Dépannage de Matter

Bâtiment

Vérifier la compatibilité de votre téléphone

Tous les appareils Android O (8.1, niveau d'API 27) et versions ultérieures sont compatibles avec Matter. Suivez les étapes ci-dessous pour vérifier si votre téléphone dispose des modules nécessaires.

Configurer Android Debug Bridge

Android Debug Bridge (adb) doit être configuré avant le dépannage. Pour mettre en place ce Hangout, procédez comme suit :

  1. Installez "adb" sur votre ordinateur.
  2. Activez les options pour les développeurs et le débogage USB sur votre téléphone Android.

Vérifiez vos modules Matter des services Google Play (GPS)

Pour vérifier si vous disposez des modules Matter Google Play services, procédez comme suit:

  1. Configurez Android Debug Bridge.
  2. Utilisez un câble USB pour connecter votre téléphone Android à votre ordinateur.
  3. Exécutez cette commande dans un terminal pour vérifier que les modules Matter nécessaires sont installés : 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    Si vous obtenez un résultat semblable à celui ci-dessous, vous avez installé les modules Matter : 
    com.google.android.gms.home [v222110900]
    Notez que le numéro de version ci-dessus peut être différent de celui de votre appareil.
  4. Exécutez cette commande dans un terminal pour vérifier que les modules Thread nécessaires sont installés : 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Si vous obtenez un résultat semblable à celui de l'exemple suivant, vous avez installé les modules Thread : 
    com.google.android.gms.threadnetwork [v222106301]
    Notez que le numéro de version sur votre appareil peut être différent.

Si les modules ne sont pas répertoriés, cela signifie que:

  1. Vous disposez d'une version obsolète de Android. Assurez-vous qu'elle correspond à Android O (8.1) ou à une version ultérieure.
  2. Les modules Matter n'ont pas encore été téléchargés. Attendez au moins 24 heures que le téléchargement soit terminé. Assurez-vous que votre appareil est allumé et en charge pendant cette période, pour éviter que le téléchargement ne soit retardé. Si vous n'avez pas reçu les modules dans les 24 heures, vous pouvez essayer de rétablir la configuration d'usine de l'appareil pour forcer le téléchargement des modules.

Journaux des appareils du hub Fuchsia

Pour activer un hub pour la récupération des journaux locaux:

  1. Envoyez un e-mail indiquant le numéro de série et le modèle de vos appareils à votre Technical Account Manager (TAM) Google. Ils apparaissent en minuscules sous l'appareil.
  2. Une fois ajouté à la liste d'autorisation, vous devez activer la fonctionnalité en procédant comme suit :
    • Depuis le hub :
      1. Balayez l'écran de haut en bas.
      2. Appuyez sur l'icône Paramètres .
      3. Pour trouver la version Fuchsia: sur un Google Nest Hub (2nd gen), accédez à Informations sur l'appareil > Informations techniques > Version Fuchsia.
      4. Appuyez sept fois sur "Version Fuchsia". Cela activera les options pour les développeurs
      5. Revenir au menu principal
      6. Appuyez sur "Options pour les développeurs".
      7. Appuyez sur "Journalisation partenaire".
    • Cette fonctionnalité sera activée pendant 24 heures. Réactivez ensuite la fonctionnalité de journalisation à partir de l'étape 5.
  3. Obtenez l'adresse IP de votre hub :
    • Si le hub s'affiche :
      1. Balayez l'écran de haut en bas.
      2. Appuyez sur l'icône Paramètres .
      3. Pour trouver l'adresse IP de l'appareil: sur un Nest Hub (2nd gen), accédez à Informations sur l'appareil > Informations techniques > Adresse IP.
    • De Google Home app (GHA) sur votre téléphone :
      1. Appuyez sur l'appareil pour afficher sa page d'informations.
      2. Appuyez sur l'icône Paramètres pour afficher la page des paramètres.
      3. Pour trouver l'adresse IP de l'appareil, accédez à Informations sur l'appareil > Informations techniques > Adresse IP.
  4. Pour récupérer les journaux du hub, vous devez envoyer une requête HTTP GET au hub à partir d'un ordinateur connecté au même réseau Wi-Fi.
    • Notez le port et le chemin d'accès du point de terminaison :
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • La connexion peut rester ouverte pendant une minute seulement, mais les données extraites du tampon contiennent généralement 20 à 30 minutes d'événements passés.
      • Idéalement, les journaux sont extraits à l'aide de cette méthode immédiatement après avoir terminé une procédure de test afin de s'assurer que le tampon contient du contenu pertinent pour le test (comme pour les rapports de bug Android).

Désactiver le masquage des journaux Android

  • Pour des raisons de confidentialité et de sécurité, cette fonctionnalité ne doit être utilisée qu'à des fins de test technique.
  • N'utilisez pas cette option avec les appareils ou les utilisateurs en production.
  • Étapes :
    1. Envoyez à votre TAM Google les comptes Google des utilisateurs dont les journaux ne seront pas masqués.
    2. Une fois que vous avez confirmé l'ajout de votre compte à la liste d'autorisation, redémarrez votre téléphone.

Vérifiez le VID/PID de votre appareil

Si vous souhaitez commencer à développer votre intégration avec Google, vous devez créer un projet et une intégration dans la console Google Home.

Dépannage du Bluetooth sniffer

La valeur VID/PID indiquée par votre appareil doit correspondre au VID/PID saisi dans votre projet Google Home Developer Console.

  • Les ID vidéo 0xFFF1 - 0xFFF4 sont réservés aux tests. Ils peuvent être utilisés pour la mise en service et les tests de contrôle de base, mais pas pendant les phases de développement suivantes :

À l'aide d'une application d'ingénierie Bluetooth telle que nRF Connect pour mobile, vous pouvez afficher le VID/PID de l'appareil de balisage dans le champ Données du service.

Dans cette capture d'écran de la version Android de nRF Connect, vous verrez que le VID/PID est indiqué comme 5A23FFFE à partir du quatrième octet du champ Données du service. Cela indique un VID de 5A23 et un PID de FFFE, tous deux au format Little Endian.

L'application BLE affiche les valeurs en small endian,mais les valeurs VID/PID que vous saisissez dans votre projet Developer Console sont en big endian.

Vérifiez que les valeurs et le format appropriés ont été saisis dans votre projet de la console Actions en fonction des informations affichées par le détection Bluetooth.

Pour les valeurs de la capture d'écran de l'exemple, le VID et le PID dans Developer Console seront respectivement 235A et FEFF.

Vérifiez que votre appareil a été créé à l'aide d'une branche du SDK Matter compatible

Les hubs Google Matter sont compatibles avec Matter 1.0 et ont été testés avec des builds qui utilisaient des commits de la branche stable v1.0-branch. Consultez les notes de version publiques pour connaître les commits spécifiques recommandés pour une utilisation avec chaque nouvelle version du hub.

Association

Valider les identifiants de votre appareil

Lorsque vous utilisez votre propre VID attribué par Alliance, assurez-vous que vous disposez des identifiants corrects sur l'appareil:

  • Déclaration de certification (CD).
  • Certificat d'attestation d'appareil (DAC) et sa chaîne de certificats.

Pour en savoir plus, consultez Créer des certificats de test d'appareils Matter.

Vérifier votre hub compatible avec Matter

Votre hub Matter doit être l'un des hubs compatibles avec Google. Il doit également se trouver sur un build compatible avec Matter.

Certains hubs sont également des routeurs de bordure Thread, qui vous permettent de développer et de tester des appareils Thread. Les autres hubs ne sont compatibles qu'avec les appareils Matter Wi-Fi et Ethernet, sauf si vous disposez d'un autre routeur de bordure sur votre réseau pour activer la connectivité Thread.

Pour vérifier le build du hub: faites glisser votre doigt vers le bas à partir du bord supérieur > Roue de configuration > Informations sur l'appareil > Informations techniques > Version du micrologiciel Chromecast.

La mise en service échoue et le message d'erreur "Impossible de contacter Google" s'affiche

Assurez-vous d'avoir créé une intégration avec la bonne combinaison VID/PID dans Developer Console. Pour en savoir plus, consultez Créer une intégration Matter.

Échec de la mise en service : le message d'erreur "Impossible de joindre l'appareil" s'affiche

Si vous continuez à recevoir le message d'erreur "Impossible de joindre l'appareil" lorsque vous mettez en service un appareil Thread et que vous avez épuisé toutes les options de débogage disponibles, vous pouvez effacer les identifiants Thread préférés stockés sur votre téléphone Android pour une configuration plus saine via Paramètres > Applications > Applications de l'application > Services Google Play > Stockage et cache > Gérer l'espace > EFFACER TOUTES LES DONNÉES.

Test

L'appareil commandé n'apparaît pas dans la suite de tests

Si vous avez associé un appareil à un ID de fournisseur (VID) et à un ID produit (PID), mais qu'il ne s'affiche pas lorsque vous tentez 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 et associez l'appareil que vous souhaitez tester à nouveau.

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.

Si le problème persiste

Si votre problème n'est toujours pas résolu après avoir suivi toutes ces étapes de dépannage, pas de problème.

Au cours des étapes de dépannage, vous avez recueilli des données importantes sur votre appareil, votre projet de console et votre environnement. Consultez la page d'assistance pour savoir comment partager au mieux votre problème avec la communauté et l'équipe d'assistance Google Home.