Codec Matter Protocol

Guide d'utilisation du schéma C Struct

Le mode schéma C Struct vous permet de définir des structures de données en utilisant la syntaxe familière C/C++. L'analyseur extrait les noms de champs, les types et les tags TLV de vos définitions de structure, puis génère un formulaire visuel pour la saisie des données et l'encodage TLV.

Syntaxe supportée

// Supported syntax forms:
typedef struct { ... } StructName;
typedef struct Tag { ... } StructName;
struct StructName { ... };

Types de données supportés

Méthodes d'annotation de tag

Utilisez des commentaires pour spécifier les tags de contexte TLV pour chaque champ. Si aucun tag n'est spécifié, les tags sont attribués automatiquement à partir de 0.

uint8_t field1;     // tag 0
uint16_t field2;    // tag: 1
uint32_t field3;    /* tag 2 */
@tag(3) uint64_t field4;

Support des tableaux

Les tableaux de taille fixe (par ex. uint32_t data[4]) et les tableaux de taille variable (par ex. uint8_t data[]) sont supportés. Le formulaire fournira un bouton « Ajouter un élément » pour la gestion dynamique des éléments du tableau.

uint32_t subjects[4];  // Fixed-size array (max 4 items)
uint8_t data[];        // Variable-size array

Limitations actuelles

• Les directives préprocesseur (#define, #ifdef) ne sont pas supportées
• Les alias typedef (par ex. typedef uint8_t BYTE) ne sont pas supportés
• Les enums, unions et champs de bits ne sont pas supportés
• L'édition de structures imbriquées est limitée à un niveau
• Les structures anonymes ne sont pas supportées

Format d'encodage TLV Matter

Matter utilise un schéma d'encodage binaire TLV (Tag-Length-Value) compact pour sérialiser les données structurées. Ce format est utilisé dans l'ensemble de la pile protocolaire, notamment dans les messages du modèle d'interaction, les données d'attestation des appareils et les payloads de mise en service.

Structure de l'octet de contrôle

L'octet de contrôle est le premier octet de chaque élément TLV. Les 5 bits inférieurs spécifient le type d'élément et les 3 bits supérieurs indiquent la forme du tag.

Types d'éléments TLV

Le champ type d'élément détermine l'encodage de la partie valeur. Les types entiers utilisent 1, 2, 4 ou 8 octets. Les booléens sont encodés directement dans le champ type. Les chaînes et tableaux d'octets portent un préfixe de longueur suivi des données.

Format du payload d'intégration

Lors de la mise en service d'un appareil Matter, les informations de configuration sont encodées dans un payload compact intégré dans un QR code ou exprimé sous forme de code de jumelage numérique manuel. Le payload QR code commence par le préfixe « MT: » suivi d'une chaîne binaire encodée en Base38.

Encodage Base38

Les payloads QR code Matter utilisent un jeu de caractères Base38 (0-9, A-Z, -.) pour une représentation alphanumérique efficace. Chaque groupe de 3 octets est encodé en 5 caractères Base38.

Code de jumelage manuel

Le code de jumelage manuel à 11 chiffres offre une méthode alternative de mise en service lorsque la lecture QR code n'est pas disponible. Il encode le discriminateur, le code de configuration et un chiffre de contrôle Verhoeff. La version 21 chiffres inclut également l'ID fournisseur et l'ID produit.

Chiffre de contrôle Verhoeff

Le code de jumelage manuel utilise l'algorithme Verhoeff pour la détection d'erreurs. Cet algorithme détecte toutes les erreurs à un chiffre et la plupart des erreurs de transposition adjacentes.

Cas d'utilisation en développement

• Débogage des payloads TLV Matter capturés depuis les interactions d'appareils
• Inspection des messages de requête et réponse du modèle d'interaction
• Vérification des payloads de mise en service intégrés dans les QR codes
• Validation des structures TLV des certificats d'attestation
• Construction de payloads de test pour les tests de conformité Matter

Références de spécification

La spécification Matter est maintenue par la Connectivity Standards Alliance (CSA). Le format d'encodage TLV est défini dans l'annexe A de la spécification principale. L'encodage des charges utiles d'intégration est couvert dans la section 5.1.

• Spécification Matter Core - Télécharger depuis CSA
• Dépôt Open Source - github.com/project-chip/connectedhomeip
• Documentation SDK - project-chip.github.io/connectedhomeip-doc
• Manuel du développeur Matter - handbook.buildwithmatter.com