Guide de l'utilisateur du logiciel SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack

Pour les mises à jour et les avis de sécurité, reportez-vous au chapitre Sécurité des notes de version de Gecko Platform installées avec ce SDK ou visitez l'onglet TECH DOCS sur Silicon Labs. website.
Restez informé en vous abonnant aux avis de sécurité.

FAQ

Question: Comment puis-je vérifier l'exactitude files sont utilisés avec les compilateurs compatibles ?
Répondre: Vous pouvez vérifier que le bon files sont utilisés en vérifiant la version 12.2.1 de GCC fournie avec Simplicity Studio.

Question: Où puis-je trouver des informations sur les mises à jour et les avis de sécurité ?
Répondre: Pour les mises à jour et les avis de sécurité, reportez-vous au chapitre Sécurité des notes de version de Gecko Platform ou visitez l'onglet TECH DOCS sur Silicon Labs. website.

Silicon Labs est le fournisseur de choix pour les équipementiers qui développent le réseau Zigbee dans leurs produits. La plateforme Zigbee de Silicon Labs est la solution Zigbee la plus intégrée, la plus complète et la plus riche en fonctionnalités disponible.
Le SDK EmberZNet de Silicon Labs contient l’implémentation par Silicon Labs de la spécification de la pile Zigbee.

Ces notes de version couvrent la ou les versions du SDK :

7.4.1.0 publié le 14er février 2024
7.4.0.0 publié le 13 décembre 2023

CARACTÉRISTIQUES PRINCIPALES

Zigbee

Conformité Zigbee R23

Conformité Zigbee Smart Energy 1.4a – production
Conformité Zigbee GP 1.1.2 – Alpha

Support MG27 – fabrication
Prise en charge améliorée des composants Secure Vault

Prise en charge endormie sur les applications NCP SPI (non-CPC) – Alpha

Multiprotocole

Prise en charge de l'écoute simultanée (RCP) – MG21 et MG24
Multiprotocole simultané (CMP) Zigbee NCP + OpenThread RCP – production

Prise en charge de Bluetooth multiprotocole dynamique + multiprotocole simultané (CMP) Zigbee et OpenThread sur SoC

Avis de compatibilité et d'utilisation

Pour plus d'informations sur les mises à jour et les avis de sécurité, consultez le chapitre Sécurité des notes de version de Gecko Platform installées avec ce SDK ou sur l'onglet TECH DOCS à l'adresse https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs vous recommande également fortement de vous abonner aux avis de sécurité pour obtenir des informations à jour. Pour obtenir des instructions, ou si vous débutez avec le SDK Zigbee EmberZNet, consultez Utilisation de cette version.

Compilateurs compatibles

Atelier intégré IAR pour ARM (IAR-EWARM) version 9.40.1.
L'utilisation de Wine pour créer avec l'utilitaire de ligne de commande IarBuild.exe ou l'interface graphique IAR Embedded Workbench sur macOS ou Linux peut entraîner des erreurs. files étant utilisé en raison de collisions dans l'algorithme de hachage de Wine pour générer des courts file noms.
Il est conseillé aux clients sous macOS ou Linux de ne pas créer avec IAR en dehors de Simplicity Studio. Les clients qui le font doivent vérifier soigneusement que le bon files sont utilisés.

GCC (The GNU Compiler Collection) version 12.2.1, fourni avec Simplicity Studio.
La version du protocole EZSP pour cette version est 0x0D.

Nouveaux articles

Cette version du SDK Gecko (GSDK) sera la dernière à prendre en charge de manière combinée tous les appareils EFM et EFR, à l'exception des correctifs apportés à cette version si nécessaire. À partir de mi-2024, nous introduirons des SDK distincts :

Le SDK Gecko existant continuera à prendre en charge les appareils des séries 0 et 1.
Un nouveau SDK s'adressera spécifiquement aux appareils des séries 2 et 3.

Le SDK Gecko continuera à prendre en charge tous les appareils des séries 0 et 1 sans modification du support, de la maintenance, de la qualité et de la réactivité à long terme fournis dans le cadre de notre politique logicielle.
Le nouveau SDK dérivera du SDK Gecko et commencera à offrir de nouvelles fonctionnalités qui aident les développeurs à progresser.tage des capacités avancées de nos produits séries 2 et 3.
Cette décision s'aligne sur les commentaires des clients, reflétant notre engagement à améliorer la qualité, garantir la stabilité et améliorer les performances pour une expérience utilisateur exceptionnelle sur nos SDK logiciels.

Nouveaux composants

Nouveauté dans la version

Les composants « zigbee_direct_security_p256 » et « zigbee_direct_security_curve25519 » ont été ajoutés afin que les utilisateurs puissent configurer une option de sécurité Zigbee Direct spécifique.
Les utilisateurs sont autorisés à activer plusieurs composants « zigbee_direct_security » sur une application Zigbee direct device (ZDD). Dans ce cas, l'option de sécurité réelle dépend de la configuration du périphérique virtuel Zigbee (ZVD).

Nouvelles API
Nouveauté dans la version

Ajout d'une nouvelle API sl_zigbee_token_factory_reset pour réinitialiser les jetons Zigbee NVM3 à leur valeur par défaut.
Ajout de l'API bool sl_zigbee_sec_man_link_key_slot_available(EmberEUI64 eui), qui renvoie true si la table de clé de lien peut ajouter ou mettre à jour une entrée avec cette adresse (la table n'est pas pleine).

Ajout d'une nouvelle API bool sl_zb_sec_man_compare_key_to_value (contexte sl_zb_sec_man_context_t*, clé sl_zb_sec_man_key_t*), qui renvoie true si la clé référencée par le contexte a la même valeur que la clé fournie dans l'argument.

Prise en charge de la nouvelle plate-forme
Nouveauté dans la version

La prise en charge de la pile Zigbee pour les nouveaux composants suivants est ajoutée dans cette version : EFR32MG24A010F768IM40 et EFR32MG24A020F768IM40.

Nouvelle documentation
Nouveau dans la version 7.4.0.0

Mise à jour de la description du composant Zigbee Secure Key Storage pour refléter l'ajout de Zigbee Secure Key Storage Upgrade (qui ajoute une compatibilité descendante avec les projets existants).
Ajout d'une nouvelle note d'application pour interagir avec le groupe de composants Zigbee Security Manager (AN1412 : Zigbee Security Manager).

Comportement prévu

Il est rappelé aux utilisateurs que les transmissions CSL non synchronisées Zigbee sont soumises à une préemption de protocole au niveau du planificateur radio. Dans les applications SleepyToSleepy, BLE peut et préemptera une transmission Zigbee CSL, ce qui mettra fin à la transmission. La préemption du planificateur est plus courante pour les CSL non synchronisés, étant donné qu'une séquence de trames de réveil potentiellement longue peut être utilisée. Les utilisateurs souhaitant ajuster les priorités de transmission peuvent utiliser le composant DMP Tuning and Testing pour le faire. Les utilisateurs peuvent également consulter UG305 : Dynamic Multiprotocol User's Guide pour plus d'informations.

Améliorations

Modifié dans la version
Modifications de la documentation de l'API emberCounterHandler

Dans les versions précédentes, le rappel du gestionnaire de compteurs pour les EmberCounterTypes des couches MAC et APS concernant les paquets RX et TX ne recevait pas l'ID de nœud cible ou les arguments de données appropriés, et la documentation de l'API concernant le comportement de certains compteurs utilisant ces paramètres n'était pas claire ou trompeuse.
Bien que la signature de emberCounterHandler() n'ait pas changé, la façon dont ses paramètres sont renseignés a légèrement changé.

Les commentaires autour des énumérations EmberCounterType dans ember-types.h ont été développés pour plus de clarté.
Le paramètre Node ID du gestionnaire de compteurs pour les compteurs liés à TX vérifie désormais si le mode d'adresse de destination indique un ID court valide avant de l'utiliser. (Sinon, aucune adresse de destination n'est renseignée et une valeur d'espace réservé EMBER_UNKNOWN_NODE_ID est utilisée à la place.)
Le paramètre Node ID du gestionnaire de compteurs pour les compteurs liés au RX reflète désormais l'ID du nœud source, et non l'ID du nœud de destination.

Le nombre de tentatives n'est *pas* transmis en tant que paramètre de données pour les compteurs EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED comme décrit dans les types de braises. h dans les versions précédentes, mais cela n'a jamais été correctement renseigné dans les versions précédentes, donc sa valeur dans les versions précédentes aurait toujours été 0. Ce comportement a été clarifié dans la description de ces EmberCounterTypes. Cependant, le nombre de tentatives pour les tentatives de couche APS continue d'être renseigné dans le paramètre de données pour les types de compteur EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED, afin d'être cohérent avec les versions précédentes.
Tous les compteurs qui remplissent l'ID de nœud ou le paramètre de données pour le rappel ont été audités pour garantir qu'ils transmettent les données, l'adresse ou EMBER_UNKNOWN_NODE_ID attendues si un ID de nœud était attendu mais n'a pas pu être obtenu à partir du paquet, comme décrit dans la version révisée. documentation types.h.
Le gestionnaire de compteur pour EMBER_COUNTER_MAC_TX_UNICAST_RETRY reflète désormais correctement l'ID du nœud de destination de la couche MAC et plusieurs tentatives dans son ID de nœud de destination et ses paramètres de données.

Le gestionnaire de compteur pour EMBER_COUNTER_PHY_CCA_FAIL_COUNT fournit désormais des informations sur l'ID du nœud de destination via le paramètre Node ID sur la cible de couche MAC prévue du message dont la transmission a échoué.

Code de l’énergie verte mis à jour
Le code du serveur d'énergie verte est mis à jour avec diverses améliorations, notamment :

Ajout de plus de code de validation pour les commandes entrantes avec un point de terminaison non valide lors de la réception sur le serveur GP.

Ajout de code pour gérer le cas où il n'y a plus d'espace pour créer des messages sur l'énergie verte.
Le récepteur abandonne désormais la configuration d'appariement avec une action de suppression d'appariement dans certains cas, conformément à la section A.3.5.2.4.1 des spécifications.
Le récepteur enregistre désormais la liste de groupes existante d'une entrée avant de la supprimer lors du traitement de la configuration de couplage avec l'action d'extension.

La commande de requête de traduction renvoie « NON TROUVÉ » comme code d'erreur lorsque la table de traduction est vide ou que l'index est plus grand que plusieurs entrées de la table.
Modification de la version du point de terminaison GP dans certaines applications de 1 à 0.

L'utilisation de CSMA dans la fonction d'envoi GPDF est limitée car les appareils Green Power sont des appareils à énergie minimale et n'utilisent pas CSMA dans la plupart des conceptions. Au lieu de cela, la conception préférée consiste à envoyer plusieurs paquets en utilisant le même budget énergétique.
Suppression de l'utilisation d'un point de terminaison caché dans l'option du plugin Green Power Server. Utilisez plutôt l’un des points de terminaison de l’application.
Améliorations du code du plugin de mise à jour des clés réseau

Modification de la période de mise à jour périodique des clés de réseau pour qu'elle puisse atteindre 1 an.

Restructuration de certaines API pour éviter les exportations de clés inutiles
Modifications apportées pour favoriser l'utilisation de contextes clés plutôt que de données clés en texte brut.

sl_zigbee_send_security_challenge_request prend désormais un argument sl_zb_sec_man_context_t à la place d'EmberKeyData.

Les valeurs de l'énumération sl_zb_sec_man_derived_key_type sont désormais un masque de bits de 16 bits pour prendre directement en charge certaines dérivations de clé qui combinent plusieurs types dérivés.

Problèmes résolus

Corrigé dans la version

ID #	Description
1036893	Correction d'un problème qui obligeait le composant du cluster OTA à installer l'ancien composant d'interface du chargeur de démarrage en tant que dépendance.
1114905	Zigbee Direct : gestion améliorée des caractéristiques du réseau de sortie.
1180937	Correction de la réinitialisation du WDT lors de la connexion de Zigbee Direct ZDD à un ZVD tiers.
1223904	Correction d'un problème qui entraînait le déplacement incorrect du périphérique final dans un environnement très chargé.
1224393	Mise à jour du code du gestionnaire de requêtes de la table de récepteur Green Power pour mettre à jour l'adresse de destination de la réponse.
1228808	Correction du problème d'affichage avec les définitions de macro dans la documentation gp-types.h.
1232297	Correction d'un problème où emberSetOutgoingNwkFrameCounter et emberSetOutgoingApsFrameCounter ne fonctionnaient pas sur les applications hôtes 64 bits (renvoyant EMBER_BAD_ARGUMENT).
1232359	Correction du calcul du paramètre gppTunnelingDelay dans le traitement des commandes du client Green Power.
1240392	Les demandes de liaison/débindation ZDO refusées pour des raisons d'accès/d'autorisation doivent renvoyer le statut EMBER_ZDP_NOT_AUTHORIZED plutôt que le statut EMBER_ZDP_NOT_PERMITTED selon les spécifications Zigbee.
1243523	Zigbee Direct : stabilité améliorée de la connexion BLE à ZVD.
1249455	Correction d'un problème qui faisait qu'un appareil final en veille passait en veille lors de la réception d'une diffusion avant de recevoir un accusé de réception.
1252295	Correction d'une erreur de frappe dans la macro du catalogue de composants SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT.

Corrigé dans la version

ID #	Description
1019348	Correction des exigences de dépendance pour le composant Zigbee ZCL Cli afin qu'il puisse être supprimé lorsqu'il n'est pas nécessaire.
1024246	Mise à jour de la description des fonctions pour emberHaveLinkKey() et sl_zb_sec_man_have_link_key().
1036503	Ajout d'une description pour recommander l'utilisation du noyau Micrium pour les DMPamples applications.
1037661	Un problème qui empêchait l'application d'installer la pile professionnelle ou la pile feuille a été résolu.
1078136	Correction d'un crash intermittent lors de la modification d'événements à partir du contexte d'interruption
1081548	Il est rappelé aux utilisateurs que les transmissions CSL non synchronisées Zigbee sont soumises à une préemption de protocole au niveau du planificateur radio. Dans les applications SleepyToSleepy, BLE peut et préemptera une transmission Zigbee CSL, ce qui mettra fin à la transmission. La préemption du planificateur est plus courante pour les CSL non synchronisés, étant donné qu'une séquence de trames de réveil potentiellement longue peut être utilisée. Les utilisateurs souhaitant ajuster les priorités de transmission peuvent utiliser le composant DMP Tuning and Testing pour le faire. Les utilisateurs peuvent également consulter UG305 : Dynamic Multiprotocol User's Guide pour plus d'informations. Un problème a été résolu dans CSL où une nouvelle séquence de trames de réveil reçue immédiatement après une trame de charge utile précédente n'était pas enregistrée correctement. Cela entraînerait une trame de charge utile manquée.
1084111	La prise en charge initiale de SPI-NCP en veille pour les cartes basées sur MG24 est mise à jour dans le cadre de cette version.
1104056	Ajout de la prise en charge du pilotage de réseau pour s'exécuter sur un réseau secondaire en cas de multi-réseau
1120515	Correction d'un problème où le canal ne changeait pas lors de l'utilisation de la commande mfglib set-channel.
1141109	Correction d'un problème qui provoquait les s générésampl'application ncp-uart-gp-multi-rail manque un en-tête files lors de l'utilisation du composant adaptateur Green Power avec l'option -cp.
1144316	Mise à jour de la description de certains types de structures de données dans la documentation gp-types.h.
1144884	Correction du bit de trame parasite en attente défini lorsqu'aucune donnée n'est en attente.
1152512	Correction d'un crash potentiel dans low-mac-rail lors de la modification de l'événement dans le contexte ISR.

ID #	Description
1154616	Ajout d'une exception pour la condition d'initialisation du réseau avec le cas « Changement de rôle d'un appareil Sleepy End à un appareil Non-Sleepy End ».
1157289	Correction d'un problème pouvant entraîner l'échec du test BDB DN-TLM-TC-02B.
1157426	Correction d'un problème de construction lors de la construction de zigbee_simple_app avec le composant green_power_adapter.
1157932	Ajout d'une condition pour vérifier si le champ « temps de transition » est manquant et définir une valeur par défaut de 0xFFFF pour ce champ manquant.
1166340	Correction d'un problème qui empêchait emberAfGpdfSend d'envoyer le nombre prévu de transmissions répétées.
1167807	Correction d'un problème où les appareils agissant comme centres de confiance dans les réseaux distribués effaçaient de manière incorrecte leurs clés de lien transitoires à chaque fois qu'un nouvel appareil rejoignait.
1169504	Correction d'un problème qui provoquait la réinitialisation d'un appareil en veille lors d'un réveil forcé.
1169966	Correction de la validation de la valeur de retour manquante dans le code d'allocation de tampon.
1171477, 172270	Avec mfglib start 1, aucun message n'est transmis mais reçu, donc le message du terminal affiché « mfglib send complete » est erroné et remplacé par « %d paquets reçus au cours des %d dernières ms ».
1171935	Modification de la période de mise à jour périodique des clés de réseau pour qu'elle puisse atteindre 1 an.
1172778	Ajout de l'invocation manquante de emberAfPluginGreenPowerServerUpdateAliasCallback au serveur Green Power.
1174288	Correction d'un problème qui faisait que le processus de pilotage du réseau confirmait si un appel pour arrêter une analyse en cours était appelé.
1178393	Mise à jour d'une erreur de documentation.
1180445	Dans Smart Energy, OTA continue désormais à télécharger si le coordinateur atteint le cycle de service limité.
1185509	Correction d'un problème dans CSL où une nouvelle séquence de trames de réveil reçue immédiatement après une trame de charge utile précédente n'était pas enregistrée correctement. Cela entraînerait une trame de charge utile manquée.
1186107	Correction d'un problème qui entraînait l'échec du déchiffrement des GPDF reçus pour remplacer le GPDF entrant dans la notification de mise en service du GP.
1188397	Correction d'un problème qui provoquait une erreur de compilation lors de l'activation de la taille étendue de la table de rapport.
1194090	Correction de l'état d'échec dans la réponse par défaut pour la commande Sink Commissioning Mode – suite à la section 3.3.4.8.2
1194963	Correction d'un problème qui mémorisait la structure commissioningGpd avant d'appeler le rappel utilisateur emberAfGreenPowerServerPairingStatusCallback.
1194966	Correction d’un problème où les champs endpoint et proxiesInvolved n’étaient pas définis avec l’action Quitter la mise en service.
1196698	Correction d'un bit de trame en attente parasite défini lorsqu'aucune donnée n'était en attente.
1199958	Ajout de code pour gérer le cas où il n'y a plus d'espace pour créer des messages sur l'énergie verte.
1202034	Correction d'un problème où la variable de pile sl_zb_sec_man_context_t n'était pas initialisée correctement, entraînant l'échec de la jointure avec le code d'installation.
1206040	L'appel de emberRemoveChild() lors d'une tentative de réadhésion sécurisée par un périphérique final peut potentiellement conduire à une diminution supplémentaire du nombre d'enfants, conduisant potentiellement à un nombre d'enfants de -1 (255), empêchant les périphériques finaux de rejoindre/rejoindre en raison d'un manque indiqué. de capacité dans la balise.
1207580	Les fonctions de recherche de table enfant au sein de la pile sont incohérentes dans l'utilisation de 0x0000 par rapport à 0xFFFF pour la valeur de retour de l'ID de nœud représentant les entrées invalides/vides, ce qui entraîne des problèmes de vérification des entrées inutilisées dans les API comme emberRemoveChild().
1210706	La destination et l'index PHY fournis dans la structure EmberExtraCounterInfo dans le cadre de emberCounterHandler() peuvent avoir été incorrects pour les types de compteurs MAC TX Unicast.
1211610 1212525	Correction d'un problème où les applications Dynamic Multiprotocol se bloquaient après l'activation du composant Secure Key Storage Upgrade.
1211847	Bien que la signature de emberCounterHandler() n'ait pas changé, la façon dont ses paramètres sont renseignés a légèrement changé. Les modifications autour de cette API sont expliquées dans la section 2 ci-dessus.
1212449	Les balises sortantes ont été incorrectement catégorisées par la couche MAC, ce qui a conduit emberCounterHandler() à ne pas capturer ces paquets avec le type de compteur EMBER_COUNTER_MAC_TX_BROADCAST et à compter à la place les balises avec le type de compteur EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS. Cela entraînait potentiellement des valeurs peu fiables pour le paramètre dest EmberNodeId transmis à la structure EmberCounterInfo.

ID #	Description
1214866	L'envoi de paquets d'interrogation de données dans certaines configurations à trafic élevé peut entraîner une panne de bus.
1216552	Un problème qui provoque une assertion dans des conditions de trafic intense est résolu.
1216613	Correction d'un problème qui entraînait une valeur incorrecte du rayon de diffusion du groupe dans le tableau proxy.
1222509	Le routeur/coordinateur envoie une demande de sortie et de réintégration à un périphérique final d'interrogation non enfant, mais la destination MAC est 0xFFFF au lieu de correspondre à l'adresse de destination NWK.
1223842	Correction d'un problème avec la génération du sl_component_catalog.h qui laissait du code indésirable provoquant un échec de compilation.
756628	Modification de l'invocation du rappel d'application emberAfMacFilterMatchMessageCallback pour qu'il soit appelé uniquement pour les messages ZLL validés par la pile.
816088	Configuration EMBER déplacée de zigbeed_configuration.h vers zigbeed. slcp.
829508	Pour éviter une condition de concurrence critique, une validation supplémentaire a été ajoutée dans emberSetLogicalAndRadioChannel pour renvoyer un échec si les couches inférieures sont occupées ou ne sont pas en mesure de changer de canal.

Problèmes connus dans la version actuelle

Les problèmes en gras ont été ajoutés depuis la version précédente. Si vous avez manqué une version, les notes de version récentes sont disponibles sur https://www.si-labs.com/developers/zigbee-emberznet dans l'onglet Tech Docs.

ID #	Description	Solution de contournement
N / A	·Les applications/composants suivants ne sont pas pris en charge dans cette version : Prise en charge d'EM4	La fonctionnalité sera activée dans les versions ultérieures.
193492	La macro de portage emberAfFillCommandGlobalServerToClientConfigureRe est interrompue. Le remplissage du tampon crée un paquet de commandes incorrect.	Utilisez la commande CLI « zcl global send-me-a-report » au lieu de l'API.
278063	Tunnellisation énergétique intelligente plugins avoir un traitement/utilisation conflictuel de l’index de la table d’adresses.	Aucune solution de contournement connue
289569	La liste de sélection des niveaux de puissance des composants du créateur de réseau n'offre pas une gamme complète de valeurs prises en charge pour EFR32.	Modifiez la plage <-8..20> spécifiée dans le commentaire CMSIS pour EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P PROPRIÉTÉ dans le /protocol/ZigBee/app/framework/plugin/network-creator/config/network-creator-config.h file. Par exempleample, passez à .
295498	La réception UART laisse parfois tomber des octets sous une charge importante dans le cas d'utilisation multiprotocole dynamique Zigbee+BLE.	Utilisez le contrôle de flux matériel ou réduisez le débit en bauds.
312291	EMHAL : les fonctions halCommonGetIntxxMillisecondTick sur les hôtes Linux utilisent actuellement la fonction d'obtention de meofday, dont il n'est pas garanti qu'elle soit monotone. Si l'heure du système change, cela peut entraîner des problèmes de synchronisation de la pile.	Modifiez ces fonctions pour utiliser clock_gettime avec la source CLOCK_MONOTONIC à la place.
338151	L'initialisation de NCP avec une valeur de nombre de tampons de paquets faible peut entraîner une corruption des paquets.	Utilisez la valeur réservée 0xFF pour le nombre de tampons de paquets afin d'éviter la valeur par défaut trop faible
387750	Le problème avec les formats de demande de table de routage sur le périphérique final.	Sous enquête
400418	Un initiateur Touchlink ne peut pas se lier à une cible de périphérique final non neuve en usine.	Aucune solution de contournement connue.
424355	Un initiateur compatible avec une cible de ligne tactile de périphérique endormi non neuf en usine n'est pas en mesure de recevoir une réponse d'informations sur le périphérique dans certaines circonstances.	Sous enquête
465180	L'élément d'optimisation du bloqueur radio de coexistence « Activer le contrôle d'exécution » peut bloquer le bon fonctionnement de Zigbee.	Le contrôle facultatif « Wi-Fi Select » de l’optimisation du bloqueur doit être laissé « Désactivé ».
480550	Le cluster OTA a sa méthode de fragmentation intégrée, il ne doit donc pas utiliser la fragmentation APS. Cependant, si le cryptage APS est activé, il augmente la charge utile des ImageBlockResponses jusqu'à une taille où la fragmentation APS est activée. Cela pourrait entraîner l’échec du processus OTA.	Aucune solution de contournement connue
481128	La cause détaillée de la réinitialisation et les détails du crash doivent être disponibles par défaut via l'UART virtuel (série 0) sur les plates-formes NCP lorsque le plug-in de diagnostic et le périphérique UART virtuel sont activés.	Étant donné que Serial 0 est déjà initialisé dans le NCP, les clients peuvent activer emberAfNcpInitCallback dans le framework Zigbee NCP et appeler les fonctions de diagnostic appropriées (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, halPrintCrashDetails et halPrintCrashData) dans ce rappel pour imprimer ces données sur Serial 0 pour viewing dans le journal de capture de Network Analyzer. Pour un exampPour savoir comment utiliser ces fonctions, reportez-vous au code inclus dans emberAfMainInit() de a-main-soc.c lorsque EXTENDED_RESET_INFO est défini.

ID #	Description	Solution de contournement
486369	Si un DynamicMultiProtocolLightSoc formant un nouveau réseau a des nœuds enfants restants d'un réseau qu'il a quitté, emberAfGetChildTableSize renvoie une valeur non nulle dans startIdentifyOnAllChildNodes, provoquant des messages d'erreur Tx 66 lors de l'adressage des enfants « fantômes ».	Effacez en masse la pièce si possible avant de créer un nouveau réseau ou vérifiez par programme la table enfant après avoir quitté le réseau et supprimez tous les enfants à l'aide de emberRemoveChild avant de former un nouveau réseau.
495563	Rejoindre SPI NCP Sleepy End Device SampL'application ne raccourcit pas l'interrogation, par conséquent la tentative de connexion échoue à l'état de mise à jour de la clé TC Link.	L'appareil qui souhaite rejoindre doit être en mode Short Poll avant de tenter de se joindre. Ce mode peut être forcé par le plugin End Device Support.
497832	Dans Network Analyzer, la répartition des commandes de prise en charge de l'application Zigbee pour la trame de demande de clé de vérification fait référence par erreur à la partie de la charge utile qui indique l'adresse source de la trame comme adresse de destination.	Aucune solution de contournement connue
519905 521782	Spi-NCP peut très rarement échouer à démarrer la communication du chargeur de démarrage à l'aide de la commande CLI 'bootload' du plugin ota-client.	Redémarrez le processus de démarrage
620596	PCN SPI Exampcâble pour BRD4181A (EFR32xGMG21) La broche par défaut nWake définie ne peut pas être utilisée comme broche de réveil.	Modifiez la broche par défaut pour nWake de PD03 à une broche compatible avec le réveil EM2/3 dans le plugin NCP-SPI.
631713	Un périphérique final Zigbee signalera les conflits d'adresses à plusieurs reprises si le plugin « Zigbee PRO Stack Library » est utilisé à la place de « Zigbee PRO Leaf Library ».	Utilisez la « Zigbee PRO Leaf Library » au lieu du plugin « Zigbee PRO Stack Library ».
670702	Les inefficacités du plug-in Reporting peuvent entraîner une latence importante en fonction de la fréquence d'écriture des données et de la taille des tables, ce qui peut interférer avec le code de l'application client, y compris la synchronisation des événements.	Si vous effectuez des écritures fréquentes, envisagez de vérifier les conditions de reporting et d'envoyer les rapports manuellement plutôt que d'utiliser le plugin.
708258	Une valeur non initialisée dans groups-server.c via addEntryToGroupTable() peut créer une liaison parasite et provoquer l'envoi de messages de rapport de diffusion de groupe.	Ajoutez « binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID ; » après « liaison.type = EMBER_MULTICAST_BINDING ; »
757775	Toutes les pièces EFR32 ont un décalage RSSI unique. De plus, la conception de la carte, les antennes et le boîtier peuvent avoir un impact sur le RSSI.	Lors de la création d'un nouveau projet, installez l'utilitaire RAIL, composant RSSI. Cette fonctionnalité inclut les Silabs de décalage RSSI par défaut mesurés pour chaque pièce. Ce décalage peut être modifié si nécessaire après test RF de votre produit complet.
758965	Les composants du cluster ZCL et la table de découverte des commandes ZCL ne sont pas synchronisés. Par conséquent, lors de l'activation ou de la désactivation d'un composant de cluster ZCL, les commandes implémentées ne seront pas activées/désactivées dans l'onglet de commande ZCL Advanced Configurator correspondant.	Activez/désactivez manuellement la découverte des commandes ZCL souhaitées dans le configurateur avancé ZCL.
765735	La mise à jour OTA échoue sur le périphérique Sleepy End avec la demande de page activée.	Utilisez Block Request au lieu de Page Request.
845649	Suppression de CLI : le composant principal n'élimine pas les appels cli EEPROM à sl_cli.h.	Supprimez le eeprom-cli.c file qui appelle le sl_cli.h. De plus, les appels à sl_cli.h ainsi qu'à sl_cli_command_arg_t dans ota-storage-simple-eeprom peuvent être commentés.
857200	serveur de zone ias. c permet de créer une liaison avec une adresse CIE « 0000000000000000 » et, par la suite, n'autorise pas d'autres liaisons.	Aucune solution de contournement connue
1019961	Marque Z3Gateway généréefile code en dur "gcc" en tant que CC	Aucune solution de contournement connue

ID #	Description	Solution de contournement
1039767	Problème de débordement de la file d'attente des nouvelles tentatives du réseau du routeur Zigbee dans le cas d'utilisation du RTOS multithread.	Zigbee Stack n'est pas thread-safe. Par conséquent, l'appel des API de la pile Zigbee à partir d'une autre tâche n'est pas pris en charge dans l'environnement du système d'exploitation et peut mettre la pile dans un état « non fonctionnel ». Reportez-vous à la note d'application suivante pour plus d'informations et une solution de contournement à l'aide du gestionnaire d'événements. https://www.silabs.com/documents/public/application- notes/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk- 7x.pdf .
1064370	Les Z3Switchampl'application n'active qu'un seul bouton (instance : btn1) par défaut, ce qui entraîne une incohérence dans la description du bouton dans le projet file.	Solution de contournement : installez l'instance btn0 manuellement lors de la création du projet Z3Switch.
1161063	Z3Light et potentiellement d'autres applications signalent des valeurs de révision de cluster incorrectes.	Mettez à jour manuellement l'attribut de révision du cluster vers la révision appropriée.
1164768, 1171478, 1171479	ERREUR : ezspErrorHandler 0x34 signalé à plusieurs reprises pendant le mode de réception mfglib	Pour réduire les messages d'erreur imprimés, configurez EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV ENT_TIMEOUT_MS sur l'application hôte à 100, afin que la file d'attente de rappel soit libérée plus rapidement.
1252460	Les routines de récupération SimEEPROM (pour v1 et v2) exécutées au démarrage peuvent effectuer des appels d'effacement de page flash mal alignés, ce qui entraîne des assertions pendant em_msc. c'est la routine MSC_ErasePage.	*Solution de contournement : placez la ligne de code suivante en haut de la fonction MSC_ErasePage() dans em_msc.c : start address = (uint32_t)((uint32_t)startAddress & ~(FLASH_PAGE_SIZE-1));**

Articles obsolètes

Obsolète dans la version
Dans GSDK 7.4.0.0 et versions ultérieures, y compris ce correctif, l'option « -v » dans une Z3Gateway pour une application hôte Linux afin de créer une interface telnet avec le port 4900 ou 4901 est obsolète. L'autre méthode recommandée pour créer une interface telnet consiste à utiliser des utilitaires Linux tels que « socat ».

Obsolète dans la version
Suppression des API de sécurité obsolètes suivantes :

braiseGetKey()
braiseGetKeyTableEntry()
emberSetKeyTableEntry()

emberHaveLinkKey()
emberAddOrUpdateKeyTableEntry()
braiseAddTransientLinkKey()

emberGetTransientKeyTableEntry()
braiseGetTransientLinkKey()
braiseHmacAesHash()

Utilisez les API fournies par Zigbee Security Manager pour accéder au stockage des clés et au hachage HMAC.

Éléments supprimés

Supprimé dans la version

Suppression des API publiques en double dans l'en-tête public file gp-types.h.

Le composant zigbee_end_device_bind a été supprimé. Ce composant a été utilisé par le coordinateur pour négocier les demandes de liaison pour les périphériques finaux. Cette fonctionnalité facultative a été supprimée de la R22 de la spécification principale de Zigbee.
Suppression de setPacketBufferCount() dans af-host.c et du cas de vérification inutile EZSP_CONFIG_PACKET_BUFFER_COUNT : dans command-handlers.c.
Suppression de l’argument memoryAllocation car il n’est pas nécessaire de le diviser en deux phases lors de l’initialisation de NCP.

Suppression de emberAfNcpInitCallback() dans l'application se14-comms-hub, se14-ihd et se14-meter-gas.
Suppression du paramètre EZSP_CONFIG_RETRY_QUEUE_SIZE lors de l'initialisation de ncp dans ncp-configuration.c

Passerelle multiprotocole et RCP

Nouveaux articles
Ajouté dans la version

L'écoute simultanée, la possibilité pour les piles Zigbee et OpenThread de fonctionner sur des canaux 802.15.4 indépendants lors de l'utilisation d'un RCP EFR32xG24 ou xG21, est libérée.
L'écoute simultanée n'est pas disponible pour la combinaison 802.15.4 RCP/Bluetooth RCP, la combinaison Zigbee NCP/OpenThread RCP ou pour le système sur puce (SoC) Zigbee/OpenThread. Il sera ajouté à ces produits dans une prochaine version.
L'extension du fournisseur OpenThread CLI a été ajoutée aux applications hôtes OpenThread des conteneurs multiprotocoles. Cela inclut les commandes coex cli.

Améliorations
Modifié dans la version

La combinaison multiprotocole Zigbee NCP/OpenThread RCP est désormais de qualité production.

Problèmes résolus
Corrigé dans la version

ID #	Description
1213701	zigbeed n'autorisait pas la création d'une entrée de table de correspondance source pour un enfant si la file d'attente indirecte MAC avait déjà des données en attente pour cet enfant. Ce comportement pourrait entraîner l'échec des transactions de la couche application entre l'enfant et un autre appareil en raison du manque d'APS Ack ou de réponse de la couche application, notamment la perturbation et l'arrêt inattendu des mises à niveau ZCL OTA ciblant l'appareil enfant.
1244461	L'entrée du tableau de correspondance source pour l'enfant en cours a pu être supprimée malgré les messages en attente.

Corrigé dans la version

ID #	Description
1081828	Problème de débit avec les DMP Zigbee/BLE basés sur FreeRTOSamples applications.
1090921	Z3GatewayCpc a eu du mal à former un réseau dans un environnement bruyant.
1153055	Une assertion sur l'hôte a été provoquée lorsqu'il y a eu un échec de communication lors de la lecture de la version NCP à partir des zigbee_ncp-ble_ncp-uart sampl'application.
1155676	Le RCP 802.15.4 a rejeté tous les paquets unicast reçus (après accusé de réception MAC) si plusieurs interfaces 15.4 partageaient le même ID de nœud 16 bits.
1173178	L'hôte a faussement signalé des centaines de paquets reçus avec mfglib dans la configuration Host-RCP.
1190859	Erreur EZSP lors de l'envoi de paquets aléatoires mfglib dans la configuration Host-RCP.
1199706	Les interrogations de données des enfants de périphériques finaux oubliés ne définissaient pas correctement une trame en attente sur le RCP pour mettre en file d'attente une commande Quitter et rejoindre l'ancien enfant.
1207967	La commande « mfglib send random » envoyait des paquets supplémentaires sur Zigbeed.
1208012	Le mode mfglib rx ne mettait pas correctement à jour les informations sur les paquets lors de la réception sur le RCP.
1214359	Le nœud coordinateur est tombé en panne lorsque 80 routeurs ou plus ont tenté de se joindre simultanément à la configuration Host-RCP.
1216470	Après avoir relayé une diffusion pour le masque d'adresse 0xFFFF, un Zigbee RCP agissant en tant qu'appareil parent laisserait l'indicateur de données en attente défini pour chaque enfant. Cela faisait que chaque enfant restait éveillé en attendant des données après chaque interrogation, et nécessitait une autre transaction de données en attente vers chaque appareil final pour finalement effacer cet état.

Problèmes connus dans la version actuelle

ID #	Description	Solution de contournement
811732	La prise en charge des jetons personnalisés n'est pas disponible lors de l'utilisation de Zigbeed.	La prise en charge est prévue dans une future version.
937562	La commande Bluetoothctl 'advertise on' échoue avec l'application rcp-uart-802154-blehci sur Raspberry Pi OS 11.	Utilisez l'application btmgmt au lieu de bluetoothctl.
1022972	Coex ne fonctionne pas sur ZB NCP + OT RCP.	Un support est prévu pour une prochaine version.
1074205	Le CMP RCP ne prend pas en charge deux réseaux sur le même identifiant PAN.	Utilisez différents identifiants PAN pour chaque réseau. La prise en charge est prévue dans une future version.
1122723	Dans un environnement chargé, la CLI peut ne plus répondre dans l'application z3-light_ot-ftd_soc.	Aucune solution de contournement connue.
1124140	z3-light_ot-ftd_socsampL'application n'est pas capable de former le réseau Zigbee si le réseau OT est déjà opérationnel.	Démarrez d'abord le réseau Zigbee, puis le réseau OT.
1170052	CMP Zigbee NCP + OT RCP et DMP Zigbee NCP + BLE NCP peuvent ne pas tenir sur les parties de RAM de 64 Ko et inférieures dans cette version actuelle.	Les parties de 64 Ko ne sont actuellement pas prises en charge pour ces applications.
1209958	Le ZB/OT/BLE RCP sur Bobcat et Bobcat Lite peut cesser de fonctionner après quelques minutes lors de l'exécution des trois protocoles.	Sera abordé dans une prochaine version
1221299	Les lectures Mfglib RSSI diffèrent entre RCP et NCP.	Sera abordé dans une prochaine version.
1231021	OTBR peut affirmer lorsque plus de 80 appareils zigbee se joignent simultanément.	Ajout d'un correctif qui peut contourner le problème. Sera entièrement abordé dans une prochaine version.

Articles obsolètes

Aucun

Éléments supprimés
Supprimé dans la version

La macro « NONCOMPLIANT_ACK_TIMING_WORKAROUND » a été supprimée. Toutes les applications RCP prennent désormais en charge par défaut un délai d'exécution de 192 μs pour les accusés de réception non améliorés, tout en utilisant un délai d'exécution de 256 μs pour les accusés de réception améliorés requis par CSL.

Utilisation de cette version
Cette version contient les éléments suivants :

Pile Zigbee

Cadre d'application Zigbee
Zigbee Samples Applications

Pour plus d'informations sur Zigbee et le SDK EmberZNet, consultez UG103.02 : Principes de base de Zigbee.
Si vous êtes un nouvel utilisateur, consultez QSG180 : Guide de démarrage rapide Zigbee EmberZNet pour SDK 7.0 et versions ultérieures, pour obtenir des instructions sur la configuration de votre environnement de développement, la création et le flashage en tant que tel.ampl'application et les références à la documentation pointant vers les prochaines étapes.

Installation et utilisation

Le SDK Zigbee EmberZNet est fourni dans le cadre du Gecko SDK (GSDK), la suite de SDK de Silicon Labs. Pour démarrer rapidement avec le GSDK, installez Simplicity Studio 5, qui configurera votre environnement de développement et vous guidera tout au long de l'installation du GSDK. Simplicity Studio 5 comprend tout le nécessaire pour le développement de produits IoT avec les appareils Silicon Labs, notamment un lanceur de ressources et de projets, des outils de configuration logicielle, un IDE complet avec la chaîne d'outils GNU et des outils d'analyse. Les instructions d'installation sont fournies dans le guide de l'utilisateur en ligne de Simplicity Studio 5.
Alternativement, Gecko SDK peut être installé manuellement en téléchargeant ou en clonant la dernière version de GitHub. Voir https://github.com/Sili-conLabs/gecko_sdk pour plus d'informations.

Simplicity Studio installe le GSDK par défaut dans :

(Windows) : C:\Utilisateurs\ \SimplicityStudio\SDKs\gecko_sdk

(MacOS) : /Utilisateurs/ /SimplicityStudio/SDKs/gecko_sdk

La documentation spécifique à la version SDK est installée avec le SDK. Des informations supplémentaires peuvent souvent être trouvées dans les articles de la base de connaissances (KBA). Les références de l'API et d'autres informations sur cette version et les versions antérieures sont disponibles sur https://docs.silabs.com/.

Informations sur la sécurité

Intégration sécurisée du coffre-fort
Pour les applications qui choisissent de stocker les clés en toute sécurité à l'aide du composant Secure Key Storage sur les pièces Secure Vault-High, le tableau suivant présente les clés protégées et leurs caractéristiques de protection de stockage gérées par le composant Zigbee Security Manager.

Clé enveloppée	Exportable / Non Exportable	Remarques
Clé réseau	Exportable
Clé de lien du centre de gestion de la confidentialité	Exportable
Clé de lien transitoire	Exportable	Table de clés indexées, stockée sous forme de clé volatile
Clé de lien d'application	Exportable	Table de clés indexées
Clé EZSP sécurisée	Exportable
Clé de chiffrement ZLL	Exportable
Clé préconfigurée ZLL	Exportable
Clé proxy GPD	Exportable	Table de clés indexées
Clé d'évier GPD	Exportable	Table de clés indexées
Clé interne/espace réservé	Exportable	Clé interne à utiliser par Zigbee Security Manager

Les clés enveloppées qui sont marquées comme « non exportables » peuvent être utilisées mais ne peuvent pas être viewed ou partagé au moment de l'exécution.
Les clés encapsulées marquées comme « exportables » peuvent être utilisées ou partagées au moment de l'exécution, mais restent cryptées lorsqu'elles sont stockées dans la mémoire flash.
Les applications utilisateur n'ont jamais besoin d'interagir avec la majorité de ces clés. Les API existantes pour gérer les clés Link Key Table ou les clés transitoires sont toujours disponibles pour l'application utilisateur et sont désormais acheminées via le composant Zigbee Security Manager.

Certaines de ces clés pourraient ne plus être exportables vers l’application utilisateur à l’avenir. Les applications utilisateur sont encouragées à ne pas s'appuyer sur l'exportation de clés, sauf en cas d'absolue nécessité.
Pour plus d'informations sur la fonctionnalité Secure Vault Key Management, consultez AN1271 : Secure Key Storage.

Avis de sécurité
Pour vous abonner aux avis de sécurité, connectez-vous au portail client de Silicon Labs, puis sélectionnez Accueil du compte. Cliquez sur ACCUEIL pour accéder à la page d'accueil du portail, puis cliquez sur la vignette Gérer les notifications. Assurez-vous que « Software/Security Advisory Notices & Product Change Notices (PCNs) » est coché et que vous êtes abonné au minimum pour votre plate-forme et votre protocole. Cliquez sur Enregistrer pour enregistrer les modifications.

Soutien
Les clients du kit de développement sont éligibles à la formation et au support technique. Utilisez le Zigbee des Laboratoires Silicon web pour obtenir des informations sur tous les produits et services Silicon Labs Zigbee et pour vous inscrire au support produit.
Vous pouvez contacter le support de Silicon Laboratories à http://www.silabs.com/support.

Studio Simplicité
Accès en un clic aux outils MCU et sans fil, à la documentation, aux logiciels, aux bibliothèques de code source et plus encore. Disponible pour Windows, Mac et Linux !

Clause de non-responsabilité
Silicon Labs a pour objectif de fournir aux clients la documentation la plus récente, précise et approfondie de tous les périphériques et modules disponibles pour les implémenteurs de systèmes et de logiciels utilisant ou prévoyant d'utiliser les produits Silicon Labs. Les données de caractérisation, les modules et périphériques disponibles, les tailles de mémoire et les adresses de mémoire se réfèrent à chaque périphérique spécifique, et les paramètres « typiques » fournis peuvent varier et varient effectivement dans différentes applications.ampLes fichiers décrits ici sont uniquement à des fins d'illustration. Silicon Labs se réserve le droit d'apporter des modifications sans préavis aux informations, spécifications et descriptions de produits contenues dans le présent document, et ne donne aucune garantie quant à l'exactitude ou à l'exhaustivité des informations incluses. Sans notification préalable, Silicon Labs peut mettre à jour le micrologiciel du produit pendant le processus de fabrication pour des raisons de sécurité ou de fiabilité. De tels changements n'altéreront pas les spécifications ou les performances du produit. Silicon Labs décline toute responsabilité quant aux conséquences de l'utilisation des informations fournies dans ce document. Ce document n'implique ni n'accorde expressément de licence pour concevoir ou fabriquer des circuits intégrés. Les produits ne sont pas conçus ou autorisés pour être utilisés dans des dispositifs FDA de classe III, des applications pour lesquelles une approbation préalable à la commercialisation par la FDA est requise ou des systèmes de survie sans le consentement écrit spécifique de Silicon Labs. Un « Life Support System » est tout produit ou système destiné à soutenir ou maintenir la vie et/ou la santé, qui, s'il tombe en panne, peut raisonnablement entraîner des blessures corporelles importantes ou la mort. Les produits Silicon Labs ne sont pas conçus ni autorisés pour des applications militaires. Les produits Silicon Labs ne doivent en aucun cas être utilisés dans des armes de destruction massive, y compris (mais sans s'y limiter) des armes nucléaires, biologiques ou chimiques, ou des missiles capables de transporter de telles armes. Silicon Labs décline toute garantie expresse et implicite et décline toute responsabilité en cas de blessures ou de dommages liés à l'utilisation d'un produit Silicon Labs dans de telles applications non autorisées.

Note: Ce contenu peut contenir une terminologie offensante qui est maintenant obsolète. Silicon Labs remplace ces termes par un langage inclusif dans la mesure du possible. Pour plus d'informations, visitez www.silabs.com/about-us/inclusive-lexicon-project.

Informations sur la marque déposée
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® et le logo Silicon Labs®, Bluegiga®, le logo Bluegiga®, EFM®, EFM32®, EFR, Ember®, Energy Micro, le logo Energy Micro et leurs combinaisons, « les microcontrôleurs les plus économes en énergie au monde », Redpine Signals®, WiSeConnect, n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, le logo Telegesis®, USBXpress®, Zentri, le logo Zentri et Zentri DMS, Z-Wave® et autres sont des marques commerciales ou des marques déposées de Silicon Labs. ARM, CORTEX, Cortex-M3 et THUMB sont des marques commerciales ou des marques déposées d'ARM Holdings. Keil est une marque déposée d'ARM Limited. Wi-Fi est une marque déposée de Wi-Fi Alliance. Tous les autres produits ou noms de marque mentionnés ici sont des marques commerciales de leurs détenteurs respectifs.

CONTACT

Laboratoires Silicon Inc.

400 Ouest César Chavez
Austin, TX 78701
USA

www.silabs.com

Documents / Ressources

SILICON LABS SDK 7.4.1.0 GA Logiciel de pile de protocole Zigbee [pdf] Guide de l'utilisateur
SDK 7.4.1.0 GA Logiciel de pile de protocole Zigbee, SDK 7.4.1.0 GA, logiciel de pile de protocole Zigbee, logiciel de pile de protocole, logiciel de pile

Références

Manuel d'utilisation

SILICON LABS SDK 7.4.1.0 GA Logiciel de pile de protocole Zigbee

Informations sur le produit

Instructions d'utilisation du produit

FAQ

CARACTÉRISTIQUES PRINCIPALES

Nouveaux composants

Comportement prévu

Améliorations

Problèmes résolus

Problèmes connus dans la version actuelle

Articles obsolètes

Éléments supprimés

Passerelle multiprotocole et RCP

Installation et utilisation

Informations sur la sécurité

CONTACT

Documents / Ressources

Références

Laisser un commentaire

Annuler la réponse