Petunjuk SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs adalah vendor pilihan bagi OEM yang mengembangkan jaringan Zigbee ke dalam produk mereka. Platform Zigbee Silicon Labs adalah solusi Zigbee yang paling terintegrasi, lengkap, dan kaya fitur yang tersedia. Silicon Labs EmberZNet SDK berisi implementasi spesifikasi tumpukan Zigbee dari Silicon Labs.

FITUR UTAMA

Sistem Zigbee

-250+ entri dalam tabel kunci tautan APS
Dukungan ZigbeeD pada Android 12 (v21.0.6113669) dan Tizen (v0.1-13.1)

Dukungan Modul xG26

Multiprotokol

Dukungan ZigbeeD dan OTBR pada OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT dengan Concurrent Listening pada MG26 untuk SoC – GA

802.15.4 Komponen prioritas penjadwal radio terpadu
Dukungan pengemasan Debian untuk aplikasi host MP – Alpha

Barang Baru

Perubahan Penting
Ukuran tabel kunci tautan APS (dikonfigurasi menggunakan SL_ZIGBEE_KEY_TABLE_SIZE) diperluas dari 127 menjadi 254 entri.

Dukungan R23 ditambahkan untuk fungsionalitas komisioning Jaringan ZDD. Fungsionalitas tunneling tersedia tanpa dukungan untuk kasus penggunaan Jaringan Lama.

Komponen Network Steering dan Network Creator telah diperbarui untuk menyertakan dukungan untuk penggabungan R23. Ini termasuk perubahan terkait berikut.
- Kebijakan permintaan Trust Center Link Key (TCLK) default telah diperbarui untuk menghasilkan kunci baru bagi setiap perangkat yang meminta. Kunci baru dibuat setiap kali perangkat yang meminta mencoba memperbarui Trust Center Link Key mereka.
- Karena perubahan kebijakan TCLK sebelumnya, komponen Keamanan Network Creator kini memerlukan komponen Kunci Tautan Keamanan. Pemutakhiran aplikasi akan diperbarui agar sesuai dengan persyaratan baru ini.
- Konfigurasi baru,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY ditambahkan untuk memungkinkan penggabungan menggunakan kunci inti yang di-hash. Konfigurasi ini ditemukan di bawah komponen Keamanan Network Creator. Penggunaan kebijakan ini memungkinkan setiap perangkat yang bergabung untuk menerima TCLK unik pasca-penggabungan, tetapi upaya berulang untuk memperbarui TCLK tidak akan menghasilkan kunci baru untuk perangkat yang meminta. Penggunaan kunci tautan yang di-hash ini merupakan kebijakan default sebelum rilis ini, dan penggunaan kebijakan ini memungkinkan Pusat Kepercayaan untuk menghindari penggunaan komponen Kunci Tautan Keamanan, yang menyimpan kunci dalam Flash.
  Catatan: Silicon Labs tidak menyarankan penggunaan kebijakan ini, karena hal ini mencegah perangkat yang bergabung untuk menggulirkan, atau memperbarui, TCLK-nya.

Set konfigurasi baru ditambahkan ke komponen zigbee_ezsp_spi untuk memungkinkan konfigurasi perangkat SPI host dan antarmuka pin-nya.
Sang mantanampproyek-proyek, termasuk proyek files (.slcps) dan folder proyek, diubah namanya menjadi pedoman penamaan Silicon Labs dan dipindahkan ke bawah direktori “projects”.

Dukungan Platform Baru

Modul baru
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Papan radio baru
- MGM260P-RB4350A
- MGM260P-RB4351A
Bagian baru
- efr32xg27
Paket Penjelajah
- BRD2709A
- MGM260P-EK2713A

Dokumentasi Baru
Panduan pengguna EZSP baru UG600 untuk rilis 8.1 dan di atasnya.

Perbaikan

Batasan SL_ZIGBEE_KEY_TABLE_SIZE diperluas hingga 254 entri.
Menambahkan zigbee_security_link_keys ke Z3Light.
Menambahkan zigbee_security_link_keys ke zigbee_mp_z3_tc_z3_tc. Memperbarui ukuran tabel kuncinya juga.
Meningkatkan ukuran tabel kunci Z3 Gateway (yang akan ditetapkan ke ncp) menjadi 20.

Masalah yang Telah Diperbaiki

Masalah yang Diketahui dalam Rilis Saat Ini

Masalah yang dicetak tebal telah ditambahkan sejak rilis sebelumnya. Jika Anda melewatkan rilis, catatan rilis terbaru tersedia di https://www.silabs.com/developers/zigbee-emberznet di tab Dokumen Teknologi.

Item yang tidak digunakan lagi

Komponen zigbee_watchdog_periodic_refresh tidak lagi digunakan dalam kerangka aplikasi Zigbee dan tidak digunakan lagi dalam rilis ini. Pengatur waktu pengawas dinonaktifkan secara default untuk semua sample applications. Akan ada komponen pengawas yang lebih baik yang ditambahkan ke SDK di masa mendatang.
Catatan: Aktifkan pengatur waktu pengawas dengan item konfigurasi SL_LEGACY_HAL_DISABLE_WATCHDOG yang disetel ke 0 di aplikasi Anda

Keterbatasan dan Pertimbangan Jaringan

Aplikasi Trust Center bawaan yang disertakan dalam rilis EmberZNet ini mampu mendukung beberapa perangkat di jaringan. Jumlah ini ditentukan berdasarkan beberapa faktor, termasuk ukuran tabel yang dikonfigurasi, penggunaan NVM, dan nilai waktu pembuatan dan waktu proses lainnya. Pengguna yang ingin membuat jaringan besar mungkin menghadapi masalah sumber daya saat mengembangkan jaringan yang lebih besar daripada yang dapat didukung aplikasi. MisalnyaampMisalnya, perangkat yang meminta Kunci Tautan Pusat Kepercayaan dari Pusat Kepercayaan dapat memicu panggilan balik sl_zigbee_af_zigbee_key_establishment_cb pada Pusat Kepercayaan dengan status h ditetapkan ke SL_ZIGBEE_KEY_TABLE_FULL, yang menunjukkan bahwa tabel kunci tidak memiliki ruang untuk menambahkan kunci baru bagi perangkat yang meminta atau bahwa NVM3 tidak memiliki ruang yang tersedia. Silicon Labs memberikan rekomendasi berikut bagi pengguna yang ingin membuat jaringan besar. Untuk aplikasi Pusat Kepercayaan, konfigurasi berikut direkomendasikan. Rekomendasi ini tidak menyeluruh, dan berfungsi sebagai dasar bagi aplikasi yang bermaksud mengembangkan jaringan besar.

Penyertaan komponen Tabel Alamat (zigbee_address_table), dengan
- item konfigurasi SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE diatur ke ukuran jaringan yang diinginkan
- nilai SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE ditetapkan ke maksimum (4)

Penyertaan komponen Kunci Tautan Keamanan (zigbee_security_link_keys), dengan
- Nilai SL_ZIGBEE_KEY_TABLE_SIZE diatur ke ukuran jaringan
Item konfigurasi berikut diatur ke ukuran jaringan yang diinginkan
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, seperti yang ditemukan di komponen Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, seperti yang ditemukan dalam komponen perutean Sumber, jika perutean sumber digunakan
Penyesuaian NVM3_DEFAULT_NVM_SIZE dan NVM3_DEFAULT_CACHE_SIZE sesuai dengan penggunaan NVM3
- Misalnya ukuran jaringan yang lebih besar dari 65 node kemungkinan memerlukan ukuran NVM3 sebesar 64K. Ukuran NVM3 default di Silicon Labs Zigbee sampAplikasi berukuran 32K. Aplikasi yang lebih banyak menggunakan NVM mungkin memerlukan penyesuaian nilai ini lebih tinggi lagi.
- Jaringan besar hingga 65 node mungkin memerlukan ukuran cache NVM3 sebesar 1200 byte; jaringan yang berkembang lebih besar dari itu mungkin memerlukan penggandaan nilai ini menjadi 2400 byte.

Penyesuaian ini hanya berlaku untuk Pusat Kepercayaan

Multiprotocol Gateway dan RCP

Barang Baru
Dukungan GA SoC yang diaktifkan untuk BLE DMP dengan Zigbee + Openthread CMP dengan mendengarkan secara bersamaan pada komponen xG26. Dukungan alfa Debian telah ditambahkan untuk aplikasi Zigbeed, OTBR, dan Z3Gateway. Zigbeed dan OTBR juga disediakan dalam format paket DEB untuk platform referensi yang dipilih (Raspberry PI 4). Lihat Menjalankan Zigbee, OpenThread, dan Bluetooth Secara Bersamaan pada Host Linux dengan Multiprotocol Co-Processor, yang terdapat di docs.silabs.com, untuk detailnya. Menambahkan dukungan Zigbeed untuk Tizen-0.1-13.1 untuk arm32 dan aarch64 serta Android 12 untuk aarch64. Informasi lebih lanjut tentang Zigbeed dapat ditemukan di docs.silabs.com. Menambahkan komponen baru “802.15.4 Unified radio scheduler priority”. Komponen ini digunakan untuk mengonfigurasi prioritas radio dari tumpukan 15.4. Komponen ini juga memerlukan komponen “radio_priority_configurator” yang baru. Komponen ini memungkinkan proyek untuk menggunakan alat Radio Priority Configurator di Simplicity Studio untuk mengonfigurasi tingkat prioritas radio dari tumpukan yang memerlukannya.

Perbaikan
Catatan aplikasi Menjalankan Zigbee, OpenThread, dan Bluetooth Secara Bersamaan pada Host Linux dengan Co-Prosesor Multiprotokol (AN1333) telah dipindahkan ke docs.silabs.comDukungan OpenWRT kini memiliki kualitas GA. Dukungan OpenWRT telah ditambahkan untuk aplikasi Zigbee, OTBR, dan Z3Gateway. Zigbee dan OTBR juga disediakan dalam format paket IPK untuk platform referensi (Raspberry PI 4). Lihat Menjalankan Zigbee, OpenThread, dan Bluetooth Secara Bersamaan pada Host Linux dengan Multiprotocol Co-Processor, yang terdapat di docs.silabs.com, untuk detailnya.

Masalah yang Telah Diperbaiki

Masalah yang Diketahui dalam Rilis Saat Ini
Masalah yang dicetak tebal ditambahkan sejak rilis sebelumnya. Jika Anda melewatkan rilis, catatan rilis terbaru tersedia di sinihttps://www.silabs.com/developers/simplicity-software-development-kit.

Item yang tidak digunakan lagi
“Multiprotocol Container” yang saat ini tersedia di DockerHub (siliconlabsinc/multiprotocol) akan dihentikan penggunaannya dalam rilis mendatang. Container tersebut tidak akan lagi diperbarui dan tidak dapat diambil dari DockerHub. Paket berbasis Debian untuk cpcd, ZigBee, dan ot-br-posix, beserta proyek yang dibuat dan dikompilasi secara native, akan menggantikan fungsionalitas yang hilang akibat penghapusan container.

Menggunakan Rilis Ini

Rilis ini berisi yang berikut:

Tumpukan Zigbee
Kerangka Aplikasi Zigbee
Zigbee Sample Aplikasi

Untuk informasi selengkapnya tentang Zigbee dan EmberZNet SDK, lihat UG103.02: Dasar-Dasar Zigbee. Jika Anda adalah pengguna pertama kali, lihat QSG180: Panduan Memulai Cepat Zigbee EmberZNet untuk SDK 7.0 dan Lebih Tinggi, untuk instruksi tentang mengonfigurasi lingkungan pengembangan Anda, membangun dan mem-flash sebagaiampaplikasi, dan referensi dokumentasi yang menunjuk ke langkah-langkah tambahan.

Instalasi dan Penggunaan
Zigbee EmberZNet SDK disediakan sebagai bagian dari Simplicity SDK, rangkaian Silicon Labs SDK. Untuk segera memulai Simplicity SDK, instal Simplicity Studio 5, yang akan menyiapkan lingkungan pengembangan Anda dan memandu Anda melalui instalasi Simplicity SDK. Simplicity Studio 5 mencakup semua yang dibutuhkan untuk pengembangan produk IoT dengan perangkat Silicon Labs, termasuk peluncur sumber daya dan proyek, alat konfigurasi perangkat lunak, IDE lengkap dengan GNU toolchain, dan alat analisis. Petunjuk instalasi disediakan dalam Panduan Pengguna Simplicity Studio 5 daring. Atau, Simplicity SDK dapat diinstal secara manual dengan mengunduh atau mengkloning versi terbaru dari GitHub. Lihat https://github.com/SiliconLabs/simplicity_sdk untuk informasi lebih lanjut. Simplicity Studio memasang Simplicity SDK secara default di:

(Jendela): C:\Pengguna\\SimplicityStudio\SDK\simplicity_sdk

(MacOS): /Pengguna//SimplicityStudio/SDK/simplicity_sdk

Dokumentasi khusus untuk versi SDK dipasang bersama SDK. Informasi tambahan sering kali dapat ditemukan di artikel basis pengetahuan (KBA). Referensi API dan informasi lain tentang rilis ini dan rilis sebelumnya tersedia di https://docs.silabs.com/.

Informasi Keamanan
Integrasi Vault Aman
Untuk aplikasi yang memilih untuk menyimpan kunci dengan aman menggunakan komponen Penyimpanan Kunci Aman pada bagian Secure Vault-High, tabel berikut menunjukkan kunci yang dilindungi dan karakteristik perlindungan penyimpanannya yang dikelola komponen Zigbee Security Manager.Kunci terbungkus yang ditandai sebagai "Non-Exportable" dapat digunakan tetapi tidak bisa viewdiedit atau dibagikan saat runtime. Kunci yang dibungkus yang ditandai sebagai "Dapat diekspor" dapat digunakan atau dibagikan saat runtime tetapi tetap dienkripsi saat disimpan dalam Flash. Aplikasi pengguna tidak perlu berinteraksi dengan sebagian besar kunci ini. API yang ada untuk mengelola kunci Link Key Table atau Transient Key masih tersedia untuk aplikasi pengguna dan tidak dirutekan melalui komponen Zigbee Security Manager.

Penasihat Keamanan
Untuk berlangganan Penasihat Keamanan, masuk ke portal pelanggan Silicon Labs, lalu pilih Beranda Akun. Klik BERANDA untuk membuka halaman beranda portal, lalu klik ubin Kelola Notifikasi. Pastikan bahwa 'Pemberitahuan Penasihat Perangkat Lunak/Keamanan & Pemberitahuan Perubahan Produk (PCN)' dicentang, dan Anda telah berlangganan minimal untuk platform dan protokol Anda. Klik Simpan untuk menyimpan setiap perubahan.

Mendukung
Pelanggan Kit Pengembangan berhak mendapatkan pelatihan dan dukungan teknis. Gunakan Laboratorium Silikon Zigbee web halaman untuk mendapatkan informasi tentang semua produk dan layanan Zigbee Silicon Labs, dan untuk mendaftar dukungan produk. Anda dapat menghubungi dukungan Silicon Laboratories di http://www.silabs.com/support.

Sertifikasi Zigbee
Rilis Ember ZNet 8.1 telah memenuhi syarat untuk Platform yang Mematuhi Zigbee untuk arsitektur SoC, NC, P, dan RCP. Ada ID sertifikasi ZCP yang terkait dengan rilis ini, silakan periksa CSA websitus di sini:
https://csa-iot.org/csa-iot_products/.

Harap dicatat bahwa sertifikasi ZCP adalah filed memposting rilis, dan membutuhkan beberapa minggu sebelum tercermin pada CSA websitus. Untuk pertanyaan lebih lanjut, silakan hubungi dukungan Silicon Laboratories di http://www.silabs.com/support.

Tanya Jawab Umum

T: Bagaimana cara memperbarui ukuran tabel kunci tautan APS di SDK?
J: Ukuran tabel kunci tautan APS dapat dikonfigurasi menggunakan parameter SL_ZIGBEE_KEY_TABLE_SIZE. Pada versi 8.1, tabel tersebut telah diperluas dari 127 menjadi 254 entri.

T: Apa saja peningkatan pada versi 8.1?
A: Versi 8.1 menghadirkan penyempurnaan seperti memperluas ukuran tabel kunci tautan APS, mengganti nama komponen, menambahkan perlindungan mutex untuk antrean peristiwa Athe pp Framework, dan banyak lagi. Lihat catatan rilis untuk daftar penyempurnaan terperinci.

T: Bagaimana cara menangani masalah yang diperbaiki di SDK?
A: Memperbaiki masalah pada SDK termasuk menyelesaikan masalah potensial dengan konfigurasi ukuran tabel tetangga, mengganti nama komponen, memperbaiki overhead rute sumber, menangani perintah ZCL, dan banyak lagi. Pastikan Anda memperbarui ke versi terbaru untuk mendapatkan manfaat dari perbaikan ini.

Dokumen / Sumber Daya

SDK Jaringan EmberZ Zigbee SILICON LABS [Bahasa Indonesia:] Instruksi
SDK Jaringan EmberZ Zigbee, SDK Jaringan EmberZ, SDK Jaringan, SDK

Referensi

Panduan Pengguna

SDK Jaringan EmberZ Zigbee SILICON LABS

Spesifikasi

Informasi Produk