Panduan ini mencakup build dasar dan konfigurasi OpenThread Commissioner (OT Commissioner). Setelah menyelesaikan prosedur ini, Anda akan memiliki file CLI OT Commissioner yang dapat dieksekusi dan library Commissioner statis.
Menyiapkan Komisaris OT
Clone repositori OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
Instal dependensi:
cd ot-commissioner
./script/bootstrap.sh
Membuat Komisaris OT
OT Commissioner menginstal ke direktori /usr/local
. Jika ingin mengubah
direktori penginstalan, tetapkan -DCMAKE_INSTALL_PREFIX
.
Membuat Komisaris OT:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Buat variabel Lingkungan untuk menjalankan
commissioner-cli
di langkah berikutnya:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Opsional. Jalankan pengujian unit:
./tests/commissioner-test
Menginstal Komisaris OT
OT Commissioner menginstal yang berikut ke direktori penginstalan Anda:
- Library dan file header OT Commissioner
- Biner eksekusi yang dapat dijalankan CLI OT Komisaris
- File konfigurasi dan kredensial 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
OT Commissioner CLI mendukung Thread 1.2 Commercial Commissioning Mode (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 contoh file di repositori GitHub komisaris.
Konfigurasi CCM
Agar dapat terhubung ke jaringan CCM Thread, perbarui kolom berikut 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 Commissioner dan Border Agent.
Konfigurasi non-CCM
Kunci Pra-Dibagikan PSKc
digunakan untuk membuat sesi yang aman antara
Komisioner dan Agen Batas. Untuk terhubung ke jaringan Thread Non-CCM, Anda
dapat menetapkan PSKc
dari CLI OT Commissioner. Untuk mengetahui 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
. 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
Membuat komisi joiner
Untuk menggunakan Komisaris OT untuk membuat komisi penggabung, lihat Komisi Eksternal.