Out of the box, Ariela supports the device tracking capabilities. This means you will be able to see where is your own phone, family and any other devices. Ariela can use both device_tracker.see service and mobile_app API in order to make the location updates.

1. Setup

In order to enable device tracker functionality in Home Assistant first, you will have to enable the component. To do that, be sure you have the fallowing entry in your Home Assistant configuration.yaml file:

device_tracker:

// or

default:

If this entry is already there you can start opening Ariela, if not apply for this entry, save the modifications and restart your Home Assistant server.

If everything went fine, open Ariela and you should see something similar in your home dashboard:

If your device does not appear here, do not worry it’s very possible that the Device Tracking capabilities are disabled from Ariela Settings. To enable Device Tracking from Ariela settings, just open the left menu drawer, click Settings. When the Settings screen appears, find the Device Tracking option and enable it.

2.  Update method

Ariela can use both device_tracker.see service and mobile_app API in order to create and update device tracker. Even if it is possible, enabling both services is not recommended since more traffic data will be made.

The recommended way to update the device tracker is “mobile_app” since this method can update in the background even if the Ariela is not currently running.

Note that if Ariela is not currently running in the background, updates could be made in the case of mobile_app at 10-15 minutes apart since Android OS limitation.

3. Device tracker options

3.1 Tracking Mode

Ariela offers two ways of device tracking methods:

1 – WiFi

2 – GPS

3.1.1 WiFi Mode

When using WiFi tracking mode will mean that Ariela will use currently WiFi connection to send Home Assistant location. This mode rely on the “WiFi & Zones” option which will allow you to assign a zone to a WiFi Network. This means that whenever Ariela detects you are connected to a particular WiFi network, if that network has a zone assigned, it will automatically inform Home Assistant that your current location is the location of the zone.

Note: The Ariela will automatically set the WiFi that you used at the setup to zone.home, meaning whenever Ariela detects that you are connected to that WiFi, it will automatically inform Home Assistant that your current location is home.

3.1.2 GPS Mode

The GPS mode include also the WiFi Mode features + the location that the GPS sends.

Note that the if you are using GPS mode, and Ariela detected that you are connected to a WiFi which has a zone assigned, the GPS location is ignored and the zone location it will be used instead.

3.2 Updates Period

This is the time interval at which Ariela will request GPS location. A lower value indicate that a more real time location request is made. Note that the lower the value is, the higher battery drain will be.

3.3 Accuracy

Use this setting to automatically ignore locations if the accuracy(in meters) is less than the set value. You can use this setting to always inform Home Assistant your location with the higher accuracy. Put 0(zero) to send GPS location with any accuracy.

3.4 Distance between locations

Do not send GPS location if the distance (in meters) between previous location send to Home Assistant and the new location received from GPS is less then the set value. Put 0 (zero) to send GPS location for any distance.

3.5 Priority

Use this setting in order to minimize the battery drain or increase the GPS location.

WiFi & Cellis more likely to use WIFI & Cell tower positioning, but it also depends on many other factors (such as which sources are available) and is implementation dependent. This is the medium battery consumption.
GPSrequest the most accurate locations available. This will return the finest location available but its also the most battery consumption.
No PowerNo locations will be returned unless a different client has requested location updates in which case this request will act as a passive listener to those locations. Note that if no other application installed on your phone requests location, the Ariela will not going to do any updates either. This mode is the least battery consumption from all 3 modes.

4. Battery Level

Beside location monitoring, using device tracking component Ariela will also send device battery level.

This means you can create cool sensors that will track devices battery.

Here is an example of device battery sensor:

sensor:
  - platform: template
    sensors:
      battery_samsung:
        friendly_name: My Phone Battery
        unit_of_measurement: '%'
        value_template: >-
            {%- if states.device_tracker.PHONE_DEVICEID.attributes.battery %}
                {{ states.device_tracker.PHONE_DEVICEID.attributes.battery|round }}
            {% else %}
                {{ states.sensor.battery_samsung.state }}
            {%- endif %}
        device_class: battery

Note: PHONE_DEVICEID is the entity id saved in the known_devices.yaml file.

4.  Troubleshooting

If the device still do not appear in Ariela or Home Assistant, try deleting known_devices.yaml(do not forget to make a copy of that before) and restart Home Assistant. In case of mobile_app device tracker please fallow instructions from here: https://companion.home-assistant.io/en/next/troubleshooting/beta-cleaning and also do not forget to use the “Force Mobile_app Credentials” option.

Note: The device name in Ariela, must not contain special characters like “(“, “)”, “}”, space etc.