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á.

# Comece a usar a IDT-FreeRTOS interface do usuário
<a name="dev-tester-ui-getting-started"></a>

Esta seção mostra como usar a IDT-FreeRTOS interface do usuário para criar ou modificar sua configuração e, em seguida, mostra como executar testes. 

**Topics**
+ [Configurar AWS credenciais](#configure-aws-credentials)
+ [Abra a IDT-FreeRTOS interface do usuário](#open-idt-ui)
+ [Criar uma configuração](#create-new-configuration)
+ [Modificar uma configuração existente](#modify-existing-configuration)
+ [Execute testes de qualificação](#run-tests-from-ui)

## Configurar AWS credenciais
<a name="configure-aws-credentials"></a>

Você deve configurar as credenciais para o AWS usuário que você criou em[Crie e configure um AWS account](dev-tester-ui-prereqs.md#ui-config-aws-account). Você pode especificar suas credenciais de uma das seguintes formas:
+ Em um arquivo de credenciais
+ Como variáveis de ambiente

### Configurar AWS credenciais com um arquivo de credenciais
<a name="config-cred-file"></a>

O IDT usa o mesmo arquivo de credenciais que a AWS CLI. Para obter mais informações, consulte [Arquivos de configuração e credenciais](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).

O local do arquivo de credenciais varia de acordo com o sistema operacional que você está usando:
+ macOS, Linux: `~/.aws/credentials`
+ Windows: `C:\Users\{{UserName}}\.aws\credentials`

Adicione suas AWS credenciais ao `credentials` arquivo no seguinte formato:

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

**nota**  
Se você não usar o `default` AWS perfil, certifique-se de especificar o nome do perfil na IDT-FreeRTOS interface do usuário. Para obter mais informações sobre perfis, consulte [Configurações de arquivos de configuração e credenciais](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).

### Configurar AWS credenciais com variáveis de ambiente
<a name="config-env-vars"></a>

As variáveis de ambiente são variáveis mantidas pelo sistema operacional e usadas pelos comandos do sistema. Elas não são salvas se você fechar a sessão SSH. A IDT-FreeRTOS interface do usuário usa as variáveis de `AWS_SECRET_ACCESS_KEY` ambiente `AWS_ACCESS_KEY_ID` e para armazenar suas AWS credenciais.

Para definir essas variáveis no Linux, macOS ou Unix, use :**export**

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

Para definir essas variáveis no Windows, use :**set**

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

## Abra a IDT-FreeRTOS interface do usuário
<a name="open-idt-ui"></a>

**Para abrir a IDT-FreeRTOS interface do usuário**

1. Baixe uma IDT-FreeRTOS versão compatível e extraia o arquivo baixado em um local em seu sistema de arquivos onde você tenha permissões de leitura e gravação.

1. Execute o comando a seguir para navegar até o diretório IDT-FreeRTOS de instalação:

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

1. Execute o comando a seguir para abrir a IDT-FreeRTOS interface do usuário:

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

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

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

   ```
   ./devicetestergui_win_x64-64
   ```

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

   ```
   ./devicetestergui_mac_x86-64
   ```

**nota**  
No Mac, para permitir que seu sistema execute a interface do usuário, acesse **Preferências do sistema -> Segurança e privacidade**. Ao executar os testes, é aconselhável repeti-los mais três vezes.

------

   A IDT-FreeRTOS interface do usuário é aberta no seu navegador padrão. Para obter informações sobre os navegadores compatíveis, consulte [Usar um navegador da web compatível](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser).

## Criar uma configuração
<a name="create-new-configuration"></a>

Se você for um usuário iniciante, deverá criar uma nova configuração para configurar os arquivos de configuração JSON IDT-FreeRTOS necessários para a execução de testes. Em seguida, você pode executar testes ou modificar a configuração criada.

Para obter exemplos dos arquivos `config.json`, `device.json` e `userdata.json`, consulte [Primeiro teste da sua placa de microcontrolador](qual-steps.md). Para obter um exemplo do arquivo `resource.json` usado somente para executar testes de Bluetooth Low Energy (BLE), consulte [Executar testes de Bluetooth Low Energy](afr-bridgekeeper-dt-bt.md).

**Como criar uma configuração**

1. Na IDT-FreeRTOS interface do usuário, abra o menu de navegação e escolha **Criar nova configuração**.
**Importante**  
Você deve configurar suas AWS credenciais antes de abrir a interface do usuário. Se você não configurou suas credenciais, feche a janela do navegador da IDT-FreeRTOS interface do usuário, siga as etapas e reabra a interface do IDT-FreeRTOS usuário. [Configurar AWS credenciais](#configure-aws-credentials)

1. Siga o assistente de configuração para inserir as configurações do IDT que são usadas para executar os testes de qualificação. O assistente define as seguintes configurações nos arquivos de configuração JSON localizados no diretório `{{devicetester-extract-location}}/config`.
   + **AWS settings** — Conta da AWS As informações IDT-FreeRTOS usadas para criar AWS recursos durante as execuções de teste. Essas configurações são definidas no arquivo `config.json`.
   + **Repositório FreeRTOS**: o caminho absoluto para o repositório e o código portado do FreeRTOS, e o tipo de qualificação que você deseja realizar. Essas configurações são definidas no arquivo `userdata.json`.

     Você deve transferir o FreeRTOS para o seu dispositivo antes de executar os testes de qualificação. Para obter mais informações, consulte o [Guia de portabilidade do FreeRTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/)
   + **Compilar e atualizar**: os comandos de compilação e atualização para seu hardware que permitem que o IDT compile e instale testes em sua placa automaticamente. Essas configurações são definidas no arquivo `userdata.json`.
   + **Dispositivos**: as configurações do grupo de dispositivos para os dispositivos a serem testados. Essas configurações são definidas nos campos `id` e `sku` no bloco `devices` do grupo de dispositivos no arquivo `device.json`.
   + **Rede**: as configurações para testar o suporte de comunicação de rede para seus dispositivos. Essas configurações são definidas no bloco `features` do arquivo `device.json` e nos blocos `clientWifiConfig` e `testWifiConfig` do arquivo `userdata.json`.
   + **Servidor echo**: as configurações do servidor echo para testes de soquete seguros. Essas configurações são definidas no arquivo `userdata.json`.

     Para obter mais informações sobre a configuração do servidor echo, consulte [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**: (opcional) as configurações para executar os testes de funcionalidade de compilação do CMake. Essa configuração é necessária somente se você estiver usando o CMake como sistema de compilação. Essas configurações são definidas no arquivo `userdata.json`.
   + **BLE**: as configurações para executar testes de funcionalidade Bluetooth Low Energy. Essas configurações são definidas no bloco `features` do arquivo `device.json` e no arquivo `resource.json`.
   + **OTA**: as configurações para executar testes de funcionalidade OTA. Essas configurações são definidas no bloco `features` do arquivo `device.json` e no arquivo `userdata.json`.

1.  Na página **Revisar**, verifique suas informações de configuração. 

Depois de concluir a revisão da configuração, para executar os testes de qualificação, escolha **Executar testes**.

## Modificar uma configuração existente
<a name="modify-existing-configuration"></a>

Se você já tiver configurado arquivos de configuração para o IDT, poderá usar a IDT-FreeRTOS interface do usuário para modificar sua configuração existente. Verifique se os arquivos de configuração existentes estão disponíveis no diretório `{{devicetester-extract-location}}/config`.

**Como modificar uma configuração nova**

1. Na IDT-FreeRTOS interface do usuário, abra o menu de navegação e escolha **Editar configuração existente**.

   O painel de configuração exibe informações sobre suas configurações existentes. Se uma configuração estiver incorreta ou indisponível, o status dessa configuração será `Error validating configuration`.

1. Para modificar uma configuração existente, conclua estas etapas: 

   1. Escolha o nome de uma configuração para abrir sua página de ajustes.

   1. Modifique as configurações e escolha **Salvar** para regenerar o arquivo de configuração correspondente.

Depois de concluir a modificação da configuração, verifique se todas as configurações passaram pela validação. Se o status de cada configuração for `Valid`, será possível executar seus testes de qualificação usando essa configuração.

## Execute testes de qualificação
<a name="run-tests-from-ui"></a>

Depois de criar uma configuração para IDT-FreeRTOS, você pode executar seus testes de qualificação.

**Como executar testes de qualificação**

1. Para validar a configuração.

1. No menu de navegação, escolha **Executar testes**.

1. Escolha **Iniciar testes** para iniciar a execução do teste.

IDT-FreeRTOS executa os testes de qualificação e exibe o resumo da execução do teste e quaisquer erros no console do **Test runner**. Depois que a execução do teste for concluída, você poderá visualizar os resultados e os logs do teste nos seguintes locais: 
+ Os resultados dos testes estão localizados no diretório `{{devicetester-extract-location}}/results/{{execution-id}}`.
+ Os logs de teste estão localizados no diretório `{{devicetester-extract-location}}/results/{{execution-id}}/logs`.

Para obter mais informações sobre os resultados de teste e logs, consulte [Veja os resultados do IDT para FreeRTOS](view-results-frq.md) e [Exibir os logs do IDT para FreeRTOS](view-logs-frq.md).