Associez votre appareil compatible avec Matter. Pour ce faire, vous aurez besoin un code QR pour l'associer. Selon la plate-forme de votre Matter appareil, vous devrez peut-être générer ce code QR vous-même.
Obtenir un code QR
Bouffalo Lab
BL602
La chaîne du code QR est imprimée dans la console série au démarrage de l'appareil. Vérifiez votre console série. Un message de ce type doit s'afficher:
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 du code QR est imprimée dans la console série au démarrage de l'appareil vers le haut. Vérifiez votre console série. Vous devriez voir des messages tels que ceci:
[ 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
- 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 115200to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0. - 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 du code QR est imprimée dans la console série au démarrage de l'appareil. Vérifiez votre console série. Un message de ce type doit s'afficher:
[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 codé sous forme d'URL, qui est imprimé sur le au démarrage du tableau 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:
Ouvrez le lien dans un navigateur Web pour afficher le code QR.
Silicon Labs
EFR32MG12
Une fois la carte démarrée, vous devriez trouver un code QR sur son petit écran LCD. l'écran.
Telink
TLSR9518
La chaîne du 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:
- Google Home app (GHA)
- SDK Home Mobile et Thread de Google pour le réseau Android (peut être utilisé dans une application tierce)
Les deux méthodes utilisent les mêmes Matter et API réseau Thread.
Application Google Home
- Accédez à GHA.
- Appuyez sur en haut à gauche.
- Appuyez sur Configurer un appareil.
- Appuyez sur Nouvel appareil.
- Sélectionnez votre maison et appuyez sur Suivant.
- GHA va rechercher votre appareil. Lorsque vous y êtes invité, si vous souhaitez configurer votre appareil, appuyez sur Configurer un autre appareil.
- Appuyez sur Matter appareil pour n'importe quel type d'appareil.
- Dirigez l'appareil photo vers le code QR de votre appareil (ou le code QR généré par le site Web) du code d'accès).
- Continuez le processus d'association comme indiqué dans les GHA le flux de travail.
Si vous rencontrez des problèmes lors de l'association avec GHA sur votre appareil mobile:
- Assurez-vous de disposer de d'entraînement pour votre appareil mobile.
- Immédiatement après l'échec de la tentative d'association, capturez un bug rapport.
SDK Android
Android SDK sont désormais 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 pour mettre en service, associer et contrôler un appareil compatible Matter de l'écosystème Google Home avec ces SDK.
La documentation de référence des deux SDK est disponible sur le site suivant:
Restrictions d'association
Un appareil Matter ne peut être associé que dans l'appareil Google Home dans certains scénarios liés à l'ID fournisseur et au type d'appareil.
- Vous ne pouvez pas utiliser un VID de test sur un appareil grand public.
- Le VID de votre production doit être émis par le Connectivity Standards Alliance (Alliance). Google va confirmer que vous êtes le propriétaire de ce VID avant de pouvoir l'utiliser dans Google Home Developer Console. Une fois que cela se produit, vous pourrez créer pour ce VID.
- À des fins de développement et d'essais sur le terrain, un projet et son intégration avec la combinaison du VID et du PID correspondante doit être créée dans le Developer Console. La mise en service par l'utilisateur l'appareil doit être membre du projet ou figurer dans la liste d'utilisateurs de tests en conditions réelles.
- Les consommateurs ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par le Alliance
| Quels types d'utilisateurs peuvent mettre en service dans l'écosystème Google Home ? | |||
|---|---|---|---|
| Type de VID | État de la certification VID et de l'intégration de la console | Production
(utilisateurs grand public) |
Développement
(développeurs et utilisateurs Field Trial) |
| Test | Aucune intégration dans Developer Console (certification impossible) | ||
| Test | L'intégration existe dans Developer Console (ne peut pas être certifiée) | ||
| Production | Non certifié, l'intégration n'existe pas dans le Developer Console | ||
| Production | Non certifié, une intégration existe dans le Developer Console | ||
| Production | Certifiée dans le DCL Alliance, l'intégration n'est pas existent dans Developer Console | ||
| Production | Certifié dans le DCL Alliance et une intégration existe dans le Developer Console | ||
Informations sur l'appareil
Les informations techniques concernant l'appareil associé sont disponibles dans les GHA
- Dans GHA, sélectionnez l'appareil.
- Appuyez sur l'icône en haut à droite.
- Appuyez sur Informations techniques.
Les identifiants tels que Fabricant, Modèle et Version du matériel sont
à partir du micrologiciel Matter sur l'appareil, et non de la
Developer Console Par exemple,
CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME et
Valeurs CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME dans la configuration de l'appareil dans
le SDK Matter.
Ces identifiants peuvent être utiles pour valider l'appareil associé à des fins de test, en particulier lorsque vous utilisez un ID de fournisseur test et ID produit (qui peut être dupliqué entre les intégrations).
Résoudre les problèmes d'association
Si vous avez associé un appareil à un ID fournisseur (VID) et à un ID produit (PID) test, mais elle ne s'affiche pas lorsque vous tentez de tester l'appareil à l'aide de la fonction Suite dans Developer Console, cela est probablement dû à en utilisant la même combinaison test VID et PID pour plusieurs intégrations.
Pour résoudre le problème, supprimez tous les appareils de test de Developer Console et associez-le l'appareil que vous souhaitez tester à nouveau.
Pour vérifier que vous avez associé le bon appareil, vous pouvez définir les champs Fabricant et
Informations sur le modèle (CHIP_DEVICE_CONFIG_DEVICE_* valeurs) que l'appareil doit utiliser
des valeurs uniques dans votre micrologiciel de test.
Pour en savoir plus, consultez la section Informations sur l'appareil. des informations.