CST328: настройка и устранение неполадок

CST328 вкратце

Официальный даташит Hynitron при подготовке этих данных не использовался: найденная в сети копия представляет собой выгрузку от реселлера, поэтому приведённые выше значения взяты из исходного кода драйверов и документации к платам.

Замена на CST3530

В README LilyGO T-Deck Pro сказано, что поставщик CST328 "прекратил производство", поэтому на новых платах T-Deck Pro v1.1 устанавливается CST3530. Там же отмечается, что "оба чипа используют один и тот же адрес устройства", поэтому прошивке необходимо определять чип при инициализации. Для CST3530 LilyGO использует подпрограмму cst66xx от Hynitron, а для CST328 — cst3xx.

На плате Waveshare RP2350-Touch-LCD-2.8 произведена та же замена. В проекте RS-Key задокументирована версия V1 с CST328 по адресу 0x1A и версия V2 с CST3530 по адресу 0x58. На T-Deck Pro адрес не меняется, а на этой плате меняется.

Данные о CST3530 взяты из объединённого драйвера RS-Key, который его автор тестировал на плате V2, и из README LilyGO.

Как проявляется подмена контроллера

Оба проекта, столкнувшиеся с этой проблемой, сообщали об одном и том же: прошивка работает, дисплей отображает картинку, но касания не регистрируются. В issue проекта reticulum-tdeck отмечается, что на одних экземплярах T-Deck Pro v1.1 всё работало, а на других — нет, что указывает на изменение между производственными партиями, а не на ошибку монтажа.

Ещё две ловушки:

• Скан шины I2C не идентифицирует чип. На T-Deck Pro оба чипа отвечают по адресу 0x1A. Авторы reticulum-tdeck сначала опрашивают CST3530, потому что CST3530 «без возражений подтверждает чтение регистров CST328». Они также отмечают, что этот код ещё не запускался на плате с CST3530. Стендовый тест в meshcore-firmware на T-Deck Pro V1.1 показывает то же самое: чтение в стиле CST328 было подтверждено, но не вернуло ни типа чипа, ни разрешения, тогда как чтение в стиле CST3530 вернуло корректный блок с маркером 0xCA 0xCA и разрешением панели 240×320.
• Другие драйверы могут принять 0x1A за свой чип. В открытом pull request проекта Meshtastic сообщается, что скан шины I2C принял тач-контроллер T-Deck Pro за мост DS2482-800, поскольку случайно совпала проверка регистра состояния.

Это типичная ситуация с небольшими тач-контроллерами: маркировка на плате остаётся прежней, а чип меняется. Если вы выпускаете продукцию серийно, уточните у поставщика дисплеев, какой тач-контроллер установлен, и попросите предупреждать о его замене. Наш глоссарий EOL и PCN объясняет, что должно содержаться в уведомлении об изменении.

Запуск с ESPHome

Платформа cst328 в ESPHome требует настройки I2C и принимает необязательные параметры interrupt_pin и reset_pin. При инициализации она выполняет следующее:

• Подаёт низкий уровень на вывод сброса на 5 мс, затем ждёт.
• Считывает CRC прошивки и ожидает значение 0xCACA. При любом другом значении компонент помечается как сбойный.
• Считывает тип чипа, идентификатор проекта, ревизию прошивки и разрешение, затем переводит чип в нормальный режим.

Проверку CRC стоит проверить в первую очередь, если ESPHome сообщает о сбое тачскрина. ESPHome использует чтения в стиле CST328 с 2-байтовыми адресами регистров, а в стендовом тесте meshcore-firmware такое чтение с CST3530 не вернуло ничего полезного. Поэтому на плате с CST3530 ожидайте, что эта проверка завершится сбоем. Это наше предположение: мы не запускали ESPHome на плате с CST3530.

Поддержка драйверов

• ESPHome: платформа cst328. В её документации упоминается плата Waveshare ESP32-S3 Touch LCD 2.8. Отдельной платформы для CST3530 нет.
• ESP-IDF: Waveshare публикует esp_lcd_touch_cst328 в реестре компонентов Espressif. В таблице совместимости указан только CST328.
• Rust: крейт cst328 на crates.io, а также прошивка RS-Key, поддерживающая оба чипа.
• Собственный драйвер Hynitron: LilyGO ссылается на исходный код hyn_driver от Hynitron для обоих чипов.

Смежные контроллеры

Об одноточечном таче на круглых дисплеях читайте в разделе CST816S, тоже от Hynitron. О более крупных панелях с поддержкой до 5 точек — GT911.