Návod SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs je výberovým dodávateľom pre výrobcov OEM, ktorí do svojich produktov vyvíjajú siete Zigbee. Platforma Silicon Labs Zigbee je najintegrovanejšie, najkompletnejšie a na funkcie najbohatšie dostupné riešenie Zigbee. Silicon Labs EmberZNet SDK obsahuje implementáciu špecifikácie zásobníka Zigbee od Silicon Labs.

KĽÚČOVÉ VLASTNOSTI

Zigbee

-250+ záznamov v tabuľke kľúčov prepojenia APS
Podpora ZigbeeD v systéme Android 12 (v21.0.6113669) a Tizen (v0.1-13.1)

Podpora modulu xG26

Multiprotokol

Podpora ZigbeeD a OTBR na OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT so súbežným počúvaním na MG26 pre SoC – GA

802.15.4 Jednotný prioritný komponent rádiového plánovača
Podpora balíkov Debianu pre hostiteľské aplikácie MP – Alpha

Nové položky

Dôležité zmeny
Veľkosť tabuľky kľúčov prepojenia APS (konfigurovaná pomocou SL_ZIGBEE_KEY_TABLE_SIZE) sa rozšíri zo 127 na 254 položiek.

Podpora R23 je pridaná pre funkčnosť spúšťania siete ZDD. Funkcia tunelovania je k dispozícii bez podpory pre prípady použitia Legacy Network.

Komponenty Network Steering a Network Creator boli aktualizované, aby zahŕňali podporu pre pripojenie R23. Patria sem nasledujúce súvisiace zmeny.
- Predvolená politika požiadaviek na kľúč Trust Center Link Key (TCLK) bola aktualizovaná tak, aby generovala nové kľúče pre každé žiadajúce zariadenie. Nový kľúč sa vygeneruje vždy, keď sa žiadajúce zariadenia pokúsia aktualizovať svoj kľúč prepojenia centra dôveryhodnosti.
- Kvôli predchádzajúcej zmene politiky TCLK komponent Network Creator Security teraz vyžaduje komponent Security Link Keys. Aktualizácia aplikácií bude aktualizovaná tak, aby vyhovovala tejto novej požiadavke.
- Nová konfigurácia,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY je pridaný, aby sa umožnilo pripojenie pomocou základného hašovaného kľúča. Táto konfigurácia sa nachádza pod komponentom Network Creator Security. Použitie tejto politiky umožňuje každému pripájajúcemu sa zariadeniu prijať po pripojení jedinečný TCLK, ale opakované pokusy o aktualizáciu TCLK nepovedú k novému kľúču pre žiadajúce zariadenie. Toto používanie kľúčov hašovaných odkazov bolo pred týmto vydaním predvolenou zásadou a používanie tejto zásady umožňuje Centru dôveryhodnosti vyhnúť sa použitiu komponentu Kľúče bezpečnostného prepojenia, ktorý ukladá kľúče vo formáte Flash.
  Poznámka: Spoločnosť Silicon Labs neodporúča používať túto zásadu, pretože bráni pripájaniu zariadení v rolovaní alebo aktualizácii ich TCLK.

Do komponentu zigbee_ezsp_spi je pridaná nová konfiguračná sada, ktorá umožňuje konfiguráciu hostiteľského SPI zariadenia a jeho pinových rozhraní.
Bývalýample projektov vrátane projektu files (.slcps) a priečinok projektu sú premenované na pokyny pre pomenovanie Silicon Labs a presunuté do adresára „projects“.

Podpora novej platformy

Nové moduly
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nové rádiové dosky
- MGM260P-RB4350A
- MGM260P-RB4351A
Nová časť
- efr32xg27
Prieskumnícka súprava
- BRD2709A
- MGM260P-EK2713A

Nová dokumentácia
Nové používateľské príručky EZSP UG600 pre vydania 8.1 a vyššie.

Vylepšenia

Limity SL_ZIGBEE_KEY_TABLE_SIZE sa rozšírili až na 254 položiek.
Do Z3Light boli pridané kľúče zigbee_security_link_keys.
Do zigbee_mp_z3_tc_z3_tc boli pridané kľúče zigbee_security_link_keys. Aktualizovala sa aj veľkosť tabuľky kľúčov.
Veľkosť tabuľky kľúčov brány Z3 (ktorá bude nastavená na ncp) sa zvýšila na 20.

Opravené problémy

Známe problémy v aktuálnom vydaní

Problémy označené tučným písmom boli pridané od predchádzajúceho vydania. Ak ste zmeškali vydanie, posledné poznámky k vydaniu sú k dispozícii na adrese https://www.silabs.com/developers/zigbee-emberznet na karte Technické dokumenty.

Zastarané položky

Komponent zigbee_watchdog_periodic_refresh sa už nepoužíva v aplikačnom rámci Zigbee av tomto vydaní je zastaraný. Časovač watchdog je predvolene vypnutý pre všetky sampaplikácie. V budúcnosti bude do SDK pridaný vylepšený komponent watchdog.
Poznámka: Povoľte časovač watchdog s konfiguračnou položkou SL_LEGACY_HAL_DISABLE_WATCHDOG nastavenou na 0 vo vašej aplikácii

Obmedzenia siete a úvahy

Predvolené aplikácie Trust Center, ktoré sa dodávajú s týmto vydaním EmberZNet, sú schopné podporovať niekoľko zariadení v sieti. Toto číslo je určené na základe niekoľkých faktorov vrátane nakonfigurovaných veľkostí tabuliek, využitia NVM a iných hodnôt doby generovania a doby spustenia. Používatelia, ktorí chcú vytvoriť veľké siete, môžu čeliť problémom so zdrojmi, keď sa sieť zväčšuje, ako môže aplikácia podporovať. Naprample, zariadenie požadujúce kľúč prepojenia centra dôveryhodnosti z centra dôveryhodnosti môže spustiť spätné volanie sl_zigbee_af_zigbee_key_establishment_cb v centre dôveryhodnosti so stavom h nastaveným na SL_ZIGBEE_KEY_TABLE_FULL, čo naznačuje, že tabuľka kľúčov nemá priestor na pridanie nového kľúča pre požadujúce zariadenie alebo že NVM3 nemá žiadne voľné miesto. Silicon Labs poskytuje nasledujúce odporúčania pre používateľov, ktorí chcú vytvoriť veľké siete. Pre aplikácie Trust Center sa odporúčajú nasledujúce konfigurácie. Tieto odporúčania nie sú vyčerpávajúce a slúžia ako základ pre aplikácie, ktoré majú v úmysle vybudovať veľké siete.

Zahrnutie komponentu Tabuľka adries (zigbee_address_table), s
- konfiguračná položka SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE nastavená na veľkosť požadovanej siete
- hodnota SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE nastavená na maximum (4)

Zahrnutie komponentu Kľúče bezpečnostného prepojenia (zigbee_security_link_keys), s
- Hodnota SL_ZIGBEE_KEY_TABLE_SIZE je nastavená na veľkosť siete
Nasledujúce položky konfigurácie sú nastavené na veľkosť požadovanej siete
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, ako sa nachádza v komponente Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, ako sa nachádza v komponente Zdrojové smerovanie, ak sa používa zdrojové smerovanie
Úprava NVM3_DEFAULT_NVM_SIZE a NVM3_DEFAULT_CACHE_SIZE podľa použitia NVM3
- Napr. veľkosti siete väčšie ako 65 uzlov pravdepodobne vyžadujú veľkosť NVM3 64 kB. Predvolená veľkosť NVM3 v Silicon Labs Zigbee sample aplikácií je 32 tis. Aplikácie, ktoré intenzívnejšie využívajú NVM, môžu vyžadovať úpravu tejto hodnoty ešte vyššie.
- Veľké siete do 65 uzlov môžu potrebovať veľkosť vyrovnávacej pamäte NVM3 1200 bajtov; rastúce siete väčšie ako táto si môžu vyžadovať zdvojnásobenie tejto hodnoty na 2400 bajtov.

Tieto úpravy sa vzťahujú len na Centrum dôveryhodnosti

Multiprotokolová brána a RCP

Nové položky
Povolená podpora GA SoC pre BLE DMP so Zigbee + Openthread CMP so súčasným počúvaním na častiach xG26. Bola pridaná podpora Debian alpha pre aplikácie Zigbeed, OTBR a Z3Gateway. Zigbeed a OTBR sú poskytované aj vo formáte balíka DEB pre zvolenú referenčnú platformu (Raspberry PI 4). Pozrite si Súbežné spustenie Zigbee, OpenThread a Bluetooth na hostiteľovi Linux s multiprotokolovým koprocesorom, ktorý nájdete na docs.silabs.com, pre podrobnosti. Pridaná podpora Zigbeed pre Tizen-0.1-13.1 pre arm32 a aarch64, ako aj Android 12 pre aarch64. Viac informácií o Zigbeed nájdete na docs.silabs.com. Pridaný nový komponent „802.15.4 Jednotná priorita plánovača rádia“. Tento komponent sa používa na konfiguráciu rádiových priorít zásobníka 15.4. Komponent tiež vyžaduje nový komponent „radio_priority_configurator“. Tento komponent umožňuje projektom používať nástroj Radio Priority Configurator v Simplicity Studio na konfiguráciu úrovní priority rádia zásobníkov, ktoré to vyžadujú.

Vylepšenia
Poznámka k aplikácii Súbežné spustenie Zigbee, OpenThread a Bluetooth na hostiteľovi Linux s multiprotokolovým koprocesorom (AN1333) bolo presunuté do docs.silabs.com. Podpora OpenWRT je teraz v kvalite GA. Pre aplikácie Zigbee, OTBR a Z3Gateway bola pridaná podpora OpenWRT. Zigbeed a OTBR sú poskytované aj vo formáte balíka IPK pre referenčnú platformu (Raspberry PI 4). Pozrite si Súbežné spustenie Zigbee, OpenThread a Bluetooth na hostiteľovi Linux s multiprotokolovým koprocesorom, ktorý nájdete na docs.silabs.com, pre podrobnosti.

Opravené problémy

Známe problémy v aktuálnom vydaní
Problémy označené tučným písmom boli pridané od predchádzajúceho vydania. Ak ste zmeškali vydanie, najnovšie poznámky k vydaniu sú k dispozíciihttps://www.silabs.com/developers/simplicity-software-development-kit.

Zastarané položky
„Multiprotocol Container“, ktorý je momentálne dostupný na DockerHub (siliconlabsinc/multiprotocol), bude v nadchádzajúcom vydaní zastaraný. Kontajner už nebude aktualizovaný a nebude ho možné stiahnuť z DockerHub. Balíky založené na Debiane pre cpcd, ZigBee a ot-br-posix spolu s natívne generovanými a kompilovanými projektmi nahradia funkčnosť stratenú odstránením kontajnera.

Používanie tohto vydania

Toto vydanie obsahuje nasledovné:

Zigbee zásobník
Aplikačný rámec Zigbee
Zigbee Sample Aplikácie

Ďalšie informácie o Zigbee a EmberZNet SDK nájdete v UG103.02: Zigbee Fundamentals. Ak ste prvým používateľom, pozrite si QSG180: Príručka rýchleho spustenia Zigbee EmberZNet pre SDK 7.0 a vyššie, kde nájdete pokyny na konfiguráciu vývojového prostredia, zostavovanie a flashovanie akoample aplikácie a odkazy na dokumentáciu poukazujúce na ďalšie kroky.

Inštalácia a používanie
Zigbee EmberZNet SDK sa poskytuje ako súčasť Simplicity SDK, sady SDK Silicon Labs. Ak chcete rýchlo začať so súpravou Simplicity SDK, nainštalujte si Simplicity Studio 5, ktoré nastaví vaše vývojové prostredie a prevedie vás inštaláciou súpravy Simplicity SDK. Simplicity Studio 5 obsahuje všetko potrebné pre vývoj produktov internetu vecí so zariadeniami Silicon Labs, vrátane spúšťača zdrojov a projektov, nástrojov na konfiguráciu softvéru, úplného IDE s GNU toolchain a analytických nástrojov. Pokyny na inštaláciu sú uvedené v online používateľskej príručke Simplicity Studio 5. Alternatívne je možné Simplicity SDK nainštalovať manuálne stiahnutím alebo naklonovaním najnovšej verzie z GitHub. Pozri https://github.com/SiliconLabs/simplicity_sdk pre viac informácií. Simplicity Studio predvolene nainštaluje Simplicity SDK v:

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

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

Dokumentácia špecifická pre verziu SDK je nainštalovaná so súpravou SDK. Ďalšie informácie možno často nájsť v článkoch databázy znalostí (KBA). Referencie API a ďalšie informácie o tomto a starších vydaniach sú dostupné na https://docs.silabs.com/.

Bezpečnostné informácie
Bezpečná integrácia Vault
Pre aplikácie, ktoré sa rozhodnú ukladať kľúče bezpečne pomocou komponentu Secure Key Storage na Secure Vault-High časti, nasledujúca tabuľka zobrazuje chránené kľúče a ich charakteristiky ochrany úložiska, ktoré spravuje komponent Zigbee Security Manager.Zabalené kľúče, ktoré sú označené ako „Neexportovateľné“, sa dajú použiť, ale nie viewed alebo zdieľané za behu. Zabalené kľúče, ktoré sú označené ako „Exportovateľné“, je možné použiť alebo zdieľať za behu, ale počas uloženia vo formáte Flash zostávajú zašifrované. Používateľské aplikácie nikdy nemusia interagovať s väčšinou týchto kľúčov. Existujúce rozhrania API na správu kľúčov tabuľky kľúčov prepojenia alebo prechodných kľúčov sú stále dostupné pre používateľskú aplikáciu a sú smerované cez komponent Zigbee Security Manager.

Bezpečnostné rady
Ak sa chcete prihlásiť na odber bezpečnostných rád, prihláste sa na zákaznícky portál Silicon Labs a vyberte Domovská stránka účtu. Kliknutím na DOMOV prejdite na domovskú stránku portálu a potom kliknite na dlaždicu Spravovať upozornenia. Uistite sa, že je začiarknuté 'Software/Security Advisory Notices & Product Change Notices (PCN)' a že ste prihlásení na odber minimálne pre svoju platformu a protokol. Kliknutím na tlačidlo Uložiť uložte všetky zmeny.

Podpora
Zákazníci súpravy Development Kit majú nárok na školenie a technickú podporu. Použite Zigbee Silicon Laboratories web na získanie informácií o všetkých produktoch a službách Silicon Labs Zigbee a na prihlásenie sa na podporu produktu. Podporu Silicon Laboratories môžete kontaktovať na adrese http://www.silabs.com/support.

Certifikácia Zigbee
Vydanie Ember ZNet 8.1 bolo kvalifikované pre platformu kompatibilnú so Zigbee pre architektúry SoC, NC, P a RCP, k tomuto vydaniu je viazané ID certifikácie ZCP, skontrolujte CSA webstránka tu:
https://csa-iot.org/csa-iot_products/.

Upozorňujeme, že certifikácia ZCP je filed po zverejnení a trvá niekoľko týždňov, kým sa prejaví v CSA webstránky. V prípade akýchkoľvek ďalších otázok kontaktujte podporu spoločnosti Silicon Laboratories na adrese http://www.silabs.com/support.

často kladené otázky

Otázka: Ako môžem aktualizovať veľkosť tabuľky kľúčov prepojenia APS v súprave SDK?
Odpoveď: Veľkosť tabuľky kľúčov prepojenia APS je možné nakonfigurovať pomocou parametra SL_ZIGBEE_KEY_TABLE_SIZE. Vo verzii 8.1 bol rozšírený zo 127 na 254 záznamov.

Otázka: Aké sú vylepšenia vo verzii 8.1?
Odpoveď: Verzia 8.1 prináša vylepšenia, ako je rozšírenie veľkosti tabuľky kľúčov prepojenia APS, premenovanie komponentov, pridanie ochrany mutex pre front udalostí Athe pp Framework a ďalšie. Podrobný zoznam vylepšení nájdete v poznámkach k vydaniu.

Otázka: Ako riešim opravené problémy v súprave SDK?
Odpoveď: Opravené problémy v súprave SDK vrátane riešenia potenciálnych problémov s konfiguráciou veľkosti susednej tabuľky, premenovávanie komponentov, oprava réžie zdroja, spracovanie príkazov ZCL a ďalšie. Uistite sa, že aktualizujete na najnovšiu verziu, aby ste mohli využívať tieto opravy.

Dokumenty / zdroje

SILICON LABS Zigbee EmberZ Net SDK [pdfPokyny
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referencie

Používateľská príručka

SILICON LABS Zigbee EmberZ Net SDK

Špecifikácie

Informácie o produkte