SILICON LABS Zigbee EmberZ Net SDK Instrucións

Silicon Labs é o provedor preferido para os OEM que desenvolven redes Zigbee nos seus produtos. A plataforma Zigbee de Silicon Labs é a solución Zigbee máis integrada, completa e rica en funcións dispoñible. O SDK EmberZNet de Silicon Labs contén a implementación de Silicon Labs da especificación de pila Zigbee.

CARACTERÍSTICAS CLAVE

Zigbee

-250+ entradas na táboa de claves de ligazón APS
Compatibilidade con ZigbeeD en Android 12 (v21.0.6113669) e Tizen (v0.1-13.1)

Soporte do módulo xG26

Multiprotocolo

Soporte de ZigbeeD e OTBR en OpenWRT - GA
DMP BLE + CMP ZB e Matter/OT con escoita simultánea en MG26 para SoC – GA

802.15.4 Compoñente prioritario do programador de radio unificado
Compatibilidade con paquetes Debian para aplicacións host MP - Alpha

Novos Elementos

Cambios importantes
O tamaño da táboa de claves de ligazón APS (configurado mediante SL_ZIGBEE_KEY_TABLE_SIZE) amplíase de 127 a 254 entradas.

Engádese soporte R23 para a funcionalidade de posta en servizo da rede ZDD. A funcionalidade de tunelización está dispoñible sen compatibilidade con casos de uso da Rede Legacy.

Actualizáronse os compoñentes de Network Steering e Network Creator para incluír compatibilidade coa unión R23. Estes inclúen os seguintes cambios relacionados.
- Actualizouse a política de solicitude predeterminada da clave de ligazón do centro de confianza (TCLK) para xerar novas claves para cada dispositivo solicitante. Xérase unha nova chave cada vez que os dispositivos solicitantes intentan actualizar a súa clave de ligazón do centro de confianza.
- Debido ao cambio anterior da política de TCLK, o compoñente de seguranza do creador de rede agora require o compoñente Chaves de ligazón de seguranza. A actualización das aplicacións actualizarase para cumprir este novo requisito.
- Unha nova configuración,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY engádese para permitir a unión mediante unha clave básica con hash. Esta configuración atópase baixo o compoñente Network Creator Security. O uso desta política permite que cada dispositivo que se une a recibir un TCLK único despois da unión, pero os intentos repetidos de actualizar o TCLK non darán lugar a unha nova clave para o dispositivo solicitante. Este uso de chaves de ligazón hash era a política predeterminada antes desta versión, e o uso desta política permite que o Centro de confianza evite incorporar o compoñente Chaves de ligazón de seguranza, que garda as claves en Flash.
  Nota: Silicon Labs non recomenda o uso desta política, xa que isto impide que os dispositivos que se unen a rodar ou actualizar os seus TCLK.

Engádese un novo conxunto de configuración ao compoñente zigbee_ezsp_spi para permitir a configuración do dispositivo SPI host e as súas interfaces pin.
O example proxectos, incluído o proxecto files (.slcps) e o cartafol do proxecto, pasan a chamarse as directrices de nomeamento de Silicon Labs e móvense ao directorio "proxectos".

Nova plataforma de soporte

Novos módulos
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Novas placas de radio
- MGM260P-RB4350A
- MGM260P-RB4351A
Nova parte
- efr32xg27
Kit explorador
- BRD2709A
- MGM260P-EK2713A

Nova Documentación
Unha nova guía de usuario de EZSP UG600 para as versións 8.1 e posteriores.

Melloras

Límites SL_ZIGBEE_KEY_TABLE_SIZE expandidos ata 254 entradas.
Engadíronse zigbee_security_link_keys a Z3Light.
Engadíronse zigbee_security_link_keys a zigbee_mp_z3_tc_z3_tc. Tamén actualizou o tamaño da súa táboa de claves.
Aumentou o tamaño da táboa de claves da pasarela Z3 (que se establecerá en ncp) a 20.

Problemas solucionados

Problemas coñecidos na versión actual

Engadíronse problemas en negra desde a versión anterior. Se perdeches unha versión, as notas de lanzamento recente están dispoñibles en https://www.silabs.com/developers/zigbee-emberznet na pestana Documentos técnicos.

Elementos obsoletos

O compoñente zigbee_watchdog_periodic_refresh xa non se utiliza no marco da aplicación Zigbee e está obsoleto nesta versión. O temporizador watchdog está desactivado por defecto para todos os sampas aplicacións. No futuro engadirase ao SDK un compoñente de control mellorado.
Nota: habilite o temporizador de control co elemento de configuración SL_LEGACY_HAL_DISABLE_WATCHDOG establecido en 0 na súa aplicación

Limitacións e consideracións da rede

As aplicacións de Trust Center predeterminadas que se entregan con esta versión de EmberZNet son capaces de admitir varios dispositivos na rede. Este número determínase en función de varios factores, incluídos os tamaños de táboa configurados, o uso de NVM e outros valores de tempo de xeración e de execución. Os usuarios que buscan crear redes grandes poden enfrontarse a problemas de recursos ao aumentar a rede máis grande do que a aplicación pode soportar. Por exampun dispositivo que solicite unha clave de ligazón do centro de confianza do centro de confianza pode desencadear unha devolución de chamada sl_zigbee_af_zigbee_key_establishment_cb no centro de confianza co estado h definido como SL_ZIGBEE_KEY_TABLE_FULL, o que indica que a táboa de claves non ten espazo para engadir unha nova clave para o dispositivo solicitante ou que NVM3 non ten espazo dispoñible. Silicon Labs ofrece as seguintes recomendacións para os usuarios que buscan crear redes grandes. Para as aplicacións do Centro de confianza, recoméndase as seguintes configuracións. Estas recomendacións non son exhaustivas e serven como base para as aplicacións que pretenden facer crecer redes grandes.

Inclusión do compoñente Táboa de enderezos (zigbee_address_table), con
- o elemento de configuración SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE definido co tamaño da rede desexada
- o valor SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE definido como máximo (4)

Inclusión do compoñente Chaves de ligazón de seguranza (zigbee_security_link_keys), con
- O valor SL_ZIGBEE_KEY_TABLE_SIZE establécese co tamaño da rede
Os seguintes elementos de configuración están configurados co tamaño da rede desexada
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, como se atopa no compoñente Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, como se atopa no compoñente de enrutamento de orixe, se se utiliza o enrutamento de orixe
Axuste de NVM3_DEFAULT_NVM_SIZE e NVM3_DEFAULT_CACHE_SIZE segundo o uso de NVM3
- Por exemplo, os tamaños de rede superiores a 65 nodos probablemente requiran un tamaño NVM3 de 64K. O tamaño predeterminado de NVM3 en Silicon Labs Zigbee sampas aplicacións son 32K. As aplicacións que usan NVM de forma máis intensa poden requirir axustar este valor aínda máis.
- As redes grandes de ata 65 nodos poden necesitar un tamaño de caché NVM3 de 1200 bytes; Crecer redes máis grandes que iso pode requirir duplicar este valor ata 2400 bytes.

Estes axustes só aplícanse ao Centro de confianza

Pasarela multiprotocolo e RCP

Novos Elementos
Compatibilidade con SoC GA activada para BLE DMP con Zigbee + Openthread CMP con escoita simultánea en pezas xG26. Engadiuse soporte alfa de Debian para as aplicacións Zigbeed, OTBR e Z3Gateway. Zigbeed e OTBR tamén se proporcionan en formato de paquete DEB para a plataforma de referencia escollida (Raspberry PI 4). Consulte Execución de Zigbee, OpenThread e Bluetooth simultáneamente nun host Linux cun coprocesador multiprotocolo, que se atopa en docs.silabs.com, para máis detalles. Engadiuse compatibilidade con Zigbeed para Tizen-0.1-13.1 para arm32 e aarch64, así como Android 12 para aarch64. Podes atopar máis información sobre Zigbeed en docs.silabs.com. Engadiuse o novo compoñente "802.15.4 Unified radio scheduler priority". Este compoñente úsase para configurar as prioridades de radio dunha pila 15.4. O compoñente tamén require o novo compoñente "radio_priority_configurator". Este compoñente permite aos proxectos utilizar a ferramenta Radio Priority Configurator en Simplicity Studio para configurar os niveis de prioridade de radio das pilas que o requiren.

Melloras
Nota da aplicación A execución de Zigbee, OpenThread e Bluetooth simultáneamente nun host Linux cun coprocesador multiprotocolo (AN1333) moveuse a docs.silabs.com. O soporte de OpenWRT agora é de calidade GA. Engadiuse compatibilidade con OpenWRT para aplicacións Zigbee, OTBR e Z3Gateway. Zigbeed e OTBR tamén se proporcionan en formato de paquete IPK para a plataforma de referencia (Raspberry PI 4). Consulte Execución de Zigbee, OpenThread e Bluetooth simultáneamente nun host Linux cun coprocesador multiprotocolo, que se atopa en docs.silabs.com, para máis detalles.

Problemas solucionados

Problemas coñecidos na versión actual
Engadíronse problemas en negra desde a versión anterior. Se perdeches un lanzamento, as notas de lanzamento recentes están dispoñibleshttps://www.silabs.com/developers/simplicity-software-development-kit.

Elementos obsoletos
O "Contedor multiprotocolo" que está dispoñible actualmente en DockerHub (siliconlabsinc/multiprotocol) quedará en desuso nunha próxima versión. O contedor xa non se actualizará e poderá extraerse de DockerHub. Os paquetes baseados en Debian para cpcd, ZigBee e ot-br-posix, xunto cos proxectos xerados e compilados nativamente, substituirán a funcionalidade perdida coa eliminación do contedor.

Usando esta versión

Esta versión contén o seguinte:

Pila Zigbee
Marco de aplicación Zigbee
Zigbee Sample Aplicacións

Para obter máis información sobre Zigbee e o SDK de EmberZNet, consulte UG103.02: Fundamentos de Zigbee. Se es un usuario por primeira vez, consulte QSG180: Guía de inicio rápido de Zigbee EmberZNet para SDK 7.0 e superior, para obter instrucións sobre como configurar o seu contorno de desenvolvemento, construír e flashear comoample e referencias de documentación que sinalan os pasos ext.

Instalación e Uso
O SDK de Zigbee EmberZNet ofrécese como parte do SDK Simplicity, o conxunto de SDK de Silicon Labs. Para comezar rapidamente co Simplicity SDK, instala Simplicity Studio 5, que configurará o teu ambiente de desenvolvemento e guiarache pola instalación do Simplicity SDK. Simplicity Studio 5 inclúe todo o necesario para o desenvolvemento de produtos IoT con dispositivos de Silicon Labs, incluíndo un lanzador de recursos e proxectos, ferramentas de configuración de software, IDE completo con cadea de ferramentas GNU e ferramentas de análise. As instrucións de instalación ofrécense na Guía do usuario de Simplicity Studio 5 en liña. Alternativamente, o Simplicity SDK pódese instalar manualmente descargando ou clonando o máis recente de GitHub. Vexa https://github.com/SiliconLabs/simplicity_sdk para máis información. Simplicity Studio instala o Simplicity SDK de forma predeterminada en:

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

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

A documentación específica da versión do SDK instálase co SDK. A miúdo pódese atopar información adicional nos artigos da base de coñecemento (KBA). Referencias da API e outra información sobre esta e versións anteriores están dispoñibles aquí https://docs.silabs.com/.

Información de seguridade
Integración segura de Vault
Para as aplicacións que optan por almacenar as claves de forma segura mediante o compoñente Secure Key Storage en pezas Secure Vault-High, a seguinte táboa mostra as claves protexidas e as súas características de protección de almacenamento que xestiona o compoñente Zigbee Security Manager.Pódense usar as claves envolvedas que están marcadas como "Non exportables", pero non vieweditado ou compartido en tempo de execución. As claves empaquetadas que están marcadas como "Exportábeis" pódense usar ou compartir durante a execución, pero permanecen cifradas mentres se almacenan en Flash. As aplicacións de usuario nunca precisan interactuar coa maioría destas claves. As API existentes para xestionar as claves da táboa de claves de enlace ou as claves transitorias aínda están dispoñibles para a aplicación do usuario e non se encamiñan a través do compoñente de xestor de seguranza de Zigbee.

Avisos de seguridade
Para subscribirse a Avisos de seguridade, inicie sesión no portal de clientes de Silicon Labs e, a continuación, seleccione Inicio da conta. Fai clic en INICIO para ir á páxina de inicio do portal e, a continuación, fai clic no mosaico Xestionar notificacións. Asegúrese de que "Avisos de asesoramento de software/seguridade e avisos de cambio de produto (PCN)" estea marcado e de que estea subscrito como mínimo para a súa plataforma e protocolo. Fai clic en Gardar para gardar os cambios.

Apoio
Os clientes do kit de desenvolvemento poden recibir formación e soporte técnico. Use o Silicon Laboratories Zigbee web páxina para obter información sobre todos os produtos e servizos de Silicon Labs Zigbee e rexistrarse para obter asistencia do produto. Podes contactar co soporte de Silicon Laboratories en http://www.silabs.com/support.

Certificación Zigbee
A versión 8.1 de Ember ZNet calificouse para a plataforma compatible con Zigbee para arquitecturas SoC, NC, P e RCP. Hai un ID de certificación ZCP vinculado a esta versión. Comprobe o CSA. websitio aquí:
https://csa-iot.org/csa-iot_products/.

Teña en conta que a certificación ZCP é filed publicar o lanzamento e tarda unhas semanas en reflectirse no CSA websitio. Para máis consultas, póñase en contacto co soporte de Silicon Laboratories en http://www.silabs.com/support.

Preguntas frecuentes

P: Como actualizo o tamaño da táboa de claves de ligazón APS no SDK?
R: O tamaño da táboa de claves de ligazón APS pódese configurar mediante o parámetro SL_ZIGBEE_KEY_TABLE_SIZE. Na versión 8.1, ampliouse de 127 a 254 entradas.

P: Cales son as melloras na versión 8.1?
R: A versión 8.1 trae melloras como ampliar o tamaño da táboa de claves de ligazón APS, renomear compoñentes, engadir protección mutex para a cola de eventos de Athe pp Framework e moito máis. Consulte as notas da versión para obter unha lista detallada de melloras.

P: Como podo tratar os problemas solucionados no SDK?
R: Solucionáronse problemas no SDK, incluíndo a resolución de problemas potenciais coa configuración do tamaño da táboa veciña, o cambio de nome dos compoñentes, a corrección da sobrecarga da ruta de orixe, o manexo de comandos ZCL e moito máis. Asegúrate de actualizar á versión máis recente para beneficiarte destas correccións.

Documentos/Recursos

SILICON LABS Zigbee EmberZ Net SDK [pdfInstrucións
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referencias

Manual de usuario

SILICON LABS Zigbee EmberZ Net SDK

Especificacións

Información do produto