Wireless buttons are a great way to quickly change modes, control lighting, override automations and even protect loved ones when you are not able. With Button Controller, an unlimited number of buttons can be configured to control devices, or attributes of other apps and drivers, providing the quickest and easiest way to program your buttons.
From the sidebar of your hub, navigate to Apps and select Add Built-In App:
Choose Button Controllers from the list of built-in apps:
If you haven't already, add your button device using the process found in Add Device. In the case of Lutron Pico buttons, you will use the Lutron mobile app to add them to the Lutron Smart Bridge Pro or Lutron RA2 Select Main Repeater, in combination with the Lutron Integrator app to add them to your Hubitat Elevation hub.
Open the Button Controllers app on your hub (if not already open from the steps above).
Select Create New Button Controller.
Select the button device (this is the device whose button events this app will respond to), then optionally provide a custom name for the Button Controller app (this is how it will display in your Apps list and, if enabled, logs).
Now, select the "+" icon to add a specific button (button number) to the list of buttons in the table. You can add one button at a time or add all buttons you want at once if the device offers multiple buttons (e.g., the most common type of Pico remote offers buttons 1-5; every button device offers at least one button, and the actual numbers offered will vary depending on the device and driver).
To create actions to run in response to a specific button event (e.g., "button 1 pushed"), select the Create Button Rule link in the table cell corresponding to the desired button number (row) and event name (column). You must first add a row for the desired button number as described above.
You may now add or edit actions to perform in response to this button event. Start by adding a new action with the "+" icon at the bottom of the actions table:
Then, select the desired action using the menus and other options presented. For example, you can choose Control Switches, Push Buttons > Turn switches on/off to turn a switch (or dimmer, bulb, etc.) on or off:
Some actions may have one or more options you can configure (in the above example, you must select whether to turn the switch on or off). When you are done adding a specific action, select Done with action. If you have selected an action add but changed your mind, select Cancel this action (or add it and then delete it later). You may add additional actions for the same button event. This can be helpful to create more complex automations or to control multiple devices in response to the same button event.
NOTE: Actions are generally similar to those found in Rule Machine, and the Rule Machine documentation may therefore be helpful to consult. Operations to insert, edit, delete, cut/copy/paste, and disable actions also work similarly to Rule Machine.
While not supported by all button devices, some do support both held and released actions. These can be used with dimmers and bulbs that support smooth dimming. It is a particularly neat automation to increase or decrease light levels while a button is held and stop the change when the button is released. The Hubitat/Hue Integration is one such application where this can be used if your button device also supports held and released actions (Hue bulbs brought in through this integration do support the necessary commands, though groups do not).
Here is an example of what a 5-button Pico setup may look like with these options (and on/off with buttons 1 and 5 pushed, as one might intuitively also want):
In each Button Rule page (e.g., the page for button 1 pushed and similar sets of actions), there are options for Logging:
These options can be useful for troubleshooting.