Associer un appareil Lit

Associez votre appareil compatible avec Matter. Pour ce faire, vous aurez besoin d'un code QR pour l'association. En fonction de la plate-forme de votre appareil Matter, vous devrez peut-être générer ce code QR vous-même.

Obtenir un code QR

Bouffalo Lab

BL602

La chaîne de code QR est imprimée dans la console série au démarrage de l'appareil. Consultez votre console série. Vous devriez voir des messages de ce type:

Booting BL602 Chip...
██████╗ ██╗      ██████╗  ██████╗ ██████╗
██╔══██╗██║     ██╔════╝ ██╔═████╗╚════██╗
██████╔╝██║     ███████╗ ██║██╔██║ █████╔╝
██╔══██╗██║     ██╔═══██╗████╔╝██║██╔═══╝
██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗
╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ╚══════╝
...
[INFO] ==================================================
[INFO] chip-bl602-lighting-example starting
[INFO] ==================================================
...
[INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code:
[INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
...

Ouvrez le lien dans un navigateur Web pour afficher le code QR.

BL702

La chaîne de code QR est imprimée dans la console série au démarrage de l'appareil. Consultez la console série. Vous devriez voir des messages de ce type:

[         0][-][PROGR] ==================================================
[         0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19
[         0][-][PROGR] ==================================================
...
[      1636][-][PROGR] Starting OpenThread task
[      1655][DL][PROGR] Device Configuration:
[      1703][DL][PROGR]   Serial Number: TEST_SN
[      1703][DL][PROGR]   Vendor Id: 65521 (0xFFF1)
[      1703][DL][PROGR]   Product Id: 32773 (0x8005)
[      1752][DL][PROGR]   Hardware Version: 0
[      1799][DL][PROGR]   Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
[      1846][DL][PROGR]   Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
[      1893][DL][PROGR]   Manufacturing Date: (not set)
[      1893][DL][PROGR]   Device Type: 65535 (0xFFFF)
[      1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[      1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code:
[      1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234

      

Espressif

Getting the QR code differs for each type of ESP32-based kit:

ESP32 DevkitC

  1. Connect the device to a host machine and use a serial terminal to connect to it and display its logs. For example, on a Linux host machine, you might use screen /dev/ttyUSB0 115200 to connect to the device and view logs if it is attached to the host at /dev/ttyUSB0.
  2. A URL is displayed in the logs when the device is first booted. Open the link in a web browser to display the QR code.

M5Stack ESP32

When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.

ESP32 WROVER Kit

The device shows the QR code immediately after booting.

Nordic Semiconductor

nRF52840

Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:

I: 1317 [SVR]SetupQRCode:  [MT:I347HHY00 0C9SS0]
I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0

Ouvrez le lien dans un navigateur Web pour afficher le code QR.

NXP

K32w

La chaîne de code QR est imprimée dans la console série au démarrage de l'appareil. Consultez votre console série. Vous devriez voir des messages de ce type:

[Info]Welcome to NXP Lighting Demo App
[Info]OpenThread started: OK
...
[Info]Server Listening...
[Info]SetupQRCode:  [MT:I34DVDY00 0C9SS0]
[Info]Copy/paste the below URL in a browser to see the QR Code:
[Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0
...

Ouvrez le lien dans un navigateur Web pour afficher le code QR.

Realtek

Ameba D

Le code QR est encodé dans une URL, qui s'affiche dans la console série au démarrage de la carte Ameba D:

Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code:  749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Ouvrez le lien dans un navigateur Web pour afficher le code QR.

Silicon Labs

EFR32MG12

Une fois que le tableau a démarré, un code QR doit s'afficher sur son petit écran LCD.

TLSR9518

La chaîne de code QR est imprimée dans la console série au démarrage de l'appareil. Vérifiez la console série. Vous devriez voir une URL qui affiche le code QR lorsqu'elle est ouverte dans un navigateur :

*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626  ***
I: Init CHIP stack
I: Starting CHIP task
…
I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData
I: 823 [DL]Setting device name to : "TelinkMatter"
…
I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234]
I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Associer l'appareil

Il existe deux façons d'associer l'appareil:

  1. Google Home app (GHA)
  2. SDK Home Mobile et Thread réseau de Google pour Android (qui peut être utilisé dans une application tierce)

Les deux méthodes utilisent les mêmes API réseau Matter et Thread.

Application Google Home

  1. Ouvrez GHA.
  2. Appuyez sur en haut à gauche.
  3. Appuyez sur Configurer un appareil.
  4. Appuyez sur Nouvel appareil.
  5. Sélectionnez votre maison, puis appuyez sur Suivant.
  6. GHA va rechercher votre appareil. Lorsqu'un message vous invite à configurer votre appareil, appuyez sur Configurer un autre appareil.
  7. Appuyez sur Matter appareil pour n'importe quel type d'appareil.
  8. Dirigez l'appareil photo vers le code QR de votre appareil (ou le code QR généré par le site Web).
  9. Continuez le processus d'association comme indiqué dans le flux GHA.

Si vous rencontrez des problèmes lors de l'association avec GHA sur votre appareil mobile:

  1. Assurez-vous d'avoir activé les Options pour les développeurs sur votre appareil mobile.
  2. Immédiatement après l'échec de la tentative d'association, enregistrez un rapport de bug.

SDK Android

Implémentez nos SDK Android pour associer des appareils Matter et gérer les réseaux Thread dans votre application

Les SDK Android sont disponibles dans Play services pour les tests et l'association dans une application tierce.

Nous vous suggérons de commencer par Google Home Sample App for Matter, qui montre comment mettre en service, associer et contrôler un appareil compatible avec Matter dans l'écosystème Google Home à l'aide de ces SDK.

La documentation de référence des deux SDK est disponible sur les pages suivantes:

Restrictions concernant l'association

Un appareil Matter ne peut être associé dans l'écosystème Google Home que dans certains cas d'ID de fournisseur et de type d'appareil.

  • Un VID test ne peut pas être utilisé sur un appareil grand public.
  • Votre VID de production doit être émis par le Connectivity Standards Alliance (Alliance). Google vérifiera que vous êtes le propriétaire de ce VID avant que vous puissiez l'utiliser dans Google Home Developer Console. Vous pourrez alors créer des intégrations pour ce VID.
  • À des fins de développement et de tests sur le terrain, un projet et une intégration avec la combinaison VID et PID correspondante doivent être créés dans Developer Console. L'utilisateur qui met l'appareil en service doit être membre du projet ou figurer dans la liste des utilisateurs du test.
  • Les consommateurs ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par l'Alliance.
Tableau: scénarios d'association entre l'ID fournisseur (VID) et le type d'appareil
Quels types d'utilisateurs peuvent mettre l'appareil en service dans l'écosystème Google Home ?
Type de VID Certification VID et état d'intégration de la console Production
(utilisateurs grand public)
Développement
(développeurs, utilisateurs de tests en conditions réelles)
Test Aucune intégration dans Developer Console (certification impossible)
Test L'intégration existe dans la Developer Console (non certifiée)
Production Non certifiée, l'intégration n'existe pas dans le Developer Console
Production Non certifié, l'intégration existe dans Developer Console
Production Certifiée dans le DCL Alliance, l'intégration n'existe pas dans le Developer Console
Production Certifiée dans le DCL Alliance, et l'intégration existe dans la Developer Console

Informations sur l'appareil

Les informations techniques de l'appareil associé sont consultables dans GHA.

  1. Dans GHA, sélectionnez l'appareil.
  2. Appuyez sur l'icône en haut à droite.
  3. Appuyez sur Informations techniques.

Les identifiants tels que Fabricant, Modèle et Version du matériel proviennent du micrologiciel Matter de l'appareil, et non de Developer Console. Par exemple, les valeurs CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME et CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME dans la configuration de l'appareil dans le SDK Matter.

Ces identifiants peuvent être utiles pour valider quel appareil a été associé à des fins de test, en particulier lorsque vous utilisez un ID de fournisseur et un ID de produit de test (qui peuvent être dupliqués pour les différentes intégrations).

Résoudre les problèmes d'association

Si vous avez associé un appareil à un ID de fournisseur (VID) et à un ID produit (PID) test, mais qu'il ne s'affiche pas lorsque vous essayez de tester l'appareil avec la suite de test dans Developer Console, cela est probablement dû à l'utilisation de la même combinaison VID et PID de test dans plusieurs intégrations.

Pour résoudre le problème, supprimez tous les appareils de test de Developer Console, puis associez à nouveau l'appareil que vous souhaitez tester.

Pour vérifier que vous avez associé le bon appareil, vous pouvez définir les informations du fabricant et du modèle (valeurs CHIP_DEVICE_CONFIG_DEVICE_*) de l'appareil sur des valeurs uniques dans votre micrologiciel de test.

Pour en savoir plus, consultez la section Informations sur l'appareil.