Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Configurez les prérequis de qualification LTS
Cette section décrit les prérequis pour tester les microcontrôleurs avec. AWS IoT Device Tester
## Préparez-vous à la qualification FreeRTOS
**Note**
AWS IoT Device Tester for FreeRTOS recommande vivement d'utiliser le dernier correctif de la dernière version de FreeRTOS-LTS.
IDT pour FRQ 2.0 est une qualification pour FreeRTOS. *Avant de lancer IDT FRQ 2.0 pour la qualification, vous devez terminer la qualification de [votre plateau dans le guide de qualification](https://docs.aws.amazon.com/freertos/latest/qualificationguide/freertos-qualification.html) FreeRTOS.* Pour porter des bibliothèques, les tester et les configurer`manifest.yml`, consultez la section Portage des bibliothèques [FreeRTOS dans le Guide de portage de *FreeRTOS*](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting.html). FRQ 2.0 contient un processus de qualification différent. Consultez [les derniers changements en matière de qualification](https://docs.aws.amazon.com/freertos/latest/qualificationguide/latest-changes.html) dans le guide de *qualification FreeRTOS pour plus de détails*.
Le référentiel [FreeRTOS-Libraries-Integration-Tests](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests) doit être présent pour qu'IDT puisse fonctionner. Consultez le [fichier README.md](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests/blob/main/README.md) pour savoir comment cloner et porter ce dépôt vers votre projet source. FreeRTOS-Libraries-Integration-Testsdoit inclure le contenu `manifest.yml` situé à la racine de votre projet, pour que IDT puisse fonctionner.
**Note**
IDT dépend de l'implémentation de`UNITY_OUTPUT_CHAR`. Les journaux des résultats des tests et les journaux des appareils ne doivent pas être entrelacés. Voir [la section Implémentation des macros de journalisation des bibliothèques](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-library-logging-macros.html) dans le Guide de *portage de FreeRTOS* pour plus de détails.
## Télécharger IDT pour FreeRTOS
Chaque version de FreeRTOS possède une version correspondante d'IDT pour FreeRTOS afin d'effectuer des tests de qualification. Téléchargez la version appropriée d'IDT pour FreeRTOS à [partir des versions](https://docs.aws.amazon.com/freertos/latest/userguide/dev-test-versions-afr.html) prises en charge de pour FreeRTOS. AWS IoT Device Tester
Extrayez IDT pour FreeRTOS vers un emplacement du système de fichiers où vous disposez d'autorisations de lecture et d'écriture. Microsoft Windows ayant une limite de caractères pour la longueur du chemin, extrayez IDT pour FreeRTOS dans un répertoire racine tel que ou. `C:\` `D:\`
**Note**
Plusieurs utilisateurs ne doivent pas exécuter IDT à partir d'un emplacement partagé, tel qu'un répertoire NFS ou un dossier partagé sur le réseau Windows. Cela entraînera des pannes ou une corruption des données. Nous vous recommandons d'extraire le package IDT sur un disque local.
## Télécharger Git
Git doit être installé sur IDT comme condition préalable pour garantir l'intégrité du code source.
Suivez les instructions du [GitHub](https://github.com/git-guides/install-git)guide pour installer Git. Pour vérifier la version actuellement installée de Git, entrez la commande `git --version` sur le terminal.
**Avertissement**
IDT utilise Git pour s'aligner sur le statut propre ou sale d'un répertoire. Si Git n'est pas installé, les groupes de `FreeRTOSIntegrity` test échoueront ou ne s'exécuteront pas comme prévu. Si IDT renvoie une erreur telle que `git executable not found` ou`git command not found`, installez ou réinstallez Git et réessayez.
**Topics**
+ [Préparez-vous à la qualification FreeRTOS](#idt-preparing-qualification)
+ [Télécharger IDT pour FreeRTOS](#idt-download-dev-tester-afr)
+ [Télécharger Git](#idt-download-git)
+ [Créez un AWS compte](#lts-config-aws-account)
+ [AWS IoT Device Tester politique gérée](#managed-policy)
+ [(Facultatif) Installez le AWS Command Line Interface](#install-cli)
## Créez un AWS compte
**Note**
La suite de qualification IDT complète n'est prise en charge que dans les cas suivants Régions AWS
USA Est (Virginie du Nord)
USA Ouest (Oregon)
Asie Pacifique (Tokyo)
Europe (Irlande)
Afin de tester votre appareil, IDT for FreeRTOS crée des ressources telles que des AWS IoT objets, des groupes FreeRTOS et des fonctions Lambda. Pour créer ces ressources, IDT for FreeRTOS nécessite que vous créiez et configuriez AWS un compte, ainsi qu'une politique IAM qui accorde à IDT for FreeRTOS l'autorisation d'accéder aux ressources en votre nom lors de l'exécution des tests.
Les étapes suivantes consistent à créer et à configurer votre AWS compte.
1. Si vous avez déjà un AWS compte, passez à l'étape suivante. Sinon, créez un [AWS compte](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/).
1. Suivez les étapes décrites dans [Création de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html). N'ajoutez pas d'autorisations ou de politiques pour le moment.
1. Pour exécuter des tests de qualification OTA, passez à l'étape 4. Sinon, passez à l'étape 5.
1. Associez la politique intégrée d'autorisations OTA IAM à votre rôle IAM.
1.
**Important**
Le modèle de stratégie suivant accorde à IDT l'autorisation de créer des rôles, de créer des stratégies et d'attacher des stratégies à des rôles. IDT pour FreeRTOS utilise ces autorisations pour les tests qui créent des rôles. Bien que le modèle de politique ne fournisse pas de privilèges d'administrateur à l'utilisateur, les autorisations peuvent être utilisées pour obtenir un accès administrateur à votre AWS compte.
1. Suivez les étapes ci-dessous pour associer les autorisations nécessaires à votre rôle IAM :
1. Sur la page **Autorisations**, choisissez **Ajouter des autorisations**.
1. Choisissez **Créer une politique en ligne**.
1. Sélectionnez l'onglet **JSON** et copiez les autorisations suivantes dans la zone de texte **JSON**. Utilisez le modèle sous **La plupart des régions** si vous n'êtes pas dans la région de Chine. Si vous vous trouvez dans la région de Chine, utilisez le modèle sous **Régions de Pékin et du 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 ]
Le modèle de politique suivant peut être utilisé dans les régions de Pékin et de Ningxia.
------
1. Lorsque vous avez terminé, sélectionnez **Review policy (Examiner une politique)**.
1. Entrez **IDTFreeRTOSIAMPermissions**comme nom de la politique.
1. Choisissez **Create Policy** (Créer une politique).
1. Associez **AWSIoTDeviceTesterForFreeRTOSFullAccess** à votre rôle IAM.
1. Pour associer les autorisations nécessaires à votre rôle IAM, procédez comme suit :
1. Sur la page **Autorisations**, choisissez **Ajouter des autorisations**.
1. Choisissez **Attacher des politiques**.
1. Recherchez la politique **AWSIoTDeviceTesterForFreeRTOSFulld'accès**. Cochez la case.
1. Choisissez **Ajouter des autorisations**.
1. Exportez les informations d'identification pour IDT. Voir [Obtenir les informations d'identification du rôle IAM pour l'accès à la CLI](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html) pour plus de détails.
## AWS IoT Device Tester politique gérée
La politique `AWSIoTDeviceTesterForFreeRTOSFullAccess` gérée contient les AWS IoT Device Tester autorisations suivantes pour la vérification des versions, les fonctionnalités de mise à jour automatique et la collecte de métriques.
+ `iot-device-tester:SupportedVersion`
Accorde AWS IoT Device Tester l'autorisation de récupérer la liste des produits pris en charge, des suites de tests et des versions IDT.
+ `iot-device-tester:LatestIdt`
Accorde AWS IoT Device Tester l'autorisation de récupérer la dernière version d'IDT disponible au téléchargement.
+ `iot-device-tester:CheckVersion`
Accorde AWS IoT Device Tester l'autorisation de vérifier la compatibilité des versions pour IDT, les suites de tests et les produits.
+ `iot-device-tester:DownloadTestSuite`
AWS IoT Device Tester Autorise le téléchargement des mises à jour de la suite de tests.
+ `iot-device-tester:SendMetrics`
Accorde AWS l'autorisation de collecter des statistiques relatives à l'utilisation AWS IoT Device Tester interne.
## (Facultatif) Installez le AWS Command Line Interface
Vous préférerez peut-être utiliser le AWS CLI pour effectuer certaines opérations. Si vous ne l'avez pas AWS CLI installé, suivez les instructions de la section [Installer le AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).
Configurez le AWS CLI pour la AWS région que vous souhaitez utiliser en l'exécutant à **aws configure** partir d'une ligne de commande. [Pour plus d'informations sur les AWS régions qui prennent en charge IDT pour FreeRTOS,AWS consultez Régions et points de terminaison.](https://docs.aws.amazon.com/general/latest/gr/rande.html#amazon-freertos-ota-control) Pour plus d'informations sur la **aws configure** section [Configuration rapide avec **aws configure**](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config).