Uživatelská příručka SILICON LABS 7.4.5.0 Zigbee Ember Z Net SDK

Oznámení o kompatibilitě a použití
Aktualizace zabezpečení a upozornění najdete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nebo na kartě TECH DOCS na Silicon Labs webmísto. Chcete-li získat nejnovější informace, doporučujeme se přihlásit k odběru bezpečnostních rad.

Kompatibilní kompilátory
Ujistěte se, že používáte správný files podporovaným kompilátorem
GCC (The GNU Compiler Collection) verze 12.2.1 dodávaná se Simplicity Studio.

Protokol EZSP
Verze protokolu EZSP pro toto vydání je 0x0D.

FAQ

Otázka: Jaké jsou nové komponenty představené ve verzi 7.4.5.0?
- Odpověď: Uživatelé nyní mohou mít povoleno více komponent zigbee_direct_security v aplikaci přímého zařízení Zigbee (ZDD), přičemž skutečná možnost zabezpečení závisí na konfiguraci virtuálního zařízení Zigbee (ZVD).

Otázka: Jaká jsou nová rozhraní API přidaná ve verzi 7.4.4.0?
- Odpověď: Mezi nová rozhraní API patří mfglibSetCtune a mfglibGetCtune.

Otázka: Jaká je nová podpora platformy představená ve verzi 7.4.5.0?
- Odpověď: EFR32MG24A020F768IM40 je nyní podporována jako platforma.

Otázka: Kde najdu aktualizovanou dokumentaci ke komponentě Zigbee Secure Key Storage?
- Odpověď: Popis komponenty Zigbee Secure Key Storage byl aktualizován ve verzi 7.4.0.0 spolu s novou poznámkou k aplikaci pro interakci se skupinou komponent Zigbee Security Manager (AN1412: Zigbee Security Manager).

Zigbee EmberZNet SDK 7.4.5.0 GA

Gecko SDK Suite 4.4

23. října 2024

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.5.0 vydáno 23. října 2024
7.4.4.0 vydáno 14. srpna 2024

7.4.3.0 vydáno 2. května 2024
7.4.2.0 vydáno 10. dubna 2024

7.4.1.0 vydáno 14. února 2024
7.4.0.0 vydáno 13. prosince 2023

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 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 se sadou Zigbee EmberZNet SDK poprvé, 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í vína k sestavení pomocí nástroje příkazového řádku IarBuild.exe nebo grafického uživatelského rozhraní IAR Embedded Workbench v systému macOS nebo Linux může vést k nesprávným files se používá kvůli kolizím v hashovacím algoritmu vína pro generování zkratů 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 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

Nové komponenty

Novinka ve verzi 7.4.0.0
Byly přidány komponenty „zigbee_direct_security_p256“ a „zigbee_direct_security_curve25519“, aby uživatelé mohli konfigurovat 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 verzi 7.4.4.0
Zavedena dvě vyhrazená výrobní lib API pro získání a nastavení hodnot CTUNE.
V dřívějších vydáních oprav se přístup a nastavení hodnoty CTUNE staly součástí RAIL API. V tomto patchi je takto zavedena sada výrobních API, která zapouzdřují RAIL API, aby se nastavila a získala hodnota.
mfglibSetCtune
mfglibGetCtune

Novinka ve verzi 7.4.2.0

Rozšířené SPI NCP pro podporu režimů spánku v některých případech použití Host-NCP.
V tomto případě použití lze SPI NCP nakonfigurovat jako ospalé koncové zařízení. Hostitel Z3Gateway sampAplikace je rozšířena o další vlastní kód CLI odpovědný za příkaz NCP, aby vstoupil do jednoho z režimů spánku prostřednictvím vlastního příkazu CLI sleepMode, a před další komunikací EZSP se musí probudit pomocí vlastního příkazu CLI probuzení.
Zavedeno nové API sl_zigbee_af_isr_event_init pro inicializaci událostí aplikačního rámce, které mají být aktivovány v rámci rutiny služby přerušení (ISR). Tyto události, které jsou naplánovány z ISR, musí mít parametr zpoždění 0 milisekund. Jinými slovy, události z ISR musí být aktivovány jako okamžitá událost. Uvnitř ISR není povolena žádná deaktivace události.
Důvod výše uvedeného je následující: Systém událostí manipuluje s frontou událostí během plánování (aktivace s nenulovým zpožděním nebo deaktivace) události. Aby se minimalizovala latence, ISR by měl aktivovat událost se zpožděním 0, která se naplánuje při dalším zpracování fronty událostí. To umožňuje provést další zpoždění nebo deaktivaci po ukončení ISR. Pro rozlišení událostí určených k použití v kontextu ISR je struktura události během inicializace označena značkou sli_zigbee_isr_event_marker.
Viz zdroj zigbee_app_framework_event.h file podrobnosti o této nové funkci.
Objasnění použití nové funkce Aktualizovat Multi Mac Znovu připojit masku kanálu pro výběr nebo připojení zařízení, která se nazývá uvnitř zásobníku API, začlenit Find And Rejoin Network With Reason, aby se získala maska kanálu použitá pro opětovné připojení.

Specifikace SE1.4a omezuje změnu rozhraní (z 2.4 GHz na sub-GHz nebo naopak) během opětovného připojení zařízení typu Multi-MAC Joining End. Vzhledem k tomu, že typ zařízení je konfigurací aplikačního rámce (to znamená, že připojujícím se typem koncového zařízení bude při konfiguraci buď zařízení sub-GHz nebo 2.4 GHz, nikoli obojí), toto volání poskytuje masku kanálu na základě této konfigurace, takže že maska opětovného připojení je vždy stejná jako maska rozhraní připojení.

Novinka ve verzi 7.4.0.0

Přidáno nové rozhraní API void sl_zigbee_token_factory_reset (bool exclude_outgoing_fc, bool exclude_boot_counter) 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íč, na který odkazuje kontext, stejnou hodnotu jako klíč zadaný v argumentu.

Podpora nové platformy

Novinka ve verzi 7.4.0.0
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 snímků pro 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 verzi 7.4.0.0 ember Counter Handler API Doc Changes
V předchozích verzích zpětné volání Counter Handler pro MAC a APS vrstvy Ember Counter Types týkající se paketů RX a TX nebylo předáno předáním správného ID cílového uzlu nebo datových argumentů 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 ember Counter Handler() 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 zástupná hodnota je
Místo toho se používá 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 v ember-types.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 vydání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 je však nadále vyplněn v parametru data pro
EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED typy čítačů, aby byly 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 bylo očekáváno ID uzlu, ale nebylo možné jej získat z paketu, jak je popsáno v revidovaném emberu. -types.h dokumentace.

Obslužná rutina čítače pro EMBER_COUNTER_MAC_TX_UNICAST_RETRY nyní správně odráží ID cílového uzlu vrstvy MAC a počet 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 již není místo pro vytváření zpráv Green Power.
Umyvadlo nyní zruší konfiguraci párování s akcí Odebrat 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 odstraněním při zpracování konfigurace párování s akcí Rozšířit.
Příkaz Translation query vrátí „NOT FOUND“ jako kód chyby, když je překladová tabulka prázdná nebo index je větší než počet položek v tabulce.
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í používá argument sl_zb_sec_man_context_t namí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 verzi 7.4.5.0

ID #	Popis
1357860	Opraven problém, který způsoboval selhání, když více koncových bodů začalo inicializovat událost zpětné vazby identifikace. (Další ref: 1348659)
1357517	Opraven problém, který způsoboval pád, když se aplikace pro více sítí pokusila ovládat sekundární síť.
1356285	Ve vzácných případech může být paket předán zpětnému volání odchozího předání paketů s parametrem indexu užitečného zatížení, který překračuje uvedenou délku vyrovnávací paměti paketů, což vede k potvrzení v legacy-packet-buffer.c, pokud je povolena komponenta předání paketů. Funkce obslužné rutiny příchozí a odchozí součásti nyní zachytí tento stav a zahodí neplatný paket bez dalšího zpracování. (Další ref: 1350285)
1355289	Opraven problém, který způsoboval, že odpověď LQI byla přijímána s MAC adresou jako samé nuly. (Další ref.: 1351489)
1349160	Brána Z3Gateway postavená na Raspberry Pi s jádrem 6.6 se ve výchozím nastavení nedokázala připojit k NCP přes SPI. Řešením je předefinovat GPIO, jak je popsáno zde. Všimněte si následujících informací o GPIO, které se mapují na rozhraní SPI NCP. V jádře 6.6 spusťte sudo cat /sys/kernel/debug/gpio Zobrazí se následující gpio-520 (GPIO8) gpio-534 (GPIO22) gpio-535 (GPIO23) gpio-536 (GPIO24) Poté předefinujte rozhraní GPIO pro SPI NCP z výše uvedeného sysfs v spi-protocol-linux-config.h jako #define NCP_CHIP_SELECT_GPIO „520“ #define NCP_HOST_INT_GPIO „534“ #define NCP_RESET_GPIO „535“ #define NCP_WAKE_GPIO „536“ (Jiné ref: 1297976)
1343044	Pokud plugin Fragmentation špatně spočítal dostupné užitečné zatížení pro unicastový fragment, mohl by odeslat více dat do NCP, než se vejde do jednoho paketu po započtení veškeré režie zásobníku. To by mohlo vést k poškození paměti v NCP, které spustilo selhání potvrzení nebo jiné neočekávané chování. (Další ref.: 1289413)
1343012	Do knihovny phy-pro4468plus-library byla přidána oprava firmwaru Si2, která řeší závodní podmínky při zpracování sub-GHz Tx/Rx. (Další ref: 1341928)
1311214	Opravena dodatečná výchozí odpověď generovaná, když má příchozí zpráva ZCL příkaz serveru OTA povolenou výchozí odpověď. Odešle se pouze jedna odpověď na chybu a pro úspěšné žádosti o blokový obrázek není nastavena žádná výchozí odpověď. (Další ref.: 1300935)
1296653	Pokud zařízení dual-PHY NCP provádělo skenování energie v pásmu sub-GHz, zatímco bylo aktivní rádio 2.4 GHz, velké výbuchy příchozího provozu majáku v reakci na příchozí požadavky na maják na rádiovém kanálu 2.4 GHz by mohly zabírat velké množství vyrovnávací paměť zásobníku (přidělená ze segmentu haldy), zatímco bylo skenováno mnoho kanálů pod GHz, což by mohlo vést k nedostatku vyrovnávací pamětitages a EZSP podmínky přetečení, pokud velikost haldy (která určuje, kolik vyrovnávacích pamětí má systém k dispozici) nebyla dostatečně velká. Tento stav přetečení by mohl zabránit obslužné rutině skenování v dosažení hostitelské aplikace, což by způsobilo, že se stroj se stavem skenování aplikace navždy zablokoval. Kód Energy Scanning pro duální PHY zařízení nyní zahazuje všechny pakety Beacon přijaté na 2.4GHz rádiu během skenování sub-GHz kanálu, čímž zabraňuje velkému přílivu majáků ve vytváření výše uvedeného problému. Všimněte si, že to nebrání normálnímu provozu sítě na 2.4 GHz, protože Beacons se používají pouze pro detekci potenciálního konfliktu PAN ID, když zařízení neprovádí aktivní skenování, a konflikty PAN ID mohou být stále detekovány jinými směrovači v síti během tentokrát nebo koordinátorem po dokončení energetického skenování. (Další ref.: 1276049)

ID #	Popis
1295250	Opraveny problémy s kompilací při přidávání komponenty testovacího svazku Zigbee 3.0 do standardní aplikace. (Další ref: 1280058)
1294848	Přidány kontroly pro datové pole ZCL, aby vyhovovalo nejdelším délkám řetězce až 253. (Jiné ref: 1275092)
1294843	Opravena chybějící inicializace lokálních proměnných před použitím. (Další ref: 1275104)
1271968	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 : Ujistěte se, že je ve vaší aplikaci povolen hlídací časovač s konfigurační položkou SL_LEGACY_HAL_DISABLE_WATCHDOG nastavenou na 0.
1270721	Opraven problém pro zlepšení víceskokového spojení zařízení. Po oznámení zařízení je dvojice adres přidána do mezipaměti adres. (Další ref.: 1266351)

Opraveno ve verzi 7.4.4.0

ID #	Popis
1334454	Opraven problém při zpracování odpovědi na opětovné připojení. (Další ref: 1331580)
1330732	Diagnostická funkce by měla zakázat přerušení po volání Iostream, aby se zabránilo aktivaci při získávání mutexu.
1330720	EZSP_MAX_FRAME_LENGTH je vráceno zpět na 220, což umožňuje, aby maximální délka zprávy XNCP byla také 220. (Další ref.: 1327706)
1330311	Opraven problém, který způsoboval selhání některých testů proxy GP při nastavení hostitele RCP. (Další ref: 1328991)
1312369	Vytvořená slabá funkce SL_LEGACY_HAL_WDOG_IRQHandler(), která umožňuje zákazníkům poskytovat vlastní implementaci.
1310711	Přidána kontrola chyb při kompilaci pro SL_STACK_SIZE při použití komponenty RTOS v projektu zigbee.
1309913	Byla přidána ochrana mutex pro frontu událostí App Framework, aby bylo možné volat rozhraní API událostí App Framework z více úloh. (Další ref.: 1252940, 1254397)
1309333	Poté, co se nové koncové zařízení připojí v pásmu sub-GHz, byla data stárnutí pracovního cyklu omylem vymazána pro všechny podřízené koncové zařízení. (Další ref.: 1296881)
1296002	Problém, který způsobil více definic funkce halAppBootloader, byl vyřešen.
1295756	Události zásobníku, které nejsou označeny jako bezpečné proti přerušení, by neměly být naplánovány v kontextu ISR, protože by to mohlo způsobit spor, který by vedl k vyřazení události z fronty událostí. Instance tohoto zabránila zařízením pod pásmem GHz správně naplánovat stažení MAC při spuštění tohoto sporu. (Další ref.: 1269856)
1294660	Opraven problém, kdy se zásuvný modul pro řízení sítě mohl chovat, jako by zařízení již bylo v síti, i když nebylo, a uvízl v tomto neplatném stavu až do resetování. To by mohlo být spuštěno voláním příkazu CLI opustit síť s dostatečně přesným načasováním, zatímco řízení sítě bylo uprostřed připojování k síti a stále čeká na skenování MAC. (Další ref.: 1293923)
1290695	Opraven problém, který zahazoval zprovozňovací paket ZLL pro případ použití, kdy je jeden koncový bod deaktivován, zatímco ostatní koncové body jsou stále povoleny. Oprava je přidána ke kontrole všech povolených koncových bodů. (Další ref.: 1275586)

Opraveno ve verzi 7.4.0.0

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	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í v 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.
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	Přidána podmínka pro kontrolu, zda chybí pole „čas přechodu“, a pro toto chybějící pole nastavte výchozí hodnotu 0xFFFF.
1166340	Opraven problém, který bránil emberAfGpdfSend odeslat zamýšlený počet opakovaných přenosů.

ID #	Popis
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í při 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 se 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	Ve 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 s nastavením memset pro 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 žádná nevyřízená 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žívaný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 povolení 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
1214866	Odeslání paketu 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 skupinového vysílání v tabulce proxy.
1222509	Router/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 namísto shody s cílovou adresou 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.

ID #	Popis
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

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

ID #	Popis	Řešení
N/A	Následující aplikace/komponenty nejsou v tomto vydání podporovány: Podpora EM4.	Funkce bude povolena v následujících verzích.
193492	Makro portování emberAfFillCommandGlobalServerToClientConfigureRe je poškozené. Zaplněním bufferu vznikne 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 Network-creator 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 gettimeofday, 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ého odkazu 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á vlastní 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ě resetu a selhání by měly být k dispozici ve výchozím nastavení prostřednictvím virtuálního UART (sériové 0) na platformách NCP, když je povolen diagnostický plugin a virtuální UART periferie.	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() af-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 zavaděče pomocí příkazu CLI „bootload“ zásuvného modulu 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 vysílání.	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, který SiLabs naměřil 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í komponenty CLI:Core neodstraní volání cli EEPROM pro 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.

Zastaralé položky

Zastaralé ve verzi 7.4.5.0
V GSDK 7.4.5.0 je zigbee_watchdog_periodic_refresh zastaralá. Alternativním doporučeným způsobem obnovení časovače hlídacího psa je použití starších rozhraní API hlídacího časovače v periodické události specifické pro aplikaci.

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

Zastaralé ve verzi 7.4.0.0
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

Odstraněno ve verzi 7.4.0.0

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.
Byla odstraněna sada Packet BufferCount() v af-host.c a zbytečný kontrolní případ EZSP_CONFIG_PACKET_BUFFER_COUNT: v command-handlers.c.
Odstraněn argument alokace paměti, 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 verzi 7.4.0.0
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 verzi 7.4.0.0
Multiprotokolová kombinace Zigbee NCP/OpenThread RCP je nyní výrobní kvalitou. Tato sampTato aplikace není podporována na zařízeních Series-1 EFR.

Opravené problémy

Opraveno ve verzi 7.4.5.0

ID #	Popis
1328799	Měkký reset spuštěný příkazem Spinel RESET nyní vymaže vyrovnávací paměti 15.4 RCP.
1337101	Neúplné přenosové operace 15.4 (Tx čekání na potvrzení, Tx potvrzení jako odpověď na zprávu atd.) již nejsou předčasně považovány za neúspěšné při přerušení rádia v důsledku DMP. To umožňuje, aby byla dané operaci dána příležitost k přeplánování po přerušení nebo trvalém selhání ze strany RAIL (chybové události stavu plánovače). (Další ref.: 1339032)
1337228	V Zigbeed je nyní tick API halCommonGetInt32uMillisecondTick() aktualizováno tak, aby používalo MONOTONICKÉ hodiny, takže není ovlivněno NTP v hostitelském systému. (Další ref.: 1339032)
1346785	Opraven spor, který mohl způsobit, že souběžný poslech na 802.15.4 RCP byl zakázán, když oba protokoly vysílaly současně. (Další ref.: 1349176)
1346849	Přidání komponenty rail_mux do projektu nyní způsobí, že se automaticky sestaví s přidruženými variantami knihovny zásobníku. (Další ref.: 1349102)

Opraveno ve verzi 7.4.4.0

ID #	Popis
1184065	Snížená paměť RAM pro zigbee_ncp-ot_rcp-spi a zigbee_ncp-ot_rcp_uart na MG13 a MG21.
1282264	Opraven problém, který mohl přerušit operace rádiového přenosu předčasným vymazáním vysílacího fifo způsobující podtečení.
1292537	Aplikace DMP Zigbee-BLE NCP se nyní správně zobrazuje v uživatelském rozhraní Simplicity Studio. (Další ref.: 1292540)

1230193	Opraven problém s nesprávným typem uzlu při připojování k síti na koncovém zařízení. (Další ref: 1298347)
1332330	Opraven problém, kdy RCP 15.4+BLE pracující v prostředí se silným síťovým provozem mohl občas narazit na spor, který by mu znemožnil odesílat zprávy až do CPCd, dokud se zařízení nerestartuje. (Další ref.: 1333156)

Opraveno ve verzi 7.4.2.0

ID #	Popis
1022972	Přidán koexistenční plugin zpět do Zigbee-OpenThread NCP/RCP sample aplikace.
1231021	Vyhněte se tvrzení v OTBR, které bylo pozorováno při připojování 80+ zigbee zařízení, a to obnovením RCP spíše než předáním nezpracovaných chyb přenosu do sub mac.
1249346	Byl vyřešen problém, kdy RCP mohlo nesprávně vyřadit pakety určené pro hostitele, což vedlo k chybě analýzy v OTBR a neočekávanému ukončení.

Opraveno ve verzi 7.4.1.0

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 verzi 7.4.0.0

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í
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.
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.
1334477	Několikrátové spuštění a zastavení zásobníku BLE může způsobit, že zásobník BLE nebude moci znovu spustit reklamu na zařízeních EFR Series 1 v DMP Zigbee-BLE sample aplikace.	N/A

Zastaralé položky Žádné

Odebrané položky

Odstraněno ve verzi 7.4.0.0
Makro „NONCOMPLIANT_ACK_TIMING_WORKAROUND“ bylo odstraněno. Všechny aplikace RCP nyní ve výchozím nastavení podporují 192 µs pro nevylepšená acks, zatímco stále používají 256 µs pro vylepšená acks vyž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 ve výchozím nastavení nainstaluje GSDK

(Windows): C:\Users\ \SimplicityStudio\SDKs\gecko_sdk
(Operační Systém Mac): /Uživatelé/ /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.

Následující obrázek je example

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!

Portfolio IoT
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity
Kvalitní
www.silabs.com/quality
Podpora a komunita
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 systémové a softwarové implementátory, 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.

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, 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ů.

Silicon Laboratories Inc.

400 West Cesar Chavez Austin, TX 78701
USA
www.silabs.com

Dokumenty / zdroje

SILICON LABS 7.4.5.0 Zigbee Ember Z Net SDK [pdfUživatelská příručka
7.4.5.0, 7.4.4.0, 7.4.3.0, 7.4.2.0, 7.4.1.0, 7.4.0.0, 7.4.5.0 Zigbee Ember Z Net SDK, 7.4.5.0, Zigbee Ember Z Net SDK, Ember Z Net SDK, Ember Z Net SDK SDK, Net SDK, SDK

Reference

Uživatelská příručka

SILICON LABS 7.4.5.0 Zigbee Ember Z Net SDK

Návod k použití produktu