Utilisation de CMake avec FreeRTOS

Vous pouvez utiliser CMake pour générer des fichiers de construction de projet à partir du code source de l'application FreeRTOS, ainsi que pour créer et exécuter le code source.

Vous pouvez également utiliser un IDE pour modifier, déboguer, compiler, flasher et exécuter du code sur des appareils compatibles FreeRTOS. Chaque manuel de démarrage propre à une carte inclut des instructions de définition de l'IDE pour une plateforme spécifique. Si vous préférez travailler sans IDE, vous pouvez utiliser d'autres outils d'édition et de débogage tiers pour développer et déboguer votre code, puis utiliser CMake pour générer et exécuter les applications.

Les cartes suivantes prennent en charge CMake :

Consultez les rubriques ci-dessous pour plus d'informations sur l'utilisation de CMake avec FreeRTOS.

Prérequis

Vérifiez que votre machine hôte satisfait les prérequis suivants avant de continuer :

Développement d'applications FreeRTOS avec des éditeurs de code et des outils de débogage tiers

Vous pouvez utiliser un éditeur de code et une extension de débogage ou un outil de débogage tiers pour développer des applications pour FreeRTOS.

Si, par exemple, vous utilisez Visual Studio Code en tant qu'éditeur de code, vous pouvez installer l'extension de code VS Cortex-Debug en tant que débogueur. Lorsque vous avez fini de développer votre application, vous pouvez appeler l'outil de ligne de commande CMake pour générer votre projet à partir de VS Code. Pour plus d'informations sur l'utilisation de CMake pour créer des applications FreeRTOS, consultez. Création de FreeRTOS avec CMake

Pour le débogage, vous pouvez fournir un code VS avec la configuration de débogage similaire à ce qui suit :

"configurations": [
    {
        "name": "Cortex Debug",
        "cwd": "${workspaceRoot}",
        "executable": "./build/st/stm32l475_discovery/aws_demos.elf",
        "request": "launch",
        "type": "cortex-debug",
        "servertype": "stutil"
    }
]

Création de FreeRTOS avec CMake

CMake cible votre système d'exploitation hôte en tant que système cible par défaut. Pour l'utiliser pour la compilation croisée, CMake a besoin d’un fichier de chaîne d’outils, qui spécifie le compilateur que vous souhaitez utiliser. Dans FreeRTOS, nous fournissons des fichiers de chaîne d'outils par défaut dans. freertos/tools/cmake/toolchains La manière de fournir ce fichier à CMake varie selon que vous utilisez l'interface utilisateur graphique ou l'interface de ligne de commande CMake. Pour plus d'informations, suivez les instructions Génération de fichiers de build (outil de ligne de commande CMake) ci-dessous. Pour plus d'informations sur la compilation croisée dans CMake, consultez le wiki officiel CrossCompilingde CMake.

Génération de fichiers de build (outil de ligne de commande CMake)

Vous pouvez utiliser l'outil de ligne de commande CMake (cmake) pour générer des fichiers de compilation pour FreeRTOS. Pour générer les fichiers de build, vous devez spécifier une carte cible, un compilateur et l'emplacement du code source et du répertoire de build.

Vous pouvez utiliser les options suivantes pour cmake :

Par exemple, si le fournisseur est Texas Instruments, que la carte est une CC3220 Launchpad et que le compilateur est GCC pour ARM, vous pouvez exécuter la commande suivante pour générer les fichiers source depuis le répertoire actuel vers un répertoire nommé build-directory :

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory -G Ninja

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory -G "MinGW Makefiles"

Les expressions régulières ${VENDOR}.* et ${BOARD}.* sont utilisées pour rechercher une carte correspondante, afin que vous n’ayez pas à utiliser les noms complets du fournisseur et de la carte pour les options VENDOR et BOARD. Vous pouvez utiliser les noms partiels, à condition qu'il n’existe qu’une seule correspondance. Par exemple, les commandes suivantes génèrent les mêmes fichiers de build à partir de la même source :

cmake -DVENDOR=ti -DCOMPILER=arm-ti -S . -B build-directory

cmake -DBOARD=cc3220 -DCOMPILER=arm-ti -S . -B build-directory

cmake -DVENDOR=t -DBOARD=cc -DCOMPILER=arm-ti -S . -B build-directory

Vous pouvez utiliser l' option CMAKE_TOOLCHAIN_FILE si vous souhaitez utiliser un fichier de chaîne d’outils qui ne figure pas dans le répertoire cmake/toolchains par défaut. Par exemple :

cmake -DBOARD=cc3220 -DCMAKE_TOOLCHAIN_FILE='/path/to/toolchain_file.cmake' -S . -B build-directory

Si le fichier de chaîne d’outils n'utilise pas de chemins absolus pour votre compilateur, et que vous n'avez pas ajouté votre compilateur à la variable d' environnement PATH, il est possible que CMake ne trouve pas son emplacement. Pour vous assurer que CMake trouve votre fichier de chaîne d’outils, vous pouvez utiliser l'option AFR_TOOLCHAIN_PATH. Cette option recherche le chemin du répertoire de la chaîne d’outils spécifiée et le sous-dossier dans bin. Par exemple :

cmake -DBOARD=cc3220 -DCMAKE_TOOLCHAIN_FILE='/path/to/toolchain_file.cmake' -DAFR_TOOLCHAIN_PATH='/path/to/toolchain/' -S . -B build-directory

Pour activer le débogage, définissez le paramètre CMAKE_BUILD_TYPE sur debug. Lorsque cette option est activée, CMake ajoute des indicateurs de débogage aux options de compilation et construit FreeRTOS avec des symboles de débogage.

# Build with debug symbols
cmake -DBOARD=cc3220 -DCOMPILER=arm-ti -DCMAKE_BUILD_TYPE=debug -S . -B build-directory

Vous pouvez également définir CMAKE_BUILD_TYPE sur release pour ajouter des indicateurs d'optimisation aux options de compilation.

Génération de fichiers de build (GUI CMake)

Vous pouvez utiliser l'interface graphique de CMake pour générer des fichiers de compilation FreeRTOS.

Création de FreeRTOS à partir des fichiers de construction générés

Génération avec un système de génération natif

Vous pouvez créer FreeRTOS avec un système de construction natif en appelant la commande build system depuis le répertoire des binaires de sortie.

Par exemple, si votre répertoire de sortie de fichier de build est <build_dir>, et que vous utilisez CMake en tant que système de build natif, exécutez les commandes suivantes :

cd <build_dir>
make -j4

Création d’ avec CMake

Vous pouvez également utiliser l'outil de ligne de commande CMake pour créer FreeRTOS. CMake fournit une couche d'abstraction pour appeler les systèmes de build natifs. Par exemple :

cmake --build build_dir

Voici quelques autres utilisations courantes du mode de build de l'outil de ligne de commande CMake :

# Take advantage of CPU cores.
cmake --build build_dir --parallel 8

# Build specific targets.
cmake --build build_dir --target afr_kernel

# Clean first, then build.
cmake --build build_dir --clean-first

Pour plus d'informations sur le mode de build CMake, consultez la documentation CMake.