SILICON LABS Zigbee EmberZ Net SDK Instructions

Silicon Labs minangka vendor pilihan kanggo OEM ngembangake jaringan Zigbee menyang produke. Platform Silicon Labs Zigbee minangka solusi Zigbee sing paling terintegrasi, lengkap, lan sugih fitur sing kasedhiya. Silicon Labs EmberZNet SDK ngemot implementasi Silicon Labs saka spesifikasi tumpukan Zigbee.

FITUR UTAMA

Zigbee

-250+ entri ing tabel tombol link APS
Dhukungan ZigbeeD ing Android 12 (v21.0.6113669) lan Tizen (v0.1-13.1)

Dhukungan modul xG26

Multiprotokol

Dhukungan ZigbeeD lan OTBR ing OpenWRT - GA
DMP BLE + CMP ZB & Matter/OT karo Ngrungokake Serempak ing MG26 kanggo SoC - GA

802.15.4 Komponen prioritas panjadwal radio terpadu
Dhukungan kemasan Debian kanggo aplikasi host MP - Alpha

Item anyar

Owah-owahan penting
Ukuran tabel tombol link APS (dikonfigurasi nggunakake SL_ZIGBEE_KEY_TABLE_SIZE) ditambahi saka 127 dadi 254 entri.

Dhukungan R23 ditambahake kanggo fungsi komisioning ZDD Network. Fungsi tunneling kasedhiya tanpa dhukungan kanggo kasus panggunaan Legacy Network.

Komponen Network Steering lan Network Creator wis dianyari kanggo nyakup dhukungan kanggo gabung karo R23. Iki kalebu owah-owahan sing gegandhengan ing ngisor iki.
- Kabijakan panyuwunan Trust Center Link Key (TCLK) standar wis dianyari kanggo ngasilake kunci anyar kanggo saben piranti sing njaluk. Tombol anyar digawe saben piranti sing njaluk nyoba nganyari Kunci Link Pusat Trust.
- Amarga owah-owahan kabijakan TCLK sadurunge, komponen Keamanan Pencipta Jaringan saiki mbutuhake komponen Kunci Link Keamanan. Nganyarke aplikasi bakal dianyari supaya cocog karo syarat anyar iki.
- Konfigurasi anyar,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY ditambahake kanggo ngidini gabung nggunakake inti, tombol hash. Konfigurasi iki ditemokake ing komponen Keamanan Pencipta Jaringan. Panggunaan kabijakan iki ngidini saben piranti gabung nampa TCLK sawise gabung unik, nanging nyoba bola-bali nganyari TCLK ora bakal ngasilake kunci anyar kanggo piranti sing njaluk. Panggunaan tombol link hash iki minangka kabijakan standar sadurunge rilis iki, lan panggunaan kabijakan iki ngidini Pusat Kepercayaan supaya ora nggawa komponen Kunci Link Keamanan, sing nyimpen kunci ing Flash.
  Cathetan: Silicon Labs ora nyaranake nggunakake kabijakan iki, amarga iki ngalangi piranti gabung saka muter, utawa nganyari, TCLKs.

A pesawat konfigurasi anyar ditambahake menyang komponen zigbee_ezsp_spi kanggo ngidini konfigurasi piranti SPI inang lan antarmuka pin sawijining.
mantanample proyèk, kalebu project files (.slcps) lan folder project, diganti jeneng kanggo Silicon Labs pedoman jeneng lan dipindhah ing "proyek" direktori.

Dhukungan Platform Anyar

Modul anyar
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Papan radio anyar
- MGM260P-RB4350A
- MGM260P-RB4351A
Bagean anyar
- efr32xg27
Kit Explorer Kab
- BRD2709A
- MGM260P-EK2713A

Dokumentasi Anyar
Pandhuan pangguna EZSP anyar UG600 kanggo release 8.1 lan ndhuwur.

dandan

Watesan SL_ZIGBEE_KEY_TABLE_SIZE ditambahi nganti 254 entri.
Nambahake zigbee_security_link_keys menyang Z3Light.
Nambahake zigbee_security_link_keys menyang zigbee_mp_z3_tc_z3_tc. Dianyari ukuran meja tombol sawijining uga.
Nambah ukuran tabel tombol Z3 Gateway (sing bakal disetel menyang ncp) dadi 20.

Masalah tetep

Masalah sing Dikenal ing Rilis Saiki

Masalah ing kandel ditambahake wiwit rilis sadurunge. Yen sampeyan wis ora kejawab release, cathetan release anyar kasedhiya ing https://www.silabs.com/developers/zigbee-emberznet ing tab Tech Docs.

Item sing ora digunakake

Komponen zigbee_watchdog_periodic_refresh ora digunakake maneh ing kerangka aplikasi Zigbee lan ora digunakake maneh ing rilis iki. Timer watchdog dipateni kanthi gawan kanggo kabeh sample aplikasi. Bakal ana komponen pengawas sing luwih apik sing ditambahake menyang SDK ing mangsa ngarep.
Cathetan: Aktifake timer pengawas kanthi item konfigurasi SL_LEGACY_HAL_DISABLE_WATCHDOG disetel dadi 0 ing aplikasi sampeyan

Watesan lan Watesan Jaringan

Aplikasi Trust Center standar sing dikirim karo rilis EmberZNet iki bisa ndhukung sawetara piranti ing jaringan. Nomer iki ditemtokake adhedhasar sawetara faktor, kalebu ukuran tabel sing dikonfigurasi, panggunaan NVM, lan nilai wektu lan wektu generasi liyane. Pangguna sing pengin nggawe jaringan gedhe bisa ngadhepi masalah sumber daya nalika ngembangake jaringan luwih gedhe tinimbang sing bisa didhukung aplikasi. Kanggo exampNanging, piranti sing njaluk Trust Center Link Key saka Trust Center bisa micu sl_zigbee_af_zigbee_key_establishment_cb callback ing Trust Center kanthi status h disetel menyang SL_ZIGBEE_KEY_TABLE_FULL, nuduhake yen tabel tombol ora duwe ruang kanggo nambah tombol anyar kanggo piranti sing njaluk utawa sing. NVM3 ora duwe papan sing kasedhiya. Silicon Labs nyedhiyakake rekomendasi ing ngisor iki kanggo pangguna sing pengin nggawe jaringan gedhe. Kanggo aplikasi Trust Center, dianjurake konfigurasi ing ngisor iki. Rekomendasi kasebut ora lengkap, lan dadi dhasar kanggo aplikasi sing pengin tuwuh jaringan gedhe.

Gawan komponen Tabel Alamat (zigbee_address_table), karo
- item konfigurasi SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE disetel menyang ukuran jaringan sing dikarepake
- nilai SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE disetel maksimal (4)

Gawan komponen Keamanan Link Keys (zigbee_security_link_keys), karo
- Nilai SL_ZIGBEE_KEY_TABLE_SIZE disetel menyang ukuran jaringan
Item konfigurasi ing ngisor iki disetel menyang ukuran jaringan sing dikarepake
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kaya sing ditemokake ing komponen Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kaya sing ditemokake ing komponen nuntun Sumber, yen nuntun sumber digunakake
Pangaturan NVM3_DEFAULT_NVM_SIZE lan NVM3_DEFAULT_CACHE_SIZE miturut panggunaan NVM3
- Contone, ukuran jaringan luwih saka 65 node mbutuhake ukuran NVM3 64K. Ukuran standar NVM3 ing Silicon Labs Zigbee sample aplikasi iku 32K. Aplikasi sing nggunakake NVM luwih akeh mbutuhake nyetel nilai iki malah luwih dhuwur.
- Jaringan gedhe nganti 65 simpul mbutuhake ukuran cache NVM3 1200 bait; jaringan sing akeh luwih gedhe tinimbang sing mbutuhake tikel kaping pindho Nilai iki kanggo 2400 bita.

Pangaturan kasebut mung ditrapake kanggo Pusat Trust

Multiprotocol Gateway lan RCP

Item anyar
Dhukungan GA SoC kanggo BLE DMP kanthi Zigbee + Openthread CMP kanthi ngrungokake bebarengan ing bagean xG26. Dhukungan alpha Debian wis ditambahake kanggo aplikasi Zigbeed, OTBR, lan Z3Gateway. Zigbeed lan OTBR kasedhiya ing format paket DEB kanggo platform referensi sing dipilih (Raspberry PI 4) uga. Deleng Mlaku Zigbee, OpenThread, lan Bluetooth Bebarengan ing Host Linux kanthi Co-Processor Multiprotocol, ditemokake ing docs.silabs.com, kanggo rincian. Dhukungan Zigbeed ditambahake kanggo Tizen-0.1-13.1 kanggo arm32 lan aarch64 uga Android 12 kanggo aarch64. Informasi liyane babagan Zigbeed bisa ditemokake ing docs.silabs.com. Added anyar "802.15.4 Unified radio scheduler priority" komponen. Komponen iki digunakake kanggo ngatur prioritas radio saka tumpukan 15.4. Komponen kasebut uga mbutuhake komponen "radio_priority_configurator" anyar. Komponen iki ngidini proyek nggunakake alat Radio Priority Configurator ing Simplicity Studio kanggo ngatur tingkat prioritas radio saka tumpukan sing mbutuhake.

dandan
Cathetan aplikasi Nganggo Zigbee, OpenThread, lan Bluetooth Bebarengan ing Host Linux kanthi Co-Processor Multiprotocol (AN1333) wis dipindhah menyang docs.silabs.com. Dhukungan OpenWRT saiki dadi kualitas GA. Dhukungan OpenWRT wis ditambahake kanggo aplikasi Zigbee, OTBR, lan Z3Gateway. Zigbeed lan OTBR kasedhiya ing format paket IPK kanggo platform referensi (Raspberry PI 4) uga. Deleng Mlaku Zigbee, OpenThread, lan Bluetooth Bebarengan ing Host Linux kanthi Co-Processor Multiprotocol, ditemokake ing docs.silabs.com, kanggo rincian.

Masalah tetep

Masalah sing Dikenal ing Rilis Saiki
Masalah ing kandel ditambahake wiwit rilis sadurunge. Yen sampeyan ora kejawab rilis, cathetan rilis anyar kasedhiya oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Item sing ora digunakake
"Multiprotocol Container" sing saiki kasedhiya ing DockerHub (siliconlabsinc / multiprotocol) bakal ora digunakake ing rilis sing bakal teka. Wadah kasebut ora bakal dianyari maneh lan bisa ditarik saka DockerHub. Paket basis Debian kanggo cpcd, ZigBee, lan ot-br-posix, bebarengan karo proyek sing digawe asli lan dikompilasi, bakal ngganti fungsi sing ilang kanthi mbusak wadhah kasebut.

Nggunakake Rilis Iki

Rilis iki ngemot ing ngisor iki:

Tumpukan Zigbee
Kerangka Aplikasi Zigbee
Zigbee Sample Aplikasi

Kanggo informasi luwih lengkap babagan Zigbee lan EmberZNet SDK pirsani UG103.02: Zigbee Fundamentals. Yen sampeyan pangguna pisanan, ndeleng QSG180: Zigbee EmberZNet Quick-Start Guide kanggo SDK 7.0 lan luwih dhuwur, kanggo instruksi babagan konfigurasi lingkungan pangembangan, mbangun lan sumunar minangkaample aplikasi, lan referensi dokumentasi nuding langkah-langkah ext.

Instalasi lan Gunakake
SDK Zigbee EmberZNet diwenehake minangka bagéan saka SDK Kesederhanaan, suite SDK Silicon Labs. Kanggo miwiti kanthi cepet ing Simplicity SDK, instal Simplicity Studio 5, sing bakal nyiyapake lingkungan pangembangan sampeyan lan nuntun sampeyan liwat instalasi Simplicity SDK. Simplicity Studio 5 kalebu kabeh sing dibutuhake kanggo pangembangan produk IoT karo piranti Silicon Labs, kalebu sumber daya lan peluncur proyek, piranti konfigurasi piranti lunak, IDE lengkap karo toolchain GNU, lan alat analisis. Pandhuan instalasi kasedhiya ing Pandhuan pangguna Simplicity Studio 5 online. Utawa, Simplicity SDK bisa diinstal kanthi manual kanthi ngundhuh utawa kloning paling anyar saka GitHub. Delengen https://github.com/SiliconLabs/simplicity_sdk kanggo informasi luwih lengkap. Simplicity Studio nginstal Simplicity SDK kanthi standar ing:

(Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk

Dokumentasi khusus kanggo versi SDK diinstal nganggo SDK. Informasi tambahan asring ditemokake ing artikel basis pengetahuan (KBA). Referensi API lan informasi liyane babagan iki lan rilis sadurungé kasedhiya ing https://docs.silabs.com/.

Informasi Keamanan
Integrasi Vault Aman
Kanggo aplikasi sing milih nyimpen tombol kanthi aman nggunakake komponen Panyimpenan Kunci Aman ing bagean Secure Vault-High, tabel ing ngisor iki nuduhake tombol sing dilindhungi lan karakteristik proteksi panyimpenan sing dikelola komponen Zigbee Security Manager.Tombol sing dibungkus sing ditandhani minangka "Non-Exportable" bisa digunakake nanging ora bisa digunakake viewed utawa dienggo bareng nalika runtime. Tombol kebungkus sing ditandhani minangka "Exportable" bisa digunakake utawa dienggo bareng nalika runtime nanging tetep ndhelik nalika disimpen ing Flash. Aplikasi pangguna ora perlu sesambungan karo mayoritas tombol kasebut. API sing wis ana kanggo ngatur tombol Link Key Table utawa Transient Keys isih kasedhiya kanggo aplikasi pangguna lan nare ow routed liwat komponen Zigbee Security Manager.

Penasihat Keamanan
Kanggo langganan Security Advisories, mlebu menyang portal pelanggan Silicon Labs, banjur pilih Akun Ngarep. Klik HOME kanggo pindhah menyang kaca ngarep portal banjur klik kothak Ngatur Notifikasi. Priksa manawa 'Software/Security Advisory Notice & Product Change Notice (PCNs)' dicenthang, lan sampeyan wis langganan minimal kanggo platform lan protokol sampeyan. Klik Simpen kanggo nyimpen owah-owahan.

Dhukungan
Pelanggan Development Kit layak kanggo latihan lan dhukungan teknis. Gunakake Silicon Laboratories Zigbee web kaca kanggo njupuk informasi babagan kabeh produk lan layanan Silicon Labs Zigbee, lan kanggo ndhaptar dhukungan produk. Sampeyan bisa hubungi dhukungan Silicon Laboratories ing http://www.silabs.com/support.

Sertifikasi Zigbee
Rilis Ember ZNet 8.1 wis mumpuni kanggo Zigbee Compliant Platform kanggo arsitektur SoC, NC, P, lan RCP ana ID sertifikasi ZCP sing ana gandhengane karo rilis iki, priksa CSA websitus kene:
https://csa-iot.org/csa-iot_products/.

Elinga yen sertifikasi ZCP yaiku filed ngirim release, lan njupuk sawetara minggu sadurunge njupuk dibayangke ing CSA websitus. Kanggo pitakon liyane, hubungi dhukungan Silicon Laboratories ing http://www.silabs.com/support.

Pitakonan

P: Kepiye carane nganyari ukuran tabel kunci link APS ing SDK?
A: Ukuran tabel tombol link APS bisa dikonfigurasi nggunakake parameter SL_ZIGBEE_KEY_TABLE_SIZE. Ing versi 8.1, wis ditambahi saka 127 dadi 254 entri.

P: Apa dandan ing versi 8.1?
A: Versi 8.1 nggawa dandan kayata nggedhekake ukuran tabel tombol link APS, ngganti jeneng komponen, nambah proteksi mutex kanggo antrian acara Athe pp Framework, lan liya-liyane. Deleng cathetan rilis kanggo dhaptar dandan sing rinci.

P: Kepiye cara nangani masalah tetep ing SDK?
A: Ndandani masalah ing SDK kalebu ngrampungake masalah potensial karo konfigurasi ukuran meja pepadhamu, ngganti jeneng komponen, ndandani nduwur sirah rute sumber, nangani perintah ZCL, lan liya-liyane. Priksa manawa sampeyan nganyari menyang versi paling anyar kanggo entuk manfaat saka perbaikan kasebut.

Dokumen / Sumber Daya

SILICON LABS Zigbee EmberZ Net SDK [pdf] Pandhuan
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referensi

Manual pangguna

SILICON LABS Zigbee EmberZ Net SDK

Spesifikasi

Informasi produk