stm32-makefile

Overview

This repository contains a blinky-button project for the STM32 Nucleo-144 development board targeting the STM32F767ZI microcontroller. The project uses:

GNU Make (Build System)
GNU ARM Embedded Toolchain (Compiler)
STM32CubeF7 MCU Firmware Package (BSP/Drivers)
ST-Link or OpenOCD (Debug)

Motivation

I often need to develop software for STM32 microcontrollers and want to use GNU Make as the build system. While STM bundles example projects and templates in the STM32Cube packages (such as STM32CubeF7), the projects do not support GNU Make and instead support IAR, Keil, and Eclipse (Atollic or AC6). These projects also don't include debug configurations. While I enjoy using those tools for navigating code and debugging, I prefer to manage the build system with human readable files.

Existing Solutions

Other projects that address this problem:

damheinrich/cm-makefile: Makefiles for Cortex-M processors. Not STM32 specific, but should be easily configurable. Overall the level of configurability and complexity is not needed for a small project.
STM32-base/STM32-base: Essentially solves the exact problem I have, combining GNU Make with STM32 source code. I tried to use this project but ran into a lot of bugs and problems. At the time of writing I do not have bandwidth to contribute, but eventually should debug this more. It also has more configurability and complexity than needed, since it supports many STM32 devices.

User Guide

Setup

GNU Make - Usually installed by default on Linux and macOS, so no work to do here.
GNU ARM Embedded Toolchain - Download the toolchain and update the TOOLCHAIN_ROOT variable at the top of the Makefile. If you've added the bin/ directory of the toolchain to your system PATH then you can leave this variable blank.
STM32CubeF7 MCU Firmware Package - This is a submodule of this repository, so it can be downloaded by running git submodule init && git submodule update. However if you already have it installed on your system, skip the submodule commands and just update the VENDOR_ROOT variable in the Makefile to point to your copy.
ST-Link or OpenOCD - For debugging, you will need software that knows how to talk to your debug hardware over USB. On the Nucleo-144 board, there is an ST-Link debugger. You can talk to it using ST-Link tools or OpenOCD. On Linux I was able to build both of these packages from source easily following the instructions. On macOS both packages were downloadable in binary form using brew install stlink openocd.

Build and Debug

Simply run make to build the project.
In another terminal, start the GDB server by running make gdb-server_openocd.
- To use ST-Link, run make gdb-server_stlink.
Run make gdb-client to download the code and start debugging.
Optionally, open a serial terminal to view the printf function calls.
- For example, run pyserial: python -m serial - 115200 and then select the port labeled "STM32 STLink".

bbrown1867 / stm32-makefile