Qu’est-ce qu’un code d’association Matter ?

Chaque appareil domotique Matter est fourni avec un code d’installation qui permet à une application mobile ou à un hub de l’ajouter à votre maison. Ce code est imprimé deux fois : sous forme de code QR, dont le texte commence par MT:, et sous forme de code d’association manuel de 11 ou 21 chiffres, à saisir lorsque l’appareil photo ne parvient pas à lire le code QR. Les deux contiennent le code de configuration, un secret que l’application prouve connaître lorsqu’elle se connecte, et le discriminateur, un nombre qui distingue l’appareil des autres appareils en attente à proximité.

Comment l’utiliser

Saisissez ou collez le texte du code QR ou le code d’association manuel. Les espaces, les tirets et les minuscules sont acceptés, et le code est décodé au fil de la saisie. Pour lire un code à partir de la photo d’une étiquette, utilisez le Lecteur de code d’association Matter.

Ce que vous voyez

  • Type de code : texte du code QR, ou code d’association manuel de 11 ou 21 chiffres.
  • ID du fabricant et ID du produit, en décimal et en hexadécimal. Les ID de fabricant 0xFFF1 à 0xFFF4 sont des ID de fabricant de test, utilisés par les kits de développement et les exemples du SDK Matter. Un code à 11 chiffres ne contient ni l’un ni l’autre.
  • Discriminateur : la valeur complète sur 12 bits issue d’un code QR. Un code manuel n’en contient que les 4 bits de poids fort.
  • Code de configuration, écrit sous la forme de huit chiffres qu’utilise la spécification Matter.
  • Processus de mise en service : Standard (l’appareil est prêt à être associé dès sa mise sous tension), Action de l’utilisateur requise (il faut d’abord appuyer sur un bouton ou suivre le manuel) ou Personnalisé (les étapes figurent dans la fiche du fabricant du Distributed Compliance Ledger, la base de données de certification Matter). Un code à 11 chiffres correspond toujours au processus standard.
  • Code d’association manuel : les chiffres imprimés à côté du code QR, calculés à partir du texte du code QR. Un appareil utilisant le processus standard porte un code de 11 chiffres ; les autres processus nécessitent le code à 21 chiffres, qui contient les ID du fabricant et du produit.
  • Méthodes de découverte : la façon dont l’appareil peut être trouvé pendant qu’il attend d’être configuré : Bluetooth LE, déjà sur le réseau IP, trame d’action publique Wi-Fi, NFC, Thread, ou point d’accès Wi-Fi logiciel sur les anciens appareils. Seuls les codes QR les indiquent.
  • Données supplémentaires : un numéro de série, un délai d’expiration de la mise en service et d’autres champs facultatifs que contiennent certains codes QR.

Un code QR peut contenir les codes de plusieurs appareils vendus ensemble ; choisissez-en un dans la liste Appareil.

Lorsqu’un code n’est pas valide

Le dernier chiffre d’un code d’association manuel est un chiffre de contrôle de Verhoeff, qui détecte toute erreur sur un seul chiffre et toute inversion de deux chiffres voisins : une faute de frappe apparaît donc immédiatement. L’outil vous signale aussi lorsque le code de configuration fait partie des codes trop simples interdits par la spécification, comme huit chiffres identiques, lorsque l’ID du fabricant sort de la plage autorisée par la spécification et lorsque le code utilise une version de format non définie.

Confidentialité

Le décodage s’effectue dans votre navigateur : le code n’est donc envoyé nulle part. Un code d’installation permet à toute personne à proximité d’ajouter l’appareil tant qu’il attend d’être configuré : ne partagez donc pas un vrai code dans des captures d’écran ou des publications.