As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Executar o pacote de qualificação do FreeRTOS
Você usa o executável AWS IoT Device Tester for FreeRTOS para interagir com o IDT for FreeRTOS. Os exemplos de linha de comando a seguir mostram como executar os testes de qualificação para um grupo de dispositivos (um conjunto de dispositivos idênticos).
------
#### [ 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
```
Executa um conjunto de testes em um grupo de dispositivos. O arquivo `userdata.json` deve estar localizado no diretório `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/`.
**nota**
Se estiver executando o IDT para FreeRTOS no Windows, use barras (/) para especificar o caminho até o arquivo `userdata.json`.
Use o seguinte comando para executar um grupo de testes específico:
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1.0.1 \
--group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
Os parâmetros `suite-id` e `pool-id` são opcionais se você estiver executando um único conjunto de testes em um único grupo de dispositivos (ou seja, você tem apenas um grupo de dispositivos definido no arquivo `device.json`).
Use o seguinte comando para executar um caso de teste em um grupo de testes:
```
devicetester_[linux | mac | win_x86-64] run-suite \
--group-id group-id \
--test-id test-id
```
Você pode usar o comando `list-test-cases` para listar os casos de teste em um grupo de testes. Opções de linhas de comando do IDT para FreeRTOS
**group-id**
(Opcional) Os grupos de testes a serem executados, como uma lista separada por vírgulas. Se não for especificado, o IDT executará todos os grupos de testes no conjunto de testes.
**pool-id**
(Opcional) O grupo de dispositivos a ser testado. Isso será necessário se você definir vários grupos de dispositivos no `device.json`. Se você tiver apenas um grupo de dispositivos, poderá omitir essa opção.
**suite-id**
(Opcional) A versão do conjunto de testes a ser executada. Se não for especificada, o IDT usará a versão mais recente no diretório de testes em seu sistema.
Começando com o IDT v3.0.0, o IDT verifica se há conjuntos de testes mais recentes online. Para obter mais informações, consulte [Versões do pacote de testes](idt-test-suite-versions.md).
**test-id**
(Opcional) Os testes a serem executados, como uma lista separada por vírgulas. Se especificado, `group-id` deve especificar um único grupo.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
**update-idt**
(Opcional) Se este parâmetro não estiver definido e houver uma versão mais recente do IDT disponível, será solicitado atualizar o IDT. Se esse parâmetro for definido como `Y`, o IDT interromperá a execução do teste se detectar que uma versão mais recente está disponível. Se esse parâmetro for definido como `N`, o IDT continuará a execução do teste.
**update-managed-policy**
(Opcional) Se esse parâmetro não for usado e o IDT detectar que sua política gerenciada não é up-to-date, você será solicitado a atualizar sua política gerenciada. Se esse parâmetro for definido como`Y`, o IDT interromperá a execução do teste se detectar que sua política gerenciada não está. up-to-date Se esse parâmetro for definido como `N`, o IDT continuará a execução do teste.
**upgrade-test-suite**
(Opcional) Se não for usado e uma versão mais recente do conjunto de testes estiver disponível, você será solicitado a fazer download. Para ocultar o prompt, especifique `y` para sempre fazer download do conjunto de testes mais recente, ou `n` para usar o conjunto de testes especificado ou a versão mais recente em seu sistema.
**Example**
**Exemplo**
Para sempre fazer download e usar o conjunto de testes mais recente, use o seguinte comando.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite y
```
Para usar o conjunto de testes mais recente em seu sistema, use o seguinte comando.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite n
```
**h**
Use a opção de ajuda para saber mais sobre as opções de `run-suite`.
**Example**
**Exemplo**
```
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
```
O arquivo `userdata.json` deve estar localizado no diretório `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/`.
**nota**
Se você estiver executando o IDT para FreeRTOS no Windows, use barras (/) para especificar o caminho até o arquivo `userdata.json`.
Use o seguinte comando para executar um grupo de testes específico.
```
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` são opcionais se você estiver executando um único conjunto de testes em um único grupo de dispositivos (ou seja, você tem apenas um grupo de dispositivos definido no arquivo `device.json`).Opções de linhas de comando do IDT para FreeRTOS
**group-id**
(Opcional) Especifica o grupo de testes.
**pool-id**
Especifica o grupo de dispositivos para testar. Se você tiver apenas um grupo de dispositivos, poderá omitir essa opção.
**suite-id**
(Opcional) Especifica o conjunto de testes a ser executado.
------
## Comandos do IDT para FreeRTOS
O comando do IDT para FreeRTOS é compatível com as seguintes operações:
------
#### [ IDT v3.0.0 and later ]
**`help`**
Lista as informações sobre o comando especificado.
**`list-groups`**
Lista os grupos em um determinado conjunto.
**`list-suites`**
Lista os conjuntos disponíveis.
**`list-supported-products`**
Lista os produtos compatíveis e as versões do conjunto de testes.
**`list-supported-versions`**
Lista as versões do FreeRTOS e do pacote de teste compatíveis com a versão atual do IDT.
**`list-test-cases`**
Lista os casos de teste em um grupo especificado.
**`run-suite`**
Executa um conjunto de testes em um grupo de dispositivos.
Use a opção `--suite-id` para especificar uma versão do conjunto de testes, ou omiti-la para usar a versão mais recente em seu sistema.
Use o `--test-id` para executar um caso de teste individual.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
Para obter uma lista completa de opções, consulte [Executar o pacote de qualificação do FreeRTOS](#run-tests).
Começando com o IDT v3.0.0, o IDT verifica se há conjuntos de testes mais recentes online. Para obter mais informações, consulte [Versões do pacote de testes](idt-test-suite-versions.md).
------
#### [ IDT v1.7.0 and earlier ]
**`help`**
Lista as informações sobre o comando especificado.
**`list-groups`**
Lista os grupos em um determinado conjunto.
**`list-suites`**
Lista os conjuntos disponíveis.
**`run-suite`**
Executa um conjunto de testes em um grupo de dispositivos.
------
## Teste para requalificação
À medida que novas versões de testes de qualificação do IDT para FreeRTOS são lançadas, ou ao atualizar os pacotes ou drivers de dispositivo específicos da placa, você pode usar o IDT para FreeRTOS para testar as placas do microcontrolador. Para qualificações subsequentes, certifique-se de que tem as versões mais recentes do FreeRTOS e do IDT para FreeRTOS e execute os testes de qualificação novamente.