คู่มือนี้ครอบคลุมการสร้างและการกําหนดค่าพื้นฐานของ OpenThread Commissioner (OT Commissioner) เมื่อดําเนินการตามกระบวนการนี้เสร็จแล้ว คุณจะมีไฟล์ปฏิบัติการ LI ค่าคอมมิชชันและไลบรารีค่าคอมมิชชันแบบคงที่
ตั้งค่า OT Commissioner
โคลนที่เก็บ OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
ติดตั้งทรัพยากร Dependency:
cd ot-commissioner
./script/bootstrap.sh
สร้าง OT Commissioner
OT Commissioner ติดตั้งในไดเรกทอรี /usr/local
หากต้องการเปลี่ยนไดเรกทอรีการติดตั้ง ให้ตั้งค่า -DCMAKE_INSTALL_PREFIX
สร้าง OT Commissioner:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
สร้างตัวแปรสภาพแวดล้อมเพื่อเรียกใช้
commissioner-cli
ในขั้นตอนถัดไปexport COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Optional เรียกใช้การทดสอบหน่วย:
./tests/commissioner-test
ติดตั้ง OT Commissioner
OT Commissioner จะติดตั้งไดเรกทอรีการติดตั้งต่อไปนี้
- ไฟล์ไลบรารีและส่วนหัวส่วนหัว OT Commissioner
- ไบนารีปฏิบัติการของ OT Commissioner CLI
- ไฟล์การกําหนดค่าเริ่มต้นและข้อมูลเข้าสู่ระบบ
- สคริปต์ที่จะเรียกใช้ OT Commissioner CLI เป็น Daemon
sudo ninja install
ยืนยันการติดตั้งโดยตรวจสอบเมนูความช่วยเหลือ
$COMMISSIONER_CLI -h
หากคุณติดตั้งในไดเรกทอรี /usr/local
คุณจะใช้ commissioner-cli
ได้จากบรรทัดคําสั่ง
commissioner-cli -h
การกำหนดค่า
OT Commissioner CLI รองรับทั้ง Thread 1.2 Commercial Commissioning Mode (CCM) และ Thread 1.1 Commissioning (ไม่ใช่ CCM) หากต้องการเชื่อมต่อเครือข่ายเทรดอื่น จะต้องใช้ไฟล์การกําหนดค่า JSON เพื่อเริ่ม OT Commissioner CLI ดังนี้
ccm-config.json
— ไฟล์การกําหนดค่าเริ่มต้นสําหรับเครือข่ายชุดข้อความ CCMnon-ccm-config.json
— ไฟล์การกําหนดค่าเริ่มต้นสําหรับเครือข่ายชุดข้อความที่ไม่ใช่ CCM
โดยค่าเริ่มต้น ไฟล์การกําหนดค่าเหล่านี้จะได้รับการติดตั้งใน /usr/local/etc/commissioner
นอกจากนี้ ยังดูตัวอย่างไฟล์ในที่เก็บ GitHub ของ ot-commissioner ได้ด้วย
การกําหนดค่า CCM
หากต้องการเชื่อมต่อกับเครือข่ายเทรด CCM ให้อัปเดตช่องเหล่านี้ใน ccm-config.json
ดังนี้
ช่อง | คำอธิบาย |
---|---|
DomainName |
ตัวระบุที่ไม่ซ้ํากันในโดเมน Enterprise |
PrivateKeyFile |
ไฟล์คีย์ส่วนตัวในรูปแบบ PEM |
CertificateFile |
ไฟล์ใบรับรองในรูปแบบ PEM |
TrustAnchorFile |
ไฟล์ Anchor การเชื่อถือในรูปแบบ PEM |
ไฟล์คีย์และใบรับรองเหล่านี้ใช้เพื่อสร้างเซสชันที่ปลอดภัยระหว่างค่าคอมมิชชันและตัวแทนเส้นขอบ
การกําหนดค่าที่ไม่ใช่ CCM
คีย์ที่แชร์ล่วงหน้า PSKc
ใช้เพื่อสร้างเซสชันที่ปลอดภัยระหว่างค่าคอมมิชชันและตัวแทนเส้นขอบ หากต้องการเชื่อมต่อเครือข่ายชุดข้อความที่ไม่ใช่ CCM
คุณสามารถตั้งค่า PSKc
จาก OT Commissioner CLI โปรดดูข้อมูลเพิ่มเติมที่การว่าจ้างภายนอก
Logging
เมื่อเรียกใช้ pi@raspberrypi: commissioner-cli
จากบรรทัดคําสั่ง OT Commissioner จะสร้างไฟล์ commissioner.log
ในไดเรกทอรีที่ใช้งานได้ในปัจจุบัน เช่น /home/pi/commissioner.log
โดยจะกําหนดค่าเส้นทาง LogFile
, ระดับการบันทึก และการตั้งค่าบันทึกอื่นๆ ได้ในไฟล์การกําหนดค่า JSON
การกําหนดค่าการโหลด
วิธีเริ่ม OT Commissioner ด้วยการกําหนดค่า
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
นายช่างไม้
หากต้องการใช้ OT Commissioner ในค่าคอมมิชชันช่างไม้ โปรดดูหัวข้อค่าคอมมิชชันภายนอก