SILICON LABS Bluetooth Mesh SDK uputstvo za upotrebu

Informacije o proizvodu
Simplicity SDK Suite uključuje funkcije koje podržava Bluetooth Mesh specifikacija verzije 1.1. Pruža platformu za razvoj aplikacija korištenjem Bluetooth Mesh tehnologije.

Upute za upotrebu proizvoda

Bluetooth Mesh je nova topologija dostupna za Bluetooth Low Energy (LE) uređaje koja omogućava komunikaciju "m:m" (many-to-many). Optimizirana je za kreiranje mreža uređaja velikih razmjera i idealno je prilagođena za automatizaciju zgrada, senzorske mreže i praćenje imovine. Naš softver i SDK za razvoj Bluetootha podržavaju Bluetooth Mesh i Bluetooth funkcionalnost. Programeri mogu dodati mesh mrežnu komunikaciju LE uređajima kao što su povezana svjetla, kućna automatizacija i sistemi za praćenje imovine. Softver podržava Bluetooth beaconing, skeniranje beacon-a i GATT veze tako da se Bluetooth Mesh može povezati sa pametnim telefonima, tabletima i drugim Bluetooth LE uređajima. Ovo izdanje uključuje funkcije koje podržava Bluetooth Mesh specifikacija verzije 1.1.

Ove bilješke o izdanju pokrivaju verzije SDK-a

7.0.3.0 objavljena 23. aprila 2025. (samo osnovne promjene platforme)
7.0.2.0 objavljen 18. septembra 2024
7.0.1.0 objavljen 24. jula 2024
7.0.0.0 objavljen 5. juna 2024

Obavještenja o kompatibilnosti i upotrebi
Za više informacija o sigurnosnim ažuriranjima i obavještenjima, pogledajte poglavlje Sigurnost u Bilješkama o izdanju platforme instaliranim s ovim SDK-om ili na stranici Bilješke o izdanju Silicon Labsa. Silicon Labs također toplo preporučuje da se pretplatite na Sigurnosne savjete kako biste dobivali ažurne informacije. Za upute ili ako ste novi korisnik Silicon Labs Bluetooth Mesh SDK-a, pogledajte Korištenje ovog izdanja.

Kompatibilni prevodioci
IAR Embedded Workbench za ARM (IAR-EWARM) verzija 9.40.1

Korištenje Wine-a za izgradnju pomoću uslužnog programa komandne linije IarBuild.exe ili grafičkog korisničkog interfejsa IAR Embedded Workbench na MacOS-u ili Linuxu može rezultirati netačnim... files se koristi zbog sudara u algoritmu heširanja vina za generiranje kratkog file imena.

Korisnicima Mac ili Linux sistema se savjetuje da ne grade pomoću IAR-a izvan Simplicity Studija. Korisnici koji to rade trebaju pažljivo provjeriti da li je ispravno files se koriste.
GCC (The GNU Compiler Collection) verzija 12.2.1, isporučena sa Simplicity Studio.

Funkcija optimizacije vremena povezivanja GCC-a je onemogućena, što je rezultiralo blagim povećanjem veličine slike.

KLJUČNE KARAKTERISTIKE

Migracija na Simplicity SDK Suite
Uklonjena podrška za seriju 0/1
Podrška za delta komprimovana ažuriranja firmvera

Nove stavke

Nove karakteristike

Dodato u izdanju 7.0.1.0
Dodana je podrška za ažuriranje firmvera Mesh uređaja (DFU) koje koristi efikasnu delta kompresiju, zasnovanu na prepoznavanju razlika između dvije verzije firmvera. Ova funkcija zahtijeva korištenje verzije Commander alata koja podržava analizu ELF binarnih razlika, kao i korištenje bootloadera koji podržava primjenu komprimiranog ažuriranja firmvera.

Dodato u izdanju 7.0.0.0
Dodana je podrška za Clock Manager. Komponente steka više ne koriste device_init() za inicijalizaciju sata. Umjesto toga, projekat aplikacije sada mora uključivati komponentu clock_manager, koja vrši inicijalizaciju sata.
Dodana je podrška za Common Memory Manager.

Novi API-ji

Dodato u izdanju 7.0.0.0

Poboljšanja

Promijenjeno u izdanju 7.0.0.0

BGAPI promjene
Dodana je naredba klase BGAPI čvora, sl_btmesh_node_test_identity, za provjeru da li primljeni oglas identiteta čvora potiče sa datog čvora ili ne.

Examppromjene u aplikaciji
Funkcija Low Power Node je dodana na Sensor server examples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), i funkcija Friend je dodana klijentu servera senzora example (btmesh_soc_sen-sor_client).

Fiksni problemi

Popravljeno u izdanju 7.0.2.0

ID br.	Opis
1331888, 1334927, 1338088, 1338090	Popravljeno je nekoliko neuspješnih grešaka u dodjeli memorije koji bi potencijalno mogli dovesti do pada kada je uređaj preopterećen prometom.
1345827	Popravljen gubitak informativnog DFU distributera BGAPI događaja za uklanjanje čvora.
1301401	Ispravljene greške ažuriranja stanja servera osvetljenja prilikom prijema servera osvetljenja Podesite zahteve sa vremenom tranzicije.
1345411	Ispravljeno sl_memory_realloc() curenje memorije, što dovodi do DFU distributera exampponestaje memorije hrpe.

Popravljeno u izdanju 7.0.1.0

ID br.	Opis
1301325	Rešen je problem sa pohranjivanjem akcija modela Planera.
1305041	Ispravljen je problem s timeoutom u NCP komunikaciji od hosta do EFR32.
1305928	Popravljen gubitak ispravnih podataka liste primatelja u DFU događajima nakon što je implementiran popravak gubitka događaja 1258654.
1319326	Ispravljene netočne vrijednosti za ulazne i izlazne OOB provjere autentičnosti nabrajanja bitova.
1325194	Ispravljeno nepotrebno dupliciranje događaja statusa prijemnika klijenta DFU distributera nakon popravka gubitka događaja 1258654.
1310377	Ispravljen je problem u aplikaciji IOP Relay. Ranije se slao samo putem GATT-a.

Popravljeno u izdanju 7.0.0.0

ID br.	Opis
356148	Izbjegava pokretanje nosača oglasa ako se čvor dobavlja koristeći samo PB-GATT.
1250461	Izvještavanje o događajima obezbjeđenja je postalo robusnije na preopterećenom uređaju.
1258654	Izvještavanje o DFU događajima je postalo robusnije na preopterećenom uređaju.
1274632	Modeli DFU distributera i samostalnog ažuriranja sada će prijaviti grešku ako konfiguracija prijenosa blobova na čvoru nije dovoljna.
1284204	Ispravljena zaštita čuvanja ponavljanja na NVM3 kada aplikacija koristi sl_btmesh_node_power_off() API.

Poznati problemi u trenutnom izdanju

Problemi koji su podebljani dodani su od prethodnog izdanja

ID br.	Opis	Zaobilazno rješenje
401550	Nema BGAPI događaja za grešku u rukovanju segmentiranim porukama.	Aplikacija treba da zaključi neuspjeh iz vremenskog ograničenja/nedostatka odgovora sloja aplikacije; za modele dobavljača, obezbeđen je API.
454059	Veliki broj događaja promjene stanja ključa se generira na kraju KR procesa i to može preplaviti NCP red.	Povećajte dužinu NCP reda u projektu.
454061	Zapažena je mala degradacija performansi u poređenju sa 1.5 u testovima latence round-trip.
624514	Problem s ponovnim uspostavljanjem povezivog oglašavanja ako su sve veze aktivne i GATT proxy je u upotrebi.	Dodijelite jednu vezu više nego što je potrebno.
841360	Loše performanse prenosa segmentiranih poruka preko GATT nosioca.	Osigurajte da je interval povezivanja osnovne BLE veze kratak; osigurati da je ATT MTU dovoljno velik da stane u puni Mesh PDU; podesite minimalnu dužinu događaja veze kako biste omogućili prijenos više LL paketa po događaju veze.
1121605	Greške zaokruživanja mogu uzrokovati pokretanje zakazanih događaja u vrlo malo drugačijem vremenu od očekivanog.
1226127	Host provider exampmože se zaglaviti kada počne pružati drugi čvor.	Ponovo pokrenite aplikaciju za pružanje usluga hosta prije dodjeljivanja drugog čvora.
1204017	Distributer nije u stanju da rukuje paralelnim sopstvenim ažuriranjem FW-a i FW Upload-om.	Nemojte paralelno pokretati samostalno ažuriranje FW-a i otpremanje FW-a.

Zastarjeli predmeti

Zastarjelo u izdanju 7.0.0.0
BGAPI komanda sl_btmesh_prov_test_identity je zastarjela. Umjesto toga koristite sl_btmesh_node_test_identity.

Uklonjene stavke

Uklonjeno u izdanju 7.0.0.0

Podrška za hardver Serije 1 (xG12 i xG13) je uklonjena u ovom izdanju.

Korištenje ovog izdanja

Ovo izdanje sadrži sljedeće

Silicon Labs Bluetooth mrežna biblioteka
Bluetooth mesh sample applications

Ako ste korisnik prvi put, pogledajte QSG176: Silicon Labs Bluetooth Mesh SDK v2. x Kratki vodič.

Instalacija i upotreba

Bluetooth mesh SDK je dio Simplicity SDK-a (GSDK), paketa Silicon Labs SDK-ova.
Da biste brzo započeli sa Simplicity SDK-om, instalirajte Simplicity Studio 5, koji će postaviti vaše razvojno okruženje i provesti vas kroz instalaciju Simplicity SDK-a.

Simplicity Studio 5 uključuje sve što je potrebno za razvoj IoT proizvoda sa Silicon Labs uređajima, uključujući pokretač resursa i projekata, alate za konfiguraciju softvera, kompletno IDE okruženje sa GNU alatima i alate za analizu.
Uputstva za instalaciju nalaze se u Simplicity Studio 5 korisničkom vodiču na mreži.

Alternativno, Simplicity SDK se može instalirati ručno preuzimanjem ili kloniranjem najnovijeg sa GitHuba. Vidi https://github.com/Sili-conLabs/simplicity_sdk za više informacija .
Simplicity Studio podrazumevano instalira Simplicity SDK u:
- Windows: C:\Korisnici\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Korisnici/ /SimplicityStudio/SDKs/simplicity_sdk

Dokumentacija specifična za verziju SDK-a se instalira sa SDK-om. Dodatne informacije se često mogu pronaći u člancima baze znanja (KBA). API reference i druge informacije o ovom i ranijim izdanjima dostupne su na https://docs.silabs.com/.

Sigurnosne informacije

Sigurna integracija trezora
Ova verzija steka je integrirana sa Secure Vault Key Management. Kada se implementiraju na Secure Vault High uređaje, ključevi mesh enkripcije su zaštićeni pomoću funkcije Secure Vault Key Management. Tabela ispod prikazuje zaštićene ključeve i njihove karakteristike zaštite pohrane.

Ključ	Mogućnost izvoza na čvoru	Mogućnost izvoza na Provisioner-u	Bilješke
Mrežni ključ	Izvozno	Izvozno	Izvodi mrežnog ključa postoje samo u RAM-u, dok se mrežni ključevi pohranjuju na fleš memoriji.
Ključ aplikacije	Neizvozno	Izvozno
Ključ uređaja	Neizvozno	Izvozno	U slučaju Provisionera, primjenjuje se na ključ uređaja Provisionera, kao i na ključeve drugih uređaja.

Ključevi koji su označeni kao “Non-Exportable” se mogu koristiti, ali ne mogu viewuređivati ili dijeliti u vrijeme izvođenja.
Ključevi koji su označeni kao "Izvozivi" mogu se koristiti ili dijeliti za vrijeme izvođenja programa, ali ostaju šifrirani dok se pohranjuju u fleš memoriji.

Za više informacija o funkcionalnosti upravljanja ključevima sigurnog trezora, pogledajte AN1271 Sigurno skladištenje ključeva.

Sigurnosni savjeti
Da biste se pretplatili na Sigurnosne savjete, prijavite se na korisnički portal Silicon Labsa, a zatim odaberite Početna stranica računa. Kliknite POČETNA stranica da biste otišli na početnu stranicu portala, a zatim kliknite pločicu Upravljanje obavijestima. Provjerite je li označeno polje 'Obavještenja o softverskim/sigurnosnim savjetima i obavijesti o promjenama proizvoda (PCNS)' i da ste pretplaćeni barem na svoju platformu i protokol. Kliknite Spremi da biste spremili sve promjene.

Sljedeća slika je bivšiample.e

Podrška
Korisnici Development Kita imaju pravo na obuku i tehničku podršku. Koristite Silicon Labs Bluetooth mrežu web stranicu da biste dobili informacije o svim Bluetooth proizvodima i uslugama Silicon Labsa i da biste se prijavili za podršku za proizvode.
Kontaktirajte podršku Silicon Laboratories na http://www.silabs.com/support.

Studio Simplicity
Pristup MCU i bežičnim alatima, dokumentaciji, softveru, bibliotekama izvornog koda i još mnogo toga jednim klikom. Dostupno za Windows, Mac i Linux

IoT portfolio
www.silabs.com/IoT
SW/HW
www.silabs.com/simplicity
Kvaliteta
www.silabs.com/quality
Podrška i zajednica
www.silabs.com/community

Odricanje od odgovornosti

Silicon Labs namjerava pružiti kupcima najnoviju, tačnu i detaljnu dokumentaciju o svim perifernim uređajima i modulima dostupnim za implementatore sistema i softvera koji koriste ili namjeravaju koristiti SiliconLabs proizvode. Karakteristični podaci, dostupni moduli i periferni uređaji, veličine memorije i memorijske adrese odnose se na svaki specifični uređaj, a navedeni "tipični" parametri mogu se razlikovati i razlikuju u različitim primjenama.
Aplikacija exampsve opisane ovdje služe samo u ilustrativne svrhe.
Silicon Labs zadržava pravo izmjene informacija o proizvodu, specifikacija i opisa bez daljnje najave i ne daje jamstva za tačnost ili potpunost uključenih informacija.

Bez prethodne najave, Silicon Labs može ažurirati firmver proizvoda tokom proizvodnog procesa iz sigurnosnih ili pouzdanih razloga. Takve promjene neće promijeniti specifikacije ili performanse proizvoda. Silicon Labs neće snositi odgovornost za posljedice korištenja informacija datih u ovom dokumentu.
Ovaj dokument ne podrazumijeva niti izričito daje bilo kakvu licencu za projektovanje ili proizvodnju bilo kojeg integriranog kola.
Proizvodi nisu dizajnirani niti odobreni za upotrebu u bilo kojim FDA uređajima klase III, aplikacijama za koje je potrebno FDA odobrenje pred stavljanje u promet ili sistemima za održavanje života bez izričite pismene saglasnosti Silicon Labsa.
„Sistem za održavanje života“ je bilo koji proizvod ili sistem namijenjen podršci ili održavanju života i/ili zdravlja, za koji se, u slučaju kvara, razumno može očekivati da će rezultirati značajnim tjelesnim povredama ili smrću.
Proizvodi Silicon Labsa nisu dizajnirani niti odobreni za vojnu primjenu. Proizvodi Silicon Labsa se ni pod kojim okolnostima ne smiju koristiti u oružju za masovno uništenje, uključujući (ali ne ograničavajući se na) nuklearno, biološko ili hemijsko oružje ili projektile sposobne za isporuku takvog oružja.
Silicon Labs se odriče svih izričitih i implicitnih garancija i neće biti odgovoran za bilo kakve povrede ili štete povezane s korištenjem Silicon Labs proizvoda u takvim neovlaštenim primjenama.

Trademark Information
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® i logotip Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, logotip Energy Micro i njihove kombinacije, „mikrokontroleri s najvećom energetskom štedljivošću na svijetu“, Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, logotip Telegesis®, USBXpress® Zentri, logotip Zentri i Zentri DMS, Z-Wave® i drugi su zaštitni znakovi ili registrovani zaštitni znakovi Silicon Labsa. ARM, CORTEX, Cortex-M3 i THUMB su zaštitni znakovi ili registrovani zaštitni znakovi ARM Holdingsa. Keil je registrovani zaštitni znak ARM Limited. Wi-Fi je registrovani zaštitni znak Wi-Fi Alliance. Svi ostali proizvodi ili nazivi robnih marki spomenuti ovdje su zaštitni znakovi njihovih vlasnika.

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

FAQs

P: Gdje mogu pronaći više informacija o sigurnosnim ažuriranjima?
A: Za detaljne informacije o sigurnosnim ažuriranjima pogledajte poglavlje Sigurnost u Bilješkama o izdanju platforme ili posjetite stranicu s bilješkama o izdanju Silicon Labsa.

P: Kako da se pretplatim na Security Advisories?
A: Silicon Labs preporučuje pretplatu na Sigurnosne savjete kako biste bili u toku s najnovijim informacijama. Slijedite upute navedene u dokumentaciji ili kontaktirajte podršku Silicon Labsa.

Dokumenti / Resursi

SILICON LABS Bluetooth Mesh SDK [pdf] Uputstvo za upotrebu
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetooth Mesh SDK, Mesh SDK, SDK

Reference

Uputstvo za upotrebu

SILICON LABS Bluetooth Mesh SDK

Specifikacije