Flux de travail détaillé sur la console Device Advisor

Dans ce didacticiel, vous allez créer une suite de tests personnalisée et exécuter des tests sur l'appareil que vous souhaitez tester dans la console. Une fois les tests terminés, vous pouvez consulter les résultats et les journaux détaillés.

Prérequis

Pour effectuer ce didacticiel, vous devez créer un objet et un certificat.

Création d'une définition de suite de tests

Créez une suite de tests afin de pouvoir l'exécuter sur vos appareils et effectuer la vérification.

1. Dans la AWS IoT console, dans le volet de navigation, développez Test, Device Advisor, puis choisissez Test suites.

   

   Choisissez Create Test Suite.

2. Sélectionnez Use the AWS Qualification test suite ou Create a new test suite.

   Pour le protocole, choisissez MQTT3.1.1 ou MQTT5.

   

   Sélectionnez Use the AWS Qualification test suite cette option pour qualifier et inscrire votre appareil dans le catalogue des appareils AWS partenaires. En choisissant cette option, les scénarios de test requis pour la qualification de votre appareil dans le cadre du programme de qualification AWS IoT Core sont présélectionnés. Les groupes de test et les scénarios de test ne peuvent pas être ajoutés ou supprimés. Vous devrez tout de même configurer les propriétés de la suite de tests.

   Sélectionnez Create a new test suite pour créer et configurer une suite de test personnalisée. Nous vous recommandons de commencer par cette option pour les tests initiaux et le dépannage. Une suite de tests personnalisée doit comporter au moins un groupe de test, et chaque groupe de test doit comporter au moins un cas de test. Dans le cadre de ce didacticiel, nous allons sélectionner cette option et choisir Next.

   

3. Choisissez Propriétés de la suite de tests. Vous devez créer les propriétés de la suite de tests lorsque vous créez votre suite de tests.

   

   Sous Propriétés de la suite de tests, renseignez les champs suivants :

   • Nom de la suite de test : vous pouvez créer la suite avec un nom personnalisé.

   • Timeout (optional) Délai(facultatif) délai d'expiration (en secondes) pour chaque scénario de test de la suite de tests actuelle. Si vous ne spécifiez pas de valeur de délai d'attente, la valeur par défaut est utilisée.

   • Balises (facultatif) : ajoutez des balises à la suite de tests.

   

   Lorsque vous avez terminé, choisissez Mettre à jour les propriétés.

4. Pour modifier la configuration au niveau du groupe, sous Test group 1, choisissez Modifier. Entrez ensuite un nom pour donner un nom personnalisé au groupe.

   Facultativement, vous pouvez également saisir une valeur de délai d'expiration en secondes dans le groupe de test sélectionné. Si vous ne spécifiez pas de valeur de délai d'attente, la valeur par défaut est utilisée.

   

   Sélectionnez Exécuté.

5. Faites glisser l'un des scénarios de test disponibles depuis les scénarios de test vers le groupe de test.

   

6. Pour modifier la configuration au niveau du scénario de test que vous avez ajouté à votre groupe de test, choisissez Modifier. Entrez ensuite un nom pour donner un nom personnalisé au groupe.

   Facultativement, vous pouvez également saisir une valeur de délai d'expiration en secondes dans le groupe de test sélectionné. Si vous ne spécifiez pas de valeur de délai d'attente, la valeur par défaut est utilisée.

   

   Sélectionnez Exécuté.

   Note

   Pour ajouter d'autres groupes de tests à la suite de tests, choisissez Ajouter un groupe de test. Suivez les étapes précédentes pour créer et configurer d'autres groupes de test, ou pour ajouter d'autres cas de test à un ou plusieurs groupes de test. Les groupes de tests et les scénarios de test peuvent être réorganisés en choisissant un scénario de test et en le faisant glisser vers la position souhaitée. Device Advisor exécute les tests dans l'ordre dans lequel vous définissez les groupes de tests et les scénarios de test.

7. Choisissez Suivant.

8. À l'étape 3, configurez un rôle d'appareil que Device Advisor utilisera pour effectuer AWS IoT MQTT des actions au nom de votre appareil de test.

   Si vous avez sélectionné MQTTConnect test case uniquement à l'étape 2, l'action Connect sera automatiquement cochée car cette autorisation est requise sur le rôle de l'appareil pour exécuter cette suite de tests. Si vous avez sélectionné d'autres scénarios de test, les actions requises correspondantes seront vérifiées. Assurez-vous que les valeurs des ressources sont fournies pour chacune des actions. Par exemple, pour l'action Connect, indiquez l'ID client que votre appareil utilise pour se connecter au point de terminaison Device Advisor. Vous pouvez fournir plusieurs valeurs en utilisant des virgules pour séparer les valeurs, et vous pouvez également fournir des valeurs de préfixe en utilisant un caractère générique (*). Par exemple, pour accorder l'autorisation de publier sur n'importe quel sujet commençant par MyTopic, vous pouvez fournir « MyTopic* » comme valeur de ressource.

   

   Si vous avez déjà créé un rôle sur l'appareil et que vous souhaitez utiliser ce rôle, sélectionnez Sélectionner un rôle existant et choisissez votre rôle sur l'appareil sous Sélectionner un rôle.

   

   Configurez le rôle de votre appareil à l'aide de l'une des deux options proposées et choisissez Next (Suivant).

9. À l'étape 4, assurez-vous que la configuration fournie à chacune des étapes est précise. Pour modifier la configuration fournie pour une étape particulière, choisissez Modifier pour l'étape correspondante.

   Après avoir vérifié la configuration, choisissez Créer une suite de tests.

   La suite de tests devrait être créée avec succès et vous serez redirigé vers la page des suites de tests où vous pourrez voir toutes les suites de tests créées.

   Si la création de la suite de tests a échoué, assurez-vous que la suite de tests, les groupes de tests, les scénarios de test et le rôle de l'appareil ont été configurés conformément aux instructions précédentes.

Lancer l'exécution d'une suite de test

1. Dans la AWS IoT console, dans le volet de navigation, développez Test, Device Advisor, puis choisissez Test suites.

2. Choisissez la suite de tests dont vous souhaitez consulter les détails.

   

   La page détaillée de la suite de tests affiche toutes les informations relatives à la suite de tests.

3. Choisissez Actions, puis Exécuter la suite de tests.

   

4. Sous Exécuter la configuration, vous devez sélectionner un AWS IoT objet ou un certificat à tester à l'aide de Device Advisor. Si vous n'avez aucun élément ou certificat existant, créez d'abord des AWS IoT Core ressources.

   Dans la section Tester le point de terminaison, sélectionnez le point de terminaison qui convient le mieux à votre cas d'utilisation. Si vous prévoyez d'exécuter plusieurs suites de tests simultanément en utilisant le même AWS compte à l'avenir, sélectionnez Endpoint au niveau de l'appareil. Sinon, si vous prévoyez d'exécuter une seule suite de tests à la fois, sélectionnez Point de terminaison au niveau du compte.

   Configurez votre appareil de test avec le point de terminaison de test du Device Advisor sélectionné.

   Après avoir sélectionné un objet ou un certificat et choisi un point de terminaison Device Advisor, choisissez Exécuter le test.

   

5. Choisissez Accéder aux résultats sur le bandeau supérieur pour afficher les détails du test.

   

Arrêter l'exécution d'une suite de tests (facultatif)

1. Dans la AWS IoT console, dans le volet de navigation, développez Test, Device Advisor, puis choisissez Tests et résultats.

2. Choisissez la suite de tests en cours que vous souhaitez arrêter.

   

3. Choisissez Actions, puis Arrêter la suite de tests.

   

4. Le processus de nettoyage prendra plusieurs minutes. Pendant l'exécution du processus de nettoyage, l'état du test sera STOPPING. Attendez que le processus de nettoyage soit terminé et que l'état de la suite de tests passe au STOPPED statut actuel avant de démarrer une nouvelle exécution de suite.

   

Afficher les détails et les journaux d'exécution de la suite de tests

1. Dans la AWS IoT console, dans le volet de navigation, développez Test, Device Advisor, puis choisissez Tests et résultats.

   Cette page affiche :

   • Nombre d'objets IoT

   • Nombre de certificats IoT

   • Nombre de suites de tests en cours d'exécution

   • Toutes les suites de tests exécutées qui ont été créées

2. Choisissez la suite de tests pour laquelle vous souhaitez afficher les détails et les journaux d'exécution.

   

   La page de résumé de l'exécution affiche l'état de l'exécution de la suite de tests en cours. Cette page est actualisée automatiquement toutes les 10 secondes. Nous vous recommandons de créer un mécanisme permettant à votre appareil d'essayer de se connecter à notre point de terminaison de test toutes les cinq secondes pendant une à deux minutes au maximum. Vous pouvez ensuite exécuter plusieurs scénarios de test en séquence de manière automatisée.

   

3. Pour accéder aux CloudWatch journaux relatifs à l'exécution de la suite de tests, choisissez Test suite log.

   Pour accéder aux CloudWatch journaux de n'importe quel scénario de test, choisissez Test case log.

4. En fonction des résultats de vos tests, troubleshoot (dépannez) votre appareil jusqu'à ce que tous les tests réussissent.

Téléchargez un rapport AWS IoT de qualification

Si vous avez choisi l'option Utiliser la suite de tests de AWS IoT qualification lors de la création d'une suite de tests et que vous avez pu exécuter une suite de tests de qualification, vous pouvez télécharger un rapport de qualification en choisissant Télécharger le rapport de qualification sur la page de résumé des tests.