

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'interfaccia utente IDT-FreeRTOS per creare o modificare la configurazione, quindi mostra come eseguire i test. 

**Topics**
+ [

## Configura le credenziali AWS
](#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 le credenziali AWS
<a name="configure-aws-credentials"></a>

È necessario configurare le credenziali per l' AWS utente in [Creare e configurare un account AWS](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 le 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 usi il `default` AWS profilo, assicurati di specificare il nome del profilo nell'interfaccia utente IDT-FreeRTOS. Per ulteriori informazioni sui profili, vedere [Configurazione e impostazioni](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) dei file di credenziali.

### Configura AWS le 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'interfaccia utente IDT-FreeRTOS utilizza le variabili di `AWS_SECRET_ACCESS_KEY` ambiente `AWS_ACCESS_KEY_ID` e per memorizzare le credenziali. AWS 

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'interfaccia utente di IDT-FreeRTOS**

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

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

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

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

------
#### [ 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 su **Preferenze di Sistema ->** Sicurezza e privacy. Quando esegui i test, potresti dover eseguire questa operazione altre tre volte.

------

   L'interfaccia utente IDT-FreeRTOS si apre nel browser predefinito. Per informazioni sui browser supportati, vedere. [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 richiesti da IDT-FreeRTOS per eseguire i test. È quindi possibile eseguire test o modificare la configurazione creata.

Per esempi dei `userdata.json` file, e`config.json`,`device.json`,,,,, 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'interfaccia utente di IDT-FreeRTOS, 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 tue credenziali, chiudi la finestra del browser dell'interfaccia utente IDT-FreeRTOS, segui i passaggi indicati e riapri l'interfaccia utente di IDT-FreeRTOS. [Configura le credenziali AWS](#configure-aws-credentials)

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 che IDT-FreeRTOS utilizza per creare AWS risorse durante le esecuzioni dei test. Queste impostazioni sono configurate nel file. `config.json`
   + 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à della CMake build. 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à impostato i file di configurazione per IDT, puoi utilizzare l'interfaccia utente IDT-FreeRTOS per modificare la configurazione esistente. Assicuratevi che i file di configurazione esistenti siano disponibili nella directory. `devicetester-extract-location/config`

**Per modificare una nuova configurazione**

1. **Nell'interfaccia utente IDT-FreeRTOS, 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.** Una volta completata l'esecuzione del test, è possibile visualizzare i risultati e i registri 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)