Google Home Developer Console fournit une page Test sur laquelle vous pouvez configurer et exécuter des tests sur votre Matter l'intégration à l'aide de Google Home Test Suite. La Test Suite est une application distincte intégrée au Developer Console qui gère tous les tests d'intégration.
Les appareils pour l'ID fournisseur et l'ID produit de l'intégration doivent être mis en service et disponible dans Google Home app (GHA) pour le compte utilisé avec la Developer Console pour être testé. Voir Associer un Matter appareil pour en savoir plus.
Le Test Suite peut être exécuté sur un ensemble d'appareils appartenant à une configuration de projet Matter spécifique. Il est très important d'exécuter Test Suite sur vos intégrations pour pour s'assurer que tout fonctionne correctement.
Sur la page Test, Matter intégrations terminées et prêtes à être testées sont listées dans la section Prêt à être testé.
Matter intégrations qui ont été testées sont listées dans la section Tested.
Types de plans de test
Il existe deux types de plans de test :
Les plans de test de développement permettent d'évaluer le contrôle des appareils Matter Vous pouvez les modifier, mais vous ne pouvez pas les envoyer pour obtenir la certification Matter.
Les plans de test Certification sont réservés à la certification Matter et ne sont pas modifiables. Sélectionnez cette option pour créer une nouvelle version de votre Intégration de Matter.
Versions d'Integration
Lorsque vous créez un plan de test pour la certification, une nouvelle version de l'intégration est créée. Cette version numérotée est listée dans toutes les listes d'intégration dans Developer Console à partir de l'onglet "Test".
Aucune nouvelle version n'est créée à partir d'autres versions numérotées. Par exemple, le premier plan de test que vous créez pour une intégration génère la version v.1 correspondante l'intégration. La création d'un autre plan de test entraîne la création de la version v.2 correspondante. mais cette version ne repose pas sur la v.1. À la place, cette version est basé sur l'instance de l'intégration sans versions gérées, comme l'était la version v.1.
La version N/A d'une intégration représente l'instance non versionnée de l'intégration, qui est gérée dans l'onglet Développer.
En d'autres termes, sur Matter > Tester dans la section Developer Console:
- Si vous cliquez sur Test pour la version N/A de l'intégration, une nouvelle version est créée. Le numéro de version sera supérieur de un à toute numérotation existante.
versions.
- S'il n'existe aucune version numérotée, la version v.1 est créée.
- Si la version v.1 existe, la version v.2 est créée. Si la version v.2 existe, la version v.3 est créée, etc.
- Si vous cliquez sur Tester pour obtenir une version numérotée de l'intégration (par exemple, v.1), aucune nouvelle version n'est créée. Au lieu de cela, la version v.1 est à nouveau.
Pour en savoir plus, consultez la section Gestion des versions des intégrations.
Créer un plan de test
Les versions d'une intégration sont un instantané d'une intégration sans version. Cela signifie lorsque vous créez un plan de test pour la certification, et donc une intégration , toutes les métadonnées liées à cette intégration doivent correspondre aux informations que vous souhaitez utiliser pour l'intégration lancée.
Avant de créer un plan de test pour la certification, assurez-vous d'avoir effectué les opérations suivantes :
- créé un profil d'entreprise ;
- Vous avez saisi l'ID de fournisseur (VID) de production pour l'intégration.
- Configurer la configuration et le branding :
Si vous n'avez pas effectué toutes ces étapes pour votre intégration, une version d'intégration créée pour les tests de certification ne peut pas être certifiée. Vous aurez pour créer une nouvelle version, c'est-à-dire refaire le test, le test et la certification. étapes.
Vous devrez également créer une autre version et recommencer si vous souhaitez mettre à jour votre branding avant qu'une version d'intégration ne soit certifiée.
Pour créer un plan de test:
Accéder à la Developer Console
Dans la liste des projets, cliquez sur Ouvrir à côté du projet que vous souhaitez ouvrir. travailler.
Dans le menu de navigation sur le côté gauche de la page, accédez à Matter > Tester :
Cliquez sur Test pour la version N/A de l'intégration que vous souhaitez tester. Ce crée une version d'intégration.
Sélectionnez un type de test Test de développement ou Test de certification.
- Sélectionnez Test de certification si vous préparez votre certification pour l'écosystème Google.
- Un test de développement ne peut pas être utilisé pour la certification.
Cliquez sur Tester. Si le message d'erreur Aucun appareil trouvé s'affiche, un appareil pour cette intégration n'a pas encore été commandée dans l'écosystème. Voir Résoudre les problèmes d'association pour en savoir plus.
Sur l'écran Configurer votre test, indiquez le nom de votre test. sélectionnez ceux que vous souhaitez tester dans la liste des appareils.
Cliquez sur le bouton Suivant: Plan de test.
Sur la page Créer un plan de test, dans la section Suites de tests, sélectionnez les suites de tests que vous souhaitez exécuter.
Si vous souhaitez quitter Test Suite, cliquez sur Retour au développeur Google Workspace.
Exécuter le plan de test
Dans Test Suite, à partir de la page Créer un plan de test, procédez comme suit : cliquez sur Run Test (Exécuter le test). La page Environnement de test s'affiche. Elle indique l'état et les journaux de tous les tests.
Les résultats s'affichent une fois les tests terminés. État de chaque suite de tests s'affiche à côté ("Réussie", "Échec").
Le volet Journaux affiche l'état de chaque exécution de test.
Pour tester de nouveau un plan de test à partir de la page Environnement de test, cliquez sur Tester de nouveau en haut de la page une fois l'exécution du test terminée.
Une fois l'opération terminée:
- Cliquez sur OK pour accéder à la page Historique des tests, ou
- Cliquez sur Envoyer pour envoyer les résultats du test pour la certification.
Afficher et interpréter les résultats de vos tests
Sur la page Historique des tests du Test Suite, vous pouvez afficher les résultats des tests précédents pour un plan de développement ou une certification non envoyée ; en cliquant sur Tester de nouveau à côté du plan souhaité dans la section Plans de test . Vous êtes redirigé vers la page Test Environment (Environnement de test) qui affiche le les résultats de ce test.
Pour un plan de certification envoyé, cliquez sur Résultats dans la colonne certification pour afficher le rapport sur les résultats des tests.
Vous pouvez également accéder aux résultats d'une version d'intégration à partir de la page Test dans Developer Console. Cliquez sur Afficher pour accéder à l'historique des tests de toute version d'intégration figurant sur cette page pour être redirigée vers l'historique des tests ; dans le Test Suite.
États de la console
La phase de test peut présenter les états suivants:
| Section | État | Description | Exigence | Étapes suivantes |
|---|---|---|---|---|
| Prêt pour les tests | Prêt | Cette version de integration est prête à être testée. | N/A | Testez cette version de integration |
| Testé | Prêt | Cette version de integration a été testée et peut être soumis pour le test ou la certification sur le terrain. |
La version a été testée et enregistrée. Tous les scénarios de test ayant échoué incluent des justifications que Google peut examiner. |
Testez de nouveau si vous le souhaitez. |
Dépannage
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) 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-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.
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.
La valeur VID/PID que votre appareil balise doit correspondre au VID/PID saisies dans votre projet Developer Console.
- Les VID
0xFFF1:0xFFF4sont 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:
À 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.
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 :
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 l'exemple de capture d'écran, les valeurs VID et PID dans Developer Console sont respectivement 235A et FEFF.