دليل تكامل واجهة المستخدم الرسومية الصناعية (HMI) - تصحيح أخطاء اللمس باستخدام GT911 + LVGL

مشاكل اللمس الشائعة في GT911 في مشاريع LVGL وكيفية حلها

إطار عمل عملي لتشخيص أعطال التهيئة، وعدم الاستجابة للمس، والإحداثيات الخاطئة، والنقرات المزدوجة الخاطئة، وأخطاء عناوين I2C

من إعداد الفريق الفني لشركة كادي ديسبلاي |  www.kadidisplay.com

لماذا تُعدّ مشاكل اللمس في جهاز GT911 شائعة جدًا في مشاريع LVGL؟

يُعد GT911 أحد أكثر البرامج استخدامًا وحدات تحكم تعمل باللمس السعوي الإسقاطي يُستخدم في مشاريع العرض المدمج. ويظهر في العديد من وحدات اللمس TFT LCD بأحجام 4.3 بوصة، و5 بوصات، و7 بوصات، و10.1 بوصة، وأكبر، المستخدمة مع ESP32-S3، وSTM32، وNXP i.MX، ولوحات Raspberry Pi، ووحدات Linux framebuffers، ووحدات تحكم HMI الصناعية المُخصصة. يُسهّل LVGL نقل واجهة المستخدم، لكن طبقة اللمس لا تزال تعتمد على تفاصيل على مستوى اللوحة: توصيلات I2C، وتوقيت إعادة الضبط، وتكوين المقاطعات، وتعيين الإحداثيات، وتدوير الشاشة، وبرنامج لوحة اللمس المُدمج في GT911.

لهذا السبب، قد ينجم العرض نفسه - "عدم عمل اللمس في GT911 LVGL" - عن عدة أسباب مختلفة تمامًا. قد يفشل أحد المشاريع لأن برنامج التشغيل يفحص العنوان 0x5D فقط بينما اختار الجهاز العنوان 0x14 عند إعادة الضبط. وقد يُهيأ مشروع آخر بشكل صحيح ولكنه لا يُبلغ عن أي ضغطة لأن دبوس المقاطعة (INT) يبقى غير موصول. وقد يُظهر مشروع ثالث لمسات معكوسة أو مُزاحة بسبب اختلاف دوران شاشة LVGL ونطاق إحداثيات GT911. وقد يبدو مشروع رابع وكأنه نقرة مزدوجة لأن دالة رد الاتصال للقراءة تُبلغ عن حالات ضغط/إفلات غير مستقرة.

تتناول هذه المقالة تصحيح أخطاء GT911 كمشكلة متعددة الطبقات. ابدأ بفحص الطاقة، ثم I2C، ثم إعادة الضبط. بعد ذلك، تأكد من مُعرّف الشريحة وسجلات الإحداثيات. فقط بعد التأكد من سلامة وحدة التحكم، يُمكن إلقاء اللوم على طبقة جهاز إدخال LVGL. هذا الترتيب يوفر ساعات من التعديلات العشوائية على الكود.

أساسيات GT911: ما يجب على السائق إتقانه

يتواصل GT911 مع المضيف عبر بروتوكول I2C، ويعرض حالة اللمس، وبيانات الإحداثيات، وسجلات التكوين. تبدو واجهة المستخدم بسيطة نظريًا، لكن العديد من التفاصيل مهمة في الأجهزة الحقيقية. يستخدم المتحكم منافذ VDD وGND وSCL وSDA وINT وRESET. تدعم واجهة I2C الخاصة به سرعات تصل إلى 400 كيلوبت/ثانية، لكن التشغيل الموثوق به عند سرعات أعلى من 200 كيلوبت/ثانية يعتمد بشكل كبير على مقاومة السحب، وسعة ناقل البيانات، وجودة حافة الإشارة. في الكابلات القصيرة على لوحة دوائر مطبوعة رباعية الطبقات، غالبًا ما يكون تردد 400 كيلوهرتز كافيًا. أما في كابلات FPC الطويلة، أو لوحات التجارب، أو النماذج الأولية ذات التشويش العالي، فإن خفض تردد ناقل البيانات إلى 100 كيلوهرتز غالبًا ما يكون أسرع خطوة تشخيصية.

أهم تفاصيل GT911 لتصحيح الأخطاء هي اختيار العنوان. يدعم GT911 عنوانين I2C من 7 بت: 0x5D و0x14. أما صيغ الكتابة/القراءة من 8 بت فهي 0xBA/0xBB و0x28/0x29. يعتمد العنوان المُختار على العلاقة الزمنية بين إشارتي RESET وINT أثناء التشغيل أو إعادة التشغيل. إذا افترض البرنامج الثابت العنوان 0x5D بينما اختارت اللوحة العنوان 0x14، فسيفشل كل فحص LVGL ذي المستوى الأعلى.

في الإنتاج شاشة لمس صناعيةتُخفى هذه التفاصيل داخل برنامج اللمس الثابت وجسر USB/I2C. في مشروع LVGL مخصص، تكون هذه التفاصيل تحت سيطرة المهندس. القاعدة بسيطة: قبل تسجيل جهاز إدخال LVGL، تأكد من أن المضيف قادر على قراءة مُعرّف منتج GT911 صالح أو على الأقل تأكيد عنوان I2C المتوقع.

نمط الفشل 1: فشل تهيئة GT911

عادةً ما تعني رسالة "فشل تهيئة gt911" أن برنامج التشغيل لم يتمكن من التواصل مع وحدة التحكم أثناء بدء التشغيل. تشمل الأسباب الشائعة عنوان I2C خاطئ، أو تسلسل إعادة ضبط مفقود، أو تبديل دبابيس SDA/SCL، أو غياب مقاومات السحب، أو مشاكل في تسلسل الطاقة، أو دبوس إعادة ضبط شاشة LCD مشترك، أو عدم تثبيت لوحة اللمس بشكل كامل.

يبدأ اختبار بدء التشغيل المنظم خارج LVGL. شغّل ماسح I2C بعد التشغيل. إذا لم يظهر العنوان 0x5D أو 0x14، فتحقق أولاً من خطوط الطاقة وتخصيص الدبابيس. إذا ظهر أحد العنوانين بشكل متقطع، فخفّض سرعة I2C إلى 100 كيلوهرتز، وأضف تأخيرًا بعد إعادة الضبط، وتأكد من عدم قيام برنامج تشغيل الشاشة بتفعيل/إلغاء تفعيل زر إعادة الضبط لاحقًا. تشترك العديد من اللوحات في خط إعادة ضبط بين لوحة LCD ووحدة التحكم باللمس؛ فعندما يُعيد برنامج تشغيل الشاشة ضبط اللوحة بعد أن يكون برنامج تشغيل GT911 قد اختار عنوانها بالفعل، قد تعود شريحة اللمس تلقائيًا إلى حالة أخرى.

ينبغي لبرنامج التشغيل القوي تجربة كلا العنوانين، وعدم اعتماد أي عنوان بشكل دائم إلا بعد قراءة مُعرّف صالح أو سجل حالة الإحداثيات. في ESP32، تأكد من أن منافذ الإدخال/الإخراج العامة (GPIO) المختارة لا تُسبب سلوكًا غير متوقع عند بدء التشغيل. في STM32، تأكد من تفعيل وحدة I2C الطرفية قبل تهيئة اللمس، وأن وظائف المنافذ البديلة تتطابق مع مخطط اللوحة.

نمط العطل 2: تم العثور على وحدة تحكم اللمس، ولكن لم يتم الإبلاغ عن أي لمسة

أما الحالة الشائعة التالية فهي أكثر إرباكًا: يستجيب جهاز GT911 لبروتوكول I2C، لكن وحدة LVGL لا تتلقى أي ضغطة. وهذا يعني عادةً أن الاتصال على المستوى الأدنى يعمل، بينما مسار قراءة الإحداثيات أو دالة استدعاء قراءة LVGL غير صحيحة.

تعتمد قراءة إحداثيات GT911 عادةً على سجل الحالة الموجود في العنوان 0x814E. يتحقق النظام المضيف من جاهزية المخزن المؤقت، ثم يقرأ بيانات نقاط اللمس، ثم يمسح الحالة ليتمكن المتحكم من الإبلاغ عن الحدث التالي. إذا قرأ برنامج التشغيل الإحداثيات دون مسح علامة الجاهزية، فقد تصبح اللمسات اللاحقة قديمة أو تختفي. إذا كان برنامج التشغيل بطيئًا جدًا في عملية الاستقصاء، فقد تُفقد النقرات السريعة. إذا اعتمد برنامج التشغيل على المقاطعة (INT) ولكن تم تكوين دبوس المقاطعة بوضع الحافة أو السحب الخاطئ، فقد لا يدخل البرنامج الثابت مسار القراءة أبدًا.

في LVGL، يجب تسجيل جهاز الإدخال كجهاز مؤشر، ويجب أن تُعيد دالة الاستدعاء للقراءة كلاً من الإحداثيات والحالة. من الأخطاء الشائعة الإبلاغ عن x و y مع إبقاء الحالة على "تم التحرير"، أو الإبلاغ عن "تم الضغط" مرة واحدة فقط دون الإبلاغ عن "تم التحرير". لا يقرأ LVGL بيانات GT911 مباشرةً، بل يعتمد على دالة الاستدعاء. إذا كانت دالة الاستدعاء خاطئة، فستظهر واجهة المستخدم الرسومية بشكل خاطئ حتى لو أظهر راسم الإشارة عملية نقل I2C سليمة.

نمط الفشل 3: الإحداثيات معكوسة أو مُدارة أو مُقاسة بشكل خاطئ

لا تُعدّ الإحداثيات الخاطئة عادةً عطلاً في جهاز GT911، بل هي في الغالب خلل في الربط بين نظام إحداثيات مستشعر اللمس ونظام إحداثيات الشاشة. قد تكون لوحة اللمس مثبتة أفقيًا بينما شاشة LCD تعمل رأسيًا. قد يكون دوران شاشة LVGL مضبوطًا على 90 درجة بينما لا يزال جهاز GT911 يُبلغ عن اتجاه المستشعر الأصلي. قد تكون دقة الشاشة 800 × 480، بينما يكون الحد الأقصى لنطاق إحداثيات GT911 مضبوطًا على 480 × 800.

قم بتصحيح هذا الخطأ باختبار بسيط من خمس نقاط: أعلى اليسار، أعلى اليمين، أسفل اليسار، أسفل اليمين، والوسط. اطبع إحداثيات GT911 الخام قبل تطبيق LVGL. إذا زادت قيمة x في الاتجاه الخاطئ، اعكس x. إذا زادت قيمة y في الاتجاه الخاطئ، اعكس y. إذا تم تبديل x و y، قم بتدوير الرسم البياني. إذا وصلت الإحداثيات إلى نصف عرض الشاشة فقط، فإن الحد الأقصى للدقة المُكوّنة غير صحيح.

تجنّب التخمين. طبقة تصحيح أخطاء صغيرة أفضل من عشر عمليات إعادة بناء للبرنامج الثابت. ارسم علامة تصويب عند إحداثيات LVGL التي تُرجعها دالة رد الاتصال للقراءة، وسجّل القيم الأولية في الوقت نفسه. بمجرد أن يصبح تحويل الإحداثيات الفيزيائية صحيحًا، احتفظ به في طبقة خاصة باللوحة بدلًا من توزيع تصحيحات الدوران على أجزاء مختلفة من كود التطبيق.

نمط الفشل الرابع: نقرات مزدوجة خاطئة، ونقرات وهمية، وضغطات غير مستقرة

عادةً ما تحدث النقرات المزدوجة الخاطئة نتيجةً لعدم استقرار وضعية الضغط/الإفلات، وليس بسبب نظام LVGL نفسه. تتأثر تقنية اللمس السعوي بالتأريض، والتشويش، ووجود طبقة رقيقة من الماء، وسمك الزجاج الواقي، وطول الكابلات، وضعف الحماية، وتشويش الشاحن، والضغط الميكانيكي بالقرب من الإطار. إذا رصد جهاز GT911 سلسلة سريعة من الضغط والإفلات والضغط في نفس الموضع، فقد يفسرها نظام LVGL على أنها نقرة مزدوجة.

أولًا، افصل ارتداد البرنامج عن التشويش الكهربائي. سجّل الحالة الأولية وعدد اللمسات والإحداثيات على فترات تتراوح بين 5 و10 مللي ثانية. إذا كانت بيانات GT911 الأولية مستقرة ولكن LVGL يُظهر نقرات مزدوجة، فاضبط معالجة الإدخال أو عتبات الإيماءات أو منطق النقر على مستوى التطبيق. إذا كانت البيانات الأولية نفسها تومض، فافحص التأريض والطاقة. تحتاج لوحة اللمس السعوية إلى تأريض مرجعي نظيف. تُعدّ العلب المعدنية العائمة والنماذج الأولية التي تعمل عبر USB وأسلاك التوصيل الطويلة مصادر شائعة للمسات الوهمية.

بالنسبة لشاشات واجهة المستخدم الصناعية، تُعدّ طبقات الزجاج الواقي مهمة أيضاً. فالربط البصري، وسُمك الزجاج الواقي، وتصميم حواف الحبر، والطلاء المضاد للانعكاس/المضاد للانعكاس، وضبط خاصية رفض الماء، كلها عوامل تؤثر على أداء اللمس. لذا، لا ينبغي اختبار المنتجات النهائية على لوحة تطوير فقط، بل يجب اختبارها باستخدام الزجاج الواقي النهائي، والإطار النهائي، ومصدر الطاقة النهائي، والهيكل النهائي.

مصفوفة استكشاف الأخطاء وإصلاحها لـ GT911 + LVGL

يُلخص الجدول التالي أكثر مشاكل اللمس شيوعًا في LVGL في أعراضها وأسبابها المحتملة والاختبارات الأولية. استخدمه بالترتيب التالي: الفحوصات الكهربائية أولًا، ثم فحوصات I2C ثانيًا، ثم فحوصات سجلات GT911 ثالثًا، وأخيرًا تعيين LVGL.

دالة رد الاتصال للقراءة في LVGL: الدالة الصغيرة التي تحدد كل شيء

يتميز تكامل مدخلات LVGL بالبساطة المتعمدة. يقوم برنامج تشغيل الشاشة برسم وحدات البكسل، بينما يقوم برنامج تشغيل المدخلات بالإبلاغ دوريًا عن حالة المؤشر الحالية. بالنسبة للوحات اللمس والفأرات، تتوقع LVGL جهاز إدخال من نوع مؤشر، ودالة رد نداء للقراءة، وإحداثيات س/ص، وحالة الضغط أو الإفلات. هذه البساطة مفيدة، ولكنها تخفي أيضًا العديد من الأخطاء.

يجب أن يقوم رد نداء اللمس الآمن في LVGL بخمسة أمور. أولًا، قراءة آخر حالة لمس من GT911. ثانيًا، التحقق من صحة عدد اللمسات. ثالثًا، قراءة أول نقطة لمس أو النقطة المحددة. رابعًا، تطبيق تعيين الإحداثيات الخاص باللوحة. خامسًا، الإبلاغ عن حالة الضغط أو التحرير بشكل متسق. لا تقم بتخصيص ذاكرة داخل رد النداء. لا تقم بالحظر لمحاولات إعادة الاتصال الطويلة عبر I2C. لا تدمج منطق الإيماءات في برنامج التشغيل منخفض المستوى.

بالنسبة للمشاريع التي تدعم اللمس المتعدد، ضع توقعات واقعية. عادةً ما تحتاج تطبيقات واجهة المستخدم الرسومية الصناعية الأساسية إلى مؤشر واحد. إذا كانت واجهة المستخدم تتطلب التكبير والتصغير أو الضغط أو اللمس المتعدد المتزامن، فتأكد من أن إصدار LVGL وبنية برنامج التشغيل وعناصر واجهة المستخدم مصممة لذلك. يتم دمج العديد من لوحات الأجهزة التي تدعم اللمس المتعدد كمؤشر واحد في الإصدار الأول من المنتج لأنه أكثر موثوقية للأزرار والمنزلقات وشاشات العمليات.

قائمة التحقق من الأجهزة لتصميمات GT911 الصناعية

قد تعمل لوحة اللمس GT911 بشكل سليم على طاولة الاختبار، ولكنها قد تتعطل في بيئة التشغيل الفعلية إذا تغيرت ظروف التشغيل. يجب على الشركات المصنعة للمنتجات الصناعية التحقق من قيم مقاومة السحب I2C، وطول الكابل، وقفل FPC، واستمرارية التأريض، والحماية من التفريغ الكهروستاتيكي، والتحكم في إعادة الضبط، وتوجيه INT، وتوصيل الدرع، وتسلسل الطاقة. لا يكفي وجود مخطط نظيف؛ فالتصميم النهائي مهم للغاية. يجب إبقاء SDA وSCL بعيدًا عن نقاط تبديل الإضاءة الخلفية، ومسارات LED ذات التيار العالي، ومحولات DC/DC ذات الضوضاء العالية. أضف نقاط اختبار لـ SCL وSDA وINT وRESET حتى يمكن تشخيص الأعطال في بيئة التشغيل الفعلية دون الحاجة إلى إزالة شاشة LCD.

يُعدّ الغلاف جزءًا من نظام اللمس السعوي. ويمكن أن يؤثر سمك الزجاج الواقي، وحافة الحبر الأسود، والإطارات المعدنية، وسماكة المادة اللاصقة على حساسية اللمس. إذا كانت اللوحة مُخصصة للاستخدام على الأيدي المبللة، أو مع القفازات، أو في الأكشاك الخارجية، فيُرجى طلب تعديل برنامج اللمس من مُورّد الوحدة بدلاً من الاعتماد على الإعدادات الافتراضية المُستخدمة في الهواتف.

بالنسبة لمشاريع العرض التجارية، يمكن أن يقلل استخدام شاشة لمس صناعية متكاملة من مخاطر التكامل. على سبيل المثال، تُدرج شركة كادي ديسبلاي شاشات صناعية تعمل باللمس السعويتتضمن الميزات الاختيارية معالجات سطحية مضادة للانعكاس/مضادة للانعكاس/مضادة للضوء، وتشغيلًا في نطاق واسع من درجات الحرارة، وإمكانية تخصيص الربط والكابلات والتركيب والهيكل. هذه ليست خيارات تجميلية، بل تؤثر على ثبات اللمس بعد تجميع المنتج.

سير عمل تصحيح الأخطاء الميدانية: من اللمس الميت إلى واجهة المستخدم الرسومية المستقرة

تبدو عملية تصحيح الأخطاء العملية كالتالي: أولًا، قم بتشغيل اللوحة وتأكد من وجود مصدر طاقة لـ GT911 باستخدام جهاز قياس. ثانيًا، تحقق من إشارتي RESET وINT باستخدام محلل منطقي أثناء بدء التشغيل. ثالثًا، افحص بروتوكول I2C بحثًا عن القيمتين 0x5D و0x14. رابعًا، اقرأ مُعرّف المنتج أو سجل حالة معروف. خامسًا، اقرأ نقاط اللمس الخام خارج LVGL. سادسًا، سجّل جهاز إدخال مؤشر LVGL فقط بعد استقرار اللمس الخام. سابعًا، حدد الإحداثيات وقم بتشغيل اختبار النقاط الخمس. ثامنًا، اختبر النقرات المزدوجة الخاطئة باستخدام غطاء الزجاج النهائي ومصدر الطاقة.

يُعدّ هذا الترتيب مهمًا لأنه يمنع الوقوع في فخّ تصحيح الأخطاء الأكثر شيوعًا: تغيير كود تطبيق LVGL قبل تهيئة وحدة التحكم. في معظم المشاريع الحقيقية، لا تكمن المشكلة في خطأ برمجي واحد جسيم، بل في عدم توافق بين مخطط اللوحة، وتوقيت وحدة التحكم باللمس، وافتراضات برنامج التشغيل، ودوران الشاشة. بمجرد فصل هذه الطبقات، يصبح GT911 جزءًا يمكن التنبؤ به بدلًا من كونه جزءًا غامضًا.

ملخص: أصلح المشكلة الأساسية، وليس الأعراض فقط

عندما تتعطل لوحة اللمس GT911 في مشروع LVGL، يكون العرض عادةً بسيطًا: لا يوجد لمس، أو لمس خاطئ، أو لمس غير مستقر. أما السبب فنادرًا ما يكون بسيطًا. قد يكون عنوان I2C مُختارًا عند إعادة الضبط، أو دبوس مقاطعة في وضع خاطئ، أو مخزن إحداثيات قديم، أو محور مُبدّل، أو تشويش كهربائي ناتج عن الغلاف الخارجي.

أهم عادة هندسية هي تصحيح الأخطاء من الأسفل إلى الأعلى. تحقق من الطاقة. تحقق من إعادة الضبط. تحقق من بروتوكول I2C. تحقق من سجلات GT911. تحقق من الإحداثيات الأولية. ثم قم بتوصيل LVGL. بالنسبة لمشاريع واجهة المستخدم الرسومية الصناعية، اختبر أيضًا المكونات الميكانيكية النهائية: الغطاء الزجاجي، والوصلات، والإطار، والتأريض، والكابل، ومصدر الطاقة.

تُتيح تقنيتا GT911 وLVGL إنشاء منصة واجهة مستخدم رسومية مدمجة موثوقة للأكشاك، والمحطات الطبية، وشاشات المركبات، والأجهزة المنزلية الذكية، وواجهات المستخدم في المصانع، وشاشات اللمس الصناعية المُخصصة. إن الفرق بين نموذج أولي هش وشاشة لمس جاهزة للإنتاج لا يكمن في إصدار مكتبة برمجية واحد، بل في عملية تكامل مُحكمة.

ملاحظات المصدر

دليل برمجة GT911: يتصل GT911 من خلال VDD و GND و SCL و SDA و INT و RESET؛ يدعم عنوانين I2C من 7 بت، 0x5D و 0x14؛ يعتمد اختيار العنوان على توقيت RESET/INT؛ تعتمد قراءة الإحداثيات على سجلات الحالة والإحداثيات.

وثائق جهاز الإدخال LVGL: تتطلب أجهزة إدخال المؤشر LVGL بنية برنامج تشغيل الإدخال، ونوع المؤشر، ووظيفة رد الاتصال للقراءة، والإحداثيات، والإبلاغ عن حالة الضغط/التحرير.

موارد شاشة اللمس من كادي ديسبلاي: تتناول صفحات Kadi Display تقنيات اللمس المقاومة والسعوية، واختيار شاشات اللمس الصناعية، ومعالجة AG/AR/AF الاختيارية، والتشغيل في نطاق درجات الحرارة الواسعة، والربط البصري، وتكامل الشاشات المدمجة.

ملاحظة هندسية: يجب التحقق من جميع قيم التسجيل والتوقيت مقابل وحدة GT911 المحددة، وبرنامج اللمس الثابت، ومخطط اللوحة، وإصدار برنامج التشغيل المستخدم في المنتج النهائي.

تنصل

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