SILICON LABS Zigbee EmberZ Net SDK Istruzzioni

Silicon Labs hè u venditore di scelta per i OEM chì sviluppanu a rete Zigbee in i so prudutti. A piattaforma Zigbee di Silicon Labs hè a suluzione Zigbee più integrata, cumpleta è ricca di funzioni disponibile. U Silicon Labs EmberZNet SDK cuntene l'implementazione di Silicon Labs di a specificazione di stack Zigbee.

CARATTERISTICHE CHIAVE

Zigbee

-250+ entrate in a tabella di chjave di ligame APS
Supportu ZigbeeD in Android 12 (v21.0.6113669) è Tizen (v0.1-13.1)

Supportu di u Modulu xG26

Multiprotocolu

Supportu ZigbeeD è OTBR nantu à OpenWRT - GA
DMP BLE + CMP ZB & Matter / OT cù Ascolta Concurrente nantu à MG26 per SoC - GA

802.15.4 Componente di priorità di pianificazione radio unificata
Supportu di imballaggio Debian per l'applicazioni MP host - Alpha

Articuli novi

Cambiamenti impurtanti
A dimensione di a tabella di chjave di ligame APS (cunfigurata cù SL_ZIGBEE_KEY_TABLE_SIZE) hè allargata da 127 à 254 entrate.

U supportu R23 hè aghjuntu per a funziunalità di cumissioni di a rete ZDD. A funziunalità di Tunneling hè dispunibule senza supportu per i casi d'usu di Legacy Network.

I cumpunenti Network Steering è Network Creator sò stati aghjurnati per include supportu per l'unione R23. Questi includenu i seguenti cambiamenti cunnessi.
- A pulitica predeterminata di dumanda di a chjave di u ligame di u centru di fiducia (TCLK) hè stata aghjurnata per generà chjavi novi per ogni dispositivu dumanda. Una nova chjave hè generata ogni volta chì i dispositi dumandati tentanu d'aghjurnà a so Chjave di Link di Trust Center.
- A causa di u cambiamentu di pulitica TCLK precedente, u cumpunente di Sicurezza di u Creatore di a Rete necessita avà u cumpunente di Chjavi di Link di Sicurezza. L'aghjurnamentu di l'applicazioni serà aghjurnatu per cunfurmà cù stu novu requisitu.
- Una nova cunfigurazione,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY hè aghjuntu per permette di unisce aduprendu un core, chjave hashed. Sta cunfigurazione si trova sottu u cumpunente Network Creator Security. L'usu di sta pulitica permette à ogni dispusitivu di unisce riceve un unicu TCLK post-join, ma i tentativi ripetuti di aghjurnà u TCLK ùn anu micca risultatu in una nova chjave per u dispusitivu dumanda. Questu usu di e chjavi di ligame hashed era a pulitica predeterminata prima di sta liberazione, è l'usu di sta pulitica permette à u Centru di Fiducia per evità di portà in u cumpunente Chjavi di Link di Sicurezza, chì salva e chjave in Flash.
  Nota: Silicon Labs ùn ricumandemu micca l'usu di sta pulitica, postu chì questu impedisce à i dispositi di unisce da rollu, o aghjurnà, i so TCLK.

Un novu set di cunfigurazione hè aghjuntu à u cumpunente zigbee_ezsp_spi per permette a cunfigurazione di u dispositivu SPI host è e so interfacce pin.
L'exampi prughjetti, cumpresi u prugettu files (.slcps) è u cartulare di prughjetti, sò rinominati à i guidelines di nomi di Silicon Labs è sò spustati sottu u cartulare "prughjetti".

A nova piattaforma di supportu

Moduli novi
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nove schede radio
- MGM260P-RB4350A
- MGM260P-RB4351A
Parte nova
- efr32xg27
Kit Explorer
- BRD2709A
- MGM260P-EK2713A

Nova Documentazione
Un novu utilizatori EZSP guida UG600 per versioni 8.1 è sopra.

Migliuramentu

SL_ZIGBEE_KEY_TABLE_SIZE limiti allargati finu à 254 voci.
Aggiuntu zigbee_security_link_keys à Z3Light.
Aggiuntu zigbee_security_link_keys à zigbee_mp_z3_tc_z3_tc. Aghjurnatu ancu a so dimensione di a tavola chjave.
Aumentatu a dimensione di a tavola di chjave Z3 Gateway (chì serà impostata à ncp) à 20.

Problemi fissi

Problemi cunnisciuti in a versione attuale

I prublemi in grassu sò stati aghjunti da a versione precedente. Se avete mancatu una liberazione, e note di liberazione recenti sò dispunibili à https://www.silabs.com/developers/zigbee-emberznet in a tabulazione Tech Docs.

Articuli obsoleti

U cumpunente zigbee_watchdog_periodic_refresh ùn hè più utilizatu in u quadru di l'applicazione Zigbee è hè obsoletu in questa versione. U timer watchdog hè disattivatu per difettu per tutti i sample applicazioni. Ci sarà un cumpunente di watchdog mejoratu aghjuntu à u SDK in u futuru.
Nota: Attivate u timer watchdog cù l'elementu di cunfigurazione SL_LEGACY_HAL_DISABLE_WATCHDOG pusatu à 0 in a vostra applicazione

Limitazioni è Considerazioni di a Rete

L'applicazioni predeterminate di Trust Center chì venenu spedite cù questa liberazione EmberZNet sò capaci di sustene parechji dispositi in a reta. Stu numeru hè determinatu basatu annantu à parechji fatturi, cumprese dimensioni di tavule cunfigurate, usu NVM, è altri valori di tempu di generazione è run-time. L'utilizatori chì cercanu di creà grandi rete ponu affruntà prublemi di risorse quandu crescenu a reta più grande di l'applicazione pò sustene. Per esample, un dispositivu chì dumanda una Chjave di Link di u Centru di Fiducia da u Centru di Fiducia pò attivà una callback sl_zigbee_af_zigbee_key_establishment_cb in u Centru di Fiducia cù u statutu h impostatu à SL_ZIGBEE_KEY_TABLE_FULL, chì indica chì a tavola di chjave ùn hà micca spaziu per aghjunghje una nova chjave per u dispositivu dumandante o chì NVM3 ùn hà micca spaziu dispunibule. Silicon Labs furnisce i seguenti cunsiglii per l'utilizatori chì cercanu di creà grandi rete. Per l'applicazioni Trust Center, e seguenti cunfigurazioni sò cunsigliate. Queste raccomandazioni ùn sò micca exhaustive, è servenu cum'è una basa per l'applicazioni chì intendenu cultivà e grande rete.

Inclusione di u cumpunente di Tabella di Indirizzu (zigbee_address_table), cù
- l'elementu di cunfigurazione SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE stabilitu à a dimensione di a reta desiderata
- u valore SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE stabilitu à u massimu (4)

Inclusione di u cumpunente Chjavi di Link di Sicurezza (zigbee_security_link_keys), cù
- U valore SL_ZIGBEE_KEY_TABLE_SIZE hè stabilitu à a dimensione di a reta
I seguenti elementi di cunfigurazione sò stabiliti à a dimensione di a reta desiderata
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, cum'è truvatu in u cumpunente Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, cum'è truvata in u cumpunente di routing Source, se u routing di origine hè utilizatu
Ajustamentu di NVM3_DEFAULT_NVM_SIZE è NVM3_DEFAULT_CACHE_SIZE secondu l'usu NVM3
- Per esempiu, e dimensioni di a rete più grande di i nodi 65 probabilmente necessitanu una dimensione NVM3 di 64K. A dimensione predeterminata NVM3 in Silicon Labs Zigbee sampl'applicazioni hè 32K. L'applicazioni chì utilizanu NVM più pesante pò esse bisognu di aghjustà stu valore ancu più altu.
- Grandi reti finu à i nodi 65 ponu avè bisognu di una dimensione di cache NVM3 di 1200 bytes; e rete crescente più grande di quellu pò esse bisognu di duppià stu valore à 2400 bytes.

Questi aghjustamenti si applicanu solu à u Trust Center

Gateway multiprotocolu è RCP

Articuli novi
Abilitatu u supportu GA SoC per BLE DMP cù Zigbee + Openthread CMP cù ascolta simultanea in parti xG26. U supportu alfa di Debian hè statu aghjuntu per l'applicazioni Zigbeed, OTBR è Z3Gateway. Zigbeed è OTBR sò furniti in formatu di pacchettu DEB per a piattaforma di riferimentu scelta (Raspberry PI 4). Vede Running Zigbee, OpenThread, è Bluetooth Concurrently in un Host Linux cù un Co-Processor Multiprotocol, truvata in docs.silabs.com, per i dettagli. Aggiuntu supportu Zigbeed per Tizen-0.1-13.1 per arm32 è aarch64 è ancu Android 12 per aarch64. Più infurmazione nantu à Zigbeed pò esse truvata à docs.silabs.com. Aggiuntu u novu cumpunente "802.15.4 Unified radio scheduler priority". Stu cumpunente hè utilizatu per cunfigurà e priorità radio di una pila 15.4. U cumpunente richiede ancu u novu cumpunente "radio_priority_configurator". Stu cumpunente permette à i prughjetti di utilizà l'uttellu Radio Priority Configurator in Simplicity Studio per cunfigurà i livelli di priorità radio di e pile chì ne necessitanu.

Migliuramentu
Nota di l'applicazione L'esecuzione di Zigbee, OpenThread è Bluetooth simultaneamente in un Host Linux cù un Co-Processore Multiprotocolu (AN1333) hè stata spustata à docs.silabs.com. U supportu OpenWRT hè issa qualità GA. U supportu OpenWRT hè statu aghjuntu per l'applicazioni Zigbee, OTBR è Z3Gateway. Zigbeed è OTBR sò furniti in u formatu di pacchettu IPK per a piattaforma di riferimentu (Raspberry PI 4). Vede Running Zigbee, OpenThread, è Bluetooth Concurrently in un Host Linux cù un Co-Processor Multiprotocol, truvata in docs.silabs.com, per i dettagli.

Problemi fissi

Problemi cunnisciuti in a versione attuale
I prublemi in grassu sò stati aghjunti da a versione precedente. Se avete mancatu una liberazione, e note di liberazione recenti sò dispunibilihttps://www.silabs.com/developers/simplicity-software-development-kit.

Articuli obsoleti
U "Container Multiprotocol" chì hè attualmente dispunibule nantu à DockerHub (siliconlabsinc/multiprotocol) serà obsoletu in una prossima versione. U cuntinuu ùn serà più aghjurnatu è puderà esse tiratu da DockerHub. I pacchetti basati in Debian per cpcd, ZigBee è ot-br-posix, cù i prughjetti generati è compilati nativamente, rimpiazzaranu a funziunalità persa cù a rimuzione di u cuntinuu.

Utilizendu sta versione

Questa liberazione cuntene i seguenti:

Stack Zigbee
Framework di l'applicazione Zigbee
Zigbee Sample Applicazioni

Per più infurmazione nantu à Zigbee è l'EmberZNet SDK vede UG103.02: Zigbee Fundamentals. Sè vo site un utilizatore per a prima volta, vede QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, per struzzioni nantu à cunfigurà u vostru ambiente di sviluppu, custruendu è lampendu cum'èampl'applicazione, è riferimenti di documentazione chì puntanu à i passi ext.

Installazione è usu
U Zigbee EmberZNet SDK hè furnitu cum'è parte di Simplicity SDK, a suite di Silicon Labs SDKs. Per cumincià rapidamente cù u Simplicity SDK, installate Simplicity Studio 5, chì stabiliscerà u vostru ambiente di sviluppu è vi guiderà per l'installazione di Simplicity SDK. Simplicity Studio 5 include tuttu ciò chì hè necessariu per u sviluppu di produttu IoT cù i dispositi di Silicon Labs, cumprese un lanciatore di risorse è di prughjettu, strumenti di cunfigurazione di software, IDE cumpletu cù a catena di strumenti GNU, è strumenti di analisi. Istruzzioni di stallazione sò furnite in a Guida d'Usuariu di Simplicity Studio 5 in linea. In alternativa, Simplicity SDK pò esse installatu manualmente scarichendu o clonendu l'ultime da GitHub. Vede https://github.com/SiliconLabs/simplicity_sdk per più infurmazione. Simplicity Studio installa u Simplicity SDK per difettu in:

(Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

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

A documentazione specifica per a versione SDK hè stallata cù u SDK. L'infurmazione supplementaria pò esse spessu truvata in l'articuli di basa di cunniscenza (KBA). I riferimenti API è altre informazioni nantu à questu è e versioni precedenti sò dispunibuli nantu https://docs.silabs.com/.

Informazioni di sicurezza
Integrazione sicura di Vault
Per l'applicazioni chì sceglienu di almacenà e chjave in modu sicuru utilizendu u cumpunente Secure Key Storage nantu à e parti Secure Vault-High, a tavula seguente mostra e chjavi protetti è e so caratteristiche di prutezzione di almacenamiento chì u cumpunente di Zigbee Security Manager gestisce.I chjavi imballati chì sò marcati cum'è "Non-Exportable" ponu esse aduprati ma ùn ponu micca esse viewed o spartutu in runtime. I chjavi imballati chì sò marcati cum'è "Esportabili" ponu esse aduprati o spartuti in runtime, ma restanu criptati mentre sò almacenati in Flash. L'applicazioni d'utilizatori ùn anu mai bisognu di interagisce cù a maiò parte di sti chjavi. L'API esistenti per gestisce e chjavi di a Tabella di Chjave di Link o Chjavi transitori sò sempre dispunibuli per l'applicazione d'utilizatore è ùn sò micca instradati attraversu u cumpunente Zigbee Security Manager.

Cunsiglii di Sicurezza
Per abbonate à i Cunsiglii di Sicurezza, accede à u portale di i clienti di Silicon Labs, dopu selezziunate Account Home. Cliccate HOME per andà à a pagina di casa di u portale è dopu cliccate nantu à u tile Manage Notifications. Assicuratevi chì "Software/Security Advisory Notices & Product Change Notices (PCNs)" hè verificatu, è chì site sottumessi à u minimu per a vostra piattaforma è u protokollu. Cliccate Salvà per salvà qualsiasi cambiamenti.

Supportu
I clienti di u Kit di Sviluppu sò eligibili per a furmazione è u supportu tecnicu. Aduprate u Silicon Laboratories Zigbee web pagina per uttene infurmazioni nantu à tutti i prudutti è servizii di Silicon Labs Zigbee, è per firmà per u sustegnu di u produttu. Pudete cuntattà u supportu di Silicon Laboratories à http://www.silabs.com/support.

Certificazione Zigbee
A versione Ember ZNet 8.1 hè stata qualificata per a Piattaforma Conforme à Zigbee per l'architetture SoC, NC, P è RCP, ci hè un ID di certificazione ZCP legatu à questa versione, verificate u CSA. websitu quì:
https://csa-iot.org/csa-iot_products/.

Per piacè nutate chì a certificazione ZCP hè filed post a liberazione, è piglia uni pochi di settimane prima di esse riflessu nantu à u CSA websitu. Per ogni altra dumanda, cuntattate u supportu di Silicon Laboratories à http://www.silabs.com/support.

FAQs

Q: Cumu aghjurnà a dimensione di a tavola di chjave di ligame APS in u SDK?
A: A dimensione di a tavola di chjave di ligame APS pò esse cunfigurata cù u paràmetru SL_ZIGBEE_KEY_TABLE_SIZE. In a versione 8.1, hè stata allargata da 127 à 254 voci.

Q: Chì sò i megliurenze in a versione 8.1?
A: A versione 8.1 porta miglioramenti cum'è l'espansione di a dimensione di a tavola chjave di ligame APS, rinominà i cumpunenti, aghjunghjendu a prutezzione di mutex per a fila di eventi Athe pp Framework, è più. Consultate e note di liberazione per una lista dettagliata di migliure.

Q: Cumu possu trattà e prublemi fissi in u SDK?
A: Problemi risolti in u SDK cumpresi risolve i prublemi potenziali cù a cunfigurazione di a dimensione di a tavola vicine, rinuminà i cumpunenti, riparà a strada di surghjente, gestione di cumandamenti ZCL, è più. Assicuratevi di aghjurnà à l'ultima versione per prufittà di sti correzioni.

Documenti / Risorse

SILICON LABS Zigbee EmberZ Net SDK [pdf] Istruzzioni
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referenze

Manuale d'usu

SILICON LABS Zigbee EmberZ Net SDK

Specificazioni

Informazione di u produttu