Dépannage de Matter

Bâtiment

Vérifier que votre téléphone est compatible

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érifier vos modules Matter pour les 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. Connectez votre téléphone Android à votre ordinateur à l'aide d'un câble USB.
  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 un résultat semblable à celui ci-dessous s'affiche, les modules Matter sont 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 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 un résultat semblable à celui de l'exemple suivant s'affiche, les modules Thread sont installés: 
    com.google.android.gms.threadnetwork [v222106301]
     Notez que le numéro de version de votre appareil peut être différent.

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

  1. Vous utilisez une version obsolète de Android. Assurez-vous qu'il s'agit de Android O (8.1) ou version ultérieure.
  2. Les modules Matter n'ont pas encore été téléchargés. Patientez au moins 24 heures pour qu'elles soient téléchargées. 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 reçu les modules sous 24 heures, vous pouvez essayer de rétablir la configuration d'usine de l'appareil pour forcer le téléchargement des modules.

Journaux de l'appareil du hub 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. Vous les trouverez en petits caractères sous l'appareil.
  2. Une fois que vous figurez sur 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. Recherchez la version de Fuchsia: sur un Google Nest Hub (2nd gen), accédez à Informations sur l'appareil > Informations techniques > Version de Fuchsia.
      4. Appuyez sept fois sur "Version Fuchsia". Les options pour les développeurs sont alors activées.
      5. Revenir au menu de premier niveau
      6. Appuyez sur "Options pour les développeurs".
      7. Appuyez sur "Journalisation des partenaires".
    • 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 :
    • Sur le hub, s'il dispose d'un écran :
      1. Balayez l'écran de haut en bas.
      2. Appuyez sur l'icône Paramètres .
      3. Trouver l'adresse IP de l'appareil: sur un Nest Hub (2nd gen), accédez à Informations sur l'appareil > Informations techniques > Adresse IP.
    • Depuis 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. Recherchez 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, envoyez-lui une requête HTTP GET à 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 ne peut être maintenue ouverte que pendant une minute, mais les données récupérées dans le 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 la fin d'une procédure de test pour s'assurer que le tampon contient du contenu pertinent pour le test (comme les rapports de bugs Android).

Désactiver la 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 des appareils ou des utilisateurs de production.
  • Étapes :
    1. Envoyez les comptes Google des utilisateurs dont les journaux ne seront pas masqués à votre TAM Google.
    2. Une fois que vous avez confirmé que votre compte a été ajouté à la liste d'autorisation, redémarrez votre téléphone.

Vérifier 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.

Résoudre les problèmes liés au sniffeur Bluetooth

La valeur VID/PID de votre appareil doit correspondre à celle saisie dans votre projet Google Home Developer Console.

  • Les VID 0xFFF1 à 0xFFF4 sont réservés aux tests. Ils peuvent être utilisés pour les tests de mise en service et de contrôle de base, mais pas lors des phases de développement suivantes :

À l'aide d'une application d'ingénierie Bluetooth telle que nRF Connect for Mobile, vous pouvez voir le VID/PID de l'appareil de balisage dans le champ Service Data (Données de service).

Dans cette capture d'écran de la version Android de nRF Connect, vous pouvez voir que le VID/PID est listé comme 5A23FFFE à partir du quatrième octet du champ Service Data (Données de 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 ordre petit endian,mais les valeurs VID/PID que vous saisissez dans votre projet Developer Console sont en ordre grand endian.

Vérifiez que les valeurs et le format appropriés ont été saisis dans votre projet Actions Console en fonction de ce que le sniffeur Bluetooth affiche.

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

Vérifier que votre appareil a été compilé à l'aide d'une branche de SDK Matter compatible

Les hubs Matter Google 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 publique pour connaître les commits spécifiques recommandés pour chaque nouvelle version du hub.

Association

Valider les identifiants de votre appareil

Lorsque vous utilisez votre propre VID attribué par Alliance, assurez-vous de disposer des identifiants appropriés 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'appareil Matter.

Vérifier votre hub compatible avec Matter

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

Certains hubs sont également des routeurs de bordure Thread et vous permettent ainsi 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 la version de votre hub, procédez comme suit: Balayez l'écran vers le bas depuis le bord supérieur > Roue de configuration > Informations sur l'appareil > Informations techniques > Version du micrologiciel Chromecast.

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

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

La mise en service échoue avec le message d'erreur "Impossible d'atteindre l'appareil"

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 propre en accédant à Paramètres > Applications > Applications > Services Google Play > Espace de 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 test

Si vous avez associé un appareil à un ID fournisseur (VID) et un ID produit (PID) de 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 pour plusieurs intégrations.

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

Pour vérifier que vous avez associé le bon appareil, vous pouvez définir les informations sur le fabricant et le 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 le problème persiste après avoir suivi toutes les étapes de dépannage indiquées ici, ne vous inquiétez pas.

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