Shadow

Utilisez ces tests pour vérifier que vos appareils testés utilisent correctement le service AWS IoT Device Shadow. Pour plus d’informations, consultez AWS IoT Service Device Shadow. Si ces cas de test sont configurés dans votre suite de tests, il est nécessaire de fournir un élément lors du démarrage de l'exécution de la suite.

Le MQTT over n' WebSocketest pas pris en charge pour le moment.

Publish

« L'appareil publie son état après sa connexion (Happy case) »

Valide si un appareil peut publier son état après s'être connecté à AWS IoT Core

Définition du cas de test de l'API :

Note

EXECUTION_TIMEOUT a une valeur par défaut de 5 minutes. Nous recommandons une valeur de délai d'attente de 2 minutes.

"tests":[
   {
      "name":"my_shadow_publish_reported_state",
      "configuration": {
         // optional:
         "EXECUTION_TIMEOUT":"300", // in seconds
         "SHADOW_NAME": "SHADOW_NAME",
         "REPORTED_STATE": {
            "STATE_ATTRIBUTE": "STATE_VALUE"
         }
      },
      "test":{
         "id":"Shadow_Publish_Reported_State",
         "version":"0.0.0"
      }
   }
]      

Les REPORTED_STATE peuvent être fournis pour une validation supplémentaire de l'état shadow exact de votre appareil, une fois celui-ci connecté. Par défaut, ce scénario de test valide l'état de publication de votre appareil.

Si SHADOW_NAME n'est pas fourni, le scénario de test recherche par défaut les messages publiés dans les préfixes de rubrique du type Unnamed (classic) shadow. Indiquez un nom shadow si votre appareil utilise le type shadow nommé. Consultez la section Utilisation des shadows dans les appareils pour plus d'informations.

Mettre à jour

« L'appareil met à jour l'état signalé à l'état souhaité (Happy case) »

Valide si votre appareil lit tous les messages de mise à jour reçus et synchronise l'état de l'appareil pour qu'il corresponde aux propriétés d'état souhaitées. Votre appareil devrait publier son dernier état signalé après la synchronisation. Si votre appareil dispose déjà d'un shadow existant avant d'exécuter le test, assurez-vous que l'état souhaité configuré pour le scénario de test et l'état signalé existant ne correspondent pas déjà. Vous pouvez identifier les messages de mise à jour de Shadow envoyés par Device Advisor en consultant le ClientTokenchamp tel qu'il sera dans le document ShadowDeviceAdvisorShadowTestCaseSetup.

Définition du cas de test de l'API :

Note

EXECUTION_TIMEOUT a une valeur par défaut de 5 minutes. Nous recommandons une valeur de délai d'attente de 2 minutes.

"tests":[
   {
      "name":"my_shadow_update_reported_state",
      "configuration": {
         "DESIRED_STATE": {
            "STATE_ATTRIBUTE": "STATE_VALUE"
         },
         // optional:
         "EXECUTION_TIMEOUT":"300", // in seconds
         "SHADOW_NAME": "SHADOW_NAME"
      },
      "test":{
         "id":"Shadow_Update_Reported_State",
         "version":"0.0.0"
      }
   }
]

Le DESIRED_STATE doit avoir au moins un attribut et une valeur associée.

Si SHADOW_NAME n'est pas fourni, alors le scénario de test recherche par défaut les messages publiés dans les préfixes de rubrique du type Unnamed (classic) shadow. Indiquez un nom shadow si votre appareil utilise le type shadow nommé. Consultez la section Utilisation des shadows dans les appareils pour plus d'informations.