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.

# Démarrez avec l' IDT-FreeRTOS interface utilisateur
<a name="dev-tester-ui-getting-started"></a>

Cette section explique comment utiliser l' IDT-FreeRTOS interface utilisateur pour créer ou modifier votre configuration, puis comment exécuter des tests. 

**Topics**
+ [Configurer AWS informations d’identification](#configure-aws-credentials)
+ [Ouvrez l' IDT-FreeRTOS interface utilisateur](#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 AWS informations d’identification
<a name="configure-aws-credentials"></a>

Vous devez configurer les informations d'identification pour l' AWS utilisateur que vous avez créé dans[Créez et configurez 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

### Configurer AWS informations d'identification avec un fichier d'informations d'identification
<a name="config-cred-file"></a>

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 = {{<your_access_key_id>}}
aws_secret_access_key = {{<your_secret_access_key>}}
```

**Note**  
Si vous n'utilisez pas le `default` AWS profil, veillez à spécifier le nom du profil dans l' IDT-FreeRTOS interface utilisateur. Pour plus d'informations sur les profils, voir [ Configuration et paramètres ](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) du fichier d'informations d'identification.

### Configurer AWS informations d'identification avec variables d'environnement
<a name="config-env-vars"></a>

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' IDT-FreeRTOS interface utilisateur utilise les variables d'`AWS_SECRET_ACCESS_KEY`environnement `AWS_ACCESS_KEY_ID` et pour stocker vos AWS informations d'identification.

Pour définir ces variables sous Linux, macOS ou Unix, utilisez **export**:

```
export AWS_ACCESS_KEY_ID={{<your_access_key_id>}}
export AWS_SECRET_ACCESS_KEY={{<your_secret_access_key>}}
```

Pour définir ces variables sous Windows, utilisez **set** :

```
set AWS_ACCESS_KEY_ID={{<your_access_key_id>}}
set AWS_SECRET_ACCESS_KEY={{<your_secret_access_key>}}
```

## Ouvrez l' IDT-FreeRTOS interface utilisateur
<a name="open-idt-ui"></a>

**Pour ouvrir l' IDT-FreeRTOS interface utilisateur **

1. Téléchargez une IDT-FreeRTOS version prise en charge et extrayez l'archive téléchargée dans un emplacement de votre système de fichiers où vous disposez des autorisations de lecture et d'écriture.

1. Exécutez la commande suivante pour accéder au répertoire IDT-FreeRTOS d'installation :

   ```
   cd {{devicetester-extract-location}}/bin 
   ```

1. Exécutez la commande suivante pour ouvrir l' IDT-FreeRTOS interface utilisateur :

------
#### [ 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écuterez les tests, vous devrez peut-être le faire trois fois de plus.

------

   L' IDT-FreeRTOS interface utilisateur 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
<a name="create-new-configuration"></a>

Si vous utilisez pour la première fois, vous devez créer une nouvelle configuration pour configurer les fichiers de configuration JSON qui IDT-FreeRTOS nécessitent l'exécution de tests. Vous pouvez ensuite exécuter des tests ou modifier la configuration créée.

Pour des exemples de `userdata.json` fichiers `config.json``device.json`, et, consultez[Premier test de votre carte à microcontrôleur](qual-steps.md). Pour obtenir un exemple de `resource.json` fichier utilisé uniquement pour exécuter des tests Bluetooth Low Energy (BLE), consultez[Exécutez des tests Bluetooth Low Energy](afr-bridgekeeper-dt-bt.md).

**Pour créer une nouvelle configuration **

1. Dans l' IDT-FreeRTOS interface utilisateur, 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' IDT-FreeRTOS interface utilisateur, suivez les étapes [Configurer AWS informations d’identification](#configure-aws-credentials) décrites, puis rouvrez l' IDT-FreeRTOS interface utilisateur.

1. Suivez l'assistant de configuration pour entrer 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 IDT-FreeRTOS utilisées 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 transféré, ainsi que le type de qualification que vous souhaitez effectuer. Ces paramètres sont configurés dans le `userdata.json` fichier.

     Vous devez porter FreeRTOS sur votre appareil avant de pouvoir effectuer des tests de qualification. Pour plus d'informations, consultez le Guide de portage de [ FreeRTOS ](https://docs.aws.amazon.com/freertos/latest/portingguide/)
   + **Générer et ** flasher : commandes de génération et de flash pour votre matériel qui permettent à IDT de créer et de flasher automatiquement des tests sur votre carte. Ces paramètres sont configurés dans le `userdata.json` fichier.
   + **Appareils ** : paramètres du pool d'appareils pour les appareils à tester. Ces paramètres sont configurés dans `sku` les champs `id` et dans le `devices` bloc correspondant au pool de périphériques du `device.json` fichier.
   + **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é. 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 les tests de fonctionnalité de compilation de CMake. Cette configuration n'est requise que si vous utilisez CMake comme système de compilation. Ces paramètres sont configurés dans le `userdata.json` fichier.
   + **BLE ** —Les 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 ** —Les 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 révisé votre configuration, pour exécuter vos tests de qualification, choisissez ** Exécuter les tests**.

## Modifier une configuration existante
<a name="modify-existing-configuration"></a>

Si vous avez déjà configuré des fichiers de configuration pour IDT, vous pouvez utiliser l' IDT-FreeRTOS interface utilisateur 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' IDT-FreeRTOS interface utilisateur, 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, son statut 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.

Après avoir modifié 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
<a name="run-tests-from-ui"></a>

Après avoir créé une configuration pour IDT-FreeRTOS, vous pouvez exécuter vos tests de qualification.

**Pour effectuer des tests de qualification **

1. Validez votre configuration.

1. Dans le menu de navigation, choisissez ** Exécuter les 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 et les éventuelles erreurs dans la ** console ** Test Runner. Une fois le test terminé, vous pouvez consulter les résultats et les journaux des tests aux 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 IDT for FreeRTOS](view-results-frq.md) et[Afficher les journaux IDT for FreeRTOS](view-logs-frq.md).