ARM GCC 编译环境快速搭建指南，Spring Boot Swagger3常用注解详解与实战。

ARM GCC 编译环境搭建基础

安装 ARM GCC 工具链是构建交叉编译环境的第一步。主流 Linux 发行版通常提供预编译的 ARM GCC 包，例如在 Ubuntu/Debian 上可通过以下命令安装：

sudo apt-get install gcc-arm-none-eabi

Windows 用户可下载 ARM GNU Toolchain 官方预编译包，解压后需将 bin/ 目录添加到系统 PATH 环境变量。

验证安装是否成功：

arm-none-eabi-gcc --version

构建系统配置

CMake 是管理交叉编译项目的推荐工具。创建 toolchain-arm.cmake 文件指定工具链路径：

set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR ARM)
set(CMAKE_C_COMPILER arm-none-eabi-gcc)
set(CMAKE_CXX_COMPILER arm-none-eabi-g++)

对于简单的 Makefile 项目，需明确指定编译器：

CC = arm-none-eabi-gcc
CFLAGS = -mcpu=cortex-m4 -mthumb -specs=nosys.specs

典型编译选项优化

针对 ARM Cortex-M 系列处理器的关键编译参数：

arm-none-eabi-gcc -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 \
                  -mthumb -specs=nosys.specs -O2 -c source.c

调试信息与优化级别组合：

-g3 -Og   # 最佳调试体验
-Os       # 最小代码体积
-O3       # 最大性能优化

链接脚本与启动文件处理

典型链接脚本 (linker.ld) 需要定义内存布局：

MEMORY {
  FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 512K
  RAM (rwx)  : ORIGIN = 0x20000000, LENGTH = 128K
}

编译启动文件需特殊处理：

arm-none-eabi-gcc -x assembler-with-cpp -c startup_stm32.s

自动化构建实践

集成 OpenOCD 进行自动化烧录：

openocd -f interface/stlink-v2.cfg -f target/stm32f4x.cfg \
        -c "program build/firmware.elf verify reset exit"

使用 CI/CD 工具（如 GitHub Actions）的配置示例：

- name: Build firmware
  run: |
    make -j$(nproc) all
    arm-none-eabi-size build/*.elf