מבנה ותצורה של נציב OpenThread

הצגת המקור ב-GitHub

המדריך הזה עוסק בבנייה ובתצורה הבסיסיות של נציב OpenThread (נציב OT). לאחר השלמת ההליך הזה, תהיה לכם הפעלה להפעלת CLI של הנציב/ה וספריית נציב סטטית.

הגדרת נציב/ה להארכה

  1. שכפול המאגר של הנציב/ה:

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

  2. יחסי תלות של התקנות:

    cd ot-commissioner
    ./script/bootstrap.sh
    

בניית נציב OT

מנהל ההתקנה של ה-OTA מתקין בספרייה /usr/local. אם ברצונך לשנות את ספריית ההתקנה שלך, הגדר את -DCMAKE_INSTALL_PREFIX.

  1. בניית 'נציב/ה' למומחי 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
  • קובץ בינארי של קובץ Cli Commissioner OT
  • קובצי ברירת מחדל ופרטי כניסה
  • סקריפטים להפעלת CLT Commissioner OT כ-Daemon
sudo ninja install

בודקים את ההתקנה באמצעות בדיקת תפריט העזרה.

$COMMISSIONER_CLI -h

אם התקנת את הספרייה /usr/local, commissioner-cli זמין משורת הפקודה.

commissioner-cli -h

הגדרה

ה-CLI של ה-OT Commissioner CLI תומך במצב נציבות מסחרית מסוג שרשור 1.2 (CCM) וגם בשיטת עמלות שרשור 1.1 (מחוץ ל-CCM). כדי להתחבר לרשתות Thread אחרות, יש צורך בקובץ תצורת JSON כדי להפעיל את CLI של ה-OT Commissioner:

  • ccm-config.json — קובץ התצורה המוגדר כברירת מחדל עבור רשת שרשורים של CCM.
  • non-ccm-config.json — קובץ התצורה המוגדר כברירת מחדל עבור רשת Thread Non-CCM.

כברירת מחדל, קובצי התצורה האלה מותקנים ב-/usr/local/etc/commissioner. ניתן גם להציג קבצים לדוגמה במאגר GitHub של נציב המלאי.

הגדרת CCM

כדי להתחבר לרשת שרשורים ב-CCM, יש לעדכן את השדות הבאים בccm-config.json:

שדה תיאור
DomainName מזהה ייחודי בדומיין של הארגון.
PrivateKeyFile קובץ המפתח הפרטי בפורמט PEM.
CertificateFile קובץ האישור בפורמט PEM.
TrustAnchorFile קובץ העוגן מהימן בפורמט PEM.

קובצי המפתח והאישורים האלה משמשים ליצירת סשנים מאובטחים בין הנציב לבין סוכן הגבול.

תצורה שאינה של CCM

המפתח המשותף מראש PSKc משמש ליצירת סשן מאובטח בין הנציב לבין סוכן הגבול. כדי להתחבר לרשת מסוג Thread Non-CCM, אפשר להגדיר את ה-PSKc מתוך CLI Commissioner OT. מידע נוסף זמין בעמלות חיצוניות.

רישום

כשמפעילים את pi@raspberrypi: commissioner-cli משורת הפקודה, נציב ה-OT יוצר קובץ commissioner.log בספריית העבודה הנוכחית, לדוגמה /home/pi/commissioner.log. בקובץ התצורה של JSON, ניתן להגדיר את הנתיב LogFile, את רמת הרישום ביומן והגדרות יומן נוספות.

טעינת תצורה

כדי להפעיל את הנציב/ה ל-OT עם הגדרות התצורה:

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

הזמנת מתקין

כדי להשתמש בנציב OT כדי להזמין מצטרף, עיינו בעמלה חיצונית.