cotugno/zigbee2mqtt
2
Fork 0
mirror of https://github.com/Koenkk/zigbee2mqtt.git synced 2024-11-17 10:58:31 -07:00
Code Issues Packages Projects Releases Wiki Activity
3a0fe60b22
zigbee2mqtt/docs/configuration/device_specific_configuration.md
Koen Kanters 590a897e9b Move docs from wiki to github pages.
2018-12-13 20:54:14 +01:00

1.1 KiB
Raw Blame History

Device specific configuration

The configuration.yaml allows to set device specific configuration. The following options are available:

  • friendly_name: Used in the MQTT topic of a device. By default this is the device ID (e.g. 0x00128d0001d9e1d2).
  • retain: Retain MQTT messages of this device.
  • occupancy_timeout: Timeout (in seconds) after the occupancy: false message is sent, only available for occupany sensors. If not set, the timeout is 90 seconds. When set to 0 no occupancy: false is send.
  • qos: QoS level for MQTT messages of this device. What is QoS?

Example:

devices:
  '0x00158d0001d82999':
    friendly_name: 'my_occupancy_sensor'
    retain: true
    occupancy_timeout: 20
    qos: 1

Once finished, restart Zigbee2mqtt.

The bridge will log the friendly_name on startup, e.g.:

Currently 2 devices are joined:
switch_bedroom (0x00158d0001d8e1d2): WXKG01LM - Xiaomi MiJia wireless switch (EndDevice)
sensor_bedroom (0x00158d0001b79111): WSDCGQ01LM - Xiaomi MiJia temperature & humidity sensor (EndDevice)