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

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

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

تحذير: يتم فرض قيود على استخدام الإصدار العلني

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

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

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

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

تتضمن مجموعة بيانات التشغيلية النشطة المعلمات المستخدمة حاليًا عبر شبكة Thread بأكملها. تحتوي مجموعة بيانات التشغيل النشطة على:

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

لتسهيل ضبط أحد الأجهزة ليكون عضوًا كاملاً في شبكة Thread، يمكنك استخدام الأمر datasetactive -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. يمكن أن يكون هذا TLV خاص ببائع قد ترغب في إضافته بالإضافة إلى معلمات أخرى.

تسمح لك 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