从零搭建 STM32 嵌入式开发环境#

告别 CubeIDE，拥抱命令行#

很多嵌入式开发者习惯了 STM32CubeIDE 的图形界面，但当你需要自动化构建、CI/CD 集成、或者跨平台开发时，命令行工具链是更好的选择。

GNU ARM 工具链配置#

1
# macOS 安装
2
brew install --cask gcc-arm-embedded
3

4
# Linux 安装
5
wget https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/\
6
arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
7
tar -xf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
8
export PATH=$PATH:/opt/arm-gnu-toolchain/bin
9

10
# 验证
11
arm-none-eabi-gcc --version

CMake 构建系统#

现代的 STM32 项目应该使用 CMake 管理。一个典型项目的 CMakeLists.txt：

1
cmake_minimum_required(VERSION 3.20)
2
project(stm32f4-blink C ASM)
3

4
set(CMAKE_SYSTEM_NAME Generic)
5
set(CMAKE_SYSTEM_PROCESSOR arm)
6
set(CMAKE_C_COMPILER arm-none-eabi-gcc)
7
set(CMAKE_CXX_COMPILER arm-none-eabi-g++)
8

9
# 处理器配置
10
set(CPU_FLAGS "-mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16")
11
set(CMAKE_C_FLAGS "${CPU_FLAGS} -Os -Wall -ffunction-sections -fdata-sections")
12
set(CMAKE_EXE_LINKER_FLAGS "${CPU_FLAGS} -T${CMAKE_SOURCE_DIR}/STM32F407VGTx_FLASH.ld -Wl,--gc-sections")

OpenOCD 调试实战#

1
# 启动 OpenOCD
2
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg
3

4
# GDB 连接（另一个终端）
5
arm-none-eabi-gdb build/stm32f4-blink.elf
6
(gdb) target extended-remote :3333
7
(gdb) monitor reset halt
8
(gdb) load
9
(gdb) continue

FreeRTOS 集成要点#

在 STM32 上跑 FreeRTOS 需要注意三件事：

SysTick 冲突：FreeRTOS 使用 SysTick 作为心跳，HAL 库也依赖 SysTick。解决方式是让 HAL 使用一个硬件定时器，把 SysTick 留给 RTOS。
中断优先级：STM32 使用 NVIC 优先级分组。确保 configMAX_SYSCALL_INTERRUPT_PRIORITY 设置正确，允许在临界区中调用 FromISR 函数。
栈溢出检测：开启 configCHECK_FOR_STACK_OVERFLOW = 2，在任务栈底部放置 canary 值。

持续集成#

用 GitHub Actions 自动化构建：

1
name: Build
2
on: [push, pull_request]
3
jobs:
4
  build:
5
    runs-on: ubuntu-latest
6
    steps:
7
      - uses: actions/checkout@v3
8
      - name: Install toolchain
9
        run: |
10
          sudo apt-get install gcc-arm-none-eabi cmake
11
      - name: Build
12
        run: |
13
          mkdir build && cd build
14
          cmake .. && make -j$(nproc)