Commencer avec le kit Cypress CY8CKIT-064S0S2-4343W

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 recommandonscommencez icilorsque 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 leGuide de migration du référentiel Github d'Amazon-FreeRTOS.

Ce didacticiel fournit des instructions pour démarrer avecCY8CKIT-064S0S2-4343Wkit. Si vous n'en avez pas déjà un, vous pouvez utiliser ce lien pour acheter un kit. Vous pouvez également utiliser ce lien pour accéder au guide de l'utilisateur du kit.

Démarrer

Avant de commencer, vous devez configurerAWS IoTet FreeRTOS pour connecter votre appareil auAWSNuage. Pour des instructions, consultez Premiers pas. Une fois que vous aurez rempli les prérequis, vous aurez un package FreeRTOS avecAWS IoT Coreinformations d'identification.

Note

Dans ce didacticiel, le chemin d'accès au répertoire de téléchargement de FreeRTOS créé dans la section « Premiers pas » est appeléfreertos.

Configuration de l'environnement de développement

FreeRTOS fonctionne avec un flux de construction CMake ou Make. Vous pouvez utiliser ModusToolbox pour votre flux de construction Make. Vous pouvez utiliser l'IDE Eclipse fourni avec ModusToolbox ou un IDE partenaire tel que IAR eW-Arm, Arm MDK ou Microsoft Visual Studio Code. L'interface de ligne de commande est compatible avec Windows, macOS et Linux.

Avant de commencer, téléchargez et installez la dernièreModusToolbox logiciel. Pour de plus amples informations, veuillez consulter le .ModusToolbox Guide d'installation.

Outils de mise à jour pour ModusToolbox 2.1 ou version ultérieure

Si vous utilisez ModusToolbox 2.1 Eclipse IDE Pour programmer ce kit, vous devez mettre à jour les outils OpenOCD et firmware-loader.

Dans les étapes suivantes, par défaut,ModusToolboxchemin pour :

• Windows estC:\Users\user_name\ModusToolbox.

• Linux estuser_home/ModusToolboxou où vous choisissez d'extraire le fichier d'archive.

• macOS se trouve dans le dossier Applications du volume que vous sélectionnez dans l'assistant.

Mettre à jour OpenOCD

Ce kit nécessite Cypress OpenOCD 4.0.0 ou version ultérieure pour effacer et programmer correctement la puce.

Pour mettre à jour Cypress OpenOCD

1. Accédez auPage de publication de Cypress OpenOCD.

2. Téléchargez le fichier d'archive correspondant à votre système d'exploitation (Windows/Mac/Linux).

3. Supprimez les fichiers existants dansModusToolbox/tools_2.x/openocd.

4. Remplacez les fichiers dansModusToolbox/tools_2.x/openocdavec le contenu extrait de l'archive que vous avez téléchargée à l'étape précédente.

Mise à jour du chargeur de microprogrammes

Ce kit nécessite Cypress FIRMWARE-Loader 3.0.0 ou version ultérieure.

Pour mettre à jour le chargeur de micrologiciel Cypress

1. Accédez auPage de mise à jour du chargeur de micrologiciels Cypress.

2. Téléchargez le fichier d'archive correspondant à votre système d'exploitation (Windows/Mac/Linux).

3. Supprimez les fichiers existants dansModusToolbox/tools_2.x/fw-loader.

4. Remplacez les fichiers dansModusToolbox/tools_2.x/fw-loaderavec le contenu extrait de l'archive que vous avez téléchargée à l'étape précédente.

Vous pouvez également utiliser CMake pour générer des fichiers de construction de projet à partir du code source de l'application FreeRTOS, créer le projet à l'aide de votre outil de génération préféré, puis programmer le kit à l'aide d'OpenOCD. Si vous préférez utiliser un outil graphique pour programmer avec le flux CMake, téléchargez et installez Cypress Programmer à partir duSolutions de programmation Cypresspage Web. Pour plus d'informations, veuillez consulter Utilisation de CMake avec FreeRTOS.

Configuration du matériel

Pour configurer le matériel du kit, procédez comme suit.

1. Approvisionnez votre kit

   SuivezGuide d'approvisionnement pour le kit CY8CKIT-064S0S2-4343Winstructions pour approvisionner en toute sécurité votre kit pourAWS IoT.

   Ce kit nécessite CySecureTools 3.1.0 ou version ultérieure.

2. Configuration d'une connexion série

   1. Connectez le kit à votre ordinateur hôte.

   2. Le port série USB du kit est automatiquement répertorié sur l'ordinateur hôte. Identifiez le numéro de port. Dans Windows, vous pouvez l'identifier à l'aide duGestionnaire de périphériquessousPorts(COM ET LPT).

   3. Démarrez une fenêtre de terminal série 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

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

Dans cette section, vous allez créer et exécuter la démo.

1. Assurez-vous de suivre les étapes deGuide d'approvisionnement pour le kit CY8CKIT-064S0S2-4343W.

2. Créez la démo de FreeRTOS.

   1. Ouvrez l'IDE Eclipse pour ModusToolbox et choisissez ou créez un espace de travail.

   2. Dans le menu File (Fichier), choisissez Import (Importer).

      ÉlargirGénéral, choisissezProjet existant dans l'espace de travail, puis choisissezSuivant.

   3. DansRépertoire racine, entrezfreertos/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demospuis sélectionnez le nom du projetaws_demos. L'option doit être sélectionnée par défaut.

   4. ChoisissezFinirpour importer le projet dans votre espace de travail.

   5. Créez l'application en effectuant l'une des opérations suivantes :

      • À partir dePanneau rapide, sélectionnezCréation de l'application aws_demos.

      • ChoisissezProjetet choisissezTout construire.

      Assurez-vous que le projet est compilé sans erreur.

3. Surveillance des messages MQTT sur le cloud

   Avant de lancer la démonstration, vous pouvez configurer le client MQTT dansAWS IoTconsole pour surveiller les messages que votre appareil envoie auAWSNuage. Pour vous abonner à la rubrique MQTT avecAWS IoTClient MQTT, procédez comme suit.

   1. Connectez-vous à la console AWS IoT.

   2. Dans le volet de navigation, choisissezTester, puis choisissezClient de test MQTTpour ouvrir le client MQTT.

   3. PourSujet de l'abonnement, entrezyour-thing-name/example/topic, puis choisissezS'abonner au sujet.

4. Exécutez le projet de démonstration FreeRTOS

   1. Sélectionnez le projetaws_demosdans l'espace de travail.

   2. À partir dePanneau rapide, sélectionnezProgramme aws_demos (KitProg3). Cela programme la carte et l'application de démonstration démarre une fois la programmation terminée.

   3. L'état de l'application en cours d'exécution est consultable sur le terminal de ligne de commande. La figure suivante montre une partie de la sortie du terminal.

      

      La démo MQTT publie des messages sur quatre sujets différents (iotdemo/topic/n, où n = 1 à 4) et s'abonne à tous ces sujets pour recevoir les mêmes messages en retour. Lorsqu'un message est reçu, la démo publie un message d'accusé de réception sur le sujetiotdemo/acknowledgements. La liste suivante décrit les messages de débogage qui apparaissent dans la sortie du terminal, avec des références aux numéros de série des messages. Dans la sortie, les détails du pilote hôte WICED (WHD) sont d'abord imprimés sans numérotation de série.

      1. 1 à 4 — L'appareil se connecte au point d'accès (AP) configuré et est approvisionné en se connectant auAWSserveur utilisant le point de terminaison et les certificats configurés.

      2. 5 à 13 — La bibliothèque CoreMQTT est initialisée et le périphérique établit une connexion MQTT.

      3. 14 à 17 — L'appareil s'abonne à tous les sujets pour recevoir en retour les messages publiés.

      4. 18 à 30 — L'appareil publie deux messages et attend de les recevoir en retour. Lorsque chaque message est reçu, l'appareil envoie un message d'accusé de réception.

      Le même cycle de publication, de réception et de confirmation se poursuit jusqu'à ce que tous les messages soient publiés. Deux messages sont publiés par cycle jusqu'à ce que le nombre de cycles configuré soit terminé.

5. Utilisation de CMake avec FreeRTOS

   Vous pouvez également utiliser CMake pour créer et exécuter l'application de démonstration. Pour configurer CMake et un système de compilation natif, voirPrérequis.

   1. Utilisez la commande suivante pour générer des fichiers de construction. Spécifiez le tableau cible à l'aide du-DBOARDoption.

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir

      Si vous utilisez Windows, vous devez spécifier le système de génération natif à l'aide du-Goption car CMake utilise Visual Studio par défaut.

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir -G Ninja

      Si arm-none-eabi-gcc n'est pas dans votre chemin d'accès shell, vous devez également définir la variable CMake AFR_TOOLCHAIN_PATH.

       -DAFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin

   2. Utilisez la commande suivante pour créer le projet à l'aide de CMake.

      cmake --build build_dir

   3. Enfin, programmez lecm0.hexetcm4.hexfichiers générés sousbuild_diren utilisant Cypress Programmer.

Exécution d'autres démos

Les applications de démonstration suivantes ont été testées et vérifiées pour fonctionner avec la version actuelle. Vous pouvez trouver ces démos dans lefreertos/demosannuaire. Pour plus d'informations sur l'exécution de ces démos, voirDémos FreeRTOS.

• Démonstration du Bluetooth Low Energy

• Démo de mises à jour en ligne

• Démo du client Secure Sockets Echo

• AWS IoTDémo de Device Shadow

Débogage

Le KitProg3 du kit prend en charge le débogage via le protocole SWD.

• Pour déboguer l'application FreeRTOS, sélectionnezprojet aws_demosdans l'espace de travail, puis sélectionnezDébogage aws_demos ()KitProg3)à partir dePanneau rapide.

Mises à jour OTA

Les microcontrôleurs PSoC 64 ont réussi tous les tests de qualification FreeRTOS requis. Cependant, l'option over-the-airfonctionnalité (OTA) implémentée dans le PSoC 64 Standard SecureAWSla bibliothèque de microprogrammes est toujours en attente d'évaluation. La fonctionnalité OTA telle qu'elle est mise en œuvre passe actuellement tous les tests de qualification OTA, à l'exceptionaws_ota_test_case_rollback_if_unable_to_connect_after_update.py.

Lorsqu'une image OTA validée avec succès est appliquée à un appareil à l'aide du protocole pSOC64 Standard Secure :AWSL'microcommande et l'appareil ne peuvent pas communiquer avecAWS IoT Core, l'appareil ne peut pas revenir automatiquement à l'image originale dont le fonctionnement a été vérifié. L'appareil peut être injoignable depuisAWS IoT Corepour d'autres mises à jour. Cette fonctionnalité est toujours en cours de développement par l'équipe Cypress.

Pour plus d'informations, veuillez consulter la rubriqueMises à jour OTA avecAWSet le kit CY8CKIT-064S0S2-4343W. Si vous avez d'autres questions ou si vous avez besoin d'une assistance technique, contactezCommunauté de développeurs de Cypress.