Instructions pour le SDK Zigbee EmberZ Net de SILICON LABS

Silicon Labs est le fournisseur de choix des fabricants d'équipement d'origine qui développent la mise en 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 kit de développement logiciel (SDK) EmberZNet de Silicon Labs contient l'implémentation de la spécification de la pile Zigbee de Silicon Labs.

CARACTÉRISTIQUES PRINCIPALES

Zigbee

-250+ entrées dans la table des clés de lien APS
Prise en charge de ZigbeeD sur Android 12 (v21.0.6113669) et Tizen (v0.1-13.1)

Prise en charge du module xG26

Multiprotocole

Prise en charge de ZigbeeD et OTBR sur OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT avec écoute simultanée sur MG26 pour SoC – GA

Composant de priorité du planificateur radio unifié 802.15.4
Prise en charge du packaging Debian pour les applications hôtes MP – Alpha

Nouveaux articles

Changements importants
La taille de la table de clés de lien APS (configurée à l'aide de SL_ZIGBEE_KEY_TABLE_SIZE) est étendue de 127 à 254 entrées.

La prise en charge R23 est ajoutée pour la fonctionnalité de mise en service du réseau ZDD. La fonctionnalité de tunneling est disponible sans prise en charge pour les cas d'utilisation du réseau hérité.

Les composants Network Steering et Network Creator ont été mis à jour pour inclure la prise en charge de la jonction R23. Ceux-ci incluent les modifications connexes suivantes.
- La stratégie de demande de clé de lien du Centre de confiance (TCLK) par défaut a été mise à jour pour générer de nouvelles clés pour chaque périphérique demandeur. Une nouvelle clé est générée chaque fois que les périphériques demandeurs tentent de mettre à jour leur clé de lien du Centre de confiance.
- En raison du changement de politique TCLK précédent, le composant Network Creator Security requiert désormais le composant Security Link Keys. La mise à niveau des applications sera mise à jour pour se conformer à cette nouvelle exigence.
- Une nouvelle configuration,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY a été ajouté pour permettre la jonction à l'aide d'une clé hachée principale. Cette configuration se trouve sous le composant Network Creator Security. L'utilisation de cette stratégie permet à chaque périphérique de jonction de recevoir une clé TCLK unique après la jonction, mais les tentatives répétées de mise à jour de la clé TCLK n'entraîneront pas de nouvelle clé pour le périphérique demandeur. Cette utilisation de clés de lien hachées était la stratégie par défaut avant cette version, et l'utilisation de cette stratégie permet au Centre de gestion de la confidentialité d'éviter d'introduire le composant Clés de lien de sécurité, qui enregistre les clés dans Flash.
  Note:Silicon Labs ne recommande pas l'utilisation de cette politique, car elle empêche les appareils qui se connectent de déployer ou de mettre à jour leurs TCLK.

Un nouvel ensemble de configuration est ajouté au composant zigbee_ezsp_spi pour permettre la configuration du périphérique SPI hôte et de ses interfaces de broches.
L'examples projets, y compris le projet files (.slcps) et le dossier du projet sont renommés selon les directives de dénomination de Silicon Labs et déplacés sous le répertoire « projets ».

Prise en charge de la nouvelle plate-forme

De nouveaux modules
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nouvelles cartes radio
- MGM260P-RB4350A
- MGM260P-RB4351A
Nouvelle partie
- efr32xg27
Kit Explorateur
- BRD2709A
- MGM260P-EK2713A

Nouvelle documentation
Un nouveau guide d'utilisation EZSP UG600 pour les versions 8.1 et supérieures.

Améliorations

Les limites de SL_ZIGBEE_KEY_TABLE_SIZE ont été étendues jusqu'à 254 entrées.
Ajout de zigbee_security_link_keys à Z3Light.
Ajout de zigbee_security_link_keys à zigbee_mp_z3_tc_z3_tc. Mise à jour de la taille de sa table de clés également.
Augmentation de la taille de la table de clés de la passerelle Z3 (qui sera définie sur ncp) à 20.

Problèmes résolus

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.silabs.com/developers/zigbee-emberznet dans l'onglet Tech Docs.

Articles obsolètes

Le composant zigbee_watchdog_periodic_refresh n'est plus utilisé dans l'infrastructure d'application Zigbee et est obsolète dans cette version. Le minuteur de surveillance est désactivé par défaut pour tous les samples applications. Un composant de surveillance amélioré sera ajouté au SDK à l'avenir.
Note: Activez le minuteur de surveillance avec l'élément de configuration SL_LEGACY_HAL_DISABLE_WATCHDOG défini sur 0 dans votre application

Limitations et considérations relatives au réseau

Les applications Trust Center par défaut fournies avec cette version d'EmberZNet sont capables de prendre en charge plusieurs périphériques sur le réseau. Ce nombre est déterminé en fonction de plusieurs facteurs, notamment les tailles de table configurées, l'utilisation de NVM et d'autres valeurs de temps de génération et d'exécution. Les utilisateurs souhaitant créer de grands réseaux peuvent être confrontés à des problèmes de ressources lorsqu'ils développent un réseau plus grand que celui que l'application peut prendre en charge. Par exempleampAinsi, un périphérique demandant une clé de lien du Centre de gestion de la confidentialité au Centre de gestion de la confidentialité peut déclencher un rappel sl_zigbee_af_zigbee_key_establishment_cb sur le Centre de gestion de la confidentialité avec un statut défini sur SL_ZIGBEE_KEY_TABLE_FULL, indiquant que la table de clés n'a pas de place pour ajouter une nouvelle clé pour le périphérique demandeur ou que NVM3 n'a pas d'espace disponible. Silicon Labs fournit les recommandations suivantes aux utilisateurs souhaitant créer de grands réseaux. Pour les applications du Centre de gestion de la confidentialité, les configurations suivantes sont recommandées. Ces recommandations ne sont pas exhaustives et servent de base aux applications visant à développer de grands réseaux.

Inclusion du composant Table d'adresses (zigbee_address_table), avec
- l'élément de configuration SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE défini sur la taille du réseau souhaité
- la valeur SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE définie au maximum (4)

Inclusion du composant Clés de lien de sécurité (zigbee_security_link_keys), avec
- La valeur SL_ZIGBEE_KEY_TABLE_SIZE est définie sur la taille du réseau
Les éléments de configuration suivants sont définis en fonction de la taille du réseau souhaité
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, tel que trouvé dans le composant Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, tel que trouvé dans le composant de routage source, si le routage source est utilisé
Ajustement de NVM3_DEFAULT_NVM_SIZE et NVM3_DEFAULT_CACHE_SIZE en fonction de l'utilisation de NVM3
- Par exemple, les tailles de réseau supérieures à 65 nœuds nécessitent probablement une taille NVM3 de 64 Ko. La taille NVM3 par défaut dans les protocoles Zigbee de Silicon Labsampla taille des applications est de 32 K. Les applications qui utilisent davantage NVM peuvent nécessiter un réglage encore plus élevé de cette valeur.
- Les grands réseaux jusqu'à 65 nœuds peuvent nécessiter une taille de cache NVM3 de 1200 2400 octets ; la croissance de réseaux plus grands que cela peut nécessiter de doubler cette valeur à XNUMX XNUMX octets.

Ces ajustements s'appliquent uniquement au Centre de gestion de la confidentialité

Passerelle multiprotocole et RCP

Nouveaux articles
Prise en charge GA SoC activée pour BLE DMP avec Zigbee + Openthread CMP avec écoute simultanée sur les composants xG26. La prise en charge alpha de Debian a été ajoutée pour les applications Zigbeed, OTBR et Z3Gateway. Zigbeed et OTBR sont également fournis au format de package DEB pour la plateforme de référence choisie (Raspberry PI 4). Voir Exécution simultanée de Zigbee, OpenThread et Bluetooth sur un hôte Linux avec un coprocesseur multiprotocole, disponible à l'adresse docs.silabs.com, pour plus de détails. Ajout de la prise en charge de Zigbeed pour Tizen-0.1-13.1 pour arm32 et aarch64 ainsi que pour Android 12 pour aarch64. Vous trouverez plus d'informations sur Zigbeed à l'adresse docs.silabs.com. Ajout du nouveau composant « Priorité du planificateur radio unifié 802.15.4 ». Ce composant est utilisé pour configurer les priorités radio d'une pile 15.4. Le composant nécessite également le nouveau composant « radio_priority_configurator ». Ce composant permet aux projets d'utiliser l'outil Configurateur de priorité radio dans Simplicity Studio pour configurer les niveaux de priorité radio des piles qui le nécessitent.

Améliorations
Note d'application L'exécution simultanée de Zigbee, OpenThread et Bluetooth sur un hôte Linux avec un coprocesseur multiprotocole (AN1333) a été déplacée vers docs.silabs.com. La prise en charge d'OpenWRT est désormais de qualité GA. La prise en charge d'OpenWRT a été ajoutée pour les applications Zigbee, OTBR et Z3Gateway. Zigbee et OTBR sont également fournis au format de package IPK pour la plateforme de référence (Raspberry PI 4). Voir Exécution simultanée de Zigbee, OpenThread et Bluetooth sur un hôte Linux avec un coprocesseur multiprotocole, disponible à l'adresse docs.silabs.com, pour plus de détails.

Problèmes résolus

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 icihttps://www.silabs.com/developers/simplicity-software-development-kit.

Articles obsolètes
Le « conteneur multiprotocole » actuellement disponible sur DockerHub (siliconlabsinc/multiprotocol) sera obsolète dans une prochaine version. Le conteneur ne sera plus mis à jour et ne pourra plus être extrait de DockerHub. Les paquets basés sur Debian pour cpcd, ZigBee et ot-br-posix, ainsi que les projets générés et compilés nativement, remplaceront les fonctionnalités perdues avec la suppression du conteneur.

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 de documentation pointant vers les étapes ext.

Installation et utilisation
Le SDK Zigbee EmberZNet est fourni dans le cadre du SDK Simplicity, la suite de SDK Silicon Labs. Pour démarrer rapidement avec le SDK Simplicity, installez Simplicity Studio 5, qui configurera votre environnement de développement et vous guidera tout au long de l'installation du SDK Simplicity. Simplicity Studio 5 comprend tout ce qui est nécessaire au développement de produits IoT avec des 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. Le SDK Simplicity peut également être installé manuellement en téléchargeant ou en clonant la dernière version à partir de GitHub. Voir https://github.com/SiliconLabs/simplicity_sdk pour plus d'informations. Simplicity Studio installe le SDK Simplicity par défaut dans :

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

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

La documentation spécifique à la version du SDK est installée avec le SDK. Des informations supplémentaires sont souvent disponibles dans les articles de la base de connaissances (KBA). Les références API et d'autres informations sur cette version et les versions antérieures sont disponibles à l'adresse suivante : 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.Les clés enveloppées qui sont marquées comme « non exportables » peuvent être utilisées mais ne peuvent pas être viewLes clés encapsulées marquées comme « exportables » peuvent être utilisées ou partagées au moment de l'exécution, mais restent chiffrées lorsqu'elles sont stockées dans 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 acheminées via le composant Zigbee Security Manager.

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 page 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 Silicon Laboratories à http://www.silabs.com/support.

Certification Zigbee
La version Ember ZNet 8.1 a été qualifiée pour la plate-forme compatible Zigbee pour les architectures SoC, NC, P et RCP. Il existe un ID de certification ZCP lié à cette version, veuillez vérifier le CSA website ici:
https://csa-iot.org/csa-iot_products/.

Veuillez noter que la certification ZCP est filed publier le communiqué, et cela prend quelques semaines avant d'être reflété sur le CSA website. Pour toute question supplémentaire, veuillez contacter le support de Silicon Laboratories à http://www.silabs.com/support.

FAQ

Q : Comment mettre à jour la taille de la table de clés de lien APS dans le SDK ?
R : La taille de la table de clés de lien APS peut être configurée à l'aide du paramètre SL_ZIGBEE_KEY_TABLE_SIZE. Dans la version 8.1, elle a été étendue de 127 à 254 entrées.

Q : Quelles sont les améliorations de la version 8.1 ?
R : La version 8.1 apporte des améliorations telles que l'extension de la taille de la table de clés de lien APS, le changement de nom des composants, l'ajout d'une protection mutex pour la file d'attente d'événements Athe pp Framework, et bien plus encore. Reportez-vous aux notes de version pour obtenir une liste détaillée des améliorations.

Q : Comment gérer les problèmes résolus dans le SDK ?
R : Problèmes résolus dans le SDK, notamment la résolution de problèmes potentiels liés à la configuration de la taille de la table de voisinage, le changement de nom des composants, la correction de la surcharge de la route source, la gestion des commandes ZCL, etc. Assurez-vous de mettre à jour vers la dernière version pour bénéficier de ces correctifs.

Documents / Ressources

Kit de développement logiciel Zigbee EmberZ Net de SILICON LABS [pdf] Instructions
Kit de développement logiciel Zigbee EmberZ Net, Kit de développement logiciel EmberZ Net, Kit de développement logiciel Net, Kit de développement logiciel

Références

Manuel d'utilisation

Kit de développement logiciel Zigbee EmberZ Net de SILICON LABS

Caractéristiques

Informations sur le produit