Démarrez avec la solution groupée Microchip Curiosity PIC32MZ EF - Gratuit RTOS
PrésentationConfigurer 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 référentiel Amazon-FreeRTOS, qui est obsolète. Nous vous recommandons de commencer par là. Si vous possédez déjà un projet FreeRTOS basé sur le référentiel Amazon-FreeRTOS, désormais obsolète, consultez leGuide de migration du référentiel RTOS Github gratuit sur Amazon.

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 des versions précédentes. Microchip recommande à ses clients d'utiliser la carte de développement Curiosity PIC32MZ-EF-2.0 (DM320209) pour leurs nouveaux designs. La plateforme PIC32MZv1 se trouve toujours dans la version 202012.00 du référentiel FreeRTOS Reference Integration. Cependant, la plate-forme n'est plus prise en charge par la version 202107.00 de 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 d'appareilsAWS 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 configurerAWS IoT et télécharger FreeRTOS pour connecter votre appareil auAWS Cloud. 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.

  • Comme le code source peut contenir des liens symboliques, si vous utilisez Windows pour extraire l'archive, vous devrez peut-être :

    De cette façon, 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 étant vides. Pour plus d'informations, consultez le billet de blog sur les liens symboliques de Windows 10 ! .

    Si vous utilisez Git sous Windows, vous devez activer le mode développeur ou vous devez :

    • Définissezcore.symlinks la valeur sur true à l'aide de la commande suivante :

      git config --global core.symlinks true

    • Utilisez une console ayant le statut d'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

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. Connect la carte MikroElectronika USB UART 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. Connect le Click Board MikroElectronika USB UART à 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 utiliser le Wi-Fi, connectez le MikroElectronika Wi-Fi 7 Click Board au connecteur MicroBus 2 du Microchip Curiosity PIC32MZ EF. Consultez Configuration des RTOS démos gratuites.

    • 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 du préprocesseurPIC32_USE_ETHERNET.

  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 ne disposez pas du PICkit 3 Programming Cable Kit, vous pouvez utiliser des cavaliers de câble M-F Dupont pour établir la connexion. 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 débogueur MPLAB Snap, consultez la fiche d'information sur le débogueur MPLAB Snap 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. Toutefois, vous pouvez évaluer et exécuter des démos FreeRTOS avec un débogage de base à l'aide du programmeur/débogueur PickIt On Board (PKOB) intégré en suivant ces étapes.

  1. Connect la carte MikroElectronika USB UART au connecteur MicroBus 1 du Microchip Curiosity PIC32MZ EF.

  2. Pour connecter votre carte à Internet, effectuez l'une des opérations suivantes :

    • Pour utiliser le Wi-Fi, connectez le MikroElectronika Wi-Fi 7 Click Board au connecteur MicroBus 2 du Microchip Curiosity PIC32MZ EF. (Suivez les étapes « Pour configurer les paramètres Wi-Fi » dans Configuration des RTOS démos gratuites).

    • 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 du préprocesseurPIC32_USE_ETHERNET.

  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. Connect le Click Board MikroElectronika USB UART à 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 générer le projet, vous devez utiliser les versions des outils qui sont compatibles avec MPLAB Harmony v2, comme v2.10 du MPLAB XC32 Compiler et les versions 2.X.X MPLAB Harmony de l'outil de configuration (CMH).

  1. Installez Python version 3.x ou une version ultérieure.

  2. Installez l'IDE MPLAB X :

    Note

    FreeRTOSAWS Reference Integrations v202007.00 n'est actuellement pris en charge que sur MPLabv5.35. Les versions antérieures de FreeRTOSAWS Reference Integrations sont prises en charge sur MPLabv5.40.

    MPLAb v5.35 téléchargements
    Derniers téléchargements de MPlab (MPLAb v5.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 de 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, le message « Hello World ! » s'affiche 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 de 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 vous connecter, vous devez définir la macro du préprocesseurPIC32_USE_ETHERNET.

Pour utiliser Ethernet pour vous connecter à l'aide de l'IDE MPLAB

  1. Dans l'IDE MPLAB, cliquez avec le bouton droit sur le projet et choisissez Propriétés.

  2. Dans la boîte de dialogue Propriétés du projet, choisissez le nom du compilateur (Options globales) pour le développer, puis sélectionnez nom-compilateur -gcc.

  3. Pour les catégories Options, choisissez Prétraitement et messages, puis ajoutez laPIC32_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 contenant les fichiers de construction générés, tel que build-directory.

  2. Utilisez la commande suivante pour générer des fichiers de construction à 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 Hexmate et de la chaîne d'outils, tels que lesC:\Program Files\Microchip\xc32\v2.40\bin cheminsC:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin et.

  3. Remplacez les répertoires par le répertoire de construction (répertoire de construction), puis exécutezmake à partir de ce répertoire.

Pour plus d'informations, veuillez consulter Utilisation de CMake avec FreeRTOS.

Pour utiliser Ethernet pour vous connecter, vous devez définir la macro du préprocesseurPIC32_USE_ETHERNET.

Résolution des problèmes

Pour plus d'informations sur le dépannage, consultez Résolution des problèmes de mise en route.