عرض مجموعات البيانات وإدارتها باستخدام واجهة سطر الأوامر "OT CLI"

الاطّلاع على المصدر على GitHub

تتم إدارة مَعلمات ضبط شبكة Thread باستخدام "نشطة" و"في انتظار المراجعة" كائنات مجموعة البيانات التشغيلية. يتضمن OT CLI أوامر للحصول على "نشط" وضبطه ومجموعات البيانات المعلقة.

تحذير: قيود متعلقة بالاستخدام العلني!

قد تسمح أوامر واجهة سطر الأوامر لكتابة مجموعات البيانات التشغيلية النشطة والمُعلَّقة أو تغييرها بإعداد معلمات غير صالحة، أو مجموعات غير صالحة من المعلمات، لأغراض الاختبار. يمكن استخدام أوامر CLI التالية فقط:

  • لضبط معلَمات الشبكة للجهاز الأول في شبكة Thread التي تم إنشاؤها حديثًا
  • للاختبار (لا ينطبق على أجهزة الإنتاج).

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

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

تتضمّن "مجموعة البيانات التشغيلية النشطة" مَعلمات قيد الاستخدام حاليًا. على شبكة Thread بالكامل تحتوي مجموعة البيانات التشغيلية النشطة على:

  • الطابع الزمني النشط
  • القناة
  • قناع القناة
  • رقم تعريف PAN الموسَّع
  • بادئة شبكة محلية متداخلة
  • اسم الشبكة
  • رقم PAN
  • PSKc
  • سياسة الأمان

لضبط جهاز كي يكون عضوًا كاملاً في شبكة Thread، يمكنك استخدام الأمر dataset active -x الحصول على ملف TLV بترميز سداسي، dataset active على لتعيين مجموعة البيانات على جهاز جديد.

على أحد الأجهزة الحالية، احصل على ملف TLV بترميز سداسي:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

على جهاز جديد، اضبط مجموعة البيانات النشطة:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

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

تُستخدم مجموعة البيانات التشغيلية المعلّقة للإبلاغ عن التغييرات في هي مجموعة البيانات التشغيلية قبل أن تدخل حيز التنفيذ. مجموعة البيانات التشغيلية في انتظار المراجعة يحتوي على جميع المعلمات من مجموعة البيانات التشغيلية النشطة، مع إضافة:

  • موقّت التأخير
  • الطابع الزمني في انتظار المراجعة

البدء

لإدارة مجموعات البيانات من سطر الأوامر، أكمل درسنا التجريبي حول ترميز المحاكاة Docker وراجع مرجع أوامر واجهة سطر الأوامر.

الانتقال إلى الدرس التطبيقي حول الترميز

الانتقال إلى مرجع أوامر واجهة سطر الأوامر

للحصول على قائمة بأوامر dataset، اكتب help:

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

تعيينات الوسيطات

سياسة الأمان

تستخدم أوامر سياسة الأمان تعيينات الوسيطات للتلقي والضبط otSecurityPolicy الأعضاء. على سبيل المثال، dataset active:

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

في هذا المثال، تشير السمة Security Policy: 0 إلى mRotationTime.

في ما يلي قائمة بجميع وسيطات واجهة سطر الأوامر لسياسة الأمان عضو otSecurityPolicy المقابل لكل وسيطة:

تستخدم أوامر dataset securitypolicy get and set أيضًا الوسيطة نفسها التعيينات، مثل ضبط securitypolicy وتمرير o وn وr وc:

dataset securitypolicy 672 onrc
Done

مكونات مجموعة البيانات وأوامر mgmt

إلى جانب المعلمات الأخرى، يتضمّن العمودان mgmtgetcommand وmgmtsetcommand لمجموعات البيانات النشطة والمعلّقة تتيح لك الحصول على أي تركيبة وتعيينها من otOperationalDatasetComponents:

  • activetimestamp
  • pendingtimestamp
  • networkkey
  • networkname
  • extpanid
  • localprefix
  • delaytimer
  • panid
  • channel
  • securitypolicy

بالنسبة إلى mgmtgetcommand، يمكنك تحديد هذه المكوّنات بأي ترتيب للحصول على والقيم المتجاوبة. يمكنك أيضًا ضبط -x لاستخدام سداسي عشري. يتم التعامل معه على أنه تمثيل تسلسل بايت من TLV. يمكن أن يكون هذا البائع TLVs محددة قد ترغب في إضافتها إلى جانب معلمات أخرى.

يتيح لك mgmtgetcommand أيضًا تحديد عنوان IPv6 في القائد. وبخلاف ذلك، يتم استخدام ALOC الرائدة.

dataset mgmtgetcommand {active|pending} [address leader-address] [dataset-components] [-x tlv-list]

على سبيل المثال، للحصول على activetimestamp وsecuritypolicy، استخدِم ما يلي: الوسيطات:

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

لتعيين المكونات، يمكنك أيضًا توفير مكونات مجموعة البيانات بأي ترتيب، متبوعة بقيمة المكون.

dataset mgmtgetcommand {active|pending} [dataset-components] [-x tlv-list]

لضبط activetimestamp وsecuritypolicy، استخدِم ما يلي: الوسيطات:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done