Matter

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

Le pilote Matter lit du matériel Matter sur Thread : capteurs connectés, prises, luminaires et équipements semblables certifiés pour le standard Matter. 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 de votre réseau Thread existant, et lui parle ensuite par ce réseau à travers votre Border Router Thread.

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.
• 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.

Le déroulement de l'appairage

Sur le pilote Matter, la barre d'outils propose Appairer un équipement là où les autres pilotes proposent Nouvel équipement. Elle ouvre un formulaire à trois champs :

Appairer un équipement reste inactif 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 de configuration), Rejoindre Thread (envoi de la configuration du réseau et attente de l'apparition de l'équipement sur le réseau Thread), Enregistrer (enregistrement du nœud mis en service 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.

Les secrets ne sont jamais conservés. Le code de configuration 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 se termine, échoue ou est annulé, et rien n'en 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 non valide, un Bluetooth absent ou désactivé, Windows refusant l'accès au Bluetooth, aucun équipement correspondant trouvé, l'équipement rejetant le code de configuration, ou l'équipement mis en service mais qui n'apparaît jamais sur le réseau Thread. Un mauvais code de configuration est nommé comme tel, si bien que la réponse est de relire le code imprimé et de remettre l'équipement en mode appairage.

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.

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.

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, 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 ID de nœud déjà configuré est marqué comme tel et Ouvrir mène à l'équipement existant. Les candidats de découverte portent l'identité du nœud et aucun secret d'appairage. 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 nommant 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 sait pas représenter se lit elle aussi comme une erreur plutôt que comme un nombre de remplacement.

Deux champs de nombre 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 voies ou une multiprise se lit à raison d'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, ce que veut presque tout tag.

Les tags Matter sont en lecture seule : le champ d'accès ne propose 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.