C template for a Cortex-M4 based board. This project is just a template to show the necessary steps for blinking an LED on STM32F4 Discovery board. It is intended to be used for educational purposes.
- Single source file for full operation demonstration. (No startup files or any other libraries are used)
- Only uses
RCCandGPIOregisters. So rest of the register structs are not included / added. - If needed, all other register locations can be found on the relevant processor datasheet.
- Clock is sourced from HSI.
- Tested on STM32F4 Discovery board.
Clone the project using git clone https://github.com/fcayci/stm32f4-c-template.
There are two options for development. First one is to use STM32CubeIDE from ST. Second one is the setup your own development environment. Both options are supported with relevant project settings or makefiles.
- Download and install STM32CubeIDE. Select a workspace then import existing project to your workspace.
- You do not need any additional tools. It comes with the compiler and debugger pre-installed.
- Rest of the sections are for Option 2.
- Get toolchain (for compiler and binutils) from GNU Arm Embedded Toolchain
- For windows only, install make tool. You can just get the make tool from gnuwin32. Alternatively you can install the minimalist GNU tools for windows from mingw and MSYS
- For the programmer/debugger, you can use - stlink or OpenOCD. Though only stlink utility support is added.
- You can use your favorite code editor to view/edit the contents. Here is an open source one: Visual Studio Code.
makefile contains necessary build scripts and compiler flags.
Browse into the directory and run make to compile. You should see a similar output as shown below.
Cleaning...
Building template.c
text data bss dec hex filename
432 16 16 464 1d0 template.elf
Successfully finished...
If you see any errors about command not found, make sure the toolchain binaries are in your PATH. On Windows check the Environment Variables for your account. On Linux/macOS run echo $PATH to verify your installation.
Run make burn to program the chip.
...
Flash written and verified! jolly good!
Install the ST LINK drivers if you cannot see your board when make burn is run.
Run make disass / make disass-all to disassamble.
In order to debug your code, connect your board to the PC, run st-util (comes with stlink utility) from one terminal, and from another terminal within the project directory run make debug. You can then use general gdb commands to browse through the code.