نمایش و مدیریت مجموعه داده ها با OT CLI

مشاهده منبع در GitHub

پارامترهای پیکربندی شبکه رشته با استفاده از اشیاء مجموعه داده عملیاتی فعال و معلق مدیریت می شوند. OT CLI شامل دستوراتی برای دریافت و تنظیم مجموعه داده های فعال و در انتظار است.

هشدار - محدودیت برای استفاده در تولید!

دستورات CLI برای نوشتن یا تغییر مجموعه داده‌های عملیاتی فعال و معلق ممکن است اجازه تنظیم پارامترهای نامعتبر یا ترکیبات نامعتبر از پارامترها را برای اهداف آزمایشی بدهد. این دستورات CLI فقط قابل استفاده هستند:

• برای پیکربندی پارامترهای شبکه برای اولین دستگاه در یک شبکه Thread جدید ایجاد شده.
• برای آزمایش (برای دستگاه های تولیدی قابل استفاده نیست).

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

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

مجموعه داده عملیاتی فعال شامل پارامترهایی است که در حال حاضر در کل شبکه Thread استفاده می شوند. مجموعه داده عملیاتی فعال شامل:

• مهر زمانی فعال
• کانال
• ماسک کانال
• PAN ID توسعه یافته
• پیشوند مش-محلی
• نام شبکه
• PAN ID
• PSKc
• سیاست امنیتی

برای پیکربندی آسان یک دستگاه به گونه‌ای که یک عضو کامل از شبکه Thread باشد، می‌توانید از دستور مجموعه داده active -x برای دریافت TLV کدگذاری شده هگزا و دستور فعال مجموعه مجموعه داده برای تنظیم مجموعه داده در دستگاه جدید استفاده کنید.

در دستگاه موجود، TLV رمزگذاری شده هگز را دریافت کنید:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

در یک دستگاه جدید، مجموعه داده فعال را تنظیم کنید:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

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

مجموعه داده های عملیاتی در انتظار برای اطلاع رسانی تغییرات به مجموعه داده های عملیاتی فعال قبل از اعمال آنها استفاده می شود. مجموعه داده عملیاتی در انتظار شامل تمام پارامترهای مجموعه داده عملیاتی فعال است، با اضافه کردن موارد:

• تایمر تاخیر
• مهر زمانی معلق

شروع کنید

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

به شبیه سازی Codelab بروید

به مرجع فرمان CLI بروید

برای لیستی از دستورات 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 را نشان می دهد.

در اینجا لیستی از همه آرگومان های CLI سیاست امنیتی و عضو مربوطه otSecurityPolicy برای هر آرگومان آمده است:

• o : mObtainNetworkKeyEnabled
• n : mNativeCommissioningEnabled
• r : mRoutersEnabled
• c : mExternalCommissioningEnabled
• b : mBeaconsEnabled
• C : mCommercialCommissioningEnabled
• e : mAutonomousEnrollmentEnabled
• p : mNetworkKeyProvisioningEnabled
• R : mNonCcmRouters Enabled

دستورات get و set dataset securitypolicy نیز از همان نگاشت آرگومان استفاده می‌کنند، به عنوان مثال، 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