Button Controllers

From Hubitat Documentation
Revision as of 16:32, 26 November 2018 by Doug (talk | contribs) (Major re-write and images added)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Wireless buttons are a great way to quickly change modes, control lighting, override automations and even protect loved ones when you, cannot, don’t have or don't want to use voice controls. Up to 8 buttons can be configured to control devices or Rule Machine®, providing the quickest, easiest way to program your buttons.

Installing the Button Controllers app

  1. From the Hubitat Web Interface select Apps
    Install Built-In App 2.0.png
  2. Choose the Button Controllers from the list of Hubitat Elevation™ built-In apps
    Install Button Controllers 2.0.png
  3. If you haven't already, add your button device using the process found in Discovering your Devices or in the case of Lutron Pico buttons, you will use the Lutron app to add them to the Lutron Smart Bridge Pro or Lutron RA2 Select Main Repeater, and the Lutron Integrator app to add them to your Hubitat Elevation™ hub.

Configuring your buttons

  1. Open the Button Controllers app in your Hubitat Web Interface.
  2. Select Create New Button Controller.
    Button Controller 2.0.png
  3. Name the button controller and select your button device.
    Name BC mapping and choose device 2.0.png
  4. Select the button device options.
    1. Turn on Use held if you want to have a separate action when the button is held. If the driver supports adjustment, the held times are configurable from 250ms to 2000ms.
      Button Controller-Use held.png
    2. Enable Use released if you want there to be a different action for when the button is released, versus when it is held.
      Button Controller-Use released.png
  5. In the Select Button field, enter which button on your controller to set (if your button controller only has one button, enter a 1), then press the Tab key to refresh or tap the area below the Select Button field.
    Button Controller-Select button.png
  6. Now you will be given options to select different actions if your button is simply pushed or if the button is pushed and held, or pushed and released. Choose Select Actions and you will be presented with several action options:
    Button Controller-Button Options.png
    Delay or repeat these actions: Delay or repeat actions by minutes, seconds or milliseconds
    Control Switches, Buttons, Capture/Restore: Here you can select device you would like to turn on, off, toggle, assign per mode, or capture the state, including on/off, hue, saturation and level. The captured state can be used in with the Restore the state of captured switches option that will be available after a device is selected.
    Set Dimmers, Bulbs, Shades and Fans: Adjust dimmers to your specified levels, raise or lower shades, adjust light bulb temperature and color, set fan speeds.
    Control Doors, Locks, Valves, Thermostats or Hubitat™ Safety Monitor: Set garage doors, door locks and valves to open or close, and adjust the monitoring state of Hubitat™ Safety Monitor.
    Send or Speak a Message: You can write a pre-set text message or push notification to send to the phone numbers of your choice. Perfect for times when a person carrying a button device might need emergency assistance.
    Set Mode, Photos, Music Player: Select a mode or select the cameras and music players you wish to activate.
    Rule Machine: Configure the button to set rule Boolean to true or false, run specific rules, run specific rule actions, stop actions, pause rules, or resume rule
  7. Repeat steps 5-6 to select the devices you want to activate up to 8 buttons.
  8. When you are done programming all of your buttons, select the Done button.
    Button Controller-Done configuring.png