EA uniTFT Series

Short Protokoll Befehle

1. Befehle / Daten zum Display 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.

Das Modul arbeitet mit little-endian (Intel-Format), das niederwertige Byte wird zuerst übertragen.

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

Das Paket beginnt also mit DC3 und einer Längenangabe der Nutzdaten. Am Ende steht eine Prüfsumme (CRC16/CCITT) über das komplette Paket. Hier finden Sie einen Online-CRC-Calculator.

In Hex: 13 07 00 23 58 43 42 32 30 0A 3D CD (hier als Datei zum Download; diese kann z.B. per Drag-and-Drop einfach auf terminal.exe geschoben werden)

Beispiel: #XCB80 ändert z.B. die Helligkeit auf 80%.

In Hex: 13 07 00 23 58 43 42 38 30 0A FC 0A (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 2042 Byte Nutzdaten. Weiterhin lässt sich der Time-out in 1/1000s 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 Unterbechung 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.

CRC-Berechnung

Für die Berechnung der Prüfsumme wird eine zyklische Redundanzprüfung (CRC) eingesetzt. Eine gängige und bekannte CRC-Prüfung ist die CRC-CCITT. Als Startwert wird 0xFFFF verwendet. Im Folgenden sehen Sie eine typische C-Implementierung. Die Funktionen müssen extern aufgerufen werden. Die Prüfsumme muss mit dem Startwert vorbelegt werden.

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

//Funktion: buffer2crc16()

//input:    ptr Datum, ptr auf CRC, Blocklänge

//output:   ---

//Beschr:   CRC-CCITT eines Speicherbereichs

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

void buffer2crc16(UBYTE *dat, UINT16 *pCRC, UINT32 anz)

{

 while(anz--)

   crc16(*dat++, pCRC);

}

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

//Funktion: sp_crc16()

//input:    Datum, ptr auf CRC

//output:   ---

//Beschr:   CRC_CCITT (x^16+x^12+x^5+1 = 1 0001 0000 0010 0001 = 0x1021

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

void crc16 (UBYTE dat, volatile UINT16 * crc)

{

 register UINT16 lcrc = *crc;

 lcrc = (lcrc >> 8) | (lcrc << 8);

 lcrc ^= dat;

 lcrc ^= (lcrc & 0xFF) >> 4;

 lcrc ^= lcrc << 12;

 lcrc ^= (lcrc & 0xFF) << 5;

 *crc = lcrc;

}