Difference between revisions of "Motion and Mode Lighting Apps"

From Hubitat Documentation
Jump to: navigation, search
(Reflect new UI wording)
(add alt text, start removing clone/import)
Line 5: Line 5:
 
===<big>Installing Motion Lighting and Mode Lighting apps</big>===
 
===<big>Installing Motion Lighting and Mode Lighting apps</big>===
  
#<big>From the sidebar of your hub, select '''Apps''' and press the '''Add Built-In App''' button.</big>[[File:Install Built-In App 2.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/7/77/Install_Built-In_App_2.0.png
+
#<big>From the sidebar of your hub, select '''Apps''' and press the '''Add Built-In App''' button.</big>[[File:Install Built-In App 2.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/7/77/Install_Built-In_App_2.0.png ]]
]]
+
#<big>Choose '''Motion and Mode Lighting Apps''' from the list of Hubitat Elevation Built-In Apps</big>[[File:Install Motion and Mode Lighting apps.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/a/a1/Install_Motion_and_Mode_Lighting_apps.png |alt=Screenshot of "Motion and Mode Lightng Apps" in built-in apps list]]
#<big>Choose '''Motion and Mode Lighting Apps''' from the list of Hubitat Elevation Built-In Apps</big>[[File:Install Motion and Mode Lighting apps.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/a/a1/Install_Motion_and_Mode_Lighting_apps.png
 
]]
 
  
 
===<big>Creating a Motion Lighting App</big>===
 
===<big>Creating a Motion Lighting App</big>===
  
 
#<big>Open the Motion Lighting Apps in your Hubitat Web Interface</big>
 
#<big>Open the Motion Lighting Apps in your Hubitat Web Interface</big>
#<big>Select '''Create New Motion Lighting App...'''</big>[[File:Create new Motion Lighting child app.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/b/bd/Create_new_Motion_Lighting_child_app.png
+
#<big>Select '''Create New Motion Lighting App...'''</big>[[File:Create new Motion Lighting child app.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/b/bd/Create_new_Motion_Lighting_child_app.png |alt=Screenshot of "Create new Motion Lighting app" option]]
]]
+
#<big>Name your Motion Lighting rule and press '''Continue'''</big>[[File:Naming Motion lighting app.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/92/Naming_Motion_lighting_app.png |alt=Screenshot of "Name this Motion Ligthing app" and "Continue" button]]
#<big>Name your Motion Lighting rule and press '''Continue'''</big>[[File:Naming Motion lighting app.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/92/Naming_Motion_lighting_app.png
+
#<big>Select '''Motion Sensors''' to choose which motion sensors should trigger your lights. Check all that apply and press '''Update'''.</big>[[File:Motion Lighting select motion sensors.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/c3/Motion_Lighting_select_motion_sensors.png |alt=Screenshot of "Motion Sensors" option]]
]]
+
#<big>Select the '''Lights to turn On''' when motion is detected. If you would like different settings per mode (i.e. Day, Night, Away, etc), enable the '''Use settings per mode option.'''</big>[[File:Motion lighting - selecting lights v3.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/3/3b/Motion_lighting_-_selecting_lights_v3.png |alt=Screenshot of "Use settings per mode?" and lights options]]
#<big>Select '''Motion Sensors''' to choose which motion sensors should trigger your lights. Check all that apply and press '''Update'''.</big>[[File:Motion Lighting select motion sensors.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/c3/Motion_Lighting_select_motion_sensors.png
+
#<big>You will now have several choices of device types you can turn '''On''' with your motion sensors.</big>[[File:Motion Lighting - Select devices for ON v2.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/9b/Motion_Lighting_-_Select_devices_for_ON_v2.png |alt=Screenshot of "Select Lights to Turn On" options]]
]]
 
#<big>Select the '''Lights to turn On''' when motion is detected. If you would like different settings per mode (i.e. Day, Night, Away, etc), enable the '''Use settings per mode option.'''</big>[[File:Motion lighting - selecting lights v3.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/3/3b/Motion_lighting_-_selecting_lights_v3.png
 
]]
 
#<big>You will now have several choices of device types you can turn '''On''' with your motion sensors.</big>[[File:Motion Lighting - Select devices for ON v2.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/9b/Motion_Lighting_-_Select_devices_for_ON_v2.png
 
]]
 
 
#:'''<big>Set these dimmers</big>'''
 
#:'''<big>Set these dimmers</big>'''
 
#:<big>Select the dimmers you want to active. You will also be asked to set the dimmer level.</big>
 
#:<big>Select the dimmers you want to active. You will also be asked to set the dimmer level.</big>
Line 35: Line 28:
 
#:'''<big>Activate Scenes</big>'''
 
#:'''<big>Activate Scenes</big>'''
 
#:<big>Select the scenes you would like to turn '''On''' when motion is activated.</big>
 
#:<big>Select the scenes you would like to turn '''On''' when motion is activated.</big>
#<big>If you enable the option '''Use settings per mode?''', you will be able to specify which modes will be applicable for '''Lights to turn On''' .</big>[[File:Motion Lighting - Select devices per mode for ON.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/0/05/Motion_Lighting_-_Select_devices_per_mode_for_ON.png
+
#<big>If you enable the option '''Use settings per mode?''', you will be able to specify which modes will be applicable for '''Lights to turn On''' .</big>[[File:Motion Lighting - Select devices per mode for ON.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/0/05/Motion_Lighting_-_Select_devices_per_mode_for_ON.png |alt=Screenshot of "Lights to Turn On" options with per-mode options enabled]]
]]
 
 
#*<big>'''NOTE:''' ''Once you select the option for '''Use settings per mode''', the motion lighting rule must now have the modes specified for each device to turn on. If you later decide you do not want to turn lights on per mode, then a new Motion Lighting child app must be created.''</big>
 
#*<big>'''NOTE:''' ''Once you select the option for '''Use settings per mode''', the motion lighting rule must now have the modes specified for each device to turn on. If you later decide you do not want to turn lights on per mode, then a new Motion Lighting child app must be created.''</big>
 
#*:
 
#*:
Line 56: Line 48:
 
<big>You have now created a functional motion lighting child app, with a motion trigger and some lights. If you want to add some additional options, choose '''Options for Activate, Disable, and Enable Lights-On'''.</big>
 
<big>You have now created a functional motion lighting child app, with a motion trigger and some lights. If you want to add some additional options, choose '''Options for Activate, Disable, and Enable Lights-On'''.</big>
  
#<big>You will be presented with a list of options and may select as many as you want, leaving any options you don't want blank.</big>[[File:Motion Lighting active and disable options v2.png|none|thumb|705x705px|link=https://docs.hubitat.com/images/6/66/Motion_Lighting_active_and_disable_options_v2.png
+
#<big>You will be presented with a list of options and may select as many as you want, leaving any options you don't want blank.</big>[[File:Motion Lighting active and disable options v2.png|none|thumb|705x705px|link=https://docs.hubitat.com/images/6/66/Motion_Lighting_active_and_disable_options_v2.png |alt=Screenshot of "Options for Turn-on, Disable, and Enable Lights-On" options]]
]]
 
 
#:'''<big>Buttons to turn on lights</big>'''
 
#:'''<big>Buttons to turn on lights</big>'''
 
#:<big>Select any buttons you'd like to use to manually turn '''On''' your specified lights. Enter the button number into the field (enter "1" if the controller only has one button). If you only define a button to turn '''On''' the light, turning the light '''Off''' will be handled solely by motion sensor activity.</big>
 
#:<big>Select any buttons you'd like to use to manually turn '''On''' your specified lights. Enter the button number into the field (enter "1" if the controller only has one button). If you only define a button to turn '''On''' the light, turning the light '''Off''' will be handled solely by motion sensor activity.</big>
Line 74: Line 65:
 
#:<big>'''Enable override with dimmer level change''' '''(defaults is disabled)'''</big>
 
#:<big>'''Enable override with dimmer level change''' '''(defaults is disabled)'''</big>
 
#:<big>Turn on this option if you want to be able to manually set lights low or bright, without the motion lighting settings overriding your manual dimmer setting when motion is detected. '''NOTE:''' When this option enabled alone, it will prevent a motion inactive from turning the lights '''Off''' and stop additional motion active events from changing the dimmer level if you manually adjusted it.</big>
 
#:<big>Turn on this option if you want to be able to manually set lights low or bright, without the motion lighting settings overriding your manual dimmer setting when motion is detected. '''NOTE:''' When this option enabled alone, it will prevent a motion inactive from turning the lights '''Off''' and stop additional motion active events from changing the dimmer level if you manually adjusted it.</big>
#:[[File:Motion Lighting - Options for Enable override with dimmer.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f2/Motion_Lighting_-_Options_for_Enable_override_with_dimmer.png
+
#:[[File:Motion Lighting - Options for Enable override with dimmer.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f2/Motion_Lighting_-_Options_for_Enable_override_with_dimmer.png |alt=Screenshot of override options]]
]]
 
 
#:'''<big>Override for level only? (Will still turn off)</big>'''
 
#:'''<big>Override for level only? (Will still turn off)</big>'''
 
#:<big>If this option is enabled, motion active events will not change your manual dimmer level settings, but when no motion is detected, the lights will still turn '''Off''' when the specified time has elapsed.</big>
 
#:<big>If this option is enabled, motion active events will not change your manual dimmer level settings, but when no motion is detected, the lights will still turn '''Off''' when the specified time has elapsed.</big>
Line 103: Line 93:
 
<big>Now that you have your options for '''On''' selected, let's turn our attention to the '''Off''' options. If you want to add some additional options, choose '''Options for Additional Sensors, Lights-Off and Off options'''.</big>
 
<big>Now that you have your options for '''On''' selected, let's turn our attention to the '''Off''' options. If you want to add some additional options, choose '''Options for Additional Sensors, Lights-Off and Off options'''.</big>
  
#<big>Again, we are presented with a series of options for controlling when the motion-activated lights will turn '''Off'''.</big>[[File:Motion Lighting Options for OFF v2.png|none|thumb|733x733px|link=https://docs.hubitat.com/images/5/5a/Motion_Lighting_Options_for_OFF_v2.png
+
#<big>Again, we are presented with a series of options for controlling when the motion-activated lights will turn '''Off'''.</big>[[File:Motion Lighting Options for OFF v2.png|none|thumb|733x733px|link=https://docs.hubitat.com/images/5/5a/Motion_Lighting_Options_for_OFF_v2.png |alt=Screenshot of "Options for Additoinal Sensors, Lights-Off and Off" options]]
]]
 
 
#::'''<big>Use delay per mode</big>'''
 
#::'''<big>Use delay per mode</big>'''
 
#::<big>By default, your lights will turn '''Off''' whenever motion stops being detected. To avoid this, you can set a delay after the last motion is detected, and before the lights turn '''Off'''. Toggle the '''Use delay per mode''' switch at the top. '''Off''' delay fields will appear for each mode you have selected. Enter the number of minutes you want to delay the lights turning '''Off'''''.''</big>
 
#::<big>By default, your lights will turn '''Off''' whenever motion stops being detected. To avoid this, you can set a delay after the last motion is detected, and before the lights turn '''Off'''. Toggle the '''Use delay per mode''' switch at the top. '''Off''' delay fields will appear for each mode you have selected. Enter the number of minutes you want to delay the lights turning '''Off'''''.''</big>
Line 147: Line 136:
  
 
#<big>Open the Motion Lighting Apps in sidebar of your hub.</big>
 
#<big>Open the Motion Lighting Apps in sidebar of your hub.</big>
#<big>Select '''Create New Motion Lighting App...'''</big>[[File:Create new Mode Lighting child app.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/0/0c/Create_new_Mode_Lighting_child_app.png
+
#<big>Select '''Create New Motion Lighting App...'''</big>[[File:Create new Mode Lighting child app.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/0/0c/Create_new_Mode_Lighting_child_app.png |alt=Screenshot of "Create New Mode Lighting app" option]]
]]
+
#<big>Name your Mode Lighting app.</big>[[File:Mode Lighting - enter name.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/ce/Mode_Lighting_-_enter_name.png |alt=Screenshot: Naming Mode Lighting app]]
#<big>Name your Mode Lighting app.</big>[[File:Mode Lighting - enter name.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/ce/Mode_Lighting_-_enter_name.png
+
#<big>Select '''Lights to turn On''' to choose lights you want controlled by mode changes.</big>[[File:Mode Lighting - Lights to turn On.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/d/d0/Mode_Lighting_-_Lights_to_turn_On.png |alt=Screenshot of "Lights to Turn On" option]][[File:Mode Lighting - options for Lights to turn On.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/3/37/Mode_Lighting_-_options_for_Lights_to_turn_On.png |alt=Screenshot of "Select Lights to Turn On" options]][[File:Mode Lighting - Lights to turn ON - defined.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/c1/Mode_Lighting_-_Lights_to_turn_ON_-_defined.png |alt=Screenshot of "Lights to turn on" with options selected]]
]]
 
#<big>Select '''Lights to turn On''' to choose lights you want controlled by mode changes.</big>[[File:Mode Lighting - Lights to turn On.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/d/d0/Mode_Lighting_-_Lights_to_turn_On.png
 
]][[File:Mode Lighting - options for Lights to turn On.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/3/37/Mode_Lighting_-_options_for_Lights_to_turn_On.png
 
]][[File:Mode Lighting - Lights to turn ON - defined.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/c1/Mode_Lighting_-_Lights_to_turn_ON_-_defined.png
 
]]
 
 
#:'''<big>Set these dimmers per mode</big>'''
 
#:'''<big>Set these dimmers per mode</big>'''
 
#:<big>Select the dimmers you want activated, and by which modes. You will also be asked to set the dimmer level.</big>
 
#:<big>Select the dimmers you want activated, and by which modes. You will also be asked to set the dimmer level.</big>
Line 163: Line 147:
 
#:'''<big>Push button per mode</big>'''
 
#:'''<big>Push button per mode</big>'''
 
#:<big>Here you can specify a button per mode you want pushed, when a mode change occurs.</big>
 
#:<big>Here you can specify a button per mode you want pushed, when a mode change occurs.</big>
#:* <big>'''NOTE''': ''You can specify different buttons per mode, but only within a single button controller.''</big>
+
#:*<big>'''NOTE''': ''You can specify different buttons per mode, but only within a single button controller.''</big>
 
#:'''<big>Turn on a switches per mode</big>'''
 
#:'''<big>Turn on a switches per mode</big>'''
 
#:<big>Select the switches you want to turn ''on'' and the modes you would like it triggered. This will turn ''on'' whatever light or appliance is activated by the switch.</big>
 
#:<big>Select the switches you want to turn ''on'' and the modes you would like it triggered. This will turn ''on'' whatever light or appliance is activated by the switch.</big>
Line 173: Line 157:
  
 
#<big>If you want the option to turn these lights on outside of mode changes, select '''Options for lights on'''. Choose buttons and/or switches you want to use to turn on the lights manually.</big>
 
#<big>If you want the option to turn these lights on outside of mode changes, select '''Options for lights on'''. Choose buttons and/or switches you want to use to turn on the lights manually.</big>
#<big>If your lights are already on at the time of a mode change, but you want their levels to adjust based on your ''Mode Lighting app'', enable the  '''Adjust levels when mode changes''' option''.''</big>[[File:Mode Lighting Options for ON.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/6/60/Mode_Lighting_Options_for_ON.png
+
#<big>If your lights are already on at the time of a mode change, but you want their levels to adjust based on your ''Mode Lighting app'', enable the  '''Adjust levels when mode changes''' option''.''</big>[[File:Mode Lighting Options for ON.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/6/60/Mode_Lighting_Options_for_ON.png |alt=Screenshot of "Options for lights on" page]]
]]
 
 
#<big>When you are satisfied with your chosen options, select '''Done'''.</big>
 
#<big>When you are satisfied with your chosen options, select '''Done'''.</big>
  
Line 198: Line 181:
 
===<big>Export, Import or Clone of Motion and Mode Lighting Rules</big>===
 
===<big>Export, Import or Clone of Motion and Mode Lighting Rules</big>===
 
<big>Select this option to allow export of your Motion and Mode Lighting App rules for import to another hub, or to clone an existing rule as a base from which to start a new rule.</big>
 
<big>Select this option to allow export of your Motion and Mode Lighting App rules for import to another hub, or to clone an existing rule as a base from which to start a new rule.</big>
[[File:Export Import and Clone Motion and Mode Lighting.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/4/4c/Export_Import_and_Clone_Motion_and_Mode_Lighting.png
 
]]
 
 
 
====<big>Export a Rule</big>====
 
====<big>Export a Rule</big>====
  
#<big>Select a single or multiple rules for '''Export'''. You may export multiple rules to a single file, and still have the option to select which rules to later '''Import'''.</big>[[File:Export selected - Motion and Mode Lighting Apps.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/b/b0/Export_selected_-_Motion_and_Mode_Lighting_Apps.png
+
#<big>Select a single or multiple rules for '''Export'''. You may export multiple rules to a single file, and still have the option to select which rules to later '''Import'''.</big>
]]
+
#<big>Press the '''Download''' button to save the file to your local drive in the designated file download location for your browser. Typically this will be your '''Downloads''' folder.</big>
#<big>Press the '''Download''' button to save the file to your local drive in the designated file download location for your browser. Typically this will be your '''Downloads''' folder.</big>[[File:Export Motion and Mode Lighting Rule v4.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/d/dd/Export_Motion_and_Mode_Lighting_Rule_v4.png
 
]]
 
  
 
====<big>Restore or Import a Rule</big>====
 
====<big>Restore or Import a Rule</big>====
Line 213: Line 191:
 
'''<big>Restore</big>'''
 
'''<big>Restore</big>'''
  
#<big>To '''Restore''', select the saved file you previously exported, then press the '''Restore''' button.</big>[[File:Rule backup file for restore.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/93/Rule_backup_file_for_restore.png
+
#<big>To '''Restore''', select the saved file you previously exported, then press the '''Restore''' button.</big>
]]
 
  
 
'''<big>Import</big>'''
 
'''<big>Import</big>'''
  
#<big>To '''Import''', select the saved file you previously exported and press the '''Import...''' button.</big>[[File:Rule backup file for import.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/8/84/Rule_backup_file_for_import.png
+
#<big>To '''Import''', select the saved file you previously exported and press the '''Import...''' button.</big>
]]
 
 
#<big>You will be prompted to replace the name and devices used in the rule if you need to.</big>
 
#<big>You will be prompted to replace the name and devices used in the rule if you need to.</big>
#*<big>'''NOTE:''' If you '''Import''' a rule to another hub without selecting replacement devices, any existing devices with those same names will be used in the imported rule. If the devices do not exist, virtual devices with those same names will automatically be created. This is very helpful when you need to replace devices of an imported rule, but do not yet have the devices available that will replace them.</big>[[File:Rename and change device before rule import.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/d/d6/Rename_and_change_device_before_rule_import.png
+
#*<big>'''NOTE:''' If you '''Import''' a rule to another hub without selecting replacement devices, any existing devices with those same names will be used in the imported rule. If the devices do not exist, virtual devices with those same names will automatically be created. This is very helpful when you need to replace devices of an imported rule, but do not yet have the devices available that will replace them.</big>
]]
 
 
#**
 
#**
#<big>When ready to import, press the '''Import ['''rule name''']''' button.</big>[[File:Start Motion and Mode Lighting rule import.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/6/6d/Start_Motion_and_Mode_Lighting_rule_import.png
+
#<big>When ready to import, press the '''Import ['''rule name''']''' button.</big>
]]
+
#<big>You will receive a confirmation that the rule you selected has been imported.</big>
#<big>You will receive a confirmation that the rule you selected has been imported.</big>[[File:Motion and Mode Lighting import confirmation.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/b/b4/Motion_and_Mode_Lighting_import_confirmation.png
+
#<big>If you changed the name, it will appear with the new name in your list of '''Motion and Mode Lighting''' child apps.</big>
]]
 
#<big>If you changed the name, it will appear with the new name in your list of '''Motion and Mode Lighting''' child apps.</big>[[File:Show imported Motion and Mode Lighting rule.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f1/Show_imported_Motion_and_Mode_Lighting_rule.png
 
]]
 
  
 
====<big>Clone a Rule</big>====
 
====<big>Clone a Rule</big>====
  
#<big>To '''Clone''' a rule, select the rule from the list of available Motion and Mode Lighting App rules on your hub and press the '''Clone''' button.</big>[[File:Clone Motion and Mode Lighting v2.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/3/33/Clone_Motion_and_Mode_Lighting_v2.png
+
#<big>To '''Clone''' a rule, select the rule from the list of available Motion and Mode Lighting App rules on your hub and press the '''Clone''' button.</big>[[File:Initiate Motion and Mode Lighting clone.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f5/Initiate_Motion_and_Mode_Lighting_clone.png ]]
]][[File:Initiate Motion and Mode Lighting clone.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f5/Initiate_Motion_and_Mode_Lighting_clone.png
+
#<big>You will be prompted to replace the name and devices used in the rule if you need to.</big>[[File:Rename and change devices before cloning.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/d/d5/Rename_and_change_devices_before_cloning.png ]]
]]
+
#<big>When ready to proceed, press the '''Clone ['''rule name''']''' button.</big>[[File:Start Motion and Mode Lighting clone.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/6/64/Start_Motion_and_Mode_Lighting_clone.png ]]
#<big>You will be prompted to replace the name and devices used in the rule if you need to.</big>[[File:Rename and change devices before cloning.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/d/d5/Rename_and_change_devices_before_cloning.png
+
#<big>You will receive a confirmation that the rule you selected has been cloned.</big>[[File:Confirmation Motion and Mode Lighting rule cloned.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f3/Confirmation_Motion_and_Mode_Lighting_rule_cloned.png ]]
]]
 
#<big>When ready to proceed, press the '''Clone ['''rule name''']''' button.</big>[[File:Start Motion and Mode Lighting clone.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/6/64/Start_Motion_and_Mode_Lighting_clone.png
 
]]
 
#<big>You will receive a confirmation that the rule you selected has been cloned.</big>[[File:Confirmation Motion and Mode Lighting rule cloned.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f3/Confirmation_Motion_and_Mode_Lighting_rule_cloned.png
 
]]
 
 
#<big>If you changed the name, it will appear with the new name in your list of Motion and Mode Lighting child apps. If you did not change the name, the rule will be imported under the same name, but it will have the word '''clone''' added to the end.</big>[[File:Show imported Motion and Mode Lighting rule.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f1/Show_imported_Motion_and_Mode_Lighting_rule.png]]__FORCETOC__
 
#<big>If you changed the name, it will appear with the new name in your list of Motion and Mode Lighting child apps. If you did not change the name, the rule will be imported under the same name, but it will have the word '''clone''' added to the end.</big>[[File:Show imported Motion and Mode Lighting rule.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/f1/Show_imported_Motion_and_Mode_Lighting_rule.png]]__FORCETOC__

Revision as of 00:28, 3 July 2022

Go to the top of the page

Motion and Mode Lighting Apps offers a quick way to automate your lighting to be triggered by motion sensors or modes. The setup for Motion Lighting and Mode Lighting are slightly different.

Installing Motion Lighting and Mode Lighting apps

  1. From the sidebar of your hub, select Apps and press the Add Built-In App button.
    Install Built-In App 2.0.png
  2. Choose Motion and Mode Lighting Apps from the list of Hubitat Elevation Built-In Apps
    Screenshot of "Motion and Mode Lightng Apps" in built-in apps list

Creating a Motion Lighting App

  1. Open the Motion Lighting Apps in your Hubitat Web Interface
  2. Select Create New Motion Lighting App...
    Screenshot of "Create new Motion Lighting app" option
  3. Name your Motion Lighting rule and press Continue
    Screenshot of "Name this Motion Ligthing app" and "Continue" button
  4. Select Motion Sensors to choose which motion sensors should trigger your lights. Check all that apply and press Update.
    Screenshot of "Motion Sensors" option
  5. Select the Lights to turn On when motion is detected. If you would like different settings per mode (i.e. Day, Night, Away, etc), enable the Use settings per mode option.
    Screenshot of "Use settings per mode?" and lights options
  6. You will now have several choices of device types you can turn On with your motion sensors.
    Screenshot of "Select Lights to Turn On" options
    Set these dimmers
    Select the dimmers you want to active. You will also be asked to set the dimmer level.
    Set color temperature for these bulbs
    If you have bulbs with variable color temperatures, select them here. Choose what color temperature you want them to emit.
    Set color for these bulbs
    If you have color-changing bulbs, select them here and what color you want them to be.
    Push button
    Select a button you would also like Motion Lighting to push when motion is activated. This will trigger whatever action you have set for the button in Button Controllers, Rule Machine® or other apps.
    Turn on a switches
    Select which switches you would like to turn On when motion is activated.
    Activate Scenes
    Select the scenes you would like to turn On when motion is activated.
  7. If you enable the option Use settings per mode?, you will be able to specify which modes will be applicable for Lights to turn On .
    Screenshot of "Lights to Turn On" options with per-mode options enabled
    • NOTE: Once you select the option for Use settings per mode, the motion lighting rule must now have the modes specified for each device to turn on. If you later decide you do not want to turn lights on per mode, then a new Motion Lighting child app must be created.
      Set these dimmers per mode
      Select the dimmers you want to active and for which modes. You will also be asked to set the dimmer level.
      Set color temperature per mode for these bulbs
      If you have bulbs with variable color temperatures, select them here. Choose the modes during which they will be active, and what color temperature you want them to display.
      Set color per mode for these bulbs
      If you have color-changing bulbs, select them here. Select the modes during which they will be active and what color you want them to be.
      Push button per mode
      Select a button you would also like Motion Lighting to push when motion is activated. This will trigger whatever action you have set for the button in Button Controller, Rule Machine® or other apps. Select the modes for which this will be active.
      Turn on a switches per mode
      Select which switches you would like to turn On when motion is activated and select the modes for which the switches will be active.
      Select Scenes per mode
      Select the scenes you would like to turn On when motion is activated. You can select a different scene for each mode.
  8. When finished setting up your Motion Lighting app, press the Done button.

Setting Options for Activate, Disable, and Enable Lights-On

You have now created a functional motion lighting child app, with a motion trigger and some lights. If you want to add some additional options, choose Options for Activate, Disable, and Enable Lights-On.

  1. You will be presented with a list of options and may select as many as you want, leaving any options you don't want blank.
    Screenshot of "Options for Turn-on, Disable, and Enable Lights-On" options
    Buttons to turn on lights
    Select any buttons you'd like to use to manually turn On your specified lights. Enter the button number into the field (enter "1" if the controller only has one button). If you only define a button to turn On the light, turning the light Off will be handled solely by motion sensor activity.
    Buttons to toggle on/off
    Select any buttons you'd like to use to manually toggle the lights On and Off. Enter the button number into the field (enter "1" if the controller only has one button).
    Buttons to disable turning on
    Select any buttons you'd like to use to disable this motion lighting child app and prevent the lights from turning On with motion when pressed. This is helpful to prevent lights from turning on in a bedroom, for example. Enter the button number into the field (enter "1" if the controller only has one button).
    Button to enable turning on/off
    If you selected a button to disable the child app, you can re-enable it with a different button. This is different from Buttons to toggle on/off, which simple toggles the light On or Off without affecting the motion sensor input. Defining a button here will allow the motion lighting child app to once again respond to your defined motion sensor(s). Enter the button number into the field (enter "1" if the controller only has one button).
    Switches to turn on lights
    Select any switches you'd like to use to manually turn on your specified lights. If you only define switches to turn On the light, turning the light Off will be handled solely by motion sensor activity.
    Contact sensors to turn on lights
    Select any contact sensors you'd like to use to turn On your specified lights. If you only define contact sensors to turn On the light, turning the light Off will be handled solely by motion sensor activity.
    Enable on/off at Time
    If you use a button, switch or contact sensor to manually disable your motion lighting child app, you can use this option to automatically re-enable at sunrise, sunset or a specific time. This option does not turn your lights On immediately, it merely re-enables the motion lighting child app at a specified time, so it will once again respond to motion.
    Enable override with dimmer level change (defaults is disabled)
    Turn on this option if you want to be able to manually set lights low or bright, without the motion lighting settings overriding your manual dimmer setting when motion is detected. NOTE: When this option enabled alone, it will prevent a motion inactive from turning the lights Off and stop additional motion active events from changing the dimmer level if you manually adjusted it.
    Screenshot of override options
    Override for level only? (Will still turn off)
    If this option is enabled, motion active events will not change your manual dimmer level settings, but when no motion is detected, the lights will still turn Off when the specified time has elapsed.
    Use physical level change for override? (Default is any level change)
    Enable this option for restricting level change override to physical dimmer changes only. Some smart dimmers may also report as they ramp up, thus causing an override and preventing a motion sensor from turning lights off. Selecting Use physical level change for override can prevent this from occurring.
    Switch to disable turning on
    Select any switches you'd like to use to disable this child app so lights will not turn On when the specified switches are on, even if motion is detected.
    Contacts to disable turning on
    Select any contact sensors you'd like to use to disable this child app so lights will not turn On when the specified contacts active, even if motion is detected.
    Don't turn on if turned off manually
    When enabled, the motion sensor will not turn the light On until the switch is turned on again manually. This will prevent the motion sensor from turning lights immediately On again in situations where, after manually turning lights off via a button, switch or contact sensor, your movement may activate a motion sensor before you have the chance to leave a room.
    Clear this on next mode change
    When enabled, will allow the lights to be turned on with motion again after the next mode change, even if the previous option ("Don't turn on if turned off manually") is selected and the lights are turned off manually.
    Do turn on even if any already on
    Motion Lighting subscribes to events from lights it controls and attempts to determine the current state of all the lights it is controlling with a particular Motion Lighting child app. Certain circumstances may cause Motion Lighting to not turn lights On if it falsely has determined they are already on, due to influence from another app, controls on a remote bridge, or physical control that may have caused the reported state to be out of sync with all of the lights it is controlling. Enabling this option forces motion events to send On commands, irrespective of the state of the lights it is controlling.
    Turn on only between two times
    Select a window of time when you would like your motion lighting child app to be active.
    Turn on only if lux is less than this value
    Select a lux sensor and select a value (1-10000). The lights will only turn On if the lux value is below this level.
    Select a fade time for the lights
    Enter a fade time for your dimmers if supported by the device.
    Modes to disable turning on
    Select the mode which, when active will not allow the lights to turn on.
  2. When you are satisfied with your chosen options, select Done.

Options for Additional Sensors, Lights-Off and Off options

Now that you have your options for On selected, let's turn our attention to the Off options. If you want to add some additional options, choose Options for Additional Sensors, Lights-Off and Off options.

  1. Again, we are presented with a series of options for controlling when the motion-activated lights will turn Off.
    Screenshot of "Options for Additoinal Sensors, Lights-Off and Off" options
    Use delay per mode
    By default, your lights will turn Off whenever motion stops being detected. To avoid this, you can set a delay after the last motion is detected, and before the lights turn Off. Toggle the Use delay per mode switch at the top. Off delay fields will appear for each mode you have selected. Enter the number of minutes you want to delay the lights turning Off.
    Minutes to delay before off (Default is 1 minute)
    Set the number of minutes following the last motion sensed, for which you would like to delay the Off state.
    Additional Motion Sensors to keep on
    Selecting motion sensors in this section will not trigger the lights to turn On, but if the lights have been triggered by the primary selected sensor, they will stay On as long as this sensor is active. (Example: You can put a sensor in the shower that will not trigger the bathroom lights to turn On, but will ensure they will remain On as long as someone is in the shower).
    Additional Switches to turn off when turned off
    Select any switches that are not already included in your setup, and you would like these switches to automatically turn Off when motion becomes inactive. For example, these might be switches that you always manually turn On, such as a bathroom exhaust fan, but you want it to always turn Off when motion stops.
    Button to Push when turned off
    Select any buttons you would like to be automatically pushed when motion becomes inactive.
    Buttons to turn off lights
    Select the buttons you wish to use to manually turn Off lights, rather than waiting for motion inactive and delay before Off.
    Switches to turn off lights
    Select any switches you wish to use to manually turn Off lights, rather than waiting for motion inactive and delay before Off.
    Contact sensors to turn off lights when closed
    Select any contact sensors you wish to turn Off lights, rather than waiting for motion inactive and delay before Off.
    Don't turn off if already on
    Enabling this option will force any light that was already On before motion began, to not turn Off when the motion stops.
    Buttons to disable off
    Select a button that will override any Off automations and keep your motion lights on, even if motion stops.
    Modes to disable Turning off
    Select the modes during which your lights will not turn Off even when motion stops. Your motion lights will still turn on during these modes (unless you disable them in the previous section).
    Switch to disable off
    Select a switch that will override any Off automations and keep your motion lights on, even if motion stops.
    Contacts to disable off
    Select a contact sensor that will override any Off automations and keep your motion lights on, even if motion stops.
    Don't turn off between two times
    Select a window of time when you would like your motion lighting child app to be inactive.
    Turn off if lux is exceeds this value
    Select a lux sensor and select a value (1-10000). The lights will turn Off if the lux value is above this level.
    Activate a scene to activate when turned off
    Select the scenes you would like to activate when when lights are turned Off by a contact, switch or inactive motion event. Depending on what your scene does, you may need to utilize the Do turn on if already on option found under Options for Turn-on, Disable and Enable Lights-On. For example, if your scene activated by turning lights Off puts the controlled lights into a dim setting, they are still determined to be On. By also enabling Do turn on if already on, motion lighting would then be able to brighten them upon a motion event.
  2. When you are satisfied with your chosen options, select Done.
    Control with Alexa or Google Home using this name
    You can also specify a name you wish to use for control of these lights using Amazon Alexa or Google Home. Select a name that is clear and easy for your voice assistant to understand.
    NOTE: If you are using Motion Lighting to turn lights On and a switch to turn them On, you will need to have the switch itself selected in Options for lights off. If you don't, and you turn your lights off outside of your Motion Lighting child app, then it won't know you did that. It will continue to register them as On, and won't turn them on again from new motion before the timer to turn them Off runs out. This includes turning lights Off via Amazon Alexa or Google Home. You need to specify the same switch Alexa or Google Assistant is using to turn the light Off in the Options for lights off.
  3. When you are satisfied with your Motion Lighting app, select Done.

Creating a Mode Lighting App

Mode Lighting is used in situations where you would like lights controlled by switches to be automatically adjusted to different dim levels based on mode changes.

  1. Open the Motion Lighting Apps in sidebar of your hub.
  2. Select Create New Motion Lighting App...
    Screenshot of "Create New Mode Lighting app" option
  3. Name your Mode Lighting app.
    Screenshot: Naming Mode Lighting app
  4. Select Lights to turn On to choose lights you want controlled by mode changes.
    Screenshot of "Lights to Turn On" option
    Screenshot of "Select Lights to Turn On" options
    Screenshot of "Lights to turn on" with options selected
    Set these dimmers per mode
    Select the dimmers you want activated, and by which modes. You will also be asked to set the dimmer level.
    Set color temperature per mode for these bulbs
    Select the color temperature adjustable bulbs you want triggered, and then choose the modes you want to trigger them. Finally, set the color temperature you want these lights to display for each mode you selected.
    Set color per mode for these bulbs
    Select the RGB or RBGW color bulbs you want triggered, and then the modes you want to trigger them. Finally, set the bulb color and level you want these lights to display for each mode you selected.
    Push button per mode
    Here you can specify a button per mode you want pushed, when a mode change occurs.
    • NOTE: You can specify different buttons per mode, but only within a single button controller.
    Turn on a switches per mode
    Select the switches you want to turn on and the modes you would like it triggered. This will turn on whatever light or appliance is activated by the switch.
    NOTE: If you are using Mode Lighting to turn lights on in modes where you don't want motion to turn on the lights, you will need to have the switch itself selected in Options for lights off, explained below. If you don't, and you turn your lights off outside of your Mode Lighting child app, then it won't know you did that. It will continue to register them as on, and will execute any adjustments per mode you specified, instead of turning them on to the adjustments per mode you are expecting to happen from an off state. This includes turning lights off via Amazon Alexa or Google Home. You need to specify the same switch Alexa or Google Assistant is using to turn the light off in the Options for lights off.
  5. When you are satisfied with your chosen options, select Done

Options for lights on

  1. If you want the option to turn these lights on outside of mode changes, select Options for lights on. Choose buttons and/or switches you want to use to turn on the lights manually.
  2. If your lights are already on at the time of a mode change, but you want their levels to adjust based on your Mode Lighting app, enable the Adjust levels when mode changes option.
    Screenshot of "Options for lights on" page
  3. When you are satisfied with your chosen options, select Done.

Options for lights off

  1. Choose from the following options for turning lights and switches off, or activating buttons when your mode lighting app turns off the lights. You can also specify buttons and/or switches that can override you mode lighting child app, and immediately turn off lights.
    Additional Switches to Turn Off
    Here you can select switches that you’d like turned off when your mode lighting child app is triggered.
    Buttons to Push when turned off
    Select any buttons you would like activated when the mode lighting child app turns the lights off.
    Buttons to turn off lights
    Select the buttons you would like to use to immediately turn off your lights, overriding your mode lighting settings.
    Switches to turn off lights
    Select the switches you would like to use to immediately turn off your lights, overriding your mode lighting settings.
  2. When you are satisfied with your chosen options, select Done
    Control with Alexa or Google Home using this name
    You can also specify a name you wish to use for control of these lights using Amazon Alexa or Google Home. Select a name that is clear and easy for your voice assistant to understand.
    NOTE: If you are using Mode Lighting to turn lights on in modes where you don't want motion to turn on the lights, you will need to have the switch itself selected in Options for lights off. If you don't, and you turn your lights off outside of your Mode Lighting child app, then it won't know you did that. It will continue to register them as on, and will execute any adjustments per mode you specified, instead of turning them on to the adjustments per mode you are expecting to happen from an off state. This includes turning lights off via Amazon Alexa or Google Home. You need to specify the same switch Alexa or Google Assistant is using to turn the light off in the Options for lights off.
  3. When you are satisfied with your Mode Lighting app, select Done.

Export, Import or Clone of Motion and Mode Lighting Rules

Select this option to allow export of your Motion and Mode Lighting App rules for import to another hub, or to clone an existing rule as a base from which to start a new rule.

Export a Rule

  1. Select a single or multiple rules for Export. You may export multiple rules to a single file, and still have the option to select which rules to later Import.
  2. Press the Download button to save the file to your local drive in the designated file download location for your browser. Typically this will be your Downloads folder.

Restore or Import a Rule

You may choose to Restore a rule instead of using the Import option. This is most appropriate for instances where you want to bring a Motion and Mode Lighting App rule into your hub database, but you do not want to change the name or the devices used in the rule. If you instead choose to Import, the process will pause to allow the rule to be renamed, and the devices used in the rule to be substituted with other devices installed on your hub before completing the import process.

Restore

  1. To Restore, select the saved file you previously exported, then press the Restore button.

Import

  1. To Import, select the saved file you previously exported and press the Import... button.
  2. You will be prompted to replace the name and devices used in the rule if you need to.
    • NOTE: If you Import a rule to another hub without selecting replacement devices, any existing devices with those same names will be used in the imported rule. If the devices do not exist, virtual devices with those same names will automatically be created. This is very helpful when you need to replace devices of an imported rule, but do not yet have the devices available that will replace them.
  3. When ready to import, press the Import [rule name] button.
  4. You will receive a confirmation that the rule you selected has been imported.
  5. If you changed the name, it will appear with the new name in your list of Motion and Mode Lighting child apps.

Clone a Rule

  1. To Clone a rule, select the rule from the list of available Motion and Mode Lighting App rules on your hub and press the Clone button.
    Initiate Motion and Mode Lighting clone.png
  2. You will be prompted to replace the name and devices used in the rule if you need to.
    Rename and change devices before cloning.png
  3. When ready to proceed, press the Clone [rule name] button.
    Start Motion and Mode Lighting clone.png
  4. You will receive a confirmation that the rule you selected has been cloned.
    Confirmation Motion and Mode Lighting rule cloned.png
  5. If you changed the name, it will appear with the new name in your list of Motion and Mode Lighting child apps. If you did not change the name, the rule will be imported under the same name, but it will have the word clone added to the end.
    Show imported Motion and Mode Lighting rule.png