إنشاء سلسلة محادثات

عرض المصدر على GitHub

كيفية إنشاء OpenThread

تختلف خطوات إنشاء OpenThread حسب مجموعة الأدوات وجهاز المستخدم والنظام الأساسي المستهدف.

في ما يلي الخطوات الأكثر شيوعًا:

  1. إعداد بيئة الإنشاء وتثبيت مجموعة الأدوات المطلوبة:
    1. لإنشاء محاكاة مباشرةً على جهاز، اطّلِع على الدرس التطبيقي حول المحاكاة للحصول على تعليمات مفصّلة.
    2. لاستخدام حاوية Docker مع بيئة تم ضبطها مسبقًا، نزِّل صورة OpenThread environment وشغِّلها:
      docker pull openthread/environment:latest
      docker run -it --rm openthread/environment bash
      
  2. ضمن البيئة التي اخترتها، استنسِخ مستودع OpenThread Git الخاص بالنظام الأساسي. في ما يلي مثال على ذلك:
    git clone https://github.com/openthread/ot-cc2538.git --recursive
    
  3. من الدليل الجذر للمستودع المستنسخ، اتّبِع الخطوات التالية:
    1. ثبِّت مجموعة الأدوات:
      ./script/bootstrap
      
    2. أنشئ الإعدادات على النحو التالي:
      ./script/build platform-specific-args cmake-options
      
  4. أرسِل الرمز الثنائي المطلوب إلى النظام الأساسي المستهدف. تتوفّر جميع الملفات الثنائية التي تم إنشاؤها في ./build/bin.

التهيئة

يمكنك ضبط OpenThread للحصول على وظائف وسلوكيات مختلفة أثناء عملية الإنشاء. يمكن الاطّلاع على تفاصيل خيارات الإعداد المتاحة في المواقع التالية:

النوع الموقع الجغرافي
الثوابت في وقت التجميع مُدرَج في جميع ملفات العناوين في /src/core/config
خيارات إنشاء cmake مُدرَج في /etc/cmake/options.cmake

إنشاء أمثلة

استخدِم خيارات إنشاء cmake لتفعيل وظائف النظام الأساسي. على سبيل المثال، لإنشاء الرمز الثنائي لمنصة CC2538 مع تفعيل دعم Commissioner وJoiner، اتّبِع الخطوات التالية:

./script/build -DOT_COMMISSIONER=ON -DOT_JOINER=ON

أو لإنشاء منصة nRF52840 مع تفعيل ميزة رصد التشويش في مستودعها:

./script/build nrf52840 UART_trans -DOT_JAM_DETECTION=ON

الملفات الثنائية

يتم إنشاء الرموز الثنائية التالية في ./build/bin من عملية الإنشاء. لتحديد الثنائيات التي يتم إنشاؤها، استخدِم العلامات مع الأمر ./script/build. على سبيل المثال، لإنشاء OpenThread وإنشاء ثنائي FTD CLI فقط:

./script/build -DOT_APP_CLI=ON -DOT_FTD=ON -DOT_MTD=OFF -DOT_APP_NCP=OFF -DOT_APP_RCP=OFF -DOT_RCP=OFF
برنامج ثنائي الوصف الخيارات
ot-cli-ftd جهاز Thread كامل لتصميمات SoC -DOT_APP_CLI=ON
-DOT_FTD=ON
ot-cli-mtd الحدّ الأدنى من أجهزة Thread لتصاميم SoC -DOT_APP_CLI=ON
-DOT_MTD=ON
ot-ncp-ftd جهاز Thread كامل لتصاميم معالج الشبكة المشترك (NCP) -DOT_APP_NCP=ON
-DOT_FTD=ON
ot-ncp-mtd جهاز Thread الحد الأدنى لتصاميم NCP -DOT_APP_NCP=ON
-DOT_MTD=ON
ot-rcp تصميم معالج الراديو المشترك (RCP) -DOT_APP_RCP=ON
-DOT_RCP=ON

يتم تفعيل جميع العلامات أعلاه تلقائيًا. إذا أوقفت جميع العلامات بشكل صريح، لن يتم إنشاء التطبيقات، ولكن سيظل يتم إنشاء ملفات مكتبة OpenThread في ./build/lib لاستخدامها في أحد المشاريع.

راجِع الدليل examples/platforms لمعرفة العلامات التي تتيحها كل منصة. لمزيد من المعلومات عن FTD وMTD، اطّلِع على مقدمة حول سلاسل المحادثات. لمزيد من المعلومات حول تصاميم SoC وNCP، يُرجى الاطّلاع على المنصات.

تختلف عملية تنزيل هذه الملفات الثنائية على المنصات النموذجية. راجِع ملفات README في مجلد الأمثلة لكل منصة للحصول على تعليمات مفصّلة.

OpenThread Daemon

‫OpenThread Daemon (OT Daemon) هو وضع إنشاء OpenThread POSIX الذي يشغّل OpenThread كخدمة ويتم استخدامه مع تصميم RCP. لمزيد من المعلومات حول كيفية إنشاء هذه الأداة واستخدامها، راجِع OpenThread Daemon.

إنشاء حِزم دعم

يمكن العثور على حِزم دعم الإصدارات (BSPs) في /third_party. حِزم دعم النظام الأساسي هي رموز إضافية تابعة لجهات خارجية تستخدمها OpenThread على كل نظام أساسي، ويتم تضمينها بشكل عام عند نقل OpenThread إلى نظام أساسي جديد للأجهزة.