SILICON LABS Bluetooth Mesh SDK įterptoji programinė įranga
Gaminio specifikacijos
- Produkto pavadinimas: „Simplicity SDK Suite“.
- Versija: 2024.6.0
- Išleidimo data: 5 m. birželio 2024 d
- „Bluetooth Mesh“ specifikacijos versija: 1.1
Produkto naudojimo instrukcijos
„Bluetooth“ tinklelis yra nauja topologija, skirta „Bluetooth Low Energy“ (LE) įrenginiams, kurie įgalina ryšį iš daugelio su daugeliu (m:m). Jis optimizuotas didelio masto įrenginių tinklams kurti ir idealiai tinka pastatų automatizavimui, jutiklių tinklams ir turto stebėjimui. Mūsų programinė įranga ir SDK „Bluetooth“ kūrimui palaiko „Bluetooth Mesh“ ir „Bluetooth“ funkcijas. Kūrėjai gali pridėti tinklinio tinklo ryšį prie LE įrenginių, tokių kaip prijungti žibintai, namų automatika ir turto sekimo sistemos. Programinė įranga taip pat palaiko „Bluetooth“ signalizaciją, švyturių nuskaitymą ir GATT ryšius, todėl „Bluetooth“ tinklelis gali prisijungti prie išmaniųjų telefonų, planšetinių kompiuterių ir kitų „Bluetooth LE“ įrenginių. Šiame leidime yra funkcijų, kurias palaiko „Bluetooth“ tinklo specifikacijos versija 1.1.
Šios laidos pastabos apima SDK versijas:
7.0.0.0 išleista 5 m. birželio 2024 d
Suderinamumo ir naudojimo pastabos
Norėdami gauti daugiau informacijos apie saugos naujinimus ir pranešimus, žr. su šiuo SDK įdiegtos platformos laidos pastabų saugos skyrių arba „Silicon Labs“ laidos pastabų puslapį. „Silicon Labs“ taip pat primygtinai rekomenduoja užsiprenumeruoti saugos patarimus, kad gautumėte naujausią informaciją. Jei reikia instrukcijų arba jei nesate naujokas Silicon Labs Bluetooth tinklelio SDK, žr. Šio leidimo naudojimas.
Suderinami kompiliatoriai
IAR Embedded Workbench for ARM (IAR-EWARM) versija 9.40.1
- Jei naudosite vyną kuriant naudodami komandų eilutės įrankį IarBuild.exe arba IAR Embedded Workbench GUI sistemoje „MacOS“ arba „Linux“, gali atsirasti klaidų files yra naudojami dėl susidūrimų vyno maišos algoritme generuojant trumpą tekstą file vardai.
- Klientams, naudojantiems „MacOS“ arba „Linux“, patariama nekurti naudojant IAR ne „Simplicity Studio“. Klientai, kurie tai daro, turėtų atidžiai patikrinti, ar tai teisinga files yra naudojami.
GCC (The GNU Compiler Collection) 12.2.1 versija, pateikta su Simplicity Studio.
- GCC nuorodos laiko optimizavimo funkcija buvo išjungta, todėl šiek tiek padidėjo vaizdo dydis.
Nauji daiktai
„Simplicity SDK“ yra įterptosios programinės įrangos kūrimo platforma, skirta daiktų interneto produktams kurti pagal mūsų 2 ir 3 serijos belaidžius ir MCU įrenginius. Jis integruoja belaidžio ryšio protokolų krūvas, tarpinę programinę įrangą, periferines tvarkykles, įkrovos įkroviklį ir taikomąsias programas, pvz.amples – tvirta sistema kuriant energiją optimizuotus ir saugius daiktų interneto įrenginius. Simplicity SDK siūlo galingas funkcijas, tokias kaip ypač mažas energijos suvartojimas, didelis tinklo patikimumas, daugelio mazgų palaikymas ir sudėtingų reikalavimų, pvz., kelių protokolų ir išankstinio sertifikavimo, abstrakcija. Be to, „Silicon Labs“ teikia belaidžio ryšio (OTA) programinę įrangą ir saugos naujinimus, kad nuotoliniu būdu atnaujintų įrenginius, sumažintų priežiūros išlaidas ir pagerintų galutinio vartotojo produkto patirtį. „Simplicity SDK“ yra mūsų populiaraus „Gecko“ SDK tęsinys, kuris ir toliau bus pasiekiamas teikiant ilgalaikį mūsų 0 ir 1 serijos įrenginių palaikymą.
Daugiau informacijos apie 0 ir 1 serijos įrenginius rasite: 0 serijos ir 1 serijos EFM32/EZR32/EFR32 įrenginys (silabs.com).
Naujos funkcijos
Pridėta 7.0.0.0 versijoje
Pridėtas laikrodžių tvarkyklės palaikymas. Stack komponentai nebenaudoja device_init() laikrodžio inicijavimui. Vietoj to, programos projekte dabar turi būti komponentas clock_manager, kuris inicijuoja laikrodį. Pridėtas „Common Memory Manager“ palaikymas.
Naujos API
Pridėta 7.0.0.0 leidime Nėra.
Patobulinimai
- Pridėta mazgo BGAPI klasės komanda sl_btmesh_node_test_identity, skirta mazgo tapatybės reklamos šaltiniams tikrinti.
- Mažos galios mazgo funkcija pridėta prie jutiklio serverio, pvzamples.
- Prie jutiklio serverio kliento pridėta draugo funkcija, pvzample.
Pakeista 7.0.0.0 versijoje
- BGAPI pakeitimai:
Pridėta mazgo BGAPI klasės komanda, sl_btmesh_node_test_identity, siekiant patikrinti, ar gautas mazgo tapatybės skelbimas kilęs iš nurodyto mazgo, ar ne. - Exampprogramos pakeitimai:
Mažos galios mazgo funkcija buvo pridėta prie jutiklio serverio, pvzamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) ir draugo funkcija buvo pridėta prie jutiklio serverio kliento example (btmesh_soc_sen-sor_client).
Išspręstos problemos
Ištaisyta 7.0.0.0 versijoje
- Venkite paleisti reklamos nešiklį, jei mazgas aprūpintas tik PB-GATT.
- Patobulintas rengimo įvykių ataskaitų teikimas perkrautame įrenginyje.
- Patobulintas DFU įvykių ataskaitų teikimas perkrautame įrenginyje.
- Klaidos pranešimas pridėtas, jei mazgo „Blob Transfer“ konfigūracija yra nepakankama DFU platintojo ir autonominio naujinimo priemonės modeliams.
- Ištaisyta pakartojimo išsaugojimo apsauga NVM3 naudojant sl_btmesh_node_power_off() API.
| ID numeris | Aprašymas |
| 356148 | Neleidžiama paleisti reklamos nešiklio, jei mazgas aprūpintas tik PB-GATT. |
| 1250461 | Suteikimo įvykių ataskaitų teikimas tapo patikimesnis perkrautame įrenginyje. |
| 1258654 | DFU įvykių ataskaitų teikimas tapo patikimesnis perkrautame įrenginyje. |
| 1274632 | DFU platintojo ir autonominio atnaujinimo modeliai dabar praneš apie klaidą, jei mazgo „Blob Transfer“ konfigūracijos nepakanka. |
| 1284204 | Ištaisyta NVM3 išsaugojimo apsauga, kai programa naudoja sl_btmesh_node_power_off() API. |
Žinomos problemos dabartiniame leidime
Paryškintu šriftu pažymėtos problemos buvo pridėtos nuo ankstesnio leidimo.
- Nėra BGAPI įvykio dėl segmentuotų pranešimų tvarkymo trikties.
- Galimas NCP eilės užtvindymas su pagrindiniais atnaujinimo būsenos keitimo įvykiais.
- Nedidelis našumo pablogėjimas atliekant kelionės delsos bandymus pirmyn ir atgal, palyginti su 1.5 versija.
- Sujungiamos reklamos atkūrimo problemos, jei visi ryšiai aktyvūs ir naudojamas GATT tarpinis serveris.
- Prastas segmentuotų pranešimų perdavimo per GATT nešėją našumas.
| ID numeris | Aprašymas | Sprendimas |
| 401550 | Nėra BGAPI įvykio dėl segmentuotų pranešimų tvarkymo trikties. | Programa turi nustatyti gedimą iš skirtojo laiko / programos lygmens atsako nebuvimo; pardavėjų modeliams buvo pateikta API. |
| 454059 | KR proceso pabaigoje sugeneruojama daug raktų atnaujinimo būsenos keitimo įvykių, kurie gali užtvindyti NCP eilę. | Padidinkite NCP eilės ilgį projekte. |
| 454061 | Pastebėtas nedidelis veikimo pablogėjimas, palyginti su 1.5 vėlavimo pirmyn ir atgal testuose. | |
| 624514 | Sujungiamos reklamos atkūrimo problema, jei visi ryšiai buvo aktyvūs ir naudojamas GATT tarpinis serveris. | Paskirkite dar vieną ryšį nei reikia. |
| 841360 | Prastas segmentuotų pranešimų perdavimo per GATT nešėją našumas. | Įsitikinkite, kad pagrindinės BLE ryšio ryšio intervalas yra trumpas; užtikrinti, kad ATT MTU būtų pakankamai didelis, kad tilptų pilnas tinklelio PDU; sureguliuokite mažiausią ryšio įvykio ilgį, kad vienam ryšio įvykiui būtų perduodami keli LL paketai. |
| 1121605 | Dėl apvalinimo klaidų suplanuoti įvykiai gali suaktyvėti labai šiek tiek skirtingu laiku, nei tikėtasi. | |
| 1226127 | Prieglobos paslaugų teikėjas, buvęsample gali užstrigti, kai pradeda teikti antrą mazgą. | Prieš sudarydami antrąjį mazgą, iš naujo paleiskite pagrindinio kompiuterio teikimo programą. |
| 1204017 | Platintojas negali tvarkyti lygiagretaus savarankiško FW atnaujinimo ir FW įkėlimo. | Nevykdykite savarankiško FW atnaujinimo ir FW įkėlimo lygiagrečiai. |
| 1301325 | Planuoklio veiksmai netinkamai išsaugomi nuolatinėje saugykloje. | |
| 1305041 | NCP ryšys iš pagrindinio kompiuterio į EFR32 gali pasibaigti. | sl_simple_com_usart.c gali būti redaguojamas, kad būtų ištaisyta skirtojo laiko reikšmė. |
| 1305928 | Nustačius 10 ar daugiau atnaujinimo mazgų kaip DFU imtuvus, SoC platintojo programoje gali nepavykti. |
Nebenaudojami elementai
Nebenaudojama 7.0.0.0 versijoje
BGAPI komanda sl_btmesh_prov_test_identity buvo pasenusi. Vietoj to naudokite sl_btmesh_node_test_identity.
Pašalinti elementai
Pašalinta 7.0.0.0 versijoje
1 serijos aparatinės įrangos (xG12 ir xG13) palaikymas šiame leidime pašalintas.
Naudojant šį leidimą
Šiame leidime yra toliau nurodyta
- Silicon Labs Bluetooth tinklelio kamino biblioteka
- Bluetooth tinklelis sample paraiškas
Jei naudojate pirmą kartą, žr. QSG176: Silicon Labs Bluetooth Mesh SDK v2.x greitos pradžios vadovas.
Įdiegimas ir naudojimas
„Bluetooth“ tinklelio SDK pateikiamas kaip „Silicon Labs“ SDK rinkinio Simplicity SDK (GSDK) dalis. Norėdami greitai pradėti naudotis Simplicity SDK, įdiekite Simplicity Studio 5, kuri nustatys jūsų kūrimo aplinką ir padės įdiegti Simplicity SDK. „Simplicity Studio 5“ apima viską, ko reikia IoT produktų kūrimui naudojant „Silicon Labs“ įrenginius, įskaitant išteklių ir projektų paleidimo priemonę, programinės įrangos konfigūravimo įrankius, visą IDE su GNU įrankių grandine ir analizės įrankius. Diegimo instrukcijos pateikiamos internetiniame Simplicity Studio 5 vartotojo vadove. Arba Simplicity SDK gali būti įdiegtas rankiniu būdu, atsisiunčiant arba klonuojant naujausią versiją iš GitHub. Matyti https://github.com/Sili-conLabs/simplicity_sdk Norėdami gauti daugiau informacijos.
Simplicity Studio pagal numatytuosius nustatymus įdiegia Simplicity SDK:
- „Windows“:
- C:\Vartotojai\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Vartotojai/ /SimplicityStudio/SDKs/simplicity_sdk
SDK versijai būdinga dokumentacija įdiegiama kartu su SDK. Papildomos informacijos dažnai galima rasti žinių bazės straipsniuose (KBA). API nuorodas ir kitą informaciją apie šią ir ankstesnes versijas rasite adresu https://docs.silabs.com/.
Saugumo informacija
| Raktas | Eksportuojamumas mazge | Eksportuojamumas ant Provisioner | Pastabos |
| Tinklo raktas | Eksportuotina | Eksportuotina | Tinklo rakto išvestiniai yra tik RAM, o tinklo raktai saugomi „flash“. |
| Programos raktas | Neeksportuotinas | Eksportuotina | |
| Įrenginio raktas | Neeksportuotinas | Eksportuotina | „Provisioner“ atveju taikoma „Provisionerr“ įrenginio raktui ir kitų įrenginių raktams |
Saugus saugyklos integravimas
Ši dėklo versija yra integruota su „Secure Vault Key Management“. Diegiant „Secure Vault High“ įrenginiuose tinklelio šifravimo raktai yra apsaugoti naudojant „Secure Vault Key Management“ funkciją. Žemiau esančioje lentelėje pateikiami apsaugoti raktai ir jų saugojimo apsaugos charakteristikos.
- Raktai, pažymėti kaip „Neeksportuojami“, gali būti naudojami, bet negali būti viewredaguojama arba bendrinama vykdymo metu.
- Raktus, kurie pažymėti kaip „Eksportuotini“, galima naudoti arba bendrinti vykdymo metu, tačiau jie lieka užšifruoti, kol saugomi „Flash“.
- Norėdami gauti daugiau informacijos apie Secure Vault Key Management funkciją, žr. AN1271: Saugi raktų saugykla.
Saugos patarimai
Norėdami užsiprenumeruoti saugos patarimus, prisijunkite prie „Silicon Labs“ klientų portalo, tada pasirinkite „Paskyros puslapis“. Spustelėkite PAGRINDINIS, kad eitumėte į portalo pagrindinį puslapį, tada spustelėkite plytelę Tvarkyti pranešimus. Įsitikinkite, kad pažymėta parinktis „Programinės įrangos / saugos įspėjamieji pranešimai ir produkto keitimo pranešimai (PCN)“ ir kad esate užsiprenumeravę bent savo platformą ir protokolą. Spustelėkite Išsaugoti, kad išsaugotumėte pakeitimus.
Palaikymas
„Development Kit“ klientai turi teisę į mokymus ir techninę pagalbą. Naudokite Silicon Labs Bluetooth tinklelį web puslapį, kad gautumėte informacijos apie visus „Silicon Labs Bluetooth“ produktus ir paslaugas bei prisiregistruotumėte dėl produktų palaikymo.
Susisiekite su Silicon Laboratories palaikymo tarnyba adresu http://www.silabs.com/support.
Paprastumo studija
Vienu paspaudimu prieiga prie MCU ir belaidžių įrankių, dokumentacijos, programinės įrangos, šaltinio kodo bibliotekų ir kt. Galima Windows, Mac ir Linux!
Atsisakymas
„Silicon Labs“ ketina teikti klientams naujausią, tikslią ir išsamią visų išorinių įrenginių ir modulių dokumentaciją, kurią gali naudoti sistemos ir programinės įrangos diegėjai, naudojantys arba ketinantys naudoti „Silicon Labs“ produktus. Apibūdinimo duomenys, galimi moduliai ir išoriniai įrenginiai, atminties dydžiai ir atminties adresai yra susiję su kiekvienu konkrečiu įrenginiu, o pateikiami „tipiniai“ parametrai įvairiose programose gali skirtis ir skiriasi. Paraiška pvzampčia aprašyti yra tik iliustravimo tikslais. „Silicon Labs“ pasilieka teisę be papildomo įspėjimo keisti čia pateiktą produkto informaciją, specifikacijas ir aprašymus ir nesuteikia garantijų dėl įtrauktos informacijos tikslumo ar išsamumo. Be išankstinio įspėjimo „Silicon Labs“ gali atnaujinti gaminio programinę-aparatinę įrangą gamybos proceso metu saugumo ar patikimumo sumetimais. Tokie pakeitimai nepakeis gaminio specifikacijų ar veikimo. „Silicon Labs“ neprisiima atsakomybės už šiame dokumente pateiktos informacijos naudojimo pasekmes. Šis dokumentas nereiškia ar aiškiai nesuteikia jokios licencijos projektuoti ar gaminti bet kokius integrinius grandynus. Produktai nėra sukurti arba neleidžiami naudoti jokiuose FDA III klasės įrenginiuose, taikomosiose programose, kurioms reikalingas FDA išankstinis patvirtinimas, arba gyvybės palaikymo sistemose be specialaus raštiško Silicon Labs sutikimo. „Gyvybės palaikymo sistema“ yra bet koks gaminys arba sistema, skirta gyvybei ir (arba) sveikatai palaikyti arba palaikyti, o jei tai nepavyks, galima pagrįstai tikėtis rimto asmens sužalojimo arba mirties. „Silicon Labs“ produktai nėra sukurti ar patvirtinti kariniams tikslams. Silicon Labs produktai jokiu būdu negali būti naudojami masinio naikinimo ginkluose, įskaitant (bet tuo neapsiribojant) branduolinius, biologinius ar cheminius ginklus arba raketas, galinčias gabenti tokius ginklus. „Silicon Labs“ atsisako visų tiesioginių ir numanomų garantijų ir nėra atsakinga už jokius sužalojimus ar žalą, susijusią su „Silicon Labs“ produkto naudojimu tokiomis neteisėtomis programomis.
Pastaba: Šiame turinyje gali būti įžeidžiančios terminijos, kuri dabar yra pasenusi. „Silicon Labs“, kur įmanoma, šiuos terminus pakeičia įtraukia kalba. Norėdami gauti daugiau informacijos, apsilankykite www.silabs.com/about-us/inclusive-lexicon-project
Prekės ženklo informacija
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® ir Silicon Labs logotipas®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logotipas ir jų deriniai , „Energiją tausojantys pasaulyje mikrovaldikliai“, Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, The Telegesis Logo®, USBXpress®, Zentri, Zentri logotipas ir Zentri DMS, Z-Wave® ir kiti yra Silicon Labs prekių ženklai arba registruotieji prekių ženklai. ARM, CORTEX, Cortex-M3 ir THUMB yra ARM Holdings prekių ženklai arba registruotieji prekių ženklai. Keil yra registruotasis ARM Limited prekės ženklas. „Wi-Fi“ yra registruotasis „Wi-Fi Alliance“ prekės ženklas. Visi kiti čia paminėti produktai ar prekių pavadinimai yra atitinkamų jų savininkų prekių ženklai.
Dažnai užduodami klausimai (DUK)
K: Kur galiu rasti daugiau informacijos apie saugos naujinimus?
Ats.: Išsamių saugos naujinimų ieškokite Platformos laidos pastabų skyriuje Sauga arba apsilankykite „Silicon Labs“ laidos pastabų puslapyje.
Kl.: Kaip įtraukti clock_manager komponentą laikrodžio inicijavimui?
Ats.: Norėdami įtraukti clock_manager komponentą, skirtą laikrodžio inicijavimui, būtinai atnaujinkite programos projektą pagal vartotojo vadove pateiktas instrukcijas.
„Silicon Laboratories Inc.
400 West Cesar Chavez
Ostinas, TX 78701
JAV
www.silabs.com
IoT portfelis
www.silabs.com/IoT
SW/HW
www.silabs.com/simplicity
Kokybė
www.silabs.com/quality
Palaikymas ir bendruomenė
www.silabs.com/community
Dokumentai / Ištekliai
 |
SILICON LABS Bluetooth Mesh SDK įterptoji programinė įranga [pdfVartotojo vadovas „Bluetooth Mesh SDK“ įterptoji programinė įranga, „Mesh SDK“ įterptoji programinė įranga, SDK įterptoji programinė įranga, įterptoji programinė įranga, programinė įranga |