ملاحظات ورقة بيانات FT6336: عنوان I2C والسجلات وحلول مشاكل اللمس

الشركة المصنّعة	FocalTech
النوع	وحدة تحكم اللمس
الواجهات	I2C
أقصى دقة	2 touch points

إجابة سريعة

FT6336 هي وحدة تحكم لمس سعوي ذاتي (self-capacitive) من FocalTech لنقطتَي لمس عبر I2C، وتستخدم المكتبات العنوان 0x38. تسمح ورقة البيانات بتردد SCL يصل إلى 400 kHz ونبضة إعادة ضبط لا تقل عن 5 ms، تليها 300 ms قبل أن تبدأ في إرسال البيانات. تبدأ بيانات اللمس عند السجل 0x02، وتقرأ المكتبات معرّف الشريحة من السجل 0xA3 (القيمة 0x64 للـ FT6336U).

عنوان I2C هو 0x38 في مشغّلات Adafruit وEspressif
نقطتا لمس، أو نقطة واحدة مع الإيماءات
تردد SCL على I2C من 10 إلى 400 kHz؛ ومعدل الإرسال يصل إلى 100 Hz
إعادة ضبط لا تقل عن 5 ms، تليها 300 ms على الأقل قبل أن تبدأ في رصد اللمس
معرّف الشريحة عند السجل 0xA3: القيمة 0x64 للـ FT6336U، وفقًا لـ Adafruit

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

البند	القيمة	المصدر
نقاط اللمس	نقطتان، أو نقطة واحدة مع إيماءات	ورقة بيانات FT6336G
عنوان I2C (7 بت)	`0x38`	برامج التشغيل من Adafruit وEspressif
خط SCL في I2C	10 إلى 400 kHz	ورقة بيانات FT6336G
معدل الإبلاغ	حتى 100 Hz	ورقة بيانات FT6336G
جهد التشغيل	من 2.8 V إلى 3.6 V	ورقة بيانات FT6336G
IOVCC	مستقل، من 1.8 V إلى 3.6 V	ورقة بيانات FT6336G
درجة حرارة التشغيل	من −40 °C إلى 85 °C	ورقة بيانات FT6336G

تذكر قائمة الميزات في ورقة البيانات نطاق 2.8 V إلى 3.6 V، بينما يذكر جدول التيار المستمر أن VDDA وVDD3 يعملان من 2.8 V إلى 3.3 V. صمّم وفق النطاق الأضيق ما لم يخبرك مورد الوحدة بخلاف ذلك.

أي نسخة من FT6336 لديك؟

القطعة	القنوات	الحزمة	حجم اللوحة
FT6336G	31	QFN بمقاس 5×5، 40 طرفًا	حتى 4.0″
FT6336DMB	36	QFN بمقاس 6×6، 48 طرفًا	حتى 4.5″

تأتي هذه الأرقام من ورقتي بيانات من FocalTech: ورقة FT6336G الإصدار 1.0 وسلسلة FT6X36 الإصدار 0.3. لم نعثر على ورقة بيانات لشريحة FT6336U، لذا فإن ما نذكره عنها مستمد من الشيفرة المصدرية لبرامج التشغيل.

قراءة نقطة لمس

تقرأ الشيفرة المصدرية لـ FT63x6 في ESPHome السجلات التالية:

السجل	المحتوى
`0x00`	وضع الجهاز (يكتب ESPHome القيمة `0x00`)
`0x02`	عدد نقاط اللمس، البتات الأربعة الأدنى
`0x03`	الحدث في البتات 7:6، والبتات العليا لقيمة X في البتات 3:0
`0x04`	البايت الأدنى لقيمة X
`0x05`	معرّف اللمس في البتات 7:4، والبتات العليا لقيمة Y في البتات 3:0
`0x06`	البايت الأدنى لقيمة Y
`0x07`	وزن نقطة اللمس
`0x80`	عتبة اللمس
`0x88`	معدل اللمس في الوضع النشط (يكتب ESPHome القيمة `0x0E`)
`0xA3`	معرّف الشريحة

تستخدم نقطة اللمس الثانية نفس الترتيب بإزاحة 6 بايتات لأعلى، بدءًا من 0x09. يتجاهل ESPHome عدد اللمس الذي يساوي 0x00 أو 0xFF.

توقيت إعادة الضبط والتشغيل

من ورقة بيانات FT6336G:

نبضة إعادة الضبط (Trst): مستوى منخفض على RSTN لمدة 5 ms على الأقل.
بعد إعادة الضبط (Trsi): 300 ms على الأقل حتى يبدأ في الإبلاغ عن النقاط.
بعد التشغيل (Tpon): 300 ms على الأقل حتى يبدأ في الإبلاغ عن النقاط.
قبل التشغيل: أبقِ خط RSTN منخفضًا. ويُنصح أيضًا بإبقاء خط INT وخطوط I2C منخفضة.
إعادة التشغيل بالطاقة: اترك الجهد ينخفض إلى أقل من 0.3 V لمدة تزيد عن 5 ms.

تختلف برامج التشغيل في هذه النقطة. ينتظر برنامج التشغيل edt-ft5x06 في Linux مدة 300 ms بعد تحرير إعادة الضبط، وهو ما يتوافق مع ورقة البيانات. أما روتين إعادة الضبط في ESPHome فيبقي إعادة الضبط منخفضة لمدة 10 ms ولا يضيف أي انتظار بعد تحريرها. وبرنامج التشغيل FT5x06 من Espressif يبقي إعادة الضبط لمدة 10 ms ثم ينتظر 10 ms.

أوضاع التشغيل وواجهة I2C

تذكر ورقة البيانات ثلاثة أوضاع:

نشط (Active): يمسح بمعدل افتراضي قدره 60 إطارًا في الثانية، ويمكن للمضيف تغيير هذا المعدل.
مراقبة (Monitor): يمسح بمعدل افتراضي قدره 25 إطارًا في الثانية. وتعيده نقطة اللمس إلى الوضع النشط. تقول ورقة البيانات إن "المنفذ التسلسلي مغلق" في هذا الوضع.
السبات (Hibernation): وضع إيقاف التشغيل الذي يتطلب إعادة ضبط أو إشارة استيقاظ من المضيف.

قد تكون ملاحظة وضع المراقبة (Monitor) مهمة عند مسح ناقل I2C على لوحة في وضع الخمول. لم نقس هذا بأنفسنا، لذا تعامل معه كأمر ينبغي استبعاده: المس اللوحة أثناء إجراء المسح.

الأعراض والحلول

العرَض	التحقق
لا يوجد جهاز على العنوان `0x38`	تأكد من أن RSTN في الحالة العالية، وانتظر 300 ms بعد إعادة الضبط، ثم المس اللوحة أثناء عملية المسح. بعد ذلك تحقق من خطوط SDA وSCL ومقاومات الرفع (pull-ups).
ESPHome يعرض رسالة "FT6336U touch driver failed to start"	قرأ ESPHome القيمة `0` من السجل `0xA3`. يعرض هذه الرسالة ويستمر في العمل، لذا تحقق من التوصيلات وتوقيت إعادة الضبط.
المكتبة ترفض معرّف الشريحة (chip ID)	تختلف المعرّفات حسب القطعة: تذكر مكتبة Adafruit المعرف `0x06` للـ FT6206، و`0x36` للـ FT6236، و`0x64` للـ FT6236U والـ FT6336U. تحقق من القيم التي تقبلها مكتبتك.
حساسية اللمس عالية جدًا أو منخفضة جدًا	قيمة السجل `0x80` تعتمد على اللوحة نفسها. تعتمد Adafruit القيمة الافتراضية 128، وهي "معايرة" لشاشتها المقاسة 2.8″، بينما يكتب مشغّل FT5x06 من Espressif القيمة 70. لا تفترض أن أيًّا منهما يناسب لوحتك.
الإصبع الثالث لا يتم رصده	هذا هو الحد الأقصى للشريحة: ورقة البيانات ومشغّل لينكس كلاهما يحددان نقطتَي لمس فقط. للحصول على نقاط أكثر، راجع GT911.

دعم المشغّلات (drivers)

ESPHome: استخدم منصة ft63x6 مع الخيارين reset_pin وinterrupt_pin حسب الحاجة. يجب أن يكون I2C مُهيأً. تشير وثائقه إلى لوحة WT32-SC01، وكود المصدر الخاص به يذكر FT6336U.
Linux: لا يوجد إدخال خاص بـ FT6336. الأقرب هو focaltech,ft6236 في مشغّل edt-ft5x06، بنقطتَي لمس وخصائص إلزامية وهي compatible وreg وinterrupts. لم نختبر هذا الخيار مع شريحة FT6336.
ESP-IDF: يستخدم مشغّل esp_lcd_touch_ft5x06 العنوان 0x38 والتردد 100 kHz افتراضيًا. يغطي كود المصدر الخاص به حتى 5 نقاط ولا يذكر FT6336 صراحةً، لذا تحقق من قطعتك قبل الاعتماد عليه.
Arduino: مكتبة FT6206 من Adafruit تُعرّف معرّف الشريحة الخاص بـ FT6336U وتعتمد افتراضيًا العنوان 0x38.

وحدات تحكم ذات صلة

لللمس بإصبع واحد على الشاشات الدائرية، راجع CST816S. للوحات أكبر، راجع GT911. لوحة M5Stack Core2 هي أحد اللوحات التي تستخدم شريحة FT6336U.

الأدلة والمقارنات

دليل

كيف تختار شاشة لـ ESP32-S3 (SPI وQSPI وRGB)

اختر الواجهة والدقة من رقمين: كم بتاً في الثانية يستطيع الناقل نقله، وكم ذاكرة يحتاجها الإطار. مع أرقام محسوبة وتصاميم مرجعية.

حل المشكلات والأسئلة الشائعة لـ FT6336

ما هو عنوان I2C الخاص بشريحة FT6336؟

تستخدم مشغّلات Adafruit وEspressif العنوان 0x38 (بصيغة 7-bit)، ويستخدم لينكس القيمة نفسها في مثال الربط الخاص بعائلة FT5x06. ورقة بيانات FT6336G التي اطلعنا عليها لا تذكر العنوان، لذا تأكد منه عبر مسح I2C على لوحتك.

لماذا لا تستجيب شريحة FT6336 على ناقل I2C؟

تحقق من أن RSTN في الحالة العالية، ثم انتظر 300 ms على الأقل بعد إعادة الضبط: هذا هو الحد الأدنى المذكور في ورقة البيانات قبل أن تبدأ الشريحة في رصد نقاط اللمس. تذكر ورقة البيانات أيضًا أن المنفذ التسلسلي مغلق في وضع Monitor، لذا المس اللوحة وأعد المسح قبل أن تشك في التوصيلات.

ما الفرق بين FT6336 وFT6336G وFT6336U؟

تُدرج أوراق بيانات FocalTech الشريحة FT6336G بـ 31 قناة للوحات حتى مقاس 4.0″، والشريحة FT6336DMB بـ 36 قناة للوحات حتى مقاس 4.5″. لم نجد ورقة بيانات للشريحة FT6336U. تمنحها مكتبة Adafruit معرّف الشريحة 0x64، وهو المعرف نفسه الخاص بالـ FT6236U.

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