Premiers pas

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 de AWS 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 la AWS région correspondant à votre AWS compte, utilisez le AWS Command Line Interface. Pour installer le AWS CLI, suivez les instructions du Guide de l'AWS Command Line Interface utilisateur. 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.

2. Accédez à la console AWS IoT.

3. Dans le volet de navigation, choisissez successivement Sécurisé, Stratégies et Créer.

4. Entrez un nom pour identifier votre stratégie.

5. 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 identifiant 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 .

6. 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.

2. Dans le volet de navigation, choisissez Gérer, puis Objets.

3. 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.

4. Sur la page Création d' AWS IoT objets, choisissez Créer un seul objet.

5. Sur la page Ajouter l'appareil au registre d'objets, saisissez un nom pour votre objet, puis choisissez Suivant.

6. Sur la page Ajouter un certificat pour votre objet, sous Création One-click d'un certificat, choisissez Créer un certificat.

7. Téléchargez votre clé privée et votre certificat en choisissant les liens Télécharger de chacun d'eux.

8. Choisissez Activer pour activer votre certificat. Les certificats doivent être activés avant utilisation.

9. Choisissez Joindre une politique pour joindre à votre certificat une politique qui autorise votre appareil à accéder aux AWS IoT opérations.

10. Choisissez la stratégie que vous venez de créer, puis choisissez Enregistrer l'objet.

Pour configurer votre AWS IoT point de terminaison

Vous devez fournir à FreeRTOS votre AWS IoT terminal afin que l'application exécutée sur votre tableau puisse envoyer des requêtes au bon terminal.

1. Accédez à la console AWS IoT.

2. Dans le panneau de navigation de gauche, choisissez Paramètres.

   Votre AWS IoT point de terminaison s'affiche dans Terminaison des données de l'appareil. Elle doit ressembler à 1234567890123-ats.iot.us-east-1.amazonaws.com. Prenez note de ce point de terminaison.

3. Dans le volet de navigation, choisissez Gérer, puis Objets.

   Votre appareil doit avoir un nom d' AWS IoT objet. Notez ce nom.

4. Ouvrir demos/include/aws_clientcredential.h.

5. 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 carte se connecte à Internet via une Wi-Fi connexion, vous devez fournir à FreeRTOS des Wi-Fi informations d'identification pour vous connecter au réseau. Si votre forum n'est pas compatible Wi-Fi, vous pouvez ignorer ces étapes.

1. demos/include/aws_clientcredential.h.

2. 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 du AWS IoT certificat et des clés privées associés à votre objet enregistré et de ses politiques d'autorisations pour pouvoir communiquer avec succès au AWS IoT nom de votre appareil.

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.

2. 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 .

3. 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 .

4. 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é.