Menampilkan dan Mengelola Set Data dengan OT CLI

Lihat sumber di GitHub

Parameter konfigurasi jaringan thread dikelola menggunakan Active dan Pending Objek Set Data Operasional. OT CLI mencakup perintah untuk mengaktifkan dan Pending.

PERINGATAN - Pembatasan untuk penggunaan produksi.

Perintah CLI untuk menulis atau mengubah Set Data Operasional dan Tertunda mungkin mengizinkan pengaturan parameter yang tidak valid, atau kombinasi parameter yang tidak valid, untuk tujuan pengujian. Perintah CLI ini hanya dapat digunakan:

  • Untuk mengonfigurasi parameter jaringan bagi perangkat pertama dalam jaringan Thread yang baru dibuat.
  • Untuk pengujian (tidak berlaku untuk perangkat produksi).

Dalam jaringan Thread produksi, metode yang benar untuk menulis atau mengubah Set Data Operasional adalah melalui Komisaris yang melakukan commissioning. Perangkat produksi yang bukan merupakan Commissioner aktif dan merupakan bagian jaringan Thread TIDAK BOLEH memodifikasi {i>Dataset<i} Operasional dengan cara apa pun.

Set Data Operasional yang Aktif

Set Data Operasional Aktif menyertakan parameter yang sedang digunakan di seluruh jaringan Thread. Set Data Operasional Aktif berisi:

  • Stempel Waktu Aktif
  • Saluran
  • Masker Saluran
  • ID PAN yang diperluas
  • Awalan Mesh-Local
  • Nama Jaringan
  • ID PAN
  • PSKc
  • Kebijakan Keamanan

Untuk mengonfigurasi perangkat dengan mudah agar menjadi anggota penuh jaringan Thread, Anda dapat menggunakan perintah dataset active -x untuk mendapatkan TLV berenkode hex, dan Perintah set data aktif ke mengatur {i>dataset <i}di perangkat baru.

Pada perangkat yang sudah ada, dapatkan TLV berenkode heksadesimal:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Di perangkat baru, tetapkan set data aktif:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Set Data Operasional Tertunda

{i>Pending Operational Dataset<i} digunakan untuk mengomunikasikan perubahan pada Set Data Operasional sebelum diterapkan. Set Data Operasional yang Tertunda berisi semua parameter dari {i>Dataset <i}Operasional Aktif, dengan tambahan dari:

  • Penghitung Waktu Tunda
  • Stempel Waktu Menunggu Persetujuan

Mulai

Untuk mengelola set data dari command line, selesaikan Codelab Simulasi kami dengan Docker dan meninjau Referensi Perintah CLI.

Buka Codelab Simulasi

Buka Referensi Perintah CLI

Untuk mengetahui daftar perintah dataset, ketik help:

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

Pemetaan argumen

Kebijakan Keamanan

Perintah Kebijakan Keamanan menggunakan pemetaan argumen untuk mendapatkan dan menetapkan otSecurityPolicy anggota. Misalnya, 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

Dalam contoh ini, Security Policy: 0 menunjukkan mRotationTime.

Berikut adalah daftar semua argumen Security Policy CLI dan anggota otSecurityPolicy yang sesuai untuk setiap argumen:

Perintah get dan set dataset securitypolicy juga menggunakan argumen yang sama pemetaan, misalnya menetapkan securitypolicy dan meneruskan o, n, r, dan c:

dataset securitypolicy 672 onrc
Done

Komponen set data dan perintah mgmt

Bersama dengan parameter lainnya, mgmtgetcommand dan mgmtsetcommand untuk Set Data Aktif dan Tertunda memungkinkan Anda untuk mendapatkan dan mengatur kombinasi apa pun dari otOperationalDatasetComponents:

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

Untuk mgmtgetcommand, Anda dapat menentukan komponen ini dalam urutan apa pun untuk mendapatkan nilai-nilai yang sesuai. Secara opsional, Anda juga dapat meneruskan -x untuk menggunakan hex yang diperlakukan sebagai representasi urutan byte dari TLV. Ini bisa berupa vendor TLV spesifik yang mungkin ingin Anda tambahkan di samping parameter lain.

mgmtgetcommand juga memungkinkan Anda secara opsional menentukan alamat IPv6 dari pemimpin. Jika tidak, ALOC pemimpin akan digunakan.

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

Misalnya, untuk mendapatkan activetimestamp dan securitypolicy, gunakan metode berikut argumen:

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

Untuk mengatur komponen, Anda juga dapat menyediakan komponen {i>dataset<i} dalam urutan apa pun, diikuti oleh nilai {i>component<i}.

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

Untuk menyetel activetimestamp dan securitypolicy, gunakan hal berikut argumen:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done