ב-OpenThread CLI נחשפים ממשקי API לניהול ולהגדרה מממשק של שורת פקודה. תוכלו להשתמש ב-OT CLI כדי ליצור סביבת פיתוח ב-OpenThread או להשתמש בה ככלי עם קוד אפליקציה נוסף. לדוגמה, סקריפטים לבדיקה של OpenThread משתמשים ב-CLI כדי להפעיל מקרי בדיקה.
כדי להתחיל:
משלימים את הסימולציה של Codelab ב-Docker ובודקים את ההפניה ל-CLI של הפקודות.
עוברים ל-Simulation Codelab עוברים ל-CLI Command Reference
שימוש ב-OTCLI
אתם יכולים להשתמש ב-OT CLI עם OpenThread Border Router (OTBR) ומכשירי Thread. פקודות ה-CLI ישתנו בהתאם לסוג המכשיר ולסימונים של גרסת ה-build.
OTBR
כדי להשתמש ב-OT CLI עם OTBR, צריך להזין את הקידומת הבאה לפני כל פקודה:
sudo ot-ctl
מכשירי חוטים
כדי להשתמש בפקודות CLI במכשיר Thread, כדאי לעיין במסמכי התיעוד של הפלטפורמה, בקוד ה-Codelab או במדריך. בדוגמאות רבות תוכלו להתחיל להקליד פקודות ללא קידומת:
state
router
Done
לפנייך כמה מקורות מידע שיעזרו לך להתחיל:
- מעיינים בפלטפורמות של OpenThread
- Codelab של חומרה נורדית
- Codelab Silicon Labs Hardware Code
- דוגמאות לפלטפורמות ב-GitHub
תווים מיוחדים
נעשה שימוש בתו הלבן (' '
) כדי להפריד בין שמות הפקודות והארגומנטים השונים, יחד עם הכרטיסייה ('\t'
) ותווים חדשים. ('\r'
, '\n'
).
ארגומנטים מסוימים יכולים לכלול רווחים, לדוגמה שם של רשת Thread. כדי לשלוח ארגומנטים שכוללים רווחים, צריך להשתמש בתו אלכסוני ('\'
) כדי לסמן מפרידים למפרידים או אחרי הקו הנטוי ההפוך:
networkname Test\ Network
Donenetworkname
Test Network Done
מיפויי ארגומנטים
ב-OT CLI משתמשים בארגומנטים שהוגדרו מראש שתואמים לערכים של הגדרת ה-API. אפשר להעביר את המיפויים האלה באמצעות פקודות CLI, ויכול להיות שהם יחזרו גם למסוף CLI כדי להשתמש בפקודות שונות של נתוני הרשת, למשל netdata show.
OTBorderRouterConfig
בחלק מהפקודות, לדוגמה prefix add
, נדרשים ערכי otBorderRouterConfig. כדי להגדיר otBorderRouterConfig
חברים בשורת הפקודה, OT CLI מנתח ארגומנט של אות ממופה לכל חבר. לדוגמה, השילוב של הארגומנט paros
מגדיר את החברים ב-mPreferred,
mSlaac,
mDefaultRoute,
mOnMesh ו-mStable, ברצף.
תחביר
בדוגמה הבאה, חובה להוסיף prefix
, והארגומנטים otBorderRouterConfig הם אופציונליים, וממופים כך: p
, a
, d
, c
, r
, o
, s
, n
וגם
D
:
prefix add prefix [padcrosnD]
Usage
כדי להשתמש במיפויי הארגומנטים, אין להזין רווחים בין האותיות:
prefix add 2001:dead:beef:cafe::/64 paros
העדפת OTRoutePreferences
כדי להגדיר את otRoutePreferences, השתמשו ב-high
, med
או low
בפקודות OT CLI.
תחביר
prefix add prefix [padcrosnD] [high|med|low]
Usage
לפניכם דוגמה לשימוש בפרמטרים ממופים otBorderRouterConfig
ו-otRoutePreference
:
prefix add 2001:dead:beef:cafe::/64 paros med
Done
OTExternalRouteConfig
בערכי otExternalRouteConfig, s
מפות ל-mStable
ו-n
מפות אל mNat64
.
תחביר
publish route prefix [sn]
Usage
route add 2001:dead:beef:cafe::/64 s
Done
ערכי החזרה
רוב הפקודות מחזירות את הערך המבוקש, ולאחר מכן Done
:
br onlinkprefix
fd41:2650:a6f5:0::/64
Done
פקודות אחרות שכוללות נתוני רשת עשויות להחזיר מיפויי ארגומנטים לרשומות של קידומת, נתיב ושירות. מידע נוסף זמין במאמר הצגה וניהול של נתוני רשת עם OT CLI.