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.
# Démarrez avec la solution groupée Microchip Curiosity PIC32MZ EF
**Important**
Cette intégration de référence est hébergée sur le 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)
**Note**
En accord avec Microchip, nous retirons le Curiosity PIC32MZEF (DM320104) de la branche principale du référentiel FreeRTOS Reference Integration et ne le proposerons plus dans les nouvelles versions. Microchip a publié un [avis officiel](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104) indiquant que le PIC32MZEF (DM320104) n'est plus recommandé pour les nouveaux modèles. Les projets et le code source PIC32MZEF sont toujours accessibles via les balises de version précédentes. Microchip recommande aux clients d'utiliser la [carte de PIC32MZ-EF-2.0 développement Curiosity (DM320209) pour les nouvelles conceptions](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board). La plate-forme Pic32MZv1 se trouve toujours dans la version [v202012.00](https://github.com/aws/amazon-freertos/tree/202012.00) du référentiel FreeRTOS Reference Integration. Cependant, la plateforme n'est plus prise en charge par la version [v202107.00 du](https://github.com/aws/amazon-freertos/tree/202107.00) FreeRTOS Reference.
Ce didacticiel fournit des instructions pour démarrer avec le Microchip Curiosity PIC32MZ EF. [Si vous ne possédez pas le pack Microchip Curiosity PIC32MZ EF, consultez le catalogue des appareils AWS partenaires pour en acheter un auprès de notre partenaire.](https://devices.amazonaws.com/detail/a3G0L00000AANscUAH/Curiosity-PIC32MZ-EF-Amazon-FreeRTOS-Bundle)
La solution groupée inclut les éléments suivants :
+ [Carte de développement Curiosity PIC32MZ EF](https://www.microchip.com/Developmenttools/ProductDetails/DM320104)
+ [MikroElectronika Tableau de clic USB UART](https://www.mikroe.com/usb-uart-click)
+ [MikroElectronika WiFi Tableau en 7 clics](https://www.mikroe.com/wifi-7-click)
+ [Carte fille PIC32 LAN8720 PHY](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ac320004-3)
Vous avez également besoin des éléments suivants pour le débogage :
+ [Débogueur MPLAB Snap In-Circuit ](https://www.microchip.com/Developmenttools/ProductDetails/PG164100)
+ (Facultatif) [PICkit 3 Programming Cable Kit](https://www.microchip.com/TPROG001)
Avant de commencer, vous devez configurer AWS IoT et télécharger FreeRTOS pour connecter votre appareil au Cloud. AWS Pour obtenir des instructions, consultez [Premiers pas](freertos-prereqs.md).
**Important**
Dans cette rubrique, le chemin d'accès au répertoire de téléchargement de FreeRTOS est appelé. `{{freertos}}`
Les espaces dans le chemin d’accès `{{freertos}}` peuvent provoquer des échecs de construction. Lorsque vous clonez ou copiez le référentiel, assurez-vous que le chemin d'accès que vous créez ne contient pas d'espaces.
La longueur maximale d'un chemin sous Microsoft Windows est de 260 caractères. Les longs chemins de répertoire de téléchargement de FreeRTOS peuvent provoquer des échecs de compilation.
Le code source pouvant contenir des liens symboliques, si vous utilisez Windows pour extraire l'archive, vous devrez peut-être :
Activez [le mode développeur](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) ou,
Utilisez une console élevée en tant qu'administrateur.
Ainsi, Windows peut créer correctement des liens symboliques lors de l'extraction de l'archive. Dans le cas contraire, les liens symboliques seront écrits sous forme de fichiers normaux contenant les chemins des liens symboliques sous forme de texte ou seront vides. Pour plus d'informations, consultez le billet de blog [Symlinks in Windows 10 \!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) .
Si vous utilisez Git sous Windows, vous devez activer le mode développeur ou vous devez :
Définissez `core.symlinks` ce paramètre sur true à l'aide de la commande suivante :
```
git config --global core.symlinks true
```
Utilisez une console élevée en tant qu'administrateur chaque fois que vous utilisez une commande git qui écrit sur le système (par exemple**git pull**,**git clone**, et**git submodule update --init --recursive**).
## Présentation de
Ce didacticiel comprend les instructions de mise en route suivantes :
1. Connexion de votre carte à un appareil hôte.
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.
1. Interaction avec l’application s’exécutant sur votre carte via une connexion série, à des fins de surveillance et de débogage.
## Configurer le matériel Microchip Curiosity PIC32MZ EF
1. Connectez la carte MikroElectronika USB UART Click au connecteur MicroBus 1 du Microchip Curiosity PIC32MZ EF.
1. Connectez la carte fille PIC32 LAN8720 PHY au connecteur J18 de Microchip Curiosity PIC32MZ EF.
1. Connectez la carte MikroElectronika USB UART Click à votre ordinateur à l'aide d'un câble USB A vers USB mini-B.
1. Pour connecter votre carte à Internet, utilisez l'une des options suivantes :
+ Pour l'utiliser **Wi-Fi**, connectez la carte MikroElectronika Wi-Fi 7 clics au connecteur MicroBus 2 du Microchip Curiosity PIC32MZ EF. Consultez [Configuration des démos de FreeRTOS](freertos-prereqs.md#freertos-configure).
+ Pour utiliser **Ethernet** afin de connecter la carte Microchip Curiosity PIC32MZ EF à Internet, connectez la carte fille PIC32 LAN8720 PHY au connecteur J18 sur la carte Microchip Curiosity PIC32MZ EF. Connectez une extrémité du câble Ethernet à la carte fille LAN8720 PHY. Connectez l'autre extrémité à votre routeur ou autre port Internet. Vous devez également définir la macro `PIC32_USE_ETHERNET` du préprocesseur.
1. Si ce n'est pas déjà fait, soudez le connecteur d'angle au connecteur ICSP de la carte Curiosity PIC32MZ EF.
1. Connectez une extrémité du câble ICSP du PICkit 3 Programming Cable Kit à la carte Microchip Curiosity PIC32MZ EF.
Si vous n'avez pas le kit de câbles de programmation PickIt 3, vous pouvez utiliser des sauteurs de fil M-F Dupont pour câbler la connexion à la place. Notez que le cercle blanc indique la position de la broche 1.
1. Connectez l'autre extrémité du câble ICSP (ou cavaliers) au MPLAB Snap Debugger. La broche 1 du connecteur SIL Programming Connector à 8 broches est signalée par le triangle noir en bas à droite de la carte mère.
Assurez-vous que l'ensemble du câblage vers la broche 1 sur la carte Curiosity PIC32MZ EF, signalée par le cercle blanc, est aligné avec la broche 1 du MPLAB Snap Debugger.
Pour plus d'informations sur le MPLAB Snap Debugger, consultez la fiche d'information du [MPLAB](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Snap%20In-Circuit%20Debugger%20IS%20DS50002787A.pdf) Snap Debugger. In-Circuit
## Configuration du matériel Microchip Curiosity PIC32MZ EF à l'aide de PicKit On Board (PKOB)
Nous vous recommandons de suivre la procédure de configuration décrite dans la section précédente. Cependant, vous pouvez évaluer et exécuter des démos FreeRTOS avec un débogage de base à l'aide du PickIt On Board (PKOB) intégré en suivant ces étapes. programmer/debugger
1. Connectez la carte MikroElectronika USB UART Click au connecteur MicroBus 1 du Microchip Curiosity PIC32MZ EF.
1. Pour connecter votre carte à Internet, effectuez l'une des opérations suivantes :
+ Pour l'utiliser **Wi-Fi**, connectez la carte MikroElectronika Wi-Fi 7 clics au connecteur MicroBus 2 du Microchip Curiosity PIC32MZ EF. (Suivez les étapes « Pour configurer votre Wi-Fi » dans[Configuration des démos de FreeRTOS](freertos-prereqs.md#freertos-configure).
+ Pour utiliser **Ethernet** afin de connecter la carte Microchip Curiosity PIC32MZ EF à Internet, connectez la carte fille PIC32 LAN8720 PHY au connecteur J18 sur la carte Microchip Curiosity PIC32MZ EF. Connectez une extrémité du câble Ethernet à la carte fille LAN8720 PHY. Connectez l'autre extrémité à votre routeur ou autre port Internet. Vous devez également définir la macro `PIC32_USE_ETHERNET` du préprocesseur.
1. Connectez le port USB micro-B nommé « USB DEBUG » de la carte Microchip Curiosity PIC32MZ EF à votre ordinateur au moyen d'un câble USB type A vers USB micro-B.
1. Connectez la carte MikroElectronika USB UART Click à votre ordinateur à l'aide d'un câble USB A vers USB mini-B.
## Configurer votre environnement de développement.
**Note**
Le projet FreeRTOS pour cet appareil est basé sur MPLAB Harmony v2. Pour créer le projet, vous devez utiliser des versions des outils MPLAB compatibles avec Harmony v2, comme la version 2.10 du compilateur MPLAB XC32 et les versions 2. X.X du configurateur MPLAB Harmony (MHC).
1. Installez [Python version 3.x](https://www.python.org/downloads/) ou une version ultérieure.
1. Installez l'IDE MPLAB X :
**Note**
AWS FreeRTOS Reference Integrations v202007.00 n'est actuellement pris en charge que sur. MPLabv5.35 Les versions précédentes des intégrations de référence AWS FreeRTOS sont prises en charge sur. MPLabv5.40
**MPLabv5.35 téléchargements**
+ [Environnement de développement intégré MPLAB X pour Windows](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-windows-installer.exe)
+ [Environnement de développement intégré MPLAB X pour macOS](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-osx-installer.dmg)
+ [Environnement de développement intégré MPLAB X pour Linux](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-linux-installer.tar)
**Derniers téléchargements de MPlab () MPLabv5.40**
+ [Environnement de développement intégré (IDE) MPLAB X pour Windows](http://www.microchip.com/mplabx-ide-windows-installer)
+ [Environnement de développement intégré (IDE) MPLAB X pour macOS](http://www.microchip.com/mplabx-ide-osx-installer)
+ [Environnement de développement intégré (IDE) MPLAB X pour Linux](http://www.microchip.com/mplabx-ide-linux-installer)
1. Installez le compilateur MPLAB XC32 :
+ [Compilateur XC32/32 MPLAB\+\+ pour Windows](http://www.microchip.com/mplabxc32windows)
+ [Compilateur XC32/32 MPLAB\+\+ pour macOS](http://www.microchip.com/mplabxc32osx)
+ [Compilateur MPLAB XC32/32 \+\+ pour Linux](http://www.microchip.com/mplabxc32linux)
1. Démarrez un émulateur de terminal UART et ouvrez une connexion avec les paramètres suivants :
+ Vitesse de transmission : 115200
+ Données : 8 bits
+ Parité : aucune
+ Bits d'arrêt : 1
+ Contrôle de flux : aucun
## Surveillance des messages MQTT dans le cloud
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 AWS IoT Client 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 \! » envoyé plusieurs fois au sujet auquel vous vous êtes abonné.
## Créez et exécutez le projet de démonstration FreeRTOS
### Ouvrez la démo FreeRTOS dans l'IDE MPLAB
1. Ouvrez l'IDE MPLAB. Si vous avez plusieurs versions de compilateur installées, vous devez sélectionner le compilateur que vous souhaitez utiliser à partir de l'IDE.
1. Dans le menu **Fichier**, choisissez **Nouveau projet**.
1. Accédez à `projects/microchip/curiosity_pic32mzef/mplab/aws_demos` et ouvrez-le.
1. Choisissez **Open Project (Ouvrir un projet)**.
**Note**
Lorsque vous ouvrez le projet pour la première fois, vous pouvez recevoir un message d'erreur sur le compilateur. Dans l'IDE, accédez à **Outils**, **Options**, **Intégré**, puis sélectionnez le compilateur que vous utilisez pour votre projet.
Pour utiliser Ethernet pour la connexion, vous devez définir la macro `PIC32_USE_ETHERNET` du préprocesseur.
**Pour utiliser Ethernet pour se connecter à l'aide de l'IDE MPLAB**
1. **Dans l'IDE MPLAB, cliquez avec le bouton droit sur le projet et sélectionnez Propriétés.**
1. Dans la boîte de dialogue **Propriétés du projet**, choisissez **{{compiler-name}}(Options globales)** pour le développer, puis sélectionnez **{{compiler-name}}-gcc**.
1. Pour les **catégories Options**, choisissez **Prétraitement et messages**, puis ajoutez la `PIC32_USE_ETHERNET` chaîne aux macros du **préprocesseur**.
### Exécutez le projet de démonstration FreeRTOS
1. Générez une nouvelle build pour votre projet.
1. Sous l'onglet **Projects (Projets)**, cliquez avec le bouton droit sur le dossier de niveau supérieur `aws_demos`, puis choisissez **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)**.
### Créez la démo de FreeRTOS avec CMake
Si vous préférez ne pas utiliser d'IDE pour le développement de FreeRTOS, vous pouvez également utiliser CMake 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.
**Pour créer la démo de FreeRTOS avec CMake**
1. Créez un répertoire pour contenir les fichiers de compilation générés, tels que{{build-directory}}.
1. Utilisez la commande suivante pour générer des fichiers de compilation à partir du code source.
```
cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH={{path}}/microchip/mplabx/{{version}}/mplab_platform/bin -DAFR_TOOLCHAIN_PATH={{path}}/microchip/xc32/{{version}}/bin -S {{freertos}} -B {{build-folder}}
```
**Note**
Vous devez spécifier les chemins corrects vers les fichiers binaires d'Hexmate et de la chaîne d'outils, tels que les `C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin` chemins et. `C:\Program Files\Microchip\xc32\v2.40\bin`
1. Remplacez les répertoires par le répertoire build ({{build-directory}}), puis exécutez-les `make` à partir de ce répertoire.
Pour de plus amples informations, veuillez consulter [Utilisation de CMake avec FreeRTOS](getting-started-cmake.md).
Pour utiliser Ethernet pour la connexion, vous devez définir la macro `PIC32_USE_ETHERNET` du préprocesseur.
## Résolution des problèmes
Pour plus d’informations sur le dépannage, consultez [Résolution des problèmes de mise en route](gsg-troubleshooting.md).