https://github.com/vpetrigo/arm-cmake-toolchains
CMake toolchain configurations for ARM
https://github.com/vpetrigo/arm-cmake-toolchains
arm arm-gcc clang cmake cmake-files cortex-m efm32 gcc nrf52 stm32 toolchain-cmake
Last synced: 4 months ago
JSON representation
CMake toolchain configurations for ARM
- Host: GitHub
- URL: https://github.com/vpetrigo/arm-cmake-toolchains
- Owner: vpetrigo
- License: bsd-3-clause
- Created: 2017-03-05T22:21:49.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-12-30T23:55:54.000Z (6 months ago)
- Last Synced: 2026-01-03T23:34:01.160Z (6 months ago)
- Topics: arm, arm-gcc, clang, cmake, cmake-files, cortex-m, efm32, gcc, nrf52, stm32, toolchain-cmake
- Language: CMake
- Homepage:
- Size: 371 KB
- Stars: 285
- Watchers: 18
- Forks: 52
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/vpetrigo/arm-cmake-toolchains/actions/workflows/build.yml)
# CMake toolchain files for ARM GCC compiler
This repo contains CMake toolchain files that utilizes [ARM GCC](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm).
MCU families that can be used:
- STM32 (F0, F1, F2, F3, F4, F7, G0, G4, H7, L0, L1, L4, L5, U5, WB, WL)
- nRF51/nRF52 (nRF52832, nRF52840, nRF51822)
- NXP Kinetis (LPC800, LPC5500, K-series like K64)
- Many more (any Cortex-M based) :smile:
One of them `arm-gcc-toolchain.cmake` uses `arm-none-eabi-gcc` suite to build CMake project. To use it the toolchain must
be added to the system PATH variable.
*Example for Ninja generator, Debug build*:
```sh
PATH=:$PATH cmake -G Ninja -DCMAKE_TOOLCHAIN_FILE=arm-gcc-toolchain.cmake -DCMAKE_BUILD_TYPE=Debug
```
`clang-arm-gcc-toolchain.cmake` uses Clang front-end as a compiler that has some additional code analyzer
features with comprehensive warning/errormessages.
## Example projects
- EFM32GG on STK3700 board:
- [simple LED blinking](examples/efm32/led)
- K64F on FRDM-K64F board:
- [simple LED blinking](examples/nxp/led)
## Customization of toolchain file
Now the `arm-gcc-toolchain.cmake` and `clang-arm-gcc-toolchain.cmake` files use `arm-none-eabi` compiler triple and prefix. In case
you want to use another compiler you should change the `TOOLCHAIN_PREFIX` variable in both CMake toolchain files and `TOOLCHAIN_TRIPLE` for
Clang-specific file only:
```cmake
# arm-gcc-toolchain.cmake and clang-arm-gcc-toolchain.cmake
set(TOOLCHAIN_PREFIX )
# clang-arm-gcc-toolchain.cmake ONLY
set(TOOLCHAIN_TRIPLE )
```
Also some options which is essential for **Cortex-M** specific compiler (`arm-none-eabi`) might be not relevant for your compiler.
In that case you should simply delete obsolete lines from toolchain CMake file. For example the line below is not relevant for
uClinux compiler:
```cmake
set(CMAKE_EXE_LINKER_FLAGS_INIT "--specs=nosys.specs")
```
And that line can be deleted while you use `arm-uclinuxeabi` compiler without any side effect.
## Additional macros/functions in utils.cmake
In the `utils.cmake` file you can find some useful macros/functions that you can add into your CMake files.
To do that you need to include `utils.cmake`:
```cmake
# CMakeLists.txt somewhere in your project
include(/utils.cmake)
```
It might be a good idea to include that file in your project's root `CMakeLists.txt` to allow other CMake files,
which may reside in subdirectories, to use provided features.
- `subdirlist`:
```cmake
# store all subfolder names in a ${result} variable
# might be useful when you have lots of subdirectories with
# headers and do not want to type them manually
# IMPORTANT: ${result} contains paths relative to a ${current_dir}
subdirlist(result current_dir)
target_include_directories( ${result})
```
- `prepend_cur_dir`:
```cmake
# prepend ${CMAKE_CURRENT_SOURCE_DIR} to a directory
# so that you have the full path to a header/source file
# and store the result in the provided ${variable}
prepend_cur_dir(full_path_to_dir dir)
# the ${full_path_to_dir} for dir/ might be like:
${full_path_to_dir} -> C:/Users/SpecificUser/Project/dir
```
- `firmware_size`:
```cmake
# function that adds custom target that will
# output resulted executable image size by using
# binutils size command
add_executable(hello_world main.c)
...
firmware_size(hello_world)
# Possible output:
# text data bss dec hex filename
# 294880 81920 11592 388392 5ed28 hello_world
```
- `generate_object`:
```cmake
# function that adds custom target that will
# generate additional output file with specified
# type by using binutils objcopy
add_executable(hello_world main.c)
...
generate_object(hello_world .hex ihex)
# in addition to .elf file the hex file for
# hello_world firmware would be generated
```