mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-20 07:46:52 +00:00
Update MQTT Device Tracker mapping payloads to zones/states (#10581)
* Add action_topic and action_template parameters to configuration * updated possible action_topic values to be more accurate * update MQTT device tracker documentation to add custom payload to location mapping parameter * update new parameter name * revert MQTT climate changes that are submitted in separate PR * support for payload_home, payload_not_home, and payload_custom * fix grammar * move optional fields to complete configuration example * fix tabs * ✏️ Tweak * fix parameter type as designed * change parameter types * match formatting of original doc * match formatting of original doc * match formatting of original doc * update docs based on code changes * change parameter name for custom mapping payloads to other zones and improve description * update complete configuration example to reflect parameter name change * revert description for 'devices' and simplify explanation for 'payload_other_zones' * fix qos parameter value in example * remove 'payload_other_zones' per balloobs review * final cleanup * ✏️ Manual fix bad rebase * ✏️ Whitespace * ✏️ Whitespace Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com> Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
parent
703be08638
commit
e8e9af12e3
@ -33,8 +33,31 @@ qos:
|
|||||||
description: The QoS level of the topic.
|
description: The QoS level of the topic.
|
||||||
required: false
|
required: false
|
||||||
type: integer
|
type: integer
|
||||||
|
payload_home:
|
||||||
|
description: The payload value that represents the 'home' state for the device.
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: 'home'
|
||||||
|
payload_not_home:
|
||||||
|
description: The payload value that represents the 'not_home' state for the device.
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: 'not_home'
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
## Complete example configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Complete configuration.yaml entry
|
||||||
|
device_tracker:
|
||||||
|
devices:
|
||||||
|
paulus_oneplus: 'location/paulus'
|
||||||
|
annetherese_n4: 'location/annetherese'
|
||||||
|
qos: 1
|
||||||
|
payload_home: 'present'
|
||||||
|
payload_not_home: 'not present'
|
||||||
|
```
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
Example JSON you can publish to the topic (e.g., via mqtt.publish service):
|
Example JSON you can publish to the topic (e.g., via mqtt.publish service):
|
||||||
|
Loading…
x
Reference in New Issue
Block a user