Instrucciones del SDK Zigbee EmberZ Net de SILICON LABS

Silicon Labs es el proveedor elegido por los fabricantes de equipos originales que desarrollan redes Zigbee en sus productos. La plataforma Zigbee de Silicon Labs es la solución Zigbee más integrada, completa y con más funciones disponible. El SDK EmberZNet de Silicon Labs contiene la implementación de la especificación de la pila Zigbee de Silicon Labs.

CARACTERÍSTICAS PRINCIPALES

Zigbee

-250+ entradas en la tabla de claves de enlace APS
Compatibilidad con ZigbeeD en Android 12 (v21.0.6113669) y Tizen (v0.1-13.1)

Soporte del módulo xG26

Multiprotocolo

Compatibilidad con ZigbeeD y OTBR en OpenWRT – GA
DMP BLE + CMP ZB y Matter/OT con escucha simultánea en MG26 para SoC – GA

Componente de prioridad del programador de radio unificado 802.15.4
Compatibilidad de paquetes Debian para aplicaciones host MP – Alpha

Nuevos artículos

Cambios importantes
El tamaño de la tabla de claves de enlace APS (configurada mediante SL_ZIGBEE_KEY_TABLE_SIZE) se amplía de 127 a 254 entradas.

Se agregó compatibilidad con R23 para la funcionalidad de puesta en servicio de la red ZDD. La funcionalidad de tunelización está disponible sin compatibilidad para los casos de uso de la red heredada.

Los componentes Network Steering y Network Creator se han actualizado para incluir compatibilidad con la incorporación a R23. Estos incluyen los siguientes cambios relacionados.
- Se actualizó la política de solicitud de clave de enlace del Centro de confianza (TCLK) predeterminada para generar nuevas claves para cada dispositivo solicitante. Se genera una nueva clave cada vez que los dispositivos solicitantes intentan actualizar su clave de enlace del Centro de confianza.
- Debido al cambio de política anterior de TCLK, el componente de seguridad de Network Creator ahora requiere el componente de claves de enlace de seguridad. Las actualizaciones de aplicaciones se actualizarán para cumplir con este nuevo requisito.
- Una nueva configuración,
  Se agregó SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY para permitir la unión mediante una clave hash central. Esta configuración se encuentra en el componente Seguridad de Network Creator. El uso de esta política permite que cada dispositivo que se une reciba una clave TCLK única después de la unión, pero los intentos repetidos de actualizar la clave TCLK no darán como resultado una nueva clave para el dispositivo solicitante. Este uso de claves de enlace hash era la política predeterminada antes de esta versión, y el uso de esta política permite que el Centro de confianza evite incorporar el componente Claves de enlace de seguridad, que guarda las claves en Flash.
  NotaSilicon Labs no recomienda el uso de esta política, ya que impide que los dispositivos unidos ejecuten o actualicen sus TCLK.

Se agrega un nuevo conjunto de configuración al componente zigbee_ezsp_spi para permitir la configuración del dispositivo SPI host y sus interfaces de pin.
El examplos proyectos, incluido el proyecto files (.slcps) y la carpeta del proyecto se renombran según las pautas de nomenclatura de Silicon Labs y se mueven al directorio “proyectos”.

Soporte para nueva plataforma

Nuevos módulos
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nuevas placas de radio
- MGM260P-RB4350A
- MGM260P-RB4351A
Parte nueva
- efr32xg27
Kit Explorador
- BRD2709A
- MGM260P-EK2713A

Nueva documentación
Una nueva guía de usuario de EZSP UG600 para versiones 8.1 y superiores.

Mejoras

Los límites de SL_ZIGBEE_KEY_TABLE_SIZE se ampliaron hasta 254 entradas.
Se agregó zigbee_security_link_keys a Z3Light.
Se agregó zigbee_security_link_keys a zigbee_mp_z3_tc_z3_tc. También se actualizó el tamaño de la tabla de claves.
Se aumentó el tamaño de la tabla de claves de Z3 Gateway (que se establecerá en ncp) a 20.

Problemas solucionados

Problemas conocidos en la versión actual

Se agregaron problemas en negrita desde la versión anterior. Si se ha perdido una versión, las notas de la versión reciente están disponibles en https://www.silabs.com/developers/zigbee-emberznet en la pestaña Documentos técnicos.

Artículos en desuso

El componente zigbee_watchdog_periodic_refresh ya no se utiliza en el marco de la aplicación Zigbee y está obsoleto en esta versión. El temporizador de vigilancia está deshabilitado de forma predeterminada para todos los dispositivos.ampEn el futuro, se agregará al SDK un componente de vigilancia mejorado.
Nota: Habilite el temporizador de vigilancia con el elemento de configuración SL_LEGACY_HAL_DISABLE_WATCHDOG establecido en 0 en su aplicación

Limitaciones y consideraciones de la red

Las aplicaciones predeterminadas del Centro de confianza que se incluyen con esta versión de EmberZNet pueden admitir varios dispositivos en la red. Esta cantidad se determina en función de varios factores, incluidos los tamaños de tabla configurados, el uso de NVM y otros valores de tiempo de generación y tiempo de ejecución. Los usuarios que deseen crear redes grandes pueden enfrentar problemas de recursos al hacer que la red sea más grande de lo que la aplicación puede admitir. Por ejemplo,ampPor ejemplo, un dispositivo que solicita una clave de enlace del Centro de confianza puede activar una devolución de llamada sl_zigbee_af_zigbee_key_establishment_cb en el Centro de confianza con el estado h establecido en SL_ZIGBEE_KEY_TABLE_FULL, lo que indica que la tabla de claves no tiene espacio para agregar una nueva clave para el dispositivo solicitante o que NVM3 no tiene espacio disponible. Silicon Labs ofrece las siguientes recomendaciones para los usuarios que buscan crear redes grandes. Para las aplicaciones del Centro de confianza, se recomiendan las siguientes configuraciones. Estas recomendaciones no son exhaustivas y sirven como base para las aplicaciones que pretenden hacer crecer redes grandes.

Inclusión del componente Tabla de direcciones (zigbee_address_table), con
- El elemento de configuración SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE se establece en el tamaño de la red deseada
- el valor SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE establecido al máximo (4)

Inclusión del componente Security Link Keys (zigbee_security_link_keys), con
- El valor SL_ZIGBEE_KEY_TABLE_SIZE se establece en el tamaño de la red
Los siguientes elementos de configuración se establecen en el tamaño de la red deseada.
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, tal como se encuentra en el componente Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, tal como se encuentra en el componente de enrutamiento de origen, si se utiliza el enrutamiento de origen
Ajuste de NVM3_DEFAULT_NVM_SIZE y NVM3_DEFAULT_CACHE_SIZE según el uso de NVM3
- Por ejemplo, los tamaños de red mayores a 65 nodos probablemente requieran un tamaño NVM3 de 64K. El tamaño NVM3 predeterminado en Silicon Labs Zigbee sampEl tamaño máximo de las aplicaciones es de 32 K. Es posible que las aplicaciones que utilizan NVM de forma más intensiva deban ajustar este valor aún más.
- Las redes grandes de hasta 65 nodos pueden necesitar un tamaño de caché NVM3 de 1200 bytes; las redes que crecen más que eso pueden requerir duplicar este valor a 2400 bytes.

Estos ajustes se aplican únicamente al Centro de confianza

Pasarela multiprotocolo y RCP

Nuevos artículos
Se habilitó la compatibilidad de GA SoC para BLE DMP con Zigbee + Openthread CMP con escucha simultánea en partes xG26. Se agregó compatibilidad con Debian alpha para aplicaciones Zigbeed, OTBR y Z3Gateway. Zigbeed y OTBR también se proporcionan en formato de paquete DEB para la plataforma de referencia elegida (Raspberry PI 4). Consulte Ejecutar Zigbee, OpenThread y Bluetooth simultáneamente en un host Linux con un coprocesador multiprotocolo, que se encuentra en docs.silabs.com, para más detalles. Se agregó compatibilidad con Zigbeed para Tizen-0.1-13.1 para arm32 y aarch64, así como Android 12 para aarch64. Puede encontrar más información sobre Zigbeed en docs.silabs.comSe agregó el nuevo componente “Prioridad del programador de radio unificado 802.15.4”. Este componente se utiliza para configurar las prioridades de radio de una pila 15.4. El componente también requiere el nuevo componente “radio_priority_configurator”. Este componente permite que los proyectos utilicen la herramienta Configurador de prioridad de radio en Simplicity Studio para configurar los niveles de prioridad de radio de las pilas que lo requieren.

Mejoras
La nota de aplicación Ejecutar Zigbee, OpenThread y Bluetooth simultáneamente en un host Linux con un coprocesador multiprotocolo (AN1333) se ha movido a docs.silabs.com. La compatibilidad con OpenWRT ahora es de calidad GA. Se ha agregado compatibilidad con OpenWRT para aplicaciones Zigbee, OTBR y Z3Gateway. Zigbeed y OTBR también se proporcionan en formato de paquete IPK para la plataforma de referencia (Raspberry PI 4). Consulte Ejecución de Zigbee, OpenThread y Bluetooth simultáneamente en un host Linux con un coprocesador multiprotocolo, que se encuentra en docs.silabs.com, para detalles.

Problemas solucionados

Problemas conocidos en la versión actual
Los problemas en negrita se agregaron desde la versión anterior. Si se perdió una versión, las notas de la versión reciente están disponibles aquíhttps://www.silabs.com/developers/simplicity-software-development-kit.

Artículos en desuso
El “Contenedor multiprotocolo” que actualmente está disponible en DockerHub (siliconlabsinc/multiprotocol) quedará obsoleto en una próxima versión. El contenedor ya no se actualizará ni se podrá extraer de DockerHub. Los paquetes basados en Debian para cpcd, ZigBee y ot-br-posix, junto con los proyectos generados y compilados de forma nativa, reemplazarán la funcionalidad perdida con la eliminación del contenedor.

Uso de esta versión

Esta versión contiene lo siguiente:

Pila Zigbee
Marco de aplicación Zigbee
Zigbee SampAplicaciones

Para obtener más información sobre Zigbee y el SDK de EmberZNet, consulte UG103.02: Fundamentos de Zigbee. Si es la primera vez que lo utiliza, consulte QSG180: Guía de inicio rápido de Zigbee EmberZNet para SDK 7.0 y superior, para obtener instrucciones sobre cómo configurar su entorno de desarrollo, compilar y actualizar comoampla aplicación y las referencias de documentación que apuntan a los pasos ext.

Instalación y uso
El SDK Zigbee EmberZNet se proporciona como parte del SDK Simplicity, el conjunto de SDK de Silicon Labs. Para comenzar rápidamente con el SDK Simplicity, instale Simplicity Studio 5, que configurará su entorno de desarrollo y lo guiará en la instalación del SDK Simplicity. Simplicity Studio 5 incluye todo lo necesario para el desarrollo de productos de IoT con dispositivos de Silicon Labs, incluido un lanzador de recursos y proyectos, herramientas de configuración de software, IDE completo con cadena de herramientas GNU y herramientas de análisis. Las instrucciones de instalación se proporcionan en la Guía del usuario de Simplicity Studio 5 en línea. Alternativamente, el SDK Simplicity se puede instalar manualmente descargando o clonando la versión más reciente de GitHub. Consulte https://github.com/SiliconLabs/simplicity_sdk Para obtener más información, Simplicity Studio instala el SDK de Simplicity de forma predeterminada en:

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

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

La documentación específica de la versión del SDK se instala con el SDK. A menudo, se puede encontrar información adicional en los artículos de la base de conocimientos (KBA). Las referencias de API y otra información sobre esta y versiones anteriores están disponibles en https://docs.silabs.com/.

Información de seguridad
Integración de bóveda segura
Para las aplicaciones que eligen almacenar claves de forma segura utilizando el componente Secure Key Storage en partes Secure Vault-High, la siguiente tabla muestra las claves protegidas y sus características de protección de almacenamiento que administra el componente Zigbee Security Manager.Las claves envueltas que están marcadas como "No exportables" se pueden usar pero no se pueden viewLas claves encapsuladas que están marcadas como "Exportables" se pueden usar o compartir en tiempo de ejecución, pero permanecen cifradas mientras se almacenan en Flash. Las aplicaciones de usuario nunca necesitan interactuar con la mayoría de estas claves. Las API existentes para administrar las claves de la tabla de claves de enlace o las claves transitorias aún están disponibles para la aplicación de usuario y se enrutan a través del componente Zigbee Security Manager.

Avisos de seguridad
Para suscribirse a los avisos de seguridad, inicie sesión en el portal de clientes de Silicon Labs y luego seleccione Inicio de cuenta. Haga clic en INICIO para ir a la página de inicio del portal y luego haga clic en el mosaico Administrar notificaciones. Asegúrese de que esté marcado "Avisos de aviso de seguridad/software y avisos de cambio de producto (PCN)" y que esté suscrito como mínimo para su plataforma y protocolo. Haga clic en Guardar para guardar los cambios.

Apoyo
Los clientes del kit de desarrollo son elegibles para recibir capacitación y soporte técnico. Utilice el Zigbee de Silicon Laboratories web Página para obtener información sobre todos los productos y servicios Zigbee de Silicon Labs y para registrarse para recibir asistencia técnica sobre productos. Puede ponerse en contacto con el servicio de asistencia técnica de Silicon Laboratories en http://www.silabs.com/support.

Certificación Zigbee
La versión Ember ZNet 8.1 ha sido calificada para la plataforma compatible con Zigbee para arquitecturas SoC, NC, P y RCP. Hay una identificación de certificación ZCP vinculada a esta versión; consulte la CSA. websitio aquí:
https://csa-iot.org/csa-iot_products/.

Tenga en cuenta que la certificación ZCP es filed publica el comunicado, y tarda algunas semanas antes de que se refleje en el CSA webSitio. Para cualquier otra consulta, comuníquese con el soporte de Silicon Laboratories al http://www.silabs.com/support.

Preguntas frecuentes

P: ¿Cómo actualizo el tamaño de la tabla de claves de enlace APS en el SDK?
A: El tamaño de la tabla de claves de enlace APS se puede configurar mediante el parámetro SL_ZIGBEE_KEY_TABLE_SIZE. En la versión 8.1, se ha ampliado de 127 a 254 entradas.

P: ¿Cuáles son las mejoras en la versión 8.1?
R: La versión 8.1 incluye mejoras como la ampliación del tamaño de la tabla de claves de vínculos de APS, el cambio de nombre de los componentes, la incorporación de protección de exclusión mutua para la cola de eventos de Athe pp Framework y más. Consulte las notas de la versión para obtener una lista detallada de las mejoras.

P: ¿Cómo puedo gestionar los problemas solucionados en el SDK?
A: Se solucionaron problemas en el SDK, como la resolución de posibles problemas con la configuración del tamaño de la tabla vecina, el cambio de nombre de los componentes, la corrección de la sobrecarga de la ruta de origen, el manejo de comandos ZCL y más. Asegúrese de actualizar a la última versión para beneficiarse de estas correcciones.

Documentos / Recursos

Kit de desarrollo de software Zigbee EmberZ Net de Silicon Labs [pdf] Instrucciones
SDK de red Zigbee EmberZ, SDK de red EmberZ, SDK de red, SDK

Referencias

Manual de usuario

Kit de desarrollo de software Zigbee EmberZ Net de Silicon Labs

Presupuesto

Información del producto