EA uniTFT Series

Small Protokoll

1. Befehle / Daten zum Modul senden

Dieser Protokoll-Befehl überträgt Daten zum Display. Es können mehrere Grafikbefehle in ein Protokollpaket verpackt werden. Sind die Daten größer als die maximale Paketgröße können die Daten auf mehrere Pakete aufgeteilt werden. Das Modul fügt die einzelnen Datenpakete wieder zusammen.

Beispiel: #XCB25 ändert z.B. die Helligkeit auf 25%. Dazu gehört am Ende ein [LF] bzw. 0x0A als Abschlusskennung

Das Paket beginnt also mit DC1 und einer Längenangabe der Nutzdaten. Am Ende steht eine Prüfsumme (8 Bit Summe, Modulo 256) über das komplette Paket. Hier finden Sie einen Online-CRC-Calculator.

In Hex: 11 07 23 58 43 42 32 35 0A 89 (hier als Datei zum Download; diese kann z.B. per Drag-and-Drop einfach auf terminal.exe geschoben werden)

Beispiel: #XCB75 ändert z.B. die Helligkeit auf 75%.

In Hex: 11 07 23 58 43 42 37 35 0A 8E (hier als Datei zum Download)

2. Inhalt des Sendepuffers anfordern

Fallen Daten im Modul an, werden diese im Sendepuffer des Moduls gespeichert. Über die seriellen Schnittstellen können die Daten angefordert werden. Ob Daten verfügbar sind kann über den Pin 20 SBUF herausgefunden werden, oder aber die übergeordnete Steuerung fragt zyklisch die Daten ab (polling).

3. Letztes Datenpaket wiederholen

Ist ein Empfangenes Packet des Moduls fehlerhaft (falsche Länge oder Prüfsumme) kann es erneut angefordert werden:

4. Pufferinformationen anfordern

Mit diesem Befehl wird nachgefragt, ob Nutzdaten zur Abholung bereit stehen (= Pin20 SBUF) und wie voll der Empfangspuffer des Displays bereits ist.

5. Protokolleinstellungen

Hierüber lässt sich die maximale Paketgröße welche das Display senden darf begrenzen. Voreingestellt ist eine Paketgröße mit bis zu 255 Byte Nutzdaten. Weiterhin lässt sich der Time-out in 1/100s einstellen. Der Time-out spricht an, wenn einzelne Bytes verloren gegangen sind. Danach muss das gesamte Paket nochmals übertragen werden.

6. Protokollinformationen

Abfrage der Protokolleinstellungen (siehe 5.).

7. RS485 Adresse selektieren / deselektieren

Mit diesem Befehl lässt sich ein Modul am RS485-Bus selektieren oder deselektieren. Per Default ist ein Modul mit der Adresse 7 immer aktiv.

8. RS485 Verzögerung Enable Signal

Einige RS485 benötigen eine gewisse Zeit um das Enable-Signal zu verändern und z.B. vom schreibenden in den lesenden Modus umzuschalten. Um eine erfolgreiche Kommunikation mit diesen Geräten zu ermöglichen kann mit diesem Befehl die Umschaltung in den schreibenden Modus verzögert werden.

9. Schnittstelle exklusiv anfordern

Alle 4 seriellen Schnittstellen werden parallel und gleichwertig behandelt. Um zu gewährleisten, dass eine Abfolge von Protokollpaketen ohne Unterbrechung durchgeführt wird, können die anderen seriellen Schnittstellen deaktiviert werden und die Schnittelle exklusiv angefordert werden. Dies ist zum Beispiel bei einem Projektupdate über USB sinnvoll.

10. Break-Kommando, Ausführung Unterbrechen / Beenden

Falls in einem Makro eine Dauerschleife programmiert wurde oder eine Unterbrechung des normalen Ablaufs gewünscht wird, kann mit diesem Befehl gezielt Unterbrochen und Beendet werden. Auch dieser Befehl eignet sich vor allem für Update-Vorgänge.

11. Hardware Reset

Das Modul wird mit diesem Protokollbefehl neu gestartet. Je nach Parameter wird nach dem Reset eine andere Startoption gewählt.

BCC-Berechnung

Für die Berechnung der Prüfsumme wird eine einfache 8-Bit Summenprüfung (Modulo 256) benötigt. Im Folgenden sehen Sie eine typische C-Implementierung.

//----------------------------------------------------------------------------

//Funktion: buffer2bcc()

//input:    ptr Datum, blocklänge

//output:   ---

//Beschr:   Byte bcc für einen Speicherbereich

//----------------------------------------------------------------------------

UBYTE buffer2bcc(UBYTE *dat, UBYTE anz)

{

 UBYTE bcc = 0;

 while(anz--)

   bcc += *dat++;

 return bcc;

}