Instrukcje SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs jest dostawcą wybieranym przez producentów OEM, którzy opracowują sieci Zigbee w swoich produktach. Platforma Zigbee Silicon Labs jest najbardziej zintegrowanym, kompletnym i bogatym w funkcje rozwiązaniem Zigbee. Silicon Labs EmberZNet SDK zawiera implementację specyfikacji stosu Zigbee przez Silicon Labs.

GŁÓWNE CECHY

Zigbee

-250+ wpisów w tabeli kluczy łącza APS
Obsługa ZigbeeD w systemach Android 12 (v21.0.6113669) i Tizen (v0.1-13.1)

Obsługa modułu xG26

Wieloprotokołowy

Wsparcie ZigbeeD i OTBR w OpenWRT – GA
DMP BLE + CMP ZB i Matter/OT z jednoczesnym słuchaniem na MG26 dla SoC – GA

802.15.4 Komponent priorytetu ujednoliconego harmonogramu radiowego
Obsługa pakietów Debiana dla aplikacji hosta MP – Alpha

Nowe przedmioty

Ważne zmiany
Rozmiar tabeli kluczy łącza APS (skonfigurowany przy użyciu SL_ZIGBEE_KEY_TABLE_SIZE) został rozszerzony ze 127 do 254 wpisów.

Dodano obsługę R23 dla funkcjonalności uruchamiania sieci ZDD. Funkcjonalność tunelowania jest dostępna bez obsługi przypadków użycia sieci Legacy.

Komponenty Network Steering i Network Creator zostały zaktualizowane, aby uwzględnić obsługę dołączania R23. Obejmują one następujące powiązane zmiany.
- Domyślna polityka żądania Trust Center Link Key (TCLK) została zaktualizowana, aby generować nowe klucze dla każdego żądającego urządzenia. Nowy klucz jest generowany za każdym razem, gdy żądające urządzenia próbują zaktualizować swój Trust Center Link Key.
- Ze względu na poprzednią zmianę polityki TCLK, komponent Network Creator Security wymaga teraz komponentu Security Link Keys. Uaktualnienia aplikacji zostaną zaktualizowane, aby dostosować je do tego nowego wymogu.
- Nowa konfiguracja,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY jest dodawany, aby umożliwić dołączanie przy użyciu podstawowego, haszowanego klucza. Ta konfiguracja znajduje się w komponencie Network Creator Security. Użycie tej polityki pozwala każdemu dołączającemu urządzeniu otrzymać unikalny TCLK po dołączeniu, ale wielokrotne próby aktualizacji TCLK nie spowodują utworzenia nowego klucza dla żądającego urządzenia. To użycie haszowanych kluczy łączy było domyślną polityką przed tą wersją, a użycie tej polityki pozwala Trust Center uniknąć wprowadzania komponentu Security Link Keys, który zapisuje klucze w Flashu.
  Notatka:Firma Silicon Labs nie zaleca stosowania tej zasady, gdyż uniemożliwia ona łączenie się urządzeń i aktualizację ich kodów TCLK.

Do komponentu zigbee_ezsp_spi dodano nowy zestaw konfiguracyjny umożliwiający konfigurację urządzenia SPI hosta i jego interfejsów pinowych.
Byłyampprojekty, w tym projekt filePliki s (.slcps) i folder projektu zostały przemianowane na zgodne z wytycznymi nazewnictwa Silicon Labs i przeniesione do katalogu „projects”.

Obsługa nowej platformy

Nowe moduły
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nowe płyty radiowe
- MGM260P-RB4350A
- MGM260P-RB4351A
Nowa część
- efr32xg27
Zestaw Odkrywcy
- BRD2709A
- MGM260P-EK2713A

Nowa dokumentacja
Nowy podręcznik użytkownika EZSP dla UG600 w wersji 8.1 i nowszych.

Ulepszenia

Limity SL_ZIGBEE_KEY_TABLE_SIZE rozszerzono do 254 wpisów.
Dodano zigbee_security_link_keys do Z3Light.
Dodano zigbee_security_link_keys do zigbee_mp_z3_tc_z3_tc. Zaktualizowano również rozmiar tabeli kluczy.
Zwiększono rozmiar tabeli kluczy bramy Z3 (który zostanie ustawiony na ncp) do 20.

Naprawione problemy

Znane problemy w aktualnej wersji

Problemy zaznaczone pogrubioną czcionką zostały dodane od czasu poprzedniej wersji. Jeśli przegapiłeś jakąś wersję, informacje o najnowszych wydaniach są dostępne pod adresem https://www.silabs.com/developers/zigbee-emberznet w zakładce Dokumentacja techniczna.

Przestarzałe przedmioty

Komponent zigbee_watchdog_periodic_refresh nie jest już używany w ramach aplikacji Zigbee i jest przestarzały w tej wersji. Timer watchdog jest domyślnie wyłączony dla wszystkich sample applications. W przyszłości do SDK zostanie dodany ulepszony komponent watchdog.
Notatka: Włącz licznik watchdog z pozycją konfiguracji SL_LEGACY_HAL_DISABLE_WATCHDOG ustawioną na 0 w swojej aplikacji

Ograniczenia i uwagi dotyczące sieci

Domyślne aplikacje Trust Center dostarczane z tą wersją EmberZNet są w stanie obsługiwać kilka urządzeń w sieci. Liczba ta jest ustalana na podstawie kilku czynników, w tym skonfigurowanych rozmiarów tabel, użycia NVM i innych wartości czasu generacji i czasu wykonania. Użytkownicy, którzy chcą tworzyć duże sieci, mogą napotkać problemy z zasobami, gdy sieć będzie większa niż jest obsługiwana przez aplikację. Na przykładample, urządzenie żądające Trust Center Link Key od Trust Center może wywołać wywołanie zwrotne sl_zigbee_af_zigbee_key_establishment_cb w Trust Center ze statusem h ustawionym na SL_ZIGBEE_KEY_TABLE_FULL, wskazując, że tabela kluczy nie ma miejsca na dodanie nowego klucza dla żądającego urządzenia lub że NVM3 nie ma dostępnego miejsca. Silicon Labs udostępnia następujące zalecenia dla użytkowników, którzy chcą tworzyć duże sieci. W przypadku aplikacji Trust Center zalecane są następujące konfiguracje. Te zalecenia nie są wyczerpujące i stanowią podstawę dla aplikacji, które mają rozwijać duże sieci.

Dołączenie komponentu Tabeli adresów (zigbee_address_table) z
- element konfiguracji SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE ustawiony na rozmiar żądanej sieci
- wartość SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE ustawiona na maksymalną (4)

Dołączenie komponentu Security Link Keys (zigbee_security_link_keys) z
- Wartość SL_ZIGBEE_KEY_TABLE_SIZE jest ustawiona na rozmiar sieci
Następujące elementy konfiguracji są ustawione na rozmiar żądanej sieci
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, jak znaleziono w komponencie Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, jak znaleziono w komponencie routingu źródłowego, jeśli używany jest routing źródłowy
Dopasowanie NVM3_DEFAULT_NVM_SIZE i NVM3_DEFAULT_CACHE_SIZE zgodnie z wykorzystaniem NVM3
- Np. rozmiary sieci większe niż 65 węzłów prawdopodobnie wymagają rozmiaru NVM3 wynoszącego 64K. Domyślny rozmiar NVM3 w Silicon Labs Zigbee sample applications wynosi 32K. Aplikacje, które intensywniej używają NVM, mogą wymagać jeszcze większego dostosowania tej wartości.
- Duże sieci składające się z maksymalnie 65 węzłów mogą wymagać pamięci podręcznej NVM3 o rozmiarze 1200 bajtów; w przypadku sieci o większym rozmiarze może być konieczne podwojenie tej wartości do 2400 bajtów.

Te zmiany dotyczą wyłącznie Centrum zaufania

Brama wieloprotokołowa i RCP

Nowe przedmioty
Włączono obsługę GA SoC dla BLE DMP z Zigbee + Openthread CMP z jednoczesnym nasłuchiwaniem na częściach xG26. Dodano obsługę Debian alpha dla aplikacji Zigbeed, OTBR i Z3Gateway. Zigbeed i OTBR są również dostarczane w formacie pakietu DEB dla wybranej platformy referencyjnej (Raspberry PI 4). Zobacz Uruchamianie Zigbee, OpenThread i Bluetooth jednocześnie na hoście Linux z wieloprotokołowym koprocesorem, dostępne pod adresem docs.silabs.com, aby uzyskać szczegółowe informacje. Dodano obsługę Zigbeed dla Tizen-0.1-13.1 dla arm32 i aarch64, a także Android 12 dla aarch64. Więcej informacji na temat Zigbeed można znaleźć na stronie docs.silabs.com. Dodano nowy komponent „802.15.4 Unified radio scheduler priority”. Ten komponent służy do konfigurowania priorytetów radiowych stosu 15.4. Komponent wymaga również nowego komponentu „radio_priority_configurator”. Ten komponent umożliwia projektom korzystanie z narzędzia Radio Priority Configurator w Simplicity Studio w celu konfigurowania poziomów priorytetów radiowych stosów, które tego wymagają.

Ulepszenia
Notatka dotycząca aplikacji Jednoczesne uruchamianie Zigbee, OpenThread i Bluetooth na hoście Linux z wieloprotokołowym koprocesorem (AN1333) została przeniesiona do docs.silabs.com. Obsługa OpenWRT jest teraz w jakości GA. Obsługa OpenWRT została dodana dla aplikacji Zigbee, OTBR i Z3Gateway. Zigbeed i OTBR są również dostarczane w formacie pakietu IPK dla platformy referencyjnej (Raspberry PI 4). Zobacz Running Zigbee, OpenThread i Bluetooth Concurrently on a Linux Host with a Multiprotocol Co-Processor, dostępne na stronie docs.silabs.com, dla szczegółów.

Naprawione problemy

Znane problemy w aktualnej wersji
Wydania pogrubione zostały dodane od czasu poprzedniej wersji. Jeśli przegapiłeś wersję, najnowsze notatki o wersji są dostępne oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Przestarzałe przedmioty
„Multiprotocol Container”, który jest obecnie dostępny w DockerHub (siliconlabsinc/multiprotocol), zostanie wycofany w nadchodzącej wersji. Kontener nie będzie już aktualizowany i nie będzie można go pobrać z DockerHub. Pakiety oparte na Debianie dla cpcd, ZigBee i ot-br-posix, wraz z natywnie generowanymi i kompilowanymi projektami, zastąpią funkcjonalność utraconą po usunięciu kontenera.

Korzystanie z tej wersji

To wydanie zawiera następujące elementy:

Stos Zigbee
Struktura aplikacji Zigbee
Zigbee Sample Aplikacje

Więcej informacji na temat Zigbee i pakietu SDK EmberZNet znajdziesz w UG103.02: Podstawy Zigbee. Jeśli jesteś użytkownikiem po raz pierwszy, zobacz QSG180: Przewodnik szybkiego startu Zigbee EmberZNet dla SDK 7.0 i nowszych, aby uzyskać instrukcje dotyczące konfigurowania środowiska programistycznego, budowania i flashowania jakoampaplikacji i odniesienia do dokumentacji wskazujące na dodatkowe kroki.

Instalacja i użytkowanie
Zigbee EmberZNet SDK jest dostarczany jako część Simplicity SDK, pakietu Silicon Labs SDK. Aby szybko rozpocząć pracę z Simplicity SDK, zainstaluj Simplicity Studio 5, które skonfiguruje środowisko programistyczne i przeprowadzi Cię przez instalację Simplicity SDK. Simplicity Studio 5 zawiera wszystko, co jest potrzebne do rozwoju produktu IoT z urządzeniami Silicon Labs, w tym program uruchamiający zasoby i projekty, narzędzia do konfiguracji oprogramowania, pełne środowisko IDE z łańcuchem narzędzi GNU i narzędzia analityczne. Instrukcje instalacji znajdują się w internetowym Podręczniku użytkownika Simplicity Studio 5. Alternatywnie, Simplicity SDK można zainstalować ręcznie, pobierając lub klonując najnowszą wersję z GitHub. Zobacz https://github.com/SiliconLabs/simplicity_sdk aby uzyskać więcej informacji. Simplicity Studio domyślnie instaluje Simplicity SDK w:

(Windows): C:\Użytkownicy\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Użytkownicy//SimplicityStudio/SDKs/simplicity_sdk

Dokumentacja specyficzna dla wersji SDK jest instalowana wraz z SDK. Dodatkowe informacje można często znaleźć w artykułach bazy wiedzy (KBA). Odniesienia do API i inne informacje o tej i wcześniejszych wersjach są dostępne atn 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.Opakowane klucze oznaczone jako „Nieeksportowalne” mogą być używane, ale nie mogą viewed lub udostępniane w czasie wykonywania. Opakowane klucze oznaczone jako „Eksportowalne” 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 Link Key Table lub Transient Keys są nadal dostępne dla aplikacji użytkownika i nie są kierowane przez komponent Zigbee Security Manager.

Porady dotyczące bezpieczeństwa
Aby zasubskrybować Poradniki dotyczące bezpieczeństwa, zaloguj się do portalu klienta Silicon Labs, a następnie wybierz Strona główna konta. Kliknij EKRAN GŁÓWNY, aby przejść do strony głównej portalu, a następnie kliknij kafelek Zarządzaj powiadomieniami. Upewnij się, że zaznaczona jest opcja „Powiadomienia dotyczące oprogramowania/bezpieczeństwa i powiadomienia o zmianach produktu (PCN)” oraz że subskrybujesz co najmniej platformę i protokół. Kliknij Zapisz, aby zapisać zmiany.

Wsparcie
Klienci korzystający z zestawu rozwojowego kwalifikują się do szkoleń i pomocy technicznej. Użyj Zigbee Silicon Laboratories web strona, aby uzyskać informacje o wszystkich produktach i usługach Silicon Labs Zigbee oraz zapisać się na wsparcie produktu. Możesz skontaktować się z pomocą techniczną Silicon Laboratories pod adresem http://www.silabs.com/support.

Certyfikacja Zigbee
Wersja Ember ZNet 8.1 została zakwalifikowana jako platforma zgodna ze standardem Zigbee dla architektur SoC, NC, P i RCP. Z tą wersją powiązany jest identyfikator certyfikacji ZCP. Sprawdź CSA webstrona tutaj:
https://csa-iot.org/csa-iot_products/.

Należy pamiętać, że certyfikacja ZCP jest filed opublikować wersję i minie kilka tygodni zanim zostanie odzwierciedlona w CSA website. W przypadku jakichkolwiek dalszych pytań prosimy o kontakt z działem wsparcia Silicon Laboratories pod adresem http://www.silabs.com/support.

Często zadawane pytania

P: Jak mogę zaktualizować rozmiar tabeli kluczy łącza APS w zestawie SDK?
A: Rozmiar tabeli kluczy łącza APS można skonfigurować za pomocą parametru SL_ZIGBEE_KEY_TABLE_SIZE. W wersji 8.1 został on rozszerzony z 127 do 254 wpisów.

P: Jakie ulepszenia wprowadzono w wersji 8.1?
A: Wersja 8.1 wprowadza ulepszenia, takie jak rozszerzenie rozmiaru tabeli kluczy łącza APS, zmiana nazw komponentów, dodanie ochrony mutex dla kolejki zdarzeń Athe pp Framework i wiele innych. Zapoznaj się z informacjami o wydaniu, aby uzyskać szczegółową listę ulepszeń.

P: Jak radzić sobie z naprawionymi problemami w zestawie SDK?
A: Naprawiono problemy w SDK, w tym rozwiązywanie potencjalnych problemów z konfiguracją rozmiaru tabeli sąsiadów, zmiana nazw komponentów, naprawa narzutu trasy źródłowej, obsługa poleceń ZCL i wiele więcej. Upewnij się, że aktualizujesz do najnowszej wersji, aby skorzystać z tych poprawek.

Dokumenty / Zasoby

SILICON LABS Zigbee EmberZ Net SDK [plik PDF] Instrukcje
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Odniesienia

Instrukcja obsługi

SILICON LABS Zigbee EmberZ Net SDK

Specyfikacje

Informacje o produkcie