SILICON LABS Pokyny pro Zigbee EmberZ Net SDK

Společnost Silicon Labs je dodavatelem volby pro výrobce OEM vyvíjející sítě Zigbee do svých produktů. Platforma Silicon Labs Zigbee je nejintegrovanější, nejúplnější a na funkce bohaté dostupné řešení Zigbee. Sada Silicon Labs EmberZNet SDK obsahuje implementaci specifikace zásobníku Zigbee od Silicon Labs.

KLÍČOVÉ VLASTNOSTI

Zigbee

-250+ záznamů v tabulce klíčů spojení APS
Podpora ZigbeeD na Androidu 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 se souběžným poslechem na MG26 pro SoC – GA

802.15.4 Jednotná prioritní komponenta rádiového plánovače
Podpora balíčků Debianu pro hostitelské aplikace MP – Alpha

Nové položky

Důležité změny
Velikost tabulky klíčů propojení APS (konfigurovaná pomocí SL_ZIGBEE_KEY_TABLE_SIZE) je rozšířena ze 127 na 254 položek.

Pro funkci zprovoznění sítě ZDD je přidána podpora R23. Funkce tunelování je k dispozici bez podpory případů použití Legacy Network.

Komponenty Network Steering a Network Creator byly aktualizovány tak, aby zahrnovaly podporu pro připojení R23. Patří mezi ně následující související změny.
- Výchozí zásada požadavku na klíč TCLK (Trust Center Link Key) byla aktualizována tak, aby generovala nové klíče pro každé žádající zařízení. Nový klíč se vygeneruje pokaždé, když se žádající zařízení pokusí aktualizovat svůj klíč propojení centra důvěryhodnosti.
- Kvůli předchozí změně zásad TCLK nyní komponenta Network Creator Security vyžaduje komponentu Security Link Keys. Aktualizace aplikací bude aktualizována, aby odpovídala tomuto novému požadavku.
- Nová konfigurace,
  Je přidán SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY, který umožňuje připojení pomocí základního, hashovaného klíče. Tato konfigurace se nachází pod součástí Network Creator Security. Použití této zásady umožňuje každému připojujícímu se zařízení přijímat po připojení jedinečný TCLK, ale opakované pokusy o aktualizaci TCLK nepovedou k vytvoření nového klíče pro žádající zařízení. Toto používání klíčů hashovaných odkazů bylo před tímto vydáním výchozí zásadou a použití této zásady umožňuje Centru důvěryhodnosti vyhnout se použití komponenty Security Link Keys, která ukládá klíče do Flash.
  Poznámka: Silicon Labs nedoporučuje používat tuto zásadu, protože to brání připojeným zařízením v rolování nebo aktualizaci jejich TCLK.

Ke komponentě zigbee_ezsp_spi je přidána nová konfigurační sada, která umožňuje konfiguraci hostitelského zařízení SPI a jeho pin rozhraní.
Bývalýample projektů, včetně projektu files (.slcps) a složka projektu jsou přejmenovány na pokyny pro pojmenování Silicon Labs a přesunuty do adresáře „projects“.

Podpora nové platformy

Nové moduly
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nové rádiové desky
- MGM260P-RB4350A
- MGM260P-RB4351A
Nový díl
- efr32xg27
Průzkumná sada
- BRD2709A
- MGM260P-EK2713A

Nová dokumentace
Nové uživatelské příručky EZSP UG600 pro verze 8.1 a vyšší.

Vylepšení

Limity SL_ZIGBEE_KEY_TABLE_SIZE rozšířeny až na 254 položek.
Do Z3Light přidány klíče zigbee_security_link_keys.
Přidány klíče zigbee_security_link_keys do zigbee_mp_z3_tc_z3_tc. Aktualizována také velikost tabulky klíčů.
Velikost tabulky klíčů brány Z3 (která bude nastavena na ncp) byla zvětšena na 20.

Opravené problémy

Známé problémy v aktuální verzi

Od předchozího vydání byly přidány problémy označené tučně. Pokud jste zmeškali vydání, poslední poznámky k vydání jsou k dispozici na adrese https://www.silabs.com/developers/zigbee-emberznet na kartě Technické dokumenty.

Zastaralé položky

Komponenta zigbee_watchdog_periodic_refresh se již nepoužívá v aplikačním rámci Zigbee a je v tomto vydání zastaralá. Watchdog timer je ve výchozím nastavení pro všechny s vypnutýample aplikace. V budoucnu bude do SDK přidána vylepšená komponenta Watchdog.
Poznámka: Povolte časovač hlídacího psa pomocí konfigurační položky SL_LEGACY_HAL_DISABLE_WATCHDOG ve vaší aplikaci nastavené na 0

Síťová omezení a úvahy

Výchozí aplikace Trust Center, které se dodávají s touto verzí EmberZNet, jsou schopny podporovat několik zařízení v síti. Toto číslo je určeno na základě několika faktorů, včetně nakonfigurovaných velikostí tabulek, využití NVM a dalších hodnot doby generování a doby běhu. Uživatelé, kteří chtějí vytvořit velké sítě, mohou čelit problémům se zdroji, když se síť zvětší, než může aplikace podporovat. Napřample, zařízení požadující klíč propojení centra důvěryhodnosti z centra důvěryhodnosti může spustit zpětné volání sl_zigbee_af_zigbee_key_establishment_cb v centru důvěryhodnosti se stavem h nastaveným na SL_ZIGBEE_KEY_TABLE_FULL, což znamená, že tabulka klíčů nemá prostor pro přidání nového klíče pro požadující zařízení nebo že NVM3 nemá žádné volné místo. Silicon Labs poskytuje následující doporučení pro uživatele, kteří chtějí vytvořit velké sítě. Pro aplikace Trust Center se doporučují následující konfigurace. Tato doporučení nejsou vyčerpávající a slouží jako základ pro aplikace, které mají v úmyslu rozvíjet velké sítě.

Zahrnutí komponenty Tabulka adres (zigbee_address_table), s
- konfigurační položka SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE nastavená na velikost požadované sítě
- hodnota SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE nastavena na maximum (4)

Zahrnutí komponenty Security Link Keys (zigbee_security_link_keys), s
- Hodnota SL_ZIGBEE_KEY_TABLE_SIZE je nastavena na velikost sítě
Následující položky konfigurace jsou nastaveny na velikost požadované sítě
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, jak se nachází v komponentě Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, jak je uvedeno v komponentě Zdrojové směrování, pokud je použito zdrojové směrování
Úprava NVM3_DEFAULT_NVM_SIZE a NVM3_DEFAULT_CACHE_SIZE podle využití NVM3
- Např. velikosti sítě větší než 65 uzlů pravděpodobně vyžadují velikost NVM3 64 kB. Výchozí velikost NVM3 v Silicon Labs Zigbee sampPočet aplikací je 32 tisíc. Aplikace, které intenzivněji využívají NVM, mohou vyžadovat úpravu této hodnoty ještě vyšší.
- Velké sítě až do 65 uzlů mohou potřebovat velikost mezipaměti NVM3 1200 bajtů; rozšiřování větších sítí může vyžadovat zdvojnásobení této hodnoty na 2400 bajtů.

Tyto úpravy se týkají pouze Centra důvěryhodnosti

Multiprotokolová brána a RCP

Nové položky
Povolena podpora GA SoC pro BLE DMP se Zigbee + Openthread CMP se souběžným poslechem na částech xG26. Byla přidána podpora Debian alpha pro aplikace Zigbeed, OTBR a Z3Gateway. Zigbeed a OTBR jsou poskytovány také ve formátu balíčku DEB pro zvolenou referenční platformu (Raspberry PI 4). Viz Současné spouštění Zigbee, OpenThread a Bluetooth na hostiteli Linux s multiprotokolovým koprocesorem, naleznete na docs.silabs.com, pro podrobnosti. Přidána podpora Zigbeed pro Tizen-0.1-13.1 pro arm32 a aarch64 a také Android 12 pro aarch64. Více informací o Zigbeed naleznete na docs.silabs.com. Přidána nová komponenta „802.15.4 Jednotná priorita rádiového plánovače“. Tato komponenta se používá ke konfiguraci priorit rádia zásobníku 15.4. Komponenta také vyžaduje novou komponentu „radio_priority_configurator“. Tato komponenta umožňuje projektům používat nástroj Radio Priority Configurator v Simplicity Studio ke konfiguraci úrovní priority rádia pro zásobníky, které to vyžadují.

Vylepšení
Poznámka k aplikaci Současné spouštění Zigbee, OpenThread a Bluetooth na hostiteli Linux s multiprotokolovým koprocesorem (AN1333) bylo přesunuto do docs.silabs.com. Podpora OpenWRT je nyní v kvalitě GA. Byla přidána podpora OpenWRT pro aplikace Zigbee, OTBR a Z3Gateway. Zigbeed a OTBR jsou poskytovány také ve formátu IPK pro referenční platformu (Raspberry PI 4). Viz Současné spouštění Zigbee, OpenThread a Bluetooth na hostiteli Linux s multiprotokolovým koprocesorem, naleznete na docs.silabs.com, pro detaily.

Opravené problémy

Známé problémy v aktuální verzi
Od předchozího vydání byly přidány problémy označené tučně. Pokud jste zmeškali vydání, jsou k dispozici poznámky k poslednímu vydáníhttps://www.silabs.com/developers/simplicity-software-development-kit.

Zastaralé položky
„Multiprotocol Container“, který je aktuálně dostupný na DockerHub (siliconlabsinc/multiprotocol), bude v nadcházející verzi ukončen. Kontejner již nebude aktualizován a nebude jej možné stáhnout z DockerHubu. Balíčky pro cpcd, ZigBee a ot-br-posix založené na Debianu spolu s nativně generovanými a zkompilovanými projekty nahradí funkčnost ztracenou odstraněním kontejneru.

Použití této verze

Toto vydání obsahuje následující:

Zigbee zásobník
Aplikační rámec Zigbee
Zigbee Sample Aplikace

Další informace o Zigbee a EmberZNet SDK viz UG103.02: Zigbee Fundamentals. Pokud jste prvním uživatelem, přečtěte si QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 a vyšší, kde najdete pokyny pro konfiguraci vývojového prostředí, sestavení a flashování jakoample aplikace a odkazy na dokumentaci ukazující na další kroky.

Instalace a použití
Zigbee EmberZNet SDK je poskytován jako součást Simplicity SDK, sady SDK Silicon Labs. Chcete-li rychle začít s Simplicity SDK, nainstalujte Simplicity Studio 5, které nastaví vaše vývojové prostředí a provede vás instalací Simplicity SDK. Simplicity Studio 5 obsahuje vše potřebné pro vývoj produktů IoT se zařízeními Silicon Labs, včetně spouštěče zdrojů a projektů, softwarových konfiguračních nástrojů, plného IDE s GNU toolchain a analytických nástrojů. Pokyny k instalaci jsou uvedeny v online příručce Simplicity Studio 5 User's Guide. Alternativně lze Simplicity SDK nainstalovat ručně stažením nebo klonováním nejnovější verze z GitHubu. Vidět https://github.com/SiliconLabs/simplicity_sdk pro více informací. Simplicity Studio instaluje Simplicity SDK ve výchozím nastavení v:

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

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

Dokumentace specifická pro verzi SDK je nainstalována se sadou SDK. Další informace lze často nalézt v článcích znalostní báze (KBA). Odkazy na API a další informace o této a dřívějších verzích jsou dostupné na https://docs.silabs.com/.

Bezpečnostní informace
Bezpečná integrace Vault
Pro aplikace, které se rozhodnou bezpečně ukládat klíče pomocí komponenty Secure Key Storage na součástech Secure Vault-High, uvádí následující tabulka chráněné klíče a jejich charakteristiky ochrany úložiště, které spravuje komponenta Zigbee Security Manager.Zabalené klíče, které jsou označeny jako „Neexportovatelné“, lze použít, ale nikoli viewed nebo sdílené za běhu. Zabalené klíče, které jsou označeny jako „Exportovatelné“, lze používat nebo sdílet za běhu, ale zůstávají zašifrované, dokud jsou uloženy ve Flashi. Uživatelské aplikace nikdy nemusí komunikovat s většinou těchto klíčů. Stávající rozhraní API pro správu klíčů tabulky klíčů propojení nebo přechodných klíčů jsou stále k dispozici uživatelské aplikaci a jsou směrovány prostřednictvím komponenty Zigbee Security Manager.

Bezpečnostní upozornění
Chcete-li se přihlásit k odběru bezpečnostních rad, přihlaste se na zákaznický portál Silicon Labs a vyberte Domovská stránka účtu. Kliknutím na DOMŮ přejděte na domovskou stránku portálu a poté klikněte na dlaždici Spravovat oznámení. Ujistěte se, že je zaškrtnuto 'Software/Security Advisory Notices & Product Change Notices (PCN)' a že jste přihlášeni minimálně pro svou platformu a protokol. Klepnutím na tlačítko Uložit uložte změny.

Podpora
Zákazníci sady Development Kit mají nárok na školení a technickou podporu. Použijte Zigbee Silicon Laboratories web na stránce získáte informace o všech produktech a službách Silicon Labs Zigbee a přihlásíte se k podpoře produktu. Podporu Silicon Laboratories můžete kontaktovat na adrese http://www.silabs.com/support.

Certifikace Zigbee
Vydání Ember ZNet 8.1 bylo kvalifikováno pro platformu kompatibilní se Zigbee pro architektury SoC, NC, P a RCP, k tomuto vydání je vázáno ID certifikace ZCP, zkontrolujte CSA webstránky zde:
https://csa-iot.org/csa-iot_products/.

Upozorňujeme, že certifikace ZCP je filed zveřejnění a trvá několik týdnů, než se projeví v CSA webmísto. S případnými dalšími dotazy se prosím obraťte na podporu Silicon Laboratories na adrese http://www.silabs.com/support.

Nejčastější dotazy

Otázka: Jak aktualizuji velikost tabulky klíčů propojení APS v sadě SDK?
Odpověď: Velikost tabulky klíčů propojení APS lze konfigurovat pomocí parametru SL_ZIGBEE_KEY_TABLE_SIZE. Ve verzi 8.1 byl rozšířen ze 127 na 254 záznamů.

Otázka: Jaká jsou vylepšení ve verzi 8.1?
Odpověď: Verze 8.1 přináší vylepšení, jako je rozšíření velikosti tabulky klíčů propojení APS, přejmenování komponent, přidání ochrany mutex pro frontu událostí Athe pp Framework a další. Podrobný seznam vylepšení naleznete v poznámkách k vydání.

Otázka: Jak mohu vyřešit opravené problémy v sadě SDK?
A: Opravené problémy v sadě SDK včetně vyřešení potenciálních problémů s konfigurací velikosti sousední tabulky, přejmenování komponent, oprava režie zdrojové trasy, zpracování příkazů ZCL a další. Ujistěte se, že aktualizujete na nejnovější verzi, abyste mohli tyto opravy využít.

Dokumenty / zdroje

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

Reference

Uživatelská příručka

SILICON LABS Zigbee EmberZ Net SDK

Specifikace

Informace o produktu