Welcome to the STM32-base project main repository! Here you will find the code and scripts that make up the STM32-base project. Visit stm32-base.org for more information and documentation on the STM32-base project.
WARNING: This project is work in progress! Anything can (and probably will) change! Do not use the code found in this project for any critical system(s). The use of the code and documentation is at your own risk!
The purpose of the STM32-base project is to provide you with a simple and easy to use base project for working with STM32 microcontrollers. More information on why this project came into being can be found on the about page.
Check out the getting started with STM32 microcontrollers guide. This guide is intended for beginners who want to get started with STM32 microcontrollers but don't know how or where to get started.
You can get started with the STM32-base project by reading the setup guide. A brief version of this guide is included in this README.
- Create a workspace directory
Create a directory named
STM32-base. Create four directories in that folder. Name them
- Install required software
Gitand make. Download the GNU ARM Embedded Toolchain. Extract the downloaded archive to the
toolsdirectory. Install the open-source ST-Link Tools.
- Clone this and the STM32-base-STM32Cube repositories
Clone both this and the STM32-base-STM32Cube repositories in the
- Clone the template repositories
Clone one or more of the template repositories.
git clone email@example.com:STM32-base/STM32-base-F0-template.git
git clone firstname.lastname@example.org:STM32-base/STM32-base-F1-template.git
git clone email@example.com:STM32-base/STM32-base-F2-template.git
git clone firstname.lastname@example.org:STM32-base/STM32-base-F3-template.git
git clone email@example.com:STM32-base/STM32-base-F4-template.git
git clone firstname.lastname@example.org:STM32-base/STM32-base-F7-template.git
- Test the setup
In one of the templates, create two symbolic links to the STM32-base and the STM32-base-STM32Cube repositories. The run
make. You have successfully set up the STM32-base project on your machine if compilation succeeds.
The STM32-base documentation contains a lot of information on many different STM32 development boards. A lot of the Chinese STM32 development boards that are available are listed on the board page.
Refer to the
CONTRIBUTING.md file to learn more about contributing to the STM32-base project.