מדריך זה עוסק ב-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 build
cd build
cmake -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 כדי להזמין מצטרפים, צריך לעיין בחיצוני עמלה.