CST328: configuração e solução de problemas

CST328 em resumo

Não usamos um datasheet da Hynitron para esses dados. A cópia que encontramos online é um upload de revendedor, portanto os valores acima vêm do código-fonte do driver e da documentação da placa.

A troca pelo CST3530

O README do T-Deck Pro da LilyGO diz que o fornecedor do CST328 "descontinuou a produção", então as placas T-Deck Pro v1.1 mais recentes usam um CST3530. O documento acrescenta que "ambos os chips usam o mesmo endereço de dispositivo", por isso o firmware precisa identificar o chip durante a inicialização. A LilyGO usa a rotina cst66xx da Hynitron para o CST3530 e a cst3xx para o CST328.

O RP2350-Touch-LCD-2.8 da Waveshare fez a mesma mudança. O projeto RS-Key documenta a V1 com um CST328 no endereço 0x1A e a V2 com um CST3530 no endereço 0x58. No T-Deck Pro o endereço não muda; nesta placa, muda.

As colunas do CST3530 vêm do driver unificado da RS-Key, cujo autor fez testes em uma placa V2, e do README da LilyGO.

Como o problema de troca se manifesta

Ambos os projetos que se depararam com isso relataram o mesmo sintoma: o firmware roda e o display desenha, mas nenhum toque é registrado. A issue do reticulum-tdeck diz que algumas unidades do T-Deck Pro v1.1 funcionavam e outras não, o que indica uma mudança entre lotes de produção, e não uma falha de fiação.

Duas outras armadilhas:

• Uma varredura I2C não identifica o chip. No T-Deck Pro, ambos os chips respondem em 0x1A. Os autores do reticulum-tdeck fazem a detecção procurando primeiro o CST3530, porque um CST3530 "reconhece prontamente leituras de registradores do CST328". Eles também afirmam que esse código ainda não havia rodado em uma placa com CST3530. Um teste de bancada do meshcore-firmware em um T-Deck Pro V1.1 mostra a mesma coisa: a leitura no estilo CST328 foi reconhecida, mas não retornou nem tipo de chip nem resolução, enquanto a leitura no estilo CST3530 retornou um bloco válido com um marcador 0xCA 0xCA e a resolução de 240×320 do painel.
• Outros drivers podem reivindicar 0x1A. Um pull request aberto do Meshtastic relata que sua varredura I2C confundiu o chip de toque do T-Deck Pro com uma ponte DS2482-800, porque um teste de registrador de status coincidiu por acaso.

Esse é um padrão comum em controladores de toque pequenos: o número de peça na placa permanece o mesmo enquanto o chip muda. Se você fabricar em volume, pergunte ao seu fornecedor de displays qual IC de toque está montado e peça que avisem antes de qualquer alteração. Nosso glossário de EOL e PCN explica o que uma notificação de alteração deve conter.

Integração com ESPHome

A plataforma cst328 do ESPHome exige o I2C configurado e aceita opcionalmente interrupt_pin e reset_pin. A configuração dela faz o seguinte:

• Aplica um pulso baixo no reset por 5 ms e, em seguida, aguarda.
• Lê o CRC do firmware e espera 0xCACA. Com qualquer outro valor, marca o componente como com falha.
• Lê o tipo de chip, o ID do projeto, a revisão do firmware e a resolução e, então, coloca o chip em modo normal.

A verificação de CRC é o primeiro lugar a investigar se o ESPHome relatar falha na tela de toque. O ESPHome usa leituras no estilo CST328 com endereços de registrador de 2 bytes, e no teste de bancada do meshcore-firmware esse tipo de leitura não retornou nada útil de um CST3530. Portanto, em uma placa com CST3530, espere que essa verificação falhe. Essa é a nossa inferência: não executamos o ESPHome em uma placa com CST3530.

Suporte a drivers

• ESPHome: a plataforma cst328. Sua documentação cita a placa Waveshare ESP32-S3 Touch LCD 2.8. Não há plataforma para o CST3530.
• ESP-IDF: a Waveshare publica o esp_lcd_touch_cst328 no registro de componentes da Espressif. Sua tabela de compatibilidade lista apenas o CST328.
• Rust: o crate cst328 no crates.io, e o firmware da RS-Key para ambos os chips.
• Driver oficial da Hynitron: a LilyGO linka o código-fonte do hyn_driver da Hynitron para ambos os chips.

Controladores relacionados

Para toque de um dedo em displays redondos, consulte o CST816S, também da Hynitron. Para painéis maiores com até 5 pontos, consulte o GT911.