CST328: การตั้งค่า & การแก้ปัญหา

CST328 ภาพรวมโดยสังเขป

ค่าตัวเลขเหล่านี้ไม่ได้มาจากดาต้าชีตของ Hynitron โดยตรง เนื่องจากเอกสารที่พบบนอินเทอร์เน็ตเป็นไฟล์ที่ผู้จำหน่ายอัปโหลด ค่าทั้งหมดข้างต้นจึงอ้างอิงจากซอร์สโค้ดไดรเวอร์และเอกสารประกอบบอร์ด

การเปลี่ยนมาใช้ CST3530

README ของ LilyGO T-Deck Pro ระบุว่าผู้ผลิต CST328 "หยุดการผลิตไปแล้ว" บอร์ด T-Deck Pro v1.1 รุ่นใหม่จึงใช้ CST3530 พร้อมระบุว่า "ทั้งสองชิปใช้แอดเดรสอุปกรณ์เดียวกัน" ไฟรม์แวร์จึงต้องตรวจสอบรุ่นชิประหว่างขั้นตอนเริ่มต้น LilyGO ใช้รูทีน cst66xx ของ Hynitron สำหรับ CST3530 และ cst3xx สำหรับ CST328

บอร์ด RP2350-Touch-LCD-2.8 ของ Waveshare เปลี่ยนมาใช้ชิปรุ่นใหม่เช่นเดียวกัน โปรเจกต์ 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 จึง probe หา CST3530 เป็นอันดับแรก เพราะ CST3530 "ตอบรับการอ่านรีจิสเตอร์แบบ CST328 อย่างไม่มีปัญหา" ทั้งนี้พวกเขาระบุด้วยว่าโค้ดส่วนนี้ยังไม่เคยรันบนบอร์ด CST3530 มาก่อน การทดสอบ bench test ของ meshcore-firmware บน T-Deck Pro V1.1 ให้ผลเช่นเดียวกัน: การอ่านแบบ CST328 ได้รับการตอบรับแต่ไม่คืนค่าชนิดชิปและความละเอียด ส่วนการอ่านแบบ CST3530 คืนค่าบล็อกที่ถูกต้องพร้อม marker 0xCA 0xCA และความละเอียด 240×320 ของแผงจอ
• ไดรเวอร์อื่นอาจเข้าใจว่าเป็นชิปที่ 0x1A ก็ได้ pull request ของ Meshtastic ที่ยังเปิดอยู่รายงานว่าการสแกน I2C เข้าใจผิดว่าชิป touch ของ T-Deck Pro เป็น bridge DS2482-800 เพราะการทดสอบ status-register บังเอิญตรงกัน

นี่เป็นรูปแบบที่พบบ่อยกับ touch controller ขนาดเล็ก: หมายเลขพาร์ตบนบอร์ดยังคงเดิมแต่ชิปภายในเปลี่ยนไป หากคุณผลิตเป็นปริมาณมาก ควรสอบถามผู้จำหน่ายจอว่าติดตั้ง touch IC รุ่นใด และขอให้แจ้งล่วงหน้าหากมีการเปลี่ยนรุ่น อภิธานศัพท์ EOL และ PCN ของเราอธิบายว่า change notice ที่ดีควรมีเนื้อหาอย่างไร

การ bring-up ด้วย ESPHome

แพลตฟอร์ม cst328 ของ ESPHome ต้องมีการตั้งค่า I2C และรับ interrupt_pin และ reset_pin แบบตัวเลือกได้ ขั้นตอน setup ของมันทำดังนี้:

• ดึงขา reset เป็น low นาน 5 ms แล้วรอ
• อ่าน CRC ของเฟิร์มแวร์และคาดหวังค่า 0xCACA หากได้ค่าอื่นจะทำเครื่องหมายว่าคอมโพเนนต์ล้มเหลว
• อ่านชนิดชิป project ID, firmware revision และความละเอียด จากนั้นสลับชิปเข้าสู่โหมดปกติ

การตรวจ CRC เป็นจุดแรกที่ควรตรวจหาก ESPHome รายงานว่า touchscreen ล้มเหลว ESPHome ใช้การอ่านแบบ CST328 ที่มีที่อยู่รีจิสเตอร์ 2 ไบต์ และจาก bench test ของ meshcore-firmware การอ่านลักษณะนี้ไม่คืนค่าที่ใช้ประโยชน์ได้จาก CST3530 ดังนั้นบนบอร์ดที่ใช้ CST3530 ให้คาดหวังว่าการตรวจนี้จะล้มเหลว ซึ่งเป็นข้ออ้างอิงของเราเอง: เรายังไม่เคยรัน ESPHome บนบอร์ด CST3530

การรองรับของไดรเวอร์

• ESPHome: แพลตฟอร์ม cst328 เอกสารของมันระบุบอร์ด Waveshare ESP32-S3 Touch LCD 2.8 และไม่มีแพลตฟอร์มสำหรับ CST3530
• ESP-IDF: Waveshare เผยแพร่ esp_lcd_touch_cst328 ใน Espressif component registry ตารางความเข้ากันได้ของมันระบุเฉพาะ CST328 เท่านั้น
• Rust: crate cst328 บน crates.io และเฟิร์มแวร์ RS-Key ที่รองรับทั้งสองชิป
• ไดรเวอร์จาก Hynitron เอง: LilyGO ลิงก์ซอร์สโค้ด hyn_driver ของ Hynitron ซึ่งรองรับทั้งสองชิป

ชิปควบคุมที่เกี่ยวข้อง

สำหรับ touch นิ้วเดียวบนจอทรงกลม ดู CST816S ซึ่งเป็นผลิตภัณฑ์ของ Hynitron เช่นกัน สำหรับแผงจอขนาดใหญ่ที่รองรับสูงสุด 5 จุด ดู GT911