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

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

كيفية إنشاء OpenThread

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

سير العمل الأكثر شيوعًا هو:

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

      docker pull openthread/environment:latest
      docker run -it --rm openthread/environment bash
      

2. في البيئة التي اخترتها، يمكنك نسخ مستودع OpenThread Git الخاص بالنظام الأساسي. ويمكن استخدام CC2538 كمثال:

   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
خيارات إنشاء Cc	مدرج في openthread/examples/README.md

أمثلة على الإصدارات

يمكنك استخدام خيارات إنشاء cmake لتفعيل الوظيفة للنظام الأساسي. على سبيل المثال، لإنشاء الملف الثنائي للنظام الأساسي CC2538 مع تفعيل دعم المفوضية والانضمام:

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

أو لإنشاء النظام الأساسي nRF52840 مع تفعيل ميزة اكتشاف محتوى Jam في بياناته:

./script/build nrf52840 UART_trans -DOT_JAM_DETECTION=ON

البرامج الثنائية

ويتم إنشاء البرامج الثنائية التالية في ./build/bin من عملية الإصدار. لتحديد البرامج الثنائية التي يتم إنشاؤها، استخدِم العلامات باستخدام الأمر ./script/build. على سبيل المثال، لإنشاء OpenThread وإنشاء ملف 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	جهاز سلاسل محادثات كاملة لتصميمات منظومة على رقاقة (SoC)	-DOT_APP_CLI=ON -DOT_FTD=ON
ot-cli-mtd	جهاز مصغر لخيوط "المنظومة على الرقاقة" (SoC)	-DOT_APP_CLI=ON -DOT_MTD=ON
ot-ncp-ftd	جهاز سلاسل محادثات كاملة لتصميمات معالج الشبكة (NCP)	-DOT_APP_NCP=ON -DOT_FTD=ON
ot-ncp-mtd	جهاز بساطة سلسلة لتصميمات NCP	-DOT_APP_NCP=ON -DOT_MTD=ON
ot-rcp	تصميم معالج لاسلكي (RCP)	-DOT_APP_RCP=ON -DOT_RCP=ON

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

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

وتختلف عملية إضافة هذه البرامج الثنائية باختلاف أمثلة المنصّات. يُرجى الاطّلاع على ReadMES في كل مجلد نموذج على نظام أساسي للحصول على تعليمات تفصيلية.

البرنامج الخفي لـ OpenThread

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

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

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