apm32-kconfig-example

The apm32-kconfig-example is an example project that demonstrates how to use the Kconfig configuration system to configure the project. The project is based on the APM32 Device Abstraction Layer (DAL) and CMSIS driver.

Features

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

Directory Structure

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

Supported Platforms

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

Dependencies

• CMake
• GNU Arm Embedded Toolchain
• Kconfiglib
• python3

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

Configure the project

You can configure the project using the menuconfig command.

menuconfig

Generate the header file

You can generate the header file using the following CMake custom target.

python tools/python/kconfig.py Kconfig .config autoconf.h kconfigLog.txt .config

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/apm32-firmware.elf", // Change the executable path
            "request": "launch",
            "type": "cortex-debug",
            "servertype": "jlink",
            "device": "APM32F405RG",
            "interface": "swd",
            "svdFile": "./svd/APM32F40x.svd",
        },
    ]
}