apm32-cmake-example

The apm32-cmake-example is a template project for developing firmware for the APM32 microcontroller using CMake build system. The project uses the APM32 Device Abstraction Layer and the APM32 CMSIS driver for peripheral access. The project also includes the APM32 SVD files for peripheral register definitions.

Features

• CMake build system
• CMake Presets
• CMake custom command
• APM32 Device Abstraction Layer
• APM32 CMSIS driver
• APM32 SVD files

Directory Structure

Directory	Content
apm32-cmake-example/.vscode	Contains JLink launch configuration for debugging
apm32-cmake-example/cmake	Contains CMake scripts for building the project
apm32-cmake-example/driver	Contains APM32 DAL driver and CMSIS driver
apm32-cmake-example/svd	Contains APM32 SVD files

Supported Platforms

Platform	Device
APM32F4	APM32F405xx, APM32F407xx, APM32F417xx, APM32F411xx, APM32F465xx

Dependencies

• CMake
• GNU Arm Embedded Toolchain

Recommended Tools

• J-Link Software and Documentation Pack
• Visual Studio Code
• Cortex-Debug
• CMake Tools

Getting Started

Ensure that all dependencies are installed on your system and that environment variables are properly set up. And then follow the steps below to build the project. You can using the following commands to build the project. Also, you can use the CMake Tools extension in Visual Studio Code to build the project.

Clone the repository

git clone

Initialize CMake project

Using CMake Presets to initialize the project. The following command will create a build directory and generate the build system files. The preset option is set to Debug. You can change the preset option to Release or any other preset defined in the CMakePresets.json file.

cmake -S . -B build/Debug --preset Debug

Make the project

You can make the project again using the following CMake custom target.

cmake --build build/Debug --target project-debug-make

Build the project

You can build the project using the following CMake custom target.

cmake --build build/Debug --target project-debug-build

Debug the project

Using the JLink launch configuration in the .vscode directory to debug the project. Open the project in Visual Studio Code and press F5 to start debugging.

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Cortex Debug with J-Link",
            "cwd": "${workspaceRoot}",
            "executable": "./build/Debug/test-firmware.elf", // Change the executable path
            "request": "launch",
            "type": "cortex-debug",
            "servertype": "jlink",
            "device": "APM32F405RG",
            "interface": "swd",
            "svdFile": "./svd/APM32F40x.svd",
        },
    ]
}