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 RTOS référentiel Amazon Free qui est obsolète. Nous vous recommandons de commencer ici lorsque vous créez un nouveau projet. Si vous possédez déjà un RTOS projet gratuit basé sur le RTOS référentiel Amazon Free, désormais obsolète, consultez le. Guide de migration du référentiel RTOS Github gratuit sur Amazon
Pour commencer à utiliser Free RTOS avec AWS IoT, vous devez avoir AWS compte, un utilisateur autorisé à accéder AWS IoT et des services RTOS cloud gratuits. Vous devez également télécharger Free RTOS et configurer le projet de RTOS démonstration gratuit de votre forum pour qu'il fonctionne avec AWS IoT. Les sections suivantes décrivent ces exigences.
Note
-
Si vous utilisez l'Espressif ESP32 - DevKit C, - ESP - ou le WROVER ESP32 - WROOM -32SEKIT, ignorez ces étapes et passez à. Débuter avec l'Espressif ESP32 - DevKit C et le ESP - - WROVER KIT
-
Si vous utilisez le Nordic n RF5284 0-DK, ignorez ces étapes et passez àMise en route avec Nordic nRF52840-DK.
Configuration de votre AWS compte et autorisations
Inscrivez-vous pour un Compte AWS
Si vous n'avez pas de Compte AWS, procédez comme suit pour en créer un.
Pour vous inscrire à un Compte AWS
Ouvrez l'https://portal.aws.amazon.com/billing/inscription.
Suivez les instructions en ligne.
Dans le cadre de la procédure d‘inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, une Utilisateur racine d'un compte AWSest créé. L'utilisateur root a accès à tous Services AWS et les ressources du compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l‘utilisateur racine pour effectuer les tâches nécessitant un accès utilisateur racine.
AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à https://aws.amazon.com/
Création d'un utilisateur doté d'un accès administratif
Une fois que vous vous êtes inscrit à un Compte AWS, sécurisez votre Utilisateur racine d'un compte AWS, activer AWS IAM Identity Center, et créez un utilisateur administratif afin de ne pas utiliser l'utilisateur root pour les tâches quotidiennes.
Sécurisez votre Utilisateur racine d'un compte AWS
-
Connectez-vous au AWS Management Console
en tant que propriétaire du compte en choisissant Utilisateur root et en saisissant votre Compte AWS adresse e-mail. Sur la page suivante, saisissez votre mot de passe. Pour obtenir de l'aide pour vous connecter à l'aide de l'utilisateur root, consultez la section Connexion en tant qu'utilisateur root dans Connexion à AWS Guide de l'utilisateur
-
Activez l'authentification multifactorielle (MFA) pour votre utilisateur root.
Pour obtenir des instructions, voir Activer un MFA appareil virtuel pour votre Compte AWS utilisateur root (console) dans le guide de IAM l'utilisateur.
Création d'un utilisateur doté d'un accès administratif
-
Activez IAM Identity Center.
Pour obtenir des instructions, voir Activation AWS IAM Identity Center dans le .AWS IAM Identity Center Guide de l'utilisateur
-
Dans IAM Identity Center, accordez un accès administratif à un utilisateur.
Pour un didacticiel sur l'utilisation du Répertoire IAM Identity Center comme source d'identité, voir Configurer l'accès utilisateur avec la valeur par défaut Répertoire IAM Identity Center dans le .AWS IAM Identity Center Guide de l'utilisateur
Connexion en tant qu‘utilisateur doté d'un accès administratif
-
Pour vous connecter avec votre utilisateur IAM Identity Center, utilisez l'URLidentifiant envoyé à votre adresse e-mail lorsque vous avez créé l'utilisateur IAM Identity Center.
Pour obtenir de l'aide pour vous connecter à l'aide d'un utilisateur d'IAMIdentity Center, consultez la section Connexion au AWS portail d'accès dans le Connexion à AWS Guide de l'utilisateur
Attribution d'un accès à d'autres utilisateurs
-
Dans IAM Identity Center, créez un ensemble d'autorisations conforme à la meilleure pratique consistant à appliquer les autorisations du moindre privilège.
Pour obtenir des instructions, voir Créer un ensemble d'autorisations dans le AWS IAM Identity Center Guide de l'utilisateur
-
Attribuez des utilisateurs à un groupe, puis attribuez un accès par authentification unique au groupe.
Pour obtenir des instructions, voir Ajouter des groupes dans le AWS IAM Identity Center Guide de l'utilisateur
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 section Créer un ensemble d'autorisations dans le AWS IAM Identity Center Guide de l'utilisateur
-
Utilisateurs gérés IAM via un fournisseur d'identité :
Créez un rôle pour la fédération d’identité. Suivez les instructions de la section Création d'un rôle pour un fournisseur d'identité tiers (fédération) dans le guide de IAM l'utilisateur.
-
IAMutilisateurs :
-
Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la section Création d'un rôle pour un IAM utilisateur dans le Guide de IAM l'utilisateur.
-
(Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la section Ajouter des autorisations à un utilisateur (console) dans le guide de IAM l'utilisateur.
-
Enregistrer votre MCU tableau auprès de AWS IoT
Votre forum doit être enregistré auprès de AWS IoT pour communiquer avec AWS Nuage. Pour enregistrer votre tableau auprès de AWS IoT, vous devez avoir :
- Un AWS IoT politique
-
Le AWS IoT la politique accorde à votre appareil les autorisations d'accès AWS IoT ressources. Il est stocké sur le AWS Nuage.
- Un AWS IoT thing
-
Un AWS IoT ce truc vous permet de gérer vos appareils dans AWS IoT. Il est stocké sur le AWS Nuage.
- Une clé privée et un certificat X.509
-
La clé privée et le certificat permettent à votre appareil de s'authentifier auprès AWS IoT.
Pour enregistrer votre tableau, suivez les procédures ci-dessous.
Pour créer un AWS IoT politique
-
Pour créer une IAM politique, vous devez connaître votre AWS Région et AWS numéro de compte.
Pour trouver votre AWS numéro de compte, ouvrez le AWS Console de gestion
, localisez et développez le menu situé sous le nom de votre compte dans le coin supérieur droit, puis choisissez Mon compte. Votre ID de compte s'affiche sous Paramètres du compte. Pour trouver le AWS région pour votre AWS compte, utilisez le AWS Command Line Interface. Pour installer AWS CLI, suivez les instructions du AWS Command Line Interface Guide de l'utilisateur Une fois que vous avez installé 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 des ATS points de terminaison comme indiqué dans l'exemple.
-
Naviguez jusqu'au AWS IoT console
. -
Dans le volet de navigation, choisissez successivement Sécurisé, Stratégies et Créer.
-
Entrez un nom pour identifier votre stratégie.
-
Dans la section Ajouter des instructions, choisissez Mode avancé. Copiez et collez ce qui suit JSON dans la fenêtre de l'éditeur de politiques. Remplacez
etaws-region
par votre AWS Région et numéro de compte.aws-account
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:Connect", "Resource":"arn:aws:iot:
aws-region
:aws-account-id
:*" }, { "Effect": "Allow", "Action": "iot:Publish", "Resource": "arn:aws:iot:aws-region
:aws-account-id
:*" }, { "Effect": "Allow", "Action": "iot:Subscribe", "Resource": "arn:aws:iot:aws-region
:aws-account-id
:*" }, { "Effect": "Allow", "Action": "iot:Receive", "Resource": "arn:aws:iot:aws-region
:aws-account-id
:*" } ] }Cette stratégie accorde les autorisations suivantes :
iot:Connect
-
Accorde à votre appareil l'autorisation de se connecter au AWS IoT courtier de messages avec n'importe quel identifiant client.
iot:Publish
-
Accorde à votre appareil l'autorisation de publier un MQTT message sur n'importe quel MQTT sujet.
iot:Subscribe
-
Accorde à votre appareil l'autorisation de s'abonner à n'importe quel filtre de MQTT sujet.
iot:Receive
-
Accorde à votre appareil l'autorisation de recevoir des messages du AWS IoT courtier de messages sur n'importe quel MQTT sujet.
-
Sélectionnez Create (Créer).
Pour créer un objet IoT, une clé privée et un certificat pour votre appareil
-
Naviguez jusqu'au AWS IoT console
. -
Dans le volet de navigation, choisissez Gérer, puis Objets.
-
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.
-
À propos de la création AWS IoT page d'objets, choisissez Create a single thing.
-
Sur la page Ajouter l'appareil au registre d'objets, saisissez un nom pour votre objet, puis choisissez Suivant.
-
Sur la page Ajouter un certificat à votre objet, sous Création de certificat en un clic, choisissez Créer un certificat.
-
Téléchargez votre clé privée et votre certificat en choisissant les liens Télécharger de chacun d'eux.
-
Choisissez Activer pour activer votre certificat. Les certificats doivent être activés avant utilisation.
-
Choisissez Joindre une politique pour associer une politique à votre certificat qui accorde à votre appareil l'accès à AWS IoT opérations.
-
Choisissez la stratégie que vous venez de créer, puis choisissez Enregistrer l'objet.
Une fois que votre forum est enregistré auprès de AWS IoT, vous pouvez continuerTéléchargement gratuit RTOS.
Téléchargement gratuit RTOS
Vous pouvez télécharger Free RTOS depuis le RTOS GitHub référentiel Free
Après avoir téléchargé FreeRTOS, vous pouvez continuer versConfiguration des RTOS démos gratuites.
Configuration des RTOS démos gratuites
Vous devez modifier certains fichiers de configuration dans votre RTOS répertoire Free avant de pouvoir compiler et exécuter des démos sur votre tableau.
Pour configurer votre AWS IoT point de terminaison
Vous devez fournir RTOS à Free votre AWS IoT point de terminaison afin que l'application exécutée sur votre carte puisse envoyer des demandes au point de terminaison approprié.
-
Naviguez jusqu'au AWS IoT console
. -
Dans le panneau de navigation de gauche, choisissez Paramètres.
Votre AWS IoT le point de terminaison est affiché dans le point de terminaison des données du périphérique Elle doit ressembler à
. Prenez note de ce point de terminaison.1234567890123
-ats.iot.us-east-1
.amazonaws.com -
Dans le volet de navigation, choisissez Gérer, puis Objets.
Votre appareil doit être doté d'un AWS IoT nom de la chose. Notez ce nom.
-
Ouvrir
demos/include/aws_clientcredential.h
. -
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 les paramètres Wi-Fi
Si votre tableau se connecte à Internet via une connexion Wi-Fi, vous devez fournir à Free RTOS des informations d'identification Wi-Fi pour vous connecter au réseau. Si votre carte ne prend pas en charge le Wi-Fi, vous pouvez ignorer ces étapes.
-
demos/include/aws_clientcredential.h
. -
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
(WEPsécurité) -
eWiFiSecurityWPA
(WPAsécurité) -
eWiFiSecurityWPA2
(WPA2sécurité)
-
-
Pour formater votre AWS IoT informations d'identification
Free RTOS doit avoir le AWS IoT certificat et clés privées associés à votre objet enregistré et à ses politiques d'autorisation pour communiquer avec succès AWS IoT au nom de votre appareil.
Note
Pour configurer votre AWS IoT informations d'identification, vous devez disposer de la clé privée et du certificat que vous avez téléchargés depuis AWS IoT console lorsque vous avez enregistré votre appareil. Après avoir enregistré votre appareil en tant que AWS IoT chose, vous pouvez récupérer les certificats de l'appareil à partir du AWS IoT console, mais vous ne pouvez pas récupérer les clés privées.
Free RTOS 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.
-
Dans une fenêtre du navigateur, ouvrez
tools/certificate_configuration/CertificateConfigurator.html
. -
Sous PEMFichier de certificat, sélectionnez le fichier
que vous avez téléchargé à partir du AWS IoT console.ID
-certificate.pem.crt -
Sous PEMFichier de clé privée, choisissez le fichier
que vous avez téléchargé à partir du AWS IoT console.ID
-private.pem.key -
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. Les applications de niveau production 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 Manuels de mise en route spécifiques aux cartes. L'application de démonstration utilisée dans le didacticiel Getting Started est la démo principale de l'authentification MQTT mutuelle, qui se trouve à l'adressedemos/coreMQTT/mqtt_demo_mutual_auth.c
.