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

From Hubitat Documentation
Jump to: navigation, search
Line 4: Line 4:
 
<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>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>'''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>'''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>For presence sensing to work properly, you’ll need to make sure that:</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 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>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>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> on iOS ===
+
===<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>[[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>
Line 19: Line 19:
 
#<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>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>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>
+
#<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>[[File:IOS Motion and Fitness Activity confirmation.png|none|thumb|593x593px]]<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''', then 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 first time the app is used on your Android phone, you will need to allow '''Physical activit'''. 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''', 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: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>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>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>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: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 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>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>

Revision as of 20:17, 8 June 2021

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.

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.

  • 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.

For presence sensing to work properly, you’ll need to make sure that:

  1. You’ve enabled the Geofence option in the Hubitat mobile app.
  2. You’ve set location permissions for the Hubitat Mobile app to Always Allow.
  3. Everyone in your household you want to participate in presence sensing has the Hubitat mobile app installed and configured on their own phones.

Install the Hubitat Mobile app on iOS

  1. 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.
    • 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.
      IOS initial location use confirmation.png
  2. 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.
    IOS app new or existing hub owner.png
  3. Login with your 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 add a guest account to your hub and log the user into the app with their own Guest User credentials.
    Admin login to app.png
  4. Select the hub for which you want the user to participate in presence detection.
    Select hub in mobile app.png
  5. 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.
    Create new device for app.png
  6. The first time the app is used on your Android phone, you will need to allow Physical activit. 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.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, 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.
    IOS send presence only while in motion.png
  7. 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.
    Create new device for app.png
  8. 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.
    IOS Change location to Always Allow.png
  9. Presence sensing can be disabled or enabled at any time by toggling the Enable GeoFence settings option in the Hubitat mobile app.
    IOS Enable GeoFence option v2.png
  10. 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 Machine rule to trigger an action.

Install the Hubitat Mobile app on Android

  1. 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.
    • 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.
      Android Location Access prompt.png
      Android Location Allow in Settings.png
  2. 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.
    Android app new or existing hub owner.png
  3. Login with your 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 add a guest account to your hub and log the user into the app with their own Guest User credentials.
    Android app login.png
  4. Select the hub for which you want the user to participate in presence detection.
    Android select hub in mobile app.png
  5. 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.
    Create new device for Android app.png
  6. 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.
    Android allow physical activity.png
    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.
    IOS send presence only while in motion.png
  7. 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.
    Create new device for Android app.png
  8. Presence sensing can be disabled or enabled at any time by toggling the Enable GeoFence settings option in the Hubitat mobile app.
    Android Enable GeoFence option.png
  9. 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 Machine rule to trigger an action.