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