Hiển thị và quản lý tập dữ liệu bằng OT CLI

Xem nguồn trên GitHub

Các tham số cấu hình mạng luồng được quản lý bằng chế độ Đang hoạt động và Đang chờ xử lý Đối tượng Tập dữ liệu hoạt động. OT CLI bao gồm các lệnh để nhận và đặt trạng thái Đang hoạt động và Tập dữ liệu đang chờ xử lý.

CẢNH BÁO – Các hạn chế đối với việc sử dụng phiên bản phát hành công khai!

Các lệnh CLI để ghi hoặc thay đổi Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý có thể cho phép cài đặt các tham số không hợp lệ, hoặc tổ hợp tham số không hợp lệ cho mục đích thử nghiệm. Bạn chỉ có thể sử dụng các lệnh CLI sau:

  • Để định cấu hình các tham số mạng cho thiết bị đầu tiên trong mạng Thread mới tạo.
  • Để thử nghiệm (không áp dụng cho các thiết bị phát hành chính thức).

Trong mạng Thread sản xuất, phương pháp chính xác để ghi hoặc thay đổi Tập dữ liệu hoạt động là thông qua Uỷ viên thực hiện phí hoa hồng. Thiết bị sản xuất không phải là Uỷ viên đang hoạt động và tham gia của mạng Thread KHÔNG ĐƯỢC sửa đổi Tập dữ liệu hoạt động theo bất kỳ cách nào.

Tập dữ liệu hoạt động đang hoạt động

Tập dữ liệu hoạt động đang hoạt động bao gồm các tham số hiện đang được sử dụng trên toàn bộ mạng Thread. Tập dữ liệu hoạt động đang hoạt động bao gồm:

  • Dấu thời gian hoạt động
  • Kênh
  • Mặt nạ kênh
  • Mã PAN mở rộng
  • Tiền tố Mesh-Local
  • Tên mạng
  • Số tài khoản vĩnh viễn
  • PSKc
  • Chính sách bảo mật

Để dễ dàng định cấu hình một thiết bị sao cho thiết bị đó trở thành thành viên đầy đủ của mạng Thread, bạn có thể dùng lệnh dataset active -x để lấy một TLV được mã hoá theo hệ thập lục phân và Lệnh dataset set active thành đặt tập dữ liệu trên một thiết bị mới.

Trên một thiết bị hiện có, hãy lấy TLV được mã hoá theo hệ thập lục phân:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Trên một thiết bị mới, hãy đặt tập dữ liệu đang hoạt động:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Tập dữ liệu hoạt động đang chờ xử lý

Tập dữ liệu hoạt động đang chờ xử lý được dùng để thông báo các thay đổi đối với Tập dữ liệu hoạt động trước khi chúng có hiệu lực. Tập dữ liệu hoạt động đang chờ xử lý chứa tất cả các tham số từ Tập dữ liệu hoạt động đang hoạt động, với thêm:

  • Đồng hồ hẹn giờ trễ
  • Dấu thời gian đang chờ xử lý

Bắt đầu

Để quản lý tập dữ liệu từ dòng lệnh, hãy hoàn tất Lớp học lập trình mô phỏng bằng Docker và xem lại tệp tham chiếu lệnh CLI.

Chuyển đến Lớp học lập trình mô phỏng

Chuyển đến phần Tham chiếu lệnh CLI

Để xem danh sách các lệnh dataset, hãy nhập help:

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

Liên kết đối số

Chính sách bảo mật

Các lệnh của Chính sách bảo mật sử dụng liên kết đối số để nhận và thiết lập otSecurityPolicy thành viên. Ví dụ như 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

Trong ví dụ này, Security Policy: 0 biểu thị mRotationTime.

Dưới đây là danh sách tất cả các đối số CLI và chính sách bảo mật thành phần otSecurityPolicy tương ứng cho mỗi đối số:

Các lệnh get và set dataset securitypolicy cũng dùng cùng một đối số ánh xạ, ví dụ: đặt securitypolicy và truyền o, n, r, và c:

dataset securitypolicy 672 onrc
Done

Thành phần tập dữ liệu và lệnh mgmt

Cùng với các tham số khác, mgmtgetcommand và mgmtsetcommand cho Tập dữ liệu Hoạt động và Đang chờ xử lý cho phép bạn nhận và đặt bất kỳ kết hợp nào về otOperationalDatasetComponents:

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

Đối với mgmtgetcommand, bạn có thể chỉ định các thành phần này theo thứ tự bất kỳ để lấy các giá trị tương ứng. Bạn cũng có thể truyền -x để sử dụng một hệ thập lục phân (không bắt buộc) được coi là đại diện chuỗi byte của TLV. Đây có thể là nhà cung cấp TLV cụ thể mà bạn có thể muốn thêm ngoài các thông số khác.

mgmtgetcommand cũng cho phép bạn tuỳ ý chỉ định địa chỉ IPv6 của người dẫn đầu. Nếu không, nhà xuất bản hàng đầu ALOC sẽ được sử dụng.

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

Ví dụ: để tải activetimestamp và securitypolicy, hãy sử dụng hàm sau đối số:

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

Để đặt các thành phần, bạn cũng có thể cung cấp các thành phần của tập dữ liệu theo thứ tự bất kỳ, theo sau là giá trị thành phần.

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

Để đặt activetimestamp và securitypolicy, hãy sử dụng các hàm sau đối số:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done