الاطّلاع على المصدر على GitHub
يتناول هذا الدليل الإنشاء الأساسي وضبطه لمفوض OpenThread. (مفوَّض OT). بعد الانتهاء من هذا الإجراء، ستحصل على مساعد إضافي واجهة سطر الأوامر للمفوِّض القابلة للتنفيذ ومكتبة المفوَّض الثابتة.
إعداد مفوَّض OT
استنساخ مستودع مفوّض OT:
git clone https://github.com/openthread/ot-commissioner
ثبِّت التبعيّات:
cd ot-commissioner
./script/bootstrap.sh
مفوَّض الإصدار OT
عمليات التثبيت التي أجراها مفوَّض OT على دليل /usr/local
. إذا كنت ترغب في تغيير
دليل التثبيت، وهي مجموعة -DCMAKE_INSTALL_PREFIX
.
مفوَّض Build OT:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
أنشِئ متغيّر بيئة لتشغيل
commissioner-cli
في الخطوة التالية:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Optional. إجراء اختبارات الوحدة:
./tests/commissioner-test
تثبيت مفوَّض OT
يثبِّت مفوَّض OT ما يلي في دليل التثبيت:
- مكتبة مفوَّض OT وملفات العناوين
- البرنامج الثنائي القابل للتنفيذ لمفوض واجهة سطر الأوامر بمفوض OT
- بيانات الاعتماد وملفات الضبط التلقائية
- نصوص برمجية لتشغيل واجهة سطر الأوامر الخاصة بمفوض OT كبرنامج خفي
sudo ninja install
تحقَّق من التثبيت من خلال مراجعة قائمة المساعدة.
$COMMISSIONER_CLI -h
إذا تم التثبيت في دليل /usr/local
، سيكون commissioner-cli
متاحًا.
من سطر الأوامر.
commissioner-cli -h
الإعداد
يتوافق واجهة سطر الأوامر OT Commissioner مع وضع Thread 1.2 Commercial Commissioning Mode ("إدارة الشؤون التجارية والعقود") وتفويض Thread 1.1 (بخلاف "إدارة الشؤون التجارية والعقود"). للربط بشبكة Thread مختلفة هناك حاجة إلى ملف إعداد JSON لبدء واجهة سطر الأوامر الخاصة بمفوض OT:
ccm-config.json
— ملف الإعداد التلقائي لشبكة Thread من "إدارة الشؤون التجارية والعقود".non-ccm-config.json
— ملف الإعداد التلقائي لسلسلة المحادثات التي لا تتبع "إدارة الشؤون التجارية والعقود" الشبكة.
يتم تثبيت ملفات الإعداد هذه تلقائيًا في /usr/local/etc/commissioner
. يمكنك
يمكنك أيضًا الاطّلاع على نماذج الملفات في مستودع ot-commissioner GitHub.
إعدادات "إدارة الشؤون التجارية والعقود"
للربط بشبكة Threads في "إدارة الشؤون التجارية والعقود"، عدِّل هذه الحقول في ccm-config.json
:
الحقل | الوصف |
---|---|
DomainName |
معرّف فريد ضمن نطاق المؤسسة |
PrivateKeyFile |
تمثّل هذه السمة ملف المفتاح الخاص بتنسيق PEM. |
CertificateFile |
ملف الشهادة بتنسيق PEM. |
TrustAnchorFile |
ملف مراسي الثقة بتنسيق PEM |
تُستخدم ملفات المفتاح والشهادة هذه لإنشاء جلسات آمنة بين المفوَّض ووكيل الحدود
الإعدادات بخلاف "إدارة الشؤون التجارية والعقود"
يُستخدم المفتاح المشترك مسبقًا PSKc
لإنشاء جلسة آمنة بين
المفوَّضة ووكيل الحدود للاتصال بشبكة Thread لا تستخدم "إدارة الشؤون التجارية والعقود"، يجب:
يمكنك ضبط PSKc
من واجهة سطر الأوامر الخاصة بمفوض OT. لمزيد من المعلومات
راجِع مقالة التفويض الخارجي.
التسجيل
عند تشغيل pi@raspberrypi: commissioner-cli
من سطر الأوامر،
ينشئ مفوّض OT ملف commissioner.log
في العمل الحالي
الدليل، على سبيل المثال /home/pi/commissioner.log
. في إعدادات JSON
يمكنك ضبط مسار LogFile
، ومستوى التسجيل، وسجلّ
الإعدادات.
تحميل الإعدادات
لبدء مفوَّض OT باستخدام إعدادات الضبط:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
تكليف انضمام
لاستخدام المفوّض في الوقت الفعلي لتكليف انضمام، يُرجى الاطّلاع على القسم مصادر خارجية. التشغيل: