סקירה כללית של Openthread CLI

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

ב-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

לפנייך כמה מקורות מידע שיעזרו לך להתחיל:

תווים מיוחדים

נעשה שימוש בתו הלבן (' ') כדי להפריד בין שמות הפקודות והארגומנטים השונים, יחד עם הכרטיסייה ('\t') ותווים חדשים. ('\r', '\n').

ארגומנטים מסוימים יכולים לכלול רווחים, לדוגמה שם של רשת Thread. כדי לשלוח ארגומנטים שכוללים רווחים, צריך להשתמש בתו אלכסוני ('\') כדי לסמן מפרידים למפרידים או אחרי הקו הנטוי ההפוך:

networkname Test\ Network
Done
networkname
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.