Flux de travail détaillé sur la console Device Advisor - AWS IoT Core

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

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

    L'interface Device Advisor propose des options permettant de créer des suites de tests pour les appareils éligibles, d'exécuter des tests de longue durée et des suites de tests personnalisées.

    Choisissez Create Test Suite.

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

    Pour le protocole, choisissez MQTT 3.1.1 ou MQTT 5.

    « Créer une suite de tests » avec des options permettant de choisir le type de suite de tests (AWS IoT Core qualification, longue durée ou personnalisé) et le protocole (MQTT 3.1.1 ou MQTT 5).

    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.

    Page de configuration de la suite de tests qui indique les étapes de création d'une suite de tests avec des groupes de tests et des cas pour tester des appareils IoT.
  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.

    L'interface « Configurer la suite de tests » qui affiche les options permettant de créer des groupes de test et d'ajouter des cas de test pour tester les fonctionnalités des appareils IoT.

    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.

    Fenêtre intitulée « Propriétés de la suite de tests » affichant les champs permettant de spécifier le nom de la suite de tests, le délai d'expiration et les balises personnalisées pour une suite de démonstration Device Advisor.

    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.

    L'interface « Configurer la suite de tests » permet de créer des groupes de tests et des cas afin de valider le fonctionnement des appareils IoT.

    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.

    Interface de configuration permettant de créer une suite de tests dans Device Advisor, avec des options permettant d'ajouter des groupes de test et des cas de test pour tester les appareils IoT.
  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.

    Interface de configuration de la suite de tests avec des options pour configurer les groupes de tests, les cas de test, les paramètres de délai d'expiration et les points de départ pour l'exécution de la suite de tests.

    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 de périphérique que Device Advisor utilisera pour effectuer des actions AWS IoT MQTT au nom de votre périphérique de test.

    Si vous avez sélectionné le scénario de test MQTT Connect uniquement à l'étape 2, l'action Connect sera sera vérifiée automatiquement puisque cette autorisation est requise sur le rôle de périphérique 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.

    L'étape « Sélectionnez un rôle sur l'appareil » dans Device Advisor pour créer une suite de tests, avec des options pour créer un nouveau rôle ou sélectionner un rôle existant, et des champs pour spécifier le nom du rôle, les autorisations et les détails des ressources.

    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.

    La page permettant de sélectionner un rôle sur l'appareil pour les tests de Device Advisor, avec des options permettant de créer un nouveau rôle ou d'en sélectionner un existant.

    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 console qui affiche une seule suite de tests nommée « suite de démonstration Device Advisor » créée le 11 mai 2021.

    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.

    La page de la suite de démonstration avec un bouton « Exécuter la suite de tests » et un journal d'activité vide indiquant qu'aucune suite de tests n'a été exécutée auparavant.
  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.

    Configuration sur laquelle exécuter une suite de tests AWS IoT Core, vous permettant de sélectionner des appareils de test (objets ou certificats), de choisir un point de terminaison de test (au niveau du compte ou au niveau de l'appareil) et d'ajouter éventuellement des balises.
  5. Choisissez Accéder aux résultats sur le bandeau supérieur pour afficher les détails du test.

    Les détails d'une suite de tests personnalisée intitulée « Suite de démonstration Device Advisor » sont en cours d'élaboration avec le statut « En attente ».

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.

    Les résultats des tests s'exécutent sur la console Device Advisor.
  3. Choisissez Actions, puis Arrêter la suite de tests.

    Les résultats des tests s'exécutent sur la console Device Advisor.
  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.

    Les résultats interrompus des tests s'exécutent sur la console Device Advisor.

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.

    Une section de tests et de résultats qui affiche les détails d'une suite de tests nommée « suite de démonstration Device Advisor » actuellement en cours de réalisation.

    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.

    Le journal des cas de test qui indique un test MQTT Connect réussi sans qu'aucun message système ne soit affiché.
  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.

Résultats des tests du programme de qualification indiquant les tests réussis pour MQTT, TLS et d'autres composants.