Uživatelská příručka k Bluetooth Mesh SDK od SILICON LABS

Informace o produktu
Sada Simplicity SDK Suite obsahuje funkce podporované specifikací Bluetooth Mesh verze 1.1. Poskytuje platformu pro vývoj aplikací využívajících technologii Bluetooth Mesh.

Návod k použití produktu

Bluetooth Mesh je nová topologie dostupná pro zařízení Bluetooth Low Energy (LE), která umožňuje komunikaci typu „m:m“ (many-to-many). Je optimalizována pro vytváření rozsáhlých sítí zařízení a je ideální pro automatizaci budov, senzorové sítě a sledování majetku. Náš software a SDK pro vývoj Bluetooth podporují Bluetooth Mesh a funkcionalitu Bluetooth. Vývojáři mohou přidat komunikaci v síti mesh k zařízením s nízkou spotřebou energie, jako jsou připojená světla, domácí automatizace a systémy sledování majetku. Software podporuje Bluetooth beaconing, skenování beaconů a připojení GATT, takže se Bluetooth Mesh může připojit k chytrým telefonům, tabletům a dalším zařízením Bluetooth LE. Tato verze obsahuje funkce podporované specifikací Bluetooth Mesh verze 1.1.

Tyto poznámky k vydání se týkají verzí SDK

Verze 7.0.3.0 vydána 23. dubna 2025 (pouze základní změny platformy)
7.0.2.0 vydáno 18. září 2024

7.0.1.0 vydáno 24. července 2024
7.0.0.0 vydáno 5. června 2024

Oznámení o kompatibilitě a použití
Další informace o aktualizacích a oznámeních zabezpečení naleznete v kapitole Zabezpečení v poznámkách k verzi platformy nainstalovaných s touto sadou SDK nebo na stránce Poznámky k verzi od Silicon Labs. Společnost Silicon Labs také důrazně doporučuje, abyste se přihlásili k odběru bezpečnostních doporučení, kde získáte aktuální informace. Pokyny nebo pokud s sadou SDK Bluetooth Mesh od Silicon Labs začínáte, naleznete v části Používání této verze.

Kompatibilní kompilátory
IAR Embedded Workbench pro ARM (IAR-EWARM) verze 9.40.1

Použití Wine k sestavení pomocí utility příkazového řádku IarBuild.exe nebo grafického uživatelského rozhraní IAR Embedded Workbench na systémech Mac nebo Linux může vést k nesprávným výsledků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 s operačními systémy Mac nebo Linux se doporučuje, aby nevytvářeli IAR mimo Simplicity Studio. Zákazníci, kteří to dělají, by si měli pečlivě ověřit, zda je použita správná files se používají.

GCC (The GNU Compiler Collection) verze 12.2.1, dodávaná se Simplicity Studio.
Funkce optimalizace doby propojení v GCC byla deaktivována, což má za následek mírné zvětšení velikosti obrázku.

KLÍČOVÉ VLASTNOSTI

Migrace na Simplicity SDK Suite

Odebrána podpora pro řadu 0/1
Podpora pro delta-komprimované aktualizace firmwaru

Nové položky

Nové funkce

Přidáno ve verzi 7.0.1.0
Byla přidána podpora pro aktualizaci firmwaru Mesh Device (DFU), která využívá efektivní delta kompresi založenou na rozpoznávání rozdílů mezi dvěma verzemi firmwaru. Tato funkce vyžaduje použití verze nástroje Commander, která podporuje analýzu binárních rozdílů ELF, a také použití bootloaderu, který podporuje aplikaci komprimované aktualizace firmwaru.

Přidáno ve verzi 7.0.0.0
Byla přidána podpora pro Clock Manager. Komponenty zásobníku již nepoužívají pro inicializaci hodin device_init(). Místo toho musí projekt aplikace nyní obsahovat komponentu clock_manager, která provádí inicializaci hodin.
Byla přidána podpora pro Common Memory Manager.

Nová API

Přidáno ve verzi 7.0.0.0

Vylepšení

Změněno ve verzi 7.0.0.0

BGAPI se mění
Byl přidán příkaz třídy BGAPI uzlu sl_btmesh_node_test_identity, který ověřuje, zda přijatá inzerce identity uzlu pochází z daného uzlu či nikoli.

Exampzměny v aplikaci le
Funkce Low Power Node byla přidána na server Sensor examples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) a funkce Friend byla přidána do klienta senzorového serveru example (btmesh_soc_sen-sor_client).

Opravené problémy

Opraveno ve verzi 7.0.2.0

ID #	Popis
1331888, 1334927, 1338088, 1338090	Opraveno několik neošetřených selhání alokace paměti, které by mohly potenciálně vést k selhání, když je zařízení přetíženo provozem.
1345827	Opravena ztráta informativní události BGAPI distributora DFU pro odstranění uzlů.
1301401	Opravené chyby aktualizace stavu serveru osvětlení při příjmu serveru osvětlení Nastavení požadavků s časem přechodu.
1345411	Opravena sl_memory_realloc() prosakující paměť, což vedlo k distributorovi DFU example dochází paměť haldy.

Opraveno ve verzi 7.0.1.0

ID #	Popis
1301325	Opraven problém s ukládáním akcí modelu Plánovače.
1305041	Opraven problém s časovým limitem v komunikaci NCP z hostitele na EFR32.
1305928	Opravená ztráta správných dat seznamu přijímačů v událostech DFU po implementaci opravy ztráty události 1258654.
1319326	Opraveny nesprávné hodnoty pro vstupní a výstupní OOB autentizační bitové výčty.
1325194	Opravena zbytečná duplikace události stavu přijímače klienta distributora DFU po implementaci opravy ztráty události 1258654.
1310377	Opraven problém v aplikaci IOP Relay. Dříve se vysílala pouze pomocí GATT.

Opraveno ve verzi 7.0.0.0

ID #	Popis
356148	Zabrání spuštění reklamního nosiče, pokud je uzel zajišťován pouze pomocí PB-GATT.
1250461	Robustnější hlášení událostí zřizování na přetíženém zařízení.
1258654	Robustnější hlášení událostí DFU na přetíženém zařízení.
1274632	Modely distributora DFU a samostatného aktualizačního modulu nyní hlásí chybu, pokud konfigurace přenosu objektů BLOB na uzlu není dostatečná.
1284204	Opravena ochrana ukládání opakovaného přehrávání do NVM3, když aplikace používá rozhraní API sl_btmesh_node_power_off().

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

Od předchozího vydání byly přidány problémy označené tučně

ID #	Popis	Řešení
401550	Žádná událost BGAPI pro selhání zpracování segmentovaných zpráv.	Aplikace musí odvodit selhání z časového limitu/chybějící odezvy aplikační vrstvy; pro modely dodavatelů bylo poskytnuto rozhraní API.
454059	Na konci procesu KR se generuje velký počet událostí změny stavu obnovení klíče, což může zahltit frontu NCP.	Zvětšete délku fronty NCP v projektu.
454061	Byla pozorována mírná degradace výkonu ve srovnání s 1.5 v testech okružní latence.
624514	Problém s obnovením připojitelné reklamy, pokud byla všechna připojení aktivní a proxy server GATT se používá.	Přidělte o jedno připojení více, než je potřeba.
841360	Špatný výkon segmentovaného přenosu zpráv přes nosič GATT.	Ujistěte se, že interval připojení základního připojení BLE je krátký; ujistěte se, že ATT MTU je dostatečně velká, aby se do ní vešla celá síťová jednotka PDU; vylaďte minimální délku události připojení, aby bylo možné přenést více paketů LL na událost připojení.
1121605	Chyby zaokrouhlování mohou způsobit spuštění naplánovaných událostí ve velmi mírně odlišných časech, než se očekávalo.
1226127	Poskytovatel hostitele exampmůže se zaseknout, když začne zřizovat druhý uzel.	Před zřizováním druhého uzlu restartujte aplikaci zprostředkování hostitele.
1204017	Distributor není schopen zpracovat paralelní vlastní aktualizaci FW a nahrávání FW.	Nespouštějte vlastní aktualizaci FW a nahrávání FW paralelně.

Zastaralé položky

Zastaralé ve verzi 7.0.0.0
Příkaz BGAPI sl_btmesh_prov_test_identity byl zastaralý. Místo toho použijte sl_btmesh_node_test_identity.

Odebrané položky

Odstraněno ve verzi 7.0.0.0

Podpora hardwaru Series 1 (xG12 a xG13) byla v tomto vydání odstraněna.

Použití této verze

Toto vydání obsahuje následující

Silicon Labs Bluetooth mesh stack knihovna
Bluetooth mesh sample aplikace

Pokud s produktem pracujete poprvé, přečtěte si příručku QSG176: Stručná úvodní příručka pro Silicon Labs Bluetooth Mesh SDK v2. x.

Instalace a použití

Sada Bluetooth Mesh SDK je součástí Simplicity SDK (GSDK), sady SDK od společnosti Silicon Labs.
Pro rychlý začátek práce se Simplicity SDK si nainstalujte Simplicity Studio 5, které nastaví vaše vývojové prostředí a provede vás instalací Simplicity SDK.
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ů, nástrojů pro konfiguraci softwaru, plnohodnotného IDE s GNU toolchainem a analytických nástrojů.
Pokyny k instalaci jsou uvedeny v online příručce Simplicity Studio 5 User's Guide.
Alternativně lze Simplicity SDK nainstalovat ručně stažením nebo klonováním nejnovější verze z GitHubu. Vidět https://github.com/Sili-conLabs/simplicity_sdk Pro více informací .

Simplicity Studio instaluje Simplicity SDK ve výchozím nastavení v:
- Windows: C:\Users\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Users/ /SimplicityStudio/SDKs/simplicity_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
Tato verze zásobníku je integrována se správou klíčů Secure Vault. Při nasazení do zařízení Secure Vault High jsou síťové šifrovací klíče chráněny pomocí funkce Secure Vault Key Management. Níže uvedená tabulka ukazuje chráněné klíče a jejich charakteristiky ochrany úložiště.

Klíč	Exportovatelnost na uzlu	Exportovatelnost na Provider	Poznámky
Síťový klíč	Exportovatelné	Exportovatelné	Odvozené verze síťového klíče existují pouze v paměti RAM, zatímco síťové klíče jsou uloženy v paměti flash.
Klíč aplikace	Neexportovatelné	Exportovatelné
Klíč zařízení	Neexportovatelné	Exportovatelné	V případě poskytovatele se to vztahuje na klíč zařízení poskytovatele i na klíče ostatních zařízení.

Klíče označené jako „Neexportovatelné“ lze použít, ale nikoli viewed nebo sdílené za běhu.

Klíče označené jako „Exportovatelné“ lze použít nebo sdílet za běhu, ale zůstávají šifrované, dokud jsou uloženy v paměti flash.
Další informace o funkci správy klíčů zabezpečeného trezoru naleznete v dokumentu AN1271 Bezpečné úložiště klíčů.

Bezpečnostní upozornění
Chcete-li se přihlásit k odběru bezpečnostních upozornění, přihlaste se na zákaznický portál Silicon Labs a poté vyberte Domů úč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 políčko „Oznámení o softwaru/bezpečnostních upozorněních a oznámení o změnách produktů (PCNS)“ a že jste přihlášeni k odběru alespoň pro vaši platformu a protokol. Kliknutím na Uložit uložte všechny změny.

Následující obrázek je exampzávětří

Podpora
Zákazníci sady Development Kit mají nárok na školení a technickou podporu. Použijte síť Bluetooth Silicon Labs web na stránce získáte informace o všech produktech a službách Bluetooth společnosti Silicon Labs a přihlásíte se k podpoře produktu.
Kontaktujte podporu Silicon Laboratories 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 internetu věcí
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

Společnost Silicon Labs má v úmyslu poskytovat zákazníkům nejnovější, přesnou a podrobnou dokumentaci ke všem periferiím a modulům dostupným pro implementátory systémů a softwaru, kteří používají nebo mají v úmyslu používat produkty SiliconLabs. Charakteristické údaje, dostupné moduly a periferie, velikosti paměti a adresy paměti se vztahují ke každému konkrétnímu zařízení a uvedené „typické“ parametry se mohou v různých aplikacích lišit.

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í.
Společnost Silicon Labs si vyhrazuje právo aktualizovat firmware produktu během výrobního procesu z důvodů bezpečnosti nebo spolehlivosti. Takové změny nezmění specifikace ani výkon produktu. Společnost 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 autorizovány pro použití v žádných zařízeních FDA třídy III, aplikacích, pro které je vyžadováno schválení FDA před uvedením na trh, ani v systémech podpory života bez výslovného písemného souhlasu společnosti 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ě očekávat, že v případě selhání povede k závažnému zranění osob nebo smrti.

Produkty společnosti Silicon Labs nejsou navrženy ani schváleny pro vojenské aplikace. Produkty společnosti Silicon Labs nesmí být za žádných okolností použity ve zbraních hromadného ničení, včetně (mimo jiné) jaderných, biologických nebo chemických zbraní nebo raket schopných takové zbraně nést.
Společnost Silicon Labs se zříká všech výslovných i implicitních záruk a nenese odpovědnost za žádná zranění nebo škody související s použitím produktu Silicon Labs v takových neoprávněných aplikacích.

Informace o ochranné známce
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® a logo Silicon Labs®, Bluegiga®, logo Bluegiga®, 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, logo Telegesis®, 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 společnosti Wi-Fi Alliance. Všechny ostatní zde uvedené produkty nebo značky jsou ochrannými známkami příslušných vlastníků.

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

Nejčastější dotazy

Otázka: Kde najdu další informace o aktualizacích zabezpečení?
A: Podrobné informace o aktualizacích zabezpečení naleznete v kapitole Zabezpečení v poznámkách k verzi platformy nebo na stránce s poznámkami k verzi Silicon Labs.

Otázka: Jak se mohu přihlásit k odběru bezpečnostních rad?
A: Společnost Silicon Labs doporučuje přihlásit se k odběru bezpečnostních doporučení, kde získáte aktuální informace. Postupujte podle pokynů uvedených v dokumentaci nebo kontaktujte podporu společnosti Silicon Labs.

Dokumenty / zdroje

SDK pro Bluetooth Mesh od Silicon Labs [pdfUživatelská příručka
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetooth Mesh SDK, Mesh SDK, SDK

Reference

Uživatelská příručka

SDK pro Bluetooth Mesh od Silicon Labs

Specifikace