SILICON LABS Zigbee EmberZ Net SDK Instruccions

Silicon Labs és el venedor escollit per als OEM que desenvolupen xarxes Zigbee als seus productes. La plataforma Zigbee de Silicon Labs és la solució Zigbee més integrada, completa i rica en funcions disponible. El SDK de Silicon Labs EmberZNet conté la implementació de Silicon Labs de l'especificació de pila Zigbee.

CARACTERÍSTIQUES CLAU

Zigbee

-250+ entrades a la taula de claus d'enllaç APS
Compatibilitat amb ZigbeeD a Android 12 (v21.0.6113669) i Tizen (v0.1-13.1)

Suport del mòdul xG26

Multiprotocol

Suport ZigbeeD i OTBR a OpenWRT - GA
DMP BLE + CMP ZB i Matter/OT amb escolta simultània a MG26 per a SoC – GA

802.15.4 Component de prioritat del programador de ràdio unificat
Suport de l'empaquetament de Debian per a aplicacions d'amfitrió MP - Alpha

Articles nous

Canvis importants
La mida de la taula de claus d'enllaç APS (configurada mitjançant SL_ZIGBEE_KEY_TABLE_SIZE) s'amplia de 127 a 254 entrades.

S'afegeix suport R23 per a la funcionalitat de posada en marxa de la xarxa ZDD. La funcionalitat de túnel està disponible sense suport per als casos d'ús de la xarxa heretada.

Els components Network Steering i Network Creator s'han actualitzat per incloure suport per a la unió a R23. Aquests inclouen els següents canvis relacionats.
- La política de sol·licitud de la clau d'enllaç del centre de confiança (TCLK) predeterminada s'ha actualitzat per generar claus noves per a cada dispositiu sol·licitant. Es genera una clau nova cada vegada que els dispositius sol·licitants intenten actualitzar la seva clau d'enllaç del centre de confiança.
- A causa del canvi de política TCLK anterior, el component de seguretat del creador de la xarxa ara requereix el component Claus d'enllaç de seguretat. L'actualització de les aplicacions s'actualitzarà per adaptar-se a aquest nou requisit.
- Una nova configuració,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY s'afegeix per permetre unir-se mitjançant una clau bàsica amb hash. Aquesta configuració es troba al component Network Creator Security. L'ús d'aquesta política permet que cada dispositiu que s'uneixi rebi un TCLK únic després de la unió, però els intents repetits d'actualitzar el TCLK no donaran lloc a una nova clau per al dispositiu sol·licitant. Aquest ús de claus d'enllaç hash era la política predeterminada abans d'aquest llançament, i l'ús d'aquesta política permet que el Centre de confiança no introdueixi el component Claus d'enllaç de seguretat, que desa les claus a Flash.
  Nota: Silicon Labs no recomana l'ús d'aquesta política, ja que això impedeix que els dispositius que s'uneixin incorporin o actualitzin els seus TCLK.

S'afegeix un nou conjunt de configuració al component zigbee_ezsp_spi per permetre la configuració del dispositiu SPI amfitrió i les seves interfícies de pins.
L'exampels projectes, inclòs el projecte files (.slcps) i la carpeta del projecte, es canvien de nom a les directrius de nomenclatura de Silicon Labs i es mouen al directori "projectes".

Nova plataforma de suport

Nous mòduls
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Noves plaques de ràdio
- MGM260P-RB4350A
- MGM260P-RB4351A
Part nova
- efr32xg27
Kit d'explorador
- BRD2709A
- MGM260P-EK2713A

Nova documentació
Una nova guia d'usuari EZSP UG600 per a les versions 8.1 i posteriors.

Millores

SL_ZIGBEE_KEY_TABLE_SIZE límits ampliats fins a 254 entrades.
S'han afegit zigbee_security_link_keys a Z3Light.
S'han afegit zigbee_security_link_keys a zigbee_mp_z3_tc_z3_tc. També s'ha actualitzat la mida de la taula de claus.
S'ha augmentat la mida de la taula de claus de la passarel·la Z3 (que s'establirà en ncp) a 20.

Problemes solucionats

Problemes coneguts a la versió actual

S'han afegit problemes en negreta des de la versió anterior. Si us heu perdut una versió, les notes de la versió recent estan disponibles a https://www.silabs.com/developers/zigbee-emberznet a la pestanya Tech Docs.

Elements obsolets

El component zigbee_watchdog_periodic_refresh ja no s'utilitza al marc de l'aplicació Zigbee i està obsolet en aquesta versió. El temporitzador de vigilant està desactivat per defecte per a tots els samples aplicacions. En el futur s'afegirà un component de control millorat a l'SDK.
Nota: habiliteu el temporitzador de control amb l'element de configuració SL_LEGACY_HAL_DISABLE_WATCHDOG establert a 0 a la vostra aplicació

Limitacions i consideracions de la xarxa

Les aplicacions per defecte del Trust Center que s'envien amb aquesta versió d'EmberZNet són capaços de donar suport a diversos dispositius a la xarxa. Aquest nombre es determina en funció de diversos factors, com ara la mida de la taula configurada, l'ús de NVM i altres valors de temps de generació i temps d'execució. Els usuaris que busquen crear xarxes grans poden tenir problemes de recursos quan fan créixer la xarxa més gran del que l'aplicació pot suportar. Per exampun dispositiu que sol·liciti una clau d'enllaç del centre de confiança des del centre de confiança pot desencadenar una devolució de trucada sl_zigbee_af_zigbee_key_establishment_cb al centre de confiança amb l'estat h establert en SL_ZIGBEE_KEY_TABLE_FULL, indicant que la taula de claus no té espai per afegir una clau nova per al dispositiu sol·licitant o que NVM3 no té espai disponible. Silicon Labs ofereix les recomanacions següents per als usuaris que busquen crear xarxes grans. Per a les aplicacions del Centre de confiança, es recomanen les configuracions següents. Aquestes recomanacions no són exhaustives i serveixen de base per a aplicacions que pretenen fer créixer grans xarxes.

Inclusió del component Taula d'adreces (zigbee_address_table), amb
- l'element de configuració SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE establert a la mida de la xarxa desitjada
- el valor SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE establert com a màxim (4)

Inclusió del component Claus d'enllaç de seguretat (zigbee_security_link_keys), amb
- El valor SL_ZIGBEE_KEY_TABLE_SIZE s'estableix a la mida de la xarxa
Els elements de configuració següents s'estableixen a la mida de la xarxa desitjada
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, tal com es troba al component Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, tal com es troba al component d'encaminament d'origen, si s'utilitza l'encaminament d'origen
Ajust de NVM3_DEFAULT_NVM_SIZE i NVM3_DEFAULT_CACHE_SIZE segons l'ús de NVM3
- Per exemple, les mides de xarxa superiors a 65 nodes probablement requereixen una mida NVM3 de 64K. La mida NVM3 predeterminada a Silicon Labs Zigbee samples aplicacions són 32K. És possible que les aplicacions que utilitzen NVM més intensament requereixin ajustar aquest valor encara més.
- Les xarxes grans de fins a 65 nodes poden necessitar una mida de memòria cau NVM3 de 1200 bytes; El creixement de xarxes més grans que això pot requerir duplicar aquest valor a 2400 bytes.

Aquests ajustos només s'apliquen al Centre de confiança

Gateway multiprotocol i RCP

Articles nous
S'ha activat el suport de GA SoC per a BLE DMP amb Zigbee + Openthread CMP amb escolta simultània a parts xG26. S'ha afegit suport alfa de Debian per a les aplicacions Zigbeed, OTBR i Z3Gateway. Zigbeed i OTBR també es proporcionen en format de paquet DEB per a la plataforma de referència escollida (Raspberry PI 4). Vegeu Execució de Zigbee, OpenThread i Bluetooth simultàniament en un host Linux amb un coprocessador multiprotocol, que es troba a docs.silabs.com, per a més detalls. S'ha afegit el suport de Zigbeed per a Tizen-0.1-13.1 per a arm32 i aarch64, així com per a Android 12 per a aarch64. Podeu trobar més informació sobre Zigbeed a docs.silabs.com. S'ha afegit el nou component "802.15.4 Unified radio scheduler priority". Aquest component s'utilitza per configurar les prioritats de ràdio d'una pila 15.4. El component també requereix el nou component "radio_priority_configurator". Aquest component permet als projectes utilitzar l'eina Radio Priority Configurator a Simplicity Studio per configurar els nivells de prioritat de ràdio de les piles que ho requereixen.

Millores
Nota de l'aplicació L'execució de Zigbee, OpenThread i Bluetooth simultàniament en un host Linux amb un coprocessador multiprotocol (AN1333) s'ha mogut a docs.silabs.com. El suport OpenWRT ara és de qualitat GA. S'ha afegit suport OpenWRT per a aplicacions Zigbee, OTBR i Z3Gateway. Zigbeed i OTBR també es proporcionen en format de paquet IPK per a la plataforma de referència (Raspberry PI 4). Vegeu Execució de Zigbee, OpenThread i Bluetooth simultàniament en un host Linux amb un coprocessador multiprotocol, que es troba a docs.silabs.com, per als detalls.

Problemes solucionats

Problemes coneguts a la versió actual
S'han afegit problemes en negreta des de la versió anterior. Si us heu perdut un llançament, les notes de llançament recents estan disponibleshttps://www.silabs.com/developers/simplicity-software-development-kit.

Elements obsolets
El "Contenidor multiprotocol" que està disponible actualment a DockerHub (siliconlabsinc/multiprotocol) quedarà obsolet en un proper llançament. El contenidor ja no s'actualitzarà i es podrà extreure de DockerHub. Els paquets basats en Debian per a cpcd, ZigBee i ot-br-posix, juntament amb els projectes generats i compilats de manera nativa, substituiran la funcionalitat perduda amb l'eliminació del contenidor.

Utilitzant aquesta versió

Aquesta versió conté el següent:

Pila Zigbee
Marc d'aplicacions Zigbee
Zigbee Samples aplicacions

Per obtenir més informació sobre Zigbee i l'SDK d'EmberZNet, consulteu UG103.02: Fonaments de Zigbee. Si sou per primera vegada, consulteu QSG180: Guia d'inici ràpid de Zigbee EmberZNet per a SDK 7.0 i superior, per obtenir instruccions sobre com configurar el vostre entorn de desenvolupament, crear i flashejar com aampl'aplicació i referències de documentació que apunten als passos posteriors.

Instal·lació i ús
El Zigbee EmberZNet SDK es proporciona com a part del Simplicity SDK, el conjunt d'SDK de Silicon Labs. Per començar ràpidament amb Simplicity SDK, instal·leu Simplicity Studio 5, que configurarà el vostre entorn de desenvolupament i us guiarà per la instal·lació de Simplicity SDK. Simplicity Studio 5 inclou tot el necessari per al desenvolupament de productes IoT amb dispositius Silicon Labs, inclòs un llançador de recursos i projectes, eines de configuració de programari, IDE complet amb cadena d'eines GNU i eines d'anàlisi. Les instruccions d'instal·lació es proporcionen a la Guia de l'usuari de Simplicity Studio 5 en línia. Alternativament, Simplicity SDK es pot instal·lar manualment baixant o clonant el més recent de GitHub. Mireu https://github.com/SiliconLabs/simplicity_sdk per a més informació. Simplicity Studio instal·la el Simplicity SDK de manera predeterminada a:

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

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

La documentació específica de la versió de l'SDK s'instal·la amb l'SDK. Sovint es pot trobar informació addicional als articles de la base de coneixement (KBA). Hi ha disponibles referències de l'API i altra informació sobre aquesta i versions anteriors https://docs.silabs.com/.

Informació de seguretat
Integració segura de Vault
Per a les aplicacions que opten per emmagatzemar les claus de manera segura mitjançant el component Secure Key Storage a les peces Secure Vault-High, la taula següent mostra les claus protegides i les seves característiques de protecció d'emmagatzematge que gestiona el component Zigbee Security Manager.Les claus embolicades que estan marcades com a "No exportables" es poden utilitzar però no vieweditat o compartit en temps d'execució. Les claus embolcallades que estan marcades com a "Exportable" es poden utilitzar o compartir en temps d'execució, però romanen xifrades mentre s'emmagatzemen a Flash. Les aplicacions d'usuari mai han d'interaccionar amb la majoria d'aquestes claus. Les API existents per gestionar les claus de la taula de claus d'enllaç o les claus transitòries encara estan disponibles per a l'aplicació d'usuari i no s'envien a través del component de Zigbee Security Manager.

Avisos de seguretat
Per subscriure's a Avisos de seguretat, inicieu sessió al portal de clients de Silicon Labs i, a continuació, seleccioneu Inici del compte. Feu clic a INICI per anar a la pàgina d'inici del portal i, a continuació, feu clic a la fitxa Gestiona les notificacions. Assegureu-vos que "Avisos d'assessorament de programari/seguretat i avisos de canvi de producte (PCN)" estigui marcat i que esteu subscrit com a mínim a la vostra plataforma i protocol. Feu clic a Desa per desar els canvis.

Suport
Els clients del kit de desenvolupament poden rebre formació i suport tècnic. Utilitzeu el Zigbee de Silicon Laboratories web pàgina per obtenir informació sobre tots els productes i serveis de Silicon Labs Zigbee i registrar-se per obtenir assistència per al producte. Podeu contactar amb l'assistència de Silicon Laboratories a http://www.silabs.com/support.

Certificació Zigbee
La versió 8.1 d'Ember ZNet s'ha qualificat per a la plataforma compatible amb Zigbee per a arquitectures SoC, NC, P i RCP. Hi ha un identificador de certificació ZCP vinculat a aquesta versió; si us plau, comproveu la CSA. weblloc aquí:
https://csa-iot.org/csa-iot_products/.

Tingueu en compte que la certificació ZCP és filed publicar el llançament i triga unes quantes setmanes abans de reflectir-se en el CSA weblloc. Per a qualsevol consulta addicional, poseu-vos en contacte amb l'assistència de Silicon Laboratories a http://www.silabs.com/support.

Preguntes freqüents

P: Com actualitzo la mida de la taula de claus d'enllaç APS a l'SDK?
R: La mida de la taula de claus d'enllaç APS es pot configurar mitjançant el paràmetre SL_ZIGBEE_KEY_TABLE_SIZE. A la versió 8.1, s'ha ampliat de 127 a 254 entrades.

P: Quines són les millores de la versió 8.1?
R: La versió 8.1 aporta millores com ara ampliar la mida de la taula de claus d'enllaç APS, canviar el nom dels components, afegir protecció mutex per a la cua d'esdeveniments d'Athe pp Framework i molt més. Consulteu les notes de la versió per obtenir una llista detallada de millores.

P: Com puc gestionar els problemes solucionats a l'SDK?
R: S'han solucionat problemes a l'SDK, com ara la resolució de problemes potencials amb la configuració de la mida de la taula veïna, el canvi de nom dels components, la correcció de la sobrecàrrega de la ruta d'origen, la gestió d'ordres ZCL i molt més. Assegureu-vos d'actualitzar a la darrera versió per beneficiar-vos d'aquestes correccions.

Documents/Recursos

SILICON LABS Zigbee EmberZ Net SDK [pdfInstruccions
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referències

Manual d'usuari

SILICON LABS Zigbee EmberZ Net SDK

Especificacions

Informació del producte