Usando CMake com FreeRTOS

Você pode usar CMake para gerar arquivos de construção do projeto a partir do código-fonte do aplicativo FreeRTOS e para criar e executar o código-fonte.

Você também pode usar um IDE para editar, depurar, compilar, atualizar e executar código em dispositivos qualificados para o FreeRTOS. Cada guia de conceitos básicos específico para a placa inclui instruções para configurar o IDE para uma plataforma específica. Se preferir trabalhar sem um IDE, você pode usar outras ferramentas de edição e depuração de código de terceiros para desenvolver e depurar seu código e, em seguida, usá-las CMake para criar e executar os aplicativos.

As seguintes placas suportam CMake:

Consulte os tópicos abaixo para obter mais informações sobre como usar CMake com FreeRTOS.

Pré-requisitos

Certifique-se de que sua máquina host atenda aos seguintes pré-requisitos antes de continuar:

Desenvolvimento de aplicações do FreeRTOS com ferramentas de terceiros para edição e depuração de código

Você pode usar um editor de código e uma extensão de depuração ou uma ferramenta de terceiros de depuração para desenvolver aplicações para o FreeRTOS.

Se, por exemplo, você usar o Visual Studio Code como editor de código, poderá instalar a extensão Cortex-Debug VS Code como depurador. Ao terminar de desenvolver seu aplicativo, você pode invocar a ferramenta de CMake linha de comando para criar seu projeto a partir do VS Code. Para obter mais informações sobre como usar CMake para criar aplicativos FreeRTOS, consulte. Criando FreeRTOS com CMake

Para a depuração, você pode fornecer um VS Code com configuração de depuração semelhante ao seguinte:

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

Criando FreeRTOS com CMake

CMake por padrão, o sistema operacional host é o sistema de destino. Para usá-lo para compilação cruzada, é CMake necessário um arquivo de conjunto de ferramentas, que especifica o compilador que você deseja usar. No FreeRTOS, fornecemos arquivos de cadeia de ferramentas padrão no freertos/tools/cmake/toolchains. A forma de fornecer esse arquivo CMake depende se você está usando a interface de linha de CMake comando ou a GUI. Para obter mais detalhes, siga as instruções de Geração de arquivos de compilação (CMake ferramenta de linha de comando) abaixo. Para obter mais informações sobre compilação cruzada CMake, consulte CrossCompilingno wiki oficial CMake .

Geração de arquivos de compilação (CMake ferramenta de linha de comando)

Você pode usar a ferramenta de CMake linha de comando (cmake) para gerar arquivos de compilação para Freertos. Para gerar os arquivos de compilação, especifique uma placa de destino, um compilador e o local do código-fonte e o diretório de compilação.

É possível usar as seguintes opções para o cmake:

Por exemplo, se o fornecedor for a Texas Instruments, a placa for o CC322 0 Launchpad e o compilador for GCC for ARM, você poderá emitir o seguinte comando para criar os arquivos de origem do diretório atual em um diretório chamado: 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"

As expressões regulares ${VENDOR}.* e ${BOARD}.* são usadas para pesquisar uma placa correspondente, portanto, você não precisa usar os nomes completos do fornecedor e da placa para as opções BOARD e VENDOR. Nomes parciais funcionam, desde que haja uma única correspondência. Por exemplo, os seguintes comandos geram os mesmos arquivos de compilação da mesma origem:

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

Você pode usar a opção CMAKE_TOOLCHAIN_FILE se quiser usar um arquivo de conjunto de ferramentas que não esteja localizado no diretório padrão cmake/toolchains. Por exemplo:

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

Se o arquivo do conjunto de ferramentas não usar caminhos absolutos para o compilador e você não tiver adicionado o compilador à variável de PATH ambiente, CMake talvez não consiga encontrá-lo. Para garantir que CMake encontre seu arquivo do conjunto de ferramentas, você pode usar a AFR_TOOLCHAIN_PATH opção. Essa opção pesquisa o caminho do diretório do conjunto de ferramentas especificado e a subpasta do conjunto de ferramentas em bin. Por exemplo:

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

Para habilitar a depuração, defina CMAKE_BUILD_TYPE como debug. Com essa opção ativada, CMake adiciona sinalizadores de depuração às opções de compilação e cria FreerTOS com símbolos de depuração.

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

Você também pode definir o CMAKE_BUILD_TYPE como release para adicionar sinalizadores de otimização às opções de compilação.

Geração de arquivos de compilação (CMake GUI)

Você pode usar a CMake GUI para gerar arquivos de compilação do FreeRTOS.

Compilação do FreeRTOS a partir de arquivos de compilação gerados

Criação com sistema de compilação nativo

Você pode compilar o FreeRTOS com um sistema de compilação nativo chamando o comando de sistema de compilação a partir do diretório de binários de saída.

Por exemplo, se o diretório de saída do arquivo de compilação for <build_dir> e você estiver usando o Make como seu sistema de compilação nativo, execute os seguintes comandos:

cd <build_dir>
make -j4

Edifício com CMake

Você também pode usar a ferramenta de CMake linha de comando para criar Freertos. CMake fornece uma camada de abstração para chamar sistemas de compilação nativos. Por exemplo:

cmake --build build_dir

Aqui estão alguns outros usos comuns do modo de construção da ferramenta CMake de linha de comando:

# 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

Para obter mais informações sobre o modo de CMake compilação, consulte a CMake documentação.