Matter

Référence du pilote Matter : mise en service par Bluetooth dans le Fabric local, le déroulement d'Appairer un équipement, l'identité de nœud et les tags de cluster.

Afficher en Markdown

Le pilote Matter lit des équipements Matter sur Thread : capteurs intelligents, prises, luminaires et équipements semblables certifiés pour la norme Matter. Ganter Lab agit comme un contrôleur Matter avec son propre Fabric local : il met chaque équipement en service une fois par Bluetooth basse consommation sur cet ordinateur, lui remet les identifiants de votre réseau Thread existant, et lui parle ensuite sur ce réseau par votre routeur de bordure Thread.

Cela inverse l'ordre habituel de mise en place. Un équipement Matter ne part pas d'un hôte et d'un port : il part d'une cérémonie d'appairage, et seule l'identité stable du nœud mis en service est enregistrée ensuite.

Ce qu'il vous faut avant l'appairage :

Un adaptateur Bluetooth basse consommation sur cet ordinateur, allumé, et Windows qui autorise Ganter Lab à l'employer.
Un réseau Thread existant avec un routeur de bordure, et son jeu de données opérationnel actif complet. Ganter Lab joint les équipements à votre réseau; il ne peut pas en inventer les identifiants.
Le code d'installation de l'équipement, imprimé sur l'équipement ou son emballage, et l'équipement en mode appairage.

Le déroulement d'Appairer un équipement

Sur le pilote Matter, la barre de commandes offre Appairer un équipement là où les autres pilotes offrent Ajouter un équipement. Elle ouvre un formulaire à trois champs :

Champ	Ce que c'est	Format	Par défaut
Nom de l'équipement	Le nom modifiable que l'équipement portera dans le Connector.	Texte libre	`Matter device`
Code d'installation Matter	Le code d'appairage manuel officiel, ou la charge utile QR complète. Saisi masqué, avec une commande pour le révéler.	Un code manuel de 11 ou 21 chiffres (les tirets et les espaces sont ignorés; le chiffre de contrôle est vérifié), ou la charge utile QR complète commençant par `MT:`. Une charge utile QR qui n'annonce pas la mise en service par Bluetooth est refusée, comme le sont les mots de passe réservés ou hors plage.	vide
Jeu de données opérationnel Thread	Le jeu de données actif complet de votre réseau Thread, remis par l'administrateur du réseau ou par le routeur de bordure. Saisi masqué, avec une commande pour le révéler.	Du texte hexadécimal (les espaces et un préfixe `hex:` sont tolérés), 254 octets au plus une fois décodé. Ce doit être le jeu de données complet : Active Timestamp, Channel, Channel Mask, Extended PAN ID, Mesh-Local Prefix, Network Key, Network Name, PAN ID, PSKc et Security Policy doivent tous être présents, et un jeu de données partiel ou malformé est refusé avec l'élément manquant nommé.	vide

Appairer un équipement reste désactivé tant que les trois champs ne sont pas remplis. Pendant l'appairage, le formulaire rapporte son étape : Valider (vérification du code et du jeu de données), Trouver (recherche de l'équipement par Bluetooth), Appairer (authentification avec le code d'installation), Rejoindre Thread (envoi de la configuration du réseau et attente que l'équipement paraisse sur le réseau Thread), Enregistrer (inscription du nœud mis en service dans le Fabric local).

Annuler est disponible tant que l'équipement physique n'a pas été changé; dès que la mise en service a modifié l'équipement, le bouton indique que Ganter Lab termine de façon sûre et le déroulement achève l'inscription au lieu d'abandonner un nœud à moitié mis en service. Un seul appairage tourne à la fois; une deuxième tentative pendant qu'un appairage est en cours est refusée.

Les secrets ne sont jamais conservés. Le code d'installation et le jeu de données Thread n'existent que dans le formulaire tant qu'il est ouvert; ils sont effacés quand l'appairage finit, échoue ou est annulé, et rien de leur contenu n'est écrit dans la configuration. Ce qui est enregistré est l'identité du nœud, et rien d'autre.

Si l'appairage échoue, le message énonce la cause : un code ou un jeu de données invalide, un Bluetooth absent ou désactivé, Windows qui refuse l'accès au Bluetooth, aucun équipement correspondant trouvé, l'équipement qui rejette le code d'installation, ou l'équipement qui est mis en service mais ne paraît jamais sur le réseau Thread. Un mauvais code d'installation est nommé comme tel : la réponse est donc de relire le code imprimé et de remettre l'équipement en mode appairage.

Chaque fois qu'un échec arrive après que l'équipement a déjà été mis en service, le message le dit et montre l'identifiant de nœud : le nœud reste dans le Fabric et peut être ajouté plus tard avec Découvrir, une fois qu'il atteint le réseau. Ne réinitialisez pas l'équipement dans ce cas; seul un message qui dit que rien n'a été enregistré signifie que l'équipement a été laissé intact.

L'identité d'un nœud

Un équipement appairé est lié à l'identifiant de nœud stable de 64 bits de l'équipement, montré en lecture seule dans sa carte Connexion sous forme de 16 chiffres hexadécimaux, à côté de l'état de l'équipement. Le nom affiché modifiable est à vous; l'identifiant de nœud ne l'est pas. Un équipement dont l'identité enregistrée ne peut plus être lue montre Appairage à refaire à sa place.

Comme l'identité est l'identifiant de nœud, les équipements Matter gardent un état de connexion indépendant : désactiver, supprimer ou perdre un nœud ne rend pas un autre indisponible, et supprimer un équipement ne libère que son usage de la session sécurisée, sans retirer l'équipement du Fabric local.

Découverte

Découvrir sur le pilote Matter liste les nœuds déjà mis en service dans le Fabric local de cette application, si bien qu'un nœud dont l'équipement a été supprimé (ou dont l'appairage s'est terminé sans équipement) peut être rajouté sans nouvelle cérémonie. Un identifiant de nœud déjà configuré est marqué comme tel et Ouvrir mène à l'équipement existant. Les candidats de la découverte portent l'identité du nœud et aucun secret d'installation. Le déroulement général de la découverte est décrit sur la page Connector.

Tags

Un tag Matter n'a pas de champ d'adresse en texte libre. Le nom du tag est le nom du cluster à lire. Le nom doit correspondre au nom du cluster tel que la spécification Matter l'écrit, espaces et ponctuation compris, la casse étant ignorée : On/Off, Level Control, Temperature Measurement. Comme le nom est l'adresse, il ne peut pas contenir de deux-points; le volet en refuse un et le dit. Un nom qu'aucun cluster ne porte se lit comme une erreur qui nomme le cluster inconnu. La valeur est convertie vers le type de donnée déclaré du tag; une valeur que le type déclaré ne peut pas représenter se lit elle aussi comme une erreur plutôt qu'en nombre de remplacement.

Deux champs numériques disent où, sur l'équipement, lire ce cluster. Un équipement expose un endpoint par sortie commandable, numéroté à partir de 1, si bien qu'une lampe à deux canaux ou une barre d'alimentation se lit un endpoint par tag; l'endpoint 0 est le nœud lui-même. L'attribut est la valeur du cluster à lire, et 0 est la valeur propre du cluster, qui est ce que presque tous les tags veulent.

Champ	Ce qu'il fait	Valeurs	Par défaut
Nom du tag	Nomme le tag et sélectionne le cluster Matter lu sur le nœud. Sans deux-points.	Le nom du cluster tel qu'il s'écrit, par exemple `On/Off`	`Tag 1`
Sortie (endpoint)	Quelle sortie de l'équipement ce tag lit.	0 et au-delà; 1 est la première sortie commandable	1
Attribut	Quel attribut du cluster ce tag lit.	0 et au-delà; 0 est la valeur propre du cluster	0
Type de donnée	Le type OPC UA sous lequel la valeur est exposée.	Boolean, Int32, UInt32, Float, Double, String	Float
Intervalle de scrutation	À quelle fréquence l'attribut est lu, par tag, la valeur de l'équipement (1000 ms) s'appliquant là où le tag n'en énonce aucune.	millisecondes	la valeur de l'équipement

Les tags Matter sont en lecture seule : le champ d'accès n'offre aucun choix inscriptible et les écritures d'attribut sont refusées par le runtime. Modifier un équipement Matter (l'allumer, par exemple) est une commande Matter, que les écritures de tag ne modélisent pas.