SILICON LABS Bluetooth SDK Mesh
Bluetooth mesh je nová topologie dostupná pro zařízení Bluetooth Low Energy (LE), která umožňuje komunikaci many-to-many (m:m). Je optimalizován 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í funkce Bluetooth Mesh a Bluetooth 5.2. Vývojáři mohou k zařízením LE přidat síťovou komunikaci, jako jsou připojená světla, domácí automatizace a systémy sledování majetku. Software také podporuje Bluetooth beaconing, Beacon Scanning a GATT připojení, takže Bluetooth mesh se může připojit k chytrým telefonům, tabletům a dalším zařízením Bluetooth LE.
Tyto poznámky k vydání se týkají verzí SDK:
- 2.1.10.0 vydáno 25. října 2023 (podpora EFR32xG22, revize D)
- 2.1.9.0 vydáno 5. září 2023 (pouze základní změny platformy)
- 2.1.8.0 vydáno 13. července 2023 (podpora pro EFR32xG21, revize C a novější)
- 2.1.6.0 vydáno 29. března 2023 (podpora části pro časný přístup)
- 2.1.5.0 vydáno 11. ledna 2023 (pouze základní změny platformy)
- 2.1.4.0 vydáno 13. října 2021
- 2.1.3.0 vydáno 24. září 2021 (pouze základní změny Bluetooth)
- 2.1.2.0 vydáno 8. září 2021
- 2.1.1.0 vydáno 21. července 2021
- 2.1.0.0 vydáno 16. června 2021
Oznámení o kompatibilitě a použití
Další 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 stránce Poznámky k vydání Silicon Labs. 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 noví se sadou SDK Silicon Labs Bluetooth mesh SDK naleznete v části Používání této verze.
Kompatibilní kompilátory
IAR Embedded Workbench pro ARM (IAR-EWARM) verze 8.50.9
- 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é fileGCC (The GNU Compiler Collection) verze 10.2.0, poskytované se Simplicity Studio. Funkce optimalizace Link-time GCC byla deaktivována, což má za následek mírné zvětšení velikosti obrázku
Nové položky
Nové funkce
Přidáno ve verzi 2.1.0.0 Secure Vault Integration
Počínaje verzí 2.1.0.0 používá Bluetooth Mesh SDK funkci Secure Vault Key Management pro ukládání síťových kryptografických klíčů, když se používají zařízení Secure Vault High. Integrace Secure Vault je viditelná pro zákazníka mnoha způsoby na zařízeních Series 2:
- Rozvržení dat NVM3 pro kryptografické klíče a související metadata se mění. Funkce migrace klíčů je poskytována pro projekty, které byly vytvořeny pomocí sady SDK verze 2.0 nebo starší. Jednorázovou migraci klíče je třeba provést při aktualizaci firmwaru v zařízení.
- Viditelnost klíčových dat je záměrně omezena na běžné uzly sítě. Aplikace na běžném síťovém uzlu to není povoleno view data klíče aplikace nebo zařízení pomocí příkazu sl_btmesh_node_get_key() BGAPI, zatímco aplikace na vestavěném uzlu Provisioner to má povoleno.
Další informace o úložišti klíčů v zabezpečeném trezoru naleznete v AN1271: Zabezpečené úložiště klíčů.
Podpora kompilátoru
Podporované kompilátory byly aktualizovány na verzi GCC 10.2.0 a IAR na verzi 8.50.9.
Nový Přample Aplikace
HSL Lighting example (Bluetooth Mesh – SoC HSL Light) byl přidán, aby demonstroval světelný uzel, který lze ovládat přes modely serverů HSL. Byla přidána ukázka IOP (Bluetooth Mesh – IOP Test – *) pro rádiové desky v sadách Pro Development Kit (SLWRB4104A, SLWRB4181A, SLWRB4181B, SLWRB4182A). Ukázky umožňují testování interoperability s mobilními telefony. Test vyžaduje čtyři ex-amples, každý example představující jednu z funkcí Mesh: proxy, relay, friend a LPN.
Nové komponenty
- Byla přidána komponenta HSL Server.
- Byla přidána podpora pro dynamickou databázi GATT (funkce Bluetooth LE).
Nová rozhraní API Přidána ve verzi 2.1.4.0
Funkce odesílání explicitní zprávy o stavu času sl_btmesh_time_server_status() a odpovídající explicitní funkce publikování sl_btmesh_time_server_publish() byly přidány do API modelu Time Server.
Přidáno ve verzi 2.1.2.0
Ve výchozím nastavení není normální zařízení Mesh, které není poskytovatelem, schopno exportovat data bezpečnostního klíče přes BGAPI. Pokud je na takovém zařízení potřeba export klíče, měl by použít nový příkaz BGAPI, sl_btmesh_node_set_exportable_keys(), předtím, než budou na uzlu vytvořeny jakékoli klíče. To zahrnuje klíče vytvořené během zřizování zařízení. Byla přidána diagnostická událost upozorňující aplikaci na naplánovanou změnu scény, sl_btmesh_scheduler_server_scene_changed().
Přidáno ve verzi 2.1.1.0
Pro optimalizaci využití vyrovnávací paměti u modelů scén bylo přidáno volitelné API, které umožňuje události vyvolání komprimované scény (ref. issue ID 706555). Nové API se doporučuje používat, když má uzel velké množství modelů nebo je objem síťového provozu, který má uzel slyšet, vysoký. Chcete-li aktivovat nové rozhraní API, použijte příkaz BGAPI sl_btmesh_scene_server_enable_compact_recall_events(). Poté bude sl_btmesh_evt_scene_server_compact_recall_events signalizovat požadavky na vyvolání scény. Chcete-li načíst stavy modelu uložené v mezipaměti po požadavku na vyvolání scény, použijte příkaz sl_btmesh_generic_server_get_cached_state().
Přidáno ve verzi 2.1.0.0
Kvůli integraci Secure Vault se na zařízeních Series 2 změnily podrobnosti o ukládání šifrovacích klíčů a souvisejících metadat. Proto byla přidána nová třída BGAPI pro migraci šifrovacích klíčů a databáze zařízení vestavěného Provisioner po aktualizaci firmwaru na zařízeních Series 2. Má následující příkazy:
- sl_btmesh_migration_migrate_keys
- sl_btmesh_migration_migrate_ddb
Vylepšení
Změněná API
Změněno ve verzi 2.1.2.0
Parametr timezone v sl_btmesh_time_server_get_datetime() byl opraven tak, aby byl 16bitovým celým číslem se znaménkem. Parametr přesnosti hodin, sl_btmesh_lpn_clock_accuracy, byl přidán do konfigurace LPN. Tento parametr lze použít k vyladění režimu spánku LPN, když by posun hodin na zařízení jinak způsobil, že LPN zmešká časový limit dotazování.
Změněno ve verzi 2.1.1.0
Událost sl_btmesh_evt_friend_friendship_terminated bude nyní generována, když Configuration Client zakáže funkci přítele uzlu, když je aktivní přátelství. Dříve bylo ukončení přátelství v této situaci implicitně signalizováno událostí sl_btmesh_evt_node_config_set. (ref. vydání iD 627811)
Změněno ve verzi 2.1.0.0
Následující příkazy BGAPI ve třídě prov se nyní vracejí po ověření parametru a skutečná požadovaná operace proběhne po odeslání odpovědi BGAPI. Dokončení požadované operace je signalizováno odpovídající událostí BGAPI:
- sl_btmesh_prov_add_ddb_entry() – dokončení přidávání je signalizováno sl_btmesh_evt_prov_add_ddb_entry_complete
- sl_btmesh_prov_delete_ddb_entry() – dokončení smazání je signalizováno sl_btmesh_evt_prov_delete_ddb_entry_complete Následující příkaz BGAPI ve třídě prov má další událost, která může být vygenerována poté, co je zavolána:
- sl_btmesh_prov_init – kromě sl_btmesh_evt_prov_initialized lze vygenerovat sl_btmesh_evt_prov_initialization_failed. Do obecného modelu klienta BGAPI byl přidán příkaz BGAPI:
mesh_generic_client_init_hsl()
Do obecného modelu serveru BGAPI byl přidán příkaz BGAPI:
mesh_generic_server_init_hsl()
Opravené problémy
Opraveno ve verzi 2.1.4.0
| ID # | Popis |
| 729116 | Opraven problém s neúmyslným násobením modelu Time Server při přidávání nových prvků do projektu |
| 735569 | Opraveno zpracování segmentovaných vícesměrových zpráv, které kamarádský uzel doručuje do uzlu s nízkou spotřebou |
Opraveno ve verzi 2.1.2.0
| ID # | Popis |
| 627811 | Vygenerujte událost ukončení přátelství, když je lokálně požadováno ukončení |
| 676798 | Vezměte v úvahu nepřesnost hodin s načasováním probuzení LPN |
| 683518 | Vygenerujte událost ukončení přátelství okamžitě v okamžiku obdržení zprávy Friend Clear |
| 703974 | Opraven problém s kvalifikačním testem s tepy |
| 709948 | Poskytuje rozhraní API pro řízení exportovatelnosti bezpečnostních klíčů na síťovém uzlu |
| 724511 | Opraven problém s registrací operačních kódů dodavatele přes 0x1F |
| 730273 | Opraven problém se zpracováním záporného posunu časového pásma |
| 731713 | Opraven potenciální únik paměti s odesíláním segmentovaných zpráv, když má zařízení nedostatek paměti |
| 734034 | Opravena komunikace mezi přáteli a LPN, když je TTL nula |
| 734858 | Opraven potenciální problém s proměnnou zásobníku se zpracováním struktury PSA |
| 736054 | Opraven problém kvalifikačního testu s vázáním klíče model-aplikace |
Opraveno ve verzi 2.1.1.0
| ID # | Popis |
| 692961 | Opraveno, že uzel přestal reagovat, když byly povoleny přenosové přenosy při velkém zatížení |
| 713152 | Opraven problém, kdy omezená přesnost výpočtu způsobovala chyby zaokrouhlování ve vazbě mezi Light Lightness Actual a Light Lightness Linear |
Opraveno ve verzi 2.1.0.0
| ID # | Popis |
| 3878 | Aplikace by měla ignorovat události GATT pro charakteristiky sítě |
| 342521 | Matematická knihovna zbytečně nezvětšuje velikost obrázku |
| 358019 | Opravený výsledný kód poskytnutý, když je požadováno zveřejnění modelu s přihlašovacími údaji přátelství, ale přátelství není podporováno |
| 404070 | Opravený výsledný kód zadaný při volání příkazu zřizování k vytvoření síťového klíče na zařízení bez zřizování |
| 454332 | Pro inzerci místních názvů zařízení by se mělo používat rozhraní LE GAP API |
| 464907 | Odstraněna zbytečná událost BGAPI „heartbeat spuštěna“, když konfigurační klient zakáže prezenční signál na uzlu |
| 653405 | Out-of-the-box přepínač sampSpotřeba proudu aplikace je nyní na očekávané úrovni |
| 654477 | DCD správně dekódováno Network Analyzerem |
| 660048 | Tlačítko Stiskněte Komponenta UC zbytečně nevyžaduje komponentu IO Stream |
| 687105 | Příkazy BT Mesh pracují s NCP Target example a velitel NCP |
| 690803 | Opravena duplicitní ID modelu dodavatele v generátoru kódu |
| 690862 | SoC prázdný example nyní začne signalizovat na hardwaru xG22 |
| 707497 | Opravená alokace kryptografického kontextu PSA |
| 707524 | Opravena regrese s časovačem ochrany IV obnovy, která neumožňovala další zotavení příliš brzy |
| ID # | Popis |
| 710381 | Opraveno zpracování výchozího stavu osvětlení, když byl nastaven jiný než výchozí rozsah pro odpovídající model |
| 711359 | Opravena kontrola parametrů pro volání BGAPI vytváření relace zajišťování |
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í vyvodit selhání z časového limitu / nedostatečné odezvy aplikační vrstvy |
| 418636 | Problémy s rozhraním API stavu místní konfigurace mesh_test (identita uzlu, přenos, opakovaný přenos sítě) | |
| 454059 | Na konci procesu KR se generuje velký počet událostí změny stavu obnovení klíče, což může zahltit frontu NCP | Zvyšte 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 používá se proxy GATT | Přidělte o jedno připojení více, než je potřeba |
| 650825 | Problém s opakovanými přenosy, když se model pravidelně publikuje | Nastavte opakované přenosy ve stavu modelu a spusťte pravidelné publikování pomocí časovače aplikace |
Zastaralé položky
Následující příkaz BGAPI ve třídě uzlů byl zastaralý: sl_btmesh_node_erase_mesh_nvm() – místo toho použijte sl_btmesh_node_reset().
Odebrané položky
- Žádný
Použití této verze
Toto vydání obsahuje následující
- Silicon Labs Bluetooth mesh stack knihovna
- Bluetooth sample aplikace
Pokud jste prvním uživatelem, přečtěte si QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Rychlý průvodce.
Instalace a použití
Ke stažení sady Silicon Labs Bluetooth SDK je vyžadován registrovaný účet u Silicon Labs. Registrovat se můžete na https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short. Pokyny k instalaci zásobníku jsou uvedeny v příručce QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide. Použijte Bluetooth mesh SDK s vývojovou platformou Silicon Labs Simplicity Studio V4. Simplicity Studio zajišťuje, že většina kompatibility softwaru a nástrojů je spravována správně. Nainstalujte aktualizace softwaru a firmwaru desky ihned, jakmile budete upozorněni. 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 Integrace zabezpečeného trezoru
Tato verze zásobníku je integrována se správou klíčů Secure Vault. Při nasazení do zařízení Secure Vault High jsou šifrovací klíče sítě 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í síťového klíče existují pouze v RAM, zatímco síťové klíče jsou uloženy na flash |
| Klíč aplikace | Neexportovatelné | Exportovatelné | |
| Klíč zařízení | Neexportovatelné | Exportovatelné | V případě Provisioner's použito na klíč zařízení Provisionerr i na klíče jiných zařízení |
Klíče označené jako „Neexportovatelné“ lze použít, ale nikoli viewed nebo sdílené za běhu. 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. Další informace o funkci správy klíčů Secure Vault naleznete v části 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.
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 IoT
- SW/HW
- Kvalitní
- Podpora a komunita
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 implementátory systémů a softwaru, 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.
Poznámka: Tento obsah může obsahovat urážlivou terminologii, která je nyní zastaralá. Silicon Labs nahrazuje tyto termíny inkluzivním jazykem, kdykoli je to možné. Pro více informací navštivte www.silabs.com/about-us/inclusive-lexicon-project
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, ThreadArch®, 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
Dokumenty / zdroje
 |
SILICON LABS Bluetooth SDK Mesh [pdfPokyny Bluetooth SDK Mesh, SDK Mesh, Mesh |
