SILICON LABS SDK 7.4.1.0 GA Software de pila de protocolo Zigbee

Información do produto

Especificacións

• Versión do SDK de Zigbee EmberZNet: 7.4.1.0
• Versión Gecko SDK Suite: 4.4 - 14 de febreiro de 2024
• Vendedor: Silicon Labs
• Características principais: Soporte multiprotocolo Zigbee e OpenThread en SoC
• Compiladores compatibles: Versión GCC 12.2.1
• Versión do protocolo EZSP: 0x0D

Instrucións de uso do produto

Avisos de compatibilidade e uso

• Para obter actualizacións e avisos de seguranza, consulte o capítulo Seguridade das notas de lanzamento da plataforma Gecko instaladas con este SDK ou visite a pestana DOCUMENTOS TÉCNICOS en Silicon Labs. websitio.
• Mantéñase actualizado subscribindo-se a Avisos de seguridade.

FAQ

• Pregunta: Como comprobo o correcto files están sendo usados ​​cos compiladores compatibles?
• Resposta: Podes verificar que é correcto files están a ser usados ​​comprobando a versión 12.2.1 de GCC proporcionada con Simplicity Studio.
• Pregunta: Onde podo atopar información sobre actualizacións de seguranza e avisos?
• Resposta: Para obter actualizacións e avisos de seguranza, consulte o capítulo Seguridade das notas de lanzamento da plataforma Gecko ou visite a pestana DOCUMENTOS TÉCNICOS en Silicon Labs. websitio.

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.
Silicon Labs EmberZNet SDK contén a implementación de Silicon Labs da especificación de pila Zigbee.

• Estas notas de publicación abarcan as versións do SDK:
• 7.4.1.0 lanzado o 14 de febreiro de 2024
• 7.4.0.0 lanzado o 13 de decembro de 2023

CARACTERÍSTICAS CLAVE

Zigbee

• Conformidade con Zigbee R23
• Conformidade Zigbee Smart Energy 1.4a - produción
• Conformidade con Zigbee GP 1.1.2 - Alpha
• Soporte MG27 - produción
• Compatibilidade mellorada para pezas de Secure Vault
• Soporte soñoliento en aplicacións NCP SPI (non CPC) - Alpha

Multiprotocolo

• Soporte de audición simultánea (RCP) - MG21 e MG24
• Multiprotocolo simultáneo (CMP) Zigbee NCP + OpenThread RCP - produción
• Multiprotocolo dinámico Bluetooth + Multiprotocolo simultáneo (CMP) Soporte Zigbee e OpenThread en SoC

Avisos de compatibilidade e uso

Para obter información sobre as actualizacións de seguranza e os avisos, consulte o capítulo Seguridade das Notas da versión da plataforma Gecko instaladas con este SDK ou na pestana DOCUMENTOS TÉCNICOS en https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs tamén recomenda encarecidamente que se subscriba aos Avisos de seguridade para obter información actualizada. Para obter instrucións ou se é novo no SDK de Zigbee EmberZNet, consulte Usar esta versión.

Compiladores compatibles

• IAR Embedded Workbench for ARM (IAR-EWARM) versión 9.40.1.
• Usar Wine para compilar coa utilidade de liña de comandos IarBuild.exe ou a GUI de IAR Embedded Workbench en macOS ou Linux pode producir un resultado incorrecto. files se está utilizando debido a colisións no algoritmo de hash de Wine para xerar curtos file nomes.
• Recoméndase aos clientes en macOS ou Linux que non creen con IAR fóra de Simplicity Studio. Os clientes que o fagan deben verificar coidadosamente que o correcto files están sendo usados.

GCC (The GNU Compiler Collection) versión 12.2.1, proporcionada con Simplicity Studio.
A versión do protocolo EZSP para esta versión é 0x0D.

Novos Elementos

Esta versión do Gecko SDK (GSDK) será a última con compatibilidade combinada para todos os dispositivos EFM e EFR, agás os parches para esta versión segundo sexa necesario. A partir de mediados de 2024, introduciremos SDK separados:

• O SDK Gecko existente continuará co soporte para os dispositivos das Series 0 e 1.
• Un novo SDK atenderá especificamente aos dispositivos das Series 2 e 3.

O SDK de Gecko seguirá admitindo todos os dispositivos das Series 0 e 1 sen cambios no soporte a longo prazo, o mantemento, a calidade e a capacidade de resposta que ofrece a nosa política de software.
O novo SDK derivará do Gecko SDK e comezará a ofrecer novas funcións que axudan aos desenvolvedores a sacar vantaxetage das capacidades avanzadas dos nosos produtos das Series 2 e 3.
Esta decisión está aliñada cos comentarios dos clientes, que reflicte o noso compromiso de elevar a calidade, garantir a estabilidade e mellorar o rendemento para unha experiencia de usuario excepcional nos nosos SDK de software.

Novos Compoñentes

Novo no lanzamento 

• Engadíronse os compoñentes "zigbee_direct_security_p256" e "zigbee_direct_security_curve25519" para que os usuarios poidan configurar unha opción de seguranza específica de Zigbee Direct.
• Os usuarios poden ter activados varios compoñentes "zigbee_direct_security" nunha aplicación de dispositivo directo de Zigbee (ZDD). Neste caso, a opción de seguranza real depende da configuración do dispositivo virtual de Zigbee (ZVD).

Novas API
Novo no lanzamento 

• Engadiuse unha nova API sl_zigbee_token_factory_reset para restablecer os tokens Zigbee NVM3 ao seu valor predeterminado.
• Engadiuse a API bool sl_zigbee_sec_man_link_key_slot_available(EmberEUI64 eui), que devolve verdadeiro se a táboa de claves de ligazón pode engadir ou actualizar unha entrada con este enderezo (a táboa non está chea).
• Engadiuse unha nova API bool sl_zb_sec_man_compare_key_to_value (contexto sl_zb_sec_man_context_t*, chave sl_zb_sec_man_key_t*), que devolve verdadeiro se a clave se fai referencia por contexto ten o mesmo valor que a clave proporcionada no argumento.

Nova plataforma de soporte
Novo no lanzamento 

• Nesta versión engádese compatibilidade con Zigbee Stack para as seguintes pezas novas: EFR32MG24A010F768IM40 e EFR32MG24A020F768IM40.

Nova Documentación
Novo na versión 7.4.0.0

• Actualizouse a descrición do compoñente Zigbee Secure Key Storage para reflectir a adición de Zigbee Secure Key Storage Upgrade (que engade compatibilidade con proxectos existentes).
• Engadiuse unha nova nota de aplicación para interactuar co grupo de compoñentes de Zigbee Security Manager (AN1412: Zigbee Security Manager).

Comportamento previsto

Lémbrase aos usuarios que as transmisións CSL non sincronizadas de Zigbee están suxeitas á preferencia do protocolo no programador de radio. Nas aplicacións SleepyToSleepy, BLE pode anticipar unha transmisión CSL de Zigbee, o que finalizará a transmisión. A preferencia do programador é máis común para CSL non sincronizado, dado que se pode usar unha secuencia de cadros de activación potencialmente longa. Os usuarios que desexen axustar as prioridades de transmisión poden utilizar o compoñente Axuste e probas DMP para facelo. Os usuarios tamén poden consultar UG305: Dynamic Multiprotocol User's Guide para obter máis información.

Melloras

Modificado na versión
Cambios na documentación da API emberCounterHandler

Nas versións anteriores, a devolución de chamada do Counter Handler para os EmberCounterTypes da capa MAC e APS relativas a paquetes RX e TX non se lle pasaba o ID de nodo de destino ou os argumentos de datos axeitados, e a documentación da API relativa ao comportamento de certos contadores que usaban estes parámetros era pouco clara ou enganosa.
Aínda que a sinatura de emberCounterHandler() non cambiou, a forma en que se enchen os seus parámetros cambiou lixeiramente.

• Os comentarios sobre as enumeracións de EmberCounterType en ember-types.h ampliáronse para que se aclare.
• O parámetro Node ID para o Counter Handler para contadores relacionados con TX agora comproba se o modo de enderezo de destino indica un ID curto válido antes de usalo. (Se non, non se encherá ningún enderezo de destino e no seu lugar úsase un valor de marcador de posición EMBER_UNKNOWN_NODE_ID).
• O parámetro ID de nodo para o manejador de contadores para contadores relacionados con RX agora reflicte o ID de nodo de orixe, non o de destino.
• O reconto de reintentos *non* se pasa como parámetro de datos para os contadores EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED, tal e como se describe nos tipos ember. h en versións anteriores, pero isto nunca se encheu correctamente en versións publicadas anteriormente, polo que o seu valor en versións anteriores sempre sería 0. Este comportamento aclarouse na descrición deses EmberCounterTypes. Non obstante, o reconto de reintentos para os reintentos de capa APS segue enchendo no parámetro de datos dos tipos de contador EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED, para ser coherente coas versións anteriores.
• Todos os contadores que enchen o ID de nodo ou o parámetro de datos para a devolución de chamada foron auditados para asegurarse de que pasan os datos, o enderezo ou o EMBER_UNKNOWN_NODE_ID esperados se se esperaba un ID de nodo pero non se puido obter do paquete, como se describe no documento revisado. tipos.h documentación.
• O controlador de contador para EMBER_COUNTER_MAC_TX_UNICAST_RETRY agora reflicte correctamente o ID do nodo de destino da capa MAC e varios reintentos no seu ID de nodo de destino e nos parámetros de datos.
• O controlador de contador para EMBER_COUNTER_PHY_CCA_FAIL_COUNT agora fornece información de ID de nodo de destino a través do parámetro ID de nodo sobre o destino da capa MAC previsto da mensaxe que fallou a transmisión.

Código de enerxía verde actualizado
O código do servidor de enerxía verde actualízase con varias melloras, incluíndo:

• Engadiuse máis código de validación para os comandos entrantes cun punto final non válido ao recibir no servidor GP.
• Engadido código para xestionar o caso cando non hai máis espazo para construír mensaxes de enerxía verde.
• O receptor agora elimina a configuración de emparejamento coa acción de eliminar o emparejamento nalgúns casos segundo a sección de especificacións A.3.5.2.4.1.
• Agora o lavabo garda a lista de grupos existente dunha entrada antes de eliminala ao procesar a configuración de emparejamento coa acción de ampliación.
• O comando de consulta de tradución devolve "NO FOUND" como código de erro cando a táboa de tradución está baleira ou o índice é maior que varias entradas da táboa.
• Cambiouse a versión do punto final de GP nalgunhas aplicacións de 1 a 0.

O uso de CSMA na función de envío GPDF está restrinxido porque os dispositivos de enerxía verde son dispositivos de enerxía mínima e non usan CSMA na maioría dos deseños. Pola contra, o deseño preferido é enviar varios paquetes usando o mesmo orzamento de enerxía.
Eliminouse o uso dun punto final oculto na opción do complemento Green Power Server. No seu lugar, use un dos puntos finais da aplicación.
Melloras do código do complemento de actualización da clave de rede

• Cambiouse o período de actualización periódica da clave de rede para que sexa de ata 1 ano.

Reestruturáronse algunhas API para evitar a exportación de chaves innecesarias
Realizáronse cambios para favorecer o uso de contextos clave fronte aos datos clave de texto sinxelo.

• sl_zigbee_send_security_challenge_request agora toma un argumento sl_zb_sec_man_context_t en lugar de EmberKeyData.
• Os valores da enumeración sl_zb_sec_man_derived_key_type agora son unha máscara de bits de 16 bits para admitir directamente determinadas derivacións de clave que combinan varios tipos derivados.

Problemas solucionados

Corrixido na versión 

número de identificación	Descrición
1036893	Solucionouse un problema que facía que o compoñente do clúster OTA instalase o compoñente da interface do cargador de arranque heredado como dependencia.
1114905	Zigbee Direct: mellor xestión da característica Leave Network.
1180937	Corrixiuse o reinicio de WDT ao conectar Zigbee Direct ZDD a ZVD de terceiros.
1223904	Solucionouse un problema que facía que o dispositivo final se movese para funcionar incorrectamente nun ambiente moi ocupado.
1224393	Actualizouse o código do manejador de solicitudes da táboa de sumidoiros de Green Power para actualizar o enderezo de destino da resposta.
1228808	Solucionouse o problema de visualización coas definicións de macros na documentación de gp-types.h.
1232297	Solucionouse un problema no que emberSetOutgoingNwkFrameCounter e emberSetOutgoingApsFrameCounter non funcionaban en aplicacións host de 64 bits (retornando EMBER_BAD_ARGUMENT).
1232359	Corrixiuse o cálculo do parámetro gppTunnelingDelay no procesamento de comandos do cliente de enerxía verde.
1240392	As solicitudes de vinculación/desvinculación de ZDO rexeitadas por motivos de acceso/permiso deberían devolver o estado EMBER_ZDP_NOT_AUTHORIZED en lugar do estado EMBER_ZDP_NOT_PERMITTED segundo as especificacións de Zigbee.
1243523	Zigbee Direct: mellora da estabilidade da conexión BLE a ZVD.
1249455	Solucionouse un problema que facía que un dispositivo de final insonorizado entrase en suspensión ao recibir unha emisión antes de recibir un ack.
1252295	Corrixe un erro de tipografía na macro do catálogo de compoñentes SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT.

Corrixido na versión 

número de identificación	Descrición
1019348	Corrixíronse os requisitos de dependencia para o compoñente Zigbee ZCL Cli para que se poida eliminar cando non sexa necesario.
1024246	Actualizouse a descrición da función para emberHaveLinkKey() e sl_zb_sec_man_have_link_key().
1036503	Engadiuse unha descrición para recomendar o uso do núcleo de Microum para os DMPampas aplicacións.
1037661	Solucionouse un problema que impedía que a aplicación instalase a pila profesional ou a pila de follas.
1078136	Corrixiuse un fallo intermitente ao modificar eventos desde o contexto de interrupción
1081548	Lémbrase aos usuarios que as transmisións CSL non sincronizadas de Zigbee están suxeitas á preferencia do protocolo no programador de radio. Nas aplicacións SleepyToSleepy, BLE pode anticipar unha transmisión CSL de Zigbee, o que finalizará a transmisión. A preferencia do programador é máis común para CSL non sincronizado, dado que se pode usar unha secuencia de cadros de activación potencialmente longa. Os usuarios que desexen axustar as prioridades de transmisión poden utilizar o compoñente Axuste e probas DMP para facelo. Os usuarios tamén poden consultar UG305: Dynamic Multiprotocol User's Guide para obter máis información. Solucionouse un problema en CSL no que unha nova secuencia de cadros de activación que se recibe inmediatamente despois dun cadro de carga útil anterior non se gravaría correctamente. Isto daría lugar a unha trama de carga útil perdida.
1084111	Como parte desta versión actualízase a compatibilidade inicial SPI-NCP soñola para placas baseadas en MG24.
1104056	Engadido soporte para a dirección de rede para executarse nunha rede secundaria en caso de multi-rede
1120515	Solucionouse un problema no que a canle non cambiaba ao usar o comando mfglib set-channel.
1141109	Solucionouse un problema que provocaba o s xeradoampa aplicación ncp-uart-gp-multi-rail para perder algunha cabeceira files cando se utiliza o compoñente adaptador de enerxía verde coa opción -cp.
1144316	Actualizouse a descrición dalgúns tipos de estrutura de datos na documentación de gp-types.h.
1144884	Fixouse o conxunto de bits pendentes de marco espurio cando non hai datos pendentes.
1152512	Corrixiuse un posible accidente en low-mac-rail ao modificar o evento no contexto ISR.

número de identificación	Descrición
1154616	Engadiuse unha excepción á condición de inicializar a rede co caso "Cambio de función de dispositivo Sleepy End a dispositivo Non-sleepy".
1157289	Solucionouse un problema que podía provocar un fallo da proba BDB DN-TLM-TC-02B.
1157426	Solucionouse un problema de compilación ao crear zigbee_simple_app co compoñente green_power_adapter.
1157932	Engadiuse unha condición para comprobar se falta o campo "tempo de transición" e estableceu un valor predeterminado de 0xFFFF para este campo que falta.
1166340	Solucionouse un problema que impedía que emberAfGpdfSend enviara o número previsto de transmisións repetidas.
1167807	Solucionouse un problema no que os dispositivos que actuaban como centros de confianza en redes distribuídas borrarían incorrectamente as súas claves de ligazón transitoria cada vez que se unía un dispositivo novo.
1169504	Solucionouse un problema que provocaba o reinicio dun dispositivo durmido ao espertar forzadamente.
1169966	Corrixiuse a falta de validación do valor de retorno no código de asignación do búfer.
1171477, 172270	Con mfglib start 1 non se transmiten mensaxes pero se reciben, polo que a mensaxe de terminal mostrada "mfglib send complete" é incorrecta e cambiou a "RXed %d paquetes nos últimos %d ms".
1171935	Cambiouse o período de actualización periódica da clave de rede para que sexa de ata 1 ano.
1172778	Engadiuse a invocación faltante do emberAfPluginGreenPowerServerUpdateAliasCallback ao servidor Green Power.
1174288	Solucionouse un problema que facía que o proceso de dirección da rede afirmase se se chamaba unha chamada para deter unha exploración en curso.
1178393	Actualizouse un erro de documentación.
1180445	En Smart Energy, OTA continúa descargando se o coordinador alcanza o ciclo de traballo limitado.
1185509	Solucionouse un problema en CSL no que unha nova secuencia de cadros de activación que se recibía inmediatamente despois dun cadro de carga útil anterior non se gravaba correctamente. Isto daría lugar a unha trama de carga útil perdida.
1186107	Solucionouse un problema que facía que o descifrado non satisfactorio dos GPDF recibidos substituíse o GPDF entrante na notificación de posta en servizo do gp.
1188397	Solucionouse un problema que provocaba un erro de compilación ao activar o tamaño da táboa de informes estendidos.
1194090	Corrixiuse o estado de fallo na resposta predeterminada para o comando Sink Commissioning Mode, seguindo a sección 3.3.4.8.2
1194963	Solucionouse un problema que memetría a estrutura de commissioningGpd antes de chamar á devolución de chamada do usuario emberAfGreenPowerServerPairingStatusCallback.
1194966	Solucionouse un problema no que os campos do punto final e dos proxies implicados non estaban configurados coa acción Saír da posta en servizo.
1196698	Corrixiuse un conxunto de bits pendentes de marco espurio cando non había datos pendentes.
1199958	Engadido código para xestionar o caso cando non hai máis espazo para construír mensaxes de enerxía verde.
1202034	Solucionouse un problema no que a variable de pila sl_zb_sec_man_context_t non se inicializaba correctamente, polo que se producía un fallo na unión co código de instalación.
1206040	Chamar a emberRemoveChild() durante un intento de unión segura por parte dun dispositivo final pode provocar un decremento adicional do reconto de fillos, que pode levar a un reconto de fillos de -1 (255), impedindo que os dispositivos finais se unan ou se reúnan debido a unha falta indicada. de capacidade na Baliza.
1207580	As funcións de busca da táboa filla dentro da pila son inconsistentes no uso de 0x0000 fronte a 0xFFFF para o valor de retorno de ID de nodo que representa entradas non válidas/baleiras, o que provoca problemas para comprobar as entradas non utilizadas en API como emberRemoveChild().
1210706	O destino e o índice PHY proporcionados na estrutura EmberExtraCounterInfo como parte de emberCounterHandler() poden ser incorrectos para os tipos de contadores MAC TX Unicast.
1211610 1212525	Solucionouse un problema no que as aplicacións dinámicas multiprotocolo fallaban despois de activar o compoñente Secure Key Storage Upgrade.
1211847	Aínda que a sinatura de emberCounterHandler() non cambiou, a forma en que se enchen os seus parámetros cambiou lixeiramente. Os cambios ao redor desta API explícanse na sección 2 anterior.
1212449	As balizas de saída foron categorizadas incorrectamente pola capa MAC, o que provocou que emberCounterHandler() non puidese capturar estes paquetes co tipo de contador EMBER_COUNTER_MAC_TX_BROADCAST e, en cambio, contase as balizas co tipo de contador EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS. Isto potencialmente resultou en valores pouco fiables para o parámetro dest EmberNodeId pasado á estrutura EmberCounterInfo

número de identificación	Descrición
1214866	O envío de paquetes de sondaxe de datos en determinadas configuracións de alto tráfico pode producir un fallo no bus.
1216552	Corrixiuse un problema que provocaba unha aserción en condicións de tráfico intenso.
1216613	Solucionouse un problema que provocaba un valor incorrecto do raio de emisión do grupo na táboa de proxy.
1222509	O enrutador/coordinador envía unha solicitude de saída e reincorporación a un dispositivo final de votación non secundario, pero o destino MAC é 0xFFFF en lugar de coincidir co enderezo de destino NWK.
1223842	Solucionouse un problema coa xeración do sl_component_catalog.h que deixaba código non desexado que provocaba un erro de compilación.
756628	Cambiouse a invocación da devolución de chamada da aplicación emberAfMacFilterMatchMessageCallback para que só se chame para as mensaxes ZLL validadas pola pila.
816088	Moveuse a configuración EMBER de zigbeed_configuration.h a zigbeed. slcp.
829508	Para evitar unha condición de carreira, engadiuse unha validación adicional en emberSetLogicalAndRadioChannel para que non teña éxito se as capas inferiores están ocupadas ou non están en estado de cambiar a canle.

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.si-labs.com/developers/zigbee-emberznet na pestana Documentos técnicos.

número de identificación	Descrición	Solución alternativa
N/A	·As seguintes aplicacións/compoñentes non son compatibles nesta versión: soporte EM4	A función activarase en versións posteriores.
193492	A macro de portabilidade emberAfFillCommandGlobalServerToClientConfigureRe está rota. O recheo do búfer crea un paquete de comando incorrecto.	Use o comando da CLI "zcl global send-me-a-report" en lugar da API.
278063	Túnel de enerxía intelixente plugins teñen un tratamento/uso conflitivo do índice da táboa de enderezos.	Non se coñece ningunha solución alternativa
289569	A lista de selección de nivel de potencia dos compoñentes do creador da rede non ofrece unha gama completa de valores admitidos para EFR32	Edite o intervalo <-8..20> especificado no comentario de CMSIS para EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P OWER no /protocol/ZigBee/app/framework/plugin/network- creator/config/network-creator-config.h file. Por example, cambia a .
295498	A recepción UART ás veces deixa caer bytes baixo carga pesada no caso de uso multiprotocolo dinámico Zigbee+BLE.	Use o control de fluxo de hardware ou reduza a velocidade en baudios.
312291	EMHAL: as funcións halCommonGetIntxxMillisecondTick en servidores Linux usan actualmente a función get meofday, que non se garante que sexa monótona. Se a hora do sistema cambia, pode causar problemas coa sincronización da pila.	Modifica estas funcións para usar clock_gettime coa fonte CLOCK_MONOTONIC.
338151	A inicialización de NCP cun valor de conta de búfer de paquetes baixo pode causar paquetes corruptos.	Use o valor reservado 0xFF para o reconto do búfer de paquetes para evitar o valor predeterminado demasiado baixo
387750	O problema cos formatos de solicitude de táboa de rutas no dispositivo final.	En investigación
400418	Un iniciador de ligazóns táctiles non pode conectarse a un destino de dispositivo final que non sexa de fábrica.	Non se coñece ningunha solución alternativa.
424355	Un iniciador con capacidade de destino para a liña de contacto do dispositivo final somnoliento que non é de fábrica non pode recibir unha resposta de información do dispositivo en determinadas circunstancias.	En investigación
465180	O elemento de optimización do Bloqueador de radio de coexistencia "Activar o control do tempo de execución" pode bloquear o funcionamento correcto de Zigbee.	O control opcional "Wi-Fi Select" da optimización do bloqueador debe deixarse ​​"Desactivado".
480550	O clúster OTA ten o seu método de fragmentación incorporado, polo que non debería usar a fragmentación APS. Aínda que, no caso de que o cifrado APS estea activado, aumenta a carga útil das ImageBlockResponses ata un tamaño onde se activa a fragmentación APS. Isto pode provocar que o proceso OTA falle.	Non se coñece ningunha solución alternativa
481128	Os detalles detallados da causa de restablecemento e do fallo deberían estar dispoñibles de forma predeterminada a través do Virtual UART (Serial 0) nas plataformas NCP cando o complemento de diagnóstico e o periférico UART virtual están activados.	Dado que o Serial 0 xa está inicializado no NCP, os clientes poden activar o emberAfNcpInitCallback no marco Zigbee NCP e chamar ás funcións de diagnóstico adecuadas (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, halPrintCrashDetails, halPrintCrashDetails) viewno rexistro de captura de Network Analyzer. Para un exampde como usar estas funcións, consulte o código incluído no emberAfMainInit() de a-main-soc.c cando se define EXTENDED_RESET_INFO.

número de identificación	Descrición	Solución alternativa
486369	Se un DynamicMultiProtocolLightSoc que forma unha nova rede ten nodos fillos restantes dunha rede que deixou, emberAfGetChildTableSize devolve un valor distinto de cero en startIdentifyOnAllChildNodes, o que provoca mensaxes de erro Tx 66 cando se dirixe aos fillos "pantasma".	Borra en masa a parte, se é posible, antes de crear unha nova rede ou verifique mediante programación a táboa filla despois de saír da rede e elimine todos os nenos usando emberRemoveChild antes de formar unha nova rede.
495563	Únete a SPI NCP Sleepy End Device Sampa aplicación non realiza unha enquisa curta, polo que o intento de unión falla no estado de Actualización da clave de ligazón TC.	O dispositivo que quere unirse debe estar no modo de enquisa curta antes de intentar unirse. Este modo pode ser forzado polo complemento End Device Support.
497832	En Network Analyzer, a desglose de comandos de soporte de aplicacións de Zigbee para o marco de solicitude de clave de verificación fai referencia por erro á parte da carga útil que indica o enderezo de orixe do marco como o enderezo de destino.	Non se coñece ningunha solución alternativa
519905 521782	Spi-NCP moi raramente pode fallar ao iniciar a comunicación do cargador de arranque usando o comando CLI 'bootload' do complemento ota-client.	Reinicie o proceso de carga de arranque
620596	NCP SPI Example para BRD4181A (EFR32xGMG21) nO pin predeterminado de activación definido non se pode usar como pin de activación.	Cambia o pin predeterminado para nWake de PD03 a un pin habilitado para espertar EM2/3 no complemento NCP-SPI.
631713	Un dispositivo final de Zigbee informará de conflitos de enderezos repetidamente se se usa o complemento "Zigbee PRO Stack Library" en lugar de "Zigbee PRO Leaf Library".	Use a "Biblioteca de follas Zigbee PRO" en lugar do complemento "Biblioteca de pilas Zigbee PRO".
670702	As ineficiencias no complemento de Informes poden levar a unha latencia significativa en función da frecuencia de escritura de datos e do tamaño da táboa, o que pode interferir co código da aplicación do cliente, incluído o tempo do evento.	Se realizas escrituras frecuentes, considera comprobar as condicións dos informes e enviar informes manualmente en lugar de usar o complemento.
708258	O valor non inicializado en groups-server.c a través de addEntryToGroupTable() pode crear unha ligazón espuria e provocar que se envíen mensaxes de informes de transmisión de grupo.	Engadir "binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;" despois de “encadernación.tipo = EMBER_MULTICAST_BINDING;”
757775	Todas as pezas EFR32 teñen unha compensación RSSI única. Ademais, o deseño da placa, as antenas e o recinto poden afectar a RSSI.	Ao crear un novo proxecto, instale a utilidade RAIL, compoñente RSSI. Esta función inclúe os silabs de compensación RSSI predeterminados medidos para cada parte. Esta compensación pódese modificar se é necesario despois da proba de RF do seu produto completo.
758965	Os compoñentes do clúster ZCL e a táboa de detección de comandos ZCL non están sincronizados. Polo tanto, ao activar ou desactivar un compoñente de clúster de ZCL, os comandos implementados non se activarán ou desactivarán na pestana de comandos do Configurador avanzado de ZCL correspondente.	Activa/desactiva manualmente a detección dos comandos ZCL desexados no Configurador avanzado de ZCL.
765735	A actualización OTA falla no dispositivo Sleepy End coa solicitude de páxina activada.	Use Solicitude de bloqueo en lugar de Solicitude de páxina.
845649	Eliminando CLI: o compoñente central non elimina as chamadas cli EEPROM a sl_cli.h.	Elimina o ficheiro eeprom-cli.c file que chama ao sl_cli.h. Ademais, as chamadas a sl_cli.h así como a sl_cli_command_arg_t no ota-storage-simple-eeprom pódense comentar.
857200	ias-zone-server. c permite crear unha ligazón cun enderezo CIE "0000000000000000" e posteriormente non permite outras vinculacións.	Non se coñece ningunha solución alternativa
1019961	Marca Z3Gateway xeradafile códigos duros "gcc" como CC	Non se coñece ningunha solución alternativa

número de identificación	Descrición	Solución alternativa
1039767	Problema de desbordamento da cola de reintentos da rede do enrutador Zigbee no caso de uso de RTOS multifío.	Zigbee Stack non é seguro para fíos. Como resultado, chamar a API de pila de Zigbee desde outra tarefa non é compatible no ambiente do SO e pode poñer a pila nun estado "non funcionante". Consulte a seguinte nota da aplicación para obter máis información e unha solución alternativa usando o controlador de eventos. https://www.silabs.com/documents/public/application- notes/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk- 7x.pdf .
1064370	O interruptor Z3 sampA aplicación de ficheiro só habilitou un botón (instancia: btn1) por defecto, o que leva a unha falta de coincidencia na descrición do botón no proxecto file.	Solución: instale a instancia btn0 manualmente durante a creación do proxecto Z3Switch.
1161063	Z3Light e posiblemente outras aplicacións informan de valores incorrectos de revisión do clúster.	Actualice manualmente o atributo de revisión do clúster á súa revisión apropiada.
1164768, 1171478, 1171479	ERRO: ezspErrorHandler 0x34 informouse repetidamente durante o modo de recepción mfglib	Para reducir as mensaxes de erro impresas, configure EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV ENT_TIMEOUT_MS na aplicación anfitrión a 100, polo que a cola de devolución de chamadas liberarase máis rápido.
1252460	As rutinas de recuperación de SimEEPROM (tanto para v1 como para v2) que se executan ao inicio poden realizar chamadas de borrado de páxinas flash desalineadas que provocan afirmacións durante em_msc. rutina MSC_ErasePage de c.	Solución: coloque a seguinte liña de código na parte superior da función MSC_ErasePage() en em_msc.c: enderezo de inicio = (uint32_t*)((uint32_t)startAddress & ~(FLASH_PAGE_SIZE-1));

Elementos obsoletos

Obsoleto na versión 
En GSDK 7.4.0.0 en diante, incluíndo este parche, a opción "-v" nun Z3Gateway para que unha aplicación host de Linux cree unha interface telnet co porto 4900 ou 4901 está obsoleta. A forma alternativa recomendada para crear unha interface telnet é usar utilidades de Linux como "socat".

Obsoleto na versión 
Elimináronse as seguintes API de seguranza obsoletas:

• emberGetKey()
• emberGetKeyTableEntry()
• emberSetKeyTableEntry()
• emberHaveLinkKey()
• emberAddOrUpdateKeyTableEntry()
• emberAddTransientLinkKey()
• emberGetTransientKeyTableEntry()
• emberGetTransientLinkKey()
• emberHmacAesHash()

Use as API proporcionadas por Zigbee Security Manager para acceder ao almacenamento de chaves e ao hash HMAC.

Elementos eliminados

Eliminado na versión

• Elimináronse as API públicas duplicadas na cabeceira pública file tipos de gp.h.
• Eliminouse o compoñente zigbee_end_device_bind. Este compoñente utilizouse para que o coordinador tramitase solicitudes vinculantes para os dispositivos finais. Esta funcionalidade opcional eliminouse do R22 da especificación principal de Zigbee.
• Eliminouse setPacketBufferCount() en af-host.c e o caso de verificación inútil EZSP_CONFIG_PACKET_BUFFER_COUNT: en command-handlers.c.
• Eliminouse o argumento memoryAllocation porque non é necesario dividilo en dúas fases ao inicializar NCP.
• Eliminouse emberAfNcpInitCallback() na aplicación se14-comms-hub, se14-ihd e se14-meter-gas.
• Eliminouse o valor de configuración EZSP_CONFIG_RETRY_QUEUE_SIZE durante a inicialización de ncp en ncp-configuration.c

Pasarela multiprotocolo e RCP

Novos Elementos
Engadido na versión

• A escoita simultánea, a capacidade das pilas Zigbee e OpenThread de operar en canles 802.15.4 independentes cando se usa un RCP EFR32xG24 ou xG21.
• A escoita simultánea non está dispoñible para a combinación 802.15.4 RCP/Bluetooth RCP, a combinación Zigbee NCP/OpenThread RCP ou para o sistema en chip (SoC) Zigbee/OpenThread. Engadirase a eses produtos nunha versión futura.
• Engadiuse a extensión do provedor OpenThread CLI ás aplicacións host OpenThread dos contedores multiprotocolo. Isto inclúe os comandos coex cli.

Melloras
Modificado na versión

• A combinación multiprotocolo Zigbee NCP/OpenThread RCP é agora calidade de produción.

Problemas solucionados
Corrixido na versión

número de identificación	Descrición
1213701	zigbeed non permitiu que se crease unha entrada da táboa de coincidencias de orixe para un fillo se a cola indirecta MAC xa ten datos pendentes para ese fillo. Este comportamento pode provocar que as transaccións da capa de aplicación entre o neno e algún outro dispositivo fallen debido á falta de APS Ack ou de resposta da capa de aplicación, sobre todo a interrupción e a terminación inesperada das actualizacións de ZCL OTA dirixidas ao dispositivo fillo.
1244461	A entrada da táboa de coincidencias de orixe para ser fillo puido eliminarse a pesar das mensaxes pendentes.

Corrixido na versión

número de identificación	Descrición
1081828	Problema de rendemento cos DMP Zigbee/BLE baseados en FreeRTOSampas aplicacións.
1090921	Z3GatewayCpc tivo problemas para formar unha rede nun ambiente ruidoso.
1153055	Produciuse unha afirmación no host cando houbo un fallo de comunicación ao ler a versión NCP desde o zigbee_ncp-ble_ncp-uart sampa aplicación.
1155676	O RCP 802.15.4 descartou todos os paquetes de unidifusión recibidos (despois de aceptar MAC) se varias interfaces 15.4 compartían o mesmo ID de nodo de 16 bits.
1173178	O host informou falsamente de centos de paquetes recibidos con mfglib na configuración de Host-RCP.
1190859	Erro EZSP ao enviar paquetes aleatorios mfglib na configuración de Host-RCP.
1199706	As enquisas de datos dos nenos do dispositivo final esquecido non estaban configurando correctamente un marco pendente no RCP para poñer en cola un comando Saír e volver a unirse ao antigo fillo.
1207967	O comando "mfglib send random" estaba enviando paquetes adicionais en Zigbeed.
1208012	O modo mfglib rx non actualizou a información do paquete correctamente ao recibir no RCP.
1214359	O nodo coordinador fallou cando 80 ou máis enrutadores tentaron unirse á vez na configuración Host-RCP.
1216470	Despois de transmitir unha emisión para a máscara de enderezo 0xFFFF, un Zigbee RCP que actúa como dispositivo principal deixaría a marca de datos pendentes establecida para cada fillo. Isto provocou que cada neno permanecese esperto esperando datos despois de cada enquisa e requiriu algunha outra transacción de datos pendente a cada dispositivo final para finalmente borrar este estado.

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 recentes están dispoñibles en https://www.si-labs.com/developers/gecko-software-development-kit.

número de identificación	Descrición	Solución alternativa
811732	O soporte de token personalizado non está dispoñible cando se usa Zigbeed.	O soporte está previsto nunha versión futura.
937562	O comando "anunciar activado" de Bluetoothctl falla coa aplicación rcp-uart-802154-blehci en Raspberry Pi OS 11.	Usa a aplicación btmgmt en lugar de bluetoothctl.
1022972	Coex non funciona en ZB NCP + OT RCP.	O soporte está previsto para unha versión futura.
1074205	O CMP RCP non admite dúas redes no mesmo ID de PAN.	Use ID PAN diferentes para cada rede. O soporte está previsto nunha versión futura.
1122723	Nun ambiente ocupado, a CLI pode deixar de responder na aplicación z3-light_ot-ftd_soc.	Non se coñece ningunha solución alternativa.
1124140	z3-light_ot-ftd_soc sampa aplicación le non pode formar a rede Zigbee se a rede OT xa está activa.	Inicie primeiro a rede Zigbee e despois a rede OT.
1170052	É posible que CMP Zigbee NCP + OT RCP e DMP Zigbee NCP + BLE NCP non se axusten a partes de RAM de 64 KB ou inferior nesta versión actual.	Actualmente non se admiten pezas de 64 KB para estas aplicacións.
1209958	O ZB/OT/BLE RCP en Bobcat e Bobcat Lite pode deixar de funcionar despois duns minutos cando se executan os tres protocolos	Abordarase nunha futura versión
1221299	As lecturas RSSI de Mfglib difiren entre RCP e NCP.	Abordarase nunha futura versión.
1231021	OTBR pode afirmar cando máis de 80 dispositivos zigbee se están unindo simultaneamente.	Engadiuse unha corrección que pode solucionar o problema. Abordarase completamente nunha futura versión.

Elementos obsoletos

• Ningún

Elementos eliminados
Eliminado na versión

• Eliminouse a macro "NONCOMPLIANT_ACK_TIMING_WORKAROUND". Agora todas as aplicacións RCP admiten de forma predeterminada un tempo de resposta de 192 μs para as confirmacións non melloradas mentres seguen utilizando un tempo de resposta de 256 μs para as confirmacións melloradas requiridas por CSL.

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 comoampaplicación e referencias de documentación que indican os seguintes pasos.

Instalación e Uso

O SDK de Zigbee EmberZNet ofrécese como parte do SDK Gecko (GSDK), o conxunto de SDK de Silicon Labs. Para comezar rapidamente co GSDK, instala Simplicity Studio 5, que configurará o teu ambiente de desenvolvemento e guiarache pola instalación do GSDK. 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.
Como alternativa, Gecko SDK pódese instalar manualmente descargando ou clonando o máis recente de GitHub. Ver https://github.com/Sili-conLabs/gecko_sdk para máis información.

Simplicity Studio instala o GSDK por defecto en:

• (Windows): C:\Usuarios\ \SimplicityStudio\SDKs\gecko_sdk
• (MacOS): /Usuarios/ /SimplicityStudio/SDKs/gecko_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). As referencias da API e outra información sobre esta e versións anteriores están dispoñibles en 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.

Chave envuelta	Exportable / Non exportable	Notas
Chave de rede	Exportable
Chave de ligazón do centro de confianza	Exportable
Chave de ligazón transitoria	Exportable	Táboa de claves indexada, almacenada como chave volátil
Chave de ligazón da aplicación	Exportable	Táboa de claves indexadas
Chave segura EZSP	Exportable
Clave de cifrado ZLL	Exportable
Chave preconfigurada de ZLL	Exportable
Chave proxy GPD	Exportable	Táboa de claves indexadas
Chave GPD Sink	Exportable	Táboa de claves indexadas
Chave interna/marcador de posición	Exportable	Chave interna para o uso de 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 agora envíanse a través do compoñente de xestor de seguranza de Zigbee.
• Algunhas destas chaves poden volverse non exportables á aplicación do usuario no futuro. Recoméndase ás aplicacións dos usuarios que non confíen na exportación de claves a non ser que sexa absolutamente necesario.
• Para obter máis información sobre a funcionalidade de Secure Vault Key Management, consulte AN1271: Secure Key Storage.

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 para rexistrarse para obter asistencia de produtos.
Podes contactar co soporte de Silicon Laboratories en http://www.silabs.com/support.

Simplicity Studio
Acceso cun só clic a MCU e ferramentas sen fíos, documentación, software, bibliotecas de código fonte e moito máis. Dispoñible para Windows, Mac e Linux!

• www.silabs.com/IoT
• www.silabs.com/simplicity
• www.silabs.com/quality
• www.silabs.com/community

Exención de responsabilidade
Silicon Labs pretende ofrecer aos clientes a documentación máis recente, precisa e detallada de todos os periféricos e módulos dispoñibles para os implementadores de sistemas e software que utilicen ou teñan intención de utilizar os produtos de Silicon Labs. Os datos de caracterización, os módulos e periféricos dispoñibles, os tamaños de memoria e os enderezos de memoria refírense a cada dispositivo específico, e os parámetros "típicos" proporcionados poden variar en diferentes aplicacións. Aplicación exampOs aquí descritos son só para fins ilustrativos. Silicon Labs resérvase o dereito de facer cambios sen previo aviso na información do produto, especificacións e descricións aquí, e non ofrece garantías sobre a precisión ou integridade da información incluída. Sen notificación previa, Silicon Labs pode actualizar o firmware do produto durante o proceso de fabricación por motivos de seguridade ou fiabilidade. Tales cambios non alterarán as especificacións nin o rendemento do produto. Silicon Labs non terá ningunha responsabilidade polas consecuencias do uso da información proporcionada neste documento. Este documento non implica nin concede expresamente ningunha licenza para deseñar ou fabricar circuítos integrados. Os produtos non están deseñados nin autorizados para ser utilizados en ningún dispositivo da FDA Clase III, aplicacións para as que se require a aprobación previa da FDA ou sistemas de soporte vital sen o consentimento específico por escrito de Silicon Labs. Un "Sistema de Soporte Vital" é calquera produto ou sistema destinado a apoiar ou manter a vida e/ou a saúde que, se falla, pode esperarse razoablemente que resulte en danos persoais importantes ou a morte. Os produtos de Silicon Labs non están deseñados nin autorizados para aplicacións militares. Os produtos de Silicon Labs non se utilizarán en ningún caso en armas de destrución masiva incluídas (pero non limitadas a) armas nucleares, biolóxicas ou químicas ou mísiles capaces de lanzar tales armas. Silicon Labs renuncia a todas as garantías expresas e implícitas e non se fará responsable de ningunha lesión ou dano relacionado co uso dun produto de Silicon Labs nesas aplicacións non autorizadas.

Nota: Este contido pode conter terminoloxía ofensiva que xa está obsoleta. Silicon Labs está a substituír estes termos por linguaxe inclusiva sempre que sexa posible. Para máis información, visite www.silabs.com/about-us/inclusive-lexicon-project.

Información da marca comercial
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® e o logotipo de Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo e combinacións dos mesmos , "os microcontroladores máis amigables coa enerxía do mundo", Redpine Signals®, WiSeConnect , n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, o Telegesis Logo®, USBXpress® , Zentri, o logotipo de Zentri e Zentri DMS, Z-Wave®, e outras son marcas comerciais ou marcas comerciais rexistradas de Silicon Labs. ARM, CORTEX, Cortex-M3 e THUMB son marcas comerciais ou marcas rexistradas de ARM Holdings. Keil é unha marca rexistrada de ARM Limited. Wi-Fi é unha marca rexistrada de Wi-Fi Alliance. Todos os demais produtos ou marcas mencionadas aquí son marcas comerciais dos seus respectivos posuidores.

CONTACTO

• Silicon Laboratories Inc.
• 400 Oeste César Chávez
• Austin, TX 78701
• EUA
• www.silabs.com

Documentos/Recursos

SILICON LABS SDK 7.4.1.0 GA Software de pila de protocolo Zigbee [pdfGuía do usuario SDK 7.4.1.0 GA Zigbee Protocol Stack Software, SDK 7.4.1.0 GA, Zigbee Protocol Stack Software, Protocol Stack Software, Stack Software

Referencias

• Manual de usuario