View a markdown version of this page

Démarrez avec la solution groupée Microchip Curiosity PIC32MZ EF - FreeRTOS
Présentation deConfigurer le matériel Microchip Curiosity PIC32MZ EFConfiguration du matériel Microchip Curiosity PIC32MZ EF à l'aide de PicKit On Board (PKOB)Configurer votre environnement de développement.Surveillance des messages MQTT dans le cloudCréez et exécutez le projet de démonstration FreeRTOSRésolution des problèmes

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

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 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. La plate-forme Pic32MZv1 se trouve toujours dans la version v202012.00 du référentiel FreeRTOS Reference Integration. Cependant, la plateforme n'est plus prise en charge par la version v202107.00 du 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.

La solution groupée inclut les éléments suivants :

Vous avez également besoin des éléments suivants pour le débogage :

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.

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 :

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

    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 exemplegit pull,git clone, etgit 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.

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

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

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

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

  2. Connectez la carte fille PIC32 LAN8720 PHY au connecteur J18 de Microchip Curiosity PIC32MZ EF.

  3. Connectez la carte MikroElectronika USB UART Click à votre ordinateur à l'aide d'un câble USB A vers USB mini-B.

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

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

  5. Si ce n'est pas déjà fait, soudez le connecteur d'angle au connecteur ICSP de la carte Curiosity PIC32MZ EF.

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

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

  2. 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 » dansConfiguration des démos de FreeRTOS.

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

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

  4. 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 ou une version ultérieure.

  2. 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
    Derniers téléchargements de MPlab () MPLabv5.40

  3. Installez le compilateur MPLAB XC32 :

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

  2. Dans le volet de navigation, choisissez Test, puis choisissez MQTT test client 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 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.

  2. Dans le menu Fichier, choisissez Nouveau projet.

  3. Accédez à projects/microchip/curiosity_pic32mzef/mplab/aws_demos et ouvrez-le.

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

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

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

  2. Sous l'onglet Projects (Projets), cliquez avec le bouton droit sur le dossier de niveau supérieur aws_demos, puis choisissez Debug (Déboguer).

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

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

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

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.