1. Pengantar
OpenThread, dirilis oleh tim Google Nest, adalah implementasi open source protokol jaringan Thread® yang dirancang untuk mempercepat pengembangan produk untuk rumah yang terhubung. Thread Specification menentukan protokol komunikasi nirkabel yang andal, aman, dan berdaya rendah berbasis IPv6 untuk aplikasi bangunan rumah dan komersial.
Espressif telah mem-porting stack OpenThread berdasarkan FreeRTOS dan LwIP, yang memungkinkan developer membuat jaringan Thread dengan cepat. Kode sumber terkait dapat diperoleh dari GitHub. Pada saat yang sama, Espressif juga telah menerapkan Router Pembatas Thread berdasarkan RTOS.
Dalam Codelab ini, Anda akan memprogram OpenThread di hardware sungguhan, membuat dan mengelola jaringan Thread, serta meneruskan pesan antar-node.
Yang akan Anda pelajari
- Membuat dan melakukan flash biner OpenThread CLI ke board ESP.
- Mem-build dan mem-flash router pembatas ke papan Router Pembatas ESP Thread.
- Mengelola node Thread secara manual dengan ESP Monitor dan OpenThread CLI.
- Membentuk jaringan Thread pada Router Pembatas Thread.
- Mengamankan commissioning perangkat ke jaringan Thread.
- Mem-ping alamat IPv6 antar-node Thread.
- Meneruskan pesan antara node Thread dengan UDP.
Yang akan Anda perlukan
Perangkat keras:
Software:
2. Memulai
- Penginstalan ESP-IDF.
Ikuti Panduan Pemrograman ESP-IDF untuk menginstal lingkungan pengembangan software.
- Buat clone ESP Thread Border Router SDK.
ESP- platform-BR adalah ESP Thread Border Router SDK resmi. Platform ini mendukung semua fitur jaringan dasar untuk membuat Thread Border Router dan mengintegrasikan fitur tingkat produk yang lengkap untuk produkisasi cepat.
$ cd <your-local-workspace> $ git clone --recursive https://github.com/espressif/esp-thread-br.git
3. Mem-build dan melakukan flash
Untuk membuat dan melakukan flash file biner ot-cli-ftd di board ESP dengan modul IEEE 802.15.4, Anda dapat melihat contoh ESP-IDF ot_cli untuk detail selengkapnya:
$ cd <your-idf-path>/examples/openthread/ot_cli $ idf.py set-target <your-board-type>
Aktifkan fitur joiner melalui menuconfig:
$ idf.py menuconfig
Konfigurasi komponen > OpenThread > Aktifkan Joiner, lalu build dan flash.
$ idf.py -p <your-local-port> build flash monitor
Untuk membangun dan mem-flash file biner ot-br di ESP Thread Border Router Board, Anda harus membuat file biner RCP terlebih dahulu. File biner RCP ini tidak perlu di-flash secara eksplisit ke perangkat di ESP Thread Border Router Board. Ini akan disertakan dalam file biner Border Router dan di-flash ke chip ESP32-H2 pada saat booting pertama (atau firmware RCP berubah). Anda dapat melihat dokumen ESP Thread BR untuk detail selengkapnya:
$ cd <your-idf-path>/examples/openthread/ot_rcp $ idf.py set-target esp32h2 $ idf.py build $ cd <your-esp-thread-br-path>/examples/basic_thread_border_router $ idf.py set-target esp32s3
Aktifkan fitur Commissioner melalui menuconfig:
$ idf.py menuconfig
Konfigurasi komponen > OpenThread > Aktifkan Commissioner, lalu build dan flash.
$ idf.py -p <your-local-port> build flash monitor
4. Membentuk jaringan Thread pada Router Pembatas Thread
Sekarang Anda dapat membuat jaringan Thread menggunakan command line OpenThread di ESP Thread Border Router Board (BR Commissioner):
## BR Commissioner ## ---------------------- > dataset init new Done > dataset Active Timestamp: 1 Channel: 21 Channel Mask: 0x07fff800 Ext PAN ID: 151975d11bea97b5 Mesh Local Prefix: fd6a:b54b:d6a3:b05a::/64 Network Key: 731ab6a60a64a0a0b14b259b86b2be01 Network Name: OpenThread-1444 PAN ID: 0x1444 PSKc: 54e7f18d2575014da94db09df29c5df0 Security Policy: 672 onrc 0 Done
Commit set data ini sebagai set data aktif:
> dataset commit active Done
Tampilkan antarmuka IPv6:
> ifconfig up I (59329) OPENTHREAD: Platform UDP bound to port 49153 Done I (59329) OT_STATE: netif up
Mulai operasi protokol Thread:
> thread start I(61709) OPENTHREAD:[N] Mle-----------: Role disabled -> detached Done > I(62469) OPENTHREAD:[N] Mle-----------: Attach attempt 1, AnyPartition reattaching with Active Dataset I(69079) OPENTHREAD:[N] RouterTable---: Allocate router id 11 I(69079) OPENTHREAD:[N] Mle-----------: RLOC16 fffe -> 2c00 I(69089) OPENTHREAD:[N] Mle-----------: Role detached -> leader I(69089) OPENTHREAD:[N] Mle-----------: Partition ID 0x28b518c6 I (69099) OPENTHREAD: Platform UDP bound to port 49154
Setelah beberapa saat, periksa status perangkat. Seharusnya seorang Pemimpin.
> state leader Done >
5. Bergabung ke jaringan Thread melalui kunci jaringan
Dalam codelab ini, dua papan ESP dengan modul IEEE 802.15.4 disiapkan untuk bergabung dengan jaringan yang dibentuk oleh BR. Dalam sesi ini, kita akan menambahkan Board1 ke jaringan.
Dapatkan kunci jaringan dari BR:
## BR Commissioner ## ---------------------- > networkkey 731ab6a60a64a0a0b14b259b86b2be01 Done >
Setel kunci jaringan ini ke satu papan ESP (Board1 Joiner) dengan modul IEEE 802.15.4:
## Board1 Joiner ## ---------------------- > dataset networkkey 731ab6a60a64a0a0b14b259b86b2be01 Done
Commit set data ini sebagai set data aktif:
> dataset commit active Done
Tampilkan antarmuka IPv6:
> ifconfig up Done I (20308) OT_STATE: netif up
Mulai operasi protokol Thread:
> thread start I(23058) OPENTHREAD:[N] Mle-----------: Role disabled -> detached Done > I(23408) OPENTHREAD:[N] Mle-----------: Attach attempt 1, AnyPartition reattaching with Active Dataset I(30028) OPENTHREAD:[N] Mle-----------: Attach attempt 1 unsuccessful, will try again in 0.288 seconds I(30328) OPENTHREAD:[N] Mle-----------: Attach attempt 2, AnyPartition I(33498) OPENTHREAD:[N] Mle-----------: Delay processing Announce - channel 21, panid 0x1444 I(33758) OPENTHREAD:[N] Mle-----------: Processing Announce - channel 21, panid 0x1444 I(33758) OPENTHREAD:[N] Mle-----------: Role detached -> disabled I(33758) OPENTHREAD:[N] Mle-----------: Role disabled -> detached I(34178) OPENTHREAD:[N] Mle-----------: Attach attempt 1, AnyPartition I(35068) OPENTHREAD:[N] Mle-----------: RLOC16 fffe -> 2c01 I(35068) OPENTHREAD:[N] Mle-----------: Role detached -> child
Setelah beberapa saat, periksa status perangkat. Konten tersebut harus Turunan.
> state child Done
Setel peran ke Router.
> state router Done I(51028) OPENTHREAD:[N] Mle-----------: RLOC16 2c01 -> 2800 I(51028) OPENTHREAD:[N] Mle-----------: Role child -> router I(51028) OPENTHREAD:[N] Mle-----------: Partition ID 0x28b518c6 >
6. Bergabung ke jaringan Thread melalui commissioning yang aman
Dalam sesi ini, kita akan menambahkan Board2 ke jaringan melalui commissioning keamanan:
Dapatkan PSKc dan panid dari Komisaris BR:
## BR Commissioner ## ---------------------- > pskc 54e7f18d2575014da94db09df29c5df0 Done > panid 0x1444 Done
Konfigurasi informasi jaringan ke Board2:
## Board2 Joiner ## ---------------------- > dataset pskc 54e7f18d2575014da94db09df29c5df0 Done > dataset panid 0x1444 Done
Commit set data ini sebagai set data aktif:
## Board2 Joiner ## ---------------------- > dataset commit active Done
Tampilkan antarmuka IPv6:
## Board2 Joiner ## ---------------------- > ifconfig up Done I (29146) OT_STATE: netif up
Dapatkan eui64 dari Board2:
## Board2 Joiner ## ---------------------- > eui64 4831b7fffec02be1 Done
Di bagian BR Commissioner, mulai Commissioner dan tentukan eui64
perangkat yang dapat bergabung, beserta Kredensial Joiner, misalnya J01NME
. Kredensial Joiner adalah string khusus perangkat dari semua karakter alfanumerik huruf besar (0-9 dan A-Y, tidak termasuk I, O, Q, dan Z untuk keterbacaan), dengan panjang antara 6 dan 32 karakter.
## BR Commissioner ## ---------------------- > commissioner start Commissioner: petitioning Done Commissioner: active > commissioner joiner add 4831b7fffec02be1 J01NME Done
Beralihlah ke Board2 Joiner. Mulai peran joiner dengan Kredensial Joiner yang baru saja Anda siapkan di BR Commissioner:
## Board2 Joiner ## ---------------------- > ifconfig up Done > joiner start J01NME Done
Dalam waktu sekitar satu menit, Anda akan mendapatkan konfirmasi autentikasi berhasil:
## Board2 Joiner ## ---------------------- > Join success
Setelah itu, Anda dapat memulai dan bergabung ke jaringan Thread yang dibentuk oleh Komisaris BR.
Mulai operasi protokol Thread:
> thread start I(35727) OPENTHREAD:[N] Mle-----------: Role disabled -> detached Done > I(36197) OPENTHREAD:[N] Mle-----------: Attach attempt 1, AnyPartition reattaching with Active Dataset I(37007) OPENTHREAD:[N] Mle-----------: RLOC16 fffe -> 2801 I(37007) OPENTHREAD:[N] Mle-----------: Role detached -> child
Setel peran ke Router.
> state router Done I(46057) OPENTHREAD:[N] Mle-----------: RLOC16 2801 -> 4400 I(46057) OPENTHREAD:[N] Mle-----------: Role child -> router I(46057) OPENTHREAD:[N] Mle-----------: Partition ID 0x28b518c6 >
Sekarang, Anda mendapatkan jaringan Thread dengan topologi yang ditunjukkan di bawah:
7. Mem-ping alamat IPv6 antar-node Thread
Anda dapat menggunakan perintah {i>ping<i} untuk berkomunikasi antara dua {i>board<i}. Gunakan perintah ipaddr
untuk mencetak alamat IPv6 setiap board:
## BR Commissioner ## ---------------------- > ipaddr fd6a:b54b:d6a3:b05a:0:ff:fe00:fc00 # Leader Anycast Locator (ALOC) fd6a:b54b:d6a3:b05a:0:ff:fe00:2c00 # Routing Locator (RLOC) fd6a:b54b:d6a3:b05a:a8df:eb43:63d8:bda0 # Mesh-Local EID (ML-EID) fe80:0:0:0:687c:7248:cc14:9c4d # Link-Local Address (LLA) Done >
## Board1 Joiner ## ---------------------- > ipaddr fd6a:b54b:d6a3:b05a:0:ff:fe00:2800 # Routing Locator (RLOC) fd6a:b54b:d6a3:b05a:e461:db08:c833:1248 # Mesh-Local EID (ML-EID) fe80:0:0:0:18ac:df04:4671:6a45 # Link-Local Address (LLA) Done
## Board2 Joiner ## ---------------------- > ipaddr fd6a:b54b:d6a3:b05a:0:ff:fe00:4400 # Routing Locator (RLOC) fd6a:b54b:d6a3:b05a:d7dc:8e90:9bc9:ecbc # Mesh-Local EID (ML-EID) fe80:0:0:0:a8cc:1483:f696:91a2 # Link-Local Address (LLA) Done
Misalnya, untuk melakukan ping ke Board2 MLE-ID dari BR Commissioner, Anda dapat menjalankan perintah ini di BR Commissioner:
## BR Commissioner ## ---------------------- > ping fd6a:b54b:d6a3:b05a:d7dc:8e90:9bc9:ecbc 16 bytes from fd6a:b54b:d6a3:b05a:d7dc:8e90:9bc9:ecbc: icmp_seq=1 hlim=255 time=123ms 1 packets transmitted, 1 packets received. Packet loss = 0.0%. Round-trip min/avg/max = 123/123.0/123 ms. Done
8. Meneruskan pesan antara node Thread dengan UDP
Dalam sesi ini, Anda akan mempelajari cara mengirim pesan antara dua perangkat Thread. Misalnya, buka udp dan ikat di port 20617
lalu proses semua alamat di BR:
## BR Commissioner ## ---------------------- > udp open Done > udp bind :: 20617 I (1298739) OPENTHREAD: Platform UDP bound to port 20617 Done
Kemudian, kirim pesan dari Board1 ke alamat MLE-ID dan port 20617
:
## Board1 Joiner ## ---------------------- > udp open Done > udp send fd6a:b54b:d6a3:b05a:a8df:eb43:63d8:bda0 20617 ESP
Anda dapat melihat pesan yang diterima di BR:
## BR Commissioner ## ---------------------- 3 bytes from fd6a:b54b:d6a3:b05a:e461:db08:c833:1248 49154 ESP
9. Selamat!
Anda telah membuat jaringan Thread fisik menggunakan papan ESP.
Anda sekarang mengetahui:
- Membuat dan melakukan flash biner OpenThread CLI ke board ESP.
- Membuat router pembatas yang berkedip ke board ESP Thread Border Router.
- Mengelola node Thread secara manual dengan ESP Monitor dan OpenThread CLI.
- Membentuk jaringan Thread pada Router Pembatas Thread.
- Mengamankan commissioning perangkat ke jaringan Thread.
- Mem-ping alamat IPv6 antar-node Thread.
- Meneruskan pesan antara node Thread dengan UDP.
Bacaan lebih lanjut
Lihat openthread.io dan GitHub untuk berbagai resource OpenThread, termasuk:
- Platform yang Didukung — temukan semua platform yang mendukung OpenThread
- Mem-build OpenThread — detail lebih lanjut tentang cara mem-build dan mengonfigurasi OpenThread
- Thread Primer — mencakup semua konsep Thread yang ditampilkan dalam Codelab ini
Referensi: