Repository files navigation

Welcome to the STM32-base project main repository! Here you will find the code and scripts that make up the STM32-base project. Visitstm32-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 withSTM32 microcontrollers. More information on why this project came into being can be found on theabout page.

Check out thegetting started with STM32 microcontrollers guide. This guide is intended for beginners who want to get started with STM32 microcontrollers but don't knowhow orwhere to get started.

You can get started with the STM32-base project by reading thesetup guide. A brief version of this guide is included in this README.

0. Create a workspace directory
   Create a directory namedSTM32-base. Create four directories in that folder. Name themlibraries,projects,templates, andtools.
1. Install required software
   InstallGit and make. Download theGNU ARM Embedded Toolchain. Extract the downloaded archive to thetools directory. Install theopen-source ST-Link Tools.
2. Clone this and the STM32-base-STM32Cube repositories
   Clone both this and theSTM32-base-STM32Cube repositories in theSTM32-base directory.
3. Clone the template repositories
   Clone one or more of the template repositories.
   git clone git@github.com:STM32-base/STM32-base-F0-template.git
git clone git@github.com:STM32-base/STM32-base-F1-template.git
git clone git@github.com:STM32-base/STM32-base-F2-template.git
git clone git@github.com:STM32-base/STM32-base-F3-template.git
git clone git@github.com:STM32-base/STM32-base-F4-template.git
git clone git@github.com:STM32-base/STM32-base-F7-template.git
4. Test the setup
   In one of the templates, create two symbolic links to the STM32-base and the STM32-base-STM32Cube repositories. The runmake. 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 theboard page.

Refer to theCONTRIBUTING.md file to learn more about contributing to the STM32-base project.