Tasmota UART Kommunikation serieller Befehlssatz

Zusammenfassend läßt sich die Tasmota Befehlssatz zur seriellen Kommunikation über die UART Schnittstelle eines ESP8266 sowie ESP32 von jedem typischen seriellen Terminal Programm ableiten. Grundlegend basieren die folgenden Parameter auf typische serielle Schnittstellen.

Ganz gleich ob es sich bei der Hardware um ein

• EI-OT RS232 WLan Bridge Modul
• EI-OT RS485 WLan Bridge Modul
• typisches ESP Modul mit UART Schnittstelle

handelt, die nachfolgende Dokumentation bezieht sich stets auf die Tasmota UART Schnittstelle.

Vorab dieser Befehlssatz bezieht sich nicht auf die serielle Hardware Bridge, sondern auf die

• TCP serial Bridge
• serielle Standard Schnittstelle

zum Befehlssatz zur seriellen Hardware Bridge.

Zunächst muss mittels folgendem Befehlssatz die serielle UART Schnittstelle gemäß dem angeschlossenen Endgerät konfiguriert werden.

Baudrate, fragt die aktuell konfigurierte Baudrate ab, bzw. durch den Befehl Baudrate gefolgt von der Baudrate wird die Baudrate entsprechend konfiguriert,
Beispiel

Baudrate 115200

setzt die Baudrate auf 115200

SerialBuffer, fragt den aktuellen seriellen Buffer / Speicher ab, bzw. setzt den aktuellen Speicher durch Eingabe des jeweiligen Parameters (von 256 bis 520),
Beispiel

SerialBuffer 520

setzte den Speicher auf 520 Byte.

SerialConfig, fragt das aktuelle serielle Protokoll (Datenbits, Parität, Stopbits) ab, bzw. konfiguriert das serielle Protokoll. beispielsweise

SerialConfig 8N1

setzt das serielle Protokoll auf
Datenbits 8
Parität None (Keine)
Stopbits 1

SerialDelimiter, fragt den ASCII Dezimal Code des aktuell festgelegte Steuerzeichens ab, bzw. konfiguriert das Steuerzeichen durch anhängen des jeweiligen Dezimal ASCII Code, beispielsweise

SerialDelimiter 13

setzt CR (Carriage Return) als Steuerzeichen. Das jeweilige Steuerzeichen wird dabei gemäß ASCII Dezimal Zeichensatz interpretiert. Neben der expliziten Zuweisung des Steuerzeichens (von 0-127) kann zusätzlich
128, erlaubt lediglich ASCII Zeichen vom Dezimalwert 32 bis 127
254, deaktiviert sowohl das Steuerzeichen, als auch eine voran gestellten Hex String
255, deaktiviert das Steuerzeichen (es wird 1:1 übertragen)

Die serielle Kommunikation erfolgt über die Tasmota Konsole. Serielle Datenpakete werden dabei mittels SerialSend übertragen und mittels SerialReceived in der Console ausgegeben. Zur richtigen Interpretation der seriellen Daten werden 6 Optionen zur Übertragung bzw. Interpretation der seriellen Daten bereitgestellt. Mit einfachen Worten, die empfangenen werden stets im Datenformat der zuvor gesendeten Datenart interpretiert / in der Konsole ausgegeben.

1. SerialSend1, sendet die angehängten Daten als String und hängt ein \n new line Element an
2. SerialSend2, sendet die angehängten Daten 1 zu 1
3. SerialSend3, sendet die angehängten Daten als String und ersetzt das Steuerzeichen
4. SerialSend4, sendet die angehängten Daten als binäres Datenpaket, etwaige zu empfangende Daten werden als binary String interpretiert
5. SerialSend5, sendet die angehängten Daten als Hex Datenpaket, etwaige zu empfangende Daten werden als Hex String interpretiert
6. SerialSend6, sendet Dezimalzahlen wobei die Dezimalstelle durch ein Komma unterteil wird

Als einfaches Beispiel, wird mittels Tasmota Konsole

SerialSend1 now I send a String

in die Kommandozeile eingeben und durch drücken der Taste Enter gesendet, wird die Antwort als String interpretiert.

In summary, the Tasmota command set for serial communication via the UART interface of an ESP8266 and ESP32 can be derived from any typical serial terminal program. Basically, the following parameters are based on typical serial interfaces.

Regardless of whether the hardware is a

• EI-OT RS232 WLan Bridge Module
• EI-OT RS485 WLan Bridge Module
• typical ESP module with UART interface

the following documentation always refers to the Tasmota UART interface.

This instruction set will not work for serial RX TX Hardware Bridge, only for

• TCP serial Bridge
• serial standard Interface

The instruction set for RX TX Hardware Bridge you can find here.

The serial RS232 Communication requires Parameters based on connected Device. To set required serial Interface Parameters use following instruction set

Baudrate, queries actual Baudrate,  Baudrate in combination with a sets the Baudrate, for example

Baudrate 115200

sets Baudrate to 11520

SerialBuffer, queries actual Buffer Size, SerialBuffer in combination with a Buffer Size (from 256 up to 520) sets the Buffer Size, for example

SerialBuffer 520

configures Buffer Size to 520 Byte.

SerialConfig, queries actual serial Protocol (Data bits, Parity, Stop bits) in combination with valid 3 parameters for example

SerialConfig 8N1

configures serial protocol to
Data bits 8
Parity None
Stop bits 1

SerialDelimiter, queries actual Serial Delimiter ASCII Decimal Code in combination with a valid ASCII Decimal Code is set to new Serial Delemitter, for example

SerialDelimiter 13

enables CR (Carriage Return) as Serial Delimiter. Beside a ASCII Decimal Value (0-127) following are valid
128, only allow ASCII characters 32 to 127 in response text
254, disable serial delimiter and post HEX string
255, disable serial delimiter

For direct communication use Command Line of Tasmota Console. The serial Data are send thru serial command SerialSend and incoming datas are shown as SerialReceived. For correct serial data interpretation are 6 options available. In simple Words, received Data are always interpreted in same format as serial data was previously send.

1. SerialSend1, send appending \n (newline) ()
2. SerialSend2, send
3. SerialSend3, replace escape characters and send
4. SerialSend4, ssend as binary data. Data in serial response messages is encoded as binary strings
5. SerialSend5, send as hex. Data in serial response messages is encoded as hex strings
6. SerialSend6, send as comma-delimited string of decimal numbers

A simple Example, if

SerialSend1 now I send a String

was send thru Tasmota Konsole Command Line, answer will be interpreted as String.