استكشاف أخطاء البرامج التعليمية للجهاز المضمن Eclipse ThreadX وإصلاحها

أثناء اتباع البرامج التعليمية للجهاز المضمن Eclipse ThreadX، قد تواجه بعض المشكلات الشائعة. بشكل عام، يمكن أن تحدث مشكلات في أي من المصادر التالية:

  • بيئتك. إعداد الجهاز أو البرنامج أو الشبكة والاتصال.
  • موارد Azure IoT الخاصة بك. مركز IoT والجهاز الذي أنشأته للاتصال ب Azure IoT.
  • جهازك. اللوحة الفعلية وتكوينها.

توفر هذه المقالة الحلول المقترحة للمشكلات الأكثر شيوعا التي يمكن أن تحدث أثناء إكمال البرامج التعليمية.

المتطلبات الأساسية

تتطلب جميع خطوات استكشاف الأخطاء وإصلاحها إكمال المتطلبات الأساسية التالية للبرنامج التعليمي الذي تعمل فيه:

  • لقد قمت بتثبيت أو الحصول على جميع المتطلبات الأساسية وأدوات البرنامج للبرنامج التعليمي.
  • لقد أنشأت مركز Azure IoT أو تطبيق Azure IoT Central، وسجلت جهازا، كما هو موجه في البرنامج التعليمي.
  • لقد أنشأت صورة للجهاز، كما هو موجه في البرنامج التعليمي.

المشكلة: لا يحتوي الدليل المصدر على ملف CMakeLists.txt

‏‏الوصف

يمكن أن تحدث هذه المشكلة عند محاولة إنشاء المشروع. إنها نتيجة استنساخ المشروع بشكل غير صحيح من GitHub. يحتوي المشروع على عدة وحدات فرعية لن يتم استنساخها بشكل افتراضي ما لم يتم استخدام العلامة --recursive .

نوع الحل

  • عند استنساخ المستودع باستخدام Git، تأكد من وجود الخيار --recursive .

المشكلة: فشل الإنشاء

‏‏الوصف

يمكن أن تحدث المشكلة لأن المسار إلى ملف كائن يتجاوز الحد الأقصى الافتراضي لطول المسار في Windows. افحص إخراج البنية لرسالة مشابهة للمثال التالي:

-- Configuring done
CMake Warning in C:/embedded tutorials/areallyreallyreallylongpath/getting-started/core/lib/netxduo/addons/azure_iot/azure_iot_security_module/iot-security-module-core/CMakeLists.txt:
  The object file directory

    C:/embedded tutorials/areallyreallyreallylongpath/getting-started/NXP/MIMXRT1060-EVK/build/lib/netxduo/addons/azure_iot/azure_iot_security_module/iot-security-module-core/CMakeFiles/asc_security_core.dir/./

  has 208 characters.  The maximum full path to an object file is 250
  characters (see CMAKE_OBJECT_PATH_MAX).  Object file

    src/serializer/extensions/custom_builder_allocator.c.obj

  cannot be safely placed under this directory.  The build may not work
  correctly.


-- Generating done

نوع الحل

يمكنك تجربة أحد الخيارات التالية لحل هذا الخطأ:

  • انسخ المستودع في دليل بمسار أقصر وحاول مرة أخرى.
  • اتبع الإرشادات الواردة في الحد الأقصى لطول المسار لتمكين المسارات الطويلة في Windows 11 وWindows 10، الإصدار 1607 والإصدارات الأحدث.

المشكلة: لا يمكن للجهاز الاتصال بمركز Iot

‏‏الوصف

يمكن أن تحدث المشكلة بعد إنشاء موارد Azure، ووميض جهازك. عند محاولة توصيل جهازك الذي تم وميضه حديثا ب Azure IoT، سترى رسالة وحدة تحكم مثل المثال التالي:

Unable to resolve DNS for MQTT Server

نوع الحل

  • تحقق من التدقيق الإملائي وحالة قيم التكوين التي أدخلتها لتكوين IoT في الملف azure_config.h. قيم بعض سمات موارد IoT، مثل deviceID و primaryKey، حساسة لحالة الأحرف.

المشكلة: Wi-Fi غير قادر على الاتصال

‏‏الوصف

بعد وميض جهاز يستخدم اتصال Wi-Fi، تتلقى رسالة خطأ تفيد بأن Wi-Fi غير قادر على الاتصال.

نوع الحل

  • تحقق من تكرار شبكة Wi-Fi وإعداداتك. تستخدم جميع الأجهزة المستخدمة في البرامج التعليمية للجهاز المضمنة 2.4 غيغاهرتز. تأكد من تكوين موجه Wi-Fi لدعم شبكة 2.4 غيغاهرتز.
  • تحقق من وضع Wi-Fi. تأكد من الإعداد الذي استخدمته للثابت WIFI_MODE في ملف azure_config.h . تحقق من إعدادات أمان شبكة Wi-Fi أو المصادقة للتأكد من أن وضع أمان Wi-Fi يطابق ما لديك في ملف التكوين.

المشكلة: فشل وامض اللوحة

‏‏الوصف

لا يمكنك إكمال عملية وميض جهازك. تشير الأعراض التالية إلى أن الوميض غير مكتمل:

  • لا يتم نسخ ملف الصورة *.bin الذي قمت ببنائه إلى الجهاز.
  • الأداة المساعدة التي تستخدمها لوميض الجهاز تعطي تحذيرا أو خطأ.
  • لا تشير الأداة المساعدة التي تستخدمها لوميض الجهاز إلى اكتمال البرمجة بنجاح.

نوع الحل

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

المشكلة: فشل الجهاز في الاتصال بالمنفذ

‏‏الوصف

بعد وميض جهازك وتوصيله بالكمبيوتر، تحصل على إخراج مثل الرسالة التالية في برنامج المحطة الطرفية:

Failed to initialize the port.
Please verify the COM port settings.

نوع الحل

  • في إعدادات برنامج المحطة الطرفية، تحقق من إعداد المنفذ للتأكد من تحديد المنفذ الصحيح. إذا كانت هناك منافذ متعددة معروضة، يمكنك فتح Windows إدارة الأجهزة وتحديد عقدة المنافذ للعثور على المنفذ الصحيح لجهازك المتصل.

المشكلة: يعرض إخراج المحطة الطرفية نصا مشوشا

‏‏الوصف

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

نوع الحل

  • في إعدادات برنامج المحطة الطرفية، تأكد من أن إعداد معدل الباود هو 115200.

المشكلة: لا يظهر إخراج المحطة الطرفية أي نص

‏‏الوصف

بعد أن تومض جهازك بنجاح وتوصيله بالكمبيوتر، لن ترى أي إخراج في برنامج المحطة الطرفية.

نوع الحل

  • تأكد من أن الإعدادات في برنامج المحطة الطرفية تطابق الإعدادات في البرنامج التعليمي.
  • أعد تشغيل برنامج المحطة الطرفية.
  • اضغط على الزر إعادة تعيين على جهازك.
  • تأكد من توصيل كبل USB بشكل صحيح.

المشكلة: فشل الاتصال بين الجهاز ومركز IoT

‏‏الوصف

بعد وميض جهازك وتوصيله بالكمبيوتر، تحصل على إخراج مثل الرسالة التالية في نافذة المحطة الطرفية:

Failed to publish temperature

نوع الحل

  • تأكد من أن مستوى التسعير والمقياس هو واحد من المستوى المجاني أو القياسي. الأساسي غير مدعوم لأنه لا يدعم الاتصال من السحابة إلى الجهاز والجهاز المزدوج.

المشكلة: رسائل إضافية مرسلة عند الاتصال ب IoT Central أو IoT Hub

‏‏الوصف

نظرا لأن وحدة Defender for IoT يتم تمكينها افتراضيا من نهاية الجهاز، فقد تلاحظ رسائل إضافية في الإخراج.

نوع الحل

  • لتعطيلها، حدد NX_AZURE_DISABLE_IOT_SECURITY_MODULE في ملف nx_port.hرأس NetX Duo .

الخطوات التالية

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