From 0dd9c10e3848ccb3bc17e4ad36e261c4cf9d64b0 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 13 Sep 2024 07:06:50 +0200 Subject: [PATCH] Device tracker: rephrase section on state (#34687) * Device tracker: rephrase section on state * Implement review feedback * Add note that parameter only applies to YAML configs * Rephrase * Apply paralellism * dito * Simplify * Rephrase * Im Co-authored-by: Martin Hjelmare --------- Co-authored-by: Martin Hjelmare --- source/_integrations/device_tracker.markdown | 41 ++++++++++++------ .../device_tracker/state_device_tracker.png | Bin 0 -> 51513 bytes 2 files changed, 28 insertions(+), 13 deletions(-) create mode 100644 source/images/integrations/device_tracker/state_device_tracker.png diff --git a/source/_integrations/device_tracker.markdown b/source/_integrations/device_tracker.markdown index 873158a40a3..5672f4441d7 100644 --- a/source/_integrations/device_tracker.markdown +++ b/source/_integrations/device_tracker.markdown @@ -96,23 +96,38 @@ In the example above, `devicename` refers to the detected name of the device. F | `picture` | None | A picture that you can use to easily identify the person or device. You can also save the image file in a folder "www" in the same location (can be obtained from developer tools) where you have your `configuration.yaml` file and just use `picture: /local/favicon-192x192.png`. The path 'local' is mapped to the 'www' folder you create. | | `icon` | mdi:account | An icon for this device (use as an alternative to `picture`). | | `gravatar` | None | An email address for the device's owner. If provided, it will override `picture`. | -| `track` | [uses platform setting] | If `yes`/`on`/`true` then the device will be tracked. Otherwise its location and state will not update. | -| `consider_home` | [uses platform setting] | Seconds to wait till marking someone as not home after not being seen. Allows you to override the global `consider_home` setting from the platform configuration on a per device level. | +| `track` | [uses platform setting] | If `yes`/`on`/`true` then the device will be tracked. Otherwise its location and state will not update. The `track` setting only applies for devices that were configured directly in YAML. | +| `consider_home` | [uses platform setting] | Seconds to wait till marking someone as not home after not being seen. Allows you to override the global `consider_home` setting from the platform configuration on a per device level. The `consider_home` setting only applies for devices that were configured directly in YAML. | -## Device states +## The state of a tracked device -The state of your tracked device will be `'home'` if it is in the [home zone](/integrations/zone#home-zone), detected by your network or Bluetooth based presence detection. If you're using a presence detection method that includes coordinates then when it's in a zone the state will be the name of the zone (case sensitive). When a device isn't at home and isn't in any zone, the state will be `'not_home'`. +The type of state a device tracker can have depends on whether it uses GPS or a router as the data source. + +A device tracker with **GPS** as a source can have any number of string states. The integration can return one of the following options: + +- Report GPS coordinates. The coordinates are then matched to a zone (which is set as state). If the home zone is matched, the state will be **Home**. If no zone was matched the state will be **Not home**. +- Report a location. This could be any string which is set as state. + +A device tracker with **router** as a source can have one of two states: **Home**, or **Not home**. + +- **Home**: Your tracked device is in the [home zone](/integrations/zone#home-zone), detected by your network or Bluetooth-based presence detection. If you're using a presence detection method that includes coordinates: when it's in a zone, the state equals the name of the zone (case sensitive). +- **Not home**: When a device isn't at home and isn't in any zone. + +

+Screenshot showing the state of a device tracker entity in the developer tools +Screenshot showing the state of a device tracker entity in the developer tools. +

## `device_tracker.see` action The `device_tracker.see` action can be used to manually update the state of a device tracker: -| Data attribute | Optional | Description | -| ---------------------- | -------- | --------------------------------------------------------------------------------------- | -| `dev_id` | no | The `object_id`, for example `tardis` for `device_tracker.tardis` | -| `location_name` | yes | The location, `home`, `not_home`, or the name of the zone | -| `host_name` | yes | The hostname of the device tracker | -| `mac` | yes | The MAC address of the entity (only specify if you're updating a network based tracker) | -| `gps` | yes | If you're providing a location, for example `[51.513845, -0.100539]` | -| `gps_accuracy` | yes | The accuracy of the GPS fix | -| `battery` | yes | The battery level of the device | +| Data attribute | Optional | Description | +| --------------- | -------- | --------------------------------------------------------------------------------------- | +| `dev_id` | no | The `object_id`, for example `tardis` for `device_tracker.tardis` | +| `location_name` | yes | The location, `home`, `not_home`, or the name of the zone | +| `host_name` | yes | The hostname of the device tracker | +| `mac` | yes | The MAC address of the entity (only specify if you're updating a network based tracker) | +| `gps` | yes | If you're providing a location, for example `[51.513845, -0.100539]` | +| `gps_accuracy` | yes | The accuracy of the GPS fix | +| `battery` | yes | The battery level of the device | diff --git a/source/images/integrations/device_tracker/state_device_tracker.png b/source/images/integrations/device_tracker/state_device_tracker.png new file mode 100644 index 0000000000000000000000000000000000000000..f6dbf05a7294b1985bcc60ded85979b6e2803c36 GIT binary patch literal 51513 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 bS-T>Ej*ZZF literal 0 HcmV?d00001