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.
# Utiliser l'interface utilisateur IDT pour exécuter la suite de qualification FreeRTOS
À partir de IDT v4.3.0, pour AWS IoT Device Tester FreeRTOS (IDT-FreeRTOS) inclut une interface utilisateur Web qui vous permet d'interagir avec le fichier exécutable en ligne de commande IDT et les fichiers de configuration associés. Vous pouvez utiliser l'interface utilisateur IDT-FreeRTOS pour créer une nouvelle configuration afin d'exécuter des tests IDT ou pour modifier une configuration existante. Vous pouvez également utiliser l'interface utilisateur pour appeler l'exécutable IDT et exécuter des tests.
L'interface utilisateur IDT-FreeRTOS fournit les fonctions suivantes :
+ Simplifiez la configuration des fichiers de configuration pour les tests IDT-FreeRTOS.
+ Simplifiez l'utilisation d'IDT-FreeRTOS pour exécuter des tests de qualification.
Pour plus d'informations sur l'utilisation de la ligne de commande pour exécuter des tests de qualification, consultez[Premier test de votre carte microcontrôleur](qual-steps.md).
Cette section décrit les conditions requises pour utiliser l'interface utilisateur IDT-FreeRTOS et vous montre comment commencer à exécuter des tests de qualification dans l'interface utilisateur.
**Topics**
+ [Configurez les prérequis pour exécuter la suite de qualification FreeRTOS](dev-tester-ui-prereqs.md)
+ [Commencez avec l'interface utilisateur IDT-Freertos](dev-tester-ui-getting-started.md)
# Configurez les prérequis pour exécuter la suite de qualification FreeRTOS
Cette section décrit les prérequis pour tester les microcontrôleurs avec. AWS IoT Device Tester
**Topics**
+ [Utiliser un navigateur Web compatible](#idt-ui-supported-web-browser)
+ [Télécharger FreeRTOS](#ui-download-afr)
+ [Télécharger IDT pour FreeRTOS](#ui-download-dev-tester-afr)
+ [Création et configuration d'un AWS compte](#ui-config-aws-account)
+ [AWS IoT Device Tester politique gérée](#ui-managed-policy)
## Utiliser un navigateur Web compatible
L'interface utilisateur d'IDT-Freertos prend en charge les navigateurs Web suivants.
| Navigateur | Version |
| --- | --- |
| Google Chrome | Les trois dernières versions majeures |
| Mozilla Firefox | Les trois dernières versions majeures |
| Microsoft Edge | Les trois dernières versions majeures |
| Apple Safari pour macOS | Les trois dernières versions majeures |
Nous vous recommandons d'utiliser Google Chrome ou Mozilla Firefox pour une meilleure expérience.
**Note**
L'interface utilisateur d'IDT-FreeRTOS ne prend pas en charge Microsoft Internet Explorer.
## Télécharger FreeRTOS
Vous pouvez télécharger une version de FreeRTOS à l'aide [GitHub](https://github.com/aws/amazon-freertos)de la commande suivante :
```
git clone --branch --recurse-submodules https://github.com/aws/amazon-freertos.git
cd amazon-freertos
git submodule update --checkout --init --recursive
```
où se trouve une version de FreeRTOS (par exemple, 202007.00) correspondant à une version IDT répertoriée dans. [Versions prises en charge de AWS IoT Device Tester](dev-test-versions-afr.md) Cela garantit que vous disposez du code source complet, y compris les sous-modules, et que vous utilisez la bonne version d'IDT pour votre version de FreeRTOS, et vice versa.
Pour Windows, la limitation de la longueur du chemin est de 260 caractères. La structure des chemins de FreeRTOS comporte plusieurs niveaux. Par conséquent, si vous utilisez Windows, maintenez les chemins de vos fichiers en dessous de la limite de 260 caractères. Par exemple, clonez FreeRTOS sur plutôt que sur`C:\FreeRTOS`. `C:\Users\username\programs\projects\myproj\FreeRTOS\`
### Considérations relatives à la qualification LTS (qualification pour FreeRTOS utilisant des bibliothèques LTS)
+ Pour que votre microcontrôleur soit désigné comme compatible avec les versions basées sur le support à long terme (LTS) de FreeRTOS dans AWS le catalogue des appareils partenaires, vous devez fournir un fichier manifeste. *Pour plus d'informations, consultez la liste de contrôle de qualification [FreeRTOS dans le guide de qualification](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afq-checklist.html) FreeRTOS.*
+ Afin de valider que votre microcontrôleur prend en charge les versions LTS de FreeRTOS et de le soumettre au Partner Device Catalog, vous devez AWS IoT Device Tester utiliser (IDT) avec AWS la version v1.4.x de la suite de tests FreeRTOS Qualification (FRQ).
+ Support pour les versions LTS de FreeRTOS limité à la version 202012.xx de FreeRTOS.
## Télécharger IDT pour FreeRTOS
Chaque version de FreeRTOS possède une version correspondante d'IDT pour FreeRTOS pour effectuer des tests de qualification. Téléchargez la version appropriée d'IDT pour FreeRTOS à partir de. [Versions prises en charge de AWS IoT Device Tester](dev-test-versions-afr.md)
Extrayez IDT pour FreeRTOS vers un emplacement du système de fichiers où vous disposez d'autorisations de lecture et d'écriture. Microsoft Windows ayant une limite de caractères pour la longueur du chemin, extrayez IDT pour FreeRTOS dans un répertoire racine tel que ou. `C:\` `D:\`
**Note**
Nous vous recommandons d'extraire le package IDT sur un lecteur local. Si vous autorisez plusieurs utilisateurs à exécuter IDT à partir d'un emplacement partagé, tel qu'un répertoire NFS ou un dossier partagé sur le réseau Windows, le système risque de ne pas répondre ou de corrompre les données.
## Création et configuration d'un AWS compte
### Inscrivez-vous pour un Compte AWS
Si vous n'en avez pas Compte AWS, procédez comme suit pour en créer un.
**Pour vous inscrire à un Compte AWS**
1. Ouvrez l'[https://portal.aws.amazon.com/billing/inscription.](https://portal.aws.amazon.com/billing/signup)
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, un *Utilisateur racine d'un compte AWS*est créé. Par défaut, seul l’utilisateur racine a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l’utilisateur racine pour effectuer les [tâches nécessitant un accès utilisateur racine](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à [https://aws.amazon.com/](https://aws.amazon.com/)et en choisissant **Mon compte**.
### Création d’un utilisateur doté d’un accès administratif
Après vous être inscrit à un Compte AWS, sécurisez Utilisateur racine d'un compte AWS AWS IAM Identity Center, activez et créez un utilisateur administratif afin de ne pas utiliser l'utilisateur root pour les tâches quotidiennes.
**Sécurisez votre Utilisateur racine d'un compte AWS**
1. Connectez-vous en [AWS Management Console](https://console.aws.amazon.com/)tant que propriétaire du compte en choisissant **Utilisateur root** et en saisissant votre adresse Compte AWS e-mail. Sur la page suivante, saisissez votre mot de passe.
Pour obtenir de l’aide pour vous connecter en utilisant l’utilisateur racine, consultez [Connexion en tant qu’utilisateur racine](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) dans le *Guide de l’utilisateur Connexion à AWS *.
1. Activez l’authentification multifactorielle (MFA) pour votre utilisateur racine.
Pour obtenir des instructions, voir [Activer un périphérique MFA virtuel pour votre utilisateur Compte AWS root (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) dans le guide de l'utilisateur *IAM*.
**Création d’un utilisateur doté d’un accès administratif**
1. Activez IAM Identity Center.
Pour obtenir des instructions, consultez [Activation d’ AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) dans le *Guide de l’utilisateur AWS IAM Identity Center *.
1. Dans IAM Identity Center, octroyez un accès administratif à un utilisateur.
Pour un didacticiel sur l'utilisation du Répertoire IAM Identity Center comme source d'identité, voir [Configurer l'accès utilisateur par défaut Répertoire IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) dans le *Guide de AWS IAM Identity Center l'utilisateur*.
**Connexion en tant qu’utilisateur doté d’un accès administratif**
+ Pour vous connecter avec votre utilisateur IAM Identity Center, utilisez l’URL de connexion qui a été envoyée à votre adresse e-mail lorsque vous avez créé l’utilisateur IAM Identity Center.
Pour obtenir de l'aide pour vous connecter en utilisant un utilisateur d'IAM Identity Center, consultez la section [Connexion au portail AWS d'accès](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) dans le *guide de l'Connexion à AWS utilisateur*.
**Attribution d’un accès à d’autres utilisateurs**
1. Dans IAM Identity Center, créez un ensemble d’autorisations qui respecte la bonne pratique consistant à appliquer les autorisations de moindre privilège.
Pour obtenir des instructions, consultez [Création d’un ensemble d’autorisations](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) dans le *Guide de l’utilisateur AWS IAM Identity Center *.
1. Attribuez des utilisateurs à un groupe, puis attribuez un accès par authentification unique au groupe.
Pour obtenir des instructions, consultez [Ajout de groupes](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) dans le *Guide de l’utilisateur AWS IAM Identity Center *.
## AWS IoT Device Tester politique gérée
Pour permettre au testeur d'appareils de s'exécuter et de collecter des métriques, la politique `AWSIoTDeviceTesterForFreeRTOSFullAccess` gérée contient les autorisations suivantes :
+ `iot-device-tester:SupportedVersion`
Accorde l'autorisation d'obtenir la liste des versions de FreeRTOS et des versions de suites de tests prises en charge par IDT, afin qu'elles soient disponibles auprès du. AWS CLI
+ `iot-device-tester:LatestIdt`
Accorde l'autorisation d'obtenir la dernière AWS IoT Device Tester version disponible au téléchargement.
+ `iot-device-tester:CheckVersion`
Accorde l'autorisation de vérifier la compatibilité d'une combinaison de produit, de suite de tests et de versions AWS IoT Device Tester .
+ `iot-device-tester:DownloadTestSuite`
Accorde l'autorisation AWS IoT Device Tester de télécharger des suites de tests.
+ `iot-device-tester:SendMetrics`
Accorde l'autorisation de publier des données de statistiques AWS IoT Device Tester d'utilisation.
# Commencez avec l'interface utilisateur IDT-Freertos
Cette section explique comment utiliser l'interface utilisateur d'IDT-FreeRTOS pour créer ou modifier votre configuration, puis comment exécuter des tests.
**Topics**
+ [Configurer les AWS informations d'identification](#configure-aws-credentials)
+ [Ouvrez l'interface utilisateur IDT-Freertos](#open-idt-ui)
+ [Création d'une nouvelle configuration](#create-new-configuration)
+ [Modifier une configuration existante](#modify-existing-configuration)
+ [Exécuter des tests de qualification](#run-tests-from-ui)
## Configurer les AWS informations d'identification
Vous devez configurer les informations d'identification de l' AWS utilisateur que vous avez créé dans[Création et configuration d'un AWS compte](dev-tester-ui-prereqs.md#ui-config-aws-account). Vous pouvez spécifier vos informations d'identification de deux manières :
+ Dans un fichier d'informations d'identification
+ En tant que variables d'environnement
### Configuration des AWS informations d'identification à l'aide d'un fichier d'identification
IDT utilise le même fichier d'informations d'identification que l' AWS CLI. Pour de plus amples informations, veuillez consulter [Fichiers de configuration et d'informations d'identification](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).
L'emplacement du fichier d'informations d'identification varie en fonction du système d'exploitation que vous utilisez :
+ macOS, Linux : `~/.aws/credentials`
+ Windows: `C:\Users\UserName\.aws\credentials`
Ajoutez vos AWS informations d'identification au `credentials` fichier au format suivant :
```
[default]
aws_access_key_id =
aws_secret_access_key =
```
**Note**
Si vous n'utilisez pas le `default` AWS profil, veillez à spécifier le nom du profil dans l'interface utilisateur IDT-FreeRTOS. Pour plus d'informations sur les profils, consultez [Configuration et paramètres des fichiers d'identification](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).
### Configurer les AWS informations d'identification avec des variables d'environnement
Les variables d'environnement sont des variables gérées par le système d'exploitation et utilisées par les commandes du système. Ils ne sont pas enregistrés si vous fermez la session SSH. L'interface utilisateur IDT-FreeRTOS utilise les variables d'`AWS_SECRET_ACCESS_KEY`environnement `AWS_ACCESS_KEY_ID` et pour stocker vos informations d'identification. AWS
Pour définir ces variables sous Linux, macOS ou Unix, utilisez **export**:
```
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
```
Pour définir ces variables sous Windows, utilisez **set** :
```
set AWS_ACCESS_KEY_ID=
set AWS_SECRET_ACCESS_KEY=
```
## Ouvrez l'interface utilisateur IDT-Freertos
**Pour ouvrir l'interface utilisateur IDT-FreeRTOS**
1. Téléchargez une version IDT-FreeRTOS compatible et extrayez l'archive téléchargée dans un emplacement de votre système de fichiers où vous disposez d'autorisations de lecture et d'écriture.
1. Exécutez la commande suivante pour accéder au répertoire d'installation d'IDT-FreeRTOS :
```
cd devicetester-extract-location/bin
```
1. Exécutez la commande suivante pour ouvrir l'interface utilisateur IDT-FreeRTOS :
------
#### [ Linux ]
```
.devicetestergui_linux_x86-64.exe
```
------
#### [ Windows ]
```
./devicetestergui_win_x64-64
```
------
#### [ macOS ]
```
./devicetestergui_mac_x86-64
```
**Note**
Sur Mac, pour autoriser votre système à exécuter l'interface utilisateur, accédez à **Préférences système -> Sécurité et confidentialité**. Lorsque vous exécutez les tests, il se peut que vous deviez le faire trois fois de plus.
------
L'interface utilisateur d'IDT-Freertos s'ouvre dans votre navigateur par défaut. Pour plus d'informations sur les navigateurs pris en charge, consultez[Utiliser un navigateur Web compatible](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser).
## Création d'une nouvelle configuration
Si vous utilisez IDT-FreeRTOS pour la première fois, vous devez créer une nouvelle configuration pour configurer les fichiers de configuration JSON dont IDT-FreeRTOS a besoin pour exécuter des tests. Vous pouvez ensuite exécuter des tests ou modifier la configuration créée.
Pour des exemples de `userdata.json` fichiers, et`config.json`,,,`device.json`,,,,,,,,,,[Premier test de votre carte microcontrôleur](qual-steps.md),, Pour un exemple de `resource.json` fichier utilisé uniquement pour exécuter des tests Bluetooth Low Energy (BLE), consultez[Exécuter des tests Bluetooth Low Energy](afr-bridgekeeper-dt-bt.md).
**Pour créer une nouvelle configuration**
1. **Dans l'interface utilisateur IDT-FreeRTOS, ouvrez le menu de navigation, puis choisissez Créer une nouvelle configuration.**
**Important**
Vous devez configurer vos AWS informations d'identification avant d'ouvrir l'interface utilisateur. Si vous n'avez pas configuré vos informations d'identification, fermez la fenêtre du navigateur de l'interface utilisateur IDT-FreeRTOS, suivez les étapes indiquées[Configurer les AWS informations d'identification](#configure-aws-credentials), puis rouvrez l'interface utilisateur d'IDT-FreeRTOS.
1. Suivez l'assistant de configuration pour saisir les paramètres de configuration IDT utilisés pour exécuter les tests de qualification. L'assistant configure les paramètres suivants dans les fichiers de configuration JSON situés dans le `devicetester-extract-location/config` répertoire.
+ **AWS paramètres** : Compte AWS informations utilisées par IDT-FreeRTOS pour créer des AWS ressources lors des tests. Ces paramètres sont configurés dans le `config.json` fichier.
+ Référentiel **FreeRTOS** : chemin absolu vers le référentiel FreeRTOS et le code porté, ainsi que le type de qualification que vous souhaitez effectuer. Ces paramètres sont configurés dans le `userdata.json` fichier.
Vous devez transférer FreeRTOS pour votre appareil avant de pouvoir exécuter des tests de qualification. Pour plus d'informations, consultez le guide de portage de [FreeRTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/)
+ **Build and flash** : commandes build et flash pour votre matériel qui permettent à IDT de créer et de tester automatiquement votre carte mère. Ces paramètres sont configurés dans le `userdata.json` fichier.
+ **Appareils** : paramètres du pool de périphériques pour les appareils à tester. Ces paramètres sont configurés dans `sku` les champs `id` et dans le `devices` bloc du pool de périphériques du `device.json` fichier.
+ **Mise en réseau** : paramètres permettant de tester la prise en charge des communications réseau pour vos appareils. Ces paramètres sont configurés dans le `features` bloc du `device.json` fichier et dans les `testWifiConfig` blocs `clientWifiConfig` et du `userdata.json` fichier.
+ **Serveur Echo** : paramètres de configuration du serveur Echo pour les tests de socket sécurisés. Ces paramètres sont configurés dans le `userdata.json` fichier.
Pour plus d'informations sur la configuration du serveur Echo, consultez[https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html).
+ **CMake**— (Facultatif) Les paramètres pour exécuter CMake les tests de fonctionnalité de compilation. Cette configuration n'est requise que si vous l'utilisez CMake comme système de compilation. Ces paramètres sont configurés dans le `userdata.json` fichier.
+ **BLE** —Paramètres permettant d'exécuter des tests de fonctionnalité Bluetooth Low Energy. Ces paramètres sont configurés dans le `features` bloc du `device.json` fichier et dans le `resource.json` fichier.
+ **OTA** : paramètres permettant d'exécuter des tests de fonctionnalité OTA. Ces paramètres sont configurés dans le `features` bloc du `device.json` fichier et dans le `userdata.json` fichier.
1. Sur la page **Révision**, vérifiez vos informations de configuration.
Après avoir passé en revue votre configuration, pour exécuter vos tests de qualification, choisissez **Run tests**.
## Modifier une configuration existante
Si vous avez déjà configuré des fichiers de configuration pour IDT, vous pouvez utiliser l'interface utilisateur IDT-FreeRTOS pour modifier votre configuration existante. Assurez-vous que vos fichiers de configuration existants sont disponibles dans le `devicetester-extract-location/config` répertoire.
**Pour modifier une nouvelle configuration**
1. **Dans l'interface utilisateur IDT-FreeRTOS, ouvrez le menu de navigation, puis choisissez Modifier la configuration existante.**
Le tableau de bord de configuration affiche des informations sur vos paramètres de configuration existants. Si une configuration est incorrecte ou indisponible, le statut de cette configuration est`Error validating configuration`.
1. Pour modifier un paramètre de configuration existant, procédez comme suit :
1. Choisissez le nom d'un paramètre de configuration pour ouvrir sa page de paramètres.
1. Modifiez les paramètres, puis choisissez **Enregistrer** pour régénérer le fichier de configuration correspondant.
Une fois que vous avez terminé de modifier votre configuration, vérifiez que tous vos paramètres de configuration sont validés. Si le statut de chaque paramètre de configuration est`Valid`, vous pouvez exécuter vos tests de qualification à l'aide de cette configuration.
## Exécuter des tests de qualification
Après avoir créé une configuration pour IDT-Freertos, vous pouvez exécuter vos tests de qualification.
**Pour exécuter des tests de qualification**
1. Validez votre configuration.
1. Dans le menu de navigation, choisissez **Exécuter des tests**.
1. Pour démarrer le test, choisissez **Démarrer les tests**.
**IDT-FreeRTOS exécute les tests de qualification et affiche le résumé des tests ainsi que les éventuelles erreurs dans la console Test Runner.** Une fois le test terminé, vous pouvez consulter les résultats du test et les journaux depuis les emplacements suivants :
+ Les résultats des tests se trouvent dans le `devicetester-extract-location/results/execution-id` répertoire.
+ Les journaux de test se trouvent dans le `devicetester-extract-location/results/execution-id/logs` répertoire.
Pour plus d'informations sur les résultats des tests et les journaux, consultez [Afficher les résultats de l'IDT pour FreeRTOS](view-results-frq.md) et[Afficher les logs IDT pour FreeRTOS](view-logs-frq.md).