Build dan Konfigurasi OpenThread Commissioner

Lihat sumber di GitHub

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

Menyiapkan OT Commissioner

1. Clone repositori OT Commissioner:

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

2. Instal dependensi:

   cd ot-commissioner
   ./script/bootstrap.sh
   

Membangun OT Commissioner

OT Commissioner diinstal ke direktori /usr/local. Jika Anda ingin mengubah direktori penginstalan Anda, setel -DCMAKE_INSTALL_PREFIX.

Catatan: Jika mengubah direktori penginstalan default, Anda harus mengupdate $PATH untuk menjalankan commissioner-cli. Panduan ini menggunakan variabel Lingkungan untuk berfungsi baik untuk penginstalan default maupun kustom.

1. Build OT Commissioner:

   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
   

Instal OT Commissioner

OT Commissioner menginstal berikut ini ke direktori penginstalan Anda:

• File header dan library OT Commissioner
• Biner CLI Commissioner OT yang dapat dieksekusi
• File konfigurasi dan kredensial default
• Skrip untuk menjalankan CLI Commissioner OT 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 baris perintah.

commissioner-cli -h

Konfigurasi

OT Commissioner CLI mendukung Mode Commissioning Komersial Thread 1.2 (CCM) dan commissioning Thread 1.1 (Non-CCM). Untuk terhubung ke Thread lain jaringan, 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 Thread Non-CCM Jaringan.

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

Konfigurasi CCM

Untuk terhubung ke jaringan Thread CCM, 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 trust anchor dalam format PEM.

File kunci dan sertifikat ini digunakan untuk membuat sesi yang aman di antara Commissioner dan Agen Perbatasan.

Catatan: Jika mengubah direktori penginstalan default, Anda harus Perbarui "ThreadSMRoot" : "/usr/local/etc/commissioner".

Konfigurasi non-CCM

Kunci yang Dibagikan Sebelumnya PSKc digunakan untuk membuat sesi yang aman antara Commissioner dan Agen Perbatasan. Agar terhubung ke jaringan Thread Non-CCM, Anda dapat menetapkan PSKc Anda dari OT Commissioner CLI. Untuk informasi selengkapnya, lihat Penetapan Komisi Eksternal.

Logging

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

Muat konfigurasi

Untuk memulai OT Commissioner dengan setelan konfigurasi Anda:

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

Catatan: Jika Anda menggunakan setelan konfigurasi default di non-ccm-config.json, Anda tidak perlu meneruskannya ke commissioner-cli.

Memberikan tugas untuk bergabung

Untuk menggunakan OT Commissioner guna meminta penggabungan, lihat Eksternal Commissioning.