إنشاء مفوّض مفوضي سلاسل المحادثات وإعداده

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

يشمل هذا الدليل الإصدار الأساسي وعملية الإعداد في مفوضية سلاسل المحادثات (OT. المفوض) عند الانتهاء من هذا الإجراء، سيكون لديك سطر أوامر CLI للمفوّض. ومكتبة مفوض ثابتة.

إعداد مفوض OT

  1. إنشاء نسخة طبق الأصل من مستودع "مفوّض ويمكنك":

    git clone https://github.com/openthread/ot-commissioner
    

  2. ثبِّت العناصر الاعتمادية:

    cd ot-commissioner
    ./script/bootstrap.sh
    

مفوّض عملية الإنشاء

يتم تثبيت مفوض OT إلى الدليل /usr/local. إذا كنت تريد تغيير دليل التثبيت، يُرجى ضبط -DCMAKE_INSTALL_PREFIX.

  1. مفوّض الإصدار الإضافي:

    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
    ninja -j1
    

  2. أنشئ متغيّر بيئة لتشغيل commissioner-cli في الخطوة التالية:

    export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
    

  3. Optional. إجراء اختبارات الوحدة:

    ./tests/commissioner-test
    

تثبيت مفوّض الوقت الإضافي

يثبّت OT المفوّض ما يلي في دليل التثبيت:

  • مكتبة وملفات الرأسن في الوقت الفعلي
  • البرنامج الثنائي القابل للتنفيذ CLI من المفوض
  • ملفات الإعداد وبيانات الاعتماد التلقائية
  • نصوص برمجية لتشغيل واجهة سطر الأوامر (CLI) للمفوّضين كبرنامج خفي
sudo ninja install

تحقّق من التثبيت عن طريق التحقق من قائمة المساعدة.

$COMMISSIONER_CLI -h

في حال التثبيت على الدليل /usr/local، يصبح commissioner-cli متاحًا من سطر الأوامر.

commissioner-cli -h

الإعداد

تتوافق واجهة برمجة التطبيقات (TCL) للمفوّضين معًا مع كل من وضع العمولة التجارية للسلسلة 1.2 (CCM) وعمولة السلسلة 1.1 (غير CCM). للاتصال بشبكات سلاسل محادثات مختلفة، يجب استخدام ملف إعداد JSON لبدء تشغيل سطر الأوامر لمفوّض وقت التشغيل:

  • ccm-config.json - ملف الإعداد التلقائي لشبكة سلاسل المحادثات CCM.
  • non-ccm-config.json - ملف الإعداد التلقائي لشبكة سلاسل المحادثات غير التابعة لـ CCM.

يتم تثبيت ملفات الإعداد هذه تلقائيًا في /usr/local/etc/commissioner. يمكنك أيضًا الاطّلاع على نماذج للملفات في مستودع GitHub التابع للمفوّض.

إعداد CCM

للاتصال بشبكة سلسلة محادثات CCM، يمكنك تعديل هذه الحقول في ccm-config.json:

الحقل الوصف
DomainName معرّف فريد ضمن نطاق المؤسسة.
PrivateKeyFile ملف المفتاح الخاص بتنسيق PEM.
CertificateFile ملف الشهادة بتنسيق PEM.
TrustAnchorFile ملف رابط الثقة بتنسيق PEM.

يتم استخدام ملفَي المفتاح والشهادة لإنشاء جلسات آمنة بين المفوّض ووكيل الحدود.

إعداد لا يتضمن إدارة علاقات العملاء

يتم استخدام المفتاح المشترك مسبقًا PSKc لإنشاء جلسة آمنة بين المفوّض ووكيل الحدود. للاتصال بشبكة لا تتضمّن سلسلة محادثات CCM، يمكنك ضبط PSKc من واجهة سطر الأوامر (TCL) على OT. لمزيد من المعلومات، يُرجى الرجوع إلى العمولات الخارجية.

جارٍ التسجيل

عند تشغيل pi@raspberrypi: commissioner-cli من سطر الأوامر، ينشئ OT المفوض ملف commissioner.log في دليل العمل الحالي، على سبيل المثال، /home/pi/commissioner.log. في ملف إعداد JSON، يمكنك ضبط مسار LogFile ومستوى التسجيل وإعدادات السجلّ الأخرى.

تحميل الإعداد

لبدء "مفوّض ويمكنك" من خلال إعدادات الضبط:

commissioner-cli /usr/local/etc/commissioner/ccm-config.json

عمولة للانضمام

لاستخدام "مفوّض شركة OT" لتفويض مساهم، يُرجى الرجوع إلى العمولات الخارجية.