MQTT Device Tracker
The mqtt
device tracker platform allows you to detect presence by monitoring an MQTT topic for new locations. To use this platform, you specify a unique topic for each device.
Configuration
To use this device tracker in your installation, add the following to your configuration.yaml
file:
# Example configuration.yaml entry
device_tracker:
- platform: mqtt
devices:
paulus_oneplus: 'location/paulus'
annetherese_n4: 'location/annetherese'
Configuration Variables
The payload value that represents the ‘home’ state for the device.
The payload value that represents the ‘not_home’ state for the device.
Attribute of a device tracker that affects state when being used to track a person. Valid options are gps
, router
, bluetooth
, or bluetooth_le
.
Complete example configuration
# Complete configuration.yaml entry
device_tracker:
- platform: mqtt
devices:
paulus_oneplus: 'location/paulus'
annetherese_n4: 'location/annetherese'
qos: 1
payload_home: 'present'
payload_not_home: 'not present'
source_type: bluetooth
Usage
Example JSON you can publish to the topic (e.g., via mqtt.publish service):
{
"topic": "location/paulus",
"payload": "home"
}