opensourcemirror
/
WLEDwiki
mirror of https://github.com/Aircoookie/WLED.wiki.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Page deprecation notice

This commit is contained in:
Christian Schwinne 2021-10-18 12:59:30 +02:00
parent 32c0e87f8e
commit 47d317a3b4
1 changed files with 2 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
MQTT.md
View File

@ -1,42 +1,3 @@
**Notice:** The MQTT implementation is currently being **restructured** to provide a better experience for users of Home Assistant and other automation software. **This will be a breaking change**. For details regarding the rework, please see [#207](https://github.com/Aircoookie/WLED/issues/207)!
Please see https://kno.wled.ge/interfaces/mqtt/ for this information.
WLED versions from 0.8.0 up are able to connect to an MQTT broker for smart home control.
Connection to both domains and IP servers is supported on port 1883.
Secure connections are not currently supported. I recommend only connecting to local MQTT brokers.
In v0.8.4-0.8.6 only, WLED supports MQTT autodiscovery by the HomeAssistant software. This has been removed because of bootloop issues and in favor of the native HomeAssistant integration.
WLED will subscribe to up to six topics to change the state of the lights.
- **[mqttDeviceTopic]**\
-> Send brightness as ASCII number 0-255 or the strings "ON", "OFF", and "T" (for toggle)
- **[mqttDeviceTopic]/col**\
-> Send color as HEX (#WWRRGGBB or #RRGGBB) or 32bit DEC. Hex has '#','h' or 'H' as prefix.
- **[mqttDeviceTopic]/api**\
-> Send an API call (using the [HTTP API](https://github.com/Aircoookie/WLED/wiki/HTTP-request-API) or, since 0.11, [JSON API](https://github.com/Aircoookie/WLED/wiki/JSON-API) syntax). You may omit the "win" and just send e.g. "FX=73"
- **[mqttGroupTopic]**
- **[mqttGroupTopic]/col**
- **[mqttGroupTopic]/api**
The topic paths [mqttDeviceTopic] and [mqttGroupTopic] are customizable in Sync settings.
If [mqttGroupTopic] is left empty, it will not subscribe to anything. An empty [mqttDeviceTopic] will instead be replaced with the default "wled/macaddr".
[mqttDeviceTopic] is intended to be unique to one WLED device and just control that device.
[mqttGroupTopic] is intended to control a group of or all WLED devices.
UDP notifications will be sent just as if the change was done via the UI or HTTP API.
Additionally, on light change, WLED will publish to 3 topics for MQTT clients to query the state of the light.
- **[mqttDeviceTopic]/g**\
-> Contains current brightness as ASCII number 0-255
- **[mqttDeviceTopic]/c**\
-> Contains current color as HEX (#RRGGBB if white is 0, else #WWRRGGBB)
- **[mqttDeviceTopic]/v**\
-> Contains XML API response (same as HTTP API)
There is support for client ID and authentication, but this is presently transmitted over an unencrypted connection, so please **do not** use the same password for other services.
**Attention:** The maximal length of a MQTT messages for WLED is 1024 bytes.
This wiki is now deprecated. Please consider contributing to kno.wled.ge by making improvements as a pull request. Thank you!