Difference between revisions of "How to setup mobile presence sensing"

From Hubitat Documentation
Jump to: navigation, search
(Advanced options for iOS)
(Replaced content with " <big>'''We're moving!''' Please visit http://docs2.hubitat.com for the latest documentation.</big> <big> This document is available at: http://docs2.hubitat.com/en/how-t...")
(Tag: Replaced)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{Top}}
 
  
<big>With the Hubitat mobile app, you can easily add devices so each family member leaving or arriving home can trigger automations with mobile presence detection.</big>
+
<big>'''We're moving!''' Please visit http://docs2.hubitat.com for the latest documentation.</big>
  
<big>If you opt-in, the Hubitat mobile app uses your phone’s location to figure out when you’ve crossed over a virtual perimeter around your home referred to as a Geofence. You can designate center and size of the Geofenced area when setting up presence sensing in the mobile app.</big>
+
<big>
 
+
This document is available at: http://docs2.hubitat.com/en/how-to/set-up-mobile-presence
*<big>'''NOTE:''' The Hubitat mobile app doesn’t track where you are or where you’ve been. Data for presence sensing and geofence is only used to determine when you come home or when you leave.</big>
+
</big>
 
 
<big>For presence sensing to work properly, you’ll need to make sure that:</big>
 
 
 
#<big>You’ve enabled the Geofence option in the Hubitat mobile app.</big>
 
#<big>You’ve set location permissions for the Hubitat Mobile app to '''Always Allow'''.</big>
 
#<big>Everyone in your household you want to participate in presence sensing has the Hubitat mobile app installed and configured on their own phones.</big>
 
 
 
===<big>Install the Hubitat Mobile app</big> <big>on iOS</big>===
 
 
 
#<big>[[Hubitat Elevation Mobile Apps|Install the Hubitat Elevation mobile app]] on the iPhone you want to have presence detection capabilities and when prompted, choose the selection '''Allow While Using App'''. You will be prompted again later to change the setting to '''Always Allow''' so presence sensing will function properly, but initially iOS only permits the selection of '''Allow While Using App'''.</big>
 
#*<big>'''NOTE:''' Presence detection is optional. If you don't want presence detection, you can disable it in the Hubitat mobile app and still use the other functions of the app.</big> [[File:IOS initial location use confirmation.png|none|thumb|336x336px]]
 
#<big>If this is the first time using the mobile app and your first interaction with your new hub, select '''New Hub Owner''' to create an account, otherwise choose '''Existing Hub Owner''' and login.</big>[[File:IOS app new or existing hub owner.png|none|thumb|611x611px]]
 
#<big>Login with your [https://my.hubitat.com/ my.hubitat.com] '''Admin User''' credentials. If you don't want your Admin account used on a guest user's phone, you can follow the instructions to [[How to manage accounts linked to your hub|add a guest account]] to your hub and log the user into the app with their own '''Guest User''' credentials.</big>[[File:Admin login to app.png|none|thumb|link=https://docs.hubitat.com/images/d/d9/Admin_login_to_app.png]]
 
#<big>Select the hub for which you want the user to participate in presence detection.</big>[[File:Select hub in mobile app.png|none|thumb|link=https://docs.hubitat.com/images/8/87/Select_hub_in_mobile_app.png]]
 
#<big>If this is the first time the app has been used on this iPhone to login with an account linked to your hub, then you will not see the name of the phone listed. Press the '''Create New Device''' button.</big>[[File:Create new device for app.png|none|thumb|650x650px]]
 
#<big>The first time the app is used on your iPhone, you will be prompted to allow '''Motion and Fitness Activity'''. This is only required for presence sensing to function if you have the option '''Send presence only while in motion''' enabled in the Hubitat mobile app settings.</big>
 
#*<big>'''NOTE:''' If the '''Send presence only while in motion''' Advanced settings option is enabled for a particular iPhone, but the Hubitat mobile app is not granted access to iOS '''Motion and Fitness Activity''', presence sensing on this iPhone will not work. The purpose of this enhancement option is to allow an iPhone that drops off the network and then comes back on, to only send Geolocation data when the phone is in motion, thus preventing unintended activation of automations that are based on presence sensing triggers.</big>[[File:IOS send presence only while in motion.png|none|thumb|613x613px]]
 
#<big>The name of the phone will appear in the [[Devices]] list on the hub you connected to with the Hubitat Elevation mobile app. It will also now appear in the app as an existing mobile device each time you login to the mobile app and connect it to the same hub.</big>[[File:Create new device for app.png|none|thumb|link=https://docs.hubitat.com/images/3/3a/Create_new_device_for_app.png]]
 
#<big>When prompted, change the iOS privacy option to '''Always Allow'''. This will ensure the iPhone can use Geolocation data for presence sensing even when the Hubitat mobile app is not running.</big>[[File:IOS Change location to Always Allow.png|none|thumb|590x590px]]
 
#<big>Presence sensing can be disabled or enabled at any time by toggling the '''Enable GeoFence''' settings option in the Hubitat mobile app.</big>[[File:IOS Enable GeoFence option v2.png|none|thumb|612x612px]]
 
#<big>Arrival or departure of the mobile phone creates an event. To use these events for presence detection, add the phone name from the Devices list to [[Basic Rules]] or a [[Rule-4.0|Rule Machine]] rule to trigger an action.</big>
 
 
 
===<big>Install the Hubitat Mobile app on Android</big>===
 
 
 
#<big>[[Hubitat Elevation Mobile Apps|Install the Hubitat Elevation mobile app]] on the Android phone you want to have presence detection capabilities, and when prompted choose the link '''Allow in settings'''.</big>
 
#*<big>'''NOTE:''' Presence detection is optional. If you don't want presence detection, you can disable it in the Hubitat mobile app and still use the other functions of the app.</big>[[File:Android Location Access prompt.png|none|thumb|300x300px]][[File:Android Location Allow in Settings.png|none|thumb|307x307px]]
 
#<big>If this is the first time using the mobile app and your first interaction with your new hub, select '''New Hub Owner''' to create an account, otherwise choose '''Existing Hub Owner''' and login.</big>[[File:Android app new or existing hub owner.png|none|thumb|515x515px]]
 
#<big>Login with your [https://my.hubitat.com/ my.hubitat.com] '''Admin User''' credentials. If you don't want your Admin account used on a guest user's phone, you can follow the instructions to [[How to manage accounts linked to your hub|add a guest account]] to your hub and log the user into the app with their own '''Guest User''' credentials.</big>[[File:Android app login.png|none|thumb|514x514px]]
 
#<big>Select the hub for which you want the user to participate in presence detection.</big>[[File:Android select hub in mobile app.png|none|thumb|508x508px]]
 
#<big>If this is the first time the app has been used on this Android phone to login with an account linked to your hub, then you will not see the name of the phone listed. Press the '''Create New Device''' button.</big>[[File:Create new device for Android app.png|none|thumb|516x516px]]
 
#<big>The first time the app is used on your Android phone, you will need to allow '''Physical activity.''' This is only required for presence sensing to function if you have the option '''Send presence only while in motion''', enabled in the Hubitat mobile app settings.</big>[[File:Android allow physical activity.png|none|thumb|378x378px]]<big>'''NOTE:''' If the '''Send presence only while in motion''' Advanced settings option is enabled for a particular Android phone, but the Hubitat mobile app is not granted access to Android '''Physical activity''', then presence sensing on this Android phone will not work. The purpose of this enhancement option is to allow an Android phone that drops off the network and then comes back on, to only send Geolocation data when the phone is in motion, thus preventing unintended activation of automations that are based on presence sensing triggers.</big>[[File:Android send presence in motion only.png|none|thumb|513x513px]]
 
#<big>The name of the phone will appear in the [[Devices]] list on the hub you connected to with the Hubitat Elevation mobile app. It will also now appear in the app as an existing mobile device each time you login to the mobile app and connect it to the same hub.</big>[[File:Create new device for Android app.png|none|thumb|516x516px]]
 
#<big>Presence sensing can be disabled or enabled at any time by toggling the '''Enable GeoFence''' settings option in the Hubitat mobile app.</big>[[File:Android Enable GeoFence option.png|none|thumb|612x612px]]
 
#<big>Arrival or departure of the mobile phone creates an event. To use these events for presence detection, add the phone name from the Devices list to [[Basic Rules]] or a [[Rule-4.0|Rule Machine]] rule to trigger an action.</big>
 
 
 
===<big>Advanced Presence Options</big>===
 
 
 
====<big>Advanced options for iOS</big>====
 
 
 
*<big>'''Send presence only while in motion'''</big>  <big>The purpose of this enhancement option is to allow an iPhone that drops off the network and then comes back on, to only send Geolocation data when the phone is in motion, thus preventing unintended activation of automations that are based on presence sensing triggers. The first time the app is used on your iPhone, you will be prompted to allow '''Motion and Fitness Activity'''. This is only required for presence sensing to function if you have the option '''Send presence only while in motion''' enabled in the Hubitat mobile app settings.</big>
 
**<big>'''NOTE:''' If the '''Send presence only while in motion''' Advanced settings option is enabled for a particular iPhone, but the Hubitat mobile app is not granted access to iOS '''Motion and Fitness Activity''', presence sensing on this iPhone will not work.</big>[[File:IOS send presence in motion.png|none|thumb|613x613px]]
 
*'''<big>Validate location on network change</big>'''  <big>This option will trigger the geofence to re-register when the iPhone changes WiFi networks.</big>[[File:IOS Validate location on network.png|none|thumb|612x612px]]
 
*'''<big>Delay exit</big>'''  <big>Use this feature to set the delay in minutes until the app will send an event update indicating the iPhone has departed the geo-fenced area.</big>[[File:IOS delay exit for geofence.png|none|thumb|616x616px]]
 
*'''<big>High Accuracy Presence</big>'''  <big>This option is only available for iOS devices. When enabled, this feature can increase the accuracy of presence detection for iOS devices, but it comes at a cost to battery consumption. Increased battery savings will be realized when this option is left disabled.</big>
 
 
 
====<big>Advanced options for Android</big>====
 
 
 
*<big>'''Send presence only while in motion'''</big>  <big>The purpose of this enhancement option is to allow an Android phone that drops off the network and then comes back on, to only send Geolocation data when the phone is in motion, thus preventing unintended activation of automations that are based on presence sensing triggers. The first time the app is used on your Android phone, you will need to allow '''Physical activity.''' This is only required for presence sensing to function if you have the option '''Send presence only while in motion''', enabled in the Hubitat mobile app settings.</big>
 
**<big>'''NOTE:''' If the '''Send presence only while in motion''' Advanced settings option is enabled for a particular Android phone, but the Hubitat mobile app is not granted access to Android '''Physical activity''', then presence sensing on this Android phone will not work.</big> [[File:Android allow physical activity.png|none|thumb|378x378px]][[File:Android send presence in motion only.png|none|thumb|513x513px]]
 
 
 
*'''<big>Validate location on network change</big>'''  <big>This option will trigger the geofence to re-register when the phone changes WiFi networks.</big>[[File:Android validate on network change.png|none|thumb|514x514px]]
 
*'''<big>Delay exit</big>'''  <big>Use this feature to set the delay in minutes until the app will send an event update indicating the phone has departed the geo-fenced area.</big>[[File:Android Geofence delay exit.png|none|thumb|511x511px]]
 
 
 
===<big>Adjusting the Geofence area</big>===
 
 
 
#<big>Tap the Geofence icon at the bottom of the app.</big>[[File:Adjust geofence in app.jpg|none|thumb|650x650px]]
 
#<big>Moving the slider will allow you to change the size of the Geofenced area (represented by the thin blue circle surrounding the pin at the center).</big>
 
#*<big>'''NOTE:''' The Blue dot is the current location of the phone. If you do not see the blue dot on the map, tap the location icon at the top right of the app to re-center.</big>[[File:Adjust geofence area.jpg|none|thumb|563x563px]]
 
#<big>You can force a different Geofence area by tap, hold and drag of the pin at the center of the blue geolocation area.</big>[[File:Hub geofence manually adjusted.jpg|none|thumb|650x650px]][[File:Phone out of geofence.jpg|none|thumb|650x650px]]
 

Latest revision as of 04:22, 25 September 2022

We're moving! Please visit http://docs2.hubitat.com for the latest documentation.

This document is available at: http://docs2.hubitat.com/en/how-to/set-up-mobile-presence