إنشاء مُفوّض OpenThread وإعداده

الاطّلاع على المصدر على GitHub

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

إعداد مفوَّض OT

  1. استنساخ مستودع مفوّض OT:

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

  2. ثبِّت التبعيّات:

    cd ot-commissioner
    ./script/bootstrap.sh
    

مفوَّض الإصدار OT

عمليات التثبيت التي أجراها مفوَّض OT على دليل /usr/local. إذا كنت ترغب في تغيير دليل التثبيت، وهي مجموعة -DCMAKE_INSTALL_PREFIX.

  1. مفوَّض Build OT:

    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

يثبِّت مفوَّض 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

تكليف انضمام

لاستخدام المفوّض في الوقت الفعلي لتكليف انضمام، يُرجى الاطّلاع على القسم مصادر خارجية. التشغيل: