CST328: طريقة التوصيل واستكشاف الأخطاء وإصلاحها

نظرة سريعة على CST328

لم نستخدم ورقة بيانات من Hynitron لهذه الأرقام. النسخة التي وجدناها على الإنترنت هي تحميل من أحد الموزعين، لذا فإن القيم أعلاه مأخوذة من شيفرة مصدر برنامج التشغيل ووثائق اللوحة.

استبدال CST3530

يقول ملف README الخاص بلوحة T-Deck Pro من LilyGO إن مورّد 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.

كيف تظهر مشكلة التبادل

كلا المشروعين الذي واجه هذه المشكلة أبلغا عن الشيء نفسه: برنامج التشغيل يعمل والشاشة ترسم، لكن لا يتم تسجيل أي لمسة. وتشير مشكلة 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. يذكر طلب دمج مفتوح في Meshtastic أن فحص I2C خَلَط بين شريحة اللمس في T-Deck Pro وجسر DS2482-800، لأن اختبار سجل الحالة تطابق مصادفةً.

هذا نمط شائع مع وحدات تحكم اللمس الصغيرة: يبقى رقم القطعة على اللوحة كما هو بينما تتغير الشريحة. إذا كنت تصنّع بكميات، فاسأل مورّد الشاشات عن شريحة اللمس المركّبة، واطلب منه إخطارك قبل تغييرها. ويشرح قاموس EOL وPCN لدينا ما يجب أن تتضمنه إشعار التغيير.

التشغيل الأولي مع ESPHome

تتطلب منصة cst328 في ESPHome إعداد I2C، وتقبل الخيارين interrupt_pin وreset_pin. عند الإعداد تقوم بما يلي:

• ترسل نبضة على خط إعادة الضبط خفضًا لمدة 5 ms، ثم تنتظر.
• تقرأ CRC لبرنامج التشغيل وتتوقع القيمة 0xCACA. عند أي قيمة أخرى تعلّم المكوّن بأنه فاشل.
• تقرأ نوع الشريحة ومعرّف المشروع ومراجعة برنامج التشغيل والدقة، ثم تحوّل الشريحة إلى الوضع العادي.

فحص CRC هو أول موضع تبحث فيه إذا أبلغ ESPHome عن فشل شاشة اللمس. يستخدم ESPHome قراءات بأسلوب CST328 مع عناوين سجلات من بايتين، وفي الاختبار المكتبي لـ 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.