CST328: cài đặt & xử lý sự cố

Tổng quan về CST328

Chúng tôi không sử dụng datasheet của Hynitron cho các thông số này. Bản copy datasheet chúng tôi tìm thấy trên mạng là do một nhà phân phối đăng tải, vì vậy các giá trị ở trên được lấy từ mã nguồn driver và tài liệu của board.

Việc thay thế bằng CST3530

README của LilyGO cho T-Deck Pro cho biết nhà cung cấp CST328 "đã ngừng sản xuất", do đó các bo T-Deck Pro v1.1 mới hơn sử dụng CST3530. README cũng nêu rằng "cả hai chip dùng cùng một địa chỉ thiết bị", nên firmware phải xác định loại chip trong quá trình khởi tạo. LilyGO dùng quy trình cst66xx của Hynitron cho CST3530 và cst3xx cho CST328.

Waveshare RP2350-Touch-LCD-2.8 cũng có sự thay đổi tương tự. Dự án RS-Key ghi nhận V1 dùng CST328 tại 0x1A và V2 dùng CST3530 tại 0x58. Trên T-Deck Pro địa chỉ không đổi; trên bo mạch này thì địa chỉ thay đổi.

Các cột thông tin về CST3530 lấy từ driver hợp nhất của RS-Key — vốn được tác giả thử nghiệm trên board V2 — và từ README của LilyGO.

Hiện tượng khi bị hoán đổi chip

Cả hai dự án gặp lỗi này đều báo cáo cùng một triệu chứng: firmware chạy và màn hình hiển thị bình thường, nhưng không nhận được bất kỳ cú chạm nào. Issue trên reticulum-tdeck ghi nhận một số máy T-Deck Pro v1.1 hoạt động còn một số thì không — điều này phù hợp với giả thuyết chip bị thay đổi giữa các lô sản xuất chứ không phải lỗi đi dây.

Hai bẫy nữa cần lưu ý:

• Quét I2C không xác định được loại chip. Trên T-Deck Pro, cả hai chip đều phản hồi tại 0x1A. Tác giả của reticulum-tdeck probe CST3530 trước, vì CST3530 "vui vẻ xác nhận cả các lượt đọc thanh ghi theo kiểu CST328". Họ cũng nói rằng đoạn code này chưa từng chạy trên board dùng CST3530. Một bài bench test của meshcore-firmware trên T-Deck Pro V1.1 cho thấy điều tương tự: lượt đọc kiểu CST328 được xác nhận nhưng không trả về loại chip hay độ phân giải nào, trong khi lượt đọc kiểu CST3530 trả về một khối dữ liệu hợp lệ với cờ hiệu 0xCA 0xCA và độ phân giải 240×320 của panel.
• Các driver khác cũng có thể nhận nhầm 0x1A. Một pull request mở của Meshtastic báo cáo rằng lượt quét I2C đã nhận nhầm chip cảm ứng của T-Deck Pro là bridge DS2482-800, vì phép kiểm tra thanh ghi trạng thái trùng khớp một cách ngẫu nhiên.

Đây là một mẫu hình phổ biến với các chip cảm ứng cỡ nhỏ: số part trên board vẫn giữ nguyên trong khi chip bên trong đã thay đổi. Nếu bạn sản xuất với số lượng lớn, hãy hỏi nhà cung cấp panel đang lắp chip cảm ứng nào, và yêu cầu họ thông báo trước khi có thay đổi. Bảng thuật ngữ EOL và PCN của chúng tôi giải thích một thông báo thay đổi cần chứa những gì.

Đưa vào hoạt động với ESPHome

Nền tảng cst328 của ESPHome yêu cầu cấu hình I2C và nhận thêm các tùy chọn interrupt_pin và reset_pin. Quá trình setup của nó thực hiện như sau:

• Kéo chân reset xuống mức thấp trong 5 ms, sau đó chờ.
• Đọc CRC của firmware và kỳ vọng giá trị 0xCACA. Nếu giá trị khác, nó đánh dấu component là failed.
• Đọc loại chip, project ID, phiên bản firmware và độ phân giải, sau đó chuyển chip sang chế độ bình thường.

Bước kiểm tra CRC là nơi đầu tiên cần xem khi ESPHome báo touchscreen failed. ESPHome dùng lượt đọc kiểu CST328 với địa chỉ thanh ghi 2 byte, và trong bài bench test của meshcore-firmware, kiểu đọc đó không trả lại gì hữu ích từ một con CST3530. Vì vậy trên board dùng CST3530, hãy kỳ vọng bước kiểm tra này sẽ thất bại. Đây là suy luận của chúng tôi: chúng tôi chưa chạy ESPHome trên board dùng CST3530.

Hỗ trợ driver

• ESPHome: nền tảng cst328. Tài liệu của nó nêu tên board Waveshare ESP32-S3 Touch LCD 2.8. Không có nền tảng nào dành cho CST3530.
• ESP-IDF: Waveshare phát hành esp_lcd_touch_cst328 trên component registry của Espressif. Bảng tương thích của nó chỉ liệt kê CST328.
• Rust: crate cst328 trên crates.io, và firmware RS-Key cho cả hai chip.
• Driver của chính Hynitron: LilyGO liên kết đến mã nguồn hyn_driver của Hynitron cho cả hai chip.

Các chip điều khiển liên quan

Với cảm ứng một điểm trên màn hình tròn, xem CST816S, cũng của Hynitron. Với panel lớn hơn hỗ trợ tới 5 điểm chạm, xem GT911.