Démarrez avec le kit de développement Cypress CYW954907AEVAL1F

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 cette prévisibilité lorsque vous lancez dans la configuration d'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 concernant la mise en route du kit de développement Cypress CYW954907AEVAL1F. Si vous ne disposez pas du kit de développement Cypress CYW954907AEVAL1F, consultez le catalogue d'appareils des partenaires AWS pour en acheter un auprès de notre partenaire.

Note

Ce didacticiel vous guide dans la configuration et l'exécution de la prévisibilité de la prévisibilité de CoreMQTT Mutual Authentication. Le port FreeRTOS de cette carte ne prend actuellement pas en charge les démos du serveur et du client TCP.

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. Dans ce didacticiel, le chemin d'accès au répertoire de téléchargement de FreeRTOS est appeléfreertos.

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 :

  • Activez le mode développeur ou

  • Utilisez une console ayant le statut d'administrateur.

  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 l'entrée de blog Symlinks dans 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).

• Comme indiqué dansTéléchargement de FreeRTOS, les ports FreeRTOS pour Cypress ne sont actuellement disponibles que sur GitHub.

Présentation

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.

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

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

4. Interaction avec l’application s’exécutant sur votre carte via une connexion série, à des fins de surveillance et de débogage.

Configuration de votre environnement de développement

Télécharger et installer le kit SDK WICED

Dans ce guide de démarrage, vous utilisez le SDK Cypress WICED Studio pour programmer votre carte avec la démo de FreeRTOS. Visitez le site web WICED Software pour télécharger le kit SDK WICED Studio depuis Cypress. Vous devez avoir un compte Cypress gratuit pour télécharger le logiciel. Le kit SDK WICED Studio est compatible avec les systèmes d'exploitation Windows, macOS et Linux.

Note

Certains systèmes d'exploitation nécessitent des étapes d'installation supplémentaires. Assurez-vous de lire et de suivre toutes les instructions d'installation du système d'exploitation et de la version de WICED Studio que vous installez.

Définir les variables d'environnement

Avant d'utiliser WICED Studio pour programmer votre carte, vous devez créer une variable d'environnement pour le répertoire d'installation du kit SDK WICED Studio SDK. Si WICED Studio est en cours d'exécution tandis que vous créez vos variables, vous devez redémarrer l'application après avoir défini vos variables.

Note

Le programme d'installation WICED Studio crée deux dossiers distincts nommés WICED-Studio-m.n sur votre machine, où m et n sont les numéros de version majeure et mineure, respectivement. Ce document assume un nom de dossier WICED-Studio-6.2 mais veillez à utiliser le nom correct pour la version que vous installez. Lorsque vous définissez la variable d'environnement WICED_STUDIO_SDK_PATH, veillez à spécifier le chemin d'installation complet du kit SDK WICED Studio, et non pas le chemin d'installation de l'interface utilisateur WICED Studio. Dans Windows et macOS, le dossier WICED-Studio-m.n du kit SDK est créé dans le dossier Documents par défaut.

Pour créer les variables d'environnement sous Windows

1. Dans le Panneau de configuration, cliquez sur Système, Paramètres système avancés.

2. Sous l'onglet Avancé, choisissez Variables d'environnement.

3. Sous Variables d'utilisateur, choisissez Nouvelle.

4. Pour Nom de la variable :, tapez WICED_STUDIO_SDK_PATH. Pour Valeur de la variable, entrez le répertoire d'installation du kit SDK WICED Studio.

Pour créer la variable d'environnement sur Linux ou macOS

1. Ouvrez le fichier /etc/profile sur votre ordinateur, puis ajoutez la ligne suivante à la fin du fichier :

   export WICED_STUDIO_SDK_PATH=installation-path/WICED-Studio-6.2

2. Redémarrez l'ordinateur.

3. Ouvrez une fenêtre de terminal et exécutez les commandes suivantes :

   cd freertos/vendors/cypress/WICED_SDK

   perl platform_adjust_make.pl

   chmod +x make

Établissement d'une connexion série

Pour établir une connexion série entre votre machine hôte et votre carte

1. Connectez la carte à votre ordinateur hôte par un câble USB Standard-A vers Micro-B.

2. Identifiez le numéro de port série USB pour la connexion à la carte sur votre ordinateur hôte.

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

Pour plus d'informations sur l'installation d'une fenêtre de terminal et la configuration d'une connexion série, consultez Installation d'un émulateur de terminal.

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.

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

Après avoir configuré une connexion série avec votre carte, vous pouvez créer le projet de démonstration FreeRTOS, flasher la démo sur votre carte, puis exécuter la démo.

Pour créer et exécuter le projet de démonstration FreeRTOS dans WICED Studio

1. Lancez WICED Studio.

2. Dans le menu File (Fichier), choisissez Import (Importer). Développez le dossier General, choisissez Projets existants dans l'espace de travail, puis choisissez Suivant.

3. Dans Select root directory (Sélectionner le répertoire racine), sélectionnez Browse..., (Parcourir...), accédez au chemin freertos/projects/cypress/CYW954907AEVAL1F/wicedstudio, puis sélectionnez OK.

4. Sous Projects (Projets), cochez la case correspondant uniquement au projet aws_demo. Choisissez Terminer pour importer le projet. Le projet cible aws_demo doit apparaître dans la fenêtre Créer la cible.

5. Développez le menu WICED Platform (Plateforme WICED) et choisissez WICED Filters off (Filtres WICED désactivés).

6. Dans la fenêtre Créer le filtre, développez aws_demo, cliquez avec le bouton droit de la souris sur le fichier demo.aws_demo, puis choisissez Créer la cible afin de créer la démonstration et de la télécharger sur votre carte. Normalement, la démonstration s'exécute automatiquement une fois qu'elle a été créée et téléchargée sur votre carte.

Résolution des problèmes

• Si vous utilisez Windows, il se peut que vous receviez le message d'erreur suivant lorsque vous développez et exécutez le projet de démonstration :

  : recipe for target 'download_dct' failed
  make.exe[1]: *** [download_dct] Error 1

  Pour résoudre ce problème, utilisez la procédure suivante :

  1. Accédez à WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32 et double-cliquez sur openocd-all-brcm-libftdi.exe.

  2. Accédez à WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1 et double-cliquez sur InstallDriver.exe.

• Si vous utilisez Linux or macOS, il se peut que vous receviez le message d'erreur suivant lorsque vous développez et exécutez le projet de démonstration :

  make[1]: *** [download_dct] Error 127

  Pour résoudre cette erreur, cliquez sur la commande suivante pour ouvrir le package libusb-dev :

  sudo apt-get install libusb-dev

Pour obtenir des informations générales sur la résolution des problèmes liés à la mise en route avec FreeRTOS, consultezRésolution des problèmes de mise en route.