Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Imposta i prerequisiti di qualificazione LTS
Questa sezione descrive i prerequisiti per testare i microcontrollori con. AWS IoT Device Tester
## Preparati per la qualificazione FreerTOS
**Nota**
AWS IoT Device Tester for FreerTOS consiglia vivamente di utilizzare l'ultima patch release della versione più recente di FreeRTOS-LTS.
IDT for FRQ 2.0 è una qualifica per FreerTOS. *Prima di avviare IDT FRQ 2.0 per la qualificazione, devi completare [Qualifying your board nella FreerTOS Qualification](https://docs.aws.amazon.com/freertos/latest/qualificationguide/freertos-qualification.html) Guide.* *Per effettuare il porting delle librerie, i test e la configurazione di`manifest.yml`, consulta [Porting the FreerTOS librerie nella FreeRTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting.html) Porting Guide.* FRQ 2.0 contiene un processo di qualificazione diverso. Vedi [le ultime modifiche alle qualifiche nella guida alla qualificazione](https://docs.aws.amazon.com/freertos/latest/qualificationguide/latest-changes.html) di *FreerTOS* per i dettagli.
Il repository [FreeRTOS-Libraries-Integration-Tests](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests) deve essere presente affinché IDT possa funzionare. Vedi [README.md](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests/blob/main/README.md) su come clonare e trasferire questo repository sul tuo progetto sorgente. FreeRTOS-Libraries-Integration-Testsè necessario includere il file che `manifest.yml` si trova nella radice del progetto, affinché IDT possa funzionare.
**Nota**
IDT dipende dall'implementazione di. `UNITY_OUTPUT_CHAR` I log dei risultati dei test e i log del dispositivo non devono interlacciarsi tra loro. Vedi [la sezione Implementazione delle macro di registrazione della libreria nella FreerTOS Porting](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-library-logging-macros.html) *Guide per ulteriori dettagli*.
## Scarica IDT per FreerTOS
Ogni versione di FreerTOS ha una versione corrispondente di IDT per FreerTOS per eseguire test di qualificazione. Scarica la versione appropriata di IDT per FreerTOS [dalle versioni](https://docs.aws.amazon.com/freertos/latest/userguide/dev-test-versions-afr.html) supportate di per FreerTOS. AWS IoT Device Tester
Estrai IDT for FreerTOS in una posizione del file system in cui disponi dei permessi di lettura e scrittura. Poiché Microsoft Windows ha un limite di caratteri per la lunghezza del percorso, estrai IDT per FreerTOS in una directory principale come o. `C:\` `D:\`
**Nota**
Più utenti non devono eseguire IDT da una posizione condivisa, come una directory NFS o una cartella condivisa di rete Windows. Ciò provocherà arresti anomali o danneggiamento dei dati. Si consiglia di estrarre il pacchetto IDT in un'unità locale.
## Scarica Git
IDT deve avere Git installato come prerequisito per garantire l'integrità del codice sorgente.
Segui le istruzioni nella [GitHub](https://github.com/git-guides/install-git)guida per installare Git. Per verificare la versione attualmente installata di Git, inserisci il comando `git --version` nel terminale.
**avvertimento**
IDT usa Git per allinearsi allo stato pulito o sporco di una directory. Se Git non è installato, i gruppi di `FreeRTOSIntegrity` test falliranno o non verranno eseguiti come previsto. Se IDT restituisce un errore come `git executable not found` o`git command not found`, installa o reinstalla Git e riprova.
**Topics**
+ [Preparati per la qualificazione FreerTOS](#idt-preparing-qualification)
+ [Scarica IDT per FreerTOS](#idt-download-dev-tester-afr)
+ [Scarica Git](#idt-download-git)
+ [Crea un account AWS](#lts-config-aws-account)
+ [AWS IoT Device Tester politica gestita](#managed-policy)
+ [(Facoltativo) Installa il AWS Command Line Interface](#install-cli)
## Crea un account AWS
**Nota**
La suite di qualificazione IDT completa è supportata solo nei seguenti paesi Regioni AWS
Stati Uniti orientali (Virginia settentrionale)
Stati Uniti occidentali (Oregon)
Asia Pacifico (Tokyo)
Europa (Irlanda)
Per testare il tuo dispositivo, IDT for FreeRTOS crea risorse come AWS IoT oggetti, gruppi FreeRTOS e funzioni Lambda. Per creare tali risorse, IDT for FreerTOS richiede la creazione e la configurazione di AWS un account e una policy IAM che conceda a IDT for FreerTOS l'autorizzazione ad accedere alle risorse per tuo conto durante l'esecuzione dei test.
I seguenti passaggi servono a creare e configurare il tuo account. AWS
1. Se hai già un AWS account, vai al passaggio successivo. Altrimenti crea un [AWS account](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/).
1. Segui i passaggi descritti in [Creazione di ruoli IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html). Al momento non aggiungere autorizzazioni o politiche.
1. Per eseguire i test di qualificazione OTA, vai al passaggio 4. Altrimenti vai al passaggio 5.
1. Allega la policy in linea per le autorizzazioni OTA IAM al tuo ruolo IAM.
1.
**Importante**
Il modello di policy seguente concede l'autorizzazione IDT per creare ruoli, policy e collegare policy ai ruoli. IDT for FreerTOS utilizza queste autorizzazioni per i test che creano ruoli. Sebbene il modello di policy non fornisca privilegi di amministratore all'utente, le autorizzazioni possono essere utilizzate per ottenere l'accesso come amministratore al proprio account. AWS
1. Segui i passaggi seguenti per assegnare le autorizzazioni necessarie al tuo ruolo IAM:
1. Nella pagina **Autorizzazioni, scegli **Aggiungi** autorizzazioni**.
1. Scegli **Create inline policy** (Crea policy in linea).
1. Scegliere la scheda **JSON** e copiare le seguenti autorizzazioni nella casella di testo **JSON** . Usa il modello sotto **La maggior parte delle regioni** se non ti trovi nella regione Cina. Se ti trovi nella regione della Cina, usa il modello in Regioni di **Pechino 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 ]
Il seguente modello di politica può essere utilizzato nelle regioni di Pechino e Ningxia.
------
1. Al termine, seleziona **Review policy (Rivedi policy)**.
1. Inserisci **IDTFreeRTOSIAMPermissions**come nome della politica.
1. Scegli **Crea policy**.
1. Allega **AWSIoTDeviceTesterForFreeRTOSFullAccess** al tuo ruolo IAM.
1. Per assegnare le autorizzazioni necessarie al tuo ruolo IAM:
1. Nella pagina **Autorizzazioni, scegli **Aggiungi** autorizzazioni**.
1. Scegli **Collega policy**.
1. Cerca la politica di **AWSIoTDeviceTesterForFreeRTOSFullaccesso**. Seleziona la casella.
1. Scegli **Add Permissions (Aggiungi autorizzazioni)**.
1. Esporta le credenziali per IDT. Per ulteriori dettagli, consulta [Ottenere le credenziali del ruolo IAM per l'accesso alla CLI](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html).
## AWS IoT Device Tester politica gestita
La policy `AWSIoTDeviceTesterForFreeRTOSFullAccess` gestita contiene le seguenti AWS IoT Device Tester autorizzazioni per il controllo della versione, le funzionalità di aggiornamento automatico e la raccolta di metriche.
+ `iot-device-tester:SupportedVersion`
Concede AWS IoT Device Tester l'autorizzazione a recuperare l'elenco dei prodotti supportati, delle suite di test e delle versioni IDT.
+ `iot-device-tester:LatestIdt`
Concede AWS IoT Device Tester l'autorizzazione a recuperare l'ultima versione IDT disponibile per il download.
+ `iot-device-tester:CheckVersion`
Concede AWS IoT Device Tester l'autorizzazione a verificare la compatibilità delle versioni per IDT, suite di test e prodotti.
+ `iot-device-tester:DownloadTestSuite`
Concede AWS IoT Device Tester l'autorizzazione a scaricare gli aggiornamenti della suite di test.
+ `iot-device-tester:SendMetrics`
Concede AWS l'autorizzazione a raccogliere metriche sull' AWS IoT Device Tester utilizzo interno.
## (Facoltativo) Installa il AWS Command Line Interface
Potresti preferire utilizzare il AWS CLI per eseguire alcune operazioni. Se non lo hai AWS CLI installato, segui le istruzioni in [Installare il AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).
Configuralo AWS CLI per la AWS regione che desideri utilizzare eseguendolo **aws configure** da una riga di comando. [Per informazioni sulle AWS regioni che supportano IDT for FreerTOS,AWS consulta Regioni ed endpoint.](https://docs.aws.amazon.com/general/latest/gr/rande.html#amazon-freertos-ota-control) [Per ulteriori informazioni, **aws configure** vedere Configurazione rapida con. **aws configure**](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)