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
Kidsrouterlinks (get,set)
הפונקציה מקבלת או מגדירה את הערך 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
: 3ack_random_factor_denominator
: 2max_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
: מסיכת ביט שמזהה ערוצים לשליחת הודעות MLEAnnounce
.count
: מספר העברות MLEAnnounce
לכל ערוץ.period
: מספר אלפיות השנייה בין העברות MLEAnnounce
רצופות.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
- otDatasetSendMgmtActiveGet
- dataset mgmtgetcommand בהמתנה
- dataset mgmtsetcommand active
- dataset mgmtsetcommand בהמתנה
מערך הנתונים 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
- otDatasetSendMgmtPendingGet
- dataset mgmtgetcommand active
- dataset mgmtsetcommand active
- dataset mgmtsetcommand בהמתנה
מערך נתונים 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
- otDatasetSendMgmtActiveSet
- dataset mgmtgetcommand active
- dataset mgmtgetcommand בהמתנה
- dataset mgmtsetcommand בהמתנה
מערך הנתונים 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
- otDatasetSendMgmtPendingSet
- dataset mgmtgetcommand active
- dataset mgmtgetcommand בהמתנה
- dataset mgmtsetcommand active
מפתח רשת של מערך נתונים (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]]
- צריך להשתמש בפונקציה
rotationtime
עבורthrKeyRotation
, ביחידות של שעות. - פקודות של מדיניות האבטחה משתמשות במיפויי הארגומנטים
onrcCepR
כדי לקבל ולהגדיר חברים ב-otSecurityPolicy. לדוגמה,o
מייצג את otSecurityPolicy::mObtainNetworkKeyEnabled. מידע נוסף זמין במאמר הצגה וניהול של מערכי נתונים באמצעות OT CLI.
דוגמאות
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-idled
: התקן פרוטוקול Threadn
: נתוני רשת מלאים
- 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-idled
: התקן פרוטוקול Threadn
: נתוני רשת מלאים
- 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).
- סוג ההודעה של IPv6, למשל
- 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).
- סוג ההודעה של IPv6, למשל
- 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).
- סוג ההודעה של IPv6, למשל
- 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
: מזהי נתב שאליהם יש לנתב הזה קישור נכנס באיכות קישור 32-links
: מזהי נתב שאליו יש לנתב הזה קישור נכנס באיכות קישור 21-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-idled
: התקן פרוטוקול Threadn
: נתוני רשת מלאים
דוגמאות
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
: מכשיר עם פרוטוקול ThreadN
: נתוני רשת מלאים
פרמטרים
אין פרמטרים.
דוגמאות
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)
- netdata publish dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
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)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicast
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 publish dnssrp unicast (addr,port)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
קידומת פרסום 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 מורחבת TLV1
: כתובת16 TLV2
: מצב TLV3
: זמן קצוב לתפוגה של TLV (תקופת הזמן המקסימלית לתשאול עבור SED)4
: קישוריות TLV5
: כביש 64 TLV6
: נתוני Leader Data TLV7
: TLV של נתוני רשת8
: TLV של רשימת כתובות IPv69
: מוני MAC TLV14
: רמת הטעינה של הסוללה TLV15
: מתח אספקה TLV16
: מודעת TLV לילדים17
: דפי ערוץ TLV19
: זמן קצוב לתפוגה של מספר מקסימלי של צאצאים23
: EUI64 TLV24
: גרסה TLV (מספר גרסה של הפרוטוקולים והתכונות)25
: שם הספק TLV26
: מודל ספק TLV27
: גרסת SW של ספק TLV28
: TLV של גרסת Thread Stack (מזהה גרסה כמחרוזת UTF-8 עבור קודbase/commit/version של Thread)29
: TLV של ילדים34
: מוני MLE TLV35
: כתובת ה-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, והן מועדפות בסדר הבא:
- רשומות Unicast שבהן כתובת השרת כלולה בנתוני השירות. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.
- רשומות Anycast שלכל אחת מהן יש מספר רצף. עדיף להשתמש במספר הרצף הגדול ביותר כפי שצוין על ידי המספר הסידורי Arithmetic Logic ב-RFC-1982.
- רשומות 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 המועדפות ל-threadnetif
, מלבד כתובות link-local וכתובות רשת מקומיות. אם אין כתובת חוקית, כתובת ה-EID המקומית ברשת תתווסף. אם כתובות ב-threadnetif
מתווספות או מוסרות, או אם הן מסומנות כלא מועדפות, לקוח ה-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
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
המצב של שרת 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
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
ביטול 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