יצירה והגדרה של נציב

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

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

הגדרה של נציבות (OT)

1. משכפלים את מאגר הנציבות (OT):

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

2. מתקינים את שאר הספריות הדרושות לצורך יצירת ספריות הלקוח:

   cd ot-commissioner
   ./script/bootstrap.sh
   

בניית נציב (OT)

יועץ ה-OT מתקין את הספרייה /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 Commissioner מתקין את הספריות הבאות בספריית ההתקנה שלך:

• הספרייה וכותרות הנציבות של OT
• קובץ בינארי להפעלה של נציב ה-CLI
• קובצי תצורה ופרטי כניסה שמוגדרים כברירת מחדל
• סקריפטים להרצת OTC Commissioner כ-daemon

sudo ninja install

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

$COMMISSIONER_CLI -h

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

commissioner-cli -h

הגדרה

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

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

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

הגדרת CCM

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

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

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

הגדרות שאינן CCM

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

רישום ביומן

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

טעינת ההגדרה

כדי להפעיל את 'מרכז הלקוחות שלי' בהגדרות התצורה:

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

הזמנת משתתפים

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