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 compatible avec Matter. Suivez les étapes ci-dessous pour vérifier 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. Installer "adb" sur votre ordinateur.
  2. Activer les options pour les développeurs et la clé USB Débogage sur votre téléphone Android.

Valider vos modules Matter des services Google Play (GPS)

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

  1. Configurer 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 Matter modules 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, Matter modules installés:
    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 Thread modules 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, Thread modules installés:
    com.google.android.gms.threadnetwork [v222106301]
    Notez que le numéro de version indiqué sur votre appareil peut être différent.

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

  1. Votre version de Android est obsolète. Assurez-vous qu'il est Android O (8.1) ou version ultérieure.
  2. Les modules Matter n'ont pas encore été téléchargés. Attendre au moins 24 heures avant qu'elles ne se téléchargent. Assurez-vous que votre appareil est allumé et en charge pendant cette période, afin que le téléchargement ne soit pas retardé. Si vous n'avez pas encore reçu les modules dans un délai de 24 heures, vous pouvez essayer de rétablir la configuration d'usine l'appareil pour forcer le téléchargement des modules.

Journaux des hubs Fuchsia

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

  1. Envoyez un e-mail contenant 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 que vous figurez sur la liste d'autorisation, vous devez activer la fonctionnalité en procédant comme suit: <ph type="x-smartling-placeholder">
      </ph>
    • Depuis le hub: <ph type="x-smartling-placeholder">
        </ph>
      1. Balayez l'écran de haut en bas.
      2. Appuyez sur l'icône Paramètres .
      3. Recherchez la version Fuchsia: sur un Google Nest Hub (2nd gen), accédez à Informations sur l'appareil > Informations techniques > Version Fuchsia
      4. Appuyez sur "Version Fuchsia". 7 fois. 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".
    • La fonctionnalité sera activée pendant 24 heures. Ensuite, réactivez la fonctionnalité de journalisation à partir de l'étape 5.
  3. Obtenez l'adresse IP de votre hub: <ph type="x-smartling-placeholder">
      </ph>
    • À partir du hub, s'il est doté d'un écran: <ph type="x-smartling-placeholder">
        </ph>
      1. Balayez l'écran de haut en bas.
      2. Appuyez sur l'icône Paramètres .
      3. Recherchez l'adresse IP de l'appareil: sur un Nest Hub (2nd gen), accédez à Informations sur l'appareil > Informations techniques > Adresse IP
    • À partir de Google Home app (GHA) sur votre téléphone: <ph type="x-smartling-placeholder">
        </ph>
      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. Recherchez l'adresse IP de l'appareil: accédez à Appareil informations > 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 la confidentialité et de sécurité, cette fonctionnalité ne doit être utilisée qu'à des fins de tests techniques.
  • N'utilisez pas cette option avec des appareils ou des utilisateurs en production.
  • Étapes: <ph type="x-smartling-placeholder">
      </ph>
    1. Envoyez à votre TAM Google les comptes Google des utilisateurs dont les journaux ne sont pas masqués.
    2. Après avoir confirmé que votre compte a été ajouté à la liste d'autorisation, redémarrez votre téléphone.

Valider le VID/PID de votre appareil

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

Résoudre les problèmes de détection Bluetooth

La valeur VID/PID que votre appareil balise doit correspondre au VID/PID saisi dans votre projet Google Home Developer Console.

  • Les VID 0xFFF1 : 0xFFF4 sont réservés aux tests. Ils peuvent être utilisés pour de base de mise en service et de contrôle, mais ils ne peuvent pas être utilisés les phases de développement suivantes: <ph type="x-smartling-placeholder">

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

Sur cette capture d'écran de la version Android de nRF Connect, vous verrez que le VID/PID est répertorié comme 5A23FFFE à partir du quatrième octet de dans le champ Données des services. Cela indique un VID de 5A23 et un PID de FFFE : au format Little Endian.

L'application BLE affiche les valeurs en petits bouts,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 vos actions de la console en fonction de ce que le détecteur Bluetooth affiche.

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

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

Les hubs Google Matter sont compatibles avec Matter 1.0 et ont été testés avec des builds qui utilisaient les commits de la branche stable v1.0-branch. Vérifiez la version publique notes concernant les commits spécifiques recommandés pour chaque nouvelle version du hub.

Association

Vérifiez les identifiants de votre appareil

Lorsque vous utilisez le VID que vous avez attribué par Alliance, assurez-vous de disposer des identifiants corrects sur l'appareil:

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

Pour en savoir plus, consultez Créer un test d'appareil Matter. certificats.

Valider votre hub compatible avec Matter

Votre hub Matter doit être l'un des hubs pris en charge par Google. Elle doit également se trouver sur build compatible avec Matter.

Certains hubs sont également des routeurs de bordure Thread Vous pouvez ainsi développer et tester des appareils Thread. Autres hubs n'est compatible qu'avec les appareils Matter Wi-Fi et Ethernet, sauf si vous avoir un autre routeur de bordure dans votre réseau pour activer la connectivité Thread.

Pour vérifier la version de votre hub, vous pouvez faire glisser le doigt du haut vers le bas > Roue de configuration > Informations provenant des appareils > Informations techniques > Version du micrologiciel Chromecast

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

Assurez-vous d'avoir créé une intégration avec la bonne combinaison VID/PID dans Developer Console. Voir la section Créer un litige intégration.

La mise en service échoue et le message "Impossible de joindre l'appareil" message d'erreur

Si le message "Impossible de joindre l'appareil" s'affiche à nouveau lors de la mise en service Thread appareil, et tous les outils de débogage disponibles ont été épuisés vous pouvez effacer les Thread préférés enregistrées sur votre téléphone Android pour une configuration propre via Paramètres > Applications > Applications d'application &gt; Services Google Play > Stockage et cache > Gérer l'espace > EFFACER TOUTES LES DONNÉES.

Tests

L'appareil mis en service n'apparaît pas dans la suite de tests

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.

Si le problème persiste

Si vous rencontrez toujours des difficultés après avoir suivi toutes ces étapes de dépannage, résolu, pas de problème !

Au cours des étapes de dépannage, vous avez recueilli des données importantes sur votre appareil, le projet de la console et l'environnement. Avec ces données en main, vérifiez le page d'assistance, qui explique comment partager au mieux votre problème avec le et l'équipe d'assistance Google Home.