Uživatelská příručka SILICON LABS 4.2.3.0 GA Bluetooth Mesh SDK

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.3. 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.
Tato verze obsahuje funkce podporované specifikací Bluetooth mesh verze 1.1.
Tyto poznámky k vydání se týkají verzí SDK:

4.2.3.0 vydáno 24. ledna 2024 (podpora EFR32xG21, revize C a novější)
4.2.2.0 vydáno 16. srpna 2023 (podpora pro EFR32xG21, revize C a novější)
4.2.1.0 vydáno 3. května 2023
4.2.0.0 vydáno 8. března 2023
4.1.0.0-prev vydáno 1. února 2023 (omezený přístup)
4.0.0.0-prev vydáno 14. prosince 2022 (omezený přístup)
3.0.0.0-prev vydáno 20. června 2022 (omezený přístup)

KLÍČOVÉ VLASTNOSTI

• Podpora specifikace návrhu sítě 1.1:
  • Protokol sítě
  • Binární síťový model přenosu velkých objektů (MBT)
  • Model aktualizace firmwaru zařízení Mesh (DFU)
• Snížená spotřeba flash projektu díky optimalizaci velikosti kódu zásobníku Mesh
• Přidána podpora pro moduly PCB xGM240P a sady BG22/BGM220 Explorer
• Přidána podpora pro GCC verze 10.32021.10 a IAR verze 9.20.4

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ánka s poznámkami 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.

Kompatibilita specifikace:
Toto vydání obsahuje implementaci specifikací Mesh Protocol 1.1, Mesh Model 1.1, Mesh Binary Large Object Transfer a Mesh Device Firmware Update. Tyto specifikace dosud nebyly přijaty specifikacemi Bluetooth SIG a v současné době pro tyto specifikace neexistuje žádný kvalifikační program Bluetooth. Proto tyto specifikace nejsou schváleny pro použití v komerční výrobě. Jakékoli experimentální použití funkcí v těchto specifikacích je „TAK, JAK JE“, a nejsou udělena žádná licenční práva Bluetooth.

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

• 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é files se používají.
  GCC (The GNU Compiler Collection) verze 10.3-2021.10, dodávaná se Simplicity Studio.
• Funkce optimalizace Link-time GCC byla deaktivována, což má za následek mírné zvětšení velikosti obrázku.

1 nové položky

1.1 Nové funkce

Přidáno ve verzi 4.2.1.0 Nový hardware: Podpora pro EFR32xG21 Rev C a Rev D

Přidáno ve verzi 4.2.0.0
Výchozí adresa Bluetooth používaná pro inzerci dat Mesh a majáků zabezpečených sítí byla změněna na soukromou adresu, která je pravidelně přiřazována nové náhodné hodnotě. Je to proto, že použití veřejné adresy by nefungovalo dobře s funkcemi pro zvýšení soukromí Mesh 1.1, majáky privátní sítě a privátní proxy GATT.

Přidáno ve verzi 4.0.0-předch
Podpora pro Bluetooth mesh over advertising extensions (AE) byla přidána jako proprietární rozšíření. Tato funkce umožňuje rychlejší přenos dlouhých zpráv ve srovnání se standardním Bluetooth Mesh využívajícím běžné reklamy. Například aktualizace firmwaru zařízení pomocí AE může vést k výraznému zkrácení doby přenosu ve srovnání se standardním provozem. Bluetooth Mesh over AE však není v souladu se specifikací Bluetooth mesh. Produkty využívající Mesh over AE nejsou plně kompatibilní s produkty, které jsou přísně v souladu se specifikací Bluetooth mesh.
Byla přidána podpora pro výběr reklamního BGAPI BLE, který zásobník Bluetooth mesh interně používá. Dříve mesh stack interně používal pouze staré BGAPI, což bránilo použití novějších BLE reklamních BGAPI v aplikaci, protože staré a nové API nefungují interoperabilně. Nyní lze BGAPI, které zásobník používá, určit výběrem komponent v projektu.

Exampaplikace:
Aktualizace IV je demonstrována prostřednictvím vloženého examples a Bluetooth Mesh Host Provisioner.
Obnovení klíčů a export klíčů do Network Analyzer je demonstrován pomocí Bluetooth Mesh Host Provisioner.

Nástroje:
NCP Commander je nyní schopen vytvořit novou síťovou síť, zřídit a konfigurovat uzly v této síti a odesílat síťové pakety pomocí modelů Generic On off Client a Generic Level Client. To umožňuje testování uzlů s modely Generic Level a Onoff Server a dalšími modely s nimi spojenými.
Nový hardware:
Podpora pro xGM240 SIP moduly
Přidáno ve verzi 3.0.0-předch
Podpora pro následující položky byla přidána na základě specifikací, které jsou ve stavu ověření a nejsou k dispozici pro kvalifikaci. Aby zákazníci získali kvalifikaci Bluetooth SIG, budou muset upgradovat na verzi, která bude vycházet z přijaté specifikace, která bude k dispozici po přijetí.

1. Mesh Protocol 1.1 s následujícími funkcemi
   · Vzdálené poskytování (RPR)
   · Poskytování na základě certifikátu (CBP) · Soukromé majáky (PRB)
2. Binární síťový model přenosu velkých objektů (MBT)
3. Model aktualizace firmwaru zařízení Mesh (DFU)

Nový Přample Aplikace
Vestavěné aplikace:
Bluetooth Mesh SoC DFU Distributor: Demonstruje roli distributora firmwaru na základě specifikace BT Mesh Model. Distributor je zodpovědný za doručování nových obrazů firmwaru do uzlů aktualizace a sledování průběhu aktualizace firmwaru.

Bluetooth Mesh – NCP Empty 1.1: Cílová aplikace režimu NCP včetně podpory vzdáleného poskytování. Pro použití s ​​BT Mesh Host Provisioned exampsoubor nalezený ve složce GSDK app/bluetooth/example_host/btmesh_host_provisioner
Bluetooth Mesh – SoC Empty s podporou Certificate-Based Provisioning: Demonstruje naprosté minimum potřebné pro aplikaci Bluetooth Mesh C, která umožňuje Certificate-Based Provisioning (CBP). Aplikace spustí Unprovisioned Device Beaconing po spuštění a čeká na zřízení do sítě Mesh.
Bluetooth Mesh – SoC CSR Generator: Firmware generující certifikát example. Software generuje pár klíčů EC zařízení, žádost o podpis certifikátu zařízení a další související data. Vygenerovaná data může ústřední orgán přečíst.
Hostitelské aplikace NCP:
Bluetooth Mesh Host Provisioner byl rozšířen o podporu Remote Provisioning a Certificate Based Provisioning.

Nové komponenty

• Úložiště BLOB: Poskytuje rozhraní API pro ukládání velkých binárních objektů (BLOB) prostřednictvím zavaděče.
• BLOB Transfer Client: Poskytuje funkci BT Mesh BLOB (binární velký objekt) Transfer Client, definovanou ve specifikaci mesh.
• BLOB Transfer Server: Poskytuje funkci BT Mesh BLOB (binary large object) Transfer Server, definovanou ve specifikaci mesh.
• Distributor DFU: Softwarová komponenta Wrapper pro roli distributora DFU v aplikacích Bluetooth Mesh.
• Firmware Update Client: Poskytuje funkci klienta aktualizace firmwaru BT Mesh definovanou ve specifikaci sítě.
• Firmware Update Server: Poskytuje funkcionalitu BT Mesh Firmware Update Server, definovanou ve specifikaci mesh.
• Firmware Distribution Server: Poskytuje funkce BT Mesh Firmware Distribution Server, definované ve specifikaci mesh.
• Vzdálené zajišťování: Používá se k podpoře funkce klienta vzdáleného zajišťování zajišťování zařízení do sítě typu mesh
  interakce s uzlem sítě, který podporuje model serveru vzdáleného zřizování.
• Server vzdáleného zajišťování: Používá se k podpoře funkcí serveru vzdáleného zajišťování při zajišťování vzdáleného zařízení přes síť typu mesh a k provádění procedur rozhraní protokolu zajišťování uzlů.
• Uzel aktualizace DFU: Softwarová komponenta Wrapper pro roli uzlu aktualizace DFU v aplikacích Bluetooth Mesh.

Nové dokumenty

• QSG183: Průvodce rychlým spuštěním Bluetooth Mesh SDK pro SDK v4.x · AN1319: Aktualizace firmwaru zařízení Bluetooth Mesh
• AN1370: Aktualizace firmwaru zařízení Bluetooth Mesh Example Návod
• AN1368: Bluetooth Mesh Remote Provisioning
• AN1405: Bluetooth Mesh na reklamních rozšířeních

Přidáno ve verzi 3.0.0.0
Nové vývojové nástroje
Uživatelsky přívětivější filtrování pro Software Exampv Simplicity Studio.
Nová hardwarová podpora
Byla přidána podpora pro xGM240P PCB moduly a BG22/BGM220 Explorer Kit.

1.2 Nová rozhraní API

Přidáno ve verzi 4.2.0.0
Testovací API bylo doplněno o nové volání sl_btmesh_test_send_private_beacons, které lze použít pro odesílání majáků privátní sítě pro testovací účely.
Test API bylo doplněno o nové volání sl_btmesh_test_adv_use_random_address, které lze použít pro nastavení typu Bluetooth adresy používané pro Mesh reklamu.

Přidáno ve verzi 4.1.0-předch
Test API bylo doplněno o nové volání sl_btmesh_test_update_key_refresh_phase, které lze použít k testování různých fází obnovy klíčů lokálně bez konfiguračního klienta.

Přidáno ve verzi 4.0.0-předch
Bluetooth mesh over AE přidává modely dodavatelů klientů a serverů pomocí zpráv dodavatele Silicon Labs pro bezdrátovou konfiguraci funkce, stejně jako odpovídající třídy BGAPI sl_btmesh_silabs_config_client a sl_btmesh_silabs_config_server.
Node API bylo upraveno několika dodatky:

• Byla přidána rozhraní API pro ukládání stavu RPL žádosti proxy a pro zkoumání, zda je nutné uložit RPL
  (sl_btmesh_node_save_proxy_solicitation_rpl a sl_btmesh_node_get_proxy_solicitation_rpl_status).
• Byla přidána rozhraní API pro čtení a zápis nezajištěných dat URI zařízení do trvalého úložiště (sl_btmesh_node_set_oob_uri a sl_btmesh_node_get_oob_uri).
• API pro místní přístup ke stránce Models Metadata, sl_btmesh_node_get_local_model_metadata_page, a odpovídajícím událostem, sl_btmesh_node_local_model_metadata_page a sl_btmesh_node_local_model_metadata_page_end.

Kontrola správce nad procedurou obnovy klíče byla vylepšena dalšími rozhraními API, sl_btmesh_prov_set_key_refresh_failure, sl_btmesh_prov_phase_timeout_get a sl_btmesh_prov_phase_timeout_set. Poskytovatel nyní může také určit množství požadavků na konfiguraci obnovení paralelního klíče nastavením konfigurační proměnné SL_BTMESH_CONFIG_LIMIT_PROV_CONCURRENT_KR. Všimněte si, že hodnota by měla být menší nebo rovna celkovému počtu požadavků klientů na paralelní konfiguraci.
Kontrola konfiguračního klienta nad konfiguračními požadavky byla vylepšena dalším rozhraním API sl_btmesh_config_client_set_request_timeout_for_node a událostí sl_btmesh_config_client_obo_ack_received, která je generována, když přítel uzel potvrdí přenosovou zprávu, která má jako cíl LPN.
Rozhraní API modelu klienta zdraví bylo doplněno o explicitní inicializaci a deinicializaci, takže kód modelu klienta zdraví bude vtažen do projektu pouze tehdy, když je to potřeba: sl_btmesh_health_client_init a sl_btmesh_health_client_deinit.
Testovací příkaz pro úpravu časových parametrů PB-ADV byl poskytnut jako sl_btmesh_test_set_adv_provisioning_bearer_timing. Všimněte si, že výchozí hodnoty časování jsou ty, které definuje specifikace; časování by mělo být upraveno pouze pro účely ladění.

Přidáno ve verzi 3.0.0-předch
Bylo přidáno několik nových tříd BGAPI pro podporu nových funkcí specifikace Mesh 1.1. Podrobnosti o přidaných třídách naleznete v odkazu API; dodatky jsou shrnuty níže.
Podpora pro přenos velkých binárních objektů typu Mesh přidává třídy BGAPI pro model klienta MBT a model serveru MBT.
Podpora pro aktualizaci firmwaru zařízení Mesh přidává třídy BGAPI pro model klienta aktualizace firmwaru, model serveru pro aktualizaci firmwaru, model klienta distribuce firmwaru, model distribučního serveru firmwaru a model samostatného aktualizátoru firmwaru a také podpůrnou třídu BGAPI pro manipulaci s mezipamětí firmwaru zařízení.
Podpora vzdáleného zřizování Mesh 1.1 přidává třídy BGAPI pro model klienta vzdáleného zřizování a model serveru se vzdáleným zřizováním.
Podpora pro soukromé majáky Mesh 1.1 přidává třídy BGAPI pro model klienta privátního majáku a model serveru privátního majáku.
Podpora pro drobná vylepšení Mesh 1.1 přidává třídy BGAPI pro model konfiguračního klienta SAR, model konfiguračního serveru SAR, model datového klienta s velkou kompozicí, model datového serveru s velkou kompozicí, model soukromého proxy klienta na vyžádání, model soukromého proxy serveru na vyžádání a žádosti Model klienta konfigurace PDU RPL.
Dále byly změněny stávající třídy BGAPI, jak je uvedeno níže.
Podpora vylepšeného zřizovacího algoritmu Mesh 1.1 přidává do uzlu BGAPI jeden příkaz, sl_btmesh_node_set_provisioning_algorithm(), a definuje hodnoty výčtu příznaků pro zřizovací algoritmy Mesh 1.0 i 1.1.
Podpora zajišťování založeného na certifikátu sítě 1.1 přidává jeden příkaz do uzlu BGAPI, sl_btmesh_node_init_provisioning_records() a tři příkazy a dvě události do zajišťovacího zařízení BGAPI: sl_btmesh_prov_init_provisioning_records(), sl_btmesh_prov_get_provisionsh_prov_list ing_record_data(), sl_btmesh_provisioning_records_list() a sl_btmesh_provisioning_record_data() .
Podpora procedur Node Provisioning Protocol Interface přidává do uzlu BGAPI dvě události, sl_btmesh_node_address_updated() a sl_btmesh_node_dcd_updated().
Podpora proxy obtěžování přidává k proxy BGAPI jeden nový příkaz BGAPI: sl_btmesh_proxy_send_solicitation().
Do testovacího BGAPI byly přidány nové příkazy BGAPI na podporu testování soukromých majáků: sl_btmesh_test_get_private_identity() a sl_btmesh_test_set_private_identity().

NIKDY vylepšení

Podporované verze kompilátoru byly aktualizovány. Nyní jsou podporovány GCC verze 10.3-2021.10 a IAR verze 9.20.4. Optimalizací struktur a odstraněním zbytečných závislostí mezi komponentami se snížila flash stopa implementace síťového zásobníku. Přesné snížení závisí na funkcích používaných projektem.

3 Opravené problémy

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

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

5 Zastaralé položky

Žádný

6 Odebrané položky

Odstraněno ve verzi 3.0.0.0
Zastaralý příkaz BGAPI sl_btmesh_node_erase_mesh_nvm() byl odstraněn. Místo toho použijte sl_btmesh_node_reset().

7 Používání této verze

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

• Silicon Labs Bluetooth mesh stack knihovna
• Bluetooth mesh sample aplikace

Pokud jste prvním uživatelem, přečtěte si QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Rychlý průvodce.

7.1 Instalace a použití

Bluetooth mesh SDK je poskytován jako součást Gecko SDK (GSDK), sady SDK Silicon Labs. Chcete-li rychle začít s GSDK, nainstalujte Simplicity Studio 5, který nastaví vaše vývojové prostředí a provede vás instalací GSDK. 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ů, softwarových konfiguračních nástrojů, plného IDE s GNU toolchain a analytických nástrojů. Pokyny k instalaci jsou uvedeny na internetu Simplicity Studio 5 Uživatelská příručka.

Alternativně lze Gecko SDK nainstalovat ručně stažením nebo klonováním nejnovější verze z GitHubu. Vidět https://github.com/SiliconLabs/gecko_sdk pro více informací.
Výchozí umístění instalace GSDK se změnilo ve verzi Simplicity Studio 5.3 a vyšší.

• Windows: C: Users SimplicityStudioSDKsgecko_sdk
• MacOS: /Users/ /SimplicityStudio/SDKs/gecko_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/.

7.2 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íč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íčů zabezpečeného trezoru viz AN1271: Zabezpečené úložiště klíčů

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.

7.3 Podpora

Zákazníci sady Development Kit mají nárok na školení a technickou podporu. Použijte Síť Bluetooth Silicon Labs web strana získat informace o všech produktech a službách Bluetooth společnosti Silicon Labs a přihlásit se k podpoře produktu.
Kontaktujte podporu Silicon Laboratories na adrese http://www.silabs.com/support.

www.silabs.com/IoT
www.silabs.com/simplicity
www.silabs.com/quality
www.silabs.com/community

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. 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 v tomto dokumentu a neposkytuje 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ůvodů 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
www.silabs.com

Dokumenty / zdroje

SILICON LABS 4.2.3.0 GA Bluetooth Mesh SDK [pdfUživatelská příručka 4.2.3.0 GA, 4.2.3.0 GA Bluetooth Mesh SDK, Bluetooth Mesh SDK, Mesh SDK, SDK

Reference

• Uživatelská příručka