

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.

# Commencer à utiliser le nœud IoT STMicroelectronics STM32 L4 Discovery Kit
<a name="getting_started_st"></a>

**Important**  <a name="deprecation-message"></a>
Cette intégration de référence est hébergée sur le référentiel Amazon-FreeRTOS, 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 Amazon-FreeRTOS, désormais obsolète, consultez le. [Guide de migration du référentiel Github d'Amazon-FreeRTOS](github-repo-migration.md)

Ce didacticiel fournit des instructions pour démarrer avec le nœud IoT du kit STMicroelectronics STM32 L4 Discovery. Si vous ne possédez pas encore le nœud IoT STMicroelectronics STM32 L4 Discovery Kit, consultez le catalogue des appareils AWS partenaires pour en acheter un auprès de notre [partenaire](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node).

Vérifiez que vous avez installé le dernier microprogramme Wi-Fi. Pour télécharger le dernier firmware Wi-Fi, voir [Nœud IoT du kit STM32 L4 Discovery, connexion sans fil basse consommation, Bluetooth Low Energy, NFC, SubGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip) Wi-Fi. Sous **Binary Resources (Ressources binaires)**, choisissez **Inventek ISM 43362 Wi-Fi module firmware update (read the readme file for instructions) (Mise à jour de programme du module Wi-Fi Inventek ISM 43362 [lire le fichier readme pour plus d’informations]**.

Avant de commencer, vous devez configurer AWS IoT votre téléchargement de FreeRTOS et le Wi-Fi pour connecter votre appareil au Cloud. AWS Pour obtenir des instructions, consultez [Premiers pas](freertos-prereqs.md). Dans ce didacticiel, le chemin d'accès au répertoire de téléchargement de FreeRTOS est appelé. `freertos`

## Présentation de
<a name="w2aac31b9b7c25c46c13"></a>

Ce didacticiel comprend les instructions de mise en route suivantes :

1. Installation de logiciels sur la machine hôte pour développer et déboguer des applications intégrées pour votre carte de microcontrôleur.

1. Compilation croisée d'une application de démonstration FreeRTOS en une image binaire.

1. Chargement de l’image binaire de l’application dans votre carte et exécution de l’application.

## Configurer votre environnement de développement.
<a name="st-setup-env"></a>

### Installez System Workbench pour STM32
<a name="install-system-workbench"></a>

1. Accédez à [Open STM32 .org](http://www.openstm32.org/HomePage).

1. Inscrivez-vous sur la STM32 page Web Open. Vous devez vous connecter pour télécharger System Workbench.

1. Accédez au programme d'[ STM32 installation de System Workbench pour](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32) télécharger et installer System Workbench.

Si vous rencontrez des problèmes lors de l'installation, consultez FAQs le [site Web de System Workbench](http://www.openstm32.org/HomePage).

## Créez et exécutez le projet de démonstration FreeRTOS
<a name="st-build-and-run-example"></a>

### Importez la démo de FreeRTOS dans le System Workbench STM32
<a name="st-freertos-import-project"></a><a name="st-import-project"></a>

1. Ouvrez le STM32 System Workbench et entrez le nom du nouvel espace de travail.

1. Dans le menu **File (Fichier)**, choisissez **Import (Importer)**. Développez **General (Général)**, choisissez **Existing Projects into Workspace (Projets existants dans l'espace de travail)**, puis choisissez **Next (Suivant)**.

1. Dans **Select Root Directory**, entrez `projects/st/stm32l475_discovery/ac6/aws_demos`.

1. Le projet `aws_demos` doit être sélectionné par défaut.

1. Choisissez **Terminer** pour importer le projet dans STM32 System Workbench.

1. Dans le menu **Project (Projet)**, choisissez **Build All (Générer tout)**. Confirmez que le projet se compile sans erreurs.

### Surveillance des messages MQTT dans le cloud
<a name="w2aac31b9b7c25c46c17b5"></a>

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

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

1. Connectez-vous à la [console AWS IoT](https://console.aws.amazon.com/iotv2/).

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

1. 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 avec succès sur votre appareil, vous voyez « Hello World \$1 » envoyé plusieurs fois au sujet auquel vous vous êtes abonné.

### Exécutez le projet de démonstration FreeRTOS
<a name="st-run-example"></a>

1. Utilisez un câble USB pour connecter votre nœud IoT STMicroelectronics STM32 L4 Discovery Kit à votre ordinateur. (Consultez la documentation du fabricant fournie avec votre carte pour connaître le port USB approprié à utiliser.)

1. Dans l'**Explorateur de projets**`aws_demos`, cliquez avec le bouton droit de la souris, choisissez **Debug** As, puis choisissez **Ac6 STM32 C/C\$1\$1 Application**.

   Si une erreur de débogage se produit la première fois où une session de débogage est lancée, procédez comme suit :

   1. Dans STM32 System Workbench, dans le menu **Exécuter**, choisissez **Debug** Configurations.

   1. Choisissez **aws\$1demos Debug**. (Vous devrez peut-être étendre le ** STM32 débogage Ac6**.)

   1. Choisissez l'onglet **Debugger (Débogueur)**.

   1. Dans **Configuration Script (Script de configuration)**, choisissez **Show Generator Options (Afficher les options du générateur)**.

   1. Dans **Mode Setup (Configuration du mode)**, définissez **Reset Mode (Mode de réinitialisation)** sur **Software System Reset (Réinitialisation système du logiciel)**. Choisissez **Apply (Appliquer)**, puis **Debug (Déboguer)**. 

1. Lorsque le débogueur s'arrête au point d'arrêt dans `main()`, dans le menu **Run (Exécuter)**, choisissez **Resume (Reprendre)**.

### Utilisation CMake avec FreeRTOS
<a name="w2aac31b9b7c25c46c17b9"></a>

Si vous préférez ne pas utiliser d'IDE pour le développement de FreeRTOS, vous pouvez également l' CMake utiliser pour créer et exécuter les applications de démonstration ou les applications que vous avez développées à l'aide d'éditeurs de code et d'outils de débogage tiers.

Créez d'abord un dossier contenant les fichiers de construction générés (*build-folder*).

Utilisez la commande suivante pour générer des fichiers de build :

```
cmake -DVENDOR=st -DBOARD=stm32l475_discovery -DCOMPILER=arm-gcc -S freertos -B build-folder
```

Si `arm-none-eabi-gcc` ce n'est pas dans le chemin de votre shell, vous devez également définir la `AFR_TOOLCHAIN_PATH` CMake variable. Par exemple :

```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```

Pour plus d'informations sur l'utilisation CMake de FreeRTOS, consultez. [Utilisation CMake avec FreeRTOS](getting-started-cmake.md)

## Résolution des problèmes
<a name="st-troubleshooting"></a>

Si vous voyez les éléments suivants dans la sortie de l'application UART, vous devez mettre à jour le microprogramme du module Wi-Fi :

```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```

Pour télécharger le dernier firmware Wi-Fi, voir [Nœud IoT du kit STM32 L4 Discovery, connexion sans fil basse consommation, Bluetooth Low Energy, NFC, SubGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip) Wi-Fi. Dans **Binary Resources (Ressources binaires)**, choisissez le lien de téléchargement pour **Inventek ISM 43362 Wi-Fi module firmware update**.

Pour obtenir des informations générales sur la résolution des problèmes liés à la prise en main de FreeRTOS, consultez. [Résolution des problèmes de mise en route](gsg-troubleshooting.md)