ba Ehemeralkey
מציין אם מפתח זמני פעיל כרגע.
נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.
פרמטרים
אין פרמטרים.
דוגמאות
ba ephemeralkey
active
Doneהפניית CLI ו-API
ba ephemeralkey 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
בהמה זמנית צלול
ביטול המפתח הזמני שנמצא בשימוש.
נדרש 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.
אפשר להגדיר את המפתח הזמני כשסוכן הגבול כבר פועל ולא מחובר כרגע לנציבות חיצונית כלשהי (כלומר, הוא במצב OT_BORDER_AGENT_STATE_STARTED). אחרת, מוחזר OT_ERROR_INVALID_STATE.
הערך של aKeyString הנתון משמש ישירות בתור ה-PSK הזמני (לא כולל תו \0 ה-null בסוף). האורך של 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)
הפונקציה מקבלת או מגדירה את המזהה של נתב גבול (Border Router) באורך 16 בייטים, שיכול לזהות את המכשיר באופן ייחודי בין כמה מספרי BR.
פרמטרים
ba id [border-agent-id]
משתמשים בארגומנט האופציונלי border-agent-id כדי להגדיר את מזהה סוכן הגבול.
דוגמאות
ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Doneba id 00112233445566778899aabbccddeeff
Doneהפניית CLI ו-API
ba Port
מקבלת את יציאת ה-UDP של שירות Thread Border Agent.
פרמטרים
אין פרמטרים.
דוגמאות
ba port
49153
Doneהפניית CLI ו-API
BA
הפונקציה מקבלת את 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
Donebbr
BBR Primary: None
Doneהפניית CLI ו-API
- אין ממשק API משויך
bbr config (מוגדר)
מגדיר את התצורה המקומית של נתב Backbone RouterConfig otBackboneRouterConfig.
הודעה SRV_DATA.ntf של בקשה לנתוני שרת מופעלת באופן אוטומטי אם מערך הנתונים של BBR משתנה עבור נתב עמוד שדרה ראשי.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
צריך להנפיק את bbr register באופן מפורש כדי לרשום שירות נתב Backbone ל-Leader for Secondary Rebone Router.
פרמטרים
bbr config [seqno seqno] [delay delay] [timeout timeout]
דוגמאות
bbr config seqno 20 delay 30
Doneהפניית CLI ו-API
הגדרת bbr
קבלת התצורה המקומית של נתב עמוד שדרה.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
פרמטרים
אין פרמטרים.
דוגמאות
bbr config
seqno: 10
delay: 120 secs
timeout: 300 secs
Doneהפניית CLI ו-API
השבתת BBR
המתג מפעיל או משבית את הפונקציונליות של Backbone.
אם ההגדרה הזו מופעלת, ההודעה SRV_DATA.ntf של בקשת נתוני השרת תופעל עבור המכשיר המחובר אם אין שירות נתב Backbone בנתוני רשת פרוטוקול Thread.
אם המדיניות מושבתת, SRV_DATA.ntf יופעל אם נתב עמוד השדרה נמצא במצב הראשי.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
פרמטרים
אין פרמטרים.
דוגמאות
bbr disable
Doneהפניית CLI ו-API
הפעלת BBR
המתג מפעיל או משבית את הפונקציונליות של Backbone.
אם ההגדרה הזו מופעלת, ההודעה SRV_DATA.ntf של בקשת נתוני השרת תופעל עבור המכשיר המחובר אם אין שירות נתב Backbone בנתוני רשת פרוטוקול Thread.
אם המדיניות מושבתת, SRV_DATA.ntf יופעל אם נתב עמוד השדרה נמצא במצב הראשי.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
פרמטרים
אין פרמטרים.
דוגמאות
bbr enable
Doneהפניית CLI ו-API
רעידות bbr (get,set)
מקבל או מגדיר רעידות (בשניות) לצורך רישום של נתב Backbone.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
פרמטרים
bbr jitter [jitter]
דוגמאות
bbr jitter
20
Donebbr 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_PROGRESS
- 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
Donebbr mgmt dua 160
Doneהפניית CLI ו-API
bbr mgmt mlr Listener add
הפונקציה מוסיפה מאזינים של Multicast עם ערך של זמן קצוב לתפוגה, בשניות.
כדי להשתמש בברירת המחדל של הזמן הקצוב לתפוגה של MLR, צריך להעביר את הערך 0.
זמין כשהתכונות 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
Donebbr mgmt mlr listener add ff04::2 300
Doneהפניית CLI ו-API
bbr mgmt mlr Listener
הפונקציה מחזירה את פונקציות Multicast Listener עם 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.
זמין כשהתכונות 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
המדיניות הזו מגדירה את סטטוס התגובה לרישום הבא של אוזן השידור.
זמין כשהתכונות 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_CCPA
- 2: ST_MLR_INVALID
- 3: ST_MLR_NO_PERSISTENT
- 4: ST_MLR_NO_resourcesS
- 5: ST_MLR_BBR_NOT_PRIMARY
- 6: ST_MLR_GENERAL_FAILED
דוגמאות
bbr mgmt mlr response 2
Doneהפניית CLI ו-API
רישום BBR
רושם במפורש את התצורה המקומית של נתב Backbone.
הודעה על 'בקשה לנתוני שרת' SRV_DATA.ntf מופעלת במכשיר המחובר.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
פרמטרים
אין פרמטרים.
דוגמאות
bbr register
Doneהפניית CLI ו-API
מצב BBR
הוא מקבל את otBackboneRouterState של Routbone Router.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE מופעלת.
פרמטרים
אין פרמטרים.
דוגמאות
bbr state
Disabled
Donebbr state
Primary
Donebbr state
Secondary
Doneהפניית CLI ו-API
השבתה
ההגדרה משביתה את מנהל ניתוב הגבולות.
פרמטרים
אין פרמטרים.
דוגמאות
br disable
Doneהפניית CLI ו-API
br הפעלה
הפעלת מנהל ניתוב הגבולות.
פרמטרים
אין פרמטרים.
דוגמאות
br enable
Doneהפניית CLI ו-API
br init
הפעלת מנהל ניתוב הגבולות.
פרמטרים
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 nat64prefix Local
הפונקציה מקבלת את הקידומת המקומית של קידומת 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 מקומית וגם בקידומת OMR.
פרמטרים
אין פרמטרים.
דוגמאות
br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Doneהפניית CLI ו-API
br omrprefix מועדף
הפונקציה מקבלת את הקידומת המועדפת כרגע מסוג Off-Mesh-Routable (OMR).
אפשר לגלות את קידומת ה-OMR המועדפת מתוך נתוני הרשת או להיות התחילית OMR המקומית של המכשיר הזה.
פרמטרים
אין פרמטרים.
דוגמאות
br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Doneהפניית CLI ו-API
קידומת מקומית br
הפונקציה מקבלת את הקידומת המקומית של '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 מועדף
הפונקציה מקבלת את הקידומת המועדפת כרגע על קישור.
התחילית המועדפת היא קידומת שמופיעה בקישור בקישור לתשתית, או קידומת מקומית בקישור.
פרמטרים
אין פרמטרים.
דוגמאות
br onlinkprefix favored
2600::0:1234:da12::/64
Doneהפניית CLI ו-API
br onlinkprefix מקומי
מקבלת את הקידומת המקומית של 'בקישור' עבור קישור התשתית הקרוב.
קידומת מקומית על הקישור היא קידומת של 64 ביט שמתפרסמת בקישור לתשתית, אם עדיין לא מוצגת בקישור קידומת שניתן להשתמש בה בקישור.
פרמטרים
אין פרמטרים.
דוגמאות
br onlinkprefix local
fd41:2650:a6f5:0::/64
Doneהפניית CLI ו-API
br pd (הפעלה,השבתה)
הפעלה או השבתה של הענקת קידומת DHCPv6.
צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.
פרמטרים
br pd enable|disable
דוגמאות
br pd enable
Donebr pd disable
Doneהפניית CLI ו-API
br pd omrprefix
הפונקציה מקבלת את התחילית DHCPv6 Prefix Delegation (PD) שסופקה מחוץ ל-meh-routable (OMR).
בפרטי הקידומת שהוחזרה נעשה שימוש רק בשדות mPrefix, mValidLifetime ו-mPreferredLifetime.
צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.
פרמטרים
אין פרמטרים.
דוגמאות
br pd omrprefix
2001:db8:cafe:0:0/64 lifetime:1800 preferred:1800
Doneהפניית CLI ו-API
מצב PD
הפונקציה מקבלת את המצב הנוכחי של האצלת קידומת DHCPv6.
נדרשת הפעלה של OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.
פרמטרים
אין פרמטרים.
דוגמאות
br pd state
running
Doneהפניית CLI ו-API
אפליקציות להשוואה
להציג את הרשימה של מספרי ה-BR להשוואה שנמצאו ברשומות של נתוני הרשת. השדה OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE הוא שדה חובה. נקודות השוואה בין רשתות שכנות (peer BR) הן מכשירים אחרים בתוך רשת ה-Thread שמספקים קישוריות IP חיצונית. מכשיר נחשב שמספק קישוריות IP חיצונית אם לפחות אחד מהתנאים הבאים מתקיים לגבי הרשומות של נתוני הרשת שלו:
- נוספה לפחות רשומה של מסלול חיצוני אחד.
- נוספה לפחות רשומת קידומת אחת, עם סימונים של נתיב ברירת המחדל וגם סימונים ברשת.
- היא הוסיפה לפחות קידומת דומיין אחת (עם הדגלים של הדומיין ושל on-mesh). המכשיר הנוכחי לא נכלל ברשימת האפליקציות להשוואה, גם אם הוא עצמו פועל כברזיל. מידע לכל רשומת ברזיל:
- RLOC16 של ברזיל
- גיל כמרווח הזמן מאז ה-BR הזה הופיע בנתוני רשת. הוא בפורמט
{hh}:{mm}:{ss}לציון שעות, דקות ושניות, אם משך הזמן קצר מ-24 שעות. אם משך הזמן הוא 24 שעות או יותר, הפורמט הוא{dd}d.{hh}:{mm}:{ss}לימים, שעות, דקות ושניות.
פרמטרים
אין פרמטרים.
דוגמאות
br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Doneהפניית CLI ו-API
מספר האפליקציות להשוואה
הפונקציה מחזירה את מספר ה-BR (BR) של אפליקציות להשוואה שנמצאו בנתוני הרשת.
נדרש OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.
נקודות השוואה בין רשתות שכנות (peer BR) הן מכשירים אחרים בתוך רשת ה-Thread שמספקים קישוריות IP חיצונית. מכשיר נחשב שמספק קישוריות IP חיצונית אם לפחות אחד מהתנאים הבאים מתקיים לגבי הרשומות של נתוני הרשת שלו:
- נוספה לפחות רשומה של מסלול חיצוני אחד.
- נוספה לפחות רשומת קידומת אחת, עם סימונים של נתיב ברירת המחדל וגם סימונים ברשת.
- היא הוסיפה לפחות קידומת דומיין אחת (עם הדגלים של הדומיין ושל on-mesh).
המכשיר הנוכחי לא נכלל ברשימת האפליקציות להשוואה, גם אם הוא פועל כברזיל באופן ספציפי.
פרמטרים
אין פרמטרים.
דוגמאות
br peers count
2 min-age:00:00:47
Doneהפניית CLI ו-API
טבלת קידומת br
קבלת הקידומות שנמצאו על ידי Border Routing Manager בקישור לתשתית. מידע לכל רשומת קידומת:
- הקידומת
- אם התחילית היא בקישור או במסלול
- אלפיות השנייה מאז הקבלה האחרונה של פרסומת הנתב שמכילה את הקידומת הזו
- משך חיים של קידומת בשניות
- משך החיים המועדף בשניות רק אם הקידומת מופיעה בקישור
- העדפת מסלול (נמוכה, בינונית, גבוהה) רק אם הקידומת היא נתיב (לא בקישור)
- כתובת ה-IPv6 של הנתב שבה מפרסם את הקידומת הזו
- סימונים בכותרת של פרסומת הנתב שהתקבלה:
- M: דגל להגדרת כתובת מנוהלת
- O: סימון הגדרה אחרת
- לשונית: דגל Stub Router (מציין אם הנתב הוא נתב 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
Donebr 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 (גבוה,בינוני,נמוך)
מגדירה באופן מפורש את ההעדפה למסלולים המפורסמים בנתוני רשת.
אחרי קריאה לפונקציה הזו, BR תשתמש בהעדפה הנתונה. כדי לבטל את ההעדפה, אפשר להתקשר אל
otBorderRoutingClearRoutePreference()
.
פרמטרים
br routeprf [high|med|low]
דוגמאות
br routeprf low
Doneהפניית CLI ו-API
br pathprf
הפונקציה מקבלת את ההעדפה הנוכחית שבה נעשה שימוש למסלולים שפורסמו בנתוני הרשת.
ההעדפה נקבעת כך:
- אם המשתמש הוגדר במפורש על ידי קריאה ל-
otBorderRoutingSetRoutePreference(), המערכת תשתמש בהעדפה הנתונה. - אחרת, הוא נקבע באופן אוטומטי על ידי
RoutingManagerעל סמך התפקיד של המכשיר ואיכות הקישור שלו.
פרמטרים
אין פרמטרים.
דוגמאות
br routeprf
med
Doneהפניית CLI ו-API
br pathprf ברור
ניקוי ערך העדפה שהוגדר בעבר למסלולים שפורסמו בנתוני רשת.
אחרי ביצוע קריאה לפונקציה הזו, המערכת של BR תקבע את ההעדפה באופן אוטומטי על סמך התפקיד של המכשיר ואיכות הקישור שלו (להורה כאשר הוא פועל כמכשיר קצה).
פרמטרים
אין פרמטרים.
דוגמאות
br routeprf clear
Doneהפניית CLI ו-API
נתבים br
בקישור לתשתית, אפשר לקבל רשימה של נתבים שזוהו לפי Border Routing Manager. מידע לכל נתב:
- כתובת ה-IPv6 של הנתב
- סימונים בכותרת של פרסומת הנתב שהתקבלה:
- M: דגל להגדרת כתובת מנוהלת
- O: סימון הגדרה אחרת
- לשונית: דגל Stub Router (מציין אם הנתב הוא נתב stub)
- אלפיות השנייה מאז קבלת ההודעה האחרונה מהנתב הזה
- סימון יכולת ההגעה (reachability): הנתב מסומן כלא נגיש אם הוא לא מגיב למספר בקשות לבדיקת שכנות.
- גיל: משך הזמן מאז הנתב הזה התגלה לראשונה. הוא בפורמט
{hh}:{mm}:{ss}לציון שעות, דקות ושניות, אם משך הזמן קצר מ-24 שעות. אם משך הזמן הוא 24 שעות או יותר, הפורמט הוא{dd}d.{hh}:{mm}:{ss}לימים, שעות, דקות ושניות. - הערך
(this BR)מצורף כשהנתב הוא המכשיר המקומי עצמו. - הערך
(peer BR)מצורף כשסביר להניח שהנתב עשוי לחבר BR שמחובר לאותה רשת Thread. לשם כך נדרשOPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.
פרמטרים
אין פרמטרים.
דוגמאות
br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Doneהפניית CLI ו-API
מצב br
קבלת המצב הנוכחי של מנהל ניתוב הגבולות.
פרמטרים
אין פרמטרים.
דוגמאות
br state
runningהפניית CLI ו-API
bufferinfo
קבלת המידע הנוכחי של מאגר ההודעות.
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-threshold-dBm כדי להגדיר את הסף של CCA.
דוגמאות
ccathreshold
-75 dBm
Doneccathreshold -62
Doneהפניית CLI ו-API
ערוץ (get,set)
מקבל או מגדיר את ערך הערוץ של IEEE 802.15.4.
פרמטרים
channel [channel-num]
אפשר להגדיר את הערוץ באמצעות channel-num.
דוגמאות
channel
11
Donechannel 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()). השינוי בערוץ מתבצע על ידי עדכון מערך הנתונים התפעולי הממתין.
שיחה נוספת תבטל את השינוי הקיים בערוץ שביקשתם בעבר.
השדה 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 Network ברשת פרוטוקול 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
צאצא (id)
מקבלת את פרטי האבחון של ילד או ילדה שצורפו לפי מזהה הצאצא שלהם או על ידי 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
Childip
הפונקציה מקבלת רשימה של כתובות IP ששמורות עבור צאצאים של MTD.
פרמטרים
אין פרמטרים.
דוגמאות
childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Doneהפניית CLI ו-API
Babyip max (מוגדר)
הגדרה או שחזור של המספר המקסימלי של כתובות IP שכל צאצא של MTD יכול לרשום במכשיר הזה כהורה.
צריך לעבור את 0 כדי לנקות את ההגדרה ולשחזר את ברירת המחדל.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.
פרמטרים
childip max count
דוגמאות
childip max 2
Doneהפניית CLI ו-API
Babyip Max
הפונקציה מקבלת את המספר המקסימלי של כתובות IP שכל צאצא של MTD יכול לרשום במכשיר הזה כהורה.
פרמטרים
אין פרמטרים.
דוגמאות
childip max
4
Doneהפניית CLI ו-API
Kidsmax (set)
הגדרה של מספר הילדים המקסימלי המותר כרגע.
ניתן להגדיר את הפרמטר הזה רק כשהפעולה של פרוטוקול Thread הופסקה.
פרמטרים
childmax count
דוגמאות
childmax 2
Doneהפניית CLI ו-API
Kidsmax
הפונקציה מקבלת את מספר הילדים המקסימלי המותר כרגע.
פרמטרים
אין פרמטרים.
דוגמאות
childmax
5
Doneהפניית CLI ו-API
Childrenrouterlinks (get,set)
הפונקציה מקבלת או מגדירה את הערך MLE_CHILD_ROUTER_LINKS.
פרמטרים
childrouterlinks [links]
דוגמאות
childrouterlinks
16
Donechildrouterlinks 16
Doneהפניית CLI ו-API
זמן קצוב לתפוגה של פיקוח על ילדים (מוגדר)
מגדירה את הזמן הקצוב לתפוגה של בדיקת הפיקוח (בשניות) על הילד או הילדה.
פרמטרים
childsupervision checktimeout timeout-seconds
דוגמאות
childsupervision checktimeout 30
Doneהפניית CLI ו-API
זמן קצוב לתפוגה של פיקוח על ילדים
מקבלת את פרק הזמן הקצוב לתפוגה של בדיקת הפיקוח (בשניות) על הילד או הילדה.
אם המכשיר ילד מנומנם והוא לא שומע את ההורה שלו במסגרת הזמן הקצוב לתפוגה של הבדיקה, מתחיל תהליך צירוף מחדש (ההחלפה של בקשה/תגובה של MLE Child Update עם ההורה שלו).
פרמטרים
אין פרמטרים.
דוגמאות
childsupervision checktimeout
30
Doneהפניית CLI ו-API
מרווח פיקוח של ילדים (מוגדר)
מגדירה את מרווח הזמן של הפיקוח על הילד או הילדה (בשניות) על ידי הילד או הילדה.
פרמטרים
childsupervision interval interval-seconds
דוגמאות
childsupervision interval 30
Doneהפניית CLI ו-API
מרווח בין ילדים
מקבלת את מרווח הזמן של 'פיקוח ילדים' (בשניות) על ילד.
התכונה 'פיקוח על ילדים' מספקת מנגנון להורים כדי להבטיח שהודעה תישלח לכל ילד ישנוני במסגרת מרווח הפיקוח. אם הילד או הילדה לא מועברים במהלך מרווח הפיקוח, 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 שצוין.
פרמטרים
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
Donecoap 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 parameters(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
Donecoap parameters request default
Transmission parameters for request:
default
Donecoap 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
Donecoap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Doneהפניית CLI ו-API
- אין ממשק API משויך
קואפ פוט
שינוי של משאב ה-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
Donecoap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Doneהפניית CLI ו-API
- אין ממשק API משויך
משאב Coap (get,set)
הפונקציה מקבלת או מגדירה את נתיב ה-URI של משאב שרת CoAP.
פרמטרים
coap resource [uri-path]
דוגמאות
coap resource test-resource
Donecoap 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 stop
Doneהפניית CLI ו-API
Coaps Connect
מאתחלת סשן של Transport Layer Security (DTLS) ב-Datagram עם אפליקציה להשוואה. מידע נוסף זמין במאמר בדיקת הקישוריות למשאב מאובטח של פרוטוקול אפליקציה מוגבל (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 שצוין בשרת 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
Donecoaps get test-resource block-1024
Doneהפניית CLI ו-API
- אין ממשק API משויך
Coaps סגור
שדה זה מציין אם שירות 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
יצירת משאב 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) ריק. עם זאת, אם משתמשים בפרמטר של המטען הייעודי (payload), הערך שלו חייב להיות מחרוזת, למשלhellothere. אם הערך שלtypeהואblock-, הערך של הפרמטר מטען ייעודי (payload) חייב להיות מספר שלם שמציין את מספר הבלוקים שצריך לשלוח. יש להגדיר את הסוגblock-OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.
דוגמאות
coaps post test-resource con hellothere
Donecoaps 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) ריק. עם זאת, אם משתמשים בפרמטר של המטען הייעודי (payload), הערך שלו חייב להיות מחרוזת, למשלhellothere. אם הערך שלtypeהואblock-, הערך של הפרמטר מטען ייעודי (payload) חייב להיות מספר שלם שמציין את מספר הבלוקים שצריך לשלוח. יש להגדיר את הסוגblock-OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.
דוגמאות
coaps put test-resource con hellothere
Donecoaps put test-resource block-1024 10
Doneהפניית CLI ו-API
- אין ממשק API משויך
משאב Coaps (get,set)
הפונקציה מקבלת או מגדירה את נתיב ה-URI של משאב שרת CoAPS. מידע נוסף זמין במאמר בדיקת הקישוריות למשאב מאובטח של פרוטוקול אפליקציה מוגבל (CoAPS) באמצעות OT CLI.
פרמטרים
coaps resource [uri-path]
דוגמאות
coaps resource test-resource
Donecoaps 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 קובע אם הבדיקה של האישורים להשוואה מופעלת (ברירת מחדל) או מושבתת. הפרמטר 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
Donecoaps start false
Donecoaps 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: Bitmask שמזהה ערוצים לשליחת הודעותAnnounceMLE.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: Bitmask שמזהה ערוצים לביצוע סריקות אנרגיה של 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
Donecommissioner id
OpenThread Commissioner
Doneהפניית CLI ו-API
הוספת נציבות
הוספת רשומת מצטרפים (join).
פרמטרים
commissioner joiner add eui64|discerner pksd [timeout]
eui64: IEEE EUI-64 של השותף. כדי לבצע התאמה לכל איחוד, צריך להשתמש בפונקציה*.discerner: הכלי לאיחוד (join) בפורמטnumber/length.pksd: מפתח משותף מראש לאיחוד.timeout: הזמן הקצוב לתפוגה של ההצטרפות, בשניות.
דוגמאות
commissioner joiner add d45e64fa83f81cf7 J01NME
Donecommissioner joiner add 0xabc/12 J01NME
Doneהפניית CLI ו-API
הסרת נציבות הנציבות
מסירה רשומה של 'הצטרפות'.
פרמטרים
commissioner joiner remove eui64|discerner
eui64: IEEE EUI-64 של החבר. כדי לבצע התאמה לכל איחוד, צריך להשתמש בפונקציה*.discerner: הכלי לאיחוד (join) בפורמטnumber/length.
דוגמאות
commissioner joiner remove d45e64fa83f81cf7
Donecommissioner joiner remove 0xabc/12
Doneהפניית CLI ו-API
טבלת איחוד (join) של נציבים
רשימה של כל הרשומות של Joiner בפורמט של טבלה.
פרמטרים
אין פרמטרים.
דוגמאות
commissioner joiner table
| ID | PSKd | Expiration |
+-----------------------+----------------------------------+------------+
| * | J01NME | 81015 |
| d45e64fa83f81cf7 | J01NME | 101204 |
| 0x0000000000000abc/12 | J01NME | 114360 |
Doneהפניית CLI ו-API
- אין ממשק API משויך
מנהל הקהילה
שליחת הודעת MGMT_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
מנהל הקהילה
שולחת הודעת 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; Bitmask שמזהה ערוצים לביצוע סריקות פעילות של 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
התחלת נציבות
מתחיל את התפקיד 'נציב שרשורים'.
פרמטרים
אין פרמטרים.
דוגמאות
commissioner start
Commissioner: petitioning
Done
Commissioner: activeהפניית CLI ו-API
מדינת הנציב
הפונקציה מחזירה את המצב הנוכחי של הנציב. הערכים האפשריים הם active, disabled או petition (כלומר, לבקש להצטרף לנציבות).
פרמטרים
אין פרמטרים.
דוגמאות
commissioner state
active
Doneהפניית CLI ו-API
עצירת נציב
הפסקת התפקיד 'נציב שרשורים'.
פרמטרים
אין פרמטרים.
דוגמאות
commissioner stop
Doneהפניית CLI ו-API
contextreusedelay (get,set)
הפונקציה מקבלת או מגדירה את הערך של CONTEXT_ID_REUSE_DELAY.
פרמטרים
contextreusedelay delay
משתמשים בארגומנט האופציונלי delay כדי להגדיר את CONTEXT_ID_REUSE_DELAY.
דוגמאות
contextreusedelay
11
Donecontextreusedelay 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
איפוס מוני ה-thread MLE.
פרמטרים
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
זמן קצוב לתפוגה של שירות CSS
מגדירה את הזמן הקצוב לתפוגה של CSL בשניות.
פרמטרים
csl timeout timeout
דוגמאות
cls timeout 10
Doneהפניית CLI ו-API
מערך הנתונים פעיל
קבלת מערך הנתונים התפעולי הפעיל.
ב-OT CLI משתמשים בחברי 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
Donedataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Doneהפניית CLI ו-API
חותמת זמן פעילה של מערך נתונים (get, set)
הפונקציה מקבלת או מגדירה otOperationalDataset::mActiveTimestamp.
פרמטרים
dataset activetimestamp [timestamp]
צריך להעביר את הארגומנט האופציונלי timestamp כדי להגדיר את חותמת הזמן הפעילה.
דוגמאות
dataset activetimestamp
123456789
Donedataset activetimestamp 123456789
Doneהפניית CLI ו-API
- אין ממשק API משויך
ערוץ של מערך נתונים (get,set)
הפונקציה מקבלת או מגדירה otOperationalDataset::mChannel.
פרמטרים
dataset channel [channel-num]
משתמשים בארגומנט האופציונלי channel-num כדי להגדיר את הערוץ.
דוגמאות
dataset channel
12
Donedataset channel 12
Doneהפניית CLI ו-API
- אין ממשק API משויך
channelmask של מערך נתונים (get,set)
מקבלת או מגדירה otOperationalDataset::mChannelMask
פרמטרים
dataset channelmask [channel-mask]
משתמשים בארגומנט האופציונלי channel-mask כדי להגדיר את מסיכת הערוץ.
דוגמאות
dataset channelmask
0x07fff800
Donedataset 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
Donedataset delay 1000
Doneהפניית CLI ו-API
extpanid של מערך נתונים (get,set)
הפונקציה מקבלת או מגדירה otOperationalDataset::mExtendedPanId.
פרמטרים
dataset extpanid [extpanid]
אפשר להשתמש בארגומנט האופציונלי extpanid כדי להגדיר את מזהה הרשת המורחבת של האזור האישי.
דוגמאות
dataset extpanid
000db80123456789
Donedataset extpanid 000db80123456789
Doneהפניית CLI ו-API
עזרה עם מערך נתונים
קבלת רשימה של dataset פקודות ב-CLI. מידע נוסף זמין במאמר הצגה וניהול של מערכי נתונים באמצעות 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
Donedataset 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]
- משתמשים ב-
addressכדי לציין את יעד IPv6. אחרת, ה-ALOC של המנהיג משמש כברירת המחדל. - בשביל
dataset-components, אפשר להעביר כל שילוב של otOperationalDatasetComponents, לדוגמהactivetimestamp,pendingtimestampאוnetworkkey. - הארגומנט האופציונלי
-xמציין ערכי TLV גולמיים שצריך לבקש.
דוגמאות
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Donedataset mgmtgetcommand active networkname
Doneהפניית CLI ו-API
- otDatasetSendMgmtActiveGet
- dataset mgmtgetcommand בהמתנה
- dataset mgmtsetcommand פעיל
- 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
Donedataset mgmtgetcommand pending networkname
Doneהפניית CLI ו-API
- otDatasetSendMgmtPendingGet
- dataset mgmtgetcommand פעיל
- dataset mgmtsetcommand פעיל
- 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 פעיל
- 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 פעיל
- dataset mgmtgetcommand בהמתנה
- dataset mgmtsetcommand פעיל
מפתח רשת של מערך נתונים (get,set)
מקבלת או מגדירה otOperationalDataset::mNetworkKey.
פרמטרים
dataset networkkey [key]
משתמשים בארגומנט key האופציונלי כדי להגדיר את מפתח הרשת.
דוגמאות
dataset networkkey
00112233445566778899aabbccddeeff
Donedataset networkkey 00112233445566778899aabbccddeeff
Doneהפניית CLI ו-API
- אין ממשק API משויך
שם הרשת של מערך הנתונים (get,set)
מקבלת או מגדירה otOperationalDataset::mNetworkName.
פרמטרים
dataset networkname [name]
משתמשים בארגומנט name האופציונלי כדי להגדיר את שם הרשת.
דוגמאות
dataset networkname
OpenThread
Donedataset networkname OpenThread
Doneהפניית CLI ו-API
panid של מערך נתונים (get,set)
הפונקציה מקבלת או מגדירה otOperationalDataset::mPanId.
פרמטרים
dataset panid [panid]
משתמשים בארגומנט האופציונלי panid כדי להגדיר את מזהה ה-PAN.
דוגמאות
dataset panid
0x1234
Donedataset panid 0x1234
Doneהפניית CLI ו-API
- אין ממשק API משויך
חותמת זמן בהמתנה של מערך נתונים (get,set)
הפונקציה מקבלת או מגדירה otOperationalDataset::mPendingTimestamp.
פרמטרים
dataset pendingtimestamp [timestamp]
צריך להשתמש בארגומנט האופציונלי timestamp כדי להגדיר את שניות ההמתנה בחותמת הזמן.
דוגמאות
dataset pendingtimestamp
123456789
Donedataset 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
Donedataset pskc -p 123456
Donedataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Doneהפניית CLI ו-API
- אין ממשק API משויך
מדיניות אבטחה של מערך נתונים (get,set)
מקבל או מגדיר את מדיניות האבטחה של מערך הנתונים.
פרמטרים
dataset securitypolicy [rotationtime [onrcCepR]]
- יש להשתמש ב-
rotationtimeבמשךthrKeyRotation, ביחידות של שעות. - פקודות מדיניות אבטחה משתמשות במיפויי הארגומנטים
onrcCepRכדי לקבל ולהגדיר חברים ב-otSecurityPolicy. לדוגמה,oמייצג את otSecurityPolicy::mObtainNetworkKeyEnabled. מידע נוסף זמין במאמר הצגה וניהול של מערכי נתונים באמצעות OT CLI.
דוגמאות
dataset securitypolicy
672 onrc
Donedataset securitypolicy 672 onrc
Doneהפניית CLI ו-API
- אין ממשק API משויך
קבוצת מערך הנתונים (פעיל,בהמתנה)
מגדיר את מערך הנתונים התפעולי הפעיל.
אם מערך הנתונים לא כולל חותמת זמן פעילה, מערך הנתונים יהיה מלא רק באופן חלקי.
אם פרוטוקול Thread מופעל במכשיר שמערך נתונים פעיל מלא באופן חלקי, המכשיר ינסה לחבר אותו לרשת Thread קיימת באמצעות כל המידע שקיים במערך הנתונים. כדי לחבר לרשת, צריך רק את מפתח הרשת בפרוטוקול Thread.
אם הערוץ לא כלול במערך הנתונים, המכשיר ישלח הודעות MLE Announce בערוצים שונים כדי למצוא שכנים בערוצים אחרים.
אם המכשיר מתחבר בהצלחה לרשת של פרוטוקול Thread, המכשיר יאחזר את כל מערך הנתונים הפעיל מההורה שלו. חשוב לשים לב שמכשיר שמתאים לנתב לא יעבור לתפקידים 'נתב' או 'מוביל' עד שיש לו 'מערך נתונים פעיל' מלא.
הפונקציה הזו מחזירה בעקביות את הערך OT_ERROR_NONE ואפשר להתייחס אליה כחוזרת מסוג void. בעבר, שגיאות אחרות (למשל, OT_ERROR_NOT_IMPLEMENTED) אושרו מסיבות קודמות. עם זאת, מכיוון שאחסון לא תנודתי נדרש עכשיו לפעולת Thread, כל כשל בשמירת מערך הנתונים יפעיל טענת נכוֹנוּת (assertion). סוג ההחזרה otError נשמר לצורך תאימות לאחור.
הפקודה dataset set של ה-CLI מגדירה את מערך הנתונים התפעולי באמצעות פונקציות TLV בקידוד הקסדצימלי.
פרמטרים
dataset set {active|pending} tlvsדוגמאות
dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Donedataset 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 צריך להכיל את השדות לעדכון ואת הערך החדש שלהם. אסור שהיא תכלול את השדות 'פעיל' או 'בהמתנה' של חותמת זמן. השדה 'עיכוב' הוא אופציונלי, אם הוא לא סופק ערך ברירת מחדל (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 כדי לאסוף מידע על המכשיר ועל רשת ה-thread. הבקשה הזו מיועדת לניפוי באגים. בפלט יוצגו כל פקודת CLI שהופעלה לפני $, ואחריה הפלט שנוצר על ידי הפקודה המתאימה. הפלט שנוצר כולל את המידע הבא:
- גרסה
- המצב הנוכחי
- RLOC16, כתובת MAC מורחבת
- רשימת כתובות IPv6 חד-פעמיות ו-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 בלי לחסום את המשתמש ולהמתין להתקשרות חזרה שמציינת שהניתוק הסתיים.
פרמטרים
אין פרמטרים.
דוגמאות
detach async
Doneהפניית CLI ו-API
ניתוק
מתחילים את תהליך הניתוק החינני על ידי שליחת הודעה לצמתים אחרים (שליחת הודעה לצמתים אחרים אם הפעולה מתבצעת כנתב, או הגדרת הערך של הזמן הקצוב לתפוגה אצל הורה כאפס במקרה של ילד) ואז הפסקת הפעולה של פרוטוקול פרוטוקול Thread.
פרמטרים
אין פרמטרים.
דוגמאות
detach
Finished detaching
Doneהפניית CLI ו-API
devicepros (מוגדר)
מגדיר את מאפייני המכשיר.
פרמטרים
deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment
powerSupply: צריך להיות 'סוללה', 'חיצוני', 'חיצוני-יציב', 'חיצוני-לא יציב'.
דוגמאות
deviceprops battery 0 0 0 -5
Donedeviceprops
PowerSupply : battery
IsBorderRouter : no
SupportsCcm : no
IsUnstable : no
WeightAdjustment : -5
Doneהפניית CLI ו-API
deviceprops
הצגת מאפייני המכשיר הנוכחיים.
נדרש 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
לגלות reqcallback (הפעלה,השבתה)
מגדיר קריאה חוזרת (callback) לקבלת נתונים של בקשת גילוי MLE.
פרמטרים
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
Donedns 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) ו-SRP של OpenThread". השדה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE הוא שדה חובה.
פרמטרים
dns compression [enable|disable]
דוגמאות
dns compression enable
Enableddns compression disable
Done
dns compression
Disabled
Doneהפניית CLI ו-API
דחיסת DNS
מציין אם 'דחיסת שם DNS' מופעל או לא.
היא מיועדת לבדיקה בלבד וזמינה כשההגדרה של OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.
דחיסת השם של DNS מופעלת כברירת מחדל. כשהתכונה הזו מושבתת, שמות ה-DNS מתווספים כמלאים ואף פעם לא דחוסים. הדבר רלוונטי למודולים של לקוח/שרת/שרת (DNS) ו-SRP של OpenThread". השדה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE הוא שדה חובה.
פרמטרים
dns compression [enable|disable]
דוגמאות
dns compression
Enabledהפניית CLI ו-API
תצורת dns (מוגדר)
ההגדרה קובעת את תצורת ברירת המחדל של השאילתה בלקוח ה-DNS.
בשדה aConfig שאינו NULL, הוא יכול לבחור להשאיר חלק מהשדות במכונה של
otDnsQueryConfig
לא צוינו (ערך אפס). השדות שלא צוינו יוחלפו בהגדרות המתאימות של אפשרויות ההגדרה ל-OTOPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}, כדי ליצור את הגדרת ברירת המחדל של השאילתה.
כשהמדיניות OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE מופעלת, כתובת ה-IPv6 של השרת בהגדרת ברירת המחדל מוגדרת ומעודכנת באופן אוטומטי על ידי לקוח ה-DNS. הפעולה הזו מתבצעת רק כשהמשתמש לא מגדיר או מציין זאת במפורש. כדי לעשות זאת, יש להפעיל את לקוח ה-SRP ואת תכונת ההפעלה האוטומטית שלו. לאחר מכן לקוח SRP יעקוב אחר נתוני רשת פרוטוקול Thread עבור רשומות של שירות DNS/SRP כדי לבחור שרת SRP. כתובת שרת ה-SRP שנבחרה מוגדרת גם ככתובת שרת ה-DNS בהגדרת ברירת המחדל.
נוכל להשאיר חלק מהשדות לא מוגדרים (או להשתמש בערך אפס). השדות שלא צוינו יוחלפו בהגדרות המתאימות של אפשרויות ההגדרה ל-OTOPENTHREAD_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] [protocol]
דוגמאות
dns config fd00::1 1234 5000 2 0
Donedns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Donedns config fd00::2
Donedns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 6000 ms
MaxTxAttempts: 3
RecursionDesired: yes
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
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), מספר ניסיונות מקסימלי לפני דיווח על כשל, סימון בוליאני שמציין אם השרת יכול לפתור את השאילתה באופן רקורסיבי או לא. השדה 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: 300dns 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 servicehost
מפעיל רזולוציית מופע של שירות 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. הקריאה החוזרת 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.
הפעולה מצליחה רק כאשר פרוטוקולים של פרוטוקולי Thread מושבתים.
פרמטרים
domainname name
צריך להשתמש ב-backslash כדי לסמן בתו בריחה (escape) רווחים.
דוגמאות
domainname Test\ Thread
Doneהפניית CLI ו-API
שם דומיין
מקבל את שם הדומיין של פרוטוקול ה-Thread.
פרמטרים
אין פרמטרים.
דוגמאות
domainname
Thread
Doneהפניית CLI ו-API
dua iid (הגדרה,ניקוי)
מגדיר או מנקה את מזהה הממשק שצוין באופן ידני עבור כתובת Unicast של דומיין Thread.
האפשרות הזו זמינה כשהאפשרות OPENTHREAD_CONFIG_DUA_ENABLE מופעלת.
פרמטרים
dua iid iid|clear
dua iid clear מעביר nullptr אל otThreadSetFixedDuaInterfaceIdentifier. אחרת, אפשר להעביר את iid.
דוגמאות
dua iid 0004000300020001
Donedua iid clear
Doneהפניית CLI ו-API
Duo iid
הפונקציה מקבלת את מזהה הממשק שצוין באופן ידני לכתובת Unicast של דומיין ה-Thread.
האפשרות הזו זמינה כשהאפשרות 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 (הגדרה)
מגדיר את הכתובת המורחבת של IEEE 802.15.4.
פרמטרים
extaddr extaddr
דוגמאות
extaddr dead00beef00cafe
dead00beef00cafe
Doneהפניית CLI ו-API
extaddr
מקבל את הכתובת המורחבת של IEEE 802.15.4.
פרמטרים
אין פרמטרים.
דוגמאות
extaddr
dead00beef00cafe
Doneהפניית CLI ו-API
extpanid (מוגדר)
מגדיר את מזהה מספר החשבון הקבוע (PAN) המורחב של IEEE 802.15.4.
פרמטרים
extpanid extpanid
דוגמאות
extpanid dead00beef00cafe
Doneהפניית CLI ו-API
extpanid
מקבל את מזהה ה-PAN המורחב של IEEE 802.15.4.
פרמטרים
אין פרמטרים.
דוגמאות
extpanid
dead00beef00cafe
Doneהפניית CLI ו-API
איפוס להגדרות המקוריות
מוחק את כל ההגדרות שנשמרו בזיכרון לא תנודתי, ולאחר מכן מפעיל איפוס של הפלטפורמה.
פרמטרים
אין פרמטרים.
דוגמאות
factoryreset
הפניית CLI ו-API
זיוף (a,an)
שליחת הודעות מזויפות בפרוטוקול Thread.
האפשרות הזו זמינה כשהאפשרות 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 lenagain (get)
מקבל את רווח ה-Rx LNA החיצוני של FEM ב-dBm.
פרמטרים
אין פרמטרים.
דוגמאות
fem lnagain
11
Doneהפניית CLI ו-API
fem lenagain (set)
מגדיר את רווח Rx LNA החיצוני של FEM ב-dBm.
פרמטרים
אין פרמטרים.
דוגמאות
fem lnagain 8
Doneהפניית CLI ו-API
היסטוריה ב-iPad
מציג את היסטוריית כתובות ה-IPv6 של Universal Analytics בפורמט של טבלה או רשימה.
כל רשומה של טבלה או רשימה מספקת:
- גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט:
hours:minutes:seconds:milliseconds - אירוע: הערכים האפשריים הם
AddedאוRemoved. - אורך כתובת/קידומת: כתובת חד-פעמית עם אורך הקידומת שלה (בביטים).
- מקור: ערך אפשרי הוא
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 |
Donehistory 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
היסטוריה אייפד
מציג את היסטוריית כתובות ה-IPv6 של Multicast בפורמט של טבלה או רשימה.
כל רשומה של טבלה או רשימה מספקת:
- גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט:
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 |
Donehistory 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-בזמן-לא פעיל, מכשיר Thread מינימלי, נתוני רשת יציבים).r: RX-במצב לא פעילd: מכשיר בפרוטוקול Thread מלא.n: נתוני רשת מלאים
- Ave RSS: מספר הפריימים הממוצע (ב-dBm) שהתקבלו מהשכן בזמן שהרשומה נרשמה.
פרמטרים
history neighbor [list] [num-entries]
- אפשר להשתמש באפשרות
listכדי להציג את הפלט בפורמט של רשימה. אחרת, הפלט יוצג בפורמט של טבלה. - אפשר להשתמש באפשרות
num-entriesכדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות שנשמרו מוצגות בפלט.
דוגמאות
history neighbor
| Age | Type | Event | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
| 00:00:29.233 | Child | Added | ae5105292f0b9169 | 0x8404 | - | -20 |
| 00:01:38.368 | Child | Removed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:27.181 | Child | Changed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:51.236 | Router | Added | 865c7ca38a5fa960 | 0x9400 | rdn | -20 |
| 00:04:51.587 | Child | Removed | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:05:22.764 | Child | Changed | ae5105292f0b9169 | 0x8401 | rn | -20 |
| 00:06:40.764 | Child | Added | 4ec99efc874a1841 | 0x8403 | r | -20 |
| 00:06:44.060 | Child | Added | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:06:49.515 | Child | Added | ae5105292f0b9169 | 0x8401 | - | -20 |
Donehistory 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-בזמן-לא פעיל, מכשיר Thread מינימלי, נתוני רשת יציבים).r: RX-במצב לא פעילd: מכשיר בפרוטוקול Thread מלא.n: נתוני רשת מלאים
- RLOC16
- מזהה חלוקה.
פרמטרים
history netinfo [list] [num-entries]
- אפשר להשתמש באפשרות
listכדי להציג את הפלט בפורמט של רשימה. אחרת, הפלט יוצג בפורמט של טבלה. - אפשר להשתמש באפשרות
num-entriesכדי להגביל את הפלט למספר הרשומות האחרונות שצוינו. אם לא משתמשים באפשרות הזו, כל הרשומות שנשמרו מוצגות בפלט.
דוגמאות
history netinfo
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:00:10.069 | router | rdn | 0x6000 | 151029327 |
| 00:02:09.337 | child | rdn | 0x2001 | 151029327 |
| 00:02:09.338 | child | rdn | 0x2001 | 151029327 |
| 00:07:40.806 | child | - | 0x2001 | 151029327 |
| 00:07:42.297 | detached | - | 0x6000 | 0 |
| 00:07:42.968 | disabled | - | 0x6000 | 0 |
Donehistory 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
Donehistory 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: סימון הגדרת כתובת IPv6 של DHCPv6.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 |
Donehistory 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 |
Donehistory 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 של הנתב.
- הצעד הבא: מזהה נתב ו-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 |
Donehistory 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: סיכום ביקורת (checksum) של ההודעה (תקף להודעות UDP, TCP או ICMP6).
- שניות: מציין אם נעשה שימוש באבטחה של שכבת קישור.
- Prio: עדיפות הודעה. הערכים האפשריים הם
low,norm,highאוnet(להודעות שמשמשות לבקרה על פרוטוקול Thread). - RSS: עוצמת האות שהתקבלה (ב-dBm), בממוצע לכל הפריימים של המקטעים שהתקבלו שיצרו את ההודעה. עבור ההיסטוריה של TX מוצג הערך
NA(לא רלוונטי). - שיחה: מראה אם ההודעה נשלחה (
TX) או התקבלה (RX). שידור שנכשל מצוין באמצעותTX-Fבפורמט טבלה אוtx-success:noבפורמט רשימה. דוגמאות להעברה שנכשלה כוללות ביטול שלtxושל אי שליחה שלackמהעמיתים של אף אחד מקטעי ההודעה. - סביבה: כתובת קצרה (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 |
Donehistory 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
מציג את ההיסטוריה המשולבת של פרוטוקול IPv6 מסוג RX ו-TX בפורמט של טבלה או רשימה.
כל רשומה של טבלה או רשימה מספקת:
- גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט:
hours:minutes:seconds:milliseconds - סוג:
- סוג הודעה של IPv6, כמו
UDP,TCP,HopOptsו-ICMP6(וסוג המשנה שלו). src: כתובת IPv6 ומספר יציאה של המקור.dst: כתובת IPv6 של היעד ומספר יציאה (מספר היציאה תקין ל-UDP/TCP, אחרת הוא 0).
- סוג הודעה של IPv6, כמו
- Len: אורך המטען הייעודי (payload) של IPv6 (לא כולל כותרת IPv6).
- Chksum: סיכום ביקורת (checksum) של ההודעה (תקף להודעות UDP, TCP או ICMP6).
- שניות: מציין אם נעשה שימוש באבטחה של שכבת קישור.
- Prio: עדיפות הודעה. הערכים האפשריים הם
low,norm,highאוnet(להודעות שמשמשות לבקרה על פרוטוקול Thread). - RSS: עוצמת האות שהתקבלה (ב-dBm), בממוצע לכל הפריימים של המקטעים שהתקבלו שיצרו את ההודעה. עבור ההיסטוריה של TX מוצג הערך
NA(לא רלוונטי). - שיחה: מראה אם ההודעה נשלחה (
TX) או התקבלה (RX). שידור שנכשל מצוין באמצעותTX-Fבפורמט טבלה אוtx-success:noבפורמט רשימה. דוגמאות להעברה שנכשלה כוללות ביטול שלtxושל אי שליחה שלackמהעמיתים של אף אחד מקטעי ההודעה. - סביבה: כתובת קצרה (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 |
Donehistory 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
היסטוריה טקסס
הצגת ההיסטוריה של הודעות IPv6 ב-TX בפורמט של טבלה או רשימה.
כל רשומה של טבלה או רשימה מספקת:
- גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט:
hours:minutes:seconds:milliseconds - סוג:
- סוג הודעה של IPv6, כמו
UDP,TCP,HopOptsו-ICMP6(וסוג המשנה שלו). src: כתובת IPv6 ומספר יציאה של המקור.dst: כתובת IPv6 של היעד ומספר יציאה (מספר היציאה תקין ל-UDP/TCP, אחרת הוא 0).
- סוג הודעה של IPv6, כמו
- Len: אורך המטען הייעודי (payload) של IPv6 (לא כולל כותרת IPv6).
- Chksum: סיכום ביקורת (checksum) של ההודעה (תקף להודעות UDP, TCP או ICMP6).
- שניות: מציין אם נעשה שימוש באבטחה של שכבת קישור.
- Prio: עדיפות הודעה. הערכים האפשריים הם
low,norm,highאוnet(להודעות שמשמשות לבקרה על פרוטוקול Thread). - RSS: עוצמת האות שהתקבלה (ב-dBm), בממוצע לכל הפריימים של המקטעים שהתקבלו שיצרו את ההודעה. עבור ההיסטוריה של TX מוצג הערך
NA(לא רלוונטי). - שיחה: מראה אם ההודעה נשלחה (
TX) או התקבלה (RX). שידור שנכשל מצוין באמצעותTX-Fבפורמט טבלה אוtx-success:noבפורמט רשימה. דוגמאות להעברה שנכשלה כוללות ביטול שלtxושל אי שליחה שלackמהעמיתים של אף אחד מקטעי ההודעה. - סביבה: כתובת קצרה (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 |
Donehistory 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
Doneifconfig down
Doneהפניית CLI ו-API
ifconfig
מציין אם ממשק IPv6 פועל או לא.
פרמטרים
אין פרמטרים.
דוגמאות
ifconfig
down
Doneifconfig
up
Doneהפניית CLI ו-API
instanceid
הפונקציה מקבלת את מזהה המכונה.
מזהה המכונה מוגדר לערך אקראי בזמן בניית המכונה, והערך שלו לא ישתנה לאחר האתחול.
פרמטרים
אין פרמטרים.
דוגמאות
instanceid
468697314
Doneהפניית CLI ו-API
הוספת אייפד
הפונקציה מוסיפה כתובת בממשק רשת לממשק של פרוטוקול Thread.
המכונה שמועברת aAddress מועתקת על ידי ממשק ה-Thread. ממשק פרוטוקול Thread תומך רק במספר קבוע של כתובות Unicode שנוספו באופן חיצוני. OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.
פרמטרים
ipaddr add aAddress
דוגמאות
ipaddr add 2001::dead:beef:cafe
Doneהפניית CLI ו-API
ipaddr דל, אייפד דל
הסרה של כתובת ממשק רשת מממשק פרוטוקול Thread.
פרמטרים
ipaddr del aAddress
דוגמאות
ipaddr del 2001::dead:beef:cafe
Doneהפניית CLI ו-API
אייפד
קבלת הרשימה של כתובות 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
Doneipaddr -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 המקומית של קישור ל-Thread.
הכתובת המקומית של קישור לשרשור נגזרת באמצעות IEEE802.15.4 כתובת מורחבת כמזהה ממשק.
פרמטרים
אין פרמטרים.
דוגמאות
ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Doneהפניית CLI ו-API
ipaddr mleid
הפונקציה מקבלת את כתובת ה-EID המקומית של Mesh.
פרמטרים
אין פרמטרים.
דוגמאות
ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Doneהפניית CLI ו-API
ipaddr rloc
הפונקציה מקבלת את הכתובת של מאתר ניתוב השרשורים (RLOC).
פרמטרים
אין פרמטרים.
דוגמאות
ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Doneהפניית CLI ו-API
הוספה של ipmaddr
רושם את ממשק פרוטוקול Thread לכתובת Multicast בממשק רשת.
ההעברה שהועברה במכונה aAddress תועתק על ידי ממשק ה-Thread. ממשק פרוטוקול Thread תומך רק במספר קבוע של כתובות Multicast שנוספו באופן חיצוני. OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.
פרמטרים
ipmaddr add aAddress
דוגמאות
ipmaddr add ff05::1
Doneהפניית CLI ו-API
אייפדר דל
ביטול ההרשמה של ממשק פרוטוקול Thread לכתובת Multicast בממשק רשת.
פרמטרים
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
אייפדר לאטן
מקבל את כתובת Multicast של 'קישור לשרשורים מקומיים' של כל צמתים השרשורים.
הכתובת היא כתובת של פרוטוקול מקומי שמבוססת על קידומת Unicast מסוג [RFC 3306], עם:
- הקישור מוגדר ל-3 (P = 1 ו-T = 1)
- הגדרת הערך 2
- Plen מוגדר ל-64
- קידומת הרשת מוגדרת כקידומת המקומית של Mesh
- מזהה הקבוצה שהוגדר הוא 1
פרמטרים
אין פרמטרים.
דוגמאות
ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Doneהפניית CLI ו-API
אייפדר רלטן
מקבל את כתובת Multicast של Thread Realm-Local All Thread Nodes.
הכתובת היא כתובת של Multicast [RFC 3306] מבוססת-תחום מקומי שמבוסס על קידומת Unicast, עם:
- הקישור מוגדר ל-3 (P = 1 ו-T = 1)
- הגדרת הערך 3
- Plen מוגדר ל-64
- קידומת הרשת מוגדרת כקידומת המקומית של Mesh
- מזהה הקבוצה שהוגדר הוא 1
פרמטרים
אין פרמטרים.
דוגמאות
ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Doneהפניית CLI ו-API
joinerdiserner (מוגדר)
מגדיר את דיסקרנר (joiner Discerner).
פרמטרים
joiner discerner discerner
- משתמשים ב-
{number}/{length}כדי להגדיר אתdiscerner. joiner discerner clearמגדיר אתaDiscernerכ-nullptr.
דוגמאות
joiner discerner 0xabc/12
Doneהפניית CLI ו-API
דיסקרנר ברור
מוחקים את הדיסקרנר של ההצטרפות.
פרמטרים
אין פרמטרים.
דוגמאות
joiner discerner clear
Doneהפניית CLI ו-API
- אין ממשק API משויך
דיסקרנר לאיחוד (joiner)
הוא מקבל את הדיסקרנר של הצירוף.
מידע נוסף זמין במאמר otJoinerSetDiscerner.
פרמטרים
אין פרמטרים.
דוגמאות
joiner discerner
0xabc/12
Doneהפניית CLI ו-API
עזרה במצטרפים חדשים
הדפסה של תפריט העזרה של joiner.
פרמטרים
אין פרמטרים.
דוגמאות
joiner help
help
id
start
state
stop
Doneהפניית CLI ו-API
- אין ממשק API משויך
מזהה איחוד (join)
הפונקציה מקבלת את מזהה ההצטרפות.
אם לא הוגדר Discerner, מזהה הצטרפות הוא 64 הביטים הראשונים של תוצאת מחשוב SHA-256 על פני IEEE EUI-64 שהוקצה על ידי היצרן. אחרת, מזהה המצטרפים מחושב על סמך הערך Joiner Discerner.
מזהה ההצטרפות משמש גם ככתובת IEEE 802.15.4 המורחבת של המכשיר במהלך תהליך ההזמנה.
פרמטרים
אין פרמטרים.
דוגמאות
joiner id
d65e64fa83f81cf7
Doneהפניית CLI ו-API
התחלת איחוד (join)
הפעלת התפקיד 'צירוף שרשורים'.
פרמטרים
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
מצב איחוד (joiner)
הפונקציה מקבלת את מצב ההצטרפות.
הפונקציה מחזירה את אחד מהמצבים הבאים:
-
Idle -
Discover -
Connecting -
Connected -
Entrust -
Joined
פרמטרים
אין פרמטרים.
דוגמאות
joiner state
Idle
Doneהפניית CLI ו-API
עצירת ביניים
ההגדרה משביתה את התפקיד 'הצטרפות לשרשורים'.
פרמטרים
אין פרמטרים.
דוגמאות
joiner stop
Doneהפניית CLI ו-API
Joinerport (set)
מגדירה את יציאת ה-UDP של התוצר.
פרמטרים
joinerport udp-port
דוגמאות
joinerport 1000
Doneהפניית CLI ו-API
Joinerport
מקבלת את יציאת ה-UDP של Joiner.
פרמטרים
אין פרמטרים.
דוגמאות
joinerport
1000
Doneהפניית CLI ו-API
מונה מפתחות (מוגדר)
מגדיר את thrKeySequenceCounter.
פרמטרים
keysequence counter counter
דוגמאות
keysequence counter 10
Doneהפניית CLI ו-API
מונה מפתחות
הפונקציה מקבלת את thrKeySequenceCounter.
פרמטרים
אין פרמטרים.
דוגמאות
keysequence counter
10
Doneהפניית CLI ו-API
זמן שמירה על רצף מקשים (מוגדר)
מגדיר את thrKeySwitchGuardTime (בשעות).
פרמטרים
keysequence guardtime guardtime-hours
אם יש התאמה מפתחת לאינדקס, צריך להשתמש ב-0 כדי Thread Key Switch באופן מיידי.
דוגמאות
keysequence guardtime 0
Doneהפניית CLI ו-API
זמן שמירה על רצף מקשים
מקבל את thrKeySwitchGuardTime (בשעות).
פרמטרים
אין פרמטרים.
דוגמאות
keysequence guardtime
0
Doneהפניית CLI ו-API
Leaddata
הפונקציה מקבלת את הנתונים של Thread Leader.
פרמטרים
אין פרמטרים.
דוגמאות
leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Doneהפניית CLI ו-API
משקל מנהיג (set)
מגדיר את משקל המנהיג של פרוטוקול Thread להשתמש בתפקיד המנהיג.
ההגדרה של 'משקל הליד' מוגדרת ישירות לערך החדש, ומחליפה את הערך הקודם שלו (שיכול להיות שנקבע לפי ה-
otDeviceProperties
הנוכחי).
פרמטרים
leaderweight weight
דוגמאות
leaderweight 128
Doneהפניית CLI ו-API
משקל מנהיג
מקבל את המשקל של מנהיג Thread שמשתמשים בו בתפקיד 'מובילים'.
פרמטרים
אין פרמטרים.
דוגמאות
leaderweight
128
Doneהפניית CLI ו-API
הגדרת linkmetrics (משופר) – ניקוי
נשלחת בקשה לניהול מדדי קישור כדי לנקות בקשה לבדיקת תקינות שמבוססת על ACK.
פרמטרים
linkmetrics config [async] peer-ipaddr enhanced-ack clear
async: שימוש במצב ללא חסימה.peer-ipaddrצריכה להיות כתובת הקישור המקומי של המכשיר הנמצא.
דוגמאות
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Doneהפניית CLI ו-API
הגדרה של linkmetrics (רישום משופר) ב-linkmetrics
המאפיין r הנוסף הוא אופציונלי ומשמש רק למכשירי עזר. כשאפשרות זו מצוינת, ה-Enum/סוג 'ממוצע' של כל סימוני מזהה סוג מוגדר שמור. משמש כדי לוודא שנושא הבדיקה מטפל כראוי בסימונים לא חוקיים של מזהה סוג, והוא זמין רק כשהאפשרות OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE מופעלת.
שליחת בקשה לניהול מדדי קישור לרישום בקשה לבדיקת תקינות שמבוססת על ACK.
פרמטרים
linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
async: שימוש במצב ללא חסימה.- [
q,m, ו-r] ממופים ל-otLinkMetricsValues. לפי המפרט 4.11.3.4.4.6, ניתן להשתמש בשתי אפשרויות לכל היותר בו-זמנית, לדוגמהqאוqm.q: LQI שכבה 2.m: שולי הקישור.r: RSSI.
דוגמאות
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done> linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
Doneהפניית CLI ו-API
הגדרת linkmetrics קדימה
שולחת בקשה לניהול מדדי קישור מסוג MLE כדי להגדיר או לנקות סדרת מעקב אחר העברה.
פרמטרים
linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
async: שימוש במצב ללא חסימה.peer-ipaddr: כתובת של אפליקציה להשוואה.series-id: מזהה הסדרה.- [
l,d,rוגםa] ממפים ל-otLinkMetricsSeriesFlags.Xמייצג אף אחד מהotLinkMetricsSeriesFlags, ומפסיק את הנהלת החשבונות ומסיר את הסדרה.l: גשושית קישור MLE.d: נתוני MAC.r: בקשה לנתוני MAC.a: MAC Ack.X: אפשר להשתמש רק ללא סימונים אחרים.
- [
p,q,mוגםr] ממפים ל-otLinkMetricsValues.p: מספר PDU בשכבה 2 שהתקבלו.q: LQI שכבה 2.m: שולי הקישור.r: RSSI.
דוגמאות
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
Doneהפניית CLI ו-API
בדיקת קישור
נשלחת הודעה של בדיקת קישור MLE.
פרמטרים
linkmetrics probe peer-ipaddr series-id length
peer-ipaddr: כתובת של אפליקציה להשוואה.series-id: מזהה הסדרה שאליה מטרגטת ההודעה של Probe.length: משך ההודעה של Probe. טווח תקין הוא [0, 64].
דוגמאות
linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Doneהפניית CLI ו-API
בקשת linkmetrics קדימה
ביצוע שאילתה על מדדי קישור (סדרת מעקב אחר העברה).
פרמטרים
linkmetrics query [async] peer-ipaddr forward series-id
async: שימוש במצב ללא חסימה.peer-ipaddr: כתובת של אפליקציה להשוואה.series-id: מזהה הסדרה.
דוגמאות
linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 forward 1
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)
Doneהפניית CLI ו-API
בקשת linkmetrics יחידה
שליחת שאילתה למדדי קישור (Probe יחיד).
פרמטרים
linkmetrics request [async] peer-ipaddr single [pqmr]
async: שימוש במצב ללא חסימה.peer-ipaddr: כתובת של אפליקציה להשוואה.- [
p,q,mוגםr] ממפים ל-otLinkMetrics.p: מספר PDU בשכבה 2 שהתקבלו.q: LQI שכבה 2.m: שולי הקישור.r: RSSI.
דוגמאות
linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 single qmr
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)
Doneהפניית CLI ו-API
linkmetricsmgr (הפעלה,השבתה)
הפעלה או השבתה של מנהל מדדי הקישורים.
פרמטרים
linkmetricsmgr enable|disable
דוגמאות
linkmetricmgr enable
Donelinkmetricmgr disable
Doneהפניית CLI ו-API
תוכנית linkmetricsmgr
קבלת נתונים של מדדי קישור של שכן לפי הכתובת המורחבת שלו.
פרמטרים
אין פרמטרים.
דוגמאות
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
Donelocate 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)
מקבל או מגדיר את מספר הניסיונות החוזרים הישירים של TX בשכבת ה-MAC.
פרמטרים
mac retries direct [number]
משתמשים בארגומנט האופציונלי number כדי להגדיר את מספר הניסיונות החוזרים הישירים באמצעות TX.
דוגמאות
mac retries direct
3
Donemac 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
Donemac 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
Donemacfilter addr add 0f6127e33af6b402
Doneהפניית CLI ו-API
רשימת היתרים של כלים ב-Macfilter
מפעיל את מצב מסנן ה-MAC של allowlist. כלומר, ניתן יהיה לגשת רק לכתובות ה-MAC ברשימת מסנני ה-MAC.
פרמטרים
אין פרמטרים.
דוגמאות
macfilter addr allowlist
Doneהפניית CLI ו-API
ניקוי של תוסף macfilter
זמינה אם ההגדרה OPENTHREAD_CONFIG_MAC_FILTER_ENABLE מופעלת.
פקודה זו מוחקת את כל הכתובות המורחבות מרשימת מסנן ה-MAC.
פרמטרים
אין פרמטרים.
דוגמאות
macfilter addr clear
Doneהפניית CLI ו-API
רשימת הישויות שנחסמו
הפעלת מצב מסנן ה-MAC של denylist – המשמעות היא שהגישה לכל כתובות ה-MAC ברשימת מסנני ה-MAC תידחה.
פרמטרים
אין פרמטרים.
דוגמאות
macfilter addr denylist
Doneהפניית CLI ו-API
השבתה של תוסף macfilter
השבתת מצבי סינון MAC.
פרמטרים
אין פרמטרים.
דוגמאות
macfilter addr disable
Doneהפניית CLI ו-API
- אין ממשק API משויך
תוסף Macfilter
זמינה אם ההגדרה 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
הוספה של הכתובת המורחבת שצוינה לרשימה של RssIn (או שינוי כתובת קיימת ברשימה של RssIn) והגדרה של עוצמת האות שמתקבלת (ב-dBm) עבור הודעות מהכתובת הזו.
פרמטרים
macfilter rss add extaddr rss
כדי להגדיר ערך ברירת מחדל לעוצמת האות שמתקבלת בכל ההודעות שהתקבלו, צריך להשתמש ב-* לארגומנט extaddr.
דוגמאות
macfilter rss add * -50
Donemacfilter 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
Donemacfilter 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 *
Donemacfilter rss remove 0f6127e33af6b404
Doneהפניית CLI ו-API
meshdiag clientip6
שולחים שאילתה להורה כדי לאחזר את כתובות 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 מורחבת
- גרסת השרשור
- זמן קצוב לתפוגה (בשניות)
- גיל (בשניות מאז שנשמע לאחרונה)
- מרווח פיקוח (בשניות)
- מספר ההודעות בתור (למקרה שהילד עייף)
- מצב המכשיר
- 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 משויך
נתב Meshdiag
התחלת שאילתה בטבלת שכנות של נתב של נתב עם RLOC16 נתון. בפלט מוצגת רשימה של כל הרשומות השכנות של הנתב. מידע לכל רשומה:
- RLOC16
- כתובת MAC מורחבת
- גרסת השרשור
- RSS (ממוצע ואחרון) ושולי הקישור
- שיעורי שגיאות, frame 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
טופולוגיית Meshdiag
הסבר על הטופולוגיה של הרשת (רשימה של נתבים והחיבורים שלהם). הפרמטרים הם אופציונליים ומציינים פריטים נוספים שצריך לגלות. אפשר להוסיף אותם בכל סדר שתרצו.
ip6-addrsכדי למצוא את הרשימה של כתובות IPv6 של כל נתב.childrenכדי למצוא את טבלת הצאצא של כל נתב.
מידע לכל נתב:
- מזהה הנתב
- RLOC16
- כתובת MAC מורחבת
- גרסת ה-thread (אם ידועה)
- אם הנתב הוא המכשיר הזה הוא עצמו (
me) - אם הנתב הוא ההורה של המכשיר הזה כשהמכשיר הוא ילד (
parent) - האם הנתב הוא
leader - האם הנתב משמש כנתב גבול שמספק קישוריות חיצונית (
br) - רשימת נתבים שאליהם יש לנתב הזה קישור:
3-links: מזהי נתב שאליהם יש לנתב קישור נכנס עם איכות קישור 32-links: מזהי נתב שאליהם יש לנתב הזה קישור נכנס עם איכות קישור 21-links: מזהי נתב שאליהם יש לנתב הזה קישור נכנס עם איכות קישור 1- אם רשימה ריקה, היא לא מופיעה בחוץ.
- אם הערך הוא
ip6-addrs, רשימה של כתובות IPv6 של הנתב - אם הערך הוא
children, רשימה של כל הצאצאים של הנתב. מידע לכל ילד:- RLOC16
- איכות הקישורים הנכנסים מנקודת המבט של ההורה אל הילד או הילדה (אפס מצביע על לא ידוע)
- מצב מכשיר צאצא (
rRX במצב לא פעיל,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 של Mesh Local (למטרות בדיקה).
נדרש 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 בנתב הראשי (Backbone Router).
השתמש בזמן קצוב לתפוגה = 0 כדי לבטל את הרישום של מאזינים מרובים ב-Multicast.
פרמטרים
mlr reg ipaddr [timeout]
דוגמאות
mlr reg ff04::1
status 0, 0 failed
Donemlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Donemlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Donemlr reg ff04::1 ff04::2 0
status 0, 0 failed
Doneהפניית CLI ו-API
מצב (get,set)
קביעת ההגדרות האישיות של מצב קישור MLE.
פרמטרים
mode [rdn]
-: לא הוגדרו סימונים (rx-off-בזמן-לא פעיל, מכשיר Thread מינימלי, נתוני רשת יציבים)r: RX-במצב לא פעילd: מכשיר בפרוטוקול Thread מלאn: נתוני רשת מלאים
דוגמאות
mode rdn
Donemode -
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 (enable,disable)
הפעלה או השבתה של פונקציות NAT64.
כש-OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE מופעל, ההגדרה המושבתת כ-True תאפס את טבלת המיפוי בכלי התרגום.
האפשרות זמינה כשהתכונות OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE או OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE מופעלות.
פרמטרים
nat64 enable|disable
דוגמאות
nat64 enable
Donenat64 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
מקבל את המידע הבא של 'מיפוי כתובות' (באמצעות איטרטור).
האפשרות הזו זמינה כשהאפשרות 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 (מופעל).
R: RX מופעל כשאין פעילותD: מכשיר עם פרוטוקול Thread מלאN: נתוני רשת מלאים
פרמטרים
אין פרמטרים.
דוגמאות
neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC |
+------+--------+-----+----------+-----------+-+-+-+------------------+
| C | 0xcc01 | 96 | -46 | -46 |1|1|1| 1eb9ba8a6522636b |
| R | 0xc800 | 2 | -29 | -29 |1|1|1| 9a91556102c39ddb |
| R | 0xf000 | 3 | -28 | -28 |1|1|1| 0ad7ed6beaa6016d |
Doneהפניית CLI ו-API
netdata מלא
הדפסת המילה 'כן' או 'לא' שמציין אם הנתונים 'נטו נתונים מלאים' קריאה חוזרת הופעלה מאז תחילת פעולת ה-thread או מאז הפעם האחרונה שבה נעשה שימוש ב-netdata full reset כדי לאפס את הדגל. בפקודה הזו נדרש OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL. העמודה 'נתוני נטו מלאים' קריאה חוזרת (callback) מופעלת כאשר:
- המכשיר פועל כמוביל ומקבל רישום נתוני רשת מנתב גבול (BR) שהוא לא יכול להוסיף לנתוני הרשת (נגמר המקום).
- המכשיר פועל כ-BR ולא ניתן להוסיף רשומות חדשות לנתוני הרשת המקומיים שלו.
- המכשיר פועל כ-BR (ברזיל) ומנסה לרשום את הרשומות של נתוני הרשת המקומיים אצל המנהל, אבל קובע שהרשומות המקומיות שלו לא יתאימו.
פרמטרים
אין פרמטרים.
דוגמאות
netdata full
no
Doneהפניית CLI ו-API
איפוס מלא של netdata
איפוס הסימון של התכונה 'נתוני נטו מלאים' בוצעה קריאה חוזרת.
פרמטרים
אין פרמטרים.
דוגמאות
netdata full reset
Doneהפניית CLI ו-API
- אין ממשק API משויך
אורך netdata
קבלת האורך הנוכחי (מספר הבייטים) של נתוני רשת פרוטוקול Thread של המחיצה.
פרמטרים
אין פרמטרים.
דוגמאות
netdata length
23
Doneהפניית CLI ו-API
אורך מקסימלי נטו נתונים
קבלת האורך המקסימלי הנצבר של נתוני הרשת של פרוטוקול Thread מאז אתחול סטאק OT או מאז הקריאה האחרונה ל-
otNetDataResetMaxLength()
.
פרמטרים
אין פרמטרים.
דוגמאות
netdata maxlength
40
Doneהפניית CLI ו-API
איפוס אורך מקסימלי של netdata
איפוס האורך המקסימלי של נתוני הרשת של פרוטוקול Thread למעקב.
פרמטרים
אין פרמטרים.
דוגמאות
netdata maxlength reset
Doneהפניית CLI ו-API
netdata Advertising dnssrp anycast, netdata publish 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)
פרסום כתובת חד-פעמית של שירות 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
מפרסמים רשומת קידומת on-mesh. מידע נוסף זמין במאמר ניהול של נתוני רשת המדיה באמצעות 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]
ב-OT CLI נעשה שימוש בארגומנטים ממופים כדי להגדיר את ערכי 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]
ב-OT CLI נעשה שימוש בארגומנטים ממופים כדי להגדיר את ערכי otExternalRouteConfig. מידע נוסף זמין במאמר סקירה כללית של OpenThread CLI.
דוגמאות
netdata publish route fd00:1234:5678::/64 s high
Doneהפניית CLI ו-API
רישום netdata
רישום קידומות, מסלולים ושירותים שהוגדרו אצל ה-Leader.
ה-CLI של OT בודק את OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE. אם האפשרות OTBR מופעלת, היא רושמת נתוני רשת מקומיים אצל ה-Leader. אחרת, היא מפעילה את הפונקציה otServerRegister ב-CLI. מידע נוסף זמין במאמר ניהול של נתוני רשת המדיה באמצעות OT CLI.
פרמטרים
אין פרמטרים.
דוגמאות
netdata register
Doneהפניית CLI ו-API
בדיקת teeringdata של netdata (discerner)
בודקים אם נתוני ההיגוי כוללים איחוד (joiner) עם ערך דיסקרנר נתון.
פרמטרים
netdata steeringdata check discerner
discerner: הכלי לאיחוד (join) בפורמט{number}/{length}.
דוגמאות
netdata steeringdata check 0xabc/12
Donenetdata steeringdata check 0xdef/12
Error 23: NotFoundהפניית CLI ו-API
בדיקת netdata steeringdata בדיקת (eui64)
צריך לבדוק אם נתוני ההיגוי כוללים Joiner.
פרמטרים
netdata steeringdata check eui64
eui64: ה-IEEE EUI-64 של השותף.
דוגמאות
netdata steeringdata check d45e64fa83f81cf7
Doneהפניית CLI ו-API
netdata unpublish (prefix)
ביטול הפרסום של קידומת 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.
צריך להפעיל את 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
אחזור אבחון רשת
נשלחת בקשה לאבחון הרשת כדי לאחזר ערכי אורך סוג (TLV) שצוינו עבור הכתובות שצוינו.
פרמטרים
networkdiagnostic get addr type(s)
עבור addr, כתובת בחיבור unicast מפעילה Diagnostic Get. כתובת Multicast מפעילה Diagnostic Query. ערכי TLV שאפשר לציין (מופרדים ברווח אם מציינים יותר מ-TLV אחד):
0: TLV של כתובת מורחבת של MAC1: כתובת 16 (TLV)2: מצב TLV3: זמן קצוב לתפוגה של דגימת נתונים (TLV) (משך הזמן המקסימלי לקלפי SED)4: TLV קישוריות5: כביש 64 (TLV)6: מבוא לנתוני בכירים7: מרכז המידע על נתוני רשת8: TLV לרשימת כתובות IPv69: מוני MAC14: זמן אמת (TLV) ברמת הסוללה15: TLV במתח אספקה16: TLV שולחן צאצא17: מרכז המידע על דפי ערוצים19: הזמן המקסימלי לתפוגה של חשבון צאצא23: EUI64 TLV24: גרסת TLV (מספר הגרסה של הפרוטוקולים והתכונות)25: שם הספק (TLV)26: TLV של דגם ספק27: TLV של גרסת SW של ספק28: גרסת TLV של מקבץ Thread (מזהה גרסה כמחרוזת UTF-8 ל-codebase/commit/version של מקבץ Thread)29: עלות משלוח לילדים (TLV)34: MLE Counters TLV35: קובץ TLV של כתובת ה-URL של אפליקציית הספק
דוגמאות
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
Donenetworkdiagnostic 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
Donenetworkidtimeout
120
Doneהפניית CLI ו-API
מפתח רשת (מפתח)
מגדירים את מפתח הרשת של פרוטוקול Thread.
האפשרות הזו מצליחה רק אם פרוטוקולי Thread מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים והפעילים, בזיכרון לא תנודתי.
פרמטרים
networkkey key
דוגמאות
networkkey 00112233445566778899aabbccddeeff
Doneהפניית CLI ו-API
מפתח רשת
מקבלים את מפתח הרשת של פרוטוקול Thread.
פרמטרים
אין פרמטרים.
דוגמאות
networkkey
00112233445566778899aabbccddeeff
Doneהפניית CLI ו-API
שם רשת (שם)
מגדירים את שם הרשת של פרוטוקול Thread.
האפשרות הזו מצליחה רק אם פרוטוקולי Thread מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים והפעילים, בזיכרון לא תנודתי.
פרמטרים
networkname name
דוגמאות
networkname OpenThread
Doneהפניית CLI ו-API
שם הרשת
מקבלים את השם של רשת פרוטוקול Thread.
פרמטרים
אין פרמטרים.
דוגמאות
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
Donenexthop 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 (panid)
מגדירים את מזהה מספר החשבון הקבוע (PAN) של IEEE 802.15.4.
האפשרות הזו מצליחה רק אם פרוטוקולי Thread מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת גם את מערכי הנתונים התפעוליים הפעילים והממתינים (Pending) בזיכרון הלא תנודתי.
פרמטרים
panid panid
דוגמאות
panid 0xdead
Doneהפניית CLI ו-API
פאניד
מקבלים את מזהה מספר החשבון הקבוע (PAN) של IEEE 802.15.4.
פרמטרים
אין פרמטרים.
דוגמאות
panid
0xdead
Doneהפניית CLI ו-API
הורה
קבלת פרטי האבחון של נתב Thread כהורה.
בעת הפעלה כנתב פרוטוקול Thread כש-Openthread_CONFIG_REFERENCE_DEVICE_ENABLE מופעל, הפקודה הזו מחזירה את המידע שנשמר במטמון מהמועד שבו המכשיר היה מחובר בעבר כצאצא של Thread. החזרת מידע מהמטמון נדרשת כדי לתמוך ב-thread Test Harness - תרחיש בדיקה בגרסה 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
Doneparentpriority 1
Doneהפניית CLI ו-API
partitionid
מוצאים את המזהה של מחיצת הרשת בפרוטוקול Thread.
פרמטרים
אין פרמטרים.
דוגמאות
partitionid
4294967295
Doneהפניית CLI ו-API
partitionid מועדף (get,set)
השדה OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE הוא שדה חובה.
פרמטרים
partitionid preferred partitionid
דוגמאות
partitionid preferred
4294967295
Donepartitionid preferred 0xffffffff
Doneהפניית CLI ו-API
platform
הדפסת הפלטפורמה הנוכחית
פרמטרים
אין פרמטרים.
דוגמאות
platform
NRF52840
Doneהפניית CLI ו-API
- אין ממשק API משויך
segmentperiod (get,set)
קבלה או הגדרה של התקופה של סקר הנתונים בהתאמה אישית עבור מכשיר קצה ישן (אלפיות שנייה). רק לבחינת הסמכה.
פרמטרים
אין פרמטרים.
דוגמאות
pollperiod
0
Donepollperiod 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
Doneprefix add fd00:7d03:7d03:7d03::/64 prosD low
Doneהפניית CLI ו-API
תחילית meshlocal
משתמשים בקידומת המקומית של הרשת.
פרמטרים
אין פרמטרים.
דוגמאות
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
Donepromiscuous 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 משויך
Pskc
אפשר להוריד את ה-Thread PSKc.
פרמטרים
אין פרמטרים.
דוגמאות
pskc
67c0c203aa0b042bfb5381c47aef4d9e
Doneהפניית CLI ו-API
pskcref (set)
מגדירים את ה-Key Reference ל-Thread PSKc.
נדרשת הפעלה של תכונת זמן ה-build OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.
הפעולה מצליחה רק אם פרוטוקולים של פרוטוקולי Thread מושבתים. הפעולה הזו תוביל גם לביטול התוקף של מערכי הנתונים התפעוליים הפעילים והממתינים (Pending) בזיכרון הלא תנודתי.
פרמטרים
pskc keyref
דוגמאות
pskc 0x20017
Doneהפניית CLI ו-API
pskcref
קבלת הפניית מפתח לשרשור PSKc של פרוטוקול Thread.
נדרשת הפעלה של תכונת זמן ה-build OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.
פרמטרים
אין פרמטרים.
דוגמאות
pskcref
0x80000000
Doneהפניית CLI ו-API
רדיו (הפעלה,השבתה)
המתג מפעיל או משבית את הרדיו.
פרמטרים
radio enable|disable
דוגמאות
radio enable
Doneradio 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 [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
נתב (id)
הפונקציה שומרת את פרטי האבחון של נתב 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
Donerouter 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
substitutedowndownthreshold (get,set)
הפונקציה מקבלת או מגדירה את הערך ROUTER_DOWN שמשמשת_REQUEST.
פרמטרים
routerdowngradethreshold [threshold]
דוגמאות
routerdowngradethreshold
23
Done routerdowngradethreshold 23
Doneהפניית CLI ו-API
נתב כשיר (הפעלה,השבתה)
המתג מפעיל או משבית את התפקיד של הנתב.
פרמטרים
routereligible [enable|disable]
דוגמאות
routereligible enable
Doneroutereligible disable
Doneהפניית CLI ו-API
כשיר לנתב
מציינת אם התפקיד בנתב מופעל או מושבת.
פרמטרים
אין פרמטרים.
דוגמאות
routereligible
Enabled
Doneהפניית CLI ו-API
routerselectionjitter
מקבל או מגדיר את הערך ROUTER_SELECTION_JITTER.
פרמטרים
routerselectionjitter [jitter]
דוגמאות
routerselectionjitter
120
Donerouterselectionjitter 120
Doneהפניית CLI ו-API
networkupgradethreshold (get,set)
הפונקציה מקבלת או מגדירה את הערך ROUTER_UPGOAL_REQUEST.
פרמטרים
routerupgradethreshold [threshold]
דוגמאות
routerupgradethreshold
16
Donerouterupgradethreshold 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 |
Donescan 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
Donenetdata register
Doneהפניית CLI ו-API
הסרת שירות
הסרת השירות מנתוני הרשת.
- EnterpriseNumber: מספר ארגון IANA
- serviceData: נתוני שירות בינאריים בקידוד הקסדצימלי
פרמטרים
service remove enterpriseNumber serviceData
דוגמאות
service remove 44970 112233
Donenetdata register
Doneהפניית CLI ו-API
singleton
מציין אם צומת הוא הנתב היחיד ברשת. הפונקציה מחזירה את הערך true או false.
פרמטרים
אין פרמטרים.
דוגמאות
singleton
true
Doneהפניית CLI ו-API
שאילתת sntp
שולחת שאילתת SNTP כדי לקבל את מועד ה-Unix epoch הנוכחי (מ-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)
Donesntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Doneהפניית CLI ו-API
הפעלה אוטומטית של לקוח srp (get)
מציין את המצב הנוכחי של מצב ההפעלה האוטומטית (מופעל או מושבת). מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (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, והן מועדפות לפי הסדר הבא:
- רשומות חד-פעמיות שבהן כתובת השרת נכללת בנתוני השירות. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.
- רשומות Anycast שלכל אחת מהן יש מספר סידורי. עדיף להשתמש במספר הרצף הגדול ביותר כפי שצוין בלוגיקת מספרים סידוריים ב-RFC-1982.
- רשומות חד-פעמיות שבהן פרטי כתובת השרת כלולים בנתוני השרת. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.
פרמטרים
אין פרמטרים.
דוגמאות
srp client autostart enable
Doneהפניית CLI ו-API
קריאה חוזרת של לקוח srp (קבלה,הפעלה,השבתה)
קבלה או הפעלה או השבתה של אירועי קריאה חוזרת של הדפסה מלקוח ה-SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.
פרמטרים
srp client callback [enable|disable]
דוגמאות
srp client callback enable
Donesrp client callback
Enabled
Doneהפניית CLI ו-API
כתובת מארח של לקוח srp (get)
מציין אם מצב הכתובת האוטומטית מופעל. אם מצב הכתובת האוטומטית לא מופעל, תוחזר רשימת כתובות המארח של לקוחות SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.
פרמטרים
אין פרמטרים.
דוגמאות
srp client host address
auto
Donesrp 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כדי להפעיל את מצב הכתובת של המארח האוטומטי. כשהאפשרות הזו מופעלת, הלקוח משתמש באופן אוטומטי בכל כתובות ה-Unicode המועדפות לשרשוריםnetif, מלבד כתובות מקומיות מסוג קישור וכתובות רשת מקומיות. אם אין כתובת חוקית, מתווספת כתובת ה-EID המקומית ברשת. לקוח ה-SRP נרשם מחדש באופן אוטומטי אם כתובות בשרשורnetifמתווספות או מוסרות או מסומנות כלא מועדפות. - לציין במפורש את רשימת הכתובות של המארחים ולהפריד בין הכתובות ברווח. אפשר להגדיר את הרשימה הזו בזמן שהלקוח פועל. הפעולה הזו תשבית גם את מצב הכתובת האוטומטית של המארח.
דוגמאות
srp client host address auto
Donesrp 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
Donesrp client host name
dev4312
Doneהפניית CLI ו-API
הסרה של מארח לקוח srp
מסיר את פרטי המארח של לקוח ה-SRP ואת כל השירותים משרת ה-SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.
פרמטרים
srp client host remove [removekeylease] [sendunregtoserver]
- הפרמטר
removekeyleaseהוא ערך בוליאני אופציונלי שמציין אם צריך להסיר גם את ערך ה-lease של המפתח המארח (ברירת המחדל היאfalse). - הפרמטר
sendunregtoserverהוא ערך בוליאני אופציונלי שמציין אם מארח הלקוח צריך לשלוח "update" לשרת גם אם פרטי מארח הלקוח עדיין לא רשומים בשרת (ברירת המחדל היא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. מדינות (States) אפשריות:
ToAdd: פריט להוספה/לרישום.Adding: מתבצעת הוספה/רישום של הפריט.ToRefresh: הפריט עובר רענון לצורך חידוש השכירות.Refreshing: הפריט עובר רענון.ToRemove: הפריט יוסר.Removing: מתבצעת הסרה של הפריט.Registered: הפריט רשום בשרת.Removed: הפריט הוסר.
פרמטרים
אין פרמטרים.
דוגמאות
srp client host state
Registered
Doneהפניית CLI ו-API
- אין ממשק API משויך
srp client keyleaseinterval (get,set)
מקבלת או מגדירה את מרווח החכירה של המפתח בשניות.
פרמטרים
srp client keyleaseinterval [interval]
דוגמאות
srp client keyleaseinterval 864000
Donesrp client keyleaseinterval
864000
Doneהפניית CLI ו-API
srp client leaseinterval (get,set)
מקבלת או מגדירה את מרווח החכירה בשניות.
פרמטרים
srp client leaseinterval [interval]
דוגמאות
srp client leaseinterval 3600
Donesrp 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
הפונקציה מקבלת את כתובת השקע (כתובת 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 חייב להיות בפורמט של מחרוזת הקסדצימלית (hex-string), והמערכת תתייחס אליו כאל רצף של בייטים של נתונים מסוג TXT שכבר מקודד.
דוגמאות
srp client service add ins1 _test1._udp 777
Donesrp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Doneהפניית CLI ו-API
מפתח שירות לקוח srp (get,set)
מקבל או מגדיר את מצב ההכללה של רשומת מפתח שירות בלקוח ה-SRP. הפקודה הזו מיועדת לבדיקה בלבד, וכדי להשתמש בה צריך להפעיל את OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.
פרמטרים
אין פרמטרים.
דוגמאות
srp client service key enable
Donesrp 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
Donesrp client ttl
3600
Doneהפניית CLI ו-API
שרת srp (הפעלה,השבתה)
המתג מפעיל או משבית את שרת ה-SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.
פרמטרים
srp server [enable|disable]
דוגמאות
srp server disable
Doneהפניית CLI ו-API
srp Server addrmode (get,set)
הפונקציה מקבלת או מגדירה את מצב הכתובת שמשמש את שרת ה-SRP.
מצב הכתובת מנחה את שרת ה-SRP לקבוע את הכתובת ואת מספר היציאה שלו, שלאחר מכן יפורסמו בנתוני הרשת בפרוטוקול Thread.
פרמטרים
srp server addrmode [anycast|unicast]
דוגמאות
srp server addrmode anycast
Donesrp server addrmode
anycast
Doneהפניית CLI ו-API
שרת srp אוטומטי (הפעלה,השבתה)
המדיניות מפעילה או משביתה את מצב ההפעלה האוטומטית בשרת ה-SRP.
כשהמצב הזה מופעל, Border Routing Manager קובעת אם ומתי להפעיל או להשבית את שרת ה-SRP.
כדי להשתמש בפקודה הזו, צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.
פרמטרים
srp server auto [enable|disable]
דוגמאות
srp server auto enable
Donesrp server auto
Enabled
Doneהפניית CLI ו-API
דומיין שרת srp (get,set)
הפונקציה מקבלת או מגדירה את שם הדומיין של שרת ה-SRP.
פרמטרים
srp server domain [domain-name]
דוגמאות
srp server domain thread.service.arpa.
Donesrp 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 Server lease (get,set)
מקבלת או מגדירה את ערכי החכירה של שרת ה-SRP במספר שניות.
פרמטרים
srp server lease [min-lease max-lease min-key-lease max-key-lease]
דוגמאות
srp server lease 1800 7200 86400 1209600
Donesrp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Doneהפניית CLI ו-API
שרת srp seqnum (get,set)
מקבלת או מגדירה את מספר הרצף שנעשה בו שימוש במצב הכתובת של anycast. מספר הרצף כלול ב'כתובת Anycast של שירות DNS/SRP' שמתפרסם בנתוני הרשת.
פרמטרים
srp server seqnum [seqnum]
דוגמאות
srp server seqnum 20
Donesrp 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
הסמוי הסופי
הפונקציה מחזירה את התפקיד הנוכחי של מכשיר Thread, או משנה את התפקיד כפי שצוין באחת מהאפשרויות. הערכים האפשריים שמוחזרים כששואלים על תפקיד המכשיר:
child: המכשיר פועל כרגע כצאצא של Thread.router: המכשיר פועל כרגע כנתב פרוטוקול Thread.leader: המכשיר פועל כרגע כמנהיג של פרוטוקול Thread.detached: המכשיר לא משתתף כרגע ברשת או במחיצה של פרוטוקול Thread.disabled: מקבץ השרשורים מושבת כרגע.
בעזרת אחת מהאפשרויות אפשר לשנות את התפקיד הנוכחי של המכשיר, כולל החרגה של שינוי למצב disabled או ממנו.
פרמטרים
state [child|router|leader|detached]
דוגמאות
state
child
Donestate 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
Donetcp 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 establishedtcp 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 init, tcp אתחול
הפעלת ה-TCP לדוגמה ונקודת הקצה (endpoint) של TCP לדוגמה שסופקו על ידי ה-CLI tcp.
פרמטרים
tcp init [mode] [size]
- ל
modeיש שלושה ערכים אפשריים:tls: מציינת שחיבור ה-TCP בין שני צמתים צריך להשתמש גם בפרוטוקול TLS מעל ל-TCP. כששני צמתים מתקשרים ב-TCP, שני הצמתים צריכים להשתמש ב-TLS או אף צומת לא יכול להשתמש ב-TLS כי נקודת קצה ללא TLS לא יכולה לתקשר עם נקודת קצה של TLS.linkedאוcircular: אחת מהאפשרויות האלה מציינת שלא להשתמש ב-TLS (אבטחת שכבת התעבורה), וצריך להשתמש בסוג אגירת הנתונים שצוין לצורך אגירת TCP. ההתנהגות שלlinkedושלcircularזהה. כדאי לבדוק את הקוד כדי לראות את ההבדלים בין שני הסוגים האלה של מאגר הנתונים הזמני. שתי נקודות קצה בחיבור TCP לא נדרשות כדי להשתמש באותו סוג אגירת נתונים.
- הפרמטר
sizeמגדיר את גודל מאגר הנתונים הזמני שישויך לנקודת הקצה (endpoint) של 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 sendend
שליחת 'סיום הסטרימינג' אות בחיבור TCP שמשויך לדוגמה של נקודת הקצה של TCP שסופקה על ידי CLI tcp. הפעולה הזו מיידעת את הרשת השכנה שלא תקבל יותר נתונים בחיבור ה-TCP הזה.
פרמטרים
אין פרמטרים.
דוגמאות
tcp sendend
Doneהפניית CLI ו-API
האזנה ל-tcp
מורה ל-TCP לדוגמה להפסיק להאזין לחיבורי TCP נכנסים.
פרמטרים
אין פרמטרים.
דוגמאות
tcp stoplistening
Doneהפניית CLI ו-API
בדיקה tmforiginfilter
המדיניות מפעילה או משביתה את המסנן לשחרור הודעות TMF UDP ממקור לא מהימן.
כברירת מחדל מופעל המסנן שמשחרר הודעות TMF UDP ממקור לא מהימן. כשהאפשרות הזו מושבתת, מותרות הודעות UDP שנשלחות ליציאת ה-TMF שמקורן במקור לא מהימן (כמו מארח, CLI או צומת IPv6 חיצוני).
פרמטרים
test tmforiginfilter [enable|disable]
דוגמאות
test tmforiginfilter
Enabledtest tmforiginfilter enable
Donetest tmforiginfilter disable
Doneהפניית CLI ו-API
- אין ממשק API משויך
התחלת שרשור
התחלת הפעולה של פרוטוקול Thread.
פרמטרים
אין פרמטרים.
דוגמאות
thread start
Doneהפניית CLI ו-API
עצירת שרשור
הפסקת הפעולה של פרוטוקול Thread.
פרמטרים
אין פרמטרים.
דוגמאות
thread stop
Doneהפניית CLI ו-API
- אין ממשק API משויך
גרסת השרשור
הפונקציה מקבלת את הגרסה של פרוטוקול Thread.
הקבועים OT_THREADVERSION* מגדירים את ערכי הגרסה המספריים.
פרמטרים
אין פרמטרים.
דוגמאות
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
timeinqueue
מקבלת את ההיסטוגרמה של משך הזמן לתור להודעות בתור הודעות ב-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.
פרמטרים
trel enable|disable
דוגמאות
trel enable
Donetrel disable
Doneהפניית CLI ו-API
מוני ה-Trel אופסו
איפוס מוני ה-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
Donetrel 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 |
Donetrel 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
Donetvcheck disable
Doneהפניית CLI ו-API
txpower (get,set)
מקבל (או מגדיר באמצעות שימוש בארגומנט txpower האופציונלי) את עוצמת השידור ב-dBm.
פרמטרים
txpower [txpower]
דוגמאות
txpower -10
Donetxpower
-10 dBm
Doneהפניית CLI ו-API
קישור udp
מקצים כתובת IPv6 ויציאה לשקע פתוח, שמחברים את השקע לתקשורת. הקצאת כתובת ויציאה של IPv6 נקראת מתן שם לשקע. מידע נוסף זמין במאמר בדיקת הפונקציונליות של UDP באמצעות OT CLI.
פרמטרים
udp bind [netif] ip port
netif: ממשק הרשת המקושרת, שנקבע כך:- אין ערך (הפרמטר הזה לא מושמט מהפקודה): נעשה שימוש בממשק רשת של פרוטוקול Thread.
-u: ממשק רשת שלא צוין, כלומר סטאק UDP/IPv6 קובע לאיזה ממשק רשת לקשר את השקע.-b: נעשה שימוש בממשק רשת Backbone.
ip: כתובת IPv6 חד-פעמית לקישור. אם רוצים שסטאק ה-UDP/IPv6 יקצה את כתובת ה-IPv6 המקושרת, או אם רוצים לקשר לכתובות IPv6 מרובות, אפשר להשתמש בערך הבא כדי להשתמש בכתובת IPv6 שלא צוינה:::. כל דוגמה משתמשת בכתובת IPv6 שלא צוינה.port: מספר יציאת UDP שאליה צריך לקשר. בכל אחת מהדוגמאות נעשה שימוש ביציאה מספר 1234.
דוגמאות
udp bind :: 1234
Doneudp bind -u :: 1234
Doneudp bind -b :: 1234
Doneהפניית CLI ו-API
UDP קרוב
סגירת שקע UDP/IPv6.
פרמטרים
אין פרמטרים.
דוגמאות
udp close
Doneהפניית CLI ו-API
udp Connect
מחברים שקע 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
Doneudp 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
Doneudp 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
Doneudp send -t hello
Doneudp send -x 68656c6c6f
Doneudp send -s 800
Doneudp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Doneudp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Doneudp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Doneudp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Doneudp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Doneהפניית CLI ו-API
אחזור לא מאובטח
רשימה של כל היציאות מרשימת היציאות הלא מאובטחות שאושרו.
פרמטרים
אין פרמטרים.
דוגמאות
unsecure get
1234
Doneהפניית CLI ו-API
הוספה לא מאובטחת
הוספת יציאה לרשימת היציאות הלא מאובטחות המותרות.
פרמטרים
unsecureport add port
דוגמאות
unsecureport add 1234
Doneהפניית CLI ו-API
הסרה לא מאובטח
הסרה של יציאה שצוינה או של כל היציאות מרשימת היציאות הלא מאובטחות שאושרו.
פרמטרים
unsecureport remove port|all
דוגמאות
unsecureport remove 1234
Doneunsecureport remove all
Doneהפניית CLI ו-API
זמן פעולה תקינה אלפיות השנייה
הפונקציה מחזירה את זמן הפעולה התקינה של המכונה הנוכחית (ב-msec).
נדרשת הפעלה של OPENTHREAD_CONFIG_UPTIME_ENABLE.
זמן הפעולה התקינה מצוין כמספר אלפיות השנייה מאז אתחול מכונת OpenThread.
פרמטרים
אין פרמטרים.
דוגמאות
uptime ms
426238
Doneהפניית CLI ו-API
זמן פעולה תקינה
מחזירה את זמן הפעולה התקינה של המופע הנוכחי כמחרוזת שבודק אנושי יכול לקרוא.
נדרשת הפעלה של OPENTHREAD_CONFIG_UPTIME_ENABLE.
הפורמט של המחרוזת הוא "
אם המחרוזת שמתקבלת לא מתאימה ל-aBuffer (בתוך aSize התווים שלה), המחרוזת תיחתך אבל המחרוזת שהפלטה תיסגר תמיד תהיה null.
פרמטרים
אין פרמטרים.
דוגמאות
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
החלפה של הספק (הגדרה)
מגדירים את מחרוזת גרסת התוכנה של הספק.
נדרש 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 עבור מחרוזת עשרונית נתונה.
נדרש 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