Kommandos
Dies ist eine Übersetzung von Github in der Originalversion von Theo Arends
Die Sonoff-Tasmota-Firmware bietet drei leistungsstarke Mensch-Maschine-Schnittstellen: MQTT, Web und Seriell.
I - MQTT
MQTT ist die empfohlene Interaktionsschnittstelle. Alle relevanten Details zu MQTT finden Sie in der MQTT Essentials Artikelserie. Sie benötigen einen MQTT-Broker und sollten einen unabhängigen MQTT-Client zur Fehlerbehebung verwenden. Das Einrichten der grundlegenden MQTT-Umgebung ist nicht Gegenstand dieses Artikels.
Bitte lesen Sie die spezifischen MQTT Features Wiki-Seite, um mehr zu erfahren.
Beispiel:
Ein Sonoff-Tasmota-Modul wurde mit dem FullTopic- Tasmota /% topic% /%-Präfix% / und der Themeneinstellung "sonoff-mylight" konfiguriert. Wir möchten das Licht ein- und ausschalten.
Wenn Sie die nachstehende Befehlstabelle betrachten, können Sie mehr über die Power und die Umschalt Option erfahren. "Power1" steht für das erste Relais.
- Statusabfrage:
Code
tasmota/sonoff-mylight/cmnd/Power1 ← //empty message ↳ tasmota/sonoff-mylight/stat/RESULT → {"POWER1":"OFF"} ↳ tasmota/sonoff-mylight/stat/POWER1 → OFF
Wir sehen, dass das erste Relais des Moduls derzeit ausgeschaltet ist.
- Senden eines Befehls:
Code
tasmota/sonoff-mylight/cmnd/Power1 ← "TOGGLE" ↳ // Power for relay 1 is toggled ↳ tasmota/sonoff-mylight/stat/RESULT → {"POWER1":"ON"} ↳ tasmota/sonoff-mylight/stat/POWER1 → ON
Wir haben den Umschaltbefehl gesendet und die Bestätigung des neuen Status erhalten.
Randbemerkung: Bei vielen Befehlen ist ein leerer Wert eine Abfrage. Wenn Sie mosquitto_pub verwenden, können Sie mit der Befehlszeilenoption -n einen leeren Wert ausgeben. Wenn Ihr MQTT-Client keinen leeren Wert ausgeben kann, könne Sie stattdessen das einzelne Zeichen "?" verwenden.
I.I - Web
Befehle können über HTTP-Anforderungen ausgeführt werden, zum Beispiel:
http://sonoff/cm?cmnd=Power%20TOGGLE
http://sonoff/cm?cmnd=Power%20On
http://sonoff/cm?cmnd=Power%20off
http://sonoff/cm?user=admin&password=joker&cmnd=Power%20Toggle
Wenn Sie ein Kennwort für den Zugriff auf die Web-Benutzeroberfläche festgelegt haben, muss dieses (im Klartext) in der URL der HTTP-Anforderung enthalten sein, z. B.
I.II - Serial
Die serielle Schnittstelle ist auf 115200 Bit / s eingestellt, mit Ausnahme von Sonoff Dual und der Sonoff RF Bridge, da ist sie auf 19200 Bit / s eingestellt.
I.III - Backlog verwenden
Ab Version 5.3.0 ist eine Backlog-Funktion verfügbar, mit der mehrere Befehle hintereinander ausgeführt werden können (Verkettung). Maximale Befehle pro Anforderung:
- Versionen <5.12.0i = 16 / Befehle
- Versionen> = 5.12.0i = 30 / Befehle
Beispiele für diesen Befehl sind:
Backlog status 1; power 2; delay 20; power 2; status 4
Backlog ssid1 myssid; password1 mypassword
http://sonoff/cm?user=admin&password=joker&cmnd=Backlog%20Power%20Toggle;Power1%20off
II - Befehlsübersicht
Die folgende Befehlstabellen stehen zur Verfügung:
- Main
- Sensor
- Timers
- Management
- Wifi
- MQTT
- Serial Bridge
- SetOption Overview
- Logging
- Sonoff Pow, Sonoff S31, Shelly2 and Pzem004T specific
- WS2812, AiLight, Sonoff Led, B1, BN-SZ01, H801 and MagicHome
- WS2812 led string specific
- Sonoff RF Bridge 433
- Domoticz
- IR remote control
III - Main
Kommando |
Wert |
Beschreibung |
---|---|---|
BlinkCount |
Zeigt die aktuelle Anzahl Ein-Aus-Schaltvorgänge. Auslösen des Blinkmodus durch power<x> 3 | |
BlinkCount |
0 |
Setzt die Anzahl Ein-Aus-Schaltungen auf unendlich. Beendigung durch power<x> 0 oder power<x> 1. Der Blinkmodus wird durch den Befehl power<x> 3 ausgelöst. |
BlinkCount |
1..32000 |
Setzt die Anzahl der Ein-Aus-Schaltvorgänge, die durch power<x> 3 ausgelöst werden. Anschließend wird der durch poweronstate definierte Zustand eingenommen. |
BlinkTime |
Zeigt die Intervall-Länge der An- und Ausphase in Zehntelsekunden an. |
|
BlinkTime |
2..3600 |
Setzt die Länge des Blinkintervalls auf den angegeben Wert (in Zehntelsekunden). |
ButtonDebounce |
(seit 6.1.1.12) Zeigt die aktuelle Entprellzeit des Buttons in Millisekunden an |
|
ButtonDebounce |
40..1000 |
(seit 6.1.1.12) Setzt die Entprellzeit des Buttons auf den angegebenen Wert in Millisekunden |
FanSpeed |
(nur für iFan02) Zeige aktuelle Ventilatorgeschwindigkeit. |
|
FanSpeed |
0 / off |
(nur für iFan02) Ventilator aus. |
FanSpeed |
1..3 |
(nur für iFan02) Stellt die Ventilatorgeschwindigkeit ein |
FanSpeed |
+ |
(seit 6.1.1.4) (nur für iFan02) Erhöhe Ventilatorgeschwindigkeit. |
FanSpeed |
- |
(seit 6.1.1.4) (nur für iFan02) Verlangsame Ventilatorgeschwindigkeit. |
LedPower |
Zeige aktuellen LED Schaltzustand als an oder aus. |
|
LedPower |
0 / off |
Schalte LED und Led-Status aus. |
LedPower |
1 / on |
Schalte LED an und LED-Status aus. |
LedState |
Zeige aktuellen LED Status von 1 bis 7 |
|
LedState |
0 / off |
Schalte LED Benutzung so weitgehend wie möglich aus. |
LedState |
1 / on |
Zeigt Schaltzustand An mit der LED an (entgegengesetzt für Sonoff Touch). |
LedState |
2 |
Zeigt MQTT-Abonnements (subscribe) als LED-Blinken. |
LedState |
3 |
Zeigt Schaltzustand und MQTT-Abonnements als LED-Blinken. |
LedState |
4 |
Zeigt MQTT-Veröffentlichungen (publish) als LED-Blinken. |
LedState |
5 |
Zeigt Schaltzustand An und MQTT-Veröffentlichungen als LED-Blinken. |
LedState |
6 |
Zeigt alle MQTT-Nachrichten als LED-Blinken. |
LedState |
7 |
Zeigt Schaltzustand und alle MQTT-Nachrichten als LED-Blinken. |
Power<x> |
Zeigt aktuellen Schaltzustand von Relais<x> als an oder aus und deaktiviert gleichzeitig die PulsZeit<x> (siehe unten). |
|
Power<x> |
0 / off |
Schaltet Relais<x> aus. |
Power<x> |
1 / on |
Schaltet Relais<x> an. |
Power<x> |
2 / toggle |
Schaltet Relais<x> um. |
Power<x> |
3 / blink |
Aktiviert Blinken für Relais<x> |
Power<x> |
4 / blinkoff |
Beendet Blinken für Relais<x> |
PowerOnState |
Zeige aktuellen Relais-Einschaltzustand. Zeigt an, welchen Schalt-Zustand das Gerät einnimmt, wenn Stromzufuhr anliegt: AN oder AUS oder ANDERS als der Zustand bevor der Strom ausfiel. |
|
PowerOnState |
0 / off |
Nach Stromzufuhr Relais ausgeschaltet lassen. |
PowerOnState |
1 / on |
Nach Stromzufuhr Relais einschalten. |
PowerOnState |
2 / toggle |
Nach Stromzufuhr (Sonoff), Relais umschalten (anders als der zuletzt gespeichertem Zustand)
|
PowerOnState |
3 |
(Standardeinstellung) Nach Stromzufuhr (Sonoff), Relais einschalten (wie zuletzt gespeicherter Zustand) |
PowerOnState |
4 |
Nach Stromzufuhr (Sonoff), Relais einschalten und weitere Kontrolle ausschalten |
PowerOnState |
5 |
Nach Stromzufuhr (Sonoff) Relais einschalten. Ein erneutes Drücken des Buttons führt zu einer Ausschaltzeit in Länge der definierten Puseltime, danch wieder Einschalten (invertierte PulseTime) |
PowerRetain |
Zeigt an, ob der MQTT-Broker den Power-Status (an oder aus) dauerhaft speichert und anderen MQTT-Clients beim Verbinden anzeigt. |
|
PowerRetain |
0 / off |
(default) Power-Zustand wird nicht vom MQTT-Broker gespeichert. |
PowerRetain |
1 / on |
Der MQTT-Broker wird Power-Zustand speichern und durch Status-Informationen auffrischen. |
PulseTime<x> |
Zeigt die aktuelle Impulslänge der Einschaltperiode in Zehntelsekunden an. |
|
PulseTime<x> |
0 / off |
(Default) Schaltet den Impuls-Modus für Relais <x>ab. |
PulseTime<x> |
1..111 |
Setzt die Impulslänge für die Einschaltperiode. Bei Zahlenwerte zwischen 1 und 111 handelt es sich um Zehntelsekunden. |
PulseTime<x> |
112..64900 |
Bei Werten größer oder gleich 112 sind Sekunden gemeint. Wenn eine Pulse-Dauer von mehr als 12 Sekunden eingerichtet werden soll, immer 100 zu der gewünschten Zeit in Sekunden hinzuaddieren. |
SetOption11 |
Zeigt die aktuelle Belegung für Einmal- und Doppeldrücken des Einschalt-Tasters an |
|
SetOption11 |
0 / off |
(default) Einfach- und Doppelklick-Funktion wie grundsätzlich definiert. |
SetOption11 |
1 / on |
Vertauschen von Einfach- und Doppleklick-Funktionalität |
SetOption13 |
Zeige die aktuelle Belegung des Einfach- und Doppelklicks bzw. des Haltens an |
|
SetOption13 |
0 / off |
(default) Aktivieren der Einfach, Mehrfachklick und Halte-Funktion |
SetOption13 |
1 / on |
Button hat nur noch die Einfach-Klick-Funktionalität. Deaktivieren dieser Funktion durch Halten des Buttons über die 4 mal solange Zeit wie sie in der SetOption32 definiert ist. Der Standard für Setoption32 ist 4 Sekunden (Wert 40). |
SetOption14 |
Zeigt die aktuelle Einstellung für den Verriegelungsmodus des Relais an. Diese Einstellungen sind für Mehrkanal-Geräte relevant. |
|
SetOption14 |
0 / off |
(default) Jedes Relais kann unabhängig von den anderen geschaltet werden. |
SetOption14 |
1 / on |
Schaltet ein anderes Relais um, falls es bereits eingeschaltet war. Beispiel für einen CH4: Wenn Relais 1 bereits angeschaltet ist führt das Anschalten eines anderen Relais zum Ausschalten von Relais 1. Diese Funktion kann für gegenläufige Motorsteuerungen verwendet werden (Rolläden). |
SetOption15 |
LED: zeigt den aktuellen PWM (Pulsweitenmodulation) LED-Steuermodus an |
|
SetOption15 |
0 / off |
LED: aktiviert die PWM LED-Steuerung |
SetOption15 |
1 / on |
(default) LED: deaktiviert die PWM LED-Steuerung und ermöglicht die Steuerung durch Dimm- oder Farbbefehle (default) |
SetOption26 |
0 / off |
(default) Ergänzt bei 1-Kanlageräten keine Kanlanummer hinter dem Power-Topic |
IV - Sensor
Parameter-Einstellung und Abfrage
Befehl | Wert | Beschreibung |
---|---|---|
Altitude |
Luftdruckmessung: zeigt die aktuelle Höhe an, die bei der Berechnung des Meeresspiegeldrucks verwendet wird z.B. {"Altitude":432} (0 = default) |
|
Altitude |
-30000..30000 |
Luftdruckmessung: stellt die lokale Höhe in Meter ein z.B. Altitude 432 |
AmpRes |
Strommessung: zeigt die aktuelle Auflösung an z.B. {"AmpRes":3} |
|
AmpRes |
0..3 |
Strommessung: stellt die Auflösung ein (von 0 bis 3) z.B. AmpRes 2 |
Counter<x> |
Zähler1 bis 4: zeigt den aktuellen Zählerwert an z.B. {"Counter2":2024} |
|
Counter<x> |
0 |
Zähler1 bis 4: setzt den Zähler auf 0 zurück z.B. Counter2 0 |
Counter<x> |
1..64900 |
Zähler1 bis 4: stellt den Zähler auf einen Wert ein z.B. Counter2 12000 |
Counter<x> |
-1..64900 |
Zähler1 bis 4: stellt auf einen Wert als Dekrement-Zähler ein z.B. Counter4 -9870 |
Counter<x> |
+1..64900 |
Zähler1 bis 4: stellt auf einen Wert als Inkrement-Zähler ein z.B. Counter4 +9870 |
CounterDebounce |
Zähler: zeigt die aktuelle globale Entprellzeit in msec an z.B. {"CounterDebounce":0} (0 = default) |
|
CounterDebounce |
0 / off |
Zähler: schaltet die globale Zähler-Entprellzeit aus |
CounterDebounce |
1..3200 |
Zähler: stellt die globale Zähler-Entprellzeit in msec ein z.B. CounterDebounce 100 |
CounterType<x> |
Zähler-Typ1 bis 4: zeigt, ob als Impuls-Zähler (0) oder Impuls-Timer (1) z.B. {"CounterType2":0} |
|
CounterType<x> |
0 / off |
Zähler-Typ1 bis 4: der Zähler wird als Impuls-Zähler eingestellt z.B. CounterType2 off |
CounterType<x> |
1 / on |
Zähler-Typ1 bis 4: der Zähler wird als Impuls-Timer eingestellt z.B. CounterType4 on |
EnergyRes |
Energiemessung: zeigt die aktuelle Auflösung an z.B. {"EnergyRes":3} |
|
EnergyRes |
0..5 |
Energiemessung: stellt die Auflösung ein z.B. EnergyRes 4 |
HumRes |
Luftfeuchtigkeitsmessung: zeigt die aktuelle Auflösung an z.B. {"HumRes":1} |
|
HumRes |
0..3 |
Luftfeuchtigkeitsmessung: stellt die Auflösung ein z.B. HumRes 2 |
Ina219Mode |
Siehe Sensor13 (Befehl Ina219Mode wurde ersetzt) |
|
PressRes |
Luftdruckmessung: zeigt die aktuelle Auflösung an z.B. {"PressRes":1} |
|
PressRes |
0..3 |
Luftdruckmessung: stellt die Auflösung ein z.B. PressRes 2 |
Sensor13 |
INA219 Strom-Sensor: zeigt den aktuellen Kalibrierungsmodus an |
|
Sensor13 |
0 |
INA219: Stellt die Kalibrierung auf max. 32V und 2A ein |
Sensor13 |
1 |
INA219: Stellt die Kalibrierung auf max. 32V und 1A ein |
Sensor13 |
2 |
INA219: Stellt die Kalibrierung auf max. 16V und 0,4A ein |
Sensor15 |
2 |
MH-Z19(B) CO2 Sensor: startet die Nullpunkt-Kalibrierung |
Sensor27 |
APDS-9960 Gesten Erkennung: zeigt den Gesten-Modus |
|
Sensor27 |
0 / off |
APDS-9960: deaktiviert den Gesten-Modus |
Sensor27 |
1 / on |
APDS-9960: aktiviert den Gesten-Modus |
SetOption8 |
Temperaturmessung: zeigt, ob die aktuelle Anzeige in Celsius (OFF) oder Fahrenheit (ON) erfolgt |
|
SetOption8 |
0 / celsius |
Temperaturmessung: aktiviert die Anzeige in Celsius |
SetOption8 |
1 / fahrenheit |
Temperaturmessung: aktiviert die Anzeige in Fahrenheit |
SetOption18 |
Signal-Licht: zeigt den Status aus/ein an - wird derzeit nur mit CO2-Sensoren verwendet |
|
SetOption18 |
0 / off |
Signal-Licht: deaktivieren (off = default) |
SetOption18 |
1 / on |
Signal-Licht: aktivieren |
TempRes |
Temperaturmessung: zeigt die aktuelle Auflösung an z.B. {"TempRes":1} |
|
TempRes |
0..3 |
Temperaturmessung: stellt die Auflösung ein z.B. TempRes 2 |
TempUnit |
Siehe SetOption8 (Befehl TempUnit wurde ersetzt) |
|
VoltRes |
Spannungsmessung: zeigt die aktuelle Auflösung an z.B. {"VoltRes":1} |
|
VoltRes |
0..3 |
Spannungsmessung: stellt die Auflösung ein z.B. VoltRes 2 |
WattRes |
Leistungsmessung: zeigt die aktuelle Auflösung an z.B. {"WattRes":1} |
|
WattRes |
0..3 |
Leistungsmessung: stellt die Auflösung ein z.B. WattRes 2 |