מדריך זה עוסק ב-build ובתצורה הבסיסיים של OpenThread Commissioner (נציבות OTA). לאחר השלמת התהליך הזה, תקבלו OT קובץ הפעלה של CLI של Commissioner וספריית נציבים סטטית.
הגדרת OT Commissioner
משכפלים את מאגר ה-OT Commissioner:
git clone https://github.com/openthread/ot-commissionerיחסי תלות של התקנות:
cd ot-commissioner./script/bootstrap.sh
פיתוח נציב בארכיטקטורת OT
נציב OTA התקנות בספרייה /usr/local. אם ברצונך לשנות
ספריית ההתקנה, מגדירים את -DCMAKE_INSTALL_PREFIX.
נציב OTA:
mkdir buildcd buildcmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..ninja -j1צריך ליצור משתנה סביבה כדי להריץ את
commissioner-cliבשלב הבא:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cliאופציונלי. הרצת בדיקות יחידה:
./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 כדי להזמין מצטרפים, צריך לעיין בחיצוני עמלה.