TURZX USB-Display selbst ansteuern

Worum es geht

Die TURZX-Displays (baugleich mit „Turing Smart Screen", USB-Vendor-ID 0x1CBE) sind schmale IPS-Bildschirme, die per USB-C Strom und Bild bekommen und eigentlich als PC-Statusanzeige gedacht sind. Die Hersteller-Software gibt es nur für Windows. Wer das Display an einen Raspberry Pi, einen Linux-Server oder einen Mac hängen will, muss das Protokoll selbst sprechen. Es ist einfach: ein 500-Byte-Kommandokopf, DES-verschlüsselt mit einem festen Schlüssel, danach ein JPEG. Die Details stehen unten, inklusive der fünf Dinge, die beim ersten Versuch garantiert schiefgehen.

Verifiziert ist das alles am 9,2"-Modell (1920×462, Produkt-ID 0x0092), das seit Monaten an einem Pi 5 als Dashboard läuft. Für die Schwestermodelle (4,6", 5,2", 8", 8,8", 12,3") nutzt die Bibliothek turing-smart-screen-python dasselbe Protokoll; dort ist nur die Auflösung anders.

Schnellstart auf Linux / Raspberry Pi

# 1. Prüfen, ob das Display erkannt wird
lsusb | grep 1cbe
#   Bus 002 Device 002: ID 1cbe:0092 Luminary Micro Inc. TURZX1.0

# 2. Zugriff ohne root: udev-Regel, danach Kabel neu einstecken
sudo curl -o /etc/udev/rules.d/99-turzx.rules https://bergclimber.de/turzx/dl/99-turzx.rules
sudo udevadm control --reload-rules && sudo udevadm trigger

# 3. Abhängigkeiten und Skript
pip3 install pyusb pillow pycryptodome          # Debian/RPi OS evtl. --break-system-packages
curl -o turzx.py https://bergclimber.de/turzx/dl/turzx.py

# 4. Testbild
python3 turzx.py --brightness 40 test
python3 turzx.py image foto.jpg
python3 turzx.py text "Hallo\nWelt"

Auf dem Mac genügt brew install libusb vor dem pip-Schritt, eine udev-Regel gibt es dort nicht. Auf Windows braucht pyusb einen WinUSB-Treiber für das Gerät (Zadig), das ist aber nicht der Weg, für den diese Seite gedacht ist.

Die fünf Fallen

Wenn es trotzdem komisch aussieht

• Werks-Hintergrund scheint durch: Init-Sequenz fehlt oder PNG statt JPEG. Dienst neu starten, notfalls Kabel ziehen.
• Bild vierfach gestapelt: Kommando 41 wurde mit Parametern gesendet (z. B. MADCTL). 41 muss ohne Parameter raus.
• „Resource busy": ein anderer Prozess hält das USB-Interface. Alte Instanz beenden, kurz warten.
• Gar nichts: Kabel oder Port wechseln; manche USB-C-Kabel führen nur Strom. Das Display zieht bis 1,6 W.

Das Python-Skript

turzx.py ist ein einzelnes Skript ohne Konfiguration: es erkennt das Modell über die Produkt-ID, polstert und dreht das Bild passend und spricht nur die fünf Init-Kommandos, Helligkeit und JPEG-Upload. Abhängigkeiten: pyusb, pillow, pycryptodome. Playwright nur für den Webseiten-Modus.

turzx.py test                           Testbild
turzx.py image foto.jpg [--fit contain] Bild (Standard: füllen und beschneiden)
turzx.py text "Zeile 1\nZeile 2"        Textkarte
turzx.py clear                          schwarz
turzx.py brightness 40                  Helligkeit 0–100
turzx.py url http://localhost:3000/     Webseite als Screenshot-Loop, --interval 2
                                        (pip3 install playwright && playwright install chromium)

Als Dienst (Dashboard-Betrieb)

Für ein Dashboard rendert der url-Modus eine beliebige Webseite in Chromium headless und schiebt alle zwei Sekunden einen Screenshot aufs Display. Ein Pi 5 ist damit praktisch unbelastet (Screenshot ~0,3 s, USB ~0,2 s, ~30 MB RAM). Beispiel-Unit: turzx.service, udev-Regel: 99-turzx.rules.

sudo mkdir -p /opt/turzx && sudo cp turzx.py /opt/turzx/
sudo curl -o /etc/systemd/system/turzx.service https://bergclimber.de/turzx/dl/turzx.service
sudo nano /etc/systemd/system/turzx.service      # User= und URL anpassen
sudo systemctl daemon-reload && sudo systemctl enable --now turzx
journalctl -u turzx -f

Zwei Lehren aus dem Dauerbetrieb: Playwright nicht mit wait_until="networkidle" laden, wenn die Seite selbst pollt (der Loop hängt dann in Timeouts, bei uns zwölf Stunden eingefrorenes Display). Und nicht pro Frame neu laden, nur screenshotten; ein Reload alle paar Minuten als Hygiene reicht. Wer es ganz robust will, gibt dem Dienst einen systemd-Watchdog.

Protokoll-Referenz

Reines USB-Bulk auf Interface 0, ein OUT- und ein IN-Endpunkt. Jedes Kommando ist ein 512-Byte-Paket, bei Bildern folgt der JPEG-Payload in demselben Transfer. Das Display antwortet mit 512 Bytes, Byte 1 oder Byte 8 = 0xC8 (200) heißt OK; die Antwort kann man lesen und verwerfen.

Paketaufbau

Klartext-Header, 500 Bytes, mit Nullen gefüllt:
  [0]      Kommando-ID
  [2..3]   Magic 0x1A 0x6D
  [4..7]   Zeitstempel: Millisekunden seit lokaler Mitternacht, Little-Endian
  [8..11]  nur bei 101/102: Payload-Größe, Big-Endian
  [8]      nur bei 14: Helligkeit 0–102

→ DES-CBC verschlüsseln, Key = IV = "slv3tuzx" (Null-Padding auf 504 Bytes)
→ in 512 Bytes legen, Bytes 510/511 = 0xA1 0x1A
→ danach bei 101: die rohen JPEG-Bytes anhängen

Kommandos

Init-Sequenz und Bild-Pipeline

Verbinden:  10 → 111 → 112 → 13 → 14 (Helligkeit) → 41 → schwarzes JPEG

Bild (9,2"): Querformat 1920×462
  → auf 1920×464 polstern (1 px schwarz oben und unten)
  → 90° im Uhrzeigersinn drehen (PIL ROTATE_270) → 464×1920
  → JPEG, Qualität 90, typisch 70–150 KB
  → Header 101 mit Größe + JPEG in einem Bulk-Write

Modelle (Vendor-ID 0x1CBE)

Quelle des Protokollwissens: eigenes Mitschneiden plus die Bibliothek turing-smart-screen-python (GPL-3.0), die diese Modelle inzwischen als „Turing USB" unterstützt und zusätzlich H.264-Video, Dateiablage und das Werks-Theme kann. Wer das volle Monitoring-Programm will, nimmt die Bibliothek. Wer nur ein Bild oder eine Webseite aufs Display will, kommt mit den acht Kommandos oben aus.

Häufige Fragen