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à.
# Esegui la suite di qualificazione FreerTOS
Si utilizza l'eseguibile AWS IoT Device Tester for FreeRTOS per interagire con IDT for FreerTOS. Gli esempi della riga di comando seguenti illustrano come eseguire i test di qualifica per un pool di dispositivi (serie di dispositivi identici).
------
#### [ 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
```
Esegue una suite di test in un determinato pool di dispositivi. Il file `userdata.json` si deve trovare nella directory `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/`.
**Nota**
Se stai usando IDT for FreerTOS su Windows, usa le barre (/) per specificare il percorso del file. `userdata.json`
Utilizza il comando seguente per eseguire un gruppo di test specifico:
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1.0.1 \
--group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
I parametri `suite-id` e `pool-id` sono facoltativi se esegui una singola suite di test su un singolo pool di dispositivi (ovvero nel tuo file `device.json` c'è un solo pool di dispositivi definito).
Utilizza il comando seguente per eseguire un caso di test specifico in un gruppo di test:
```
devicetester_[linux | mac | win_x86-64] run-suite \
--group-id group-id \
--test-id test-id
```
Puoi utilizzare il comando `list-test-cases` per elencare i casi di test in un gruppo di test. IDT per le opzioni della riga di comando di FreerTOS
**group-id**
(Facoltativo) I gruppi di test da eseguire, come elenco con valori separati da virgole. Se non specificato, IDT esegue tutti i gruppi di test nella suite di test.
**pool-id**
(Facoltativo) Il pool di dispositivi da testare. Questo è necessario se si definiscono più pool di dispositivi in `device.json`. Se hai un solo pool di dispositivi, questa opzione può essere omessa.
**suite-id**
(Facoltativo) Versione della suite di test da eseguire. Se non specificato, IDT utilizza la versione più recente nella directory dei test del sistema.
A partire da IDT v3.0.0, IDT controlla online le suite di test più recenti. Per ulteriori informazioni, consulta [Versioni della suite di test](idt-test-suite-versions.md).
**test-id**
(Facoltativo) I test da eseguire, come elenco con valori separati da virgole. Se specificato, `group-id` deve includere un singolo gruppo.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
**update-idt**
(Facoltativo) Se questo parametro non è impostato ed è disponibile una versione IDT più recente, ti verrà richiesto di aggiornare IDT. Se questo parametro è impostato su`Y`, IDT interromperà l'esecuzione del test se rileva che è disponibile una versione più recente. Se questo parametro è impostato su`N`, IDT continuerà l'esecuzione del test.
**update-managed-policy**
(Facoltativo) Se questo parametro non viene utilizzato e IDT rileva che la tua politica gestita non lo è up-to-date, ti verrà richiesto di aggiornare la politica gestita. Se questo parametro è impostato su`Y`, IDT interromperà l'esecuzione del test se rileva che la politica gestita non lo è. up-to-date Se questo parametro è impostato su`N`, IDT continuerà l'esecuzione del test.
**upgrade-test-suite**
(Facoltativo) Se non utilizzato ed è disponibile una versione più recente della suite di test, viene richiesto di scaricarla. Per nascondere il prompt, specifica `y` per scaricare sempre la suite di test più recente o `n` per utilizzare la suite di test specificata o l'ultima versione nel sistema.
**Example**
**Esempio**
Per scaricare e utilizzare sempre la suite di test più recente, utilizza il seguente comando.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite y
```
Per utilizzare la suite di test più recente nel sistema, utilizza il seguente comando.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite n
```
**h**
Utilizza l'opzione di aiuto per ulteriori informazioni sulle opzioni `run-suite`.
**Example**
**Esempio**
```
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
```
Il file `userdata.json` deve trovarsi nella directory `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/`.
**Nota**
Se stai usando IDT for FreerTOS su Windows, usa le barre (/) per specificare il percorso del file. `userdata.json`
Utilizza il comando seguente per eseguire un gruppo di test specifico.
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1 --group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
`suite-id` e `pool-id` sono facoltativi se esegui una singola suite di test su un singolo pool di dispositivi (ovvero nel tuo file `device.json` c'è un solo pool di dispositivi definito).IDT per le opzioni della riga di comando di FreerTOS
**group-id**
(Facoltativo) Specifica il gruppo di test.
**pool-id**
Specifica il pool di dispositivi da testare. Se hai un solo pool di dispositivi, questa opzione può essere omessa.
**suite-id**
(Facoltativo) Specifica la suite di test da eseguire.
------
## Comandi IDT per FreerTOS
Il comando IDT for FreerTOS supporta le seguenti operazioni:
------
#### [ IDT v3.0.0 and later ]
**`help`**
Elenca le informazioni sul comando specificato.
**`list-groups`**
Elenca i gruppi in una determinata suite.
**`list-suites`**
Elenca le suite disponibili.
**`list-supported-products`**
Elenca i prodotti e le versioni della suite di test supportati.
**`list-supported-versions`**
Elenca le versioni di FreerTOS e della suite di test supportate dalla versione IDT corrente.
**`list-test-cases`**
Elenca i casi di test in un gruppo specificato.
**`run-suite`**
Esegue una suite di test in un determinato pool di dispositivi.
Utilizza l'opzione `--suite-id` per specificare una versione della suite di test oppure omettila per utilizzare la versione più recente nel sistema.
Utilizza `--test-id` per eseguire un singolo caso di test.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
Per l'elenco completo delle opzioni, consulta [Esegui la suite di qualificazione FreerTOS](#run-tests).
A partire da IDT v3.0.0, IDT controlla online le suite di test più recenti. Per ulteriori informazioni, consulta [Versioni della suite di test](idt-test-suite-versions.md).
------
#### [ IDT v1.7.0 and earlier ]
**`help`**
Elenca le informazioni sul comando specificato.
**`list-groups`**
Elenca i gruppi in una determinata suite.
**`list-suites`**
Elenca le suite disponibili.
**`run-suite`**
Esegue una suite di test in un determinato pool di dispositivi.
------
## Test di riqualifica
Man mano che vengono rilasciate nuove versioni di IDT per i test di qualificazione FreerTOS o quando aggiorni i pacchetti o i driver di dispositivo specifici della scheda, puoi utilizzare IDT per FreerTOS per testare le tue schede microcontrollori. Per le qualifiche successive, assicurati di disporre delle versioni più recenti di FreeRTOS e IDT for FreerTOS ed esegui nuovamente i test di qualificazione.