# stm32_cmake

**Repository Path**: exp-code/stm32_cmake

## Basic Information

- **Project Name**: stm32_cmake
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-13
- **Last Updated**: 2023-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# STM32 CMake Project Template

This template has been tested in Linux. Additional adjustments may be required for use in Windows. 

## How to compile code

**Prerequisite**: 

This cmake setup assumes the gcc-arm-none-eabi toolchain has been set up correctly in your system.

Generally there are two ways to set up the toolchain:

1. Install using the package manager

    ```
    $ sudo apt install gcc-arm-none-eabi
    ```
2. Download the toolchain binaries and add its directory to system path

* Find the binaries from the website: 
  
  https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads

* Add the path in .bashrc (for example, if you put the extracted files at /opt/gcc-arm-none-eabi-7-2017-q4-major-linux)
  
    ```
    $ export PATH=/opt/gcc-arm-none-eabi-7-2017-q4-major-linux/bin:$PATH
    ```

* Make sure you can invoke the toolchain from a terminal

    ```
    $ arm-none-eabi-gcc -v
    ```

Now you can try to compile the sample project using the cmake template.

```
$ cd <path-of-this-repo>
$ mkdir build && cd build
$ cmake ..
$ make -j
```
If the "cmake .." step runs successfully, you should see something similar to the below screenshot:

![cmake step](docs/stm32_cmake1.png)

Then you can continue to actually compile the code and you can expect a similar result:

![cmake step](docs/stm32_cmake2.png)

You can find the compiled **.elf**, **.hex** and **.bin** binary files in "build/src".

Reference:

* https://github.com/ahessling/STM32F4Template
* https://gitlab.kitware.com/cmake/community/wikis/doc/cmake/CrossCompiling
* https://www.bootladder.com/2017/10/09/cmake-and-gradle-for-arm-c-c.html