

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

# Configurar os pré-requisitos de qualificação 1.0
<a name="dev-tester-prereqs"></a>

Esta seção descreve os pré-requisitos para testar microcontroladores com. AWS IoT Device Tester

## Fazer download do FreeRTOS
<a name="download-afr"></a>

Você pode baixar uma versão do FreeRTOS com o seguinte [GitHub](https://github.com/aws/amazon-freertos)comando:

```
git clone --branch <{{FREERTOS_RELEASE_VERSION}}> --recurse-submodules https://github.com/aws/amazon-freertos.git
cd amazon-freertos
git submodule update --checkout --init --recursive
```

em que <FREERTOS\_RELEASE\_VERSION> é uma versão do FreeRTOS (por exemplo, 202007.00) correspondente a uma versão do IDT listada em [Versões compatíveis do AWS IoT Device Tester](dev-test-versions-afr.md). Isso garante que você tenha o código-fonte completo, incluindo submódulos, e esteja usando a versão correta do IDT para sua versão de FreeRTOS e vice-versa.

O Windows tem uma limitação de comprimento de caminho de 260 caracteres. A estrutura de caminho do FreeRTOS tem muitos níveis; portanto, se você estiver usando o Windows, mantenha os caminhos de arquivo dentro do limite de 260 caracteres. Por exemplo, clone o FreeRTOS para `C:\FreeRTOS` em vez de `C:\Users\username\programs\projects\myproj\FreeRTOS\`.

### Qualificação do FreeRTOS com bibliotecas LTS
<a name="lts-qualification-dev-tester-afr"></a>
+ Para que seu microcontrolador seja designado como compatível com versões de FreeRTOS baseadas em suporte de longo prazo (LTS) no AWS Partner Device Catalog, você deve fornecer um arquivo manifesto. Para obter mais informações, consulte a [Lista de verificação de qualificação do FreeRTOS](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afq-checklist.html) no *Guia de qualificação do FreeRTOS*.
+ Para validar se seu microcontrolador suporta versões baseadas em LTS do FreeRTOS e qualificá-lo para envio ao AWS Partner Device Catalog, você deve usar ( AWS IoT Device Tester IDT) com a suíte de testes FreeRTOS Qualification (FRQ) versão v1.4.x.
+ O suporte para versões baseadas em LTS do FreeRTOS está limitado à versão 202012.xx do FreeRTOS. 

## Faça download do IDT para FreeRTOS
<a name="download-dev-tester-afr"></a>

Cada versão do FreeRTOS tem uma versão correspondente do IDT para o FreeRTOS para realizar testes de qualificação. Baixe a versão adequada do IDT para FreeRTOS em [Versões compatíveis do AWS IoT Device Tester](dev-test-versions-afr.md).

Extraia o IDT para FreeRTOS em um local no sistema de arquivos onde existam permissões de leitura e gravação. Como o Microsoft Windows tem um limite de caracteres para o comprimento do caminho, extraia o IDT para FreeRTOS em um diretório raiz, como `C:\` ou `D:\`.

**nota**  
Não é recomendável que vários usuários executem o IDT em um local compartilhado, como um diretório NFS ou uma pasta compartilhada de rede do Windows. Isso pode resultar em falhas ou corrupção de dados. Recomendamos extrair o pacote IDT para uma unidade local.

## Crie e configure um AWS account
<a name="config-aws-account"></a>

### Inscreva-se para um Conta da AWS
<a name="sign-up-for-aws"></a>

Para começar AWS, você precisa de um Conta da AWS. Para obter informações sobre como criar um Conta da AWS, consulte [Introdução a um Conta da AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) no *Guia de AWS Gerenciamento de contas referência*.

## AWS IoT Device Tester política gerenciada
<a name="managed-policy"></a>

A política `AWSIoTDeviceTesterForFreeRTOSFullAccess` gerenciada contém as seguintes AWS IoT Device Tester permissões para verificação de versão, recursos de atualização automática e coleção de métricas.
+ `iot-device-tester:SupportedVersion`

  Concede AWS IoT Device Tester permissão para buscar a lista de produtos compatíveis, suítes de teste e versões do IDT.
+ `iot-device-tester:LatestIdt`

  Concede AWS IoT Device Tester permissão para obter a versão mais recente do IDT disponível para download.
+ `iot-device-tester:CheckVersion`

  Concede AWS IoT Device Tester permissão para verificar a compatibilidade de versões do IDT, suítes de teste e produtos.
+ `iot-device-tester:DownloadTestSuite`

  Concede AWS IoT Device Tester permissão para baixar atualizações da suíte de testes.
+ `iot-device-tester:SendMetrics`

  Concede AWS permissão para coletar métricas sobre o uso AWS IoT Device Tester interno.

## (Opcional) Instale o AWS Command Line Interface
<a name="install-cli"></a>

Talvez você prefira usar o AWS CLI para realizar algumas operações. Se não tiver a AWS CLI instalada, siga as instruções em [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).

Configure o AWS CLI para a AWS região que você deseja usar executando a **aws configure** partir de uma linha de comando. [Para obter informações sobre as AWS regiões que oferecem suporte ao IDT para FreeRTOS,AWS consulte Regiões e endpoints.](https://docs.aws.amazon.com/general/latest/gr/rande.html#amazon-freertos-ota-control) Para obter mais informações sobre **aws configure**, consulte [Configuração rápida com o **aws configure**](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config).