แสดงและจัดการชุดข้อมูลด้วย OT CLI

ดูแหล่งที่มาใน GitHub

จัดการพารามิเตอร์การกำหนดค่าเครือข่ายเทรดโดยใช้ "ใช้งานอยู่" และ "รอดำเนินการ" ออบเจ็กต์ชุดข้อมูลการดำเนินการ OT CLI มีคำสั่งเพื่อรับและตั้งค่าเป็น "ใช้งานอยู่" และชุดข้อมูลที่รอดำเนินการ

คำเตือน - ข้อจำกัดสำหรับการใช้งานจริง

คำสั่ง CLI เพื่อเขียนหรือเปลี่ยนแปลงชุดข้อมูลการดำเนินการที่ใช้งานอยู่และรอดำเนินการอาจอนุญาตให้ตั้งค่าพารามิเตอร์ที่ไม่ถูกต้อง หรือ ชุดค่าผสมของพารามิเตอร์ที่ไม่ถูกต้อง สำหรับการทดสอบ คำสั่ง CLI ต่อไปนี้ใช้ได้เท่านั้น

  • เพื่อกำหนดค่าพารามิเตอร์เครือข่ายสำหรับอุปกรณ์แรกในเครือข่ายเทรดที่สร้างขึ้นใหม่
  • สำหรับการทดสอบ (ใช้ไม่ได้กับอุปกรณ์เวอร์ชันที่ใช้งานจริง)

ในเครือข่ายเทรดเวอร์ชันที่ใช้งานจริง วิธีที่ถูกต้องในการเขียนหรือเปลี่ยนแปลงชุดข้อมูลด้านการปฏิบัติงานคือการใช้ กรรมาธิการ ที่ดำเนินการค่าคอมมิชชัน อุปกรณ์การผลิตที่ไม่ใช่พนักงานประจำอยู่แล้วและเป็นส่วนหนึ่งของ ของเครือข่ายเทรดต้องไม่แก้ไขชุดข้อมูลการดำเนินการด้วยวิธีใดๆ

ชุดข้อมูลด้านการปฏิบัติงานที่ใช้งานอยู่

ชุดข้อมูลด้านการปฏิบัติงานที่ใช้งานอยู่มีพารามิเตอร์ที่กำลังใช้อยู่ ทั่วทั้งเครือข่ายเทรด ชุดข้อมูลด้านการดำเนินการที่ใช้งานอยู่ประกอบด้วย

  • การประทับเวลาที่มีการใช้งาน
  • ช่อง
  • มาสก์ช่อง
  • รหัส PAN แบบขยาย
  • คำนำหน้า Mesh-Local
  • ชื่อเครือข่าย
  • PAN ID
  • PSKc
  • นโยบายความปลอดภัย

หากต้องการกำหนดค่าอุปกรณ์ได้อย่างง่ายดายเพื่อให้อุปกรณ์นั้นเป็นสมาชิกเต็มรูปแบบของเครือข่ายเทรด คุณจะต้องทำดังนี้ สามารถใช้คำสั่ง datasetactive -x เพื่อ จะรับ TLV ที่เข้ารหัสเลขฐาน 16 และ คำสั่งใช้งานชุดข้อมูลเป็น ตั้งค่าชุดข้อมูลในอุปกรณ์เครื่องใหม่

รับ TLV ที่เข้ารหัสเลขฐาน 16 ดังนี้ในอุปกรณ์ที่มีอยู่

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

ในอุปกรณ์ใหม่ ให้ตั้งค่าชุดข้อมูลที่ใช้งานอยู่

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

ชุดข้อมูลการดำเนินการที่รอดำเนินการ

ชุดข้อมูลการดำเนินการที่รอดำเนินการจะใช้ในการสื่อสารการเปลี่ยนแปลง ชุดข้อมูลด้านการปฏิบัติงานก่อนที่จะมีผล ชุดข้อมูลการดำเนินการที่รอดำเนินการ มีพารามิเตอร์ทั้งหมดจากชุดข้อมูลด้านการดำเนินการที่ใช้งานอยู่ การเพิ่ม:

  • ตัวจับเวลาการหน่วงเวลา
  • การประทับเวลาที่รอดำเนินการ

เริ่มต้นใช้งาน

หากต้องการจัดการชุดข้อมูลจากบรรทัดคำสั่ง ให้ทำ Simulation Codelab ด้วย Docker และตรวจสอบการอ้างอิงคำสั่ง CLI

ไปที่ Simulation 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 ที่ตรงกันสำหรับอาร์กิวเมนต์แต่ละรายการ

คำสั่ง 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