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.
# Exécutez la suite de qualification FreeRTOS
Vous utilisez l'exécutable AWS IoT Device Tester for FreeRTOS pour interagir avec IDT pour FreeRTOS. Les exemples de ligne de commande ci-dessous vous montrent comment exécuter les tests de qualification d'un groupe d'appareils (ensemble d'appareils identiques).
------
#### [ IDT v3.0.0 and later ]
```
devicetester_[linux | mac | win] run-suite \
--suite-id suite-id \
--group-id group-id \
--pool-id your-device-pool \
--test-id test-id \
--upgrade-test-suite y|n \
--update-idt y|n \
--update-managed-policy y|n \
--userdata userdata.json
```
Exécute une suite de tests sur un groupe d'appareils. Le fichier `userdata.json` doit figurer dans le répertoire `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/`.
**Note**
Si vous utilisez IDT pour FreeRTOS sous Windows, utilisez des barres obliques (/) pour spécifier le chemin du fichier. `userdata.json`
Utilisez la commande suivante pour exécuter un groupe de tests spécifique :
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1.0.1 \
--group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
Les paramètres `suite-id` et `pool-id` sont facultatifs si vous exécutez une seule suite de tests au niveau d'un seul groupe d'appareils (à savoir, si un seul groupe d'appareils est défini dans votre fichier `device.json`).
Utilisez la commande suivante pour exécuter un cas de test spécifique dans un groupe de tests :
```
devicetester_[linux | mac | win_x86-64] run-suite \
--group-id group-id \
--test-id test-id
```
Vous pouvez utiliser la commande `list-test-cases` pour répertorier les cas de test dans un groupe de tests. Options de ligne de commande IDT pour FreeRTOS
**group-id**
(Facultatif) Groupes de tests à exécuter, sous la forme d'une liste séparée par des virgules. Si cette option n'est pas spécifiée, IDT exécute tous les groupes de tests de la suite de tests.
**pool-id**
(Facultatif) Le groupe d'appareils à tester. Option requise si vous définissez plusieurs groupes d'appareils dans `device.json`. Si vous avez un seul groupe d'appareils, vous pouvez omettre cette option.
**suite-id**
(Facultatif) Version de la suite de tests à exécuter. Si cette option n'est pas spécifiée, IDT utilise la dernière version dans le répertoire tests de votre système.
Depuis IDT v3.0.0, IDT recherche en ligne des suites de tests plus récentes. Pour de plus amples informations, veuillez consulter [Versions de la suite de tests](idt-test-suite-versions.md).
**test-id**
(Facultatif) Tests à exécuter, sous la forme d'une liste séparée par des virgules. Si cette option est spécifiée, `group-id` doit spécifier un groupe unique.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
**update-idt**
(Facultatif) Si ce paramètre n'est pas défini et qu'une version IDT plus récente est disponible, vous serez invité à mettre à jour IDT. Si ce paramètre est défini sur`Y`, IDT arrêtera l'exécution du test s'il détecte qu'une version plus récente est disponible. Si ce paramètre est défini sur`N`, IDT poursuivra l'exécution du test.
**update-managed-policy**
(Facultatif) Si ce paramètre n'est pas utilisé et qu'IDT détecte que votre politique gérée ne l'est pas up-to-date, vous serez invité à mettre à jour votre politique gérée. Si ce paramètre est défini sur`Y`, IDT arrêtera l'exécution du test s'il détecte que ce n'est pas up-to-date le cas de votre politique gérée. Si ce paramètre est défini sur`N`, IDT poursuivra l'exécution du test.
**upgrade-test-suite**
(Facultatif) Si cette option n'est pas utilisée et qu'une version de suite de tests plus récente est disponible, vous êtes invité à la télécharger. Pour masquer l'invite, spécifiez `y` pour toujours télécharger la suite de tests la plus récente ou spécifiez `n` pour utiliser la suite de tests spécifiée ou la dernière version sur votre système.
**Example**
**Exemple**
Pour toujours télécharger et utiliser la suite de tests la plus récente, utilisez la commande suivante.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite y
```
Pour utiliser la dernière suite de tests sur votre système, utilisez la commande suivante.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite n
```
**h**
Utilisez l'option d'aide pour en savoir plus sur les options `run-suite`.
**Example**
**Exemple**
```
devicetester_[linux | mac | win_x86-64] run-suite -h
```
------
#### [ IDT v1.7.0 and earlier ]
```
devicetester_[linux | mac | win] run-suite \
--suite-id suite-id \
--pool-id your-device-pool \
--userdata userdata.json
```
Le fichier `userdata.json` doit être situé dans le répertoire `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/`.
**Note**
Si vous utilisez IDT pour FreeRTOS sous Windows, utilisez des barres obliques (/) pour spécifier le chemin du fichier. `userdata.json`
Utilisez la commande suivante pour exécuter un groupe de tests spécifique.
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1 --group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
Les valeurs `suite-id` et `pool-id` sont facultatives si vous exécutez une seule suite de tests au niveau d'un seul groupe d'appareils (autrement, si un seul groupe d'appareils est défini dans le fichier `device.json`).Options de ligne de commande IDT pour FreeRTOS
**group-id**
(Facultatif) Spécifie le groupe de tests.
**pool-id**
Spécifie le groupe d'appareils à tester. Si vous avez un seul groupe d'appareils, vous pouvez omettre cette option.
**suite-id**
(Facultatif) Spécifie la suite de tests à exécuter.
------
## IDT pour les commandes FreeRTOS
La commande IDT pour FreeRTOS prend en charge les opérations suivantes :
------
#### [ IDT v3.0.0 and later ]
**`help`**
Répertorie les informations sur la commande spécifiée.
**`list-groups`**
Répertorie les groupes dans une suite donnée.
**`list-suites`**
Répertorie les suites disponibles.
**`list-supported-products`**
Répertorie les produits et les versions de suite de tests pris en charge.
**`list-supported-versions`**
Répertorie les versions de FreeRTOS et de suites de tests prises en charge par la version actuelle d'IDT.
**`list-test-cases`**
Répertorie les cas de test dans un groupe spécifié.
**`run-suite`**
Exécute une suite de tests sur un groupe d'appareils.
Utilisez l'option `--suite-id` pour spécifier une version de suite de tests ou omettez-la pour utiliser la dernière version sur votre système.
Utilisez l'option `--test-id` pour exécuter un cas de test individuel.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
Pour obtenir la liste complète des options, veuillez consulter [Exécutez la suite de qualification FreeRTOS](#run-tests).
Depuis IDT v3.0.0, IDT recherche en ligne des suites de tests plus récentes. Pour de plus amples informations, veuillez consulter [Versions de la suite de tests](idt-test-suite-versions.md).
------
#### [ IDT v1.7.0 and earlier ]
**`help`**
Répertorie les informations sur la commande spécifiée.
**`list-groups`**
Répertorie les groupes dans une suite donnée.
**`list-suites`**
Répertorie les suites disponibles.
**`run-suite`**
Exécute une suite de tests sur un groupe d'appareils.
------
## Test de requalification
À mesure que de nouvelles versions d'IDT pour les tests de qualification FreeRTOS sont publiées, ou que vous mettez à jour des packages ou des pilotes de périphériques spécifiques à vos cartes, vous pouvez utiliser IDT pour FreeRTOS pour tester vos cartes microcontrôleurs. Pour les qualifications ultérieures, assurez-vous de disposer des dernières versions de FreeRTOS et d'IDT pour FreeRTOS et recommencez les tests de qualification.