מידע על פקודות CLI

ba eephemeralkey

מציין אם מפתח זמני פעיל כרגע או לא.

נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

ba ephemeralkey
active
Done

הפניות CLI ו-API

ba ehemeralkey callback (הפעלה, השבתה)

מגדירה את פונקציית הקריאה החוזרת שבה משתמש סוכן הגבול כדי להודיע על כל שינוי הקשור לשימוש במפתח זמני.

נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

קריאה נוספת לפונקציה הזו תחליף כל קריאה חוזרת (callback) שהוגדרה בעבר.

פרמטרים

אין פרמטרים.

דוגמאות

ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive

הפניות CLI ו-API

ba ehemeralkey מחיקה

ביטול המפתח הזמני שנמצא בשימוש.

נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

אפשר להשתמש בה כדי לבטל מפתח זמני שהוגדר בעבר לפני הזמן הקצוב לתפוגה. אם סוכן הגבול לא פועל או שלא נעשה שימוש במפתח זמני, לקריאה לפונקציה הזו אין השפעה.

אם הנציב מחובר באמצעות המפתח הזמני והוא פעיל כרגע, קריאה לפונקציה הזו לא תשנה את המצב שלה. במקרה כזה, otBorderAgentIsEphemeralKeyActive() ימשיך להחזיר TRUE עד שהנציב יתנתק.

פרמטרים

אין פרמטרים.

דוגמאות

ba ephemeralkey clear
Done

הפניות CLI ו-API

ba ephemeralkey set [timeout-in-msec] [port]

הגדרת המפתח הזמני למשך זמן קצוב לתפוגה.

נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

ניתן להגדיר את המפתח הזמני כשה-Border Agent כבר פועל ולא מחובר כרגע לאף נציב חיצוני (כלומר, הוא נמצא במצב OT_BORDER_AGENT_STATE_STARTED). אחרת, הערך OT_ERROR_INVALID_STATE מוחזר.

aKeyString הנתון משמש ישירות בתור ה-PSK הזמני (לא כולל התו ה-null \0 בסוף). האורך של aKeyString חייב להיות בין OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH ל-OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH, כולל.

הגדרה חוזרת של המפתח הזמני לפני שתם הזמן הקצוב לתפוגה של מפתח שהוגדר קודם לכן תחליף את המפתח שהוגדר בעבר ותאפס את הזמן הקצוב לתפוגה.

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

פרמטרים

אין פרמטרים.

דוגמאות

ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done

הפניות CLI ו-API

ba id (get,set)

הפונקציה מקבלת או מגדירה מזהה של נתב גבול בן 16 בייטים שיכול לזהות את המכשיר באופן ייחודי מבין כמה BRs.

פרמטרים

ba id [border-agent-id]

השתמש בארגומנט האופציונלי border-agent-id כדי להגדיר את מזהה סוכן הגבול.

דוגמאות

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done

הפניות CLI ו-API

Ba Port

מקבל את יציאת ה-UDP של שירות Thread Border Agent.

פרמטרים

אין פרמטרים.

דוגמאות

ba port
49153
Done

הפניות CLI ו-API

Ba State

מקבל את otBorderAgentState של התפקיד Thread Border Agent.

פרמטרים

אין פרמטרים.

דוגמאות

ba state
Started
Done

הפניות CLI ו-API

bbr

מחזירה את הפרטים הנוכחיים של נתב השדרה הראשי של מכשיר ה-Thread.

פרמטרים

אין פרמטרים.

דוגמאות

bbr
BBR Primary:
server16: 0xE400
seqno:    10
delay:    120 secs
timeout:  300 secs
Done
bbr
BBR Primary: None
Done

הפניות CLI ו-API

  • אין API משויך

הגדרת bbr (קבוצה)

מגדיר את התצורה המקומית של נתב השדרה otBackboneRouterConfig.

הודעה של בקשת נתוני שרת SRV_DATA.ntf מופעלת באופן אוטומטי אם מערך הנתונים של BBR משתנה עבור נתב השדרה הראשי.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

צריך להנפיק הנפקה מפורשת של bbr register כדי לרשום שירות Backbone Router ל-Leader עבור נתב שדרה משני.

פרמטרים

bbr config [seqno seqno] [delay delay] [timeout timeout]

דוגמאות

bbr config seqno 20 delay 30
Done

הפניות CLI ו-API

הגדרת bbr

קבלת ההגדרה המקומית של נתב השדרה (Backbone Router).

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

bbr config
seqno:    10
delay:    120 secs
timeout:  300 secs
Done

הפניות CLI ו-API

השבתה bbr

מפעילה או משביתה את הפונקציונליות של Backbone.

אם המדיניות הזו מופעלת, אם אין שירות נתב שדרה לנתוני הרשת של Thread Network, תופעל הודעה SRV_DATA.ntf של הבקשה לנתוני השרת במכשיר המחובר.

אם המדיניות מושבתת, SRV_DATA.ntf מופעל אם נתב השדרה נמצא במצב הראשי.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

bbr disable
Done

הפניות CLI ו-API

הפעלה bbr

מפעילה או משביתה את הפונקציונליות של Backbone.

אם המדיניות הזו מופעלת, אם אין שירות נתב שדרה לנתוני הרשת של Thread Network, תופעל הודעה SRV_DATA.ntf של הבקשה לנתוני השרת במכשיר המחובר.

אם המדיניות מושבתת, SRV_DATA.ntf מופעל אם נתב השדרה נמצא במצב הראשי.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

bbr enable
Done

הפניות CLI ו-API

bbr רעידות (get,set)

מקבל או מגדיר רעידות (בשניות) לצורך רישום של נתב שדרה.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

פרמטרים

bbr jitter [jitter]

דוגמאות

bbr jitter
20
Done
bbr jitter 10
Done

הפניות CLI ו-API

bbr mgmt dua

כאשר meshLocalIid כלול, הפקודה הזו קובעת את סטטוס התגובה לרישום DUA הבא. בלי meshLocalIid, צריך להשיב ל-DUA.req הבא עם status או coap-code שצוינו.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.

פרמטרים

bbr mgmt dua status|coap-code [meshLocalIid]

עבור status או coap-code, יש להשתמש ב:

  • 0: ST_DUA_הצלחה
  • 1: ST_DUA_REREGISTER
  • 2: ST_DUA_INVALID
  • 3: ST_DUA_DUPLICATE
  • 4: ST_DUA_NO_resourcesS
  • 5: ST_DUA_BBR_NOT_PRIMARY
  • 6: ST_DUA_GENERAL_FAILURE
  • 160: קוד COAP 5.00

דוגמאות

bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done

הפניות CLI ו-API

הוספת bbr mgmt mlr listener

הוספת האזנה ל-Multicast עם ערך של זמן קצוב לתפוגה, בשניות.

מעבירים את 0 כדי להשתמש הזמן הקצוב לתפוגה שמוגדר כברירת מחדל ל-MLR.

האפשרות זמינה כאשר OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE ו-OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלים.

פרמטרים

bbr mgmt mlr listener add ipaddress [timeout-seconds]

דוגמאות

bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done

הפניות CLI ו-API

bbr mgmt mlr listener

הפונקציה מחזירה את פונקציות ההאזנה Multicast עם otBackboneRouterMulticastListenerInfomTimeout בשניות.

האפשרות הזו זמינה כאשר OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE ו-OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE מופעלים.

פרמטרים

אין פרמטרים.

דוגמאות

bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done

הפניות CLI ו-API

bbr mgmt mlr listener מחיקה

ניקוי של פונקציות ה-Multicast Listener.

האפשרות זמינה כאשר OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE ו-OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלים.

פרמטרים

אין פרמטרים.

דוגמאות

bbr mgmt mlr listener clear
Done

הפניות CLI ו-API

תגובה bbr mgmt mlr

הגדרת סטטוס התגובה לרישום הבא של האזנה ל-Multicast.

האפשרות זמינה כאשר OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE ו-OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלים.

פרמטרים

bbr mgmt mlr response status-code

עבור status-code, יש להשתמש בפורמט:

  • 0: ST_MLR_הצלחה
  • 2: ST_MLR_INVALID
  • 3: ST_MLR_NO_PERSISTENT
  • 4: ST_MLR_NO_resourcesS
  • 5: ST_MLR_BBR_NOT_PRIMARY
  • 6: ST_MLR_GENERAL_FAILURE

דוגמאות

bbr mgmt mlr response 2
Done

הפניות CLI ו-API

רישום bbr

רושם במפורש את התצורה המקומית של נתב השדרה (Backbone Router).

במכשיר המחובר מופעלת הודעה של SRV_DATA.ntf לגבי הבקשה לנתוני השרת.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

bbr register
Done

הפניות CLI ו-API

מצב bbr

מקבל את Backbone Router otBackboneRouterState.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done

הפניות CLI ו-API

br השבתה

השבתת מנהל ניתוב הגבולות.

פרמטרים

אין פרמטרים.

דוגמאות

br disable
Done

הפניות CLI ו-API

הפעלת br

הפעלת מנהל ניתוב הגבולות.

פרמטרים

אין פרמטרים.

דוגמאות

br enable
Done

הפניות CLI ו-API

ברייט

הפעלת מנהל ניתוב הגבולות.

פרמטרים

br init infrastructure-network-index is-running

דוגמאות

br init 2 1
Done

הפניות CLI ו-API

br nat64prefix

פלט גם קידומות NAT64 מקומיות וגם מועדפים.

פרמטרים

אין פרמטרים.

דוגמאות

br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done

הפניות CLI ו-API

br nat64prefix מועדף

הפונקציה מקבלת את קידומת NAT64 המועדפת כרגע.

ניתן לגלות את קידומת NAT64 המועדפת דרך קישור לתשתית, או להיות קידומת NAT64 המקומית של המכשיר.

פרמטרים

אין פרמטרים.

דוגמאות

br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done

הפניות CLI ו-API

br nat64קידומת מקומית

מקבלת את הקידומת המקומית NAT64 של נתב הגבול.

יכול להיות שקידומת NAT64 לא מפורסמת ברשת Thread.

חובה להפעיל את OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done

הפניות CLI ו-API

br omrprefix

פלט גם קידומת OMR מקומית וגם מועדפת.

פרמטרים

אין פרמטרים.

דוגמאות

br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done

הפניות CLI ו-API

יש העדפה ל- omrprefix

מקבלת את הקידומת המועדפת כעת מחוץ ל-Mesh-Routable (OMR).

ניתן לגלות את קידומת ה-OMR המועדפת מנתוני הרשת, או להיות קידומת ה-OMR המקומית של המכשיר.

פרמטרים

אין פרמטרים.

דוגמאות

br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done

הפניות CLI ו-API

br omrprefix מקומי

הפונקציה מקבלת את הקידומת המקומית Off-Mesh-Routable (OMR). לדוגמה: fdfc:1ff5:1512:5622::/64.

קידומת OMR היא קידומת 64 ביט שנוצרת באופן אקראי ומתפרסמת ברשת Thread אם אין עדיין קידומת OMR. ניתן להגיע לקידומת הזו מרשת ה-Wi-Fi או האתרנט המקומית.

פרמטרים

אין פרמטרים.

דוגמאות

br omrprefix local
fdfc:1ff5:1512:5622::/64
Done

הפניות CLI ו-API

br onlinkprefix

פלטים גם בקידומות מקומיות וגם בקידומות מועדפים בקישור.

פרמטרים

אין פרמטרים.

דוגמאות

br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done

הפניות CLI ו-API

br onlinkprefix מועדף

קבלת קידומת On-Link המועדפת כרגע.

הקידומת המועדפת היא קידומת שהתגלתה בקישור בקישור לתשתית או הקידומת המקומית בקישור.

פרמטרים

אין פרמטרים.

דוגמאות

br onlinkprefix favored
2600::0:1234:da12::/64
Done

הפניות CLI ו-API

br onlinkprefix מקומי

הפונקציה מקבלת את הקידומת המקומית On-Link של קישור התשתית הצמוד.

הקידומת המקומית On-Link היא קידומת של 64 ביט שמפורסמת בקישור התשתית, אם עדיין לא פורסמה קידומת לשימוש בקישור שניתנת לשימוש.

פרמטרים

אין פרמטרים.

דוגמאות

br onlinkprefix local
fd41:2650:a6f5:0::/64
Done

הפניות CLI ו-API

קידומת br

קבלת הקידומות שהתגלו על ידי Border Routing Manager בקישור לתשתית. מידע לכל רשומת קידומת:

  • הקידומת
  • האם הקידומת היא בקישור או בנתיב
  • באלפיות השנייה מאז קבלת הפרסומת האחרונה של הנתב שמכילה את הקידומת הזו
  • משך החיים של קידומת בשניות
  • משך החיים המועדף בשניות רק אם התחילית היא בקישור
  • העדפת מסלול (נמוכה, בינונית, גבוהה) רק אם התחילית היא נתיב (לא דרך הקישור)
  • כתובת ה-IPv6 של הנתב שמפרסמת את הקידומת הזו
  • סימונים בכותרת פרסומת הנתב שהתקבלה:
    • M: סימון תצורה של כתובת מנוהלת
    • O: סימון תצורה אחרת
    • לשונית: סימון נתב נתב (מציין אם הנתב הוא נתב stub)

פרמטרים

אין פרמטרים.

דוגמאות

br prefixtable
prefix:fd00:1234:5678:0::/64, on-link:no, ms-since-rx:29526, lifetime:1800, route-prf:med,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
prefix:1200:abba:baba:0::/64, on-link:yes, ms-since-rx:29527, lifetime:1800, preferred:1800,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done

הפניות CLI ו-API

br raoptions (set,clear)

מגדירה אפשרויות נוספות לצירוף בסופם של הודעות פרסומת של הנתב (RA).

התוכן של aOptions מועתק באופן פנימי, כך שהוא יכול להיות מאגר זמני (למשל, מערך שמוקצה לערימה).

הקריאות הבאות לפונקציה הזו מחליפות את הערך שהוגדר קודם לכן.

פרמטרים

br raoptions options|clear

br raoptions clear מעביר nullptr אל otBorderRoutingSetExtraRouterAdvertOptions. אחרת, אפשר להעביר את הבייט options כנתונים הקסדצימליים.

דוגמאות

br raoptions 0400ff00020001
Done
br raoptions clear
Done

הפניות CLI ו-API

br rioprf (גבוה,בינוני,נמוך)

ההגדרה מגדירה במפורש את ההעדפה לשימוש בעת פרסום אפשרויות מידע על נתיב (RIO) בהודעות פרסומת של הנתב שנשלחות דרך הקישור לתשתית.

לאחר קריאה לפונקציה הזו, BR ישתמש בהעדפה הנתונה עבור כל מודעות ה-RIO שלה שפורסמו. אפשר להסיר את ההעדפה על ידי התקשרות אל otBorderRoutingClearRouteInfoOptionPreference() .

פרמטרים

br rioprf [high|med|low]

דוגמאות

br rioprf low
Done

הפניות CLI ו-API

בר ריופרף

מקבלת את ההעדפה הנוכחית שנעשה בה שימוש כשמפרסמים אפשרויות מידע על מסלול (RIO) בהודעות פרסומת של הנתב שנשלחות דרך קישור לתשתית.

ההעדפה ל-RIO נקבעת כך:

  • אם הוגדרה במפורש על ידי המשתמש על ידי קריאה לפונקציה otBorderRoutingSetRouteInfoOptionPreference(), המערכת תשתמש בהעדפה הנתונה.
  • אחרת, היא נקבעת על סמך התפקיד הנוכחי של המכשיר: העדפה בינונית בתפקיד בנתב/מנהיג והעדפה נמוכה בתפקיד צאצא.

פרמטרים

אין פרמטרים.

דוגמאות

br rioprf
med
Done

הפניות CLI ו-API

בר ריופרף קליר

ניקוי ערך העדפה שהוגדר בעבר עבור אפשרויות פרטי מסלול שפורסמו.

לאחר קריאה לפונקציה הזו, BR ישתמש בתפקיד המכשיר כדי לקבוע העדפה ל-RIO: העדפה בינונית בתפקיד בנתב/מנהיג והעדפה נמוכה בתפקיד צאצא.

פרמטרים

אין פרמטרים.

דוגמאות

br rioprf clear
Done

הפניות CLI ו-API

br pathprf (high,med,low)

מגדירה באופן מפורש את ההעדפה של הנתיבים שפורסמו בנתוני הרשת.

לאחר קריאה לפונקציה הזו, BR ישתמש בהעדפה הנתונה. אפשר להסיר את ההעדפה על ידי התקשרות אל otBorderRoutingClearRoutePreference() .

פרמטרים

br routeprf [high|med|low]

דוגמאות

br routeprf low
Done

הפניות CLI ו-API

br pathprf

הפונקציה מקבלת את ההעדפה הנוכחית המשמשת למסלולים שפורסמו בנתוני הרשת.

ההעדפה נקבעת באופן הבא:

  • אם הוגדרה במפורש על ידי המשתמש על ידי קריאה לפונקציה otBorderRoutingSetRoutePreference(), המערכת תשתמש בהעדפה הנתונה.
  • אחרת, הוא נקבע באופן אוטומטי על ידי RoutingManager על סמך התפקיד ואיכות הקישור של המכשיר.

פרמטרים

אין פרמטרים.

דוגמאות

br routeprf
med
Done

הפניות CLI ו-API

br Trackprf ברור

ניקוי ערך העדפה שהוגדר בעבר למסלולים שפורסמו בנתוני הרשת.

לאחר קריאה לפונקציה הזו, BR תקבע את ההעדפה באופן אוטומטי על סמך תפקיד המכשיר ואיכות הקישור (להורה בעת פעולה כמכשיר קצה).

פרמטרים

אין פרמטרים.

דוגמאות

br routeprf clear
Done

הפניות CLI ו-API

נתבים br

בקישור לתשתית אפשר לקבל את רשימת הנתבים שנמצאו על ידי Border Routing Manager. מידע לכל נתב:

  • כתובת ה-IPv6 של הנתב
  • סימונים בכותרת פרסומת הנתב שהתקבלה:
    • M: סימון תצורה של כתובת מנוהלת
    • O: סימון תצורה אחרת
    • לשונית: סימון נתב נתב (מציין אם הנתב הוא נתב stub)

פרמטרים

אין פרמטרים.

דוגמאות

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done

הפניות CLI ו-API

מצב br

קבלת המצב הנוכחי של מנהל ניתוב הגבולות.

פרמטרים

אין פרמטרים.

דוגמאות

br state
running

הפניות CLI ו-API

מאגר נתונים זמני

קבלת הפרטים של מאגר ההודעות הנוכחי.

  • בעמודה total מוצג המספר הכולל של מאגרי הודעות במאגר הנתונים הזמני.
  • free מציג את מספר מאגרי ההודעות בחינם.
  • ב-max-used מוצג המספר המקסימלי של מאגרים בשימוש בו-זמנית מאז אתחול מקבץ OT או bufferinfo reset האחרון.

בשלב הבא, ה-CLI מציג מידע על תורים שונים שבהם נעשה שימוש בסטאק OpenThread, לדוגמה 6lo send. כל שורה אחרי התור מייצגת מידע על תור:

  • המספר הראשון מציג את מספר ההודעות בתור.
  • המספר השני מציג את מספר מאגרי הנתונים הזמניים שנוצלו על ידי כל ההודעות בתור.
  • המספר השלישי מייצג את המספר הכולל של הבייטים של כל ההודעות בתור.

פרמטרים

אין פרמטרים.

דוגמאות

bufferinfo
total: 40
free: 40
max-used: 5
6lo send: 0 0 0
6lo reas: 0 0 0
ip6: 0 0 0
mpl: 0 0 0
mle: 0 0 0
coap: 0 0 0
coap secure: 0 0 0
application coap: 0 0 0
Done

הפניות CLI ו-API

איפוס של מאגר נתונים זמני

איפוס מונה המידע של מאגר ההודעות כדי לעקוב אחר מספר מאגרי המידע המקסימלי שנמצאים בשימוש בו-זמנית.

הפעולה הזו תאפס את mMaxUsedBuffers ב otBufferInfo .

פרמטרים

אין פרמטרים.

דוגמאות

bufferinfo reset
Done

הפניות CLI ו-API

ccathreshold (get,set)

הפונקציה מקבלת או מגדירה את סף ה-CCA ב-dBm שנמדד במחבר האנטנה לפי סעיף 10.1.4 של IEEE 802.15.4 - 2015.

פרמטרים

ccathreshold [CCA-threshold-dBm]

כדי להגדיר את הסף ל-CCA, משתמשים בארגומנט האופציונלי CCA-threshold-dBm.

דוגמאות

ccathreshold
-75 dBm
Done
ccathreshold -62
Done

הפניות CLI ו-API

ערוץ (קבל,הגדר)

מקבלת או מגדירה את ערך הערוץ IEEE 802.15.4.

פרמטרים

channel [channel-num]

אפשר להשתמש בchannel-num כדי להגדיר את הערוץ.

דוגמאות

channel
11
Done
channel 11
Done

הפניות CLI ו-API

  • אין API משויך

מנהל ערוץ – אוטומטי

הפעלה או השבתה של פונקציונליות הבחירה האוטומטית בערוץ עבור ערוץ רשת.

כשהאפשרות הזו מופעלת, ChannelManager יפעיל RequestChannelSelect(false) מדי פעם. אפשר להגדיר את מרווח הזמן עד otChannelManagerSetAutoChannelSelectionInterval() .

חובה לציין OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE, OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

פרמטרים

channel manager auto enable

1 הוא בוליאני ל-enable.

דוגמאות

channel manager auto 1
channel manager auto 1
Done

הפניות CLI ו-API

שינוי במנהל הערוץ

נשלחת בקשה להחלפת ערוץ של פרוטוקול Thread.

הרשת עוברת לערוץ הנתון אחרי עיכוב שצוין (ראו otChannelManagerSetDelay()). שינוי הערוץ מתבצע על ידי עדכון מערך הנתונים Pending Operationsal Data.

שיחה נוספת תבטל את הבקשה לשינוי ערוץ שכבר ביקשתם בעבר.

השדה OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE הוא שדה חובה.

פרמטרים

channel manager change channel-num

דוגמאות

channel manager change 11
channel manager change 11
Done

הפניות CLI ו-API

מנהל הערוץ

בודקים את הסטטוס של מנהל הערוץ. חובה למלא את השדה OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE או את הערך OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done

הפניות CLI ו-API

עיכוב במנהל הערוץ

מגדיר את ההשהיה (בשניות) שמשמשת לשינוי ערוץ רשת.

זמין ב-FTD בלבד. עדיף שהעיכוב יהיה ארוך יותר מהמרווח המקסימלי של סקר הנתונים, שבו משתמשים כל המכשירים של Sleepy End ברשת של Thread.

השדות OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE ו-OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE נדרשים.

פרמטרים

channel manager delay delay-seconds

דוגמאות

channel manager delay 120
channel manager delay 120
Done

הפניות CLI ו-API

מועדף למנהל ערוץ

הגדרה של מסכת הערוץ המועדפת.

חובה לציין OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE, OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

פרמטרים

channel manager favored mask

דוגמאות

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

הפניות CLI ו-API

מרווח בין מנהל הערוץ

המדיניות הזו מגדירה את מרווח הזמן (בשניות) שמשמש את הפונקציונליות של בחירה אוטומטית בערוץ.

חובה לציין OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE, OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

פרמטרים

channel manager interval interval-seconds

דוגמאות

channel manager interval 10800
channel manager interval 10800
Done

הפניות CLI ו-API

בחירת מנהל ערוץ

בקשות ש-ChannelManager יבדוק ויבחר ערוץ חדש, ותתחיל שינוי של הערוץ.

בניגוד ל- otChannelManagerRequestChannelChange() שבו צריך לציין את הערוץ כפרמטר, הפונקציה הזו מבקשת מ-ChannelManager לבחור ערוץ לבד (על סמך מידע שנאסף לגבי איכות הערוץ).

לאחר קבלת השיחה, מנהל הערוצים יבצע את 3 השלבים הבאים:

1) ChannelManager מחליט אם השינוי בערוץ יועיל לך. אפשר לדלג על הבדיקה הזו אם המדיניות aSkipQualityCheck מוגדרת כ-True (הדבר יאלץ את בחירת ערוץ והמערכת תדלג על בדיקת האיכות). בשלב הזה נעשה שימוש במדדי איכות הקישורים שנאספו במכשיר (למשל שיעור כשלים של CCA, שיעורי שגיאות של פריימים ושל הודעות לשכן וכו') כדי לקבוע אם איכות הערוץ הנוכחית היא ברמה שמצדיקה שינוי בערוץ.

2) אם השלב הראשון עובר, ChannelManager בוחר ערוץ שעשוי להיות טוב יותר. המערכת משתמשת בנתונים שנאספו לגבי איכות הערוץ באמצעות המודול ChannelMonitor. בשלב הזה נעשה שימוש בערוצים הנתמכים ובערוצים המועדפים. (פרטים נוספים זמינים ב- otChannelManagerSetSupportedChannels() וב- otChannelManagerSetFavoredChannels() ).

3) אם הערוץ החדש שנבחר שונה מהערוץ הנוכחי, ChannelManager יבקש/יתחיל את תהליך שינוי הערוץ (באופן פנימי, להפעלה של RequestChannelChange()).

חובה לציין OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE, OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

פרמטרים

channel manager select skip-quality-check

יש להשתמש ב-1 או ב-0 עבור הערך הבוליאני skip-quality-check.

דוגמאות

channel manager select 1
channel manager select 1
Done

הפניות CLI ו-API

יש תמיכה במנהל הערוץ

הגדרה של מסכת הערוץ הנתמכת.

חובה לציין OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE, OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

פרמטרים

channel manager supported mask

דוגמאות

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

הפניות CLI ו-API

סף למנהל ערוץ

המדיניות מגדירה את הסף לשיעור הכישלונות של CCA.

חובה לציין OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE, OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

פרמטרים

channel manager threshold threshold-percent

צריך להשתמש בערך הקסדצימלי עבור threshold-percent. 0 ממופה ל-0% ו-0xffff ממופה ל-100%.

דוגמאות

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

הפניות CLI ו-API

כלי למעקב אחרי ערוצים

הצגת סטטוס המעקב הנוכחי של הערוץ ונוכחות הערוץ. השדה OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE הוא שדה חובה.

פרמטרים

אין פרמטרים.

דוגמאות

channel monitor
enabled: 1
interval: 41000
threshold: -75
window: 960
count: 10552
occupancies:
ch 11 (0x0cb7)  4.96% busy
ch 12 (0x2e2b) 18.03% busy
ch 13 (0x2f54) 18.48% busy
ch 14 (0x0fef)  6.22% busy
ch 15 (0x1536)  8.28% busy
ch 16 (0x1746)  9.09% busy
ch 17 (0x0b8b)  4.50% busy
ch 18 (0x60a7) 37.75% busy
ch 19 (0x0810)  3.14% busy
ch 20 (0x0c2a)  4.75% busy
ch 21 (0x08dc)  3.46% busy
ch 22 (0x101d)  6.29% busy
ch 23 (0x0092)  0.22% busy
ch 24 (0x0028)  0.06% busy
ch 25 (0x0063)  0.15% busy
ch 26 (0x058c)  2.16% busy
Done

הפניות CLI ו-API

  • אין API משויך

התחלת מעקב אחר הערוץ

מפעילים את מעקב הערוץ. OT CLI שולח ערך בוליאני של true ל-otChannelMonitorSetEnabled. השדה OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE הוא שדה חובה.

פרמטרים

אין פרמטרים.

דוגמאות

channel monitor start
channel monitor start
Done

הפניות CLI ו-API

עצירת ביניים למעקב אחר הערוץ

עצירת המעקב אחר הערוץ. OT CLI שולח ערך בוליאני של false ל-otChannelMonitorSetEnabled. השדה OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE הוא שדה חובה.

פרמטרים

אין פרמטרים.

דוגמאות

channel monitor stop
channel monitor stop
Done

הפניות CLI ו-API

מועדף לערוץ

הפונקציה מקבלת את מסכת הערוץ המועדפת לרדיו שהמכשיר מעדיף ליצור באמצעותה.

פרמטרים

אין פרמטרים.

דוגמאות

channel preferred
0x7fff800
Done

הפניות CLI ו-API

עם תמיכה בערוץ

צריך להשיג את מסכת הערוץ הנתמכת ברדיו שהמכשיר מורשה להשתמש בה.

פרמטרים

אין פרמטרים.

דוגמאות

channel supported
0x7fff800
Done

הפניות CLI ו-API

צאצא (מזהה)

קבלת נתוני אבחון של ילדים שצורפו לפי מזהה הילד שלהם או RLOC16.

פרמטרים

child child-id

דוגמאות

child 1
Child ID: 1
Rloc: 9c01
Ext Addr: e2b3540590b0fd87
Mode: rn
CSL Synchronized: 1
Net Data: 184
Timeout: 100
Age: 0
Link Quality In: 3
RSSI: -20
Done

הפניות CLI ו-API

רשימת צאצא

הפונקציה מחזירה רשימה של מזהי צאצאים מצורפים.

פרמטרים

אין פרמטרים.

דוגמאות

child list
1 2 3 6 7 8
Done

הפניות CLI ו-API

טבלת צאצא

מדפיס טבלה של הצאצאים המצורפים.

פרמטרים

אין פרמטרים.

דוגמאות

child table
| ID  | RLOC16 | Timeout    | Age        | LQ In | C_VN |R|D|N|Ver|CSL|QMsgCnt| Extended MAC     |
+-----+--------+------------+------------+-------+------+-+-+-+---+---+-------+------------------+
|   1 | 0xc801 |        240 |         24 |     3 |  131 |1|0|0|  3| 0 |     0 | 4ecede68435358ac |
|   2 | 0xc802 |        240 |          2 |     3 |  131 |0|0|0|  3| 1 |     0 | a672a601d2ce37d8 |
Done

הפניות CLI ו-API

צאצא

מקבלת רשימה של כתובות IP שמאוחסנות עבור ילדי MTD.

פרמטרים

אין פרמטרים.

דוגמאות

childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done

הפניות CLI ו-API

צאצא IP (הגדרה)

מגדירה או משחזרת את המספר המקסימלי של כתובות IP שכל צאצא של MTD יכול לרשום במכשיר הזה כהורה.

כדי לנקות את ההגדרה ולשחזר את ברירת המחדל, צריך לעבור את 0.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.

פרמטרים

childip max count

דוגמאות

childip max 2
Done

הפניות CLI ו-API

צאצא IP Max

הפונקציה מקבלת את המספר המקסימלי של כתובות IP שכל צאצא של MTD יכול לרשום במכשיר הזה כהורה.

פרמטרים

אין פרמטרים.

דוגמאות

childip max
4
Done

הפניות CLI ו-API

צאצא (הגדרה)

מגדירה את מספר הילדים המקסימלי המותר כרגע.

אפשר להגדיר את הפרמטר הזה רק כשהפעולה של פרוטוקול Thread הופסקה.

פרמטרים

childmax count

דוגמאות

childmax 2
Done

הפניות CLI ו-API

צאצא

הפונקציה מקבלת את מספר הילדים המקסימלי המותר כרגע.

פרמטרים

אין פרמטרים.

דוגמאות

childmax
5
Done

הפניות CLI ו-API

הפונקציה מקבלת או מגדירה את הערך MLE_CHILD_ROUTER_LINKS.

פרמטרים

childrouterlinks [links]

דוגמאות

childrouterlinks
16
Done
childrouterlinks 16
Done

הפניות CLI ו-API

הגדרת זמן קצוב לפיקוח על ילדים (מוגדר)

הגדרה של מרווח הזמן הקצוב לתפוגה של בדיקת פיקוח (בשניות) עבור הילד או הילדה.

פרמטרים

childsupervision checktimeout timeout-seconds

דוגמאות

childsupervision checktimeout 30
Done

הפניות CLI ו-API

הגדרת זמן קצוב לפיקוח על ילדים

קבלת הזמן הקצוב לתפוגה של בדיקת הפיקוח (בשניות) עבור הילד או הילדה.

אם המכשיר הוא ילד שישנוני והוא לא שומע מההורה שלו תוך פרק הזמן הקצוב לבדיקה שהוגדר, הוא מתחיל תהליך של צירוף מחדש (החלפה של בקשה/תגובה של MLE / של תגובה להורה).

פרמטרים

אין פרמטרים.

דוגמאות

childsupervision checktimeout
30
Done

הפניות CLI ו-API

מרווח זמן לפיקוח על ילדים (הגדרה)

ההגדרה הזו מגדירה את מרווח הזמן של הילד או הילדה לפיקוח (בשניות).

פרמטרים

childsupervision interval interval-seconds

דוגמאות

childsupervision interval 30
Done

הפניות CLI ו-API

פרק זמן של פיקוח על ילדים

הפונקציה מקבלת את פרק הזמן של פיקוח על ילדים (בשניות) עבור הילד או הילדה.

התכונה 'פיקוח על ילדים' מספקת מנגנון להורים כדי להבטיח שתישלח הודעה לכל ילד ישנוני במהלך פרק הזמן של הפיקוח. אם אין שידור לילד או לילדה במהלך מרווח הזמן של הפיקוח, OpenThread יציג הודעה לילד או לילדה על פיקוח ב-OpenThread.

פרמטרים

אין פרמטרים.

דוגמאות

childsupervision interval
30
Done

הפניות CLI ו-API

זמן קצוב לתפוגה של ילדים (מוגדר)

המדיניות מגדירה את הזמן הקצוב לתפוגה של צאצאים ב-Thread (בשניות) לשימוש בתפקיד 'צאצא'.

פרמטרים

childtimeout timeout-seconds

דוגמאות

childtimeout 300
Done

הפניות CLI ו-API

זמן קצוב לתפוגה של ילדים

מקבל את הזמן הקצוב לתפוגה של צאצאים ב-Thread (בשניות) שבו נעשה שימוש כשמפעילים את התפקיד 'צאצא'.

פרמטרים

אין פרמטרים.

דוגמאות

childtimeout
300
Done

הפניות CLI ו-API

ביטול COap

ביטול מינוי קיים לתצפית למשאב מרוחק בשרת CoAP.

פרמטרים

אין פרמטרים.

דוגמאות

coap cancel
Done

הפניות CLI ו-API

coap Delete (מחיקה של Coap)

מחיקת משאב CoAP שצוין.

פרמטרים

coap delete address uri-path [type] [payload]
  • address: כתובת IPv6 של שרת CoAP.
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
  • payload: מחרוזת המטען הייעודי (payload) של CoAP. לדוגמה: hellothere.

דוגמאות

coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done

הפניות CLI ו-API

  • אין API משויך

Coap get

קבלת מידע על משאב CoAP שצוין בשרת CoAP.

פרמטרים

coap get address uri-path [type]
  • address: כתובת IPv6 של שרת CoAP.
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
    • block-: אם צריך להעביר את התגובה ברמת הבלוק, אפשר להשתמש באפשרות הזו, ואז להוסיף את הערך ברמת הבלוק. הערכים החוקיים הם: block-16, block-32, block-64, block-128, block-256, block-512 או block-1024.

דוגמאות

coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024
Done

הפניות CLI ו-API

  • אין API משויך

coap תצפית

הפעלה של בקשת הרשמה שמאפשרת ללקוח CoAP לצפות במשאב שצוין בשרת CoAP בנוגע לשינויים אפשריים במצב שלו.

פרמטרים

coap observe address uri-path [type]
  • address: כתובת IPv6 של שרת CoAP.
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל).

דוגמאות

coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done

הפניות CLI ו-API

  • אין API משויך

פרמטרים של COap(get,set)

אם הפקודה פועלת ללא פרמטרים אופציונליים, הפונקציה מקבלת את הערכים הנוכחיים של הפרמטרים של CoAP.

מגדיר את הפרמטרים של CoAP לערכי ברירת המחדל שלהם או לערכים שמציינים, בהתאם לתחביר שנבחר.

פרמטרים

coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
  • type: request לבקשות של CoAP, או response עבור תשובות של CoAP. אם לא תספקו פרמטרים נוספים, הפקודה תדפיס את התצורה הנוכחית.
  • default: מגדיר את הפרמטרים של ההעברה לערכי ברירת המחדל הבאים:
    • ack_timeout: 2,000 אלפיות שנייה
    • ack_random_factor_numerator: 3
    • ack_random_factor_denominator: 2
    • max_retransmit: 4
  • ack_timeout: ACK_TIMEOUT (0-UINT32_MAX) באלפיות שנייה. מידע נוסף זמין בכתובת RFC7252.
  • ack_random_factor_numerator: המונה ACK_RANDOM_FACTOR, עם ערכים אפשריים של 0-255. מידע נוסף זמין בכתובת RFC7252.
  • ack_random_factor_denominator: המכנה ACK_RANDOM_FACTOR, עם ערכים אפשריים של 0-255. מידע נוסף זמין בכתובת RFC7252.
  • max_retransmit: MAX_RETRANSMIT (0-255). מידע נוסף זמין בכתובת RFC7252.

דוגמאות

coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done

הפניות CLI ו-API

  • אין API משויך

Coap Post

יצירת משאב CoAP שצוין. למידע נוסף, ראו בדיקת הקישוריות למשאבים של פרוטוקול אפליקציה מוגבל (CoAP) באמצעות OT CLI.

פרמטרים

coap post address uri-path [type] [payload]
  • address: כתובת IPv6 של שרת CoAP.
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
    • block-: משתמשים באפשרות הזו, ולאחר מכן בערך הבלוקים, כדי לשלוח בלוקים עם מספר בייטים שנוצר באופן אקראי למטען הייעודי (payload). הערכים החוקיים הם: block-16, block-32, block-64, block-128, block-256, block-512 או block-1024.
  • payload: בקשת מטען ייעודי (payload) של CoAP, שבה אם משתמשים היא מחרוזת או מספר שלם, בהתאם לtype. אם הערך בעמודה type הוא con או non-con, הפרמטר payload הוא אופציונלי. אם לא כוללים את הפרמטר payload, נשלח מטען ייעודי (payload) ריק. עם זאת, אם משתמשים בפרמטר payload, הערך שלו חייב להיות מחרוזת, כמו hellothere. אם הערך של type הוא block-, הערך של הפרמטר payload חייב להיות מספר שלם שמציין את מספר הבלוקים שיש לשלוח. הסוג block- מחייב הגדרה של OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

דוגמאות

coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done

הפניות CLI ו-API

  • אין API משויך

Coap Pot

משנה את משאב CoAP שצוין. למידע נוסף, ראו בדיקת הקישוריות למשאבים של פרוטוקול אפליקציה מוגבל (CoAP) באמצעות OT CLI.

פרמטרים

coap put address uri-path [type] [payload]
  • address: כתובת IPv6 של שרת CoAP.
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
    • block-: משתמשים באפשרות הזו, ולאחר מכן בערך הבלוקים, כדי לשלוח בלוקים עם מספר בייטים שנוצר באופן אקראי למטען הייעודי (payload). הערכים החוקיים הם: block-16, block-32, block-64, block-128, block-256, block-512 או block-1024.
  • payload: בקשת מטען ייעודי (payload) של CoAP, שבה אם משתמשים היא מחרוזת או מספר שלם, בהתאם לtype. אם הערך בעמודה type הוא con או non-con, הפרמטר payload הוא אופציונלי. אם לא כוללים את הפרמטר payload, נשלח מטען ייעודי (payload) ריק. עם זאת, אם משתמשים בפרמטר payload, הערך שלו חייב להיות מחרוזת, כמו hellothere. אם הערך של type הוא block-, הערך של הפרמטר payload חייב להיות מספר שלם שמציין את מספר הבלוקים שיש לשלוח. הסוג block- מחייב הגדרה של OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

דוגמאות

coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done

הפניות CLI ו-API

  • אין API משויך

משאב Coap (קבל,הגדר)

מקבלת או מגדירה את נתיב ה-URI של משאב שרת CoAP.

פרמטרים

coap resource [uri-path]

דוגמאות

coap resource test-resource
Done
coap resource
test-resource
Done

הפניות CLI ו-API

קבוצת Coap

מגדיר את התוכן שנשלח על ידי המשאב בשרת CoAP. אם לקוח CoAP צופה במשאב, נשלחת התראה ללקוח הזה.

פרמטרים

coap set new-content

דוגמאות

coap set Testing123
Done

הפניות CLI ו-API

הפעלת מצב Coap

הפעלת השרת של CoAP. למידע נוסף, ראו בדיקת הקישוריות למשאבים של פרוטוקול אפליקציה מוגבל (CoAP) באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

coap start
Done

הפניות CLI ו-API

תחנת Coap

עוצר את שרת CoAP.

פרמטרים

אין פרמטרים.

דוגמאות

coap stop
Done

הפניות CLI ו-API

Coaps Connect

מפעיל סשן של Datagram Transport Layer Security (DTLS) עם אפליקציה להשוואה. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

coaps connect address

הפרמטר address הוא כתובת ה-IPv6 של האפליקציה להשוואה.

דוגמאות

coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected

הפניות CLI ו-API

Coaps מחיקה

מחרוזת המטען הייעודי (payload) של CoAPS למחיקה.

פרמטרים

coaps delete uri-path [type] [payload]
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
  • payload: בקשת מטען ייעודי (payload) של CoAPS.

דוגמאות

coaps delete test-resource con hellothere
Done

הפניות CLI ו-API

  • אין API משויך

ניתוקים Coaps

מפסיק את הסשן של DTLS.

פרמטרים

אין פרמטרים.

דוגמאות

coaps disconnect
coaps disconnected
Done

הפניות CLI ו-API

Coaps Get

קבלת מידע על משאב CoAPS שצוין בשרת CoAPS. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

coaps get uri-path [type]
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
    • block-: אם צריך להעביר את התגובה ברמת הבלוק, אפשר להשתמש באפשרות הזו, ואז להוסיף את הערך ברמת הבלוק. הערכים החוקיים הם: block-16, block-32, block-64, block-128, block-256, block-512 או block-1024.

דוגמאות

coaps get test-resource
Done
coaps get test-resource block-1024
Done

הפניות CLI ו-API

  • אין API משויך

המשטרות סגורות

הערך מציין אם השירות CoAP Secure סגור. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

coaps isclosed
no
Done

הפניות CLI ו-API

Coaps פעיל

הערך הזה מציין אם חיבור השירות של CoAP Secure פעיל (כבר מחובר או נמצא בתהליך יצירת חיבור). למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

coaps isconnactive
yes
Done

הפניות CLI ו-API

יש קשר ל-Coaps

הערך מציין אם השירות CoAP Secure מחובר. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

coaps isconnected
yes
Done

הפניות CLI ו-API

Coaps Post

יצירת משאב CoAPS שצוין. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

uri-path [type] [payload]
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
    • block-: משתמשים באפשרות הזו, ולאחר מכן בערך הבלוקים, כדי לשלוח בלוקים עם מספר בייטים שנוצר באופן אקראי למטען הייעודי (payload). הערכים החוקיים הם: block-16, block-32, block-64, block-128, block-256, block-512 או block-1024.
  • payload: בקשת מטען ייעודי (payload) של CoAPS, שבה אם נעשה שימוש הוא מחרוזת או מספר שלם, בהתאם לtype. אם הערך של type הוא con או non-con, הפרמטר של המטען הייעודי הוא אופציונלי. אם לא משמיטים את הפרמטר Payload, נשלח מטען ייעודי (payload) ריק. עם זאת, אם משתמשים בפרמטר של המטען הייעודי (payload), הערך שלו חייב להיות מחרוזת, כמו hellothere. אם הערך של type הוא block-, הערך של פרמטר המטען הייעודי חייב להיות מספר שלם שמציין את מספר הבלוקים שיש לשלוח. הסוג block- מחייב הגדרה של OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

דוגמאות

coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done

הפניות CLI ו-API

  • אין API משויך

Coaps Psk

מגדירה את המפתח המשותף מראש (PSK) ואת חבילת ההצפנה DTLS_PSK_WITH_AES_128_CCM_8.

פרמטרים

coaps psk psk-value psk-id
  • psk-value: המפתח המשותף מראש
  • psk-id: מזהה המפתח המשותף מראש.

דוגמאות

coaps psk 1234 key1
Done

הפניות CLI ו-API

קטלנים

משנה את משאב CoAPS שצוין. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

uri-path [type] [payload]
  • uri-path: נתיב ה-URI של המשאב.
  • type:
    • con: אפשר לאמת
    • non-con: לא ניתן לאישור (ברירת מחדל)
    • block-: משתמשים באפשרות הזו, ולאחר מכן בערך הבלוקים, כדי לשלוח בלוקים עם מספר בייטים שנוצר באופן אקראי למטען הייעודי (payload). הערכים החוקיים הם: block-16, block-32, block-64, block-128, block-256, block-512 או block-1024.
  • payload: בקשת מטען ייעודי (payload) של CoAPS, שבה אם נעשה שימוש הוא מחרוזת או מספר שלם, בהתאם לtype. אם הערך של type הוא con או non-con, הפרמטר של המטען הייעודי הוא אופציונלי. אם לא משמיטים את הפרמטר Payload, נשלח מטען ייעודי (payload) ריק. עם זאת, אם משתמשים בפרמטר של המטען הייעודי (payload), הערך שלו חייב להיות מחרוזת, כמו hellothere. אם הערך של type הוא block-, הערך של פרמטר המטען הייעודי חייב להיות מספר שלם שמציין את מספר הבלוקים שיש לשלוח. הסוג block- מחייב הגדרה של OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

דוגמאות

coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done

הפניות CLI ו-API

  • אין API משויך

משאב Coaps (קבל,הגדר)

מקבלת או מגדירה את נתיב ה-URI של משאב השרת CoAPS. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

coaps resource [uri-path]

דוגמאות

coaps resource test-resource
Done
coaps resource
test-resource
Done

הפניות CLI ו-API

הגדרת Coaps

מגדיר את התוכן שנשלח על ידי המשאב בשרת CoAPS. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

coaps set new-content

דוגמאות

coaps set Testing123
Done

הפניות CLI ו-API

  • אין API משויך

תחילת Coaps

הפעלת השירות של CoAP Secure. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

coaps start [check-peer-cert | max-conn-attempts]

הפרמטר check-peer-cert קובע אם הבדיקה של האישור העמית (peering) מופעלת (ברירת מחדל) או מושבתת. הפרמטר max-conn-attempts מגדיר את מספר הניסיונות המקסימלי המותר, בין אם הצליחו או נכשלו, כדי להתחבר לשרת CoAP Secure. ערך ברירת המחדל של הפרמטר הזה הוא 0, והמשמעות היא שאין הגבלה על מספר הניסיונות. הפרמטרים check-peer-cert ו-max-conn-attempts פועלים יחד בשילובים הבאים, על אף שניתן לציין רק ארגומנט אחד:

  • לא צוין ארגומנט: נעשה שימוש בברירות המחדל.
  • אם מגדירים את check-peer-cert ל-true: יש אותה השפעה כמו השמטת הארגומנט, כלומר הערך של check-peer-cert הוא true והערך של max-conn-attempts הוא 0.
  • אם המדיניות check-peer-cert מוגדרת כ-false: הערך של check-peer-cert הוא false והערך של max-conn-attempts הוא 0.
  • ציון מספר: check-peer-cert הוא true, והערך max-conn-attempts הוא המספר שצוין בארגומנט.

דוגמאות

coaps start
Done
coaps start false
Done
coaps start 8
Done

הפניות CLI ו-API

עצירת ביניים

מפסיק את השירות CoAP Secure. למידע נוסף, עיינו במאמר על בדיקת הקישוריות למשאב 'פרוטוקול אפליקציה מוגבל' (CoAPS) באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

coaps stop
Done

הפניות CLI ו-API

Coaps x509

מגדירה את אישור X509 של המכשיר המקומי עם המפתח הפרטי התואם לסשן DTLS עם DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.

פרמטרים

אין פרמטרים.

דוגמאות

coaps x509
Done

הפניות CLI ו-API

הכרזה על הנציב

נשלחת הודעת 'התחלת הכרזה'.

פרמטרים

commissioner announce mask count period destination
  • mask: מסיכת ביט שמזהה ערוצים לשליחת הודעות MLE Announce.
  • count: מספר העברות MLE Announce לכל ערוץ.
  • period: מספר אלפיות השנייה בין העברות MLE Announce רצופות.
  • destination: כתובת היעד (IPv6) של ההודעה. ייתכן שההודעה היא בכמה שידורים.

דוגמאות

commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done

הפניות CLI ו-API

נציבות האנרגיה

תישלח הודעה לגבי השאילתה 'סריקת אנרגיה'. הפלט של הפקודה מודפס כשהוא מתקבל.

פרמטרים

commissioner energy mask count period scanDuration destination
  • mask: מסכת ביט שמזהה ערוצים לביצוע סריקות אנרגיה לפי תקן IEEE 802.15.4.
  • count: מספר סריקות האנרגיה מסוג IEEE 802.15.4 לכל ערוץ.
  • period: מספר אלפיות השנייה בין סריקות אנרגיה עוקבות לפי תקן IEEE 802.15.4.
  • scanDuration: משך הסריקה באלפיות השנייה לשימוש במהלך סריקת אנרגיה לפי תקן IEEE 802.15.4.
  • destination: כתובת היעד (IPv6) של ההודעה. ייתכן שההודעה היא בכמה שידורים.

דוגמאות

commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0

הפניות CLI ו-API

מזהה נציב (get,set)

מקבלת או מגדירה את שם מזהה ה-OpenThread Commissioner.

פרמטרים

commissioner id name

דוגמאות

commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done

הפניות CLI ו-API

הוספת נציב

הוספת רשומת איחוד (join).

פרמטרים

commissioner joiner add eui64|discerner pksd [timeout]
  • eui64: IEEE EUI-64 של האיחוד. כדי להתאים כל מחבר, צריך להשתמש ב-*.
  • discerner: רכיב הדיסקer בפורמט number/length.
  • pksd: מפתח משותף מראש לשותף.
  • timeout: הזמן הקצוב לתפוגה של ההצטרפות בשניות.

דוגמאות

commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done

הפניות CLI ו-API

הסרת נציב

הסרת רשומה של מחבר.

פרמטרים

commissioner joiner remove eui64|discerner
  • eui64: IEEE EUI-64 של המצרף. כדי להתאים כל מחבר, צריך להשתמש ב-*.
  • discerner: רכיב הדיסקרינר בפורמט number/length.

דוגמאות

commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done

הפניות CLI ו-API

טבלת נציבים

הרשימה של כל רשומות ה-joiner מופיעה בפורמט של טבלה.

פרמטרים

אין פרמטרים.

דוגמאות

commissioner joiner table
| ID                    | PSKd                             | Expiration |
+-----------------------+----------------------------------+------------+
|                     * |                           J01NME |      81015 |
|      d45e64fa83f81cf7 |                           J01NME |     101204 |
| 0x0000000000000abc/12 |                           J01NME |     114360 |
Done

הפניות CLI ו-API

  • אין API משויך

Comser mgmtget

שליחה של הודעת MGMT_GET (Management Get) למנהיג. המערכת תחזיר ערכי משתנים שהוגדרו באמצעות הפקודה commissioner mgmtset.

פרמטרים

commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
  • locator: נתב גבול RLOC16.
  • sessionid: מזהה הסשן של הנציב.
  • steeringdata: היגוי של הנתונים.
  • joinerudpport: יציאת UDP לחיבור.
  • TLVs: הקבוצה של רכיבי TLV שיש לאחזר.

דוגמאות

commissioner mgmtget locator sessionid
Done

הפניות CLI ו-API

Commiter mgmtset

שולח הודעה מסוג MGMT_SET (קבוצת ניהול) למנהיג ומגדיר את המשתנים בהתאם לערכים שצוינו.

פרמטרים

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
  • locator: נתב גבול RLOC16.
  • sessionid: מזהה הסשן של הנציב.
  • steeringdata: היגוי של הנתונים.
  • joinerudpport: יציאת UDP לחיבור.
  • TLVs: הקבוצה של רכיבי TLV שיש לאחזר.

דוגמאות

commissioner mgmtset joinerudpport 9988
Done

הפניות CLI ו-API

חלונית הנציב

נשלחת שאילתה של מזהה PAN. הפלט של הפקודה מוחזר כשהוא מתקבל.

פרמטרים

commissioner panid panid mask destination
  • paind: מזהה PAN לשימוש לבדיקת התנגשויות.
  • mask; מסיכת ביט שמזהה ערוצים לביצוע סריקות פעילות של IEEE 802.15.4.
  • destination: כתובת יעד IPv6 של ההודעה. ייתכן שההודעה היא בכמה שידורים.

דוגמאות

commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800

הפניות CLI ו-API

כתובת URL להקצאת עמלה

מגדיר את כתובת ה-URL להקצאת הנציב.

פרמטרים

commissioner provisioningurl provisioningurl

דוגמאות

commissioner provisioningurl http://github.com/openthread/openthread
Done

הפניות CLI ו-API

מזהה סשן עמלה

הפונקציה מקבלת את מזהה הסשן הנוכחי של הנציב.

פרמטרים

אין פרמטרים.

דוגמאות

commissioner sessionid
0
Done

הפניות CLI ו-API

תחילת העמלה

מתחיל את התפקיד Thread Commissioner.

פרמטרים

אין פרמטרים.

דוגמאות

commissioner start
Commissioner: petitioning
Done
Commissioner: active

הפניות CLI ו-API

מצב הנציב

מחזירה את המצב הנוכחי של הנציב. הערכים האפשריים הם active, disabled או petition (עותר להפוך לנציב).

פרמטרים

אין פרמטרים.

דוגמאות

commissioner state
active
Done

הפניות CLI ו-API

עצירת ביניים

הפסקת התפקיד Thread Commissioner.

פרמטרים

אין פרמטרים.

דוגמאות

commissioner stop
Done

הפניות CLI ו-API

הקשר חוזר (get,set)

הפונקציה מקבלת או מגדירה את הערך CONTEXT_ID_REUSE_DELAY.

פרמטרים

contextreusedelay delay

משתמשים בארגומנט האופציונלי delay כדי להגדיר את CONTEXT_ID_REUSE_DELAY.

דוגמאות

contextreusedelay
11
Done
contextreusedelay 11
Done

הפניות CLI ו-API

מונים (Mac)

אחזור של מוני שכבות MAC.

פרמטרים

counters mac

דוגמאות

counters mac
TxTotal: 10
   TxUnicast: 3
   TxBroadcast: 7
   TxAckRequested: 3
   TxAcked: 3
   TxNoAckRequested: 7
   TxData: 10
   TxDataPoll: 0
   TxBeacon: 0
   TxBeaconRequest: 0
   TxOther: 0
   TxRetry: 0
   TxErrCca: 0
   TxErrBusyChannel: 0
RxTotal: 2
   RxUnicast: 1
   RxBroadcast: 1
   RxData: 2
   RxDataPoll: 0
   RxBeacon: 0
   RxBeaconRequest: 0
   RxOther: 0
   RxAddressFiltered: 0
   RxDestAddrFiltered: 0
   RxDuplicated: 0
   RxErrNoFrame: 0
   RxErrNoUnknownNeighbor: 0
   RxErrInvalidSrcAddr: 0
   RxErrSec: 0
   RxErrFcs: 0
   RxErrOther: 0
Done

הפניות CLI ו-API

מונה (mle)

קבלת מוני Thread MLE.

פרמטרים

counters mle

דוגמאות

counters mle
Role Disabled: 0
Role Detached: 1
Role Child: 0
Role Router: 0
Role Leader: 1
Attach Attempts: 1
Partition Id Changes: 1
Better Partition Attach Attempts: 0
Parent Changes: 0
Done

הפניות CLI ו-API

מונים

הפונקציה מקבלת את שמות המונה הנתמכים.

פרמטרים

אין פרמטרים.

דוגמאות

counters
ip
mac
mle
Done

הפניות CLI ו-API

  • אין API משויך

IP של מונה

מקבלת את מוני IPv6.

פרמטרים

counters ip

דוגמאות

counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done

הפניות CLI ו-API

איפוס IP של המונה

איפוס מוני IPv6.

פרמטרים

counters ip reset

דוגמאות

counters ip reset
Done

הפניות CLI ו-API

מונה Mac איפוס

איפוס המוני של שכבות ה-MAC.

פרמטרים

counters mac reset

דוגמאות

counters mac reset
Done

הפניות CLI ו-API

איפוס מונה mle

איפוס מוני ה-MLE של Thread.

פרמטרים

counters mle reset

דוגמאות

counters mle reset
Done

הפניות CLI ו-API

ערוץ CSS

הגדרת ערוץ ה-CSL.

פרמטרים

csl channel channel

דוגמאות

csl channel 20
Done

הפניות CLI ו-API

CSS

מקבלת את ההגדרות של ה-CSL.

פרמטרים

אין פרמטרים.

דוגמאות

csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done

הפניות CLI ו-API

תקופת CSS

מגדירה את תקופת ה-CSL במיליוניות השנייה.

כדי להשבית את CSL, יש להגדיר את הפרמטר הזה ל-0.

תקופת ה-CSL חייבת להיות כפולה של OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC, אחרת מוחזר OT_ERROR_INVALID_ARGS.

פרמטרים

csl period period

דוגמאות

csl period 3000000
Done

הפניות CLI ו-API

פסק זמן ל-csl

מגדיר את הזמן הקצוב לתפוגה של CSL בשניות.

פרמטרים

csl timeout timeout

דוגמאות

cls timeout 10
Done

הפניות CLI ו-API

מערך הנתונים פעיל

מקבל את מערך הנתונים התפעולי הפעיל.

ב-CLI של OT משתמשים בחברים ב-otOperationalDataset כדי להחזיר ערכים של מערך הנתונים למסוף.

פרמטרים

dataset active [-x]

הארגומנט האופציונלי -x מדפיסים את הערכים של מערך הנתונים התפעולי הפעיל כערכי TLV בקידוד הקסדצימלי.

דוגמאות

dataset active
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done
dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

הפניות CLI ו-API

חותמת זמן של מערך הנתונים (get, set)

מקבלת או מגדירה את otOperationalDataset::mActiveTimestamp.

פרמטרים

dataset activetimestamp [timestamp]

כדי להגדיר את חותמת הזמן הפעילה, מעבירים את הארגומנט האופציונלי timestamp.

דוגמאות

dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done

הפניות CLI ו-API

  • אין API משויך

מערך נתונים (get,set)

מקבלת או מגדירה את otOperationalDataset::mChannel.

פרמטרים

dataset channel [channel-num]

כדי להגדיר את הערוץ, משתמשים בארגומנט האופציונלי channel-num.

דוגמאות

dataset channel
12
Done
dataset channel 12
Done

הפניות CLI ו-API

  • אין API משויך

מסכת ערוץ של מערך נתונים (get,set)

מקבלת או מגדירה את otOperationalDataset::mChannelMask

פרמטרים

dataset channelmask [channel-mask]

כדי להגדיר את מסכת הערוץ, משתמשים בארגומנט האופציונלי channel-mask.

דוגמאות

dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done

הפניות CLI ו-API

  • אין API משויך

ניקוי מערך הנתונים

איפוס המאגר התפעולי של מערך הנתונים.

פרמטרים

אין פרמטרים.

דוגמאות

dataset clear
Done

הפניות CLI ו-API

  • אין API משויך

התחייבות למערך נתונים פעילה

שמירת המאגר של מערך הנתונים התפעולי למערך נתונים תפעולי פעיל.

פרמטרים

אין פרמטרים.

דוגמאות

dataset commit active
Done

הפניות CLI ו-API

שמירה של מערך הנתונים בהמתנה

שמירת המאגר של מערך הנתונים התפעולי למערך נתונים תפעולי בהמתנה.

פרמטרים

אין פרמטרים.

דוגמאות

dataset commit pending
Done

הפניות CLI ו-API

עיכוב במערך נתונים (get,set)

מקבלת או מגדירה את otOperationalDataset::mDelay.

פרמטרים

dataset delay [delay]

אפשר להשתמש בארגומנט האופציונלי delay כדי להגדיר את ערך הטיימר להשהיית הטיימר.

דוגמאות

dataset delay
1000
Done
dataset delay 1000
Done

הפניות CLI ו-API

מערך נתונים extpanid (get,set)

הפונקציה מקבלת או מגדירה את otOperationalDataset::mExtendedPanId.

פרמטרים

dataset extpanid [extpanid]

אפשר להשתמש בארגומנט האופציונלי extpanid כדי להגדיר את מזהה הרשת של האזור האישי המורחב.

דוגמאות

dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done

הפניות CLI ו-API

עזרה בנושא מערך נתונים

מקבלת רשימה של פקודות CLI של dataset. מידע נוסף זמין במאמר הצגה וניהול של מערכי נתונים באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
set
tlvs
Done

הפניות CLI ו-API

  • אין API משויך

אתחול מערך נתונים (פעיל,חדש,בהמתנה,tlvs)

OT CLI בודק את active, pending או tlvs ומחזיר את הערכים המתאימים. אחרת, ה-OT CLI יוצר רשת אקראית חדשה ומחזיר מערך נתונים חדש.

פרמטרים

dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]

כדי לאתחל מערך נתונים חדש, משתמשים ב-new, ואז מזינים את הפקודה dataset commit active. צריך להשתמש ב-tlvs ל-TLV בקידוד הקסדצימלי.

דוגמאות

dataset init new
Done

הפניות CLI ו-API

מערך נתונים meshlocalprefix (get,set)

מקבלת או מגדירה את otOperationalDataset::mMeshLocalPrefix.

פרמטרים

dataset meshlocalprefix [meshlocalprefix]

השתמש בארגומנט האופציונלי meshlocalprefix כדי להגדיר את הקידומת Mesh-Local.

דוגמאות

dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done

הפניות CLI ו-API

  • אין API משויך

מערך נתונים mgmtgetcommand פעיל

שולחת MGMT_ACTIVE_GET.

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

פרמטרים

dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
  • כדי לציין את היעד IPv6, משתמשים ב-address. אחרת, ה-ALOC של ה-Leader משמש כברירת מחדל.
  • עבור dataset-components, אפשר להעביר כל שילוב של otOperationalDatasetComponents, לדוגמה activetimestamp, pendingtimestamp או networkkey.
  • הארגומנט האופציונלי -x מציין רכיבי TLV גולמיים שיש לבקש.

דוגמאות

dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done

הפניות CLI ו-API

מערך הנתונים mgmtgetcommand בהמתנה

שליחת MGMT_PENDING_GET.

פרמטרים

dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]

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

דוגמאות

dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done

הפניות CLI ו-API

מערך נתונים mgmtsetcommand פעיל

שולחת MGMT_ACTIVE_SET.

פרמטרים

dataset mgmtsetcommand active [dataset-components] [-x tlv-list]

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

דוגמאות

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

הפניות CLI ו-API

מערך הנתונים mgmtsetcommand בהמתנה

שליחת MGMT_PENDING_SET.

פרמטרים

dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]

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

דוגמאות

dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done

הפניות CLI ו-API

מפתח רשת של מערך נתונים (get,set)

מקבלת או מגדירה את otOperationalDataset::mNetworkKey.

פרמטרים

dataset networkkey [key]

משתמשים בארגומנט האופציונלי key כדי להגדיר את מפתח הרשת.

דוגמאות

dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done

הפניות CLI ו-API

  • אין API משויך

שם רשת של מערך נתונים (get,set)

הפונקציה מקבלת או מגדירה את otOperationalDataset::mNetworkName.

פרמטרים

dataset networkname [name]

משתמשים בארגומנט האופציונלי name כדי להגדיר את שם הרשת.

דוגמאות

dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done

הפניות CLI ו-API

panid במערך נתונים (get,set)

מקבלת או מגדירה את otOperationalDataset::mPanId.

פרמטרים

dataset panid [panid]

משתמשים בארגומנט האופציונלי panid כדי להגדיר את מזהה ה-PAN.

דוגמאות

dataset panid
0x1234
Done
dataset panid 0x1234
Done

הפניות CLI ו-API

  • אין API משויך

מערך נתונים pendingtimestamp (get,set)

הפונקציה מקבלת או מגדירה את otOperationalDataset::mPendingTimestamp.

פרמטרים

dataset pendingtimestamp [timestamp]

אפשר להשתמש בארגומנט האופציונלי timestamp כדי להגדיר את השניות של חותמת הזמן בהמתנה.

דוגמאות

dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done

הפניות CLI ו-API

  • אין API משויך

מערך נתונים pskc (get,set)

הפונקציה מקבלת או מגדירה את otOperationalDataset::mPskc.

פרמטרים

dataset pskc [-p passphrase] | [key]

עבור FTD בלבד, יש להשתמש ב--p עם הארגומנט passphrase. -p יוצר pskc מpassphrase בקידוד UTF-8 שסיפקת, יחד עם שם הרשת ומזהה ה-PAN המורחב. אם המדיניות מוגדרת, -p משתמש במאגר הנתונים הזמני של מערך הנתונים. אחרת, הוא משתמש במקבץ הנוכחי. לחלופין, אפשר להגדיר את pskc כ-key (פורמט הקסדצימלי).

דוגמאות

dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

הפניות CLI ו-API

  • אין API משויך

מערך נתונים Securitypolicy (get,set)

מקבלת או מגדירה את מדיניות האבטחה של מערך הנתונים.

פרמטרים

dataset securitypolicy [rotationtime [onrcCepR]]

דוגמאות

dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done

הפניות CLI ו-API

  • אין API משויך

מערך נתונים מוגדר (פעיל,בהמתנה)

מגדיר את מערך הנתונים התפעולי הפעיל.

אם מערך הנתונים לא כולל חותמת זמן פעילה, מערך הנתונים שלם רק באופן חלקי.

אם פרוטוקול Thread מופעל במכשיר שיש בו מערך נתונים פעיל מלא, המכשיר ינסה להתחבר לרשת Thread קיימת באמצעות המידע הקיים במערך הנתונים. כדי לצרף לרשת נדרש רק מפתח Thread Network.

אם הערוץ לא נכלל במערך הנתונים, המכשיר ישלח הודעות MLE הכרזה בערוצים שונים כדי למצוא שכנים בערוצים אחרים.

אם המכשיר מתחבר בהצלחה לרשת ב-thread, המכשיר יאחזר את מערך הנתונים הפעיל המלא מהורה שלו. שימו לב שמכשיר שתומך בנתב לא יעבור לתפקידים 'נתב' או 'ליד' עד שיהיו בו כל מערך הנתונים הפעיל.

הפקודה dataset set של ה-CLI מגדירה את מערך הנתונים התפעולי הפעיל באמצעות רכיבי TLV בקידוד הקסדצימלי.

פרמטרים

dataset set {active|pending} tlvs

דוגמאות

dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

הפניות CLI ו-API

tlvs של מערך נתונים

ממירה מערך נתונים תפעולי נתון ל- otOperationalDatasetTlvs .

פרמטרים

אין פרמטרים.

דוגמאות

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

הפניות CLI ו-API

ביטול המעדכן של מערך הנתונים

ביטול בקשה לעדכון של מערך נתונים תפעולי (אם יש).

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

@dataset updater cancel
Done

הפניות CLI ו-API

מעדכן מערך נתונים

הערך מציין אם יש בקשה מתמשכת לעדכון מערך הנתונים של הפעולה.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

dataset updater
Enabled
Done

הפניות CLI ו-API

התחלה של מעדכן מערך הנתונים

נשלחה בקשה לעדכון מערך הנתונים התפעולי.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE מופעלת.

השדה aDataset צריך להכיל את השדות לעדכון ואת הערך החדש שלהם. היא לא יכולה להכיל שדות חותמת זמן של Active (פעיל) או Pending Timestamp. השדה 'עיכוב' הוא אופציונלי, אם לא מזינים ערך ברירת מחדל (1,000 אלפיות שנייה).

פרמטרים

אין פרמטרים.

דוגמאות

channel
19
Done
dataset clear
Done
dataset channel 15
Done
dataset
Channel: 15
Done
dataset updater start
Done
dataset updater
Enabled
Done
Dataset update complete: OK
channel
15
Done

הפניות CLI ו-API

ניפוי באגים

מבצעת סדרה של פקודות CLI כדי לאסוף מידע על המכשיר ועל הרשת של השרשורים. מיועד לניפוי באגים. בפלט יוצגו כל פקודת CLI שהופעלה ומופיעה אחריה $, ואחריה הפלט שנוצר על ידי הפקודה המתאימה. הפלט שנוצר כולל את המידע הבא:

  • גרסה
  • המצב הקיים
  • RLOC16, כתובת MAC מורחבת
  • רשימת כתובות IPv6 ב-Unicast וב-multicast
  • ערוץ
  • מזהה PAN ומזהה PAN מורחב
  • נתוני רשת
  • מזהה המחיצה
  • נתוני הבכירים בארגון

אם המכשיר פועל כ-FTD:

  • טבלת צאצא ושכן
  • טבלת נתבים ומידע על הצעד הבא
  • טבלה של מטמון כתובות
  • כתובת IPv6 רשומה של MTD
  • מאפייני המכשיר

אם המכשיר תומך ופועל כלקוח SRP:

  • מצב לקוח SRP
  • שירותי לקוח SRP ומידע על המארח

אם המכשיר תומך ופועל כמפריד SRP:

  • מצב שרת SRP ומצב כתובת
  • שירותים ומארחים רשומים של שרת SRP

אם המכשיר תומך ב-TREL:

  • סטטוס TREL וטבלת אפליקציות להשוואה

אם המכשיר תומך ומתפקד כנתב גבול:

  • מצב ברזיל
  • קידומות BR (OMR, on-link, NAT64)
  • התגלתה טבלת תחילית

פרמטרים

אין פרמטרים.

דוגמאות

הפניות CLI ו-API

  • אין API משויך

pendingtimermin (הגדרה)

הגדרת הטיימר המינימלי להשהיה (בשניות).

פרמטרים

delaytimermin delaytimermin

דוגמאות

delaytimermin 60
Done

הפניות CLI ו-API

זמן עיכוב

קבלת הטיימר המינימלי להשהיה (בשניות).

פרמטרים

אין פרמטרים.

דוגמאות

delaytimermin
30
Done

הפניות CLI ו-API

detach async

מתחילים את תהליך הניתוק החינני בדומה לפקודה detach בלי לחסום ולהמתין לקריאה החוזרת (callback) שמציינת שהניתוק הסתיים.

פרמטרים

אין פרמטרים.

דוגמאות

detach async
Done

הפניות CLI ו-API

ניתוק

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

פרמטרים

אין פרמטרים.

דוגמאות

detach
Finished detaching
Done

הפניות CLI ו-API

devicePros (set)

הגדרת מאפייני המכשיר.

פרמטרים

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

powerSupply: צריך להיות 'סוללה', 'חיצוני', 'חיצוני-יציב', 'חיצוני-לא יציב'.

דוגמאות

deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply      : battery
IsBorderRouter   : no
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : -5
Done

הפניות CLI ו-API

ציוד עזר

בודקים את מאפייני המכשיר הנוכחיים.

נדרש OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

deviceprops
PowerSupply      : external
IsBorderRouter   : yes
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : 0
Done

הפניות CLI ו-API

discover

ביצוע פעולה לגילוי MLE.

פרמטרים

discover [channel]

channel: הערוץ שבו אפשר לגלות. אם לא תספקו ערוץ, הגילוי יכסה את כל הערוצים התקינים.

דוגמאות

discover
| J | Network Name     | Extended PAN     | PAN  | MAC Address      | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread       | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

הפניות CLI ו-API

Discover reqcallback (הפעלה,השבתה)

מגדירה קריאה חוזרת (callback) לקבלת נתוני בקשה של MLE Discovery.

פרמטרים

discover reqcallback enable|disable

דוגמאות

discover reqcallback enable
Done

הפניות CLI ו-API

דפדוף ב-DNS

שליחה של שאילתת DNS של עיון (ספירה של מופע שירות) כדי לקבל את רשימת השירותים בשביל שם שירות נתון

הפרמטרים אחרי service-name הם אופציונליים. כל ערך שלא צוין (או אפס) עבור הפרמטרים האופציונליים האלה יוחלף בערך מהגדרת ברירת המחדל הנוכחית (dns config).

פרמטרים

dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

דוגמאות

dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=6531, b=6c12] TTL:7300
instance2
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=1234] TTL:7300
Done
dns browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
    Port:7000, Priority:0, Weight:0, TTL:10
    Host:Mac-mini.default.service.arpa.
    HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done

הפניות CLI ו-API

דחיסת dns (הפעלה,השבתה)

מגדירים את המצב 'דחיסת שם DNS'.

דחיסת שם DNS מופעלת כברירת מחדל. כשה-DNS מושבת, שמות ה-DNS מתווספים כמלאים ואף פעם לא דחוסים. הדבר רלוונטי למודולים של לקוח/שרת DNS ו-SRP של OpenThread." השדה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE הוא שדה חובה.

פרמטרים

dns compression [enable|disable]

דוגמאות

dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done

הפניות CLI ו-API

דחיסת DNS

השדה הזה מציין אם המצב 'דחיסת שמות DNS' מופעל או לא.

מיועד לבדיקה בלבד וזמין כאשר ההגדרה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.

דחיסת שם DNS מופעלת כברירת מחדל. כשה-DNS מושבת, שמות ה-DNS מתווספים כמלאים ואף פעם לא דחוסים. הדבר רלוונטי למודולים של לקוח/שרת DNS ו-SRP של OpenThread." השדה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE הוא שדה חובה.

פרמטרים

dns compression [enable|disable]

דוגמאות

dns compression
Enabled

הפניות CLI ו-API

הגדרת dns (set)

ההגדרה קובעת את הגדרות ברירת המחדל של השאילתה בלקוח ה-DNS.

בערך aConfig שאינו NULL, מבצע הקריאה החוזרת יכול לבחור להשאיר חלק מהשדות במופע של otDnsQueryConfig לא צוינו (הערך אפס). השדות שלא צוינו מוחלפים בהגדרות המתאימות של אפשרות תצורת OT OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{} כדי ליצור את ברירת המחדל של תצורת השאילתה.

כאשר OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE מופעל, כתובת ה-IPv6 של השרת בהגדרת ברירת המחדל מוגדרת ומעודכנת באופן אוטומטי על ידי לקוח ה-DNS. הדבר נעשה רק כאשר המשתמש לא מגדיר או מציין זאת במפורש. התנהגות זו מחייבת הפעלה של לקוח SRP ותכונת ההפעלה האוטומטית שלו. לאחר מכן, לקוח SRP יעקוב אחר נתוני רשת Thread עבור רשומות DNS/SRP כדי לבחור שרת SRP. הכתובת של שרת ה-SRP שנבחרה מוגדרת גם ככתובת של שרת ה-DNS בתצורת ברירת המחדל.

יכול להיות שחלק מהשדות לא צוינו (או להשתמש בערך אפס). השדות שלא צוינו מוחלפים בהגדרות המתאימות של אפשרות תצורת OT OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT כדי ליצור את ברירת המחדל של תצורת השאילתה. השדה OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE הוא שדה חובה.

פרמטרים

dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode]

דוגמאות

dns config fd00::1 1234 5000 2 0
Done
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 3000 ms
MaxTxAttempts: 3
RecursionDesired: yes
Done

הפניות CLI ו-API

הגדרות DNS

מקבל את ההגדרה הנוכחית של השאילתה, שמשמשת את לקוח ה-DNS.

כשמחסנית OpenThread מופעלת, הגדרת ברירת המחדל של שאילתת ה-DNS נקבעת על סמך קבוצה של אפשרויות תצורה בפרוטוקול OT, כמו OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS, _DEFAULT_SERVER_PORT, _DEFAULT_RESPONSE_TIMEOUT וכו' (ב-config/dns_client.h מפורטות כל אפשרויות ההגדרה הקשורות).

ההגדרה כוללת את הכתובת והיציאה של IPv6 של השרת, זמן קצוב לתגובה במילי-שניות (זמן המתנה לתגובת rx), מספר ניסיונות tx מקסימלי לפני דיווח על כשל, סימון בוליאני שמציין אם השרת יכול לפתור את השאילתה באופן רקורסיבי או לא. השדה OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE הוא שדה חובה.

פרמטרים

אין פרמטרים.

דוגמאות

dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done

הפניות CLI ו-API

DNS לפתרון

נשלחת שאילתת DNS לרזולוציה של כתובת עבור רשומות AAAA (IPv6) עבור שם מארח נתון.

הערך של aConfig יכול להיות NULL. במקרה הזה, הגדרת ברירת המחדל (מ- otDnsClientGetDefaultConfig() ) תשמש כהגדרה של השאילתה הזו. בשדה aConfig שאינו NULL, ניתן להשאיר חלק מהשדות לא מזוהים (הערך אפס). השדות שלא צוינו יוחלפו בערכים מהגדרת ברירת המחדל.

יש לשלוח שאילתת DNS כדי לקבל כתובת IPv6 עבור שם מארח נתון.

הפרמטרים שמופיעים אחרי שם המארח הם אופציונליים. כל ערך שלא צוין (או אפס) עבור הפרמטרים האופציונליים האלה יוחלף בערך מהגדרת ברירת המחדל הנוכחית (הגדרת dns).

כתובת ה-IP של שרת ה-DNS יכולה להיות כתובת IPv4, שתועתק לכתובת IPv6 באמצעות קידומת NAT64 המועדפת מנתוני הרשת.

פרמטרים

dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

דוגמאות

dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300
dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done

הפניות CLI ו-API

שירות DNS

הפעלת רזולוציית מופע של שירות DNS במופע נתון של שירות.

זמין כאשר OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE מופעל.

הערך של aConfig יכול להיות NULL. במקרה הזה, הגדרת ברירת המחדל (מ- otDnsClientGetDefaultConfig() ) תשמש כהגדרה של השאילתה הזו. בשדה aConfig שאינו NULL, ניתן להשאיר חלק מהשדות לא מזוהים (הערך אפס). השדות שלא צוינו יוחלפו בערכים מהגדרת ברירת המחדל.

הפונקציה שולחת שאילתות לרשומות SRV ו/או TXT עבור מופע השירות הנתון. השדה mServiceMode ב- otDnsQueryConfig קובע על אילו רשומות יש שאילתה (SRV בלבד, TXT בלבד, או SRV ו-TXT) ואת אופן הביצוע של השאילתה (ביחד באותה הודעה, בנפרד במקביל, או במצב אופטימלי שבו הלקוח ינסה תחילה באותה הודעה, ולאחר מכן בנפרד אם הוא לא יקבל תגובה).

רשומת ה-SRV מספקת מידע על היציאה, העדיפות והמשקל של השירות, יחד עם שם המארח המשויך למופע השירות. הפונקציה הזו לא מבצעת פענוח כתובת עבור שם המארח שהתגלה מרשומת SRV. השרת/המקודד עשוי לספק רשומות AAAA/A עבור שם המארח בקטע 'נתונים נוספים' של התגובה לשאילתת SRV/TXT. ניתן לאחזר את המידע הזה באמצעות otDnsServiceResponseGetServiceInfo() ב-otDnsServiceCallback. המשתמשים של ה-API הזה לא רשאים להניח שכתובת המארח תמיד תהיה זמינה מ- otDnsServiceResponseGetServiceInfo() .

שולחים שאילתת DNS לפענוח מופע של שירות, לגבי מופע של שירות נתון. קודם מזינים את התווית של מופע השירות, ואחריה את שם השירות (חשוב לשים לב שהתווית של מופע השירות יכולה להכיל את התו '.').

הפרמטרים אחרי service-name הם אופציונליים. כל ערך שלא צוין (או אפס) עבור הפרמטרים האופציונליים האלה יוחלף בערך מהגדרת ברירת המחדל הנוכחית (dns config).

פרמטרים

dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

דוגמאות

הפניות CLI ו-API

מארח שירות ב-DNS

מפעיל רזולוציית מופע של שירות DNS למופע של שירות נתון, עם רזולוציה פוטנציאלית של כתובת מעקב לשם המארח שהתגלתה עבור מופע השירות.

זמין כאשר OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE מופעל.

הערך של aConfig יכול להיות NULL. במקרה הזה, הגדרת ברירת המחדל (מ- otDnsClientGetDefaultConfig() ) תשמש כהגדרה של השאילתה הזו. בשדה aConfig שאינו NULL, ניתן להשאיר חלק מהשדות לא מזוהים (הערך אפס). השדות שלא צוינו יוחלפו בערכים מהגדרת ברירת המחדל. לא ניתן להשתמש בפונקציה הזו כאשר ההגדרה mServiceMode ב-DNS מוגדרת ל-OT_DNS_SERVICE_MODE_TXT (כלומר, שליחת שאילתה לרשומת TXT בלבד) והיא תחזיר OT_ERROR_INVALID_ARGS.

פועלת באופן דומה ל- otDnsClientResolveService() שליחת שאילתות עבור רשומות SRV ו-TXT. עם זאת, אם השרת/המקודד לא מספק רשומות AAAA/A לשם המארח בתגובה לשאילתת SRV (בקטע 'נתונים נוספים'), הוא יבצע רזולוציה של שם המארח (שישלח שאילתת AAAA) עבור שם המארח שנמצא מרשומת ה-SRV. הקריאה החוזרת (callback) aCallback מופעלת כשמתקבלות תגובות לכל השאילתות (כלומר, עד שיסתיים פתרון הבעיה גם בשירות וגם בכתובת המארח).

שולחים שאילתת DNS לפענוח מופע של שירות, למופע של שירות נתון עם רזולוציה אפשרית לשם המארח. קודם מזינים את התווית של מופע השירות, ואחריה את שם השירות (חשוב לשים לב שהתווית של מופע השירות יכולה להכיל את התו '.').

הפרמטרים אחרי service-name הם אופציונליים. כל ערך שלא צוין (או אפס) עבור הפרמטרים האופציונליים האלה יוחלף בערך מהגדרת ברירת המחדל הנוכחית (dns config).

פרמטרים

dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

דוגמאות

הפניות CLI ו-API

domainname (set)

מגדיר את שם הדומיין של השרשור.

הפעולה מצליחה רק כשהפרוטוקולים של Thread מושבתים.

פרמטרים

domainname name

שימוש ב-backslash כדי לצאת ממרחבים משותפים.

דוגמאות

domainname Test\ Thread
Done

הפניות CLI ו-API

שם דומיין

מקבל את שם הדומיין של ה-thread.

פרמטרים

אין פרמטרים.

דוגמאות

domainname
Thread
Done

הפניות CLI ו-API

dua iid (הגדרה,ברור)

מגדיר או מסיר את מזהה הממשק שצוין באופן ידני עבור כתובת Unicast של הדומיין לשרשור.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_DUA_ENABLE מופעלת.

פרמטרים

dua iid iid|clear

הפונקציה dua iid clear מעבירה nullptr אל otThreadSetFixedDuaInterfaceIdentifier. אם לא, אפשר להעביר את iid.

דוגמאות

dua iid 0004000300020001
Done
dua iid clear
Done

הפניות CLI ו-API

Dua Iid

מקבל את מזהה הממשק שצוין באופן ידני עבור כתובת Unicast של הדומיין לשרשור.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_DUA_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

dua iid
0004000300020001
Done

הפניות CLI ו-API

Eidcache

מחזירה את הרשומות של מטמון EID-to-RLOC.

פרמטרים

אין פרמטרים.

דוגמאות

eidcache
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d 2000 cache canEvict=1 transTime=0 eid=fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7f fffe retry canEvict=1 timeout=10 retryDelay=30
Done

הפניות CLI ו-API

eui64

מקבל את IEEE EUI-64 שהוקצה על ידי היצרן לממשק הזה.

פרמטרים

אין פרמטרים.

דוגמאות

eui64
0615aae900124b00
Done

הפניות CLI ו-API

extaddr (set)

מגדיר את הכתובת המורחבת של IEEE 802.15.4.

פרמטרים

extaddr extaddr

דוגמאות

extaddr dead00beef00cafe
dead00beef00cafe
Done

הפניות CLI ו-API

Extaddr

מקבל את הכתובת המורחבת IEEE 802.15.4.

פרמטרים

אין פרמטרים.

דוגמאות

extaddr
dead00beef00cafe
Done

הפניות CLI ו-API

extpanid (קבוצה)

מגדיר את מזהה ה-PAN המורחב 802.15.4.

פרמטרים

extpanid extpanid

דוגמאות

extpanid dead00beef00cafe
Done

הפניות CLI ו-API

Extpanid

מקבל את מזהה ה-PAN המורחב 802.15.4.

פרמטרים

אין פרמטרים.

דוגמאות

extpanid
dead00beef00cafe
Done

הפניות CLI ו-API

איפוס להגדרות המקוריות

מוחק את כל ההגדרות המאוחסנות בזיכרון לא תנודתי, ולאחר מכן מפעיל איפוס פלטפורמה.

פרמטרים

אין פרמטרים.

דוגמאות

factoryreset

הפניות CLI ו-API

זיוף

נשלחות הודעות מזויפות בשרשור.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.

פרמטרים

fake /a/an dst-ipaddr target meshLocalIid

דוגמאות

fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done

הפניות CLI ו-API

fem

מקבל פרמטרים חיצוניים של FEM.

פרמטרים

אין פרמטרים.

דוגמאות

fem
LNA gain 11 dBm
Done

הפניות CLI ו-API

fem nonenne (get)

מקבל את רווח Rx LNA של FEM החיצוני ב-dBm.

פרמטרים

אין פרמטרים.

דוגמאות

fem lnagain
11
Done

הפניות CLI ו-API

fem none Again (set)

מגדיר את רווח ה-Rx LNA של ה-FEM החיצוני ב-dBm.

פרמטרים

אין פרמטרים.

דוגמאות

fem lnagain 8
Done

הפניות CLI ו-API

היסטוריה ipaddr

מציג את היסטוריית הכתובות של IPv6 בפורמט unicast בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • אירוע: ערכים אפשריים הם Added או Removed.
  • אורך כתובת/קידומת: כתובת Unicast עם אורך הקידומת שלה (בביטים).
  • מקור: הערכים האפשריים הם thread, slaac, dhcp6 או manual.
  • היקף: היקף של כתובת IPv6.
  • P: סימון מועדף.
  • V: סימון תקין.
  • RLOC (R): הדגל הזה מציין אם כתובת ה-IPv6 היא מאתר ניתוב.

פרמטרים

history ipaddr [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history ipaddr
| Age                  | Event   | Address / Prefix Length                     | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
|         00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64  | slaac  |  14 | Y | Y | N |
|         00:00:44.647 | Added   | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64  | slaac  |  14 | Y | Y | N |
|         00:01:07.199 | Added   | fd00:0:0:0:0:0:0:1/64                       | manual |  14 | Y | Y | N |
|         00:02:17.885 | Added   | fdde:ad00:beef:0:0:ff:fe00:fc00/64          | thread |   3 | N | Y | N |
|         00:02:17.885 | Added   | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:21.575 | Added   | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:21.575 | Added   | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64     | thread |   3 | N | Y | N |
|         00:02:23.904 | Added   | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64           | thread |   2 | Y | Y | N |
Done
history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done

הפניות CLI ו-API

היסטוריה ipmaddr

מציג את היסטוריית הכתובות של IPv6 בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • אירוע: ערכים אפשריים הם Subscribed או Unsubscribed.
  • כתובת שידור לקבוצה
  • מקור: ערכים אפשריים הם Thread או Manual.

פרמטרים

history ipmaddr [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history ipmaddr
| Age                  | Event        | Multicast Address                       | Origin |
+----------------------+--------------+-----------------------------------------+--------+
|         00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1                      | Manual |
|         00:01:25.353 | Subscribed   | ff05:0:0:0:0:0:0:1                      | Manual |
|         00:01:54.953 | Subscribed   | ff03:0:0:0:0:0:0:2                      | Thread |
|         00:01:54.953 | Subscribed   | ff02:0:0:0:0:0:0:2                      | Thread |
|         00:01:59.329 | Subscribed   | ff33:40:fdde:ad00:beef:0:0:1            | Thread |
|         00:01:59.329 | Subscribed   | ff32:40:fdde:ad00:beef:0:0:1            | Thread |
|         00:02:01.129 | Subscribed   | ff03:0:0:0:0:0:0:fc                     | Thread |
|         00:02:01.129 | Subscribed   | ff03:0:0:0:0:0:0:1                      | Thread |
|         00:02:01.129 | Subscribed   | ff02:0:0:0:0:0:0:1                      | Thread |
Done
history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done

הפניות CLI ו-API

שכן היסטוריה

הצגת היסטוריית השכן בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • סוג: Child או Router.
  • אירוע: ערכים אפשריים הם Added, Removed או Changed.
  • כתובת מורחבת
  • RLOC16
  • מצב: מצב קישור MLE. ערכים אפשריים:
    • -: לא הוגדרו סימונים (rx-off-when-idle, מכשיר Thread מינימלי, נתוני רשת יציבה).
    • r: rx-on-when-idle
    • d: התקן פרוטוקול Thread
    • n: נתוני רשת מלאים
  • Ave RSS: מספר הפריימים הממוצע (ב-dBm) שהתקבלו מהשכן בזמן רישום הרשומה.

פרמטרים

history neighbor [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history neighbor
| Age                  | Type   | Event     | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
|         00:00:29.233 | Child  | Added     | ae5105292f0b9169 | 0x8404 | -    |     -20 |
|         00:01:38.368 | Child  | Removed   | ae5105292f0b9169 | 0x8401 | -    |     -20 |
|         00:04:27.181 | Child  | Changed   | ae5105292f0b9169 | 0x8401 | -    |     -20 |
|         00:04:51.236 | Router | Added     | 865c7ca38a5fa960 | 0x9400 | rdn  |     -20 |
|         00:04:51.587 | Child  | Removed   | 865c7ca38a5fa960 | 0x8402 | rdn  |     -20 |
|         00:05:22.764 | Child  | Changed   | ae5105292f0b9169 | 0x8401 | rn   |     -20 |
|         00:06:40.764 | Child  | Added     | 4ec99efc874a1841 | 0x8403 | r    |     -20 |
|         00:06:44.060 | Child  | Added     | 865c7ca38a5fa960 | 0x8402 | rdn  |     -20 |
|         00:06:49.515 | Child  | Added     | ae5105292f0b9169 | 0x8401 | -    |     -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done

הפניות CLI ו-API

היסטוריה netinfo

הצגת היסטוריית פרטי הרשת בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • תפקיד: תפקיד המכשיר. ערכים אפשריים הם router, child, detached או disabled.
  • מצב: מצב קישור MLE. ערכים אפשריים:
    • -: לא הוגדרו סימונים (rx-off-when-idle, מכשיר Thread מינימלי, נתוני רשת יציבה).
    • r: rx-on-when-idle
    • d: התקן פרוטוקול Thread
    • n: נתוני רשת מלאים
  • RLOC16
  • מזהה המחיצה.

פרמטרים

history netinfo [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history netinfo
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:00:10.069 | router   | rdn  | 0x6000 |    151029327 |
|         00:02:09.337 | child    | rdn  | 0x2001 |    151029327 |
|         00:02:09.338 | child    | rdn  | 0x2001 |    151029327 |
|         00:07:40.806 | child    | -    | 0x2001 |    151029327 |
|         00:07:42.297 | detached | -    | 0x6000 |            0 |
|         00:07:42.968 | disabled | -    | 0x6000 |            0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:02:05.451 | router   | rdn  | 0x6000 |    151029327 |
|         00:04:04.719 | child    | rdn  | 0x2001 |    151029327 |
Done

הפניות CLI ו-API

קידומת היסטוריה

הצגת נתוני הרשת של היסטוריית הקידומות של רשת בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • אירוע: ערכים אפשריים הם Added או Removed.
  • תחילית
  • סימונים/משמעות:
    • p: סימון מועדף
    • a: סימון הגדרה אוטומטית של כתובת IPv6 ללא שמירת מצב.
    • d: סימון הגדרה של כתובת DHCPv6 IPv6.
    • c: סימון תצורה אחרת של DHCPv6.
    • r: סימון מסלול ברירת המחדל.
    • o: דגל על רשת.
    • s: סימון יציב.
    • n: סימון Nd Dns.
    • D: סימון קידומת הדומיין.
  • העדפה: העדפה. הערכים יכולים להיות high, med או low.
  • RLOC16

פרמטרים

history prefix [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history prefix
| Age                  | Event   | Prefix                                      | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:10.663 | Added   | fd00:1111:2222:3333::/64                    | paro      | med  | 0x5400 |
|         00:01:02.054 | Removed | fd00:dead:beef:1::/64                       | paros     | high | 0x5400 |
|         00:01:21.136 | Added   | fd00:abba:cddd:0::/64                       | paos      | med  | 0x5400 |
|         00:01:45.144 | Added   | fd00:dead:beef:1::/64                       | paros     | high | 0x3c00 |
|         00:01:50.944 | Added   | fd00:dead:beef:1::/64                       | paros     | high | 0x5400 |
|         00:01:59.887 | Added   | fd00:dead:beef:1::/64                       | paros     | med  | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done

הפניות CLI ו-API

מסלול היסטורי

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

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • אירוע: ערכים אפשריים הם Added או Removed.
  • נתיב
  • סימונים/משמעות:
    • s: סימון יציב.
    • n: סימון NAT64.
  • העדפה: העדפה. הערכים יכולים להיות high, med או low.
  • RLOC16

פרמטרים

history route [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history route
| Age                  | Event   | Route                                       | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:05.456 | Removed | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:29.310 | Added   | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:42.822 | Added   | fd00:1111:0::/48                            | s         | med  | 0x5400 |
|         00:01:27.688 | Added   | fd00:aaaa:bbbb:cccc::/64                    | s         | med  | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done

הפניות CLI ו-API

נתב היסטוריה

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

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • אירוע: ערכים אפשריים הם Added, Removed, NextHopChanged או CostChanged.
  • מזהה (RLOC16): מזהה הנתב ו-RLOC16 של הנתב.
  • Next hop: מזהה הנתב ו-RLOC16 של הצעד הבא. אם אין צעד הבא, יוצג none.
  • עלות נתיב: עלות ישנה -> עלות חדשה. הערך inf מציין עלות נתיב אינסופית.

פרמטרים

history router [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history router
| Age                  | Event          | ID (RLOC16) | Next Hop    | Path Cost  |
+----------------------+----------------+-------------+-------------+------------+
|         00:00:05.258 | NextHopChanged |  7 (0x1c00) | 34 (0x8800) | inf ->   3 |
|         00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf ->   2 |
|         00:00:08.604 | Added          |  7 (0x1c00) |        none | inf -> inf |
|         00:00:11.931 | Added          | 34 (0x8800) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 59 (0xec00) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 54 (0xd800) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 34 (0x8800) |        none | inf -> inf |
|         00:00:14.948 | Removed        |  7 (0x1c00) |        none | inf -> inf |
|         00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) |   1 ->   5 |
|         00:02:33.735 | NextHopChanged | 54 (0xd800) |        none |  15 -> inf |
|         00:03:10.915 | CostChanged    | 54 (0xd800) | 34 (0x8800) |  13 ->  15 |
|         00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) |  15 ->  13 |
|         00:03:46.188 | CostChanged    | 54 (0xd800) | 59 (0xec00) |  13 ->  15 |
|         00:04:19.124 | CostChanged    | 54 (0xd800) | 59 (0xec00) |  11 ->  13 |
|         00:04:52.008 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   9 ->  11 |
|         00:05:23.176 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   7 ->   9 |
|         00:05:51.081 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   5 ->   7 |
|         00:06:48.721 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   3 ->   5 |
|         00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) |   1 ->   3 |
|         00:09:28.681 | NextHopChanged |  7 (0x1c00) | 34 (0x8800) | inf ->   3 |
|         00:09:31.882 | Added          |  7 (0x1c00) |        none | inf -> inf |
|         00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf ->   1 |
|         00:09:54.204 | Added          | 54 (0xd800) |        none | inf -> inf |
|         00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf ->   2 |
|         00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf ->   1 |
|         00:10:24.242 | Added          | 34 (0x8800) |        none | inf -> inf |
|         00:10:41.900 | NextHopChanged | 59 (0xec00) |        none |   1 -> inf |
|         00:10:42.480 | Added          |  3 (0x0c00) |  3 (0x0c00) | inf -> inf |
|         00:10:43.614 | Added          | 59 (0xec00) | 59 (0xec00) | inf ->   1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done

הפניות CLI ו-API

היסטוריה Rx

הצגת ההיסטוריה של RX בהודעות IPv6 בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • סוג:
    • סוג ההודעה של IPv6, למשל UDP, TCP, HopOpts ו-ICMP6 (וסוג המשנה שלו).
    • src: כתובת IPv6 של המקור ומספר יציאה.
    • dst: כתובת היעד של IPv6 ומספר היציאה (מספר היציאה תקף ל-UDP/TCP, אחרת הוא 0).
  • Len: אורך המטען הייעודי (payload) של IPv6 (לא כולל כותרת IPv6).
  • CHKsum: סיכום בדיקת הודעות (תקף להודעות UDP, TCP או ICMP6).
  • Sec: מציינת אם נעשה שימוש באבטחת שכבת קישור.
  • Prio: עדיפות הודעה. הערכים האפשריים הם low, norm, high או net (בהודעות של Thread control).
  • RSS: התקבל מדד חוזק אות (ב-dBm), ממוצע של כל הפריימים המקטעים שהתקבלו שיצרו את ההודעה. עבור היסטוריית TX, יוצג NA (לא רלוונטי).
  • Dir: מציג אם ההודעה נשלחה (TX) או התקבלה (RX). שידור שנכשל מצוין באמצעות TX-F בפורמט של טבלה או tx-success:no בפורמט רשימה. דוגמאות לכך ששידור שנכשל כוללות txביטול או שליחת ack מהעמית עבור אף אחד מהקטעים של ההודעות.
  • Neighb: כתובת קצרה (RLOC16) של השכן שאיתו ההודעה נשלחה/התקבלה. אם המסגרת שודרה, היא תוצג כ-bcast בפורמט טבלה או 0xffff בפורמט רשימה. אם הכתובת הקצרה של השכן לא זמינה, היא תוצג כ-unknwn בפורמט טבלה או כ-0xfffe בפורמט רשימה.
  • רדיו: קישור לרדיו שבו ההודעה נשלחה/התקבלה (שימושי כאשר OPENTHREAD_CONFIG_MULTI_RADIO מופעל). יכול להיות 15.4, trel או all (אם הוא נשלח בכל קישורי הרדיו).

פרמטרים

history rx [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history rx
| Age                  | Type             | Len   | Chksum | Sec | Prio | RSS  |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xbd26 |  no |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0                                    |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    12 | 0x3f7d | yes |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631                                |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631                                |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReqst) |    16 | 0x942c | yes | norm |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0                               |
|                      | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0                                    |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0x2e37 |  no |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xe177 |  no |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |   165 | 0x82ee | yes |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    93 | 0x52df |  no |  net |  -20 | RX | unknwn |  15.4 |
|         00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0x5ccf |  no |  net |  -20 | RX | unknwn |  15.4 |
|         00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
Done
history rx list 4
00:00:13.368
    type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
    src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
    type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
    type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
    dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done

הפניות CLI ו-API

היסטוריה rxtx

הצגת ההיסטוריה המשולבת RX ו-TX של הודעות IPv6 בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • סוג:
    • סוג ההודעה של IPv6, למשל UDP, TCP, HopOpts ו-ICMP6 (וסוג המשנה שלו).
    • src: כתובת IPv6 של המקור ומספר יציאה.
    • dst: כתובת היעד של IPv6 ומספר היציאה (מספר היציאה תקף ל-UDP/TCP, אחרת הוא 0).
  • Len: אורך המטען הייעודי (payload) של IPv6 (לא כולל כותרת IPv6).
  • CHKsum: סיכום בדיקת הודעות (תקף להודעות UDP, TCP או ICMP6).
  • Sec: מציינת אם נעשה שימוש באבטחת שכבת קישור.
  • Prio: עדיפות הודעה. הערכים האפשריים הם low, norm, high או net (בהודעות של Thread control).
  • RSS: התקבל מדד חוזק אות (ב-dBm), ממוצע של כל הפריימים המקטעים שהתקבלו שיצרו את ההודעה. עבור היסטוריית TX, יוצג NA (לא רלוונטי).
  • Dir: מציג אם ההודעה נשלחה (TX) או התקבלה (RX). שידור שנכשל מצוין באמצעות TX-F בפורמט של טבלה או tx-success:no בפורמט רשימה. דוגמאות לכך ששידור שנכשל כוללות txביטול או שליחת ack מהעמית עבור אף אחד מהקטעים של ההודעות.
  • Neighb: כתובת קצרה (RLOC16) של השכן שאיתו ההודעה נשלחה/התקבלה. אם המסגרת שודרה, היא תוצג כ-bcast בפורמט טבלה או 0xffff בפורמט רשימה. אם הכתובת הקצרה של השכן לא זמינה, היא תוצג כ-unknwn בפורמט טבלה או כ-0xfffe בפורמט רשימה.
  • רדיו: קישור לרדיו שבו ההודעה נשלחה/התקבלה (שימושי כאשר OPENTHREAD_CONFIG_MULTI_RADIO מופעל). יכול להיות 15.4, trel או all (אם הוא נשלח בכל קישורי הרדיו).

פרמטרים

history rxtx [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history rxtx
| Age                  | Type             | Len   | Chksum | Sec | Prio | RSS  |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0                                     |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    12 | 0x6c6b | yes |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631                                 |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReqst) |    16 | 0xc6a2 | yes | norm |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0                               |
|                      | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReply) |    16 | 0xc5a2 | yes | norm |  NA  | TX | 0x0800 |  15.4 |
|         00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0                               |
|                      | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xaa0d | yes |  net |  NA  | TX | 0x0800 |  15.4 |
|         00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631                                 |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0                                     |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xc1d8 |  no |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0x3cb1 |  no |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xeda0 |  no |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |   165 | 0xbdfa | yes |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    64 | 0x1c11 |  no |  net |  NA  | TX | 0x0800 |  15.4 |
|         00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
|                      | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    93 | 0xedff |  no |  net |  -20 | RX | unknwn |  15.4 |
|         00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    44 | 0xd383 |  no |  net |  NA  | TX | bcast  |  15.4 |
|         00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:2]:19788                                             |
Done
history rxtx list 5
00:00:02.100
    type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
    src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
    type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
    type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
    dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
    type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
    dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done

הפניות CLI ו-API

היסטוריה tx

הצגת היסטוריית TX של הודעות IPv6 בפורמט של טבלה או רשימה.

כל רשומה בטבלה או ברשימה מספקת:

  • גיל: הזמן שעבר מאז הנפקת הפקודה, והוא ניתן בפורמט: hours:minutes:seconds:milliseconds
  • סוג:
    • סוג ההודעה של IPv6, למשל UDP, TCP, HopOpts ו-ICMP6 (וסוג המשנה שלו).
    • src: כתובת IPv6 של המקור ומספר יציאה.
    • dst: כתובת היעד של IPv6 ומספר היציאה (מספר היציאה תקף ל-UDP/TCP, אחרת הוא 0).
  • Len: אורך המטען הייעודי (payload) של IPv6 (לא כולל כותרת IPv6).
  • CHKsum: סיכום בדיקת הודעות (תקף להודעות UDP, TCP או ICMP6).
  • Sec: מציינת אם נעשה שימוש באבטחת שכבת קישור.
  • Prio: עדיפות הודעה. הערכים האפשריים הם low, norm, high או net (בהודעות של Thread control).
  • RSS: התקבל מדד חוזק אות (ב-dBm), ממוצע של כל הפריימים המקטעים שהתקבלו שיצרו את ההודעה. עבור היסטוריית TX, יוצג NA (לא רלוונטי).
  • Dir: מציג אם ההודעה נשלחה (TX) או התקבלה (RX). שידור שנכשל מצוין באמצעות TX-F בפורמט של טבלה או tx-success:no בפורמט רשימה. דוגמאות לכך ששידור שנכשל כוללות txביטול או שליחת ack מהעמית עבור אף אחד מהקטעים של ההודעות.
  • Neighb: כתובת קצרה (RLOC16) של השכן שאיתו ההודעה נשלחה/התקבלה. אם המסגרת שודרה, היא תוצג כ-bcast בפורמט טבלה או 0xffff בפורמט רשימה. אם הכתובת הקצרה של השכן לא זמינה, היא תוצג כ-unknwn בפורמט טבלה או כ-0xfffe בפורמט רשימה.
  • רדיו: קישור לרדיו שבו ההודעה נשלחה/התקבלה (שימושי כאשר OPENTHREAD_CONFIG_MULTI_RADIO מופעל). יכול להיות 15.4, trel או all (אם הוא נשלח בכל קישורי הרדיו).

פרמטרים

history tx [list] [num-entries]
  • משתמשים באפשרות list כדי להציג את הפלט בפורמט רשימה. אחרת, הפלט יוצג בפורמט של טבלה.
  • יש להשתמש באפשרות num-entries כדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות השמורות יוצגו בפלט.

דוגמאות

history tx
| Age                  | Type             | Len   | Chksum | Sec | Prio | RSS  |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReply) |    16 | 0x932c | yes | norm |  NA  | TX | 0x4800 |  15.4 |
|         00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0                               |
|                      | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xce87 | yes |  net |  NA  | TX | 0x4800 |  15.4 |
|         00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631                                |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631                                |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    64 | 0xf7ba |  no |  net |  NA  | TX | 0x4800 |  15.4 |
|         00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
|                      | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    44 | 0x26d4 |  no |  net |  NA  | TX | bcast  |  15.4 |
|         00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
|                      | dst: [ff02:0:0:0:0:0:0:2]:19788                                             |
Done
history tx list
00:00:23.957
    type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
    dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
    type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
    type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
    type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[ff02:0:0:0:0:0:0:2]:19788
Done

הפניות CLI ו-API

ifconfig (למעלה,למטה)

מעלה או מורידה את ממשק IPv6.

קרא כדי להפעיל או להשבית תקשורת IPv6.

פרמטרים

ifconfig up|down

דוגמאות

ifconfig up
Done
ifconfig down
Done

הפניות CLI ו-API

ifconfig

מציין אם ממשק IPv6 פועל או לא.

פרמטרים

אין פרמטרים.

דוגמאות

ifconfig
down
Done
ifconfig
up
Done

הפניות CLI ו-API

מזהה מכונה

מקבלת את מזהה המכונה.

מזהה המכונה מוגדר לערך אקראי כשהמכונה נוצרת, ולאחר מכן הערך שלה לא משתנה לאחר האתחול.

פרמטרים

אין פרמטרים.

דוגמאות

instanceid
468697314
Done

הפניות CLI ו-API

הוספת ipaddr

הוספה של כתובת ממשק רשת לממשק של פרוטוקול Thread.

המכונה aAddress שמעבירים מועתקת על ידי הממשק של Thread. ממשק ה-thread תומך רק במספר קבוע של כתובות unicast שנוספו באופן חיצוני. OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

פרמטרים

ipaddr add aAddress

דוגמאות

ipaddr add 2001::dead:beef:cafe
Done

הפניות CLI ו-API

ipaddr Del

הסרה של כתובת ממשק רשת מממשק Thread.

פרמטרים

ipaddr del aAddress

דוגמאות

ipaddr del 2001::dead:beef:cafe
Done

הפניות CLI ו-API

ipaddr, אייפד, איפדר

קבלת הרשימה של כתובות IPv6 שמוקצות לממשק של פרוטוקול Thread.

פרמטרים

ipaddr [-v]

השתמש ב-v כדי לקבל מידע מפורט יותר על הכתובת:

  • origin: יכול להיות thread, slaac, dhcp6, manual ומציין את מקור הכתובת
  • plen: אורך הקידומת
  • preferred: סימון מועדף (בוליאני)
  • valid: סימון חוקי (בוליאני)

דוגמאות

ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done

הפניות CLI ו-API

ipaddr linklocal

מקבל את כתובת ה-IPv6 המקומית לקישור שרשור.

הכתובת המקומית של הקישור לשרשור נגזרת באמצעות IEEE802.15.4 כתובת מורחבת כמזהה ממשק.

פרמטרים

אין פרמטרים.

דוגמאות

ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

הפניות CLI ו-API

ipaddr mleid

מקבל את כתובת ה-EID המקומי של הרשת.

פרמטרים

אין פרמטרים.

דוגמאות

ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done

הפניות CLI ו-API

ipaddr rloc

הפונקציה מקבלת את הכתובת של Thread Routing Locator (RLOC).

פרמטרים

אין פרמטרים.

דוגמאות

ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done

הפניות CLI ו-API

הוספת ipmaddr

רישום של ממשק Thread לכתובת מרובת שידורים של ממשק רשת.

האירוע שהועבר במכונה aAddress יועתק על ידי הממשק של Thread. ממשק ה-thread תומך רק במספר קבוע של כתובות שידור לקבוצה חיצונית שנוספו. OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

פרמטרים

ipmaddr add aAddress

דוגמאות

ipmaddr add ff05::1
Done

הפניות CLI ו-API

Ipmaddr Del

ביטול ההרשמה של ממשק Thread לכתובת מרובת שידורים של ממשק רשת.

פרמטרים

ipmaddr del aAddress

דוגמאות

ipmaddr del ff05::1
Done

הפניות CLI ו-API

Ipmaddr

קבלת הרשימה של כתובות ה-Multicast של IPv6 שנרשמת לממשק של פרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

ipmaddr
ff05:0:0:0:0:0:0:1
ff33:40:fdde:ad00:beef:0:0:1
ff32:40:fdde:ad00:beef:0:0:1
Done

הפניות CLI ו-API

איפדר אטן

מקבל את הכתובת של Thread Link-Local All Thread Nodes של שידורים מרובים.

הכתובת היא כתובת מקומית מרובת שידורים המבוססת על קידומת Unicast [RFC 3306], עם:

  • flgs מוגדר ל-3 (P = 1 ו-T = 1)
  • scop מוגדר ל-2
  • מוגדר ל-64
  • קידומת הרשת מוגדרת לקידומת מקומית ברשת
  • מזהה הקבוצה הוגדר ל-1

פרמטרים

אין פרמטרים.

דוגמאות

ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done

הפניות CLI ו-API

ipmaddr promiscuous (הפעלה,השבתה)

מפעילה או משביתה מצב פרוץ של Multicast בממשק של Thread.

פרמטרים

ipmaddr promiscuous enable|disable

דוגמאות

ipmaddr promiscuous enable
Done
ipmaddr promiscuous disable
Done

הפניות CLI ו-API

איפדר פרוץ

הפונקציה בודקת אם מצב פרוץ של שידורים מרובים (multicast) מופעל בממשק של Thread.

פרמטרים

אין פרמטרים.

דוגמאות

ipmaddr promiscuous
Disabled
Done

הפניות CLI ו-API

איפדר רלאטן

מקבל את הכתובת של שרשורים בדומיין של Thread Realm-Local All Thread Nodes.

הכתובת היא כתובת מקומית מרובת-שידורים של Unicast [RFC 3306], המבוססת על קידומת, עם:

  • flgs מוגדר ל-3 (P = 1 ו-T = 1)
  • scop מוגדר ל-3
  • מוגדר ל-64
  • קידומת הרשת מוגדרת לקידומת מקומית ברשת
  • מזהה הקבוצה הוגדר ל-1

פרמטרים

אין פרמטרים.

דוגמאות

ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done

הפניות CLI ו-API

partnerer Diserner (set)

מגדיר את הדיסק און קי.

פרמטרים

joiner discerner discerner
  • משתמשים ב-{number}/{length} כדי להגדיר את discerner.
  • joiner discerner clear מגדיר את aDiscerner כ-nullptr.

דוגמאות

joiner discerner 0xabc/12
Done

הפניות CLI ו-API

ניקוי איחוד (joiner Diserner)

יש לנקות את רכיב הדיסק 'איחוד'.

פרמטרים

אין פרמטרים.

דוגמאות

joiner discerner clear
Done

הפניות CLI ו-API

  • אין API משויך

איחוד פיצ'רים

מקבלים את הדיסקינר לאיחוד.

מידע נוסף זמין ב-otJoinerSetDiscerner.

פרמטרים

אין פרמטרים.

דוגמאות

joiner discerner
0xabc/12
Done

הפניות CLI ו-API

עזרה להצטרפות

הדפסה של תפריט העזרה של joiner.

פרמטרים

אין פרמטרים.

דוגמאות

joiner help
help
id
start
state
stop
Done

הפניות CLI ו-API

  • אין API משויך

מזהה איחוד (joiner)

הפונקציה מקבלת את מזהה ההצטרפות.

אם לא הוגדר מזהה חיבור, מזהה המחבר הוא 64 הביטים הראשונים של תוצאת חישוב SHA-256 על גבי IEEE EUI-64 שהוקצה על ידי היצרן. אחרת, מזהה המחבר יחושב לפי הערך של Connectorer Discerner.

במהלך ההזמנה, מזהה ההצטרפות משמש גם בתור הכתובת המורחבת של IEEE 802.15.4 של המכשיר.

פרמטרים

אין פרמטרים.

דוגמאות

joiner id
d65e64fa83f81cf7
Done

הפניות CLI ו-API

התחלת איחוד (joiner)

הפעלת התפקיד 'רכיב חיבור בשרשור'.

פרמטרים

joiner start joining-device-credential [provisioning-url]
  • joining-device-credential: ביטוי סיסמה של מצטרף. חייב להיות מחרוזת של כל התווים האלפאנומריים באותיות רישיות (0-9 ו-A-Y, לא כולל I , O , Q ו-Z לצורכי קריאות), באורך של 6 עד 32 תווים.
  • provisioning-url: כתובת URL להקצאה עבור המצרף (אופציונלי).

דוגמאות

joiner start J01NM3
Done

הפניות CLI ו-API

מצב איחוד (join)

מקבל את מצב הצירוף.

הפונקציה מחזירה את אחד מהמצבים הבאים:

  • Idle
  • Discover
  • Connecting
  • Connected
  • Entrust
  • Joined

פרמטרים

אין פרמטרים.

דוגמאות

joiner state
Idle
Done

הפניות CLI ו-API

עצירת ביניים

השבתה של התפקיד 'שותף שרשור'.

פרמטרים

אין פרמטרים.

דוגמאות

joiner stop
Done

הפניות CLI ו-API

sharederport (set)

מגדיר את יציאת ה-UDP של המחבר.

פרמטרים

joinerport udp-port

דוגמאות

joinerport 1000
Done

הפניות CLI ו-API

איחוד (joinerport)

מקבל את יציאת ה-UDP של האיחוד.

פרמטרים

אין פרמטרים.

דוגמאות

joinerport
1000
Done

הפניות CLI ו-API

מונה מפתחות (set)

מגדיר את thrKeySequenceCounter.

פרמטרים

keysequence counter counter

דוגמאות

keysequence counter 10
Done

הפניות CLI ו-API

מונה Keyequence

מקבל את thrKeySequenceCounter.

פרמטרים

אין פרמטרים.

דוגמאות

keysequence counter
10
Done

הפניות CLI ו-API

זמן הגנה למפתחות equence (מוגדר)

מגדיר את thrKeySwitchGuardTime (בשעות).

פרמטרים

keysequence guardtime guardtime-hours

אם יש התאמה של מפתח לאינדקס, יש להשתמש ב-0 עד Thread Key Switch באופן מיידי.

דוגמאות

keysequence guardtime 0
Done

הפניות CLI ו-API

זמן הגנה על רצף מפתחות

מקבל את thrKeySwitchGuardTime (בשעות).

פרמטרים

אין פרמטרים.

דוגמאות

keysequence guardtime
0
Done

הפניות CLI ו-API

נתונים מובילים

קבלת נתונים של מוביל ה-thread.

פרמטרים

אין פרמטרים.

דוגמאות

leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done

הפניות CLI ו-API

משקל מוביל (קבוצה)

ההגדרה קובעת את משקל של מוביל ה-Thread שמשויך לפעולה בתפקיד 'מוביל'.

הערך החדש של משקל הליד מגדיר באופן ישיר את הערך החדש, ומחליף את הערך הקודם שלו (שיכול להיות שנקבע על סמך הערך הנוכחי של otDeviceProperties ).

פרמטרים

leaderweight weight

דוגמאות

leaderweight 128
Done

הפניות CLI ו-API

משקל המנהיג

מקבל את משקל מוביל ה-thread כפי שהוא מוגדר בתפקיד ה-Leader.

פרמטרים

אין פרמטרים.

דוגמאות

leaderweight
128
Done

הפניות CLI ו-API

linkmeasures mgmt enhanced-ack clear

נשלחת בקשה לניהול מדדי קישורים כדי לאשר חקירה מבוססת-ACK משופרת.

פרמטרים

linkmetrics mgmt peer-ipaddr enhanced-ack clear

peer-ipaddr צריכה להיות הכתובת של 'קישור מקומי' של המכשיר השכן.

דוגמאות

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success

הפניות CLI ו-API

רישום linkmetrics mgmt enhanced-ack

נשלחת בקשה לניהול מדדי קישורים כדי להירשם לבדיקה משופרת מסוג ACK מבוסס (Enhanced-ACK).

פרמטרים

linkmetrics mgmt peer-ipaddr enhanced-ack register [qmr][r]

[q, m ו-r] ממופים ל-otLinkMetricsValues. לפי מפרט 4.11.3.4.4.6, ניתן להשתמש בו-זמנית לכל היותר בשתי אפשרויות, לדוגמה q או qm.

  • q: שכבה 2 LQI.
  • m: שולי קישור.
  • r: RSSI.
המאפיין r הנוסף הוא אופציונלי ומשמש רק למכשירי עזר. כאשר מציינים את האפשרות הזו, הטיפוסים מסוג 'סוג/ממוצע' של כל דגלי מזהה סוג מוגדרים כשמורים. אנחנו משתמשים בנתון הזה כדי לוודא שהנושא המבחן מטפל בצורה נכונה בסימונים לא חוקיים של מזהה סוג, וזמין רק כאשר OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעל.

דוגמאות

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series

הפניות CLI ו-API

ניהול קישורים ארגוניים

נשלחת בקשה לניהול מדדי קישורי MLE כדי להגדיר או למחוק סדרת מעקב קדימה.

פרמטרים

linkmetrics mgmt peer-ipaddr forward series-id [ldraX][pqmr]
  • peer-ipaddr: כתובת של אפליקציה להשוואה.
  • series-id: מזהה הסדרה.
  • [l, d, r ו-a] ממופים ל-otLinkMetricsSeriesFlags. X לא מייצג אף אחד מה-otLinkMetricsSeriesFlags, מפסיק את החשבונאות ומסיר את הסדרה.
    • l: MLE Link Probe.
    • d: נתוני MAC.
    • r: בקשת נתוני MAC.
    • a: יציאת MAC.
    • X: ניתן להשתמש רק ללא סימונים נוספים.
  • [p, q, m ו-r] ממופים ל-otLinkMetricsValues.
    • p: מספר ה-PDU שהתקבלו.
    • q: שכבה 2 LQI.
    • m: שולי קישור.
    • r: RSSI.

דוגמאות

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS

הפניות CLI ו-API

גשושית קישור

תישלח הודעה של MLE Link Probe.

פרמטרים

linkmetrics probe peer-ipaddr series-id length
  • peer-ipaddr: כתובת של אפליקציה להשוואה.
  • series-id: מזהה הסדרה שאליו מטרגטת הודעת הבדיקה הזו.
  • length: אורך הודעת הבדיקה. טווח תקין הוא [0, 64].

דוגמאות

linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done

הפניות CLI ו-API

שאילתת קישור קדימה

מבצעים שאילתה על מדדי קישורים (סדרת מעקב עתידי).

פרמטרים

linkmetrics query peer-ipaddr forward series-id
  • peer-ipaddr: כתובת של אפליקציה להשוואה.
  • series-id: מזהה הסדרה.

דוגמאות

linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)

הפניות CLI ו-API

שאילתת קישורים יחידה

מבצעים שאילתה על מדדי קישורים (בדיקה יחידה).

פרמטרים

linkmetrics query peer-ipaddr single [pqmr]
  • peer-ipaddr: כתובת של אפליקציה להשוואה.
  • [p, q, m ו-r] ממופים אל otLinkMetrics.
    • p: מספר ה-PDU שהתקבלו.
    • q: שכבה 2 LQI.
    • m: שולי קישור.
    • r: RSSI.

דוגמאות

linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)

הפניות CLI ו-API

linkmeasuresmgr (הפעלה,השבתה)

הפעלה או השבתה של 'מנהל מדדי הקישורים'.

פרמטרים

linkmetricsmgr enable|disable

דוגמאות

linkmetricmgr enable
Done
linkmetricmgr disable
Done

הפניות CLI ו-API

תוכנית linkmeasuresmgr

קבלת נתונים ממדדי הקישורים של שכן לפי הכתובת המורחבת שלו.

פרמטרים

אין פרמטרים.

דוגמאות

linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done

הפניות CLI ו-API

לאתר (הגדרה)

מאתרים את היעד הקרוב ביותר לכתובת anycast (כלומר, מאתרים את ה-EID המקומי וה-RLOC16 של היעד).

היעד הקרוב ביותר נקבע על סמך טבלת הניתוב הנוכחית ועלויות הנתיב ברשת של Thread.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE מופעלת.

פרמטרים

locate anycastaddr

דוגמאות

locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done

הפניות CLI ו-API

לאתר

הפונקציה מקבלת את המצב הנוכחי (In Progress או Idle) של ממקם Anycast.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done

הפניות CLI ו-API

שם קובץ יומן

המדיניות קובעת את שם הקובץ לתיעוד הודעות של otPlatLog() . האפשרות הזו שימושית לניפוי באגים בסקריפטים אוטומטיים של בדיקה ב-Linux כשרישום ביומן משבש את פעולת הסקריפטים האוטומטיים של הבדיקה.

נדרשים OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART וגם OPENTHREAD_POSIX.

פרמטרים

log filename filename

דוגמאות

הפניות CLI ו-API

רמת יומן (קבוצה)

מגדירה את רמת היומן.

פרמטרים

log level level

דוגמאות

log level 4
Done

הפניות CLI ו-API

רמת יומן

בודקים את רמת היומן.

פרמטרים

אין פרמטרים.

דוגמאות

log level
1
Done

הפניות CLI ו-API

ניסיונות חוזרים של Mac ישיר (get,set)

מקבלת או מגדירה את מספר הניסיונות החוזרים הישירים בשכבת ה-MAC.

פרמטרים

mac retries direct [number]

משתמשים בארגומנט האופציונלי number כדי להגדיר את מספר הניסיונות החוזרים הישירים של TX.

דוגמאות

mac retries direct
3
Done
mac retries direct 5
Done

הפניות CLI ו-API

MAC ניסיונות חוזרים עקיפים (get,set)

מקבלת או מגדירה את מספר הניסיונות החוזרים של TX בשכבת ה-MAC.

פרמטרים

mac retries indirect [number]

משתמשים בארגומנט האופציונלי number כדי להגדיר את מספר הניסיונות החוזרים מסוג Tx עקיפים.

דוגמאות

mac retries indirect
3
Done
 max retries indirect 5
Done

הפניות CLI ו-API

שליחה ב-Mac

מורה למכשיר Rx-Off-When-Idle לשלוח מסגרת MAC להורה שלו. הפקודה הזאת מיועדת לאישור וניתן להשתמש בה רק כשהתכונה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.

פרמטרים

mac send datarequest | emptydata

צריך לבחור אחד משני הארגומנטים הבאים:

  • datarequest: שולח הודעה לתור של בקשת נתונים מסוג IEEE 802.15.4 לשידור.
  • emptydata: מורה למכשיר לשלוח מסגרת נתונים ריקה של IEEE 802.15.4.

דוגמאות

mac send datarequest
Done
mac send emptydata
Done

הפניות CLI ו-API

הוספת Macfilter

האפשרות הזו זמינה רק אם ההגדרות של OPENTHREAD_CONFIG_MAC_FILTER_ENABLE מופעלות.

הוספת כתובת מורחבת של IEEE 802.15.4 לרשימת המסננים של MAC. אם מציינים את הארגומנט האופציונלי rss, הפעולה הזו תתקן את עוצמת האות שהתקבל עבור הודעות מהכתובת. אם לא תשתמשו באפשרות rss, הכתובת תשתמש בערך ברירת המחדל שהגדרתם. אם לא הגדרת ברירת מחדל, עוצמת האות תהיה האות.

פרמטרים

macfilter addr add extaddr [rss]

דוגמאות

macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done

הפניות CLI ו-API

רשימת היתרים ל-Macfilter

מפעיל את מצב הסינון של allowlist MAC, כך שרק כתובות ה-MAC ברשימת מסנני ה-MAC יורשה לגשת.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr allowlist
Done

הפניות CLI ו-API

macfilter addr Clear

האפשרות הזו זמינה כשמפעילים את ההגדרה OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

פקודה זו מוחקת את כל הכתובות המורחבות מרשימת מסנני ה-MAC.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr clear
Done

הפניות CLI ו-API

רשימת ישויות שנחסמו ב-Macfilter

הפעלת מצב הסינון של denylist MAC. כלומר, תידחה הגישה של כל כתובות ה-MAC ברשימת מסנני ה-MAC.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr denylist
Done

הפניות CLI ו-API

השבתה של macfilter addr

השבתת מצבי סינון של MAC.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr disable
Done

הפניות CLI ו-API

  • אין API משויך

macfilter Addr

האפשרות הזו זמינה כשמפעילים את ההגדרה OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

מספק את הפרטים הבאים:

  • המצב הנוכחי של רשימת מסנני ה-MAC: AllowList, DenyList, או Disabled
  • רשימה של כל הכתובות המורחבות במסנן. עוצמת האות שנקלט (rss) ומחוון איכות הקישור (lqi) מופיעים לצד הכתובת אם הערכים האלה הוגדרו שונים מערכי ברירת המחדל.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done

הפניות CLI ו-API

הסרה מ-Macfilter

האפשרות הזו זמינה כשמפעילים את ההגדרה OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

פקודה זו מסירה את הכתובת המורחבת שצוינה מרשימת מסנני ה-MAC.

פרמטרים

macfilter addr remove extaddr

דוגמאות

macfilter addr remove 0f6127e33af6b402
Done

הפניות CLI ו-API

Macfilter

מספק את הפרטים הבאים:

  • Address Mode: המצב הנוכחי של מסנן ה-MAC: AllowList, DenyList, או Disabled
  • רשימה של כל הכתובות המורחבות ברשימת מסנני ה-MAC. עוצמת האות שנקלט (rss) ומחוון איכות הקישור (lqi) מופיעים לצד הכתובת אם הערכים האלה הוגדרו שונים מערכי ברירת המחדל.
  • רשימה נפרדת (RssIn List) שמציגה את כל הכתובות המורחבות שבהן rss הוגדר כשונה מערך ברירת המחדל.
  • Default rss: מציגה את ערכי ברירת המחדל, אם הדבר רלוונטי, להגדרות rss ו-lqi.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

הפניות CLI ו-API

Macfilter rss add, Macfilter rss

הוספת הכתובת המורחבת שצוינה לרשימת RssIn (או שינוי כתובת קיימת ברשימה של RssIn) והגדרה של עוצמת האות הנכנסת (ב-dBm) להודעות מהכתובת הזו.

פרמטרים

macfilter rss add extaddr rss

כדי להגדיר ערך ברירת מחדל לעוצמת האות שהתקבל בכל ההודעות שהתקבלו, צריך להשתמש ב-* בארגומנט extaddr.

דוגמאות

macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done

הפניות CLI ו-API

macfilter rss add-lqi

הוספת הכתובת המורחבת שצוינה לרשימה של RssIn (או שינוי כתובת קיימת ברשימה של RssIn) והגדרה של אינדיקטור איכות הקישור הקבוע להודעות מהכתובת הזו. הכתובת המורחבת לא חייבת להיכלל במסנן address allowlist/denylist כדי להגדיר את הערך lqi.

האפשרות הזו זמינה כשההגדרות של OPENTHREAD_CONFIG_MAC_FILTER_ENABLE מופעלות.

פרמטרים

macfilter rss add-lqi extaddr lqi

כדי להגדיר ערך ברירת מחדל לאינדיקטור של איכות הקישור בכל ההודעות שמתקבלות, צריך להשתמש ב-* בארגומנט extaddr. הטווח המותר הוא 0 עד 3.

דוגמאות

macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done

הפניות CLI ו-API

macfilter rss מחיקה

ניקוי כל הערכים של עוצמת האות שנקלטה (rss) ומדד איכות הקישור (lqi) (כולל ברירות המחדל) מהרשימה RssIn.

ביצוע הפעולה הזו יגרום לכך שכל הכתובות המורחבות ישתמשו באות בשידור.

האפשרות הזו זמינה כשמפעילים את ההגדרה OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter rss clear
Done

הפניות CLI ו-API

macfilter rss

מספק את הפרטים הבאים:

  • פירוט של כל הכתובות המורחבות שבהן עוצמת האות שנקלט (rss) הוגדרה כשונה מערך ברירת המחדל. מוצג גם האינדיקטור של איכות הקישור (lqi). ההגדרות של rss ושל lqi ממופות זו לזו. אם תגדירו אפשרות אחת, הערך של השנייה יוגדר באופן אוטומטי. רשימת הכתובות הזו נקראת RssIn List. הגדרה של rsi או של lqi מוסיפה את הכתובת המורחבת התואמת לרשימה של RssIn.
  • Default rss: מציגה את ערכי ברירת המחדל, אם הדבר רלוונטי, להגדרות rss ו-lqi.

פרמטרים

אין פרמטרים.

דוגמאות

macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

הפניות CLI ו-API

הסרה ב-Macfilter rss

הסרת הכתובת המורחבת שצוינה מהרשימה RssIn.

אחרי ההסרה מהרשימה RssIn, כתובת ה-MAC הזו תשתמש בהגדרות ברירת המחדל של rss ו-lqi, בהנחה שכבר הוגדרו ברירות המחדל. (אם לא הוגדרו ברירות מחדל, ייעשה שימוש באות אלחוטי.)

האפשרות הזו זמינה כשמפעילים את ההגדרה OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

לא תתבצע כל פעולה אם אין ברשימה RssIn רשומה קיימת שתואמת לכתובת המורחבת שצוינה.

פרמטרים

macfilter rss remove extaddr

כדי להסיר את הגדרות ברירת המחדל של עוצמת האות שנקלט ושל האינדיקטור של איכות הקישור, אפשר להשתמש ב-* בתור extaddr. הפעולה הזו מבטלת את הגדרות ברירות המחדל אבל לא מסירה רשומות מהרשימה RssIn.

דוגמאות

macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done

הפניות CLI ו-API

meshdiag גיליפ6

שולחים שאילתה להורה כדי לאחזר את כתובות ה-IPv6 של כל צאצאי ה-MTD שלו.

פרמטרים

meshdiag childip6 parent-rloc16

דוגמאות

meshdiag childip6 0xdc00
child-rloc16: 0xdc02
    fdde:ad00:beef:0:ded8:cd58:b73:2c21
    fd00:2:0:0:c24a:456:3b6b:c597
    fd00:1:0:0:120b:95fe:3ecc:d238
child-rloc16: 0xdc03
    fdde:ad00:beef:0:3aa6:b8bf:e7d6:eefe
    fd00:2:0:0:8ff8:a188:7436:6720
    fd00:1:0:0:1fcf:5495:790a:370f
Done

הפניות CLI ו-API

meshdiag ילדים

מתחילים שאילתה בטבלת צאצא של נתב עם RLOC16 נתון. בפלט מפורטים כל רשומות הצאצא. מידע לכל ילד:

  • RLOC16
  • כתובת MAC מורחבת
  • גרסת השרשור
  • זמן קצוב לתפוגה (בשניות)
  • גיל (שניות מאז ההשמעה האחרונה)
  • מרווח זמן בפיקוח (בשניות)
  • מספר ההודעות בתור (למקרה שהילד או הילדה ישנוני)
  • מצב המכשיר (Device Mode)
  • RSS (ממוצע ואחרון)
  • קצבי שגיאות: frame tx (בשכבת MAC), IPv6 message tx (מעל MAC)
  • זמן חיבור (בשניות מאז יצירת הקישור בפורמט {dd}d.{hh}:{mm}:{ss})
  • מידע על CSL:
    • אם הסנכרון מתבצע
    • תקופה (ביחידה של 10 סמלים-זמן)
    • זמן קצוב לתפוגה (בשניות)

פרמטרים

אין פרמטרים.

דוגמאות

meshdiag childtable 0x6400
rloc16:0x6402 ext-addr:8e6f4d323bbed1fe ver:4
    timeout:120 age:36 supvn:129 q-msg:0
    rx-on:yes type:ftd full-net:yes
    rss - ave:-20 last:-20 margin:80
    err-rate - frame:11.51% msg:0.76%
    conn-time:00:11:07
    csl - sync:no period:0 timeout:0 channel:0
rloc16:0x6403 ext-addr:ee24e64ecf8c079a ver:4
    timeout:120 age:19 supvn:129 q-msg:0
    rx-on:no type:mtd full-net:no
    rss - ave:-20 last:-20  margin:80
    err-rate - frame:0.73% msg:0.00%
    conn-time:01:08:53
    csl - sync:no period:0 timeout:0 channel:0
Done

הפניות CLI ו-API

  • אין API משויך

נתב רשת מסוג meshdiagneighbortable

מתחילים שאילתה בטבלת סמוך של הנתב עם RLOC16 נתון. בפלט מפורטים כל הערכים השכנים של הנתב. פרטים לכל רשומה:

  • RLOC16
  • כתובת MAC מורחבת
  • גרסת השרשור
  • RSS (ממוצע ואחרון) ושולי הקישורים
  • קצבי שגיאות, tx (בשכבת MAC), IPv6 message tx (מעל MAC)
  • זמן חיבור (בשניות מאז יצירת הקישור בפורמט {dd}d.{hh}:{mm}:{ss})

פרמטרים

meshdiag routerneighbortable router-rloc16

דוגמאות

meshdiag routerneighbortable 0x7400
rloc16:0x9c00 ext-addr:764788cf6e57a4d2 ver:4
   rss - ave:-20 last:-20 margin:80
   err-rate - frame:1.38% msg:0.00%
   conn-time:01:54:02
rloc16:0x7c00 ext-addr:4ed24fceec9bf6d3 ver:4
   rss - ave:-20 last:-20 margin:80
   err-rate - frame:0.72% msg:0.00%
   conn-time:00:11:27
Done

הפניות CLI ו-API

טופולוגיה של רשת אריג

גילוי הטופולוגיה של הרשת (רשימת הנתבים והחיבורים שלהם). הפרמטרים הם אופציונליים ומציינים פריטים נוספים שצריך לגלות. אפשר להוסיף בכל סדר.

  • ip6-addrs כדי לראות את הרשימה של כתובות ה-IPv6 של כל נתב.
  • children כדי לראות את טבלת הצאצא של כל נתב.

מידע לכל נתב:

  • מזהה הנתב
  • RLOC16
  • כתובת MAC מורחבת
  • גרסת השרשור (אם ידועה)
  • האם הנתב הוא המכשיר הזה הוא עצמו (me)
  • אם הנתב הוא ההורה של המכשיר הזה כשהמכשיר הוא ילד (parent)
  • האם הנתב leader
  • האם הנתב פועל כנתב גבול שמספק קישוריות חיצונית (br)
  • רשימת הנתבים שאליהם יש לנתב הזה קישור:
    • 3-links: מזהי נתב שאליהם יש לנתב הזה קישור נכנס באיכות קישור 3
    • 2-links: מזהי נתב שאליו יש לנתב הזה קישור נכנס באיכות קישור 2
    • 1-links: מזהי נתב שאליהם יש לנתב הזה קישור נכנס באיכות קישור 1
    • אם רשימה ריקה, המערכת תשמיט אותה החוצה.
  • אם ip6-addrs, רשימה של כתובות IPv6 של הנתב
  • אם children, רשימה של כל הצאצאים של הנתב. מידע לכל ילד:
    • RLOC16
    • איכות הקישור הנכנסת מנקודת המבט של הורה לילד (אפס מציינת לא ידוע)
    • מצב מכשיר לילדים (r rx-on-when-idle, d מכשיר פרוטוקול Thread מלא, n נתוני רשת מלאים, - לא הוגדרו סימונים)
    • האם הילד או הילדה הם המכשיר הזה עצמו (me)
    • האם הילד או הילדה פועלים כנתב גבול שמספק קישוריות חיצונית (br)

פרמטרים

meshdiag topology [ip6-addrs] [children]

דוגמאות

meshdiag topology
id:02 rloc16:0x0800 ext-addr:8aa57d2c603fe16c ver:4 - me - leader
   3-links:{ 46 }
id:46 rloc16:0xb800 ext-addr:fe109d277e0175cc ver:4
   3-links:{ 02 51 57 }
id:33 rloc16:0x8400 ext-addr:d2e511a146b9e54d ver:4
   3-links:{ 51 57 }
id:51 rloc16:0xcc00 ext-addr:9aab43ababf05352 ver:4
   3-links:{ 33 57 }
   2-links:{ 46 }
id:57 rloc16:0xe400 ext-addr:dae9c4c0e9da55ff ver:4
   3-links:{ 46 51 }
   1-links:{ 33 }
Done

הפניות CLI ו-API

mleadvimax

הפונקציה מקבלת את הערך הנוכחי של מרווח הזמן המקסימלי שמשמש את הטיימר לטפטוף הפרסומת.

ל-API הזה נדרש OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE והוא מיועד לבדיקה בלבד.

פרמטרים

אין פרמטרים.

דוגמאות

mleadvimax
12000
Done

הפניות CLI ו-API

Mliid

מגדיר את ה-IID המקומי של הרשת (למטרות הבדיקה).

נדרש OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

צריך להשתמש בה כדי להפעיל את מחסנית השרשורים.

רק לצורך בדיקה או הפניה למכשיר.

פרמטרים

mliid iid

דוגמאות

mliid 1122334455667788
Done

הפניות CLI ו-API

mlr reg

רושם מעבדי Multicast כנתב שדרה ראשי.

חייבים להפעיל את OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE ואת OPENTHREAD_CONFIG_COMMISSIONER_ENABLE.

השמטת הזמן הקצוב לתפוגה כדי להשתמש בזמן הקצוב המוגדר כברירת מחדל ל-MLR בנתב השדרה הראשי.

כדי לבטל את הרישום של פונקציות Multicast Listening, צריך להשתמש בערך 'זמן קצוב לתפוגה' = 0.

פרמטרים

mlr reg ipaddr [timeout]

דוגמאות

mlr reg ff04::1
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Done
mlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 0
status 0, 0 failed
Done

הפניות CLI ו-API

מצב (קבל,הגדר)

הגדרת התצורה של מצב קישור MLE.

פרמטרים

mode [rdn]
  • -: לא הוגדרו סימונים (rx-off-when-idle, מכשיר Thread מינימלי, נתוני רשת יציבה)
  • r: rx-on-when-idle
  • d: התקן פרוטוקול Thread
  • n: נתוני רשת מלאים

דוגמאות

mode rdn
Done
mode -
Done

הפניות CLI ו-API

מולטי-רדיו

קבלת רשימה של קישורי רדיו נתמכים לפי המכשיר.

הפקודה הזו תמיד זמינה, גם כשהמכשיר תומך רק ברדיו אחד.

פרמטרים

אין פרמטרים.

דוגמאות

multiradio
[15.4, TREL]
Done

הפניות CLI ו-API

  • אין API משויך

רשימת שכנים ומולטי-רדיו

מקבלת את הפרטים של קישור ריבוי רדיו שמשויך לשכן עם כתובת מורחבת נתונה.

חובה להפעיל את OPENTHREAD_CONFIG_MULTI_RADIO.

פרמטרים

אין פרמטרים.

דוגמאות

multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done

הפניות CLI ו-API

שכן מולטי-רדיו

מקבלת את הפרטים של קישור ריבוי רדיו שמשויך לשכן עם כתובת מורחבת נתונה.

חובה להפעיל את OPENTHREAD_CONFIG_MULTI_RADIO.

פרמטרים

multiradio neighbor ext-address

דוגמאות

multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done

הפניות CLI ו-API

nat64 (הפעלה,השבתה)

הפעלה או השבתה של פונקציות NAT64.

כאשר OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעלת, ההגדרה מושבתת כ-True תאפס את טבלת המיפוי בתרגום.

האפשרות זמינה כאשר OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE או OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE מופעלים.

פרמטרים

nat64 enable|disable

דוגמאות

nat64 enable
Done
nat64 disable
Done

הפניות CLI ו-API

nat64 cidr

פרמטרים

אין פרמטרים.

דוגמאות

nat64 cidr 192.168.255.0/24
Done

הפניות CLI ו-API

nat64 cidr

מקבל את הגדרת ה-CIDR של IPv4 במתרגם NAT64.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

nat64 cidr
192.168.255.0/24
Done

הפניות CLI ו-API

מוני nat64

מקבל את חבילות התרגום של NAT64 ומוני השגיאות.

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

nat64 counters
|               | 4 to 6                  | 6 to 4                  |
+---------------+-------------------------+-------------------------+
| Protocol      | Pkts     | Bytes        | Pkts     | Bytes        |
+---------------+----------+--------------+----------+--------------+
|         Total |       11 |          704 |       11 |          704 |
|           TCP |        0 |            0 |        0 |            0 |
|           UDP |        0 |            0 |        0 |            0 |
|          ICMP |       11 |          704 |       11 |          704 |
| Errors        | Pkts                    | Pkts                    |
+---------------+-------------------------+-------------------------+
|         Total |                       8 |                       4 |
|   Illegal Pkt |                       0 |                       0 |
|   Unsup Proto |                       0 |                       0 |
|    No Mapping |                       2 |                       0 |
Done

הפניות CLI ו-API

מיפויי nat64

מקבלת את הפרטים הבאים של AddressMapping (באמצעות איטרטור).

האפשרות הזו זמינה כאשר המדיניות OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

nat64 mappings
|          | Address                   |        | 4 to 6       | 6 to 4       |
+----------+---------------------------+--------+--------------+--------------+
| ID       | IPv6       | IPv4         | Expiry | Pkts | Bytes | Pkts | Bytes |
+----------+------------+--------------+--------+------+-------+------+-------+
| 00021cb9 | fdc7::df79 | 192.168.64.2 |  7196s |    6 |   456 |   11 |  1928 |
|          |                                TCP |    0 |     0 |    0 |     0 |
|          |                                UDP |    1 |   136 |   16 |  1608 |
|          |                               ICMP |    5 |   320 |    5 |   320 |

הפניות CLI ו-API

מצב nat64

הפונקציה מקבלת את המצב של פונקציות NAT64.

המצב PrefixManager זמין כשOPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE מופעל. המצב Translator זמין כשOPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעל.

כשהאפשרות OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE מופעלת, PrefixManager מחזירה את אחד מהמצבים הבאים:

  • Disabled: מנהל התחילית NAT64 מושבת.
  • NotRunning: מנהל התחילית NAT64 מופעל, אבל לא פועל. יכול להיות שמנהל הניתוב מושבת.
  • Idle: מנהל קידומת NAT64 מופעל ופועל, אבל לא מפרסם קידומת NAT64. מצב כזה יכול לקרות כשנתב גבולות אחר מפרסם קידומת NAT64 בעדיפות גבוהה יותר.
  • Active: מנהל קידומת NAT64 מופעל, פועל ומפרסם קידומת NAT64.

כשהאפשרות OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעלת, Translator מחזירה את אחד מהמצבים הבאים:

  • Disabled: מתרגם NAT64 מושבת.
  • NotRunning: מתרגם NAT64 מופעל, אבל לא מתרגם מנות. יכול להיות שהמתרגם לא מוגדר עם קידומת NAT64 או CIDR ל-NAT64.
  • Active: מתרגם NAT64 מופעל ומתרגם מנות.

פרמטרים

אין פרמטרים.

דוגמאות

nat64 state
PrefixManager: Active
Translator: Active
Done

הפניות CLI ו-API

רשימת רשתות שכנות

מדפיסה את זמן החיבור ואת גיל השכנים. פקודה זו דומה ל-neighbor conntime, אך היא מציגה את המידע בפורמט רשימה. הגיל וזמן החיבור מוצגים בשניות.

פרמטרים

אין פרמטרים.

דוגמאות

neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done

הפניות CLI ו-API

שכן

מדפיסה את זמן החיבור ואת גיל השכנים. מידע לכל שכן:

  • RLOC16
  • MAC מורחב
  • נשמע אחרון (גיל): מספר השניות מאז ששמעתי את השכן לאחרונה.
  • זמן חיבור: מספר השניות שחלפו מאז ביסוס הקישור עם שכן. הפורמט של מרווחי זמן הוא {hh}:{mm}:{ss} לשעות, דקות ושניות, אם משך הזמן הוא פחות מיום אחד. אם משך הזמן ארוך יותר מיום אחד, הפורמט הוא {dd}d.{hh}:{mm}:{ss}.

פרמטרים

אין פרמטרים.

דוגמאות

neighbor conntime
| RLOC16 | Extended MAC     | Last Heard (Age) | Connection Time  |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 |         00:00:13 |         00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 |         00:00:03 |         00:11:27 |
| 0xe800 | ce53628a1e3f5b3c |         00:00:02 |         00:00:15 |
Done

הפניות CLI ו-API

איכות קישור שכן

מדפיס מידע על איכות הקישור על כל השכנים.

פרמטרים

אין פרמטרים.

דוגמאות

neighbor linkquality
| RLOC16 | Extended MAC     | Frame Error | Msg Error | Avg RSS | Last RSS | Age   |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db |      0.00 % |    0.00 % |     -46 |      -48 |     1 |
| 0xc001 | 0ad7ed6beaa6016d |      4.67 % |    0.08 % |     -68 |      -72 |    10 |
Done

הפניות CLI ו-API

  • אין API משויך

רשימת שכנים

רשימת ה-RLOC16 של כל שכן.

פרמטרים

אין פרמטרים.

דוגמאות

neighbor list
0xcc01 0xc800 0xf000
Done

הפניות CLI ו-API

  • אין API משויך

טבלת שכן

מדפיס מידע בפורמט של טבלה לגבי כל השכנים.

עבור Role, הערכים האפשריים היחידים לטבלה הזו הם C (צאצא) או R (נתב).

בעמודות הבאות יש מידע על מצב המכשיר של השכנים. כל עמודה מקבלת את הערך 0 (מושבת) או 1 (on).

  • R: RX פועל כשהמכשיר לא פעיל
  • D: מכשיר עם פרוטוקול Thread
  • N: נתוני רשת מלאים

פרמטרים

אין פרמטרים.

דוגמאות

neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC     |
+------+--------+-----+----------+-----------+-+-+-+------------------+
|   C  | 0xcc01 |  96 |      -46 |       -46 |1|1|1| 1eb9ba8a6522636b |
|   R  | 0xc800 |   2 |      -29 |       -29 |1|1|1| 9a91556102c39ddb |
|   R  | 0xf000 |   3 |      -28 |       -28 |1|1|1| 0ad7ed6beaa6016d |
Done

הפניות CLI ו-API

netdata מלא

אפשר להדפיס את הערך 'yes' או 'no' כדי לציין אם הקריאה החוזרת (callback) מסוג 'net data full' הופעלה מאז תחילת פעולת ה-thread או מאז הפעם האחרונה שבה נעשה שימוש ב-netdata full reset לאיפוס הדגל. לפקודה הזו נדרש OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL. הקריאה החוזרת (callback) "נתונים מלאים" מופעלת כאשר:

  • המכשיר פועל כמוביל ומקבל רישום נתוני רשת מפורטב גבול (BR) שהוא לא יכול להוסיף לנתוני רשת (אין מספיק מקום).
  • המכשיר פועל כ-BR ולא ניתן להוסיף רשומות חדשות לנתוני הרשת המקומית שלו.
  • המכשיר פועל כ-BR ומנסה לרשום את הרשומות של נתוני הרשת המקומיים עם המוביל, אבל קובע שהרשומות המקומיות שלו לא יתאימו.

פרמטרים

אין פרמטרים.

דוגמאות

netdata full
no
Done

הפניות CLI ו-API

איפוס מלא של netdata

איפוס המעקב אחר הסימון אם הופעלה קריאה חוזרת מסוג 'net data full'.

פרמטרים

אין פרמטרים.

דוגמאות

netdata full reset
Done

הפניות CLI ו-API

  • אין API משויך

אורך netdata

קבלת האורך הנוכחי (מספר הבייטים) של נתוני Thread Network של ה-partition.

פרמטרים

אין פרמטרים.

דוגמאות

netdata length
23
Done

הפניות CLI ו-API

אורך מקסימלי של netdata

קבלת האורך המקסימלי שנצפה של נתוני Thread Network מאז אתחול מקבץ OT או מאז הקריאה האחרונה ל- otNetDataResetMaxLength() .

פרמטרים

אין פרמטרים.

דוגמאות

netdata maxlength
40
Done

הפניות CLI ו-API

איפוס netdata maxlength

איפוס האורך המקסימלי של נתוני רשת ה-threads.

פרמטרים

אין פרמטרים.

דוגמאות

netdata maxlength reset
Done

הפניות CLI ו-API

פרסום netdata dnssrp anycast

פרסום כתובת Anycast של שירות DNS/SRP עם מספר רצף. כל רשומה נוכחית של שירות DNS/SRP שמתפרסמת מפקודת publish dnssrp{anycast|unicast} קודמת תוסר ותוחלף בארגומנטים החדשים.

חובה להפעיל את OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

פרמטרים

netdata publish dnssrp anycast seq-num

דוגמאות

netdata publish dnssrp anycast 1
Done

הפניות CLI ו-API

netdata publish dnssrp unicast (addr,port)

פרסום כתובת Unicast של שירות DNS/SRP עם כתובת ומספר יציאה. הכתובת והיציאה כלולים בנתוני ה-TLV של השירות. כל רשומה נוכחית של שירות DNS/SRP שמתפרסמת מפקודת publish dnssrp{anycast|unicast} קודמת תוסר ותוחלף בארגומנטים החדשים.

חובה להפעיל את OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

פרמטרים

netdata publish dnssrp unicast address port

דוגמאות

netdata publish dnssrp unicast fd00::1234 51525
Done

הפניות CLI ו-API

netdata publish dnssrp unicast (mle)

פרסום ה-EID מסוג Mesh-Local של המכשיר עם מספר יציאה. נתוני MLE והיציאות נכללים בנתוני ה-TLV של השרת. כדי להשתמש בכתובת Unicast אחרת, משתמשים בפקודה netdata publish dnssrp unicast (addr,port).

כל רשומה נוכחית של שירות DNS/SRP שמתפרסמת מפקודת publish dnssrp{anycast|unicast} קודמת תוסר ותוחלף בארגומנטים החדשים.

חובה להפעיל את OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

פרמטרים

netdata publish dnssrp unicast port

דוגמאות

netdata publish dnssrp unicast 50152
Done

הפניות CLI ו-API

קידומת פרסום netdata

מפרסמים רשומת קידומת ברשת. מידע נוסף זמין במאמר ניהול נתוני רשת וניהול שלהם באמצעות OT CLI.

פרמטרים

netdata publish prefix prefix [padcrosnD] [high|med|low]

OT CLI משתמש בארגומנטים ממופים כדי להגדיר ערכי otBorderRouterConfig. מידע נוסף זמין בסקירה הכללית של OpenThread CLI

דוגמאות

netdata publish prefix fd00:1234:5678::/64 paos med
Done

הפניות CLI ו-API

החלפת פרסום ב-netdata

מחליף ערך של מסלול חיצוני שפורסם בעבר. מידע נוסף זמין במאמר ניהול נתוני רשת וניהול שלהם באמצעות OT CLI.

פרמטרים

netdata publish replace oldprefix prefix [sn] [high|med|low]

ב-CLI של OT נעשה שימוש בארגומנטים ממופים כדי להגדיר ערכי otExternalRouteConfig. מידע נוסף זמין בסקירה הכללית של OpenThread CLI

דוגמאות

netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done

הפניות CLI ו-API

נתיב פרסום netdata

מפרסמים רשומה של מסלול חיצוני. מידע נוסף זמין במאמר ניהול נתוני רשת וניהול שלהם באמצעות OT CLI.

פרמטרים

publish route prefix [sn] [high|med|low]

ב-CLI של OT נעשה שימוש בארגומנטים ממופים כדי להגדיר ערכי otExternalRouteConfig. מידע נוסף זמין בסקירה הכללית של OpenThread CLI

דוגמאות

netdata publish route fd00:1234:5678::/64 s high
Done

הפניות CLI ו-API

רישום netdata

רישום תחיליות, נתיבים ושירותים שהוגדרו אצל ה-Leader.

בדיקות OT CLI של OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE. אם OTBR מופעל, הוא רושם את נתוני הרשת המקומית אצל ה-Leader. אחרת, הוא קורא לפונקציה של CLI כ-otServerRegister. מידע נוסף זמין במאמר ניהול נתוני רשת וניהול שלהם באמצעות OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

netdata register
Done

הפניות CLI ו-API

netdata steeringdata check (discerner)

בודקים אם נתוני ההיגוי כוללים איחוד (join) עם ערך נתון של דיסקר.

פרמטרים

netdata steeringdata check discerner
  • discerner: רכיב הדיסקer בפורמט {number}/{length}.

דוגמאות

netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound

הפניות CLI ו-API

netdata steeringdata check (eui64)

בודקים אם נתוני ההיגוי כוללים שירות איחוד (joiner).

פרמטרים

netdata steeringdata check eui64
  • eui64: האיחוד האירופי של IEEE-EUI-64 של האיחוד.

דוגמאות

netdata steeringdata check d45e64fa83f81cf7
Done

הפניות CLI ו-API

netdata unpublish (קידומת)

מבטל את הפרסום של קידומת On-Mesh או של המסלול החיצוני שפורסמו בעבר.

חובה להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

מידע נוסף זמין במאמר ניהול נתוני רשת וניהול שלהם באמצעות OT CLI.

פרמטרים

netdata unpublish prefix

דוגמאות

netdata unpublish fd00:1234:5678::/64
Done

הפניות CLI ו-API

netdata בטל פרסום dnssrp

מבטל את הפרסום של רשומת שירות DNS/SRP (Anycast או Unicast) שנוספו בעבר מנתוני Thread Network.

חובה להפעיל את OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

netdata unpublish dnssrp
Done

הפניות CLI ו-API

Netstat

הפונקציה מקבלת את הראש של הרשימה המקושרת של שקעי UDP.

פרמטרים

אין פרמטרים.

דוגמאות

netstat
| Local Address                                   | Peer Address                                    |
+-------------------------------------------------+-------------------------------------------------+
| [0:0:0:0:0:0:0:0]:49153                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:49152                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:61631                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:19788                         | [0:0:0:0:0:0:0:0]:0                             |
Done

הפניות CLI ו-API

Networkdiagnostic Get

נשלחת בקשה לאבחון רשת כדי לאחזר את ערכי אורך הסוג (TLV) שצוינו עבור הכתובות שצוינו.

פרמטרים

networkdiagnostic get addr type(s)

עבור addr, כתובת unicast מפעילה Diagnostic Get. כתובת שידור לקבוצה מפעילה Diagnostic Query. ערכי TLV שאפשר לציין (מופרדים באמצעות רווח אם מציינים יותר מ-TLV אחד):

  • 0: כתובת MAC מורחבת TLV
  • 1: כתובת16 TLV
  • 2: מצב TLV
  • 3: זמן קצוב לתפוגה של TLV (תקופת הזמן המקסימלית לתשאול עבור SED)
  • 4: קישוריות TLV
  • 5: כביש 64 TLV
  • 6: נתוני Leader Data TLV
  • 7: TLV של נתוני רשת
  • 8: TLV של רשימת כתובות IPv6
  • 9: מוני MAC TLV
  • 14: רמת הטעינה של הסוללה TLV
  • 15: מתח אספקה TLV
  • 16: מודעת TLV לילדים
  • 17: דפי ערוץ TLV
  • 19: זמן קצוב לתפוגה של מספר מקסימלי של צאצאים
  • 23: EUI64 TLV
  • 24: גרסה TLV (מספר גרסה של הפרוטוקולים והתכונות)
  • 25: שם הספק TLV
  • 26: מודל ספק TLV
  • 27: גרסת SW של ספק TLV
  • 28: TLV של גרסת Thread Stack (מזהה גרסה כמחרוזת UTF-8 עבור קודbase/commit/version של Thread)
  • 29: TLV של ילדים
  • 34: מוני MLE TLV
  • 35: כתובת ה-URL של אפליקציית הספק TLV

דוגמאות

networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
    PartitionId: 0x640b0f67
    Weighting: 64
    DataVersion: 116
    StableDataVersion: 197
    LeaderRouterId: 0x03
EUI64: 18b4300000000004
Done
networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done

הפניות CLI ו-API

איפוס אבחון הרשת

נשלחת בקשה לאבחון רשת כדי לאפס את ערכי אורך הסוג (TLV) שצוינו בכתובות שצוינו. הפקודה הזו תומכת רק בערכי ה-TLV הבאים: 9 (MAC Counters TLV) או 34 (MLE Counters TLV)

פרמטרים

networkdiagnostic reset addr type(s)

דוגמאות

networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done

הפניות CLI ו-API

networkidtimeout (get,set)

הפונקציה מקבלת או מגדירה את הפרמטר NETWORK_ID_TIMEOUT.

פרמטרים

networkidtimeout [timeout]

אפשר להשתמש בארגומנט האופציונלי timeout כדי להגדיר את הערך של הפרמטר NETWORK_ID_TIMEOUT.

דוגמאות

networkidtimeout 120
Done
networkidtimeout
120
Done

הפניות CLI ו-API

מפתח רשת (מפתח)

מגדירים את Thread Network Key.

אפשר לבצע את הפעולה רק כשהפרוטוקולים של Thread מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים הפעילים והממתינים בזיכרון לא תנודתי.

פרמטרים

networkkey key

דוגמאות

networkkey 00112233445566778899aabbccddeeff
Done

הפניות CLI ו-API

מפתח רשת

קבלת מפתח Thread Network.

פרמטרים

אין פרמטרים.

דוגמאות

networkkey
00112233445566778899aabbccddeeff
Done

הפניות CLI ו-API

שם הרשת (שם)

מגדירים את השם של פרוטוקול Thread Network.

אפשר לבצע את הפעולה רק כשהפרוטוקולים של Thread מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים הפעילים והממתינים בזיכרון לא תנודתי.

פרמטרים

networkname name

דוגמאות

networkname OpenThread
Done

הפניות CLI ו-API

שם רשת

קבלת השם של Thread Network.

פרמטרים

אין פרמטרים.

דוגמאות

networkname
OpenThread
Done

הפניות CLI ו-API

זמן רשת (מוגדר)

הגדרת הפרמטרים לסנכרון השעה.

  • timesyncperiod: פרק הזמן לסנכרון הזמן, בשניות.
  • xtalthreshold: סף הדיוק של XTAL ב-PPM, שלפיו ניתן להפוך מכשיר לתומך בנתב.

פרמטרים

networktime timesyncperiod xtalthreshold

דוגמאות

networktime 100 300
Done

הפניות CLI ו-API

זמן רשת

קבלת השעה ברשת של Thread והפרמטרים של סנכרון השעה.

פרמטרים

אין פרמטרים.

דוגמאות

networktime
Network Time:     21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold:   300ppm
Done

הפניות CLI ו-API

nexthop (get)

המחיר של הצעד הבא ועלות הנתיב לקראת יעד נתון של RLOC16.

אפשר להשתמש במאפיין הזה כאשר הערך של aNextHopRloc16 או הערך של aPathCost הוא NULL, שמציין שהמתקשר לא רוצה לקבל את הערך.

פרמטרים

nexthop rloc16

דוגמאות

nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done

הפניות CLI ו-API

Nexthop

טבלת פלט של מזהי הנתבים שהוקצו והעלות הנוכחית של הצעד הבא והנתיב לכל נתב.

פרמטרים

אין פרמטרים.

דוגמאות

nexthop
| ID   |NxtHop| Cost |
+------+------+------+
|    9 |    9 |    1 |
|   25 |   25 |    0 |
|   30 |   30 |    1 |
|   46 |    - |    - |
|   50 |   30 |    3 |
|   60 |   30 |    2 |
Done

הפניות CLI ו-API

panid (פנד)

מגדירים את מזהה ה-PAN של IEEE 802.15.4.

אפשר לבצע את הפעולה רק כשהפרוטוקולים של Thread מושבתים. בנוסף, קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים הפעילים והממתינים בזיכרון לא תנודתי.

פרמטרים

panid panid

דוגמאות

panid 0xdead
Done

הפניות CLI ו-API

פנד

קבלת מזהה ה-PAN של IEEE 802.15.4.

פרמטרים

אין פרמטרים.

דוגמאות

panid
0xdead
Done

הפניות CLI ו-API

parent

קבלת פרטי האבחון של נתב Thread כהורה.

כשמפעילים את הפקודה הזו כנתב Thread Router כשOPEN_CONFIG_REFERENCE_DEVICE_ENABLE מופעל, הפקודה הזו תחזיר את המידע שנשמר במטמון מהמכשיר שצורף בעבר כצאצא של פרוטוקול Thread. החזרת מידע ששמור במטמון נדרשת כדי לתמוך ב'מסגרת בדיקה של שרשורים – תרחיש בדיקה 8.2.x' .בקשת כתובת ה-MAC הקודמת של ההורה (כלומר, של הנתב היציג) כבר מקדמת את המכשיר, גם אם המכשיר כבר הועלה לנתב.

פרמטרים

אין פרמטרים.

דוגמאות

parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done

הפניות CLI ו-API

מתחילים את התהליך שבו הילדים מחפשים הורה טוב יותר, בלי קשר להורה הנוכחי.

חובה להשתמש במכשיר כשהוא מחובר לילדים.

פרמטרים

אין פרמטרים.

דוגמאות

parent search
Done

הפניות CLI ו-API

הורה (get,set)

מקבלת או מגדירה את ערך העדיפות של ההורה שמוקצה: 1, 0, -1 או -2. -2 פירושו לא מוקצה.

פרמטרים

parentpriority [parentpriority]

דוגמאות

parentpriority
1
Done
parentpriority 1
Done

הפניות CLI ו-API

מזהה מחיצה

קבלת מזהה המחיצה של Thread Network.

פרמטרים

אין פרמטרים.

דוגמאות

partitionid
4294967295
Done

הפניות CLI ו-API

מחיצות מועדפת (קבל,הגדרה)

השדה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE הוא שדה חובה.

פרמטרים

partitionid preferred partitionid

דוגמאות

partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done

הפניות CLI ו-API

platform

הדפסה של הפלטפורמה הנוכחית

פרמטרים

אין פרמטרים.

דוגמאות

platform
NRF52840
Done

הפניות CLI ו-API

  • אין API משויך

Polperiod (get,set)

קבלה או הגדרה של פרק הזמן המותאם אישית של סקר הנתונים במכשיר קצה ישן (אלפיות שנייה). רק למבחן ההסמכה.

פרמטרים

אין פרמטרים.

דוגמאות

pollperiod
0
Done
pollperiod 10
Done

הפניות CLI ו-API

נתיב מועדף

מציין את מזהה הנתב המועדף שהמוביל צריך לספק בעת בקשתו.

פרמטרים

preferrouterid routerid

דוגמאות

preferrouterid 16
Done

הפניות CLI ו-API

הוספת תחילית

הוספת קידומת תקינה לנתוני הרשת.

פרמטרים

prefix add prefix [padcrosnD] [high|med|low]

OT CLI משתמש בארגומנטים ממופים כדי להגדיר ערכי otBorderRouterConfig. מידע נוסף זמין בסקירה הכללית של OpenThread CLI

דוגמאות

prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done

הפניות CLI ו-API

קידומת רשת מקומית

מקבלים את הקידומת המקומית של הרשת.

פרמטרים

אין פרמטרים.

דוגמאות

prefix meshlocal
fdde:ad00:beef:0::/64
Done

הפניות CLI ו-API

  • אין API משויך

תחילית

קבלת רשימת הקידומות בנתוני הרשת המקומית.

לקבלת מידע נוסף על הדגלים של otBorderRouterConfig, יש לעיין בסקירה הכללית של OpenThread CLI.

פרמטרים

אין פרמטרים.

דוגמאות

prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done

הפניות CLI ו-API

הסרת קידומת

הסרת הגדרה של נתב גבול מנתוני הרשת המקומית.

פרמטרים

אין פרמטרים.

דוגמאות

prefix remove 2001:dead:beef:cafe::/64
Done

הפניות CLI ו-API

פרוץ (הפעלה,השבתה)

מפעילה או משביתה את מצב פרוץ בשכבת הקישור.

פרמטרים

promiscuous enable|disable

דוגמאות

promiscuous enable
Done
promiscuous disable
Done

הפניות CLI ו-API

פרוץ

מציין אם מצב פרוץ מופעל או לא מופעל בשכבת הקישור.

פרמטרים

אין פרמטרים.

דוגמאות

promiscuous
Disabled
Done

הפניות CLI ו-API

pskc (set)

מגדיר את pskc בפורמט הקסדצימלי.

פרמטרים

pskc key

דוגמאות

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

הפניות CLI ו-API

  • אין API משויך

pskc -p

יוצר את ה-pskc מביטוי הסיסמה (בקידוד UTF-8), ביחד עם שם הרשת הנוכחי ומזהה ה-PAN המורחב.

פרמטרים

pskc -p passphrase

דוגמאות

pskc -p 123456
Done

הפניות CLI ו-API

  • אין API משויך

PSCc

קבלת PSKc של Thread.

פרמטרים

אין פרמטרים.

דוגמאות

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

הפניות CLI ו-API

pskcref (set)

מגדירים את Key Reference (ה-Key Reference) ל-Thread PSKc.

צריך להפעיל את התכונה OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE בזמן ה-build.

הפעולה תתבצע רק כשהפרוטוקולים של Thread מושבתים. אם תעשו זאת בהצלחה, מערכי הנתונים התפעוליים הפעילים והממתינים יימחקו בזיכרון הלא תנודתי.

פרמטרים

pskc keyref

דוגמאות

pskc 0x20017
Done

הפניות CLI ו-API

Pskcref

אחזור של אזכור מפתח ל-Thread PSKc.

צריך להפעיל את התכונה OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE בזמן ה-build.

פרמטרים

אין פרמטרים.

דוגמאות

pskcref
0x80000000
Done

הפניות CLI ו-API

רדיו (הפעלה,השבתה)

מפעילה או משביתה את הרדיו.

פרמטרים

radio enable|disable

דוגמאות

radio enable
Done
radio disable
Done

הפניות CLI ו-API

הנתונים הסטטיסטיים ברדיו ברורים

איפוס הנתונים הסטטיסטיים של הרדיו.

כל הזמנים מאופסים ל-0.

פרמטרים

אין פרמטרים.

דוגמאות

radio stats clear
Done

הפניות CLI ו-API

נתונים סטטיסטיים של רדיו

הפונקציה מקבלת את הנתונים הסטטיסטיים של הרדיו.

הנתונים הסטטיסטיים של הרדיו כוללים את השעה שבה הרדיו נמצא במצב TX/RX/שינה. הזמנים האלה שייכים ליחידות של מיליוניות השנייה. כל הזמנים מחושבים מהאיפוס האחרון של סטטיסטיקת הרדיו.

פרמטרים

אין פרמטרים.

דוגמאות

radio stats
Radio Statistics:
Total Time: 67.756s
Tx Time: 0.022944s (0.03%)
Rx Time: 1.482353s (2.18%)
Sleep Time: 66.251128s (97.77%)
Disabled Time: 0.000080s (0.00%)
Done

הפניות CLI ו-API

גרסת rcp

מוצאים את המחרוזת של גרסת הרדיו.

פרמטרים

אין פרמטרים.

דוגמאות

rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun  4 2020 17:53:16
Done

הפניות CLI ו-API

אזור (הגדרה)

הגדרת קוד האזור.

הפורמט של אזור רדיו הוא ייצוג ASCII של 2 בייטים של קוד ISO 3166 alpha-2.

שינוי הפרטים האלה יכול להשפיע על המגבלה של עוצמת השידור.

פרמטרים

אין פרמטרים.

דוגמאות

region US
Done

הפניות CLI ו-API

region

מקבלים את קידומת החיוג האזורית.

הפורמט של אזור רדיו הוא ייצוג ASCII של 2 בייטים של קוד ISO 3166 alpha-2.

פרמטרים

אין פרמטרים.

דוגמאות

region
US
Done

הפניות CLI ו-API

Releaserouterid (מנותבת)

שחרור של מזהה הנתב שהוקצה על ידי המכשיר בתפקיד מוביל.

פרמטרים

releaserouterid [routerid]

דוגמאות

releaserouterid 16
Done

הפניות CLI ו-API

rloc16

קבלו את ה-RLOC16.

פרמטרים

אין פרמטרים.

דוגמאות

rloc16
0xdead
Done

הפניות CLI ו-API

הוספת מסלול

לפרמטרים, צריך להשתמש ב:

  • s: סימון יציב
  • n: דגל NAT64
  • prf: העדפת נתב המוגדרת כברירת מחדל, [גבוהה, בינונית, נמוכה].

יש להוסיף נתיב חיצוני חוקי לנתוני הרשת.

פרמטרים

route add prefix [sn] [high|med|low]

דוגמאות

route add 2001:dead:beef:cafe::/64 s med
Done

הפניות CLI ו-API

הסרת נתיב

הסרת הגדרה של מסלול חיצוני מנתוני הרשת המקומית.

פרמטרים

route remove [prefix]

דוגמאות

route remove 2001:dead:beef:cafe::/64
Done

הפניות CLI ו-API

נתיב

קבלת רשימת הנתיבים החיצוניים בנתוני הרשת המקומית.

פרמטרים

אין פרמטרים.

דוגמאות

route
2001:dead:beef:cafe::/64 s med
Done

הפניות CLI ו-API

נתב (מזהה)

הפונקציה שומרת את פרטי האבחון של נתב Thread נתון.

הדפסה של פרטי האבחון של נתב Thread. המזהה יכול להיות מזהה נתב או RLOC16.

פרמטרים

router [id]

דוגמאות

router 50
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 3
Done
router 0xc800
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 7
Done

הפניות CLI ו-API

רשימת נתבים

הצגת רשימה של מזהי הנתבים שהוקצו.

פרמטרים

אין פרמטרים.

דוגמאות

router list
8 24 50
Done

הפניות CLI ו-API

טבלת נתבים

מדפיס רשימה של נתבים בפורמט של טבלה.

פרמטרים

אין פרמטרים.

דוגמאות

router table
| ID | RLOC16 | Next Hop | Path Cost | LQ In | LQ Out | Age | Extended MAC     | Link |
+----+--------+----------+-----------+-------+--------+-----+------------------+------+
| 22 | 0x5800 |       63 |         0 |     0 |      0 |   0 | 0aeb8196c9f61658 |    0 |
| 49 | 0xc400 |       63 |         0 |     3 |      3 |   0 | faa1c03908e2dbf2 |    1 |
Done

הפניות CLI ו-API

Routdowndownthreshold (get,set)

מקבלת או מגדירה את הערך ROUTER_DOWNGRADE_ בשיתוף.

פרמטרים

routerdowngradethreshold [threshold]

דוגמאות

 routerdowngradethreshold
23
Done
 routerdowngradethreshold 23
Done

הפניות CLI ו-API

נתב כשיר (הפעלה,השבתה)

מפעילה או משביתה את התפקיד בנתב.

פרמטרים

routereligible [enable|disable]

דוגמאות

routereligible enable
Done
routereligible disable
Done

הפניות CLI ו-API

נתב כשיר

השדה הזה מציין אם התפקיד בנתב מופעל או מושבת.

פרמטרים

אין פרמטרים.

דוגמאות

routereligible
Enabled
Done

הפניות CLI ו-API

Routselectionjitter

משיג או מגדיר את הערך ROUTER_SELECTION_JITTER.

פרמטרים

routerselectionjitter [jitter]

דוגמאות

routerselectionjitter
120
Done
routerselectionjitter 120
Done

הפניות CLI ו-API

Routerupgradethreshold (get,set)

מקבלת או מגדירה את הערך ROUTER_UPGRADE_ בשיתוף.

פרמטרים

routerupgradethreshold [threshold]

דוגמאות

routerupgradethreshold
16
Done
routerupgradethreshold 16
Done

הפניות CLI ו-API

סריקת אנרגיה

מבצעת סריקת אנרגיה לפי תקן IEEE 802.15.4, ומציגה את הזמן באלפיות השנייה לשימוש בסריקה של כל ערוץ. כל הערוצים יוצגו, אלא אם ציינתם ערוץ מסוים באמצעות האפשרות 'ערוץ'.

פרמטרים

scan energy [duration] [channel]

דוגמאות

scan energy 10
| Ch | RSSI |
+----+------+
| 11 |  -59 |
| 12 |  -62 |
| 13 |  -67 |
| 14 |  -61 |
| 15 |  -87 |
| 16 |  -86 |
| 17 |  -86 |
| 18 |  -52 |
| 19 |  -58 |
| 20 |  -82 |
| 21 |  -76 |
| 22 |  -82 |
| 23 |  -74 |
| 24 |  -81 |
| 25 |  -88 |
| 26 |  -71 |
Done
scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 |  -82 |
Done

הפניות CLI ו-API

סריקה

מבצע סריקה פעילה של IEEE 802.15.4. הסריקה מכסה את כל הערוצים אם לא צוין ערוץ. אחרת, הטווח מכסה רק את הערוץ שצוין.

פרמטרים

scan [channel]

דוגמאות

scan
| PAN  | MAC Address      | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

הפניות CLI ו-API

הוספת שירות

הוספת שירות לנתוני הרשת.

  • EnterpriseNumber: מספר ארגון IANA
  • serviceData: נתוני שירות בינאריים בקידוד הקסדצימלי
  • ServerData: נתוני שרת בינאריים בקידוד הקסדצימלי

פרמטרים

service add enterpriseNumber serviceData serverData

דוגמאות

service add 44970 112233 aabbcc
Done
netdata register
Done

הפניות CLI ו-API

הסרת שירות

הסרת השירות מנתוני הרשת.

  • EnterpriseNumber: מספר ארגון IANA
  • serviceData: נתוני שירות בינאריים בקידוד הקסדצימלי

פרמטרים

service remove enterpriseNumber serviceData

דוגמאות

service remove 44970 112233
Done
netdata register
Done

הפניות CLI ו-API

singleton

מציין אם צומת הוא הנתב היחיד ברשת. הפונקציה מחזירה את הערך true או את הערך false.

פרמטרים

אין פרמטרים.

דוגמאות

singleton
true
Done

הפניות CLI ו-API

שאילתת sntp

נשלחת שאילתת SNTP כדי לקבל את השעה הנוכחית של מערכת Unix (מ-1 בינואר 1970).

  • כתובת ה-IP המוגדרת כברירת מחדל של שרת SNTP: 2001:4860:4806:8:: (שרת Google IPv6 NTP)
  • יציאת ברירת המחדל של שרת SNTP: 123

פרמטרים

sntp query [SNTP server IP] [SNTP server port]

דוגמאות

sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done

הפניות CLI ו-API

הפעלה אוטומטית של לקוח srp (קבל)

מציין את המצב הנוכחי של מצב ההפעלה האוטומטית (מופעל או מושבת). מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp client autostart
Disabled
Done

הפניות CLI ו-API

השבתה של הפעלה אוטומטית של לקוח srp

מצב ההפעלה האוטומטית מושבת.

השבתת מצב ההפעלה האוטומטית לא עוצרת לקוח פועל. עם זאת, לקוח ה-SRP מפסיק לעקוב אחרי נתוני רשת של Thread.

פרמטרים

אין פרמטרים.

דוגמאות

srp client autostart disable
Done

הפניות CLI ו-API

הפעלה אוטומטית של לקוח srp

הפעלת מצב הפעלה אוטומטית.

כאשר 'הפעלה אוטומטית' מופעלת, לקוח ה-SRP עוקב אחר נתוני רשת Thread כדי לגלות שרתי SRP, לבחור את השרת המועדף ולהפעיל ולהפסיק את הלקוח באופן אוטומטי כאשר מזוהה שרת SRP.

שלוש קטגוריות של רשומות נתוני רשת מציינות את נוכחותו של מפריד SRP, והן מועדפות בסדר הבא:

  1. רשומות Unicast שבהן כתובת השרת כלולה בנתוני השירות. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.
  2. רשומות Anycast שלכל אחת מהן יש מספר רצף. עדיף להשתמש במספר הרצף הגדול ביותר כפי שצוין על ידי המספר הסידורי Arithmetic Logic ב-RFC-1982.
  3. רשומות Unicast שבהן פרטי הכתובת של השרת כלולים בנתוני השרת. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.

פרמטרים

אין פרמטרים.

דוגמאות

srp client autostart enable
Done

הפניות CLI ו-API

קריאה חוזרת (callback) של לקוח srp (קבל,הפעלה,השבתה)

קבלה או הפעלה/השבתה של הדפסה של אירועי קריאה חוזרת (callback) מלקוח SRP. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp client callback [enable|disable]

דוגמאות

srp client callback enable
Done
srp client callback
Enabled
Done

הפניות CLI ו-API

כתובת מארח של לקוח srp (קבל)

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client host address
auto
Done
srp client host address
fd00:0:0:0:0:0:0:1234
fd00:0:0:0:0:0:0:beef
Done

הפניות CLI ו-API

כתובת מארח של לקוח srp (הגדרה)

הפעילו את מצב הכתובת של המארח האוטומטי או מגדירים במפורש את רשימת כתובות המארחים. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp client host address [auto|address...]
  • צריך להשתמש בפרמטר auto כדי להפעיל את מצב הכתובת של המארח האוטומטי. כשהאפשרות הזו מופעלת, הלקוח משתמש באופן אוטומטי בכל כתובות ה-unicast המועדפות ל-thread netif, מלבד כתובות link-local וכתובות רשת מקומיות. אם אין כתובת חוקית, כתובת ה-EID המקומית ברשת תתווסף. אם כתובות ב-thread netif מתווספות או מוסרות, או אם הן מסומנות כלא מועדפות, לקוח ה-SRP נרשם מחדש באופן אוטומטי.
  • צריך לציין במפורש את רשימת הכתובות המארחות, ולהפריד בין הכתובות באמצעות רווח. אפשר להגדיר את הרשימה הזו בזמן שהלקוח פועל. הפעולה הזו גם תשבית את מצב הכתובת של המארח האוטומטי.

דוגמאות

srp client host address auto
Done
srp client host address fd00::cafe
Done

הפניות CLI ו-API

לקוח srp מארח ברור

ניקוי כל פרטי המארח וכל השירותים.

פרמטרים

אין פרמטרים.

דוגמאות

srp client host clear
Done

הפניות CLI ו-API

שם מארח של לקוח srp (get,set)

קבלה או הגדרה של שם המארח של לקוח SRP. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp client host name [name]

כדי להגדיר את שם מארח הלקוח אחרי שהמארח הוסר או עדיין לא רשום בשרת, צריך להשתמש בפרמטר name.

דוגמאות

srp client host name dev4312
Done
srp client host name
dev4312
Done

הפניות CLI ו-API

הסרה של לקוח srp ממארח

מסיר את הפרטים של מארח לקוח ה-SRP ואת כל השירותים משרת ה-SRP. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp client host remove [removekeylease] [sendunregtoserver]
  • הפרמטר removekeylease הוא ערך בוליאני אופציונלי שמציין אם יש להסיר גם את החכירה של מפתח המארח (ברירת המחדל היא false).
  • הפרמטר sendunregtoserver הוא ערך בוליאני אופציונלי שמציין אם מארח הלקוח צריך לשלוח הודעת "עדכון" לשרת גם כשפרטי מארח הלקוח עדיין לא רשומים בשרת (ברירת המחדל היא false). אפשר לציין את הפרמטר הזה רק אם הפרמטר removekeylease צוין ראשון בפקודה.

דוגמאות

srp client host remove 1
Done

הפניות CLI ו-API

מארח לקוח srp

קבלת פרטי המארח.

פרמטרים

אין פרמטרים.

דוגמאות

srp client host
name:"dev4312", state:Registered, addrs:[fd00:0:0:0:0:0:0:1234, fd00:0:0:0:0:0:0:beef]
Done

הפניות CLI ו-API

מצב מארח srp של לקוח

מחזירה את המצב של מארח לקוח ה-SRP. מצבים אפשריים:

  • ToAdd: הפריט להוספה/לרישום.
  • Adding: מתבצעת הוספה/רישום של פריט.
  • ToRefresh: הפריט לרענון לקראת חידוש ההשכרה.
  • Refreshing: מתבצע רענון של הפריט בצבע בז'.
  • ToRemove: הפריט יוסר.
  • Removing: מתבצעת הסרה של הפריט.
  • Registered: הפריט רשום בשרת.
  • Removed: הפריט הוסר.

פרמטרים

אין פרמטרים.

דוגמאות

srp client host state
Registered
Done

הפניות CLI ו-API

  • אין API משויך

keyleaseinterval (קבלה,הגדרה) של לקוח srp

הפונקציה מקבלת או מגדירה את מרווח השכירות של המפתח בשניות.

פרמטרים

srp client keyleaseinterval [interval]

דוגמאות

srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done

הפניות CLI ו-API

srp client leaseinterval (get,set)

הפונקציה מקבלת או מגדירה את מרווח השכירות בשניות.

פרמטרים

srp client leaseinterval [interval]

דוגמאות

srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done

הפניות CLI ו-API

כתובת שרת לקוח srp

מחזירה את כתובת ה-IPv6 של השרת.

פרמטרים

אין פרמטרים.

דוגמאות

srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done

הפניות CLI ו-API

  • אין API משויך

יציאת שרת לקוח srp

מחזירה את מספר היציאה של השרת.

פרמטרים

אין פרמטרים.

דוגמאות

srp client server port
4724
Done

הפניות CLI ו-API

  • אין API משויך

שרת לקוח srp

מקבל את כתובת ה-socket (כתובת IPv6 ומספר היציאה) של שרת ה-SRP שבו משתמש לקוח ה-SRP. אם הלקוח לא פועל, לא צוינה כתובת (כל האפסים) ומספר היציאה הוא 0. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done

הפניות CLI ו-API

הוספת שירות לקוחות srp

הוספת שירות עם שם של מכונה, שם שירות ומספר יציאה. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp client service add instancename servicename port [priority] [weight] [txt]

הפרמטר servicename יכול לכלול רשימה של תוויות סוג משנה של שירות שמופרדות בפסיקים. בדוגמאות כאן נעשה שימוש בשמות גנריים. הפרמטרים priority ו-weight (שניהם הם ערכי uint16_t) הם אופציונליים, ואם לא מזינים ערך, המערכת משתמשת באפס. הפרמטר האופציונלי txt מגדיר את נתוני ה-TXT המשויכים לשירות. הערך של txt חייב להיות בפורמט הקסדצימלי, והמערכת תתייחס אליו כרצף בייטים של נתוני TXT שמקודד כבר.

דוגמאות

srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done

הפניות CLI ו-API

מפתח שירות לקוח srp (קבל,הגדר)

מקבל או מגדיר את מצב ההכללה של רשומת מפתח השירות בלקוח ה-SRP. הפקודה הזו מיועדת לבדיקה בלבד ומחייבת להפעיל את OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp client service key enable
Done
srp client service key
Enabled
Done

הפניות CLI ו-API

השם של שירות הלקוח ב-Srp ברור

ניקוי שירות והסרה שלו מיידית מרשימת שירותי הלקוחות, ללא אינטראקציה עם שרת ה-SRP.

פרמטרים

srp client service clear instancename servicename

דוגמאות

srp client service clear ins2 _test2._udp
Done

הפניות CLI ו-API

הסרה של שירות לקוח srp

בקשת ביטול רישום של שירות בשרת SRP.

פרמטרים

srp client service remove instancename servicename

דוגמאות

srp client service remove ins2 _test2._udp
Done

הפניות CLI ו-API

שירות לקוח srp

קבלת רשימת השירותים שמנוהלים על ידי הלקוח.

פרמטרים

אין פרמטרים.

דוגמאות

srp client service
instance:"ins2", name:"_test2._udp,_sub1,_sub2", state:Registered, port:111, priority:1, weight:1
instance:"ins1", name:"_test1._udp", state:Registered, port:777, priority:0, weight:0
Done

הפניות CLI ו-API

התחלת לקוח Srp

מפעיל את פעולת לקוח ה-SRP. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp client start serveraddr serverport

דוגמאות

srp client start fd00::d88a:618b:384d:e760 4724
Done

הפניות CLI ו-API

מצב לקוח srp

מציין אם לקוח ה-SRP פועל או לא.

פרמטרים

אין פרמטרים.

דוגמאות

srp client state
Enabled
Done

הפניות CLI ו-API

עצירת לקוח srp

מפסיק את פעולת לקוח ה-SRP.

עוצר כל אינטראקציה נוספת עם שרת ה-SRP. שימו לב שהוא לא מסיר או מנקה את פרטי המארח ו/או את רשימת השירותים. כשהלקוח מופעל (מחדש) הוא מסמן את כל השירותים להוספה או להסרה מחדש.

פרמטרים

אין פרמטרים.

דוגמאות

srp client stop
Done

הפניות CLI ו-API

srp client ttl (get,set)

הפונקציה מקבלת או מגדירה את הערך ttl(משך החיים) בשניות.

פרמטרים

srp client ttl [value]

דוגמאות

srp client ttl 3600
Done
srp client ttl
3600
Done

הפניות CLI ו-API

שרת srp (הפעלה,השבתה)

מפעילה או משביתה את שרת ה-SRP. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp server [enable|disable]

דוגמאות

srp server disable
Done

הפניות CLI ו-API

addrmode של שרת srp (get,set)

מקבלת או מגדירה את מצב הכתובת המשמש את שרת ה-SRP.

מצב הכתובת מורה לשרת ה-SRP איך לקבוע את הכתובת ואת מספר היציאה שלו, שיפורסמו לאחר מכן בנתוני הרשת של Thread.

פרמטרים

srp server addrmode [anycast|unicast]

דוגמאות

srp server addrmode anycast
Done
srp server addrmode
anycast
Done

הפניות CLI ו-API

שרת srp אוטומטי (הפעלה,השבתה)

המדיניות מפעילה או משביתה את מצב ההפעלה האוטומטית בשרת ה-SRP.

כשהמצב הזה מופעל, מנהל ניתוב הגבולות קובע אם ומתי להפעיל או להשבית את שרת ה-SRP.

כדי להשתמש בפקודה הזו צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

srp server auto [enable|disable]

דוגמאות

srp server auto enable
Done
srp server auto
Enabled
Done

הפניות CLI ו-API

דומיין שרת srp (get,set)

מקבל או מגדיר את שם הדומיין של שרת ה-SRP.

פרמטרים

srp server domain [domain-name]

דוגמאות

srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done

הפניות CLI ו-API

מארח של שרת srp

מחזירה מידע על כל המארחים הרשומים. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp server host
srp-api-test-1.default.service.arpa.
    deleted: false
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0.default.service.arpa.
    deleted: false
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done

הפניות CLI ו-API

חכירה של שרת srp (קבלה,הגדרה)

מקבלת או מגדירה את ערכי החכירה של שרת ה-SRP, במספר השניות.

פרמטרים

srp server lease [min-lease max-lease min-key-lease max-key-lease]

דוגמאות

srp server lease 1800 7200 86400 1209600
Done
srp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Done

הפניות CLI ו-API

בחירת פורמט לשרת srp (get,set)

מקבלת או מגדירה את מספר הרצף שבשימוש במצב כתובת anycast. מספר הרצף נכלל ברשומת "כתובת Anycast של שירות DNS/SRP" שמתפרסמת בנתוני הרשת.

פרמטרים

srp server seqnum [seqnum]

דוגמאות

srp server seqnum 20
Done
srp server seqnum
20
Done

הפניות CLI ו-API

שירות שרת srp

מחזירה מידע על שירותים רשומים.

הרשומה TXT מוצגת כמערך של רשומות. אם רשומה מכילה מפתח, המפתח מודפס בפורמט ASCII. החלק של הערך מודפס בבייטים הקסדצימליים. מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp server service
srp-api-test-1._ipps._tcp.default.service.arpa.
    deleted: false
    subtypes: (null)
    port: 49152
    priority: 0
    weight: 0
    ttl: 7200
    lease: 7200
    key-lease: 1209600
    TXT: [616263, xyz=585960]
    host: srp-api-test-1.default.service.arpa.
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0._ipps._tcp.default.service.arpa.
    deleted: false
    subtypes: _sub1,_sub2
    port: 49152
    priority: 0
    weight: 0
    ttl: 3600
    lease: 3600
    key-lease: 1209600
    TXT: [616263, xyz=585960]
    host: srp-api-test-0.default.service.arpa.
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done

הפניות CLI ו-API

המצב של שרת srp

הפונקציה מחזירה את אחד מהמצבים האפשריים הבאים של שרת ה-SRP:

  • disabled: שרת ה-SRP לא מופעל.
  • stopped: שרת ה-SRP מופעל אך אינו פעיל בגלל שרתי SRP קיימים שכבר פעילים ברשת Thread. שרת ה-SRP עשוי להיות פעיל כששרתי ה-SRP הקיימים לא פעילים יותר ברשת Thread.
  • running: שרת ה-SRP פעיל ויכול לטפל ברישומי שירותים.

מידע נוסף זמין במאמר הגדרת קישוריות שרת-לקוח (SRP) עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp server state
running
Done

הפניות CLI ו-API

state

מחזירה את התפקיד הנוכחי של מכשיר ה-thread או משנה את התפקיד כפי שצוין באחת מהאפשרויות. הערכים האפשריים שהוחזרו בעת בדיקת תפקיד המכשיר:

  • child: המכשיר פועל כרגע כצאצא של פרוטוקול Thread.
  • router: המכשיר פועל כרגע כנתב Thread.
  • leader: המכשיר פועל כרגע כמנהיג Thread.
  • detached: המכשיר לא משתתף כרגע ברשת/מחיצה של Thread.
  • disabled: ערימת השרשורים מושבתת כרגע.

שימוש באחת מהאפשרויות יאפשר לך לשנות את התפקיד הנוכחי של מכשיר, מלבד מעבר למצב disabled או שינוי ממנו.

פרמטרים

state [child|router|leader|detached]

דוגמאות

state
child
Done
state leader
Done

הפניות CLI ו-API

ביטול tcp

מסיים באופן לא טקסי את חיבור ה-TCP המשויך לנקודת הקצה של TCP לדוגמה, ומעביר את נקודת הקצה של TCP למצב סגור.

פרמטרים

אין פרמטרים.

דוגמאות

tcp abort
TCP: Connection reset
Done

הפניות CLI ו-API

התוצאה של נקודת ההשוואה ל-tcp

הצגת התוצאה האחרונה של בדיקת ההשוואה לשוק של TCP. ערכי סטטוס אפשריים:

  • מתמשך
  • הושלם
  • לא נבדקה

פקודה זו מיועדת בעיקר ליצירת סקריפטים שמבצעים אוטומציה של בדיקת נקודת ההשוואה של TCP.

פרמטרים

אין פרמטרים.

דוגמאות

tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s

הפניות CLI ו-API

  • אין API משויך

הפעלת נקודת השוואה לנקודת רייטינג בקהל היעד (tcp)

מעביר את מספר הבייטים שצוין באמצעות חיבור TCP שמשויך כרגע לנקודת הקצה של TCP לדוגמה שסופקה על ידי ה-CLI של tcp.

פרמטרים

tcp benchmark run [size]

השתמשו בפרמטר size כדי לציין את מספר הבייטים שיש לשלוח עבור נקודת ההשוואה. אם לא תשתמשו בפרמטר size, המערכת תשתמש בערך ברירת המחדל (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE).

דוגמאות

tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s

הפניות CLI ו-API

  • אין API משויך

קישור tcp

משייך כתובת IPv6 ויציאה לנקודת הקצה לדוגמה של TCP שסופקה על ידי ה-CLI של tcp. שיוך של נקודת הקצה של TCP לכתובת וליציאה של IPv6 נקרא 'מתן שם לנקודת הקצה של TCP'. כך מקשרים את נקודת הקצה לתקשורת. מידע נוסף זמין במאמר בדיקת פונקציונליות של TCP באמצעות OT CLI.

פרמטרים

tcp bind ip port
  • ip: כתובת IPv6 לאגד אליה. אם ברצונך שהמחסנית TCP/IPv6 תקצה כתובת IPv6 לקישור, צריך להשתמש בכתובת IPv6 שלא צוינה: ::.
  • port: מספר יציאת ה-TCP שאליו צריך לקשר.

דוגמאות

tcp bind :: 30000
Done

הפניות CLI ו-API

tcp Connect

יוצר חיבור עם העמית שצוין.

אם יצירת החיבור מצליחה, חיבור ה-TCP שמתקבל משויך לנקודת הקצה של TCP לדוגמה. מידע נוסף זמין במאמר בדיקת פונקציונליות של TCP באמצעות OT CLI.

פרמטרים

tcp connect ip port [fastopen]
  • ip: כתובת ה-IP של הרשת השכנה. הכתובת יכולה להיות כתובת IPv4, שסונתזת לכתובת IPv6 באמצעות קידומת NAT64 המועדפת מנתוני הרשת. הפקודה תחזיר InvalidState כשהקידומת המועדפת NAT64 לא זמינה.
  • port: מספר יציאת ה-TCP של הרשת השכנה.
  • fastopen: הפרמטר הזה הוא אופציונלי. אם המדיניות מוגדרת לערך fast, האפשרות 'פתיחה מהירה של TCP' מופעלת בחיבור הזה. אחרת, אם הפרמטר הזה מוגדר לערך slow או לא נמצא בשימוש, התכונה 'פתיחה מהירה של TCP' מושבתת.

דוגמאות

tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established
tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

הפניות CLI ו-API

tcp deinit

מאתחל את נקודת הקצה של TCP הזו.

המשמעות היא ש-OpenThread לא עוקב יותר אחרי נקודת הקצה הזו של TCP ומקצה את כל המשאבים שהיא הקצתה באופן פנימי לנקודת הקצה הזו ב-TCP. האפליקציה יכולה לעשות שימוש חוזר בזיכרון שמגבה את נקודת הקצה של TCP לפי הצורך.

אם החיבור תואם לחיבור TCP פעיל, החיבור מסתיים באופן לא טקסי (כמו ב-otTcpAbort()). כל המשאבים שהאפליקציה סיפקה לנקודת הקצה הזו של TCP (מאגרי אחסון מקושרים למאגר הנתונים הזמני לשליחה, זיכרון למאגר הנתונים הזמני בקבלה, המבנה של aEndpoint עצמו וכו') מוחזרים מיד לאפליקציה.

פרמטרים

אין פרמטרים.

דוגמאות

tcp deinit
Done

הפניות CLI ו-API

אתחול tcp

מפעיל את סורק ה-TCP לדוגמה ואת נקודת הקצה לדוגמה של TCP שסופקו על ידי ה-CLI של tcp.

פרמטרים

tcp init [mode] [size]
  • למאפיין mode יש שלושה ערכים אפשריים:
    • tls: המדיניות קובעת שחיבור ה-TCP בין שני הצמתים צריך גם להשתמש בפרוטוקול TLS מעל TCP. כששני צמתים מתקשרים ב-TCP, שני הצמתים צריכים להשתמש ב-TLS, או אף אחד מהצמתים לא יכול להשתמש ב-TLS, כי נקודת קצה שאינה TLS לא יכולה לתקשר עם נקודת קצה (endpoint) של TLS.
    • linked או circular: המשמעות של אחת מהאפשרויות האלה היא שלא ניתן להשתמש ב-TLS, ושצריך להשתמש בסוג אגירת הנתונים שצוין לצורך אגירת נתונים של TCP. ההתנהגות של linked ושל circular זהה. בוחנים את הקוד כדי לבדוק את ההבדלים בין שני הסוגים האלה של אגירת נתונים. שתי נקודות קצה של חיבור TCP לא נדרשות להשתמש באותו סוג של אחסון זמני.
  • הפרמטר size מגדיר את גודל מאגר הנתונים הזמני לקבל לשיוך אל נקודת הקצה של TCP לדוגמה. אם לא צוין הגודל המקסימלי, ייעשה שימוש בגודל המקסימלי. הגודל המקסימלי מוגדר ב-OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE.

דוגמאות

tcp init tls
Done

הפניות CLI ו-API

האזנה ל-tcp

שימוש בדוגמה של מעבד TCP כדי להאזין לחיבורים נכנסים בכתובת IPv6 וביציאה שצוינו. מידע נוסף זמין במאמר בדיקת פונקציונליות של TCP באמצעות OT CLI.

פרמטרים

tcp listen ip port

הפרמטרים הבאים נדרשים:

  • ip: כתובת IPv6 או כתובת IPv6 שלא צוינה (::) של האזנה ל-TCP לדוגמה שסופקה על ידי ה-CLI של tcp.
  • port: יציאת TCP של האזנה ל-TCP לדוגמה. אם לא משויך חיבור TCP לנקודת הקצה לדוגמה של TCP, כל החיבורים הנכנסים שתואמים לכתובת ה-IPv6 וליציאה שצוינו יתקבלו ומשויכים לנקודת הקצה של TCP לדוגמה.

דוגמאות

tcp listen :: 30000
Done

הפניות CLI ו-API

שליחת tcp

שליחת נתונים דרך חיבור TCP שמשויך לנקודת הקצה של TCP לדוגמה שסופקה עם ה-CLI tcp. מידע נוסף זמין במאמר בדיקת פונקציונליות של TCP באמצעות OT CLI.

פרמטרים

tcp send message

הפרמטר message מכיל את ההודעה שרוצים לשלוח לנקודת הקצה של TCP המרוחק.

דוגמאות

tcp send hello
Done

הפניות CLI ו-API

  • אין API משויך

שליחה ל-tcp

שליחת האות 'סיום השידור' דרך חיבור TCP שמשויך לנקודת הקצה לדוגמה של TCP שסופקה על ידי ה-CLI tcp. אפליקציה זו שולחת התראה לעמית על כך שלא יקבל נתונים נוספים בחיבור ה-TCP הזה.

פרמטרים

אין פרמטרים.

דוגמאות

tcp sendend
Done

הפניות CLI ו-API

עצירת tcp

מורה למאזין ה-TCP לדוגמה להפסיק להאזין לחיבורי TCP נכנסים.

פרמטרים

אין פרמטרים.

דוגמאות

tcp stoplistening
Done

הפניות CLI ו-API

התחלת שרשור

התחלת הפעולה של פרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

thread start
Done

הפניות CLI ו-API

עצירת שרשור

הפסקת הפעולה של פרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

thread stop
Done

הפניות CLI ו-API

  • אין API משויך

גרסת שרשור

לקבלת הגרסה של פרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

 thread version
2
Done

הפניות CLI ו-API

מקסימום זמן בתור

קבלת הזמן המרבי לתור להודעות ב-TX.

נדרש OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

המעקב אחר זמן ההמתנה לתור מתבצע רק בשידורים ישירים, ונמדד כמשך הזמן שחולף מהרגע שבו הודעה מתווספת לתור השידור ועד שהיא מועברת לשכבת ה-MAC בשידור או מוסרת.

ניתן לאפס את הנתונים הסטטיסטיים שנאספו על ידי קריאה ל- otThreadResetTimeInQueueStat() .

פרמטרים

אין פרמטרים.

דוגמאות

timeinqueue max
281
Done

הפניות CLI ו-API

איפוס תור הזמן

איפוס הנתונים הסטטיסטיים של תור ב-TX.

נדרש OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

timeinqueue reset
Done

הפניות CLI ו-API

תור זמן

קבלת ההיסטוגרמה של 'זמן לתור' עבור הודעות בתור ב-TX.

נדרש OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

נאספת ההיסטוגרמה של תור ההודעות בתור לשידור. המעקב אחר זמן ההמתנה לתור מתבצע רק בשידורים ישירים, ונמדד כמשך הזמן שחולף מהרגע שבו הודעה מתווספת לתור השידור ועד שהיא מועברת לשכבת ה-MAC בשידור או מוסרת.

ההיסטוגרמה מוחזרת כמערך של ערכי uint32_t עם רשומות aNumBins. הרשומה הראשונה במערך (באינדקס 0) מייצגת את מספר ההודעות שזמן ההמתנה לתור קטן מ-aBinInterval. הרשומה השנייה מייצגת את מספר ההודעות שהזמן שלהן בתור גדול מ-aBinInterval או שווה לו, אבל קטן מ-2 * aBinInterval. וכן הלאה. הרשומה האחרונה מייצגת את מספר ההודעות שהזמן שלהן בתור גדול מ-(aNumBins - 1) * aBinInterval או שווה לו.

ניתן לאפס את הנתונים הסטטיסטיים שנאספו על ידי קריאה ל- otThreadResetTimeInQueueStat() . נתוני ההיסטוגרמה נאספים מאז שהמופע של OpenThread אותחל, או מאז הפעם האחרונה שבה אוסף הנתונים הסטטיסטיים אופס על ידי קריאה ל- otThreadResetTimeInQueueStat() .

הערך של המצביע aNumBins ו-aBinInterval לא יכול להיות NULL.

פרמטרים

אין פרמטרים.

דוגמאות

timeinqueue
| Min  | Max  |Msg Count|
+------+------+---------+
|    0 |    9 |    1537 |
|   10 |   19 |     156 |
|   20 |   29 |      57 |
|   30 |   39 |     108 |
|   40 |   49 |      60 |
|   50 |   59 |      76 |
|   60 |   69 |      88 |
|   70 |   79 |      51 |
|   80 |   89 |      86 |
|   90 |   99 |      45 |
|  100 |  109 |      43 |
|  110 |  119 |      44 |
|  120 |  129 |      38 |
|  130 |  139 |      44 |
|  140 |  149 |      35 |
|  150 |  159 |      41 |
|  160 |  169 |      34 |
|  170 |  179 |      13 |
|  180 |  189 |      24 |
|  190 |  199 |       3 |
|  200 |  209 |       0 |
|  210 |  219 |       0 |
|  220 |  229 |       2 |
|  230 |  239 |       0 |
|  240 |  249 |       0 |
|  250 |  259 |       0 |
|  260 |  269 |       0 |
|  270 |  279 |       0 |
|  280 |  289 |       0 |
|  290 |  299 |       1 |
|  300 |  309 |       0 |
|  310 |  319 |       0 |
|  320 |  329 |       0 |
|  330 |  339 |       0 |
|  340 |  349 |       0 |
|  350 |  359 |       0 |
|  360 |  369 |       0 |
|  370 |  379 |       0 |
|  380 |  389 |       0 |
|  390 |  399 |       0 |
|  400 |  409 |       0 |
|  410 |  419 |       0 |
|  420 |  429 |       0 |
|  430 |  439 |       0 |
|  440 |  449 |       0 |
|  450 |  459 |       0 |
|  460 |  469 |       0 |
|  470 |  479 |       0 |
|  480 |  489 |       0 |
|  490 |  inf |       0 |
Done

הפניות CLI ו-API

טרל (הפעלה,השבתה)

מפעילה או משביתה את פעולת הרדיו TREL.

פרמטרים

trel enable|disable

דוגמאות

trel enable
Done
trel disable
Done

הפניות CLI ו-API

מוני טרל אופסו

איפוס מוני TREL.

פרמטרים

אין פרמטרים.

דוגמאות

trel counters reset
Done

הפניות CLI ו-API

מוני טרל

מקבל את מוני TREL.

פרמטרים

אין פרמטרים.

דוגמאות

trel counters
Inbound:  Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done

הפניות CLI ו-API

מסנן טרל (הפעלה,השבתה)

מפעילה או משביתה מצב סינון של TREL.

פרמטרים

trel filter enable|disable

דוגמאות

trel filter enable
Done
trel filter disable
Done

הפניות CLI ו-API

פילטר טרל

התנאי מציין אם מצב הסינון של TREL מופעל.

כשמצב הסינון מופעל, כל התנועה באמצעות Rx ו-Tx שנשלחת דרך ממשק ה-TREL מוסרת באופן שקט.

פרמטרים

אין פרמטרים.

דוגמאות

trel filter
Disabled
Done

הפניות CLI ו-API

אפליקציות טרל

קבלת טבלת האפליקציות להשוואה ב-TREL בפורמט של טבלה או רשימה.

פרמטרים

trel peers [list]

דוגמאות

trel peers
| No  | Ext MAC Address  | Ext PAN Id       | IPv6 Socket Address                              |
+-----+------------------+------------------+--------------------------------------------------+
|   1 | 5e5785ba3a63adb9 | f0d9c001f00d2e43 | [fe80:0:0:0:cc79:2a29:d311:1aea]:9202            |
|   2 | ce792a29d3111aea | dead00beef00cafe | [fe80:0:0:0:5c57:85ba:3a63:adb9]:9203            |
Done
trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done

הפניות CLI ו-API

טרל

מציין אם פעולת TREL מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

trel
Enabled
Done

הפניות CLI ו-API

tvcheck (הפעלה,השבתה)

המדיניות מפעילה או משביתה את בדיקת הגרסה של פרוטוקול Thread כשמשדרגים לנתב או למנהיג. הבדיקה הזו מופעלת כברירת מחדל.

פרמטרים

אין פרמטרים.

דוגמאות

tvcheck enable
Done
tvcheck disable
Done

הפניות CLI ו-API

txpower (קבל,הגדר)

הפונקציה מקבלת (או מגדירה באמצעות שימוש בארגומנט האופציונלי txpower) את עוצמת השידור ב-dBm.

פרמטרים

txpower [txpower]

דוגמאות

txpower -10
Done
txpower
-10 dBm
Done

הפניות CLI ו-API

קישור udp

הקצאה של כתובת IPv6 ויציאה לשקע פתוח, כדי לחבר את השקע לתקשורת. הקצאת כתובת ויציאה של IPv6 נקראת מתן שם לשקע. מידע נוסף זמין במאמר בדיקת פונקציונליות של UDP באמצעות OT CLI.

פרמטרים

udp bind [netif] ip port
  • netif: ממשק הרשת המקשר, שנקבע כך:
    • אין ערך (ללא פרמטר זה מהפקודה): נעשה שימוש בממשק של רשת שרשורים.
    • -u: ממשק רשת שלא צוין, כלומר מחסנית UDP/IPv6 קובעת לאיזה ממשק רשת לאגד את השקע.
    • -b: נעשה שימוש בממשק של רשת השדרה (Backbone).
  • ip: כתובת IPv6 לאגד אליה. אם ברצונך שהמחסנית UDP/IPv6 תקצה כתובת IPv6 לקישור, אפשר להשתמש בערך הבא כדי להשתמש בכתובת IPv6 שלא צוינה: ::. כל דוגמה משתמשת בכתובת IPv6 שלא צוינה.
  • port: מספר יציאת UDP לקישור. בכל אחת מהדוגמאות נעשה שימוש ביציאה מספר 1234.

דוגמאות

udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done

הפניות CLI ו-API

סגירת udp

סגירת שקע UDP/IPv6.

פרמטרים

אין פרמטרים.

דוגמאות

udp close
Done

הפניות CLI ו-API

udp connect (חיבור udp)

מחברים שקע UDP/IPv6.

פרמטרים

udp connect ip port

הפרמטרים הבאים נדרשים:

  • ip: כתובת ה-IP של האפליקציה להשוואה.
  • port: מספר יציאת ה-UDP של האפליקציה להשוואה. הכתובת יכולה להיות כתובת IPv4, שמוזנת לכתובת IPv6 באמצעות קידומת NAT64 המועדפת מנתוני הרשת. הפקודה תחזיר InvalidState כשהקידומת המועדפת NAT64 לא זמינה.

דוגמאות

udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done
udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

הפניות CLI ו-API

udp linksecurity (הפעלה,השבתה)

מפעילה או משביתה אבטחת קישורים.

פרמטרים

אין פרמטרים.

דוגמאות

udp linksecurity enable
Done
udp linksecurity disable
Done

הפניות CLI ו-API

  • אין API משויך

אבטחת קישורים ב-udp

התנאי מציין אם אבטחת קישורים מופעלת או מושבתת.

פרמטרים

אין פרמטרים.

דוגמאות

udp linksecurity
Enabled
Done

הפניות CLI ו-API

  • אין API משויך

udp פתוח

פותחים שקע UDP/IPv6.

פרמטרים

אין פרמטרים.

דוגמאות

udp open
Done

הפניות CLI ו-API

שליחת udp

שליחה של הודעת UDP באמצעות השקע. מידע נוסף זמין במאמר בדיקת פונקציונליות של UDP באמצעות OT CLI.

פרמטרים

udp send [ip port] [type] value

הערכים ip ו-port הם אופציונליים כצמד, אבל אם מציינים אחד מהם, חובה לציין את השני. אם לא מציינים ip ו-port, נעשה שימוש בכתובת השכנה של השקע מ-udp connect.

  • ip: כתובת היעד. הכתובת הזו יכולה להיות כתובת IPv4 או IPv6; כתובת IPv4 עוברת מסנתז לכתובת IPv6 עם קידומת NAT64 המועדפת מנתוני הרשת. (אם קידומת NAT64 המועדפת לא זמינה, הפקודה תחזיר InvalidState).
  • port: יציאת יעד UDP.
  • type/value שילובים:
    • -t: המטען הייעודי (payload) בפרמטר value מטופל כטקסט. אם לא מזינים ערך של type, המטען הייעודי (payload) בפרמטר value יטופל גם הוא כטקסט.
    • -s: מטען ייעודי (payload) שנוצר באופן אוטומטי, באורך שצוין בפרמטר value.
    • -x: נתונים בינאריים בייצוג הקסדצימלי הנתונים בפרמטר value.

דוגמאות

udp send hello
Done
udp send -t hello
Done
udp send -x 68656c6c6f
Done
udp send -s 800
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done

הפניות CLI ו-API

גיגה לא מאובטחת

רשימה של כל היציאות מרשימת היציאות הלא מאובטחות המותרות.

פרמטרים

אין פרמטרים.

דוגמאות

unsecure get
1234
Done

הפניות CLI ו-API

הוספה ב-unsecureport

הוספה של יציאה לרשימת היציאות הלא מאובטחות המורשות.

פרמטרים

unsecureport add port

דוגמאות

unsecureport add 1234
Done

הפניות CLI ו-API

הסרה לא מאובטחת

הסרה של יציאה ספציפית או של כל היציאות מרשימת היציאות הלא מאובטחות המותרות.

פרמטרים

unsecureport remove port|all

דוגמאות

unsecureport remove 1234
Done
unsecureport remove all
Done

הפניות CLI ו-API

זמן פעולה תקינה באלפיות השנייה

מחזירה את זמן הפעולה התקינה הנוכחי של המכונה (במילי-שניות).

צריך להפעיל את OPENTHREAD_CONFIG_UPTIME_ENABLE.

זמן הפעולה התקינה מחושב כמספר אלפיות השנייה מאז אתחול המופע של OpenThread.

פרמטרים

אין פרמטרים.

דוגמאות

uptime ms
426238
Done

הפניות CLI ו-API

זמן פעולה תקינה

מחזירה את זמן הפעולה התקינה של המכונה הנוכחית כמחרוזת שאנשים יכולים לקרוא.

צריך להפעיל את OPENTHREAD_CONFIG_UPTIME_ENABLE.

המחרוזת מופיעה בפורמט "::." לציון שעות, דקות, שניות ואלפיות השנייה (אם זמן הפעולה התקינה קצר מיום אחד) או "

ד.::." (אם יותר מיום אחד).

אם המחרוזת שתתקבל לא מתאימה למחרוזת aBuffer (ב-aSize התווים שלה), המחרוזת תיחתך אבל מחרוזת הפלט תמיד תהיה ריקה.

פרמטרים

אין פרמטרים.

דוגמאות

uptime
12:46:35.469
Done

הפניות CLI ו-API

appurl של הספק (קבוצה)

מגדירים את מחרוזת כתובת ה-URL של אפליקציית הספק.

נדרש OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorAppUrl צריך להיות UTF8 עם אורך מקסימלי של 64 תווים (MAX_VENDOR_APPL_URL_TLV_LENGTH). האורך המקסימלי לא כולל את התו \0 ריק.

פרמטרים

vendor appurl url

דוגמאות

vendor appurl http://www.example.com
Done

הפניות CLI ו-API

כתובת ה-URL של הספק

משיגים את מחרוזת כתובת ה-URL של אפליקציית הספק.

פרמטרים

אין פרמטרים.

דוגמאות

vendor appurl
http://www.example.com
Done

הפניות CLI ו-API

מודל ספק (קבוצה)

מגדירים את המחרוזת של מודל הספק.

נדרש OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorModel צריך להיות UTF8 עם אורך מקסימלי של 32 תווים (MAX_VENDOR_MODEL_TLV_LENGTH). האורך המקסימלי לא כולל את התו \0 ריק.

פרמטרים

vendor model name

דוגמאות

vendor model Hub\ Max
Done

הפניות CLI ו-API

מודל ספק

מקבלים את המחרוזת של מודל הספק.

פרמטרים

אין פרמטרים.

דוגמאות

vendor model
Hub Max
Done

הפניות CLI ו-API

שם הספק (קבוצה)

מגדירים את המחרוזת של שם הספק.

נדרש OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorName צריך להיות UTF8 עם אורך מקסימלי של 32 תווים (MAX_VENDOR_NAME_TLV_LENGTH). האורך המקסימלי לא כולל את התו \0 ריק.

פרמטרים

vendor name name

דוגמאות

vendor name nest
Done

הפניות CLI ו-API

שם הספק

מוצאים את המחרוזת של שם הספק.

פרמטרים

אין פרמטרים.

דוגמאות

vendor name
nest
Done

הפניות CLI ו-API

שינוי ספק (set)

מגדירים את המחרוזת של גרסת התוכנה של הספק.

נדרש OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorSwVersion צריך להיות UTF8 עם אורך מקסימלי של 16 תווים(MAX_VENDOR_SW_VERSION_TLV_LENGTH). האורך המקסימלי לא כולל את התו \0 ריק.

פרמטרים

vendor swversion version

דוגמאות

vendor swversion Marble3.5.1
Done

הפניות CLI ו-API

החלפת ספק

משיגים את המחרוזת של גרסת התוכנה של הספק.

פרמטרים

אין פרמטרים.

דוגמאות

vendor swversion
Marble3.5.1
Done

הפניות CLI ו-API

verhoeff חישוב

מחשבת את סיכום הביקורת של Verhoeff עבור מחרוזת עשרונית נתונה.

נדרש OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

פרמטרים

verhoeff calculate decimalstring

דוגמאות

verhoeff calculate 30731842
1
Done

הפניות CLI ו-API

אימות verhoeff

מאמת את סיכום הביקורת של Verhoeff עבור מחרוזת עשרונית נתונה.

נדרש OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

פרמטרים

verhoeff validate decimalstring

דוגמאות

verhoeff validate 307318421
Done

הפניות CLI ו-API

גרסה API

מדפיס את מספר הגרסה של ה-API.

פרמטרים

אין פרמטרים.

דוגמאות

version api
28
Done

הפניות CLI ו-API

  • אין API משויך

גרסה

קבלת מחרוזת הגרסה של OpenThread.

פרמטרים

אין פרמטרים.

דוגמאות

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done

הפניות CLI ו-API