SILICON LABS 7.4.0.0 Podręcznik użytkownika oprogramowania Zigbee EmberZNet SDK

Silicon Labs jest dostawcą wybieranym przez producentów OEM rozwijających sieć Zigbee w swoich produktach. Platforma Zigbee firmy Silicon Labs jest najbardziej zintegrowanym, kompletnym i bogatym w funkcje dostępnym rozwiązaniem Zigbee.

Silicon Labs EmberZNet SDK zawiera implementację specyfikacji stosu Zigbee opracowanej przez Silicon Labs.

Te informacje o wersji dotyczą wersji SDK:

Wersja 7.4.0.0 wydana 13 grudnia 2023 r

GŁÓWNE CECHY

Zigbee

Zgodność z Zigbee R23

Zgodność z Zigbee Smart Energy 1.4a – produkcja
Zgodność z Zigbee GP 1.1.2 – Alpha

Wsparcie MG27 – produkcja
Ulepszona obsługa części Secure Vault

Senne wsparcie dla aplikacji NCP SPI (nie-CPC) – Alpha

Wieloprotokołowy

Obsługa jednoczesnego słuchania (RCP) – MG21 i MG24
Współbieżny wieloprotokołowy (CMP) Zigbee NCP + OpenThread RCP – produkcja

Dynamiczny wieloprotokołowy Bluetooth + jednoczesna obsługa wieloprotokołowa (CMP) Zigbee i OpenThread w SoC

Uwagi dotyczące kompatybilności i użytkowania

Aby uzyskać informacje o aktualizacjach zabezpieczeń i uwagach, zobacz rozdział Bezpieczeństwo informacji o wersji platformy Gecko zainstalowanej z tym SDK lub w zakładce TECH DOCS na https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs zdecydowanie zaleca również subskrypcję Poradników bezpieczeństwa, aby uzyskać aktualne informacje. Aby uzyskać instrukcje lub jeśli nie znasz jeszcze zestawu SDK Zigbee EmberZNet, zobacz Korzystanie z tej wersji.

Kompatybilne kompilatory:

IAR Embedded Workbench dla ARM (IAR-EWARM) w wersji 9.40.1.

Użycie Wine do kompilacji za pomocą narzędzia wiersza poleceń IarBuild.exe lub interfejsu GUI IAR Embedded Workbench w systemie macOS lub Linux może spowodować nieprawidłowe files jest używany z powodu kolizji w algorytmie haszującym wine do generowania skrótów file imiona.

Klientom korzystającym z systemu macOS lub Linux zaleca się, aby nie tworzyli z IAR poza Simplicity Studio. Klienci, którzy to robią, powinni dokładnie sprawdzić, czy to prawda files są używane.

GCC (The GNU Compiler Collection) wersja 12.2.1, dostarczona z Simplicity Studio.

Wersja protokołu EZSP dla tej wersji to 0x0D.

Nowe przedmioty

To wydanie Gecko SDK (GSDK) będzie ostatnim z łączną obsługą wszystkich urządzeń EFM i EFR, z wyjątkiem poprawek do tej wersji, jeśli to konieczne. Od połowy 2024 r. wprowadzimy osobne pakiety SDK:

Istniejący zestaw SDK Gecko będzie nadal wspierał urządzenia z serii 0 i 1.
Nowy pakiet SDK będzie przeznaczony specjalnie dla urządzeń z serii 2 i 3.

Pakiet Gecko SDK będzie nadal wspierać wszystkie urządzenia serii 0 i 1 bez zmian w zakresie długoterminowego wsparcia, konserwacji, jakości i czasu reakcji zapewnianego zgodnie z naszymi zasadami dotyczącymi oprogramowania.

Nowy SDK będzie odgałęzieniem Gecko SDK i zacznie oferować nowe funkcje, które pomogą programistom w wykorzystaniu zaawansowanych rozwiązańtage z zaawansowanych możliwości naszych produktów serii 2 i 3.

Decyzja ta jest zgodna z opiniami klientów i odzwierciedla nasze zaangażowanie w podnoszenie jakości, zapewnianie stabilności i zwiększanie wydajności w celu zapewnienia wyjątkowej obsługi użytkownika w ramach naszych pakietów SDK oprogramowania.

Nowe komponenty

Nowość w wydaniu 7.4.0.0

Dodano komponenty „zigbee_direct_security_p256” i „zigbee_direct_security_curve25519”, dzięki czemu użytkownicy mogą skonfigurować konkretną opcję bezpieczeństwa Zigbee Direct.

Użytkownicy mogą mieć włączonych wiele komponentów „zigbee_direct_security” w aplikacji Zigbee Direct Device (ZDD). W tym przypadku rzeczywista opcja zabezpieczeń zależy od konfiguracji urządzenia wirtualnego Zigbee (ZVD).

Nowe interfejsy API

Nowość w wydaniu 7.4.0.0

Dodano nowe API sl_zigbee_token_factory_reset aby zresetować tokeny Zigbee NVM3 do wartości domyślnej.
Dodano interfejs API bool sl_zigbee_sec_man_link_key_slot_available(EmberEUI64 eui), która zwraca wartość true, jeśli tabela kluczy łączy może dodać lub zaktualizować wpis o tym adresie (tabela nie jest pełna).

Dodano nowe API bool sl_zb_sec_man_compare_key_to_value (kontekst sl_zb_sec_man_context_t*, klucz sl_zb_sec_man_key_t*), która zwraca wartość true, jeśli klucz, do którego odwołuje się kontekst, ma tę samą wartość, co klucz podany w argumencie.

Obsługa nowej platformy

Nowość w wydaniu 7.4.0.0

W tej wersji dodano obsługę stosu Zigbee dla następujących nowych części: EFR32MG24A010F768IM40 i EFR32MG24A020F768IM40.

Nowa dokumentacja

Nowość w wydaniu 7.4.0.0

Zaktualizowano opis komponentu Zigbee Secure Key Storage, aby odzwierciedlić dodanie Zigbee Secure Key Storage Upgrade (które dodaje wsteczną kompatybilność z istniejącymi projektami).

Dodano nową notatkę dotyczącą aplikacji dotyczącą interakcji z grupą komponentów Zigbee Security Manager (AN1412: Zigbee Security Manager).

Zamierzone zachowanie

Przypomina się użytkownikom, że niezsynchronizowane transmisje CSL Zigbee podlegają wywłaszczeniu protokołu w programie planującym radio. W aplikacjach SleepyToSleepy BLE może i będzie wywłaszczać transmisję Zigbee CSL, co zakończy transmisję. Wywłaszczanie harmonogramu jest bardziej powszechne w przypadku niezsynchronizowanej listy CSL, biorąc pod uwagę, że może zostać użyta potencjalnie długa sekwencja ramek budzenia. Użytkownicy chcący dostosować priorytety transmisji mogą w tym celu skorzystać z komponentu DMP Tuning and Testing. Użytkownicy mogą również konsultować się UG305: Podręcznik użytkownika dynamicznego wieloprotokołowego Aby uzyskać więcej informacji.

Ulepszenia

Zmieniono w wersji 7.4.0.0

Zmiany w dokumentacji API emberCounterHandler

W poprzednich wersjach wywołanie zwrotne modułu obsługi licznika dla EmberCounterTypes warstwy MAC i APS dotyczące pakietów RX i TX nie było przekazywane, przekazując odpowiedni identyfikator węzła docelowego lub argumenty danych, a dokumentacja API dotycząca zachowania niektórych liczników korzystających z tych parametrów była niejasna lub wprowadzająca w błąd.

Chociaż podpis funkcji emberCounterHandler() nie uległ zmianie, sposób wypełniania jej parametrów nieznacznie się zmienił.

Komentarze dotyczące wyliczeń EmberCounterType w pliku ember-types.h zostały rozszerzone dla przejrzystości.
Parametr Node ID modułu obsługi liczników dla liczników związanych z TX sprawdza teraz, czy tryb adresu docelowego wskazuje prawidłowy krótki identyfikator przed jego użyciem. (Jeśli nie, adres docelowy nie jest wypełniany, a zamiast tego używana jest wartość zastępcza EMBER_UNKNOWN_NODE_ID.)
Parametr Node ID w module obsługi liczników dla liczników związanych z RX odzwierciedla teraz identyfikator węzła źródłowego, a nie identyfikator węzła docelowego.

Liczba ponownych prób *nie* jest przekazywana jako parametr danych dla liczników EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED, jak opisano w ember-types.h w poprzednich wersjach, ale nigdy nie był on poprawnie wypełniany we wcześniej wydanych wersjach, więc jego wartość w poprzednich wersjach zawsze wynosiła 0 . To zachowanie zostało wyjaśnione w opisie tych typów EmberCounterType. Jednak liczba ponownych prób dla ponownych prób warstwy APS jest nadal wypełniana w parametrze danych dla typów liczników EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED, aby zachować spójność z poprzednimi wersjami.
Wszystkie liczniki wypełniające identyfikator węzła lub parametr danych dla wywołania zwrotnego zostały sprawdzone w celu zapewnienia, że przekazują oczekiwane dane, adres lub EMBER_UNKNOWN_NODE_ID, jeśli oczekiwano identyfikatora węzła, ale nie można było go uzyskać z pakietu, jak opisano w poprawionym ember -types.h dokumentacja.
Procedura obsługi licznika dla EMBER_COUNTER_MAC_TX_UNICAST_RETRY teraz poprawnie odzwierciedla identyfikator węzła docelowego warstwy MAC i liczbę ponownych prób w jego identyfikatorze węzła docelowego i parametrach danych.

Procedura obsługi licznika dla EMBER_COUNTER_PHY_CCA_FAIL_COUNT dostarcza teraz informacje o identyfikatorze węzła docelowego poprzez parametr Node ID o zamierzonej warstwie docelowej MAC komunikatu, którego transmisja nie powiodła się.

Zaktualizowany Kodeks Zielonej Energii

Kod serwera Green Power został zaktualizowany i zawiera różne ulepszenia, w tym:

Dodano więcej kodu weryfikacyjnego dla poleceń przychodzących z nieprawidłowym punktem końcowym podczas odbierania na serwerze GP.
Dodano kod do obsługi przypadku, gdy nie ma już miejsca na budowanie komunikatów o zielonej energii.
Ujście usuwa teraz konfigurację parowania z akcją usuwania parowania w niektórych przypadkach zgodnie ze specyfikacją A.3.5.2.4.1.

Ujście zapisuje teraz istniejącą listę grup wpisu przed usunięciem podczas przetwarzania konfiguracji parowania z akcją rozszerzenia.
Polecenie Zapytanie o tłumaczenie zwraca „NOT FOUND” jako kod błędu, gdy tabela tłumaczeń jest pusta lub indeks jest większy niż liczba wpisów w tabeli.
Zmieniono wersję punktu końcowego GP w niektórych aplikacjach z 1 na 0.

Korzystanie z CSMA w funkcji wysyłania GPDF jest ograniczone, ponieważ urządzenia Green Power to urządzenia o niskim zużyciu energii i w większości projektów nie korzystają z CSMA. Zamiast tego preferowanym projektem jest wysyłanie wielu pakietów przy użyciu tego samego budżetu energetycznego.

Usunięto użycie ukrytego punktu końcowego w opcji wtyczki Green Power Server. Zamiast tego użyj jednego z punktów końcowych aplikacji.

Ulepszenia kodu wtyczki aktualizacji klucza sieciowego

Zmieniono okres okresowej aktualizacji klucza sieciowego na maksymalnie 1 rok.

Zrestrukturyzowano niektóre interfejsy API, aby uniknąć niepotrzebnego eksportu kluczy

Wprowadzono zmiany, aby faworyzować użycie kluczowych kontekstów zamiast kluczowych danych w postaci zwykłego tekstu.

sl_zigbee_send_security_challenge_request przyjmuje teraz argument sl_zb_sec_man_context_t zamiast EmberKeyData.
Wartości wyliczenia sl_zb_sec_man_derived_key_type są teraz 16-bitową maską bitową, która bezpośrednio obsługuje określone wyprowadzenia kluczy, które łączą wiele typów pochodnych.

Naprawione problemy

Naprawiono w wersji 7.4.0.0

ID #	Opis
1019348	Naprawiono wymagania zależności dla komponentu Zigbee ZCL Cli, dzięki czemu można go usunąć, gdy nie jest potrzebny.
1024246	Zaktualizowano opis funkcji emberHaveLinkKey() i sl_zb_sec_man_have_link_key().
1036503	Dodano opis zalecający użycie jądra Micrium dla DMPampaplikacje.
1037661	Naprawiono problem, który uniemożliwiał aplikacji instalację stosu pro lub stosu liści.
1078136	Naprawiono sporadyczną awarię podczas modyfikowania zdarzeń z kontekstu przerwania
1081548	Przypomina się użytkownikom, że niezsynchronizowane transmisje CSL Zigbee podlegają wywłaszczeniu protokołu w programie planującym radio. W aplikacjach SleepyToSleepy BLE może i będzie wywłaszczać transmisję Zigbee CSL, co zakończy transmisję. Wywłaszczanie harmonogramu jest bardziej powszechne w przypadku niezsynchronizowanej listy CSL, biorąc pod uwagę, że może zostać użyta potencjalnie długa sekwencja ramek budzenia. Użytkownicy chcący dostosować priorytety transmisji mogą w tym celu skorzystać z komponentu DMP Tuning and Testing. Użytkownicy mogą również zapoznać się z UG305: Podręcznik użytkownika dynamicznego wieloprotokołowego, aby uzyskać więcej informacji. W CSL rozwiązano problem polegający na tym, że nowa sekwencja ramek wybudzania otrzymana bezpośrednio po poprzedniej ramce ładunku nie była poprawnie rejestrowana. Spowodowałoby to pominięcie ramki ładunku.
1084111	Początkowa, senna obsługa SPI-NCP dla płyt opartych na MG24 została zaktualizowana w ramach tej wersji.
1104056	Dodano obsługę sterowania siecią w przypadku sieci dodatkowej w przypadku wielu sieci
1120515	Naprawiono problem polegający na tym, że kanał nie zmieniał się podczas używania polecenia mfglib set-channel.
1141109	Naprawiono problem, który powodował, że wygenerowany plik sampw aplikacji ncp-uart-gp-multi-rail brakuje jakiegoś nagłówka files podczas korzystania z komponentu zasilacza Green Power z opcją -cp.
1144316	Zaktualizowano opis niektórych typów struktur danych w dokumentacji gp-types.h.
1144884	Naprawiono ustawiony bit fałszywej ramki oczekującej, gdy nie było żadnych oczekujących danych.
1152512	Naprawiono potencjalną awarię w low-mac-rail podczas modyfikowania wydarzenia w kontekście isr.
1154616	Dodano wyjątek dla warunku inicjalizacji sieci w przypadku „Przełączanie roli z uśpionego urządzenia końcowego na nieuśpione urządzenie końcowe”.
1157289	Naprawiono problem, który może powodować niepowodzenie testu BDB DN-TLM-TC-02B.
1157426	Naprawiono problem z kompilacją podczas tworzenia aplikacji zigbee_simple_app z komponentem green_power_adapter.
1157932	Dodano warunek sprawdzenia, czy brakuje pola „czas przejścia” i ustawiono dla tego brakującego pola wartość domyślną 0xFFFF.
1166340	Naprawiono problem, który uniemożliwiał emberAfGpdfSend wysyłanie zamierzonej liczby powtarzanych transmisji.
1167807	Naprawiono problem polegający na tym, że urządzenia działające jako centra zaufania w sieciach rozproszonych niepoprawnie kasowały swoje klucze łącza przejściowego za każdym razem, gdy przyłączało się nowe urządzenie.
1169504	Naprawiono błąd powodujący resetowanie uśpionego urządzenia po wymuszeniu wybudzenia.
1169966	Naprawiono brakującą weryfikację wartości zwracanej w kodzie alokacji bufora.
1171477, 172270	Przy mfglib start 1 żadne komunikaty nie są wysyłane, ale odbierane, więc wyświetlany komunikat terminala „mfglib send Complete” jest błędny i zmieniany na „RXed %d pakietów w ciągu ostatnich %d ms”.
1171935	Zmieniono okres okresowej aktualizacji klucza sieciowego na maksymalnie 1 rok.
1172778	Dodano brakujące wywołanie emberAfPluginGreenPowerServerUpdateAliasCallback do serwera Green Power.
1174288	Naprawiono problem powodujący, że proces sterowania siecią potwierdza, jeśli zostanie wywołane żądanie zatrzymania trwającego skanowania.
1178393	Zaktualizowano błąd w dokumentacji.
1180445	W Smart Energy f OTA kontynuuje teraz pobieranie, jeśli Koordynator osiągnie ograniczony cykl pracy.
1185509	Naprawiono problem w CSL polegający na tym, że nowa sekwencja ramek wybudzania otrzymana bezpośrednio po poprzedniej ramce ładunku nie była poprawnie rejestrowana. Spowodowałoby to pominięcie ramki ładunku.

ID #	Opis
1186107	Naprawiono problem powodujący nieudane odszyfrowanie otrzymanych GPDF w celu zastąpienia przychodzącego GPDF w powiadomieniu o uruchomieniu gp.
1188397	Naprawiono problem powodujący błąd kompilacji podczas włączania rozszerzonego rozmiaru tabeli raportów.
1194090	Poprawiono status awarii w domyślnej odpowiedzi na polecenie trybu uruchomienia zlewu – zgodnie z sekcją 3.3.4.8.2
1194963	Naprawiono problem polegający na ustawianiu struktury CommissioningGpd przed wywołaniem wywołania zwrotnego użytkownika emberAfGreenPowerServerPairingStatusCallback.
1194966	Naprawiono problem polegający na tym, że pola Endpoint i proxyInvolved nie zostały ustawione w akcji Wyjdź z uruchomienia.
1196698	Naprawiono ustawiony bit fałszywej ramki oczekującej, gdy nie było żadnych oczekujących danych.
1199958	Dodano kod do obsługi przypadku, gdy nie ma już miejsca na budowanie komunikatów o zielonej energii.
1202034	Naprawiono problem polegający na tym, że zmienna stosu sl_zb_sec_man_context_t nie została poprawnie zainicjowana, co powodowało niepowodzenie dołączenia za pomocą kodu instalacyjnego.
1206040	Wywołanie funkcji emberRemoveChild() podczas bezpiecznej próby ponownego dołączenia przez urządzenie końcowe może potencjalnie prowadzić do dodatkowego zmniejszenia liczby elementów podrzędnych, potencjalnie prowadząc do wartości -1 (255), uniemożliwiając urządzeniom końcowym dołączenie/ponowne dołączenie z powodu wskazanego braku pojemności w Beaconie.
1207580	Funkcje przeszukiwania tabeli podrzędnej na stosie są niespójne w użyciu 0x0000 w porównaniu z 0xFFFF dla zwracanej wartości identyfikatora węzła reprezentującej nieprawidłowe/puste wpisy, co prowadzi do problemów ze sprawdzaniem nieużywanych wpisów w interfejsach API, takich jak emberRemoveChild().
1210706	Miejsce docelowe i indeks PHY podane w strukturze EmberExtraCounterInfo jako część emberCounterHandler() mogły być niepoprawne dla typów liczników MAC TX Unicast.
1211610 1212525	Naprawiono błąd powodujący awarię aplikacji Dynamic Multiprotocol po włączeniu komponentu Secure Key Storage Upgrade.
1211847	Chociaż podpis funkcji emberCounterHandler() nie uległ zmianie, sposób wypełniania jej parametrów nieznacznie się zmienił. Zmiany wokół tego interfejsu API wyjaśniono w sekcji 2 powyżej.
1212449	Wychodzące sygnały nawigacyjne zostały nieprawidłowo sklasyfikowane w warstwie MAC, co doprowadziło do tego, że funkcja emberCounterHandler() nie przechwyciła tych pakietów z typem licznika EMBER_COUNTER_MAC_TX_BROADCAST i zamiast tego zliczyła sygnały nawigacyjne z typem licznika EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS. Potencjalnie skutkowało to niewiarygodnymi wartościami parametru dest EmberNodeId przekazanymi do struktury EmberCounterInfo
1214866	Wysłanie pakietu sondowania danych w niektórych konfiguracjach o dużym natężeniu ruchu może spowodować awarię magistrali.
1216552	Naprawiono problem powodujący potwierdzenie w warunkach dużego natężenia ruchu.
1216613	Naprawiono problem, który prowadził do nieprawidłowej wartości promienia grupowego w tabeli proxy.
1222509	Router/koordynator wysyła żądanie opuszczenia i ponownego dołączenia do urządzenia końcowego odpytującego innego niż podrzędne, ale miejscem docelowym MAC jest 0xFFFF zamiast odpowiadać adresowi docelowemu NWK.
1223842	Naprawiono problem z generowaniem pliku sl_component_catalog.h, który pozostawiał w nim niechciany kod, powodując błąd kompilacji.
756628	Zmieniono wywoływanie wywołania zwrotnego aplikacji emberAfMacFilterMatchMessageCallback tak, aby było wywoływane tylko dla wiadomości ZLL, które są sprawdzane przez stos.
816088	Przeniesiono konfigurację EMBER z zigbeed_configuration.h do zigbeed.slcp.
829508	Aby uniknąć sytuacji wyścigu, w emberSetLogicalAndRadioChannel dodano dodatkową weryfikację, aby powrót nie powiódł się, jeśli niższe warstwy są zajęte lub nie są w stanie zmienić kanału.

Znane problemy w aktualnej wersji

Pogrubione problemy zostały dodane od poprzedniej wersji. Jeśli przegapiłeś jakieś wydanie, najnowsze informacje o wydaniu są dostępne na https://www.silabs.com/developers/zigbee-emberznet w zakładce Dokumentacja techniczna.

ID #	Opis	Obejście problemu
Brak	• W tej wersji nie są obsługiwane następujące aplikacje/komponenty: Obsługa EM4	Funkcja zostanie włączona w kolejnych wersjach.
193492	emberAfFillCommandGlobalServerToClientConfigureReporting makro jest uszkodzone. Wypełnienie bufora powoduje utworzenie nieprawidłowego pakietu poleceń.	Zamiast interfejsu API użyj polecenia CLI „zcl global send-me-a-report”.
278063	Inteligentne tunelowanie energetyczne plugins mają sprzeczne traktowanie/użycie indeksu tabeli adresów.	Brak znanego rozwiązania
289569	Lista wyboru poziomu mocy komponentów kreatora sieci nie oferuje pełnego zakresu obsługiwanych wartości dla EFR32	Edytuj zakres <-8..20> określony w komentarzu CMSIS dla EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P OWER w /protocol/zigbee/app/framework/plugin/network Creator/config/network-creator-config.h file. Na przykładample, zmień na <-26..20>.
295498	Odbiór UART czasami powoduje utratę bajtów przy dużym obciążeniu w dynamicznym, wieloprotokołowym przypadku użycia Zigbee+BLE.	Użyj sprzętowej kontroli przepływu lub zmniejsz szybkość transmisji.
312291	EMHAL: Funkcje halCommonGetIntxxMillisekundaTick na hostach z systemem Linux korzystają obecnie z funkcji gettimeofday, która nie gwarantuje, że będzie monotoniczna. Jeśli czas systemowy się zmieni, może to powodować problemy z synchronizacją stosu.	Zmodyfikuj te funkcje, aby zamiast tego używały clock_gettime ze źródłem CLOCK_MONOTONIC.
338151	Inicjowanie NCP z małą wartością licznika buforów pakietów może spowodować uszkodzenie pakietów.	Użyj zarezerwowanej wartości 0xFF dla liczby buforów pakietów, aby uniknąć zbyt niskiej wartości domyślnej
387750	Problem z formatami żądań tabeli tras na urządzeniu końcowym.	W trakcie śledztwa
400418	Inicjator Touchlink nie może połączyć się z niefabrycznie nowym docelowym urządzeniem końcowym.	Brak znanego rozwiązania.
424355	Niefabrycznie nowy inicjator docelowego łącza dotykowego uśpionego urządzenia końcowego nie jest w stanie odebrać odpowiedzi z informacjami o urządzeniu w pewnych okolicznościach.	W trakcie śledztwa
465180	Element optymalizacji blokowania radioblokowania współistnienia „Włącz kontrolę czasu działania” może blokować prawidłowe działanie Zigbee.	Opcjonalna kontrola „Wi-Fi Select” dotycząca optymalizacji blokowania powinna pozostać „wyłączona”.
480550	Klaster OTA ma wbudowaną własną metodę fragmentacji, dlatego nie powinien wykorzystywać fragmentacji APS. Chociaż w przypadku włączenia szyfrowania APS zwiększa to ładunek ImageBlockResponses do rozmiaru, w którym aktywowana jest fragmentacja APS. Może to spowodować niepowodzenie procesu OTA.	Brak znanego rozwiązania
481128	Szczegółowy reset Przyczyna i szczegóły awarii powinny być domyślnie dostępne za pośrednictwem wirtualnego UART (Serial 0) na platformach NCP, gdy włączona jest wtyczka diagnostyczna i wirtualne urządzenie peryferyjne UART.	Ponieważ Serial 0 jest już zainicjowany w NCP, klienci mogą włączyć emberAfNcpInitCallback w Zigbee NCP Framework i wywołać odpowiednie funkcje diagnostyczne (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, halPrintCrashDetails i halPrintCrashData) w tym wywołaniu zwrotnym, aby wydrukować te dane na Serial 0 dla vieww dzienniku przechwytywania Network Analyzer. Dla byłegoampPlik opisujący sposób korzystania z tych funkcji można znaleźć w kodzie zawartym w funkcji emberAfMainInit() w af-main-soc.c, gdy zdefiniowano EXTENDED_RESET_INFO.

ID #	Opis	Obejście problemu
486369	Jeśli DynamicMultiProtocolLightSoc tworzący nową sieć ma pozostałe węzły podrzędne z sieci, którą opuścił, emberAfGetChildTableSize zwraca wartość niezerową w startIdentifyOnAllChildNodes, powodując komunikaty o błędach Tx 66 podczas adresowania „duchów” dzieci.	Masowo wymaż część, jeśli to możliwe, przed utworzeniem nowej sieci lub programowo sprawdź tabelę podrzędną po opuszczeniu sieci i usuń wszystkie dzieci za pomocą emberRemoveChild przed utworzeniem nowej sieci.
495563	Dołączenie do SPI NCP Sleepy End Device Sample Aplikacja nie przeprowadza krótkiej ankiety, dlatego próba dołączenia kończy się niepowodzeniem po zaktualizowaniu klucza łącza TC.	Przed próbą dołączenia urządzenie, które chce się dołączyć, powinno znajdować się w trybie krótkiej ankiety. Ten tryb można wymusić za pomocą wtyczki End Device Support.
497832	W programie Network Analyzer podział poleceń obsługi aplikacji Zigbee dla ramki żądania weryfikacji klucza błędnie odwołuje się do części ładunku, która wskazuje adres źródłowy ramki jako adres docelowy.	Brak znanego rozwiązania
519905 521782	Spi-NCP bardzo rzadko może nie uruchomić komunikacji bootloadera przy użyciu polecenia CLI „bootload” wtyczki ota-client.	Uruchom ponownie proces ładowania
620596	NCP SPI Npampplik dla BRD4181A (EFR32xGMG21) Zdefiniowany domyślny pin nWake nie może być używany jako pin wybudzania.	Zmień domyślny pin nWake z PD03 na pin obsługujący wybudzanie EM2/3 we wtyczce NCP-SPI.
631713	Urządzenie końcowe Zigbee będzie wielokrotnie zgłaszać konflikty adresów, jeśli zamiast wtyczki „Zigbee PRO Leaf Library” zostanie użyta wtyczka „Zigbee PRO Stack Library”.	Użyj wtyczki „Zigbee PRO Leaf Library” zamiast wtyczki „Zigbee PRO Stack Library”.
670702	Nieefektywność wtyczki Reporting może prowadzić do znacznych opóźnień w zależności od częstotliwości zapisu danych i rozmiaru tabeli, co może zakłócać kod aplikacji klienta, w tym czas trwania zdarzeń.	Jeśli często piszesz, rozważ sprawdzenie warunków raportowania i ręczne wysyłanie raportów, zamiast korzystać z wtyczki.
708258	Niezainicjowana wartość w groups-server.c via addEntryToGroupTable() może utworzyć fałszywe powiązanie i spowodować wysyłanie komunikatów raportowania grupowego.	Dodaj „binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;” po „binding.type = EMBER_MULTICAST_BINDING;”
757775	Wszystkie części EFR32 mają unikalne przesunięcie RSSI. Ponadto konstrukcja płytki, anteny i obudowa mogą mieć wpływ na RSSI.	Podczas tworzenia nowego projektu zainstaluj narzędzie RAIL Utility, komponent RSSI. Ta funkcja obejmuje domyślne przesunięcie RSSI zmierzone przez Silabs dla każdej części. To przesunięcie można w razie potrzeby zmodyfikować po przetestowaniu RF całego produktu.
758965	Komponenty klastra ZCL i tabela wykrywania poleceń ZCL nie są zsynchronizowane. Dlatego podczas włączania lub wyłączania komponentu klastra ZCL zaimplementowane polecenia nie będą włączane/wyłączane w odpowiedniej zakładce poleceń zaawansowanego konfiguratora ZCL.	Ręcznie włącz/wyłącz wykrywanie żądanych poleceń ZCL w zaawansowanym konfiguratorze ZCL.
765735	Aktualizacja OTA nie powiedzie się na uśpionym urządzeniu końcowym z włączonym żądaniem strony.	Użyj żądania zablokowania zamiast żądania strony.
845649	Usunięcie komponentu CLI:Core nie eliminuje wywołań cli EEPROM do sl_cli.h.	Usuń plik eeprom-cli.c file to wywołuje sl_cli.h. Dodatkowo wywołania sl_cli.h oraz sl_cli_command_arg_t w ota-storage-simple-eeprom można skomentować.
857200	ias-zone-server.c umożliwia utworzenie powiązania z adresem CIE „0000000000000000” i później nie pozwala na dalsze powiązania.	Brak znanego rozwiązania
1019961	Wygenerowano markę Z3Gatewayfile koduje „gcc” jako CC	Brak znanego rozwiązania

ID #	Opis	Obejście problemu
1039767	Problem przepełnienia kolejki ponownych prób sieci routera Zigbee w przypadku użycia wielowątkowego systemu RTOS.	Zigbee Stack nie jest bezpieczny dla wątków. W rezultacie wywoływanie interfejsów API stosu Zigbee z innego zadania nie jest obsługiwane w środowisku systemu operacyjnego i może spowodować, że stos stanie się „niedziałający”. Więcej informacji i obejście problemu przy użyciu modułu obsługi zdarzeń można znaleźć w poniższej notatce dotyczącej aplikacji. https://www.silabs.com/documents/public/application notes/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk 7x.pdf .
1064370	Przełącznik Z3Switchampaplikacja domyślnie włączyła tylko jeden przycisk (instancja: btn1), co prowadzi do niezgodności opisu w projekciefile.	Rozwiązanie: Zainstaluj instancję btn0 ręcznie podczas tworzenia projektu Z3Switch.
1161063	Z3Light i potencjalnie inne aplikacje zgłaszają nieprawidłowe wartości wersji klastra.	Ręcznie zaktualizuj atrybut wersji klastra do odpowiedniej wersji.
1164768, 1171478, 1171479	BŁĄD: ezspErrorHandler s0x34 zgłaszany wielokrotnie w trybie odbioru mfglib	Aby zmniejszyć liczbę drukowanych komunikatów o błędach, skonfiguruj EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV ENT_TIMEOUT_MS w aplikacji hosta na 100, aby szybciej zwolnić kolejkę wywołań zwrotnych.

Przestarzałe przedmioty

Przestarzałe w wersji 7.4.0.0

Usunięto następujące przestarzałe interfejsy API zabezpieczeń:

emberGetKey()

emberGetKeyTableEntry()

emberSetKeyTableEntry()

emberHaveLinkKey()

emberAddOrUpdateKeyTableEntry()

emberAddTransientLinkKey()

emberGetTransientKeyTableEntry()

emberGetTransientLinkKey()

żarHmacAesHash()

Skorzystaj z interfejsów API dostarczonych przez Zigbee Security Manager, aby uzyskać dostęp do magazynu kluczy i hashowania HMAC.

Usunięte elementy

Usunięto w wersji 7.4.0.0

Usunięto zduplikowane publiczne interfejsy API w nagłówku publicznym file gp-types.h.

Komponent zigbee_end_device_bind został usunięty. Komponent ten został wykorzystany przez koordynatora do pośredniczenia w wiązaniach żądań dla urządzeń końcowych. Ta opcjonalna funkcjonalność została usunięta z wersji R22 podstawowej specyfikacji Zigbee.
Usunięto setPacketBufferCount() w af-host.c i bezużyteczny przypadek kontrolny EZSP_CONFIG_PACKET_BUFFER_COUNT: w poleceniu handlers.c.
Usunięto argument memoryAllocation, ponieważ nie ma potrzeby dzielenia na dwie fazy podczas inicjalizacji NCP.

Usunięto funkcję emberAfNcpInitCallback() w aplikacjach se14-comms-hub, se14-ihd i se14-meter-gas.
Usunięto ustawienie wartości EZSP_CONFIG_RETRY_QUEUE_SIZE podczas inicjalizacji ncp w ncp-configuration.c

Brama wieloprotokołowa i RCP

Nowe przedmioty

Dodano w wersji 7.4.0.0

Wprowadzono możliwość jednoczesnego słuchania, dzięki czemu stosy Zigbee i OpenThread mogą działać na niezależnych kanałach 802.15.4 przy użyciu RCP EFR32xG24 lub xG21. Równoczesne słuchanie nie jest dostępne w przypadku kombinacji 802.15.4 RCP/Bluetooth RCP, kombinacji Zigbee NCP/OpenThread RCP ani systemu na chipie (SoC) Zigbee/OpenThread. Zostanie dodany do tych produktów w przyszłej wersji.

Rozszerzenie dostawcy OpenThread CLI zostało dodane do aplikacji hosta OpenThread kontenerów wieloprotokołowych. Obejmuje to polecenia coex cli.

Ulepszenia

Zmieniono w wersji 7.4.0.0

Kombinacja wieloprotokołowa Zigbee NCP/OpenThread RCP osiągnęła teraz jakość produkcyjną.

Naprawione problemy

Naprawiono w wersji 7.4.0.0

ID #	Opis
1081828	Problem z przepustowością w przypadku Zigbee/BLE DMP opartych na FreeRTOSamppliki aplikacji.
1090921	Z3GatewayCpc miał problemy z utworzeniem sieci w hałaśliwym otoczeniu.
1153055	Asercja na hoście została spowodowana błędem komunikacji podczas odczytu wersji NCP z pliku zigbee_ncp-ble_ncp-uartample aplikacja.
1155676	RCP 802.15.4 odrzucał wszystkie odebrane pakiety emisji pojedynczej (po potwierdzeniu adresu MAC), jeśli wiele interfejsów 15.4 współdzieli ten sam 16-bitowy identyfikator węzła.
1173178	Host fałszywie zgłosił setki pakietów odebranych za pomocą mfglib w konfiguracji Host-RCP.
1190859	Błąd EZSP podczas wysyłania losowych pakietów mfglib w konfiguracji Host-RCP.
1199706	Sondaże danych z zapomnianych urządzeń podrzędnych urządzenia końcowego nie ustawiały prawidłowo ramki oczekującej na RCP, aby kolejkować polecenie Opuść i Dołącz do poprzedniego elementu podrzędnego.
1207967	Polecenie „mfglib send random” wysyłało dodatkowe pakiety do Zigbeeda.
1208012	Tryb mfglib rx nie aktualizował poprawnie informacji o pakiecie podczas odbioru na RCP.
1214359	Węzeł koordynatora uległ awarii, gdy 80 lub więcej routerów próbowało połączyć się jednocześnie w konfiguracji Host-RCP.
1216470	Po przesłaniu transmisji z maską adresu 0xFFFF, Zigbee RCP działający jako urządzenie nadrzędne pozostawi flagę oczekujących danych ustawioną dla każdego dziecka. Spowodowało to, że każde dziecko nie spało, oczekując danych po każdym odpytywaniu, i wymagało innej oczekującej transakcji danych do każdego urządzenia końcowego, aby ostatecznie wyczyścić ten stan.

Znane problemy w aktualnej wersji

ID #	Opis	Obejście problemu
811732	Obsługa tokenów niestandardowych nie jest dostępna w przypadku korzystania z Zigbeed.	Wsparcie jest planowane w przyszłej wersji.
937562	Polecenie Bluetoothctl „advertise on” nie działa w przypadku aplikacji rcp-uart 802154-blehci w Raspberry Pi OS 11.	Użyj aplikacji btmgmt zamiast bluetoothctl.

ID #	Opis	Obejście problemu
1022972	Coex nie działa na ZB NCP + OT RCP.	Wsparcie jest planowane w przyszłej wersji.
1074205	CMP RCP nie obsługuje dwóch sieci o tym samym identyfikatorze PAN.	Użyj różnych identyfikatorów PAN dla każdej sieci. Wsparcie jest planowane w przyszłej wersji.
1122723	W ruchliwym środowisku interfejs CLI w aplikacji z3-light_ot-ftd_soc może przestać odpowiadać.	Brak znanego rozwiązania.
1170052	CMP Zigbee NCP + OT RCP i DMP Zigbee NCP + BLE NCP mogą nie pasować do części RAM o pojemności 64 KB i mniejszych w tej bieżącej wersji.	Części o rozmiarze 64 KB nie są obecnie obsługiwane w tych aplikacjach.
1213701	RCP może nie wskazywać oczekujących danych dla śpiącego dziecka podczas aktualizacji OTA do dziecka w hałaśliwym otoczeniu, co może skutkować nieoczekiwanym zakończeniem procesu aktualizacji.	Zostanie omówione w przyszłej wersji.
1221299	Odczyty Mfglib RSSI różnią się między RCP i NCP.	Zostanie omówione w przyszłej wersji.

Przestarzałe przedmioty

Nic

Usunięte elementy

Usunięto w wersji 7.4.0.0

Makro „NONCOMPLIANT_ACK_TIMING_WORKAROUND” zostało usunięte. Wszystkie aplikacje RCP domyślnie obsługują teraz czas realizacji wynoszący 192 µs w przypadku nieulepszonych potwierdzeń, jednocześnie korzystając z czasu realizacji wynoszącego 256 µs w przypadku rozszerzonych potwierdzeń wymaganych przez CSL.

Korzystanie z tej wersji

To wydanie zawiera następujące elementy:

Stos Zigbee

Struktura aplikacji Zigbee
Zigbee Sample Aplikacje

Aby uzyskać więcej informacji na temat Zigbee i pakietu SDK EmberZNet, zobacz UG103.02: Podstawy Zigbee.

Jeśli jesteś użytkownikiem po raz pierwszy, zobacz QSG180: Z Zigbee EmberZNet Skrócona instrukcja obsługi dla SDK 7.0 i nowszych, aby uzyskać instrukcje dotyczące konfigurowania środowiska programistycznego, budowania i flashowania jakoampPlik aplikacji i odniesienia do dokumentacji wskazujące kolejne kroki.

Instalacja i użytkowanie

Zigbee EmberZNet SDK jest częścią Gecko SDK (GSDK), pakietu SDK Silicon Labs. Aby szybko rozpocząć korzystanie z GSDK, zainstaluj Studio Prostoty 5, który skonfiguruje Twoje środowisko programistyczne i przeprowadzi Cię przez proces instalacji GSDK. Simplicity Studio 5 zawiera wszystko, co jest potrzebne do tworzenia produktów IoT przy użyciu urządzeń Silicon Labs, w tym narzędzie do uruchamiania zasobów i projektów, narzędzia do konfiguracji oprogramowania, pełne środowisko IDE z zestawem narzędzi GNU oraz narzędzia analityczne. Instrukcje instalacji znajdują się w Internecie Podręcznik użytkownika Simplicity Studio 5.

Alternatywnie Gecko SDK można zainstalować ręcznie, pobierając lub klonując najnowszą wersję z GitHub. Widzieć https://github.com/SiliconLabs/gecko_sdk Aby uzyskać więcej informacji.

Simplicity Studio domyślnie instaluje GSDK w:

(Windows): C:\Użytkownicy\ \SimplicityStudio\SDKs\gecko_sdk
(MacOS): /Użytkownicy/ /SimplicityStudio/SDKs/gecko_sdk

Dokumentacja specyficzna dla wersji zestawu SDK jest instalowana wraz z zestawem SDK. Dodatkowe informacje często można znaleźć w artykuły bazy wiedzy (KBA). Referencje API i inne informacje na temat tej i wcześniejszych wersji są dostępne na stronie https://docs.silabs.com/.

Informacje o bezpieczeństwie

Bezpieczna integracja z przechowalnią

W przypadku aplikacji, które zdecydowały się na bezpieczne przechowywanie kluczy przy użyciu komponentu Secure Key Storage w częściach Secure Vault-High, poniższa tabela przedstawia chronione klucze i charakterystykę ochrony ich przechowywania, którą zarządza komponent Zigbee Security Manager.

Zapakowany klucz	Eksportowalny / Nieeksportowalny	Notatki
Klucz sieciowy	Eksportowalny
Klucz łącza Centrum zaufania	Eksportowalny
Klucz łącza tymczasowego	Eksportowalny	Indeksowana tabela kluczy, przechowywana jako klucz nietrwały
Klucz łącza aplikacji	Eksportowalny	Indeksowana tabela kluczy
Bezpieczny klucz EZSP	Eksportowalny
Klucz szyfrujący ZLL	Eksportowalny
Wstępnie skonfigurowany klucz ZLL	Eksportowalny
Klucz proxy GPD	Eksportowalny	Indeksowana tabela kluczy
Klucz do zlewu GPD	Eksportowalny	Indeksowana tabela kluczy
Klucz wewnętrzny/zastępczy	Eksportowalny	Wewnętrzny klucz do użytku przez Zigbee Security Manager

Opakowane klucze oznaczone jako „Nieeksportowalne” mogą być używane, ale nie mogą viewedytowane lub udostępniane w czasie wykonywania.

Opakowane klucze oznaczone jako „Do eksportu” mogą być używane lub udostępniane w czasie wykonywania, ale pozostają zaszyfrowane podczas przechowywania w pamięci flash.

Aplikacje użytkownika nigdy nie muszą wchodzić w interakcję z większością tych kluczy. Istniejące interfejsy API do zarządzania kluczami tabeli kluczy łączy lub kluczami przejściowymi są nadal dostępne dla aplikacji użytkownika i obecnie przechodzą przez komponent Zigbee Security Manager.

Niektórych z tych kluczy może w przyszłości nie być możliwe wyeksportowanie do aplikacji użytkownika. Zachęca się, aby aplikacje użytkownika nie polegały na eksportowaniu kluczy, chyba że jest to absolutnie konieczne.

Aby uzyskać więcej informacji na temat funkcji zarządzania kluczami Secure Vault, zobacz AN1271: Bezpieczne przechowywanie kluczy.

Porady dotyczące bezpieczeństwa

Aby subskrybować Poradniki dotyczące bezpieczeństwa, zaloguj się do portalu klienta Silicon Labs, a następnie wybierz Strona główna kontaKliknij DOM aby przejść do strony głównej portalu, a następnie kliknij przycisk Zarządzaj powiadomieniami płytka. Upewnij się, że zaznaczono opcję „Powiadomienia dotyczące oprogramowania/bezpieczeństwa i powiadomienia o zmianie produktu (PCN)” oraz że posiadasz subskrypcję co najmniej dla swojej platformy i protokołu. Kliknij Ratować aby zapisać zmiany.

Wsparcie

Klienci korzystający z zestawu rozwojowego kwalifikują się do szkoleń i pomocy technicznej. Użyj Laboratoria krzemowe Zigbee web strona w celu uzyskania informacji o wszystkich produktach i usługach Zigbee firmy Silicon Labs oraz zarejestrowania się w celu uzyskania pomocy technicznej dotyczącej produktu.

Możesz skontaktować się z pomocą techniczną Silicon Laboratories pod adresem http://www.silabs.com/support.

Zastrzeżenie

Silicon Labs zamierza zapewnić klientom najnowszą, dokładną i dogłębną dokumentację wszystkich urządzeń peryferyjnych i modułów dostępnych dla wdrażających systemy i oprogramowanie korzystających lub zamierzających używać produktów Silicon Labs. Dane charakterystyki, dostępne moduły i urządzenia peryferyjne, rozmiary pamięci i adresy pamięci odnoszą się do każdego konkretnego urządzenia, a dostarczone parametry „typowe” mogą i różnią się w różnych zastosowaniach. Zastosowanie npampOpisane tutaj pliki służą wyłącznie celom ilustracyjnym. Silicon Labs zastrzega sobie prawo do wprowadzania zmian bez dodatkowego powiadomienia w informacjach o produkcie, specyfikacjach i opisach zawartych w niniejszym dokumencie i nie daje gwarancji co do dokładności lub kompletności zawartych informacji. Bez wcześniejszego powiadomienia Silicon Labs może aktualizować oprogramowanie sprzętowe produktu podczas procesu produkcyjnego ze względów bezpieczeństwa lub niezawodności. Zmiany takie nie wpływają na specyfikację ani działanie produktu. Silicon Labs nie ponosi odpowiedzialności za skutki wykorzystania informacji zawartych w tym dokumencie. Niniejszy dokument nie implikuje ani nie udziela wyraźnie licencji na projektowanie lub wytwarzanie jakichkolwiek układów scalonych. Produkty nie są zaprojektowane ani nie są dopuszczone do stosowania w jakichkolwiek urządzeniach klasy III FDA, zastosowaniach wymagających zatwierdzenia przez FDA przed wprowadzeniem do obrotu lub systemach podtrzymywania życia bez specjalnej pisemnej zgody Silicon Labs. „System podtrzymywania życia” to dowolny produkt lub system przeznaczony do podtrzymywania lub podtrzymywania życia i/lub zdrowia, co do którego, jeśli zawiedzie, można zasadnie oczekiwać, że spowoduje poważne obrażenia ciała lub śmierć. Produkty Silicon Labs nie są projektowane ani autoryzowane do zastosowań wojskowych. Produkty Silicon Labs nie mogą być w żadnym wypadku wykorzystywane w broni masowego rażenia, w tym (ale nie wyłącznie) w broni nuklearnej, biologicznej lub chemicznej, ani w rakietach zdolnych do przenoszenia takiej broni. Silicon Labs zrzeka się wszelkich wyraźnych i dorozumianych gwarancji i nie ponosi odpowiedzialności za jakiekolwiek obrażenia lub szkody związane z używaniem produktu Silicon Labs w takich nieautoryzowanych zastosowaniach. Uwaga: ta treść może zawierać obraźliwą terminologię, która jest już nieaktualna. Tam, gdzie to możliwe, Silicon Labs zastępuje te terminy językiem włączającym. Aby uzyskać więcej informacje, odwiedź www.silabs.com/about-us/inclusive-lexicon-project

Informacje o znaku towarowym

Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® i logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, logo Energy Micro i ich kombinacje , „najbardziej przyjazne energetycznie mikrokontrolery na świecie”, Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis , logo Telegesis®, USBXpress®, Zentri, logo Zentri oraz Zentri DMS, Z-Wave® i inne są znakami towarowymi lub zastrzeżonymi znakami towarowymi firmy Silicon Labs. ARM, CORTEX, Cortex-M3 i THUMB są znakami towarowymi lub zastrzeżonymi znakami towarowymi firmy ARM Holdings. Keil jest zastrzeżonym znakiem towarowym firmy ARM Limited. Wi-Fi jest zastrzeżonym znakiem towarowym stowarzyszenia Wi-Fi Alliance. Wszystkie inne produkty lub nazwy marek wymienione w niniejszym dokumencie są znakami towarowymi odpowiednich właścicieli.

Laboratoria Silicon Inc.
400 Zachodni Cesar Chávez
Austin, Teksas 78701
USA

www.silabs.com

Dokumenty / Zasoby

Oprogramowanie SILICON LABS 7.4.0.0 Zigbee EmberZNet SDK [plik PDF] Instrukcja użytkownika
7.4.0.0 Oprogramowanie Zigbee EmberZNet SDK, 7.4.0.0, Oprogramowanie Zigbee EmberZNet SDK, Oprogramowanie EmberZNet SDK, Oprogramowanie SDK, Oprogramowanie

Odniesienia

Instrukcja obsługi