Konfigurasi dan Pembuatan Komisaris OpenThread

Lihat sumber di GitHub

Panduan ini membahas build dasar dan konfigurasi OpenThread Commissioner (OT Commissioner). Setelah prosedur ini selesai, Anda akan memiliki CLI CLI Komisioner yang dapat dieksekusi dan library Komisaris statis.

Menyiapkan Komisioner OT

1. Clone repositori OT Commissioner:

   git clone https://github.com/openthread/ot-commissioner
   

2. Instal dependensi:

   cd ot-commissioner
   ./script/bootstrap.sh
   

Membuat Komisaris OT

Komisaris OT menginstal ke direktori /usr/local. Jika Anda ingin mengubah direktori penginstalan, tetapkan -DCMAKE_INSTALL_PREFIX.

1. Membuat Komisaris OT:

   mkdir build
   cd build
   cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
   ninja -j1
   

2. Buat variabel Lingkungan untuk menjalankan commissioner-cli di langkah berikutnya:

   export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
   

3. Opsional. Jalankan pengujian unit:

   ./tests/commissioner-test
   

Menginstal Komisaris OT

Komisaris OT menginstal hal berikut ke direktori penginstalan Anda:

• Library dan file header Komisi Commissioner OT
• Biner yang dapat dieksekusi CLI Komisioner OT
• File dan kredensial konfigurasi default
• Skrip untuk menjalankan OT Commissioner CLI sebagai daemon

sudo ninja install

Verifikasi penginstalan dengan memeriksa menu bantuan.

$COMMISSIONER_CLI -h

Jika Anda menginstal ke direktori /usr/local, commissioner-cli tersedia dari command line.

commissioner-cli -h

Konfigurasi

CLI Komisioner OT mendukung Mode Komisioner Thread 1.2 (CCM) dan Thread 1.1 Commissioning (Non-CCM). Agar terhubung ke jaringan Thread yang berbeda, file konfigurasi JSON diperlukan untuk memulai OT Commissioner CLI:

• ccm-config.json — File konfigurasi default untuk CCM Thread Network.
• non-ccm-config.json — File konfigurasi default untuk Jaringan Thread Non-CCM.

Secara default, file konfigurasi ini diinstal di /usr/local/etc/commissioner. Anda juga dapat melihat file sampel di repositori GitHub ot-commissioner.

Konfigurasi CCM

Untuk terhubung ke jaringan CCM Thread, perbarui kolom ini di ccm-config.json:

Kolom	Deskripsi
DomainName	ID unik dalam Domain Perusahaan.
PrivateKeyFile	File kunci pribadi dalam format PEM.
CertificateFile	File sertifikat dalam format PEM.
TrustAnchorFile	File anchor kepercayaan dalam format PEM.

File kunci dan sertifikat ini digunakan untuk membuat sesi yang aman antara Komisioner dan Agen Batas.

Konfigurasi non-CCM

Kunci Pra-Bagi PSKc digunakan untuk membangun sesi aman antara Komisioner dan Agen Batas. Untuk terhubung ke jaringan Non-CCM Thread, Anda dapat menyetel PSKc dari CLI OT Commissioner CLI. Untuk informasi selengkapnya, lihat Komisi Eksternal.

Logging

Saat Anda menjalankan pi@raspberrypi: commissioner-cli dari command line, OT Commissioner akan membuat file commissioner.log di direktori kerja saat ini, misalnya /home/pi/commissioner.log. Pada file konfigurasi JSON, Anda dapat mengonfigurasi jalur LogFile, level logging, dan setelan log lainnya.

Muat konfigurasi

Untuk memulai OT Commissioner dengan setelan konfigurasi:

commissioner-cli /usr/local/etc/commissioner/ccm-config.json

Membuat permintaan bergabung

Untuk menggunakan Komisaris OT untuk menetapkan anggota, lihat Komisi Eksternal.