مرجع أوامر واجهة سطر الأوامر

مفتاح ba ephemeralkey

يشير إلى ما إذا كان مفتاح مؤقت نشطًا حاليًا أم لا.

يجب توفّر OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

ba ephemeralkey
active
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

استدعاء ba ephemeralkey (تفعيل، إيقاف)

تضبط دالة معاودة الاتصال التي يستخدمها وكيل الحدود لإبلاغ أي تغييرات ذات صلة باستخدام مفتاح مؤقت.

يجب توفّر 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أغنية ba ephemeralkey واضحة

يؤدي إلى إلغاء المفتاح المؤقت المستخدَم.

يجب توفّر OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

يمكن استخدامها لإلغاء مفتاح مؤقت تم إعداده سابقًا قبل انتهاء مهلته. إذا لم يكن وكيل الحدود قيد التشغيل أو ليس هناك مفتاح مؤقت قيد الاستخدام، لن يكون لاستدعاء هذه الدالة أي تأثير.

إذا كان المفوَّض متصلاً باستخدام المفتاح المؤقت وكان نشطًا حاليًا، لن يؤدي استدعاء هذه الدالة إلى تغيير حالتها. في هذه الحالة، سيستمر otBorderAgentIsEphemeralKeyActive() في عرض TRUE إلى أن يتم إلغاء ربط حساب المفوّض.

المعلمات

ما مِن مَعلمات.

أمثلة

ba ephemeralkey clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ضبط مفتاح المرور المؤقت [timeout-in-msec] [port]

لضبط مفتاح الملف الشخصي المؤقت على مدة مهلة معيّنة

يجب توفّر OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

يمكن ضبط المفتاح المؤقت عندما يكون وكيل الحدود قيد التشغيل حاليًا وغير متصل حاليًا بأي مفوَّض خارجي (أي أنّه في حالة OT_BORDER_AGENT_STATE_STARTED). وبخلاف ذلك، يتم إرجاع OT_ERROR_INVALID_STATE.

يُستخدم aKeyString المحدد مباشرةً باعتباره PSK المؤقت (باستثناء حرف \0 الفارغ اللاحق). يجب أن يتراوح طول aKeyString بين OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH وOT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH بشكل شامل.

سيؤدي ضبط المفتاح المؤقت مرة أخرى قبل انتهاء مهلة مفتاح تم ضبطه مسبقًا إلى استبدال المفتاح الذي تم ضبطه في السابق وإعادة ضبط المهلة.

أثناء سريان الفاصل الزمني، يمكن لأي مفوَّض خارجي استخدام مفتاح الملف الشخصي المؤقت مرة واحدة فقط لإجراء عملية الربط. بعد إلغاء ربط التفويض، يتم محو المفتاح المؤقت، ويعود وكيل الحدود إلى استخدام PSKc.

المعلمات

ما مِن مَعلمات.

أمثلة

ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

معرّف ba (get,set)

يحصل على أو يضبط رقم تعريف جهاز توجيه الحدود الذي يبلغ حجمه 16 بايت، والذي يمكنه التعرّف على الجهاز بشكلٍ فريد من بين العديد من اللغات في البرازيل.

المعلمات

ba id [border-agent-id]

يمكنك استخدام الوسيطة border-agent-id الاختيارية لضبط معرّف وكيل الحدود.

أمثلة

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
 
ba id 00112233445566778899aabbccddeeff
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

منفذ ba

يحصل على منفذ UDP لخدمة وكيل Thread Border.

المعلمات

ما مِن مَعلمات.

أمثلة

ba port
49153
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ولاية ba

يحصل على otBorderAgentState لدور وكيل حدود سلسلة المحادثات.

المعلمات

ما مِن مَعلمات.

أمثلة

ba state
Started
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بريطاني

تعرض معلومات "جهاز توجيه العمود الفقري الأساسي" الحالي لجهاز Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إعدادات bbr (ضبط)

تضبط هذه السياسة إعدادات جهاز توجيه Backbone Router على otBackboneRouterConfig.

يتم تلقائيًا بدء رسالة "طلب بيانات الخادم" SRV_DATA.ntf في حال تغيير مجموعة بيانات BBR لجهاز التوجيه الأساسي ذي العمود الفقري.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

يجب إصدار bbr register بشكل صريح لتسجيل خدمة Backbone Router لدى "القائد" في جهاز التوجيه الثانوي (Backbone Router).

المعلمات

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

أمثلة

bbr config seqno 20 delay 30
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعدادات bbr

يحصل على الإعدادات المحلية لجهاز توجيه Backbone Router.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف bbr

تفعيل أو إيقاف وظيفة Backbone

في حال تفعيل السياسة، يتم تشغيل رسالة "طلب بيانات الخادم" SRV_DATA.ntf للجهاز المتصل في حال عدم توفّر "خدمة توجيه الروابط" في بيانات شبكة Thread.

في حال إيقاف السياسة، يتم تشغيل SRV_DATA.ntf إذا كان "جهاز توجيه الظهر" في الحالة "الأساسية".

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

bbr disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تفعيل bbr

تفعيل أو إيقاف وظيفة Backbone

في حال تفعيل السياسة، يتم تشغيل رسالة "طلب بيانات الخادم" SRV_DATA.ntf للجهاز المتصل في حال عدم توفّر "خدمة توجيه الروابط" في بيانات شبكة Thread.

في حال إيقاف السياسة، يتم تشغيل SRV_DATA.ntf إذا كان "جهاز توجيه الظهر" في الحالة "الأساسية".

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

bbr enable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

bbr jitter (get,set)

يحصل على أو يضبط عدم الاستقرار (بالثواني) لتسجيل Backbone Router.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

المعلمات

bbr jitter [jitter]

أمثلة

bbr jitter
20
Done
 
bbr jitter 10
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

cannot translate

مع تضمين 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_REGISTER
  • 2: ST_DUA_CUSTOM
  • 3: ST_DUA_DUPLICATE
  • 4: ST_DUA_NO_الموارد
  • 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

bbr mgmt mlr مستمع إضافة

تضيف أداة معالجة البث المتعدد مع تحديد قيمة المهلة بالثواني.

مرِّر 0 لاستخدام مهلة MLR التلقائية.

تتوفّر هذه الميزة عند تفعيل كلّ من OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE وOPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE وOPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

المعلمات

bbr mgmt mlr listener add ipaddress [timeout-seconds]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مستمع bbr mgmt mlr

تعرض مستمعات البث المتعدد باستخدام otBackboneRouterMulticastListenerInfomTimeout في ثوانٍ.

تتوفّر هذه الميزة عند تفعيل كلّ من السياستَين OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE وOPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

استجابة 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_ النافذة غير متوفرة
  • 3: ST_MLR_NO_PERSISTENT
  • 4: ST_MLR_NO_الموارد
  • 5: ST_MLR_BBR_NOT_PRIMARY
  • 6: ST_MLR_GENERAL_FAILURE

أمثلة

bbr mgmt mlr response 2
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجلّ bbr

تسجيل إعداد جهاز توجيه Backbone Router المحلي بوضوح.

تم تشغيل رسالة "طلب بيانات الخادم" SRV_DATA.ntf للجهاز المتصل.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

bbr register
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حالة bbr

يحصل على جهاز التوجيه Backbone Router otBackboneRouterState.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف br

لإيقاف مدير التوجيه الحدودي.

المعلمات

ما مِن مَعلمات.

أمثلة

br disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br تفعيل

تفعِّل هذه السياسة.

المعلمات

ما مِن مَعلمات.

أمثلة

br enable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

المملكة المتحدة

لإعداد مدير توجيه الحدود.

المعلمات

br init infrastructure-network-index is-running

أمثلة

br init 2 1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة nat64 في البرازيل

تُخرج بادئات NAT64 المحلية والمفضّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة nat64المفضّلة في br nat64

يحصل على بادئة NAT64 المفضلة حاليًا.

يمكن اكتشاف بادئة NAT64 المفضلة من رابط البنية الأساسية أو يمكن أن تكون بادئة NAT64 المحلية لهذا الجهاز.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة nat64 في البرازيل

يحصل على بادئة NAT64 المحلية لموجه الحدود.

قد لا يتم الإعلان عن بادئة NAT64 في شبكة Thread.

يجب تفعيل OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br omrprefix

يؤدي إلى إخراج بادئة OMR المحلية والمفضّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تفضيل br omrprefix

يحصل على بادئة Off-Mesh-Routable (OMR) المفضّلة حاليًا.

يمكن اكتشاف بادئة OMR المفضلة من "بيانات الشبكة" أو يمكن أن تكون بادئة OMR المحلية لهذا الجهاز.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br omrprefix محلي

للحصول على بادئة Off-Mesh-Routable (OMR) المحلية، على سبيل المثال fdfc:1ff5:1512:5622::/64.

بادئة OMR هي بادئة بتنسيق 64 بت يتم إنشاؤها عشوائيًا ويتم نشرها في شبكة Thread إذا لم تكن هناك بالفعل بادئة OMR. ويمكن الوصول إلى هذه البادئة من خلال شبكة Wi-Fi المحلية أو شبكة إيثرنت.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br onlinkprefix

يؤدي إلى إخراج بادئات الربط المحلية والمفضّلة على الرابط.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تفضيل br onlinkprefix

يحصل على بادئة On-Link المفضلة حاليًا.

البادئة المفضّلة هي إمّا بادئة مكتشفة على الرابط على رابط البنية الأساسية أو البادئة المحلية على الرابط.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br onlinkprefix محلي

للحصول على بادئة On-Link المحلية لرابط البنية الأساسية المجاورة.

البادئة On-Link هي بادئة بتنسيق 64 بت يتم الإعلان عنها على رابط البنية الأساسية إذا لم تكن هناك بادئة قابلة للاستخدام على الرابط يتم الإعلان عنها على الرابط.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br pd (enable,disable)

تفعيل أو إيقاف تفويض بادئة DHCPv6.

يجب تفعيل OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

المعلمات

br pd enable|disable

أمثلة

br pd enable
Done
 
br pd disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حالة اضطراب الكريكت

يحصل على الحالة الحالية لتفويض بادئة DHCPv6.

يجب تفعيل OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

br pd state
running
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أقران في البرازيل

احصل على قائمة بـ BRs مماثلة في إدخالات بيانات الشبكة. يجب ملء الحقل "OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE". أجهزة الشبكات اللاسلكية النظيرة هي أجهزة أخرى داخل شبكة Thread المتداخلة توفّر اتصال IP الخارجي. يتم اعتبار الجهاز يوفر اتصال IP خارجيًا في حال استيفاء شرط واحد على الأقل من الشروط التالية في ما يتعلق بإدخالات بيانات الشبكة:

  • لقد تمت إضافة إدخال مسار خارجي واحد على الأقل.
  • يحتوي على إدخال بادئة واحد على الأقل مع تعيين علامات كل من المسار التلقائي وعلامة on-mesh.
  • يحتوي على بادئة نطاق واحدة على الأقل (مع ضبط علامات النطاق وعلامات الشبكة المتداخلة). تستبعد قائمة البرازيل المماثلة الجهاز الحالي على وجه التحديد، حتى إذا كان نفسه يعمل كـ BR. المعلومات لكل إدخال في البرازيل:
  • RLOC16 من البرازيل
  • العمر كفاصل المدة منذ ظهور هذه البرازيل في بيانات الشبكة. يتم تنسيقها على النحو {hh}:{mm}:{ss} للساعات والدقائق والثواني، إذا كانت المدة أقل من 24 ساعة. إذا كانت المدة 24 ساعة أو أكثر، يكون التنسيق {dd}d.{hh}:{mm}:{ss} للأيام والساعات والدقائق والثواني.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدد التطبيقات المشابهة في البرازيل

تعرض عدد BRs المشابهة في بيانات الشبكة.

يجب توفّر OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.

أجهزة الشبكات اللاسلكية النظيرة هي أجهزة أخرى داخل شبكة Thread المتداخلة توفّر اتصال IP الخارجي. يتم اعتبار الجهاز يوفر اتصال IP خارجيًا في حال استيفاء شرط واحد على الأقل من الشروط التالية في ما يتعلق بإدخالات بيانات الشبكة:

  • لقد تمت إضافة إدخال مسار خارجي واحد على الأقل.
  • يحتوي على إدخال بادئة واحد على الأقل مع تعيين علامات كل من المسار التلقائي وعلامة on-mesh.
  • يحتوي على بادئة نطاق واحدة على الأقل (مع ضبط علامات النطاق وعلامات الشبكة المتداخلة).

تستبعد قائمة البرازيل المشابهة على وجه التحديد الجهاز الحالي، حتى إذا كان نفسه يعمل كـ BR.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة br

يمكنك الحصول على البادئات التي تم اكتشافها من خلال التوجيه الحدودي عبر رابط البنية الأساسية. المعلومات حسب إدخال البادئة:

  • البادئة
  • ما إذا كانت البادئة على الرابط أو على المسار
  • مللي ثانية منذ آخر إعلان جهاز توجيه يحتوي على هذه البادئة
  • بادئة القيمة الدائمة بالثواني
  • العمر المفضّل بالثواني فقط إذا كانت البادئة مضمّنة في الرابط
  • تفضيل المسار (منخفض، متوسط، مرتفع) فقط إذا كانت البادئة مسارًا (وليست على الرابط)
  • عنوان IPv6 الخاص بجهاز التوجيه الذي يعلن عن هذه البادئة
  • العلامات في عنوان إعلانات جهاز التوجيه الذي تم استلامه:
    • M: علامة "إعدادات العنوان المُدار"
    • O: علامة "إعدادات أخرى"
    • العقب: علامة جهاز التوجيه القصير (تشير إلى ما إذا كان الموجه عبارة عن جهاز توجيه بديل)

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br raoptions (تعيين،مسح)

لضبط خيارات إضافية لإلحاقها بنهاية رسائل إعلانات أجهزة التوجيه المنبعثة (RA).

يتم نسخ محتوى aOptions داخليًا، لذا يمكن أن يكون مخزنًا مؤقتًا (على سبيل المثال، مصفوفة مخصّصة في حزمة).

تؤدي الطلبات اللاحقة لهذه الدالة إلى استبدال القيمة التي تم ضبطها مسبقًا.

المعلمات

br raoptions options|clear

يمرّر br raoptions clear nullptr إلى otBorderRoutingSetExtraRouterAdvertOptions. بخلاف ذلك، يمكنك تمرير options بايت كبيانات سداسية عشرية.

أمثلة

br raoptions 0400ff00020001
Done
 
br raoptions clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br rioprf (مرتفع،متوسط،منخفض)

تحدِّد هذه السياسة الإعدادات المفضّلة بشكلٍ صريح للاستخدام عند الإعلان عن "خيارات معلومات المسار" (RIO) في رسائل إعلانات أجهزة التوجيه المُرسَلة عبر رابط البنية الأساسية.

بعد استدعاء هذه الدالة، ستستخدم BR التفضيل المحدّد لجميع وحدات RIO المعلَن عنها. يمكن محو التفضيل من خلال طلب الرقم otBorderRoutingClearRouteInfoOptionPreference() .

المعلمات

br rioprf [high|med|low]

أمثلة

br rioprf low
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

البرازيل

يتم استخدام التفضيل الحالي عند الإعلان عن "خيارات معلومات المسار" (RIO) في رسائل إعلانات أجهزة التوجيه التي يتم إرسالها عبر رابط البنية الأساسية.

يتم تحديد تفضيل RIO على النحو التالي:

  • إذا ضبط المستخدم الإعداد بشكل صريح من خلال طلب الرقم otBorderRoutingSetRouteInfoOptionPreference()، يتم استخدام الإعدادات المفضّلة المحدّدة.
  • بخلاف ذلك، يتم تحديدها استنادًا إلى الدور الحالي للجهاز: الإعداد المفضّل المتوسط في دور جهاز التوجيه/القائد، والتفضيل المنخفض في الدور الثانوي.

المعلمات

ما مِن مَعلمات.

أمثلة

br rioprf
med
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

البرازيل

يؤدي هذا الإجراء إلى محو قيمة تفضيل تم تعيينها سابقًا لخيارات معلومات المسار المعلن عنها.

بعد استدعاء هذه الوظيفة، ستستخدم BR دور الجهاز لتحديد تفضيل RIO: تفضيل متوسط عندما يكون في دور جهاز التوجيه/القائد، والتفضيل المنخفض عندما يكون في دور فرعي.

المعلمات

ما مِن مَعلمات.

أمثلة

br rioprf clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br Roadprf (مرتفع،متوسط،منخفض)

لتعيين تفضيل المسارات المنشورة في بيانات الشبكة بشكلٍ صريح.

بعد استدعاء هذه الدالة، ستستخدم BR التفضيل المحدد. يمكن محو التفضيل من خلال طلب الرقم otBorderRoutingClearRoutePreference() .

المعلمات

br routeprf [high|med|low]

أمثلة

br routeprf low
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

البرازيل

للحصول على التفضيل الحالي المستخدم للمسارات المنشورة في بيانات الشبكة.

ويتم تحديد التفضيل كما يلي:

  • إذا ضبط المستخدم الإعداد بشكل صريح من خلال طلب الرقم otBorderRoutingSetRoutePreference()، يتم استخدام الإعدادات المفضّلة المحدّدة.
  • بخلاف ذلك، يتم تحديده تلقائيًا من خلال RoutingManager استنادًا إلى دور الجهاز وجودة الرابط.

المعلمات

ما مِن مَعلمات.

أمثلة

br routeprf
med
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

البرازيل

يؤدي ذلك إلى محو قيمة تفضيل تم تحديدها سابقًا للمسارات المنشورة في بيانات الشبكة.

بعد استدعاء هذه الوظيفة، ستحدد BR تلقائيًا التفضيل تلقائيًا استنادًا إلى دور الجهاز وجودة الرابط (إلى أحد الوالدين عند استخدام الجهاز كجهاز نهائي).

المعلمات

ما مِن مَعلمات.

أمثلة

br routeprf clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

br Routes

احصل على قائمة بأجهزة التوجيه التي تم اكتشافها بواسطة مدير التوجيه الحدودي على رابط البنية الأساسية. معلومات لكل جهاز توجيه:

  • عنوان IPv6 الخاص بجهاز التوجيه
  • العلامات في عنوان إعلانات جهاز التوجيه الذي تم استلامه:
    • M: علامة "إعدادات العنوان المُدار"
    • O: علامة "إعدادات أخرى"
    • العقب: علامة جهاز التوجيه القصير (تشير إلى ما إذا كان الموجه عبارة عن جهاز توجيه بديل)
  • عدد المللي ثانية منذ آخر رسالة تم استلامها من جهاز التوجيه هذا
  • علامة إمكانية الوصول: يتم وضع علامة على جهاز التوجيه بأنه لا يمكن الوصول إليه في حالة عدم استجابته إلى عدة تحقيقات لطلب تقديم الطلبات المجاورة.
  • العمر: فاصل المدة منذ اكتشاف جهاز التوجيه هذا لأول مرة. يتم تنسيقها على النحو {hh}:{mm}:{ss} للساعات والدقائق والثواني، إذا كانت المدة أقل من 24 ساعة. إذا كانت المدة 24 ساعة أو أكثر، يكون التنسيق {dd}d.{hh}:{mm}:{ss} للأيام والساعات والدقائق والثواني.
  • يتم إلحاق "(this BR)" عندما يكون جهاز التوجيه هو الجهاز المحلي نفسه.
  • يتم إلحاق السمة (peer BR) عندما يكون جهاز التوجيه شبكة BR مشابهة متصلة بشبكة Thread المتداخلة نفسها. يتطلب هذا الإجراء OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ولاية البرازيل

الحصول على الحالة الحالية لمدير التوجيه الحدودي.

المعلمات

ما مِن مَعلمات.

أمثلة

br state
running

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

bufferinfo

الحصول على معلومات المخزن المؤقت للرسائل الحالية

  • يعرض total إجمالي عدد المخازن المؤقتة للرسائل في المجموعة.
  • يعرض free عدد المخازن المؤقتة للرسائل المجانية.
  • يعرض max-used الحد الأقصى لعدد وحدات التخزين المؤقت المستخدمة في الوقت نفسه منذ إعداد حزمة OT أو آخر bufferinfo reset.

بعد ذلك، يعرض واجهة سطر الأوامر معلومات عن قوائم الانتظار المختلفة التي تستخدمها حزمة 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تمت إعادة ضبط معلومات المخزن المؤقت

يمكنك إعادة ضبط عدّاد معلومات "مخزن الرسائل" لتتبّع الحد الأقصى للمخزن المؤقت قيد الاستخدام في الوقت نفسه.

سيؤدي هذا إلى إعادة ضبط mMaxUsedBuffers في otBufferInfo .

المعلمات

ما مِن مَعلمات.

أمثلة

bufferinfo reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ccathreshold (get,set)

يتم الحصول على أو ضبط الحد الأدنى لـ CCA بالديسيبل، والذي يتم قياسه في موصّل الهوائي وفقًا للفقرة 10.1.4 من معيار IEEE 802.15.4 - 2015.

المعلمات

ccathreshold [CCA-threshold-dBm]

يمكنك استخدام الوسيطة الاختيارية CCA-threshold-dBm لضبط حدّ CCA.

أمثلة

ccathreshold
-75 dBm
Done
 
ccathreshold -62
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قناة (get,set)

لعرض قيمة قناة IEEE 802.15.4 أو ضبطها.

المعلمات

channel [channel-num]

استخدِم channel-num لضبط القناة.

أمثلة

channel
11
Done
 
channel 11
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مدير القناة تلقائيًا

تعمل هذه السياسة على تفعيل وظيفة الاختيار التلقائي للقنوات إلى مجموعات أو إيقافها.

عند التفعيل، يستدعي ChannelManager بشكل دوري RequestChannelSelect(false). يمكن ضبط الفاصل الزمني للدورة من خلال otChannelManagerSetAutoChannelSelectionInterval() .

يجب توفير السمتَين OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE أو OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE وOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

channel manager auto enable

1 هي قيمة منطقية بالنسبة إلى enable.

أمثلة

channel manager auto 1
channel manager auto 1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تغيير مدير القناة

تطلب تغيير قناة شبكة Thread.

تنتقل الشبكة إلى القناة المحدّدة بعد مهلة محددة (راجع otChannelManagerSetDelay()). ويتم تغيير القناة من خلال تعديل مجموعة البيانات التشغيلية في انتظار المراجعة.

ستؤدي المكالمة اللاحقة إلى إلغاء تغيير القناة الحالي الذي تم طلبه سابقًا.

يجب ملء الحقل "OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE".

المعلمات

channel manager change channel-num

أمثلة

channel manager change 11
channel manager change 11
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مدير القناة

الحصول على حالة مدير القناة يجب ملء الحقل "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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تأخير مدير القناة

لضبط التأخير (بالثواني) المستخدَم لتغيير قناة الشبكة

هذا العرض متوفّر فقط للتقارير التي يتم تتبّعها من خلال FTD. ومن المفترض أن يكون التأخير أطول من الحدّ الأقصى للفاصل الزمني لاستطلاع البيانات الذي تستخدمه جميع الأجهزة الناعسة ضمن شبكة 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تفضيل مدير القناة

لضبط قناع القناة المفضّل.

يجب توفير السمتَين OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE أو OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE وOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

channel manager favored mask

أمثلة

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الفاصل الزمني لمدير القناة

تحدد فاصل الفترة (بالثواني) الذي تستخدمه وظيفة الاختيار التلقائي للقنوات.

يجب توفير السمتَين OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE أو OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE وOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

channel manager interval interval-seconds

أمثلة

channel manager interval 10800
channel manager interval 10800
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اختيار مدير القناة

يطلب هذا الحقل "ChannelManager" التحقّق من قناة جديدة واختيارها وبدء تغيير القناة.

على عكس السمة otChannelManagerRequestChannelChange() التي يجب فيها تحديد القناة كمَعلمة، تطلب هذه الدالة من ChannelManager اختيار قناة بمفردها (استنادًا إلى معلومات جودة القناة التي يتمّ جمعها).

بعد استدعاء مدير القناة، سينفّذ الخطوات الثلاث التالية:

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_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

channel manager select skip-quality-check

استخدِم 1 أو 0 للقيمة المنطقية skip-quality-check.

أمثلة

channel manager select 1
channel manager select 1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مدير القناة المتوافق

لضبط قناع القناة المتوافق.

يجب توفير السمتَين OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE أو OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE وOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

channel manager supported mask

أمثلة

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الحد الأدنى لتحديد مدير القناة

تضبط هذه السياسة الحدّ الأدنى لمعدّل عدم نجاح CCA.

يجب توفير السمتَين OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE أو OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE وOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

channel manager threshold threshold-percent

استخدام قيمة سداسية عشرية لـ threshold-percent يربط 0 بين 0% و0xffff بنسبة 100%.

أمثلة

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أداة مراقبة القناة

يمكنك الاطّلاع على حالة أداة مراقبة القناة الحالية وإشغال القناة. يجب ملء الحقل "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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

بدء أداة مراقبة القناة

شغِّل أداة مراقبة القناة. يرسل OT CLI قيمة منطقية true إلى otChannelMonitorSetEnabled. يجب ملء الحقل OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

channel monitor start
channel monitor start
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف مراقبة القناة

أوقِف أداة مراقبة القناة. يرسل OT CLI قيمة منطقية false إلى otChannelMonitorSetEnabled. يجب ملء الحقل OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

channel monitor stop
channel monitor stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قناة مفضّلة

يحصل على قناع القناة المفضّل للراديو الذي يفضّل الجهاز إنشاءه.

المعلمات

ما مِن مَعلمات.

أمثلة

channel preferred
0x7fff800
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قناة متوافقة

احصل على قناع القناة المتوافق مع الراديو الذي يُسمح للجهاز بتشغيله.

المعلمات

ما مِن مَعلمات.

أمثلة

channel supported
0x7fff800
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طفل (رقم تعريف)

يحصل على معلومات التشخيص الخاصة بطفل مرفق من خلال رقم تعريف الطفل أو 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قائمة فرعية

تعرض قائمة بالمعرّفات الثانوية المرفقة.

المعلمات

ما مِن مَعلمات.

أمثلة

child list
1 2 3 6 7 8
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جدول فرعي

يطبع جدولاً يحتوي على العناصر الثانوية المرفقة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أطفال

للحصول على قائمة بعناوين IP المخزَّنة للعناصر الثانوية في MTD.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

childip max (set)

تعمل هذه السياسة على ضبط أو استعادة الحد الأقصى لعدد عناوين IP التي يمكن أن يسجِّلها كل حساب فرعي من MTD على هذا الجهاز باعتباره أحد الوالدَين.

مرِّر 0 لمحو الإعدادات واستعادة الإعداد التلقائي.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE" مفعّلة.

المعلمات

childip max count

أمثلة

childip max 2
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الطفل في ماكس

الحصول على الحد الأقصى لعدد عناوين IP التي يمكن أن يسجلها كل عنصر فرعي من نظام MTD باستخدام هذا الجهاز كجهاز رئيسي.

المعلمات

ما مِن مَعلمات.

أمثلة

childip max
4
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الطفل (set)

لضبط الحد الأقصى لعدد الأطفال المسموح به حاليًا.

لا يمكن ضبط هذه المَعلمة إلا عند إيقاف عملية بروتوكول Thread.

المعلمات

childmax count

أمثلة

childmax 2
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طفل ماكس

الحصول على الحد الأقصى لعدد الأطفال المسموح به حاليًا.

المعلمات

ما مِن مَعلمات.

أمثلة

childmax
5
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

للحصول على القيمة MLE_CHILD_ROUTER_LINKS أو ضبطها.

المعلمات

childrouterlinks [links]

أمثلة

childrouterlinks
16
Done
 
childrouterlinks 16
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مهلة التحقّق من إشراف الطفل (إعداد)

تحدِّد هذه السياسة مهلة التحقّق من الإشراف (بالثواني) على حساب الطفل.

المعلمات

childsupervision checktimeout timeout-seconds

أمثلة

childsupervision checktimeout 30
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مهلة التحقّق من إشراف الطفل

الحصول على فاصل مهلة التحقّق من الإشراف (بالثواني) على الطفل

إذا كان الجهاز طفلاً نائمًا ولم يستمع إلى رسالة من أحد الوالدين خلال مهلة التحقّق المحددة، سيؤدي ذلك إلى بدء عملية إعادة إرفاقه (MLE Child Update/Response exchange (MLE Child Update/Response exchange) (تبادل طلب التحديث/الاستجابة MLE مع العنصر الرئيسي).

المعلمات

ما مِن مَعلمات.

أمثلة

childsupervision checktimeout
30
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الفاصل الزمني لإشراف الطفل (إعداد)

لضبط فاصل إشراف الطفل (بالثواني) على الطفل.

المعلمات

childsupervision interval interval-seconds

أمثلة

childsupervision interval 30
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فاصل إشراف الطفل

الحصول على فاصل إشراف الأطفال (بالثواني) على الطفل

توفِّر ميزة إشراف الأطفال آلية للوالدَين لضمان إرسال رسالة إلى كل طفل نائم خلال فترة الإشراف. إذا لم يتم إرسال رسالة إلى الطفل خلال الفاصل الزمني للإشراف، يدرِج OpenThread قائمة في قائمة المحتوى ويرسله إلى الطفل.

المعلمات

ما مِن مَعلمات.

أمثلة

childsupervision interval
30
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

التابعة (تعيين)

تضبط هذه السياسة مهلة سلسلة المحادثات الفرعية (بالثواني) المستخدَمة عند العمل في دور "الفرع الفرعي".

المعلمات

childtimeout timeout-seconds

أمثلة

childtimeout 300
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مهلة الطفل

يحصل على مهلة سلسلة المحادثات الفرعية (بالثواني) المستخدَمة عند العمل في دور "حساب فرعي".

المعلمات

ما مِن مَعلمات.

أمثلة

childtimeout
300
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إلغاء الإجراء

لإلغاء اشتراك ملاحظة حالي لمورد بعيد على خادم CoAP.

المعلمات

ما مِن مَعلمات.

أمثلة

coap cancel
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حذف النص

حذف مورد 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

تحقيق الربح

الحصول على معلومات عن مورد CoAP المحدّد على خادم CoAP

المعلمات

coap get address uri-path [type]
  • address: عنوان IPv6 لخادم CoAP.
  • uri-path: مسار معرّف الموارد المنتظم (URI) للمورد.
  • type:
    • con: يمكن تأكيدها
    • non-con: غير قابل للتأكيد (تلقائي)
    • block-: استخدِم هذا الخيار، متبوعًا بقيمة الحظر من المنظور، إذا كان يجب نقل الاستجابة من خلال الحظر. القيم الصالحة هي: block-16 أو block-32 أو block-64 أو block-128 أو block-256 أو block-512 أو block-1024.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

حظيرة تركية

تؤدي هذه السياسة إلى تنفيذ طلب اشتراك يسمح لعميل 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

معلمات Coap(get,set)

الحصول على قيم معلمات CoAP الحالية إذا تم تشغيل الأمر بدون معلمات اختيارية.

تُعيِّن معلمات CoAP إما على القيم الافتراضية أو إلى القيم التي تحددها، بناءً على بناء الجملة المختار.

المعلمات

coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
  • type: request لطلبات CoAP أو response لردود CoAP. إذا لم يتم توفير المزيد من المعلمات، سيطبع الأمر التهيئة الحالية.
  • default: لضبط معلمات الإرسال على القيم التلقائية التالية:
    • ack_timeout: 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مشاركة مرعبة

ينشئ مورد CoAP المحدد. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار إمكانية الاتصال بأحد موارد بروتوكول التطبيقات المشروطة (CoAP) باستخدام واجهة سطر الأوامر OT.

المعلمات

coap post address uri-path [type] [payload]
  • address: عنوان IPv6 لخادم CoAP.
  • uri-path: مسار معرّف الموارد المنتظم (URI) للمورد.
  • type:
    • con: يمكن تأكيدها
    • non-con: غير قابل للتأكيد (تلقائي)
    • block-: استخدِم هذا الخيار، متبوعًا بقيمة الحظر المناسبة لإرسال الوحدات الأساسية مع عدد عشوائي من وحدات البايت للحمولة. القيم الصالحة هي: block-16 أو block-32 أو block-64 أو block-128 أو block-256 أو block-512 أو block-1024.
  • 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

cannot translate

لتعديل مورد CoAP المحدّد. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار إمكانية الاتصال بأحد موارد بروتوكول التطبيقات المشروطة (CoAP) باستخدام واجهة سطر الأوامر OT.

المعلمات

coap put address uri-path [type] [payload]
  • address: عنوان IPv6 لخادم CoAP.
  • uri-path: مسار معرّف الموارد المنتظم (URI) للمورد.
  • type:
    • con: يمكن تأكيدها
    • non-con: غير قابل للتأكيد (تلقائي)
    • block-: استخدِم هذا الخيار، متبوعًا بقيمة الحظر المناسبة لإرسال الوحدات الأساسية مع عدد عشوائي من وحدات البايت للحمولة. القيم الصالحة هي: block-16 أو block-32 أو block-64 أو block-128 أو block-256 أو block-512 أو block-1024.
  • 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مورد Coap (get,set)

يحصل هذا الحقل على مسار معرّف الموارد المنتظم (URI) لمورد خادم CoAP أو يضبطه.

المعلمات

coap resource [uri-path]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مجموعة سباقات

تعيِّن المحتوى الذي أرسله المورد على خادم CoAP. إذا كان عميل CoAP يراقب المورد، يتم إرسال إشعار إلى ذلك العميل.

المعلمات

coap set new-content

أمثلة

coap set Testing123
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بداية Coap

لبدء خادم CoAP لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار إمكانية الاتصال بأحد موارد بروتوكول التطبيقات المشروطة (CoAP) باستخدام واجهة سطر الأوامر OT.

المعلمات

ما مِن مَعلمات.

أمثلة

coap start
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محطة توقّف المركبات

يوقف خادم CoAP.

المعلمات

ما مِن مَعلمات.

أمثلة

coap stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ربط القوات

إعداد جلسة بروتوكول أمان طبقة النقل لمخطّط البيانات (DTLS) مع أحد التطبيقات المشابهة لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

coaps connect address

المعلَمة address هي عنوان IPv6 للنظير.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حذف الشرطين

سلسلة حمولة CoAPS المطلوب حذفها

المعلمات

coaps delete uri-path [type] [payload]
  • uri-path: مسار معرّف الموارد المنتظم (URI) للمورد.
  • type:
    • con: يمكن تأكيدها
    • non-con: غير قابل للتأكيد (تلقائي)
  • payload: طلب حمولة CoAPS.

أمثلة

coaps delete test-resource con hellothere
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

قطع اتصال الشرطة

تؤدي هذه السياسة إلى إيقاف جلسة بروتوكول أمان طبقة النقل لمخطّطات البيانات (DTLS).

المعلمات

ما مِن مَعلمات.

أمثلة

coaps disconnect
coaps disconnected
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

المقاتلون

يحصل على معلومات عن مورد CoAPS المحدّد على خادم CoAPS. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

الشرطات مغلقة

يشير هذا الرمز إلى ما إذا كانت خدمة CoAP Secure مغلقة. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

ما مِن مَعلمات.

أمثلة

coaps isclosed
no
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حركة المرور غير نشطة

يشير إلى ما إذا كان اتصال خدمة CoAP Secure نشطًا (سواء كان متصلاً من قبل أو أثناء عملية إنشاء الاتصال). لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

ما مِن مَعلمات.

أمثلة

coaps isconnactive
yes
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الفرقة مرتبطة

يشير هذا الرمز إلى ما إذا كان قد تم ربط خدمة CoAP Secure. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

ما مِن مَعلمات.

أمثلة

coaps isconnected
yes
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مشاركة لرجال الشرطة

تنشئ مورد CoAPS المحدّد. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

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، تكون معلَمة الحمولة اختيارية. في حال استبعاد مَعلمة الحمولة، يتم إرسال حمولة فارغة. ومع ذلك، إذا كنت تستخدم مَعلمة حمولة البيانات، يجب أن تكون قيمتها سلسلة، مثل hellothere. إذا كانت قيمة type هي block-، يجب أن تكون قيمة مَعلمة الحمولة عددًا صحيحًا يحدد عدد الوحدات المطلوب إرسالها. يتطلب النوع block- ضبط OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

فرقة Coaps psk

تضبط المفتاح المشترك مسبقًا (PSK) ومجموعة التشفير DTLS_PSK_WITH_AES_128_CCM_8.

المعلمات

coaps psk psk-value psk-id
  • psk-value: المفتاح المشترك مسبقًا
  • psk-id: معرّف المفتاح المشترك مسبقًا.

أمثلة

coaps psk 1234 key1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

رجال الشرطة ضعوا

لتعديل مورد CoAPS المحدّد. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

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، تكون معلَمة الحمولة اختيارية. في حال استبعاد مَعلمة الحمولة، يتم إرسال حمولة فارغة. ومع ذلك، إذا كنت تستخدم مَعلمة حمولة البيانات، يجب أن تكون قيمتها سلسلة، مثل hellothere. إذا كانت قيمة type هي block-، يجب أن تكون قيمة مَعلمة الحمولة عددًا صحيحًا يحدد عدد الوحدات المطلوب إرسالها. يتطلب النوع block- ضبط OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مورد Coaps (الحصول على,set)

يحصل هذا الحقل على مسار معرّف الموارد المنتظم (URI) لمورد خادم CoAPS أو يضبطه. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

coaps resource [uri-path]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مجموعة الركلات

تعيِّن المحتوى الذي أرسله المورد على خادم CoAPS. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

coaps set new-content

أمثلة

coaps set Testing123
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

بداية القوات

يؤدي هذا الإجراء إلى بدء خدمة CoAP Secure. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

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

تحدِّد مَعلمة check-peer-cert ما إذا كان فحص شهادة الزملاء مُفعَّلاً (تلقائيًا) أو متوقّفًا. تضبط المَعلمة max-conn-attempts الحد الأقصى لعدد المحاولات المسموح بها، سواء كانت ناجحة أو التي تعذّر إتمامها، للاتصال بخادم CoAP Secure. القيمة التلقائية لهذه المَعلمة هي 0، ما يعني أنّه ما مِن حدّ أقصى لعدد المحاولات. تعمل المَعلمتان check-peer-cert وmax-conn-attempts معًا في المجموعات التالية، على الرغم من أنّه يمكنك تحديد وسيطة واحدة فقط:

  • لم يتم تحديد وسيطة: يتم استخدام القيم الافتراضية.
  • ضبط check-peer-cert على true: له التأثير نفسه الناتج عن حذف الوسيطة، والذي يتمثل في أن قيمة check-peer-cert تساوي true وقيمة max-conn-attempts تساوي 0.
  • ضبط check-peer-cert على false: قيمة check-peer-cert هي false، وقيمة max-conn-attempts هي 0.
  • تحديد رقم: قيمة check-peer-cert هي true، وقيمة max-conn-attempts هي الرقم المحدّد في الوسيطة.

أمثلة

coaps start
Done
 
coaps start false
Done
 
coaps start 8
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

توقف القوات

يؤدي هذا الإجراء إلى إيقاف خدمة CoAP Secure. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة اختبار الاتصال بمورِّد بروتوكول أمان التطبيقات المشروطة (CoAPS) باستخدام واجهة سطر الأوامر OT.

المعلمات

ما مِن مَعلمات.

أمثلة

coaps stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سيارات x509

تحدِّد هذه السياسة شهادة X509 للجهاز المحلي باستخدام المفتاح الخاص المقابل لجلسة DTLS مع DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.

المعلمات

ما مِن مَعلمات.

أمثلة

coaps x509
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعلان المفوّض

يؤدي هذا الخيار إلى إرسال رسالة "إعلان البدء".

المعلمات

commissioner announce mask count period destination
  • mask: قناع Bitm قد يحدد القنوات التي ترسل رسائل MLE Announce
  • count: عدد عمليات إرسال MLE Announce لكل قناة
  • period: عدد المللي ثانية بين عمليات إرسال MLE Announce المتتالية
  • destination: عنوان IPv6 الوجهة للرسالة. قد تكون الرسالة بثًا متعدّدًا.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طاقة المفوّض

يؤدي هذا الخيار إلى إرسال رسالة طلب بحث Energy Scan. تتم طباعة مخرجات الأمر عند استلامه.

المعلمات

commissioner energy mask count period scanDuration destination
  • mask: قناع Bitmask الذي يحدد القنوات اللازمة لإجراء عمليات المسح الضوئي للطاقة IEEE 802.15.4.
  • count: عدد عمليات البحث عن الطاقة وفقًا لمعايير IEEE 802.15.4 لكل قناة.
  • period: عدد المللي ثانية بين عمليات البحث المتتالية للطاقة باستخدام IEEE 802.15.4.
  • scanDuration: مدة الفحص بالمللي ثانية لاستخدامها عند إجراء مسح الطاقة IEEE 802.15.4.
  • destination: عنوان IPv6 الوجهة للرسالة. قد تكون الرسالة بثًا متعدّدًا.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

رقم تعريف المفوّض (get,set)

تتيح هذه السياسة الحصول على اسم رقم تعريف مفوض OpenThread أو ضبطه.

المعلمات

commissioner id name

أمثلة

commissioner id OpenThread Commissioner
Done
 
commissioner id
OpenThread Commissioner
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة عضو مفوَّض

لإضافة إدخال انضمام

المعلمات

commissioner joiner add eui64|discerner pksd [timeout]
  • eui64: IEEE EUI-64 للرابط. لمطابقة أي رابط، استخدِم *.
  • discerner: معرّف الربط بالتنسيق number/length
  • pksd: المفتاح الذي تمت مشاركته مسبقًا للانضمام إلى الاجتماع.
  • timeout: مهلة الانضمام بالثواني.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة عضو مفوّض

إزالة إدخال رابط.

المعلمات

commissioner joiner remove eui64|discerner
  • eui64: IEEE EUI-64 للرابط لمطابقة أي رابط، استخدِم *.
  • discerner: معرّف الدمج بتنسيق number/length

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جدول انضمام المفوَّض

يسرد جميع إدخالات أداة الانضمام بتنسيق جدول.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إدارة المفوَّض

يتم إرسال رسالة MGMT_GET (الحصول على الإدارة) إلى القائد. يتم عرض قيم المتغيّرات التي تم ضبطها باستخدام الأمر commissioner mgmtset.

المعلمات

commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
  • locator: جهاز توجيه الحدود RLOC16.
  • sessionid: رقم تعريف جلسة المفوِّض
  • steeringdata: بيانات التوجيه
  • joinerudpport: منفذ UDP المنضم
  • TLVs: مجموعة الملفات القصيرة (TLV) التي سيتم استردادها

أمثلة

commissioner mgmtget locator sessionid
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إدارة الخدمات الجوّالة للمؤسسات المفوَّضة

ترسل رسالة MGMT_SET (مجموعة الإدارة) إلى القائد، وتضبط المتغيّرات على القيم المحدَّدة.

المعلمات

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
  • locator: جهاز توجيه الحدود RLOC16.
  • sessionid: رقم تعريف جلسة المفوِّض
  • steeringdata: بيانات التوجيه
  • joinerudpport: منفذ UDP المنضم
  • TLVs: مجموعة الملفات القصيرة (TLV) التي سيتم استردادها

أمثلة

commissioner mgmtset joinerudpport 9988
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بنك المفوّض

يرسل طلب بحث عن رقم PAN. يتم عرض مخرجات الأمر عند استلامه.

المعلمات

commissioner panid panid mask destination
  • paind: رقم PAN لاستخدامه في التحقّق من التعارضات
  • mask؛ قناع Bitm يُحدِّد القنوات التي ستُجري عمليات الفحص باستخدام IEEE 802.15.4 Active.
  • destination: عنوان وجهة IPv6 للرسالة. قد تكون الرسالة بثًا متعدّدًا.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عنوان URL لتوفير المتطلبات اللازمة للمفوِّض

تضبط هذه السياسة عنوان URL لتوفير المتطلبات اللازمة للمفوِّض.

المعلمات

commissioner provisioningurl provisioningurl

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

رقم تعريف الجلسة الخاص بالمفوِّض

الحصول على رقم تعريف جلسة المفوَّض الحالي

المعلمات

ما مِن مَعلمات.

أمثلة

commissioner sessionid
0
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بدء المفوَّض

يؤدي هذا الاختصار إلى بدء دور "مفوَّض سلسلة المحادثات".

المعلمات

ما مِن مَعلمات.

أمثلة

commissioner start
Commissioner: petitioning
Done
Commissioner: active

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ولاية المفوّض

تعرض الحالة الحالية للمفوّض. القيم المحتملة هي active أو disabled أو petition (تقديم التماس بأن تصبح مفوضًا).

المعلمات

ما مِن مَعلمات.

أمثلة

commissioner state
active
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

موقع مفوَّض

يؤدي هذا الإجراء إلى إيقاف دور "مفوَّض سلسلة المحادثات".

المعلمات

ما مِن مَعلمات.

أمثلة

commissioner stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة استخدام السياق (get,set)

تحصل على قيمة CONTEXT_ID_REUSE_DELAY أو تضبطها.

المعلمات

contextreusedelay delay

يمكنك استخدام الوسيطة الاختيارية delay لضبط CONTEXT_ID_REUSE_DELAY.

أمثلة

contextreusedelay
11
Done
 
contextreusedelay 11
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدادات (mac)

الحصول على عدّادات طبقة MAC.

المعلمات

counters mac

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدادات (mle)

الحصول على عدّادات Thread MLE

المعلمات

counters mle

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدادات

الحصول على أسماء العدّادات المتوافقة

المعلمات

ما مِن مَعلمات.

أمثلة

counters
ip
mac
mle
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

عدادات ip

الحصول على عدّادات IPv6

المعلمات

counters ip

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط بروتوكول ip للعدادات

تُعيد ضبط عدّادات IPv6.

المعلمات

counters ip reset

أمثلة

counters ip reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

العدادات إعادة تعيين mac

إعادة تعيين عدّادات طبقة MAC.

المعلمات

counters mac reset

أمثلة

counters mac reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط العدادات

إعادة ضبط عدّادات Thread MLE

المعلمات

counters mle reset

أمثلة

counters mle reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قناة CSS

لضبط قناة CSL.

المعلمات

csl channel channel

أمثلة

csl channel 20
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

CSS

الحصول على تهيئة CSL.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فترة CSS

لضبط فترة CSL بالميكرو ثانية.

يمكنك إيقاف CSL من خلال ضبط هذه المَعلمة على 0.

يجب أن تكون فترة CSL مضاعفة OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC، وإلا سيتم إرجاع OT_ERROR_INVALID_ARGS.

المعلمات

csl period period

أمثلة

csl period 3000000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مهلة csl

لضبط مهلة CSL بالثواني.

المعلمات

csl timeout timeout

أمثلة

cls timeout 10
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مجموعة البيانات نشطة

توفر مجموعة البيانات التشغيلية النشطة.

يستخدم OT CLI أعضاء otOperationalDataset لعرض قيم مجموعة البيانات إلى وحدة التحكّم.

المعلمات

dataset active [-x]

تطبع الوسيطة -x الاختيارية قيم مجموعة البيانات التشغيلية النشطة كملفات TLV بترميز سداسي.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الطابع الزمني النشط لمجموعة البيانات (get, set)

تحصل على otOperationalDataset::mActiveTimestamp أو تضبطها.

المعلمات

dataset activetimestamp [timestamp]

مرِّر الوسيطة الاختيارية timestamp لضبط الطابع الزمني النشط.

أمثلة

dataset activetimestamp
123456789
Done
 
dataset activetimestamp 123456789
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

قناة مجموعة البيانات (get,set)

تحصل على otOperationalDataset::mChannel أو تضبطها.

المعلمات

dataset channel [channel-num]

يمكنك استخدام الوسيطة الاختيارية channel-num لضبط القناة.

أمثلة

dataset channel
12
Done
 
dataset channel 12
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

قناع قناة مجموعة البيانات (get,set)

تحصل على otOperationalDataset::mChannelMask أو تضبطها

المعلمات

dataset channelmask [channel-mask]

استخدِم الوسيطة الاختيارية channel-mask لضبط قناع القناة.

أمثلة

dataset channelmask
0x07fff800
Done
 
dataset channelmask 0x07fff800
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

محو مجموعة البيانات

أعِد ضبط المخزن المؤقت لمجموعة البيانات التشغيلية.

المعلمات

ما مِن مَعلمات.

أمثلة

dataset clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إتمام مجموعة البيانات نشطة

التزام المخزن المؤقت لمجموعة البيانات التشغيلية بـ "مجموعة البيانات التشغيلية النشطة".

المعلمات

ما مِن مَعلمات.

أمثلة

dataset commit active
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إتمام مجموعة البيانات في انتظار المراجعة

التزام المورد الاحتياطي لمجموعة البيانات التشغيلية بمجموعة البيانات التشغيلية في انتظار المراجعة.

المعلمات

ما مِن مَعلمات.

أمثلة

dataset commit pending
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تأخير مجموعة البيانات (get,set)

تحصل على otOperationalDataset::mDelay أو تضبطها.

المعلمات

dataset delay [delay]

يمكنك استخدام الوسيطة الاختيارية delay لضبط قيمة موقّت التأخير.

أمثلة

dataset delay
1000
Done
 
dataset delay 1000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

extpanid لمجموعة البيانات (get,set)

تحصل على otOperationalDataset::mExtendedPanId أو تضبطها.

المعلمات

dataset extpanid [extpanid]

يمكنك استخدام الوسيطة الاختيارية extpanid لضبط رقم تعريف شبكة المنطقة الشخصية الموسَّعة.

أمثلة

dataset extpanid
000db80123456789
Done
 
dataset extpanid 000db80123456789
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مساعدة مجموعة البيانات

للحصول على قائمة بـ dataset أوامر CLI. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة عرض مجموعات البيانات وإدارتها باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مجموعة البيانات init (active,new,pending,tlvs)

يتحقّق OT CLI من active أو pending أو tlvs ويعرض القيم المقابلة. بخلاف ذلك، ينشئ OT CLI شبكة عشوائية جديدة ويعرض مجموعة بيانات جديدة.

المعلمات

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

استخدِم new لإعداد مجموعة بيانات جديدة، ثم أدخِل الأمر dataset commit active. استخدِم tlvs للملفات بتنسيق TLV بترميز سداسي.

أمثلة

dataset init new
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مجموعة البيانات meshlocalprefix (get,set)

تحصل على otOperationalDataset::mMeshLocalPrefix أو تضبطها.

المعلمات

dataset meshlocalprefix [meshlocalprefix]

استخدِم الوسيطة الاختيارية meshlocalprefix لضبط بادئة Mesh-Local.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مجموعة البيانات mgmtgetcommand نشطة

يتم إرسال MGMT_ACTIVE_GET.

يرسل OT CLI رسالة MGMT_ACTIVE_GET مع الوسيطات ذات الصلة. للمزيد من المعلومات عن هذه المَعلمات وعمليات ربط الوسيطات، يمكنك الاطّلاع على مقالة عرض مجموعات البيانات وإدارتها باستخدام OT CLI.

المعلمات

dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
  • استخدام address لتحديد وجهة الإصدار السادس من بروتوكول الإنترنت (IPv6) وإلا يتم استخدام Leader 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مجموعة البيانات mgmtsetcommand نشطة

يرسل MGMT_ACTIVE_SET.

المعلمات

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

للمزيد من المعلومات عن هذه المَعلمات وعمليات ربط الوسيطات، يمكنك الاطّلاع على مقالة عرض مجموعات البيانات وإدارتها باستخدام OT CLI.

أمثلة

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

mgmtsetcommand لمجموعة البيانات في انتظار المراجعة

ترسل MGMT_PENDING_SET.

المعلمات

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

للمزيد من المعلومات عن هذه المَعلمات وعمليات ربط الوسيطات، يمكنك الاطّلاع على مقالة عرض مجموعات البيانات وإدارتها باستخدام OT CLI.

أمثلة

dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مجموعة البيانات المتعلقة بمفتاح الشبكة (get,set)

تحصل على otOperationalDataset::mNetworkKey أو تضبطها.

المعلمات

dataset networkkey [key]

استخدِم الوسيطة الاختيارية key لضبط مفتاح الشبكة.

أمثلة

dataset networkkey
00112233445566778899aabbccddeeff
Done
 
dataset networkkey 00112233445566778899aabbccddeeff
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

اسم شبكة مجموعة البيانات (get,set)

يحصل على otOperationalDataset::mNetworkName أو يضبطه.

المعلمات

dataset networkname [name]

يمكنك استخدام الوسيطة الاختيارية name لضبط اسم الشبكة.

أمثلة

dataset networkname
OpenThread
Done
 
dataset networkname OpenThread
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

panid لمجموعة البيانات (get,set)

تعرض هذه الدالة أو تضبطها على otOperationalDataset::mPanId.

المعلمات

dataset panid [panid]

يمكنك استخدام الوسيطة panid الاختيارية لضبط رقم تعريف رقم PAN.

أمثلة

dataset panid
0x1234
Done
 
dataset panid 0x1234
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مجموعة البيانات في انتظار الطابع الزمني (get,set)

تحصل على otOperationalDataset::mPendingTimestamp أو تعيِّنها.

المعلمات

dataset pendingtimestamp [timestamp]

يمكنك استخدام الوسيطة timestamp الاختيارية لضبط ثوانٍ الطابع الزمني التي في انتظار المراجعة.

أمثلة

dataset pendingtimestamp
123456789
Done
 
dataset pendingtimestamp 123456789
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مجموعة بيانات pskc (get,set)

تحصل على otOperationalDataset::mPskc أو تضبطها.

المعلمات

dataset pskc [-p passphrase] | [key]

بالنسبة إلى FTD فقط، يمكنك استخدام -p مع الوسيطة passphrase. ينشئ -p ملف pskc من passphrase الذي تقدّمه بترميز UTF-8، بالإضافة إلى اسم الشبكة ورقم تعريف PAN الموسّع. في حال ضبط السياسة، يستخدم -p المخزن المؤقت لمجموعة البيانات. وإلا، فإنها تستخدم المكدس الحالي. بدلاً من ذلك، يمكنك ضبط pskc على key (تنسيق سداسي عشري).

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

سياسة أمان مجموعة البيانات (get,set)

يحصل على سياسة أمان مجموعة البيانات أو يضبطها.

المعلمات

dataset securitypolicy [rotationtime [onrcCepR]]

أمثلة

dataset securitypolicy
672 onrc
Done
 
dataset securitypolicy 672 onrc
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مجموعة البيانات (نشطة،في انتظار المراجعة)

تحدِّد هذه السياسة مجموعة البيانات التشغيلية النشطة.

إذا كانت مجموعة البيانات لا تتضمّن طابعًا زمنيًا نشطًا، ستكون مجموعة البيانات كاملة جزئيًا فقط.

إذا كانت خدمة Thread مفعَّلة على جهاز يتضمّن مجموعة بيانات نشطة مكتملة جزئيًا، سيحاول الجهاز الاتصال بشبكة Thread حالية باستخدام أي معلومات حالية في مجموعة البيانات. لن تحتاج سوى إلى مفتاح شبكة Thread فقط للاتصال بإحدى الشبكات.

إذا لم يتم تضمين القناة في مجموعة البيانات، سيرسل الجهاز رسالة إشعار MLE على جميع القنوات المختلفة للعثور على جهات مجاورة على قنوات أخرى.

إذا نجح الجهاز في الاتصال بشبكة Thread، فسيسترد الجهاز مجموعة البيانات النشطة الكاملة من عنصره الرئيسي. تجدر الإشارة إلى أنّ الجهاز المتوافق مع جهاز التوجيه لن ينتقل إلى دور "جهاز التوجيه" أو "القائد" حتى تتوفّر له مجموعة بيانات نشطة كاملة.

تعرض هذه الدالة بشكل ثابت OT_ERROR_NONE ويمكن التعامل معها بفعالية باعتبارها تتضمن نوع إرجاع void. في السابق، كانت هناك أخطاء أخرى (على سبيل المثال، OT_ERROR_NOT_IMPLEMENTED) لأسباب قديمة. ومع ذلك، أصبح التخزين غير المتطاير إلزاميًا الآن لتشغيل سلسلة المحادثات، وسيؤدي أي تعذُّر في حفظ مجموعة البيانات إلى ظهور تأكيد. ويتم الاحتفاظ بنوع الإرجاع otError للتوافق مع الأنظمة القديمة.

يضبط أمر واجهة سطر الأوامر dataset set مجموعة البيانات التشغيلية النشطة باستخدام ملفات TLV بترميز سداسي.

المعلمات

dataset set {active|pending} tlvs

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ملفات Tlv لمجموعة البيانات

تحوِّل مجموعة بيانات تشغيلية معيّنة إلى otOperationalDatasetTlvs .

المعلمات

ما مِن مَعلمات.

أمثلة

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إلغاء أداة تعديل مجموعة البيانات

يؤدي إلى إلغاء طلب تعديل مجموعة بيانات تشغيلية مستمر (إن وُجد).

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

@dataset updater cancel
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أداة تحديث مجموعات البيانات

تشير هذه السمة إلى ما إذا كان هناك طلب تعديل مستمر لمجموعة بيانات التشغيل.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

dataset updater
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بدء أداة تحديث مجموعة البيانات

طلب تعديل مجموعة البيانات التشغيلية.

يتوفّر هذا الخيار عندما تكون ميزة "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 لجمع معلومات حول الجهاز وشبكة سلسلة المحادثات هذا مُخصص لتصحيح الأخطاء. ستعرض المخرجات كل أمر CLI تم تنفيذه مسبوقًا بـ $، يليه الناتج الذي تم إنشاؤه من الأمر المقابل. يشمل الناتج الذي تم إنشاؤه المعلومات التالية:

  • الإصدار
  • الحالة الحالية
  • RLOC16، عنوان MAC موسّع
  • قائمة عناوين IPv6 للإرسال الأحادي والبث المتعدد
  • القناة
  • رقم PAN ورقم PAN الموسّع
  • بيانات الشبكة
  • رقم تعريف القسم
  • بيانات القائد

إذا كان الجهاز يعمل بنظام FTD:

  • جدول الأطفال والجار
  • جدول أجهزة التوجيه ومعلومات القفزة التالية
  • جدول ذاكرة التخزين المؤقت للعنوان
  • عنوان IPv6 الثانوي المسجّل في MTD
  • خصائص الجهاز

إذا كان الجهاز متوافقًا مع برنامج SRP ويعمل به:

  • حالة عميل SRP
  • خدمات عملاء SRP ومعلومات المضيف

إذا كان الجهاز متوافقًا مع خوادم SRP ويعمل كخادم SRP:

  • حالة خادم SRP ووضع العنوان
  • الخدمات والمضيفات المسجَّلة لخادم SRP

إذا كان الجهاز متوافقًا مع TREL:

  • حالة TREL وجدول التطبيقات المشابهة

إذا كان الجهاز متوافقًا ويعمل كجهاز توجيه الحدود:

  • ولاية البرازيل
  • بادئات البرازيل (OMR، on-link، NAT64)
  • جدول البادئات التي تم رصدها

المعلمات

ما مِن مَعلمات.

أمثلة

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

وقت التأخير (محدّد)

يضبط الحد الأدنى لمهلة التأخير (بالثواني).

المعلمات

delaytimermin delaytimermin

أمثلة

delaytimermin 60
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ضبط وقت التأخير

احصل على الحد الأدنى من موقّت التأخير (بالثواني).

المعلمات

ما مِن مَعلمات.

أمثلة

delaytimermin
30
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فصل غير متزامن

يمكنك بدء عملية الفصل السلسة المشابهة للأمر detach بدون حظر وانتظار معاودة الاتصال التي تشير إلى انتهاء الفصل.

المعلمات

ما مِن مَعلمات.

أمثلة

detach async
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فصل

يمكنك بدء عملية الفصل السلس من خلال إشعار العُقد الأخرى أولاً (إرسال إصدار العنوان في حال العمل كجهاز توجيه، أو ضبط قيمة المهلة الفرعية على صفر على العنصر الرئيسي إذا كانت تعمل كفرع) ثم إيقاف عملية بروتوكول Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

detach
Finished detaching
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

لوازم الجهاز (مجموعة)

لضبط خصائص الجهاز.

المعلمات

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

deviceprops

يمكنك الحصول على خصائص الجهاز الحالية.

يجب توفّر OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اكتشف

نفِّذ عملية استكشاف 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Discover reqcallback (تفعيل،إيقاف)

تضبط هذه السياسة معاودة اتصال لتلقّي بيانات طلب استكشاف MLE.

المعلمات

discover reqcallback enable|disable

أمثلة

discover reqcallback enable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تصفُّح نظام أسماء النطاقات

إرسال طلب بحث في نظام أسماء النطاقات للتصفّح (تعداد مثيل الخدمة) للحصول على قائمة الخدمات لاسم خدمة معيّن

المعلمات بعد 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ضغط نظام أسماء النطاقات (enable,disable)

ضبط "ضغط اسم نظام أسماء النطاقات" الحالي.

يكون ضغط اسم نظام أسماء النطاقات مفعَّلاً تلقائيًا. وعند إيقافه، يتم إلحاق أسماء نظام أسماء النطاقات ككاملة ولا يتم ضغطها مطلقًا. وينطبق ذلك على وحدات العميل/الخادم في OpenThread. يجب ملء الحقل "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE".

المعلمات

dns compression [enable|disable]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ضغط نظام أسماء النطاقات

ويشير إلى ما إذا كان "ضغط اسم نظام أسماء النطاقات" تمكين الوضع أم لا.

هذه الميزة مخصَّصة للاختبار فقط، وهي متاحة عندما تكون إعدادات OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE مفعَّلة.

يكون ضغط اسم نظام أسماء النطاقات مفعَّلاً تلقائيًا. وعند إيقافه، يتم إلحاق أسماء نظام أسماء النطاقات ككاملة ولا يتم ضغطها مطلقًا. وينطبق ذلك على وحدات العميل/الخادم في OpenThread. يجب ملء الحقل "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE".

المعلمات

dns compression [enable|disable]

أمثلة

dns compression
Enabled

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعداد نظام أسماء النطاقات (set)

تضبط هذه السياسة الإعدادات التلقائية لطلب البحث في برنامج نظام أسماء النطاقات.

في aConfig غير فارغ، يمكن للمتصل اختيار ترك بعض الحقول في مثيل otDnsQueryConfig غير محدد (القيمة صفر). يتم استبدال الحقول غير المحدّدة بتعريفات خيارات ضبط الخدمة الإضافية OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{} من أجل إنشاء الإعدادات التلقائية لطلب البحث.

عند تفعيل OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE، يتم تلقائيًا ضبط عنوان IPv6 الخاص بالخادم في الإعدادات التلقائية وتعديله من خلال برنامج نظام أسماء النطاقات. ولا يتم ذلك إلا في حال عدم ضبط الإعداد أو تحديده بشكلٍ صريح. يتطلب هذا السلوك تفعيل عميل SRP وميزة التشغيل التلقائي. سيراقب عميل SRP بعد ذلك بيانات شبكة Thread لمدخلات خدمة نظام أسماء النطاقات/خدمة SRP لاختيار خادم SRP. يتم أيضًا ضبط عنوان خادم SRP المحدّد كعنوان خادم نظام أسماء النطاقات في الإعداد التلقائي.

يمكننا ترك بعض الحقول على أنّها غير محدّدة (أو استخدِم القيمة صفر). يتم استبدال الحقول غير المحدّدة بتعريفات خيارات ضبط الخدمة الإضافية 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعدادات نظام أسماء النطاقات

تحصل على إعدادات طلب البحث التلقائية الحالية التي يستخدمها برنامج نظام أسماء النطاقات.

عند بدء تكديس OpenThread، يتم تحديد الإعداد التلقائي لطلب بحث نظام أسماء النطاقات من خلال مجموعة من خيارات ضبط 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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حل نظام أسماء النطاقات

يرسل طلب بحث نظام أسماء النطاقات لتحليل العنوان لسجلات AAAA (IPv6) لاسم مضيف معيّن.

يمكن أن تكون قيمة aConfig فارغة. في هذه الحالة، سيتم استخدام الإعدادات التلقائية (من otDnsClientGetDefaultConfig() ) كإعدادات لطلب البحث هذا. في aConfig غير فارغ، يمكن ترك بعض الحقول غير محددة (القيمة صفر). يتم بعد ذلك استبدال الحقول غير المحددة بقيم الإعدادات التلقائية.

أرسِل طلب بحث نظام أسماء النطاقات للحصول على عنوان IPv6 لاسم المضيف المحدَّد.

المعلمات بعد اسم المضيف اختيارية. يتم استبدال أي قيمة غير محدّدة (أو صفرًا) لهذه المَعلمات الاختيارية بالقيمة الواردة من الإعدادات التلقائية الحالية (إعدادات نظام أسماء النطاقات).

قد يكون عنوان IP لخادم نظام أسماء النطاقات هو عنوان IPv4، وسيتم تجميعه إلى عنوان IPv6 باستخدام بادئة NAT64 المفضّلة من بيانات الشبكة.

المعلمات

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

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

خدمة نظام أسماء النطاقات

لبدء تحليل مثيل خدمة نظام أسماء النطاقات لمثيل خدمة معيّن.

يتوفّر عند تفعيل "OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE".

يمكن أن تكون قيمة aConfig فارغة. في هذه الحالة، سيتم استخدام الإعدادات التلقائية (من otDnsClientGetDefaultConfig() ) كإعدادات لطلب البحث هذا. في aConfig غير فارغ، يمكن ترك بعض الحقول غير محددة (القيمة صفر). يتم بعد ذلك استبدال الحقول غير المحددة بقيم الإعدادات التلقائية.

ترسل الدالة استعلامات لسجلات SRV و/أو TXT لمثيل الخدمة المحدد. يحدد الحقل mServiceMode في otDnsQueryConfig السجلات التي سيتم طلبها (SRV فقط، أو TXT فقط، أو كليهما SRV وTXT) وكيفية تنفيذ طلب البحث (معًا في نفس الرسالة، بشكل منفصل أو بشكل متوازٍ أو في الوضع المحسَّن حيث سيحاول العميل في الرسالة نفسها أولاً ثم بشكل منفصل في حال تعذُّر الحصول على رد).

يوفر سجل SRV معلومات حول منفذ الخدمة والأولوية والوزن بالإضافة إلى اسم المضيف المرتبط بمثيل الخدمة. لا تؤدي هذه الدالة تحليل العنوان لاسم المضيف الذي تم اكتشافه من سجل SRV. يمكن أن يوفّر الخادم/أداة الحل سجلّات AAAA/A لاسم المضيف في قسم "البيانات الإضافية" الخاص بالاستجابة لطلب بحث SRV/TXT، ويمكن استرداد هذه المعلومات باستخدام otDnsServiceResponseGetServiceInfo() في otDnsServiceCallback. يجب ألا يفترض مستخدمو واجهة برمجة التطبيقات هذه أن عنوان المضيف سيكون متاحًا دائمًا من otDnsServiceResponseGetServiceInfo() .

يمكنك إرسال طلب بحث لنظام أسماء النطاقات لتحليل مثيل الخدمة لمثيل خدمة معيّن. يتم تقديم تصنيف مثيل الخدمة أولاً، متبوعًا باسم الخدمة (لاحظ أن تصنيف مثيل الخدمة يمكن أن يحتوي على النقطة '.').

المعلمات بعد 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]

أمثلة

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مضيف خدمة نظام أسماء النطاقات

لبدء تحليل مثيل خدمة نظام أسماء النطاقات لمثيل خدمة معين، مع حل محتمل لعنوان المتابعة لاسم المضيف الذي تم اكتشافه لمثيل الخدمة.

يتوفّر عند تفعيل "OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE".

يمكن أن تكون قيمة aConfig فارغة. في هذه الحالة، سيتم استخدام الإعدادات التلقائية (من otDnsClientGetDefaultConfig() ) كإعدادات لطلب البحث هذا. في aConfig غير فارغ، يمكن ترك بعض الحقول غير محددة (القيمة صفر). يتم بعد ذلك استبدال الحقول غير المحددة بقيم الإعدادات التلقائية. لا يمكن استخدام هذه الدالة مع mServiceMode في ضبط إعداد نظام أسماء النطاقات على OT_DNS_SERVICE_MODE_TXT (أي الاستعلام عن سجل TXT فقط) وسيتم عرض OT_ERROR_INVALID_ARGS.

يتصرف بشكل مشابه لإرسال otDnsClientResolveService() طلبات بحث لسجلات SRV وTXT. على الرغم من ذلك، إذا كان الخادم/برنامج الحل لا يوفر سجلات AAAA/A لاسم المضيف في الرد على طلب SRV (في قسم "البيانات الإضافية")، سيجري تحليل اسم المضيف (إرسال استعلام AAAA) لاسم المضيف الذي تم اكتشافه من سجل SRV. يتم استدعاء استدعاء aCallback عند استلام ردود على جميع طلبات البحث (أي عند اكتمال كل من حلول عنوان الخدمة والمضيف).

يمكنك إرسال طلب بحث نظام أسماء النطاقات لتحليل مثيل الخدمة لمثيل خدمة معيّن مع تحليل اسم مضيف المتابعة المحتمل. يتم تقديم تصنيف مثيل الخدمة أولاً، متبوعًا باسم الخدمة (لاحظ أن تصنيف مثيل الخدمة يمكن أن يحتوي على النقطة '.').

المعلمات بعد service-name اختيارية. يتم استبدال أي قيمة غير محدّدة (أو صفرًا) لهذه المَعلمات الاختيارية بقيمة الإعدادات التلقائية الحالية (dns config).

المعلمات

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

أمثلة

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم النطاق (تعيين)

لضبط "اسم نطاق سلسلة المحادثات"

ولا ينجح هذا الإجراء إلا عند إيقاف بروتوكولات سلسلة المحادثات.

المعلمات

domainname name

استخدِم backslash للخروج من المسافات.

أمثلة

domainname Test\ Thread
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم النطاق

الحصول على اسم نطاق سلسلة المحادثات

المعلمات

ما مِن مَعلمات.

أمثلة

domainname
Thread
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

dua iid (set,clear)

تضبط هذه السياسة أو يمحو "معرّف الواجهة" المحدّد يدويًا لعنوان البث الأحادي لنطاق سلسلة المحادثات.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_DUA_ENABLE" مفعّلة.

المعلمات

dua iid iid|clear

يمرّر dua iid clear nullptr إلى otThreadSetFixedDuaInterfaceIdentifier. وبخلاف ذلك، يمكنك اجتياز iid.

أمثلة

dua iid 0004000300020001
Done
 
dua iid clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

دعاء عيد الفطر

الحصول على معرّف الواجهة المحدَّد يدويًا لعنوان البث الأحادي لنطاق سلسلة المحادثات

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_DUA_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

dua iid
0004000300020001
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عيد التخزين المؤقت (eidcache)

تعرض إدخالات ذاكرة التخزين المؤقت من EID-to-RLOC.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

eui64

للحصول على IEEE EUI-64 لهذه الواجهة من المصنع.

المعلمات

ما مِن مَعلمات.

أمثلة

eui64
0615aae900124b00
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

امتداد (مجموعة)

تضبط هذه السياسة عنوان IEEE 802.15.4 الموسَّع.

المعلمات

extaddr extaddr

أمثلة

extaddr dead00beef00cafe
dead00beef00cafe
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

extaddr

للحصول على عنوان IEEE 802.15.4 الموسع.

المعلمات

ما مِن مَعلمات.

أمثلة

extaddr
dead00beef00cafe
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

extpanid (مجموعة)

تضبط هذه السياسة معرّف IEEE 802.15.4 Extended PAN ID.

المعلمات

extpanid extpanid

أمثلة

extpanid dead00beef00cafe
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

خارجي

يحصل على رقم تعريف رقم PAN الممتد وفقًا لمعيار IEEE 802.15.4.

المعلمات

ما مِن مَعلمات.

أمثلة

extpanid
dead00beef00cafe
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة الضبط على الإعدادات الأصلية

يحذف هذا الإجراء جميع الإعدادات المخزَّنة في ذاكرة غير متطايرة، ثم يؤدي إلى إعادة الضبط على النظام الأساسي.

المعلمات

ما مِن مَعلمات.

أمثلة

factoryreset

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مزيّفة (a,an)

إرسال رسائل مزيّفة ضمن سلسلة المحادثات

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE" مفعّلة.

المعلمات

fake /a/an dst-ipaddr target meshLocalIid

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أنثى

الحصول على مَعلمات FEM الخارجية

المعلمات

ما مِن مَعلمات.

أمثلة

fem
LNA gain 11 dBm
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

fem lna المتاح (الحصول على)

للحصول على ربح LNA الخارجي لـ FEM بالديسيبل.

المعلمات

ما مِن مَعلمات.

أمثلة

fem lnagain
11
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

fem lnatake (set)

لضبط كسب Rx LNA الخارجي بالديسيبل بالمللي واط.

المعلمات

ما مِن مَعلمات.

أمثلة

fem lnagain 8
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجل ipaddr

يعرض سجلّ عناوين IPv6 الأحادية بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • الحدث: القيم المحتملة هي Added أو Removed.
  • طول العنوان/البادئة: عنوان أحادي البث مع طول بادئته (بالبت).
  • المصدر: القيمة المحتملة هي thread أو slaac أو dhcp6 أو manual.
  • النطاق: نطاق عنوان IPv6
  • P: العلامة المفضّلة
  • V: علامة صالحة
  • RLOC (R): تشير هذه العلامة إلى ما إذا كان عنوان IPv6 هو محدد مواقع التوجيه.

المعلمات

history ipaddr [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجل ipmaddr

يعرض سجلّ عناوين IPv6 للإرسال المتعدد بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • الحدث: القيم المحتملة هي Subscribed أو Unsubscribed.
  • عنوان البث المتعدد
  • المصدر: القيم المحتملة هي Thread أو Manual.

المعلمات

history ipmaddr [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جار التاريخ

لعرض سجل الجهة المجاورة بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • اكتب Child أو Router.
  • الحدث: القيم المحتملة هي Added أو Removed أو Changed.
  • العنوان الموسّع
  • RLOC16
  • الوضع: وضع رابط MLE القيم المتاحة:
    • -: لم يتم ضبط أي علامات (rx-off-when-idle، الحدّ الأدنى من جهاز Thread، بيانات شبكة ثابتة)
    • r: rx-on-when-idle
    • d: جهاز Thread كامل
    • n: بيانات الشبكة بالكامل
  • Ave RSS: متوسط عدد الإطارات (بالديسيبل بالمللي واط) التي تم تلقيها من الجهاز المجاور وقت تسجيل الإدخال.

المعلمات

history neighbor [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجلّ netinfo

عرض سجلّ معلومات الشبكة بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • الدور: دور الجهاز. القيم المحتملة هي router أو child أو detached أو disabled.
  • الوضع: وضع رابط MLE القيم المتاحة:
    • -: لم يتم ضبط أي علامات (rx-off-when-idle، الحدّ الأدنى من جهاز Thread، بيانات شبكة ثابتة)
    • r: rx-on-when-idle
    • d: جهاز Thread كامل
    • n: بيانات الشبكة بالكامل
  • RLOC16
  • رقم تعريف القسم

المعلمات

history netinfo [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة السجلّ

لعرض بيانات الشبكة لسجلّ بادئة الشبكة المتداخلة بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • الحدث: القيم المحتملة هي Added أو Removed.
  • بادئة
  • البلاغات/المعنى:
    • p: العلامة المفضّلة
    • a: علامة الإعداد التلقائي لعنوان IPv6 بدون حالة الحالة
    • d: علامة إعداد عنوان DHCPv6 IPv6
    • c: علامة تهيئة أخرى لبروتوكول DHCPv6
    • r: علامة المسار التلقائي
    • o: علامة على الشبكة المتداخلة
    • s: علامة ثابتة
    • n: علامة نظام أسماء النطاقات Nd.
    • D: علامة بادئة النطاق.
  • الإعداد المفضّل: التفضيل يمكن أن تكون القيم high أو med أو low.
  • RLOC16

المعلمات

history prefix [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مسار السجلّ

يعرض سجل المسارات الخارجية لبيانات الشبكة بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • الحدث: القيم المحتملة هي Added أو Removed.
  • مسار
  • البلاغات/المعنى:
    • s: علامة ثابتة
    • n: علم NAT64.
  • الإعداد المفضّل: التفضيل يمكن أن تكون القيم high أو med أو low.
  • RLOC16

المعلمات

history route [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جهاز توجيه السجلّ

يعرض سجلّ جدول المسارات بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • الحدث: القيم المحتملة هي Added أو Removed أو NextHopChanged أو CostChanged.
  • المعرّف (RLOC16): معرّف جهاز التوجيه وRLOC16 لجهاز التوجيه.
  • القفزة التالية: رقم تعريف جهاز التوجيه وRLOC16 من القفزة التالية. في حال عدم وجود قفزة تالية، يتم عرض none.
  • تكلفة المسار: التكلفة القديمة -> التكلفة الجديدة. تشير القيمة inf إلى تكلفة مسار لا نهائي.

المعلمات

history router [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجلّ rx

يعرض سجلّ RX لرسائل IPv6 بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • النوع:
    • نوع رسالة IPv6، مثل UDP وTCP وHopOpts وICMP6 (ونوعها الفرعي).
    • src: عنوان IPv6 ورقم المنفذ المصدر
    • dst: عنوان IPv6 للوجهة ورقم المنفذ (رقم المنفذ صالح لـ UDP/TCP، وإلا فإنه 0).
  • Len: طول حمولة IPv6 (باستثناء رأس IPv6)
  • Chksum: المجموع الاختباري للرسالة (صالح لرسائل UDP أو TCP أو ICMP6).
  • Sec: تشير إلى ما إذا تم استخدام أمان طبقة الرابط.
  • Prio: أولوية الرسالة. القيم المحتملة هي low أو norm أو high أو net (لرسائل التحكم في سلسلة المحادثات).
  • RSS: تم تلقي قوة الإشارة (بالديسيبل)، في المتوسط على مستوى جميع إطارات الأجزاء التي تم استلامها والتي شكلت الرسالة. بالنسبة إلى سجلّ TX، يتم عرض NA (لا ينطبق).
  • Dir: يوضح ما إذا تم إرسال الرسالة (TX) أو استلامها (RX). تتم الإشارة إلى عملية الإرسال غير الناجحة باستخدام TX-F بتنسيق جدول أو tx-success:no بتنسيق القائمة. من الأمثلة على تعذُّر إرسال الرسالة، txإلغاء عملية الإلغاء وعدم إرسال ack من التطبيق المشابه لأي من أجزاء الرسالة.
  • الجوار: عنوان قصير (RLOC16) للجار الذي تم إرسال/استلام الرسالة منه. إذا تم بث الإطار، يتم عرضه كـ bcast بتنسيق الجدول أو 0xffff بتنسيق القائمة. وإذا لم يكن العنوان المختصر للجهة المجاورة متاحًا، يتم عرضه كـ unknwn بتنسيق الجدول أو 0xfffe في تنسيق القائمة.
  • الراديو: رابط راديو تم إرسال/استلام الرسالة عليه (يكون مفيدًا عند تفعيل OPENTHREAD_CONFIG_MULTI_RADIO). يمكن أن يكون الإدخال 15.4 أو trel أو all (في حال إرساله باستخدام كل روابط الراديو).

المعلمات

history rx [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجلّ rxtx

يعرض السجلّ المجمَّع لرسالة IPv6 بتنسيق RX وTX بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • النوع:
    • نوع رسالة IPv6، مثل UDP وTCP وHopOpts وICMP6 (ونوعها الفرعي).
    • src: عنوان IPv6 ورقم المنفذ المصدر
    • dst: عنوان IPv6 للوجهة ورقم المنفذ (رقم المنفذ صالح لـ UDP/TCP، وإلا فإنه 0).
  • Len: طول حمولة IPv6 (باستثناء رأس IPv6)
  • Chksum: المجموع الاختباري للرسالة (صالح لرسائل UDP أو TCP أو ICMP6).
  • Sec: تشير إلى ما إذا تم استخدام أمان طبقة الرابط.
  • Prio: أولوية الرسالة. القيم المحتملة هي low أو norm أو high أو net (لرسائل التحكم في سلسلة المحادثات).
  • RSS: تم تلقي قوة الإشارة (بالديسيبل)، في المتوسط على مستوى جميع إطارات الأجزاء التي تم استلامها والتي شكلت الرسالة. بالنسبة إلى سجلّ TX، يتم عرض NA (لا ينطبق).
  • Dir: يوضح ما إذا تم إرسال الرسالة (TX) أو استلامها (RX). تتم الإشارة إلى عملية الإرسال غير الناجحة باستخدام TX-F بتنسيق جدول أو tx-success:no بتنسيق القائمة. من الأمثلة على تعذُّر إرسال الرسالة، txإلغاء عملية الإلغاء وعدم إرسال ack من التطبيق المشابه لأي من أجزاء الرسالة.
  • الجوار: عنوان قصير (RLOC16) للجار الذي تم إرسال/استلام الرسالة منه. إذا تم بث الإطار، يتم عرضه كـ bcast بتنسيق الجدول أو 0xffff بتنسيق القائمة. وإذا لم يكن العنوان المختصر للجهة المجاورة متاحًا، يتم عرضه كـ unknwn بتنسيق الجدول أو 0xfffe في تنسيق القائمة.
  • الراديو: رابط راديو تم إرسال/استلام الرسالة عليه (يكون مفيدًا عند تفعيل OPENTHREAD_CONFIG_MULTI_RADIO). يمكن أن يكون الإدخال 15.4 أو trel أو all (في حال إرساله باستخدام كل روابط الراديو).

المعلمات

history rxtx [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تاريخ تكساس

يعرض سجلّ TX لرسالة IPv6 بتنسيق جدول أو قائمة.

يوفر كل إدخال في الجدول أو القائمة ما يلي:

  • العمر: الوقت المنقضي منذ إصدار الأمر، والذي تم تقديمه بالتنسيق: hours:minutes:seconds:milliseconds
  • النوع:
    • نوع رسالة IPv6، مثل UDP وTCP وHopOpts وICMP6 (ونوعها الفرعي).
    • src: عنوان IPv6 ورقم المنفذ المصدر
    • dst: عنوان IPv6 للوجهة ورقم المنفذ (رقم المنفذ صالح لـ UDP/TCP، وإلا فإنه 0).
  • Len: طول حمولة IPv6 (باستثناء رأس IPv6)
  • Chksum: المجموع الاختباري للرسالة (صالح لرسائل UDP أو TCP أو ICMP6).
  • Sec: تشير إلى ما إذا تم استخدام أمان طبقة الرابط.
  • Prio: أولوية الرسالة. القيم المحتملة هي low أو norm أو high أو net (لرسائل التحكم في سلسلة المحادثات).
  • RSS: تم تلقي قوة الإشارة (بالديسيبل)، في المتوسط على مستوى جميع إطارات الأجزاء التي تم استلامها والتي شكلت الرسالة. بالنسبة إلى سجلّ TX، يتم عرض NA (لا ينطبق).
  • Dir: يوضح ما إذا تم إرسال الرسالة (TX) أو استلامها (RX). تتم الإشارة إلى عملية الإرسال غير الناجحة باستخدام TX-F بتنسيق جدول أو tx-success:no بتنسيق القائمة. من الأمثلة على تعذُّر إرسال الرسالة، txإلغاء عملية الإلغاء وعدم إرسال ack من التطبيق المشابه لأي من أجزاء الرسالة.
  • الجوار: عنوان قصير (RLOC16) للجار الذي تم إرسال/استلام الرسالة منه. إذا تم بث الإطار، يتم عرضه كـ bcast بتنسيق الجدول أو 0xffff بتنسيق القائمة. وإذا لم يكن العنوان المختصر للجهة المجاورة متاحًا، يتم عرضه كـ unknwn بتنسيق الجدول أو 0xfffe في تنسيق القائمة.
  • الراديو: رابط راديو تم إرسال/استلام الرسالة عليه (يكون مفيدًا عند تفعيل OPENTHREAD_CONFIG_MULTI_RADIO). يمكن أن يكون الإدخال 15.4 أو trel أو all (في حال إرساله باستخدام كل روابط الراديو).

المعلمات

history tx [list] [num-entries]
  • استخدِم الخيار list لعرض الناتج بتنسيق القائمة. وبخلاف ذلك، يتم عرض الناتج بتنسيق جدول.
  • ويمكنك استخدام الخيار num-entries لحصر الناتج بعدد من أحدث الإدخالات المحدّدة. وفي حال عدم استخدام هذا الخيار، سيتم عرض جميع الإدخالات المخزَّنة في النتيجة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ifconfig (لأعلى، أسفل)

نقل واجهة IPv6 إلى الأعلى أو الأسفل

يمكنك استدعاء هذا الإجراء لتفعيل اتصال IPv6 أو إيقافه.

المعلمات

ifconfig up|down

أمثلة

ifconfig up
Done
 
ifconfig down
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ifconfig

يشير إلى ما إذا كانت واجهة IPv6 تعمل أم لا.

المعلمات

ما مِن مَعلمات.

أمثلة

ifconfig
down
Done
 
ifconfig
up
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

instanceid

يحصل على معرّف المثيل.

يتم ضبط معرِّف المثيل على قيمة عشوائية عند إنشاء المثيل، ولن تتغيّر قيمته بعد الإعداد.

المعلمات

ما مِن مَعلمات.

أمثلة

instanceid
468697314
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة ipaddr

يضيف هذا الإعداد عنوان واجهة شبكة إلى واجهة Thread.

يتم نسخ المثيل الذي تم تمريره aAddress من خلال واجهة Thread. لا تتيح واجهة سلسلة المحادثات إلا عددًا ثابتًا من عناوين البث الأحادي التي تتم إضافتها خارجيًا. يمكنك الاطّلاع على OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

المعلمات

ipaddr add aAddress

أمثلة

ipaddr add 2001::dead:beef:cafe
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيبادر ديل

يزيل عنوان واجهة الشبكة من واجهة Thread.

المعلمات

ipaddr del aAddress

أمثلة

ipaddr del 2001::dead:beef:cafe
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيبادر

يحصل على قائمة عناوين IPv6 المخصّصة لواجهة Thread.

المعلمات

ipaddr [-v]

استخدِم -v للحصول على مزيد من المعلومات المفصَّلة عن العنوان:

  • origin: يمكن أن يكون thread أو slaac أو dhcp6 أو manual ويشير إلى أصل العنوان.
  • plen: طول البادئة
  • preferred: علامة مفضّلة (منطقية)
  • valid: علامة صالحة (منطقية)

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ipaddr linklocal

يحصل على عنوان IPv6 المحلي لرابط Thread.

يتم اشتقاق العنوان المحلي لرابط Thread باستخدام IEEE802.15.4 Extended Address كمعرِّف واجهة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيبادر mleid

يحصل على عنوان معرّف EID المحلي للشبكة المتداخلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيبادر رولك

الحصول على عنوان محدد موقع توجيه سلسلة المحادثات (RLOC).

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة ipmaddr

للاشتراك في واجهة Thread في عنوان البث المتعدد في واجهة الشبكة

سيتم نسخ المثيل aAddress الذي تم تمريره من خلال واجهة Thread. لا تتيح واجهة Thread إلا عددًا ثابتًا من عناوين البث المتعدد التي تمت إضافتها خارجيًا. يمكنك الاطّلاع على OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

المعلمات

ipmaddr add aAddress

أمثلة

ipmaddr add ff05::1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ipmaddr del

يؤدي هذا الإجراء إلى إلغاء الاشتراك في واجهة Thread في عنوان البث المتعدد في واجهة الشبكة.

المعلمات

ipmaddr del aAddress

أمثلة

ipmaddr del ff05::1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ipmaddr

للحصول على قائمة بعناوين البث المتعدد IPv6 المشتركين في واجهة Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ipmaddr llatn

للحصول على عنوان Thread Link-Local All Thread Nodes Multi-cast

العنوان هو عنوان بث متعدّد قائم على بادئة Unicast [RFC 3306] محلي على الرابط، مع:

  • تم ضبط Fgs على 3 (P = 1 وT = 1)
  • تَمَّ ضَبْطُ الْكَهْرُفْ عَلَى 2.
  • plen مضبوط على 64
  • تم ضبط بادئة الشبكة على بادئة الشبكة المحلية المتداخلة (Mesh)
  • تم ضبط رقم تعريف المجموعة على 1.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ipmaddr rlatn

للحصول على عنوان البث المتعدد لـ Thread Realm-Local لجميع عُقد سلسلة المحادثات.

هذا العنوان هو عنوان محلي متعدّد قائم على بادئة Unicast [RFC 3306]، مع:

  • تم ضبط Fgs على 3 (P = 1 وT = 1)
  • الْمُسْتَوَى الْمَقْصُودْ عَلَى 3
  • plen مضبوط على 64
  • تم ضبط بادئة الشبكة على بادئة الشبكة المحلية المتداخلة (Mesh)
  • تم ضبط رقم تعريف المجموعة على 1.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محدِّد الانضمام (مجموعة)

تعيين محدد الروابط.

المعلمات

joiner discerner discerner
  • استخدِم {number}/{length} لضبط discerner.
  • تم ضبط aDiscerner على nullptr من قِبل joiner discerner clear.

أمثلة

joiner discerner 0xabc/12
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تمييز النجار واضح

امسح محدد الانضمام.

المعلمات

ما مِن مَعلمات.

أمثلة

joiner discerner clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

مُميِّز نَسب

الحصول على أداة Joiner Discerner

لمزيد من المعلومات، يمكنك الاطّلاع على otJoinerSetDiscerner.

المعلمات

ما مِن مَعلمات.

أمثلة

joiner discerner
0xabc/12
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مساعدة الانضمام

طباعة قائمة مساعدة joiner

المعلمات

ما مِن مَعلمات.

أمثلة

joiner help
help
id
start
state
stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

معرّف الانضمام

الحصول على معرف الانضمام.

إذا لم يتم ضبط معرف الانضمام، يكون معرف الانضمام هو أول 64 بت من نتيجة احتساب SHA-256 عبر IEEE EUI-64 المخصص من المصنع. وبخلاف ذلك، يتم حساب "رقم تعريف الانضمام" من قيمة "المُفصل المشترك".

يُستخدم معرّف الانضمام أيضًا باعتباره عنوان IEEE 802.15.4 الموسع للجهاز أثناء عملية التشغيل.

المعلمات

ما مِن مَعلمات.

أمثلة

joiner id
d65e64fa83f81cf7
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بداية الانضمام

تفعِّل هذه السياسة دور "رابط سلسلة المحادثات".

المعلمات

joiner start joining-device-credential [provisioning-url]
  • joining-device-credential: عبارة مرور الانضمام يجب أن تكون سلسلة من الأحرف الأبجدية الرقمية الكبيرة (0-9 وA-Y، باستثناء I وO وQ وZ لتسهيل القراءة)، وطولها يتراوح بين 6 و32 حرفًا.
  • provisioning-url: عنوان URL لتوفير المتطلبات اللازمة لتطبيق الانضمام (اختياري)

أمثلة

joiner start J01NM3
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حالة الانضمام

الحصول على ولاية الانضمام.

تعرض إحدى الحالات التالية:

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

المعلمات

ما مِن مَعلمات.

أمثلة

joiner state
Idle
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محطة انضمام

لإيقاف دور "رابط سلسلة المحادثات".

المعلمات

ما مِن مَعلمات.

أمثلة

joiner stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Joinerport (مجموعة)

يضبط منفذ UDP الانضمام.

المعلمات

joinerport udp-port

أمثلة

joinerport 1000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جونربورت

يحصل على منفذ Joiner UDP.

المعلمات

ما مِن مَعلمات.

أمثلة

joinerport
1000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدّاد التسلسلات الرئيسية (set)

لضبط thrKeySequenceCounter.

المعلمات

keysequence counter counter

أمثلة

keysequence counter 10
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدّاد تسلسل المفاتيح

الحصول على thrKeySequenceCounter.

المعلمات

ما مِن مَعلمات.

أمثلة

keysequence counter
10
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

وقت حماية تسلسل المفاتيح (مجموعة)

لضبط thrKeySwitchGuardTime (بالساعات).

المعلمات

keysequence guardtime guardtime-hours

استخدِم من 0 إلى Thread Key Switch فورًا إذا كان هناك تطابق في فهرس المفاتيح.

أمثلة

keysequence guardtime 0
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

وقت الحماية لتسلسل المفاتيح

الحصول على thrKeySwitchGuardTime (بالساعات)

المعلمات

ما مِن مَعلمات.

أمثلة

keysequence guardtime
0
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بيانات القادة

الحصول على بيانات قائد سلسلة المحادثات

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

وزن القائد (مجموعة)

تحدد وزن قائد سلسلة المحادثات المستخدم عند العمل في دور "القائد".

تضبط "وزن القائد" القيمة الجديدة مباشرةً، مع استبدال قيمتها السابقة (التي ربما تم تحديدها من قيمة otDeviceProperties الحالية).

المعلمات

leaderweight weight

أمثلة

leaderweight 128
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

وزن القائد

الحصول على وزن قائد سلسلة المحادثات المستخدم عند العمل في دور "القائد".

المعلمات

ما مِن مَعلمات.

أمثلة

leaderweight
128
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محو الإعدادات المحسّنة لمقاييس الروابط

يؤدي هذا الخيار إلى إرسال طلب لإدارة مقاييس الرابط لإزالة اختبار تحقق محسّن من ACK.

المعلمات

linkmetrics config [async] peer-ipaddr enhanced-ack clear
  • async: استخدام "وضع عدم الحظر"
  • يجب أن يكون peer-ipaddr هو عنوان الرابط المحلي للجهاز المجاور.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجلّ النقل المحسَّن في إعدادات linkmetrics

إنّ r الإضافي اختياري ويُستخدَم للأجهزة المرجعية فقط. عند تحديد هذا الخيار، يتم تعيين قيمة/متوسط التعداد لكل علامة من علامات معرف النوع على محجوز. وتُستخدم هذه الطريقة للتأكّد من أنّ "موضوع الاستقصاء" يتعامل بشكل صحيح مع علامات المعرّف لنوع غير صالح، ولا يتوفّر إلّا عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

إرسال طلب إدارة مقاييس الرابط لتسجيل اختبار استقصائي محسَّن استنادًا إلى ACK

المعلمات

linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
  • async: استخدام "وضع عدم الحظر"
  • يتم ربط [q وm وr] بـ otLinkMetricsValues. وفقًا للمواصفات 4.11.3.4.4.6، يمكنك استخدام خيارَين كحد أقصى في الوقت نفسه، على سبيل المثال q أو qm.
    • q: الطبقة 2 LQI
    • m: هامش الرابط
    • r: RSSI.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة توجيه إعدادات linkmetrics

إرسال طلب إدارة مقاييس رابط MLE لضبط سلسلة تتبُّع إعادة توجيه أو محوها

المعلمات

linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
  • async: استخدام "وضع عدم الحظر"
  • peer-ipaddr: عنوان الزملاء.
  • series-id: رقم تعريف المسلسل
  • يتم ربط [l وd وr وa] otLinkMetricsSeriesFlags. لا يمثل X أيًا من otLinkMetricsSeriesFlags، ويوقف الحساب ويزيل السلسلة.
    • l: اختبار رابط MLE
    • d: بيانات MAC.
    • r: طلب بيانات MAC.
    • a: عنوان MAC.
    • X: يمكن استخدامه فقط بدون أي علامات أخرى.
  • يتمّ ربط [p وq وm وr] otLinkMetricsValues.
    • p: الطبقة 2: عدد وحدات PDU التي تم تلقّيها.
    • q: الطبقة 2 LQI
    • m: هامش الرابط
    • r: RSSI.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

استجواب مقاييس الروابط

يرسل رسالة تحقق رابط MLE.

المعلمات

linkmetrics probe peer-ipaddr series-id length
  • peer-ipaddr: عنوان الزملاء.
  • series-id: رقم تعريف المسلسل الذي تستهدفه رسالة التحقيق هذه
  • length: طول رسالة التحقّق النطاق الصالح هو [0, 64].

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طلب مقاييس الروابط إلى الأمام

نفِّذ طلب بحث لمقاييس الرابط (سلسلة التتبُّع المستقبلية).

المعلمات

linkmetrics query [async] peer-ipaddr forward series-id
  • async: استخدام "وضع عدم الحظر"
  • peer-ipaddr: عنوان الزملاء.
  • series-id: رقم تعريف المسلسل

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طلب مقاييس الروابط فردي

نفِّذ طلب بحث عن مقاييس الرابط (فحص فردي).

المعلمات

linkmetrics request [async] peer-ipaddr single [pqmr]
  • async: استخدام "وضع عدم الحظر"
  • peer-ipaddr: عنوان الزملاء.
  • يتم ربط [p وq وm وr] otLinkMetrics.
    • p: الطبقة 2: عدد وحدات PDU التي تم تلقّيها.
    • q: الطبقة 2 LQI
    • m: هامش الرابط
    • r: RSSI.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

linkmetricsmgr (تفعيل،إيقاف)

تفعيل "مدير مقاييس الروابط" أو إيقافه

المعلمات

linkmetricsmgr enable|disable

أمثلة

linkmetricmgr enable
Done
 
linkmetricmgr disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عرض linkmetricsmgr

الحصول على بيانات مقاييس الروابط لإحدى الجيران من خلال عنوانه الموسع.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تحديد (تعيين)

حدِّد أقرب وجهة لعنوان البث العشوائي (أي ابحث عن معرّف EID المحلي للشبكة وRLOC16 للوجهة).

يتم تحديد أقرب وجهة استنادًا إلى تكاليف جدول التوجيه الحالي والمسار الحالي ضمن شبكة Thread المتداخلة.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE" مفعّلة.

المعلمات

locate anycastaddr

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تحديد الموقع

يحصل على الحالة الحالية (In Progress أو Idle) لمحدِّد مواقع البث العشوائي.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

locate
In Progress
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم ملف السجلّ

تُحدِّد هذه السياسة اسم الملف لتسجيل رسائل otPlatLog() ، وهو مفيد عند تصحيح أخطاء النصوص البرمجية التجريبية المبرمَجة على نظام التشغيل Linux عند إيقاف النصوص البرمجية للاختبار الآلي.

تتطلّب الميزة OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART وOPENTHREAD_POSIX.

المعلمات

log filename filename

أمثلة

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مستوى السجلّ (محدّد)

يضبط مستوى السجلّ.

المعلمات

log level level

أمثلة

log level 4
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مستوى السجلّ

احصل على مستوى السجل.

المعلمات

ما مِن مَعلمات.

أمثلة

log level
1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة المحاولة مباشرةً (get,set) في نظام التشغيل mac

للحصول على أو تعيين عدد مرات إعادة محاولة TX المباشرة على طبقة MAC.

المعلمات

mac retries direct [number]

يمكنك استخدام الوسيطة الاختيارية number لتحديد عدد محاولات إعادة المحاولة المباشرة في TX.

أمثلة

mac retries direct
3
Done
 
mac retries direct 5
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

يعيد نظام التشغيل mac المحاولة بشكل غير مباشر (get,set)

للحصول على أو تعيين عدد مرات إعادة محاولة TX غير المباشرة على طبقة MAC.

المعلمات

mac retries indirect [number]

يمكنك استخدام الوسيطة الاختيارية number لتحديد عدد محاولات إعادة المحاولة غير المباشرة.

أمثلة

mac retries indirect
3
Done
 
 max retries indirect 5
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إرسال Mac

توجّه هذه السياسة جهاز Rx-Off-When-Idle لإرسال إطار MAC إلى الجهاز الرئيسي. هذا الأمر مخصص لشهادة الاعتماد، ولا يمكن استخدامه إلا عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

المعلمات

mac send datarequest | emptydata

يجب اختيار إحدى الوسيطتين التاليتين:

  • datarequest: أدرج رسالة طلب بيانات IEEE 802.15.4 في قائمة انتظار الإرسال.
  • emptydata: توجّه هذه السياسة الجهاز إلى إرسال إطار بيانات IEEE 802.15.4 فارغ.

أمثلة

mac send datarequest
Done
 
mac send emptydata
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة macfilter addr

لا تتوفّر إلا عندما تكون إعدادات "OPENTHREAD_CONFIG_MAC_FILTER_ENABLE" مفعَّلة.

لإضافة عنوان IEEE 802.15.4 الموسّع إلى قائمة فلتر MAC. إذا حدّدت الوسيطة rss الاختيارية، سيؤدي ذلك إلى إصلاح قوة الإشارة المُستلَمة للرسائل الواردة من العنوان. وفي حال عدم استخدام الخيار rss، سيستخدم العنوان أي قيمة تلقائية ضبطتها. وإذا لم تكن قد ضبطت الإعداد التلقائي، ستتمثل قوة الإشارة في الإشارة عبر الهواء.

المعلمات

macfilter addr add extaddr [rss]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

القائمة المسموح بها على macfilter addr

يؤدي هذا الخيار إلى تفعيل وضع فلتر MAC allowlist، ما يعني أنّه لن يُسمح بالوصول إلا لعناوين MAC في قائمة فلاتر MAC.

المعلمات

ما مِن مَعلمات.

أمثلة

macfilter addr allowlist
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محو برنامج macfilter addr

يتوفّر عندما يكون إعداد OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلاً.

يقوم هذا الأمر بمحو جميع العناوين الموسعة من قائمة فلاتر MAC.

المعلمات

ما مِن مَعلمات.

أمثلة

macfilter addr clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قائمة الحظر الخاصة بـ macfilter addr

يفعِّل هذا الإعداد وضع فلتر MAC لنظام التشغيل denylist، ما يعني أنه سيتم رفض وصول جميع عناوين MAC في قائمة فلاتر MAC.

المعلمات

ما مِن مَعلمات.

أمثلة

macfilter addr denylist
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف macfilter addr

لإيقاف أوضاع فلتر MAC.

المعلمات

ما مِن مَعلمات.

أمثلة

macfilter addr disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إضافة macfilter

يتوفّر عندما يكون إعداد OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلاً.

في ما يلي المعلومات التالية:

  • الوضع الحالي لقائمة فلاتر MAC: إما AllowList أو DenyList, أو Disabled
  • قائمة بجميع العناوين الموسّعة في الفلتر. يتم إدراج قوة الإشارة المُستلَمة (rss) ومؤشر جودة الرابط (lqi) بجانب العنوان في حال تم ضبط هذه القيم لتكون مختلفة عن القيم التلقائية.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة macfilter addr

يتوفّر عندما يكون إعداد OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلاً.

يزيل هذا الأمر العنوان الموسع المحدد من قائمة فلاتر MAC.

المعلمات

macfilter addr remove extaddr

أمثلة

macfilter addr remove 0f6127e33af6b402
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فلتر Mac

في ما يلي المعلومات التالية:

  • Address Mode: الوضع الحالي لفلتر MAC: إما AllowList أو DenyList, أو Disabled
  • قائمة بجميع العناوين الموسّعة في قائمة فلتر MAC. يتم إدراج قوة الإشارة المُستلَمة (rss) ومؤشر جودة الرابط (lqi) بجانب العنوان في حال تم ضبط هذه القيم لتكون مختلفة عن القيم التلقائية.
  • قائمة منفصلة (RssIn List) تعرض جميع العناوين الموسّعة التي تم ضبط rss فيها لتكون مختلفة عن القيمة التلقائية
  • Default rss: يعرض القيم التلقائية، إن أمكن، لإعدادات rss وlqi.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة macfilter rss

لإضافة "العنوان الموسَّع" المحدَّد إلى قائمة "RssIn" (أو تعديل عنوان حالي في قائمة "RssIn") وضبط إدخال قوة الإشارة التي تم تلقّيها (بالديسيبل) للرسائل الواردة من ذلك العنوان

المعلمات

macfilter rss add extaddr rss

لضبط قيمة تلقائية لقوة الإشارة المُستلَمة لجميع الرسائل المُستلَمة، استخدِم * للوسيطة extaddr.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة-lqi لـ macfilter rss

لإضافة "العنوان الموسَّع" المحدَّد إلى قائمة "RssIn" (أو تعديل عنوان حالي في قائمة "RssIn") وضبط مؤشر جودة الرابط الثابت للرسائل الواردة من هذا العنوان وليس بالضرورة أن يكون "العنوان الموسّع" مُدرَجًا في فلتر "address allowlist/denylist" لضبط lqi.

يتوفّر ذلك عندما تكون إعدادات "OPENTHREAD_CONFIG_MAC_FILTER_ENABLE" مفعَّلة.

المعلمات

macfilter rss add-lqi extaddr lqi

لضبط قيمة تلقائية لمؤشر جودة الرابط لجميع الرسائل المُستلَمة، استخدِم * للوسيطة extaddr. النطاق المسموح به هو 0 إلى 3.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مسح macfilter rss

يؤدي هذا الإجراء إلى محو جميع إدخالات قوة الإشارة المُستلَمة (rss) ومؤشر جودة الرابط (lqi) (بما في ذلك الإعدادات التلقائية) من قائمة "RssIn".

يعني تنفيذ هذا الإجراء أنّ جميع "العناوين الموسَّعة" ستستخدم الإشارة على الهواء.

يتوفّر عندما يكون إعداد OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلاً.

المعلمات

ما مِن مَعلمات.

أمثلة

macfilter rss clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

macfilter rss

في ما يلي المعلومات التالية:

  • قائمة بجميع العناوين الموسّعة التي تم ضبط قوة الإشارة المُستلَمة (rss) فيها على قيم مختلفة عن القيمة التلقائية ويتم أيضًا عرض مؤشر جودة الرابط (lqi). يتم ربط الإعدادَين rss وlqi ببعضهما. فإذا ضبطت إحدى القيمتَين، يتم ضبط قيمة الأخرى تلقائيًا. يُطلق على قائمة العناوين هذه اسم RssIn List. يؤدي ضبط السياسة rsi أو lqi إلى إضافة العنوان الموسّع المقابل إلى قائمة RssIn.
  • Default rss: يعرض القيم التلقائية، إن أمكن، لإعدادات rss وlqi.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة macfilter rss

يزيل "العنوان الموسع" المحدّد من قائمة "RssIn".

بعد إزالة عنوان MAC هذا من قائمة RssIn، سيستخدم بدلاً من ذلك إعدادات rss وlqi التلقائية، بافتراض أنّه تم ضبط الإعدادات التلقائية. (إذا لم يتم ضبط أي إعدادات تلقائية، سيتم استخدام الإشارة عبر البث الهوائي).

يتوفّر عندما يكون إعداد OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلاً.

لا يتم تنفيذ أي إجراء إذا لم يكن هناك إدخال حالي في قائمة RssIn يتطابق مع العنوان الموسّع المحدَّد.

المعلمات

macfilter rss remove extaddr

إذا أردت إزالة الإعدادات التلقائية لقوة الإشارة المُستلَمة ومؤشر جودة الرابط، استخدِم * على أنّها extaddr. يؤدي هذا إلى إلغاء ضبط الإعدادات التلقائية، ولكنه لا يؤدي إلى إزالة الإدخالات من قائمة RssIn.

أمثلة

macfilter rss remove *
Done
 
macfilter rss remove 0f6127e33af6b404
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

رسالة أطفال

أرسل طلب بحث إلى أحد الوالدين لاسترداد عناوين IPv6 لجميع عناصر MTD الفرعية.

المعلمات

meshdiag childip6 parent-rloc16

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جدول مشادي للسماء الطفل

ابدأ استعلامًا عن جدول فرعي للموجه باستخدام RLOC16 معين. تسرد الإخراج جميع الإدخالات الفرعية. المعلومات لكل طفل:

  • RLOC16
  • عنوان MAC الموسّع
  • إصدار سلسلة المحادثات
  • المهلة (بالثواني)
  • العمر (بالثواني منذ آخر مرة سُمع بها)
  • الفاصل الزمني للإشراف (بالثواني)
  • عدد الرسائل المنتظرة (في حال كان الطفل نائمًا)
  • وضع الجهاز
  • RSS (المتوسط والأخير)
  • معدلات الخطأ: الإطار tx (في طبقة MAC)، رسالة IPv6 tx (فوق MAC)
  • وقت الاتصال (بالثواني منذ إنشاء الرابط بالتنسيق {dd}d.{hh}:{mm}:{ss})
  • معلومات CSL:
    • إذا تمت المزامنة
    • النقطة (بوحدة وقت مكونة من 10 رموز)
    • المهلة (بالثواني)

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

شبكة توجيه متداخلة

ابدأ استعلامًا عن جدول بجوار الموجه للموجه باستخدام RLOC16 معين. يسرد الناتج جميع إدخالات جار الموجه. المعلومات عن كل إدخال:

  • RLOC16
  • عنوان MAC الموسّع
  • إصدار سلسلة المحادثات
  • خلاصة RSS (المتوسط والأخير) وهامش الرابط
  • معدلات الخطأ، إطار tx (في طبقة MAC)، رسالة tx لرسالة IPv6 (فوق MAC)
  • وقت الاتصال (بالثواني منذ إنشاء الرابط بالتنسيق {dd}d.{hh}:{mm}:{ss})

المعلمات

meshdiag routerneighbortable router-rloc16

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طوبولوجيا شبكة متداخلة

اكتشف طوبولوجيا الشبكة (قائمة بالموجهات واتصالاتها). المَعلمات اختيارية وتشير إلى عناصر إضافية يجب اكتشافها. يمكن إضافتها بأي ترتيب.

  • ip6-addrs لاكتشاف قائمة عناوين IPv6 لكل جهاز توجيه.
  • children لاكتشاف الجدول الفرعي لكل جهاز توجيه.

المعلومات لكل جهاز توجيه:

  • رقم تعريف جهاز التوجيه
  • RLOC16
  • عنوان MAC الموسّع
  • إصدار سلسلة المحادثات (إذا كان معروفًا)
  • ما إذا كان جهاز التوجيه هو هذا الجهاز نفسه (me)
  • ما إذا كان جهاز التوجيه هو أحد الوالدَين لهذا الجهاز عندما يكون جهاز طفلاً (parent)
  • ما إذا كان جهاز التوجيه هو "leader"
  • ما إذا كان جهاز التوجيه يعمل كجهاز توجيه الحدود لتوفير إمكانية الاتصال الخارجي (br)
  • قائمة بالموجهات التي لدى جهاز التوجيه هذا رابط لها:
    • 3-links: أرقام تعريف أجهزة التوجيه التي لدى جهاز التوجيه هذا رابط وارد بجودة رابط 3
    • 2-links: أرقام تعريف أجهزة التوجيه التي لدى جهاز التوجيه هذا رابط وارد بجودة الرابط 2
    • 1-links: أرقام تعريف أجهزة التوجيه التي لدى جهاز التوجيه هذا رابط وارد بجودة الرابط 1
    • وإذا كانت القائمة فارغة، سيتم حذفها.
  • إذا كانت القيمة ip6-addrs، يجب إدراج عناوين IPv6 الخاصة بجهاز التوجيه.
  • إذا كانت القيمة هي children، يجب إدراج جميع عناصر جهاز التوجيه الفرعية. المعلومات لكل طفل:
    • RLOC16
    • جودة الرابط الوارد من منظور الأصل إلى الثانوي (يشير الصفر إلى جودة غير معروفة)
    • وضع الجهاز الفرعي (r rx-on-when-idle، d جهاز مزوّد بسلسلة كاملة، n بيانات الشبكة الكاملة، - لم يتم ضبط أي علامات)
    • ما إذا كان الطفل هو هذا الجهاز نفسه (me)
    • ما إذا كان الطفل يعمل كجهاز توجيه حدودي يوفّر اتصالاً خارجيًا (br)

المعلمات

meshdiag topology [ip6-addrs] [children]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

mleadvimax

الحصول على القيمة الحالية للفاصل الزمني القصوى التي يستخدمها "موقّت نقل الإعلانات"

تتطلّب واجهة برمجة التطبيقات هذه OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE، وهي مخصّصة للاختبار فقط.

المعلمات

ما مِن مَعلمات.

أمثلة

mleadvimax
12000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

mliid

تضبط هذه السياسة معرّف IID المحلي الشبكي (لأغراض الاختبار).

يجب توفّر OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

يجب استخدامها قبل تفعيل تكديس Thread.

للاختبار/الجهاز المرجعي فقط

المعلمات

mliid iid

أمثلة

mliid 1122334455667788
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجل mlr

لتسجيل أدوات معالجة البث المتعدد كجهاز توجيه أساسي.

يجب تفعيل OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE وOPENTHREAD_CONFIG_COMMISSIONER_ENABLE.

احذف المهلة لاستخدام مهلة MLR التلقائية على جهاز التوجيه الأساسي.

يمكنك استخدام المهلة = 0 لإلغاء تسجيل أدوات استماع البث المتعدد.

المعلمات

mlr reg ipaddr [timeout]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الوضع (get,set)

اضبط إعدادات وضع ربط MLE.

المعلمات

mode [rdn]
  • -: لم يتم ضبط أي علامات (rx-off-when-idle، جهاز Thread منخفض، بيانات شبكة ثابتة)
  • r: rx-on-when-idle
  • d: جهاز سلسلة محادثات كامل
  • n: بيانات الشبكة بالكامل

أمثلة

mode rdn
Done
 
mode -
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

راديو متعدد

يمكنك الحصول على قائمة بروابط الراديو المتوافقة حسب الجهاز.

هذا الأمر متاح دائمًا، حتى إذا كان الجهاز متوافقًا مع جهاز لاسلكي واحد فقط.

المعلمات

ما مِن مَعلمات.

أمثلة

multiradio
[15.4, TREL]
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

قائمة الجيران المتعدد القنوات

يحصل على معلومات رابط الراديو المتعدد المرتبط بالجار الذي يستخدم "عنوان موسّع" محدّد.

يجب تفعيل OPENTHREAD_CONFIG_MULTI_RADIO.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جار متعدد الراديو

يحصل على معلومات رابط الراديو المتعدد المرتبط بالجار الذي يستخدم "عنوان موسّع" محدّد.

يجب تفعيل OPENTHREAD_CONFIG_MULTI_RADIO.

المعلمات

multiradio neighbor ext-address

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

nat64 (تفعيل،إيقاف)

تفعيل وظائف NAT64 أو إيقافها

عند تفعيل OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE، يؤدي ضبط السياسة على خيار "صحيح" إلى إعادة ضبط جدول الربط في أداة الترجمة.

تتوفّر هذه الميزة عند تفعيل كلّ من OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE وOPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE.

المعلمات

nat64 enable|disable

أمثلة

nat64 enable
Done
 
nat64 disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

nat64 cidr

المعلمات

ما مِن مَعلمات.

أمثلة

nat64 cidr 192.168.255.0/24
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

nat64 cidr

تعمل على تهيئة CIDR للبروتوكول IPv4 في مترجم NAT64.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

nat64 cidr
192.168.255.0/24
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدّادات nat64

يحصل على حزمة مترجم NAT64 وعدّادات الأخطاء.

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تعيينات nat64

الحصول على معلومات ربط العنوان التالية (باستخدام مكرر).

يتوفّر هذا الخيار عندما تكون ميزة "OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE" مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ولاية nat64

الحصول على حالة وظائف NAT64.

تتوفر حالة "PrefixManager" عند تفعيل "OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE". تتوفر حالة "Translator" عند تفعيل "OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE".

عند تفعيل OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE، تعرض PrefixManager إحدى الحالات التالية:

  • Disabled: تم إيقاف مدير بادئة NAT64.
  • NotRunning: تم تفعيل مدير بادئة NAT64، ولكنه لا يعمل. وقد يعني ذلك إيقاف مدير التوجيه.
  • Idle: تم تفعيل مدير بادئة NAT64 وهو قيد التشغيل، ولكنه لا ينشر بادئة NAT64. وقد يحدث ذلك عندما يكون هناك جهاز توجيه حدود آخر ينشر بادئة NAT64 ذات أولوية أعلى.
  • Active: تفعيل مدير بادئة NAT64 وتشغيله ونشر بادئة NAT64.

عند تفعيل OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE، تعرض Translator إحدى الحالات التالية:

  • Disabled: تم إيقاف مترجم NAT64.
  • NotRunning: تم تفعيل مترجم NAT64، لكنه لا يترجم حزمًا. قد يعني هذا أن المترجم لم يتم إعداده ببادئة NAT64 أو CIDR لـ NAT64.
  • Active: تم تفعيل مترجم NAT64 وهو يترجم حزم البيانات.

المعلمات

ما مِن مَعلمات.

أمثلة

nat64 state
PrefixManager: Active
Translator: Active
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قائمة أحداث الجيران

لطباعة وقت الاتصال وعمر الجيران. يشبه هذا الأمر neighbor conntime، ولكنه يعرض المعلومات بتنسيق قائمة. ويتم عرض كل من العمر ووقت الاتصال بالثواني.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

وقت الجيران

لطباعة وقت الاتصال وعمر الجيران. المعلومات لكل جار:

  • RLOC16
  • عنوان MAC الموسّع
  • آخر مرة سمعت (العمر): عدد الثواني منذ آخر مرة سمعت فيها الجار.
  • وقت الاتصال: عدد الثواني منذ إنشاء الرابط مع الجهاز المجاور. يتم تنسيق الفواصل الزمنية على أنّها {hh}:{mm}:{ss} للساعات والدقائق والثواني إذا كانت المدّة أقل من يوم واحد. إذا كانت المدة أطول من يوم واحد، يكون التنسيق هو {dd}d.{hh}:{mm}:{ss}.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جودة رابط مجاورة

تطبع معلومات جودة الرابط عن جميع المناطق المجاورة.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

قائمة الجيران

تعرض RLOC16 لكل جار.

المعلمات

ما مِن مَعلمات.

أمثلة

neighbor list
0xcc01 0xc800 0xf000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

طاولة مجاورة

تطبع معلومات في تنسيق جدول عن جميع المناطق المجاورة.

بالنسبة إلى Role، القيم الوحيدة الممكنة لهذا الجدول هي C (الفرعي) أو R (جهاز التوجيه).

تقدم الأعمدة التالية معلومات عن وضع جهاز الجيران. قيمة كل عمود هي 0 (إيقاف) أو 1 (تشغيل).

  • R: يتم تشغيل RX في حال عدم النشاط.
  • D: جهاز Thread كامل
  • N: بيانات الشبكة بالكامل

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بيانات الشبكة ممتلئة

طباعة "نعم" أو "لا" للإشارة إلى ما إذا كان "صافي البيانات ممتلئة" تم استدعاء هذه الدالة منذ بدء عملية سلسلة المحادثات أو منذ آخر مرة تم فيها استخدام netdata full reset لإعادة ضبط العلامة. يتطلّب تنفيذ هذا الأمر استخدام OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL. "صافي البيانات ممتلئة" يتم استدعاء دالة الاستدعاء في الحالات التالية:

  • ويعمل الجهاز كقائد ويتلقّى تسجيل بيانات الشبكة من جهاز توجيه الحدود (BR) الذي لا يمكن إضافته إلى بيانات الشبكة (نفدت المساحة).
  • يعمل الجهاز كـ BR ولا يمكن إضافة إدخالات جديدة إلى بيانات الشبكة المحلية.
  • يؤدي الجهاز دور BR ويحاول تسجيل إدخالات بيانات الشبكة المحلية مع المسؤول، ولكنه يقرر أن إدخالاته المحلية لن تكون مناسبة.

المعلمات

ما مِن مَعلمات.

أمثلة

netdata full
no
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط netdata بالكامل

إعادة ضبط عملية تتبُّع العلامة في حال امتلاء بيانات الشبكة تم استدعاء وظيفة معاودة الاتصال.

المعلمات

ما مِن مَعلمات.

أمثلة

netdata full reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

طول netdata

احصل على الطول الحالي (عدد وحدات البايت) لبيانات شبكة مؤشر ترابط القسم.

المعلمات

ما مِن مَعلمات.

أمثلة

netdata length
23
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الحدّ الأقصى لطول netdata

الحصول على الحد الأقصى للطول المرصود لبيانات شبكة Thread منذ إعداد حزمة الإضافة OT أو منذ آخر استدعاء إلى otNetDataResetMaxLength() .

المعلمات

ما مِن مَعلمات.

أمثلة

netdata maxlength
40
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط netdata maxlength

إعادة ضبط الحد الأقصى للطول الذي يتم تتبّعه لبيانات شبكة Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

netdata maxlength reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نشر netdata أمر dnssrp anycast

تنشر عنوان البث العشوائي لخدمة DNS/SRP برقم تسلسلي. تتم إزالة أي إدخال حالي لخدمة DNS/SRP يتم نشره من أمر publish dnssrp{anycast|unicast} سابق واستبداله بالوسيطات الجديدة.

يجب تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

المعلمات

netdata publish dnssrp anycast seq-num

أمثلة

netdata publish dnssrp anycast 1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نشر netdata عبر dnssrp unicast (إضافة، منفذ)

تنشر عنوان البث الأحادي لخدمة DNS/SRP مع عنوان ورقم منفذ. يتم تضمين معلومات العنوان والمنفذ في بيانات TLV الخاصة بالخدمة. تتم إزالة أي إدخال حالي لخدمة DNS/SRP يتم نشره من أمر publish dnssrp{anycast|unicast} سابق واستبداله بالوسيطات الجديدة.

يجب تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

المعلمات

netdata publish dnssrp unicast address port

أمثلة

netdata publish dnssrp unicast fd00::1234 51525
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

netdata Publishing dnssrp unicast (mle)

تعمل هذه السياسة على نشر معرّف EID المحلي المتداخل للجهاز باستخدام رقم منفذ. يتم تضمين معلومات MLE والمنفذ في بيانات TLV للخادم. لاستخدام عنوان Unicast مختلف، استخدِم الأمر netdata publish dnssrp unicast (addr,port).

تتم إزالة أي إدخال حالي لخدمة DNS/SRP يتم نشره من أمر publish dnssrp{anycast|unicast} سابق واستبداله بالوسيطات الجديدة.

يجب تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

المعلمات

netdata publish dnssrp unicast port

أمثلة

netdata publish dnssrp unicast 50152
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة نشر netdata

انشر إدخال بادئة على الشبكة المتداخلة. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إدارة بيانات الشبكة الإعلانية وإدارتها باستخدام OT CLI.

المعلمات

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

يستخدم OT CLI الوسيطات التي تم تعيينها لضبط قيم otBorderRouterConfig. لمزيد من المعلومات، يمكنك الاطّلاع على نظرة عامة على واجهة سطر الأوامر OpenThread.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

استبدال netdata للنشر

يحل محل إدخال مسار خارجي تم نشره سابقًا. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إدارة بيانات الشبكة الإعلانية وإدارتها باستخدام OT CLI.

المعلمات

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

يستخدم OT CLI الوسيطات التي تم ربطها لضبط قيم otExternalRouteConfig. لمزيد من المعلومات، يمكنك الاطّلاع على نظرة عامة على واجهة سطر الأوامر OpenThread.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مسار نشر netdata

نشر إدخال مسار خارجي. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إدارة بيانات الشبكة الإعلانية وإدارتها باستخدام OT CLI.

المعلمات

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

يستخدم OT CLI الوسيطات التي تم ربطها لضبط قيم otExternalRouteConfig. لمزيد من المعلومات، يمكنك الاطّلاع على نظرة عامة على واجهة سطر الأوامر OpenThread.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سجلّ netdata

سجِّل البادئات والمسارات والخدمات التي تم ضبطها لدى "القائد".

يتحقّق OT CLI من OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE. إذا تم تفعيل OTBR، فإنه يسجل بيانات الشبكة المحلية لدى المسؤول. وبخلاف ذلك، يستدعي دالة CLI دالة otServerRegister. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إدارة بيانات الشبكة الإعلانية وإدارتها باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

netdata register
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فحص netdata steeringdata (مميِّز)

تحقق مما إذا كانت بيانات التوجيه تتضمن رابطًا ذو قيمة مميزة معينة.

المعلمات

netdata steeringdata check discerner
  • discerner: معرّف الربط بالتنسيق {number}/{length}

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

netdata steeringdata Check (eui64)

تحقق مما إذا كانت بيانات التوجيه تتضمن رابطًا.

المعلمات

netdata steeringdata check eui64
  • eui64: معيار IEEE EUI-64 للرابط

أمثلة

netdata steeringdata check d45e64fa83f81cf7
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إلغاء نشر netdata (بادئة)

إلغاء نشر بادئة مسار خارجي أو على شبكة متداخلة تم نشرها مسبقًا.

يجب تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إدارة بيانات الشبكة الإعلانية وإدارتها باستخدام OT CLI.

المعلمات

netdata unpublish prefix

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إلغاء نشر netdata لنظام أسماء النطاقات

إلغاء نشر أي إدخال مُضاف سابقًا لنظام أسماء النطاقات (DNS)/SRP (Anycast أو Unicast) من بيانات شبكة Thread

يجب تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

netdata unpublish dnssrp
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

netstat

الحصول على عنوان القائمة المرتبطة بمقابس UDP.

المعلمات

ما مِن مَعلمات.

أمثلة

netstat
| Local Address                                   | Peer Address                                    |
+-------------------------------------------------+-------------------------------------------------+
| [0:0:0:0:0:0:0:0]:49153                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:49152                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:61631                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:19788                         | [0:0:0:0:0:0:0:0]:0                             |
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الحصول على تشخيص الشبكة

إرسال طلب تشخيص شبكة لاسترداد قيم طول النوع (TLV) المحددة للعناوين المحددة.

المعلمات

networkdiagnostic get addr type(s)

بالنسبة إلى addr، يؤدي عنوان البث الأحادي إلى تشغيل Diagnostic Get. يؤدي عنوان البث المتعدد إلى تشغيل Diagnostic Query. قيم TLV التي يمكنك تحديدها (مفصولة بمسافة في حال تحديد أكثر من ملف TLV واحد):

  • 0: عنوان MAC الموسّع TLV
  • 1: العنوان16 TLV
  • 2: الوضع TLV
  • 3: المهلة TLV (الحد الأقصى لفترة زمنية لاستطلاع آراء العملاء المحتملين)
  • 4: TLV للاتصال
  • 5: Route64 TLV
  • 6: Lead Data TLV
  • 7: ملف TLV لبيانات الشبكة
  • 8: قائمة عناوين IPv6
  • 9: عدّادات MAC TLV
  • 14: TLV لمستوى البطارية
  • 15: TLV لجهد الإمداد
  • 16: Child Table TLV
  • 17: الملف TLV لصفحات القناة
  • 19: الحد الأقصى لمهلة طفل TLV
  • 23: EUI64 TLV
  • 24: الإصدار TLV (رقم الإصدار للبروتوكولات والميزات)
  • 25: اسم المورّد TLV
  • 26: نموذج TLV للمورّد
  • 27: نسخة SW للمورّد TLV
  • 28: إصدار حزمة Thread TLV (معرّف الإصدار كسلسلة UTF-8 لحزمة Thread stackbase/commit/version)
  • 29: TLV للأطفال
  • 34: عدّادات MLE TLV
  • 35: ملف TLV لعنوان URL لتطبيق المورّد

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط بيانات تشخيص الشبكة

إرسال طلب تشخيص للشبكة لإعادة ضبط قيم طول النوع (TLV) المحدَّدة على العناوين المحدَّدة يتيح هذا الأمر استخدام قيم TLV التالية فقط: 9 (عدّادات MAC TLV) أو 34 (MLE العدات TLV).

المعلمات

networkdiagnostic reset addr type(s)

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Networkidtimeout (get,set)

تحصل على مَعلمة NETWORK_ID_TIMEOUT أو تضبطها.

المعلمات

networkidtimeout [timeout]

يمكنك استخدام الوسيطة الاختيارية timeout لضبط قيمة المعلَمة NETWORK_ID_TIMEOUT.

أمثلة

networkidtimeout 120
Done
 
networkidtimeout
120
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مفتاح الشبكة (مفتاح)

اضبط مفتاح شبكة Thread.

لا يمكن تنفيذ هذا الإجراء إلا عند إيقاف بروتوكولات سلسلة المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة إلى إلغاء صلاحية مجموعات البيانات التشغيلية النشطة والمعلَّقة في الذاكرة غير المتطايرة.

المعلمات

networkkey key

أمثلة

networkkey 00112233445566778899aabbccddeeff
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مفتاح الشبكة

احصل على مفتاح شبكة Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

networkkey
00112233445566778899aabbccddeeff
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم الشبكة (الاسم)

اضبط اسم شبكة Thread.

لا يمكن تنفيذ هذا الإجراء إلا عند إيقاف بروتوكولات سلسلة المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة إلى إلغاء صلاحية مجموعات البيانات التشغيلية النشطة والمعلَّقة في الذاكرة غير المتطايرة.

المعلمات

networkname name

أمثلة

networkname OpenThread
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم الشبكة

الحصول على اسم شبكة Thread

المعلمات

ما مِن مَعلمات.

أمثلة

networkname
OpenThread
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

وقت الشبكة (ضبط)

تحدِّد مَعلمات مزامنة الوقت.

  • timesyncperiod: فترة المزامنة بالثواني
  • xtalthreshold: الحد الأدنى لدقة XTAL للجهاز لكي يصبح جهازًا متوافقًا مع جهاز التوجيه، في جزء من لكل ألف ظهور.

المعلمات

networktime timesyncperiod xtalthreshold

أمثلة

networktime 100 300
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مدة الشبكة

يحصل على وقت شبكة Thread ومعلَمات مزامنة الوقت.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Nexthop (get)

يحصل على تكلفة القفزة والمسار التالية للوصول إلى وجهة RLOC16 معيّنة.

يمكن استخدام القيمة "aNextHopRloc16" أو "aPathCost" مع ضبط قيمة "NULL" (فارغ) للإشارة إلى أنّ المتصل لا يريد الحصول على القيمة.

المعلمات

nexthop rloc16

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

nexthop

جدول مخرجات معرّفات أجهزة التوجيه المخصصة وتكلفة القفزة التالية والمسار الحالية لكل موجه

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

panid (panid)

عليك ضبط رقم تعريف رقم PAN في IEEE 802.15.4.

لا يمكن تنفيذ هذا الإجراء إلا عند إيقاف بروتوكولات سلسلة المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة أيضًا إلى إلغاء صلاحية مجموعات البيانات التشغيلية النشطة والمعلَّقة في الذاكرة غير المتطايرة.

المعلمات

panid panid

أمثلة

panid 0xdead
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بانيد

احصل على رقم تعريف رقم PAN وفقًا لمعيار IEEE 802.15.4.

المعلمات

ما مِن مَعلمات.

أمثلة

panid
0xdead
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عنصر رئيسي

يمكنك الاطّلاع على معلومات التشخيص الخاصة بجهاز توجيه Thread باعتباره أحد الوالدَين.

عند تشغيل هذا الأمر كجهاز توجيه Thread عند تفعيل OPENFALSE_CONFIG_REFERENCE_DEVICE_ENABLE، سيعرض هذا الأمر المعلومات المخزّنة مؤقتًا من وقت ربط الجهاز سابقًا على أنّه تابع لسلسلة المحادثات. من الضروري عرض المعلومات المخزّنة مؤقتًا لإتاحة استخدام مفعِّل اختبار سلسلة التعليمات - يطلب السيناريو 8.2.x عنوان MAC الرئيسي السابق (أي جهاز توجيه أداة الربط) حتى إذا تمت ترقية الجهاز من قبل إلى جهاز توجيه.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بدء عملية بحث الطفل عن والد أفضل مع الحفاظ على الارتباط بالوالد الحالي

يجب استخدامه عند توصيل الجهاز عندما يكون طفلاً.

المعلمات

ما مِن مَعلمات.

أمثلة

parent search
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الأصل (get,set)

تحصل على قيمة الأولوية الرئيسية المعيّنة أو تضبطها: 1 أو 0 أو -1 أو -2. -2 تعني أنّه لم يتم تعيينه.

المعلمات

parentpriority [parentpriority]

أمثلة

parentpriority
1
Done
 
parentpriority 1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

partitionid

احصل على رقم تعريف قسم شبكة Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

partitionid
4294967295
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

معرِّف التقسيم المفضَّل (get,set)

يجب ملء الحقل "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE".

المعلمات

partitionid preferred partitionid

أمثلة

partitionid preferred
4294967295
Done
 
partitionid preferred 0xffffffff
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

platform

طباعة النظام الأساسي الحالي

المعلمات

ما مِن مَعلمات.

أمثلة

platform
NRF52840
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

فترة الاستطلاع (get,set)

يمكنك الحصول على أو ضبط فترة استطلاع البيانات المخصّصة للجهاز النهائي النائم (بالمللي ثانية). لاختبارات الشهادة فقط

المعلمات

ما مِن مَعلمات.

أمثلة

pollperiod
0
Done
 
pollperiod 10
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تفضيل الملف الشخصي

تحدد معرف الموجه المفضل الذي يجب أن يقدمه المسؤول عند الطلب.

المعلمات

preferrouterid routerid

أمثلة

preferrouterid 16
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة البادئة

تضيف بادئة صالحة إلى بيانات الشبكة.

المعلمات

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

يستخدم OT CLI الوسيطات التي تم تعيينها لضبط قيم otBorderRouterConfig. لمزيد من المعلومات، يمكنك الاطّلاع على نظرة عامة على واجهة سطر الأوامر OpenThread.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بادئة Meshlocal

احصل على بادئة الشبكة المتداخلة المحلية.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

بادئة

يمكنك الحصول على قائمة البادئات في صفحة "بيانات الشبكة المحلية".

لمزيد من المعلومات عن علامات otBorderRouterConfig، يمكنك الاطّلاع على مقالة نظرة عامة على واجهة سطر الأوامر OpenThread.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة البادئة

إزالة إعداد جهاز توجيه الحدود من بيانات الشبكة المحلية.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مختلط (enable,disable)

لتمكين أو تعطيل الوضع المختلط لطبقة الروابط.

المعلمات

promiscuous enable|disable

أمثلة

promiscuous enable
Done
 
promiscuous disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مختلط

يشير إلى ما إذا كان الوضع المختلط مفعّلاً في طبقة الرابط أم لا.

المعلمات

ما مِن مَعلمات.

أمثلة

promiscuous
Disabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

pskc (تعيين)

لضبط pskc بتنسيق سداسي عشري.

المعلمات

pskc key

أمثلة

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

pskc -p

تنشئ هذه الدالة pskc من عبارة المرور (بترميز UTF-8)، مع اسم الشبكة الحالي ورقم تعريف PAN الموسّع.

المعلمات

pskc -p passphrase

أمثلة

pskc -p 123456
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

pskc

احصل على Thread PSKc.

المعلمات

ما مِن مَعلمات.

أمثلة

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

pskcref (تعيين)

اضبط مرجع المفتاح على Thread PSKc.

يتطلب هذا الإعداد تفعيل ميزة وقت الإصدار OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

لن تنجح هذه العملية إلا عند إيقاف بروتوكولات سلسلة المحادثات. عند نجاح الإجراء، سيؤدي ذلك أيضًا إلى إيقاف مجموعات البيانات التشغيلية النشطة والمُعلَّقة في الذاكرة غير المتطايرة.

المعلمات

pskc keyref

أمثلة

pskc 0x20017
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

pskcref

الحصول على مرجع رئيسي لـ Thread PSKc مخزّن

يتطلب هذا الإعداد تفعيل ميزة وقت الإصدار OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

pskcref
0x80000000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

راديو (تفعيل،إيقاف)

لتفعيل الراديو أو إيقافه.

المعلمات

radio enable|disable

أمثلة

radio enable
Done
 
radio disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إحصاءات الراديو واضحة

إعادة ضبط إحصاءات الراديو.

وتتم إعادة ضبط جميع الأوقات على 0.

المعلمات

ما مِن مَعلمات.

أمثلة

radio stats clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إحصاءات الراديو

الحصول على إحصاءات الراديو

تشمل إحصاءات الراديو الوقت الذي يكون فيه الراديو في وضع TX/RX/النوم. وتكون هذه الأوقات بوحدات الميكرو ثانية. يتم حساب جميع الأوقات من آخر إعادة ضبط لإحصاءات الراديو.

المعلمات

ما مِن مَعلمات.

أمثلة

radio stats
Radio Statistics:
Total Time: 67.756s
Tx Time: 0.022944s (0.03%)
Rx Time: 1.482353s (2.18%)
Sleep Time: 66.251128s (97.77%)
Disabled Time: 0.000080s (0.00%)
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إصدار Rcp

الحصول على سلسلة إصدار الراديو

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

المنطقة (مجموعة)

لضبط رمز المنطقة.

تنسيق منطقة الراديو هو تمثيل 2 بايت لرمز Ascii لرمز ISO 3166 alpha-2.

يمكن أن يؤثر تغيير ذلك على حد طاقة الإرسال.

المعلمات

ما مِن مَعلمات.

أمثلة

region US
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

المنطقة

احصل على رمز المنطقة.

تنسيق منطقة الراديو هو تمثيل 2 بايت لرمز Ascii لرمز ISO 3166 alpha-2.

المعلمات

ما مِن مَعلمات.

أمثلة

region
US
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Releaserouterid (المسارات)

يمكنك إلغاء "رقم تعريف جهاز توجيه" تم تخصيصه من خلال الجهاز في دور "القائد".

المعلمات

releaserouterid [routerid]

أمثلة

releaserouterid 16
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

rloc16

الحصول على RLOC16

المعلمات

ما مِن مَعلمات.

أمثلة

rloc16
0xdead
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة مسار

بالنسبة إلى المَعلمات، استخدِم:

  • s: علامة ثابتة
  • n: علامة NAT64
  • prf: تفضيل جهاز التوجيه التلقائي، [مرتفع، متوسط، منخفض].

أضِف مسارًا خارجيًا صالحًا إلى بيانات الشبكة.

المعلمات

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

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة مسار

إزالة إعداد مسار خارجي من بيانات الشبكة المحلية

المعلمات

route remove [prefix]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مسار

يمكنك الحصول على قائمة المسارات الخارجية في بيانات الشبكة المحلية.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جهاز التوجيه (id)

تحتفظ الدالة بمعلومات التشخيص لجهاز توجيه Thread معيّن.

طباعة معلومات التشخيص الخاصة بجهاز توجيه Thread. قد يكون المعرّف عبارة عن معرّف جهاز توجيه أو RLOC16.

المعلمات

router [id]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

قائمة أجهزة التوجيه

أدرِج معرّفات أجهزة التوجيه المخصّصة.

المعلمات

ما مِن مَعلمات.

أمثلة

router list
8 24 50
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جدول الموجه

تطبع قائمة بالموجهات بتنسيق جدول.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Routedowngradthreshold (get,set)

للحصول على قيمة ROUTER_DOWNRATE_وانتحددها أو تضبطها.

المعلمات

routerdowngradethreshold [threshold]

أمثلة

 routerdowngradethreshold
23
Done
 
 routerdowngradethreshold 23
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

موجه مطلوب (تمكين،تعطيل)

تتيح هذه السياسة تفعيل دور جهاز التوجيه أو إيقافه.

المعلمات

routereligible [enable|disable]

أمثلة

routereligible enable
Done
 
routereligible disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

جهاز التوجيه مؤهل

يشير إلى ما إذا كان دور جهاز التوجيه مفعَّلاً أو موقوفًا.

المعلمات

ما مِن مَعلمات.

أمثلة

routereligible
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

routerselectionjitter

يحصل على أو يضبط قيمة ROUTER_SEARCH_JITTER.

المعلمات

routerselectionjitter [jitter]

أمثلة

routerselectionjitter
120
Done
 
routerselectionjitter 120
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Routeupgradethreshold (get,set)

للحصول على قيمة ROUTER_UPدر_LIMIT أو ضبطها.

المعلمات

routerupgradethreshold [threshold]

أمثلة

routerupgradethreshold
16
Done
 
routerupgradethreshold 16
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طاقة المسح الضوئي

يجري فحص الطاقة IEEE 802.15.4، مع عرض الوقت بالملي ثانية لاستخدامه في فحص كل قناة. يتم عرض جميع القنوات إلا إذا حددت قناة معينة باستخدام خيار القناة.

المعلمات

scan energy [duration] [channel]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فحص

يجري فحص IEEE 802.15.4 نشطًا. يشمل البحث جميع القنوات في حال عدم تحديد أي قناة. وإلا فإن الامتداد يغطي القناة المحددة فقط.

المعلمات

scan [channel]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة خدمة

تضيف الخدمة إلى بيانات الشبكة.

  • enterpriseNumber: رقم المؤسسة الصادر عن هيئة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)
  • serviceData: بيانات الخدمة الثنائية بترميز سداسي
  • serverData: بيانات الخادم الثنائي بترميز سداسي (تكون فارغة إذا لم يتم توفيرها)

المعلمات

service add enterpriseNumber serviceData [serverData]

أمثلة

service add 44970 112233 aabbcc
Done
 
netdata register
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة الخدمة

إزالة الخدمة من بيانات الشبكة.

  • enterpriseNumber: رقم المؤسسة الصادر عن هيئة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)
  • serviceData: بيانات الخدمة الثنائية بترميز سداسي

المعلمات

service remove enterpriseNumber serviceData

أمثلة

service remove 44970 112233
Done
 
netdata register
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سينغلتون

يشير إلى ما إذا كانت العقدة هي الموجه الوحيد على الشبكة. تعرض إما true أو false.

المعلمات

ما مِن مَعلمات.

أمثلة

singleton
true
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

طلب بحث sntp

لإرسال طلب SNTP للحصول على وقت حقبة يونكس الحالي (من 1 يناير 1970).

  • عنوان IP التلقائي لخادم SNTP: 2001:4860:4806:8:: (خادم Google IPv6 NTP)
  • المنفذ التلقائي لخادم SNTP: 123

المعلمات

sntp query [SNTP server IP] [SNTP server port]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

البدء التلقائي لعميل srp (الحصول على)

يشير إلى الحالة الحالية لوضع البدء التلقائي (مفعَّل أو غير مفعَّل). لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client autostart
Disabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف التشغيل التلقائي لعميل srp

لإيقاف وضع البدء التلقائي.

لا يؤدي إيقاف وضع البدء التلقائي إلى إيقاف البرنامج قيد التشغيل. مع ذلك، يتوقف برنامج SRP عن مراقبة بيانات شبكة Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client autostart disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تفعيل التشغيل التلقائي لعميل بروتوكول النقل الآمن للملفات (srp)

لتفعيل وضع البدء التلقائي.

عند تفعيل التشغيل التلقائي، يراقب عميل SRP بيانات شبكة Thread لاكتشاف خوادم SRP، ويختار الخادم المفضل ولتشغيل البرنامج وإيقافه تلقائيًا عند اكتشاف خادم SRP.

تشير ثلاث فئات من إدخالات بيانات الشبكة إلى وجود خادم SRP، ويتم تفضيلها بالترتيب التالي:

  1. إدخالات البث الأحادي التي يتم فيها تضمين عنوان الخادم في بيانات الخدمة وإذا كانت هناك خيارات متعددة، يُفضَّل استخدام الخيار الأقل عنوان IPv6 رقمي.
  2. إدخالات البث العشوائي التي يحتوي كل منها على رقم تسلسل. يُفضَّل استخدام أكبر رقم تسلسلي على النحو المحدَّد بواسطة المنطق الحسابي للأرقام التسلسلية في RFC-1982.
  3. إدخالات البث الأحادي التي يتم فيها تضمين معلومات عنوان الخادم مع بيانات الخادم وإذا كانت هناك خيارات متعددة، يُفضَّل استخدام الخيار الأقل عنوان IPv6 رقمي.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client autostart enable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

معاودة الاتصال بعميل srp (الحصول على، التفعيل،الإيقاف)

الحصول على أحداث معاودة الاتصال أو تفعيلها أو إيقافها من برنامج SRP. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp client callback [enable|disable]

أمثلة

srp client callback enable
Done
 
srp client callback
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عنوان مضيف عميل srp (الحصول على)

يشير إلى ما إذا كان وضع العنوان التلقائي مفعَّلاً. إذا لم يتم تفعيل وضع العنوان التلقائي، سيتم عرض قائمة بعناوين مضيف عميل SRP. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عنوان مضيف عميل srp (تم الضبط)

يمكنك تفعيل وضع عنوان المضيف التلقائي أو إعداد قائمة عناوين المضيف بشكل صريح. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp client host address [auto|address...]
  • استخدم المعلمة auto لتفعيل وضع عنوان المضيف التلقائي. عند تفعيل هذا الإعداد، يستخدم البرنامج تلقائيًا جميع عناوين البث الأحادي المفضّلة لنظام Thread netif باستثناء عناوين الروابط المحلية وعناوين الشبكة المحلية المتداخلة. في حال عدم توفّر عنوان صالح، تتم إضافة عنوان معرّف EID المحلي للشبكة المتداخلة. يعيد برنامج SRP تلقائيًا التسجيل في حال إضافة عناوين على سلسلة المحادثات netif أو إزالتها أو وضع علامة عليها على أنّها غير مفضَّلة.
  • تحديد قائمة عناوين المضيف بوضوح، وفصل كل عنوان بمسافة. يمكنك إعداد هذه القائمة أثناء تشغيل البرنامج. سيؤدي هذا أيضًا إلى إيقاف وضع عنوان المضيف التلقائي.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محو مضيف عميل srp

يؤدي هذا الإجراء إلى محو جميع معلومات المضيف وجميع الخدمات.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client host clear
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم مضيف عميل srp (get,set)

يحصل على أو يضبط اسم المضيف لعميل SRP. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp client host name [name]

لضبط اسم مضيف العميل عندما يكون المضيف قد تمت إزالته أو لم يتم تسجيله بعد في الخادم، استخدِم المَعلمة name.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة مضيف عميل srp

يزيل معلومات مضيف عميل SRP وجميع الخدمات من خادم SRP. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp client host remove [removekeylease] [sendunregtoserver]
  • المَعلمة removekeylease هي قيمة منطقية اختيارية تشير إلى ما إذا كان يجب أيضًا إزالة مفتاح المضيف من مفتاح المضيف (القيمة التلقائية هي false).
  • المَعلمة sendunregtoserver هي قيمة منطقية اختيارية تشير إلى ما إذا كان يجب على مضيف العميل إرسال تحديث. إلى الخادم حتى إذا لم يتم تسجيل معلومات مضيف العميل في الخادم بعد (الإعداد الافتراضي هو false). لا يمكن تحديد هذه المَعلمة إلا إذا تم تحديد المَعلمة removekeylease أولاً في الأمر.

أمثلة

srp client host remove 1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مضيف عميل srp

الحصول على معلومات المضيف

المعلمات

ما مِن مَعلمات.

أمثلة

srp client host
name:"dev4312", state:Registered, addrs:[fd00:0:0:0:0:0:0:1234, fd00:0:0:0:0:0:0:beef]
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حالة مضيف عميل srp

تعرض حالة مضيف عميل SRP. الحالات المحتملة:

  • ToAdd: العنصر الذي ستتم إضافته أو تسجيله
  • Adding: تتم إضافة العنصر أو تسجيله.
  • ToRefresh: السلعة التي ستتم إعادة تحميلها بهدف تجديد الإيجار
  • Refreshing: العنصر باللون البيج الجديد
  • ToRemove: العنصر الذي ستتم إزالته
  • Removing: تتم الآن إزالة العنصر.
  • Registered: تم تسجيل العنصر في الخادم.
  • Removed: تمت إزالة العنصر.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client host state
Registered
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

srp العميل keyleaseinterval (get,set)

تتيح هذه الطريقة الحصول على فاصل الإيجار الرئيسي أو ضبطه بالثواني.

المعلمات

srp client keyleaseinterval [interval]

أمثلة

srp client keyleaseinterval 864000
Done
 
srp client keyleaseinterval
864000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

srp client leaseinterval (get,set)

يحصل على أو يضبط الفاصل الزمني للإيجار بالثواني.

المعلمات

srp client leaseinterval [interval]

أمثلة

srp client leaseinterval 3600
Done
 
srp client leaseinterval
3600
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عنوان خادم عميل بروتوكول النقل الآمن للملفات (SFTP)

تعرض عنوان IPv6 للخادم.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

منفذ خادم عميل srp

تعرض رقم منفذ الخادم.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client server port
4724
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

خادم عميل بروتوكول النقل الآمن للملفات (SFTP)

يحصل على عنوان المقبس (عنوان IPv6 ورقم المنفذ) لخادم SRP الذي يستخدمه عميل SRP. إذا لم يكن العميل قيد التشغيل، فسيكون العنوان غير محدد (جميع الأصفار) برقم منفذ 0. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة خدمة عملاء srp

لإضافة خدمة باسم مثيل معيّن واسم خدمة ورقم منفذ لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

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

يمكن أن تتضمّن المَعلمة servicename اختياريًا قائمة بتصنيفات الأنواع الفرعية للخدمة مفصولة بفواصل. تستخدم الأمثلة هنا التسمية العامة. إنّ المَعلمتَين priority وweight (كلاهما قيمتان uint16_t) اختياريتان، ويتم استخدام القيمة صفر في حال عدم إدخالهما. تحدّد مَعلمة txt الاختيارية بيانات TXT المرتبطة بالخدمة. يجب أن تكون قيمة txt بتنسيق السلسلة الست عشرية وأن يتم التعامل معها على أنّها تسلسل بايت بيانات TXT مرمّز مسبقًا.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مفتاح خدمة عميل srp (get,set)

يحصل هذا الإعداد على وضع تضمين سجلّ مفتاح الخدمة أو يضبطه في برنامج SRP. هذا الأمر مخصّص للاختبار فقط، ويتطلّب تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

محو اسم خدمة عملاء srp

يؤدي هذا الإجراء إلى محو إحدى الخدمات وإزالتها على الفور من قائمة خدمات العملاء بدون تفاعل مع خادم SRP.

المعلمات

srp client service clear instancename servicename

أمثلة

srp client service clear ins2 _test2._udp
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة من خدمة عملاء srp

تطلب إلغاء تسجيل خدمة في خادم SRP.

المعلمات

srp client service remove instancename servicename

أمثلة

srp client service remove ins2 _test2._udp
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

خدمة عملاء srp

الحصول على قائمة الخدمات التي يديرها العميل.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client service
instance:"ins2", name:"_test2._udp,_sub1,_sub2", state:Registered, port:111, priority:1, weight:1
instance:"ins1", name:"_test1._udp", state:Registered, port:777, priority:0, weight:0
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بداية عميل srp

يؤدي هذا الخيار إلى بدء عملية عميل SRP. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp client start serveraddr serverport

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حالة عميل srp

يشير إلى ما إذا كان عميل SRP قيد التشغيل أم لا.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client state
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نقطة توقّف عميل بروتوكول srp

إيقاف عملية عميل SRP.

إيقاف أي تفاعلات أخرى مع خادم SRP. يُرجى العِلم أنّ هذا الإجراء لا يؤدي إلى إزالة أو محو معلومات المضيف و/أو قائمة الخدمات. وهو يميّز جميع الخدمات التي ستتم إضافتها/إزالتها مرة أخرى بمجرد بدء العميل.

المعلمات

ما مِن مَعلمات.

أمثلة

srp client stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

srp client ttl (get,set)

يحصل على أو يضبط قيمة ttl(وقت بدء البث) بالثواني.

المعلمات

srp client ttl [value]

أمثلة

srp client ttl 3600
Done
 
srp client ttl
3600
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

خادم srp (تفعيل،إيقاف)

تفعيل خادم SRP أو إيقافه. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp server [enable|disable]

أمثلة

srp server disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

srp Server addrmode (get,set)

يحصل هذا الإعداد على وضع العنوان الذي يستخدمه خادم SRP أو يضبطه.

يقوم وضع العنوان بإخبار خادم SRP بكيفية تحديد عنوانه ورقم المنفذ، والذي يتم نشره بعد ذلك في بيانات شبكة Thread.

المعلمات

srp server addrmode [anycast|unicast]

أمثلة

srp server addrmode anycast
Done
 
srp server addrmode
anycast
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

خادم srp تلقائي (تفعيل،إيقاف)

تتيح هذه السياسة تفعيل وضع التفعيل التلقائي على خادم SRP أو إيقافه.

عند تفعيل هذا الوضع، يتحكّم مدير التوجيه الحدودي في إمكانية تفعيل خادم SRP أو إيقافه ووقته.

يتطلّب تنفيذ هذا الأمر تفعيل "OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE". لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

srp server auto [enable|disable]

أمثلة

srp server auto enable
Done
 
srp server auto
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نطاق خادم srp (get,set)

يحصل على أو يضبط اسم النطاق لخادم SRP.

المعلمات

srp server domain [domain-name]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مضيف خادم بروتوكول النقل الآمن للملفات (SFTP)

عرض معلومات عن جميع المضيفين المسجّلين لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تأجير خادم srp (get,set)

يحصل على أو يضبط قيم تأجير خادم SRP بعدد الثواني.

المعلمات

srp server lease [min-lease max-lease min-key-lease max-key-lease]

أمثلة

srp server lease 1800 7200 86400 1209600
Done
 
srp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

سلسلة خادم srp (get,set)

تحصل على رقم التسلسل المستخدَم مع وضع عنوان anycast أو يضبطه. يتم تضمين رقم التسلسل في "عنوان البث العشوائي لخدمة DNS/SRP" الذي تم نشره في بيانات الشبكة.

المعلمات

srp server seqnum [seqnum]

أمثلة

srp server seqnum 20
Done
 
srp server seqnum
20
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

خادم بروتوكول النقل الآمن للملفات (SFTP)

إرجاع معلومات عن الخدمات المسجّلة

يتم عرض سجلّ TXT كمصفوفة من الإدخالات. إذا كان أحد الإدخالات يحتوي على مفتاح، تتم طباعة المفتاح بتنسيق ASCII. تتم طباعة جزء القيمة بوحدات بايت سداسية عشرية. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

حالة خادم srp

تعرض إحدى الحالات المحتملة التالية لخادم SRP:

  • disabled: خادم SRP غير مفعَّل.
  • stopped: خادم SRP مفعَّل ولكنه غير نشط بسبب خوادم SRP الحالية النشطة في شبكة Thread. قد يصبح خادم SRP نشطًا عندما لا تعود خوادم SRP الحالية نشطة في شبكة Thread.
  • running: خادم SRP نشط ويمكنه معالجة عمليات تسجيل الخدمة.

لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد الاتصال بالخادم للعميل باستخدام بروتوكول تسجيل الخدمة (SRP) باستخدام OT CLI.

المعلمات

ما مِن مَعلمات.

أمثلة

srp server state
running
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الولاية

يعرض الدور الحالي لجهاز Thread أو يغيّر الدور كما هو محدّد في أحد الخيارات. يتم عرض القيم المحتملة عند الاستعلام عن دور الجهاز:

  • child: يعمل الجهاز حاليًا كتطبيق Thread فرعي.
  • router: الجهاز يعمل حاليًا كجهاز توجيه Thread.
  • leader: يعمل الجهاز حاليًا كقائد سلسلة محادثات.
  • detached: الجهاز غير متصل حاليًا بشبكة أو قسم Thread.
  • disabled: حزمة سلسلة المحادثات غير مفعّلة حاليًا.

يتيح لك استخدام أحد الخيارات تغيير الدور الحالي للجهاز، مع استبعاد التغيير من أو إلى حالة disabled.

المعلمات

state [child|router|leader|detached]

أمثلة

state
child
Done
 
state leader
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إلغاء tcp

يتم إنهاء اتصال TCP المرتبط بنقطة نهاية TCP بشكل غير مقصود، مما يؤدي إلى تحويل نقطة نهاية TCP إلى الحالة المغلقة.

المعلمات

ما مِن مَعلمات.

أمثلة

tcp abort
TCP: Connection reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نتيجة مقياس الأداء في tcp

تعرض أحدث نتيجة لاختبار معيار TCP. قيم الحالة المحتملة:

  • مستمر
  • مباريات مكتملة
  • لم يتم اختبارها

الهدف الأساسي من هذا الأمر هو إنشاء نصوص برمجية تعمل على أتمتة اختبار معيار TCP.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

تشغيل مقياس الأداء في tcp

لنقل عدد وحدات البايت المحدد باستخدام اتصال TCP المرتبط حاليًا بمثال نقطة نهاية TCP الذي يوفره واجهة سطر الأوامر tcp.

المعلمات

tcp benchmark run [size]

استخدِم المَعلمة size لتحديد عدد وحدات البايت المطلوب إرسالها لمقياس الأداء. إذا لم تكن تستخدم المَعلمة size، يتم استخدام القيمة التلقائية (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE).

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

ربط tcp

يربط عنوان IPv6 ومنفذًا بمثال نقطة نهاية TCP الذي يوفره واجهة سطر الأوامر tcp. يشار إلى ربط نقطة نهاية TCP بعنوان IPv6 والمنفذ باسم "تسمية نقطة نهاية TCP". يؤدي هذا إلى ربط نقطة النهاية للاتصال. لمزيد من المعلومات، يمكنك الاطّلاع على اختبار وظائف TCP باستخدام OT CLI.

المعلمات

tcp bind ip port
  • ip: عنوان IPv6 المطلوب الربط به. إذا كنت تريد أن تخصص حزمة TCP/IPv6 لعنوان IPv6 الربط، استخدم عنوان IPv6 غير المحدد: ::.
  • port: رقم منفذ TCP المطلوب الربط به.

أمثلة

tcp bind :: 30000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ربط Tcp

إقامة اتصال مع النظير المحدد.

إذا كان إنشاء الاتصال ناجحًا، فسيتم ربط اتصال TCP الناتج بنموذج نقطة نهاية TCP. لمزيد من المعلومات، يمكنك الاطّلاع على اختبار وظائف TCP باستخدام OT CLI.

المعلمات

tcp connect ip port [fastopen]
  • ip: عنوان IP للنظير يمكن أن يكون العنوان هو عنوان IPv4، والذي يتم تجميعه إلى عنوان IPv6 باستخدام بادئة NAT64 المفضّلة من بيانات الشبكة. يعرض الأمر InvalidState عندما تكون بادئة NAT64 المفضّلة غير متاحة.
  • port: رقم منفذ TCP للنظير
  • fastopen: هذه المَعلمة اختيارية. في حال ضبط السياسة على fast، سيتم تفعيل ميزة TCP Fast Open (الفتح السريع في TCP) لهذا الاتصال. بخلاف ذلك، إذا تم ضبط هذه المَعلمة على slow أو لم يتم استخدامها، سيتم إيقاف TCP Fast Open.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

Tcp deinit

لإيقاف نقطة نهاية TCP هذه.

وهذا يعني أن OpenThread لم يعد يتتبع نقطة نهاية TCP هذه ويوزّع جميع الموارد التي خصصتها داخليًا لنقطة نهاية TCP هذه. يمكن للتطبيق إعادة استخدام الذاكرة التي تدعم نقطة نهاية TCP على النحو الذي تراه مناسبًا.

إذا كان الاتصال يتجاوب مع اتصال TCP مباشر، يتم إنهاء الاتصال بشكل غير مقصود (كما في otTcpAbort()). يتم على الفور إرجاع جميع الموارد التي وفرها التطبيق لنقطة نهاية TCP هذه (المخزن المؤقت المرتبط للمخزن المؤقت للإرسال والذاكرة للمخزن المؤقت للاستلام وبنية aEndpoint نفسها، وما إلى ذلك) على الفور.

المعلمات

ما مِن مَعلمات.

أمثلة

tcp deinit
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

tcp init

تجري هذه السياسة إعداد نموذج مستمع TCP ومثال نقطة نهاية TCP الذي يوفّره واجهة سطر الأوامر tcp.

المعلمات

tcp init [mode] [size]
  • هناك ثلاث قيم محتملة للسمة mode:
    • tls: يحدد أن اتصال TCP بين نقطتين يجب أن يستخدم أيضًا بروتوكول TLS في أعلى بروتوكول TCP. عندما تتصل عقدتان عبر بروتوكول TCP، يجب أن تستخدم كلتا النقطتين بروتوكول أمان طبقة النقل (TLS) أو يجب ألا تستخدم أي من العُقدتين بروتوكول أمان طبقة النقل (TLS) لأن نقطة النهاية التي لا تستخدم بروتوكول أمان طبقة النقل لا يمكنها الاتصال بنقطة نهاية بروتوكول أمان طبقة النقل.
    • linked أو circular: يعني أحد هذين الخيارين أنه لن يتم استخدام بروتوكول أمان طبقة النقل (TLS)، وأنه يجب استخدام نوع المخزن المؤقت المحدد للتخزين المؤقت لبروتوكول TCP. سلوك linked وcircular متطابق. افحص التعليمات البرمجية لمعرفة الاختلافات بين هذين النوعين من التخزين المؤقت. لا يلزم استخدام نقطتَي نهاية لاتصال TCP لاستخدام نفس نوع التخزين المؤقت.
  • تضبط المَعلمة size حجم المخزن المؤقت للاستلام المراد ربطه بنموذج نقطة نهاية TCP. إذا لم يتم تحديد قيمة، يتم استخدام الحد الأقصى للحجم. تم ضبط الحد الأقصى للحجم في OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE.

أمثلة

tcp init tls
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الاستماع في tcp

يستخدم نموذج أداة استماع TCP للاستماع إلى الاتصالات الواردة على عنوان ومنفذ IPv6 المحددين. لمزيد من المعلومات، يمكنك الاطّلاع على اختبار وظائف TCP باستخدام OT CLI.

المعلمات

tcp listen ip port

المعلمات التالية مطلوبة:

  • ip: عنوان IPv6 أو عنوان IPv6 غير محدَّد (::) لمثال مستمع TCP المقدَّم من tcp CLI.
  • port: منفذ TCP الخاص بمثال أداة معالجة TCP. إذا لم يكن هناك اتصال TCP مرتبطًا بنقطة نهاية TCP المثالية، فسيتم قبول أي اتصالات واردة تطابق عنوان IPv6 والمنفذ المحددَين وربطها بمثال نقطة نهاية TCP.

أمثلة

tcp listen :: 30000
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إرسال tcp

يتم إرسال البيانات عبر اتصال TCP المرتبط بنموذج نقطة نهاية TCP المتوفرة مع واجهة سطر الأوامر tcp. لمزيد من المعلومات، يمكنك الاطّلاع على اختبار وظائف TCP باستخدام OT CLI.

المعلمات

tcp send message

تحتوي المعلمة message على الرسالة التي تريد إرسالها إلى نقطة نهاية TCP البعيد.

أمثلة

tcp send hello
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إرسال tcp

إرسال "نهاية البث" الإشارة عبر اتصال TCP المرتبط بمثال نقطة نهاية TCP الذي يوفره واجهة سطر الأوامر tcp. ينبه هذا النظير أنه لن يتلقى أي بيانات أخرى عبر اتصال TCP هذا.

المعلمات

ما مِن مَعلمات.

أمثلة

tcp sendend
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف الاستماع في tcp

توجه نموذج أداة استماع TCP المثالي لإيقاف الاستماع إلى اتصالات TCP الواردة.

المعلمات

ما مِن مَعلمات.

أمثلة

tcp stoplistening
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اختبار فلتر tmforigin

يفعِّل هذا الخيار الفلتر أو يوقفه لإسقاط رسائل TMF UDP من مصدر غير موثوق به.

يتم تلقائيًا تفعيل الفلتر الذي يستبعد رسائل TMF UDP من مصدر غير موثوق به. عند إيقاف هذا الإعداد، سيتم السماح برسائل UDP المُرسَلة إلى منفذ TMF التي تنشأ من مصدر غير موثوق به (مثل المضيف أو واجهة سطر الأوامر أو عقدة IPv6 خارجية).

المعلمات

test tmforiginfilter [enable|disable]

أمثلة

test tmforiginfilter
Enabled
 
test tmforiginfilter enable
Done
 
test tmforiginfilter disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

بداية سلسلة المحادثات

يؤدي هذا الإجراء إلى بدء عملية بروتوكول Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

thread start
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إيقاف سلسلة المحادثات

إيقاف عملية بروتوكول Thread.

المعلمات

ما مِن مَعلمات.

أمثلة

thread stop
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إصدار سلسلة المحادثات

الحصول على إصدار بروتوكول Thread.

تحدّد الثوابت OT_THREADVERSION* قيم الإصدار الرقمي.

المعلمات

ما مِن مَعلمات.

أمثلة

 thread version
2
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الحد الأقصى لإدراج الوقت

الحصول على الحد الأقصى لوقت الانتظار في قائمة الرسائل في قائمة انتظار TX.

يجب توفّر OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

ويتم تتبع الوقت في قائمة الانتظار لعمليات الإرسال المباشرة فقط ويتم قياسه كمدة تبدأ من إضافة رسالة إلى قائمة انتظار الإرسال حتى تمريرها إلى طبقة MAC لنقلها أو إسقاطها.

يمكن إعادة ضبط الإحصاءات التي تم جمعها من خلال الاتصال بالرقم otThreadResetTimeInQueueStat() .

المعلمات

ما مِن مَعلمات.

أمثلة

timeinqueue max
281
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط قائمة الانتظار

إعادة ضبط إحصاءات مدة الانتظار في قائمة انتظار TX

يجب توفّر OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

المعلمات

ما مِن مَعلمات.

أمثلة

timeinqueue reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

timeinqueue

الحصول على المدرج التكراري لوقت انتظار الرسائل في قائمة الانتظار في تكساس.

يجب توفّر OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

يتم جمع المدرج التكراري لوقت انتظار الرسائل في قائمة انتظار الإرسال. ويتم تتبع الوقت في قائمة الانتظار لعمليات الإرسال المباشرة فقط ويتم قياسه كمدة تبدأ من إضافة رسالة إلى قائمة انتظار الإرسال حتى تمريرها إلى طبقة MAC لنقلها أو إسقاطها.

يتم عرض المدرج التكراري كمصفوفة من قيم uint32_t مع aNumBins إدخال. يمثل الإدخال الأول في الصفيف (في الفهرس 0) عدد الرسائل التي تحتوي على وقت في قائمة الانتظار أقل من aBinInterval. ويمثل الإدخال الثاني عدد الرسائل التي تكون مدة بقاءها في قائمة الانتظار أكبر من أو تساوي aBinInterval، ولكنها أقل من 2 * aBinInterval. وما إلى ذلك. يمثل الإدخال الأخير عدد الرسائل التي تكون مدة بقاءها في قائمة الانتظار أكبر من أو تساوي (aNumBins - 1) * aBinInterval.

يمكن إعادة ضبط الإحصاءات التي تم جمعها من خلال الاتصال بالرقم otThreadResetTimeInQueueStat() . يتم جمع معلومات المدرّج التكراري منذ بدء إعداد مثيل OpenThread أو منذ آخر مرة تمت فيها إعادة ضبط جمع الإحصاءات عن طريق استدعاء otThreadResetTimeInQueueStat() .

يجب ألا يكون المؤشران aNumBins وaBinInterval فارغين.

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

trel (تفعيل،إيقاف)

تعمل هذه السياسة على تفعيل عملية الراديو TREL أو إيقافها.

المعلمات

trel enable|disable

أمثلة

trel enable
Done
 
trel disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إعادة ضبط عدّادات النقرات

لإعادة ضبط عدّادات TREL.

المعلمات

ما مِن مَعلمات.

أمثلة

trel counters reset
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عدادات تريل

الحصول على عدّادات TREL

المعلمات

ما مِن مَعلمات.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فلتر trel (تفعيل،إيقاف)

لتفعيل وضع فلتر TREL أو إيقافه.

المعلمات

trel filter enable|disable

أمثلة

trel filter enable
Done
 
trel filter disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فِلْتَرْ trel

يشير هذا الحقل إلى ما إذا كان وضع فلتر TREL مفعَّلاً.

عند تفعيل وضع الفلتر، يتم تجاهل جميع زيارات Rx وTx المرسلة من خلال واجهة TREL بدون تنبيه.

المعلمات

ما مِن مَعلمات.

أمثلة

trel filter
Disabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نظراء trel

للحصول على جدول نظير TREL بتنسيق جدول أو قائمة.

المعلمات

trel peers [list]

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أغنية trel

يشير إلى ما إذا كانت عملية TREL مفعّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

trel
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

التحقق من التلفزيون (تفعيل،إيقاف)

تفعيل فحص إصدار سلسلة المحادثات أو إيقافه عند الترقية إلى جهاز التوجيه أو جهاز التوجيه. تكون عملية التحقّق هذه مفعَّلة تلقائيًا.

المعلمات

ما مِن مَعلمات.

أمثلة

tvcheck enable
Done
 
tvcheck disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

txpower (get,set)

يحصل (أو يحدد باستخدام وسيطة txpower الاختيارية) القدرة على الإرسال بالديسيبل.

المعلمات

txpower [txpower]

أمثلة

txpower -10
Done
 
txpower
-10 dBm
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ربط udp

يعيّن عنوان IPv6 ومنفذًا لمقبس مفتوح يربط المقبس للاتصال. يُشار إلى تعيين عنوان IPv6 والمنفذ باسم المقبس. لمزيد من المعلومات، يمكنك مراجعة اختبار وظائف UDP باستخدام OT CLI.

المعلمات

udp bind [netif] ip port
  • netif: واجهة الشبكة للربط، والتي يتم تحديدها على النحو التالي:
    • ما مِن قيمة (مع استبعاد هذه المَعلمة من الأمر): يتم استخدام واجهة شبكة Thread.
    • -u: واجهة شبكة غير محدّدة، ما يعني أنّ حزمة UDP/IPv6 تحدّد واجهة الشبكة المطلوب ربط المقبس بها.
    • -b: يتم استخدام واجهة الشبكة الأساسية.
  • ip: عنوان IPv6 أحادي للاتصال به. إذا كنت تريد أن تخصص حزمة UDP/IPv6 عنوان IPv6 الربط، أو إذا كنت تريد الربط بعناوين IPv6 ذات البث المتعدد، يمكنك استخدام القيمة التالية لاستخدام عنوان IPv6 غير المحدد: ::. يستخدم كل مثال عنوان IPv6 غير محدد.
  • port: رقم منفذ UDP المطلوب الربط به. يستخدم كل مثال من الأمثلة رقم المنفذ 1234.

أمثلة

udp bind :: 1234
Done
 
udp bind -u :: 1234
Done
 
udp bind -b :: 1234
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إغلاق udp

أغلِق مقبس UDP/IPv6.

المعلمات

ما مِن مَعلمات.

أمثلة

udp close
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

ربط udp

وصِّل مقبس UDP/IPv6.

المعلمات

udp connect ip port

المعلمات التالية مطلوبة:

  • ip: عنوان IP للنظير
  • port: رقم منفذ UDP للنظير يمكن أن يكون العنوان هو عنوان IPv4، والذي يتم تجميعه إلى عنوان IPv6 باستخدام بادئة NAT64 المفضلة من بيانات الشبكة. يعرض الأمر InvalidState عندما تكون بادئة NAT64 المفضّلة غير متاحة.

أمثلة

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

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

أمان روابط udp (تفعيل،إيقاف)

تفعيل أمان الروابط أو إيقافه

المعلمات

ما مِن مَعلمات.

أمثلة

udp linksecurity enable
Done
 
udp linksecurity disable
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

أمان روابط udp

يشير إلى ما إذا كانت أمان الروابط مفعَّلة أو غير مفعَّلة.

المعلمات

ما مِن مَعلمات.

أمثلة

udp linksecurity
Enabled
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

بروتوكول udp مفتوح

افتح مقبس UDP/IPv6.

المعلمات

ما مِن مَعلمات.

أمثلة

udp open
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إرسال udp

إرسال رسالة UDP باستخدام المقبس. لمزيد من المعلومات، يمكنك مراجعة اختبار وظائف UDP باستخدام OT CLI.

المعلمات

udp send [ip port] [type] value

إنّ ip وport اختياريان، ولكن إذا حدّدت أحدهما، يجب تحديد الآخر. إذا لم يتم تحديد ip وport، سيتم استخدام عنوان نظير المقبس من udp connect.

  • ip: عنوان الوجهة يمكن أن يكون هذا العنوان إما عنوان IPv4 أو IPv6، ويتم تجميع عنوان IPv4 إلى عنوان IPv6 مع بادئة NAT64 المفضلة من بيانات الشبكة. (إذا كانت بادئة NAT64 المفضّلة غير متاحة، سيعرض الأمر InvalidState).
  • port: منفذ وجهة UDP
  • عدد التركيبات: type من إجمالي value:
    • -t: يتم التعامل مع الحمولة في المعلَمة value على أنّها نص. في حال عدم إدخال قيمة type، يتم أيضًا التعامل مع حمولة البيانات في المعلَمة value على أنّها نص.
    • -s: الحمولة التي يتم إنشاؤها تلقائيًا بالطول المحدد المحدد في المعلمة value.
    • -x: البيانات الثنائية في التمثيل السداسي العشري المحدّد في المَعلمة value

أمثلة

udp send hello
Done
 
udp send -t hello
Done
 
udp send -x 68656c6c6f
Done
 
udp send -s 800
Done
 
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
 
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
 
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
 
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
 
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

الحصول على بيانات غير آمنة

يسرد جميع المنافذ من قائمة المنافذ غير الآمنة المسموح بها.

المعلمات

ما مِن مَعلمات.

أمثلة

unsecure get
1234
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إضافة منفذ غير آمن

إضافة منفذ إلى قائمة المنافذ غير الآمنة المسموح بها

المعلمات

unsecureport add port

أمثلة

unsecureport add 1234
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إزالة المنفذ غير الآمن

إزالة منفذ معيّن أو جميع المنافذ من قائمة المنافذ غير الآمنة المسموح بها

المعلمات

unsecureport remove port|all

أمثلة

unsecureport remove 1234
Done
 
unsecureport remove all
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مدة التشغيل ملي ثانية

تعرض مدة تشغيل المثيل الحالي (بالمللي ثانية).

يجب تفعيل OPENTHREAD_CONFIG_UPTIME_ENABLE.

يُحدَّد وقت التشغيل كعدد بالمللي ثانية منذ بدء إعداد مثيل OpenThread.

المعلمات

ما مِن مَعلمات.

أمثلة

uptime ms
426238
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

مدة التشغيل

تعرض مدة تشغيل المثيل الحالي كسلسلة يمكن لشخص عادي قراءتها.

يجب تفعيل OPENTHREAD_CONFIG_UPTIME_ENABLE.

تتبع السلسلة التنسيق "::." للساعات والدقائق والثواني والملي ثانية (إذا كانت مدة التشغيل أقصر من يوم واحد) أو "

د.::." (إذا كان أطول من يوم).

إذا كانت السلسلة الناتجة لا تتناسب مع aBuffer (ضمن أحرفها aSize)، سيتم اقتطاع السلسلة، ولكن يتم دائمًا إنهاء السلسلة المُخرجة بقيمة خالية.

المعلمات

ما مِن مَعلمات.

أمثلة

uptime
12:46:35.469
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

بائع appurl (مجموعة)

اضبط سلسلة عنوان URL لتطبيق المورِّد.

يجب توفّر OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

يجب أن يكون الترميز aVendorAppUrl بتنسيق UTF8، بحيث لا يزيد طوله عن 64 حرفًا (MAX_VENDOR_APPL_URL_TLV_LENGTH). لا يشمل الحد الأقصى للطول حرف \0 فارغًا.

المعلمات

vendor appurl url

أمثلة

vendor appurl http://www.example.com
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

عنوان URL للمورّد

الحصول على سلسلة عنوان URL لتطبيق المورّد

المعلمات

ما مِن مَعلمات.

أمثلة

vendor appurl
http://www.example.com
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نموذج البائع (مجموعة)

اضبط سلسلة نموذج المورِّد.

يجب توفّر OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

يجب أن يكون الترميز aVendorModel بتنسيق UTF8، بحيث لا يزيد طوله عن 32 حرفًا (MAX_VENDOR_MODEL_TLV_LENGTH). لا يشمل الحد الأقصى للطول حرف \0 فارغًا.

المعلمات

vendor model name

أمثلة

vendor model Hub\ Max
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

نموذج البائع

الحصول على سلسلة نموذج البائع

المعلمات

ما مِن مَعلمات.

أمثلة

vendor model
Hub Max
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم البائع (مجموعة)

اضبط سلسلة اسم المورِّد.

يجب توفّر OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

يجب أن يكون الترميز aVendorName بتنسيق UTF8، بحيث لا يزيد طوله عن 32 حرفًا (MAX_VENDOR_NAME_TLV_LENGTH). لا يشمل الحد الأقصى للطول حرف \0 فارغًا.

المعلمات

vendor name name

أمثلة

vendor name nest
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

اسم البائع

الحصول على سلسلة اسم المورّد

المعلمات

ما مِن مَعلمات.

أمثلة

vendor name
nest
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تحويل البائع (مجموعة)

عيِّن سلسلة إصدار برنامج البائع.

يجب توفّر OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

يجب أن يكون الترميز aVendorSwVersion بتنسيق UTF8، بحيث لا يزيد طوله عن 16 حرفًا(MAX_VENDOR_SW_VERSION_TLV_LENGTH). لا يشمل الحد الأقصى للطول حرف \0 فارغًا.

المعلمات

vendor swversion version

أمثلة

vendor swversion Marble3.5.1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تحويل البائع

الحصول على سلسلة إصدار برنامج البائع.

المعلمات

ما مِن مَعلمات.

أمثلة

vendor swversion
Marble3.5.1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

فيرهوف يحسب

لحساب المجموع الاختباري لـ Verhoeff لسلسلة عشرية معينة.

يجب توفّر OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

المعلمات

verhoeff calculate decimalstring

أمثلة

verhoeff calculate 30731842
1
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

تأكيد صحة فيرهوف

للتحقق من صحة المجموع الاختباري لـ Verhoeff لسلسلة عشرية معينة.

يجب توفّر OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

المعلمات

verhoeff validate decimalstring

أمثلة

verhoeff validate 307318421
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

إصدار واجهة برمجة التطبيقات

يطبع رقم إصدار واجهة برمجة التطبيقات.

المعلمات

ما مِن مَعلمات.

أمثلة

version api
28
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر

  • ما مِن واجهة برمجة تطبيقات مرتبطة.

إصدار

الحصول على سلسلة إصدار OpenThread.

المعلمات

ما مِن مَعلمات.

أمثلة

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done

مراجع واجهة برمجة التطبيقات وواجهة سطر الأوامر