Handbók eiganda SILICON LABS Bluetooth Mesh SDK

Upplýsingar um vöru
Simplicity SDK Suite inniheldur eiginleika sem Bluetooth Mesh forskriftin, útgáfa 1.1, styður. Hún býður upp á vettvang til að þróa forrit með Bluetooth Mesh tækni.

Notkunarleiðbeiningar fyrir vöru

Bluetooth Mesh er ný netkerfi sem er í boði fyrir Bluetooth Low Energy (LE) tæki sem gerir kleift að hafa marga-til-marga (m:m) samskipti. Það er fínstillt til að búa til stórfelld tækjanet og hentar sérstaklega vel fyrir sjálfvirkni bygginga, skynjaranet og eignarakningar. Hugbúnaður okkar og SDK fyrir Bluetooth þróun styðja Bluetooth Mesh og Bluetooth virkni. Forritarar geta bætt við möskva netsamskiptum við LE tæki eins og tengd ljós, sjálfvirkni heimilisins og eignarakningarkerfi. Hugbúnaðurinn styður Bluetooth beaconing, beacon skönnun og GATT tengingar þannig að Bluetooth Mesh geti tengst snjallsímum, spjaldtölvum og öðrum Bluetooth LE tækjum. Þessi útgáfa inniheldur eiginleika sem studdir eru af Bluetooth Mesh forskriftinni útgáfu 1.1.

Þessar útgáfuupplýsingar ná yfir SDK útgáfur

7.0.3.0 gefin út 23. apríl 2025 (Aðeins undirliggjandi breytingar á kerfinu)
7.0.2.0 gefin út 18. september 2024

7.0.1.0 gefin út 24. júlí 2024
7.0.0.0 gefin út 5. júní 2024

Samhæfi og notkunartilkynningar
Nánari upplýsingar um öryggisuppfærslur og tilkynningar er að finna í kaflanum um öryggi í útgáfutilkynningum kerfisins sem eru settar upp með þessu SDK eða á síðunni um útgáfutilkynningar Silicon Labs. Silicon Labs mælir einnig eindregið með því að þú gerist áskrifandi að öryggisráðgjöfum til að fá uppfærðar upplýsingar. Fyrir leiðbeiningar, eða ef þú ert nýr í notkun Silicon Labs Bluetooth Mesh SDK, sjá Notkun þessarar útgáfu.

Samhæfðir þýðendur
IAR Embedded Workbekk fyrir ARM (IAR-EWARM) útgáfu 9.40.1

Að nota Wine til að smíða með skipanalínuforritinu IarBuild.exe eða IAR Embedded Workbench GUI á Mac eða Linux gæti leitt til rangra gagna. files verið notað vegna árekstra í kjötkássa reiknirit víns til að mynda stutt file nöfnum.
Viðskiptavinum sem nota Mac eða Linux er ráðlagt að nota ekki IAR utan Simplicity Studio. Þeir sem nota það ættu að ganga vandlega úr skugga um að réttar útgáfur séu notaðar. files eru notuð.

GCC (The GNU Compiler Collection) útgáfa 12.2.1, fylgir Simplicity Studio.
Tengitímabestunaraðgerð GCC hefur verið gerð óvirk, sem hefur leitt til lítilsháttar aukningar á myndastærð.

LYKILEIGNIR

Flutningur í Simplicity SDK Suite

Fjarlægði stuðning fyrir Series 0/1
Stuðningur við delta-þjappaðar fastbúnaðaruppfærslur

Nýir hlutir

Nýir eiginleikar

Bætt við útgáfu 7.0.1.0
Stuðningur við uppfærslu á vélbúnaðaruppfærslum fyrir möskvabúnað (DFU) sem notar skilvirka delta-þjöppun, byggða á því að greina muninn á tveimur vélbúnaðarútgáfum, hefur verið bætt við. Þessi eiginleiki krefst notkunar á útgáfu af Commander tólinu sem styður greiningu á ELF tvíundarmismun, sem og notkunar á ræsiforriti sem styður beitingu þjappaðrar vélbúnaðaruppfærslu.

Bætt við útgáfu 7.0.0.0
Stuðningur við Clock Manager hefur verið bætt við. Staflaþættirnir nota ekki lengur device_init() til að frumstilla klukku. Í staðinn verður forritsverkefnið nú að innihalda clock_manager íhlutinn, sem framkvæmir frumstillingu klukkunnar.
Stuðningur við Common Memory Manager hefur verið bætt við.

Ný forritaskil

Bætt við útgáfu 7.0.0.0

Umbætur

Breytt í útgáfu 7.0.0.0

BGAPI breytingar
Skipun fyrir BGAPI-klasa hnúta, sl_btmesh_node_test_identity, hefur verið bætt við til að athuga hvort móttekin auglýsing um hnútauðkenni komi frá tilteknum hnút eða ekki.

Exampbreytingar á forritinu
Low Power Node eiginleiki hefur verið bætt við Sensor miðlara tdamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), og Friend eiginleikanum var bætt við skynjaraþjónsbiðlarann td.ample (btmesh_soc_sen-sor_client).

Föst mál

Lagað í útgáfu 7.0.2.0

auðkenni #	Lýsing
1331888, 1334927, 1338088, 1338090	Lagaði nokkrar ómeðhöndlaðar bilanir í minni úthlutun sem gætu hugsanlega leitt til hruns þegar tækið er of mikið af umferð.
1345827	Lagfært tap á upplýsandi DFU dreifingaraðila BGAPI atburði til að fjarlægja hnút.
1301401	Fastar villur í stöðuuppfærslu lýsingarþjóns við móttöku ljósaþjóns Stilltu beiðnir með umbreytingartíma.
1345411	Lagaði sl_memory_realloc() sem lekur minni, sem leiddi til DFU dreifingaraðilans tdampLe er að verða uppiskroppa með hrúga minni.

Lagað í útgáfu 7.0.1.0

auðkenni #	Lýsing
1301325	Lagaði vandamál við að geyma aðgerðir tímaáætlunarlíkans.
1305041	Lagað tímaleysisvandamál í NCP samskiptum frá hýsil til EFR32.
1305928	Lagað tap á réttum gögnum um móttakaralista í DFU-tilvikum eftir að viðburðatapsleiðrétting 1258654 var innleidd.
1319326	Lagaði röng gildi fyrir inn- og úttak OOB auðkenningarbitaupptalningar.
1325194	Lagaði óþarfa tvíverknað á DFU dreifingaraðila móttakara viðtaka stöðutilviki eftir atburðatapsleiðréttingu 1258654 var innleitt.
1310377	Lagfærði vandamál í IOP Relay appinu. Áður sendi það aðeins með GATT.

Lagað í útgáfu 7.0.0.0

auðkenni #	Lýsing
356148	Forðist að hefja auglýsingabera ef verið er að útvega hnút með því að nota aðeins PB-GATT.
1250461	Gerði tilkynningar um úthlutunarviðburði öflugri á ofhlaðin tæki.
1258654	Gerði DFU atburðatilkynningu öflugri á ofhlaðin tæki.
1274632	DFU dreifingaraðili og sjálfstæðir uppfærslulíkön munu nú tilkynna villu ef stillingar Blob Transfer á hnútnum eru ekki fullnægjandi.
1284204	Lagaði vistun endurspilunarvörn í NVM3 þegar forrit notar sl_btmesh_node_power_off() API.

Þekkt vandamál í núverandi útgáfu

Feitletruð tölublöð voru bætt við frá fyrri útgáfu

auðkenni #	Lýsing	Lausn
401550	Enginn BGAPI atburður fyrir misskilning í meðhöndlun skilaboða.	Forritið þarf að leiða bilun frá tímamörkum/skorti á svörun forritslags; fyrir gerðir söluaðila hefur verið útvegað API.
454059	Mikill fjöldi lykiluppbótarástandsbreytinga er myndaður í lok KR ferlisins og það gæti flætt yfir NCP biðröð.	Auka lengd NCP biðraðarinnar í verkefninu.
454061	Lítilsháttar skerðing á frammistöðu samanborið við 1.5 í biðtímaprófum fram og til baka.
624514	Vandamál með að endurreisa tengjanlegar auglýsingar ef allar tengingar hafa verið virkar og GATT umboðið er í notkun.	Úthlutaðu einni tengingu í viðbót en þörf er á.
841360	Léleg frammistaða sundurliðaðrar skilaboðasendingar yfir GATT-bera.	Gakktu úr skugga um að tengingarbil undirliggjandi BLE tengingar sé stutt; tryggja að ATT MTU sé nógu stórt til að passa fullan Mesh PDU; stilla lágmarkslengd tengingartilviks til að leyfa sendingu margra LL-pakka á hvern tengingaratburð.
1121605	Námundunarvillur geta valdið því að áætlaðar atburðir hrinda af stað á örlítið öðrum tímum en búist var við.
1226127	Hýsingaraðili fyrrvample getur fest sig þegar það byrjar að útvega annan hnút.	Endurræstu hýsingarforritið áður en seinni hnútinn er útvegaður.
1204017	Dreifingaraðilinn getur ekki séð um samhliða sjálfan FW Update og FW Upload.	Ekki keyra sjálf FW uppfærslu og FW upphleðslu samhliða.

Úreltir hlutir

Úrelt í útgáfu 7.0.0.0
BGAPI skipunin sl_btmesh_prov_test_identity hefur verið úrelt. Notaðu sl_btmesh_node_test_identity í staðinn.

Fjarlægðir hlutir

Fjarlægt í útgáfu 7.0.0.0

Stuðningur við Series 1 vélbúnað (xG12 og xG13) hefur verið fjarlægður í þessari útgáfu.

Að nota þessa útgáfu

Þessi útgáfa inniheldur eftirfarandi

Silicon Labs Bluetooth möskva stafla bókasafn
Bluetooth möskva sample umsóknir

Ef þú ert að nota þetta í fyrsta skipti, sjáðu þá QSG176: Silicon Labs Bluetooth Mesh SDK v2. x fljótlegan leiðbeiningarhandbók.

Uppsetning og notkun

Bluetooth möskva SDK er hluti af Simplicity SDK (GSDK), safni Silicon Labs SDK kerfa.
Til að byrja fljótt með Simplicity SDK skaltu setja upp Simplicity Studio 5, sem mun setja upp þróunarumhverfið þitt og leiða þig í gegnum uppsetningu Simplicity SDK.
Simplicity Studio 5 inniheldur allt sem þarf til að þróa IoT vörur með Silicon Labs tækjum, þar á meðal ræsiforrit fyrir auðlindir og verkefni, stillingartól fyrir hugbúnað, fullt IDE með GNU verkfærakeðju og greiningartól.
Uppsetningarleiðbeiningar eru í nethandbók Simplicity Studio 5.
Að öðrum kosti er hægt að setja Simplicity SDK upp handvirkt með því að hlaða niður eða klóna það nýjasta frá GitHub. Sjáðu https://github.com/Sili-conLabs/simplicity_sdk fyrir meiri upplýsingar .

Simplicity Studio setur upp Simplicity SDK sjálfgefið í:
- Windows: C:\Notendur\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Notendur/ /SimplicityStudio/SDKs/simplicity_sdk

Skjöl sem eru sértæk fyrir SDK útgáfuna eru sett upp með SDK. Viðbótarupplýsingar má oft finna í þekkingargrunnsgreinum (KBA). API tilvísanir og aðrar upplýsingar um þessa og fyrri útgáfur eru fáanlegar á https://docs.silabs.com/.

Öryggisupplýsingar

Örugg Vault samþætting
Þessi útgáfa af staflanum er samþætt Secure Vault Key Management. Þegar þeir eru notaðir í Secure Vault High tæki eru dulkóðunarlyklar með möskva verndaðir með því að nota Secure Vault Key Management virkni. Taflan hér að neðan sýnir vernduðu lyklana og geymsluverndareiginleika þeirra.

Lykill	Útflutningshæfni á hnút	Útflutningshæfni á Provisioner	Skýringar
Netlykill	Útflutningshæft	Útflutningshæft	Afleiðingar netlykilsins eru aðeins til í vinnsluminni, en netlyklar eru geymdir á flash-minni.
Umsóknarlykill	Óútflutningshæft	Útflutningshæft
Tækjalykill	Óútflutningshæft	Útflutningshæft	Í tilviki úthlutanda, beitt á tækjalykil úthlutanda sem og lykla annarra tækja.

Lykla sem eru merktir sem „Non-Exportable“ er hægt að nota en ekki viewed eða deilt á keyrslutíma.

Lyklar sem eru merktir sem „Útflutningshæfir“ er hægt að nota eða deila á keyrslutíma en þeir eru dulkóðaðir meðan þeir eru geymdir í flash-kóða.
Nánari upplýsingar um virkni lyklastjórnunar í öruggu geymsluhólfi er að finna í AN1271 Örugg lyklageymsla.

Öryggisráðgjöf
Til að gerast áskrifandi að öryggisráðgjöfum skaltu skrá þig inn á viðskiptavinavef Silicon Labs og velja síðan Aðgangsheim. Smelltu á HEIMASÍÐA til að fara á heimasíðu vefgáttarinnar og smelltu síðan á reitinn Stjórna tilkynningum. Gakktu úr skugga um að hakað sé við „Tilkynningar um hugbúnað/öryggi og tilkynningar um vörubreytingar (PCNS)“ og að þú sért að lágmarki áskrifandi að þínu kerfi og samskiptareglum. Smelltu á Vista til að vista allar breytingar.

Eftirfarandi mynd er fyrrverandiample.e

Stuðningur
Viðskiptavinir Þróunarsetts eiga rétt á þjálfun og tækniaðstoð. Notaðu Silicon Labs Bluetooth netið web síðu til að fá upplýsingar um allar Silicon Labs Bluetooth vörur og þjónustu, og til að skrá þig fyrir vöruaðstoð.
Hafðu samband við stuðning Silicon Laboratories á http://www.silabs.com/support.

Simplicity stúdíó
Aðgangur með einum smelli að MCU og þráðlausum verkfærum, skjölum, hugbúnaði, frumkóðasöfnum og fleira. Í boði fyrir Windows, Mac og Linux

IoT eignasafn
www.silabs.com/IoT
SV/HW

www.silabs.com/Simplicity
Gæði
www.silabs.com/quality

Stuðningur og samfélag
www.silabs.com/community

Fyrirvari

Silicon Labs hyggst veita viðskiptavinum sínum nýjustu, nákvæmu og ítarlegu skjölun um allan jaðarbúnað og einingar sem eru í boði fyrir kerfis- og hugbúnaðarframleiðendur sem nota eða hyggjast nota vörur SiliconLabs. Eiginleikaupplýsingar, tiltækar einingar og jaðarbúnaður, minnisstærðir og minnisföng vísa til hvers tækis fyrir sig og „dæmigerðar“ breytur sem gefnar eru upp geta verið mismunandi eftir forritum.

Umsókn tdampLesið sem lýst er hér er eingöngu til lýsingar.
Silicon Labs áskilur sér rétt til að gera breytingar án frekari fyrirvara á vöruupplýsingum, forskriftum og lýsingum hér, og gefur enga ábyrgð á nákvæmni eða heilleika meðfylgjandi upplýsinga.
Silicon Labs kann að uppfæra vélbúnaðarbúnað vörunnar á meðan framleiðsluferlinu stendur yfir, af öryggis- eða áreiðanleikaástæðum, án fyrirvara. Slíkar breytingar munu ekki breyta forskriftum eða afköstum vörunnar. Silicon Labs ber enga ábyrgð á afleiðingum notkunar upplýsinganna sem gefnar eru í þessu skjali.

Þetta skjal felur ekki í sér eða gefur beinlínis leyfi til að hanna eða búa til samþættar rafrásir.
Vörurnar eru ekki hannaðar eða heimilaðar til notkunar í neinum tækjum í flokki III hjá FDA, forritum þar sem samþykki FDA fyrir markaðssetningu er krafist, eða lífsbjörgunarkerfum án sérstaks skriflegs samþykkis Silicon Labs.
„Lífstuðningskerfi“ er hver sú vara eða kerfi sem ætlað er að styðja við eða viðhalda lífi og/eða heilsu, sem, ef það bilar, má eðlilega búast við að muni leiða til verulegs líkamstjóns eða dauða.

Vörur Silicon Labs eru ekki hannaðar eða leyfðar til hernaðarnota. Vörur Silicon Labs skulu undir engum kringumstæðum notaðar í gereyðingarvopn, þar með talið (en ekki takmarkað við) kjarnorkuvopn, líffræðileg vopn eða efnavopn, eða eldflaugar sem geta borið slík vopn.
Silicon Labs afsalar sér allri ábyrgð, bæði skýrri og óskýrri, og ber ekki ábyrgð á meiðslum eða tjóni sem tengist notkun vöru frá Silicon Labs í slíkum óheimilum tilgangi.

Upplýsingar um vörumerki
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® og Silicon Labs merkið®, Bluegiga®, Bluegiga Merkið®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro merkið og samsetningar þeirra, „orkuvænustu örstýringar heims“, Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Merkið®, USBXpress® Zentri, Zentri merkið og Zentri DMS, Z-Wave® og fleiri eru vörumerki eða skráð vörumerki Silicon Labs. ARM, CORTEX, Cortex-M3 og THUMB eru vörumerki eða skráð vörumerki ARM Holdings. Keil er skráð vörumerki ARM Limited. Wi-Fi er skráð vörumerki Wi-Fi Alliance. Allar aðrar vörur eða vörumerki sem hér eru nefnd eru vörumerki viðkomandi eigenda.

Fyrirtækið Silicon Laboratories Inc.
400 West Cesar Chavez Avenue, Austin, TX 78701 Bandaríkin
www.silabs.com

Algengar spurningar

Sp.: Hvar get ég fundið frekari upplýsingar um öryggisuppfærslur?
A: Vísað er til öryggiskaflans í útgáfuupplýsingum kerfisins eða á útgáfuupplýsingasíðu Silicon Labs til að fá ítarlegri upplýsingar um öryggisuppfærslur.

Sp.: Hvernig gerist áskrifandi að öryggisráðgjöfum?
A: Silicon Labs mælir með því að þú gerist áskrifandi að öryggisráðgjöfum til að fá uppfærðar upplýsingar. Fylgdu leiðbeiningunum í skjölunum eða hafðu samband við þjónustudeild Silicon Labs.

Skjöl / auðlindir

SILICON LABS Bluetooth Mesh SDK [pdf] Handbók eiganda
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetooth Mesh SDK, Mesh SDK, SDK

Heimildir

Notendahandbók

SILICON LABS Bluetooth Mesh SDK

Tæknilýsing