דף זה תורגם על ידי Cloud Translation API.

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

ba Ehemeralkey

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

נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

ba ephemeralkey
active
Done

הפניית CLI ו-API

otBorderAgentIsEphemeralKeyActive

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

otBorderAgentSetEphemeralKeyCallback

בהמה זמנית צלול

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

נדרש OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

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

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

פרמטרים

אין פרמטרים.

דוגמאות

ba ephemeralkey clear
Done

הפניית CLI ו-API

otBorderAgentClearEphemeralKey

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

otBorderAgentSetEphemeralKey

ba id (get,set)

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

פרמטרים

ba id [border-agent-id]

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

דוגמאות

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done

ba id 00112233445566778899aabbccddeeff
Done

הפניית CLI ו-API

ba Port

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

פרמטרים

אין פרמטרים.

דוגמאות

ba port
49153
Done

הפניית CLI ו-API

otBorderAgentGetUdpPort

BA

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

פרמטרים

אין פרמטרים.

דוגמאות

ba state
Started
Done

הפניית CLI ו-API

otBorderAgentGetState

BBR

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

פרמטרים

אין פרמטרים.

דוגמאות

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

bbr
BBR Primary: None
Done

הפניית CLI ו-API

אין ממשק API משויך

bbr 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

otBackboneRouterSetConfig

הגדרת bbr

קבלת התצורה המקומית של נתב עמוד שדרה.

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otBackboneRouterGetConfig

השבתת BBR

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

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

bbr disable
Done

הפניית CLI ו-API

otBackboneRouterSetEnabled

הפעלת BBR

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

bbr enable
Done

הפניית CLI ו-API

otBackboneRouterSetEnabled

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

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

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

פרמטרים

bbr jitter [jitter]

דוגמאות

bbr jitter
20
Done

bbr jitter 10
Done

הפניית CLI ו-API

Bbr mgmt dua

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

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

פרמטרים

bbr mgmt dua status|coap-code [meshLocalIid]

בשביל status או coap-code, משתמשים ב:

0: ST_DUA_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
Done

bbr mgmt dua 160
Done

הפניית CLI ו-API

otBackboneRouterConfigNextDuaRegistrationResponse

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
Done

bbr mgmt mlr listener add ff04::2 300
Done

הפניית CLI ו-API

otBackboneRouterMulticastListenerAdd

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

otBackboneRouterMulticastListenerGetNext

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

otBackboneRouterMulticastListenerClear

תגובת 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

otBackboneRouterConfigNextMulticastListenerRegistrationResponse

רישום BBR

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

bbr register
Done

הפניית CLI ו-API

otBackboneRouterRegister

מצב BBR

הוא מקבל את otBackboneRouterState של Routbone Router.

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

פרמטרים

אין פרמטרים.

דוגמאות

bbr state
Disabled
Done

bbr state
Primary
Done

bbr state
Secondary
Done

הפניית CLI ו-API

otBackboneRouterGetState

השבתה

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

פרמטרים

אין פרמטרים.

דוגמאות

br disable
Done

הפניית CLI ו-API

otBorderRoutingSetEnabled

br הפעלה

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

פרמטרים

אין פרמטרים.

דוגמאות

br enable
Done

הפניית CLI ו-API

otBorderRoutingSetEnabled

br init

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

פרמטרים

br init infrastructure-network-index is-running

דוגמאות

br init 2 1
Done

הפניית CLI ו-API

otBorderRoutingInit

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

otBorderRoutingGetFavoredNat64Prefix

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

otBorderRoutingGetNat64Prefix

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

otBorderRoutingGetFavoredOmrPrefix

קידומת מקומית 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

otBorderRoutingGetOmrPrefix

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

otBorderRoutingGetFavoredOnLinkPrefix

br onlinkprefix מקומי

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

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otBorderRoutingGetOnLinkPrefix

br pd (הפעלה,השבתה)

הפעלה או השבתה של הענקת קידומת DHCPv6.

צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

פרמטרים

br pd enable|disable

דוגמאות

br pd enable
Done

br pd disable
Done

הפניית CLI ו-API

otBorderRoutingDhcp6PdSetEnabled

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

otBorderRoutingGetPdOmrPrefix

מצב PD

הפונקציה מקבלת את המצב הנוכחי של האצלת קידומת DHCPv6.

נדרשת הפעלה של OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

br pd state
running
Done

הפניית CLI ו-API

otBorderRoutingDhcp6PdGetState

אפליקציות להשוואה

להציג את הרשימה של מספרי ה-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

otBorderRoutingGetNextPrefixTableEntry

מספר האפליקציות להשוואה

הפונקציה מחזירה את מספר ה-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

otBorderRoutingCountPeerBrs

טבלת קידומת 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

otBorderRoutingGetNextPrefixTableEntry

br raoptions (set,clear)

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

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

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

פרמטרים

br raoptions options|clear

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

דוגמאות

br raoptions 0400ff00020001
Done

br raoptions clear
Done

הפניית CLI ו-API

otBorderRoutingSetExtraRouterAdvertOptions

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

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

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

פרמטרים

br rioprf [high|med|low]

דוגמאות

br rioprf low
Done

הפניית CLI ו-API

otBorderRoutingSetRouteInfoOptionPreference

בר ריופרף

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

br rioprf
med
Done

הפניית CLI ו-API

otBorderRoutingGetRouteInfoOptionPreference

ברזיל ריופרף ברורה

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

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

פרמטרים

אין פרמטרים.

דוגמאות

br rioprf clear
Done

הפניית CLI ו-API

otBorderRoutingClearRouteInfoOptionPreference

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

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

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

פרמטרים

br routeprf [high|med|low]

דוגמאות

br routeprf low
Done

הפניית CLI ו-API

otBorderRoutingSetRoutePreference

br pathprf

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

ההעדפה נקבעת כך:

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

פרמטרים

אין פרמטרים.

דוגמאות

br routeprf
med
Done

הפניית CLI ו-API

otBorderRoutingGetRoutePreference

br pathprf ברור

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

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

פרמטרים

אין פרמטרים.

דוגמאות

br routeprf clear
Done

הפניית CLI ו-API

otBorderRoutingClearRoutePreference

נתבים 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

otBorderRoutingGetNextRouterEntry

מצב br

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

פרמטרים

אין פרמטרים.

דוגמאות

br state
running

הפניית CLI ו-API

otBorderRoutingGetState

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

otMessageGetBufferInfo

איפוס מאגר המידע הזמני

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

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

פרמטרים

אין פרמטרים.

דוגמאות

bufferinfo reset
Done

הפניית CLI ו-API

otMessageResetBufferInfo

ccathreshold (get,set)

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

פרמטרים

ccathreshold [CCA-threshold-dBm]

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

דוגמאות

ccathreshold
-75 dBm
Done

ccathreshold -62
Done

הפניית CLI ו-API

ערוץ (get,set)

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

פרמטרים

channel [channel-num]

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

דוגמאות

channel
11
Done

channel 11
Done

הפניית CLI ו-API

אין ממשק API משויך

מנהל ערוצים אוטומטי

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

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

השדות OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE או OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE וגם OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE הם שדות חובה.

פרמטרים

channel manager auto enable

1 הוא ערך בוליאני ל-enable.

דוגמאות

channel manager auto 1
channel manager auto 1
Done

הפניית CLI ו-API

otChannelManagerSetAutoChannelSelectionEnabled

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

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

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

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

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

פרמטרים

channel manager change channel-num

דוגמאות

channel manager change 11
channel manager change 11
Done

הפניית CLI ו-API

otChannelManagerRequestChannelChange

מנהל הערוץ

מאתרים את מצב מנהל הערוץ. השדה 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

otChannelManagerGetRequestedChannel

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

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

זמין רק ב-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

otChannelManagerSetDelay

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

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

פרמטרים

channel manager favored mask

דוגמאות

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

הפניית CLI ו-API

otChannelManagerSetFavoredChannels

מרווח זמן ממנהל הערוץ

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

פרמטרים

channel manager interval interval-seconds

דוגמאות

channel manager interval 10800
channel manager interval 10800
Done

הפניית CLI ו-API

otChannelManagerSetAutoChannelSelectionInterval

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

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

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

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

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

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

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

פרמטרים

channel manager select skip-quality-check

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

דוגמאות

channel manager select 1
channel manager select 1
Done

הפניית CLI ו-API

otChannelManagerRequestChannelSelect

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

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

פרמטרים

channel manager supported mask

דוגמאות

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

הפניית CLI ו-API

otChannelManagerSetSupportedChannels

סף מנהל הערוץ

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

פרמטרים

channel manager threshold threshold-percent

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

דוגמאות

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

הפניית CLI ו-API

otChannelManagerSetCcaFailureRateThreshold

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

בודקים את סטטוס המעקב הנוכחי של הערוץ ואת התפוסה בערוץ. השדה 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

otChannelMonitorSetEnabled

תחנת ניטור ערוץ

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

פרמטרים

אין פרמטרים.

דוגמאות

channel monitor stop
channel monitor stop
Done

הפניית CLI ו-API

otChannelMonitorSetEnabled

הערוץ המועדף

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

פרמטרים

אין פרמטרים.

דוגמאות

channel preferred
0x7fff800
Done

הפניית CLI ו-API

otPlatRadioGetPreferredChannelMask

ערוץ נתמך

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

פרמטרים

אין פרמטרים.

דוגמאות

channel supported
0x7fff800
Done

הפניית CLI ו-API

otPlatRadioGetSupportedChannelMask

צאצא (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

otThreadGetChildInfoById

רשימת צאצא

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

פרמטרים

אין פרמטרים.

דוגמאות

child list
1 2 3 6 7 8
Done

הפניית CLI ו-API

otThreadGetChildInfoByIndex

טבלת צאצא

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

פרמטרים

אין פרמטרים.

דוגמאות

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

otThreadGetChildInfoByIndex

Childip

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otThreadGetChildNextIp6Address

Babyip max (מוגדר)

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

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

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

פרמטרים

childip max count

דוגמאות

childip max 2
Done

הפניית CLI ו-API

otThreadSetMaxChildIpAddresses

Babyip Max

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

פרמטרים

אין פרמטרים.

דוגמאות

childip max
4
Done

הפניית CLI ו-API

otThreadGetMaxChildIpAddresses

Kidsmax (set)

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

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

פרמטרים

childmax count

דוגמאות

childmax 2
Done

הפניית CLI ו-API

otThreadSetMaxAllowedChildren

Kidsmax

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

פרמטרים

אין פרמטרים.

דוגמאות

childmax
5
Done

הפניית CLI ו-API

otThreadGetMaxAllowedChildren

Childrenrouterlinks (get,set)

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

פרמטרים

childrouterlinks [links]

דוגמאות

childrouterlinks
16
Done

childrouterlinks 16
Done

הפניית CLI ו-API

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

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

פרמטרים

childsupervision checktimeout timeout-seconds

דוגמאות

childsupervision checktimeout 30
Done

הפניית CLI ו-API

otChildSupervisionSetCheckTimeout

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

childsupervision checktimeout
30
Done

הפניית CLI ו-API

otChildSupervisionGetCheckTimeout

מרווח פיקוח של ילדים (מוגדר)

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

פרמטרים

childsupervision interval interval-seconds

דוגמאות

childsupervision interval 30
Done

הפניית CLI ו-API

otChildSupervisionSetInterval

מרווח בין ילדים

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

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

פרמטרים

אין פרמטרים.

דוגמאות

childsupervision interval
30
Done

הפניית CLI ו-API

otChildSupervisionGetInterval

פסק זמן לילדים (מוגדר)

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

פרמטרים

childtimeout timeout-seconds

דוגמאות

childtimeout 300
Done

הפניית CLI ו-API

otThreadSetChildTimeout

פסק זמן לילדים

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

פרמטרים

אין פרמטרים.

דוגמאות

childtimeout
300
Done

הפניית CLI ו-API

otThreadGetChildTimeout

ביטול Coap

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

פרמטרים

אין פרמטרים.

דוגמאות

coap cancel
Done

הפניית CLI ו-API

תצפית ב-coap

מחיקה במהירות

מחיקה של משאב ה-CoAP שצוין.

פרמטרים

coap delete address uri-path [type] [payload]

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

דוגמאות

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

הפניית CLI ו-API

אין ממשק API משויך

Coap get

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

פרמטרים

coap get address uri-path [type]

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

דוגמאות

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

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

הפניית CLI ו-API

אין ממשק API משויך

צפייה ב-Coap

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

פרמטרים

coap observe address uri-path [type]

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

דוגמאות

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

הפניית CLI ו-API

אין ממשק API משויך

coap 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: 3
- ack_random_factor_denominator: 2
- max_retransmit: 4
ack_timeout: ACK_TIMEOUT (0-UINT32_MAX) באלפיות השנייה. פרטים נוספים זמינים ב-RFC7252.
ack_random_factor_numerator: המונה ACK_RANDOM_FACTOR, עם ערכים אפשריים של 0-255. פרטים נוספים זמינים ב-RFC7252.
ack_random_factor_denominator: המכנה ACK_RANDOM_FACTOR, עם ערכים אפשריים של 0-255. פרטים נוספים זמינים ב-RFC7252.
max_retransmit: MAX_RETRANSMIT (0-255). פרטים נוספים זמינים ב-RFC7252.

דוגמאות

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

coap parameters request default
Transmission parameters for request:
default
Done

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

הפניית CLI ו-API

אין ממשק API משויך

Coap Post

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

פרמטרים

coap post address uri-path [type] [payload]

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

דוגמאות

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

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

הפניית CLI ו-API

אין ממשק API משויך

קואפ פוט

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

פרמטרים

coap put address uri-path [type] [payload]

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

דוגמאות

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

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

הפניית CLI ו-API

אין ממשק API משויך

משאב Coap (get,set)

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

פרמטרים

coap resource [uri-path]

דוגמאות

coap resource test-resource
Done

coap resource
test-resource
Done

הפניית CLI ו-API

מערכת Coap

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

פרמטרים

coap set new-content

דוגמאות

coap set Testing123
Done

הפניית CLI ו-API

התחלת Coap

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

פרמטרים

אין פרמטרים.

דוגמאות

coap start
Done

הפניית CLI ו-API

otCoapStart

עצירת ביניים

עוצר את שרת CoAP.

פרמטרים

אין פרמטרים.

דוגמאות

coap stop
Done

הפניית CLI ו-API

otCoapStop

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

otCoapSecureConnect

מחיקה של 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

otCoapSecureDisconnect

קופס גט

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

פרמטרים

coaps get uri-path [type]

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

דוגמאות

coaps get test-resource
Done

coaps get test-resource block-1024
Done

הפניית CLI ו-API

אין ממשק API משויך

Coaps סגור

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

פרמטרים

אין פרמטרים.

דוגמאות

coaps isclosed
no
Done

הפניית CLI ו-API

otCoapSecureIsClosed

Coaps לא פעיל

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

פרמטרים

אין פרמטרים.

דוגמאות

coaps isconnactive
yes
Done

הפניית CLI ו-API

otCoapSecureIsConnectionActive

Coaps מחובר

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

פרמטרים

אין פרמטרים.

דוגמאות

coaps isconnected
yes
Done

הפניית CLI ו-API

otCoapSecureIsConnected

פוסט ב-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
Done

coaps post test-resource block-1024 10
Done

הפניית CLI ו-API

אין ממשק API משויך

Coaps psk

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

פרמטרים

coaps psk psk-value psk-id

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

דוגמאות

coaps psk 1234 key1
Done

הפניית CLI ו-API

otCoapSecureSetPsk

קאפות פוט

שינוי של משאב 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
Done

coaps 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
Done

coaps resource
test-resource
Done

הפניית CLI ו-API

otCoapSecureAddBlockWiseResource

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
Done

coaps start false
Done

coaps start 8
Done

הפניית CLI ו-API

קופסו

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

פרמטרים

אין פרמטרים.

דוגמאות

coaps stop
Done

הפניית CLI ו-API

otCoapSecureStop

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 שמזהה ערוצים לשליחת הודעות Announce MLE.
count: מספר השידורים מסוג MLE Announce לכל ערוץ.
period: מספר אלפיות השנייה בין העברות MLE Announce רצופות.
destination: כתובת IPv6 של היעד של ההודעה. יכול להיות שההודעה לכמה שידורים.

דוגמאות

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

הפניית CLI ו-API

אנרגיית נציב

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

פרמטרים

commissioner energy mask count period scanDuration destination

mask: 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
Done

commissioner id
OpenThread Commissioner
Done

הפניית CLI ו-API

otCommissionerSetId

הוספת נציבות

הוספת רשומת מצטרפים (join).

פרמטרים

commissioner joiner add eui64|discerner pksd [timeout]

eui64: IEEE EUI-64 של השותף. כדי לבצע התאמה לכל איחוד, צריך להשתמש בפונקציה *.
discerner: הכלי לאיחוד (join) בפורמט number/length.
pksd: מפתח משותף מראש לאיחוד.
timeout: הזמן הקצוב לתפוגה של ההצטרפות, בשניות.

דוגמאות

commissioner joiner add d45e64fa83f81cf7 J01NME
Done

commissioner joiner add 0xabc/12 J01NME
Done

הפניית CLI ו-API

הסרת נציבות הנציבות

מסירה רשומה של 'הצטרפות'.

פרמטרים

commissioner joiner remove eui64|discerner

eui64: IEEE EUI-64 של החבר. כדי לבצע התאמה לכל איחוד, צריך להשתמש בפונקציה *.
discerner: הכלי לאיחוד (join) בפורמט number/length.

דוגמאות

commissioner joiner remove d45e64fa83f81cf7
Done

commissioner 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

otCommissionerSendMgmtGet

מנהל הקהילה

שולחת הודעת 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

otCommissionerSendMgmtSet

קומיש פניד

נשלחת שאילתה עם מספר חשבון קבוע (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

otCommissionerSetProvisioningUrl

מזהה סשן של נציב

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

פרמטרים

אין פרמטרים.

דוגמאות

commissioner sessionid
0
Done

הפניית CLI ו-API

otCommissionerGetSessionId

התחלת נציבות

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

פרמטרים

אין פרמטרים.

דוגמאות

commissioner start
Commissioner: petitioning
Done
Commissioner: active

הפניית CLI ו-API

otCommissionerStart

מדינת הנציב

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

פרמטרים

אין פרמטרים.

דוגמאות

commissioner state
active
Done

הפניית CLI ו-API

otCommissionerState

עצירת נציב

הפסקת התפקיד 'נציב שרשורים'.

פרמטרים

אין פרמטרים.

דוגמאות

commissioner stop
Done

הפניית CLI ו-API

otCommissionerStop

contextreusedelay (get,set)

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

פרמטרים

contextreusedelay delay

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

דוגמאות

contextreusedelay
11
Done

contextreusedelay 11
Done

הפניית CLI ו-API

מונה (Mac)

מוצאים את מוני השכבות של ה-MAC.

פרמטרים

counters mac

דוגמאות

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

הפניית CLI ו-API

otLinkGetCounters

מונה (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

otThreadGetMleCounters

דלפקים

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

פרמטרים

אין פרמטרים.

דוגמאות

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

otThreadGetIp6Counters

איפוס IP מונה

איפוס המוני IPv6.

פרמטרים

counters ip reset

דוגמאות

counters ip reset
Done

הפניית CLI ו-API

otThreadResetIp6Counters

מוני איפוס Mac

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

פרמטרים

counters mac reset

דוגמאות

counters mac reset
Done

הפניית CLI ו-API

otLinkResetCounters

מוני איפוס mle

איפוס מוני ה-thread MLE.

פרמטרים

counters mle reset

דוגמאות

counters mle reset
Done

הפניית CLI ו-API

otThreadResetMleCounters

ערוץ CSS

מגדיר את ערוץ ה-CSL.

פרמטרים

csl channel channel

דוגמאות

csl channel 20
Done

הפניית CLI ו-API

otLinkSetCslChannel

שירות 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

otLinkSetCslPeriod

זמן קצוב לתפוגה של שירות CSS

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

פרמטרים

csl timeout timeout

דוגמאות

cls timeout 10
Done

הפניית CLI ו-API

otLinkSetCslTimeout

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

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

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

dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

הפניית CLI ו-API

otDatasetGetActive

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

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

פרמטרים

dataset activetimestamp [timestamp]

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

דוגמאות

dataset activetimestamp
123456789
Done

dataset activetimestamp 123456789
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

dataset channel [channel-num]

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

דוגמאות

dataset channel
12
Done

dataset channel 12
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

dataset channelmask [channel-mask]

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

דוגמאות

dataset channelmask
0x07fff800
Done

dataset channelmask 0x07fff800
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

אין פרמטרים.

דוגמאות

dataset clear
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

אין פרמטרים.

דוגמאות

dataset commit active
Done

הפניית CLI ו-API

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

dataset commit pending
Done

הפניית CLI ו-API

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

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

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

פרמטרים

dataset delay [delay]

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

דוגמאות

dataset delay
1000
Done

dataset delay 1000
Done

הפניית CLI ו-API

otDatasetSetDelayTimerMinimal

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

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

פרמטרים

dataset extpanid [extpanid]

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

דוגמאות

dataset extpanid
000db80123456789
Done

dataset extpanid 000db80123456789
Done

הפניית CLI ו-API

dataset pskc (get,set)

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

קבלת רשימה של 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

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

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

פרמטרים

dataset meshlocalprefix [meshlocalprefix]

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

דוגמאות

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

dataset meshlocalprefix fd00:db8:0:0::
Done

הפניית CLI ו-API

אין ממשק API משויך

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

שולח MGMT_ACTIVE_GET.

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

פרמטרים

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

משתמשים ב-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
Done

dataset 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
Done

dataset 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
Done

dataset networkkey 00112233445566778899aabbccddeeff
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

dataset networkname [name]

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

דוגמאות

dataset networkname
OpenThread
Done

dataset networkname OpenThread
Done

הפניית CLI ו-API

dataset pskc (get,set)

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

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

פרמטרים

dataset panid [panid]

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

דוגמאות

dataset panid
0x1234
Done

dataset panid 0x1234
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

dataset pendingtimestamp [timestamp]

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

דוגמאות

dataset pendingtimestamp
123456789
Done

dataset pendingtimestamp 123456789
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

פרמטרים

dataset pskc [-p passphrase] | [key]

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

דוגמאות

dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

dataset pskc -p 123456
Done

dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

הפניית CLI ו-API

אין ממשק API משויך

מדיניות אבטחה של מערך נתונים (get,set)

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

פרמטרים

dataset securitypolicy [rotationtime [onrcCepR]]

יש להשתמש ב-rotationtime במשך thrKeyRotation, ביחידות של שעות.
פקודות מדיניות אבטחה משתמשות במיפויי הארגומנטים onrcCepR כדי לקבל ולהגדיר חברים ב-otSecurityPolicy. לדוגמה, o מייצג את otSecurityPolicy::mObtainNetworkKeyEnabled. מידע נוסף זמין במאמר הצגה וניהול של מערכי נתונים באמצעות OT CLI.

דוגמאות

dataset securitypolicy
672 onrc
Done

dataset securitypolicy 672 onrc
Done

הפניית CLI ו-API

אין ממשק API משויך

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

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

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

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

אם הערוץ לא כלול במערך הנתונים, המכשיר ישלח הודעות 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
Done

dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

הפניית CLI ו-API

otDatasetSetActive

מערך נתונים tlvs

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

פרמטרים

אין פרמטרים.

דוגמאות

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

הפניית CLI ו-API

otDatasetConvertToTlvs

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

@dataset updater cancel
Done

הפניית CLI ו-API

otDatasetUpdaterCancelUpdate

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

dataset updater
Enabled
Done

הפניית CLI ו-API

otDatasetUpdaterIsUpdateOngoing

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

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

האפשרות הזו זמינה כשהאפשרות 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

otDatasetUpdaterRequestUpdate

ניפוי באגים

מפעיל סדרה של פקודות 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

otDatasetSetDelayTimerMinimal

עיכוב זמן

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

פרמטרים

אין פרמטרים.

דוגמאות

delaytimermin
30
Done

הפניית CLI ו-API

otDatasetGetDelayTimerMinimal

ניתוק אסינכרוני

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

פרמטרים

אין פרמטרים.

דוגמאות

detach async
Done

הפניית CLI ו-API

ניתוק

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

פרמטרים

אין פרמטרים.

דוגמאות

detach
Finished detaching
Done

הפניית CLI ו-API

otThreadDetachGracefully

devicepros (מוגדר)

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

פרמטרים

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

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

דוגמאות

deviceprops battery 0 0 0 -5
Done

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

הפניית CLI ו-API

משקל מנהיגים
משקל מנהיג (set)
otThreadSetDeviceProperties

deviceprops

הצגת מאפייני המכשיר הנוכחיים.

נדרש OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otThreadGetDeviceProperties

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

otThreadDiscover

לגלות reqcallback (הפעלה,השבתה)

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

פרמטרים

discover reqcallback enable|disable

דוגמאות

discover reqcallback enable
Done

הפניית CLI ו-API

otThreadSetDiscoveryRequestCallback

עיון ב-DNS

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

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

פרמטרים

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

דוגמאות

dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=6531, b=6c12] TTL:7300
instance2
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=1234] TTL:7300
Done

dns browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
    Port:7000, Priority:0, Weight:0, TTL:10
    Host:Mac-mini.default.service.arpa.
    HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done

הפניית CLI ו-API

otDnsClientBrowse

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

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

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

פרמטרים

dns compression [enable|disable]

דוגמאות

dns compression enable
Enabled

dns compression disable
Done
dns compression
Disabled
Done

הפניית CLI ו-API

otDnsSetNameCompressionEnabled

דחיסת DNS

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

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

פרמטרים

dns compression [enable|disable]

דוגמאות

dns compression
Enabled

הפניית CLI ו-API

otDnsIsNameCompressionEnabled

תצורת 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
Done

dns 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
Done

dns config fd00::2
Done

dns 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

otDnsClientSetDefaultConfig

הגדרות 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

otDnsClientGetDefaultConfig

התאמת DNS

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

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

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

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

פרמטרים

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

דוגמאות

dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300

dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done

הפניית CLI ו-API

otDnsClientResolveAddress

שירות DNS

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

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

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

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

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

פרמטרים

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

דוגמאות

הפניית CLI ו-API

otDnsClientResolveService

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 ברזולוציית מופע שירות של מופע שירות מסוים עם רזולוציה פוטנציאלית לשם המארח. התווית של מופע השירות מופיעה ראשונה, ואחריה שם השירות (חשוב לזכור שתווית מופע השירות יכולה להכיל את התו '.').

פרמטרים

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

דוגמאות

הפניית CLI ו-API

otDnsClientResolveServiceAndHostAddress

domainname (set)

מגדיר את שם הדומיין של פרוטוקול ה-Thread.

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

פרמטרים

domainname name

צריך להשתמש ב-backslash כדי לסמן בתו בריחה (escape) רווחים.

דוגמאות

domainname Test\ Thread
Done

הפניית CLI ו-API

otThreadSetDomainName

שם דומיין

מקבל את שם הדומיין של פרוטוקול ה-Thread.

פרמטרים

אין פרמטרים.

דוגמאות

domainname
Thread
Done

הפניית CLI ו-API

otThreadGetDomainName

dua iid (הגדרה,ניקוי)

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

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

פרמטרים

dua iid iid|clear

dua iid clear מעביר nullptr אל otThreadSetFixedDuaInterfaceIdentifier. אחרת, אפשר להעביר את iid.

דוגמאות

dua iid 0004000300020001
Done

dua iid clear
Done

הפניית CLI ו-API

otThreadSetFixedDuaInterfaceIdentifier

Duo iid

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

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

פרמטרים

אין פרמטרים.

דוגמאות

dua iid
0004000300020001
Done

הפניית CLI ו-API

otThreadGetFixedDuaInterfaceIdentifier

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

otThreadGetNextCacheEntry

eui64

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

פרמטרים

אין פרמטרים.

דוגמאות

eui64
0615aae900124b00
Done

הפניית CLI ו-API

otPlatRadioGetIeeeEui64

extaddr (הגדרה)

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

פרמטרים

extaddr extaddr

דוגמאות

extaddr dead00beef00cafe
dead00beef00cafe
Done

הפניית CLI ו-API

otLinkSetExtendedAddress

extaddr

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

פרמטרים

אין פרמטרים.

דוגמאות

extaddr
dead00beef00cafe
Done

הפניית CLI ו-API

otLinkGetExtendedAddress

extpanid (מוגדר)

מגדיר את מזהה מספר החשבון הקבוע (PAN) המורחב של IEEE 802.15.4.

פרמטרים

extpanid extpanid

דוגמאות

extpanid dead00beef00cafe
Done

הפניית CLI ו-API

otThreadSetExtendedPanId

extpanid

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

פרמטרים

אין פרמטרים.

דוגמאות

extpanid
dead00beef00cafe
Done

הפניית CLI ו-API

otThreadGetExtendedPanId

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

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

פרמטרים

אין פרמטרים.

דוגמאות

factoryreset

הפניית CLI ו-API

otInstanceFactoryReset

זיוף (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

otThreadSendAddressNotification

Fem

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

פרמטרים

אין פרמטרים.

דוגמאות

fem
LNA gain 11 dBm
Done

הפניית CLI ו-API

otPlatRadioGetFemLnaGain

fem lenagain (get)

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

פרמטרים

אין פרמטרים.

דוגמאות

fem lnagain
11
Done

הפניית CLI ו-API

otPlatRadioGetFemLnaGain

fem lenagain (set)

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

פרמטרים

אין פרמטרים.

דוגמאות

fem lnagain 8
Done

הפניית CLI ו-API

otPlatRadioSetFemLnaGain

היסטוריה ב-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 |
Done

history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done

הפניית CLI ו-API

היסטוריה אייפד

מציג את היסטוריית כתובות ה-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 |
Done

history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done

הפניית CLI ו-API

עם היסטוריה

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

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

גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט: hours:minutes:seconds:milliseconds
סוג: Child או Router.
אירוע: הערכים האפשריים הם Added, Removed או Changed.
כתובת מורחבת
RLOC16
מצב: מצב קישור MLE. ערכים אפשריים:
- -: לא הוגדרו סימונים (rx-off-בזמן-לא פעיל, מכשיר 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 |
Done

history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done

הפניית CLI ו-API

otHistoryTrackerIterateNeighborHistory

היסטוריה 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 |
Done

history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done

history netinfo 2
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:02:05.451 | router   | rdn  | 0x6000 |    151029327 |
|         00:04:04.719 | child    | rdn  | 0x2001 |    151029327 |
Done

הפניית CLI ו-API

otHistoryTrackerIterateNetInfoHistory

תחילית ההיסטוריה

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

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

גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט: 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 |
Done

history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done

הפניית CLI ו-API

otHistoryTrackerIterateOnMeshPrefixHistory

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

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

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

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

פרמטרים

history route [list] [num-entries]

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

דוגמאות

history route
| Age                  | Event   | Route                                       | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:05.456 | Removed | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:29.310 | Added   | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:42.822 | Added   | fd00:1111:0::/48                            | s         | med  | 0x5400 |
|         00:01:27.688 | Added   | fd00:aaaa:bbbb:cccc::/64                    | s         | med  | 0x8800 |
Done

history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done

הפניית CLI ו-API

otHistoryTrackerIterateExternalRouteHistory

נתב היסטוריה

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

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

גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט: 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 |
Done

history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done

הפניית CLI ו-API

otHistoryTrackerIterateRouterHistory

היסטוריה rx

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

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

גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט: hours:minutes:seconds:milliseconds
סוג:
- סוג הודעה של IPv6, כמו UDP, TCP, HopOpts ו-ICMP6 (וסוג המשנה שלו).
- src: כתובת IPv6 ומספר יציאה של המקור.
- dst: כתובת IPv6 של היעד ומספר יציאה (מספר היציאה תקין ל-UDP/TCP, אחרת הוא 0).
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                                             |
Done

history rx list 4
00:00:13.368
    type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
    src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
    type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
    type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
    dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done

הפניית CLI ו-API

otHistoryTrackerIterateRxHistory

היסטוריה RXtx

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

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

גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט: hours:minutes:seconds:milliseconds
סוג:
- סוג הודעה של IPv6, כמו UDP, TCP, HopOpts ו-ICMP6 (וסוג המשנה שלו).
- src: כתובת IPv6 ומספר יציאה של המקור.
- dst: כתובת IPv6 של היעד ומספר יציאה (מספר היציאה תקין ל-UDP/TCP, אחרת הוא 0).
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                                             |
Done

history rxtx list 5
00:00:02.100
    type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
    src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
    type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
    type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
    dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
    type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
    dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done

הפניית CLI ו-API

היסטוריה טקסס

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

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

גיל: הזמן שעבר מאז הנפקת הפקודה, וניתן בפורמט: hours:minutes:seconds:milliseconds
סוג:
- סוג הודעה של IPv6, כמו UDP, TCP, HopOpts ו-ICMP6 (וסוג המשנה שלו).
- src: כתובת IPv6 ומספר יציאה של המקור.
- dst: כתובת IPv6 של היעד ומספר יציאה (מספר היציאה תקין ל-UDP/TCP, אחרת הוא 0).
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                                             |
Done

history tx list
00:00:23.957
    type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
    dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
    type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
    type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
    type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[ff02:0:0:0:0:0:0:2]:19788
Done

הפניית CLI ו-API

otHistoryTrackerIterateTxHistory

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

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

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

פרמטרים

ifconfig up|down

דוגמאות

ifconfig up
Done

ifconfig down
Done

הפניית CLI ו-API

otIp6SetEnabled

ifconfig

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

פרמטרים

אין פרמטרים.

דוגמאות

ifconfig
down
Done

ifconfig
up
Done

הפניית CLI ו-API

otIp6IsEnabled

instanceid

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

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

פרמטרים

אין פרמטרים.

דוגמאות

instanceid
468697314
Done

הפניית CLI ו-API

otInstanceGetId

הוספת אייפד

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

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

פרמטרים

ipaddr add aAddress

דוגמאות

ipaddr add 2001::dead:beef:cafe
Done

הפניית CLI ו-API

otIp6AddUnicastAddress

ipaddr דל, אייפד דל

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

פרמטרים

ipaddr del aAddress

דוגמאות

ipaddr del 2001::dead:beef:cafe
Done

הפניית CLI ו-API

otIp6RemoveUnicastAddress

אייפד

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

פרמטרים

ipaddr [-v]

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

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

דוגמאות

ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done

הפניית CLI ו-API

otIp6GetUnicastAddresses

ipaddr linklocal

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

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otThreadGetLinkLocalIp6Address

ipaddr mleid

הפונקציה מקבלת את כתובת ה-EID המקומית של Mesh.

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otThreadGetMeshLocalEid

ipaddr rloc

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otThreadGetRloc

הוספה של ipmaddr

רושם את ממשק פרוטוקול Thread לכתובת Multicast בממשק רשת.

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

פרמטרים

ipmaddr add aAddress

דוגמאות

ipmaddr add ff05::1
Done

הפניית CLI ו-API

otIp6SubscribeMulticastAddress

אייפדר דל

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

פרמטרים

ipmaddr del aAddress

דוגמאות

ipmaddr del ff05::1
Done

הפניית CLI ו-API

otIp6UnsubscribeMulticastAddress

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

otIp6GetMulticastAddresses

אייפדר לאטן

מקבל את כתובת 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

otThreadGetLinkLocalAllThreadNodesMulticastAddress

אייפדר רלטן

מקבל את כתובת 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

otThreadGetRealmLocalAllThreadNodesMulticastAddress

joinerdiserner (מוגדר)

מגדיר את דיסקרנר (joiner Discerner).

פרמטרים

joiner discerner discerner

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

דוגמאות

joiner discerner 0xabc/12
Done

הפניית CLI ו-API

otJoinerSetDiscerner

דיסקרנר ברור

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

פרמטרים

אין פרמטרים.

דוגמאות

joiner discerner clear
Done

הפניית CLI ו-API

אין ממשק API משויך

דיסקרנר לאיחוד (joiner)

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

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

פרמטרים

אין פרמטרים.

דוגמאות

joiner discerner
0xabc/12
Done

הפניית CLI ו-API

otJoinerGetDiscerner

עזרה במצטרפים חדשים

הדפסה של תפריט העזרה של 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

otJoinerGetId

התחלת איחוד (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

otJoinerStart

מצב איחוד (joiner)

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

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

Idle
Discover
Connecting
Connected
Entrust
Joined

פרמטרים

אין פרמטרים.

דוגמאות

joiner state
Idle
Done

הפניית CLI ו-API

otJoinerGetState

עצירת ביניים

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

פרמטרים

אין פרמטרים.

דוגמאות

joiner stop
Done

הפניית CLI ו-API

otJoinerStop

Joinerport (set)

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

פרמטרים

joinerport udp-port

דוגמאות

joinerport 1000
Done

הפניית CLI ו-API

otThreadSetJoinerUdpPort

Joinerport

מקבלת את יציאת ה-UDP של Joiner.

פרמטרים

אין פרמטרים.

דוגמאות

joinerport
1000
Done

הפניית CLI ו-API

otThreadGetJoinerUdpPort

מונה מפתחות (מוגדר)

מגדיר את thrKeySequenceCounter.

פרמטרים

keysequence counter counter

דוגמאות

keysequence counter 10
Done

הפניית CLI ו-API

otThreadSetKeySequenceCounter

מונה מפתחות

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

פרמטרים

אין פרמטרים.

דוגמאות

keysequence counter
10
Done

הפניית CLI ו-API

otThreadGetKeySequenceCounter

זמן שמירה על רצף מקשים (מוגדר)

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

פרמטרים

keysequence guardtime guardtime-hours

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

דוגמאות

keysequence guardtime 0
Done

הפניית CLI ו-API

otThreadSetKeySwitchGuardTime

זמן שמירה על רצף מקשים

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

פרמטרים

אין פרמטרים.

דוגמאות

keysequence guardtime
0
Done

הפניית CLI ו-API

otThreadGetKeySwitchGuardTime

Leaddata

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otThreadGetLeaderData

משקל מנהיג (set)

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

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

פרמטרים

leaderweight weight

דוגמאות

leaderweight 128
Done

הפניית CLI ו-API

otThreadSetLocalLeaderWeight

משקל מנהיג

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

פרמטרים

אין פרמטרים.

דוגמאות

leaderweight
128
Done

הפניית CLI ו-API

otThreadGetLocalLeaderWeight

הגדרת 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

otLinkMetricsConfigEnhAckProbing

הגדרה של 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

otLinkMetricsConfigEnhAckProbing

הגדרת 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

otLinkMetricsConfigForwardTrackingSeries

בדיקת קישור

נשלחת הודעה של בדיקת קישור 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

otLinkMetricsSendLinkProbe

בקשת 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

otLinkMetricsQuery

בקשת 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

otLinkMetricsQuery

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

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

פרמטרים

linkmetricsmgr enable|disable

דוגמאות

linkmetricmgr enable
Done

linkmetricmgr disable
Done

הפניית CLI ו-API

otLinkMetricsManagerSetEnabled

תוכנית linkmetricsmgr

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

פרמטרים

אין פרמטרים.

דוגמאות

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

הפניית CLI ו-API

otLinkMetricsManagerGetMetricsValueByExtAddr

אתר (הגדרה)

מחפשים את היעד הקרוב ביותר של כתובת 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

otThreadLocateAnycastDestination

לאתר

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

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

פרמטרים

אין פרמטרים.

דוגמאות

locate
Idle
Done

locate fdde:ad00:beef:0:0:ff:fe00:fc10

locate
In Progress
Done

הפניית CLI ו-API

otThreadIsAnycastLocateInProgress

שם קובץ ביומן

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

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

פרמטרים

log filename filename

דוגמאות

הפניית CLI ו-API

otPlatDebugUart_logfile

רמת היומן (הגדרה)

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

פרמטרים

log level level

דוגמאות

log level 4
Done

הפניית CLI ו-API

otLoggingSetLevel

רמת היומן

מאתרים את רמת היומן.

פרמטרים

אין פרמטרים.

דוגמאות

log level
1
Done

הפניית CLI ו-API

otLoggingGetLevel

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

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

פרמטרים

mac retries direct [number]

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

דוגמאות

mac retries direct
3
Done

mac retries direct 5
Done

הפניית CLI ו-API

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

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

פרמטרים

mac retries indirect [number]

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

דוגמאות

mac retries indirect
3
Done

 max retries indirect 5
Done

הפניית CLI ו-API

שליחה ב-Mac

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

פרמטרים

mac send datarequest | emptydata

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

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

דוגמאות

mac send datarequest
Done

mac send emptydata
Done

הפניית CLI ו-API

הוספה של macfilter

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

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

פרמטרים

macfilter addr add extaddr [rss]

דוגמאות

macfilter addr add 0f6127e33af6b403 -95
Done

macfilter addr add 0f6127e33af6b402
Done

הפניית CLI ו-API

otLinkFilterAddAddress

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

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

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr allowlist
Done

הפניית CLI ו-API

otLinkFilterSetAddressMode

ניקוי של תוסף macfilter

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

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

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr clear
Done

הפניית CLI ו-API

otLinkFilterClearAddresses

רשימת הישויות שנחסמו

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

פרמטרים

אין פרמטרים.

דוגמאות

macfilter addr denylist
Done

הפניית CLI ו-API

otLinkFilterSetAddressMode

השבתה של תוסף 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

otLinkFilterGetAddressMode

הסרת תוסף macfilter

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

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

פרמטרים

macfilter addr remove extaddr

דוגמאות

macfilter addr remove 0f6127e33af6b402
Done

הפניית CLI ו-API

otLinkFilterRemoveAddress

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
Done

macfilter rss add 0f6127e33af6b404 -85
Done

הפניית CLI ו-API

otLinkFilterAddRssIn

macfilter rss add-lqi

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

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

פרמטרים

macfilter rss add-lqi extaddr lqi

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

דוגמאות

macfilter rss add-lqi * 3
Done

macfilter rss add-lqi 0f6127e33af6b404 2
Done

הפניית CLI ו-API

Macfilter rss ניקוי

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

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

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

פרמטרים

אין פרמטרים.

דוגמאות

macfilter rss clear
Done

הפניית CLI ו-API

otLinkFilterClearAllRssIn

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

otLinkFilterGetNextRssIn

הסרה של macfilter rss

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

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

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

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

פרמטרים

macfilter rss remove extaddr

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

דוגמאות

macfilter rss remove *
Done

macfilter rss remove 0f6127e33af6b404
Done

הפניית CLI ו-API

otLinkFilterRemoveRssIn

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

otMeshDiagQueryChildrenIp6Addrs

שולחן ילדים בסגנון 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

otMeshDiagQueryRouterNeighborTable

טופולוגיית Meshdiag

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

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

מידע לכל נתב:

מזהה הנתב
RLOC16
כתובת MAC מורחבת
גרסת ה-thread (אם ידועה)
אם הנתב הוא המכשיר הזה הוא עצמו (me)
אם הנתב הוא ההורה של המכשיר הזה כשהמכשיר הוא ילד (parent)
האם הנתב הוא leader
האם הנתב משמש כנתב גבול שמספק קישוריות חיצונית (br)
רשימת נתבים שאליהם יש לנתב הזה קישור:
- 3-links: מזהי נתב שאליהם יש לנתב קישור נכנס עם איכות קישור 3
- 2-links: מזהי נתב שאליהם יש לנתב הזה קישור נכנס עם איכות קישור 2
- 1-links: מזהי נתב שאליהם יש לנתב הזה קישור נכנס עם איכות קישור 1
- אם רשימה ריקה, היא לא מופיעה בחוץ.
אם הערך הוא ip6-addrs, רשימה של כתובות IPv6 של הנתב
אם הערך הוא children, רשימה של כל הצאצאים של הנתב. מידע לכל ילד:
- RLOC16
- איכות הקישורים הנכנסים מנקודת המבט של ההורה אל הילד או הילדה (אפס מצביע על לא ידוע)
- מצב מכשיר צאצא (r RX במצב לא פעיל, 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

otMeshDiagDiscoverTopology

mleadvimax

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

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

פרמטרים

אין פרמטרים.

דוגמאות

mleadvimax
12000
Done

הפניית CLI ו-API

otThreadGetAdvertisementTrickleIntervalMax

mliid

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

נדרש OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

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

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

פרמטרים

mliid iid

דוגמאות

mliid 1122334455667788
Done

הפניית CLI ו-API

otIp6SetMeshLocalIid

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
Done

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

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

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

הפניית CLI ו-API

otIp6RegisterMulticastListeners

מצב (get,set)

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

פרמטרים

mode [rdn]

-: לא הוגדרו סימונים (rx-off-בזמן-לא פעיל, מכשיר Thread מינימלי, נתוני רשת יציבים)
r: RX-במצב לא פעיל
d: מכשיר בפרוטוקול Thread מלא
n: נתוני רשת מלאים

דוגמאות

mode rdn
Done

mode -
Done

הפניית CLI ו-API

otThreadSetLinkMode

רב-רדיו

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

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

פרמטרים

אין פרמטרים.

דוגמאות

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

otMultiRadioGetNeighborInfo

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

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

צריך להפעיל את OPENTHREAD_CONFIG_MULTI_RADIO.

פרמטרים

multiradio neighbor ext-address

דוגמאות

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

הפניית CLI ו-API

otMultiRadioGetNeighborInfo

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
Done

nat64 disable
Done

הפניית CLI ו-API

otNat64SetEnabled

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

otNat64GetCidr

מוני 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

otNat64GetNextAddressMapping

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

otThreadGetNextNeighborInfo

netdata מלא

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

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

פרמטרים

אין פרמטרים.

דוגמאות

netdata full
no
Done

הפניית CLI ו-API

otBorderRouterSetNetDataFullCallback

איפוס מלא של netdata

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

פרמטרים

אין פרמטרים.

דוגמאות

netdata full reset
Done

הפניית CLI ו-API

אין ממשק API משויך

אורך netdata

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

פרמטרים

אין פרמטרים.

דוגמאות

netdata length
23
Done

הפניית CLI ו-API

otNetDataGetLength

אורך מקסימלי נטו נתונים

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

פרמטרים

אין פרמטרים.

דוגמאות

netdata maxlength
40
Done

הפניית CLI ו-API

otNetDataGetMaxLength

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

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

פרמטרים

אין פרמטרים.

דוגמאות

netdata maxlength reset
Done

הפניית CLI ו-API

otNetDataResetMaxLength

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

otNetDataPublishOnMeshPrefix

החלפה של פרסום ב-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

otNetDataReplacePublishedExternalRoute

נתיב פרסום netdata

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

פרמטרים

publish route prefix [sn] [high|med|low]

דוגמאות

netdata publish route fd00:1234:5678::/64 s high
Done

הפניית CLI ו-API

otNetDataPublishExternalRoute

רישום 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
Done

netdata 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

otNetDataUnpublishPrefix

netdata ביטול פרסום dnssrp

ביטול הפרסום של כל רשומה של שירות DNS/SRP (Anycast או Unicast) שנוספו בעבר מנתוני רשת Thread.

צריך להפעיל את OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

netdata unpublish dnssrp
Done

הפניית CLI ו-API

otNetDataUnpublishDnsSrpService

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

otUdpGetSockets

אחזור אבחון רשת

נשלחת בקשה לאבחון הרשת כדי לאחזר ערכי אורך סוג (TLV) שצוינו עבור הכתובות שצוינו.

פרמטרים

networkdiagnostic get addr type(s)

עבור addr, כתובת בחיבור unicast מפעילה Diagnostic Get. כתובת Multicast מפעילה Diagnostic Query. ערכי TLV שאפשר לציין (מופרדים ברווח אם מציינים יותר מ-TLV אחד):

0: TLV של כתובת מורחבת של MAC
1: כתובת 16 (TLV)
2: מצב TLV
3: זמן קצוב לתפוגה של דגימת נתונים (TLV) (משך הזמן המקסימלי לקלפי SED)
4: TLV קישוריות
5: כביש 64 (TLV)
6: מבוא לנתוני בכירים
7: מרכז המידע על נתוני רשת
8: TLV לרשימת כתובות IPv6
9: מוני MAC
14: זמן אמת (TLV) ברמת הסוללה
15: TLV במתח אספקה
16: TLV שולחן צאצא
17: מרכז המידע על דפי ערוצים
19: הזמן המקסימלי לתפוגה של חשבון צאצא
23: EUI64 TLV
24: גרסת TLV (מספר הגרסה של הפרוטוקולים והתכונות)
25: שם הספק (TLV)
26: TLV של דגם ספק
27: TLV של גרסת SW של ספק
28: גרסת TLV של מקבץ Thread (מזהה גרסה כמחרוזת UTF-8 ל-codebase/commit/version של מקבץ Thread)
29: עלות משלוח לילדים (TLV)
34: MLE Counters TLV
35: קובץ 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
Done

networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done

הפניית CLI ו-API

otThreadSendDiagnosticGet

איפוס לאבחון הרשת

נשלחת בקשה לאבחון הרשת לאיפוס ערכי אורך הסוג (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

otThreadSendDiagnosticReset

networkidtimeout (get,set)

מקבלת או מגדירה את הפרמטר NETWORK_ID_TIMEOUT.

פרמטרים

networkidtimeout [timeout]

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

דוגמאות

networkidtimeout 120
Done

networkidtimeout
120
Done

הפניית CLI ו-API

מפתח רשת (מפתח)

מגדירים את מפתח הרשת של פרוטוקול Thread.

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

פרמטרים

networkkey key

דוגמאות

networkkey 00112233445566778899aabbccddeeff
Done

הפניית CLI ו-API

otThreadSetNetworkKey

מפתח רשת

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

פרמטרים

אין פרמטרים.

דוגמאות

networkkey
00112233445566778899aabbccddeeff
Done

הפניית CLI ו-API

otThreadGetNetworkKey

שם רשת (שם)

מגדירים את שם הרשת של פרוטוקול Thread.

פרמטרים

networkname name

דוגמאות

networkname OpenThread
Done

הפניית CLI ו-API

otThreadSetNetworkName

שם הרשת

מקבלים את השם של רשת פרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

networkname
OpenThread
Done

הפניית CLI ו-API

otThreadGetNetworkName

זמן רשת (מוגדר)

הגדרת הפרמטרים של סנכרון הזמן.

timesyncperiod: פרק הזמן לסנכרון הזמן, בשניות.
xtalthreshold: סף הדיוק XTAL שמכשיר הופך למכשיר עם יכולות נתב, ב-PPM.

פרמטרים

networktime timesyncperiod xtalthreshold

דוגמאות

networktime 100 300
Done

הפניית CLI ו-API

זמן רשת

הפונקציה מקבלת את זמן הרשת של פרוטוקול Thread ואת הפרמטרים של סנכרון הזמן.

פרמטרים

אין פרמטרים.

דוגמאות

networktime
Network Time:     21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold:   300ppm
Done

הפניית CLI ו-API

nexthop (get)

מקבל את הצעד הבא ואת העלות של הנתיב הבא ליעד נתון של RLOC16.

אפשר להשתמש בערך הזה גם כשהערך בשדה aNextHopRloc16 או הערך aPathCost הוא NULL, שמציין שהמתקשר לא רוצה לקבל את הערך הזה.

פרמטרים

nexthop rloc16

דוגמאות

nexthop 0xc000
0xc000 cost:0
Done

nexthop 0x8001
0x2000 cost:3
Done

הפניית CLI ו-API

otThreadGetNextHopAndPathCost

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

otLinkSetPanId

פאניד

מקבלים את מזהה מספר החשבון הקבוע (PAN) של IEEE 802.15.4.

פרמטרים

אין פרמטרים.

דוגמאות

panid
0xdead
Done

הפניית CLI ו-API

otLinkGetPanId

הורה

קבלת פרטי האבחון של נתב 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

otThreadGetParentInfo

חיפוש להורים

התחלה של תהליך החיפוש של הורה טוב יותר, תוך שמירה על החיבור להורה הנוכחי.

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

פרמטרים

אין פרמטרים.

דוגמאות

parent search
Done

הפניית CLI ו-API

otThreadSearchForBetterParent

הורה-עדיפות (get,set)

הפונקציה מקבלת או מגדירה את ערך העדיפות של ההורה שהוקצה: 1, 0, 1- או 2-. המשמעות של -2 היא לא מוקצה.

פרמטרים

parentpriority [parentpriority]

דוגמאות

parentpriority
1
Done

parentpriority 1
Done

הפניית CLI ו-API

partitionid

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

פרמטרים

אין פרמטרים.

דוגמאות

partitionid
4294967295
Done

הפניית CLI ו-API

otThreadGetPartitionId

partitionid מועדף (get,set)

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

פרמטרים

partitionid preferred partitionid

דוגמאות

partitionid preferred
4294967295
Done

partitionid preferred 0xffffffff
Done

הפניית CLI ו-API

platform

הדפסת הפלטפורמה הנוכחית

פרמטרים

אין פרמטרים.

דוגמאות

platform
NRF52840
Done

הפניית CLI ו-API

אין ממשק API משויך

segmentperiod (get,set)

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

פרמטרים

אין פרמטרים.

דוגמאות

pollperiod
0
Done

pollperiod 10
Done

הפניית CLI ו-API

מועדף

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

פרמטרים

preferrouterid routerid

דוגמאות

preferrouterid 16
Done

הפניית CLI ו-API

otThreadSetPreferredRouterId

הוספת תחילית

הפונקציה מוסיפה קידומת חוקית לנתוני הרשת.

פרמטרים

prefix add prefix [padcrosnD] [high|med|low]

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

דוגמאות

prefix add 2001:dead:beef:cafe::/64 paros med
Done

prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done

הפניית CLI ו-API

otBorderRouterAddOnMeshPrefix

תחילית 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

otBorderRouterGetNextOnMeshPrefix

הסרת תחילית

הסרת הגדרה של נתב גבול מנתוני הרשת המקומית.

פרמטרים

אין פרמטרים.

דוגמאות

prefix remove 2001:dead:beef:cafe::/64
Done

הפניית CLI ו-API

otBorderRouterRemoveOnMeshPrefix

לא תקין (הפעלה,השבתה)

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

פרמטרים

promiscuous enable|disable

דוגמאות

promiscuous enable
Done

promiscuous disable
Done

הפניית CLI ו-API

otLinkSetPromiscuous

פרוץ

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

פרמטרים

אין פרמטרים.

דוגמאות

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

otThreadGetPskc

pskcref (set)

מגדירים את ה-Key Reference ל-Thread PSKc.

נדרשת הפעלה של תכונת זמן ה-build OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

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

פרמטרים

pskc keyref

דוגמאות

pskc 0x20017
Done

הפניית CLI ו-API

otThreadSetPskcRef

pskcref

קבלת הפניית מפתח לשרשור PSKc של פרוטוקול Thread.

נדרשת הפעלה של תכונת זמן ה-build OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

פרמטרים

אין פרמטרים.

דוגמאות

pskcref
0x80000000
Done

הפניית CLI ו-API

otThreadGetPskcRef

רדיו (הפעלה,השבתה)

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

פרמטרים

radio enable|disable

דוגמאות

radio enable
Done

radio disable
Done

הפניית CLI ו-API

otLinkSetEnabled

ניקוי נתונים סטטיסטיים של רדיו

איפוס הנתונים הסטטיסטיים של הרדיו.

כל השעות אופסו ל-0.

פרמטרים

אין פרמטרים.

דוגמאות

radio stats clear
Done

הפניית CLI ו-API

otRadioTimeStatsReset

נתונים סטטיסטיים של רדיו

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

הנתונים הסטטיסטיים של הרדיו כוללים את השעה שבה הרדיו נמצא במצב 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

otRadioTimeStatsGet

גרסת RCP

מקבלים את המחרוזת של גרסת הרדיו.

פרמטרים

אין פרמטרים.

דוגמאות

rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun  4 2020 17:53:16
Done

הפניית CLI ו-API

otPlatRadioGetVersionString

אזור (מוגדר)

מגדיר את קידומת האזור.

הפורמט של אזור רדיו הוא ייצוג ASCII של 2 בייטים של קוד ISO 3166 alpha-2.

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

פרמטרים

אין פרמטרים.

דוגמאות

region US
Done

הפניית CLI ו-API

otLinkSetRegion

region

מקבלים את קידומת החיוג האזורית.

הפורמט של אזור רדיו הוא ייצוג ASCII של 2 בייטים של קוד ISO 3166 alpha-2.

פרמטרים

אין פרמטרים.

דוגמאות

region
US
Done

הפניית CLI ו-API

otLinkGetRegion

ניתוב מחדש (ניתוב)

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

פרמטרים

releaserouterid [routerid]

דוגמאות

releaserouterid 16
Done

הפניית CLI ו-API

otThreadReleaseRouterId

rloc16

מורידים את ה-RLOC16.

פרמטרים

אין פרמטרים.

דוגמאות

rloc16
0xdead
Done

הפניית CLI ו-API

otThreadGetRloc16

הוספת נתיב

בשביל פרמטרים, משתמשים כך:

s: דגל יציב
n: דגל NAT64
prf: העדפת נתב ברירת מחדל, [גבוהה, בינונית, נמוכה].

צריך להוסיף נתיב חיצוני חוקי לנתוני הרשת.

פרמטרים

route add prefix [sn] [high|med|low]

דוגמאות

route add 2001:dead:beef:cafe::/64 s med
Done

הפניית CLI ו-API

otExternalRouteConfig

הסרת מסלול

מסירים הגדרה של נתיב חיצוני מנתוני הרשת המקומית.

פרמטרים

route remove [prefix]

דוגמאות

route remove 2001:dead:beef:cafe::/64
Done

הפניית CLI ו-API

otBorderRouterRemoveRoute

נתיב

הצגת רשימת הנתיבים החיצוניים בנתוני הרשת המקומיים.

פרמטרים

אין פרמטרים.

דוגמאות

route
2001:dead:beef:cafe::/64 s med
Done

הפניית CLI ו-API

otBorderRouterGetNextRoute

נתב (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
Done

router 0xc800
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 7
Done

הפניית CLI ו-API

otThreadGetRouterInfo

רשימת נתבים

הצגת רשימה של מזהי הנתבים שהוקצו.

פרמטרים

אין פרמטרים.

דוגמאות

router list
8 24 50
Done

הפניית CLI ו-API

otThreadGetRouterInfo

טבלת נתבים

מדפיסה רשימה של נתבים בפורמט של טבלה.

פרמטרים

אין פרמטרים.

דוגמאות

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

otThreadGetRouterInfo

substitutedowndownthreshold (get,set)

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

פרמטרים

routerdowngradethreshold [threshold]

דוגמאות

 routerdowngradethreshold
23
Done

 routerdowngradethreshold 23
Done

הפניית CLI ו-API

נתב כשיר (הפעלה,השבתה)

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

פרמטרים

routereligible [enable|disable]

דוגמאות

routereligible enable
Done

routereligible disable
Done

הפניית CLI ו-API

otThreadSetRouterEligible

כשיר לנתב

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

פרמטרים

אין פרמטרים.

דוגמאות

routereligible
Enabled
Done

הפניית CLI ו-API

otThreadIsRouterEligible

routerselectionjitter

מקבל או מגדיר את הערך ROUTER_SELECTION_JITTER.

פרמטרים

routerselectionjitter [jitter]

דוגמאות

routerselectionjitter
120
Done

routerselectionjitter 120
Done

הפניית CLI ו-API

networkupgradethreshold (get,set)

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

פרמטרים

routerupgradethreshold [threshold]

דוגמאות

routerupgradethreshold
16
Done

routerupgradethreshold 16
Done

הפניית CLI ו-API

סריקת אנרגיה

מבצע סריקת אנרגיה של IEEE 802.15.4 ומציג את הזמן באלפיות השנייה שיש להשתמש בסריקת כל ערוץ. כל הערוצים מוצגים, אלא אם מציינים ערוץ מסוים באמצעות האפשרות 'ערוץ'.

פרמטרים

scan energy [duration] [channel]

דוגמאות

scan energy 10
| Ch | RSSI |
+----+------+
| 11 |  -59 |
| 12 |  -62 |
| 13 |  -67 |
| 14 |  -61 |
| 15 |  -87 |
| 16 |  -86 |
| 17 |  -86 |
| 18 |  -52 |
| 19 |  -58 |
| 20 |  -82 |
| 21 |  -76 |
| 22 |  -82 |
| 23 |  -74 |
| 24 |  -81 |
| 25 |  -88 |
| 26 |  -71 |
Done

scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 |  -82 |
Done

הפניית CLI ו-API

otLinkEnergyScan

סריקה

מבצע סריקה פעילה של IEEE 802.15.4. אם לא צוין ערוץ, הסריקה תכסה את כל הערוצים. אחרת, הטווח יכסה רק את הערוץ שצוין.

פרמטרים

scan [channel]

דוגמאות

scan
| PAN  | MAC Address      | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

הפניית CLI ו-API

otLinkActiveScan

הוספת שירות

הוספת שירות לנתוני הרשת.

EnterpriseNumber: מספר ארגון IANA
serviceData: נתוני שירות בינאריים בקידוד הקסדצימלי
ServerData: נתוני שרת בינארי בקידוד הקסדצימלי (ריק אם לא צוין)

פרמטרים

service add enterpriseNumber serviceData [serverData]

דוגמאות

service add 44970 112233 aabbcc
Done

netdata register
Done

הפניית CLI ו-API

הסרת שירות

הסרת השירות מנתוני הרשת.

EnterpriseNumber: מספר ארגון IANA
serviceData: נתוני שירות בינאריים בקידוד הקסדצימלי

פרמטרים

service remove enterpriseNumber serviceData

דוגמאות

service remove 44970 112233
Done

netdata register
Done

הפניית CLI ו-API

singleton

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

פרמטרים

אין פרמטרים.

דוגמאות

singleton
true
Done

הפניית CLI ו-API

otThreadIsSingleton

שאילתת 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)
Done

sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done

הפניית CLI ו-API

otSntpClientQuery

הפעלה אוטומטית של לקוח srp (get)

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client autostart
Disabled
Done

הפניית CLI ו-API

otSrpClientIsAutoStartModeEnabled

השבתה אוטומטית של הפעלה אוטומטית של לקוח srp

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

השבתת מצב ההפעלה האוטומטית לא גורמת להפסקה של לקוח פועל. עם זאת, לקוח ה-SRP מפסיק לעקוב אחרי נתוני הרשת בפרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

srp client autostart disable
Done

הפניית CLI ו-API

otSrpClientDisableAutoStartMode

הפעלה אוטומטית של לקוח srp

הפעלת מצב הפעלה אוטומטית.

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

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

רשומות חד-פעמיות שבהן כתובת השרת נכללת בנתוני השירות. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.
רשומות Anycast שלכל אחת מהן יש מספר סידורי. עדיף להשתמש במספר הרצף הגדול ביותר כפי שצוין בלוגיקת מספרים סידוריים ב-RFC-1982.
רשומות חד-פעמיות שבהן פרטי כתובת השרת כלולים בנתוני השרת. אם יש כמה אפשרויות, עדיפה האפשרות עם כתובת ה-IPv6 המספרית הנמוכה ביותר.

פרמטרים

אין פרמטרים.

דוגמאות

srp client autostart enable
Done

הפניית CLI ו-API

otSrpClientEnableAutoStartMode

קריאה חוזרת של לקוח srp (קבלה,הפעלה,השבתה)

קבלה או הפעלה או השבתה של אירועי קריאה חוזרת של הדפסה מלקוח ה-SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.

פרמטרים

srp client callback [enable|disable]

דוגמאות

srp client callback enable
Done

srp client callback
Enabled
Done

הפניית CLI ו-API

otSrpClientSetCallback

כתובת מארח של לקוח srp (get)

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client host address
auto
Done

srp client host address
fd00:0:0:0:0:0:0:1234
fd00:0:0:0:0:0:0:beef
Done

הפניית CLI ו-API

otSrpClientGetHostInfo

כתובת מארח של לקוח srp (הגדרה)

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

פרמטרים

srp client host address [auto|address...]

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

דוגמאות

srp client host address auto
Done

srp client host address fd00::cafe
Done

הפניית CLI ו-API

ניקוי מארח של לקוח srp

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client host clear
Done

הפניית CLI ו-API

שם מארח של לקוח srp (get,set)

מקבל או מגדיר את שם המארח של לקוח ה-SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.

פרמטרים

srp client host name [name]

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

דוגמאות

srp client host name dev4312
Done

srp client host name
dev4312
Done

הפניית CLI ו-API

otSrpClientSetHostName

הסרה של מארח לקוח 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

otSrpClientGetHostInfo

מצב מארח של לקוח 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
Done

srp client keyleaseinterval
864000
Done

הפניית CLI ו-API

srp client leaseinterval (get,set)

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

פרמטרים

srp client leaseinterval [interval]

דוגמאות

srp client leaseinterval 3600
Done

srp client leaseinterval
3600
Done

הפניית CLI ו-API

כתובת שרת לקוח srp

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done

הפניית CLI ו-API

אין ממשק API משויך

יציאת שרת לקוח srp

מחזירה את מספר היציאה של השרת.

פרמטרים

אין פרמטרים.

דוגמאות

srp client server port
4724
Done

הפניית CLI ו-API

אין ממשק API משויך

שרת לקוח srp

הפונקציה מקבלת את כתובת השקע (כתובת IPv6 ומספר יציאה) של שרת ה-SRP שבו משתמש לקוח ה-SRP. אם הלקוח לא פועל, לא מצוינת הכתובת (כל האפסים) ומספר היציאה 0. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done

הפניית CLI ו-API

otSrpClientGetServerAddress

הוספה של שירות לקוח 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
Done

srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done

הפניית CLI ו-API

otSrpClientAddService

מפתח שירות לקוח srp (get,set)

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client service key enable
Done

srp client service key
Enabled
Done

הפניית CLI ו-API

otSrpClientIsServiceKeyRecordEnabled

השם של שירות הלקוח ב-srp, ברור

ניקוי שירות, הסרה מיידית שלו מרשימת שירותי הלקוח, ללא אינטראקציה עם שרת ה-SRP.

פרמטרים

srp client service clear instancename servicename

דוגמאות

srp client service clear ins2 _test2._udp
Done

הפניית CLI ו-API

otSrpClientClearService

הסרת שירות לקוח srp

מבקשת לבטל את הרישום של שירות בשרת ה-SRP.

פרמטרים

srp client service remove instancename servicename

דוגמאות

srp client service remove ins2 _test2._udp
Done

הפניית CLI ו-API

otSrpClientRemoveService

שירות לקוח 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

otSrpClientGetServices

התחלת לקוח srp

התחלת פעולת לקוח SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.

פרמטרים

srp client start serveraddr serverport

דוגמאות

srp client start fd00::d88a:618b:384d:e760 4724
Done

הפניית CLI ו-API

otSrpClientStart

מצב לקוח srp

מציין אם לקוח ה-SRP פועל או לא.

פרמטרים

אין פרמטרים.

דוגמאות

srp client state
Enabled
Done

הפניית CLI ו-API

otSrpClientIsRunning

עצירת לקוח ב-srp

הפסקת הפעולה של לקוח ה-SRP.

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

פרמטרים

אין פרמטרים.

דוגמאות

srp client stop
Done

הפניית CLI ו-API

otSrpClientStop

srp client ttl (get,set)

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

פרמטרים

srp client ttl [value]

דוגמאות

srp client ttl 3600
Done

srp client ttl
3600
Done

הפניית CLI ו-API

שרת srp (הפעלה,השבתה)

המתג מפעיל או משבית את שרת ה-SRP. מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.

פרמטרים

srp server [enable|disable]

דוגמאות

srp server disable
Done

הפניית CLI ו-API

otSrpServerSetEnabled

srp Server addrmode (get,set)

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

מצב הכתובת מנחה את שרת ה-SRP לקבוע את הכתובת ואת מספר היציאה שלו, שלאחר מכן יפורסמו בנתוני הרשת בפרוטוקול Thread.

פרמטרים

srp server addrmode [anycast|unicast]

דוגמאות

srp server addrmode anycast
Done

srp 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
Done

srp server auto
Enabled
Done

הפניית CLI ו-API

דומיין שרת srp (get,set)

הפונקציה מקבלת או מגדירה את שם הדומיין של שרת ה-SRP.

פרמטרים

srp server domain [domain-name]

דוגמאות

srp server domain thread.service.arpa.
Done

srp server domain
thread.service.arpa.
Done

הפניית CLI ו-API

מארח שרת srp

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

פרמטרים

אין פרמטרים.

דוגמאות

srp server host
srp-api-test-1.default.service.arpa.
    deleted: false
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0.default.service.arpa.
    deleted: false
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done

הפניית CLI ו-API

srp 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
Done

srp 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
Done

srp server seqnum
20
Done

הפניית CLI ו-API

שירות שרת srp

מחזירה מידע על שירותים רשומים.

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

פרמטרים

אין פרמטרים.

דוגמאות

srp server service
srp-api-test-1._ipps._tcp.default.service.arpa.
    deleted: false
    subtypes: (null)
    port: 49152
    priority: 0
    weight: 0
    ttl: 7200
    lease: 7200
    key-lease: 1209600
    TXT: [616263, xyz=585960]
    host: srp-api-test-1.default.service.arpa.
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0._ipps._tcp.default.service.arpa.
    deleted: false
    subtypes: _sub1,_sub2
    port: 49152
    priority: 0
    weight: 0
    ttl: 3600
    lease: 3600
    key-lease: 1209600
    TXT: [616263, xyz=585960]
    host: srp-api-test-0.default.service.arpa.
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done

הפניית CLI ו-API

מצב שרת srp

מחזירה את אחד מהמצבים האפשריים הבאים של שרת ה-SRP:

disabled: שרת ה-SRP לא מופעל.
stopped: שרת ה-SRP מופעל אבל לא פעיל בגלל שרתי SRP קיימים שכבר פעילים ברשת בפרוטוקול Thread. שרת ה-SRP עשוי להיות פעיל כששרתי ה-SRP הקיימים לא יהיו פעילים יותר ברשת פרוטוקול Thread.
running: שרת ה-SRP פעיל ויכול לטפל ברישומי שירותים.

מידע נוסף זמין במאמר בנושא הגדרת פרוטוקול רישום שירות (SRP) קישוריות שרת-לקוח עם OT CLI.

פרמטרים

אין פרמטרים.

דוגמאות

srp server state
running
Done

הפניית CLI ו-API

otSrpServerGetState

הסמוי הסופי

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

child: המכשיר פועל כרגע כצאצא של Thread.
router: המכשיר פועל כרגע כנתב פרוטוקול Thread.
leader: המכשיר פועל כרגע כמנהיג של פרוטוקול Thread.
detached: המכשיר לא משתתף כרגע ברשת או במחיצה של פרוטוקול Thread.
disabled: מקבץ השרשורים מושבת כרגע.

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

פרמטרים

state [child|router|leader|detached]

דוגמאות

state
child
Done

state leader
Done

הפניית CLI ו-API

ביטול tcp

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

פרמטרים

אין פרמטרים.

דוגמאות

tcp abort
TCP: Connection reset
Done

הפניית CLI ו-API

otTcpAbort

תוצאת בנצ'מרק של tcp

הצגת התוצאה העדכנית של בדיקת ההשוואה לשוק של TCP. ערכי סטטוס אפשריים:

מתמשך
הושלם
לא נבדק

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

פרמטרים

אין פרמטרים.

דוגמאות

tcp benchmark result
TCP Benchmark Status: Ongoing
Done

tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s

הפניית CLI ו-API

אין ממשק API משויך

הרצת נקודת ההשוואה tcp

מעבירה את מספר הבייטים שצוין באמצעות חיבור ה-TCP שמשויך כרגע לנקודת הקצה לדוגמה של TCP שסופקה על ידי ה-CLI של tcp.

פרמטרים

tcp benchmark run [size]

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

דוגמאות

tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s

הפניית CLI ו-API

אין ממשק API משויך

קישור tcp

משייך כתובת IPv6 ויציאה לנקודת הקצה לדוגמה של TCP שסופקה על ידי ה-CLI של tcp. שיוך של נקודת הקצה של TCP לכתובת וליציאה של IPv6 נקרא 'מתן שם לנקודת הקצה של TCP'. המערכת מקשרת את נקודת הקצה לתקשורת. מידע נוסף זמין במאמר בדיקת הפונקציונליות של TCP באמצעות OT CLI.

פרמטרים

tcp bind ip port

ip: כתובת IPv6 שאליה רוצים לקשר. אם רוצים שמקבץ TCP/IPv6 יקצה את כתובת IPv6 המקשר, צריך להשתמש בכתובת IPv6 שלא צוינה: ::.
port: מספר יציאת TCP שאליה יתבצע קישור.

דוגמאות

tcp bind :: 30000
Done

הפניית CLI ו-API

otTcpBind

tcp Connect

יוצר חיבור עם האפליקציה להשוואה שצוינה.

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

פרמטרים

tcp connect ip port [fastopen]

ip: כתובת IP של האפליקציה השכנה יכולה להיות כתובת IPv4, שעוברת מסונתזת לכתובת IPv6 באמצעות קידומת NAT64 המועדפת מנתוני הרשת. הפקודה מחזירה InvalidState כשהקידומת המועדפת של NAT64 לא זמינה.
port: מספר יציאת ה-TCP של האפליקציה להשוואה.
fastopen: הפרמטר הזה הוא אופציונלי. אם המדיניות מוגדרת לערך fast, פתיחה מהירה של TCP מופעלת בחיבור הזה. אחרת, אם הפרמטר הזה מוגדר לערך slow או לא משתמשים בו, התכונה 'פתיחה מהירה של TCP' מושבתת.

דוגמאות

tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established

tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

הפניית CLI ו-API

otTcpConnect

tcp Deinit

אתחול נקודת הקצה של TCP.

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

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

פרמטרים

אין פרמטרים.

דוגמאות

tcp deinit
Done

הפניית CLI ו-API

otTcpEndpointDeinitialize

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

otTcpListen

שליחה ב-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

otTcpSendEndOfStream

האזנה ל-tcp

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

פרמטרים

אין פרמטרים.

דוגמאות

tcp stoplistening
Done

הפניית CLI ו-API

otTcpStopListening

בדיקה tmforiginfilter

המדיניות מפעילה או משביתה את המסנן לשחרור הודעות TMF UDP ממקור לא מהימן.

כברירת מחדל מופעל המסנן שמשחרר הודעות TMF UDP ממקור לא מהימן. כשהאפשרות הזו מושבתת, מותרות הודעות UDP שנשלחות ליציאת ה-TMF שמקורן במקור לא מהימן (כמו מארח, CLI או צומת IPv6 חיצוני).

פרמטרים

test tmforiginfilter [enable|disable]

דוגמאות

test tmforiginfilter
Enabled

test tmforiginfilter enable
Done

test tmforiginfilter disable
Done

הפניית CLI ו-API

אין ממשק API משויך

התחלת שרשור

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

פרמטרים

אין פרמטרים.

דוגמאות

thread start
Done

הפניית CLI ו-API

otThreadSetEnabled

עצירת שרשור

הפסקת הפעולה של פרוטוקול Thread.

פרמטרים

אין פרמטרים.

דוגמאות

thread stop
Done

הפניית CLI ו-API

אין ממשק API משויך

גרסת השרשור

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

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

פרמטרים

אין פרמטרים.

דוגמאות

 thread version
2
Done

הפניית CLI ו-API

otThreadGetVersion

מקסימום זמן

הפונקציה מקבלת את הזמן המקסימלי בתור להודעות בתור הודעות ב-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

otThreadResetTimeInQueueStat

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
Done

trel disable
Done

הפניית CLI ו-API

otTrelSetEnabled

מוני ה-Trel אופסו

איפוס מוני ה-TREL.

פרמטרים

אין פרמטרים.

דוגמאות

trel counters reset
Done

הפניית CLI ו-API

otTrelResetCounters

מוני טרל

הפונקציה מקבלת את מוני ה-TREL.

פרמטרים

אין פרמטרים.

דוגמאות

trel counters
Inbound:  Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done

הפניית CLI ו-API

otTrelGetCounters

מסנן רכיב (הפעלה,השבתה)

המתג מפעיל או משבית את המסנן 'TREL'.

פרמטרים

trel filter enable|disable

דוגמאות

trel filter enable
Done

trel filter disable
Done

הפניית CLI ו-API

otTrelSetFilterEnabled

פילטר טרל

מציין אם מצב המסנן TREL מופעל.

כשמצב המסנן מופעל, כל תעבורת הנתונים של Rx ו-Tx שנשלחת דרך ממשק TREL מושמטת.

פרמטרים

אין פרמטרים.

דוגמאות

trel filter
Disabled
Done

הפניית CLI ו-API

otTrelIsFilterEnabled

טרל עמיתים

הפונקציה מקבלת את הטבלה של האפליקציות להשוואה ב-TREL בפורמט של טבלה או רשימה.

פרמטרים

trel peers [list]

דוגמאות

trel peers
| No  | Ext MAC Address  | Ext PAN Id       | IPv6 Socket Address                              |
+-----+------------------+------------------+--------------------------------------------------+
|   1 | 5e5785ba3a63adb9 | f0d9c001f00d2e43 | [fe80:0:0:0:cc79:2a29:d311:1aea]:9202            |
|   2 | ce792a29d3111aea | dead00beef00cafe | [fe80:0:0:0:5c57:85ba:3a63:adb9]:9203            |
Done

trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done

הפניית CLI ו-API

otTrelGetNextPeer

טרל

מציין אם פעולת TREL מופעלת.

פרמטרים

אין פרמטרים.

דוגמאות

trel
Enabled
Done

הפניית CLI ו-API

otTrelIsEnabled

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

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

פרמטרים

אין פרמטרים.

דוגמאות

tvcheck enable
Done

tvcheck disable
Done

הפניית CLI ו-API

otThreadSetThreadVersionCheckEnabled

txpower (get,set)

מקבל (או מגדיר באמצעות שימוש בארגומנט txpower האופציונלי) את עוצמת השידור ב-dBm.

פרמטרים

txpower [txpower]

דוגמאות

txpower -10
Done

txpower
-10 dBm
Done

הפניית CLI ו-API

קישור udp

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

פרמטרים

udp bind [netif] ip port

netif: ממשק הרשת המקושרת, שנקבע כך:
- אין ערך (הפרמטר הזה לא מושמט מהפקודה): נעשה שימוש בממשק רשת של פרוטוקול Thread.
- -u: ממשק רשת שלא צוין, כלומר סטאק UDP/IPv6 קובע לאיזה ממשק רשת לקשר את השקע.
- -b: נעשה שימוש בממשק רשת Backbone.
ip: כתובת IPv6 חד-פעמית לקישור. אם רוצים שסטאק ה-UDP/IPv6 יקצה את כתובת ה-IPv6 המקושרת, או אם רוצים לקשר לכתובות IPv6 מרובות, אפשר להשתמש בערך הבא כדי להשתמש בכתובת IPv6 שלא צוינה: ::. כל דוגמה משתמשת בכתובת IPv6 שלא צוינה.
port: מספר יציאת UDP שאליה צריך לקשר. בכל אחת מהדוגמאות נעשה שימוש ביציאה מספר 1234.

דוגמאות

udp bind :: 1234
Done

udp bind -u :: 1234
Done

udp bind -b :: 1234
Done

הפניית CLI ו-API

otUdpBind

UDP קרוב

סגירת שקע UDP/IPv6.

פרמטרים

אין פרמטרים.

דוגמאות

udp close
Done

הפניית CLI ו-API

otUdpClose

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
Done

udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

הפניית CLI ו-API

otUdpConnect

udp linksecurity (הפעלה,השבתה)

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

פרמטרים

אין פרמטרים.

דוגמאות

udp linksecurity enable
Done

udp linksecurity disable
Done

הפניית CLI ו-API

אין ממשק API משויך

אבטחת קישורים ב-UDP

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

פרמטרים

אין פרמטרים.

דוגמאות

udp linksecurity
Enabled
Done

הפניית CLI ו-API

אין ממשק API משויך

udp פתוח

פותחים שקע UDP/IPv6.

פרמטרים

אין פרמטרים.

דוגמאות

udp open
Done

הפניית CLI ו-API

otUdpOpen

שליחת UDP

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

פרמטרים

udp send [ip port] [type] value

הערכים ip ו-port הם אופציונליים כצמד, אבל אם מציינים אחד מהם צריך לציין את השני. אם ip ו-port לא מצוינים, נעשה שימוש בכתובת שכנה של השקע מ-udp connect.

ip: כתובת היעד. כתובת זו יכולה להיות כתובת IPv4 או IPv6, כתובת IPv4 מסונתזת לכתובת IPv6 עם קידומת NAT64 המועדפת מנתוני הרשת. (אם קידומת NAT64 המועדפת לא זמינה, הפקודה תחזיר InvalidState).
port: יציאת יעד UDP.
type/value שילובים:
- -t: המטען הייעודי (payload) בפרמטר value מטופל כטקסט. אם לא מזינים ערך של type, המטען הייעודי (Payload) בפרמטר value נחשב גם לטקסט.
- -s: מטען ייעודי (payload) שנוצר באופן אוטומטי באורך שצוין בפרמטר value.
- -x: נתונים בינאריים בייצוג הקסדצימלי שניתן בפרמטר value.

דוגמאות

udp send hello
Done

udp send -t hello
Done

udp send -x 68656c6c6f
Done

udp send -s 800
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done

udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done

הפניית CLI ו-API

udp פתוח
קישור udp
udp Connect
otUdpSend

אחזור לא מאובטח

רשימה של כל היציאות מרשימת היציאות הלא מאובטחות שאושרו.

פרמטרים

אין פרמטרים.

דוגמאות

unsecure get
1234
Done

הפניית CLI ו-API

otIp6GetUnsecurePorts

הוספה לא מאובטחת

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

פרמטרים

unsecureport add port

דוגמאות

unsecureport add 1234
Done

הפניית CLI ו-API

otIp6AddUnsecurePort

הסרה לא מאובטח

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

פרמטרים

unsecureport remove port|all

דוגמאות

unsecureport remove 1234
Done

unsecureport remove all
Done

הפניית CLI ו-API

זמן פעולה תקינה אלפיות השנייה

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

נדרשת הפעלה של OPENTHREAD_CONFIG_UPTIME_ENABLE.

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

פרמטרים

אין פרמטרים.

דוגמאות

uptime ms
426238
Done

הפניית CLI ו-API

otInstanceGetUptime

זמן פעולה תקינה

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

נדרשת הפעלה של OPENTHREAD_CONFIG_UPTIME_ENABLE.

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

ד.::." (אם יותר מיום).

אם המחרוזת שמתקבלת לא מתאימה ל-aBuffer (בתוך aSize התווים שלה), המחרוזת תיחתך אבל המחרוזת שהפלטה תיסגר תמיד תהיה null.

פרמטרים

אין פרמטרים.

דוגמאות

uptime
12:46:35.469
Done

הפניית CLI ו-API

otInstanceGetUptimeAsString

ספק 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

otThreadSetVendorAppUrl

כתובת URL של ספק

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

פרמטרים

אין פרמטרים.

דוגמאות

vendor appurl
http://www.example.com
Done

הפניית CLI ו-API

otThreadGetVendorAppUrl

מודל ספק (קבוצה)

מגדירים את המחרוזת של מודל הספק.

נדרש 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

otThreadSetVendorModel

מודל ספק

מקבלים את המחרוזת של מודל הספק.

פרמטרים

אין פרמטרים.

דוגמאות

vendor model
Hub Max
Done

הפניית CLI ו-API

otThreadGetVendorModel

שם ספק (הגדרה)

מגדירים את המחרוזת של שם הספק.

נדרש 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

otThreadSetVendorName

שם הספק

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

פרמטרים

אין פרמטרים.

דוגמאות

vendor name
nest
Done

הפניית CLI ו-API

otThreadGetVendorName

החלפה של הספק (הגדרה)

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

נדרש 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

otThreadSetVendorSwVersion

החלפה של הספק

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

פרמטרים

אין פרמטרים.

דוגמאות

vendor swversion
Marble3.5.1
Done

הפניית CLI ו-API

otThreadGetVendorSwVersion

חישוב ורפוף

מחשבת את סיכום הביקורת Verhoeff עבור מחרוזת עשרונית נתונה.

נדרש OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

פרמטרים

verhoeff calculate decimalstring

דוגמאות

verhoeff calculate 30731842
1
Done

הפניית CLI ו-API

otVerhoeffChecksumCalculate

אימות verhoeff

מאמתת את סיכום הביקורת Verhoeff עבור מחרוזת עשרונית נתונה.

נדרש OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

פרמטרים

verhoeff validate decimalstring

דוגמאות

verhoeff validate 307318421
Done

הפניית CLI ו-API

otVerhoeffChecksumValidate

גרסה API

מדפיסה את מספר הגרסה של ה-API.

פרמטרים

אין פרמטרים.

דוגמאות

version api
28
Done

הפניית CLI ו-API

אין ממשק API משויך

גרסה

הפונקציה מקבלת את מחרוזת הגרסה של OpenThread.

פרמטרים

אין פרמטרים.

דוגמאות

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done

הפניית CLI ו-API

otGetVersionString