CST328: cara pemasangan & troubleshooting

CST328 secara ringkas

Kami tidak menggunakan datasheet Hynitron untuk angka-angka ini. Salinan yang kami temukan online adalah unggahan reseller, sehingga nilai-nilai di atas berasal dari source code driver dan dokumentasi board.

Penggantian ke CST3530

README T-Deck Pro dari LilyGO menyatakan bahwa pemasok CST328 "telah menghentikan produksi", sehingga board T-Deck Pro v1.1 yang lebih baru menggunakan CST3530. README tersebut menambahkan bahwa "kedua chip menggunakan alamat perangkat yang sama", sehingga firmware harus mengidentifikasi chip tersebut saat inisialisasi. LilyGO menggunakan rutin cst66xx dari Hynitron untuk CST3530 dan cst3xx untuk CST328.

Waveshare RP2350-Touch-LCD-2.8 melakukan perubahan yang sama. Proyek RS-Key mendokumentasikan V1 dengan CST328 pada 0x1A dan V2 dengan CST3530 pada 0x58. Pada T-Deck Pro alamatnya tidak berubah; pada board ini alamatnya berubah.

Kolom CST3530 berasal dari driver gabungan RS-Key yang diuji pembuatnya pada board V2, dan dari README LilyGO.

Bagaimana gejala penukaran chip terlihat

Kedua proyek yang mengalami masalah ini melaporkan hal yang sama: firmware berjalan dan display menampilkan gambar, tetapi tidak ada sentuhan yang terdeteksi. Isu reticulum-tdeck menyebutkan beberapa unit T-Deck Pro v1.1 berfungsi dan yang lain tidak, yang sesuai dengan perubahan antar batch produksi, bukan karena kesalahan wiring.

Dua jebakan lainnya:

• Pemindaian I2C tidak mengidentifikasi chip. Pada T-Deck Pro kedua chip merespons di 0x1A. Penulis reticulum-tdeck melakukan probe CST3530 terlebih dahulu, karena CST3530 "dengan senang hati mengakui pembacaan register CST328". Mereka juga menyatakan kode ini belum pernah dijalankan pada board CST3530. Uji bench meshcore-firmware pada T-Deck Pro V1.1 menunjukkan hal yang sama: pembacaan gaya CST328 diakui tetapi tidak mengembalikan tipe chip maupun resolusi, sedangkan pembacaan gaya CST3530 mengembalikan blok valid dengan penanda 0xCA 0xCA dan resolusi panel 240×320.
• Driver lain bisa mengira chip itu 0x1A. Sebuah pull request Meshtastic terbuka melaporkan bahwa pemindaian I2C-nya mengira chip sentuh T-Deck Pro sebagai bridge DS2482-800, karena pengujian register status kebetulan cocok.

Ini pola yang umum pada controller sentuh kecil: nomor part di board tetap sama sementara chipnya berganti. Jika Anda memproduksi dalam jumlah besar, tanyakan kepada pemasok display Anda IC sentuh apa yang terpasang, dan minta agar diberi tahu sebelum diubah. Glosarium EOL dan PCN kami menjelaskan apa saja yang seharusnya terkandung dalam change notice.

Bring-up dengan ESPHome

Platform cst328 milik ESPHome membutuhkan konfigurasi I2C serta menerima interrupt_pin dan reset_pin opsional. Proses setup-nya melakukan hal berikut:

• Memberi pulsa reset low selama 5 ms, lalu menunggu.
• Membaca CRC firmware dan mengharapkan 0xCACA. Pada nilai lain, komponen ditandai gagal.
• Membaca tipe chip, project ID, revisi firmware, dan resolusi, lalu mengalihkan chip ke mode normal.

Pemeriksaan CRC adalah hal pertama yang diperiksa jika ESPHome melaporkan touchscreen gagal. ESPHome menggunakan pembacaan CST328 dengan alamat register 2 byte, dan pada uji bench meshcore-firmware pembacaan seperti itu tidak mengembalikan apa pun yang berguna dari CST3530. Jadi pada board dengan CST3530, harapkan pemeriksaan ini gagal. Ini adalah kesimpulan kami: kami belum menjalankan ESPHome pada board CST3530.

Dukungan driver

• ESPHome: platform cst328. Dokumentasinya menyebutkan board Waveshare ESP32-S3 Touch LCD 2.8. Tidak ada platform CST3530 di sana.
• ESP-IDF: Waveshare menerbitkan esp_lcd_touch_cst328 di component registry Espressif. Tabel kompatibilitasnya hanya mencantumkan CST328.
• Rust: crate cst328 di crates.io, serta firmware RS-Key untuk kedua chip.
• Driver milik Hynitron sendiri: LilyGO menautkan sumber hyn_driver milik Hynitron untuk kedua chip.

Controller terkait

Untuk sentuhan satu jari pada display bulat, lihat CST816S, juga dari Hynitron. Untuk panel lebih besar dengan hingga 5 titik sentuh, lihat GT911.