How to setup mobile presence sensing

From Hubitat Documentation
Revision as of 15:21, 14 June 2021 by Doug (talk | contribs) (Advanced options for Android)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Go to the top of the page

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 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.
    • 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.
      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.
    Android send presence in motion only.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.

Advanced Presence Options

Advanced options for iOS

  • Send presence only while in motion 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.
    • 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.
      IOS send presence in motion.png
  • Validate location on network change This option will trigger the geofence to re-register when the iPhone changes WiFi networks.
    IOS Validate location on network.png
  • Delay exit 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.
    IOS delay exit for geofence.png
  • High Accuracy Presence 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.

Advanced options for Android

  • Send presence only while in motion 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.
    • 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.
      Android allow physical activity.png
      Android send presence in motion only.png
  • Validate location on network change This option will trigger the geofence to re-register when the phone changes WiFi networks.
    Android validate on network change.png
  • Delay exit 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.
    Android Geofence delay exit.png

Adjusting the Geofence area

  1. Tap the Geofence icon at the bottom of the app.
    Adjust geofence in app.jpg
  2. 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).
    • 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.
      Adjust geofence area.jpg
  3. You can force a different Geofence area by tap, hold and drag of the pin at the center of the blue geolocation area.
    Hub geofence manually adjusted.jpg
    Phone out of geofence.jpg