CST328: Setup & Fehlerbehebung

Der CST328 auf einen Blick

Für diese Angaben haben wir kein Datenblatt von Hynitron verwendet. Das im Netz auffindbare Exemplar ist ein Upload eines Händlers, daher stammen die obigen Werte aus dem Treiberquellcode und der Board-Dokumentation.

Der Wechsel zum CST3530

Im README des LilyGO T-Deck Pro heißt es, der CST328-Lieferant "hat die Produktion eingestellt", sodass neuere T-Deck-Pro-v1.1-Boards einen CST3530 verwenden. Dort wird zudem darauf hingewiesen, dass "beide Chips dieselbe Geräteadresse verwenden", sodass die Firmware den Chip während der Initialisierung identifizieren muss. LilyGO verwendet Hynitrons cst66xx-Routine für den CST3530 und cst3xx für den CST328.

Der Waveshare RP2350-Touch-LCD-2.8 vollzog denselben Wechsel. Das RS-Key-Projekt dokumentiert V1 mit einem CST328 unter 0x1A und V2 mit einem CST3530 unter 0x58. Beim T-Deck Pro ändert sich die Adresse nicht; bei diesem Board hingegen schon.

Die CST3530-Angaben stammen aus dem zusammengeführten Treiber von RS-Key, dessen Autor ihn auf einem V2-Board getestet hat, sowie aus LilyGOs README.

Wie sich der Tausch bemerkbar macht

Beide Projekte, bei denen dies auftrat, meldeten dasselbe Bild: Die Firmware läuft und das Display zeichnet, aber keine Berührung wird registriert. Laut dem reticulum-tdeck-Issue funktionierten manche T-Deck-Pro-v1.1-Geräte und andere nicht — das passt eher zu einer Änderung zwischen Produktionslosen als zu einem Verdrahtungsfehler.

Zwei weitere Fallen:

• Ein I2C-Scan identifiziert den Chip nicht. Auf dem T-Deck Pro antworten beide Chips unter 0x1A. Die Autoren von reticulum-tdeck fragen zuerst den CST3530 ab, weil ein CST3530 "Lesezugriffe auf CST328-Register gerne quittiert". Sie weisen auch darauf hin, dass dieser Code noch nicht auf einem CST3530-Board gelaufen sei. Ein Bench-Test von meshcore-firmware an einem T-Deck Pro V1.1 zeigt dasselbe: Der Lesezugriff im CST328-Stil wurde quittiert, lieferte aber weder Chip-Typ noch Auflösung, während der Lesezugriff im CST3530-Stil einen gültigen Block mit der Markierung 0xCA 0xCA und der 240×320-Auflösung des Panels zurückgab.
• Andere Treiber können 0x1A für sich beanspruchen. Ein offener Meshtastic-Pull-Request berichtet, dass sein I2C-Scan den Touch-Chip des T-Deck Pro für eine DS2482-800-Bridge hielt, weil ein Statusregister-Test zufällig zutraf.

Das ist ein verbreitetes Muster bei kleinen Touch-Controllern: Die Teilenummer auf dem Board bleibt gleich, während sich der Chip ändert. Wenn Sie in Stückzahlen fertigen, fragen Sie Ihren Display-Lieferanten, welcher Touch-IC verbaut ist — und lassen Sie sich ankündigen, bevor er wechselt. Unser EOL- und PCN-Glossar erklärt, was eine Änderungsmitteilung enthalten sollte.

Inbetriebnahme mit ESPHome

ESP Homes cst328-Plattform benötigt eine konfigurierte I2C-Schnittstelle und akzeptiert optional interrupt_pin und reset_pin. Beim Setup passiert Folgendes:

• Setzt den Reset-Pin für 5 ms auf Low und wartet dann.
• Liest die Firmware-CRC und erwartet 0xCACA. Bei jedem anderen Wert markiert sie die Komponente als fehlgeschlagen.
• Liest Chip-Typ, Projekt-ID, Firmware-Revision und Auflösung und schaltet den Chip dann in den Normalmodus.

Der CRC-Check ist die erste Anlaufstelle, wenn ESPHome den Touchscreen als fehlgeschlagen meldet. ESPHome verwendet CST328-Lesezugriffe mit 2-Byte-Registeradressen, und im Bench-Test von meshcore-firmware lieferte diese Art von Zugriff bei einem CST3530 nichts Verwertbares. Erwarten Sie daher auf einem Board mit CST3530, dass dieser Check fehlschlägt. Das ist unsere Schlussfolgerung: Wir haben ESPHome nicht auf einem CST3530-Board ausgeführt.

Treiberunterstützung

• ESPHome: die cst328-Plattform. Ihre Dokumentation nennt das Board Waveshare ESP32-S3 Touch LCD 2.8. Eine CST3530-Plattform gibt es nicht.
• ESP-IDF: Waveshare veröffentlicht esp_lcd_touch_cst328 in der Espressif-Component-Registry. Seine Kompatibilitätstabelle listet nur den CST328.
• Rust: das Crate cst328 auf crates.io sowie die RS-Key-Firmware für beide Chips.
• Hynitrons eigener Treiber: LilyGO verlinkt Hynitrons hyn_driver-Quellcode für beide Chips.

Verwandte Controller

Für Ein-Finger-Touch bei runden Displays siehe CST816S, ebenfalls von Hynitron. Für größere Panels mit bis zu 5 Punkten siehe GT911.