Usare CMake con FreerTOS

Puoi usare CMake per generare file di build del progetto dal codice sorgente dell'applicazione FreerTOS e per creare ed eseguire il codice sorgente.

Puoi anche utilizzare un IDE per modificare, eseguire il debug, compilare, eseguire il flashing ed eseguire il codice su dispositivi certificati FreeRTOS. Ogni guida alle operazioni di base specifiche della scheda include istruzioni per configurare l'IDE per una determinata piattaforma. Se preferisci non utilizzare un'IDE, puoi usare altri strumenti di modifica e debug del codice di terze parti per lo sviluppo e il debug del codice e quindi utilizzare CMake per compilare ed eseguire le applicazioni.

CMake è supportato dalle seguenti schede:

Consulta gli argomenti seguenti per ulteriori informazioni sull'uso di CMake con FreerTOS.

Prerequisiti

Assicurati che il computer host soddisfi i seguenti prerequisiti prima di continuare:

Sviluppo di applicazioni FreerTOS con editor di codice e strumenti di debug di terze parti

Puoi utilizzare un editor di codice e un'estensione di debug o uno strumento di debug di terze parti per sviluppare applicazioni per FreerTOS.

Se, ad esempio, utilizzi Visual Studio Code come editor di codice, puoi installare l'estensione Cortex-Debug di VS Code come strumento di debug. Al termine dello sviluppo dell'applicazione, è possibile richiamare lo strumento a riga di comando CMake per compilare il progetto all'interno di VS Code. Per ulteriori informazioni sull'utilizzo di CMake per creare applicazioni FreerTOS, vedere. Costruire FreerTOS con CMake

Per le operazioni di debug, puoi specificare una configurazione di debug simile alla seguente:

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

Costruire FreerTOS con CMake

Per impostazione predefinita, CMake definisce il sistema operativo host come sistema di destinazione. Per utilizzarlo per la compilazione incrociata, CMake richiede un file toolchain che specifica il compilatore da utilizzare. In FreerTOS, forniamo file di toolchain predefiniti in. freertos/tools/cmake/toolchains Il modo in cui fornire questo file a CMake varia a seconda se utilizzi l'interfaccia della riga di comando o la GUI di CMake. Per ulteriori dettagli, segui le istruzioni Generazione dei file di compilazione (strumento a riga di comando di CMake) di seguito. Per ulteriori informazioni sulla compilazione incrociata in CMake, consulta CrossCompilingil wiki ufficiale di CMake.

Generazione dei file di compilazione (strumento a riga di comando di CMake)

Puoi usare lo strumento da riga di comando CMake (cmake) per generare file di build per FreerTOS. Per generare i file di compilazione, devi specificare una scheda di destinazione, un compilatore e la posizione del codice sorgente e della directory di compilazione.

Puoi usare le seguenti opzioni per cmake:

Ad esempio, se il fornitore è Texas Instruments, la scheda è CC3220 Launchpad e il compilatore è GCC per ARM, puoi avviare il comando seguente per compilare i file di origine dalla directory corrente in una directory denominata 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"

Le espressioni regolari ${VENDOR}.* e ${BOARD}.* vengono utilizzate per cercare una scheda corrispondente, pertanto non è necessario utilizzare i nomi completi del fornitore e della scheda per le opzioni VENDOR e BOARD. È possibile utilizzare nomi parziali, purché esista una sola corrispondenza. Ad esempio, i seguenti comandi generano gli stessi file di compilazione dalla stessa origine:

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

Puoi utilizzare l'opzione CMAKE_TOOLCHAIN_FILE se desideri utilizzare un file di toolchain che non si trova nella directory predefinita cmake/toolchains. Per esempio:

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

Se il file di toolchain non utilizza percorsi assoluti per il compilatore, e non hai aggiunto il compilatore alla variabile di ambiente PATH, CMake potrebbe non essere in grado di individuarlo. Per essere certo che CMake individui il file di toolchain, puoi utilizzare l'opzione AFR_TOOLCHAIN_PATH. Questa opzione esegue una ricerca nel percorso di directory della toolchain specificato e nella sottocartella della toolchain in bin. Per esempio:

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

Per abilitare il debug, imposta CMAKE_BUILD_TYPE su debug. Con questa opzione abilitata, CMake aggiunge flag di debug alle opzioni di compilazione e crea FreerTOS con simboli di debug.

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

Puoi anche impostare CMAKE_BUILD_TYPE su release per aggiungere flag di ottimizzazione alle opzioni di compilazione.

Generazione dei file di compilazione (GUI CMake)

Puoi usare la GUI di CMake per generare file di build FreerTOS.

Creazione di FreerTOS da file di build generati

Compilazione con un sistema di compilazione nativo

Puoi creare FreerTOS con un sistema di build nativo chiamando il comando build system dalla directory dei binari di output.

Ad esempio, se la directory di output del file di compilazione è <build_dir> e utilizzi Make come sistema di compilazione nativo, esegui i comandi seguenti:

cd <build_dir>
make -j4

Compilazione di con CMake

Puoi anche usare lo strumento da riga di comando CMake per creare FreerTOS. CMake fornisce un livello di astrazione per chiamare sistemi di compilazione nativi. Per esempio:

cmake --build build_dir

Di seguito sono riportati alcuni utilizzi comuni della modalità di compilazione dello strumento a riga di comando di 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

Per ulteriori informazioni sulle modalità di compilazione CMake, consulta la documentazione CMake.