Difference between revisions of "Button Controllers"

From Hubitat Documentation
Jump to: navigation, search
(Added Images)
(Major re-write and images added)
 
Line 1: Line 1:
Wireless buttons are a great way to quickly change modes, control lighting 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 ===
+
===Installing the Button Controllers app===
  
 
#From the Hubitat Web Interface select '''Apps'''[[File:Install Built-In App 2.0.png|none|thumb|600x600px]]
 
#From the Hubitat Web Interface select '''Apps'''[[File:Install Built-In App 2.0.png|none|thumb|600x600px]]
 
#Choose the Button Controllers from the list of Hubitat Elevation™ built-In apps[[File:Install Button Controllers 2.0.png|none|thumb|600x600px]]
 
#Choose the Button Controllers from the list of Hubitat Elevation™ built-In apps[[File:Install Button Controllers 2.0.png|none|thumb|600x600px]]
#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 Hubitat.
+
#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 ===
+
===Configuring your buttons===
  
 
#Open the '''Button Controllers''' app in your Hubitat Web Interface.
 
#Open the '''Button Controllers''' app in your Hubitat Web Interface.
 
#Select ''Create New Button Controller''.[[File:Button Controller 2.0.png|none|thumb|600x600px]]
 
#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]]
 
#Name the button controller and select your button device.[[File:Name BC mapping and choose device 2.0.png|none|thumb|600x600px]]
#Check the button controller you want to use and click ''Save''
+
#Select the button device options.
#Click ''Select Button'' to choose which button on your controller to set (if your button controller only has one button, select 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.[[File:Button Controller-Use held.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. Click ''Select Actions'' and you will be presented with several action options:
+
##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]]
#:'''Delay These Actions''' by minutes, seconds or milliseconds
+
#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]]
#:'''Control Switches, Buttons, Capture/Restore'''. Here you can select device you’d like to turn on, off or toggle.
+
#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]]
#:'''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.
+
#:'''Delay or repeat these actions:''' Delay or repeat actions by minutes, seconds or milliseconds
#:'''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.
+
#:'''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.
#:'''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 Dimmers, Bulbs, Shades and Fans:''' Adjust dimmers to your specified levels, raise or lower shades, adjust light bulb temperature and color, set fan speeds.
#:'''Set Mode, Photos, Music Player''' Select a mode or select the cameras and music players you wish to activate.
+
#:'''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.
#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 activate when the button is pressed or held.
+
#:'''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.
#You can program as many buttons on your button controller as you wish by clicking the Select Button field and following steps 6-7.
+
#:'''Set Mode, Photos, Music Player:''' Select a mode or select the cameras and music players you wish to activate.
#When you are done programming all of your button, click the ''Done'' button.
+
#:'''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