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.
# Premiers pas
**Important**
Cette page fait référence au Amazon-FreeRTOS référentiel qui est obsolète. Nous vous recommandons de [commencer ici](freertos-getting-started-modular.md) lorsque vous créez un nouveau projet. Si vous possédez déjà un projet FreeRTOS basé sur le référentiel désormais Amazon-FreeRTOS obsolète, consultez le. [Amazon-FreeRTOS Guide de migration du référentiel Github](github-repo-migration.md)
Pour commencer à utiliser FreeRTOS AWS IoT avec, vous devez avoir AWS un compte, un utilisateur autorisé à y accéder AWS IoT et les services cloud FreeRTOS. Vous devez également télécharger FreeRTOS et configurer le projet de démonstration FreeRTOS de votre forum pour qu'il fonctionne avec. AWS IoT Les sections suivantes vous guident au cours de ces exigences.
**Note**
Si vous utilisez l'Espressif ESP32-DevKitC, ou le ESP-WROVER-KIT ESP32-WROOM-32SE, ignorez ces étapes et passez à. [Commencer à utiliser l'Espressif ESP32-DevKitC et le ESP-WROVER-KIT](getting_started_espressif.md)
Si vous utilisez le Nordic nRF52840-DK, ignorez ces étapes et passez à[Débuter avec le Nordic n RF52840-DK](getting_started_nordic.md).
1. [Configuration de votre AWS compte et autorisations](#freertos-account-and-permissions)
1. [Enregistrement de votre carte MCU auprès AWS IoT](#get-started-freertos-thing)
1. [Téléchargement de FreeRTOS](#freertos-download)
1. [Configuration des démos de FreeRTOS](#freertos-configure)
## Configuration de votre AWS compte et autorisations
### Inscrivez-vous pour un Compte AWS
Pour commencer AWS, vous avez besoin d'un Compte AWS. Pour plus d'informations sur la création d'un Compte AWS, voir [Getting started with an Compte AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) dans le *Guide de Gestion de compte AWS référence*.
Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :
+ Utilisateurs et groupes dans AWS IAM Identity Center :
Créez un jeu d’autorisations. Suivez les instructions de la rubrique [Création d’un jeu d’autorisations](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) du *Guide de l’utilisateur AWS IAM Identity Center *.
+ Utilisateurs gérés dans IAM par un fournisseur d’identité :
Créez un rôle pour la fédération d’identité. Suivez les instructions de la rubrique [Création d’un rôle pour un fournisseur d’identité tiers (fédération)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) dans le *Guide de l’utilisateur IAM*.
+ Utilisateurs IAM :
+ Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la rubrique [Création d’un rôle pour un utilisateur IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dans le *Guide de l’utilisateur IAM*.
+ (Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la rubrique [Ajout d’autorisations à un utilisateur (console)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) du *Guide de l’utilisateur IAM*.
## Enregistrement de votre carte MCU auprès AWS IoT
Votre forum doit être enregistré AWS IoT pour pouvoir communiquer avec le AWS Cloud. Pour enregistrer votre forum auprès de AWS IoT celui-ci, vous devez avoir :
**Une AWS IoT politique**
La AWS IoT politique accorde à votre appareil l'autorisation d'accéder aux AWS IoT ressources. Il est stocké dans le AWS Cloud.
**N'importe quelle AWS IoT chose**
AWS IoT Tout ce qui vous permet de gérer vos appareils dans AWS IoT. Il est stocké dans le AWS Cloud.
**Une clé privée et X.509 un certificat**
La clé privée et le certificat permettent à votre appareil de s'authentifier. AWS IoT
Pour enregistrer votre tableau, suivez les procédures ci-dessous.
**Pour créer un AWS IoT policy**
1. Pour créer une politique IAM, vous devez connaître votre AWS région et votre numéro de AWS compte.
Pour trouver votre numéro de AWS compte, ouvrez la [console AWS de gestion](https://console.aws.amazon.com/), recherchez et développez le menu situé sous le nom de votre compte dans le coin supérieur droit, puis sélectionnez **Mon** compte. Votre ID de compte s'affiche sous **Paramètres du compte**.
Pour trouver la AWS région associée à votre AWS compte, utilisez le AWS Command Line Interface. Pour l'installer AWS CLI, suivez les instructions du [guide de l'AWS Command Line Interface utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html). Après avoir installé le AWS CLI, ouvrez une fenêtre d'invite de commande et entrez la commande suivante :
```
aws iot describe-endpoint --endpoint-type=iot:Data-ATS
```
La sortie doit se présenter comme suit :
```
{
"endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com"
}
```
Dans cet exemple, la région est `us-west-2`.
**Note**
Nous vous recommandons d'utiliser les points de terminaison ATS comme indiqué dans l'exemple.
1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iotv2/).
1. Dans le volet de navigation, choisissez successivement **Sécurisé**, **Stratégies** et **Créer**.
1. Entrez un nom pour identifier votre stratégie.
1. Dans la section **Ajouter des instructions**, choisissez **Mode avancé**. Copiez et collez le code JSON suivant dans la fenêtre de l'éditeur de stratégie. Remplacez `{{aws-region}}` et `{{aws-account}}` par votre AWS région et votre numéro de compte.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iot:Connect",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
},
{
"Effect": "Allow",
"Action": "iot:Publish",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
},
{
"Effect": "Allow",
"Action": "iot:Subscribe",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
},
{
"Effect": "Allow",
"Action": "iot:Receive",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
}
]
}
```
------
Cette stratégie accorde les autorisations suivantes :
**`iot:Connect`**
Accorde à votre appareil l'autorisation de se connecter au courtier de AWS IoT messages avec n'importe quel identifiant client.
**`iot:Publish`**
Accorde à votre appareil l'autorisation de publier un message MQTT sur n’importe quelle rubrique MQTT.
**`iot:Subscribe`**
Accorde à votre appareil l'autorisation de s'abonner au filtre de n’importe quelle rubrique MQTT.
**`iot:Receive`**
Accorde à votre appareil l'autorisation de recevoir des messages de l'agent de messages AWS IoT .
1. Choisissez **Créer**.
**Pour créer un objet IoT, une clé privée et un certificat pour votre appareil**
1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iotv2/).
1. Dans le volet de navigation, choisissez **Gérer**, puis **Objets**.
1. Si vous n'avez pas d'objets IoT enregistrés dans votre compte, la page **Vous n'avez pas encore d'objets** s'affiche. Si vous voyez cette page, choisissez **Enregistrer un objet**. Sinon, cliquez sur **Create**.
1. Sur la page **Création d' AWS IoT objets**, choisissez **Créer un objet unique**.
1. Sur la page **Ajouter l'appareil au registre d'objets**, saisissez un nom pour votre objet, puis choisissez **Suivant**.
1. Sur la page **Ajouter un certificat pour votre objet**, sous **Création de One-click certificat**, sélectionnez **Créer un certificat**.
1. Téléchargez votre clé privée et votre certificat en choisissant les liens **Télécharger** de chacun d'eux.
1. Choisissez **Activer** pour activer votre certificat. Les certificats doivent être activés avant utilisation.
1. Choisissez **Joindre une politique** pour associer une politique à votre certificat qui accorde à votre appareil l'accès aux AWS IoT opérations.
1. Choisissez la stratégie que vous venez de créer, puis choisissez **Enregistrer l'objet**.
Une fois que votre forum est enregistré AWS IoT, vous pouvez continuer sur[Téléchargement de FreeRTOS](#freertos-download).
## Téléchargement de FreeRTOS
[Vous pouvez télécharger FreeRTOS depuis le dépôt FreeRTOS. GitHub ](https://github.com/freertos/freertos)
Après avoir téléchargé FreeRTOS, vous pouvez continuer. [Configuration des démos de FreeRTOS](#freertos-configure)
## Configuration des démos de FreeRTOS
Vous devez modifier certains fichiers de configuration dans votre répertoire FreeRTOS avant de pouvoir compiler et exécuter des démos sur votre carte.
**Pour configurer votre AWS IoT point de terminaison**
Vous devez fournir votre point de terminaison à FreeRTOS afin que l'application exécutée sur AWS IoT votre carte puisse envoyer des demandes au point de terminaison approprié.
1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iotv2/).
1. Dans le panneau de navigation de gauche, choisissez **Paramètres**.
Votre AWS IoT point de terminaison est affiché dans Terminal de **données de l'appareil**. Elle doit ressembler à `{{1234567890123}}-ats.iot.{{us-east-1}}.amazonaws.com`. Prenez note de ce point de terminaison.
1. Dans le volet de navigation, choisissez **Gérer**, puis **Objets**.
Votre appareil doit porter un nom d' AWS IoT objet. Notez ce nom.
1. Ouvrir `demos/include/aws_clientcredential.h`.
1. Spécifiez des valeurs pour les constantes suivantes :
+ `#define clientcredentialMQTT_BROKER_ENDPOINT "{{Your AWS IoT endpoint}}";`
+ `#define clientcredentialIOT_THING_NAME "{{The AWS IoT thing name of your board}}"`
**Pour configurer votre Wi-Fi**
Si votre forum se connecte à Internet via une Wi-Fi connexion, vous devez fournir à FreeRTOS les informations d'identification pour vous connecter au réseau. Wi-Fi Si votre tableau n'est pas compatible Wi-Fi, vous pouvez ignorer ces étapes.
1. `demos/include/aws_clientcredential.h`.
1. Spécifiez des valeurs pour les constantes `#define` suivantes :
+ `#define clientcredentialWIFI_SSID "{{The SSID for your Wi-Fi network}}"`
+ `#define clientcredentialWIFI_PASSWORD "{{The password for your Wi-Fi network}}"`
+ `#define clientcredentialWIFI_SECURITY` {{The security type of your Wi-Fi network}}
Les types de sécurité valides sont :
+ `eWiFiSecurityOpen` (Ouvrir, aucune sécurité)
+ `eWiFiSecurityWEP` (Sécurité WEP)
+ `eWiFiSecurityWPA` (Sécurité WPA)
+ `eWiFiSecurityWPA2` (Sécurité WPA2)
**Pour formater votre AWS IoT informations d’identification**
FreeRTOS doit disposer AWS IoT du certificat et des clés privées associés à votre objet enregistré et de ses politiques d'autorisation pour pouvoir communiquer AWS IoT avec succès au nom de votre appareil.
**Note**
Pour configurer vos AWS IoT informations d'identification, vous devez disposer de la clé privée et du certificat que vous avez téléchargés depuis la AWS IoT console lors de l'enregistrement de votre appareil. Après avoir enregistré votre appareil en tant qu' AWS IoT objet, vous pouvez récupérer les certificats de l'appareil depuis la AWS IoT console, mais vous ne pouvez pas récupérer les clés privées.
FreeRTOS est un projet en langage C, et le certificat et la clé privée doivent être spécialement formatés pour être ajoutés au projet.
1. Dans une fenêtre du navigateur, ouvrez `tools/certificate_configuration/CertificateConfigurator.html`.
1. Sous **Certificate PEM file (Fichier PEM de certificat)**, choisissez le `{{ID}}-certificate.pem.crt` que vous avez téléchargé à partir de la console AWS IoT .
1. Sous **Fichier PEM de clé privée**, choisissez le `{{ID}}-private.pem.key` que vous avez téléchargé à partir de la console AWS IoT .
1. Choisissez **Generate and save aws\_clientcredential\_keys.h (Générer et enregistrer aws\_clientcredential\_keys.h)** et enregistrez le fichier dans `demos/include`. Cela remplace le fichier existant dans le répertoire.
**Note**
Le certificat et la clé privée sont codés en dur à des fins de démonstration uniquement. Production-level les applications doivent stocker ces fichiers dans un emplacement sécurisé.
Après avoir configuré FreeRTOS, vous pouvez passer au guide de démarrage de votre carte pour configurer le matériel de votre plate-forme et son environnement de développement logiciel, puis compiler et exécuter la démo sur votre carte. Pour obtenir des instructions spécifiques à la carte, consultez [Board-specific guides de démarrage](getting-started-guides.md). L'application de démonstration utilisée dans le didacticiel de mise en route est la démo d'authentification mutuelle CoreMQTT, qui se trouve à l'adresse. `demos/coreMQTT/mqtt_demo_mutual_auth.c`