Difference between revisions of "Button Controllers"

From Hubitat Documentation
Jump to: navigation, search
(Major re-write and images added)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Button are a great way to quickly change modes or override automations when you don’t have or want to use voice controls. Buttons can be used in any of our rule building apps, but the Button Controller app provides you the quickest, easiest way to program your buttons. Let’s get started:
+
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<sup>®</sup>, providing the quickest, easiest way to program your buttons.
  
 +
===Installing the Button Controllers app===
  
#If you haven't already, use the discovery process to add your button [[discovering your devices]].
+
#From the Hubitat Web Interface select '''Apps'''[[File:Install Built-In App 2.0.png|none|thumb|600x600px]]
#Open the Button Controllers app in your Hubitat Web Interface.
+
#Choose the Button Controllers from the list of Hubitat Elevation™ built-In apps[[File:Install Button Controllers 2.0.png|none|thumb|600x600px]]
#Click ''Create New Button Controller''.
+
#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.
#Name the button controller
 
#Click Select Button Device
 
Check the button controller you want to use and click Save
 
Click Select Button to choose which button on your controller to set (if your button controller only has one button, select 1)
 
Now will be given options to select different actions if your button is simply pushed or if the button is pushed and held. Click Select Actions and you will be presented with several action options:
 
Delay These Actions by minutes, seconds or milliseconds
 
Control Switches, Buttons, Capture/Restore. Here you can select device you’d like to turn on, off or toggle.
 
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 and valves to open or close, lock or unlock doors and arm or disarm your alarm.
 
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 when you have fallen and can’t get up.
 
Set Mode, Photos, Music Player Select a mode or select the cameras and music players you wish to activate.
 
8. You can set as many devices as you like to activate when you press the button. Repeat step 7 to select the devices you want to active when the button is held.
 
  
9. You can program as many buttons on your button controller as you wish by clicking the Select Button field and following steps 6-7.
+
===Configuring your buttons===
  
10. When you are done programming all of your button, click the Done button.
+
#Open the '''Button Controllers''' app in your Hubitat Web Interface.
 +
#Select ''Create New Button Controller''.[[File:Button Controller 2.0.png|none|thumb|600x600px]]
 +
#Name the button controller and select your button device.[[File:Name BC mapping and choose device 2.0.png|none|thumb|600x600px]]
 +
#Select the button device options.
 +
##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.[[File:Button Controller-Use held.png|none|thumb|600x600px]]
 +
##Enable '''Use released''' if you want there to be a different action for when the button is released, versus when it is held.[[File:Button Controller-Use released.png|none|thumb|600x600px]]
 +
#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.[[File:Button Controller-Select button.png|none|thumb|600x600px]]
 +
#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:[[File:Button Controller-Button Options.png|none|thumb|600x600px]]
 +
#:'''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
 +
#Repeat steps 5-6 to select the devices you want to activate up to 8 buttons.
 +
#When you are done programming all of your buttons, select the ''Done'' button.[[File:Button Controller-Done configuring.png|none|thumb|600x600px]]

Latest revision as of 16:32, 26 November 2018

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