stm32f103_spl_clion

STM32F103C8T6 标准外设库（StdPeriph V3.5.0）工程，基于 CLion + CMake + arm-none-eabi-gcc 工具链。

• MCU：STM32F103C8T6（Cortex-M3，Medium density，64K Flash / 20K RAM）
• 库：ST 标准外设库 V3.5.0（SPL）
• 工具链：GNU Tools for STM32（arm-none-eabi-gcc 13.3）
• 构建：CMake + Ninja
• 烧录/调试：ST-Link（SWD），STM32CubeProgrammer + ST-LINK_gdbserver

目录结构

stm32f103_spl_clion/
├── CMakeLists.txt              # 工程主构建文件
├── CMakePresets.json           # Debug/Release 预设（CLion 零配置打开）
├── STM32F103XX_FLASH.ld        # 链接脚本（64K Flash / 20K RAM）
├── cmake/
│   └── gcc-arm-none-eabi.cmake # 交叉工具链定义（-mcpu=cortex-m3, gc-sections 等）
├── CMSIS/                      # 内核与启动文件
│   ├── startup_stm32f10x_md.s  # GCC 版启动文件（Medium density，对应 C8T6）
│   ├── core_cm3.{c,h}
│   ├── stm32f10x.h
│   └── system_stm32f10x.{c,h}
├── StdPeriph_Driver/           # 标准外设库 V3.5.0
│   ├── inc/                    # 23 个外设头文件
│   └── src/                    # 23 个外设源文件（未引用的会被 --gc-sections 自动裁掉）
├── User/                       # 用户代码
│   ├── main.c                  # 示例：PC13 LED 闪烁
│   └── stm32f10x_conf.h        # SPL 配置（包含所有外设头）
└── tools/
    ├── flash.sh                # 一键 configure -> build -> 烧录 -> 复位
    └── debug-server.sh         # 启动 ST-LINK GDB Server（端口 61234）

一、在 CLion 中打开

1. File → Open 选择本目录，CLion 自动识别 CMakeLists.txt + CMakePresets.json。
2. Settings → Build, Execution, Deployment → Toolchains：
   • 添加一个工具链，Debugger 选 arm-none-eabi-gdb（通常 CLion 会自动发现 CubeCLT 工具链）。
3. Settings → Build, Execution, Deployment → CMake：
   • Debug profile 的配置类型会读取 CMakePresets.json 的 Debug 预设，无需手填 toolchain file。
4. 加载完成后，右上角可直接 Build，产物为 build/Debug/stm32f103_spl_clion.elf。

二、编译

• CLion：点 Build 按钮。
• 命令行：

  cmake --preset Debug
  cmake --build --preset Debug
  

三、烧录（ST-Link / SWD）

• 一键脚本（命令行，自包含 configure+build+flash）：

  bash tools/flash.sh
  

  注意：flash.sh 使用独立的 build/ 目录；若想烧录 CLion 的产物，用下面的方式。

• CLion 内烧录：安装 STM32CubeProgrammer / OpenOCD 插件后配置 Run。

四、调试（GDB + ST-Link）

1. 接好 ST-Link（SWD），给板子供电。
2. 终端启动 GDB Server：

   bash tools/debug-server.sh   # 监听 localhost:61234，under-reset 模式
   

3. CLion 中新建 Embedded GDB Server 调试配置：
   • Target：stm32f103_spl_clion.elf
   • GDB：arm-none-eabi-gdb
   • 连接：target remote localhost:61234
4. 点 Debug，可下断点、单步。

修改工程名

工程名集中在两处：CMakeLists.txt 的 CMAKE_PROJECT_NAME 与 tools/flash.sh 的 ELF。