MQTT-spezifisches
Befehl | Wert | Beschreibung |
---|---|---|
ButtonRetain | ||
ButtonRetain | 0 / off | (default) Abschalten des Speicherns des Schalterzustands im MQTT-Broker |
ButtonRetain | 1 / on | Legt das Geräte-Topic (MQTT-Gerätename) auf den Einschalttaster und veranlasst, dass der Schalterzustand im MQTT-Broker gespeichert wird, wenn der Einschalttaster gedrückt wird |
ButtonTopic | ||
ButtonTopic | 0 / off | Schaltet das Aussenden (publish) des MQTT-Button-Topics ab |
ButtonTopic | 1 | Setzt das MQTT-Button-Topic auf das Geräte-Topic zurück |
ButtonTopic | Setzt das MQTT-Button-Topic auf den eingegebenen Namen (max. 32 Zeichen, Leerstellen, Sonderzeichen und deutsche Umlaute vermeiden). In diesem Fall wird beim Drücken der Einschalttaste nicht das Geräte-Topic an den MQTT-Broker gesendet sondern das Button-Topic |
|
FullTopic | Zeigt das aktuelle FullTopic an in der Regel %prefix%/%topic%, %prefix% bedeutet Nachrichtenart stat, tele oder cmnd (Zustand, Sensordaten oder Auftrag) und %topic% ist die Gerätebezeichnung, falls gesetzt |
|
FullTopic | 1 | Setzt das MQTT fulltopic auf die Einstellungen der user_config.h (MQTT_FULLTOPIC) zurück und führt einen Neustart aus |
FullTopic | Definiert ein neues MQTT fulltopic (max. 100 Zeichen) mit optionaler Nutzung von %topic% und %prefix% (oder auch nicht) und führt einen Neustart aus |
|
GroupTopic | Zeigt das Grouptopic an Kommentar: Ein Grouptopic ist ein zweites Geräte-Topic, das an mehrere Geräte namensgleich vergeben werden kann. Alle Geräte mit demselben Grouptopic können durch einen MQTT-Befehl gemeinsam geschaltet werden. Beispiel: cmnd/GROUPTOPIC/power -m 1 |
|
GroupTopic | 1 | Setzt das MQTT Grouptopic zurück auf die Einstellungen der user_config.h (MQTT_GRPTOPIC) und startet das Gerät neu |
GroupTopic | Setzt das MQTT Grouptopic (max. 32 Zeichen) und startet das Gerät neu |
|
MqttClient | Zeigt den individuellen Namen des auf dem Sonoff laufenden MQTT-Clients an. Dieser Name setzt sich standardmäßig aus der Zeichenkette DVES_ und der Variablen %06X zusammen. Diese steht für die letzten 6 Zeichen der MAC-Adresse (Hardware-Adresse des WLAN-Interfaces). Mit diesem Namen identifiziert sich der MQTT-Client beim MQTT-Broker. |
|
MqttClient | 1 | Setzt den MQTT-Client zurück auf die Einstellungen der user_config.h (MQTT_CLIENT_ID) und starte das Gerät neu |
MqttClient | Setzt den Namen des MQTT-Client (max. 32 Zeichen, Sonderzeichen und deutsche Umlaute vermeiden) und startet das Gerät neu. Man kann die Wildcard-Zeichen %06X benutzen. Sie werden dirch die letzen sechs Ziffern der MAC-Adresse ersetzt |
|
MqttFingerprint | Zeigt den aktuellen Fingerprint des MQTT-Clients an; wird für die verschlüsselte Übertragung (TLS) der Nachrichten zwischen Broker und Client benutzt. |
|
MqttFingerprint | (nur TLS) Setzt einen neuen Fingerprint aus 20 Leerstellen getrennten Bytes (max. 59 Zeichen) | |
MqttHost | Zeigt die IP-Nummer des aktuellen MQTT-Hosts (= MQTT-Broker) an |
|
MqttHost | 0 | Leert das MQTT-Host-Feld und sucht nach dem mDNS-Verfahren (z. B. Bonjour, Zeroconf) einen MQTT-Host |
MqttHost | 1 | Setzt den MQTT-Host auf den Wert der user_config.h (MQTT_HOST) und startet das Gerät neu |
MqttHost | Setzt den Namen des MQTT-Host (max. 32 Zeichen, Sonderzeichen und deutsche Umlaute vermeiden) | |
MqttPassword | Zeigt das MQTT-Passwort an |
|
MqttPassword | 0 | Entfernt das MQTT-Passwort |
MqttPassword | 1 | Setzt das MQTT-Passwort zurück auf die Einstellungen der user_config.h (MQTT_PASS) und starte das Gerät neu. |
MqttPassword | Setzt das MQTT-Passwort (max. 32 Zeichen, Sonderzeichen und deutsche Umlaute vermeiden) und startet das Gerät neu. |
|
MqttPort | Zeigt den MQTT-Port an (default: 1883) |
|
MqttPort | 1 | Setzt den MQTT-Port zurück auf die Einstellung aus der user_config.h (MQTT_PORT) und starte das Gerät neu |
MqttPort | 2..32766 | Setzt den MQTT-Port auf die angegeben Nummer. Achtung: Der MQTT-Broker muss dann ebenfalls auf diesen Port geleitet werden. |
MqttResponse | Wird (noch?) nicht unterstützt |
|
MqttRetry | Zeigt die Wartezeit in Sekunden zwischen zwei Versuchen der Verbindungsaufnahme zum MQTT-Broker an |
|
MqttRetry | 10 | (default) Setzt die Wartezeit zwischen zwei Verbindungsversuchen zum MQTT-Broker auf den Standardwert 10 Sekunden |
MqttRetry | 10..32000 | Setzt die Wartezeit zwischen zwei Verbindungsversuchen zum MQTT-Broker auf den angegebenen Wert in Sekunden |
MqttUser | Zeigt den Benutzernamen des MQTT-Clients an (falls gesetzt) |
|
MqttUser | 0 | Löscht den MQTT-Benutzernamen |
MqttUser | 1 | Setzt den MQTT-Benutzernamen zurück aufdie Einstellung der user_config.h (MQTT_USER) und startet das Gerät neu |
MqttUser | Setzt den MQTT-Benutzernamen (max. 32 Zeichen, Sonderzeichen und deutsche Umlaute vermeiden) und startet das Gerät neu. | |
PowerRetain | Zeigt an, ob der Power-Status (Schalter steht auf AN oder AUS) dauerhaft im MQTT-Broker gespeichert wird. Falls der Wert gespeichert wird, bekommt jeder Client, der sich beim MQTT-Broker anmeldet, diesen Status mitgeteilt. |
|
PowerRetain | 0 / off | (default) Die Power-Status-Information wird nicht dauerhaft im MQTT-Broker gespeichert |
PowerRetain | 1 / on | Die Power-Status-Information wird im MQTT-Broker gespeichert |
Prefix1 | Standardmässig ist das Prefix1 das Kommando-Präfix "cmnd". cmnd wird benötigt, um Zustände zu ändern (An- Ausschalten, Parameter übertragen, etc.). Es ist eine Nachrichten-Subskription oder ein -Abonnenment beim MQTT-Broker |
|
Prefix1 | 1 | Setzt das Prefix1 zurück auf den in der user_config.h (SUB_PREFIX) angegebenen Wert starte das Gerät neu |
Prefix1 | <Text> | Setzt ein anderes MQTT Kommando-Empfangs-Präfix (subscription prefix) (max. 10 Zeichen, keine Leerstellen, keine Umlaute) und startet das Gerät neu |
Prefix2 | Standardmässig ist das Prefix2 das Status-Präfix "stat". stat wird benötigt, um Zustände an den MQTT-Broker mitzuteilen | |
Prefix2 | 1 | Setzt das MQTT Status-Versende-Präfix zurück auf den in der user_config.h (PUB_PREFIX) angegebenen Wert und startet das Gerät neu. Prefix2 ist eine Nachrichten-Publikation an den MQTT-Broker |
Prefix2 | Setzt ein anderes MQTT-Status-Versende-Präfix (subscription prefix) (max. 10 Zeichen, keine Leerstellen, keine Umlaute) und startet das Gerät neu | |
Prefix3 | Standardmässig ist das Prefix3 das Telemetrie-Präfix "tele". tele wird benötigt, um Sensor- und Zählerdaten zu übertragen. Es ist eine Nachrichten-Publikation an den MQTT-Broker | |
Prefix3 | 1 | Setzt das MQTT-Telemetrie-Präfix zurück auf den in der user_config.h (PUB_PREFIX2) angegebenen Wert und startet das Gerät neu. Prefix3 ist eine Nachrichten-Publikation an den MQTT-Broker |
Prefix3 | Setzt ein anderes MQTT-Telemetrie-Präfix (subscription prefix) (max. 10 Zeichen, keine Leerstellen, keine Umlaute) und startet das Gerät neu | |
Publish | Dient zum Versenden beliebiger Nachrichten mit beliebiegen Topics an den MQTT-Broker |
|
SensorRetain | ||
SensorRetain | 0 / off | (default) Disable use of sensor MQTT retain flag |
SensorRetain | 1 / on | Enable MQTT retain flag on message tele/sonoff/SENSOR |
SetOption2 | ||
SetOption2 | 0 / off | (default) Do not show units to messages |
SetOption2 | 1 / on | Add units to messages |
SetOption3 | ||
SetOption3 | 0 / off | Disable MQTT |
SetOption3 | 1 / on | Enable MQTT |
SetOption4 | ||
SetOption4 | 0 / off | Return response as RESULT topic |
SetOption4 | 1 / on | Return response as Command topic |
SetOption10 | ||
SetOption10 | 0 / off | (default) When topic changes drop retained old topic LWT |
SetOption10 | 1 / on | When topic changes send old topic retained LWT offline |
StateText1 | ||
StateText1 | Set Off state text (10 chars max) | |
StateText2 | ||
StateText2 | Set On state text (10 chars max) | |
StateText3 | ||
StateText3 | Set Toggle state text (10 chars max) | |
StateText4 | ||
StateText4 | Set button Hold state text (10 chars max) | |
SwitchRetain | ||
SwitchRetain | 0 / off | (default) Disable use of MQTT retain flag |
SwitchRetain | 1 / on | Set ButtonTopic to Topic and enable MQTT retain flag on button press |
SwitchTopic | ||
SwitchTopic | 0 / off | Disable use of MQTT switch topic |
SwitchTopic | 1 | Set MQTT switch topic to Topic |
SwitchTopic | Set MQTT switch topic (32 chars max) | |
TelePeriod | ||
TelePeriod | 0 / off | Disable telemetry messages |
TelePeriod | 1 | Reset telemetry period to user_config.h (TELE_PERIOD) |
TelePeriod | Set telemetry period between 10 and 3600 seconds | |
Topic | ||
Topic | 1 | Reset MQTT topic to user_config.h (MQTT_TOPIC) and restart |
Topic | Set MQTT topic (32 chars max) AND button topic and restart | |
Units |