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á.
# Interface do usuário para o IDT para o pacote de qualificação FreeRTOS 2.0 (FRQ 2.0)
AWS IoT Device Tester para FreeRTOS (IDT for FreeRTOS) inclui uma interface de usuário (UI) baseada na web na qual você pode interagir com o aplicativo de linha de comando do IDT e os arquivos de configuração relacionados. Você usa a interface do IDT para FreeRTOS para criar uma nova configuração ou modificar uma existente para seu dispositivo. Você também pode usar a interface do usuário para chamar a aplicação IDT e executar os testes do FreeRTOS em seu dispositivo.
Para obter informações sobre o uso da linha de comando para executar os testes de qualificação, consulte [Primeiro teste da sua placa de microcontrolador](lts-qual-steps.md).
Esta seção descreve os pré-requisitos da interface do usuário do IDT para FreeRTOS e como executar testes de qualificação a partir da interface do usuário.
**Topics**
+ [Configurar os pré-requisitos do IDT](#lts-dev-tester-ui-prereqs)
+ [Configurar AWS credenciais para usar a interface de usuário do IDT](lts-configure-aws-credentials.md)
+ [Abrir a interface de usuário do IDT para FreeRTOS](lts-open-idt-ui.md)
+ [Criar uma configuração](lts-create-new-configuration.md)
+ [Modificar uma configuração existente](lts-modify-existing-configuration.md)
+ [Execute testes de qualificação](lts-run-tests-from-ui.md)
## Configurar os pré-requisitos do IDT
Para executar testes por meio da interface do usuário AWS IoT Device Tester (IDT) for FreeRTOS, você deve preencher os pré-requisitos na página do IDT FreeRTOS Qualification ([Configurar os pré-requisitos de qualificação LTS](lts-idt-dev-tester-prereqs.md)FRQ) 2.x.
# Configurar AWS credenciais para usar a interface de usuário do IDT
Você deve configurar suas credenciais de usuário do IAM para o AWS usuário que você criou. [Crie uma AWS conta](lts-idt-dev-tester-prereqs.md#lts-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
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ê usa:
+ **macOS e 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, deverá especificar o nome do perfil na interface de usuário do IDT para Freertos. 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-files.html).
## Configurar AWS credenciais com variáveis de ambiente
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 interface de usuário do IDT para FreeRTOS usa as variáveis de ambiente `AWS_SECRET_ACCESS_KEY` e `AWS_ACCESS_KEY_ID` para armazenar suas credenciais. AWS
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
```
# Abrir a interface de usuário do IDT para FreeRTOS
Este tópico explica como abrir a interface de usuário do IDT para FreeRTOS para usar o pacote de qualificações do FreeRTOS.
**Como abrir a interface de usuário do IDT para FreeRTOS**
1. Baixe um IDT compatível para a versão do FreeRTOS. Em seguida, extraia o arquivo baixado em um diretório para o qual você tenha permissões de leitura e gravação.
1. Navegue até o diretório da instalação do IDT para FreeRTOS:
```
cd devicetester-extract-location/bin
```
1. Execute o comando a seguir para abrir a interface de usuário do IDT para FreeRTOS:
------
#### [ Linux ]
```
.devicetester_ui_linux_x86-64
```
------
#### [ Windows ]
```
./devicetester_ui_win_x64-64
```
------
#### [ macOS ]
```
./devicetester_ui_mac_x86-64
```
**nota**
No macOS, 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-lo três vezes.
------
A interface de usuário do IDT para FreeRTOS é aberta em seu navegador padrão. As três versões principais mais recentes dos seguintes navegadores são compatíveis com a interface do usuário:
+ Google Chrome
+ Mozilla Firefox
+ Microsoft Edge
+ Apple Safari para macOS
**nota**
Para obter uma melhor experiência, recomendamos o Google Chrome ou o Mozilla Firefox para acessar a interface de usuário do IDT para FreeRTOS. O Microsoft Internet Explorer não é compatível com a interface do usuário.
**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 interface de usuário do IDT para FreeRTOS, siga as etapas em [Configurar AWS credenciais para usar a interface de usuário do IDT](lts-configure-aws-credentials.md) e reabra a interface de usuário do IDT para FreeRTOS.
# Criar uma configuração
Se você for um usuário iniciante, deverá criar uma nova configuração para definir os arquivos de configuração JSON que o IDT para FreeRTOS exige para executar 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](lts-qual-steps.md).
**Como criar uma configuração**
1. Na interface de usuário do IDT para FreeRTOS, abra o menu de navegação e escolha **Criar nova configuração**.
![\[Device Tester para interface do FreeRTOS com botão "Criar configuração" e informações sobre autoteste automatizado de microcontroladores.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-create-configuration.png)
1. Siga o assistente de configuração para inserir as configurações do IDT 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`.
+ **Configurações de 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 do grupo de **dispositivos** no arquivo `config.json`.
![\[Tela de configuração do Device Tester para o FreeRTOS com campos de identificador e SKU para configurar um pool de dispositivos, opções de configurações do dispositivo como método de conectividade, provisionamento de chave, configurações PKCS #11, campos de entrada de detalhes do dispositivo e controles para adicionar dispositivos ou identificadores.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-device-settings.png)
+ **AWS configurações da conta** — As Conta da AWS informações que o IDT para FreeRTOS usa para AWS criar recursos durante as execuções de teste. Essas configurações são definidas no arquivo `config.json`.
![\[Conta da AWS página de configurações com campos para região da conta, localização das credenciais como arquivo ou ambiente e nome do perfil\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-account-settings.png)
+ **Implementação do FreeRTOS**: o caminho absoluto para o repositório e o código transferido do FreeRTOS e a versão do FreeRTOS na qual você deseja executar o FRQ do IDT. Os caminhos para os arquivos de cabeçalho de configuração de execução e parâmetros do `FreeRTOS-Libraries-Integration-Tests` GitHub repositório. Compilar e instalar: os comandos 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`.
![\[Seção de configuração da implementação do FreeRTOS com caminhos de repositório, caminhos de execução de testes, versão do FreeRTOS, detalhes da ferramenta de compilação e configurações da ferramenta de gravação em flash.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-implementation-settings.png)
+ **Rótulos PKCS \$111 e servidor echo**: os rótulos [PKCS \$111](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-pkcs.html) que correspondem às chaves provisionadas em seu hardware com base na funcionalidade e no método de provisionamento de chaves. As configurações do servidor echo para os testes da Interface de transporte. Essas configurações são definidas nos arquivos `userdata.json` e `device.json`.
![\[Rótulos PKCS #11 e configurações do servidor Echo com campos de entrada para rótulos de chave, método de geração de chave e número da porta do servidor\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-pkcs11-settings.png)
+ **Over-the-air Atualizações (OTA) — As** configurações que controlam os testes de funcionalidade OTA. Essas configurações são definidas no bloco `features` dos arquivos `device.json` e `userdata.json`.
![\[Opções de configuração de atualização do OTA: ignorar testes, protocolos de dados, caminhos de firmware, caminho do certificado PAL, assinatura de código, hash/sign algoritmos, certificados do assinante, arquivo do certificado do trusted/untrusted assinante, compilar certificado do assinante, plataforma do assinante.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-ota-settings.png)
1. Na página **Revisar**, verifique suas informações de configuração.
![\[Caixa de diálogo de configuração criada para o Device Tester para o FreeRTOS, mostrando detalhes sobre a criação de uma configuração de teste com opções para editar ou executar testes.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/gsg-configuration-created.png)
Depois de concluir a revisão da configuração, para executar os testes de qualificação, escolha **Executar testes**.
# Modificar uma configuração existente
Se você já configurou arquivos de configuração do IDT para FreeRTOS, você pode usar a interface de usuário do IDT para FreeRTOS para modificar sua configuração existente. Os arquivos de configuração existentes devem estar localizados no diretório `devicetester-extract-location/config`.
**Como criar uma configuração**
1. Na interface de usuário do IDT para FreeRTOS, 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`.
![\[Tela de configuração com seções de dispositivo Conta da AWS, implementação de FreeRTOS, rótulos PKCS e servidor de eco over-the-air, atualizações e configurações de execução de teste mostrando status válido.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/modify-existing-configuration.png)
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.
1. Para modificar as configurações de execução de teste do IDT para FreeRTOS, escolha as **configurações de execução de teste do IDT** na visualização de edição:
![\[Caixa de diálogo de configurações de execução de testes do IDT com opções para seleção de testes, ignorar grupos de testes, multiplicador de tempo limite e interrupção na primeira falha.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/idt-testrun-settings.png)
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 com essa configuração.
# Execute testes de qualificação
Após criar uma configuração para a interface de usuário do IDT para FreeRTOS, é possível executar os testes de qualificação.
**Como executar testes de qualificação**
1. No menu de navegação, escolha **Executar testes**.
1. Escolha **Iniciar testes** para iniciar a execução do teste. Por padrão, todos os testes aplicáveis são executados para a configuração do seu dispositivo. O IDT para FreeRTOS gera um relatório de qualificação quando todos os testes terminam.
![\[A interface do Device Tester para FreeRTOS mostra que nenhum teste foi executado ainda, com opções para criar uma configuração, editar uma configuração existente e executar testes.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/idt-run-tests.png)
O IDT para FreeRTOS executa os testes de qualificação. Em seguida, ele exibe o resumo da execução do teste e todos os erros no console do **Executor de teste**. 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 o IDT gratuitamente RTOSresults](view-results-lts.md) e [Veja o IDT gratuitamente RTOSlogs](view-logs-lts.md).
![\[Log de execução do Device Tester para FreeRTOS exibindo testes aprovados, grupos de testes e caminhos dos arquivos de log e relatórios.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/idt-results.png)