Matter

Référence du pilote Matter : les réseaux Wi-Fi et Thread que rejoignent les équipements, la mise en service par Bluetooth dans le Fabric local, le déroulement de l'appairage, l'identité de nœud, les tags qui viennent de l'équipement et ce que fait l'écriture de chacun.

Le pilote Matter lit du matériel Matter : capteurs connectés, prises, luminaires et équipements semblables certifiés pour le standard Matter, qu'ils rejoignent le réseau par Wi-Fi ou par Thread. C'est un seul pilote pour les deux. Le réseau n'est que le chemin d'entrée : une fois qu'un équipement y est, Ganter Lab le lit de la même façon, par le réseau local.

Ganter Lab agit en contrôleur Matter avec son propre Fabric local : il met chaque équipement en service une fois par Bluetooth Low Energy sur cet ordinateur, lui remet les identifiants d'un réseau inscrit sur la carte Réseaux du pilote, et lui parle ensuite par le réseau local : à travers votre routeur pour un équipement Wi-Fi, à travers votre Border Router Thread pour un équipement Thread.

Vous ne dites jamais à Ganter Lab si un équipement est Wi-Fi ou Thread : l'équipement le dit lui-même. Une fois la session Bluetooth ouverte, Ganter Lab lit sur l'équipement quel type de réseau il rejoint, avant d'y écrire quoi que ce soit, et s'arrête avec un message à part quand le réseau choisi est de l'autre type.

Cela inverse l'ordre d'installation habituel. 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 conservée ensuite.

Ce qu'il vous faut avant l'appairage :

• Un adaptateur Bluetooth Low Energy sur cet ordinateur, allumé, avec Windows autorisant Ganter Lab à l'employer.
• Le réseau que l'équipement va rejoindre, inscrit sur la carte Réseaux : pour un équipement Wi-Fi, le nom du Wi-Fi et son mot de passe ; pour un équipement Thread, un réseau Thread existant avec un Border Router, et son jeu de données opérationnel actif complet. Ganter Lab fait rejoindre votre réseau aux équipements ; il ne peut pas inventer ses identifiants.
• Le code de configuration de l'équipement, imprimé sur l'équipement ou son emballage, et l'équipement en mode appairage.

Réseaux

Le volet du pilote Matter porte une carte intitulée Réseaux : les réseaux Wi-Fi et Thread que rejoignent les équipements, un par ligne. Un réseau s'inscrit une fois, avant le premier équipement, et sert à tous les équipements appairés dedans : appairer une deuxième lampe sur le même Wi-Fi ne demande plus rien. La carte n'est dessinée que pour un rôle qui peut configurer le Connector, parce qu'elle garde les secrets des réseaux et ne sert qu'à l'appairage.

La tête de la carte porte ses commandes, dans cet ordre :

Le tableau montre, pour chaque réseau, son Nom, son Type de réseau (Réseau Wi-Fi ou Réseau Thread) et son État : Prêt pour l'appairage, ou ce qui manque encore au réseau. Un réseau dont le nom n'est pas encore écrit s'affiche Réseau sans nom.

Les champs du réseau sélectionné se modifient sur place, sous le tableau, et s'enregistrent d'eux-mêmes. Une valeur que les règles ci-dessous refusent n'est pas écrite, et le champ dit pourquoi.

Deux choses décident si un équipement Wi-Fi peut être appairé, et la carte les dit toutes deux à côté des champs :

• La plupart des équipements ne rejoignent que des réseaux 2,4 GHz. Un routeur qui diffuse un même nom en 2,4 GHz et en 5 GHz les sert ; un réseau qui n'existe qu'en 5 GHz, non.
• Cet ordinateur et les équipements doivent être sur le même réseau local. Un réseau invité, ou l'isolation des clients activée sur le routeur, empêche l'ordinateur de trouver les équipements une fois qu'ils ont rejoint le réseau.

Un réseau ne sert à l'appairage que tant que son secret respecte ces règles : un réseau Wi-Fi avec un nom et un mot de passe valides (vide compris), un réseau Thread avec un jeu de données valide.

Modifier un réseau change ce que le prochain appairage remet, jamais ce qu'un équipement a déjà reçu. Un équipement qui doit passer à un autre réseau, ou dont le routeur a reçu un nouveau mot de passe, est réinitialisé et appairé de nouveau.

Le déroulement de l'appairage

Sur le pilote Matter, la barre d'outils propose Appairer un équipement là où les autres pilotes proposent Ajouter un équipement, et l'entrée Matter du menu Nouveau… de la colonne aussi. Tant qu'aucun réseau ne sert à l'appairage, la commande reste dessinée et grisée, avec l'infobulle « Ajoutez d'abord le réseau que l'équipement doit rejoindre. » Sinon, elle ouvre un formulaire :

Un dossier du pilote Matter propose Nouvel équipement (dans son tableau Équipements, dans son menu du clic droit et dans Nouveau… > Matter > <Dossier>). Il ouvre ce même formulaire, grisé de la même façon tant qu'aucun réseau ne sert, et l'équipement appairé est rangé dans ce dossier.

Appairer un équipement dans le formulaire reste inactif tant que le nom et le code de configuration ne sont pas remplis ou qu'aucun réseau ne sert. Pendant l'appairage, le formulaire rapporte son étape : Valider (vérification du code et du secret du réseau), Trouver (recherche de l'équipement par Bluetooth), Appairer (authentification avec le code de configuration et lecture du type de réseau que l'équipement rejoint), Rejoindre le réseau (envoi du réseau à l'équipement, puis recherche de l'équipement sur le réseau local jusqu'à ce qu'il réponde ; la ligne d'état dit si ce réseau est Wi-Fi ou Thread), Enregistrer (ouverture de la session sécurisée avec l'équipement sur le réseau local, fin de sa mise en service et enregistrement du nœud dans le Fabric local).

Annuler est disponible tant que l'équipement physique n'a pas encore été modifié ; une fois que la mise en service a changé l'équipement, le bouton indique que Ganter Lab finalise en sécurité et le déroulement termine l'enregistrement au lieu d'abandonner un nœud à demi mis en service. Un seul appairage tourne à la fois ; une seconde tentative pendant qu'un autre est en cours est refusée.

Le nouvel équipement garde le nom du réseau qu'il a rejoint, affiché dans son champ Réseau. Appairer l'équipement suivant sur le même réseau ne demande que son nom et son code de configuration.

Quand l'appairage échoue

Si l'appairage échoue, le message énonce la cause et ce qu'il faut faire :

Chaque fois qu'un échec arrive après que le matériel a déjà été mis en service, le message le dit et montre l'ID 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 le matériel est resté intact.

Un équipement qui répond qu'il n'a pas pu rejoindre le réseau est l'exception : il ne détient rien qui vaille d'être gardé. Ganter Lab met fin à l'appairage sur l'équipement, qui abandonne ce qu'il a reçu et revient aussitôt en mode appairage, et retire son nœud du Fabric ; le message ne porte donc pas d'ID de nœud, et Découvrir ne liste jamais un nœud qui ne peut pas répondre. Corrigez le réseau et appairez de nouveau. Seul un équipement qui n'a donné aucune réponse garde son nœud, car on ne sait s'il a rejoint le réseau qu'au moment où il apparaît sur le réseau local.

Ce qui est conservé

Le mot de passe du Wi-Fi et le jeu de données n'apparaissent jamais dans le journal technique, dans l'adresse d'un équipement ni dans sa Thing Description. Les réseaux et l'appairage ne sont pas proposés aux agents par le serveur MCP : l'appairage demande quelqu'un auprès de l'équipement, et les réseaux gardent des secrets.

L'identité de nœud

Un équipement appairé est lié à l'ID de nœud stable de 64 bits du matériel, affiché en lecture seule dans sa carte Connexion en 16 chiffres hexadécimaux, à côté de l'état de l'équipement. Le nom affiché modifiable est à vous de le changer ; l'ID de nœud, non. Un équipement dont l'identité conservée ne peut plus être lue montre Appairage à refaire à sa place.

Le volet de l'équipement montre aussi un champ Réseau en lecture seule : le nom du réseau que l'équipement a rejoint lors de son appairage. Un équipement appairé par une version qui ne le gardait pas dit que rien n'a été enregistré. Le champ est une trace, pas un réglage : modifier ou retirer ce réseau sur la carte Réseaux ne change rien sur l'équipement.

Comme l'identité est l'ID 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 : cela ne retire pas le matériel 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 et lit, sur chacun, les valeurs qu'il publie. Pour les lire, il ouvre une session sécurisée avec chaque nœud, si bien qu'un nœud absent du réseau reste listé, sans valeurs, une fois que sa session n'a pas pu s'ouvrir. Les candidats de la découverte portent l'identité du nœud et aucun secret de configuration. Le déroulement général de la découverte est décrit sur Découverte.

Les valeurs d'un équipement configuré sont comparées à ses tags par sortie, cluster et attribut, jamais par nom : un tag que vous avez renommé compte toujours, et une valeur n'est jamais ajoutée deux fois.

La page de l'équipement lui-même offre la même chose sans la quitter : Découvrir les tags, dans l'en-tête de sa carte Tags, lit ce seul nœud et liste, cochées, les valeurs pour lesquelles il n'a pas encore de tag, avec Ajouter les tags (voir Découvrir les tags d'un équipement).

Tags

Les tags d'un équipement Matter viennent de l'équipement lui-même : personne ne saisit de cluster ni de numéro d'attribut pour eux. Un appairage qui réussit y mène directement. Le journal des actions indique « Équipement Matter « Éclairage de la cuisine » appairé. », la page s'ouvre sur le pilote Matter avec le nouvel équipement mis en évidence dans son tableau Équipements, et un balayage de ce seul équipement démarre aussitôt. L'équipement que l'appairage a créé apparaît dans Équipements découverts avec les valeurs qu'il publie, toutes cochées, et le balayage se termine par « Cochez les valeurs de « Éclairage de la cuisine » à créer comme tags, puis Ajouter les tags. » Décochez ce que vous ne voulez pas et appuyez sur Ajouter les tags ; le journal des actions indique alors « 5 tags ajoutés à « Éclairage de la cuisine ». » Un équipement qui n'a pas encore répondu ne signale rien : « « Éclairage de la cuisine » n'a encore signalé aucune valeur. Relancez Découvrir une fois qu'il est en ligne. » La même carte revient à chaque Découvrir suivant, avec les valeurs pour lesquelles l'équipement n'a pas encore de tag.

Ajouter les tags n'est dessiné que pour un rôle qui a Configurer Connector. Il reste grisé, avec sa raison en infobulle, pendant qu'un balayage ou un appairage tourne, pendant que la station refuse les changements et tant que rien n'est coché (« Cochez au moins une valeur à ajouter. »). Une valeur dont l'équipement lit déjà la sortie, le cluster et l'attribut n'est jamais ajoutée de nouveau ; quand chaque valeur cochée est déjà là, rien n'est enregistré : « « Éclairage de la cuisine » a déjà un tag pour chaque valeur cochée, donc rien n'a été ajouté. » Un nom qu'un autre tag de l'équipement porte déjà reçoit un numéro à la suite, comme dans Luminosité (2).

Le balayage lit ce que l'équipement publie, tel que la spécification Matter l'organise :

Ce que le balayage propose, et sous quel nom :

Un tag proposé en écriture arrive avec l'accès Lecture et écriture ; tous les autres arrivent en Lecture seule.

Les valeurs que le pilote connaît

Le pilote porte une table, tirée de la spécification Matter, des valeurs qu'il connaît par leur nom et de la façon dont chacune change. Une valeur change de l'une de trois façons : par une commande que le pilote envoie, que l'équipement doit lister parmi les commandes qu'il accepte ; par une écriture de l'attribut lui-même, là où la spécification le rend accessible en écriture et où l'équipement le liste ; ou pas du tout, pour une valeur que l'équipement ne fait que signaler.

La spécification envoie les températures, l'humidité et la pression dans des unités fixes : centièmes de degré Celsius, centièmes de pour cent et dixièmes de kilopascal. La découverte offre ces valeurs déjà en °C, % et kPa : le tag arrive avec le facteur dans son étape de mise à l'échelle (0,01 pour une température et une humidité, 0,1 pour une pression) et avec l'unité, si bien qu'un équipement qui envoie 2150 se lit 21,5 °C. Une écriture défait cette étape avant que la valeur ne parte, si bien qu'une consigne écrite 21,5 arrive à l'équipement en 2150. L'éclairement est logarithmique (10000 × log10(lux) + 1), donc aucun facteur ne le convertit : il se lit tel que l'équipement l'envoie. Toutes les autres valeurs se lisent aussi telles que l'équipement les envoie.

Les serrures, la couleur par coordonnées X et Y, les scènes, les groupes et la commande Toggle ne sont pas dans la table. Un équipement Matter n'a pas non plus de commandes à lui : tout changement est l'écriture d'un de ses tags.

Écrire une valeur

Un tag Matter dont l'accès est Lecture et écriture change l'équipement quand on l'écrit : depuis sa carte Valeur en direct, un contrôle de tableau de bord, la Logic ou un agent. L'écriture rejoint la file de l'équipement comme celle de tout pilote, à son tour avec les lectures de l'équipement, et sa réponse est celle de l'équipement lui-même. Le pilote choisit la commande Matter ou l'écriture de l'attribut à partir de la table ; personne ne choisit de commande. Seul le SUCCESS de l'équipement compte comme écrit. Tout le reste est refusé, avec une raison :

Une écriture refusée n'est jamais signalée comme écrite, ni comme un équipement injoignable. Sur la page du tag, la ligne d'état indique « Écriture refusée par l'équipement : CONSTRAINT_ERROR, 0x87. » quand l'équipement l'a refusée, avec la raison à la place du statut pour un refus tranché avant tout envoi, et « Écriture non confirmée : l'équipement n'a pas répondu à temps. » quand aucune réponse n'est venue ; « Échec de l'écriture : l'équipement n'a pas pu être joint. » reste réservé à un équipement qui n'est pas connecté. La raison voyage aussi avec l'écriture : la ligne du journal de cette écriture la nomme, avec ce que le statut veut dire, et le tag_write d'un agent la renvoie.

Un tag créé à la main

Pour la rare valeur que l'équipement ne publie pas sous une forme que le balayage propose, Ajouter un tag sur un équipement Matter crée un tag à remplir à la main. Sa carte Source de la valeur montre trois champs sur une ligne, et l'aperçu de l'adresse en dessous les assemble en <endpoint>/<cluster>/<attribute>, en décimal (1/8/0 est la luminosité de la première sortie). Tant qu'aucun cluster n'est choisi, le tag n'est pas enregistré, et le panneau dit : « Choisissez le cluster que ce tag lit. Sans lui, rien n'est jamais demandé à l'équipement. »

Le nom du tag est libre : il nomme le tag et ne choisit rien sur l'équipement. Le type de donnée se choisit parmi Boolean, Int32, UInt32, Float, Double et String ; une lecture que le type déclaré ne peut pas représenter se lit comme une erreur plutôt que comme un nombre de remplacement. La valeur arrive telle que l'équipement l'envoie : une température, une humidité ou une pression créée à la main se lit en centièmes ou en dixièmes tant que vous ne lui donnez pas, dans son étape de mise à l'échelle, le facteur et l'unité du tableau ci-dessus.

Le champ d'accès ne propose l'écriture que là où la table du pilote change la valeur ; sinon il propose Lecture seule et dit pourquoi en dessous :

Quand une modification de la sortie, du cluster ou de l'attribut fait pointer le tag vers une valeur que le pilote ne peut pas écrire, son accès revient à Lecture seule. Un tag offert par la découverte garde l'accès que la découverte lui a donné, car seule la découverte demande à l'équipement quelles commandes il accepte : une valeur que l'équipement n'a pas listée reste en Lecture seule, et le champ propose quand même l'écriture.

Les tags enregistrés par des versions précédentes

Une version précédente nommait le cluster d'un tag Matter par le seul nom du tag, avec une adresse <endpoint>/<attribute>. Quand cette version démarre pour la première fois, chaque tag d'un équipement Matter dont le nom est un cluster du catalogue Matter (la partie après le dernier deux-points, sans les espaces autour, sans tenir compte de la casse) reçoit ce cluster, si bien qu'il continue de lire exactement la valeur qu'il lisait. Son nom reste tel qu'il était, et l'aperçu de son adresse montre alors <endpoint>/<cluster>/<attribute>. Un tag dont le nom ne correspondait à aucun cluster n'a jamais rien lu : il reste sans cluster, ses lectures sont refusées avec une raison qui le dit, et sa page demande le cluster. Un tag converti garde l'accès qu'il avait, Lecture seule, le seul que ces versions proposaient ; pour l'écrire, choisissez Lecture et écriture, ce qui fonctionne pour les valeurs de la table ci-dessus.