Istruzioni per Zigbee EmberZ Net SDK di SILICON LABS

Silicon Labs è il fornitore di scelta per gli OEM che sviluppano reti Zigbee nei loro prodotti. La piattaforma Zigbee di Silicon Labs è la soluzione Zigbee più integrata, completa e ricca di funzionalità disponibile. L'SDK EmberZNet di Silicon Labs contiene l'implementazione di Silicon Labs delle specifiche dello stack Zigbee.

CARATTERISTICHE PRINCIPALI

Zigbee

-250+ voci nella tabella delle chiavi di collegamento APS
Supporto ZigbeeD su Android 12 (v21.0.6113669) e Tizen (v0.1-13.1)

Supporto modulo xG26

Multiprotocollo

Supporto ZigbeeD e OTBR su OpenWRT – GA
DMP BLE + CMP ZB e Matter/OT con ascolto simultaneo su MG26 per SoC – GA

Componente di priorità del pianificatore radio unificato 802.15.4
Supporto per pacchetti Debian per applicazioni host MP – Alpha

Nuovi articoli

Cambiamenti importanti
La dimensione della tabella delle chiavi di collegamento APS (configurata tramite SL_ZIGBEE_KEY_TABLE_SIZE) è stata ampliata da 127 a 254 voci.

È stato aggiunto il supporto R23 per la funzionalità di messa in servizio di ZDD Network. La funzionalità di tunneling è disponibile senza supporto per i casi d'uso Legacy Network.

I componenti Network Steering e Network Creator sono stati aggiornati per includere il supporto per l'unione R23. Questi includono le seguenti modifiche correlate.
- La policy di richiesta Trust Center Link Key (TCLK) predefinita è stata aggiornata per generare nuove chiavi per ogni dispositivo richiedente. Una nuova chiave viene generata ogni volta che i dispositivi richiedenti tentano di aggiornare la loro Trust Center Link Key.
- A causa della precedente modifica della policy TCLK, il componente Network Creator Security richiede ora il componente Security Link Keys. L'aggiornamento delle applicazioni verrà aggiornato per conformarsi a questo nuovo requisito.
- Una nuova configurazione,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY è stato aggiunto per consentire l'unione tramite una chiave hash core. Questa configurazione si trova nel componente Network Creator Security. L'uso di questa policy consente a ogni dispositivo di unione di ricevere un TCLK univoco post-unione, ma ripetuti tentativi di aggiornare il TCLK non daranno luogo a una nuova chiave per il dispositivo richiedente. Questo utilizzo di chiavi di collegamento hash era la policy predefinita prima di questa versione e l'uso di questa policy consente al Trust Center di evitare di introdurre il componente Security Link Keys, che salva le chiavi in Flash.
  Nota: Silicon Labs sconsiglia l'utilizzo di questa policy, poiché impedisce ai dispositivi in adesione di aggiornare i propri TCLK.

Un nuovo set di configurazione viene aggiunto al componente zigbee_ezsp_spi per consentire la configurazione del dispositivo SPI host e delle sue interfacce pin.
L'exampi progetti, compreso il progetto files (.slcps) e la cartella del progetto vengono rinominati secondo le linee guida di denominazione di Silicon Labs e spostati nella directory "progetti".

Supporto per la nuova piattaforma

Nuovi moduli
- Modello: MGM260PD32VNA2
- Modello: MGM260PD32VNN2
- Modello: MGM260PD22VNA2
- Modello: MGM260PB32VNA5
- Modello: MGM260PB32VNN5
- Modello: MGM260PB22VNA5
- Modello BGM260PB22VNA2
- Modello BGM260PB32VNA2
- Nuove schede radio
- Modello MGM260P-RB4350A
- Modello MGM260P-RB4351A
Nuova parte
- efr32xg27
Kit esploratore
- BRD2709A
- Modello MGM260P-EK2713A

Nuova documentazione
Nuove istruzioni per l'uso EZSP UG600 per le versioni 8.1 e successive.

Miglioramenti

I limiti di SL_ZIGBEE_KEY_TABLE_SIZE sono stati estesi a 254 voci.
Aggiunti zigbee_security_link_keys a Z3Light.
Aggiunto zigbee_security_link_keys a zigbee_mp_z3_tc_z3_tc. Aggiornata anche la dimensione della tabella delle chiavi.
Aumentata la dimensione della tabella delle chiavi del gateway Z3 (che sarà impostata su ncp) a 20.

Problemi risolti

Problemi noti nella versione corrente

I problemi in grassetto sono stati aggiunti rispetto alla versione precedente. Se ti sei perso una versione, le note sulla versione recente sono disponibili all'indirizzo https://www.silabs.com/developers/zigbee-emberznet nella scheda Documenti tecnici.

Articoli obsoleti

Il componente zigbee_watchdog_periodic_refresh non è più utilizzato nel framework dell'applicazione Zigbee ed è deprecato in questa versione. Il timer watchdog è disabilitato per impostazione predefinita per tutti gli sample applicazioni. In futuro verrà aggiunto un componente watchdog migliorato all'SDK.
Nota: Abilita il timer watchdog con l'elemento di configurazione SL_LEGACY_HAL_DISABLE_WATCHDOG impostato su 0 nella tua applicazione

Limitazioni e considerazioni sulla rete

Le applicazioni Trust Center predefinite fornite con questa release di EmberZNet sono in grado di supportare diversi dispositivi sulla rete. Questo numero è determinato in base a diversi fattori, tra cui le dimensioni delle tabelle configurate, l'utilizzo di NVM e altri valori di tempo di generazione e di runtime. Gli utenti che cercano di creare reti di grandi dimensioni potrebbero riscontrare problemi di risorse quando la rete aumenta più di quanto l'applicazione possa supportare. Ad esempioample, un dispositivo che richiede una Trust Center Link Key dal Trust Center può attivare un callback sl_zigbee_af_zigbee_key_establishment_cb sul Trust Center con stato h impostato su SL_ZIGBEE_KEY_TABLE_FULL, indicando che la tabella delle chiavi non ha spazio per aggiungere una nuova chiave per il dispositivo richiedente o che NVM3 non ha spazio disponibile. Silicon Labs fornisce le seguenti raccomandazioni per gli utenti che desiderano creare reti di grandi dimensioni. Per le applicazioni Trust Center, si consigliano le seguenti configurazioni. Queste raccomandazioni non sono esaustive e servono come base di partenza per le applicazioni che intendono sviluppare reti di grandi dimensioni.

Inclusione del componente Tabella indirizzi (zigbee_address_table), con
- l'elemento di configurazione SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE impostato sulla dimensione della rete desiderata
- il valore SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE impostato al massimo (4)

Inclusione del componente Security Link Keys (zigbee_security_link_keys), con
- Il valore SL_ZIGBEE_KEY_TABLE_SIZE è impostato sulla dimensione della rete
I seguenti elementi di configurazione sono impostati sulla dimensione della rete desiderata
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, come trovato nel componente Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, come trovato nel componente di routing di origine, se viene utilizzato il routing di origine
Regolazione di NVM3_DEFAULT_NVM_SIZE e NVM3_DEFAULT_CACHE_SIZE in base all'utilizzo di NVM3
- Ad esempio, dimensioni di rete superiori a 65 nodi richiedono probabilmente una dimensione NVM3 di 64K. La dimensione NVM3 predefinita in Silicon Labs Zigbee sample applicazioni è 32K. Le applicazioni che utilizzano NVM in modo più massiccio potrebbero richiedere di regolare questo valore ancora più in alto.
- Le reti di grandi dimensioni fino a 65 nodi potrebbero necessitare di una dimensione della cache NVM3 di 1200 byte; reti più grandi potrebbero richiedere di raddoppiare questo valore a 2400 byte.

Queste modifiche si applicano solo al Trust Center

Gateway multiprotocollo e RCP

Nuovi articoli
Abilitato il supporto GA SoC per BLE DMP con Zigbee + Openthread CMP con ascolto simultaneo su parti xG26. È stato aggiunto il supporto Debian alpha per le applicazioni Zigbeed, OTBR e Z3Gateway. Zigbeed e OTBR sono forniti anche nel formato pacchetto DEB per la piattaforma di riferimento scelta (Raspberry PI 4). Vedere Esecuzione di Zigbee, OpenThread e Bluetooth contemporaneamente su un host Linux con un coprocessore multiprotocollo, disponibile all'indirizzo docs.silabs.com, per i dettagli. Aggiunto supporto Zigbeed per Tizen-0.1-13.1 per arm32 e aarch64 e Android 12 per aarch64. Ulteriori informazioni su Zigbeed sono disponibili all'indirizzo docs.silabs.com. Aggiunto il nuovo componente "802.15.4 Unified radio scheduler priority". Questo componente è utilizzato per configurare le priorità radio di uno stack 15.4. Il componente richiede anche il nuovo componente "radio_priority_configurator". Questo componente consente ai progetti di utilizzare lo strumento Radio Priority Configurator in Simplicity Studio per configurare i livelli di priorità radio degli stack che lo richiedono.

Miglioramenti
La nota applicativa Esecuzione simultanea di Zigbee, OpenThread e Bluetooth su un host Linux con un coprocessore multiprotocollo (AN1333) è stata spostata in docs.silabs.com. Il supporto OpenWRT è ora di qualità GA. Il supporto OpenWRT è stato aggiunto per le applicazioni Zigbee, OTBR e Z3Gateway. Zigbeed e OTBR sono forniti anche in formato pacchetto IPK per la piattaforma di riferimento (Raspberry PI 4). Vedere Esecuzione di Zigbee, OpenThread e Bluetooth contemporaneamente su un host Linux con un coprocessore multiprotocollo, disponibile all'indirizzo docs.silabs.com, per dettagli.

Problemi risolti

Problemi noti nella versione corrente
I problemi in grassetto sono stati aggiunti dalla versione precedente. Se hai perso una versione, le note di rilascio recenti sono disponibili oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Articoli obsoleti
Il "Multiprotocol Container" attualmente disponibile su DockerHub (siliconlabsinc/multiprotocol) verrà deprecato in una prossima release. Il container non verrà più aggiornato e non potrà più essere estratto da DockerHub. I pacchetti basati su Debian per cpcd, ZigBee e ot-br-posix, insieme ai progetti generati e compilati in modo nativo, sostituiranno la funzionalità persa con la rimozione del container.

Utilizzo di questa versione

Questa versione contiene quanto segue:

Pila Zigbee
Quadro applicativo Zigbee
Zigbee Sample Applicazioni

Per ulteriori informazioni su Zigbee e EmberZNet SDK vedere UG103.02: Zigbee Fundamentals. Se sei un utente alle prime armi, consulta QSG180: Zigbee EmberZNet Guida rapida per SDK 7.0 e versioni successive, per istruzioni sulla configurazione dell'ambiente di sviluppo, sulla creazione e sul flashing comeampapplicazione le e riferimenti alla documentazione che puntano ai passaggi ext.

Installazione e utilizzo
Zigbee EmberZNet SDK è fornito come parte di Simplicity SDK, la suite di Silicon Labs SDK. Per iniziare rapidamente con Simplicity SDK, installa Simplicity Studio 5, che imposterà 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, IDE completo con toolchain GNU e strumenti di analisi. Le istruzioni di installazione sono fornite nella Guida utente di Simplicity Studio 5 online. In alternativa, Simplicity SDK può essere installato manualmente scaricando o clonando l'ultima versione da GitHub. Vedi https://github.com/SiliconLabs/simplicity_sdk per maggiori informazioni. Simplicity Studio installa l'SDK Simplicity per impostazione predefinita in:

(Windows): C:\Utenti\\SimplicityStudio\SDK\simplicity_sdk

(MacOS): /Utenti//SimplicityStudio/SDKs/simplicity_sdk

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

Informazioni sulla sicurezza
Integrazione del Vault sicuro
Per le applicazioni che scelgono di archiviare le chiavi in modo sicuro utilizzando il componente Secure Key Storage su parti Secure Vault-High, la tabella seguente mostra le chiavi protette e le relative caratteristiche di protezione dell'archiviazione gestite dal componente Zigbee Security Manager.Le chiavi incapsulate contrassegnate come "non esportabili" possono essere utilizzate ma non possono esserlo viewed o condivise in fase di esecuzione. Le chiavi wrappate contrassegnate come "Esportabili" possono essere utilizzate o condivise in fase di esecuzione, ma rimangono crittografate durante l'archiviazione in Flash. Le applicazioni utente non devono mai interagire con la maggior parte di queste chiavi. Le API esistenti per gestire le chiavi Link Key Table o Transient Key sono ancora disponibili per l'applicazione utente e sono instradate tramite il componente Zigbee Security Manager.

Consulenza sulla sicurezza
Per abbonarti agli avvisi di sicurezza, accedi al portale clienti di Silicon Labs, quindi seleziona Account Home. Fare clic su HOME per accedere alla home page del portale, quindi fare clic sul riquadro Gestisci notifiche. Assicurati che "Avvisi di avviso software/sicurezza e avvisi di modifica prodotto (PCN)" sia selezionato e che tu sia abbonato almeno alla tua piattaforma e al tuo protocollo. Fare clic su Salva per salvare eventuali modifiche.

Supporto
I clienti del kit di sviluppo hanno diritto alla formazione e al supporto tecnico. Utilizzare Zigbee di Silicon Laboratories web pagina per ottenere informazioni su tutti i prodotti e servizi Zigbee di Silicon Labs e per registrarsi per ricevere assistenza sui prodotti. Puoi contattare l'assistenza Silicon Laboratories all'indirizzo http://www.silabs.com/support.

Certificazione Zigbee
La versione Ember ZNet 8.1 è stata qualificata per la piattaforma conforme a Zigbee per architetture SoC, NC, P e RCP. Esiste un ID di certificazione ZCP associato a questa versione, controllare il CSA websito qui:
https://csa-iot.org/csa-iot_products/.

Si prega di notare che la certificazione ZCP è filed pubblica il comunicato e ci vogliono alcune settimane prima che venga riflesso sul CSA websito. Per ulteriori domande, contattare il supporto Silicon Laboratories all'indirizzo http://www.silabs.com/support.

Domande frequenti

D: Come posso aggiornare la dimensione della tabella delle chiavi di collegamento APS nell'SDK?
A: La dimensione della tabella delle chiavi di collegamento APS può essere configurata tramite il parametro SL_ZIGBEE_KEY_TABLE_SIZE. Nella versione 8.1, è stata ampliata da 127 a 254 voci.

D: Quali sono i miglioramenti della versione 8.1?
R: La versione 8.1 apporta miglioramenti come l'espansione della dimensione della tabella delle chiavi di collegamento APS, la ridenominazione dei componenti, l'aggiunta della protezione mutex per la coda degli eventi di Athepp Framework e altro ancora. Fare riferimento alle note di rilascio per un elenco dettagliato dei miglioramenti.

D: Come posso gestire i problemi risolti nell'SDK?
A: Problemi risolti nell'SDK, tra cui la risoluzione di potenziali problemi con la configurazione delle dimensioni della tabella dei vicini, la ridenominazione dei componenti, la correzione del sovraccarico del percorso sorgente, la gestione dei comandi ZCL e altro. Assicurati di aggiornare alla versione più recente per beneficiare di queste correzioni.

Documenti / Risorse

SILICON LABS Zigbee EmberZ Net SDK [pdf] Istruzioni
Zigbee EmberZ Net SDK, EmberZ Net SDK, SDK di rete, SDK

Riferimenti

Manuale d'uso

SILICON LABS Zigbee EmberZ Net SDK

Specifiche

Informazioni sul prodotto