

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Inizia con l'interfaccia utente IDT-FreeRTOS
<a name="dev-tester-ui-getting-started"></a>

Questa sezione mostra come utilizzare l' IDT-FreeRTOS interfaccia utente per creare o modificare la configurazione, quindi mostra come eseguire i test. 

**Topics**
+ [Configura AWS credenziali](#configure-aws-credentials)
+ [Apri l'interfaccia utente IDT-FreeRTOS](#open-idt-ui)
+ [Creare una nuova configurazione](#create-new-configuration)
+ [Modifica una configurazione esistente](#modify-existing-configuration)
+ [Esegui test di qualificazione](#run-tests-from-ui)

## Configura AWS credenziali
<a name="configure-aws-credentials"></a>

È necessario configurare le credenziali per l' AWS utente in [Creare e configurare un AWS account](dev-tester-ui-prereqs.md#ui-config-aws-account) cui è stato creato. Puoi specificare le credenziali in uno dei due modi seguenti:
+ In un file di credenziali
+ Come variabili di ambiente

### Configura AWS credenziali con un file di credenziali
<a name="config-cred-file"></a>

IDT usa lo stesso file delle credenziali di AWS CLI. Per ulteriori informazioni, consulta l'argomento relativo ai [file di configurazione e delle credenziali](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).

La posizione del file delle credenziali varia a seconda del sistema operativo in uso:
+ macOS, Linux: `~/.aws/credentials`
+ Windows: `C:\Users\{{UserName}}\.aws\credentials`

Aggiungi AWS le tue credenziali al `credentials` file nel seguente formato:

```
[default]
aws_access_key_id = {{<your_access_key_id>}}
aws_secret_access_key = {{<your_secret_access_key>}}
```

**Nota**  
Se non utilizzi il `default` AWS profilo, assicurati di specificarne il nome nell' IDT-FreeRTOS interfaccia utente. Per ulteriori informazioni sui profili, consulta [Configurazione e impostazioni dei file di credenziali](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).

### Configura AWS credenziali con variabili di ambiente
<a name="config-env-vars"></a>

Le variabili di ambiente sono variabili gestite dal sistema operativo e utilizzate dai comandi di sistema. Non vengono salvate se si chiude la sessione SSH. L' IDT-FreeRTOS interfaccia utente utilizza le variabili di `AWS_SECRET_ACCESS_KEY` ambiente `AWS_ACCESS_KEY_ID` e per memorizzare le AWS credenziali.

Per impostare queste variabili su Linux, macOS o Unix, utilizza **export**:

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

Per impostare queste variabili su Windows, utilizza **set**:

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

## Apri l'interfaccia utente IDT-FreeRTOS
<a name="open-idt-ui"></a>

**Per aprire l' IDT-FreeRTOS interfaccia utente**

1. Scarica una IDT-FreeRTOS versione supportata ed estrai l'archivio scaricato in una posizione del file system in cui disponi delle autorizzazioni di lettura e scrittura.

1. Eseguite il comando seguente per accedere alla directory IDT-FreeRTOS di installazione:

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

1. Esegui il comando seguente per aprire l' IDT-FreeRTOS interfaccia utente:

------
#### [ Linux ]

   ```
   .devicetestergui_linux_x86-64.exe
   ```

------
#### [ Windows ]

   ```
   ./devicetestergui_win_x64-64
   ```

------
#### [ macOS ]

   ```
   ./devicetestergui_mac_x86-64
   ```

**Nota**  
Su Mac, per consentire al sistema di eseguire l'interfaccia utente, vai a **Preferenze di sistema -> Sicurezza e privacy**. Quando esegui i test, potresti dover eseguire questa operazione altre tre volte.

------

   L' IDT-FreeRTOS interfaccia utente si apre nel browser predefinito. Per informazioni sui browser supportati, consulta[Utilizza un browser Web supportato](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser).

## Creare una nuova configurazione
<a name="create-new-configuration"></a>

Se sei un utente alle prime armi, devi creare una nuova configurazione per configurare i file di configurazione JSON che IDT-FreeRTOS richiedono l'esecuzione dei test. Puoi quindi eseguire test o modificare la configurazione creata.

Per alcuni esempi dei `userdata.json` file `config.json``device.json`, and, vedi[Primo test della scheda del microcontrollore](qual-steps.md). Per un esempio del `resource.json` file utilizzato solo per eseguire i test Bluetooth Low Energy (BLE), vedere[Esegui i test Bluetooth Low Energy](afr-bridgekeeper-dt-bt.md).

**Per creare una nuova configurazione**

1. Nell' IDT-FreeRTOS interfaccia utente, apri il menu di navigazione, quindi scegli **Crea nuova configurazione**.
**Importante**  
È necessario configurare le AWS credenziali prima di aprire l'interfaccia utente. Se non hai configurato le credenziali, chiudi la finestra del browser dell' IDT-FreeRTOS interfaccia utente, segui i passaggi indicati e riapri l'interfaccia utente. [Configura AWS credenziali](#configure-aws-credentials) IDT-FreeRTOS 

1. Segui la procedura guidata di configurazione per accedere alle impostazioni di configurazione IDT utilizzate per eseguire i test di qualificazione. La procedura guidata configura le seguenti impostazioni nei file di configurazione JSON che si trovano nella directory. `{{devicetester-extract-location}}/config`
   + **AWS settings: le** Account AWS informazioni IDT-FreeRTOS utilizzate per creare AWS risorse durante le esecuzioni dei test. Queste impostazioni sono configurate nel `config.json` file.
   + Repository **FreerTOS**: il percorso assoluto verso il repository FreerTOS e il codice portato e il tipo di qualifica che desideri eseguire. Queste impostazioni sono configurate nel file. `userdata.json`

     Devi portare FreerTOS sul tuo dispositivo prima di poter eseguire i test di qualificazione. Per ulteriori informazioni, consulta la [FreerTOS Porting Guide](https://docs.aws.amazon.com/freertos/latest/portingguide/)
   + **Build and flash**: i comandi build e flash per l'hardware che consentono a IDT di creare e eseguire test flash sulla scheda in modo automatico. Queste impostazioni sono configurate nel file. `userdata.json`
   + **Dispositivi**: le impostazioni del pool di dispositivi per i dispositivi da testare. Queste impostazioni sono configurate nei `sku` campi `id` e nel `devices` blocco per il pool di dispositivi nel `device.json` file.
   + **Rete**: le impostazioni per testare il supporto delle comunicazioni di rete per i dispositivi. Queste impostazioni sono configurate nel `features` blocco del `device.json` file e nei `testWifiConfig` blocchi `clientWifiConfig` and del `userdata.json` file.
   + **Echo server**: le impostazioni di configurazione del server echo per i test Secure Socket. Queste impostazioni sono configurate nel file. `userdata.json`

     Per ulteriori informazioni sulla configurazione del server echo, vedere[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** — (Facoltativo) Le impostazioni per eseguire i test di funzionalità di compilazione di CMake. Questa configurazione è richiesta solo se utilizzi CMake come sistema di compilazione. Queste impostazioni sono configurate nel `userdata.json` file.
   + **BLE**: le impostazioni per eseguire i test di funzionalità Bluetooth Low Energy. Queste impostazioni sono configurate nel `features` blocco del `device.json` file e nel `resource.json` file.
   + **OTA**: le impostazioni per eseguire i test di funzionalità OTA. Queste impostazioni sono configurate nel `features` blocco del `device.json` file e nel `userdata.json` file.

1.  Nella pagina **Revisione**, verifica le informazioni di configurazione. 

Dopo aver esaminato la configurazione, per eseguire i test di qualificazione, scegli **Esegui test**.

## Modifica una configurazione esistente
<a name="modify-existing-configuration"></a>

Se hai già configurato i file di configurazione per IDT, puoi utilizzare l' IDT-FreeRTOS interfaccia utente per modificare la configurazione esistente. Assicurati che i file di configurazione esistenti siano disponibili nella `{{devicetester-extract-location}}/config` directory.

**Per modificare una nuova configurazione**

1. Nell' IDT-FreeRTOS interfaccia utente, apri il menu di navigazione, quindi scegli **Modifica configurazione esistente**.

   La dashboard di configurazione mostra informazioni sulle impostazioni di configurazione esistenti. Se una configurazione è errata o non disponibile, lo stato di tale configurazione è`Error validating configuration`.

1. Per modificare un'impostazione di configurazione esistente, completare i seguenti passaggi: 

   1. Scegli il nome di un'impostazione di configurazione per aprire la relativa pagina delle impostazioni.

   1. Modifica le impostazioni, quindi scegli **Salva** per rigenerare il file di configurazione corrispondente.

Dopo aver modificato la configurazione, verifica che tutte le impostazioni di configurazione superino la convalida. Se lo stato di ogni impostazione di configurazione è`Valid`, puoi eseguire i test di qualificazione utilizzando questa configurazione.

## Esegui test di qualificazione
<a name="run-tests-from-ui"></a>

Dopo aver creato una configurazione per IDT-FreeRTOS, puoi eseguire i test di qualificazione.

**Per eseguire test di qualificazione**

1. Convalida la tua configurazione.

1. Nel menu di navigazione, scegli **Esegui test**.

1. Per iniziare l'esecuzione del test, scegli **Avvia test**.

IDT-FreeRTOS esegue i test di qualificazione e visualizza il riepilogo dei test eseguiti e gli eventuali errori nella console **Test runner**. Al termine dell'esecuzione del test, è possibile visualizzare i risultati e i log del test dalle seguenti posizioni: 
+ I risultati dei test si trovano nella `{{devicetester-extract-location}}/results/{{execution-id}}` directory.
+ I registri dei test si trovano nella `{{devicetester-extract-location}}/results/{{execution-id}}/logs` directory.

Per ulteriori informazioni sui risultati e sui registri dei test, vedere [Visualizza i risultati di IDT for FreerTOS](view-results-frq.md) e. [Visualizza i log di IDT for FreerTOS](view-logs-frq.md)