Vstavaný softvér SILICON LABS Bluetooth Mesh SDK

Špecifikácie produktu

• Názov produktu: Simplicity SDK Suite
• Verzia: 2024.6.0
• Dátum vydania: 5. júna 2024
• Verzia špecifikácie Bluetooth Mesh: 1.1

Návod na použitie produktu

Bluetooth mesh je nová topológia dostupná pre zariadenia Bluetooth Low Energy (LE), ktorá umožňuje komunikáciu medzi mnohými (m:m). Je optimalizovaný na vytváranie rozsiahlych sietí zariadení a ideálne sa hodí na automatizáciu budov, senzorové siete a sledovanie majetku. Náš softvér a SDK pre vývoj Bluetooth podporujú funkcie Bluetooth Mesh a Bluetooth. Vývojári môžu pridať sieťovú sieťovú komunikáciu do zariadení LE, ako sú pripojené svetlá, domáca automatizácia a systémy sledovania majetku. Softvér tiež podporuje signalizáciu Bluetooth, skenovanie majákov a pripojenia GATT, takže sieť Bluetooth sa môže pripojiť k smartfónom, tabletom a iným zariadeniam Bluetooth LE. Toto vydanie obsahuje funkcie podporované špecifikáciou Bluetooth mesh verzie 1.1.

Tieto poznámky k vydaniu pokrývajú verzie súpravy SDK:
7.0.0.0 vydaná 5. júna 2024

Oznámenia o kompatibilite a používaní
Ďalšie informácie o aktualizáciách zabezpečenia a upozorneniach nájdete v kapitole Zabezpečenie v poznámkach k vydaniu platformy nainštalovanej s touto súpravou SDK alebo na stránke Poznámky k vydaniu Silicon Labs. Spoločnosť Silicon Labs tiež dôrazne odporúča, aby ste sa prihlásili na odber bezpečnostných rád pre aktuálne informácie. Pokyny alebo ak ste novým používateľom Silicon Labs Bluetooth mesh SDK, pozrite si tému Používanie tohto vydania.

Kompatibilné kompilátory
IAR Embedded Workbench pre ARM (IAR-EWARM) verzia 9.40.1

• Použitie vína na zostavenie pomocou nástroja príkazového riadka IarBuild.exe alebo grafického používateľského rozhrania IAR Embedded Workbench v systéme MacOS alebo Linux môže viesť k nesprávnemu files sa používa v dôsledku kolízií v hašovacom algoritme vína na generovanie skratiek file mená.
• Zákazníkom so systémom macOS alebo Linux sa neodporúča zostavovať pomocou IAR mimo Simplicity Studio. Zákazníci, ktorí to robia, by si mali starostlivo overiť, či je to správne files sa používajú.

GCC (The GNU Compiler Collection) verzia 12.2.1, dodávaná so Simplicity Studio.

• Funkcia optimalizácie času prepojenia GCC bola zakázaná, čo malo za následok mierne zvýšenie veľkosti obrázka.

Nové položky
Simplicity SDK je vstavaná platforma na vývoj softvéru na vytváranie produktov internetu vecí založených na našich bezdrôtových zariadeniach a zariadeniach MCU Series 2 a Series 3. Integruje zásobníky bezdrôtových protokolov, middleware, ovládače periférnych zariadení, bootloader a aplikácie napramples – solídny rámec pre budovanie energeticky optimalizovaných a bezpečných zariadení internetu vecí. Simplicity SDK ponúka výkonné funkcie, ako je ultra nízka spotreba energie, vysoká spoľahlivosť siete, podpora veľkého počtu uzlov a abstrakcia zložitých požiadaviek, ako je multiprotokol a predbežná certifikácia. Okrem toho Silicon Labs poskytuje softvér OTA (over-the-air) a bezpečnostné aktualizácie na vzdialenú aktualizáciu zariadení, minimalizáciu nákladov na údržbu a zlepšenie skúseností s produktmi koncových používateľov. Simplicity SDK je pokračovaním našej populárnej súpravy Gecko SDK, ktorá bude naďalej dostupná a poskytuje dlhodobú podporu pre naše zariadenia série 0 a série 1.

Ďalšie informácie o zariadeniach série 0 a série 1 nájdete na: Zariadenie série 0 a série 1 EFM32/EZR32/EFR32 (silabs.com).

Nové funkcie

Pridané vo verzii 7.0.0.0
Bola pridaná podpora pre Clock Manager. Komponenty zásobníka už nepoužívajú device_init() na inicializáciu hodín. Namiesto toho musí projekt aplikácie teraz obsahovať komponent clock_manager, ktorý inicializuje hodiny. Bola pridaná podpora pre Common Memory Manager.

Nové API
Pridané vo verzii 7.0.0.0 Žiadne.

Vylepšenia

• Bol pridaný príkaz triedy BGAPI uzla sl_btmesh_node_test_identity na kontrolu zdrojov reklamy na identitu uzla.
• Funkcia Low Power Node pridaná na server Sensor napramples.
• Funkcia priateľ pridaná do klienta servera senzorov naprample.

Zmenené vo verzii 7.0.0.0

• Zmeny BGAPI:
  Bol pridaný príkaz triedy BGAPI uzla sl_btmesh_node_test_identity na kontrolu, či prijatá reklama na identitu uzla pochádza z daného uzla alebo nie.
• Exampzmeny aplikácie:
  Funkcia Low Power Node bola pridaná na server Sensor examples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) a funkcia Friend bola pridaná do klienta senzorového servera example (btmesh_soc_sen-sor_client).

Opravené problémy
Opravené vo verzii 7.0.0.0

• Vyhnite sa spúšťaniu nosiča reklamy, ak sa uzol poskytuje iba pomocou PB-GATT.
• Vylepšené hlásenie udalostí poskytovania na preťaženom zariadení.
• Vylepšené hlásenie udalostí DFU na preťaženom zariadení.
• Hlásenie chýb bolo pridané, ak konfigurácia Blob Transfer v uzle nie je dostatočná pre modely DFU Distributor a Standalone Updater.
• Opravená ochrana ukladania opakovaného prehrávania do NVM3 pri použití sl_btmesh_node_power_off() API.

ID #	Popis
356148	Zabráni spusteniu reklamného nosiča, ak sa uzol poskytuje iba pomocou PB-GATT.
1250461	Robustnejšie hlásenie udalostí poskytovania na preťaženom zariadení.
1258654	Robustnejšie hlásenie udalostí DFU na preťaženom zariadení.
1274632	Modely DFU Distributor a Standalone Updater budú teraz hlásiť chybu, ak konfigurácia Blob Transfer v uzle nie je dostatočná.
1284204	Opravená ochrana pri ukladaní opakovaného prehrávania do NVM3, keď aplikácia používa sl_btmesh_node_power_off() API.

Známe problémy v aktuálnom vydaní
Problémy označené tučným písmom boli pridané od predchádzajúceho vydania.

• Žiadna udalosť BGAPI pre zlyhanie spracovania segmentovaných správ.
• Potenciálne zaplavenie frontu NCP udalosťami zmeny stavu obnovenia kľúča.
• Mierne zníženie výkonu v testoch okružnej latencie v porovnaní s verziou 1.5.
• Problémy s opätovným vytvorením pripojiteľnej reklamy, ak sú všetky pripojenia aktívne a používa sa proxy GATT.
• Slabý výkon prenosu segmentovaných správ cez GATT nosič.

ID #	Popis	Alternatívne riešenie
401550	Žiadna udalosť BGAPI pre zlyhanie spracovania segmentovaných správ.	Aplikácia musí odvodiť zlyhanie z časového limitu / nedostatočnej odozvy aplikačnej vrstvy; pre modely dodávateľov bolo poskytnuté API.
454059	Na konci procesu KR sa generuje veľký počet udalostí zmeny stavu obnovenia kľúča, čo môže zahltiť front NCP.	Zvýšte dĺžku frontu NCP v projekte.
454061	Pozorovala sa mierna degradácia výkonu v porovnaní s 1.5 v testoch okružnej latencie.
624514	Problém s opätovným vytvorením pripojiteľnej reklamy, ak boli všetky pripojenia aktívne a používa sa proxy server GATT.	Prideľte o jedno pripojenie viac, ako je potrebné.
841360	Slabý výkon prenosu segmentovaných správ cez GATT nosič.	Uistite sa, že interval pripojenia základného pripojenia BLE je krátky; uistite sa, že ATT MTU je dostatočne veľká na to, aby sa do nej zmestila plná sieťová jednotka PDU; vylaďte minimálnu dĺžku udalosti pripojenia, aby ste umožnili prenos viacerých paketov LL na udalosť pripojenia.
1121605	Chyby zaokrúhľovania môžu spôsobiť spustenie naplánovaných udalostí vo veľmi mierne odlišných časoch, než sa očakávalo.
1226127	Poskytovateľ hostiteľa example sa môže zaseknúť, keď začne poskytovať druhý uzol.	Pred poskytnutím druhého uzla reštartujte aplikáciu poskytovateľa hostiteľa.
1204017	Distribútor nie je schopný spracovať paralelnú vlastnú aktualizáciu FW a nahrávanie FW.	Nespúšťajte súbežne vlastnú aktualizáciu FW a nahrávanie FW.
1301325	Akcie plánovača nie sú správne uložené do trvalého úložiska.
1305041	Komunikácia NCP z hostiteľa do EFR32 môže uplynúť.	sl_simple_com_usart.c možno upraviť, aby sa opravila hodnota časového limitu.
1305928	Nastavenie 10 alebo viacerých aktualizačných uzlov ako prijímačov DFU môže zlyhať v aplikácii distribútora SoC.

Zastarané položky
Zastarané vo verzii 7.0.0.0
Príkaz BGAPI sl_btmesh_prov_test_identity bol zastaraný. Namiesto toho použite sl_btmesh_node_test_identity.

Odstránené položky
Odstránené vo verzii 7.0.0.0
Podpora pre hardvér série 1 (xG12 a xG13) bola v tomto vydaní odstránená.

Používanie tohto vydania
Toto vydanie obsahuje nasledujúce

• Silicon Labs Bluetooth mesh stack knižnica
• Bluetooth mesh sampaplikácie

Ak ste prvým používateľom, pozrite si QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Sprievodca rýchlym spustením.

Inštalácia a používanie
Bluetooth mesh SDK sa poskytuje ako súčasť Simplicity SDK (GSDK), sady SDK Silicon Labs. Ak chcete rýchlo začať so súpravou Simplicity SDK, nainštalujte si Simplicity Studio 5, ktorá nastaví vaše vývojové prostredie a prevedie vás inštaláciou súpravy Simplicity SDK. Simplicity Studio 5 obsahuje všetko potrebné pre vývoj produktov internetu vecí so zariadeniami Silicon Labs, vrátane spúšťača zdrojov a projektov, nástrojov na konfiguráciu softvéru, úplného IDE s GNU toolchain a analytických nástrojov. Pokyny na inštaláciu sú uvedené v online používateľskej príručke Simplicity Studio 5. Alternatívne je možné Simplicity SDK nainštalovať manuálne stiahnutím alebo naklonovaním najnovšej verzie z GitHub. Pozri https://github.com/Sili-conLabs/simplicity_sdk pre viac informácií.

Simplicity Studio predvolene nainštaluje Simplicity SDK v:

• Windows:
  • C:\Používatelia\ \SimplicityStudio\SDK\simplicity_sdk
• MacOS: /Používatelia/ /SimplicityStudio/SDKs/simplicity_sdk
  Dokumentácia špecifická pre verziu SDK je nainštalovaná so súpravou SDK. Ďalšie informácie možno často nájsť v článkoch databázy znalostí (KBA). Referencie API a ďalšie informácie o tomto a starších vydaniach sú dostupné na https://docs.silabs.com/.

Bezpečnostné informácie

kľúč	Exportovateľnosť na uzle	Exportovateľnosť na poskytovateľovi	Poznámky
Sieťový kľúč	Exportovateľné	Exportovateľné	Odvodenia sieťového kľúča existujú iba v RAM, zatiaľ čo sieťové kľúče sú uložené na flash
Aplikačný kľúč	Neexportovateľné	Exportovateľné
Kľúč zariadenia	Neexportovateľné	Exportovateľné	V prípade poskytovateľa sa použije na kľúč vlastného zariadenia poskytovateľa, ako aj na kľúče iných zariadení

Bezpečná integrácia Vault
Táto verzia zásobníka je integrovaná so správou kľúčov Secure Vault. Pri nasadení do zariadení Secure Vault High sú sieťové šifrovacie kľúče chránené pomocou funkcie Secure Vault Key Management. Nižšie uvedená tabuľka zobrazuje chránené kľúče a ich charakteristiky ochrany uloženia.

• Kľúče, ktoré sú označené ako „Neexportovateľné“, sa dajú použiť, ale nie viewed alebo zdieľané za behu.
• Kľúče, ktoré sú označené ako „Exportovateľné“, je možné používať alebo zdieľať za behu, ale zostávajú zašifrované, kým sú uložené vo formáte Flash.
• Ďalšie informácie o funkcii správy kľúčov Secure Vault nájdete pozri AN1271: Bezpečné úložisko kľúčov.

Bezpečnostné rady
Ak sa chcete prihlásiť na odber bezpečnostných rád, prihláste sa na zákaznícky portál Silicon Labs a vyberte Domovská stránka účtu. Kliknutím na DOMOV prejdite na domovskú stránku portálu a potom kliknite na dlaždicu Spravovať upozornenia. Uistite sa, že je začiarknuté 'Software/Security Advisory Notices & Product Change Notices (PCN)' a že ste prihlásení na odber minimálne pre svoju platformu a protokol. Kliknutím na tlačidlo Uložiť uložte všetky zmeny.

Podpora
Zákazníci súpravy Development Kit majú nárok na školenie a technickú podporu. Použite sieť Silicon Labs Bluetooth web stránku, kde získate informácie o všetkých produktoch a službách Bluetooth spoločnosti Silicon Labs a prihlásite sa na podporu produktu.
Kontaktujte podporu Silicon Laboratories na adrese http://www.silabs.com/support.

Štúdio jednoduchosti
Prístup jedným kliknutím k MCU a bezdrôtovým nástrojom, dokumentácii, softvéru, knižniciam zdrojových kódov a ďalším. K dispozícii pre Windows, Mac a Linux!

Vylúčenie zodpovednosti
Silicon Labs má v úmysle poskytnúť zákazníkom najnovšiu, presnú a hĺbkovú dokumentáciu všetkých periférnych zariadení a modulov dostupných pre implementátorov systémov a softvéru, ktorí používajú alebo plánujú používať produkty Silicon Labs. Charakterizačné údaje, dostupné moduly a periférie, veľkosti pamäte a adresy pamäte sa vzťahujú na každé konkrétne zariadenie a poskytnuté „typické“ parametre sa môžu v rôznych aplikáciách líšiť. Aplikácia napramptu popísané sú len ilustračné. Silicon Labs si vyhradzuje právo na zmeny bez ďalšieho upozornenia v informáciách o produkte, špecifikáciách a popisoch tu uvedených a neposkytuje záruky na presnosť alebo úplnosť zahrnutých informácií. Bez predchádzajúceho upozornenia môže spoločnosť Silicon Labs aktualizovať firmvér produktu počas výrobného procesu z dôvodov bezpečnosti alebo spoľahlivosti. Takéto zmeny nezmenia špecifikácie ani výkon produktu. Spoločnosť Silicon Labs nenesie žiadnu zodpovednosť za následky použitia informácií uvedených v tomto dokumente. Tento dokument nenaznačuje ani výslovne neudeľuje žiadnu licenciu na navrhovanie alebo výrobu akýchkoľvek integrovaných obvodov. Produkty nie sú navrhnuté ani autorizované na použitie v zariadeniach FDA triedy III, v aplikáciách, pre ktoré sa vyžaduje schválenie FDA pred uvedením na trh, alebo v systémoch na podporu života bez osobitného písomného súhlasu Silicon Labs. „Systém na podporu života“ je akýkoľvek produkt alebo systém určený na podporu alebo udržanie života a/alebo zdravia, pri ktorom v prípade zlyhania možno odôvodnene očakávať, že povedie k vážnemu zraneniu alebo smrti. Produkty Silicon Labs nie sú navrhnuté ani autorizované pre vojenské aplikácie. Produkty Silicon Labs sa za žiadnych okolností nesmú používať v zbraniach hromadného ničenia vrátane (okrem iného) jadrových, biologických alebo chemických zbraní alebo rakiet schopných niesť takéto zbrane. Silicon Labs sa zrieka všetkých výslovných a implicitných záruk a nezodpovedá ani neručí za žiadne zranenia alebo škody súvisiace s používaním produktu Silicon Labs v takýchto neautorizovaných aplikáciách.

Poznámka: Tento obsah môže obsahovať urážlivú terminológiu, ktorá je už zastaraná. Silicon Labs nahrádza tieto výrazy inkluzívnym jazykom všade, kde je to možné. Pre viac informácií navštívte www.silabs.com/about-us/inclusive-lexicon-project

Informácie o ochrannej známke
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 ich kombinácie , „najúspornejšie mikrokontroléry na svete“, 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 ďalšie sú ochranné známky alebo registrované ochranné známky spoločnosti Silicon Labs. ARM, CORTEX, Cortex-M3 a THUMB sú ochranné známky alebo registrované ochranné známky spoločnosti ARM Holdings. Keil je registrovaná ochranná známka spoločnosti ARM Limited. Wi-Fi je registrovaná ochranná známka Wi-Fi Alliance. Všetky ostatné produkty alebo názvy značiek uvedené v tomto dokumente sú ochrannými známkami ich príslušných vlastníkov.

Často kladené otázky (FAQ)

Otázka: Kde nájdem ďalšie informácie o aktualizáciách zabezpečenia?
Odpoveď: Pozrite si kapitolu Zabezpečenie v poznámkach k vydaniu platformy alebo navštívte stránku s poznámkami k vydaniu Silicon Labs, kde nájdete podrobné aktualizácie zabezpečenia.

Otázka: Ako začlením komponent clock_manager na inicializáciu hodín?
Odpoveď: Ak chcete zahrnúť komponent clock_manager na inicializáciu hodín, nezabudnite aktualizovať projekt vašej aplikácie podľa poskytnutých pokynov v používateľskej príručke.

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

Portfólio internetu vecí
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Kvalita
www.silabs.com/quality

Podpora a komunita
www.silabs.com/community

Dokumenty / zdroje

Vstavaný softvér SILICON LABS Bluetooth Mesh SDK [pdf] Používateľská príručka Bluetooth Mesh SDK Embedded Software, Mesh SDK Embedded Software, SDK Embedded Software, Embedded Software, Software

Referencie

• Používateľská príručka