z/Z21: WLAN Maus (Lok Bibliothek) Befehle

Die Roco WLAN-Multimaus bietet bekanntermaßen die Möglichkeit, die Lok Bibliothek an eine andere Multimaus zu senden oder sie von dort zu empfangen.

Da ich evtl. eine Software schreiben werde, die als zentrale Stelle für die Verwaltung der Loks dienen soll und neben der Z21-App auch die WLAN-Multimaus mit den notwendigen Informationen versorgen soll, haben mich die korrekte Implementierung interessiert.

Wie schon in meinem anderen Blog-Beitrag nachzulesen ist, ist die Dokumentierung der z/Z21 Befehle leider nicht komplett, so dass man die Befehle selber entschlüsseln muss.

Eine erste Nachfrage im Forum nach den Befehlen führte zu einem Hinweis auf die Webseite von Wolfgang Kufe. Hier wurden aber “nur” die Befehle für den XPressnet aufgelistet.

Nicht desto weniger half mir seine Informationen, die UDP-Pakete leichter zu entschlüsseln.

Wenn eine WLAN Maus die Lok Bibliothek übermittelt, so sendet sie die Daten an die Z21. Jedes Paket wird zweimal kurz hintereinander übermittelt. Anschließend leitet die Z21 diese Informationen in gleichen Format an alle angemeldeten Endgeräte weiter.

Die Pakete sehen folgendermaßen aus:

0f 00 -- 40 00 -- e9 f1 -- 00 03 -- 00  -- 04   -- 4c 4f 4b 31       -- 66
10 00 -- 40 00 -- ea f1 -- 00 47 -- 01  -- 04   -- 42 52 31 38 32    -- 72
10 00 -- 40 00 -- ea f1 -- 12 67 -- 02  -- 04   -- 53 43 48 4f 4d    -- 32
11 00 -- 40 00 -- eb f1 -- 00 0a -- 03  -- 04   -- 41 42 43 44 45 46 -- 10
LEN   -- CMD1  -- CMD2  -- ADDR  -- IDX -- ANZ  -- NAME als ASCII    -- XOR

LEN: Länge des Paketes
CMD1: 0x40 0x00
CMD2: Definiert den Befehl. Im ersten Byte ist jedoch noch die Länge des Namen ein kodiert. Für Namen der Länge 1 ist der Wert 0xe6. Sollte der Namen 10 Zeichen lang sein (maximale Länge), wäre der Wert 0xef.
IDX: Die einzelnen Einträge sind von 0 bis ANZ-1 durchnummeriert
ANZ: Anzahl der Loks in der Bibliothek
NAME: Der Name in ASCII Format. Die Länge ist im CMD-Feld kodiert.
XOR: XOR-Wert für die einzelnen Bytes