مرجع فرمان CLI

با شمارنده

شمارنده های مامور مرزی را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

ba counters
epskcActivation: 0
epskcApiDeactivation: 0
epskcTimeoutDeactivation: 0
epskcMaxAttemptDeactivation: 0
epskcDisconnectDeactivation: 0
epskcInvalidBaStateError: 0
epskcInvalidArgsError: 0
epskcStartSecureSessionError: 0
epskcSecureSessionSuccess: 0
epskcSecureSessionFailure: 0
epskcCommissionerPetition: 0
pskcSecureSessionSuccess: 0
pskcSecureSessionFailure: 0
pskcCommissionerPetition: 0
mgmtActiveGet: 0
mgmtPendingGet: 0
Done

مراجع CLI و API

با کلید زودگذر

نشان می دهد که آیا یک کلید زودگذر در حال حاضر فعال است یا خیر.

به OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE نیاز دارد.

پارامترها

بدون پارامتر

نمونه ها 

ba ephemeralkey
active
Done

مراجع CLI و API

پاسخ تماس با کلید موقت (فعال، غیرفعال)

عملکرد برگشت تماس مورد استفاده توسط Border Agent را برای اطلاع هر گونه تغییر مربوط به استفاده از کلید زودگذر تنظیم می کند.

به OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE نیاز دارد.

یک فراخوان بعدی به این تابع جایگزین هر تماس قبلی تنظیم شده خواهد شد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

با کلید زودگذر روشن

کلید زودگذری که در حال استفاده است را لغو می کند.

به OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE نیاز دارد.

می توان از آن برای لغو یک کلید زودگذر از قبل تنظیم شده قبل از اتمام زمان استفاده کرد. اگر Border Agent در حال اجرا نباشد یا هیچ کلید زودگذری در حال استفاده نباشد، فراخوانی این تابع تاثیری ندارد.

اگر یک کمیسیونر با استفاده از کلید زودگذر وصل شده باشد و در حال حاضر فعال باشد، فراخوانی این تابع حالت آن را تغییر نمی دهد. در این مورد otBorderAgentIsEphemeralKeyActive() به بازگشت TRUE ادامه می دهد تا زمانی که کمیسیونر ارتباط خود را قطع کند.

پارامترها

بدون پارامتر

نمونه ها 

ba ephemeralkey clear
Done

مراجع CLI و API

مجموعه کلید زودگذر ba [timeout-in-msec] [پورت]

کلید زودگذر را برای مدت زمان مشخصی تنظیم می کند.

به OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE نیاز دارد.

کلید زودگذر را می توان زمانی تنظیم کرد که Border Agent از قبل در حال اجرا باشد و در حال حاضر به هیچ کمیسیون خارجی متصل نباشد (یعنی در وضعیت OT_BORDER_AGENT_STATE_STARTED است). در غیر این صورت OT_ERROR_INVALID_STATE برگردانده می شود.

aKeyString داده شده مستقیماً به عنوان PSK زودگذر استفاده می شود (به استثنای نویسه null \0 انتهایی). طول aKeyString باید بین OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH و OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH باشد.

تنظیم مجدد کلید زودگذر قبل از اتمام زمان کلیدی که قبلاً تنظیم شده است، جایگزین کلید قبلی تنظیم شده و بازنشانی مدت زمان می شود.

در حالی که فاصله زمانی در حال اجرا است، کلید زودگذر را فقط یک بار می توان توسط یک مامور خارجی برای اتصال استفاده کرد. هنگامی که کمیسیونر قطع می شود، کلید زودگذر پاک می شود و Border Agent به استفاده از PSKc برمی گردد.

پارامترها

بدون پارامتر

نمونه ها 

ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done

مراجع CLI و API

شناسه ba (دریافت، تنظیم)

شناسه مسیریاب مرزی 16 بایتی را دریافت یا تنظیم می‌کند که می‌تواند دستگاه را به طور منحصربه‌فرد در بین چندین BR شناسایی کند.

پارامترها

ba id [border-agent-id]

از آرگومان اختیاری border-agent-id برای تنظیم شناسه عامل مرزی استفاده کنید.

نمونه ها 

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done

مراجع CLI و API

بندر با

پورت UDP سرویس Thread Border Agent را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

ba port
49153
Done

مراجع CLI و API

با ایالت

نقش otBorderAgentState از Thread Border Agent را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

ba state
Started
Done

مراجع CLI و API

bbr

اطلاعات روتر اصلی ستون فقرات فعلی را برای دستگاه Thread برمی‌گرداند.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

  • API مرتبطی وجود ندارد

پیکربندی bbr (تنظیم)

پیکربندی محلی Backbone Router را تنظیم می کند.

اگر مجموعه داده های BBR برای روتر اصلی ستون فقرات تغییر کند، یک پیام درخواست داده سرور SRV_DATA.ntf به طور خودکار آغاز می شود.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

bbr register باید به طور صریح برای ثبت سرویس روتر Backbone به Leader برای مسیریاب ستون فقرات ثانویه صادر شود.

پارامترها 

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

نمونه ها 

bbr config seqno 20 delay 30
Done

مراجع CLI و API

پیکربندی bbr

پیکربندی محلی Backbone Router را دریافت می کند.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

bbr غیر فعال کردن

عملکرد Backbone را فعال یا غیرفعال می کند.

اگر فعال باشد، اگر سرویس مسیریاب ستون فقرات در داده شبکه موضوعی وجود نداشته باشد، یک پیام درخواست داده سرور SRV_DATA.ntf برای دستگاه متصل راه‌اندازی می‌شود.

در صورت غیرفعال شدن، SRV_DATA.ntf راه اندازی می شود اگر روتر Backbone در حالت Primary باشد.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

پارامترها

بدون پارامتر

نمونه ها 

bbr disable
Done

مراجع CLI و API

bbr را فعال کنید

عملکرد Backbone را فعال یا غیرفعال می کند.

اگر فعال باشد، اگر سرویس مسیریاب ستون فقرات در داده شبکه موضوعی وجود نداشته باشد، یک پیام درخواست داده سرور SRV_DATA.ntf برای دستگاه متصل راه‌اندازی می‌شود.

در صورت غیرفعال شدن، SRV_DATA.ntf راه اندازی می شود اگر روتر Backbone در حالت Primary باشد.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

پارامترها

بدون پارامتر

نمونه ها 

bbr enable
Done

مراجع CLI و API

bbr jitter (دریافت، تنظیم)

لرزش (در چند ثانیه) را برای ثبت روتر Backbone دریافت یا تنظیم می کند.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

پارامترها 

bbr jitter [jitter]

نمونه ها 

bbr jitter
20
Done
bbr jitter 10
Done

مراجع CLI و API

bbr mgmt دعا

با گنجاندن 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_SUCCESS
  • 1: ST_DUA_REREGISTER
  • 2: ST_DUA_INVALID
  • 3: ST_DUA_DUPLICATE
  • 4: ST_DUA_NO_RESOURCES
  • 5: ST_DUA_BBR_NOT_PRIMARY
  • 6: ST_DUA_GENERAL_FAILURE
  • 160: کد COAP 5.00

نمونه ها 

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

مراجع CLI و API

bbr mgmt mlr شنونده اضافه کنید

یک شنونده چندپخشی با مقدار وقفه در چند ثانیه اضافه می کند.

برای استفاده از مهلت زمانی پیش‌فرض 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

شنونده bbr mgmt mlr

شنوندگان Multicast را با mTimeout otBackboneRouterMulticastListenerInfo در چند ثانیه برمی‌گرداند.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE و OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE فعال باشند.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

bbr mgmt mlr شنونده روشن

شنوندگان چندپخشی را پاک می کند.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE ، OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE ، و OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE فعال باشند.

پارامترها

بدون پارامتر

نمونه ها 

bbr mgmt mlr listener clear
Done

مراجع CLI و API

پاسخ bbr mgmt mlr

وضعیت پاسخ را برای ثبت شنونده چندپخشی بعدی پیکربندی می کند.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE ، OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE ، و OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE فعال باشند.

پارامترها

bbr mgmt mlr response status-code

برای status-code ، از:

  • 0: ST_MLR_SUCCESS
  • 2: ST_MLR_INVALID
  • 3: ST_MLR_NO_PERSISTENT
  • 4: ST_MLR_NO_RESOURCES
  • 5: ST_MLR_BBR_NOT_PRIMARY
  • 6: ST_MLR_GENERAL_FAILURE

نمونه ها 

bbr mgmt mlr response 2
Done

مراجع CLI و API

ثبت bbr

پیکربندی روتر Backbone محلی را به صراحت ثبت می کند.

یک پیام درخواست داده سرور SRV_DATA.ntf برای دستگاه پیوست شده راه اندازی می شود.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

پارامترها

بدون پارامتر

نمونه ها 

bbr register
Done

مراجع CLI و API

وضعیت bbr

مسیریاب ستون فقرات otBackboneRouterState را دریافت می کند.

زمانی در دسترس است که OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE فعال باشد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br غیر فعال کردن

مدیر مسیریابی مرزی را غیرفعال می کند.

پارامترها

بدون پارامتر

نمونه ها 

br disable
Done

مراجع CLI و API

br فعال کردن

مدیر مسیریابی مرزی را فعال می کند.

پارامترها

بدون پارامتر

نمونه ها 

br enable
Done

مراجع CLI و API

br init

مدیر مسیریابی مرزی را راه اندازی می کند.

پارامترها 

br init infrastructure-network-index is-running

نمونه ها 

br init 2 1
Done

مراجع CLI و API

پیشوند br nat64

خروجی هر دو پیشوند 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 nat64 مورد علاقه

پیشوند NAT64 مورد علاقه فعلی را دریافت می کند.

پیشوند مورد علاقه NAT64 را می توان از پیوند زیرساخت کشف کرد یا می تواند پیشوند محلی NAT64 این دستگاه باشد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br nat64 پیشوند محلی

پیشوند محلی NAT64 روتر مرزی را دریافت می کند.

ممکن است پیشوند NAT64 در شبکه Thread تبلیغ نشود.

OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE باید فعال باشد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br omrprefix

خروجی هر دو پیشوند OMR محلی و مورد علاقه.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br omrprefix مورد علاقه

پیشوند دلخواه Off-Mesh-Routable (OMR) را دریافت می کند.

پیشوند OMR مورد علاقه را می توان از داده های شبکه کشف کرد یا می تواند پیشوند OMR محلی این دستگاه باشد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br omrprefix local

پیشوند محلی Off-Mesh-Routable (OMR) را دریافت می کند، برای مثال fdfc:1ff5:1512:5622::/64 .

پیشوند OMR یک پیشوند 64 بیتی تصادفی است که در شبکه Thread منتشر می شود، اگر قبلاً پیشوند OMR وجود نداشته باشد. این پیشوند از طریق شبکه محلی Wi-Fi یا اترنت قابل دسترسی است.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br onlink prefix

پیشوندهای محلی و دلخواه روی پیوند را خروجی می‌دهد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br onlinkprefix مورد علاقه

پیشوند On-Link مورد علاقه فعلی را دریافت می کند.

پیشوند مورد علاقه یا یک پیشوند on-link کشف شده در پیوند زیرساخت یا پیشوند محلی on-link است.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br onlinkprefix local

پیشوند محلی On-Link را برای پیوند زیرساخت مجاور دریافت می کند.

پیشوند محلی On-Link یک پیشوند 64 بیتی است که در پیوند زیرساخت تبلیغ می شود، اگر قبلاً یک پیشوند روی پیوند قابل استفاده روی پیوند تبلیغ نشده باشد.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

br pd (فعال کردن، غیرفعال کردن)

Delegation پیشوند DHCPv6 را فعال / غیرفعال می کند.

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE باید فعال باشد.

پارامترها 

br pd enable|disable

نمونه ها 

br pd enable
Done
br pd disable
Done

مراجع CLI و API

br pd omrprefix

پیشوند پیشوند پیشوند DHCPv6 (PD) ارائه شده با قابلیت مسیریابی خارج از شبکه (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

br PD حالت

وضعیت فعلی Delegation پیشوند DHCPv6 را دریافت می کند.

برای فعال کردن OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE نیاز دارد.

پارامترها

بدون پارامتر

نمونه ها 

br pd state
running
Done

مراجع CLI و API

br همتایان

لیستی از BR های همتا که در ورودی های داده های شبکه یافت می شوند را دریافت کنید. OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE مورد نیاز است. Peer BR دستگاه های دیگری در شبکه Thread هستند که اتصال IP خارجی را فراهم می کنند. دستگاهی برای ارائه اتصال IP خارجی در صورتی در نظر گرفته می شود که حداقل یکی از شرایط زیر در مورد ورودی های داده شبکه آن وجود داشته باشد:

  • حداقل یک ورودی مسیر خارجی اضافه کرده است.
  • حداقل یک ورودی پیشوند را با پرچم‌های مسیر پیش‌فرض و روی مش اضافه کرده است.
  • حداقل یک پیشوند دامنه اضافه کرده است (همراه با پرچم‌های دامنه و هم روی مش). فهرست BR های همتا به طور خاص دستگاه فعلی را مستثنی می کند، حتی اگر خودش به عنوان یک BR عمل کند. اطلاعات در هر ورودی BR:
  • RLOC16 از BR
  • سن به عنوان فاصله زمانی از زمانی که این BR در داده های شبکه ظاهر شد. اگر مدت زمان کمتر از 24 ساعت باشد، به صورت {hh}:{mm}:{ss} برای ساعت‌ها، دقیقه‌ها، ثانیه‌ها قالب‌بندی می‌شود. اگر مدت زمان 24 ساعت یا بیشتر باشد، قالب {dd}d.{hh}:{mm}:{ss} برای روز، ساعت، دقیقه، ثانیه است.

پارامترها

بدون پارامتر

نمونه ها 

br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Done

مراجع CLI و API

همسالان br شمارش می کنند

تعداد BR های همتا موجود در داده های شبکه را برمی گرداند.

به OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE نیاز دارد.

Peer BR دستگاه های دیگری در شبکه Thread هستند که اتصال IP خارجی را فراهم می کنند. دستگاهی برای ارائه اتصال IP خارجی در صورتی در نظر گرفته می شود که حداقل یکی از شرایط زیر در مورد ورودی های داده شبکه آن وجود داشته باشد:

  • حداقل یک ورودی مسیر خارجی اضافه کرده است.
  • حداقل یک ورودی پیشوند را با پرچم‌های مسیر پیش‌فرض و روی مش اضافه کرده است.
  • حداقل یک پیشوند دامنه اضافه کرده است (همراه با پرچم‌های دامنه و هم روی مش).

فهرست BR های همتا به طور خاص دستگاه فعلی را مستثنی می کند، حتی اگر خود به عنوان یک BR عمل کند.

پارامترها

بدون پارامتر

نمونه ها 

br peers count
2 min-age:00:00:47
Done

مراجع CLI و API

br پیشوند

پیشوندهای کشف شده را توسط Border Routing Manager در پیوند زیرساخت دریافت کنید. اطلاعات در هر ورودی پیشوند:

  • پیشوند
  • این که آیا پیشوند روی پیوند است یا مسیر
  • میلی ثانیه از آخرین دریافت آگهی روتر حاوی این پیشوند
  • طول عمر پیشوند در ثانیه
  • تنها در صورتی که پیشوند روی پیوند باشد، طول عمر ترجیحی بر حسب ثانیه است
  • ترجیح مسیر (کم، متوسط، زیاد) فقط در صورتی که پیشوند مسیر باشد (نه روی پیوند)
  • آدرس IPv6 روتر که این پیشوند را تبلیغ می کند
  • پرچم‌ها در سربرگ آگهی روتر دریافتی:
    • M: پرچم پیکربندی آدرس مدیریت شده
    • O: پرچم تنظیمات دیگر
    • S: پرچم روتر SNAC

پارامترها

بدون پارامتر

نمونه ها 

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 S: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 S:1)
Done

مراجع CLI و API

گزینه های br (تنظیم، روشن)

گزینه‌های اضافی را برای اضافه کردن در انتهای پیام‌های ارسال شده تبلیغ روتر (RA) تنظیم می‌کند.

محتوای aOptions به صورت داخلی کپی می شود، بنابراین می تواند یک بافر موقت باشد (به عنوان مثال، یک آرایه اختصاص داده شده پشته).

فراخوانی های بعدی این تابع مقدار تنظیم شده قبلی را بازنویسی می کند.

پارامترها

br raoptions options|clear

br raoptions clear یک nullptr به otBorderRoutingSetExtraRouterAdvertOptions ارسال می کند. در غیر این صورت، می توانید بایت options را به عنوان داده هگز ارسال کنید.

نمونه ها 

br raoptions 0400ff00020001
Done
br raoptions clear
Done

مراجع CLI و API

br rioprf (بالا، دارو، کم)

صراحتاً این اولویت را تنظیم می‌کند که هنگام تبلیغات گزینه‌های اطلاعات مسیر (RIO) در پیام‌های تبلیغاتی روتر ارسال شده از طریق پیوند زیرساخت استفاده شود.

پس از تماس با این تابع، BR از اولویت داده شده برای همه RIOهای تبلیغاتی خود استفاده می کند. با فراخوانی otBorderRoutingClearRouteInfoOptionPreference() می توان اولویت را پاک کرد.

پارامترها 

br rioprf [high|med|low]

نمونه ها 

br rioprf low
Done

مراجع CLI و API

br rioprf

ترجیحات فعلی مورد استفاده را هنگام تبلیغ گزینه‌های اطلاعات مسیر (RIO) در پیام‌های تبلیغاتی روتر که از طریق پیوند زیرساخت ارسال می‌شوند، دریافت می‌کند.

اولویت RIO به شرح زیر تعیین می شود:

  • اگر به صراحت توسط کاربر با فراخوانی otBorderRoutingSetRouteInfoOptionPreference() تنظیم شود، از اولویت داده شده استفاده می شود.
  • در غیر این صورت، بر اساس نقش فعلی دستگاه تعیین می‌شود: اولویت متوسط ​​در نقش روتر/رهبر و اولویت پایین در نقش فرزند.

پارامترها

بدون پارامتر

نمونه ها 

br rioprf
med
Done

مراجع CLI و API

br rioprf روشن

یک مقدار ترجیحی تنظیم شده قبلی را برای گزینه‌های اطلاعات مسیر تبلیغ شده پاک می‌کند.

پس از فراخوانی این تابع، BR از نقش دستگاه برای تعیین اولویت RIO استفاده می‌کند: اولویت متوسط ​​در نقش روتر/رهبر و اولویت پایین در نقش فرزند.

پارامترها

بدون پارامتر

نمونه ها 

br rioprf clear
Done

مراجع CLI و API

br routeprf (بالا، متوسط، کم)

به صراحت اولویت مسیرهای منتشر شده را در داده های شبکه تنظیم می کند.

پس از فراخوانی این تابع، BR از اولویت داده شده استفاده می کند. این اولویت را می توان با فراخوانی otBorderRoutingClearRoutePreference() پاک کرد.

پارامترها 

br routeprf [high|med|low]

نمونه ها 

br routeprf low
Done

مراجع CLI و API

br routeprf

اولویت فعلی مورد استفاده برای مسیرهای منتشر شده در Network Data را دریافت می کند.

اولویت به شرح زیر تعیین می شود:

  • اگر به صراحت توسط کاربر با فراخوانی otBorderRoutingSetRoutePreference() تنظیم شود، ترجیح داده شده استفاده می شود.
  • در غیر این صورت، به طور خودکار توسط RoutingManager بر اساس نقش دستگاه و کیفیت لینک تعیین می شود.

پارامترها

بدون پارامتر

نمونه ها 

br routeprf
med
Done

مراجع CLI و API

br routeprf روشن

یک مقدار ترجیحی تنظیم شده قبلی را برای مسیرهای منتشر شده در Network Data پاک می کند.

پس از تماس با این عملکرد، BR به طور خودکار بر اساس نقش دستگاه و کیفیت پیوند (به والد هنگام عمل به عنوان دستگاه پایانی) اولویت را تعیین می کند.

پارامترها

بدون پارامتر

نمونه ها 

br routeprf clear
Done

مراجع CLI و API

روترهای br

لیست روترهای کشف شده توسط Border Routing Manager را در پیوند زیرساخت دریافت کنید. اطلاعات در هر روتر:

  • آدرس IPv6 روتر
  • پرچم‌ها در سربرگ آگهی روتر دریافتی:
    • M: پرچم پیکربندی آدرس مدیریت شده
    • O: پرچم تنظیمات دیگر
    • S: پرچم روتر SNAC (نشان می دهد که آیا روتر یک روتر خرد است یا خیر)
  • میلی ثانیه از آخرین پیام دریافتی از این روتر
  • پرچم قابلیت دسترسی: اگر روتر به چندین پروب درخواست همسایه پاسخ ندهد به عنوان غیرقابل دسترسی علامت گذاری می شود.
  • سن: فاصله زمانی از اولین بار کشف این روتر. اگر مدت زمان کمتر از 24 ساعت باشد، به صورت {hh}:{mm}:{ss} برای ساعت‌ها، دقیقه‌ها، ثانیه‌ها قالب‌بندی می‌شود. اگر مدت زمان 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 S:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done

مراجع CLI و API

ایالت br

وضعیت فعلی Border Routing Manager را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

br state
running

مراجع CLI و API

اطلاعات بافر

اطلاعات بافر پیام فعلی را دریافت می کند.

  • total تعداد کل بافرهای پیام را در pool نمایش می دهد.
  • 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

بازنشانی bufferinfo

شمارنده اطلاعات بافر پیام را بازنشانی کنید تا حداکثر تعداد بافرهای در حال استفاده را همزمان ردیابی کنید.

این کار mMaxUsedBuffers در otBufferInfo بازنشانی می‌کند.

پارامترها

بدون پارامتر

نمونه ها 

bufferinfo reset
Done

مراجع CLI و API

آستانه (دریافت، تنظیم)

آستانه 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

کانال (دریافت، تنظیم)

مقدار کانال 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_CHANNEL_SELECT_ENABLE، و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها

channel manager auto enable

1 یک بولی برای enable است.

نمونه ها 

channel manager auto 1
channel manager auto 1
Done

مراجع CLI و API

تغییر مدیر کانال

درخواست تغییر کانال شبکه Thread را دارد.

شبکه پس از یک تاخیر مشخص به کانال داده شده سوئیچ می کند (به otChannelManagerSetDelay() مراجعه کنید). تغییر کانال با به‌روزرسانی مجموعه داده‌های عملیاتی در انتظار انجام می‌شود.

تماس بعدی، تغییر کانالی را که قبلاً درخواست شده بود لغو می‌کند.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE مورد نیاز است.

پارامترها 

channel manager change channel-num

نمونه ها 

channel manager change 11
channel manager change 11
Done

مراجع CLI و API

مدیر کانال

وضعیت مدیر کانال را دریافت کنید. OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE یا OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE مورد نیاز است.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

تاخیر مدیر کانال

تأخیر (بر حسب ثانیه) مورد استفاده برای تغییر کانال شبکه را تنظیم می کند.

فقط در FTD موجود است. تأخیر ترجیحاً باید بیشتر از حداکثر فاصله نظرسنجی داده استفاده شده توسط همه دستگاه‌های Sleepy End در شبکه Thread باشد.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها 

channel manager delay delay-seconds

نمونه ها 

channel manager delay 120
channel manager delay 120
Done

مراجع CLI و API

مدیر کانال مورد علاقه

ماسک کانال مورد علاقه را تنظیم می کند.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE یا OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE و OPENTHREAD_CHANNEL_SELECT_ENABLE، و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها 

channel manager favored mask

نمونه ها 

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

مراجع CLI و API

فاصله زمانی مدیر کانال

بازه دوره (بر حسب ثانیه) مورد استفاده توسط عملکرد انتخاب خودکار کانال را تنظیم می کند.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE یا OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE و OPENTHREAD_CHANNEL_SELECT_ENABLE، و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها 

channel manager interval interval-seconds

نمونه ها 

channel manager interval 10800
channel manager interval 10800
Done

مراجع CLI و API

مدیر کانال را انتخاب کنید

از ChannelManager درخواست می کند که کانال جدیدی را بررسی و انتخاب کند و تغییر کانال را شروع کند.

برخلاف otChannelManagerRequestChannelChange() که در آن کانال باید به عنوان پارامتر داده شود، این تابع از ChannelManager می خواهد که به تنهایی یک کانال را انتخاب کند (بر اساس اطلاعات جمع آوری شده کیفیت کانال).

پس از تماس، مدیر کانال 3 مرحله زیر را انجام می دهد:

1) ChannelManager تصمیم می گیرد که آیا تغییر کانال مفید است یا خیر. اگر aSkipQualityCheck روی درست تنظیم شود (اجبار کردن انتخاب کانال و رد شدن از بررسی کیفیت) می‌توان از این بررسی صرفنظر کرد. این مرحله از معیارهای کیفیت پیوند جمع‌آوری‌شده در دستگاه (مانند نرخ شکست CCA، نرخ خطای فریم و پیام به ازای هر همسایه و غیره) استفاده می‌کند تا مشخص کند آیا کیفیت کانال فعلی در سطحی است که تغییر کانال را توجیه می‌کند یا خیر.

2) اگر مرحله اول بگذرد، ChannelManager کانال بالقوه بهتری را انتخاب می کند. از داده های کیفیت کانال جمع آوری شده توسط ماژول ChannelMonitor استفاده می کند. کانال های پشتیبانی شده و مورد علاقه در این مرحله استفاده می شوند. (به otChannelManagerSetSupportedChannels() و otChannelManagerSetFavoredChannels() مراجعه کنید).

3) اگر کانال تازه انتخاب شده با کانال فعلی متفاوت باشد، ChannelManager فرآیند تغییر کانال را درخواست می کند/شروع می کند (به طور داخلی RequestChannelChange() ).

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE یا OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE و OPENTHREAD_CHANNEL_SELECT_ENABLE، و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها

channel manager select skip-quality-check

از 1 یا 0 برای skip-quality-check بولی استفاده کنید.

نمونه ها 

channel manager select 1
channel manager select 1
Done

مراجع CLI و API

مدیر کانال پشتیبانی می شود

ماسک کانال پشتیبانی شده را تنظیم می کند.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE یا OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE و OPENTHREAD_CHANNEL_SELECT_ENABLE، و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها 

channel manager supported mask

نمونه ها 

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

مراجع CLI و API

آستانه مدیر کانال

آستانه نرخ شکست CCA را تنظیم می کند.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE یا OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE و OPENTHREAD_CHANNEL_SELECT_ENABLE، و OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها

channel manager threshold threshold-percent

از مقدار هگز برای threshold-percent استفاده کنید. 0 نقشه تا 0% و 0xffff نقشه تا 100%.

نمونه ها 

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

مراجع CLI و API

مانیتور کانال

وضعیت فعلی مانیتور کانال و اشغال کانال را دریافت کنید. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

  • API مرتبطی وجود ندارد

شروع مانیتور کانال

مانیتور کانال را راه اندازی کنید. OT CLI یک مقدار بولی true به otChannelMonitorSetEnabled ارسال می کند. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها

بدون پارامتر

نمونه ها 

channel monitor start
channel monitor start
Done

مراجع CLI و API

توقف مانیتور کانال

مانیتور کانال را متوقف کنید. OT CLI مقدار بولی false را به otChannelMonitorSetEnabled ارسال می کند. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE مورد نیاز است.

پارامترها

بدون پارامتر

نمونه ها 

channel monitor stop
channel monitor stop
Done

مراجع CLI و API

کانال ترجیحی

ماسک کانال ترجیحی رادیویی را دریافت می کند که دستگاه ترجیح می دهد روی آن شکل بگیرد.

پارامترها

بدون پارامتر

نمونه ها 

channel preferred
0x7fff800
Done

مراجع CLI و API

کانال پشتیبانی می شود

ماسک کانال رادیویی را که دستگاه مجاز به استفاده از آن است، دریافت کنید.

پارامترها

بدون پارامتر

نمونه ها 

channel supported
0x7fff800
Done

مراجع CLI و API

فرزند (ID)

اطلاعات تشخیصی کودک پیوست شده را با شناسه فرزند یا RLOC16 دریافت می کند.

پارامترها 

child child-id

نمونه ها 

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

مراجع CLI و API

لیست کودک

فهرستی از شناسه های فرزند پیوست شده را برمی گرداند.

پارامترها

بدون پارامتر

نمونه ها 

child list
1 2 3 6 7 8
Done

مراجع CLI و API

میز کودک

جدولی از کودکان پیوست را چاپ می کند.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

بچه داری

لیستی از آدرس های IP ذخیره شده برای کودکان MTD را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

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

مراجع CLI و API

حداکثر کودک (مجموعه)

حداکثر تعداد آدرس های IP را که هر فرزند MTD ممکن است با این دستگاه به عنوان والدین ثبت کند، تنظیم یا بازیابی می کند.

برای پاک کردن تنظیمات و بازیابی تنظیمات پیش فرض، 0 پاس کنید.

زمانی در دسترس است که OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE فعال باشد.

پارامترها 

childip max count

نمونه ها 

childip max 2
Done

مراجع CLI و API

حداکثر فرزند

حداکثر تعداد آدرس‌های IP را که هر فرزند MTD ممکن است با این دستگاه به‌عنوان والدین ثبت کند، دریافت می‌کند.

پارامترها

بدون پارامتر

نمونه ها 

childip max
4
Done

مراجع CLI و API

فرزند حداکثر (مجموعه)

حداکثر تعداد فرزندان مجاز در حال حاضر را تنظیم می کند.

این پارامتر فقط زمانی قابل تنظیم است که عملیات پروتکل Thread متوقف شده باشد.

پارامترها 

childmax count

نمونه ها 

childmax 2
Done

مراجع CLI و API

فرزند حداکثر

حداکثر تعداد فرزندان مجاز در حال حاضر را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

childmax
5
Done

مراجع CLI و API

مقدار MLE_CHILD_ROUTER_LINKS را دریافت یا تنظیم می کند.

پارامترها 

childrouterlinks [links]

نمونه ها 

childrouterlinks
16
Done
childrouterlinks 16
Done

مراجع CLI و API

بازرسی نظارت بر کودک (مجموعه)

فاصله زمانی بازرسی نظارت (بر حسب ثانیه) را بر روی کودک تنظیم می کند.

پارامترها 

childsupervision checktimeout timeout-seconds

نمونه ها 

childsupervision checktimeout 30
Done

مراجع CLI و API

بازرسی نظارت بر کودک

فاصله زمانی بازرسی نظارت (بر حسب ثانیه) را بر روی کودک دریافت می کند.

اگر دستگاه کودک خواب‌آلود باشد و در بازه زمانی تعیین‌شده از والدین خود چیزی نشنود، فرآیند پیوست مجدد را آغاز می‌کند (مبادله درخواست/پاسخ به‌روزرسانی کودک MLE با والدینش).

پارامترها

بدون پارامتر

نمونه ها 

childsupervision checktimeout
30
Done

مراجع CLI و API

فاصله نظارت بر کودک (مجموعه)

فاصله نظارت کودک (بر حسب ثانیه) را روی کودک تنظیم می کند.

پارامترها 

childsupervision interval interval-seconds

نمونه ها 

childsupervision interval 30
Done

مراجع CLI و API

فاصله نظارت بر کودک

فاصله نظارت بر کودک (در ثانیه) را بر روی کودک دریافت می کند.

ویژگی نظارت بر کودک مکانیزمی را برای والدین فراهم می کند تا اطمینان حاصل شود که پیامی برای هر کودک خواب آلود در بازه نظارت ارسال می شود. اگر در بازه نظارتی هیچ انتقالی برای کودک وجود نداشته باشد، OpenThread در نوبت قرار می گیرد و یک پیام نظارت بر کودک برای کودک ارسال می کند.

پارامترها

بدون پارامتر

نمونه ها 

childsupervision interval
30
Done

مراجع CLI و API

مهد کودک (مجموعه)

زمان استفاده از Thread Child Timeout (بر حسب ثانیه) را هنگام اجرای نقش Child تنظیم می کند.

پارامترها 

childtimeout timeout-seconds

نمونه ها 

childtimeout 300
Done

مراجع CLI و API

تعطیلی کودک

زمان استفاده از Thread Child Timeout (در چند ثانیه) را هنگام اجرای نقش Child دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

childtimeout
300
Done

مراجع CLI و API

coap لغو

اشتراک مشاهده موجود در یک منبع راه دور در سرور CoAP را لغو می کند.

پارامترها

بدون پارامتر

نمونه ها 

coap cancel
Done

مراجع CLI و API

coap delete

منبع CoAP مشخص شده را حذف می کند.

پارامترها

coap delete address uri-path [type] [payload]
  • address : آدرس IPv6 سرور CoAP.
  • uri-path : مسیر URI منبع.
  • type :
    • con : قابل تایید
    • non-con : غیر قابل تایید (پیش فرض)
  • payload : رشته محموله CoAP. به عنوان مثال، hellothere .

نمونه ها 

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

مراجع CLI و API

  • API مرتبطی وجود ندارد

کاپ گرفتن

اطلاعات مربوط به منبع CoAP مشخص شده در سرور CoAP را دریافت می کند.

پارامترها

coap get address uri-path [type]
  • address : آدرس IPv6 سرور CoAP.
  • uri-path : مسیر URI منبع.
  • type :
    • con : قابل تایید
    • non-con : غیر قابل تایید (پیش فرض)
    • block- : اگر پاسخ باید به صورت بلوک منتقل شود از این گزینه و به دنبال آن مقدار block-wise استفاده کنید. مقادیر معتبر عبارتند از: 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 (دریافت، تنظیم)

اگر فرمان بدون پارامترهای اختیاری اجرا شود، مقادیر پارامتر 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 : 2000 میلی ثانیه
    • 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 مشخص شده را ایجاد می کند. برای اطلاعات بیشتر، به تست اتصال به منبع پروتکل برنامه محدود (CoAP) با استفاده از OT CLI مراجعه کنید.

پارامترها

coap post address uri-path [type] [payload]
  • address : آدرس IPv6 سرور CoAP.
  • uri-path : مسیر URI منبع.
  • type :
    • con : قابل تایید
    • non-con : غیر قابل تایید (پیش فرض)
    • block- : از این گزینه و به دنبال آن مقدار block-wise برای ارسال بلوک هایی با تعداد بایت های تولید شده به صورت تصادفی برای بار استفاده کنید. مقادیر معتبر عبارتند از: block-16 ، block-32 ، block-64 ، block-128 ، block-256 ، block-512 ، یا block-1024 .
  • payload : درخواست بارگذاری CoAP، که در صورت استفاده بسته به type ، رشته یا عدد صحیح است. اگر type con یا non-con باشد، پارامتر 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- : از این گزینه و به دنبال آن مقدار block-wise برای ارسال بلوک هایی با تعداد بایت های تولید شده به صورت تصادفی برای بار استفاده کنید. مقادیر معتبر عبارتند از: block-16 ، block-32 ، block-64 ، block-128 ، block-256 ، block-512 ، یا block-1024 .
  • payload : درخواست بارگذاری CoAP، که در صورت استفاده بسته به type ، رشته یا عدد صحیح است. اگر type con یا non-con باشد، پارامتر payload اختیاری است. اگر پارامتر payload را کنار بگذارید، یک بار خالی ارسال می شود. با این حال، اگر از پارامتر payload استفاده می‌کنید، مقدار آن باید یک رشته باشد، مانند hellothere . اگر type block- است، مقدار پارامتر payload باید یک عدد صحیح باشد که تعداد بلوک های ارسالی را مشخص می کند. نوع block- نیاز به تنظیم OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE دارد.

نمونه ها 

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

مراجع CLI و API

  • API مرتبطی وجود ندارد

منبع coap (دریافت، تنظیم)

مسیر URI منبع سرور COAP را تنظیم یا تنظیم می کند.

پارامترها 

coap resource [uri-path]

نمونه ها 

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

منابع CLI و API

ست

محتوای ارسال شده توسط منبع را در سرور COAP تنظیم می کند. اگر یک مشتری COAP در حال مشاهده منبع باشد ، اعلان به آن مشتری ارسال می شود.

پارامترها 

coap set new-content

نمونه ها 

coap set Testing123
Done

منابع CLI و API

شروع Coap

سرور COAP را شروع می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI ، به تست اتصال به یک منبع پروتکل برنامه محدود (COAP) مراجعه کنید.

پارامترها

بدون پارامتر

نمونه ها 

coap start
Done

منابع CLI و API

توقف

سرور COAP را متوقف می کند.

پارامترها

بدون پارامتر

نمونه ها 

coap stop
Done

منابع CLI و API

Coaps وصل می شود

جلسه امنیتی لایه حمل و نقل Datagram (DTLS) را با یک همتا آغاز می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

coaps connect address

پارامتر address آدرس IPv6 همسالان است.

نمونه ها 

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

منابع CLI و API

Coaps حذف می شود

رشته بار Coaps برای حذف.

پارامترها

coaps delete uri-path [type] [payload]
  • uri-path : مسیر Uri از منبع.
  • type :
    • con : قابل تأیید
    • non-con : غیر قابل تأیید (پیش فرض)
  • payload : درخواست بار Coaps.

نمونه ها 

coaps delete test-resource con hellothere
Done

منابع CLI و API

  • API همراه نیست

Coaps قطع می شود

جلسه DTLS را متوقف می کند.

پارامترها

بدون پارامتر

نمونه ها 

coaps disconnect
coaps disconnected
Done

منابع CLI و API

coaps دریافت می کند

اطلاعاتی در مورد منبع مشخص شده Coaps در سرور COAPS دریافت می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

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 Isclosed

نشان می دهد که آیا سرویس امن COAP بسته است یا خیر. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

بدون پارامتر

نمونه ها 

coaps isclosed
no
Done

منابع CLI و API

coaps isConnactive

نشان می دهد که آیا اتصال سرویس امن COAP فعال است (یا از قبل متصل است یا در روند برقراری اتصال). برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

بدون پارامتر

نمونه ها 

coaps isconnactive
yes
Done

منابع CLI و API

Coaps IsConned

نشان می دهد که آیا سرویس امن COAP متصل است یا خیر. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

بدون پارامتر

نمونه ها 

coaps isconnected
yes
Done

منابع CLI و API

پست

منبع CoAPS مشخص شده را ایجاد می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

uri-path [type] [payload]
  • uri-path : مسیر Uri از منبع.
  • type :
    • con : قابل تأیید
    • non-con : غیر قابل تأیید (پیش فرض)
    • block- : از این گزینه استفاده کنید ، به دنبال آن مقدار بلوک ، برای ارسال بلوک هایی با تعداد بایت به طور تصادفی تولید شده برای بار. مقادیر معتبر عبارتند از: block-16 ، block-32 ، block-64 ، block-128 ، block-256 ، block-512 یا block-1024 .
  • payload : درخواست بار Coaps ، که در صورت استفاده از یک رشته یا عدد صحیح ، بسته به type استفاده می شود. اگر type con یا non-con باشد ، پارامتر 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) و Cipher Suite DTLS_PSK_WOTH_AES_128_CCM_8 را تنظیم می کند.

پارامترها

coaps psk psk-value psk-id
  • psk-value : کلید از پیش سهمیه
  • psk-id : شناسه کلید از پیش سهم.

نمونه ها 

coaps psk 1234 key1
Done

منابع CLI و API

Coaps قرار داده است

منبع COAPS مشخص شده را اصلاح می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

uri-path [type] [payload]
  • uri-path : مسیر Uri از منبع.
  • type :
    • con : قابل تأیید
    • non-con : غیر قابل تأیید (پیش فرض)
    • block- : از این گزینه استفاده کنید ، به دنبال آن مقدار بلوک ، برای ارسال بلوک هایی با تعداد بایت به طور تصادفی تولید شده برای بار. مقادیر معتبر عبارتند از: block-16 ، block-32 ، block-64 ، block-128 ، block-256 ، block-512 یا block-1024 .
  • payload : درخواست بار Coaps ، که در صورت استفاده از یک رشته یا عدد صحیح ، بسته به type استفاده می شود. اگر type con یا non-con باشد ، پارامتر 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 (دریافت ، تنظیم)

مسیر URI منبع سرور COAPS را تنظیم یا تنظیم می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها 

coaps resource [uri-path]

نمونه ها 

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

منابع CLI و API

Coaps Set Set

محتوای ارسال شده توسط منبع را در سرور COAPS تنظیم می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها 

coaps set new-content

نمونه ها 

coaps set Testing123
Done

منابع CLI و API

  • API همراه نیست

Coaps شروع می شود

سرویس امن COAP را شروع می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

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

Coaps متوقف می شود

سرویس امن COAP را متوقف می کند. برای اطلاعات بیشتر ، با استفاده از OT CLI به تست اتصال به یک منبع محدود پروتکل برنامه (COAPS) محدود (COAPS) مراجعه کنید.

پارامترها

بدون پارامتر

نمونه ها 

coaps stop
Done

منابع CLI و API

Coaps X509

گواهی X509 دستگاه محلی را با کلید خصوصی مربوطه برای جلسه DTLS با DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 تنظیم می کند.

پارامترها

بدون پارامتر

نمونه ها 

coaps x509
Done

منابع CLI و API

کمیسر اعلام کرد

یک پیام اعلان را ارسال می کند.

پارامترها

commissioner announce mask count period destination
  • mask : بیت ماسک که کانال هایی را برای ارسال پیام های 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 : بیت ماسک که کانال های انجام اسکن انرژی 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

شناسه کمیسر (دریافت ، تنظیم)

نام ID کمیسر Openthread را می گیرد یا تنظیم می کند.

پارامترها 

commissioner id name

نمونه ها 

commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done

منابع CLI و API

وصل کننده کمیسر اضافه کنید

ورودی وصل کننده را اضافه می کند.

پارامترها

commissioner joiner add eui64|discerner pksd [timeout]
  • eui64 : IEEE EUI-64 از وصل کننده. برای مطابقت با هر وصل کننده ، از * استفاده کنید.
  • discerner : Diserner joiner در 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 : Diserner joiner در number/length قالب.

نمونه ها 

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

منابع CLI و API

جدول وصلر کمیسر

تمام ورودی های وصل کننده را در قالب جدول لیست می کند.

پارامترها

بدون پارامتر

نمونه ها 

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

منابع CLI و API

  • API همراه نیست

کمیسر Mgmtget

پیام MGMT_GET (مدیریت دریافت) را به رهبر ارسال می کند. مقادیر متغیر که با استفاده از دستور commissioner mgmtset تنظیم شده اند بازگردانده می شوند.

پارامترها

commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
  • locator : روتر مرزی RLOC16.
  • sessionid : شناسه جلسه کمیسر.
  • steeringdata : داده های فرمان.
  • joinerudpport : پورت joiner udp.
  • TLVs : مجموعه TLV ها مورد بازیابی قرار می گیرند.

نمونه ها 

commissioner mgmtget locator sessionid
Done

منابع CLI و API

کمیسر Mgmtset

یک پیام MGMT_SET (مجموعه مدیریت) را به رهبر ارسال می کند و متغیرها را برای مقادیر مشخص شده تنظیم می کند.

پارامترها

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
  • locator : روتر مرزی RLOC16.
  • sessionid : شناسه جلسه کمیسر.
  • steeringdata : داده های فرمان.
  • joinerudpport : پورت joiner udp.
  • TLVs : مجموعه TLV ها مورد بازیابی قرار می گیرند.

نمونه ها 

commissioner mgmtset joinerudpport 9988
Done

منابع CLI و API

کمیسر پانوید

پرس و جو شناسه تابه ارسال می کند. خروجی فرمان با دریافت بازگردانده می شود.

پارامترها

commissioner panid panid mask destination
  • paind : PAN ID برای استفاده برای بررسی درگیری ها.
  • 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 تهیه کننده کمیسر را تنظیم می کند.

پارامترها 

commissioner provisioningurl provisioningurl

نمونه ها 

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

منابع CLI و API

کمیسر جلسه

شناسه جلسه فعلی کمیسر را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

commissioner sessionid
0
Done

منابع CLI و API

کمیسر شروع کنید

نقش کمیسر موضوع را شروع می کند.

پارامترها

بدون پارامتر

نمونه ها 

commissioner start
Commissioner: petitioning
Done
Commissioner: active

منابع CLI و API

ایالت کمیسر

وضعیت فعلی کمیسر را برمی گرداند. مقادیر احتمالی active ، disabled یا petition هستند (دادخواست برای کمیسر شدن).

پارامترها

بدون پارامتر

نمونه ها 

commissioner state
active
Done

منابع CLI و API

کمیسر توقف

نقش کمیسر موضوع را متوقف می کند.

پارامترها

بدون پارامتر

نمونه ها 

commissioner stop
Done

منابع CLI و API

contextreusedElay (دریافت ، تنظیم)

مقدار CONTEXT_ID_REUSE_DELAY را می گیرد یا تنظیم می کند.

پارامترها

contextreusedelay delay

برای تنظیم CONTEXT_ID_REUSE_DELAY از آرگومان delay اختیاری استفاده کنید.

نمونه ها 

contextreusedelay
11
Done
contextreusedelay 11
Done

منابع CLI و API

پیشخوان (MAC)

پیشخوان های MAC Layer را دریافت کنید.

پارامترها 

counters mac

نمونه ها 

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

منابع CLI و API

پیشخوان (MLE)

پیشخوان های نخ را می گیرد.

پارامترها 

counters mle

نمونه ها 

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

منابع CLI و API

شمارنده ها

نام های پیشخوان پشتیبانی شده را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

counters
ip
mac
mle
Done

منابع CLI و API

  • API همراه نیست

پیشخوان IP

پیشخوان های IPv6 را دریافت می کند.

پارامترها 

counters ip

نمونه ها 

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

منابع CLI و API

شمارنده IP تنظیم مجدد IP

شمارنده های IPv6 را مجدداً تنظیم می کند.

پارامترها 

counters ip reset

نمونه ها 

counters ip reset
Done

منابع CLI و API

شمارنده MAC تنظیم مجدد

شمارنده های لایه MAC را مجدداً تنظیم می کند.

پارامترها 

counters mac reset

نمونه ها 

counters mac reset
Done

منابع CLI و API

شمارنده MLE تنظیم مجدد

شمارنده های نخ را مجدداً تنظیم می کند.

پارامترها 

counters mle reset

نمونه ها 

counters mle reset
Done

منابع CLI و API

کانال CSL

کانال CSL را تنظیم می کند.

پارامترها 

csl channel channel

نمونه ها 

csl channel 20
Done

منابع CLI و API

CSL

پیکربندی CSL را دریافت می کند.

پارامترها

بدون پارامتر

نمونه ها 

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

منابع CLI و API

دوره CSL

دوره CSL را در میکرو ثانیه تنظیم می کند.

CSL را با تنظیم این پارامتر در 0 غیرفعال کنید.

دوره CSL باید متعدد OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC باشد ، در غیر این صورت OT_ERROR_INVALID_ARGS بازگردانده می شود.

پارامترها 

csl period period

نمونه ها 

csl period 3000000
Done

منابع CLI و API

مدت زمان CSL

مدت زمان CSL را در چند ثانیه تنظیم می کند.

پارامترها 

csl timeout timeout

نمونه ها 

cls timeout 10
Done

منابع CLI و API

مجموعه داده فعال

مجموعه داده عملیاتی فعال را دریافت می کند.

OT CLI از اعضای OTOPERATIONDATASET برای بازگشت مقادیر مجموعه داده به کنسول استفاده می کند.

پارامترها

dataset active [-x]

آرگومان اختیاری مقادیر مجموعه داده های عملیاتی فعال را به عنوان TLV های رمزگذاری شده -x چاپ می کند.

نمونه ها 

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

DataSet ActiveTimestamp (دریافت ، تنظیم)

otoperationaldataset :: mactivetimestamp را می گیرد یا تنظیم می کند.

پارامترها

dataset activetimestamp [timestamp]

برای تنظیم زمان سنج فعال ، آرگومان timestamp اختیاری را منتقل کنید.

نمونه ها 

dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done

منابع CLI و API

  • API همراه نیست

کانال داده (دریافت ، تنظیم)

otoperationaldataset :: mchannel را می گیرد یا تنظیم می کند.

پارامترها

dataset channel [channel-num]

برای تنظیم کانال از آرگومان اختیاری channel-num استفاده کنید.

نمونه ها 

dataset channel
12
Done
dataset channel 12
Done

منابع CLI و API

  • API همراه نیست

DataSet ChannelMask (دریافت ، تنظیم)

otoperationaldataset را دریافت یا تنظیم می کند :: mchannelmask

پارامترها

dataset channelmask [channel-mask]

برای تنظیم ماسک کانال از آرگومان channel-mask استفاده کنید.

نمونه ها 

dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done

منابع CLI و API

  • API همراه نیست

مجموعه داده ها روشن است

بافر مجموعه داده عملیاتی را مجدداً تنظیم کنید.

پارامترها

بدون پارامتر

نمونه ها 

dataset clear
Done

منابع CLI و API

  • API همراه نیست

مجموعه داده های فعال

بافر مجموعه داده عملیاتی را به مجموعه داده های عملیاتی فعال متعهد کنید.

پارامترها

بدون پارامتر

نمونه ها 

dataset commit active
Done

منابع CLI و API

مجموعه داده در انتظار

بافر مجموعه داده عملیاتی را به داده های عملیاتی در انتظار انجام دهید.

پارامترها

بدون پارامتر

نمونه ها 

dataset commit pending
Done

منابع CLI و API

تأخیر مجموعه داده (دریافت ، تنظیم)

OTOPERATIONDATASET :: MDELAY را می گیرد یا تنظیم می کند.

پارامترها

dataset delay [delay]

برای تنظیم مقدار تایمر تأخیر از آرگومان delay اختیاری استفاده کنید.

نمونه ها 

dataset delay
1000
Done
dataset delay 1000
Done

منابع CLI و API

DataSet extpanid (دریافت ، تنظیم)

OTOPERATIONDATASET :: MEXTENDENDPANID را می گیرد یا تنظیم می کند.

پارامترها

dataset extpanid [extpanid]

برای تنظیم شناسه شبکه گسترده منطقه شخصی از آرگومان اختیاری extpanid استفاده کنید.

نمونه ها 

dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done

منابع CLI و API

راهنمای مجموعه داده

لیستی از دستورات CLI dataset را دریافت می کند. برای اطلاعات بیشتر ، به نمایش داده ها با OT CLI مراجعه کنید.

پارامترها

بدون پارامتر

نمونه ها 

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

منابع CLI و API

  • API همراه نیست

DataSet Init (فعال ، جدید ، در انتظار ، TLV)

OT CLI برای active ، pending یا tlvs بررسی می کند و مقادیر مربوطه را برمی گرداند. در غیر این صورت ، OT CLI یک شبکه جدید و تصادفی ایجاد می کند و یک مجموعه داده جدید را برمی گرداند.

پارامترها

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

برای اولیه سازی یک مجموعه داده جدید new استفاده کنید ، سپس Command dataset commit active وارد کنید. tlvs برای TLV های رمزگذاری شده HEX استفاده کنید.

نمونه ها 

dataset init new
Done

منابع CLI و API

DataSet MeshlocalPrefix (دریافت ، تنظیم)

OTOPERATIONDATASET :: mmeshlocalprefix را می گیرد یا تنظیم می کند.

پارامترها

dataset meshlocalprefix [meshlocalprefix]

برای تنظیم پیشوند مش-محلی مش استفاده از آرگومان meshlocalprefix اختیاری استفاده کنید.

نمونه ها 

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

منابع CLI و API

  • API همراه نیست

DataSet MgmtgetCommand فعال است

mgmt_active_get را ارسال می کند.

OT CLI با آرگومان های مربوطه یک MGMT_ACTIONALY_GET را ارسال می کند. برای کسب اطلاعات بیشتر در مورد این پارامترها و نگاشتهای آرگومان ، به نمایش داده ها با OT CLI مراجعه کنید.

پارامترها

dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
  • برای مشخص کردن مقصد IPv6 از address استفاده کنید. در غیر این صورت ، رهبر 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

DataSet MgmtgetCommand در انتظار

mgmt_pending_get را ارسال می کند.

پارامترها

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

برای کسب اطلاعات بیشتر در مورد این پارامترها و نگاشتهای آرگومان ، به نمایش داده ها با OT CLI مراجعه کنید.

نمونه ها 

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

منابع CLI و API

مجموعه داده MgmtsetCommand فعال است

mgmt_active_set را ارسال می کند.

پارامترها

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

برای کسب اطلاعات بیشتر در مورد این پارامترها و نگاشتهای آرگومان ، به نمایش داده ها با OT CLI مراجعه کنید.

نمونه ها 

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

منابع CLI و API

DataSet 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

DataSet NetworkKey (دریافت ، تنظیم)

OTOPERATIONDATASET :: MNETWORDKEY را می گیرد یا تنظیم می کند.

پارامترها

dataset networkkey [key]

برای تنظیم کلید شبکه از آرگومان key اختیاری استفاده کنید.

نمونه ها 

dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done

منابع CLI و API

  • API همراه نیست

DataSet NetworkName (دریافت ، تنظیم)

OTOPERATIONDATASET :: mnetworkName را دریافت می کند یا تنظیم می کند.

پارامترها

dataset networkname [name]

برای تنظیم نام شبکه از آرگومان name اختیاری استفاده کنید.

نمونه ها 

dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done

منابع CLI و API

panid dataSet (دریافت ، تنظیم)

OTOPERATIONDATASET :: MPANID را می گیرد یا تنظیم می کند.

پارامترها

dataset panid [panid]

برای تنظیم شناسه PAN از آرگومان panid اختیاری استفاده کنید.

نمونه ها 

dataset panid
0x1234
Done
dataset panid 0x1234
Done

منابع CLI و API

  • API همراه نیست

مجموعه داده در انتظار timestamp (دریافت ، تنظیم)

OTOPERATIONDATASET :: mpendingtimestamp را می گیرد یا تنظیم می کند.

پارامترها

dataset pendingtimestamp [timestamp]

برای تنظیم ثانیه های زمان در انتظار از آرگومان timestamp اختیاری استفاده کنید.

نمونه ها 

dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done

منابع CLI و API

  • API همراه نیست

DataSet PSKC (دریافت ، تنظیم)

OTOPERATIONDATASET :: MPSKC را دریافت یا تنظیم می کند.

پارامترها

dataset pskc [-p passphrase] | [key]

فقط برای FTD ، با استدلال passphrase از -p استفاده کنید. -p یک PSKC را از passphrase رمزگذاری شده UTF-8 که شما تهیه می کنید ، همراه با نام شبکه و شناسه PAN گسترده تولید می کند. در صورت تنظیم ، -p از بافر مجموعه داده استفاده می کند. در غیر این صورت ، از پشته فعلی استفاده می کند. از طرف دیگر ، می توانید PSKC را به عنوان key (قالب hex) تنظیم کنید.

نمونه ها 

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

منابع CLI و API

  • API همراه نیست

DataSet SecurityPolicy (دریافت ، تنظیم)

خط مشی امنیتی مجموعه داده ها را تنظیم یا تنظیم می کند.

پارامترها

dataset securitypolicy [rotationtime [onrcCepR]]

نمونه ها 

dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done

منابع CLI و API

  • API همراه نیست

مجموعه مجموعه داده ها (فعال ، در انتظار)

مجموعه داده های عملیاتی فعال را تنظیم می کند.

اگر مجموعه داده شامل یک جدول زمانی فعال نباشد ، مجموعه داده فقط تا حدی کامل است.

اگر موضوع بر روی دستگاهی فعال شود که دارای یک مجموعه داده فعال جزئی کامل باشد ، دستگاه سعی خواهد کرد با استفاده از هرگونه اطلاعات موجود در مجموعه داده ، به یک شبکه نخ موجود وصل شود. فقط کلید شبکه نخ برای اتصال به یک شبکه لازم است.

اگر کانال در مجموعه داده گنجانده نشده باشد ، دستگاه پیام های اعلام شده MLE را در کانال های مختلف ارسال می کند تا همسایگان را در کانال های دیگر پیدا کند.

اگر دستگاه با موفقیت به یک شبکه نخ وصل شود ، دستگاه سپس مجموعه داده فعال کامل را از والدین خود بازیابی می کند. توجه داشته باشید که تا زمانی که یک مجموعه داده فعال کامل داشته باشد ، یک دستگاه با قابلیت روتر به نقش روتر یا رهبر منتقل نمی شود.

این عملکرد به طور مداوم OT_ERROR_NONE را برمی گرداند و به طور موثری می تواند به عنوان داشتن نوع بازگشت void رفتار شود. پیش از این ، خطاهای دیگر (به عنوان مثال ، OT_ERROR_NOT_IMPLEMENTED ) به دلایل میراث مجاز بود. با این حال ، از آنجا که اکنون ذخیره سازی غیر فرار برای عملکرد نخ الزامی است ، هرگونه عدم ذخیره در مجموعه داده باعث ایجاد ادعای می شود. نوع بازده otError برای سازگاری به عقب حفظ می شود.

دستور dataset set CLI مجموعه داده های عملیاتی فعال را با استفاده از TLV های رمزگذاری شده HEX تنظیم می کند.

پارامترها 

dataset set {active|pending} tlvs

نمونه ها 

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

منابع CLI و API

مجموعه داده های TLV

یک مجموعه داده عملیاتی داده شده را به otOperationalDatasetTlvs تبدیل می کند.

پارامترها

بدون پارامتر

نمونه ها 

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

منابع CLI و API

DataSet Updater لغو

درخواست به روزرسانی داده های عملیاتی در حال انجام (در صورت وجود) را لغو می کند.

در صورت فعال بودن OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE در دسترس است.

پارامترها

بدون پارامتر

نمونه ها 

@dataset updater cancel
Done

منابع CLI و API

به روزرسانی مجموعه داده

نشان می دهد که آیا یک درخواست به روزرسانی مجموعه داده های عملیاتی در حال انجام است یا خیر.

در صورت فعال بودن OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE در دسترس است.

پارامترها

بدون پارامتر

نمونه ها 

dataset updater
Enabled
Done

منابع CLI و API

شروع به روزرسانی مجموعه داده

درخواست به روزرسانی در مجموعه داده های عملیاتی.

در صورت فعال بودن OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE در دسترس است.

aDataset باید شامل زمینه هایی باشد که باید به روز شوند و مقدار جدید آنها باشد. این نباید حاوی زمینه های فعال یا در انتظار زمان باشد. قسمت تأخیر اختیاری است ، در صورت عدم استفاده از مقدار پیش فرض (1000 میلی ثانیه).

پارامترها

بدون پارامتر

نمونه ها 

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

منابع CLI و API

اشکال زدایی

برای جمع آوری اطلاعات در مورد دستگاه و شبکه نخ ، یک سری دستورات CLI را اجرا می کند. این برای اشکال زدایی در نظر گرفته شده است. خروجی هر دستور CLI اجرا شده قبل از $ را نشان می دهد و به دنبال آن خروجی تولید شده فرمان مربوطه. خروجی تولید شده اطلاعات زیر را شامل می شود:

  • نسخه
  • وضعیت فعلی
  • RLOC16 ، آدرس MAC گسترده
  • لیست آدرس unicast و multicast ipv6
  • کانال
  • شناسه تابه و شناسه تابه
  • داده های شبکه
  • شناسه پارتیشن
  • داده های رهبر

اگر دستگاه به عنوان FTD کار می کند:

  • میز و میز همسایه
  • جدول روتر و اطلاعات بعدی هاپ
  • جدول حافظه نهان
  • آدرس IPv6 کودک MTD ثبت شده
  • خصوصیات دستگاه

اگر دستگاه به عنوان مشتری SRP پشتیبانی و عمل کند:

  • حالت مشتری SRP
  • خدمات مشتری SRP و اطلاعات میزبان

اگر دستگاه به عنوان SRP STEEN پشتیبانی و عمل کند:

  • حالت سرور SRP و حالت آدرس
  • سرور SRP میزبان و خدمات ثبت شده

اگر دستگاه از TREL پشتیبانی می کند:

  • وضعیت تریل و جدول همسالان

اگر دستگاه به عنوان روتر مرزی پشتیبانی و عمل کند:

  • حالت
  • پیشوند BR (OMR ، on-link ، nat64)
  • جدول پیشوند کشف شده

پارامترها

بدون پارامتر

نمونه ها

منابع CLI و API

  • API همراه نیست

تأخیر مارمین (مجموعه)

حداقل تایمر تأخیر (در ثانیه) را تنظیم می کند.

پارامترها 

delaytimermin delaytimermin

نمونه ها 

delaytimermin 60
Done

منابع CLI و API

تاخیر

حداقل تایمر تأخیر (در ثانیه) دریافت کنید.

پارامترها

بدون پارامتر

نمونه ها 

delaytimermin
30
Done

منابع CLI و API

جدا کردن

فرآیند جداشده برازنده را شبیه به دستور detach بدون مسدود کردن و انتظار برای پاسخ به تماس ، شروع به پایان یافتن جدا کردن.

پارامترها

بدون پارامتر

نمونه ها 

detach async
Done

منابع CLI و API

جدا کردن

فرآیند جداشدگی برازنده را با اطلاع ابتدا گره های دیگر (ارسال انتشار آدرس در صورت عمل به عنوان روتر ، یا تعیین مقدار زمان کودک در برابر والدین در صورت فعالیت به عنوان کودک) و سپس متوقف کردن عملکرد پروتکل موضوع ، شروع کنید.

پارامترها

بدون پارامتر

نمونه ها 

detach
Finished detaching
Done

منابع CLI و API

دستگاه (SET)

خصوصیات دستگاه را تنظیم می کند.

پارامترها

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

powerSupply : باید "باتری" ، "خارجی" ، "پایدار خارجی" ، "غیرقانونی خارجی" باشد.

نمونه ها 

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

منابع CLI و API

دستگاه

خصوصیات دستگاه فعلی را دریافت کنید.

به OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE نیاز دارد.

پارامترها

بدون پارامتر

نمونه ها 

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

منابع CLI و API

کشف کنید

یک عملیات کشف MLE را انجام دهید.

پارامترها

discover [channel]

channel : کانال برای کشف در. در صورت عدم ارائه کانال ، این کشف تمام کانال های معتبر را پوشش می دهد.

نمونه ها 

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

منابع CLI و API

کشف reqcallback (فعال کردن ، غیرفعال کردن)

برای دریافت داده های درخواست MLE Discovery یک تماس تلفنی را تنظیم می کند.

پارامترها 

discover reqcallback enable|disable

نمونه ها 

discover reqcallback enable
Done

منابع CLI و API

DNS مرور کنید

برای دریافت لیست خدمات برای نام خدمات ، یک مرور (شمارش نمونه خدمات) DNS ارسال کنید

پارامترهای پس از service-name اختیاری هستند. هر مقدار نامشخص (یا صفر) برای این پارامترهای اختیاری با مقدار از پیکربندی پیش فرض فعلی ( dns config ) جایگزین می شود.

پارامترها 

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

نمونه ها 

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

منابع CLI و API

فشرده سازی DNS (فعال کردن ، غیرفعال کردن)

حالت "فشرده سازی نام DNS" را تنظیم کنید.

به طور پیش فرض فشرده سازی نام DNS فعال است. هنگام غیرفعال کردن ، نام DNS به صورت کامل و هرگز فشرده نمی شود. این کار برای ماژول های DNS/SRP Client/ OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE Openthread قابل استفاده است.

پارامترها 

dns compression [enable|disable]

نمونه ها 

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

منابع CLI و API

فشرده سازی DNS

نشان می دهد که آیا حالت "فشرده سازی نام DNS" فعال است یا خیر.

این فقط برای آزمایش در نظر گرفته شده است و در صورت فعال بودن OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE در دسترس است.

به طور پیش فرض فشرده سازی نام DNS فعال است. هنگام غیرفعال کردن ، نام DNS به صورت کامل و هرگز فشرده نمی شود. این کار برای ماژول های DNS/SRP Client/ OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE Openthread قابل استفاده است.

پارامترها 

dns compression [enable|disable]

نمونه ها 

dns compression
Enabled

منابع CLI و API

پیکربندی DNS (SET)

پیکربندی پرس و جو پیش فرض را در مشتری DNS تنظیم می کند.

در یک aConfig غیر تهی ، تماس گیرنده می تواند برخی از زمینه ها را در نمونه otDnsQueryConfig نامشخص (ارزش صفر) بگذارد. زمینه های نامشخص توسط تعاریف گزینه پیکربندی OT OPENTHREAD_CONFIG_DNS_CLIENT DEFAULT {} جایگزین می شوند تا پیکربندی پرس و جو پیش فرض را تشکیل دهند.

هنگامی که OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE فعال می شود ، آدرس IPv6 سرور در پیکربندی پیش فرض به طور خودکار توسط مشتری DNS تنظیم و به روز می شود. این کار فقط هنگامی انجام می شود که کاربر به صراحت آن را تنظیم یا مشخص نکند. این رفتار نیاز به SRP Client و ویژگی شروع خودکار آن دارد. SRP Client سپس داده های شبکه نخ را برای ورودی های سرویس DNS/SRP نظارت می کند تا یک سرور SRP را انتخاب کند. آدرس سرور SRP انتخاب شده نیز به عنوان آدرس سرور DNS در پیکربندی پیش فرض تنظیم شده است.

ما می توانیم برخی از زمینه ها را به عنوان نامشخص (یا از مقدار صفر استفاده کنیم) بگذاریم. زمینه های نامشخص با تعاریف گزینه پیکربندی OT مربوطه جایگزین می شوند که OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT تشکیل می دهد تا پیکربندی پیش فرض پرس و جو را تشکیل دهد. OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE مورد نیاز است.

پارامترها 

dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode] [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

پیکربندی DNS

پیکربندی پرس و جو پیش فرض فعلی را که توسط DNS Client استفاده می شود ، دریافت می کند.

هنگامی که Openthread Stack شروع می شود ، پیکربندی پیش فرض DNS Query از مجموعه ای از گزینه های پیکربندی OT مانند OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS ، _DEFAULT_SERVER_PORT ، _DEFAULT_RESPONSE_TIMEOUT ، و غیره تعیین می شود (به همه config/dns_client.h های مربوط به پیکربندی) مراجعه کنید.

پیکربندی شامل آدرس و پورت سرور IPv6 ، زمان پاسخ در MSEC (زمان انتظار برای پاسخ RX) ، حداکثر تلاش TX قبل از گزارش خرابی ، پرچم بولی برای نشان دادن اینکه آیا سرور می تواند پرس و جو را به صورت بازگشتی حل کند یا خیر. OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE مورد نیاز است.

پارامترها

بدون پارامتر

نمونه ها 

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

منابع CLI و API

DNS Resolve

یک پرسش وضوح DNS با وضوح آدرس را برای ثبت (های) AAAA (IPv6) برای نام میزبان داده شده ارسال می کند.

aConfig می تواند تهی باشد. در این حالت از پیکربندی پیش فرض (از otDnsClientGetDefaultConfig() ) به عنوان پیکربندی این پرس و جو استفاده می شود. در یک aConfig غیر تهی ، برخی از زمینه ها را می توان نا مشخص (مقدار صفر) باقی گذاشت. قسمتهای نامشخص سپس با مقادیر از پیکربندی پیش فرض جایگزین می شوند.

برای به دست آوردن آدرس IPv6 برای نام میزبان داده شده ، پرس و جو DNS را ارسال کنید.

پارامترهای بعد از نام میزبان اختیاری هستند. هر مقدار نامشخص (یا صفر) برای این پارامترهای اختیاری با مقدار از پیکربندی پیش فرض فعلی (پیکربندی DNS) جایگزین می شود.

IP سرور DNS می تواند یک آدرس IPv4 باشد ، که با استفاده از پیشوند NAT64 مورد نظر از داده های شبکه به یک آدرس IPv6 سنتز می شود.

پارامترها 

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

نمونه ها 

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

منابع CLI و API

سرویس DNS

وضوح نمونه خدمات DNS را برای یک نمونه خدمات خاص شروع می کند.

در صورت فعال بودن OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE در دسترس است.

aConfig می تواند تهی باشد. در این حالت از پیکربندی پیش فرض (از otDnsClientGetDefaultConfig() ) به عنوان پیکربندی این پرس و جو استفاده می شود. در یک aConfig غیر تهی ، برخی از زمینه ها را می توان نا مشخص (مقدار صفر) باقی گذاشت. قسمتهای نامشخص سپس با مقادیر از پیکربندی پیش فرض جایگزین می شوند.

این تابع برای نمونه خدمات داده شده برای سوابق SRV و/یا TXT ارسال می کند. قسمت mServiceMode در otDnsQueryConfig تعیین می کند که کدام سوابق برای پرس و جو (فقط SRV ، فقط TXT یا هر دو SRV و TXT) و نحوه انجام پرس و جو (با هم در همان پیام ، به طور جداگانه به صورت موازی یا در حالت بهینه سازی شده که مشتری در آن سعی خواهد کرد در آن تلاش کند ، تعیین می کند. ابتدا همان پیام و سپس به طور جداگانه اگر نتواند پاسخی دریافت کند).

سوابق SRV اطلاعاتی در مورد بندر خدمات ، اولویت و وزن همراه با نام میزبان مرتبط با نمونه خدمات ارائه می دهد. این عملکرد وضوح آدرس را برای نام میزبان کشف شده از SRV Record انجام نمی دهد. سرور/حل کننده ممکن است AAAA/A ضبط (های) را برای نام میزبان در بخش داده اضافی پاسخ به پرس و جو SRV/TXT ارائه دهد و این اطلاعات را می توان با استفاده از otDnsServiceResponseGetServiceInfo() در otDnsServiceCallback بازیابی کرد. کاربران این API نباید فرض کنند که آدرس میزبان همیشه از otDnsServiceResponseGetServiceInfo() در دسترس خواهد بود.

برای یک نمونه خدمات خاص ، یک پرس و جو DNS وضوح نمونه خدمات ارسال کنید. برچسب نمونه خدمات ابتدا ارائه می شود و پس از آن نام سرویس (توجه داشته باشید که برچسب نمونه خدمات می تواند حاوی شخصیت باشد.

پارامترهای پس از service-name اختیاری هستند. هر مقدار نامشخص (یا صفر) برای این پارامترهای اختیاری با مقدار از پیکربندی پیش فرض فعلی ( dns config ) جایگزین می شود.

پارامترها 

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

نمونه ها

منابع CLI و API

سرویس DNS

وضوح نمونه خدمات DNS را برای یک نمونه خدمات خاص شروع می کند ، با وضوح بالقوه پیگیری آدرس برای نام میزبان که برای نمونه خدمات کشف شده است.

در صورت فعال بودن OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE در دسترس است.

aConfig می تواند تهی باشد. در این حالت از پیکربندی پیش فرض (از otDnsClientGetDefaultConfig() ) به عنوان پیکربندی این پرس و جو استفاده می شود. در یک aConfig غیر تهی ، برخی از زمینه ها را می توان نا مشخص (مقدار صفر) باقی گذاشت. قسمتهای نامشخص سپس با مقادیر از پیکربندی پیش فرض جایگزین می شوند. This function cannot be used with mServiceMode in DNS config set to OT_DNS_SERVICE_MODE_TXT (ie, querying for TXT record only) and will return OT_ERROR_INVALID_ARGS .

Behaves similarly to otDnsClientResolveService() sending queries for SRV and TXT records. However, if the server/resolver does not provide AAAA/A records for the host name in the response to SRV query (in the Additional Data section), it will perform host name resolution (sending an AAAA query) for the discovered host name from the SRV record. The callback aCallback is invoked when responses for all queries are received (ie, both service and host address resolutions are finished).

Send a service instance resolution DNS query for a given service instance with potential follow-up host name resolution. Service instance label is provided first, followed by the service name (note that service instance label can contain dot '.' character).

The parameters after service-name are optional. Any unspecified (or zero) value for these optional parameters is replaced by the value from the current default config ( dns config ).

پارامترها 

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

نمونه ها

CLI and API References

domainname (set)

Sets the Thread Domain Name.

Only succeeds when Thread protocols are disabled.

پارامترها

domainname name

Use a backslash to escape spaces.

نمونه ها 

domainname Test\ Thread
Done

CLI and API References

domainname

Gets the Thread Domain Name.

پارامترها

بدون پارامتر

نمونه ها 

domainname
Thread
Done

CLI and API References

dua iid (set,clear)

Sets or clears the Interface Identifier manually specified for the Thread Domain Unicast Address.

Available when OPENTHREAD_CONFIG_DUA_ENABLE is enabled.

پارامترها

dua iid iid|clear

dua iid clear passes a nullptr to otThreadSetFixedDuaInterfaceIdentifier . Otherwise, you can pass the iid .

نمونه ها 

dua iid 0004000300020001
Done
dua iid clear
Done

CLI and API References

dua iid

Gets the Interface Identifier manually specified for the Thread Domain Unicast Address.

Available when OPENTHREAD_CONFIG_DUA_ENABLE is enabled.

پارامترها

بدون پارامتر

نمونه ها 

dua iid
0004000300020001
Done

CLI and API References

eidcache

Returns the EID-to-RLOC cache entries.

پارامترها

بدون پارامتر

نمونه ها 

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 and API References

eui64

Gets the factory-assigned IEEE EUI-64 for this interface.

پارامترها

بدون پارامتر

نمونه ها 

eui64
0615aae900124b00
Done

CLI and API References

extaddr (set)

Sets the IEEE 802.15.4 Extended Address.

پارامترها 

extaddr extaddr

نمونه ها 

extaddr dead00beef00cafe
dead00beef00cafe
Done

CLI and API References

extaddr

Gets the IEEE 802.15.4 Extended Address.

پارامترها

بدون پارامتر

نمونه ها 

extaddr
dead00beef00cafe
Done

CLI and API References

extpanid (set)

Sets the IEEE 802.15.4 Extended PAN ID.

پارامترها 

extpanid extpanid

نمونه ها 

extpanid dead00beef00cafe
Done

CLI and API References

extpanid

Gets the IEEE 802.15.4 Extended PAN ID.

پارامترها

بدون پارامتر

نمونه ها 

extpanid
dead00beef00cafe
Done

CLI and API References

factoryreset

Deletes all the settings stored on non-volatile memory, and then triggers a platform reset.

پارامترها

بدون پارامتر

نمونه ها 

factoryreset

CLI and API References

fake (a,an)

Sends fake Thread messages.

Available when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is enabled.

پارامترها 

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 and API References

زن

Gets external FEM parameters.

پارامترها

بدون پارامتر

نمونه ها 

fem
LNA gain 11 dBm
Done

CLI and API References

fem lnagain (get)

Gets the external FEM's Rx LNA gain in dBm.

پارامترها

بدون پارامتر

نمونه ها 

fem lnagain
11
Done

CLI and API References

fem lnagain (set)

Sets the external FEM's Rx LNA gain in dBm.

پارامترها

بدون پارامتر

نمونه ها 

fem lnagain 8
Done

CLI and API References

history ipaddr

Displays the unicast IPv6 address history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Event: Possible values are Added or Removed .
  • Address/Prefix Length: Unicast address with its prefix length (in bits).
  • Origin: Possible value are thread , slaac , dhcp6 , or manual .
  • Scope: IPv6 address scope.
  • P: Preferred flag.
  • V: Valid flag.
  • RLOC (R): This flag indicates if the IPv6 address is a routing locator.

پارامترها

history ipaddr [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history ipmaddr

Displays the multicast IPv6 address history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Event: Possible values are Subscribed or Unsubscribed .
  • آدرس چندپخشی
  • Origin: Possible values are Thread or Manual .

پارامترها

history ipmaddr [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history neighbor

Displays the neighbor history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Type: Child or Router .
  • Event: Possible values are Added , Removed , or Changed .
  • Extended Address
  • RLOC16
  • Mode: MLE link mode. Possible values:
    • - : no flags set (rx-off-when-idle, minimal Thread device, stable network data).
    • r : rx-on-when-idle
    • d : Full Thread Device.
    • n : Full Network Data
  • Ave RSS: Average number of frames (in dBm) received from the neighbor at the time the entry was recorded.

پارامترها

history neighbor [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history netinfo

Displays the network info history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Role: Device role. Possible values are router , child , detached , or disabled .
  • Mode: MLE link mode. Possible values:
    • - : no flags set (rx-off-when-idle, minimal Thread device, stable network data).
    • r : rx-on-when-idle
    • d : Full Thread Device.
    • n : Full Network Data
  • RLOC16
  • Partition ID.

پارامترها

history netinfo [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history prefix

Displays the network data for the mesh prefix history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Event: Possible values are Added or Removed .
  • پیشوند
  • Flags/meaning:
    • p : Preferred flag
    • a : Stateless IPv6 address auto-configuration flag.
    • d : DHCPv6 IPv6 address configuration flag.
    • c : DHCPv6 other-configuration flag.
    • r : Default route flag.
    • o : On mesh flag.
    • s : Stable flag.
    • n : Nd Dns flag.
    • D : Domain prefix flag.
  • Pref: Preference. Values can be either high , med , or low .
  • RLOC16

پارامترها

history prefix [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history route

Displays the network data external-route history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Event: Possible values are Added or Removed .
  • مسیر
  • Flags/meaning:
    • s : Stable flag.
    • n : NAT64 flag.
  • Pref: Preference. Values can be either high , med , or low .
  • RLOC16

پارامترها

history route [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history router

Displays the route-table history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • Event: Possible values are Added , Removed , NextHopChanged , or CostChanged .
  • ID (RLOC16): Router ID and RLOC16 of the router.
  • Next Hop: Router ID and RLOC16 of the next hop. If there is no next hop, none is shown.
  • Path Cost: old cost -> new cost. A value of inf indicates an infinite path cost.

پارامترها

history router [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history rx

Displays the IPv6 message RX history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • نوع:
    • IPv6 message type, such as UDP , TCP , HopOpts , and ICMP6 (and its subtype).
    • src : Source IPv6 address and port number.
    • dst : Destination IPv6 address and port number (port number is valid for UDP/TCP, otherwise it is 0).
  • Len: IPv6 payload length (excluding the IPv6 header).
  • Chksum: Message checksum (valid for UDP, TCP, or ICMP6 messages).
  • Sec: Indicates if link-layer security was used.
  • Prio: Message priority. Possible values are low , norm , high , or net (for Thread control messages).
  • RSS: Received Signal Strength (in dBm), averaged over all received fragment frames that formed the message. For TX history, NA (not applicable) is displayed.
  • Dir: Shows whether the message was sent ( TX ) or received ( RX ). A failed transmission is indicated with TX-F in table format or tx-success:no in list format. Examples of a failed transmission include a tx getting aborted and no ack getting sent from the peer for any of the message fragments.
  • Neighb: Short address (RLOC16) of the neighbor with whom the message was sent/received. If the frame was broadcast, it is shown as bcast in table format or 0xffff in list format. If the short address of the neighbor is not available, it is shown as unknwn in table format or 0xfffe in list format.
  • Radio: Radio link on which the message was sent/received (useful when OPENTHREAD_CONFIG_MULTI_RADIO is enabled). Can be 15.4 , trel , or all (if sent on all radio links).

پارامترها

history rx [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history rxtx

Displays the combined IPv6 message RX and TX history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • نوع:
    • IPv6 message type, such as UDP , TCP , HopOpts , and ICMP6 (and its subtype).
    • src : Source IPv6 address and port number.
    • dst : Destination IPv6 address and port number (port number is valid for UDP/TCP, otherwise it is 0).
  • Len: IPv6 payload length (excluding the IPv6 header).
  • Chksum: Message checksum (valid for UDP, TCP, or ICMP6 messages).
  • Sec: Indicates if link-layer security was used.
  • Prio: Message priority. Possible values are low , norm , high , or net (for Thread control messages).
  • RSS: Received Signal Strength (in dBm), averaged over all received fragment frames that formed the message. For TX history, NA (not applicable) is displayed.
  • Dir: Shows whether the message was sent ( TX ) or received ( RX ). A failed transmission is indicated with TX-F in table format or tx-success:no in list format. Examples of a failed transmission include a tx getting aborted and no ack getting sent from the peer for any of the message fragments.
  • Neighb: Short address (RLOC16) of the neighbor with whom the message was sent/received. If the frame was broadcast, it is shown as bcast in table format or 0xffff in list format. If the short address of the neighbor is not available, it is shown as unknwn in table format or 0xfffe in list format.
  • Radio: Radio link on which the message was sent/received (useful when OPENTHREAD_CONFIG_MULTI_RADIO is enabled). Can be 15.4 , trel , or all (if sent on all radio links).

پارامترها

history rxtx [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

history tx

Displays the IPv6 message TX history in table or list format.

Each table or list entry provides:

  • Age: Time elapsed since the command was issued, and given in the format: hours : minutes : seconds : milliseconds
  • نوع:
    • IPv6 message type, such as UDP , TCP , HopOpts , and ICMP6 (and its subtype).
    • src : Source IPv6 address and port number.
    • dst : Destination IPv6 address and port number (port number is valid for UDP/TCP, otherwise it is 0).
  • Len: IPv6 payload length (excluding the IPv6 header).
  • Chksum: Message checksum (valid for UDP, TCP, or ICMP6 messages).
  • Sec: Indicates if link-layer security was used.
  • Prio: Message priority. Possible values are low , norm , high , or net (for Thread control messages).
  • RSS: Received Signal Strength (in dBm), averaged over all received fragment frames that formed the message. For TX history, NA (not applicable) is displayed.
  • Dir: Shows whether the message was sent ( TX ) or received ( RX ). A failed transmission is indicated with TX-F in table format or tx-success:no in list format. Examples of a failed transmission include a tx getting aborted and no ack getting sent from the peer for any of the message fragments.
  • Neighb: Short address (RLOC16) of the neighbor with whom the message was sent/received. If the frame was broadcast, it is shown as bcast in table format or 0xffff in list format. If the short address of the neighbor is not available, it is shown as unknwn in table format or 0xfffe in list format.
  • Radio: Radio link on which the message was sent/received (useful when OPENTHREAD_CONFIG_MULTI_RADIO is enabled). Can be 15.4 , trel , or all (if sent on all radio links).

پارامترها

history tx [list] [num-entries]
  • Use the list option to display the output in list format. Otherwise, the output is shown in table format.
  • Use the num-entries option to limit the output to the number of most-recent entries specified. If this option is not used, all stored entries are shown in the output.

نمونه ها 

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 and API References

ifconfig (up,down)

Brings the IPv6 interface up or down.

Call this to enable or disable IPv6 communication.

پارامترها 

ifconfig up|down

نمونه ها 

ifconfig up
Done
ifconfig down
Done

CLI and API References

ifconfig

Indicates whether or not the IPv6 interface is up.

پارامترها

بدون پارامتر

نمونه ها 

ifconfig
down
Done
ifconfig
up
Done

CLI and API References

instanceid

Gets the instance identifier.

The instance identifier is set to a random value when the instance is constructed, and then its value will not change after initialization.

پارامترها

بدون پارامتر

نمونه ها 

instanceid
468697314
Done

CLI and API References

ipaddr add

Adds a Network Interface Address to the Thread interface.

The passed-in instance aAddress is copied by the Thread interface. The Thread interface only supports a fixed number of externally added unicast addresses. See OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS .

پارامترها 

ipaddr add aAddress

نمونه ها 

ipaddr add 2001::dead:beef:cafe
Done

CLI and API References

ipaddr del

Removes a Network Interface Address from the Thread interface.

پارامترها 

ipaddr del aAddress

نمونه ها 

ipaddr del 2001::dead:beef:cafe
Done

CLI and API References

ipaddr

Gets the list of IPv6 addresses assigned to the Thread interface.

پارامترها

ipaddr [-v]

Use -v to get more verbose information about the address:

  • origin : can be thread , slaac , dhcp6 , manual and indicates the origin of the address
  • plen : prefix length
  • preferred : preferred flag (boolean)
  • valid : valid flag (boolean)

نمونه ها 

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 and API References

ipaddr linklocal

Gets the Thread link-local IPv6 address.

The Thread link local address is derived using IEEE802.15.4 Extended Address as Interface Identifier.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

ipaddr mleid

Gets the Mesh Local EID address.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

ipaddr rloc

Gets the Thread Routing Locator (RLOC) address.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

ipmaddr add

Subscribes the Thread interface to a Network Interface Multicast Address.

The passed in instance aAddress will be copied by the Thread interface. The Thread interface only supports a fixed number of externally added multicast addresses. See OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS .

پارامترها 

ipmaddr add aAddress

نمونه ها 

ipmaddr add ff05::1
Done

CLI and API References

ipmaddr del

Unsubscribes the Thread interface to a Network Interface Multicast Address.

پارامترها 

ipmaddr del aAddress

نمونه ها 

ipmaddr del ff05::1
Done

CLI and API References

ipmaddr

Gets the list of IPv6 multicast addresses subscribed to the Thread interface.

پارامترها

بدون پارامتر

نمونه ها 

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 and API References

ipmaddr llatn

Gets the Thread Link-Local All Thread Nodes multicast address.

The address is a link-local Unicast Prefix-Based Multicast Address [RFC 3306], with:

  • flgs set to 3 (P = 1 and T = 1)
  • scop set to 2
  • plen set to 64
  • network prefix set to the Mesh Local Prefix
  • group ID set to 1

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

ipmaddr rlatn

Gets the Thread Realm-Local All Thread Nodes multicast address.

The address is a realm-local Unicast Prefix-Based Multicast Address [RFC 3306], with:

  • flgs set to 3 (P = 1 and T = 1)
  • scop set to 3
  • plen set to 64
  • network prefix set to the Mesh Local Prefix
  • group ID set to 1

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

joiner discerner (set)

Sets the Joiner Discerner.

پارامترها

joiner discerner discerner
  • Use {number}/{length} to set the discerner .
  • joiner discerner clear sets aDiscerner to nullptr .

نمونه ها 

joiner discerner 0xabc/12
Done

CLI and API References

joiner discerner clear

Clear the Joiner discerner.

پارامترها

بدون پارامتر

نمونه ها 

joiner discerner clear
Done

CLI and API References

  • No associated API

joiner discerner

Gets the Joiner Discerner.

For more information, refer to otJoinerSetDiscerner .

پارامترها

بدون پارامتر

نمونه ها 

joiner discerner
0xabc/12
Done

CLI and API References

joiner help

Print the joiner help menu.

پارامترها

بدون پارامتر

نمونه ها 

joiner help
help
id
start
state
stop
Done

CLI and API References

  • No associated API

joiner id

Gets the Joiner ID.

If a Joiner Discerner is not set, Joiner ID is the first 64 bits of the result of computing SHA-256 over factory-assigned IEEE EUI-64. Otherwise the Joiner ID is calculated from the Joiner Discerner value.

The Joiner ID is also used as the device's IEEE 802.15.4 Extended Address during the commissioning process.

پارامترها

بدون پارامتر

نمونه ها 

joiner id
d65e64fa83f81cf7
Done

CLI and API References

joiner start

Enables the Thread Joiner role.

پارامترها

joiner start joining-device-credential [provisioning-url]
  • joining-device-credential : Joiner Passphrase. Must be a string of all uppercase alphanumeric characters (0-9 and AY, excluding I, O, Q, and Z for readability), with a length between 6 and 32 characters.
  • provisioning-url : Provisioning URL for the Joiner (optional).

نمونه ها 

joiner start J01NM3
Done

CLI and API References

joiner state

Gets the Joiner State.

Returns one of the following states:

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

پارامترها

بدون پارامتر

نمونه ها 

joiner state
Idle
Done

CLI and API References

joiner stop

Disables the Thread Joiner role.

پارامترها

بدون پارامتر

نمونه ها 

joiner stop
Done

CLI and API References

joinerport (set)

Sets the Joiner UDP Port.

پارامترها 

joinerport udp-port

نمونه ها 

joinerport 1000
Done

CLI and API References

joinerport

Gets the Joiner UDP Port.

پارامترها

بدون پارامتر

نمونه ها 

joinerport
1000
Done

CLI and API References

keysequence counter (set)

Sets the thrKeySequenceCounter.

پارامترها 

keysequence counter counter

نمونه ها 

keysequence counter 10
Done

CLI and API References

keysequence counter

Gets the thrKeySequenceCounter.

پارامترها

بدون پارامتر

نمونه ها 

keysequence counter
10
Done

CLI and API References

keysequence guardtime (set)

Sets the thrKeySwitchGuardTime (in hours).

پارامترها

keysequence guardtime guardtime-hours

Use 0 to Thread Key Switch immediately if there's a key index match.

نمونه ها 

keysequence guardtime 0
Done

CLI and API References

keysequence guardtime

Gets the thrKeySwitchGuardTime (in hours).

پارامترها

بدون پارامتر

نمونه ها 

keysequence guardtime
0
Done

CLI and API References

leaderdata

Gets the Thread Leader Data.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

leaderweight (set)

Sets the Thread Leader Weight used when operating in the Leader role.

Directly sets the Leader Weight to the new value, replacing its previous value (which may have been determined from the current otDeviceProperties ).

پارامترها 

leaderweight weight

نمونه ها 

leaderweight 128
Done

CLI and API References

leaderweight

Gets the Thread Leader Weight used when operating in the Leader role.

پارامترها

بدون پارامتر

نمونه ها 

leaderweight
128
Done

CLI and API References

linkmetrics config enhanced-ack clear

Sends a Link Metrics Management Request to clear an Enhanced-ACK Based Probing.

پارامترها

linkmetrics config [async] peer-ipaddr enhanced-ack clear
  • async : Use the non-blocking mode.
  • peer-ipaddr should be the Link Local address of the neighboring device.

نمونه ها 

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 and API References

linkmetrics config enhanced-ack register

The additional r is optional and only used for reference devices. When this option is specified, Type/Average Enum of each Type Id Flags is set to reserved. This is used to verify that the Probing Subject correctly handles invalid Type Id Flags, and only available when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is enabled.

Sends a Link Metrics Management Request to register an Enhanced-ACK Based Probing.

پارامترها

linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
  • async : Use the non-blocking mode.
  • [ q , m , and r ] map to otLinkMetricsValues . Per spec 4.11.3.4.4.6, you can only use a maximum of two options at once, for example q , or qm .
    • q : Layer 2 LQI.
    • m : Link Margin.
    • 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 and API References

linkmetrics config forward

Sends an MLE Link Metrics Management Request to configure or clear a Forward Tracking Series.

پارامترها

linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
  • async : Use the non-blocking mode.
  • peer-ipaddr : Peer address.
  • series-id : The Series ID.
  • [ l , d , r , and a ] map to otLinkMetricsSeriesFlags . X represents none of the otLinkMetricsSeriesFlags , and stops the accounting and removes the series.
    • l : MLE Link Probe.
    • d : MAC Data.
    • r : MAC Data Request.
    • a : MAC Ack.
    • X : Can only be used without any other flags.
  • [ p , q , m , and r ] map to otLinkMetricsValues .
    • p : Layer 2 Number of PDUs received.
    • q : Layer 2 LQI.
    • m : Link Margin.
    • 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 and API References

linkmetrics probe

Sends an MLE Link Probe message.

پارامترها

linkmetrics probe peer-ipaddr series-id length
  • peer-ipaddr : Peer address.
  • series-id : The Series ID for which this Probe message targets.
  • length : The length of the Probe message. A valid range is [0, 64].

نمونه ها 

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

CLI and API References

linkmetrics request forward

Perform a Link Metrics query (Forward Tracking Series).

پارامترها

linkmetrics query [async] peer-ipaddr forward series-id
  • async : Use the non-blocking mode.
  • peer-ipaddr : Peer address.
  • series-id : The 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 and API References

linkmetrics request single

Perform a Link Metrics query (Single Probe).

پارامترها

linkmetrics request [async] peer-ipaddr single [pqmr]
  • async : Use the non-blocking mode.
  • peer-ipaddr : Peer address.
  • [ p , q , m , and r ] map to otLinkMetrics .
    • p : Layer 2 Number of PDUs received.
    • q : Layer 2 LQI.
    • m : Link Margin.
    • 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 and API References

linkmetricsmgr (enable,disable)

Enable or disable Link Metrics Manager.

پارامترها 

linkmetricsmgr enable|disable

نمونه ها 

linkmetricmgr enable
Done
linkmetricmgr disable
Done

CLI and API References

linkmetricsmgr show

Get Link Metrics data of a neighbor by its extended address.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

locate (set)

Locate the closest destination of an anycast address (ie, find the destination's mesh local EID and RLOC16).

The closest destination is determined based on the current routing table and path costs within the Thread mesh.

Available when OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE is enabled.

پارامترها 

locate anycastaddr

نمونه ها 

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

CLI and API References

locate

Gets the current state ( In Progress or Idle ) of anycast locator.

Available when OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE is enabled.

پارامترها

بدون پارامتر

نمونه ها 

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

locate
In Progress
Done

CLI and API References

log filename

Specifies filename to capture otPlatLog() messages, useful when debugging automated test scripts on Linux when logging disrupts the automated test scripts.

Requires OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART and OPENTHREAD_POSIX .

پارامترها 

log filename filename

نمونه ها

CLI and API References

log level (set)

Sets the log level.

پارامترها 

log level level

نمونه ها 

log level 4
Done

CLI and API References

log level

Get the log level.

پارامترها

بدون پارامتر

نمونه ها 

log level
1
Done

CLI and API References

mac retries direct (get,set)

Gets or sets the number of direct TX retries on the MAC layer.

پارامترها

mac retries direct [number]

Use the optional number argument to set the number of direct TX retries.

نمونه ها 

mac retries direct
3
Done
mac retries direct 5
Done

CLI and API References

mac retries indirect (get,set)

Gets or sets the number of indirect TX retries on the MAC layer.

پارامترها

mac retries indirect [number]

Use the optional number argument to set the number of indirect Tx retries.

نمونه ها 

mac retries indirect
3
Done
 max retries indirect 5
Done

CLI and API References

mac send

Instructs an Rx-Off-When-Idle device to send a MAC frame to its parent. This command is for certification, and can only be used when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is enabled.

پارامترها

mac send datarequest | emptydata

You must choose one of the following two arguments:

  • datarequest : Enqueues an IEEE 802.15.4 Data Request message for transmission.
  • emptydata : Instructs the device to send an empty IEEE 802.15.4 data frame.

نمونه ها 

mac send datarequest
Done
mac send emptydata
Done

CLI and API References

macfilter addr add

Is available only when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

Adds an IEEE 802.15.4 Extended Address to the MAC filter list. If you specify the optional rss argument, this fixes the received signal strength for messages from the address. If you do not use the rss option, the address will use whatever default value you have set. If you have not set a default, the signal strength will be the over-air signal.

پارامترها 

macfilter addr add extaddr [rss]

نمونه ها 

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

CLI and API References

macfilter addr allowlist

Enables the allowlist MAC filter mode, which means that only the MAC addresses in the MAC filter list will be allowed access.

پارامترها

بدون پارامتر

نمونه ها 

macfilter addr allowlist
Done

CLI and API References

macfilter addr clear

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

This command clears all the extended addresses from the MAC filter list.

پارامترها

بدون پارامتر

نمونه ها 

macfilter addr clear
Done

CLI and API References

macfilter addr denylist

Enables the denylist MAC filter mode, which means that all MAC addresses in the MAC filter list will be denied access.

پارامترها

بدون پارامتر

نمونه ها 

macfilter addr denylist
Done

CLI and API References

macfilter addr disable

Disables MAC filter modes.

پارامترها

بدون پارامتر

نمونه ها 

macfilter addr disable
Done

CLI and API References

  • No associated API

macfilter addr

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

Provides the following information:

  • Current mode of the MAC filter list: Either AllowList , DenyList, or Disabled
  • A list of all the extended addresses in the filter. The received signal strength (rss) and link quality indicator (lqi) are listed next to the address if these values have been set to be different from the default values.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

macfilter addr remove

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

This command removes the specified extended address from the MAC filter list.

پارامترها 

macfilter addr remove extaddr

نمونه ها 

macfilter addr remove 0f6127e33af6b402
Done

CLI and API References

macfilter

Provides the following information:

  • Address Mode : Current mode of the MAC filter: Either AllowList , DenyList, or Disabled
  • A list of all the extended addresses in the MAC filter list. The received signal strength (rss) and link quality indicator (lqi) are listed next to the address if these values have been set to be different from the default values.
  • A separate list ( RssIn List ) that shows all the extended addresses where the rss has been set to be different from the default value.
  • Default rss : Shows the default values, if applicable, for the rss and lqi settings.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

macfilter rss add

Adds the specified Extended Address to the RssIn list (or modifies an existing address in the RssIn list) and sets the received signal strength (in dBm) entry for messages from that address.

پارامترها

macfilter rss add extaddr rss

To set a default value for the received signal strength for all received messages, use the * for the extaddr argument.

نمونه ها 

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

CLI and API References

macfilter rss add-lqi

Adds the specified Extended Address to the RssIn list (or modifies an existing address in the RssIn list) and sets the fixed link quality indicator for messages from that address. The Extended Address does not necessarily have to be in the address allowlist/denylist filter to set the lqi .

This is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

پارامترها

macfilter rss add-lqi extaddr lqi

To set a default value for the link quality indicator for all received messages, use the * for the extaddr argument. The allowed range is 0 to 3.

نمونه ها 

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

CLI and API References

macfilter rss clear

Clears all the received signal strength ( rss ) and link quality indicator ( lqi ) entries (including defaults) from the RssIn list.

Performing this action means that all Extended Addresses will use the on-air signal.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

پارامترها

بدون پارامتر

نمونه ها 

macfilter rss clear
Done

CLI and API References

macfilter rss

Provides the following information:

  • Listing of all the extended addresses where the received signal strength ( rss ) has been set to be different from the default value. The link quality indicator ( lqi ) is also shown. The rss and lqi settings map to each other. If you set one, the value of the other gets set automatically. This list of addresses is called the RssIn List . Setting either the rsi or the lqi adds the corresponding extended address to the RssIn list.
  • Default rss : Shows the default values, if applicable, for the rss and lqi settings.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

macfilter rss remove

Removes the specified Extended Address from the RssIn list.

Once removed from the RssIn list, this MAC address will instead use the default rss and lqi settings, assuming defaults have been set. (If no defaults have been set, the over-air signal is used.)

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

No action is performed if there is no existing entry in the RssIn list matching the specified Extended Address.

پارامترها

macfilter rss remove extaddr

If you wish to remove the default received signal strength and link quality indicator settings, use the * as the extaddr . This unsets the defaults but does not remove entries from the RssIn list.

نمونه ها 

macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done

CLI and API References

meshdiag childip6

Send a query to a parent to retrieve the IPv6 addresses of all its MTD children.

پارامترها 

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 and API References

meshdiag childtable

Start a query for child table of a router with a given RLOC16. Output lists all child entries. Information per child:

  • RLOC16
  • Extended MAC address
  • Thread Version
  • Timeout (in seconds)
  • Age (seconds since last heard)
  • Supervision interval (in seconds)
  • Number of queued messages (in case child is sleepy)
  • Device Mode
  • RSS (average and last)
  • Error rates: frame tx (at MAC layer), IPv6 message tx (above MAC)
  • Connection time (seconds since link establishment {dd}d.{hh}:{mm}:{ss} format)
  • CSL info:
    • If synchronized
    • Period (in unit of 10-symbols-time)
    • Timeout (in seconds)

پارامترها

بدون پارامتر

نمونه ها 

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 and API References

  • No associated API

meshdiag routerneighbortable

Start a query for router neighbor table of a router with a given RLOC16. Output lists all router neighbor entries. Information per entry:

  • RLOC16
  • Extended MAC address
  • Thread Version
  • RSS (average and last) and link margin
  • Error rates, frame tx (at MAC layer), IPv6 message tx (above MAC)
  • Connection time (seconds since link establishment {dd}d.{hh}:{mm}:{ss} format)

پارامترها 

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 and API References

meshdiag topology

Discover network topology (list of routers and their connections). Parameters are optional and indicate additional items to discover. Can be added in any order.

  • ip6-addrs to discover the list of IPv6 addresses of every router.
  • children to discover the child table of every router.

Information per router:

  • شناسه روتر
  • RLOC16
  • Extended MAC address
  • Thread Version (if known)
  • Whether the router is this device is itself ( me )
  • Whether the router is the parent of this device when device is a child ( parent )
  • Whether the router is leader
  • Whether the router acts as a border router providing external connectivity ( br )
  • List of routers to which this router has a link:
    • 3-links : Router IDs to which this router has a incoming link with link quality 3
    • 2-links : Router IDs to which this router has a incoming link with link quality 2
    • 1-links : Router IDs to which this router has a incoming link with link quality 1
    • If a list if empty, it is omitted in the out.
  • If ip6-addrs , list of IPv6 addresses of the router
  • If children , list of all children of the router. Information per child:
    • RLOC16
    • Incoming Link Quality from perspective of parent to child (zero indicates unknown)
    • Child Device mode ( r rx-on-when-idle, d Full Thread Device, n Full Network Data, - no flags set)
    • Whether the child is this device itself ( me )
    • Whether the child acts as a border router providing external connectivity ( 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 and API References

mleadvimax

Gets the current Interval Max value used by Advertisement trickle timer.

This API requires OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE , and is intended for testing only.

پارامترها

بدون پارامتر

نمونه ها 

mleadvimax
12000
Done

CLI and API References

mliid

Sets the Mesh Local IID (for test purpose).

Requires OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE .

It must be used before Thread stack is enabled.

Only for testing/reference device.

پارامترها 

mliid iid

نمونه ها 

mliid 1122334455667788
Done

CLI and API References

mlr reg

Registers Multicast Listeners to Primary Backbone Router.

OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE and OPENTHREAD_CONFIG_COMMISSIONER_ENABLE must be enabled.

Omit timeout to use the default MLR timeout on the Primary Backbone Router.

Use timeout = 0 to deregister Multicast Listeners.

پارامترها 

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 and API References

mode (get,set)

Set the MLE Link Mode configuration.

پارامترها

mode [rdn]
  • - : no flags set (rx-off-when-idle, minimal Thread device, stable network data)
  • r : rx-on-when-idle
  • d : Full Thread Device
  • n : Full Network Data

نمونه ها 

mode rdn
Done
mode -
Done

CLI and API References

multiradio

Get the list of supported radio links by the device.

This command is always available, even when only a single radio is supported by the device.

پارامترها

بدون پارامتر

نمونه ها 

multiradio
[15.4, TREL]
Done

CLI and API References

  • No associated API

multiradio neighbor list

Gets the multi radio link information associated with a neighbor with a given Extended Address.

OPENTHREAD_CONFIG_MULTI_RADIO must be enabled.

پارامترها

بدون پارامتر

نمونه ها 

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

CLI and API References

multiradio neighbor

Gets the multi radio link information associated with a neighbor with a given Extended Address.

OPENTHREAD_CONFIG_MULTI_RADIO must be enabled.

پارامترها 

multiradio neighbor ext-address

نمونه ها 

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

CLI and API References

nat64 (enable,disable)

Enable or disable NAT64 functions.

When OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE is enabled, setting disabled to true resets the mapping table in the translator.

Available when OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE or OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE is enabled.

پارامترها 

nat64 enable|disable

نمونه ها 

nat64 enable
Done
nat64 disable
Done

CLI and API References

nat64 cidr

پارامترها

بدون پارامتر

نمونه ها 

nat64 cidr 192.168.255.0/24
Done

CLI and API References

nat64 cidr

Gets the IPv4 CIDR configured in the NAT64 translator.

Available when OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE is enabled.

پارامترها

بدون پارامتر

نمونه ها 

nat64 cidr
192.168.255.0/24
Done

CLI and API References

nat64 counters

Gets the NAT64 translator packet and error counters.

Available when OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE is enabled.

پارامترها

No parameters.

نمونه ها 

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 and API References

nat64 mappings

Gets the next AddressMapping info (using an iterator).

Available when OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE is enabled.

پارامترها

بدون پارامتر

نمونه ها 

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 and API References

nat64 state

Gets the state of NAT64 functions.

PrefixManager state is available when OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE is enabled. Translator state is available when OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE is enabled.

When OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE is enabled, PrefixManager returns one of the following states:

  • Disabled : NAT64 prefix manager is disabled.
  • NotRunning : NAT64 prefix manager is enabled, but is not running. This could mean that the routing manager is disabled.
  • Idle : NAT64 prefix manager is enabled and is running, but is not publishing a NAT64 prefix. This can happen when there is another border router publishing a NAT64 prefix with a higher priority.
  • Active : NAT64 prefix manager is enabled, running, and publishing a NAT64 prefix.

When OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE is enabled, Translator returns one of the following states:

  • Disabled : NAT64 translator is disabled.
  • NotRunning : NAT64 translator is enabled, but is not translating packets. This could mean that the Translator is not configured with a NAT64 prefix or a CIDR for NAT64.
  • Active : NAT64 translator is enabled and is translating packets.

پارامترها

No parameters.

نمونه ها 

nat64 state
PrefixManager: Active
Translator: Active
Done

CLI and API References

neighbor conntime list

Prints the connection time and age of neighbors. This command is similar to neighbor conntime , but it displays the information in a list format. The age and connection time are both displayed in seconds.

پارامترها

No parameters.

نمونه ها 

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 and API References

neighbor conntime

Prints the connection time and age of neighbors. Information per neighbor:

  • RLOC16
  • Extended MAC
  • Last Heard (Age): Number of seconds since last heard from neighbor.
  • Connection Time: Number of seconds since link establishment with neighbor. Duration intervals are formatted as {hh}:{mm}:{ss} for hours, minutes, and seconds if the duration is less than one day. If the duration is longer than one day, the format is {dd}d.{hh}:{mm}:{ss} .

پارامترها

No parameters.

نمونه ها 

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 and API References

neighbor linkquality

Prints link quality information about all neighbors.

پارامترها

No parameters.

نمونه ها 

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 and API References

  • No associated API

neighbor list

Lists the RLOC16 of each neighbor.

پارامترها

بدون پارامتر

نمونه ها 

neighbor list
0xcc01 0xc800 0xf000
Done

CLI and API References

  • No associated API

neighbor table

Prints information in table format about all neighbors.

For Role , the only possible values for this table are C (Child) or R (Router).

The following columns provide information about the device mode of neighbors. Each column has a value of 0 (off) or 1 (on).

  • R : RX on when idle
  • D : Full Thread device
  • N : Full network data

پارامترها

No parameters.

نمونه ها 

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 and API References

netdata full

Print "yes" or "no" indicating whether or not the "net data full" callback has been invoked since start of Thread operation or since the last time netdata full reset was used to reset the flag. This command requires OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL . The "net data full" callback is invoked whenever:

  • The device is acting as a leader and receives a Network Data registration from a Border Router (BR) that it cannot add to Network Data (running out of space).
  • The device is acting as a BR and new entries cannot be added to its local Network Data.
  • The device is acting as a BR and tries to register its local Network Data entries with the leader, but determines that its local entries will not fit.

پارامترها

No parameters.

نمونه ها 

netdata full
no
Done

CLI and API References

netdata full reset

Reset the flag tracking whether "net data full" callback was invoked.

پارامترها

No parameters.

نمونه ها 

netdata full reset
Done

CLI and API References

  • No associated API

netdata length

Get the current length (number of bytes) of Partition's Thread Network Data.

پارامترها

No parameters.

نمونه ها 

netdata length
23
Done

CLI and API References

netdata maxlength

Get the maximum observed length of the Thread Network Data since OT stack initialization or since the last call to otNetDataResetMaxLength() .

پارامترها

No parameters.

نمونه ها 

netdata maxlength
40
Done

CLI and API References

netdata maxlength reset

Reset the tracked maximum length of the Thread Network Data.

پارامترها

No parameters.

نمونه ها 

netdata maxlength reset
Done

CLI and API References

netdata publish dnssrp anycast

Publishes a DNS/SRP Service Anycast Address with a sequence number. Any current DNS/SRP Service entry being published from a previous publish dnssrp{anycast|unicast} command is removed and replaced with the new arguments.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE must be enabled.

پارامترها 

netdata publish dnssrp anycast seq-num

نمونه ها 

netdata publish dnssrp anycast 1
Done

CLI and API References

netdata publish dnssrp unicast (addr,port)

Publishes a DNS/SRP Service Unicast Address with an address and port number. The address and port information is included in Service TLV data. Any current DNS/SRP Service entry being published from a previous publish dnssrp{anycast|unicast} command is removed and replaced with the new arguments.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE must be enabled.

پارامترها 

netdata publish dnssrp unicast address port

نمونه ها 

netdata publish dnssrp unicast fd00::1234 51525
Done

CLI and API References

netdata publish dnssrp unicast (mle)

Publishes the device's Mesh-Local EID with a port number. MLE and port information is included in the Server TLV data. To use a different Unicast address, use the netdata publish dnssrp unicast (addr,port) command.

Any current DNS/SRP Service entry being published from a previous publish dnssrp{anycast|unicast} command is removed and replaced with the new arguments.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE must be enabled.

پارامترها 

netdata publish dnssrp unicast port

نمونه ها 

netdata publish dnssrp unicast 50152
Done

CLI and API References

netdata publish prefix

Publish an on-mesh prefix entry. For more information, refer to Display and Manage Network Data with OT CLI .

پارامترها

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

OT CLI uses mapped arguments to configure otBorderRouterConfig values. For more information, refer to the OpenThread CLI Overview .

نمونه ها 

netdata publish prefix fd00:1234:5678::/64 paos med
Done

CLI and API References

netdata publish replace

Replaces a previously published external route entry. For more information, refer to Display and Manage Network Data with OT CLI .

پارامترها

netdata publish replace oldprefix prefix [sn] [high|med|low]

OT CLI uses mapped arguments to configure otExternalRouteConfig values. For more information, refer to the OpenThread CLI Overview .

نمونه ها 

netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done

CLI and API References

netdata publish route

Publish an external route entry. For more information, refer to Display and Manage Network Data with OT CLI .

پارامترها

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

OT CLI uses mapped arguments to configure otExternalRouteConfig values. For more information, refer to the OpenThread CLI Overview .

نمونه ها 

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

CLI and API References

netdata register

Register configured prefixes, routes, and services with the Leader.

OT CLI checks for OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE . If OTBR is enabled, it registers local Network Data with the Leader. Otherwise, it calls the CLI function otServerRegister . For more information, refer to Display and Manage Network Data with OT CLI .

پارامترها

بدون پارامتر

نمونه ها 

netdata register
Done

CLI and API References

netdata steeringdata check (discerner)

Check if the steering data includes a Joiner with a given discerner value.

پارامترها

netdata steeringdata check discerner
  • discerner : The Joiner discerner in format {number}/{length} .

نمونه ها 

netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound

CLI and API References

netdata steeringdata check (eui64)

Check if the steering data includes a Joiner.

پارامترها

netdata steeringdata check eui64
  • eui64 : The IEEE EUI-64 of the Joiner.

نمونه ها 

netdata steeringdata check d45e64fa83f81cf7
Done

CLI and API References

netdata unpublish (prefix)

Unpublishes a previously published On-Mesh or External Route Prefix.

OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE must be enabled.

For more information, refer to Display and Manage Network Data with OT CLI .

پارامترها 

netdata unpublish prefix

نمونه ها 

netdata unpublish fd00:1234:5678::/64
Done

CLI and API References

netdata unpublish dnssrp

Unpublishes any previously added DNS/SRP (Anycast or Unicast) Service entry from the Thread Network Data.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE must be enabled.

پارامترها

No parameters.

نمونه ها 

netdata unpublish dnssrp
Done

CLI and API References

netstat

Gets the head of linked list of UDP Sockets.

پارامترها

No parameters.

نمونه ها 

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 and API References

networkdiagnostic get

Sends a network diagnostic request to retrieve specified Type Length Values (TLVs) for the specified addresses(es).

پارامترها

networkdiagnostic get addr type(s)

For addr , a unicast address triggers a Diagnostic Get . A multicast address triggers a Diagnostic Query . TLV values you can specify (separated by a space if you specify more than one TLV):

  • 0 : MAC Extended Address TLV
  • 1 : Address16 TLV
  • 2 : Mode TLV
  • 3 : Timeout TLV (the maximum polling time period for SEDs)
  • 4 : Connectivity TLV
  • 5 : Route64 TLV
  • 6 : Leader Data TLV
  • 7 : Network Data TLV
  • 8 : IPv6 Address List TLV
  • 9 : MAC Counters TLV
  • 14 : Battery Level TLV
  • 15 : Supply Voltage TLV
  • 16 : Child Table TLV
  • 17 : Channel Pages TLV
  • 19 : Max Child Timeout TLV
  • 23 : EUI64 TLV
  • 24 : Version TLV (version number for the protocols and features)
  • 25 : Vendor Name TLV
  • 26 : Vendor Model TLV
  • 27 : Vendor SW Version TLV
  • 28 : Thread Stack Version TLV (version identifier as UTF-8 string for Thread stack codebase/commit/version)
  • 29 : Child TLV
  • 34 : MLE Counters TLV
  • 35 : Vendor App URL TLV

نمونه ها 

networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
    PartitionId: 0x640b0f67
    Weighting: 64
    DataVersion: 116
    StableDataVersion: 197
    LeaderRouterId: 0x03
EUI64: 18b4300000000004
Done
networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done

CLI and API References

networkdiagnostic reset

Sends a network diagnostic request to reset the specified Type Length Values (TLVs) on the specified address(es). This command only supports the following TLV values: 9 (MAC Counters TLV) or 34 (MLE Counters TLV)

پارامترها 

networkdiagnostic reset addr type(s)

نمونه ها 

networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done

CLI and API References

networkidtimeout (get,set)

Gets or sets the NETWORK_ID_TIMEOUT parameter.

پارامترها

networkidtimeout [timeout]

Use the optional timeout argument to set the value of the NETWORK_ID_TIMEOUT parameter.

نمونه ها 

networkidtimeout 120
Done
networkidtimeout
120
Done

CLI and API References

networkkey (key)

Set the Thread Network Key.

Succeeds only when Thread protocols are disabled. A successful call to this function invalidates the Active and Pending Operational Datasets in non-volatile memory.

پارامترها 

networkkey key

نمونه ها 

networkkey 00112233445566778899aabbccddeeff
Done

CLI and API References

networkkey

Get the Thread Network Key.

پارامترها

No parameters.

نمونه ها 

networkkey
00112233445566778899aabbccddeeff
Done

CLI and API References

networkname (name)

Set the Thread Network Name.

Succeeds only when Thread protocols are disabled. A successful call to this function invalidates the Active and Pending Operational Datasets in non-volatile memory.

پارامترها 

networkname name

نمونه ها 

networkname OpenThread
Done

CLI and API References

networkname

Get the Thread Network Name.

پارامترها

No parameters.

نمونه ها 

networkname
OpenThread
Done

CLI and API References

networktime (set)

Sets the time sync parameters.

  • timesyncperiod : The time synchronization period, in seconds.
  • xtalthreshold : The XTAL accuracy threshold for a device to become Router-Capable device, in PPM.

پارامترها 

networktime timesyncperiod xtalthreshold

نمونه ها 

networktime 100 300
Done

CLI and API References

networktime

Gets the Thread network time and the time sync parameters.

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

nexthop (get)

Gets the next hop and path cost towards a given RLOC16 destination.

Can be used with either aNextHopRloc16 or aPathCost being NULL indicating caller does not want to get the value.

پارامترها 

nexthop rloc16

نمونه ها 

nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done

CLI and API References

nexthop

Output table of allocated Router IDs and current next hop and path cost for each router.

پارامترها

No parameters.

نمونه ها 

nexthop
| ID   |NxtHop| Cost |
+------+------+------+
|    9 |    9 |    1 |
|   25 |   25 |    0 |
|   30 |   30 |    1 |
|   46 |    - |    - |
|   50 |   30 |    3 |
|   60 |   30 |    2 |
Done

CLI and API References

panid (panid)

Set the IEEE 802.15.4 PAN ID.

Succeeds only when Thread protocols are disabled. A successful call to this function also invalidates the Active and Pending Operational Datasets in non-volatile memory.

پارامترها 

panid panid

نمونه ها 

panid 0xdead
Done

CLI and API References

panid

Get the IEEE 802.15.4 PAN ID.

پارامترها

No parameters.

نمونه ها 

panid
0xdead
Done

CLI and API References

پدر و مادر

Get the diagnostic information for a Thread Router as parent.

When operating as a Thread Router when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is enabled, this command will return the cached information from when the device was previously attached as a Thread Child. Returning cached information is necessary to support the Thread Test Harness - Test Scenario 8.2.x requests the former parent (ie Joiner Router's) MAC address even if the device has already promoted to a router.

پارامترها

No parameters.

نمونه ها 

parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done

CLI and API References

Starts the process for child to search for a better parent while staying attached to its current parent.

Must be used when device is attached as a child.

پارامترها

No parameters.

نمونه ها 

parent search
Done

CLI and API References

parentpriority (get,set)

Gets or sets the assigned parent priority value: 1, 0, -1 or -2. -2 means not assigned.

پارامترها 

parentpriority [parentpriority]

نمونه ها 

parentpriority
1
Done
parentpriority 1
Done

CLI and API References

partitionid

Get the Thread Network Partition ID.

پارامترها

No parameters.

نمونه ها 

partitionid
4294967295
Done

CLI and API References

partitionid preferred (get,set)

OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is required.

پارامترها 

partitionid preferred partitionid

نمونه ها 

partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done

CLI and API References

پلت فرم

Print the current platform

پارامترها

No parameters.

نمونه ها 

platform
NRF52840
Done

CLI and API References

  • No associated API

pollperiod (get,set)

Get or set the customized data poll period of sleepy end device (milliseconds). Only for certification test.

پارامترها

No parameters.

نمونه ها 

pollperiod
0
Done
pollperiod 10
Done

CLI and API References

preferrouterid

Specifies the preferred router ID that the leader should provide when solicited.

پارامترها 

preferrouterid routerid

نمونه ها 

preferrouterid 16
Done

CLI and API References

prefix add

Adds a valid prefix to the Network Data.

پارامترها

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

OT CLI uses mapped arguments to configure otBorderRouterConfig values. For more information, refer to the OpenThread CLI Overview .

نمونه ها 

prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done

CLI and API References

prefix meshlocal

Get the mesh local prefix.

پارامترها

No parameters.

نمونه ها 

prefix meshlocal
fdde:ad00:beef:0::/64
Done

CLI and API References

  • No associated API

پیشوند

Get the prefix list in the local Network Data.

For more information about otBorderRouterConfig flags, refer to OpenThread CLI Overview .

پارامترها

No parameters.

نمونه ها 

prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done

CLI and API References

prefix remove

Remove a border router configuration from the local network data.

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

promiscuous (enable,disable)

Enables or disables the link layer promiscuous mode.

پارامترها 

promiscuous enable|disable

نمونه ها 

promiscuous enable
Done
promiscuous disable
Done

CLI and API References

بی بند و باری

Indicates whether or not promiscuous mode is enabled at the link layer.

پارامترها

No parameters.

نمونه ها 

promiscuous
Disabled
Done

CLI and API References

pskc (set)

Sets the pskc in hexadecimal format.

پارامترها 

pskc key

نمونه ها 

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

CLI and API References

  • No associated API

pskc -p

Generates the pskc from the passphrase (UTF-8 encoded), together with the current network name and extended PAN ID.

پارامترها 

pskc -p passphrase

نمونه ها 

pskc -p 123456
Done

CLI and API References

  • No associated API

pskc

Get the Thread PSKc.

پارامترها

No parameters.

نمونه ها 

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

CLI and API References

pskcref (set)

Set the Key Reference to the Thread PSKc.

Requires the build-time feature OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE to be enabled.

Will only succeed when Thread protocols are disabled. Upon success, this will also invalidate the Active and Pending Operational Datasets in non-volatile memory.

پارامترها 

pskc keyref

نمونه ها 

pskc 0x20017
Done

CLI and API References

pskcref

Get Key Reference to Thread PSKc stored.

Requires the build-time feature OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE to be enabled.

پارامترها

No parameters.

نمونه ها 

pskcref
0x80000000
Done

CLI and API References

radio (enable,disable)

Enables or disables the radio.

پارامترها 

radio enable|disable

نمونه ها 

radio enable
Done
radio disable
Done

CLI and API References

radio stats clear

Resets the radio statistics.

All times are reset to 0.

پارامترها

No parameters.

نمونه ها 

radio stats clear
Done

CLI and API References

radio stats

Gets the radio statistics.

The radio statistics include the time when the radio is in TX/RX/Sleep state. These times are in units of microseconds. All times are calculated from the last reset of radio statistics.

پارامترها

No parameters.

نمونه ها 

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 and API References

rcp version

Get the radio version string.

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

region (set)

Sets the region code.

The radio region format is the 2-bytes ascii representation of the ISO 3166 alpha-2 code.

Changing this can affect the transmit power limit.

پارامترها

No parameters.

نمونه ها 

region US
Done

CLI and API References

منطقه

Get the region code.

The radio region format is the 2-bytes ascii representation of the ISO 3166 alpha-2 code.

پارامترها

No parameters.

نمونه ها 

region
US
Done

CLI and API References

releaserouterid (routerid)

Release a Router ID that has been allocated by the device in the Leader role.

پارامترها 

releaserouterid [routerid]

نمونه ها 

releaserouterid 16
Done

CLI and API References

rloc16

Get the RLOC16.

پارامترها

No parameters.

نمونه ها 

rloc16
0xdead
Done

CLI and API References

route add

For parameters, use:

  • s: Stable flag
  • n: NAT64 flag
  • prf: Default Router Preference, [high, med, low].

Add a valid external route to the Network Data.

پارامترها 

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

نمونه ها 

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

CLI and API References

route remove

Remove an external route configuration from the local network data.

پارامترها 

route remove [prefix]

نمونه ها 

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

CLI and API References

مسیر

Get the external route list in the local Network Data.

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

router (id)

The function retains diagnostic information for a given Thread Router.

Print diagnostic information for a Thread Router. The id may be a Router ID or an 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 and API References

router list

List allocated Router IDs.

پارامترها

No parameters.

نمونه ها 

router list
8 24 50
Done

CLI and API References

router table

Prints a list of routers in a table format.

پارامترها

No parameters.

نمونه ها 

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 and API References

routerdowngradethreshold (get,set)

Gets or sets the ROUTER_DOWNGRADE_THRESHOLD value.

پارامترها 

routerdowngradethreshold [threshold]

نمونه ها 

 routerdowngradethreshold
23
Done
 routerdowngradethreshold 23
Done

CLI and API References

routereligible (enable,disable)

Enables or disables the router role.

پارامترها 

routereligible [enable|disable]

نمونه ها 

routereligible enable
Done
routereligible disable
Done

CLI and API References

routereligible

Indicates whether the router role is enabled or disabled.

پارامترها

No parameters.

نمونه ها 

routereligible
Enabled
Done

CLI and API References

routerselectionjitter

Gets or sets the ROUTER_SELECTION_JITTER value.

پارامترها 

routerselectionjitter [jitter]

نمونه ها 

routerselectionjitter
120
Done
routerselectionjitter 120
Done

CLI and API References

routerupgradethreshold (get,set)

Gets or sets the ROUTER_UPGRADE_THRESHOLD value.

پارامترها 

routerupgradethreshold [threshold]

نمونه ها 

routerupgradethreshold
16
Done
routerupgradethreshold 16
Done

CLI and API References

scan energy

Performs an IEEE 802.15.4 energy scan, and displays the time in milliseconds to use for scanning each channel. All channels are shown unless you specify a certain channel by using the channel option.

پارامترها 

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 and API References

اسکن کنید

Performs an active IEEE 802.15.4 scan. The scan covers all channels if no channel is specified; otherwise the span covers only the channel specified.

پارامترها 

scan [channel]

نمونه ها 

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

CLI and API References

service add

Adds service to the network data.

  • enterpriseNumber: IANA enterprise number
  • serviceData: Hex-encoded binary service data
  • serverData: Hex-encoded binary server data (empty if not provided)

پارامترها 

service add enterpriseNumber serviceData [serverData]

نمونه ها 

service add 44970 112233 aabbcc
Done
netdata register
Done

CLI and API References

service remove

Removes service from the network data.

  • enterpriseNumber: IANA enterprise number
  • serviceData: Hex-encoded binary service data

پارامترها 

service remove enterpriseNumber serviceData

نمونه ها 

service remove 44970 112233
Done
netdata register
Done

CLI and API References

singleton

Indicates whether a node is the only router on the network. Returns either true or false .

پارامترها

No parameters.

نمونه ها 

singleton
true
Done

CLI and API References

sntp query

Sends an SNTP query to obtain the current unix epoch time (from January 1, 1970).

  • SNTP server default IP address: 2001:4860:4806:8:: (Google IPv6 NTP Server)
  • SNTP server default port: 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 and API References

srp client autostart (get)

Indicates the current state of auto-start mode (enabled or disabled). For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

srp client autostart
Disabled
Done

CLI and API References

srp client autostart disable

Disables the auto-start mode.

Disabling auto-start mode does not stop a running client. However, the SRP client stops monitoring Thread network data.

پارامترها

No parameters.

نمونه ها 

srp client autostart disable
Done

CLI and API References

srp client autostart enable

Enables auto-start mode.

When auto-start is enabled, the SRP client monitors Thread network data to discover SRP servers, to select the preferred server, and to automatically start and stop the client when an SRP server is detected.

Three categories of network data entries indicate the presence of an SRP sever, and are preferred in the following order:

  1. Unicast entries in which the server address is included in the service data. If there are multiple options, the option with the lowest numerical IPv6 address is preferred.
  2. Anycast entries that each have a sequence number. The largest sequence number as specified by Serial Number Arithmetic Logic in RFC-1982 is preferred.
  3. Unicast entries in which the server address information is included with the server data. If there are multiple options, the option with the lowest numerical IPv6 address is preferred.

پارامترها

No parameters.

نمونه ها 

srp client autostart enable
Done

CLI and API References

srp client callback (get,enable,disable)

Gets or enables/disables printing callback events from the SRP client. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها 

srp client callback [enable|disable]

نمونه ها 

srp client callback enable
Done
srp client callback
Enabled
Done

CLI and API References

srp client host address (get)

Indicates whether auto address mode is enabled. If auto address mode is not enabled, then the list of SRP client host addresses is returned. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

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 and API References

srp client host address (set)

Enable auto host address mode or explicitly set the list of host addresses. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

srp client host address [auto|address...]
  • Use the auto parameter to enable auto host address mode. When enabled, the client automatically uses all preferred Thread netif unicast addresses except for link-local and mesh-local addresses. If there is no valid address, the mesh local EID address gets added. The SRP client automatically re-registers if addresses on the Thread netif are added or removed or marked as non-preferred.
  • Explicitly specify the list of host addresses, separating each address by a space. You can set this list while the client is running. This will also disable auto host address mode.

نمونه ها 

srp client host address auto
Done
srp client host address fd00::cafe
Done

CLI and API References

srp client host clear

Clears all host information and all services.

پارامترها

No parameters.

نمونه ها 

srp client host clear
Done

CLI and API References

srp client host name (get,set)

Gets or sets the host name of the SRP client. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

srp client host name [name]

To set the client host name when the host has either been removed or not yet registered with the server, use the name parameter.

نمونه ها 

srp client host name dev4312
Done
srp client host name
dev4312
Done

CLI and API References

srp client host remove

Removes SRP client host information and all services from the SRP server. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

srp client host remove [removekeylease] [sendunregtoserver]
  • The parameter removekeylease is an optional boolean value that indicates whether the host key lease should also be removed (default is false ).
  • The parameter sendunregtoserver is an optional boolean value that indicates whether the client host should send an "update" message to the server even when the client host information has not yet been registered with the server (default is false ). This parameter can be specified only if the removekeylease parameter is specified first in the command.

نمونه ها 

srp client host remove 1
Done

CLI and API References

srp client host

Gets the host info.

پارامترها

No parameters.

نمونه ها 

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 and API References

srp client host state

Returns the state of the SRP client host. Possible states:

  • ToAdd : Item to be added/registered.
  • Adding : Item is being added/registered.
  • ToRefresh : Item to be refreshed for lease renewal.
  • Refreshing : Item is beig refreshed.
  • ToRemove : Item to be removed.
  • Removing : Item is being removed.
  • Registered : Item is registered with server.
  • Removed : Item has been removed.

پارامترها

No parameters.

نمونه ها 

srp client host state
Registered
Done

CLI and API References

  • No associated API

srp client keyleaseinterval (get,set)

Gets or sets the key lease interval in seconds.

پارامترها 

srp client keyleaseinterval [interval]

نمونه ها 

srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done

CLI and API References

srp client leaseinterval (get,set)

Gets or sets the lease interval in seconds.

پارامترها 

srp client leaseinterval [interval]

نمونه ها 

srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done

CLI and API References

srp client server address

Returns the server's IPv6 address.

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

  • No associated API

srp client server port

Returns the server's port number.

پارامترها

No parameters.

نمونه ها 

srp client server port
4724
Done

CLI and API References

  • No associated API

srp client server

Gets the socket address (IPv6 address and port number) of the SRP server that is being used by the SRP client. If the client is not running, the address is unspecified (all zeros) with a port number of 0. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

srp client service add

Adds a service with a given instance name, service name, and port number. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

srp client service add instancename servicename port [priority] [weight] [txt]

The servicename parameter can optionally include a list of service subtype labels that are separated by commas. The examples here use generic naming. The priority and weight (both are uint16_t values) parameters are optional, and if not provided zero is used. The optional txt parameter sets the TXT data associated with the service. The txt value must be in hex-string format and is treated as an already encoded TXT data byte sequence.

نمونه ها 

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

CLI and API References

srp client service key (get,set)

Gets or sets the service key record inclusion mode in the SRP client. This command is intended for testing only, and requires that OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE be enabled. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

srp client service key enable
Done
srp client service key
Enabled
Done

CLI and API References

srp client service name clear

Clears a service, immediately removing it from the client service list, with no interaction with the SRP server.

پارامترها 

srp client service clear instancename servicename

نمونه ها 

srp client service clear ins2 _test2._udp
Done

CLI and API References

srp client service remove

Requests a service to be unregistered with the SRP server.

پارامترها 

srp client service remove instancename servicename

نمونه ها 

srp client service remove ins2 _test2._udp
Done

CLI and API References

srp client service

Gets the list of services being managed by client.

پارامترها

No parameters.

نمونه ها 

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 and API References

srp client start

Starts the SRP client operation. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها 

srp client start serveraddr serverport

نمونه ها 

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

CLI and API References

srp client state

Indicates whether the SRP client is running or not.

پارامترها

No parameters.

نمونه ها 

srp client state
Enabled
Done

CLI and API References

srp client stop

Stops the SRP client operation.

Stops any further interactions with the SRP server. Note that it does not remove or clear host info and/or list of services. It marks all services to be added/removed again once the client is (re)started.

پارامترها

No parameters.

نمونه ها 

srp client stop
Done

CLI and API References

srp client ttl (get,set)

Gets or sets the ttl (time to live) value in seconds.

پارامترها 

srp client ttl [value]

نمونه ها 

srp client ttl 3600
Done
srp client ttl
3600
Done

CLI and API References

srp server (enable,disable)

Enables or disables the SRP server. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها 

srp server [enable|disable]

نمونه ها 

srp server disable
Done

CLI and API References

srp server addrmode (get,set)

Gets or sets the address mode used by the SRP server.

The address mode tells the SRP server how to determine its address and port number, which then get published in the Thread network data.

پارامترها 

srp server addrmode [anycast|unicast]

نمونه ها 

srp server addrmode anycast
Done
srp server addrmode
anycast
Done

CLI and API References

srp server auto (enable,disable)

Enables or disables the auto-enable mode on the SRP server.

When this mode is enabled, the Border Routing Manager controls if and when to enable or disable the SRP server.

This command requires that OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE be enabled. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها 

srp server auto [enable|disable]

نمونه ها 

srp server auto enable
Done
srp server auto
Enabled
Done

CLI and API References

srp server domain (get,set)

Gets or sets the domain name of the SRP server.

پارامترها 

srp server domain [domain-name]

نمونه ها 

srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done

CLI and API References

srp server host

Returns information about all registered hosts. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

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 and API References

srp server lease (get,set)

Gets or sets the SRP server lease values in number of seconds.

پارامترها 

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 and API References

srp server seqnum (get,set)

Gets or sets the sequence number used with the anycast address mode. The sequence number is included in the "DNS/SRP Service Anycast Address" entry that is published in the Network Data.

پارامترها 

srp server seqnum [seqnum]

نمونه ها 

srp server seqnum 20
Done
srp server seqnum
20
Done

CLI and API References

srp server service

Returns information about registered services.

The TXT record is displayed as an array of entries. If an entry contains a key, the key is printed in ASCII format. The value portion is printed in hexadecimal bytes. For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

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 and API References

srp server state

Returns one of the following possible states of the SRP server:

  • disabled : The SRP server is not enabled.
  • stopped : The SRP server is enabled but not active due to existing SRP servers that are already active in the Thread network. The SRP server may become active when the existing SRP servers are no longer active within the Thread network.
  • running : The SRP server is active and can handle service registrations.

For more information, refer to Set Up Service Registration Protocol (SRP) Server-Client Connectivity With OT CLI .

پارامترها

No parameters.

نمونه ها 

srp server state
running
Done

CLI and API References

دولت

Returns the current role of the Thread device, or changes the role as specified with one of the options. Possible values returned when inquiring about the device role:

  • child : The device is currently operating as a Thread child.
  • router : The device is currently operating as a Thread router.
  • leader : The device is currently operating as a Thread leader.
  • detached : The device is not currently participating in a Thread network/partition.
  • disabled : The Thread stack is currently disabled.

Using one of the options allows you to change the current role of a device, with the exclusion of changing to or from a disabled state.

پارامترها 

state [child|router|leader|detached]

نمونه ها 

state
child
Done
state leader
Done

CLI and API References

tcat advid

Sets/clears advertised ID type and value.

پارامترها

tcat advid [id_type] [value]
  • The id_type has five possible values:
    • clear - removes all previously set advertised IDs.
    • oui24 - sets OUI24 ID type.
    • oui36 - sets OUI36 ID type.
    • discriminator - sets discriminator ID type.
    • ianapen - sets IANA PEN ID type.
  • The value hexstring value of the ID.

نمونه ها 

tcat advid ianapen f378aabb
Done

CLI and API References

  • No associated API

tcat devid

Sets/clears vendor specific device ID.

پارامترها

tcat devid [value|clear]
  • The value hexstring value of the ID. clear is a special value removing previously set ID.

نمونه ها 

tcat devid ianapen f378aabb
Done

CLI and API References

  • No associated API

tcat start

Starts TCAT operation.

پارامترها

No parameters.

نمونه ها 

tcat start
Done

CLI and API References

tcat stop

Stops TCAT operation.

پارامترها

No parameters.

نمونه ها 

tcat stop
Done

CLI and API References

tcp abort

Unceremoniously ends the TCP connection associated with the example TCP endpoint, transitioning the TCP endpoint to the closed state.

پارامترها

No parameters.

نمونه ها 

tcp abort
TCP: Connection reset
Done

CLI and API References

tcp benchmark result

Shows the latest result of the TCP benchmark test. Possible status values:

  • در حال انجام است
  • تکمیل شد
  • تست نشده

This command is primarily intended for creating scripts that automate the TCP benchmark test.

پارامترها

No parameters.

نمونه ها 

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 and API References

  • No associated API

tcp benchmark run

Transfers the specified number of bytes using the TCP connection currently associated with the example TCP endpoint provided by the tcp CLI.

پارامترها

tcp benchmark run [size]

Use the size parameter to specify the number of bytes to send for the benchmark. If you do not use the size parameter, the default value ( OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE ) is used.

نمونه ها 

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

CLI and API References

  • No associated API

tcp bind

Associates an IPv6 address and a port to the example TCP endpoint provided by the tcp CLI. Associating the TCP endpoint to an IPv6 address and port is referred to as "naming the TCP endpoint." This binds the endpoint for communication. For more information, refer to Test TCP Functionality With OT CLI .

پارامترها

tcp bind ip port
  • ip : IPv6 address to bind to. If you wish to have the TCP/IPv6 stack assign the binding IPv6 address, use the unspecified IPv6 address: :: .
  • port : TCP port number to bind to.

نمونه ها 

tcp bind :: 30000
Done

CLI and API References

tcp connect

Establishes a connection with the specified peer.

If the connection establishment is successful, the resulting TCP connection is associated with the example TCP endpoint. For more information, refer to Test TCP Functionality With OT CLI .

پارامترها

tcp connect ip port [fastopen]
  • ip : IP address of the peer The address can be an IPv4 address, which gets synthesized to an IPv6 address using the preferred NAT64 prefix from the network data. The command returns InvalidState when the preferred NAT64 prefix is unavailable.
  • port : TCP port number of the peer.
  • fastopen : This parameter is optional. If set to fast , TCP Fast Open is enabled for this connection. Otherwise, if this parameter is set to slow or not used, TCP Fast Open is disabled.

نمونه ها 

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 and API References

tcp deinit

Deinitializes this TCP endpoint.

This means that OpenThread no longer keeps track of this TCP endpoint and deallocates all resources it has internally allocated for this TCP endpoint. The application can reuse the memory backing the TCP endpoint as it sees fit.

If it corresponds to a live TCP connection, the connection is terminated unceremoniously (as in otTcpAbort() ). All resources the application has provided for this TCP endpoint (linked buffers for the send buffer, memory for the receive buffer, the aEndpoint structure itself, etc.) are immediately returned to the application.

پارامترها

No parameters.

نمونه ها 

tcp deinit
Done

CLI and API References

tcp init

Initializes the example TCP listener and the example TCP endpoint provided by the tcp CLI.

پارامترها

tcp init [mode] [size]
  • The mode has three possible values:
    • tls : Specifies that the TCP connection between two nodes should also use the TLS protocol on top of TCP. When two nodes communicate over TCP, both nodes must either use TLS or neither node should use TLS because a non-TLS endpoint cannot communicate with a TLS endpoint.
    • linked or circular : Either one of these options means that TLS is not to be used, and the specified buffering type should be used for TCP buffering. The behavior of linked and circular is identical. Examine the code for the differences between these two buffering types. Two endpoints of a TCP connection are not required to use the same buffering type.
  • The size parameter sets the size of the receive buffer to associate with the example TCP endpoint. If left unspecified, the maximum size is used. The maximum size is set in OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE .

نمونه ها 

tcp init tls
Done

CLI and API References

tcp listen

Uses the example TCP listener to listen for incoming connections on the specified IPv6 address and port. For more information, refer to Test TCP Functionality With OT CLI .

پارامترها

tcp listen ip port

The following parameters are required:

  • ip : IPv6 address or the unspecified IPv6 address ( :: ) of the example TCP listener provided by the tcp CLI.
  • port : TCP port of the example TCP listener. If no TCP connection is associated with the example TCP endpoint, then any incoming connections matching the specified IPv6 address and port are accepted and are associated with the example TCP endpoint.

نمونه ها 

tcp listen :: 30000
Done

CLI and API References

tcp send

Sends data over the TCP connection associated with the example TCP endpoint that is provided with the tcp CLI. For more information, refer to Test TCP Functionality With OT CLI .

پارامترها

tcp send message

The message parameter contains the message you want to send to the remote TCP endpoint.

نمونه ها 

tcp send hello
Done

CLI and API References

  • No associated API

tcp sendend

Sends the "end of stream" signal over the TCP connection associated with the example TCP endpoint provided by the tcp CLI. This alerts the peer that it will not receive any more data over this TCP connection.

پارامترها

No parameters.

نمونه ها 

tcp sendend
Done

CLI and API References

tcp stoplistening

Instructs the example TCP listener to stop listening for incoming TCP connections.

پارامترها

No parameters.

نمونه ها 

tcp stoplistening
Done

CLI and API References

test tmforiginfilter

Enables or disables the filter to drop TMF UDP messages from untrusted origin.

By default the filter that drops TMF UDP messages from untrusted origin is enabled. When disabled, UDP messages sent to the TMF port that originate from untrusted origin (such as host, CLI or an external IPv6 node) will be allowed.

پارامترها 

test tmforiginfilter [enable|disable]

نمونه ها 

test tmforiginfilter
Enabled
test tmforiginfilter enable
Done
test tmforiginfilter disable
Done

CLI and API References

  • No associated API

thread start

Starts the Thread protocol operation.

پارامترها

No parameters.

نمونه ها 

thread start
Done

CLI and API References

thread stop

Stops the Thread protocol operation.

پارامترها

No parameters.

نمونه ها 

thread stop
Done

CLI and API References

  • No associated API

thread version

Gets the Thread protocol version.

The constants OT_THREAD VERSION * define the numerical version values.

پارامترها

No parameters.

نمونه ها 

 thread version
2
Done

CLI and API References

timeinqueue max

Gets the maximum time-in-queue for messages in the TX queue.

Requires OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE .

The time-in-queue is tracked for direct transmissions only and is measured as the duration from when a message is added to the transmit queue until it is passed to the MAC layer for transmission or dropped.

The collected statistics can be reset by calling otThreadResetTimeInQueueStat() .

پارامترها

No parameters.

نمونه ها 

timeinqueue max
281
Done

CLI and API References

timeinqueue reset

Resets the TX queue time-in-queue statistics.

Requires OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE .

پارامترها

No parameters.

نمونه ها 

timeinqueue reset
Done

CLI and API References

timeinqueue

Gets the time-in-queue histogram for messages in the TX queue.

Requires OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE .

Histogram of the time-in-queue of messages in the transmit queue is collected. The time-in-queue is tracked for direct transmissions only and is measured as the duration from when a message is added to the transmit queue until it is passed to the MAC layer for transmission or dropped.

The histogram is returned as an array of uint32_t values with aNumBins entries. The first entry in the array (at index 0) represents the number of messages with a time-in-queue less than aBinInterval . The second entry represents the number of messages with a time-in-queue greater than or equal to aBinInterval , but less than 2 * aBinInterval . و غیره. The last entry represents the number of messages with time-in-queue greater than or equal to (aNumBins - 1) * aBinInterval .

The collected statistics can be reset by calling otThreadResetTimeInQueueStat() . The histogram information is collected since the OpenThread instance was initialized or since the last time statistics collection was reset by calling the otThreadResetTimeInQueueStat() .

Pointers aNumBins and aBinInterval MUST NOT be NULL.

پارامترها

No parameters.

نمونه ها 

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 and API References

trel (enable,disable)

Enables or disables the TREL radio operation.

پارامترها 

trel enable|disable

نمونه ها 

trel enable
Done
trel disable
Done

CLI and API References

trel counters reset

Resets the TREL counters.

پارامترها

No parameters.

نمونه ها 

trel counters reset
Done

CLI and API References

trel counters

Gets the TREL counters.

پارامترها

No parameters.

نمونه ها 

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

CLI and API References

trel filter (enable,disable)

Enables or disables TREL filter mode.

پارامترها 

trel filter enable|disable

نمونه ها 

trel filter enable
Done
trel filter disable
Done

CLI and API References

trel filter

Indicates whether TREL filter mode is enabled.

When filter mode is enabled, all Rx and Tx traffic sent through the TREL interface gets silently dropped.

پارامترها

No parameters.

نمونه ها 

trel filter
Disabled
Done

CLI and API References

trel peers

Gets the TREL peer table in table or list format.

پارامترها 

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 and API References

trel port

Gets the UDP port of the TREL interface.

پارامترها

No parameters.

نمونه ها 

trel port
49153
Done

CLI and API References

trel

Indicates whether the TREL operation is enabled.

پارامترها

No parameters.

نمونه ها 

trel
Enabled
Done

CLI and API References

tvcheck (enable,disable)

Enables or disables the Thread version check when upgrading to router or leader. This check is enabled by default.

پارامترها

No parameters.

نمونه ها 

tvcheck enable
Done
tvcheck disable
Done

CLI and API References

txpower (get,set)

Gets (or sets with the use of the optional txpower argument) the transmit power in dBm.

پارامترها 

txpower [txpower]

نمونه ها 

txpower -10
Done
txpower
-10 dBm
Done

CLI and API References

udp bind

Assigns an IPv6 address and a port to an open socket, which binds the socket for communication. Assigning the IPv6 address and port is referred to as naming the socket. For more information, refer to Test UDP Functionality With OT CLI .

پارامترها

udp bind [netif] ip port
  • netif : The binding network interface, which is determined as follows:
    • No value (leaving out this parameter from the command): Thread network interface is used.
    • -u : Unspecified network interface, which means that the UDP/IPv6 stack determines which network interface to bind the socket to.
    • -b : Backbone network interface is used.
  • ip : Unicast IPv6 address to bind to. If you wish to have the UDP/IPv6 stack assign the binding IPv6 address, or if you wish to bind to multicast IPv6 addresses, then you can use the following value to use the unspecified IPv6 address: :: . Each example uses the unspecified IPv6 address.
  • port : UDP port number to bind to. Each of the examples is using port number 1234.

نمونه ها 

udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done

CLI and API References

udp close

Close a UDP/IPv6 socket.

پارامترها

No parameters.

نمونه ها 

udp close
Done

CLI and API References

udp connect

Connect a UDP/IPv6 socket.

پارامترها

udp connect ip port

The following parameters are required:

  • ip : IP address of the peer.
  • port : UDP port number of the peer. The address can be an IPv4 address, which gets synthesized to an IPv6 address using the preferred NAT64 prefix from the network data. The command returns InvalidState when the preferred NAT64 prefix is unavailable.

نمونه ها 

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 and API References

udp linksecurity (enable,disable)

Enables or disables link security.

پارامترها

No parameters.

نمونه ها 

udp linksecurity enable
Done
udp linksecurity disable
Done

CLI and API References

  • No associated API

udp linksecurity

Indicates whether link security is enabled or disabled.

پارامترها

No parameters.

نمونه ها 

udp linksecurity
Enabled
Done

CLI and API References

  • No associated API

udp open

Open a UDP/IPv6 socket.

پارامترها

No parameters.

نمونه ها 

udp open
Done

CLI and API References

udp send

Sends a UDP message using the socket. For more information, refer to Test UDP Functionality With OT CLI .

پارامترها

udp send [ip port] [type] value

The ip and port are optional as a pair, but if you specify one you must specify the other. If ip and port are not specified, the socket peer address is used from udp connect .

  • ip : Destination address. This address can be either an IPv4 or IPv6 address, An IPv4 address gets synthesized to an IPv6 address with the preferred NAT64 prefix from the network data. (If the preferred NAT64 prefix is unavailable, the command returns InvalidState ).
  • port : UDP destination port.
  • type / value combinations:
    • -t : The payload in the value parameter is treated as text. If no type value is entered, the payload in the value parameter is also treated as text.
    • -s : Auto-generated payload with the specified length given in the value parameter.
    • -x : Binary data in hexadecimal representation given in the value parameter.

نمونه ها 

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 and API References

unsecure get

Lists all ports from the allowed unsecured port list.

پارامترها

No parameters.

نمونه ها 

unsecure get
1234
Done

CLI and API References

unsecureport add

Adds a port to the allowed unsecured port list.

پارامترها 

unsecureport add port

نمونه ها 

unsecureport add 1234
Done

CLI and API References

unsecureport remove

Removes a specified port or all ports from the allowed unsecured port list.

پارامترها 

unsecureport remove port|all

نمونه ها 

unsecureport remove 1234
Done
unsecureport remove all
Done

CLI and API References

uptime ms

Returns the current instance uptime (in msec).

Requires OPENTHREAD_CONFIG_UPTIME_ENABLE to be enabled.

The uptime is given as number of milliseconds since OpenThread instance was initialized.

پارامترها

No parameters.

نمونه ها 

uptime ms
426238
Done

CLI and API References

uptime

Returns the current instance uptime as a human-readable string.

Requires OPENTHREAD_CONFIG_UPTIME_ENABLE to be enabled.

The string follows the format " : : . " for hours, minutes, seconds and millisecond (if uptime is shorter than one day) or "

د : : . " (if longer than a day).

If the resulting string does not fit in aBuffer (within its aSize characters), the string will be truncated but the outputted string is always null-terminated.

پارامترها

No parameters.

نمونه ها 

uptime
12:46:35.469
Done

CLI and API References

vendor appurl (set)

Set the vendor app URL string.

Requires OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE .

aVendorAppUrl should be UTF8 with max length of 64 chars ( MAX_VENDOR_APPL_URL_TLV_LENGTH ). Maximum length does not include the null \0 character.

پارامترها 

vendor appurl url

نمونه ها 

vendor appurl http://www.example.com
Done

CLI and API References

vendor appurl

Get the vendor app URL string.

پارامترها

No parameters.

نمونه ها 

vendor appurl
http://www.example.com
Done

CLI and API References

vendor model (set)

Set the vendor model string.

Requires OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE .

aVendorModel should be UTF8 with max length of 32 chars ( MAX_VENDOR_MODEL_TLV_LENGTH ). Maximum length does not include the null \0 character.

پارامترها 

vendor model name

نمونه ها 

vendor model Hub\ Max
Done

CLI and API References

vendor model

Get the vendor model string.

پارامترها

No parameters.

نمونه ها 

vendor model
Hub Max
Done

CLI and API References

vendor name (set)

Set the vendor name string.

Requires OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE .

aVendorName should be UTF8 with max length of 32 chars ( MAX_VENDOR_NAME_TLV_LENGTH ). Maximum length does not include the null \0 character.

پارامترها 

vendor name name

نمونه ها 

vendor name nest
Done

CLI and API References

vendor name

Get the vendor name string.

پارامترها

No parameters.

نمونه ها 

vendor name
nest
Done

CLI and API References

vendor swversion (set)

Set the vendor software version string.

Requires OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE .

aVendorSwVersion should be UTF8 with max length of 16 chars( MAX_VENDOR_SW_VERSION_TLV_LENGTH ). Maximum length does not include the null \0 character.

پارامترها 

vendor swversion version

نمونه ها 

vendor swversion Marble3.5.1
Done

CLI and API References

vendor swversion

Get the vendor software version string.

پارامترها

No parameters.

نمونه ها 

vendor swversion
Marble3.5.1
Done

CLI and API References

verhoeff calculate

Calculates the Verhoeff checksum for a given decimal string.

Requires OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE .

پارامترها 

verhoeff calculate decimalstring

نمونه ها 

verhoeff calculate 30731842
1
Done

CLI and API References

verhoeff validate

Validates the Verhoeff checksum for a given decimal string.

Requires OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE .

پارامترها 

verhoeff validate decimalstring

نمونه ها 

verhoeff validate 307318421
Done

CLI and API References

version api

Prints the API version number.

پارامترها

No parameters.

نمونه ها 

version api
28
Done

CLI and API References

  • No associated API

نسخه

Gets the OpenThread version string.

پارامترها

No parameters.

نمونه ها 

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done

CLI and API References