Manuale utente dell'SDK Bluetooth Mesh di SILICON LABS

Informazioni sul prodotto
La suite Simplicity SDK include funzionalità supportate dalla specifica Bluetooth Mesh versione 1.1. Fornisce una piattaforma per lo sviluppo di applicazioni che utilizzano la tecnologia Bluetooth Mesh.

Istruzioni per l'uso del prodotto

Bluetooth Mesh è una nuova topologia disponibile per dispositivi Bluetooth Low Energy (LE) che consente la comunicazione molti-a-molti (m:m). È ottimizzata per la creazione di reti di dispositivi su larga scala ed è ideale per l'automazione degli edifici, le reti di sensori e il tracciamento degli asset. Il nostro software e SDK per lo sviluppo Bluetooth supportano Bluetooth Mesh e le funzionalità Bluetooth. Gli sviluppatori possono aggiungere la comunicazione di rete mesh ai dispositivi LE come luci connesse, sistemi di domotica e sistemi di tracciamento degli asset. Il software supporta Bluetooth beaconing, beacon scanning e connessioni GATT, consentendo a Bluetooth Mesh di connettersi a smartphone, tablet e altri dispositivi Bluetooth LE. Questa versione include funzionalità supportate dalla specifica Bluetooth Mesh versione 1.1.

Queste note di rilascio coprono le versioni dell'SDK

7.0.3.0 rilasciato il 23 aprile 2025 (solo modifiche alla piattaforma di base)
7.0.2.0 rilasciata il 18 settembre 2024

7.0.1.0 rilasciato il 24 luglio 2024
7.0.0.0 rilasciato il 5 giugno 2024

Avvisi di compatibilità e utilizzo
Per ulteriori informazioni sugli aggiornamenti e gli avvisi di sicurezza, consultare il capitolo sulla sicurezza delle Note di rilascio della piattaforma installate con questo SDK o la pagina delle Note di rilascio di Silicon Labs. Silicon Labs consiglia inoltre vivamente di abbonarsi agli avvisi di sicurezza per informazioni aggiornate. Per istruzioni, o se non si ha familiarità con l'SDK Bluetooth Mesh di Silicon Labs, consultare la sezione Utilizzo di questa versione.

Compilatori compatibili
IAR Embedded Workbench per ARM (IAR-EWARM) versione 9.40.1

L'utilizzo di Wine per la compilazione con l'utilità della riga di comando IarBuild.exe o l'interfaccia utente grafica di IAR Embedded Workbench su macOS o Linux potrebbe causare risultati errati fileviene utilizzato a causa di collisioni nell'algoritmo di hashing di wine per la generazione di short file nomi.
Si consiglia ai clienti che utilizzano macOS o Linux di non compilare con IAR al di fuori di Simplicity Studio. In caso contrario, è necessario verificare attentamente che il codice corretto filevengono utilizzati.

GCC (The GNU Compiler Collection) versione 12.2.1, fornita con Simplicity Studio.
La funzionalità di ottimizzazione del tempo di collegamento di GCC è stata disabilitata, con conseguente leggero aumento delle dimensioni dell'immagine.

CARATTERISTICHE PRINCIPALI

Migrazione a Simplicity SDK Suite

Rimosso il supporto per la serie 0/1
Supporto per gli aggiornamenti del firmware compressi delta

Nuovi articoli

Nuove funzionalità

Aggiunto nella versione 7.0.1.0
È stato aggiunto il supporto per l'aggiornamento del firmware dei dispositivi mesh (DFU), che utilizza un'efficiente compressione delta basata sul riconoscimento delle differenze tra due versioni del firmware. La funzionalità richiede l'utilizzo di una versione dello strumento Commander che supporti l'analisi delle differenze binarie ELF, nonché l'utilizzo di un bootloader che supporti l'applicazione dell'aggiornamento del firmware compresso.

Aggiunto nella versione 7.0.0.0
È stato aggiunto il supporto per Clock Manager. I componenti dello stack non utilizzano più device_init() per l'inizializzazione dell'orologio. Il progetto dell'applicazione deve ora includere il componente clock_manager, che si occupa dell'inizializzazione dell'orologio.
È stato aggiunto il supporto per Common Memory Manager.

Nuove API

Aggiunto nella versione 7.0.0.0

Miglioramenti

Modificato nella versione 7.0.0.0

Modifiche BGAPI
È stato aggiunto un comando di classe BGAPI del nodo, sl_btmesh_node_test_identity, per verificare se un annuncio di identità del nodo ricevuto proviene da un determinato nodo oppure no.

Example modifiche dell'applicazione
La funzionalità Nodo a basso consumo è stata aggiunta al server Sensor examples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) e la funzione Friend è stata aggiunta al client del server dei sensori example (btmesh_soc_sen-sor_client).

Problemi risolti

Risolto nella versione 7.0.2.0

ID #	Descrizione
1331888, 1334927, 1338088, 1338090	Sono stati risolti diversi errori di allocazione della memoria non gestiti che avrebbero potuto causare un arresto anomalo quando il dispositivo era sovraccarico di traffico.
1345827	Risolto il problema della perdita dell'evento informativo BGAPI del distributore DFU per la rimozione del nodo.
1301401	Corretti errori di aggiornamento dello stato del server di illuminazione durante la ricezione di richieste di set di server di illuminazione con tempo di transizione.
1345411	Corretta perdita di memoria sl_memory_realloc(), che portava all'ex del distributore DFUampla memoria heap sta esaurendo.

Risolto nella versione 7.0.1.0

ID #	Descrizione
1301325	Risolto un problema nell'archiviazione delle azioni del modello Scheduler.
1305041	Risolto il problema di timeout nella comunicazione NCP dall'host a EFR32.
1305928	Risolto il problema della perdita dei dati corretti dell'elenco dei ricevitori negli eventi DFU dopo l'implementazione della correzione 1258654 per la perdita dell'evento.
1319326	Corretti valori errati per le enumerazioni dei bit di autenticazione OOB di input e output.
1325194	È stata corretta la duplicazione non necessaria dell'evento di stato del ricevitore client del distributore DFU dopo l'implementazione della correzione 1258654 per la perdita dell'evento.
1310377	Risolto un problema nell'app IOP Relay. In precedenza, trasmetteva solo tramite GATT.

Risolto nella versione 7.0.0.0

ID #	Descrizione
356148	Evita di avviare la portante dell'annuncio se il provisioning del nodo viene eseguito utilizzando solo PB-GATT.
1250461	Reso più affidabile il reporting degli eventi di provisioning su un dispositivo sovraccarico.
1258654	Reso più affidabile il reporting degli eventi DFU su un dispositivo sovraccarico.
1274632	I modelli DFU Distributor e Standalone Updater segnaleranno ora un errore se la configurazione del trasferimento Blob sul nodo non è sufficiente.
1284204	Risolto il problema della protezione della riproduzione salvata su NVM3 quando un'applicazione utilizza l'API sl_btmesh_node_power_off().

Problemi noti nella versione corrente

I problemi in grassetto sono stati aggiunti rispetto alla versione precedente

ID #	Descrizione	Soluzione alternativa
401550	Nessun evento BGAPI per errore di gestione dei messaggi segmentati.	L'applicazione deve dedurre l'errore dal timeout/mancanza di risposta a livello di applicazione; per i modelli del fornitore è stata fornita un'API.
454059	Alla fine del processo KR viene generato un gran numero di eventi di modifica dello stato di aggiornamento delle chiavi che potrebbero inondare la coda NCP.	Aumentare la lunghezza della coda NCP nel progetto.
454061	È stato osservato un leggero degrado delle prestazioni rispetto a 1.5 nei test di latenza di andata e ritorno.
624514	Problema con il ripristino della pubblicità collegabile se tutte le connessioni sono attive e il proxy GATT è in uso.	Assegnare una connessione in più del necessario.
841360	Scarse prestazioni della trasmissione di messaggi segmentati tramite portante GATT.	Assicurarsi che l'Intervallo di connessione della connessione BLE sottostante sia breve; assicurarsi che la MTU ATT sia sufficientemente grande da contenere una PDU Mesh completa; ottimizzare la durata minima dell'evento di connessione per consentire la trasmissione di più pacchetti LL per evento di connessione.
1121605	Gli errori di arrotondamento possono causare l'attivazione degli eventi pianificati in orari leggermente diversi rispetto a quelli previsti.
1226127	L'host provisioner example può bloccarsi quando inizia a fornire un secondo nodo.	Riavviare l'app di provisioning dell'host prima di eseguire il provisioning del secondo nodo.
1204017	Il distributore non è in grado di gestire l'aggiornamento e il caricamento automatici del firmware in parallelo.	Non eseguire l'aggiornamento automatico del FW e il caricamento del FW in parallelo.

Articoli obsoleti

Deprecato nella versione 7.0.0.0
Il comando BGAPI sl_btmesh_prov_test_identity è stato deprecato. Utilizza invece sl_btmesh_node_test_identity.

Elementi rimossi

Rimosso nella versione 7.0.0.0

Il supporto per l'hardware Serie 1 (xG12 e xG13) è stato rimosso in questa versione.

Utilizzo di questa versione

Questa versione contiene quanto segue

Libreria stack mesh Bluetooth di Silicon Labs
Maglia Bluetooth sample applicazioni

Se sei un utente alle prime armi, consulta QSG176: Guida rapida all'uso di Silicon Labs Bluetooth Mesh SDK v2. x.

Installazione e utilizzo

L'SDK Bluetooth mesh è fornito come parte dell'SDK Simplicity (GSDK), la suite di SDK di Silicon Labs.
Per iniziare subito a usare Simplicity SDK, installa Simplicity Studio 5, che configurerà il tuo ambiente di sviluppo e ti guiderà attraverso l'installazione di Simplicity SDK.
Simplicity Studio 5 include tutto il necessario per lo sviluppo di prodotti IoT con dispositivi Silicon Labs, tra cui un launcher di risorse e progetti, strumenti di configurazione software, un IDE completo con toolchain GNU e strumenti di analisi.
Le istruzioni di installazione sono fornite nella Guida per l'utente online di Simplicity Studio 5.
In alternativa, Simplicity SDK può essere installato manualmente scaricando o clonando la versione più recente da GitHub. Vedere https://github.com/Sili-conLabs/simplicity_sdk per maggiori informazioni .

Simplicity Studio installa Simplicity SDK per impostazione predefinita in:
- Windows: C:\Utenti\ \SimplicityStudio\SDK\simplicity_sdk
- MacOS: /Utenti/ /SimplicityStudio/SDK/simplicity_sdk

La documentazione specifica per la versione dell'SDK viene installata con l'SDK. Ulteriori informazioni possono essere trovate spesso negli articoli della knowledge base (KBA). I riferimenti API e altre informazioni su questa versione e su quelle precedenti sono disponibili su https://docs.silabs.com/.

Informazioni sulla sicurezza

Integrazione del Vault sicuro
Questa versione dello stack è integrata con Secure Vault Key Management. Quando distribuite su dispositivi Secure Vault High, le chiavi di crittografia mesh vengono protette utilizzando la funzionalità Secure Vault Key Management. La tabella seguente mostra le chiavi protette e le relative caratteristiche di protezione della conservazione.

Chiave	Esportabilità su un nodo	Esportabilità su Provisioner	Appunti
Chiave di rete	Esportabile	Esportabile	Le derivazioni della chiave di rete esistono solo nella RAM, mentre le chiavi di rete sono memorizzate nella memoria flash.
Chiave dell'applicazione	Non esportabile	Esportabile
Chiave del dispositivo	Non esportabile	Esportabile	Nel caso di Provisioner, applicato alla chiave del dispositivo Provisioner e alle chiavi di altri dispositivi.

Le chiavi contrassegnate come "Non esportabili" possono essere utilizzate ma non possono esserlo viewed o condiviso in fase di esecuzione.

Le chiavi contrassegnate come "Esportabili" possono essere utilizzate o condivise in fase di esecuzione, ma rimangono crittografate durante l'archiviazione nella memoria flash.
Per ulteriori informazioni sulla funzionalità Secure Vault Key Management, vedere AN1271 Secure Key Storage.

Consulenza sulla sicurezza
Per iscriverti agli avvisi di sicurezza, accedi al portale clienti di Silicon Labs, quindi seleziona la pagina iniziale dell'account. Fai clic su HOME per accedere alla home page del portale, quindi fai clic sul riquadro Gestisci notifiche. Assicurati che la casella "Avvisi di software/sicurezza e avvisi di modifica prodotto (PCNS)" sia selezionata e di essere iscritto almeno alla piattaforma e al protocollo desiderati. Fai clic su Salva per salvare le modifiche.

La figura seguente è un example.e

Supporto
I clienti del kit di sviluppo hanno diritto alla formazione e al supporto tecnico. Utilizza la rete Bluetooth di Silicon Labs web pagina per ottenere informazioni su tutti i prodotti e servizi Bluetooth di Silicon Labs e per iscriversi al supporto del prodotto.
Contattare il supporto di Silicon Laboratories all'indirizzo http://www.silabs.com/support.

Semplicità Studio
Accesso con un clic a MCU e strumenti wireless, documentazione, software, librerie di codici sorgente e altro ancora. Disponibile per Windows, Mac e Linux

Portafoglio IoT
www.silabs.com/IoT
software/hardware

www.silabs.com/semplicità
Qualità
www.silabs.com/qualità

Supporto e comunità
www.silabs.com/community

Disclaimer

Silicon Labs intende fornire ai clienti la documentazione più aggiornata, accurata e approfondita di tutte le periferiche e i moduli disponibili per gli implementatori di sistemi e software che utilizzano o intendono utilizzare i prodotti SiliconLabs. I dati di caratterizzazione, i moduli e le periferiche disponibili, le dimensioni della memoria e gli indirizzi di memoria si riferiscono a ciascun dispositivo specifico e i parametri "tipici" forniti possono variare e variano in base alle diverse applicazioni.

Applicazione example qui descritte sono solo a scopo illustrativo.
Silicon Labs si riserva il diritto di apportare modifiche senza ulteriore preavviso alle informazioni, alle specifiche e alle descrizioni del prodotto qui contenute e non fornisce garanzie circa l'accuratezza o la completezza delle informazioni incluse.
Senza preavviso, Silicon Labs può aggiornare il firmware del prodotto durante il processo di produzione per motivi di sicurezza o affidabilità. Tali modifiche non modificheranno le specifiche o le prestazioni del prodotto. Silicon Labs non si assume alcuna responsabilità per le conseguenze derivanti dall'utilizzo delle informazioni fornite in questo documento.

Questo documento non implica né concede espressamente alcuna licenza per progettare o fabbricare circuiti integrati.
I prodotti non sono progettati o autorizzati per essere utilizzati in dispositivi di Classe III della FDA, applicazioni per le quali è richiesta l'approvazione pre-commercializzazione della FDA o sistemi di supporto vitale senza lo specifico consenso scritto di Silicon Labs.
Un "sistema di supporto vitale" è qualsiasi prodotto o sistema destinato a supportare o sostenere la vita e/o la salute e che, in caso di guasto, può ragionevolmente provocare gravi lesioni personali o la morte.

I prodotti Silicon Labs non sono progettati né autorizzati per applicazioni militari. I prodotti Silicon Labs non devono in nessun caso essere utilizzati in armi di distruzione di massa, incluse (a titolo esemplificativo ma non esaustivo) armi nucleari, biologiche o chimiche, né in missili in grado di trasportare tali armi.
Silicon Labs declina ogni garanzia espressa o implicita e non sarà responsabile per eventuali lesioni o danni correlati all'uso di un prodotto Silicon Labs in tali applicazioni non autorizzate.

Informazioni sul marchio
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® e il logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, il logo Energy Micro e le loro combinazioni, "i microcontrollori più ecologici al mondo", Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, il logo Telegesis®, USBXpress®, Zentri, il logo Zentri e Zentri DMS, Z-Wave® e altri sono marchi commerciali o marchi registrati di Silicon Labs. ARM, CORTEX, Cortex-M3 e THUMB sono marchi commerciali o marchi registrati di ARM Holdings. Keil è un marchio registrato di ARM Limited. Wi-Fi è un marchio registrato della Wi-Fi Alliance. Tutti gli altri prodotti o marchi qui menzionati sono marchi dei rispettivi titolari.

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

Domande frequenti

D: Dove posso trovare ulteriori informazioni sugli aggiornamenti di sicurezza?
A: Per informazioni dettagliate sugli aggiornamenti di sicurezza, fare riferimento al capitolo Sicurezza delle Note di rilascio della piattaforma o visitare la pagina delle Note di rilascio di Silicon Labs.

D: Come posso abbonarmi agli avvisi di sicurezza?
A: Silicon Labs consiglia di iscriversi agli avvisi di sicurezza per informazioni aggiornate. Seguire le istruzioni fornite nella documentazione o contattare il supporto di Silicon Labs.

Documenti / Risorse

SDK Bluetooth Mesh di SILICON LABS [pdf] Manuale del proprietario
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetooth Mesh SDK, Mesh SDK, SDK

Riferimenti

Manuale d'uso

SDK Bluetooth Mesh di SILICON LABS

Specifiche