פיתוח והגדרה של OpenThread Commissioner

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

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

הגדרת OT Commissioner

  1. משכפלים את מאגר ה-OT Commissioner:

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

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

    cd ot-commissioner
    ./script/bootstrap.sh
    

פיתוח נציב בארכיטקטורת OT

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

  1. נציב OTA:

    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. אופציונלי. הרצת בדיקות יחידה:

    ./tests/commissioner-test
    

התקנת OT Commissioner

נציב OT מתקין את הקבצים הבאים בספריית ההתקנה:

  • קובצי כותרות וספריות OTA
  • קובץ בינארי לקובץ ההפעלה של CLI של OTA
  • פרטי כניסה וקובצי תצורה שמוגדרים כברירת מחדל
  • סקריפטים להרצת OT Commissioner CLI כדי לבצע דימון (daemon)
sudo ninja install

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

$COMMISSIONER_CLI -h

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

commissioner-cli -h

תצורה

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

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

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

הגדרת CCM

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

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

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

הגדרות שלא קשורות ל-CCM

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

רישום ביומן

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

טעינת התצורה

כדי להפעיל OT Commissioner עם הגדרות התצורה שלכם:

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

הזמנת מצטרפים חדשים

כדי להשתמש ב-OT Commissioner כדי להזמין מצטרפים, צריך לעיין בחיצוני עמלה.