Vývoj softwaru SILICON LABS 6.1.3.0 GA Bluetooth Mesh

Specifikace

• Název produktu: Gecko SDK Suite 4.4
• Datum vydání: 23. října 2024
• Bluetooth Mesh Specifikace Verze: 1.1
• Podporované verze SDK:
  • 6.1.3.0 vydáno 23. října 2024
  • 6.1.2.0 vydáno 14. srpna 2024
  • 6.1.1.0 vydáno 2. května 2024
  • 6.1.0.0 vydáno 10. dubna 2024
  • 6.0.1.0 vydáno 14. února 2024
  • 6.0.0.0 vydáno 13. prosince 2023

Návod k použití produktu

Oznámení o kompatibilitě a použití
Aktualizace zabezpečení a upozornění najdete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nebo na stránce Poznámky k vydání Silicon Labs. Chcete-li získat nejnovější informace, přihlaste se k odběru bezpečnostních rad.

Použití této verze
Pokud jste se Silicon Labs Bluetooth mesh SDK noví, postupujte podle pokynů v uživatelské příručce a začněte s produktem.

Kompatibilní kompilátory
Ujistěte se, že používáte správný files a kompilátory podle doporučení pro optimální výkon produktu.

FAQ

• Otázka: Kde najdu další informace o aktualizacích zabezpečení?
  Odpověď: Podrobné informace o aktualizaci zabezpečení naleznete v kapitole Zabezpečení v poznámkách k vydání platformy Gecko nebo na stránce Poznámky k vydání Silicon Labs. |
• Otázka: Jak se mohu přihlásit k odběru bezpečnostních rad pro tento produkt?
  Odpověď: Chcete-li se přihlásit k odběru bezpečnostních rad a dostávat aktuální informace, postupujte podle pokynů v uživatelské příručce nebo kontaktujte podporu Silicon Labs.
• Otázka: Jaké kompilátory jsou kompatibilní s tímto produktem?
  Odpověď: Seznam kompatibilních kompilátorů doporučených pro použití s ​​tímto produktem najdete v uživatelské příručce.

Bluetooth® mesh SDK 6.1.3.0 GA
Gecko SDK Suite 4.4 23. října 2024

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.

KLÍČOVÉ VLASTNOSTI

• Kvalifikovaná implementace Mesh 1.1
• Přidáno Network Lighting Control (NLC) profiles

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

• 6.1.3.0 vydáno 23. října 2024
• 6.1.2.0 vydáno 14. srpna 2024
• 6.1.1.0 vydáno 2. května 2024
• 6.1.0.0 vydáno 10. dubna 2024
• 6.0.1.0 vydáno 14. února 2024
• 6.0.0.0 vydáno 13. prosince 2023

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 9.40.1

• 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 12.2.1, 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.

Nové položky

 Nové funkce
Přidáno ve verzi 6.0.1.0

Změny v komponentách SLC:

• Vedle role Provisioner a Provisionee byla přidána třetí role BT Mesh Role – vlastní role BT Mesh, kde aplikace získává svobodu implementovat vlastní roli. Napřample, Poskytovatel nebo
• Role poskytovatele může být vybrána za běhu.
• Přidáno ve verzi 6.0.0.0
• Nové síťové řízení osvětlení (NLC) exampaplikace:
• btmesh_soc_nlc_basic_lightness_controller pro ukázku BT Mesh NLC Basic Lightness Controller Profile
• btmesh_soc_nlc_basic_scene_selector pro ukázku BT Mesh NLC Basic Scene Selector Profile
• btmesh_soc_nlc_dimming_control pro ukázku BT Mesh NLC Dimming Controller Profile
• btmesh_soc_nlc_sensor_ambient_light pro ukázku BT Mesh NLC Ambient Light Sensor Profile
• btmesh_soc_nlc_sensor_occupancy pro předvedení BT Mesh NLC Occupancy Sensor Profile (Lidé se počítají)

Změny v exampaplikace:
btmesh_soc_sensor_server byl odstraněn a jeho funkčnost byla rozdělena na 3 examples:

• btmesh_soc_sensor_thermometer pro demonstraci modelu Sensor Server Model s teploměrem
• btmesh_soc_nlc_sensor_occupancy pro předvedení BT Mesh NLC Occupancy Sensor Profile (lidé se počítají)
• btmesh_soc_nlc_sensor_ambient_light pro ukázku BT Mesh NLC Ambient Light Sensor Profile
• btmesh_soc_switch byl přejmenován na btmesh_soc_switch_ctl, jehož účelem je demonstrovat použití modelu Light CTL Client. Bývalýample již neovládá scény (Scene Client)
• btmesh_soc_light byl přejmenován na btmesh_soc_light_ctl
• BývalýampSoubor již nedemonstruje model LC Server a Scene Server, Scheduler Server a Time Server modely
• btmesh_soc_hsl byl přejmenován na btmesh_soc_light_hsl
• BývalýampSoubor již nedemonstruje model LC Server a Scene Server, Scheduler Server a Time Server modely

Změny ve všech exampaplikace:

• Aktualizace obrázků DFU jsou generovány skriptem Python namísto create_bl_files.bat/.sh files
• Byla přidána podpora pro datové stránky o složení sítě 1, 2, 128, 129, 130 pro všechny exampTyto stránky jsou automaticky generovány nástrojem BT Mesh Configurator.

Nové komponenty SLC:

• btmesh_nlc_basic_lightness_controller pro ukázku BT Mesh NLC Basic Lightness Controller Profile
• btmesh_nlc_basic_lightness_controller_profile_metadata pro Composition Data Page 2 Podpora NLC pro Basic Lightness Controller Profile
• btmesh_nlc_basic_scene_selector pro ukázku BT Mesh NLC Basic Scene Selector Profile
• btmesh_nlc_basic_scene_selector_profile_metadata for Composition Data Page 2 Podpora NLC pro Basic Scene Selector Profile btmesh_nlc_dimming_control pro demonstraci BT Mesh NLC
• Dimming Controller Profile
• btmesh_nlc_dimming_control_profile_metadata pro Composition Data Page 2 Podpora NLC pro Dimming Controller Profile btmesh_nlc_ambient_light_sensor pro ukázku BT Mesh NLC Ambient Light Sensor Profile
• btmesh_nlc_ambient_light_sensor_profile_metadata pro Composition Data Page 2 Podpora NLC pro Ambient Light Sensor Profile btmesh_nlc_occupancy_sensor pro ukázku BT Mesh NLC Occupancy Sensor Profile (Lidé se počítají)
• btmesh_nlc_occupancy_sensor_profile_metadata pro Composition Data Page 2 Podpora NLC pro Occupancy Sensor Profile
• btmesh_generic_level_client_ext pro rozšíření komponenty Generic Base o zprávy Generic Move Unaknowledged a Generic Delta Unacknownledged
• ncp_btmesh_ae_server pro povolení modelu dodavatele Silabs Configuration Server pro uzel umožňující přenos dat přes Advertisement Extension
• ncp_btmesh_ae_server pro povolení modelu dodavatele Silabs Configuration Client pro uzel.
• ncp_btmesh_user_cmd pro demonstraci komunikace mezi hostitelem NCP a cílem NCP pomocí uživatelských zpráv, odpovědí a událostí BGAPI.

Nová API
Přidáno ve verzi 6.1.0.0

Doplňky BGAPI:
Do třídy uzlů byly přidány nové příkazy, které spojují data odezvy na skenování s poskytováním sítě Mesh a reklamami na službu proxy sítě Mesh. Data odezvy na skenování spojená s reklamami na službu proxy Mesh lze nastavit individuálně pro každý síťový klíč, takže mohou obsahovat data zašifrovaná tímto klíčem, ale je na aplikaci, jak je bude spravovat. Nové příkazy jsou:

• sl_btmesh_node_set_proxy_service_scan response: Nastavit data odezvy skenování pro inzerci služby proxy
• sl_btmesh_node_clear_proxy_service_scan_response: Vymazat data odezvy skenování pro inzerci služby proxy
• sl_btmesh_node_set_provisioning_service_scan response: Nastavit data odezvy skenování pro inzerci poskytování služby
• sl_btmesh_node_clear_provisioning_service_scan_response: Vymazat data odezvy skenování pro inzerci poskytování služeb

Do třídy modelu dodavatele byl přidán nový příkaz pro nastavení možností chování modelu. V současné době existuje jedna možnost, která řídí, zda je pracovní vyrovnávací paměť přidělena z haldy pro každý model dodavatele pro hlášení příjmu zpráv. Výchozí hodnota (1) přiděluje vyrovnávací paměť, která zvyšuje odolnost hlášení událostí, když je zařízení pod vysokým zatížením, na úkor využití další haldy paměti. Nový příkaz je:

• sl_btmesh_vendor_model_set_option: Nastavte volbu chování modelu dodavatele

Do diagnostické třídy byly přidány nové příkazy pro hlášení událostí souvisejících s přátelstvím. Nové příkazy jsou:

• sl_btmesh_diagnostic_enable_friend: Povolit generování diagnostických událostí souvisejících s přátelstvím
• sl_btmesh_diagnostic_disable_friend: Zakázat generování diagnostických událostí souvisejících s přátelstvím
• sl_btmesh_diagnostic_get_friend: Získejte diagnostické čítače týkající se přátelství

Nové události přidané do diagnostické třídy jsou následující: 

• sl_btmesh_diagnostic_friend_queue: Událost pro přidání zprávy do fronty zpráv přátelství
  sl_btmesh_diagnostic_friend_relay: Událost pro zprávu předávanou do LPN
• sl_btmesh_diagnostic_friend_remove: Událost pro odstranění zprávy z fronty zpráv přátelství

Přidáno ve verzi 6.0.0.0

Změny v komponentách SLC:

• ncp_btmesh_dfu.h komponenty ncp_btmesh_dfu má nové API
  • void sl_btmesh_ncp_dfu_handle_cmd(void *data, bool *cmd_handled);
• Komponenta btmesh_provisioning_decorator nerestartuje zajišťování po selhání zajišťování Server btmesh_lighting_server sl_btmesh_lighting_server.h má nové API
  • void sl_btmesh_update_lightness(uint16_t lehkost, uint32_t zbývající_ms);
• btmesh_event_log má podrobnější možnosti konfigurovatelnosti
• Btmesh_ctl_client's sl_btmesh_ctl_client.h má změnu API místo
  • void sl_btmesh_set_temperature(uint8_t new_color_temperature_percentagE); nové API je
  • void sl_btmesh_ctl_client_set_temperature(uint8_t teplota_procenta); void sl_btmesh_ctl_client_set_lightness(uint8_t lightness_percent);

Doplňky BGAPI:
Byla přidána nová třída BGAPI pro diagnostiku zařízení. Poskytuje aplikaci počítadla statistik Mesh stack a reportování síťového PDU přenosu a proxy serveru založené na událostech, které lze aktivovat a deaktivovat podle potřeby.

Příkazy BGAPI v diagnostické třídě jsou:

• sl_btmesh_diagnostic_init: Inicializujte diagnostickou komponentu
• sl_btmesh_diagnostic_deinit: Deinicializovat diagnostickou komponentu
• sl_btmesh_diagnostic_enable_relay: Povolí hlášení síťového PDU přenosu/proxyingu na základě událostí
• sl_btmesh_diagnostic_disable_relay: Zakáže hlášení založené na událostech síťového PDU přenosu/proxyingu
• sl_btmesh_diagnostic_get_relay: Získejte zatím počet přenášených/proxovaných síťových jednotek PDU
• sl_btmesh_diagnostic_get_statistics: Získejte počítadla statistik zásobníku sítě
• sl_btmesh_diagnostic_clear_statistics: Čítače statistik zásobníku s nulovou sítí

Událost BGAPI v diagnostické třídě je: 

• sl_btmesh_diagnostic_relay: Hlášení události, že síťová PDU byla předána nebo zprostředkována prostřednictvím zásobníku

 Vylepšení

Změněno ve verzi 6.1.0.0

Příkaz diagnostické třídy BGAPI pro načítání statistiky byl změněn tak, aby načítal bloky dat namísto načítání všech dat najednou. Volající by měl poskytnout velikost části, kterou požaduje, spolu s offsetem části ve statistických datech a volání se vrátí s tolika daty, kolik může být poskytnuto s ohledem na omezení požadavku.

Změněno ve verzi 6.0.0.0

• Poskytovatel nebo uzel se nyní může konfigurovat pomocí modelu konfiguračního klienta a své vlastní primární adresy jako cíle pro zprávy. To může nahradit vlastní konfiguraci testovacími příkazy BGAPI.
• Optimalizace kódu může vést k mírně menším obrázkům firmwaru než dříve, v závislosti na použité sadě funkcí.
• Optimalizace kódu může mít za následek o něco menší využití paměti RAM než dříve, v závislosti na použité sadě funkcí.
• Zásobník Mesh již nevyžaduje ani nepodporuje zastaralé komponenty BLE inzerenta a skeneru. Místo toho používá aktuální verze každého z nich (starší inzerent a starší skener pro nerozšířené reklamy a rozšířený inzerent a rozšířený skener pro rozšířené reklamy). Aplikace, které používají BLE i Mesh BGAPI, by již neměly používat zastaralé komponenty BLE inzerenta a skeneru.

Opravené problémy

Opraveno ve verzi 6.1.3.0

Opraveno ve verzi 6.1.2.0 

Opraveno ve verzi 6.1.0.0 

Opraveno ve verzi 6.0.1.0 

Opraveno ve verzi 6.0.0.0 

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

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

Zastaralé položky

Zastaralé ve verzi 6.0.0.0

Příkaz BGAPI sl_btmesh_node_get_networks() byl zastaralý. Místo toho použijte sl_btmesh_node_key_key_count() a sl_btmesh_node_get_key().
Příkazy BGAPI sl_btmesh_test_set_segment_send_delay() a sl_btmesh_test_set_sar_config() byly zastaralé. Místo toho použijte sl_btmesh_sar_config_set_sar_transmitter() a sl_btmesh_sar_config_server_set_sar_receiver().

Odebrané položky

Odstraněno ve verzi 6.0.0.0
Příkazy BGAPI sl_btmesh_test_set_local_config() a sl_btmesh_test_get_local_config() byly odstraněny. Příkazy BGAPI sl_btmesh_node_get_statistics() a sl_btmesh_node_clear_statistics() byly odstraněny.

 Použití 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.

 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 v online příručce Simplicity Studio 5 User's Guide.
Alternativně lze Gecko SDK nainstalovat ručně stažením nebo klonováním nejnovější verze z GitHubu. Vidět https://github.com/Sili-conLabs/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\ \SimplicityStudio\SDKs\gecko_sdk
• MacOS: /Users/ /SimplicityStudio/SDKs/gecko_sdk

 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.

Portfolio IoTwww.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
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ůvodů bezpečnosti nebo spolehlivosti. Takové 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.

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, 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
USAwww.silabs.com

Dokumenty / zdroje

Vývoj softwaru SILICON LABS 6.1.3.0 GA Bluetooth Mesh [pdfUživatelská příručka 6.1.3.0 GA Bluetooth Mesh Software Development, 6.1.3.0 GA, Bluetooth Mesh Software Development, Mesh Software Development, Software Development, Development

Reference

• Uživatelská příručka