Mise en route avec le simulateur d'appareils Windows

Ce didacticiel fournit des instructions pour démarrer avec le simulateur de périphériques FreeRTOS Windows.

Avant de commencer, vous devez configurerAWS IoT et télécharger FreeRTOS pour connecter votre appareil auAWS Cloud. Pour obtenir des instructions, consultez Premiers pas. Dans ce didacticiel, le chemin d'accès au répertoire de téléchargement de FreeRTOS est appeléfreertos.

FreeRTOS est publié sous la forme d'un fichier zip qui contient les bibliothèques FreeRTOS et des exemples d'applications pour la plate-forme que vous spécifiez. Pour exécuter les exemples sur un ordinateur Windows, téléchargez les bibliothèques et les exemples portés à exécuter sur Windows. Cet ensemble de fichiers est désigné comme le simulateur FreeRTOS pour Windows.

Note

didacticiel ne peut pas être exécuté correctement sur les instances Windows Amazon EC2.

Configurer votre environnement de développement.

1. Installez la dernière version de Npcap. Sélectionnez le « ModeWinPcap compatible API » lors de l'installation.

2. Installez Microsoft Visual Studio.

   Les versions Visual Studio 2017 et 2019 fonctionnent. Toutes les éditions de ces versions de Visual Studio sont prises en charge (Community, Professionnel ou Entreprise).

   En plus de l'IDE, installez le composant Développement de bureau avec C++.

   Installez le dernier kit SDK Windows 10. Vous pouvez le choisir sous la section Facultatif du composant Développement de bureau avec C++.

3. Assurez-vous que vous avez une connexion Ethernet câblée active.

4. (Facultatif) Si vous souhaitez utiliser le système de génération basé sur CMake pour créer vos projets FreeRTOS, installez la dernière version de CMake. FreeRTOS nécessite la version 3.13 ou ultérieure de CMake.

Surveillance des messages MQTT dans le cloud

Avant de lancer le projet de démonstration FreeRTOS, vous pouvez configurer le client MQTT dans laAWS IoT console pour surveiller les messages que votre appareil envoie auAWS Cloud.

Pour vous abonner à la rubrique MQTT avec le client MQTT AWS IoT

1. Connectez-vous à la console AWS IoT.

2. Dans le volet de navigation, choisissez Test, puis choisissez le client de test MQTT pour ouvrir le client MQTT.

3. Dans le champ Rubrique d'abonnement, saisissez your-thing-name/example/topic, puis choisissez S'abonner à la rubrique.

Lorsque le projet de démonstration s'exécute correctement sur votre appareil, vous pouvez voir « Hello World ! » envoyé plusieurs fois au sujet auquel vous vous êtes abonné.

Créez et exécutez le projet de démonstration FreeRTOS

Vous pouvez utiliser Visual Studio ou CMake pour créer des projets FreeRTOS.

Création et exécution du projet de démonstration FreeRTOS avec l'IDE Visual Studio

1. Chargez le projet dans Visual Studio.

   Dans Visual Studio, dans le menu Fichier, choisissez Ouvrir. Choisissez Fichier/solution, accédez à projects/pc/windows/visual_studio/aws_demos/aws_demos.sln, puis choisissez Ouvrir.

2. Reciblez le projet de démonstration.

   Le projet de démonstration fourni dépend du kit SDK Windows, mais il n'a pas de version du kit SDK Windows spécifiée. Par défaut, l'IDE peut tenter de générer la démonstration avec une version du kit SDK qui n'est pas présente sur votre ordinateur. Pour définir la version du kit SDK Windows, cliquez avec le bouton droit de la souris sur aws_demos puis choisissez Recibler les projets. Cette opération permet d'ouvrir la fenêtre Examiner les actions de la solution. Choisissez une version du SDK Windows présente sur votre ordinateur (la valeur initiale dans la liste déroulante convient), puis choisissez OK.

3. Créez et exécutez le projet.

   Dans le menu Générer, choisissez Générer la solution, et assurez-vous que la solution est générée sans erreurs ou avertissements. Choisissez Dégoguer, Démarrer le débogage pour exécuter le projet. Lors de la première exécution, vous devez sélectionner une interface réseau.

Création et exécution du projet de démonstration FreeRTOS avec CMake

Nous vous recommandons d'utiliser l'interface graphique de CMake au lieu de l'outil de ligne de commande CMake pour créer le projet de démonstration pour le simulateur Windows.

Une fois que vous avez installé CMake, ouvrez son interface utilisateur graphique. Sous Windows, vous pouvez la trouver dans le menu Démarrer sous CMake, CMake (cmake-gui).

1. Définissez le répertoire du code source de FreeRTOS.

   Dans l'interface graphique, définissez le répertoire du code source FreeRTOS (freertos) pour Where is the source code.

   Définissez freertos/build pour Where to build the binaries (Où générer les fichiers binaires).

2. Configurez le projet CMake.

   Dans l'interface utilisateur graphique de CMake, choisissez Ajouter une entrée, puis dans la fenêtre Ajouter une entrée de cache, définissez les valeurs suivantes :

   Nom

   AFR_BOARD

   Type

   CHAÎNE

   Valeur

   pc.windows

   Description

   (Facultatif)

3. Choisissez Configure (Configurer). Si CMake vous invite à créer le dossier de génération, choisissez Oui, puis sélectionnez un générateur sous Spécifier le générateur pour ce projet. Nous vous recommandons d'utiliser Visual Studio comme générateur, mais Ninja est également pris en charge. (Notez que lorsque vous utilisez Visual Studio 2019, la plateforme doit être définie sur Win32 au lieu de son paramètre par défaut.) Conservez les autres options du générateur inchangées et choisissez Terminer.

4. Générer et ouvrez le projet CMake.

   Une fois que vous avez configuré le projet, l'interface utilisateur graphique de CMake affiche toutes les options disponibles pour le projet généré. Dans le cadre de didacticiel, vous pouvez conserver les valeurs par défaut des options.

   Choisissez Générer pour créer une solution Visual Studio, puis choisissez Ouvrir le projet pour ouvrir le projet dans Visual Studio.

   Dans Visual Studio, cliquez avec le bouton droit sur leaws_demos projet et choisissez Définir comme StartUp projet. Cela vous permet de générer et d'exécuter le projet. Lors de la première exécution, vous devez sélectionner une interface réseau.

Pour plus d'informations sur l'utilisation de CMake avec FreeRTOS, consultezUtilisation de CMake avec FreeRTOS.

Configurer votre interface réseau

Lors de la première exécution du projet de démonstration, vous devez sélectionner l'interface réseau à utiliser. Le programme compte vos interfaces réseau. Recherchez le numéro de votre interface Ethernet câblée. La sortie doit se présenter comme suit :

0 0 [None] FreeRTOS_IPInit
1 0 [None] vTaskStartScheduler
1. rpcap://\Device\NPF_{AD01B877-A0C1-4F33-8256-EE1F4480B70D}
(Network adapter 'Intel(R) Ethernet Connection (4) I219-LM' on local host)

2. rpcap://\Device\NPF_{337F7AF9-2520-4667-8EFF-2B575A98B580}
(Network adapter 'Microsoft' on local host)

The interface that will be opened is set by "configNETWORK_INTERFACE_TO_USE", which
should be defined in FreeRTOSConfig.h

ERROR:  configNETWORK_INTERFACE_TO_USE is set to 0, which is an invalid value.
Please set configNETWORK_INTERFACE_TO_USE to one of the interface numbers listed above,
then re-compile and re-start the application.  Only Ethernet (as opposed to Wi-Fi)
interfaces are supported.

Une fois que vous avez identifié le numéro de votre interface Ethernet câblée, fermez la fenêtre de l'application. Dans l'exemple précédent, le nombre à utiliser est1.

Ouvrez FreeRTOSConfig.h et définissez configNETWORK_INTERFACE_TO_USE sur le numéro correspondant à votre interface réseau câblée.

Important

Seules les interfaces Ethernet sont prises en charge. Le Wi-Fi n'est pas pris en charge.

Résolution des problèmes

Dépannage des problèmes courants sur Windows

Vous rencontrerez peut-être l'erreur suivante en tenant de générer le projet de démonstration avec Visual Studio :

Error "The Windows SDK version X.Y was not found" when building the provided Visual Studio solution.

Le projet doit être ciblé sur une version du kit SDK Windows présente sur votre ordinateur.

Pour obtenir des informations de dépannage générales sur la mise en route avec FreeRTOS, consultezRésolution des problèmes de mise en route.