SILICON LABS Bluetooth Mesh SDK kasutusjuhend

Tooteteave
Simplicity SDK Suite sisaldab funktsioone, mida toetab Bluetooth Meshi spetsifikatsiooni versioon 1.1. See pakub platvormi rakenduste arendamiseks Bluetooth Meshi tehnoloogia abil.

Toote kasutusjuhised

Bluetooth Mesh on uus topoloogia, mis on saadaval Bluetooth Low Energy (LE) seadmetele ja võimaldab mitmelt mitmele (m:m) kommunikatsiooni. See on optimeeritud suuremahuliste seadmevõrkude loomiseks ning sobib ideaalselt hoonete automatiseerimiseks, andurivõrkudeks ja varade jälgimiseks. Meie Bluetoothi arendustarkvara ja SDK toetavad Bluetooth Meshi ja Bluetoothi funktsionaalsust. Arendajad saavad lisada võrgusuhtlust LE-seadmetele, näiteks ühendatud tuledele, koduautomaatikale ja varade jälgimissüsteemidele. Tarkvara toetab Bluetoothi beaconingut, beaconingu skaneerimist ja GATT-ühendusi, nii et Bluetooth Mesh saab ühenduda nutitelefonide, tahvelarvutite ja muude Bluetooth LE-seadmetega. See versioon sisaldab funktsioone, mida toetab Bluetooth Meshi spetsifikatsiooni versioon 1.1.

Need väljalaskemärkmed hõlmavad SDK versioone

7.0.3.0 avaldati 23. aprillil 2025 (ainult platvormi muudatused)
7.0.2.0, välja antud 18. septembril 2024
7.0.1.0, välja antud 24. juulil 2024
7.0.0.0, välja antud 5. juunil 2024

Ühilduvuse ja kasutamise teatised
Lisateavet turvavärskenduste ja -teadete kohta leiate selle SDK-ga installitud platvormi väljalaskemärkmete turvalisuse peatükist või Silicon Labsi väljalaskemärkmete lehelt. Silicon Labs soovitab tungivalt ka ajakohase teabe saamiseks tellida turvahoiatused. Juhiste saamiseks või kui olete Silicon Labsi Bluetooth Mesh SDK-ga uus, vaadake jaotist Selle väljalaske kasutamine.

Ühilduvad kompilaatorid
IAR Embedded Workbench for ARM (IAR-EWARM) versioon 9.40.1

MacOS-is või Linuxis käsurea utiliidi IarBuild.exe või IAR Embedded Workbench GUI abil Wine'i kasutamine võib põhjustada vale tulemuse. files kasutatakse kokkupõrgete tõttu veini räsimisalgoritmis lühikeste genereerimiseks file nimed.

MacOSi või Linuxi kasutajatel ei soovitata IAR-iga väljaspool Simplicity Studiot luua. Kliendid, kes seda teevad, peaksid hoolikalt kontrollima, et õige files on kasutusel.
GCC (The GNU Compiler Collection) versioon 12.2.1, mis on kaasas Simplicity Studioga.

GCC lingiaja optimeerimise funktsioon on keelatud, mille tulemusel on pildi suurus veidi suurenenud.

PÕHIOMADUSED

Üleminek Simplicity SDK Suite'ile
Seeria 0/1 tugi on eemaldatud
Delta tihendatud püsivara värskenduste tugi

Uued esemed

Uued funktsioonid

Lisatud versioonis 7.0.1.0
Lisatud on võrgusilma seadme püsivara värskenduse (DFU) tugi, mis kasutab kahe püsivara versiooni erinevuste tuvastamisel põhinevat tõhusat delta-tihendust. See funktsioon nõuab Commanderi tööriista versiooni, mis toetab ELF-binaarsete erinevuste analüüsimist, ning alglaaduri kasutamist, mis toetab tihendatud püsivara värskenduse rakendamist.

Lisatud versioonis 7.0.0.0
Lisatud on tugi Clock Managerile. Stack komponendid ei kasuta enam kella initsialiseerimiseks device_init(). Selle asemel peab rakendusprojekt nüüd sisaldama komponenti clock_manager, mis teostab kella initsialiseerimise.
Lisatud on Common Memory Manageri tugi.

Uued API-d

Lisatud versioonis 7.0.0.0

Täiustused

Muudetud versioonis 7.0.0.0

BGAPI muudatused
Lisatud on sõlme BGAPI klassi käsk sl_btmesh_node_test_identity, mis kontrollib, kas vastuvõetud sõlme identiteedi reklaam pärineb antud sõlmest või mitte.

Examprakenduse muudatused
Sensorserverile on lisatud vähese energiatarbega sõlme funktsioon, ntamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) ja Friend funktsioon lisati sensorserveri kliendile example (btmesh_soc_sen-sor_client).

Parandatud probleemid

Parandatud versioonis 7.0.2.0

ID nr	Kirjeldus
1331888, 1334927, 1338088, 1338090	Parandatud mitu käsitlemata mälu eraldamise tõrget, mis võisid potentsiaalselt põhjustada krahhi, kui seade oli liiklusega ülekoormatud.
1345827	Parandatud informatiivse DFU turustaja BGAPI sündmuse kadu sõlme eemaldamiseks.
1301401	Parandatud Valgustusserveri oleku värskendamise vead valgustusserveri vastuvõtmisel Määrake päringud üleminekuajaga.
1345411	Parandatud sl_memory_realloc() lekkiv mälu, mis viib DFU turustajaniample kuhjamälu otsa saama.

Parandatud versioonis 7.0.1.0

ID nr	Kirjeldus
1301325	Lahendatud on probleem plaanija mudeli toimingute salvestamisel.
1305041	Lahendatud on ajalõpu probleem NCP-suhtluses hostilt EFR32-le.
1305928	Parandatud õigete vastuvõtjate loendi andmete kadu DFU sündmustes pärast sündmuse kadumise paranduse 1258654 rakendamist.
1319326	Parandatud OOB-i sisendi ja väljundi autentimisbittide loenduste valed väärtused.
1325194	Parandatud DFU levitaja kliendi vastuvõtja olekusündmuse tarbetu dubleerimine pärast sündmuse kadumise paranduse 1258654 rakendamist.
1310377	Parandatud IOP Relay rakenduse probleem. Varem edastas see ainult GATT-i.

Parandatud versioonis 7.0.0.0

ID nr	Kirjeldus
356148	Väldib reklaamikandja käivitamist, kui sõlme ette valmistatakse ainult PB-GATT-i abil.
1250461	Muutis ettevalmistamise sündmuste aruandluse ülekoormatud seadmes töökindlamaks.
1258654	Muutis DFU sündmuste aruandluse ülekoormatud seadmes tugevamaks.
1274632	DFU levitaja ja eraldiseisva värskendaja mudelid teatavad nüüd veast, kui sõlme Blob Transferi konfiguratsioon pole piisav.
1284204	Parandatud NVM3 taasesituse salvestamise kaitse, kui rakendus kasutab API-d sl_btmesh_node_power_off().

Teadaolevad probleemid praeguses väljaandes

Paksus kirjas olevad probleemid on lisatud alates eelmisest väljaandest

ID nr	Kirjeldus	Lahendus
401550	BGAPI sündmus puudub segmenteeritud sõnumite töötlemise tõrke korral.	Rakendus peab tuletama ebaõnnestumise ajalõpu/rakenduskihi vastuse puudumise põhjal; tarnija mudelite jaoks on API pakutud.
454059	KR-protsessi lõpus genereeritakse suur hulk võtme värskendusoleku muutmise sündmusi ja see võib NCP-järjekorra üle ujutada.	Suurenda projektis NCP järjekorra pikkust.
454061	Täheldati jõudluse kerget halvenemist võrreldes 1.5-ga edasi-tagasi latentsustestides.
624514	Probleem ühenduvuse taastamisega reklaamide kuvamisel, kui kõik ühendused on olnud aktiivsed ja GATT-puhverserver on kasutusel.	Eraldage üks ühendus rohkem kui vaja.
841360	GATT-i kandja kaudu segmenteeritud sõnumite edastamise nõrk jõudlus.	Veenduge, et aluseks oleva BLE-ühenduse ühendusintervall on lühike; veenduge, et ATT MTU on piisavalt suur, et mahutada täisvõrguga PDU-d; häälestage ühenduse sündmuse minimaalne pikkus, et ühe ühenduse sündmuse kohta oleks võimalik edastada mitu LL-paketti.
1121605	Ümardamisvead võivad põhjustada plaanitud sündmuste käivitumist oodatust veidi erineval ajal.
1226127	Hostiteenuse pakkuja ntample võib teise sõlme ettevalmistamise alustamisel kinni jääda.	Enne teise sõlme ettevalmistamist taaskäivitage hosti ettevalmistaja rakendus.
1204017	Jaotur ei suuda paralleelselt püsivara ise uuendada ja üles laadida.	Ärge käivitage FW värskendamist ja FW üleslaadimist paralleelselt.

Aegunud üksused

Versioonis 7.0.0.0 aegunud
BGAPI käsk sl_btmesh_prov_test_identity on aegunud. Kasutage selle asemel sl_btmesh_node_test_identity.

Eemaldatud üksused

Eemaldatud versioonis 7.0.0.0

Seeria 1 riistvara (xG12 ja xG13) tugi on sellest versioonist eemaldatud.

Selle väljalase kasutamine

See väljaanne sisaldab järgmist

Silicon Labsi Bluetoothi võrgu virnade raamatukogu
Bluetooth mesh sample rakendusi

Kui oled esmakasutaja, vaata QSG176: Silicon Labs Bluetooth Mesh SDK v2. x kiirjuhend.

Paigaldamine ja kasutamine

Bluetoothi võrgu SDK on osa Simplicity SDK-st (GSDK), mis on Silicon Labsi SDK-de komplekt.
Simplicity SDK kiireks kasutamiseks installige Simplicity Studio 5, mis seadistab teie arenduskeskkonna ja juhendab teid Simplicity SDK installimisel.

Simplicity Studio 5 sisaldab kõike, mida on vaja asjade interneti tootearenduseks Silicon Labsi seadmetega, sh ressursside ja projektide käivitajat, tarkvara konfigureerimise tööriistu, täielikku IDE-d GNU tööriistaketiga ja analüüsitööriistu.
Paigaldusjuhised leiate veebipõhisest Simplicity Studio 5 kasutusjuhendist.

Teise võimalusena võib Simplicity SDK installida käsitsi, laadides alla või kloonides GitHubist uusima versiooni. Vaata https://github.com/Sili-conLabs/simplicity_sdk rohkem informatsiooni .
Simplicity Studio installib Simplicity SDK vaikimisi järgmistesse kohtadesse:
- Windows: C:\Users\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Kasutajad/ /SimplicityStudio/SDKs/simplicity_sdk

SDK versioonile spetsiaalne dokumentatsioon installitakse koos SDK-ga. Lisateavet leiate sageli teadmistebaasi artiklitest (KBA). API viited ja muu teave selle ja varasemate versioonide kohta on saadaval aadressil https://docs.silabs.com/.

Turvateave

Turvaline võlvi integreerimine
See virna versioon on integreeritud Secure Vault Key Managementiga. Secure Vault High seadmetes juurutamisel kaitstakse võrgukrüpteerimisvõtmeid Secure Vault Key Management funktsiooni abil. Allolevas tabelis on näidatud kaitstud võtmed ja nende salvestuskaitse omadused.

Võti	Eksporditavus sõlmes	Eksporditavus Provisioneril	Märkmed
Võrguvõti	Eksporditav	Eksporditav	Võrguvõtme tuletised eksisteerivad ainult RAM-is, samas kui võrguvõtmed on salvestatud välkmälusse.
Rakenduse võti	Mitteeksporditav	Eksporditav
Seadme võti	Mitteeksporditav	Eksporditav	Provisioneri puhul rakendatakse seda nii Provisioneri seadmevõtmele kui ka teiste seadmete võtmetele.

Klahve, mis on märgistatud kui „Ei eksporditav”, saab kasutada, kuid mitte viewredigeeritud või käitusajal jagatud.
Võtmeid, mis on märgitud kui „Eksporditavad”, saab käitusajal kasutada või jagada, kuid need jäävad välkmällu salvestamise ajal krüpteerituks.

Lisateavet turvalise võtmehoidla funktsioonide kohta leiate jaotisest AN1271 Turvaline võtmehoidla.

Turvameetmed
Turvahoiatuste tellimiseks logige sisse Silicon Labsi kliendiportaali ja valige seejärel Konto avaleht. Portaali avalehele minemiseks klõpsake nuppu HOME ja seejärel klõpsake paani Halda teavitusi. Veenduge, et „Tarkvara/turvahoiatuste teated ja tootemuudatuste teated (PCNS)” on märgitud ning et teil on vähemalt oma platvormi ja protokolli jaoks tellija. Muudatuste salvestamiseks klõpsake nuppu Salvesta.

Järgmine joonis on endineample.e

Toetus
Arenduskomplekti klientidel on õigus saada koolitust ja tehnilist tuge. Kasutage Silicon Labsi Bluetoothi võrku web lehel, et saada teavet kõigi Silicon Labsi Bluetoothi toodete ja teenuste kohta ning registreeruda tootetoe saamiseks.
Võtke ühendust Silicon Laboratories toega aadressil http://www.silabs.com/support.

Lihtsuse stuudio
Ühe klõpsuga juurdepääs MCU-le ja juhtmevabadele tööriistadele, dokumentatsioonile, tarkvarale, lähtekooditeekidele ja muule. Saadaval Windowsi, Maci ja Linuxi jaoks

Asjade interneti portfell
www.silabs.com/IoT
SW/HW
www.silabs.com/simplicity
Kvaliteet
www.silabs.com/quality
Tugi ja kogukond
www.silabs.com/community

Vastutusest loobumine

Silicon Labs kavatseb pakkuda klientidele uusimat, täpset ja põhjalikku dokumentatsiooni kõigi saadaolevate välisseadmete ja moodulite kohta, mis on mõeldud SiliconLabsi tooteid kasutavatele või kasutada kavatsevatele süsteemi- ja tarkvarakasutajatele. Iseloomustusandmed, saadaolevad moodulid ja välisseadmed, mälumahud ja mäluaadressid viitavad igale konkreetsele seadmele ning esitatud „tüüpilised” parameetrid võivad erineda ja erineda erinevates rakendustes.
Rakendus ntampsiin kirjeldatud on ainult illustratiivsel eesmärgil.
Silicon Labs jätab endale õiguse teha siin esitatud tooteteavet, spetsifikatsioone ja kirjeldusi ilma täiendava etteteatamata muudatusi ega anna garantiid lisatud teabe täpsuse või täielikkuse kohta.

Silicon Labs võib turvalisuse või töökindluse kaalutlustel tootmisprotsessi käigus toote püsivara ette teatamata uuendada. Sellised muudatused ei muuda toote tehnilisi andmeid ega jõudlust. Silicon Labs ei vastuta käesolevas dokumendis esitatud teabe kasutamise tagajärgede eest.
See dokument ei viita ega anna selgesõnaliselt litsentsi mis tahes integraallülituste projekteerimiseks või valmistamiseks.
Tooteid ei ole kavandatud ega lubatud kasutada üheski FDA III klassi seadmes, rakendustes, mille jaoks on vaja FDA turustamiseelset heakskiitu, ega elutoetussüsteemides ilma Silicon Labsi konkreetse kirjaliku nõusolekuta.
„Elutoetussüsteem” on iga toode või süsteem, mis on ette nähtud elu ja/või tervise toetamiseks või säilitamiseks ning mille rikke korral võib mõistlike eelduste kohaselt tekkida oluline kehavigastus või surm.
Silicon Labsi tooted ei ole loodud ega lubatud sõjaliseks otstarbeks. Silicon Labsi tooteid ei tohi mingil juhul kasutada massihävitusrelvades, sealhulgas (kuid mitte ainult) tuuma-, bioloogilistes või keemiarelvades ega selliste relvade kohaletoimetamiseks võimelistes rakettides.
Silicon Labs ei anna mingeid otseseid ega kaudseid garantiisid ega vastuta vigastuste või kahjude eest, mis on seotud Silicon Labsi toote kasutamisega sellistes volitamata rakendustes.

Kaubamärgi teave
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® ja Silicon Labsi logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo ja nende kombinatsioonid, „maailma energiasäästlikumad mikrokontrollerid“, Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesise logo®, USBXpress® Zentri, Zentri logo ja Zentri DMS, Z-Wave® ja teised on Silicon Labsi kaubamärgid või registreeritud kaubamärgid. ARM, CORTEX, Cortex-M3 ja THUMB on ARM Holdingsi kaubamärgid või registreeritud kaubamärgid. Keil on ARM Limitedi registreeritud kaubamärk. Wi-Fi on Wi-Fi Alliance'i registreeritud kaubamärk. Kõik muud siin mainitud tooted või kaubamärgid on nende vastavate omanike kaubamärgid.

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

KKK-d

K. Kust ma leian lisateavet turvavärskenduste kohta?
A: Üksikasjaliku turvavärskenduste teabe saamiseks vaadake platvormi väljalaskemärkmete peatükki „Turvalisus” või külastage Silicon Labsi väljalaskemärkmete lehte.

K: Kuidas tellida turvanõuandeid?
A: Silicon Labs soovitab ajakohase teabe saamiseks tellida turvahoiatused. Järgige dokumentatsioonis toodud juhiseid või võtke ühendust Silicon Labsi toega.

Dokumendid / Ressursid

SILICON LABS Bluetooth Mesh SDK [pdfKasutusjuhend
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetoothi võrgusilma SDK, võrgusilma SDK, SDK

Viited

Kasutusjuhend

SILICON LABS Bluetooth Mesh SDK

Tehnilised andmed