Software SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack

Informace o produktu

Specifikace

• Verze sady Zigbee EmberZNet SDK: 7.4.1.0
• Verze sady Gecko SDK Suite: 4.4 – 14. února 2024
• Prodejce: Silicon Labs
• Klíčové vlastnosti: Podpora víceprotokolových Zigbee a OpenThread na SoC
• Kompatibilní kompilátory: GCC verze 12.2.1
• Verze protokolu EZSP: 0x0D

Návod k použití produktu

Oznámení o kompatibilitě a použití

• Aktualizace zabezpečení a upozornění naleznete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nainstalované s touto sadou SDK nebo navštivte kartu TECH DOCS na Silicon Labs. webmísto.
• Zůstaňte v obraze tím, že se přihlásíte k odběru bezpečnostních rad.

FAQ

• Otázka: Jak ověřím správnost files jsou používány s kompatibilními kompilátory?
• Odpověď: Můžete si ověřit, že je to správné files jsou používány kontrolou GCC verze 12.2.1 dodávané se Simplicity Studio.
• Otázka: Kde najdu informace o aktualizacích zabezpečení a upozornění?
• Odpověď: Aktualizace zabezpečení a upozornění naleznete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nebo na kartě TECH DOCS na Silicon Labs' webmísto.

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.
Silicon Labs EmberZNet SDK obsahuje implementaci specifikace Zigbee stacku od Silicon Labs.

• Tyto poznámky k vydání se týkají verzí sady SDK:
• 7.4.1.0 vydáno 14. února 2024
• 7.4.0.0 vydáno 13. prosince 2023

KLÍČOVÉ VLASTNOSTI

Zigbee

• Kompatibilita se Zigbee R23
• Shoda se Zigbee Smart Energy 1.4a – výroba
• Shoda se Zigbee GP 1.1.2 – Alpha
• Podpora MG27 – výroba
• Vylepšená podpora pro součásti Secure Vault
• Ospalá podpora u aplikací NCP SPI (non-CPC) – Alpha

Multiprotokol

• Podpora souběžného poslechu (RCP) – MG21 a MG24
• Concurrent Multiprotocol (CMP) Zigbee NCP + OpenThread RCP – výroba
• Dynamic Multiprotocol Bluetooth + Concurrent Multiprotocol (CMP) podpora Zigbee a OpenThread na SoC

Oznámení o kompatibilitě a použití

Informace o aktualizacích zabezpečení a upozorněních naleznete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nainstalované s touto sadou SDK nebo na kartě TECH DOCS na adrese https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs také důrazně doporučuje, abyste se přihlásili k odběru bezpečnostních rad pro aktuální informace. Pokyny, nebo pokud jste noví se sadou Zigbee EmberZNet SDK, naleznete v části Používání této verze.

Kompatibilní kompilátory

• IAR Embedded Workbench pro ARM (IAR-EWARM) verze 9.40.1.
• Použití Wine k sestavení pomocí nástroje příkazového řádku IarBuild.exe nebo grafického uživatelského rozhraní IAR Embedded Workbench v systémech macOS nebo Linux může mít za následek nesprávné files se používá kvůli kolizím v hashovacím algoritmu Wine pro generování short file jména.
• Zákazníkům se systémem macOS nebo Linux se doporučuje, aby nevytvářeli s IAR mimo Simplicity Studio. Zákazníci, kteří tak učiní, by si měli pečlivě ověřit, že je to správné files se používají.

GCC (The GNU Compiler Collection) verze 12.2.1, dodávaná se Simplicity Studio.
Verze protokolu EZSP pro toto vydání je 0x0D.

Nové položky

Toto vydání Gecko SDK (GSDK) bude poslední s kombinovanou podporou pro všechna zařízení EFM a EFR, kromě oprav této verze podle potřeby. Od poloviny roku 2024 zavedeme samostatné sady SDK:

• Stávající Gecko SDK bude nadále podporovat zařízení řady 0 a 1.
• Nová sada SDK bude sloužit speciálně pro zařízení Series 2 a 3.

Gecko SDK bude i nadále podporovat všechna zařízení řady 0 a 1 beze změny dlouhodobé podpory, údržby, kvality a odezvy poskytované v rámci našich zásad pro software.
Nové SDK se rozvětví z Gecko SDK a začne nabízet nové funkce, které pomohou vývojářům pokročittage z pokročilých schopností našich produktů řady 2 a 3.
Toto rozhodnutí je v souladu se zpětnou vazbou zákazníků a odráží náš závazek zvyšovat kvalitu, zajišťovat stabilitu a zlepšovat výkon pro výjimečnou uživatelskou zkušenost napříč našimi softwarovými sadami SDK.

Nové komponenty

Novinka ve vydání 

• Byly přidány komponenty „zigbee_direct_security_p256“ a „zigbee_direct_security_curve25519“, aby uživatelé mohli nakonfigurovat konkrétní možnost zabezpečení Zigbee Direct.
• Uživatelé mohou mít povoleno více komponent „zigbee_direct_security“ v aplikaci přímého zařízení Zigbee (ZDD). V tomto případě závisí skutečná možnost zabezpečení na konfiguraci virtuálního zařízení Zigbee (ZVD).

Nová API
Novinka ve vydání 

• Přidáno nové API sl_zigbee_token_factory_reset pro resetování tokenů Zigbee NVM3 na jejich výchozí hodnotu.
• Přidáno rozhraní API bool sl_zigbee_sec_man_link_key_slot_available (EmberEUI64 eui), které vrací hodnotu true, pokud tabulka klíčů odkazů může přidat nebo aktualizovat položku s touto adresou (tabulka není plná).
• Přidáno nové rozhraní API bool sl_zb_sec_man_compare_key_to_value (kontext sl_zb_sec_man_context_t*, klíč sl_zb_sec_man_key_t*), které vrací hodnotu true, pokud má klíč odkazovaný kontextem stejnou hodnotu jako klíč zadaný v argumentu.

Podpora nové platformy
Novinka ve vydání 

• V tomto vydání je přidána podpora zásobníku Zigbee pro následující nové díly: EFR32MG24A010F768IM40 a EFR32MG24A020F768IM40.

Nová dokumentace
Novinka ve verzi 7.4.0.0

• Aktualizován popis komponenty Zigbee Secure Key Storage, aby odrážel přidání Zigbee Secure Key Storage Upgrade (který přidává zpětnou kompatibilitu se stávajícími projekty).
• Přidána nová poznámka k aplikaci pro interakci se skupinou komponent Zigbee Security Manager (AN1412: Zigbee Security Manager).

Zamýšlené chování

Upozorňujeme uživatele, že nesynchronizované přenosy CSL Zigbee podléhají preempci protokolu v rádiovém plánovači. V aplikacích SleepyToSleepy BLE může a bude předcházet přenosu Zigbee CSL, který přenos ukončí. Preempce plánovače je běžnější pro nesynchronizované CSL, vzhledem k tomu, že lze použít potenciálně zdlouhavou sekvenci rámců probuzení. Uživatelé, kteří si přejí upravit priority přenosu, mohou k tomu použít komponentu DMP Tuning and Testing. Uživatelé mohou také nahlédnout do UG305: Dynamic Multiprotocol User's Guide pro více informací.

Vylepšení

Změněno ve vydání
Změny dokumentu API emberCounterHandler

V předchozích verzích zpětnému volání Counter Handler pro vrstvu MAC a APS EmberCounterTypes týkající se paketu RX a TX nebylo předáno správné ID cílového uzlu nebo datové argumenty a dokumentace API týkající se chování určitých čítačů, které tyto parametry používaly, byla nejasná nebo zavádějící.
Zatímco signatura emberCounterHandler() se nezměnila, způsob naplnění jejích parametrů se mírně změnil.

• Komentáře k výčtům EmberCounterType v ember-types.h byly kvůli přehlednosti rozšířeny.
• Parametr Node ID pro Counter Handler pro čítače související s TX nyní před jeho použitím kontroluje, zda režim cílové adresy indikuje platné krátké ID. (Pokud ne, není vyplněna žádná cílová adresa a místo toho se použije zástupná hodnota EMBER_UNKNOWN_NODE_ID.)
• Parametr ID uzlu pro obslužnou rutinu čítače pro čítače související s RX nyní odráží ID zdrojového uzlu, nikoli ID cílového uzlu.
• Počet opakování *není* předán jako datový parametr pro čítače EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED, jak je popsáno u typů ember. h v předchozích verzích, ale toto nebylo nikdy správně vyplněno v dříve vydaných verzích, takže jeho hodnota v předchozích verzích by vždy byla 0. Toto chování bylo objasněno v popisu těchto EmberCounterTypes. Počet opakování pro opakování vrstvy APS se však nadále vyplňuje v datovém parametru pro typy čítačů EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED, aby byl konzistentní s předchozími verzemi.
• Všechny čítače, které naplňují ID uzlu nebo datový parametr pro zpětné volání, byly auditovány, aby bylo zajištěno, že předají očekávaná data, adresu nebo EMBER_UNKNOWN_NODE_ID, pokud se očekávalo ID uzlu, ale nebylo možné jej získat z paketu, jak je popsáno v revidovaném ember- dokumentace typů.h.
• Obslužná rutina čítače pro EMBER_COUNTER_MAC_TX_UNICAST_RETRY nyní správně odráží ID cílového uzlu vrstvy MAC a několik opakování ve svém ID cílového uzlu a datových parametrech.
• Obslužná rutina čítače pro EMBER_COUNTER_PHY_CCA_FAIL_COUNT nyní poskytuje informace o ID cílového uzlu prostřednictvím parametru ID uzlu o zamýšleném cíli vrstvy MAC zprávy, která selhala při přenosu.

Aktualizovaný kód zelené energie
Kód serveru Green Power je aktualizován o různá vylepšení, včetně:

• Přidán další ověřovací kód pro příchozí příkazy s neplatným koncovým bodem při příjmu na serveru GP.
• Přidán kód pro řešení případu, kdy už není místo pro vytváření zpráv o zelené energii.
• Dřez nyní zruší konfiguraci párování s akcí odstranění párování v některých případech podle části A.3.5.2.4.1.
• Umyvadlo nyní ukládá existující seznam skupin položky před jejím odstraněním při zpracování konfigurace párování s rozšířením akce.
• Pokud je překladová tabulka prázdná nebo je index větší než několik položek v tabulce, příkaz Translation query vrátí „NOT FOUND“ jako kód chyby.
• Změněna verze koncového bodu GP v některých aplikacích z 1 na 0.

Použití CSMA ve funkci GPDF Send je omezeno, protože Green Power Devices jsou zařízení s minimální spotřebou energie a nepoužívají CSMA ve většině návrhů. Místo toho je upřednostňovaným návrhem posílat více paketů se stejným energetickým rozpočtem.
Odebráno použití skrytého koncového bodu v možnosti pluginu Green Power Server. Místo toho použijte jeden z koncových bodů aplikace.
Vylepšení kódu pluginu pro aktualizaci síťového klíče

• Změna periodické aktualizace síťového klíče na 1 rok.

Restrukturalizována některá rozhraní API, aby se zabránilo zbytečnému exportu klíčů
Provedeny změny, které upřednostňují použití klíčových kontextů před klíčovými daty v prostém textu.

• sl_zigbee_send_security_challenge_request nyní přebírá argument sl_zb_sec_man_context_t místo EmberKeyData.
• Hodnoty výčtu sl_zb_sec_man_derived_key_type jsou nyní 16bitovou bitovou maskou, která přímo podporuje určité odvozeniny klíčů, které kombinují více odvozených typů.

Opravené problémy

Opraveno ve vydání 

ID #	Popis
1036893	Opraven problém, který způsobil, že komponenta clusteru OTA nainstalovala starší komponentu rozhraní boot-loader jako závislost.
1114905	Zigbee Direct: Vylepšené zpracování charakteristiky Leave Network Characteristic.
1180937	Opraven reset WDT při připojení Zigbee Direct ZDD k ZVD třetí strany.
1223904	Opraven problém, který způsoboval, že koncové zařízení nesprávně fungovalo ve velmi rušném prostředí.
1224393	Byl aktualizován kód obslužné rutiny požadavku tabulky jímky Green Power, aby se aktualizovala cílová adresa odpovědi.
1228808	Opraven problém se zobrazením definic maker v dokumentaci gp-types.h.
1232297	Opraven problém, kdy emberSetOutgoingNwkFrameCounter a emberSetOutgoingApsFrameCounter nefungovaly na 64bitových hostitelských aplikacích (vracení EMBER_BAD_ARGUMENT).
1232359	Opraven výpočet parametru gppTunnelingDelay ve zpracování příkazů klienta zelené energie.
1240392	Požadavky ZDO Bind/Unbind zamítnuté z důvodů přístupu/oprávnění by měly vrátit stav EMBER_ZDP_NOT_AUTHORIZED spíše než stav EMBER_ZDP_NOT_PERMITTED podle specifikací Zigbee.
1243523	Zigbee Direct: Vylepšená stabilita připojení BLE k ZVD.
1249455	Opraven problém, který způsoboval přechod ospalého koncového zařízení do režimu spánku při příjmu vysílání před přijetím potvrzení.
1252295	Opravte chybu překlepu v makru katalogu komponent SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT.

Opraveno ve vydání 

ID #	Popis
1019348	Opraveny požadavky na závislost pro komponentu Zigbee ZCL Cli, aby ji bylo možné odebrat, když ji nepotřebujete.
1024246	Aktualizován popis funkce pro emberHaveLinkKey() a sl_zb_sec_man_have_link_key().
1036503	Přidán popis, který doporučuje použití jádra Micrium pro DMP sampaplikace.
1037661	Byl opraven problém, který aplikaci bránil v instalaci profesionálního nebo listového zásobníku.
1078136	Opraven občasný pád při úpravě událostí z kontextu přerušení
1081548	Upozorňujeme uživatele, že nesynchronizované přenosy CSL Zigbee podléhají preempci protokolu v rádiovém plánovači. V aplikacích SleepyToSleepy BLE může a bude předcházet přenosu Zigbee CSL, který přenos ukončí. Preempce plánovače je běžnější pro nesynchronizované CSL, vzhledem k tomu, že lze použít potenciálně zdlouhavou sekvenci rámců probuzení. Uživatelé, kteří si přejí upravit priority přenosu, mohou k tomu použít komponentu DMP Tuning and Testing. Uživatelé mohou také nahlédnout do UG305: Dynamic Multiprotocol User's Guide pro více informací. V CSL byl opraven problém, kdy nová sekvence rámců probuzení, která je přijata bezprostředně po předchozím rámci užitečného zatížení, nebyla zaznamenána správně. To by vedlo k vynechání rámce užitečného zatížení.
1084111	Počáteční ospalá podpora SPI-NCP pro desky založené na MG24 je aktualizována jako součást tohoto vydání.
1104056	Přidána podpora pro řízení sítě pro spuštění na sekundární síti v případě více sítí
1120515	Opraven problém, kdy se kanál nezměnil při použití příkazu mfglib set-channel.
1141109	Opraven problém, který způsoboval generované sampv aplikaci ncp-uart-gp-multi-rail chybí nějaká hlavička files při použití komponenty adaptéru Green Power s volbou -cp.
1144316	Aktualizován popis některých typů datových struktur v dokumentaci gp-types.h.
1144884	Opravený bit čekající na vyřízení falešného rámce, když nejsou nevyřízena žádná data.
1152512	Opraven potenciální pád v low-mac-rail při úpravě události v kontextu ISR.

ID #	Popis
1154616	Přidána výjimka pro podmínku inicializace sítě s případem „Přepínání role z ospalého koncového zařízení na neuspalé koncové zařízení“.
1157289	Opraven problém, který mohl způsobit selhání testu BDB DN-TLM-TC-02B.
1157426	Opraven problém se sestavováním při sestavování zigbee_simple_app s komponentou green_power_adapter.
1157932	Byla přidána podmínka pro kontrolu, zda chybí pole „čas přechodu“, a pro toto chybějící pole byla nastavena výchozí hodnota 0xFFFF.
1166340	Opraven problém, který bránil emberAfGpdfSend odeslat zamýšlený počet opakovaných přenosů.
1167807	Opraven problém, kdy zařízení fungující jako centra důvěryhodnosti v distribuovaných sítích nesprávně vymazala své klíče přechodného propojení pokaždé, když se připojilo nové zařízení.
1169504	Opraven problém, který způsoboval reset ospalého zařízení po nuceném probuzení.
1169966	Opravena chybějící validace návratové hodnoty v kódu alokace vyrovnávací paměti.
1171477, 172270	S mfglib start 1 nejsou vysílány, ale přijímány žádné zprávy, takže zobrazená terminálová zpráva „mfglib send complete“ je chybná a změněna na „RXed %d packets in the last %d ms“.
1171935	Změna periodické aktualizace síťového klíče na 1 rok.
1172778	Přidáno chybějící vyvolání emberAfPluginGreenPowerServerUpdateAliasCallback na server Green Power.
1174288	Opraven problém, který způsoboval, že proces řízení sítě uplatňoval, pokud je voláno volání k zastavení probíhající kontroly.
1178393	Byla aktualizována chyba dokumentace.
1180445	V Smart Energy nyní OTA pokračuje ve stahování, pokud koordinátor dosáhne omezeného pracovního cyklu.
1185509	Opraven problém v CSL, kdy nová sekvence rámců probuzení, která je přijata bezprostředně po předchozím rámci užitečného zatížení, nebyla zaznamenána správně. To by vedlo k vynechání rámce užitečného zatížení.
1186107	Opraven problém, který způsoboval neúspěšné dešifrování přijatých GPDF, které nahradilo příchozí GPDF v oznámení o uvedení do provozu gp.
1188397	Opraven problém, který způsoboval chybu kompilace při povolení rozšířené velikosti tabulky sestav.
1194090	Opraven chybový stav ve výchozí odezvě na příkaz Sink Commissioning Mode – podle části 3.3.4.8.2
1194963	Opraven problém, který nastavoval strukturu CommissioningGpd před voláním zpětného volání uživatele emberAfGreenPowerServerPairingStatusCallback.
1194966	Opraven problém, kdy pole endpoint a proxyInvolved nebyla nastavena pomocí akce Ukončit uvedení do provozu.
1196698	Opravena falešná sada nevyřízených bitů rámců, když nebyla čekající žádná data.
1199958	Přidán kód pro řešení případu, kdy už není místo pro vytváření zpráv o zelené energii.
1202034	Opraven problém, kdy proměnná zásobníku sl_zb_sec_man_context_t nebyla správně inicializována, což způsobovalo selhání připojení pomocí instalačního kódu.
1206040	Volání funkce emberRemoveChild() během bezpečného pokusu o opětovné připojení koncovým zařízením může potenciálně vést k dalšímu snížení počtu dětí, což může vést k počtu dětí -1 (255), což znemožní koncovým zařízením připojit se/znovu se připojit kvůli indikovanému nedostatku. kapacity v Beaconu.
1207580	Funkce vyhledávání podřízených tabulek v rámci zásobníku jsou nekonzistentní při použití 0x0000 oproti 0xFFFF pro návratovou hodnotu ID uzlu představující neplatné/prázdné položky, což vede k problémům při kontrole nepoužitých položek v rozhraních API, jako je emberRemoveChild().
1210706	Cíl a index PHY poskytnuté ve struktuře EmberExtraCounterInfo jako součást emberCounterHandler() mohly být pro typy čítačů MAC TX Unicast nesprávné.
1211610 1212525	Opraven problém, kdy aplikace Dynamic Multiprotocol havarovaly po aktivaci komponenty Secure Key Storage Upgrade.
1211847	Zatímco signatura emberCounterHandler() se nezměnila, způsob naplnění jejích parametrů se mírně změnil. Změny kolem tohoto rozhraní API jsou vysvětleny v části 2 výše.
1212449	Odchozí majáky byly nesprávně kategorizovány vrstvou MAC, což vedlo k tomu, že emberCounterHandler() nedokázala zachytit tyto pakety s typem čítače EMBER_COUNTER_MAC_TX_BROADCAST a místo toho počítala majáky s typem čítače EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS. To mohlo mít za následek nespolehlivé hodnoty pro parametr dest EmberNodeId předaný do struktury EmberCounterInfo

ID #	Popis
1214866	Odesílání paketů dotazování dat v určitých konfiguracích s vysokým provozem může vést k poruše sběrnice.
1216552	Problém, který způsobuje aserci za podmínek vytíženého provozu, je opraven.
1216613	Opraven problém, který vedl k nesprávné hodnotě poloměru obsazení skupiny v proxy tabulce.
1222509	Směrovač/koordinátor odešle požadavek na opuštění a opětovné připojení na koncové zařízení, které není podřízené, ale cíl MAC je 0xFFFF místo toho, aby odpovídal cílové adrese NWK.
1223842	Opraven problém s generováním souboru sl_component_catalog.h, který v něm zanechával nežádoucí kód způsobující selhání kompilace.
756628	Vyvolání zpětného volání aplikace emberAfMacFilterMatchMessageCallback bylo změněno tak, aby bylo voláno pouze pro zprávy ZLL, které jsou ověřeny zásobníkem.
816088	Konfigurace EMBER byla přesunuta z zigbeed_configuration.h do zigbeed. slcp.
829508	Aby se předešlo sporu, bylo do emberSetLogicalAndRadioChannel přidáno další ověření, které vrátí neúspěšné, pokud jsou nižší vrstvy zaneprázdněny nebo nejsou ve stavu pro změnu kanálu.

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.si-labs.com/developers/zigbee-emberznet na kartě Technické dokumenty.

ID #	Popis	Řešení
N/A	·V tomto vydání nejsou podporovány následující aplikace/součásti: Podpora EM4	Tato funkce bude povolena v následujících verzích.
193492	Makro portování emberAfFillCommandGlobalServerToClientConfigureRe je poškozené. Naplnění vyrovnávací paměti vytvoří nesprávný příkazový paket.	Místo rozhraní API použijte příkaz CLI „zcl global send-me-a-report“.
278063	Chytrý energetický tunel plugins mít konfliktní zacházení/použití indexu tabulky adres.	Žádné známé řešení
289569	Výběrový seznam úrovně výkonu komponent tvůrce sítě nenabízí úplný rozsah podporovaných hodnot pro EFR32	Upravte rozsah <-8..20> zadaný v komentáři CMSIS pro EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P OWER v /protocol/ZigBee/app/framework/plugin/network-creator/config/network-creator-config.h file. Napřample, změňte na .
295498	V případě dynamického multiprotokolového použití Zigbee+BLE příjem UART někdy při velkém zatížení klesá o bajty.	Použijte hardwarové řízení toku nebo snižte přenosovou rychlost.
312291	EMHAL: Funkce halCommonGetIntxxMillisecondTick na hostitelích Linuxu aktuálně používají funkci získávání meofday, u které není zaručeno, že bude monotónní. Pokud se systémový čas změní, může to způsobit problémy s časováním zásobníku.	Upravte tyto funkce tak, aby místo toho používaly clock_gettime se zdrojem CLOCK_MONOTONIC.
338151	Inicializace NCP s nízkou hodnotou počtu vyrovnávací paměti paketů může způsobit poškození paketů.	Chcete-li se vyhnout příliš nízké výchozí hodnotě, použijte rezervovanou hodnotu 0xFF pro počet vyrovnávací paměti paketů
387750	Problém s formáty požadavků směrovací tabulky na koncovém zařízení.	V rámci vyšetřování
400418	Iniciátor touchlinku se nemůže připojit k cíli koncového zařízení, který není z výroby.	Žádné známé řešení.
424355	Netovární nový ospalý iniciátor dotykové linky koncového zařízení schopný cílení není za určitých okolností schopen přijímat informační odpověď zařízení.	V rámci vyšetřování
465180	Položka Coexistence Radio Blocker Optimization „Enable Runtime Control“ může blokovat správnou funkci Zigbee.	Volitelné ovládání „Wi-Fi Select“ optimalizace blokování by mělo zůstat „Zakázáno“.
480550	Cluster OTA má vestavěnou metodu fragmentace, proto by neměl používat fragmentaci APS. I když v případě, že je povoleno šifrování APS, zvýší se užitečné zatížení ImageBlockResponses na velikost, při které je aktivována fragmentace APS. To by mohlo vést k selhání procesu OTA.	Žádné známé řešení
481128	Podrobné podrobnosti o příčině resetování a selhání by měly být ve výchozím nastavení k dispozici prostřednictvím virtuálního UART (sériové 0) na platformách NCP, když je povolen zásuvný modul Diagnostics a periferie virtuálního UART.	Vzhledem k tomu, že sériové číslo 0 je již inicializováno v NCP, mohou zákazníci povolit zpětné volání emberAfNcpInitCallback v rámci Zigbee NCP a volat příslušné diagnostické funkce (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, halPrintCrashDetails a halPrint0 vytisknout tato data zpětného volání do SerialData) viewv protokolu zachycení Network Analyzeru. Pro exampInformace o tom, jak tyto funkce používat, naleznete v kódu obsaženém v emberAfMainInit() a-main-soc.c, když je definována EXTENDED_RESET_INFO.

ID #	Popis	Řešení
486369	Pokud má DynamicMultiProtocolLightSoc tvořící novou síť podřízené uzly ze sítě, kterou opustila, emberAfGetChildTableSize vrátí nenulovou hodnotu v startIdentifyOnAllChildNodes, což způsobí chybové zprávy Tx 66 při adresování „duchových“ potomků.	Před vytvořením nové sítě tuto část pokud možno hromadně vymažte nebo po opuštění sítě programově zkontrolujte podřízenou tabulku a před vytvořením nové sítě odstraňte všechny potomky pomocí emberRemoveChild.
495563	Připojení SPI NCP Sleepy End Device SampAplikace nezkracuje dotazování, proto se pokus o připojení nezdaří ve stavu Update TC Link Key.	Zařízení, které se chce připojit, by mělo být před pokusem o připojení v režimu krátkého dotazování. Tento režim lze vynutit pomocí pluginu End Device Support.
497832	V Network Analyzeru rozčlenění příkazu Zigbee Application Support pro rámec požadavku na ověření klíče chybně odkazuje na část užitečného zatížení, která označuje zdrojovou adresu rámce jako cílovou adresu.	Žádné známé řešení
519905 521782	Spi-NCP může velmi zřídka selhat při spuštění komunikace bootloaderu pomocí příkazu CLI „bootload“ pluginu ota-client.	Restartujte proces zavádění
620596	NCP SPI Přample pro BRD4181A (EFR32xGMG21) nWake defaultně definovaný pin nelze použít jako probuzení pin.	V pluginu NCP-SPI změňte výchozí pin pro nWake z PD03 na pin s povoleným probuzením EM2/3.
631713	Koncové zařízení Zigbee bude opakovaně hlásit konflikty adres, pokud se místo „Knihovny Zigbee PRO Stack Library“ použije plugin „Zigbee PRO Stack Library“.	Místo pluginu „Zigbee PRO Stack Library“ použijte „Knihovnu listů Zigbee PRO“.
670702	Neefektivita v modulu Reporting může vést k významné latenci na základě frekvence zápisu dat a velikosti tabulky, což může narušovat kód zákaznické aplikace, včetně časování událostí.	Pokud provádíte časté zápisy, zvažte kontrolu podmínek hlášení a ruční odesílání hlášení namísto použití pluginu.
708258	Neinicializovaná hodnota v groups-server.c prostřednictvím addEntryToGroupTable() může vytvořit falešnou vazbu a způsobit odeslání zpráv skupinového hlášení.	Přidejte „binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;“ za „vazbou.typ = EMBER_MULTICAST_BINDING;”
757775	Všechny díly EFR32 mají unikátní RSSI offset. Kromě toho může RSSI ovlivnit design desky, antény a kryt.	Při vytváření nového projektu nainstalujte komponentu RAIL Utility, RSSI. Tato funkce zahrnuje výchozí RSSI Offset Silabs měřené pro každý díl. Tento offset lze v případě potřeby upravit po RF testování vašeho kompletního produktu.
758965	Komponenty clusteru ZCL a tabulka zjišťování příkazů ZCL nejsou synchronizovány. Proto při povolení nebo zakázání komponenty clusteru ZCL nebudou implementované příkazy povoleny/deaktivovány v odpovídající záložce příkazů ZCL Advanced Configurator.	Ručně povolte/zakažte zjišťování požadovaných příkazů ZCL v pokročilém konfigurátoru ZCL.
765735	Aktualizace OTA selže na koncovém zařízení Sleepy s povolenou žádostí o stránku.	Místo požadavku na stránku použijte požadavek na blok.
845649	Odstranění CLI: Základní komponenta neodstraňuje volání EEPROM cli sl_cli.h.	Smažte soubor eeprom-cli.c file který volá sl_cli.h. Kromě toho lze zakomentovat volání sl_cli.h a také sl_cli_command_arg_t v souboru ota-storage-simple-eeprom.
857200	ias-zone-server. c umožňuje vytvoření vazby s adresou CIE „0000000000000000“ a později neumožňuje další vazby.	Žádné známé řešení
1019961	Generovaná značka Z3Gatewayfile pevné kódy „gcc“ jako CC	Žádné známé řešení

ID #	Popis	Řešení
1039767	Problém s přetečením fronty opakování sítě routeru Zigbee v případě použití vícevláknového RTOS.	Zigbee Stack není bezpečný pro vlákna. V důsledku toho není volání rozhraní API zásobníku Zigbee z jiné úlohy v prostředí operačního systému podporováno a může zásobník uvést do „nefunkčního“ stavu. Další informace a řešení pomocí obslužné rutiny události naleznete v následující poznámce k aplikaci. https://www.silabs.com/documents/public/application- notes/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk- 7x.pdf .
1064370	Přepínač Z3Switch sampAplikace ve výchozím nastavení povolila pouze jedno tlačítko (instance: btn1), což vede k neshodě v popisu tlačítka v projektu file.	Řešení: Nainstalujte instanci btn0 ručně během vytváření projektu Z3Switch.
1161063	Z3Light a potenciálně další aplikace hlásí nesprávné hodnoty revize clusteru.	Ručně aktualizujte atribut revize clusteru na příslušnou revizi.
1164768, 1171478, 1171479	CHYBA: ezspErrorHandler 0x34 se opakovaně hlásí během režimu příjmu mfglib	Chcete-li omezit tisk chybových zpráv, nakonfigurujte EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV ENT_TIMEOUT_MS v hostitelské aplikaci na 100, takže fronta zpětných volání se uvolní rychleji.
1252460	Rutiny obnovy SimEEPROM (pro v1 i v2) spuštěné při spuštění mohou provádět nesprávně zarovnaná volání mazání flash stránky, což má za následek aserce během em_msc. c's MSC_ErasePage rutina.	Řešení: Umístěte následující řádek kódu na začátek funkce MSC_ErasePage() v em_msc.c: počáteční adresa = (uint32_t*)((uint32_t)startAddress & ~(FLASH_PAGE_SIZE-1));

Zastaralé položky

Zastaralé ve vydání 
V GSDK 7.4.0.0 a novějších, včetně této opravy, je možnost „-v“ v Z3Gateway pro linuxovou hostitelskou aplikaci pro vytvoření rozhraní telnet s portem 4900 nebo 4901 zastaralá. Alternativní doporučený způsob vytvoření rozhraní telnet je použití linuxových utilit, jako je „socat“.

Zastaralé ve vydání 
Odstraněna následující zastaralá bezpečnostní rozhraní API:

• emberGetKey()
• emberGetKeyTableEntry()
• emberSetKeyTableEntry()
• emberHaveLinkKey()
• emberAddOrUpdateKeyTableEntry()
• emberAddTransientLinkKey()
• emberGetTransientKeyTableEntry()
• emberGetTransientLinkKey()
• emberHmacAesHash()

Pro přístup k úložišti klíčů a hašování HMAC použijte rozhraní API poskytovaná Zigbee Security Manager.

Odebrané položky

Odebráno ve vydání

• Byla odstraněna duplicitní veřejná rozhraní API ve veřejné hlavičce file gp-types.h.
• Komponenta zigbee_end_device_bind byla odstraněna. Tato komponenta sloužila koordinátorovi ke zprostředkování vazebních požadavků pro koncová zařízení. Tato volitelná funkce byla odstraněna z R22 specifikace jádra Zigbee.
• Odstraněno setPacketBufferCount() v af-host.c a zbytečný kontrolní případ EZSP_CONFIG_PACKET_BUFFER_COUNT: v command-handlers.c.
• Odstraněn argument memoryAllocation, protože při inicializaci NCP není třeba dělit na dvě fáze.
• Odebráno emberAfNcpInitCallback() v se14-comms-hub, se14-ihd a se14-meter-gas app.c.
• Odebrána hodnota nastavení EZSP_CONFIG_RETRY_QUEUE_SIZE během inicializace ncp v ncp-configuration.c

Multiprotokolová brána a RCP

Nové položky
Přidáno ve vydání

• Současný poslech, schopnost zásobníků Zigbee a OpenThread pracovat na nezávislých kanálech 802.15.4 při použití EFR32xG24 nebo xG21 RCP, je uvolněna.
• Souběžný poslech není k dispozici pro kombinaci 802.15.4 RCP/Bluetooth RCP, kombinaci Zigbee NCP/OpenThread RCP ani pro systém Zigbee/OpenThread system-on-chip (SoC). K těmto produktům bude přidán v budoucí verzi.
• Rozšíření dodavatele OpenThread CLI bylo přidáno do hostitelských aplikací OpenThread multiprotokolových kontejnerů. To zahrnuje příkazy coex cli.

Vylepšení
Změněno ve vydání

• Multiprotokolová kombinace Zigbee NCP/OpenThread RCP je nyní výrobní kvalitou.

Opravené problémy
Opraveno ve vydání

ID #	Popis
1213701	zigbeed neumožnil vytvoření položky zdrojové identifikační tabulky pro potomka, pokud nepřímá fronta MAC obsahuje data pro tohoto potomka již čekající na vyřízení. Toto chování by mohlo vést k selhání transakcí aplikační vrstvy mezi podřízeným zařízením a některým jiným zařízením kvůli nedostatku APS Ack nebo odezvy aplikační vrstvy, zejména narušení a neočekávané ukončení upgradů ZCL OTA zaměřených na podřízené zařízení.
1244461	Záznam zdrojové identifikační tabulky pro dítě bylo možné odstranit navzdory čekajícím zprávám.

Opraveno ve vydání

ID #	Popis
1081828	Problém s propustností u Zigbee/BLE DMP s FreeRTOSample aplikace.
1090921	Z3GatewayCpc měl potíže s vytvořením sítě v hlučném prostředí.
1153055	Aserence na hostiteli byla způsobena, když došlo k selhání komunikace při čtení verze NCP ze souboru zigbee_ncp-ble_ncp-uart sampaplikace.
1155676	802.15.4 RCP zahodil všechny přijaté unicast pakety (po potvrzení MAC), pokud více rozhraní 15.4 sdílelo stejné 16bitové ID uzlu.
1173178	Hostitel falešně hlásil stovky paketů přijatých pomocí mfglib v nastavení Host-RCP.
1190859	Chyba EZSP při odesílání náhodných paketů mfglib v nastavení Host-RCP.
1199706	Výzvy dat od zapomenutých potomků koncových zařízení správně nenastavovaly čekající rámec na RCP pro zařazení příkazu Leave & Rejoin k bývalému dítěti.
1207967	Příkaz „mfglib send random“ odesílal další pakety na Zigbeed.
1208012	Režim mfglib rx neaktualizoval správně informace o paketech při příjmu na RCP.
1214359	Uzel koordinátora selhal, když se 80 nebo více směrovačů pokusilo připojit současně v nastavení Host-RCP.
1216470	Po předání vysílání pro masku adresy 0xFFFF by Zigbee RCP jednající jako nadřazené zařízení ponechalo nevyřízený datový příznak nastavený pro každého potomka. To vedlo k tomu, že každé dítě zůstalo vzhůru a očekávalo data po každém dotazování a vyžadovalo to nějakou další nevyřízenou datovou transakci do každého koncového zařízení, aby se tento stav nakonec vymazal.

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

Problémy označené tučně byly přidány od předchozí verze. Pokud jste zmeškali vydání, poslední poznámky k vydání jsou k dispozici na https://www.si-labs.com/developers/gecko-software-development-kit.

ID #	Popis	Řešení
811732	Při použití Zigbeed není k dispozici podpora vlastních tokenů.	Podpora je plánována v budoucí verzi.
937562	Příkaz Bluetoothctl „reklamovat na“ selže s aplikací rcp-uart-802154-blehci na Raspberry Pi OS 11.	Místo bluetoothctl použijte aplikaci btmgmt.
1022972	Coex nefunguje na ZB NCP + OT RCP.	Podpora je plánována pro budoucí vydání.
1074205	CMP RCP nepodporuje dvě sítě na stejném PAN id.	Pro každou síť použijte různá ID PAN. Podpora je plánována v budoucí verzi.
1122723	V rušném prostředí může CLI přestat reagovat v aplikaci z3-light_ot-ftd_soc.	Žádné známé řešení.
1124140	z3-light_ot-ftd_soc sampAplikace není schopna vytvořit síť Zigbee, pokud je síť OT již aktivní.	Nejprve spusťte síť Zigbee a poté síť OT.
1170052	CMP Zigbee NCP + OT RCP a DMP Zigbee NCP + BLE NCP se v tomto aktuálním vydání nemusí vejít na 64KB a nižší části RAM.	Části o velikosti 64 kB nejsou pro tyto aplikace aktuálně podporovány.
1209958	ZB/OT/BLE RCP na Bobcat a Bobcat Lite může přestat fungovat po několika minutách při spuštění všech tří protokolů	Bude řešeno v budoucí verzi
1221299	Hodnoty RSSI Mfglib se mezi RCP a NCP liší.	Bude řešeno v budoucí verzi.
1231021	OTBR se může prosadit, když se současně připojuje 80+ zigbee zařízení.	Byla přidána oprava, která může problém vyřešit. Bude plně řešeno v budoucí verzi.

Zastaralé položky

• Žádný

Odebrané položky
Odebráno ve vydání

• Makro „NONCOMPLIANT_ACK_TIMING_WORKAROUND“ bylo odstraněno. Všechny aplikace RCP nyní standardně podporují 192 μs pro nevylepšená acks, zatímco stále používají 256 μs pro vylepšená acks požadovaná CSL.

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 Gecko SDK (GSDK), sady SDK Silicon Labs. Chcete-li rychle začít s GSDK, nainstalujte Simplicity Studio 5, které nastaví vaše vývojové prostředí a provede vás instalací GSDK. 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 Gecko SDK nainstalovat ručně stažením nebo klonováním nejnovější verze z GitHubu. Vidět https://github.com/Sili-conLabs/gecko_sdk pro více informací.

Simplicity Studio standardně nainstaluje GSDK do:

• (Windows): C:\Users\ \SimplicityStudio\SDKs\gecko_sdk
• (MacOS): /Users/ /SimplicityStudio/SDKs/gecko_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). Reference API a další informace o tomto a dřívějších vydáních jsou k dispozici 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íč	Exportovatelné / Neexportovatelné	Poznámky
Síťový klíč	Exportovatelné
Klíč propojení centra důvěryhodnosti	Exportovatelné
Klíč přechodného spojení	Exportovatelné	Tabulka indexovaných klíčů, uložená jako volatilní klíč
Klíč odkazu na aplikaci	Exportovatelné	Tabulka indexovaných klíčů
Zabezpečený klíč EZSP	Exportovatelné
Šifrovací klíč ZLL	Exportovatelné
Předkonfigurovaný klíč ZLL	Exportovatelné
Proxy klíč GPD	Exportovatelné	Tabulka indexovaných klíčů
GPD Sink Key	Exportovatelné	Tabulka indexovaných klíčů
Interní/Zástupný klíč	Exportovatelné	Interní klíč pro použití 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 dostupné uživatelské aplikaci a nyní jsou směrovány přes komponentu Zigbee Security Manager.
• Některé z těchto klíčů mohou být v budoucnu neexportovatelné do uživatelské aplikace. Uživatelským aplikacím se doporučuje, aby se nespoléhaly na export klíčů, pokud to není nezbytně nutné.
• Další informace o funkci Secure Vault Key Management najdete v AN1271: Secure Key Storage.

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 stránku, kde 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.

Studio jednoduchosti
Přístup jedním kliknutím k MCU a bezdrátovým nástrojům, dokumentaci, softwaru, knihovnám zdrojového kódu a dalším. K dispozici pro Windows, Mac a Linux!

• www.silabs.com/IoT
• www.silabs.com/simplicity
• www.silabs.com/quality
• www.silabs.com/community

Zřeknutí se odpovědnosti
Silicon Labs má v úmyslu poskytovat zákazníkům nejnovější, přesnou a hloubkovou dokumentaci všech periferií a modulů dostupných pro implementátory systémů a softwaru, kteří používají nebo hodlají používat produkty Silicon Labs. Charakterizační údaje, dostupné moduly a periferie, velikosti paměti a adresy paměti se vztahují ke každému konkrétnímu zařízení a poskytnuté „typické“ parametry se mohou v různých aplikacích lišit a mění se. Aplikace exampzde popsané texty slouží pouze pro ilustrativní účely. Společnost Silicon Labs si vyhrazuje právo provádět změny bez dalšího upozornění v informacích o produktech, specifikacích a popisech zde uvedených a neposkytuje žádné záruky na přesnost nebo úplnost obsažených informací. Bez předchozího upozornění může společnost Silicon Labs aktualizovat firmware produktu během výrobního procesu z důvodu bezpečnosti nebo spolehlivosti. Tyto změny nezmění specifikace ani výkon produktu. Silicon Labs nenese žádnou odpovědnost za důsledky použití informací uvedených v tomto dokumentu. Tento dokument neimplikuje ani výslovně neuděluje žádnou licenci k navrhování nebo výrobě jakýchkoli integrovaných obvodů. Produkty nejsou navrženy ani schváleny k použití v zařízeních třídy III FDA, aplikacích, pro které je vyžadováno schválení FDA před uvedením na trh, nebo v systémech podpory života bez konkrétního písemného souhlasu Silicon Labs. „Systém podpory života“ je jakýkoli produkt nebo systém určený k podpoře nebo udržení života a/nebo zdraví, u kterého lze důvodně předpokládat, že pokud selže, povede k vážnému zranění nebo smrti. Produkty Silicon Labs nejsou navrženy ani schváleny pro vojenské aplikace. Produkty Silicon Labs se za žádných okolností nesmějí používat ve zbraních hromadného ničení, včetně (ale nejen) jaderných, biologických nebo chemických zbraní nebo střel schopných takové zbraně nést. Silicon Labs se zříká všech výslovných a předpokládaných záruk a nenese odpovědnost za jakákoli zranění nebo škody související s používáním produktu Silicon Labs v takových neautorizovaných aplikacích.

Poznámka: Tento obsah může obsahovat urážlivou terminologii, která je nyní zastaralá. Silicon Labs nahrazuje tyto termíny inkluzivním jazykem, kdykoli je to možné. Pro více informací navštivte www.silabs.com/about-us/inclusive-lexicon-project.

Informace o ochranné známce
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® a logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, logo Energy Micro a jejich kombinace , „Energeticky nejšetrnější mikrokontroléry na světě“, Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, logo Zentri a Zentri DMS, Z- Wave® a další jsou ochranné známky nebo registrované ochranné známky společnosti Silicon Labs. ARM, CORTEX, Cortex-M3 a THUMB jsou ochranné známky nebo registrované ochranné známky společnosti ARM Holdings. Keil je registrovaná ochranná známka společnosti ARM Limited. Wi-Fi je registrovaná ochranná známka sdružení Wi-Fi Alliance. Všechny ostatní produkty nebo názvy značek zde uvedené jsou ochrannými známkami příslušných vlastníků.

KONTAKT

• Silicon Laboratories Inc.
• 400 West Cesar Chavez
• Austin, TX 78701
• USA
• www.silabs.com

Dokumenty / zdroje

Software SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack [pdfUživatelská příručka SDK 7.4.1.0 GA Zigbee Protocol Stack Software, SDK 7.4.1.0 GA, Zigbee Protocol Stack Software, Protocol Stack Software, Stack Software

Reference

• Uživatelská příručka