LED-blinking application for Chapter 7 of Hands-On RTOS With Microcontrollers. This application is built for the STM32F767ZI Nucleo board. As opposed to the source code provided by the book for the STM32CubeIDE, this project utilizes CMake as the build system. The stm32-cmake project is used to incorporate the necessary source code directly from STMicroelectronic’s GitHub repositories and the FreeRTOS GitHub repository.

This section describes how to setup the build environment required to build the project. The instructions here are for Ubuntu 20.04.

1. Install the necessary system packages.

   ➜ sudo apt -y install binutils ccache clang-format gcc-arm-none-eabi gdb-multiarch git ninja-build qt5-default python3 \
     python3-pip

2. Install the cmakelang Python package via Pip.

   ➜ python3 -m pip install --user cmakelang[yaml]

   ℹ️	~/.local/bin will need to be on your PATH.

3. Install a newer version of CMake.

   1. Download the latest version.

      x86_64

      ➜ wget -LP ~/Downloads/ https://github.com/Kitware/CMake/releases/download/v3.20.1/cmake-3.20.1-Linux-x86_64.sh

      aarch64

      ➜ wget -LP ~/Downloads/ https://github.com/Kitware/CMake/releases/download/v3.20.1/cmake-3.20.1-Linux-aarch64.sh

   2. Make the installer executable.

      ➜ chmod +x ~/Downloads/cmake-*.sh

   3. Change to the /usr/local directory.

      ➜ cd /usr/local

   4. Install CMake in /usr/local.

      ➜ sudo ~/Downloads/cmake-*.sh

   5. Press q to skip reading the license.

   6. Enter y and press enter to accept the license.

   7. Enter n and press enter to install to the subdirectories in /usr/local.

   8. Remove the installer.

      ➜ rm ~/Downloads/cmake-*.sh

Required source code is pulled in with CMake using stm32-cmake and FetchContent. When using a single configuration generator with CMake, set the appropriate build type when configuring the build. Likely, this build type will be either Debug or Release, but may also be MinSizeRel in order to produce the smallest executable possible. Examples for each build type are provided below. The examples also enable several helpful options to improve performance of the build and the resulting binaries. These examples assume you are in the top-level directory of the project and using a build directory named build.

1. First, clone the source code of this repository locally.

   ➜ git clone https://github.com/jwillikers/Hands-On-RTOS-With-Microcontrollers-Chapter-7.git

2. Then change into the project directory.

   ➜ cd Hands-On-RTOS-With-Microcontrollers-Chapter-7

3. Configure the build using the provided toolchain file.

   Debug

   ➜ cmake \
     -GNinja \
     -DCMAKE_BUILD_TYPE=Debug \
     -DCMAKE_UNITY_BUILD=yes \
     -DCLANG_FORMAT_PROGRAM=/usr/bin/clang-format \
     -B build -S .

   Release

   ➜ cmake \
     -GNinja \
     -DCMAKE_BUILD_TYPE=Release \
     -DCMAKE_UNITY_BUILD=yes \
     -DCLANG_FORMAT_PROGRAM=/usr/bin/clang-format \
     -B build -S .

   MinSizeRel

   ➜ cmake \
     -GNinja \
     -DCMAKE_BUILD_TYPE=MinSizeRel \
     -DCMAKE_UNITY_BUILD=yes \
     -DCLANG_FORMAT_PROGRAM=/usr/bin/clang-format \
     -B build -S .

4. Build the project with CMake.

   ➜ cmake --build build

   ℹ️	This will also produce a build/blinky.bin binay file and a build/blinky.hex hex file.

5. To flash the ELF file directly to the STM32F7 Nucleo board with OpenOCD, build the flash target with CMake.

   ➜ cmake --build build --target flash

The clang-format and cmake-format tools are used to format the source code files. The Format.cmake module provides build targets to simplify the use of these tools.

Format the source files by building the CMake target fix-format.

Contributions in the form of issues, feedback, and even pull requests are welcome. Make sure to adhere to the project’s Code of Conduct.

This project is built on the hard work of countless open source contributors. Several of these projects are enumerated below.

• Asciidoctor

• Boost C++ Libraries

• ccache

• Ccache.cmake

• Clang

• Clang-Tidy

• ClangFormat

• CMake

• cmakelang

• CMake Scripts

• Debian

• GCC

• Git

• Linux

• ModernCppStarter

• Ninja

• OpenOCD

• Python

• Rouge

• Ruby

• stm32-cmake

• Ubuntu

The project’s Code of Conduct is available in the Code of Conduct file.

This repository is licensed under the GPLv3, available in the license file.

© 2021 Jordan Williams

Jordan Williams