Panduan ini mencakup build dan konfigurasi dasar OpenThread Commissioner (OT Commissioner). Setelah menyelesaikan prosedur ini, Anda akan memiliki KLI yang dapat dieksekusi OT Commissioner dan library Komisaris statis.
Menyiapkan Komisaris OT
Clone repositori OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
Instal dependensi:
cd ot-commissioner
./script/bootstrap.sh
Komisioner OT Build
OT Commissioner akan menginstal ke direktori /usr/local
. Jika ingin mengubah
direktori penginstalan, tetapkan -DCMAKE_INSTALL_PREFIX
.
Komisioner OT Build:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Buat variabel Lingkungan untuk menjalankan
commissioner-cli
pada langkah berikutnya:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Optional. Jalankan pengujian unit:
./tests/commissioner-test
Menginstal Komisi OT
OT Commissioner akan menginstal direktori berikut ini ke direktori penginstalan Anda:
- Library header OT Commissioner dan file header
- Biner eksekusi CLI Komisaris OT
- File konfigurasi default dan kredensial
- 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
akan tersedia
dari command line.
commissioner-cli -h
Konfigurasi
CLI OT Commissioner mendukung Mode Komisi Komersial Thread 1.2 (CCM) dan komisioning Thread 1.1 (Non-CCM). Untuk menghubungkan ke jaringan Thread berbeda, file konfigurasi JSON diperlukan untuk memulai OT Commissioner CLI:
ccm-config.json
— File konfigurasi default untuk Jaringan Thread CCM.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 com-missioner.
Konfigurasi CCM
Untuk terhubung ke jaringan CCM Thread, perbarui kolom ini di ccm-config.json
:
Field | Deskripsi |
---|---|
DomainName |
ID unik dalam Domain Perusahaan. |
PrivateKeyFile |
File kunci pribadi dalam format PEM. |
CertificateFile |
File sertifikat dalam format PEM. |
TrustAnchorFile |
File trust anchor dalam format PEM. |
File kunci dan sertifikat ini digunakan untuk membuat sesi aman antara Komisaris dan Agen Perbatasan.
Konfigurasi non-CCM
Kunci Pra-Bagi PSKc
digunakan untuk membuat sesi yang aman antara
Komisaris dan Agen Perbatasan. Untuk terhubung ke jaringan Thread Non-CCM, Anda
dapat menetapkan PSKc
dari CLI OT Commissioner. Untuk informasi selengkapnya,
lihat Komisioning Eksternal.
Logging
Saat Anda menjalankan pi@raspberrypi: commissioner-cli
dari command line,
Komisioner OT akan membuat file commissioner.log
dalam direktori kerja
saat ini, misalnya /home/pi/commissioner.log
. Dalam 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
Memberi komisi kepada penggabung
Untuk menggunakan OT Commissioner untuk menugaskan gabungan, lihat Komisi Eksternal.