Wbudowane oprogramowanie SILICON LABS Bluetooth Mesh SDK
Specyfikacja produktu
- Nazwa produktu: Prostota pakietu SDK
- Wersja: 2024.6.0
- Data wydania: 5 czerwca 2024 r.
- Wersja specyfikacji siatki Bluetooth: 1.1
Instrukcje użytkowania produktu
Siatka Bluetooth to nowa topologia dostępna dla urządzeń Bluetooth Low Energy (LE), która umożliwia komunikację wiele do wielu (m:m). Jest zoptymalizowany do tworzenia sieci urządzeń na dużą skalę i idealnie nadaje się do automatyzacji budynków, sieci czujników i śledzenia zasobów. Nasze oprogramowanie i zestaw SDK do programowania Bluetooth obsługują funkcję Bluetooth Mesh i Bluetooth. Programiści mogą dodać komunikację sieciową typu mesh do urządzeń LE, takich jak podłączone oświetlenie, automatyka domowa i systemy śledzenia zasobów. Oprogramowanie obsługuje także beaconing Bluetooth, skanowanie beaconów i połączenia GATT, dzięki czemu Bluetooth mesh może łączyć się ze smartfonami, tabletami i innymi urządzeniami Bluetooth LE. To wydanie zawiera funkcje obsługiwane przez specyfikację Bluetooth Mesh w wersji 1.1.
Te informacje o wersji dotyczą wersji SDK:
Wersja 7.0.0.0 wydana 5 czerwca 2024 r
Uwagi dotyczące kompatybilności i użytkowania
Aby uzyskać więcej informacji na temat aktualizacji i powiadomień dotyczących zabezpieczeń, zobacz rozdział Bezpieczeństwo w uwagach do wersji platformy zainstalowanych z tym zestawem SDK lub na stronie Uwagi do wersji Silicon Labs. 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 siatki Bluetooth firmy Silicon Labs, zobacz Korzystanie z tej wersji.
Kompatybilne kompilatory
IAR Embedded Workbench dla ARM (IAR-EWARM) w wersji 9.40.1
- Używanie wine do kompilacji za pomocą narzędzia wiersza poleceń IarBuild.exe lub 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.
- Funkcja optymalizacji czasu łącza w GCC została wyłączona, co spowodowało nieznaczny wzrost rozmiaru obrazu.
Nowe przedmioty
Simplicity SDK to wbudowana platforma programistyczna do tworzenia produktów IoT w oparciu o nasze urządzenia bezprzewodowe i MCU serii 2 i 3. Integruje stosy protokołów bezprzewodowych, oprogramowanie pośrednie, sterowniki urządzeń peryferyjnych, program ładujący i aplikacje, npamples – solidna platforma do budowania zoptymalizowanych pod kątem zasilania i bezpiecznych urządzeń IoT. Pakiet Simplicity SDK oferuje zaawansowane funkcje, takie jak bardzo niskie zużycie energii, wysoka niezawodność sieci, obsługa dużej liczby węzłów i abstrakcja złożonych wymagań, takich jak wieloprotokołowość i wstępna certyfikacja. Ponadto Silicon Labs zapewnia aktualizacje oprogramowania i zabezpieczeń drogą bezprzewodową (OTA), aby zdalnie aktualizować urządzenia, minimalizować koszty konserwacji i zwiększać wygodę korzystania z produktu przez użytkownika końcowego. Simplicity SDK jest kontynuacją naszego popularnego zestawu SDK Gecko, który będzie nadal dostępny, zapewniając długoterminowe wsparcie dla naszych urządzeń z serii 0 i serii 1.
Dodatkowe informacje na temat urządzeń serii 0 i serii 1 można znaleźć pod adresem: Urządzenie serii 0 i serii 1 EFM32/EZR32/EFR32 (silabs.com).
Nowe funkcje
Dodano w wersji 7.0.0.0
Dodano obsługę Menedżera Zegarów. Komponenty stosu nie używają już urządzenia_init() do inicjalizacji zegara. Zamiast tego projekt aplikacji musi teraz zawierać komponent clock_manager, który inicjuje zegar. Dodano obsługę Common Memory Manager.
Nowe interfejsy API
Dodano w wersji 7.0.0.0 Brak.
Ulepszenia
- Dodano polecenie klasy BGAPI węzła, sl_btmesh_node_test_identity, służące do sprawdzania źródeł anonsów tożsamości węzła.
- Do serwera Sensor dodano funkcję Low Power Node, npamples.
- Do klienta serwera czujników dodano funkcję znajomych, npample.
Zmieniono w wersji 7.0.0.0
- Zmiany BGAPI:
Dodano komendę klasy BGAPI węzła, sl_btmesh_node_test_identity, która sprawdza, czy odebrane ogłoszenie tożsamości węzła pochodzi z danego węzła, czy nie. - Exampzmiany w aplikacji:
Do serwera Sensor dodano funkcję Low Power Node, npamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), a do klienta serwera czujników dodano funkcję Friend exampplik (btmesh_soc_sen-sor_client).
Naprawione problemy
Naprawiono w wersji 7.0.0.0
- Unikaj uruchamiania nośnika reklam, jeśli węzeł jest udostępniany wyłącznie przy użyciu protokołu PB-GATT.
- Ulepszone raportowanie zdarzeń udostępniania na przeciążonym urządzeniu.
- Poprawione raportowanie zdarzeń DFU na przeciążonym urządzeniu.
- Dodano raportowanie błędów, jeśli konfiguracja transferu obiektów BLOB w węźle jest niewystarczająca dla modeli DFU Distributor i Standalone Updater.
- Naprawiono zapisywanie ochrony przed powtórką w NVM3 podczas korzystania z API sl_btmesh_node_power_off().
| ID # | Opis |
| 356148 | Pozwala uniknąć uruchamiania nośnika reklam, jeśli węzeł jest udostępniany wyłącznie przy użyciu protokołu PB-GATT. |
| 1250461 | Zwiększono niezawodność raportowania zdarzeń udostępniania na przeciążonym urządzeniu. |
| 1258654 | Zwiększono niezawodność raportowania zdarzeń DFU na przeciążonym urządzeniu. |
| 1274632 | Modele DFU Distributor i Standalone Updater będą teraz zgłaszać błąd, jeśli konfiguracja transferu obiektów BLOB w węźle nie będzie wystarczająca. |
| 1284204 | Naprawiono zapisywanie ochrony przed powtórką w NVM3, gdy aplikacja korzysta z API sl_btmesh_node_power_off(). |
Znane problemy w aktualnej wersji
Problemy zaznaczone pogrubioną czcionką zostały dodane od poprzedniej wersji.
- Brak zdarzenia BGAPI w przypadku niepowodzenia obsługi segmentowanego komunikatu.
- Potencjalne zalanie kolejki NCP zdarzeniami zmiany stanu odświeżania klucza.
- Niewielkie pogorszenie wydajności w testach opóźnień w obie strony w porównaniu z wersją 1.5.
- Problemy z ponownym ustanowieniem możliwych do połączenia reklam, jeśli wszystkie połączenia są aktywne i używany jest serwer proxy GATT.
- Słaba wydajność transmisji segmentowanych komunikatów za pośrednictwem nośnika GATT.
| ID # | Opis | Obejście problemu |
| 401550 | Brak zdarzenia BGAPI w przypadku niepowodzenia obsługi segmentowanego komunikatu. | Aplikacja musi wydedukować awarię na podstawie przekroczenia limitu czasu/braku odpowiedzi warstwy aplikacji; dla modeli dostawców udostępniono interfejs API. |
| 454059 | Na końcu procesu KR generowana jest duża liczba zdarzeń związanych ze zmianą stanu odświeżania klucza, które mogą zapełnić kolejkę NCP. | Zwiększ długość kolejki NCP w projekcie. |
| 454061 | Zaobserwowano nieznaczne pogorszenie wydajności w porównaniu do 1.5 w testach opóźnień w obie strony. | |
| 624514 | Problem z ponownym ustanowieniem możliwych do połączenia reklam, jeśli wszystkie połączenia były aktywne i używany jest serwer proxy GATT. | Przydziel o jedno połączenie więcej niż jest to potrzebne. |
| 841360 | Słaba wydajność transmisji segmentowanych komunikatów za pośrednictwem nośnika GATT. | Upewnij się, że interwał połączenia podstawowego połączenia BLE jest krótki; upewnij się, że jednostka ATT MTU jest wystarczająco duża, aby zmieścić pełną jednostkę Mesh PDU; dostosuj minimalną długość zdarzenia połączenia, aby umożliwić transmisję wielu pakietów LL na zdarzenie połączenia. |
| 1121605 | Błędy zaokrągleń mogą spowodować, że zaplanowane zdarzenia zostaną uruchomione w bardzo nieznacznie innym czasie niż oczekiwano. | |
| 1226127 | Dostawca hosta, npampPlik może się zawiesić, gdy zaczyna udostępniać drugi węzeł. | Uruchom ponownie aplikację dostawcy hosta przed udostępnieniem drugiego węzła. |
| 1204017 | Dystrybutor nie jest w stanie obsłużyć równoległej samodzielnej aktualizacji oprogramowania sprzętowego i przesyłania oprogramowania sprzętowego. | Nie uruchamiaj równolegle aktualizacji oprogramowania sprzętowego i przesyłania oprogramowania sprzętowego. |
| 1301325 | Akcje harmonogramu nie są poprawnie przechowywane w pamięci trwałej. | |
| 1305041 | Komunikacja NCP z hosta do EFR32 może przekroczyć limit czasu. | sl_simple_com_usart.c można edytować, aby poprawić wartość limitu czasu. |
| 1305928 | Konfigurowanie 10 lub więcej węzłów aktualizacji jako odbiorników DFU może zakończyć się niepowodzeniem w aplikacji dystrybutora SoC. |
Przestarzałe przedmioty
Przestarzałe w wersji 7.0.0.0
Komenda BGAPI sl_btmesh_prov_test_identity jest przestarzała. Zamiast tego użyj sl_btmesh_node_test_identity.
Usunięte elementy
Usunięto w wersji 7.0.0.0
W tej wersji usunięto obsługę sprzętu serii 1 (xG12 i xG13).
Korzystanie z tej wersji
Ta wersja zawiera następujące elementy
- Biblioteka stosów siatki Bluetooth firmy Silicon Labs
- Siatka Bluetooth samppliki aplikacji
Jeśli jesteś użytkownikiem po raz pierwszy, zobacz QSG176: Skrócona instrukcja obsługi Silicon Labs Bluetooth Mesh SDK v2.x.
Instalacja i użytkowanie
Zestaw SDK siatki Bluetooth jest dostarczany jako część zestawu SDK Simplicity (GSDK), pakietu SDK firmy Silicon Labs. Aby szybko rozpocząć korzystanie z pakietu Simplicity SDK, zainstaluj Simplicity Studio 5, które skonfiguruje Twoje środowisko programistyczne i przeprowadzi Cię przez proces instalacji Simplicity SDK. 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 internetowym Podręczniku użytkownika Simplicity Studio 5. Alternatywnie pakiet Simplicity SDK można zainstalować ręcznie, pobierając lub klonując najnowszą wersję z GitHub. Widzieć https://github.com/Sili-conLabs/simplicity_sdk Aby uzyskać więcej informacji.
Simplicity Studio domyślnie instaluje pakiet Simplicity SDK w:
- Okna:
- 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 interfejsu API i inne informacje dotyczące tej i wcześniejszych wersji są dostępne na stronie https://docs.silabs.com/.
Informacje o bezpieczeństwie
| Klawisz | Możliwość eksportu na węźle | Możliwość eksportu na Provisioner | Notatki |
| Klucz sieciowy | Eksportowalny | Eksportowalny | Wyprowadzenia klucza sieciowego istnieją tylko w pamięci RAM, podczas gdy klucze sieciowe są przechowywane w pamięci flash |
| Klucz aplikacji | Nieeksportowalne | Eksportowalny | |
| Klucz urządzenia | Nieeksportowalne | Eksportowalny | W przypadku Provisionera dotyczy klucza urządzenia Provisionerra oraz kluczy innych urządzeń |
Bezpieczna integracja z przechowalnią
Ta wersja stosu jest zintegrowana z funkcją Secure Vault Key Management. Po wdrożeniu na urządzeniach Secure Vault High klucze szyfrowania mesh są chronione za pomocą funkcji zarządzania kluczami Secure Vault. Poniższa tabela przedstawia chronione klucze i charakterystykę ochrony ich przechowywania.
- Klucze oznaczone jako „Nieeksportowalne” mogą być używane, ale nie mogą viewedytowane lub udostępniane w czasie wykonywania.
- Klucze oznaczone jako „Eksportowalne” mogą być używane lub udostępniane w czasie wykonywania, ale pozostają zaszyfrowane podczas przechowywania w pamięci flash.
- Aby uzyskać więcej informacji na temat funkcji zarządzania kluczami Secure Vault, zobacz AN1271: Bezpieczne przechowywanie kluczy.
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 wsparcia technicznego. Użyj siatki Bluetooth Silicon Labs web stronę, aby uzyskać informacje o wszystkich produktach i usługach Silicon Labs Bluetooth oraz zarejestrować się w celu uzyskania wsparcia produktu.
Skontaktuj się z pomocą techniczną Silicon Laboratories pod adresem http://www.silabs.com/support.
Studio Prostoty
Dostęp jednym kliknięciem do MCU i narzędzi bezprzewodowych, dokumentacji, oprogramowania, bibliotek kodów źródłowych i nie tylko. Dostępne dla systemów Windows, Mac i Linux!
Zastrzeżenie
Silicon Labs ma na celu dostarczanie klientom najnowszej, dokładnej i dogłębnej dokumentacji wszystkich urządzeń peryferyjnych i modułów dostępnych dla wdrożeniowców systemów i oprogramowania 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 podane parametry „Typowe” mogą się różnić i różnią się w różnych zastosowaniach. Zastosowanie npampPliki opisane w niniejszym dokumencie służą wyłącznie celom ilustracyjnym. Silicon Labs zastrzega sobie prawo do wprowadzania zmian bez dalszego powiadomienia w informacjach o produkcie, specyfikacjach i opisach zawartych w niniejszym dokumencie i nie udziela gwarancji co do dokładności lub kompletności zawartych informacji. Bez uprzedniego powiadomienia Silicon Labs może aktualizować oprogramowanie sprzętowe produktu podczas procesu produkcyjnego ze względów bezpieczeństwa lub niezawodności. Takie zmiany nie zmienią specyfikacji ani wydajności produktu. Silicon Labs nie ponosi odpowiedzialności za konsekwencje wykorzystania informacji zawartych w niniejszym dokumencie. Niniejszy dokument nie sugeruje ani nie udziela wyraźnie żadnej licencji na projektowanie lub wytwarzanie jakichkolwiek układów scalonych. Produkty nie są zaprojektowane ani dopuszczone do użytku z jakimikolwiek urządzeniami FDA Class III, aplikacjami, dla których wymagana jest aprobata FDA przed wprowadzeniem na rynek lub systemami podtrzymywania życia bez wyraźnej pisemnej zgody Silicon Labs. „System podtrzymywania życia” to dowolny produkt lub system przeznaczony do podtrzymywania lub podtrzymywania życia i/lub zdrowia, którego awaria może spowodować poważne obrażenia ciała lub śmierć. Produkty Silicon Labs nie są zaprojektowane ani autoryzowane do zastosowań wojskowych. Produkty Silicon Labs nie mogą być w żadnym wypadku używane w broni masowego rażenia, w tym (między innymi) w broni jądrowej, biologicznej lub chemicznej, ani w pociskach 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życiem produktu Silicon Labs w takich nieautoryzowanych zastosowaniach.
Notatka: Ta treść może zawierać obraźliwą terminologię, która jest już przestarzała. Silicon Labs w miarę możliwości zastępuje te terminy językiem włączającym. Po więcej informacji 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, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, the Telegesis Logo®, USBXpress®, Zentri, logo Zentri i 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.
Często zadawane pytania (FAQ)
P: Gdzie mogę znaleźć więcej informacji na temat aktualizacji zabezpieczeń?
O: Aby zapoznać się ze szczegółowymi aktualizacjami zabezpieczeń, zapoznaj się z rozdziałem „Bezpieczeństwo” w „Uwagach do wydania platformy” lub odwiedź stronę „Uwagi do wydania” firmy Silicon Labs.
P: Jak dołączyć komponent clock_manager do inicjalizacji zegara?
O: Aby dołączyć komponent clock_manager do inicjalizacji zegara, pamiętaj o odpowiedniej aktualizacji projektu aplikacji zgodnie z instrukcjami podanymi w instrukcji obsługi.
Laboratoria Silicon Inc.
400 Zachodni Cesar Chávez
Austin, Teksas 78701
USA
www.silabs.com
Portfolio IoT
www.silabs.com/IoT
SW/sprzęt
www.silabs.com/simplicity
Jakość
www.silabs.com/jakość
Wsparcie i społeczność
www.silabs.com/community
Dokumenty / Zasoby
 |
Wbudowane oprogramowanie SILICON LABS Bluetooth Mesh SDK [plik PDF] Instrukcja użytkownika Wbudowane oprogramowanie Bluetooth Mesh SDK, Wbudowane oprogramowanie Mesh SDK, Wbudowane oprogramowanie SDK, Wbudowane oprogramowanie, Oprogramowanie |