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 LTS Esta seção descreve os pré-requisitos para testar microcontroladores com. AWS IoT Device Tester ## Preparar-se para a qualificação do FreeRTOS **nota** AWS IoT Device Tester for FreeRTOS recomenda fortemente o uso da última versão de patch da versão mais recente do FreeRTOS-LTS. O IDT para FRQ 2.0 é uma qualificação para FreeRTOS. Antes de executar o IDT FRQ 2.0 para qualificação, é preciso concluir a [Qualificação de sua placa](https://docs.aws.amazon.com/freertos/latest/qualificationguide/freertos-qualification.html) no *Guia de qualificação do FreeRTOS*. Para portar bibliotecas, testar e configurar o `manifest.yml`, consulte [Como portar as bibliotecas do FreeRTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting.html) no *Guia de portabilidade do FreeRTOS*. O FRQ 2.0 contém um processo diferente de qualificação. Consulte [Alterações mais recentes na qualificação](https://docs.aws.amazon.com/freertos/latest/qualificationguide/latest-changes.html) no *Guia de qualificação do FreeRTOS* para obter detalhes. O repositório [IDT-FreeRTOS-Libraries-Integration-Tests](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests) deve estar presente para que o IDT seja executado. Consulte o [README.md](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests/blob/main/README.md) sobre como clonar e portar esse repositório para seu projeto de origem. FreeRTOS-Libraries-Integration-Testsdeve incluir o `manifest.yml` localizado na raiz do seu projeto, para que o IDT seja executado. **nota** O IDT depende da implementação do repositório de testes do `UNITY_OUTPUT_CHAR`. Os logs de saída de teste e os logs do dispositivo não devem ser intercalados entre si. Consulte [Como implementar a seção de macros de registro em log da biblioteca](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-library-logging-macros.html) no *Guia de portabilidade do FreeRTOS* para obter mais detalhes. ## Baixe o IDT para FreeRTOS 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 apropriada do IDT para FreeRTOS a [partir das versões](https://docs.aws.amazon.com/freertos/latest/userguide/dev-test-versions-afr.html) suportadas do para FreeRTOS. AWS IoT Device Tester 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** Vários usuários não devem executar o IDT de um local compartilhado, como um diretório NFS ou uma pasta compartilhada de rede do Windows. Isto pode resultar em falhas ou corrupção de dados. Recomendamos extrair o pacote IDT para uma unidade local. ## Baixe o Git O IDT deve ter o Git instalado como um pré-requisito para garantir a integridade do código-fonte. Siga as instruções no [GitHub](https://github.com/git-guides/install-git)guia para instalar o Git. Para verificar a versão atual instalada do Git, digite o comando `git --version` no terminal. **Atenção** O IDT usa o Git para se alinhar ao status de limpo ou sujo de um diretório. Se o Git não estiver instalado, os grupos de teste `FreeRTOSIntegrity` falharão ou não serão executados conforme o esperado. Se o IDT retornar um erro como `git executable not found` ou`git command not found`, instale ou reinstale o Git e tente novamente. **Topics** + [Preparar-se para a qualificação do FreeRTOS](#idt-preparing-qualification) + [Baixe o IDT para FreeRTOS](#idt-download-dev-tester-afr) + [Baixe o Git](#idt-download-git) + [Crie uma AWS conta](#lts-config-aws-account) + [AWS IoT Device Tester política gerenciada](#managed-policy) + [(Opcional) Instale o AWS Command Line Interface](#install-cli) ## Crie uma AWS conta **nota** O pacote completo de qualificação da IDT é suportado somente no seguinte Regiões da AWS Leste dos EUA (N. da Virgínia) Oeste dos EUA (Oregon) Ásia-Pacífico (Tóquio) Europa (Irlanda) Para testar seu dispositivo, o IDT for FreeRTOS cria recursos como AWS IoT coisas, grupos do FreeRTOS e funções Lambda. Para criar esses recursos, o IDT for FreeRTOS exige que você crie e configure AWS uma conta e uma política do IAM que conceda ao IDT for FreeRTOS permissão para acessar recursos em seu nome durante a execução de testes. As etapas a seguir são para criar e configurar sua AWS conta. 1. Se você já tiver uma AWS conta, vá para a próxima etapa. Para criar uma [conta da AWS](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/). 1. Siga as etapas em [Como criar perfis do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html). Não adicione permissões ou políticas no momento. 1. Para executar testes de qualificação OTA, vá para a etapa 4. Caso contrário, vá para a etapa 5. 1. Anexe a política embutida de permissões do OTA IAM ao seu perfil do IAM. 1. **Importante** O modelo de política a seguir concede ao IDT permissão para criar funções e políticas, e associar políticas às funções. O IDT para FreeRTOS usa essas permissões para testes que criam perfis. Embora o modelo de política não forneça privilégios de administrador ao usuário, as permissões podem ser usadas para obter acesso de administrador à sua AWS conta. 1. Siga as etapas abaixo para anexar as permissões necessárias ao perfil do IAM: 1. Na guia **Permissões**, escolha **Adicionar permissões**. 1. Escolha **Criar política em linha**. 1. Escolha a guia **JSON** e copie as permissões a seguir na caixa de texto **JSON**. Use o modelo na **Maioria das regiões** se não estiver na região da China. Se estiver na região da China, use o modelo nas **regiões de Pequim e Ningxia**. ------ #### [ Most Regions ] ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotdeviceadvisor:*", "Resource": [ "arn:aws:iotdeviceadvisor:*:*:suiterun/*/*", "arn:aws:iotdeviceadvisor:*:*:suitedefinition/*" ] }, { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::*:role/idt*", "Condition": { "StringEquals": { "iam:PassedToService": "iotdeviceadvisor.amazonaws.com" } } }, { "Effect": "Allow", "Action": [ "execute-api:Invoke*", "iam:ListRoles", "iot:Connect", "iot:CreateJob", "iot:DeleteJob", "iot:DescribeCertificate", "iot:DescribeEndpoint", "iot:DescribeJobExecution", "iot:DescribeJob", "iot:DescribeThing", "iot:GetPolicy", "iot:ListAttachedPolicies", "iot:ListCertificates", "iot:ListPrincipalPolicies", "iot:ListThingPrincipals", "iot:ListThings", "iot:Publish", "iot:UpdateThingShadow", "logs:CreateLogGroup", "logs:CreateLogStream", "logs:DescribeLogGroups", "logs:DescribeLogStreams", "logs:PutLogEvents", "logs:PutRetentionPolicy" ], "Resource": "*" }, { "Effect": "Allow", "Action": "iotdeviceadvisor:*", "Resource": "*" }, { "Effect": "Allow", "Action": "logs:DeleteLogGroup", "Resource": "arn:aws:logs:*:*:log-group:/aws/iot/deviceadvisor/*" }, { "Effect": "Allow", "Action": "logs:GetLogEvents", "Resource": "arn:aws:logs:*:*:log-group:/aws/iot/deviceadvisor/*:log-stream:*" }, { "Effect": "Allow", "Action": [ "iam:CreatePolicy", "iam:DetachRolePolicy", "iam:DeleteRolePolicy", "iam:DeletePolicy", "iam:CreateRole", "iam:DeleteRole", "iam:AttachRolePolicy" ], "Resource": [ "arn:aws:iam::*:policy/idt*", "arn:aws:iam::*:role/idt*" ] }, { "Effect": "Allow", "Action": [ "ssm:GetParameters" ], "Resource": [ "arn:aws:ssm:*::parameter/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2" ] }, { "Effect": "Allow", "Action": [ "ec2:DescribeInstances", "ec2:RunInstances", "ec2:CreateSecurityGroup", "ec2:CreateTags", "ec2:DeleteTags" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "ec2:CreateKeyPair", "ec2:DeleteKeyPair" ], "Resource": [ "arn:aws:ec2:*:*:key-pair/idt-ec2-ssh-key-*" ] }, { "Effect": "Allow", "Condition": { "StringEqualsIgnoreCase": { "aws:ResourceTag/Owner": "IoTDeviceTester" } }, "Action": [ "ec2:TerminateInstances", "ec2:DeleteSecurityGroup", "ec2:AuthorizeSecurityGroupIngress", "ec2:RevokeSecurityGroupIngress" ], "Resource": [ "*" ] } ] } ``` ------ ------ #### [ Beijing and Ningxia Regions ] O modelo de política a seguir pode ser usado nas regiões de Pequim e Ningxia. ------ 1. Ao concluir, selecione **Review policy (Revisar política)**. 1. Insira **IDTFreeRTOSIAMPermissions**como nome da política. 1. Selecione **Criar política**. 1. Anexe **AWSIoTDeviceTesterForFreeRTOSFullo Access** à sua função do IAM. 1. Para associar as permissões necessárias ao seu perfil do IAM: 1. Na guia **Permissões**, escolha **Adicionar permissões**. 1. Escolha **Anexar políticas**. 1. Pesquise a política de **AWSIoTDeviceTesterForFreeRTOSFullacesso**. Marque a caixa. 1. Escolha **Adicionar permissões**. 1. Exporte credenciais para o IDT. Consulte [Obter credenciais de perfil do IAM para acesso à CLI](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html) para obter detalhes. ## AWS IoT Device Tester política gerenciada 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 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).