Menampilkan dan Mengelola Set Data dengan OT CLI

Lihat sumber di GitHub

Parameter konfigurasi jaringan thread dikelola menggunakan objek Set Data Operasional Aktif dan Tertunda. OT CLI mencakup perintah untuk mendapatkan dan menetapkan set data Aktif dan Tertunda.

PERINGATAN - Pembatasan penggunaan produksi!

Perintah CLI untuk menulis atau mengubah Set Data Operasional Aktif dan Tertunda memungkinkan penyetelan 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 bagi perangkat produksi).

Dalam jaringan Thread produksi, metode yang benar untuk menulis atau mengubah Set Data Operasional adalah melalui Commissioner yang melakukan komisi. Perangkat produksi yang bukan Komisaris aktif dan merupakan bagian dari jaringan Thread TIDAK BOLEH mengubah Set Data Operasional dengan cara apa pun.

Set Data Operasional Aktif

Set Data Operasional Aktif mencakup parameter yang saat ini digunakan di seluruh jaringan Thread. {i>Dataset<i} Operasional Aktif berisi:

  • Stempel Waktu Aktif
  • Channel
  • Masker Saluran
  • ID PAN yang diperpanjang
  • Awalan Lokal-Mesh
  • Nama Jaringan
  • ID PAN
  • PSKc
  • Kebijakan Keamanan

Untuk mengonfigurasi perangkat dengan mudah agar menjadi anggota penuh jaringan Thread, Anda dapat menggunakan perintah set data active -x untuk mendapatkan TLV berenkode heksadesimal, dan perintah dataset set active untuk menetapkan set data pada 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

Set Data Operasional Tertunda digunakan untuk mengomunikasikan perubahan pada Set Data Operasional Aktif sebelum perubahan tersebut berlaku. Set Data Operasional Tertunda berisi semua parameter dari Set Data Operasional Aktif, dengan tambahan:

  • Tunda Timer
  • Stempel Waktu Tertunda

Memulai

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

Buka Codelab Simulasi

Buka Referensi Perintah CLI

Untuk melihat 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 anggota otSecurityPolicy. Sebagai contoh, 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 CLI Kebijakan Keamanan dan anggota otSecurityPolicy yang terkait untuk setiap argumen:

Perintah get dan set dataset securitypolicy juga menggunakan pemetaan argumen yang sama, misalnya menyetel 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 mendapatkan dan menetapkan kombinasi otOperationalDatasetComponents apa pun:

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

Untuk mgmtgetcommand, Anda dapat menentukan komponen ini dalam urutan apa pun untuk mendapatkan nilai yang sesuai. Secara opsional, Anda juga dapat meneruskan -x untuk menggunakan string heksa yang diperlakukan sebagai representasi urutan byte TLV. Hal ini dapat berupa TLV khusus vendor yang mungkin ingin Anda tambahkan selain parameter lainnya.

mgmtgetcommand juga memungkinkan Anda secara opsional menentukan alamat IPv6 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 argumen berikut:

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

Untuk menetapkan komponen, Anda juga dapat menyediakan komponen set data dalam urutan apa pun, diikuti dengan nilai komponen.

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

Untuk menetapkan activetimestamp dan securitypolicy, gunakan argumen berikut:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done