CST328: configuración y resolución de problemas

El CST328 de un vistazo

No usamos un datasheet de Hynitron para estos datos. La copia que encontramos en línea es una subida de un revendedor, por lo que los valores anteriores provienen del código fuente del driver y de la documentación de la placa.

El cambio al CST3530

El README del T-Deck Pro de LilyGO dice que el proveedor del CST328 "ha descontinuado la producción", por lo que las placas T-Deck Pro v1.1 más recientes usan un CST3530. Añade que "ambos chips usan la misma dirección de dispositivo", de modo que el firmware debe identificar el chip durante la inicialización. LilyGO usa la rutina cst66xx de Hynitron para el CST3530 y cst3xx para el CST328.

La RP2350-Touch-LCD-2.8 de Waveshare hizo el mismo cambio. El proyecto RS-Key documenta la V1 con un CST328 en 0x1A y la V2 con un CST3530 en 0x58. En el T-Deck Pro la dirección no cambia; en esta placa sí.

Las columnas de la CST3530 provienen del driver unificado de RS-Key, que su autor probó en una placa V2, y del README de LilyGO.

Cómo se manifiesta el cambio de chip

Ambos proyectos que se toparon con esto reportaron lo mismo: el firmware arranca y la pantalla dibuja, pero ningún toque se registra. El issue de reticulum-tdeck indica que algunas unidades de la T-Deck Pro v1.1 funcionaban y otras no, lo que apunta a un cambio entre lotes de producción y no a un fallo de cableado.

Dos trampas más:

• Un escaneo I2C no identifica el chip. En la T-Deck Pro ambos chips responden en 0x1A. Los autores de reticulum-tdeck sondean primero la CST3530, porque una CST3530 "responde sin problema a las lecturas de registros de la CST328". También dicen que ese código aún no se había ejecutado en una placa con CST3530. Una prueba de banco de meshcore-firmware en una T-Deck Pro V1.1 muestra lo mismo: la lectura estilo CST328 fue reconocida pero no devolvió ni tipo de chip ni resolución, mientras que la lectura estilo CST3530 devolvió un bloque válido con un marcador 0xCA 0xCA y la resolución de 240×320 del panel.
• Otros drivers pueden reclamar 0x1A. Un pull request abierto de Meshtastic reporta que su escaneo I2C tomó el chip táctil de la T-Deck Pro por un puente DS2482-800, porque una prueba del registro de estado coincidía por casualidad.

Este es un patrón común con los controladores táctiles pequeños: la referencia del componente en la placa se mantiene igual mientras el chip cambia. Si fabricas en volumen, pregunta a tu proveedor de pantallas qué chip táctil está montado y que te avise antes de cambiarlo. Nuestro glosario de EOL y PCN explica qué debe contener una notificación de cambio.

Puesta en marcha con ESPHome

La plataforma cst328 de ESPHome requiere que el I2C esté configurado y acepta opcionalmente interrupt_pin y reset_pin. Su configuración hace lo siguiente:

• Aplica un pulso bajo en reset durante 5 ms y luego espera.
• Lee el CRC del firmware y espera 0xCACA. Con cualquier otro valor marca el componente como fallido.
• Lee el tipo de chip, el ID de proyecto, la revisión del firmware y la resolución, y luego cambia el chip a modo normal.

La comprobación del CRC es lo primero que hay que revisar si ESPHome reporta que el panel táctil falló. ESPHome utiliza lecturas de la CST328 con direcciones de registro de 2 bytes, y en la prueba de banco de meshcore-firmware ese tipo de lectura no devolvió nada útil de una CST3530. Así que en una placa con una CST3530, espera que esta comprobación falle. Es una inferencia nuestra: no hemos ejecutado ESPHome en una placa con CST3530.

Soporte de drivers

• ESPHome: la plataforma cst328. Su documentación menciona la placa Waveshare ESP32-S3 Touch LCD 2.8. No tiene plataforma para la CST3530.
• ESP-IDF: Waveshare publica esp_lcd_touch_cst328 en el registro de componentes de Espressif. Su tabla de compatibilidad solo lista la CST328.
• Rust: el crate cst328 en crates.io, y el firmware de RS-Key para ambos chips.
• El driver propio de Hynitron: LilyGO enlaza el código fuente hyn_driver de Hynitron para ambos chips.

Controladores relacionados

Para táctil de un dedo en pantallas redondas, consulta la CST816S, también de Hynitron. Para paneles más grandes de hasta 5 puntos, consulta la GT911.