diff --git a/Domoticz.md b/Domoticz.md index a64535eb..f71a6839 100644 --- a/Domoticz.md +++ b/Domoticz.md @@ -26,10 +26,6 @@ Configure MQTT and Virtual Sensor hardware Sonoff Sonoff provides several ways of configuring Domoticz parameters. -- Make updates to the Domoticz section of ```user_config.h``` but remember that these changes are only propagated if you also change the CFG_HOLDER define. This is NOT my preferred way of configuring. - 1. Set ```DOMOTICZ_IN_TOPIC``` to ```domoticz/in``` as hardcoded in Domoticz - 2. Set ```DOMOTICZ_OUT_TOPIC``` to ```domoticz/out``` as hardcoded in Domoticz - 3. Configure ```DOMOTICZ_RELAY_IDX1``` to the value read in step 4.1 - Use the webinterface and select ```Configuration - Configure Domoticz``` 1. Set ```In topic``` to ```domoticz/in``` as hardcoded in Domoticz 2. Set ```Out topic``` to ```domoticz/out``` as hardcoded in Domoticz diff --git a/MQTT-Features.md b/MQTT-Features.md index 5ca59981..68c41be2 100644 --- a/MQTT-Features.md +++ b/MQTT-Features.md @@ -2,9 +2,9 @@ Sonoff responds to the following MQTT commands using MQTT Topic for ```cmnd/sono - the relay can be controlled with ```cmnd/sonoff/power on```, ```cmnd/sonoff/power off``` or ```cmnd/sonoff/power toggle```. The LED will blink twice and sends a MQTT status message like ```stat/sonoff/POWER ON```. The same function can be initiated with ```cmnd/sonoff/light on```. -- starting with version 3.0.0 the power state message can be sent with the retain flag set. Enable this with ```cmnd/sonoff/PowerRetain on```. +- The power state message can be sent with the retain flag set. Enable this with ```cmnd/sonoff/PowerRetain on```. -- starting with version 3.0.0 for sonoff dual the relays need to be addressed with ```cmnd/sonoff/power1 toggle``` and ```cmnd/sonoff/power2 toggle```. From version 2.0.0 until version 3.0.0 the relays could be addressed with ```cmnd/sonoff/1/power toggle``` and ```cmnd/sonoff/2/power toggle```. +- For sonoff dual the relays need to be addressed with ```cmnd/sonoff/power1 toggle``` and ```cmnd/sonoff/power2 toggle```. - the MQTT topic can be changed with ```cmnd/sonoff/topic sonoff1``` which reboots sonoff and makes it available for MQTT commands like ```cmnd/sonoff1/power on```. @@ -16,10 +16,10 @@ Sonoff responds to the following MQTT commands using MQTT Topic for ```cmnd/sono - The button can send a MQTT message to the broker that in turn will switch the relay. To configure this you need to perform ```cmnd/sonoff/ButtonTopic sonoff``` where sonoff equals to Topic. The message can also be provided with the retain flag by ```cmnd/sonoff/ButtonRetain on```. -- Sonoff Pow status can be retreived with ```cmnd/sonoff/status 8``` or periodically every 5 minutes using ```cmnd/sonoff/TelePeriod 300```. If units appended to the message are needed execute command ```cmnd/sonoff/MqttUnits on```. +- Sonoff Pow status can be retreived with ```cmnd/sonoff/status 8``` or periodically every 5 minutes using ```cmnd/sonoff/TelePeriod 300```. If units appended to the message are needed execute command ```cmnd/sonoff/Units on```. - When a Sonoff Pow threshold like PowerLow has been met a message ```tele/sonoff/POWER_LOW ON``` will be sent. When the error is corrected a message ```tele/sonoff/POWER_LOW OFF``` will be sent. -Most MQTT commands will result in a status feedback like ```stat/sonoff/POWER ON``` and/or {"POWER":"ON"} depending of ```cmnd/sonoff/MessageFormat Legacy|JSON```. The power state will ALWAYS be returned in Legacy mode (for easy triggering by home automation tool) and optionally in JSON. +While most MQTT commands will result in a message in JSON format the power status feedback will always be returned like ```stat/sonoff/POWER ON``` too. -Telemetry data will be sent by prefix ```tele``` like ```tele/sonoff/TEMPERATURE 24.7``` +Telemetry data will be sent by prefix ```tele``` like ```tele/sonoff/TELEMETRY {"Temperature":"24.7"}```