Revert "Revert "Add sensors to the Traccar Server documentation (#31624)" (#3…"

ludeeus · web-flow · commit 22c2bfe7b276 · 2024-03-20T09:28:05.000+01:00
This reverts commit 90900be.
diff --git a/source/_integrations/traccar_server.markdown b/source/_integrations/traccar_server.markdown
@@ -81,6 +81,7 @@ These device representations in Home Assistant will have [entities](#entities) a
 The traccar server integration will create entities in with the following domains:
 
 - [Device Tracker](/integrations/device_tracker)
+- [Sensor](/integrations/sensor)
 
 For more details about each of these, see the sections below.
 
@@ -104,22 +105,10 @@ State:
 In addition to the custom attributes you can define in the Traccar Server integration options, the device tracker entity will have the following attributes:
 
 {% configuration_basic %}
-Address:
-  description: If a position update has an address associated with it, this will be the address.
-Altitude:
-  description: The altitude of the position update.
-Battery Level:
-  description: The battery level of the device if defined.
 Category:
   description: The category of the device in Traccar if defined.
-Geofence:
-  description: The name of the geofence the device is located in.
 Motion:
   description: If the device is moving or not.
-Speed:
-  description: The speed of the device.
-Status:
-  description: The status of the device in Traccar.
 Traccar ID:
   description: The ID of the device in Traccar.
 Tracker:
@@ -128,6 +117,120 @@ Tracker:
 
 {% enddetails %}
 
+### Sensor - Address
+
+The Traccar Server integration will create a [sensor](/integrations/sensor) entity for each device registered in Traccar Server to show the address reported by the Traccar Server.
+
+This entity is disabled by default.
+
+{% configuration_basic %}
+Name:
+  description: The name of the sensor will be set to what you have named it in Traccar Server followed by Address. If your device is named "Millennium Falcon", this will be "Millennium Falcon Address".
+Entity ID:
+  description: This will be a slugified version of the name.
+Unique ID:
+  description: This will be the unique ID of the device tracker in Traccar Server followed by `position_address`.
+State:
+  description: This will be the address reported by the Traccar Server, if geo detection is not configured this will be unknown`.
+{% endconfiguration_basic %}
+
+This entity does not have any attributes.
+
+### Sensor - Altitude
+
+The Traccar Server integration will create a [sensor](/integrations/sensor) entity for each device registered in Traccar Server to show the altitude reported by the Traccar Server.
+
+This entity is disabled by default.
+
+{% configuration_basic %}
+Name:
+  description: The name of the sensor will be set to what you have named it in Traccar Server followed by Altitude. If your device is named "Millennium Falcon", this will be "Millennium Falcon Altitude".
+Entity ID:
+  description: This will be a slugified version of the name.
+Unique ID:
+  description: This will be the unique ID of the device tracker in Traccar Server followed by `position_altitude`.
+State:
+  description: This will be the altitude in meters. You can select a different unit in the entity options if you want.
+{% endconfiguration_basic %}
+
+This entity does not have any attributes.
+
+### Sensor - Battery
+
+The Traccar Server integration will create a [sensor](/integrations/sensor) entity for each device registered in Traccar Server to show the remaining battery percentage reported by the Traccar Server.
+
+This entity is disabled by default.
+
+{% configuration_basic %}
+Name:
+  description: The name of the sensor will be set to what you have named it in Traccar Server followed by Battery. If your device is named "Millennium Falcon", this will be "Millennium Falcon Battery".
+Entity ID:
+  description: This will be a slugified version of the name.
+Unique ID:
+  description: This will be the unique ID of the device tracker in Traccar Server followed by `position_attributes.batteryLevel`.
+State:
+  description: This will be the battery percentage (level) as reported by the tracked device, if the device does not have a battery this will be unknown.
+{% endconfiguration_basic %}
+
+This entity does not have any attributes.
+
+### Sensor - Geofence
+
+The Traccar Server integration will create a [sensor](/integrations/sensor) entity for each device registered in Traccar Server to show the geofence reported by the Traccar Server.
+
+This entity is disabled by default.
+
+{% configuration_basic %}
+Name:
+  description: The name of the sensor will be set to what you have named it in Traccar Server followed by Geofence. If your device is named "Millennium Falcon", this will be "Millennium Falcon Geofence".
+Entity ID:
+  description: This will be a slugified version of the name.
+Unique ID:
+  description: This will be the unique ID of the device tracker in Traccar Server followed by `geofence_geofence`.
+State:
+  description: This will be geofence that the device is in, if you have overlapping geofences it will show the first one as reported by the Traccar Server.
+{% endconfiguration_basic %}
+
+This entity does not have any attributes.
+
+### Sensor - Speed
+
+The Traccar Server integration will create a [sensor](/integrations/sensor) entity for each device registered in Traccar Server to show the speed reported by the Traccar Server.
+
+This entity is disabled by default.
+
+{% configuration_basic %}
+Name:
+  description: The name of the sensor will be set to what you have named it in Traccar Server followed by Speed. If your device is named "Millennium Falcon", this will be "Millennium Falcon Speed".
+Entity ID:
+  description: This will be a slugified version of the name.
+Unique ID:
+  description: This will be the unique ID of the device tracker in Traccar Server followed by `position_speed`.
+State:
+  description: This will be the speed of the device in knots. You can select a different unit in the entity options if you want.
+{% endconfiguration_basic %}
+
+This entity does not have any attributes.
+
+### Sensor - Status
+
+The Traccar Server integration will create a [sensor](/integrations/sensor) entity for each device registered in Traccar Server to show the status reported by the Traccar Server.
+
+This entity is disabled by default.
+
+{% configuration_basic %}
+Name:
+  description: The name of the sensor will be set to what you have named it in Traccar Server followed by Status. If your device is named "Millennium Falcon", this will be "Millennium Falcon Status".
+Entity ID:
+  description: This will be a slugified version of the name.
+Unique ID:
+  description: This will be the unique ID of the device tracker in Traccar Server followed by `devcie_status`.
+State:
+  description: This will be one of the following; `offline`, `unknown`, `online`.
+{% endconfiguration_basic %}
+
+This entity does not have any attributes.
+
 ## Examples
 
 So you set up the integration and it pulled in all your devices. Now what? Below are some examples of what you can do with the data provided by Traccar Server integration.
@@ -138,7 +241,7 @@ In this section you will find some example automations that you can use to get s
 
 #### Do something when a device enters a geofence
 
-The allows you to do something when the device `device_tracker.millennium_falcon` enters the defined geofence.
+The allows you to do something when the device "Millennium Falcon" enters the defined geofence.
 
 {% my blueprint_import badge blueprint_url="https://www.home-assistant.io/blueprints/integrations/traccar_server_device_enter_geofence.yaml" %}
 
@@ -147,8 +250,7 @@ The allows you to do something when the device `device_tracker.millennium_falcon
 ```yaml
 trigger:
   - platform: state
-    entity_id: device_tracker.millennium_falcon
-    attribute: geofence
+    entity_id: sensor.millennium_falcon_geofence
     to: 'Tatooine'
 action:
   ...
@@ -158,7 +260,7 @@ action:
 
 #### Do something when a device are speeding
 
-The allows you to do something when the device `device_tracker.millennium_falcon` exceeds a defined speed.
+The allows you to do something when the device "Millennium Falcon" exceeds a defined speed.
 
 {% my blueprint_import badge blueprint_url="https://www.home-assistant.io/blueprints/integrations/traccar_server_device_speed_limit.yaml" %}
 
@@ -167,14 +269,13 @@ The allows you to do something when the device `device_tracker.millennium_falcon
 ```yaml
 trigger:
   - platform: numeric_state
-    entity_id: device_tracker.millennium_falcon
-    attribute: speed
+    entity_id: sensor.millennium_falcon_speed
     above: 1337
 action:
   ...
 ```
 
-If you want to include the speed in a notification, you can use the `{{ trigger.to_state.attributes.speed }}` template.
+If you want to include the speed in a notification, you can use the `{{ trigger.to_state.state }}` template.
 
 Partial example:
 
@@ -184,7 +285,7 @@ trigger:
 action:
   - service: notify.notify
     data:
-      message: "The current speed of the Millennium falcon is {{ trigger.to_state.attributes.speed }}!"
+      message: "The current speed of the Millennium falcon is {{ trigger.to_state.state }}!"
 ```
 
 {% enddetails %}
diff --git a/source/blueprints/integrations/traccar_server_device_enter_geofence.yaml b/source/blueprints/integrations/traccar_server_device_enter_geofence.yaml
@@ -8,17 +8,17 @@ blueprint:
   domain: automation
   author: ludeeus
   homeassistant:
-    min_version: 2024.2.0
+    min_version: 1970.1.1 # Placeholder that need replacement but the version is currently not known
   input:
     devices:
-      name: Devices
-      description: The Traccar device(s) trackers you want to act upon
+      name: Device geofences
+      description: The Traccar sensor that holds the geofence you want to act upon
       selector:
         entity:
           multiple: true
           filter:
             integration: "traccar_server"
-            domain: "device_tracker"
+            domain: "sensor"
     geofence:
       name: Geofence
       description: The name of the geofence
@@ -46,7 +46,6 @@ blueprint:
 trigger:
   - platform: state
     entity_id: !input devices
-    attribute: geofence
     to: !input geofence
 condition: !input conditions
 action: !input actions
diff --git a/source/blueprints/integrations/traccar_server_device_speed_limit.yaml b/source/blueprints/integrations/traccar_server_device_speed_limit.yaml
@@ -7,17 +7,17 @@ blueprint:
   domain: automation
   author: ludeeus
   homeassistant:
-    min_version: 2024.2.0
+    min_version: 1970.1.1 # Placeholder that need replacement but the version is currently not known
   input:
     devices:
       name: Devices
-      description: The Traccar device(s) trackers you want to act upon
+      description: The Traccar sensor that holds the speed you want to act upon
       selector:
         entity:
           multiple: true
           filter:
             integration: "traccar_server"
-            domain: "device_tracker"
+            domain: "sensor"
     speed:
       name: Geofence
       description: The speed limit
@@ -45,7 +45,6 @@ blueprint:
 trigger:
   - platform: numeric_state
     entity_id: !input devices
-    attribute: speed
     above: !input speed
 condition: !input conditions
 action: !input actions
