第17章嵌入式MCU项目实战(STM32)

课程目录第17章嵌入式MCU项目实战(STM32)

第17章嵌入式MCU项目实战(STM32)：项目结构、启动文件与链接脚本、Flash与RAM配置

说实话，嵌入式项目做到一定规模，你就会发现——项目结构和链接脚本才是真正的分水岭。很多人能点亮LED，能跑FreeRTOS，但一遇到Flash不够用、RAM溢出、或者启动就HardFault，就彻底懵了。

我当年带团队时，有个同事折腾了三天，发现是链接脚本里堆栈地址写错了。嗯，这种坑，踩过一次就忘不了。

今天咱们就拿STM32F4系列为例，把项目结构、启动文件、链接脚本、Flash与RAM配置这些硬骨头，一块一块啃干净。

17.1 项目结构：别让文件乱成一锅粥

我个人习惯，嵌入式项目一定要分层。不是装样子，是真能救命。你想想看，一个项目几十个文件，全扔src里，找bug时翻来翻去，心态直接崩。

我推荐的结构长这样：

project_root/
├── CMakeLists.txt              # 顶层CMake
├── cmake/
│   ├── toolchain_stm32f4.cmake # 工具链配置
│   └── stm32f4xx.ld            # 链接脚本
├── startup/
│   └── startup_stm32f407xx.s   # 启动文件
├── drivers/
│   ├── CMakeLists.txt
│   ├── gpio.c
│   └── gpio.h
├── middleware/
│   ├── CMakeLists.txt
│   └── fatfs/
├── app/
│   ├── CMakeLists.txt
│   ├── main.c
│   └── tasks.c
└── config/
    └── stm32f4xx_hal_conf.h

每个子目录都有自己的CMakeLists.txt，顶层只负责add_subdirectory。这样做的好处是——模块独立，编译快，改一处不影响全局。

我的小技巧： 把启动文件和链接脚本单独放一个目录，不要和源码混在一起。我曾经见过有人把启动文件放src里，结果git merge时冲突了，修了半天。

17.2 启动文件：MCU的“第一行代码”

启动文件是汇编写的，很多人一看就头大。但说白了，它只干三件事：

设置堆栈指针——从链接脚本里取__initial_sp的值
初始化中断向量表——把Reset_Handler、NMI_Handler等地址填好
跳转到C环境——调用SystemInit()，然后跳main()

我截一段STM32F407的启动文件核心代码：

; 启动文件 startup_stm32f407xx.s (片段)
.section .isr_vector, "a", %progbits
.globl g_pfnVectors
g_pfnVectors:
    .word _estack                ; 栈顶地址
    .word Reset_Handler          ; 复位中断
    .word NMI_Handler            ; NMI中断
    ; ... 其他中断向量 ...

.section .text.Reset_Handler
.weak Reset_Handler
.type Reset_Handler, %function
Reset_Handler:
    ldr sp, =_estack             ; 设置栈指针
    bl SystemInit                ; 初始化时钟等
    bl main                      ; 跳转到主函数
    bx lr

注意那个.weak关键字——它允许你在C代码里重新定义这些中断处理函数。如果你没定义，就用默认的弱符号（通常是死循环）。

避坑指南： 我曾经遇到一个bug，启动文件里忘了设置栈指针，结果一进中断就跑飞。排查了整整一天，最后发现是ld sp那行被注释掉了。嗯，从那以后我每次改启动文件都会double-check。

17.3 链接脚本：Flash和RAM的“地图”

链接脚本（.ld文件）告诉链接器：你的代码放哪，数据放哪。STM32F407的Flash是1MB，RAM是192KB（128KB SRAM1 + 64KB SRAM2）。

一个典型的链接脚本长这样：

/* stm32f4xx.ld */
MEMORY
{
    FLASH (rx)  : ORIGIN = 0x08000000, LENGTH = 1M
    RAM   (rwx) : ORIGIN = 0x20000000, LENGTH = 128K
    RAM2  (rwx) : ORIGIN = 0x20020000, LENGTH = 64K
}

SECTIONS
{
    .isr_vector : {
        KEEP(*(.isr_vector))   ; 中断向量表，必须放在开头
    } > FLASH

    .text : {
        *(.text*)              ; 代码段
        *(.rodata*)            ; 只读数据
    } > FLASH

    .data : {
        _sdata = .;
        *(.data*)              ; 初始化数据
        _edata = .;
    } > RAM AT > FLASH         ; 运行时在RAM，初始值在Flash

    .bss : {
        _sbss = .;
        *(.bss*)               ; 未初始化数据
        _ebss = .;
    } > RAM

    _estack = ORIGIN(RAM) + LENGTH(RAM);  ; 栈顶在RAM末尾
}

这里有个关键点：.data段用了AT > FLASH，意思是运行时在RAM，但初始值存在Flash里。启动文件里的_sdata和_edata就是用来做这个拷贝的。

  核心理解： Flash是只读的，RAM是可读写的。全局变量必须放在RAM里，但初始值得从Flash拷过来。这个拷贝动作，就是启动文件里那个循环完成的。

17.4 Flash与RAM配置：别让内存“打架”

配置Flash和RAM，说白了就是回答三个问题：

代码放哪？ —— Flash，地址0x08000000开始
全局变量放哪？ —— RAM，地址0x20000000开始
栈放哪？ —— RAM末尾，地址由_estack指定

我画了一张图，帮你理清整个内存布局：

这张图里，Flash和RAM的对应关系一目了然。注意栈是从RAM末尾向下生长的，堆是从.data段末尾向上生长的。如果堆和栈撞上了，那就是经典的“堆栈溢出”——程序会莫名其妙地跑飞。

我的经验： 调试堆栈溢出有个笨办法——在链接脚本里把栈区填一个固定模式（比如0xDEADBEEF），然后跑程序，最后看栈区被改写了多少。我常用这个办法来估算实际栈用量。

17.5 CMake集成：让构建自动化

有了启动文件和链接脚本，怎么把它们集成到CMake里？我直接给代码：

# CMakeLists.txt (顶层)
cmake_minimum_required(VERSION 3.20)
project(stm32f4_demo C ASM)

# 指定工具链
set(CMAKE_TOOLCHAIN_FILE cmake/toolchain_stm32f4.cmake)

# 添加启动文件
set(STARTUP_SOURCES
    startup/startup_stm32f407xx.s
)

# 添加源码
set(APP_SOURCES
    app/main.c
    drivers/gpio.c
)

# 生成可执行文件
add_executable(${PROJECT_NAME}
    ${STARTUP_SOURCES}
    ${APP_SOURCES}
)

# 指定链接脚本
target_link_options(${PROJECT_NAME} PRIVATE
    -T ${CMAKE_SOURCE_DIR}/cmake/stm32f4xx.ld
    -Wl,--gc-sections
    -Wl,-Map=${PROJECT_NAME}.map
)

# 生成hex和bin文件
add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
    COMMAND ${CMAKE_OBJCOPY} -O ihex ${PROJECT_NAME} ${PROJECT_NAME}.hex
    COMMAND ${CMAKE_OBJCOPY} -O binary ${PROJECT_NAME} ${PROJECT_NAME}.bin
    COMMENT "Generating hex and bin files..."
)

注意-Wl,--gc-sections这个选项——它能自动删除未使用的函数和变量，对嵌入式项目特别有用。我见过有人不加这个，结果一个简单的LED闪烁程序编译出来50KB，加了之后只剩8KB。

避坑指南： 链接脚本里的内存地址一定要和芯片手册一致。我曾经接手一个项目，链接脚本里RAM地址写成了0x20010000，但芯片实际RAM起始是0x20000000。结果全局变量全跑偏了，程序一运行就HardFault。查了三天，最后发现是地址写错了。

17.6 实战要点总结

嗯，说了这么多，我帮你把核心要点捋一遍：

组件	作用	常见错误
启动文件	设置栈指针、初始化中断向量、跳转main	栈指针未设置、中断向量表对齐错误
链接脚本	定义Flash/RAM布局、段分配	地址写错、段重叠、堆栈位置不对
Flash配置	存放代码和只读数据	代码超过Flash大小、未使能Flash预取
RAM配置	存放变量、堆栈	堆栈溢出、未初始化变量访问

最后说一句——别怕看启动文件和链接脚本。我第一次看的时候也觉得头大，但硬着头皮啃下来之后，对MCU的理解直接上了一个台阶。你想想看，连芯片怎么启动、内存怎么分配都搞清楚了，还有什么能难住你？

好了，这一章就到这。动手试试，把项目结构搭起来，把启动文件和链接脚本跑通。遇到问题别慌，回头看看这张图，思路就清晰了。

📚 课程目录