SILICON LABS Bluetooth SDK Mesh

Mreža Bluetooth je nova topologija, ki je na voljo za naprave Bluetooth Low Energy (LE), ki omogočajo komunikacijo mnogo proti mnogo (m:m). Optimiziran je za ustvarjanje omrežij naprav velikega obsega in je idealen za avtomatizacijo zgradb, senzorska omrežja in sledenje premoženju. Naša programska oprema in SDK za razvoj Bluetooth podpirata funkcijo Bluetooth Mesh in Bluetooth 5.2. Razvijalci lahko napravam LE dodajo mrežno komunikacijo, kot so povezane luči, avtomatizacija doma in sistemi za sledenje sredstvi. Programska oprema podpira tudi signalizacijo Bluetooth, skeniranje svetilnikov in povezave GATT, tako da se mreža Bluetooth lahko poveže s pametnimi telefoni, tablicami in drugimi napravami Bluetooth LE.

Te opombe ob izdaji zajemajo različice SDK:

• 2.1.10.0 izdan 25. oktobra 2023 (podpora za EFR32xG22, revizija D)
• 2.1.9.0 izdan 5. septembra 2023 (samo spremembe osnovne platforme)
• 2.1.8.0 izdan 13. julija 2023 (podpora za EFR32xG21, Revizija C in novejše)
• 2.1.6.0 izdan 29. marca 2023 (podpora za del zgodnjega dostopa)
• 2.1.5.0 izdan 11. januarja 2023 (samo spremembe osnovne platforme)
• 2.1.4.0 izdan 13. oktobra 2021
• 2.1.3.0 izdan 24. septembra 2021 (samo osnovne spremembe Bluetooth)
• 2.1.2.0 izdan 8. septembra 2021
• 2.1.1.0 izdan 21. julija 2021
• 2.1.0.0 izdan 16. junija 2021

Obvestila o združljivosti in uporabi

Za več informacij o varnostnih posodobitvah in obvestilih si oglejte poglavje Varnost v opombah ob izdaji platforme Gecko, nameščenih s tem SDK-jem, ali na strani Silicon Labs Opombe ob izdaji. Silicon Labs prav tako močno priporoča, da se naročite na varnostne nasvete za najnovejše informacije. Za navodila ali če ste novinec v Silicon Labs Bluetooth mesh SDK, glejte Uporaba te izdaje.

Združljivi prevajalniki
IAR Embedded Workbench za ARM (IAR-EWARM) različica 8.50.9

• Uporaba vina za gradnjo s pripomočkom ukazne vrstice IarBuild.exe ali IAR Embedded Workbench GUI v sistemu macOS ali Linux lahko povzroči nepravilno filese uporablja zaradi kolizij v algoritmu zgoščevanja vina za generiranje kratkega file imena.
• Strankam, ki uporabljajo macOS ali Linux, svetujemo, naj ne gradijo z IAR zunaj Simplicity Studio. Stranke, ki to storijo, morajo natančno preveriti, ali je pravilna files se uporabljajo. GCC (zbirka prevajalnika GNU) različica 10.2.0, ki je priložena Simplicity Studio. Funkcija optimizacije časa povezave GCC je bila onemogočena, kar je povzročilo rahlo povečanje velikosti slike

Novi predmeti

Nove funkcije

Dodano v različici 2.1.0.0 Integracija varnega trezorja
Začenši z izdajo 2.1.0.0, Bluetooth Mesh SDK uporablja funkcijo Secure Vault Key Management za shranjevanje mrežnih kriptografskih ključev, ko se uporabljajo naprave Secure Vault High. Integracija Secure Vault je strankam vidna na več načinov na napravah serije 2:

• Spremeni se postavitev podatkov NVM3 za kriptografske ključe in z njimi povezani metapodatki. Ključna funkcija selitve je na voljo za projekte, ki so bili ustvarjeni z različico SDK 2.0 ali starejšo. Enkratno selitev ključa je treba izvesti, ko je vdelana programska oprema v napravi posodobljena.
• Vidnost ključnih podatkov je namerno omejena na običajnih mrežnih vozliščih. Aplikacija na običajnem mrežnem vozlišču ni dovoljena view podatke o ključu aplikacije ali naprave z ukazom sl_btmesh_node_get_key() BGAPI, medtem ko lahko aplikacija na vdelanem vozlišču Provisioner to stori.

Za dodatne informacije o shranjevanju ključev v varnem trezorju glejte AN1271: Varna shramba ključev.

Podpora za prevajalnik
Podprti prevajalniki so bili posodobljeni na GCC različico 10.2.0 in IAR različico 8.50.9.

New Example Aplikacije
HSL Lighting example (Bluetooth Mesh – SoC HSL Light) je bil dodan za predstavitev svetlobnega vozlišča, ki ga je mogoče nadzorovati prek modelov strežnikov HSL. Predstavitve IOP (Bluetooth Mesh – IOP Test – *) so bile dodane za radijske plošče v Pro Development Kits (SLWRB4104A, SLWRB4181A, SLWRB4181B, SLWRB4182A). Predstavitve omogočajo testiranje interoperabilnosti z mobilnimi telefoni. Test zahteva štiri eks-amples, vsak exampdatoteka, ki predstavlja eno od funkcij Mesh: proxy, relay, friend in LPN.

Nove komponente

• Dodana je bila strežniška komponenta HSL.
• Dodana je bila podpora za dinamično bazo podatkov GATT (funkcija Bluetooth LE).

Novi API-ji, dodani v izdaji 2.1.4.0

Funkcija pošiljanja eksplicitnega časovnega statusa sl_btmesh_time_server_status() in ustrezna eksplicitna objavljajoča funkcija sl_btmesh_time_server_publish() sta bili dodani v API modela časovnega strežnika.

Dodano v izdaji 2.1.2.0
Privzeto običajna mrežasta naprava, ki ni ponudnik, ne more izvoziti podatkov varnostnega ključa prek BGAPI. Če je v takšni napravi potreben izvoz ključev, mora uporabiti nov ukaz BGAPI, sl_btmesh_node_set_exportable_keys(), preden se v vozlišču ustvarijo kateri koli ključi. To vključuje ključe, ustvarjene med zagotavljanjem naprave. Dodan je bil diagnostični dogodek, ki obvesti aplikacijo o načrtovani spremembi scene, sl_btmesh_scheduler_server_scene_changed().

Dodano v izdaji 2.1.1.0
Za optimizacijo uporabe vmesnega pomnilnika z modeli scene je bil dodan izbirni API za omogočanje dogodkov priklica stisnjene scene (ref. ID težave 706555). Priporočljiva je uporaba novega API-ja, kadar ima vozlišče veliko modelov ali ko je količina omrežnega prometa, ki naj bi ga vozlišče slišalo, visoka. Če želite aktivirati nov API, uporabite ukaz BGAPI sl_btmesh_scene_server_enable_compact_recall_events(). Nato bo sl_btmesh_evt_scene_server_compact_recall_events signaliziral zahteve za priklic scene. Če želite pridobiti predpomnjena stanja modela po zahtevi za priklic scene, uporabite ukaz sl_btmesh_generic_server_get_cached_state().

Dodano v izdaji 2.1.0.0
Zaradi integracije Secure Vault so se podrobnosti shranjevanja šifrirnih ključev in z njimi povezanih metapodatkov spremenile v napravah serije 2. Zato je bil dodan nov razred BGAPI za selitev šifrirnih ključev in baze podatkov naprav vdelanega ponudnika po posodobitvi vdelane programske opreme na napravah serije 2. Ima naslednje ukaze:

• sl_btmesh_migration_migrate_keys
• sl_btmesh_migration_migrate_ddb

Izboljšave

Spremenjeni API-ji

Spremenjeno v izdaji 2.1.2.0
Parameter časovnega pasu v sl_btmesh_time_server_get_datetime() je bil popravljen tako, da je predpisano 16-bitno celo število. Parameter natančnosti ure, sl_btmesh_lpn_clock_accuracy, je bil dodan konfiguraciji LPN. Ta parameter je mogoče uporabiti za nastavitev vedenja mirovanja LPN, ko bi zaradi premika ure na napravi sicer LPN zamudil časovno omejitev ankete.

Spremenjeno v izdaji 2.1.1.0
Dogodek sl_btmesh_evt_friend_friendship_terminated bo zdaj ustvarjen, ko konfiguracijski odjemalec onemogoči funkcijo prijatelja vozlišča, ko je prijateljstvo aktivno. Prej je bila prekinitev prijateljstva v tej situaciji implicitno nakazana z dogodkom sl_btmesh_evt_node_config_set. (Ref. ID izdaje 627811)

Spremenjeno v izdaji 2.1.0.0
Naslednji ukazi BGAPI v razredu prov se zdaj vrnejo po potrditvi parametrov, dejanska zahtevana operacija pa se izvede po podanem odgovoru BGAPI. Dokončanje zahtevane operacije signalizira ustrezen dogodek BGAPI:

• sl_btmesh_prov_add_ddb_entry() – zaključek dodajanja signalizira sl_btmesh_evt_prov_add_ddb_entry_complete
• sl_btmesh_prov_delete_ddb_entry() – zaključek brisanja signalizira sl_btmesh_evt_prov_delete_ddb_entry_complete Naslednji ukaz BGAPI v razredu prov ima dodaten dogodek, ki se lahko ustvari po njegovem klicu:
• sl_btmesh_prov_init – poleg sl_btmesh_evt_prov_initialized se lahko generira sl_btmesh_evt_prov_initialization_failed. Generičnemu modelu odjemalca BGAPI je bil dodan ukaz BGAPI:

mesh_generic_client_init_hsl()
Generičnemu modelu strežnika BGAPI je bil dodan ukaz BGAPI:

mesh_generic_server_init_hsl()

Odpravljene težave

Popravljeno v izdaji 2.1.4.0

ID št	Opis
729116	Odpravljena težava z nenamernim množenjem modela časovnega strežnika pri dodajanju novih elementov v projekt
735569	Popravljeno ravnanje s segmentiranimi multicast sporočili, ki jih prijateljsko vozlišče dostavlja vozlišču z nizko porabo energije

Popravljeno v izdaji 2.1.2.0 

ID št	Opis
627811	Ustvarite dogodek prekinitve prijateljstva, ko je prekinitev zahtevana lokalno
676798	Upoštevajte netočnost ure pri času bujenja ankete LPN
683518	Ustvari dogodek prekinitve prijateljstva takoj ob prejemu sporočila Friend Clear
703974	Odpravljena težava s kvalifikacijskim preizkusom s srčnimi utripi
709948	Zagotovil je API za nadzor možnosti izvoza varnostnih ključev v mrežnem vozlišču
724511	Odpravljena je težava z registracijo kod dobavitelja prek 0x1F
730273	Odpravljena težava z obravnavanjem negativnega odmika časovnega pasu
731713	Odpravljeno morebitno uhajanje pomnilnika s pošiljanjem segmentiranih sporočil, ko napravi primanjkuje pomnilnika
734034	Popravljena komunikacija prijatelj-LPN, ko je TTL enak nič
734858	Odpravljena morebitna težava s spremenljivko sklada pri ravnanju s strukturo PSA
736054	Odpravljena je težava s preizkusom kvalifikacij z vezavo ključa modela in aplikacije

Popravljeno v izdaji 2.1.1.0 

ID št	Opis
692961	Odpravljeno je bilo, da je vozlišče postalo neodzivno, ko so bili omogočeni relejski ponovni prenosi, ko je bilo pod veliko obremenitvijo
713152	Odpravljena je težava, pri kateri je omejena natančnost izračuna povzročila napake pri zaokroževanju pri povezovanju med Light Lightness Actual in Light Lightness Linear

Popravljeno v izdaji 2.1.0.0 

ID št	Opis
3878	Aplikacija mora prezreti dogodke GATT za značilnosti mreže
342521	Matematična knjižnica ne poveča velikosti slike po nepotrebnem
358019	Popravljena koda rezultata, podana, ko je zahtevana objava modela s poverilnicami prijateljstva, vendar prijateljstvo ni podprto
404070	Popravljena koda rezultata, ki je podana, ko je ukaz oskrbnika za ustvarjanje omrežnega ključa poklican na napravi brez oskrbe
454332	LE GAP API je treba uporabiti za oglaševanje lokalnega imena naprave
464907	Odstranjen je nepotreben dogodek BGAPI 'začetek srčnega utripa', ko konfiguracijski odjemalec onemogoči srčni utrip na vozlišču
653405	Že pripravljeno stikalo samptrenutna poraba aplikacije je zdaj na pričakovani ravni
654477	DCD je pravilno dekodiral Network Analyzer
660048	Komponenta Button Press UC ne zahteva komponente IO Stream po nepotrebnem
687105	Ukazi BT Mesh delujejo z NCP Target example in poveljnik NCP
690803	Popravljeni podvojeni ID-ji modela prodajalca v generatorju kode
690862	SoC prazen example zdaj začne svetiti na strojni opremi xG22
707497	Popravljena dodelitev kriptografskega konteksta PSA
707524	Odpravljena je regresija s časovnikom za varovanje okrevanja IV, ki ni dovoljeval prehitrega okrevanja

ID št	Opis
710381	Popravljeno ravnanje s privzetim stanjem osvetlitve, ko je bil za ustrezen model nastavljen obseg, ki ni privzet
711359	Popravljeno preverjanje parametrov za klic BGAPI za ustvarjanje seje za zagotavljanje

Znane težave v trenutni izdaji

Težave s krepkim tiskom so bile dodane od prejšnje izdaje.

ID št	Opis	Rešitev
401550	Ni dogodka BGAPI za napako pri obravnavanju segmentiranih sporočil	Aplikacija mora razbrati napako iz časovne omejitve/pomanjkanja odziva aplikacijske plasti
418636	Težave z API-jem stanja lokalne konfiguracije mesh_test (identiteta vozlišča, rele, ponovni prenos omrežja)
454059	Veliko število ključnih dogodkov spremembe stanja osveževanja se ustvari na koncu procesa KR, kar lahko preplavi čakalno vrsto NCP	Povečajte dolžino čakalne vrste NCP v projektu
454061	Opaženo je bilo rahlo poslabšanje zmogljivosti v primerjavi z 1.5 pri povratnih zakasnitvenih testih
624514	Težava pri ponovnem vzpostavljanju povezljivega oglaševanja, če so bile vse povezave aktivne in je v uporabi proxy GATT	Dodelite še eno povezavo več, kot je potrebno
650825	Težava s ponovnim pošiljanjem, ko se model občasno objavlja	Nastavite ponovne prenose v stanju modela in sprožite periodično objavljanje s časovnikom aplikacije

Zastareli predmeti

Naslednji ukaz BGAPI v razredu vozlišča je bil opuščen: sl_btmesh_node_erase_mesh_nvm() – namesto tega uporabite sl_btmesh_node_reset().

Odstranjeni predmeti

• Noben

Uporaba te izdaje

Ta izdaja vsebuje naslednje

• Silicon Labs Bluetooth mesh stack knjižnica
• Bluetooth sample aplikacije

Če ste prvi uporabnik, glejte QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick Start Guide.

Namestitev in uporaba
Za prenos Silicon Labs Bluetooth SDK je potreben registriran račun pri Silicon Labs. Registrirate se lahko na https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short. Navodila za namestitev sklada so zajeta v QSG176: Vodnik za hiter začetek Silicon Labs Bluetooth Mesh SDK v2.x. Uporabite Bluetooth mesh SDK z razvojno platformo Silicon Labs Simplicity Studio V4. Simplicity Studio zagotavlja pravilno upravljanje večine združljivosti programske opreme in orodij. Namestite posodobitve programske opreme in vdelane programske opreme plošče takoj, ko ste obveščeni. Dokumentacija, specifična za različico SDK, je nameščena s SDK. Dodatne informacije je pogosto mogoče najti v člankih baze znanja (KBA). Reference API-jev in druge informacije o tej in prejšnjih izdajah so na voljo na https://docs.silabs.com/.

Varnostne informacije Integracija varnega trezorja
Ta različica sklada je integrirana z upravljanjem ključev Secure Vault. Ko so uvedeni v naprave Secure Vault High, so šifrirni ključi mreže zaščiteni s funkcijo upravljanja ključev Secure Vault. Spodnja tabela prikazuje zaščitene ključe in njihove značilnosti zaščite shranjevanja.

Ključ	Izvoznost na vozlišču	Izvoz na Provisioner	Opombe
Omrežni ključ	Izvozno	Izvozno	Izpeljave omrežnega ključa obstajajo samo v RAM-u, medtem ko so omrežni ključi shranjeni na flash
Ključ aplikacije	Neizvozno	Izvozno
Ključ naprave	Neizvozno	Izvozno	V primeru Provisionerja velja za ključ naprave Provisionerr-ja in tudi za ključe drugih naprav

Ključe, ki so označeni kot »neizvozni«, je mogoče uporabiti, vendar ne viewed ali v skupni rabi med izvajanjem. Ključe, ki so označeni kot »Izvozni«, je mogoče uporabiti ali dati v skupno rabo med izvajanjem, vendar ostanejo šifrirani, medtem ko so shranjeni v flash. Za več informacij o funkciji Secure Vault Key Management glejte AN1271: Secure Key Storage

Varnostni nasveti
Če se želite naročiti na varnostne nasvete, se prijavite na portal za stranke Silicon Labs in izberite Domov računa. Kliknite DOMOV, da odprete domačo stran portala, in nato kliknite ploščico Upravljanje obvestil. Prepričajte se, da je označena možnost »Obvestila o programski opremi/varnosti in obvestila o spremembah izdelkov (PCN)« in da ste naročeni vsaj na svojo platformo in protokol. Kliknite Shrani, da shranite morebitne spremembe.

Podpora
Stranke razvojnega kompleta so upravičene do usposabljanja in tehnične podpore. Uporabite Bluetooth mrežo Silicon Labs web strani za pridobitev informacij o vseh izdelkih in storitvah Bluetooth podjetja Silicon Labs ter za prijavo na podporo za izdelek. Obrnite se na podporo Silicon Laboratories na http://www.silabs.com/support.

Studio preprostosti
Dostop z enim klikom do MCU in brezžičnih orodij, dokumentacije, programske opreme, knjižnic izvorne kode in več. Na voljo za Windows, Mac in Linux!

• Portfelj interneta stvari
  • www.silabs.com/IoT
• SW/HW
  • www.silabs.com/simplicity
• Kakovost
  • www.silabs.com/kakovost
• Podpora in skupnost
  • www.silabs.com/skupnost

Zavrnitev odgovornosti
Silicon Labs namerava strankam zagotoviti najnovejšo, natančno in poglobljeno dokumentacijo o vseh zunanjih napravah in modulih, ki so na voljo izvajalcem sistemov in programske opreme, ki uporabljajo ali nameravajo uporabljati izdelke Silicon Labs. Podatki o značilnostih, razpoložljivi moduli in zunanje naprave, velikosti pomnilnika in pomnilniški naslovi se nanašajo na vsako specifično napravo, navedeni »tipični« parametri pa se lahko razlikujejo in se razlikujejo v različnih aplikacijah. Aplikacija npramptukaj opisane informacije so samo za ilustracijo. Silicon Labs si pridržuje pravico do sprememb informacij o izdelku, specifikacij in opisov brez nadaljnjega obvestila in ne daje jamstev glede točnosti ali popolnosti vključenih informacij. Brez predhodnega obvestila lahko Silicon Labs posodobi vdelano programsko opremo izdelka med proizvodnim procesom zaradi varnosti ali zanesljivosti. Takšne spremembe ne bodo spremenile specifikacij ali delovanja izdelka. Silicon Labs ne odgovarja za posledice uporabe informacij v tem dokumentu. Ta dokument ne pomeni ali izrecno podeljuje nobene licence za načrtovanje ali izdelavo integriranih vezij. Izdelki niso zasnovani ali odobreni za uporabo v nobeni napravi FDA razreda III, aplikacijah, za katere je potrebna predprodajna odobritev FDA, ali sistemih za vzdrževanje življenja brez posebnega pisnega soglasja Silicon Labs. »Sistem za vzdrževanje življenja« je kateri koli izdelek ali sistem, namenjen podpiranju ali vzdrževanju življenja in/ali zdravja, za katerega se lahko razumno pričakuje, da bo v primeru okvare povzročil resne telesne poškodbe ali smrt. Izdelki Silicon Labs niso zasnovani ali odobreni za vojaške namene. Izdelki Silicon Labs se v nobenem primeru ne smejo uporabljati v orožju za množično uničevanje, vključno z (vendar ne omejeno na) jedrskim, biološkim ali kemičnim orožjem ali raketami, ki lahko izstrelijo takšno orožje. Silicon Labs zavrača vsa izrecna in implicitna jamstva in ne prevzema odgovornosti za kakršne koli poškodbe ali škodo, povezano z uporabo izdelka Silicon Labs v takih nepooblaščenih aplikacijah.

Opomba: Ta vsebina lahko vsebuje žaljivo terminologijo, ki je zdaj zastarela. Silicon Labs te izraze nadomešča z vključujočim jezikom, kjer je to mogoče. Za več informacij obiščite www.silabs.com/about-us/inclusive-lexicon-project

Informacije o blagovni znamki
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® in logotip Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, logotip Energy Micro in njihove kombinacije , »energetsko najbolj prijazni mikrokontrolerji na svetu«, Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, logotip Zentri in Zentri DMS, Z-Wave® in druge so blagovne znamke ali registrirane blagovne znamke družbe Silicon Labs. ARM, CORTEX, Cortex-M3 in THUMB so blagovne znamke ali registrirane blagovne znamke družbe ARM Holdings. Keil je registrirana blagovna znamka ARM Limited. Wi-Fi je registrirana blagovna znamka združenja Wi-Fi Alliance. Vsi ostali izdelki ali imena blagovnih znamk, omenjena tukaj, so blagovne znamke njihovih imetnikov.

Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 ZDA

• www.silabs.com

Dokumenti / Viri

SILICON LABS Bluetooth SDK Mesh [pdfNavodila Bluetooth SDK Mesh, SDK Mesh, Mesh

Reference

• Uporabniški priročnik