嵌入式项目：如何用GCC从多文件初始化无RAM占用的const结构体数组

核心思路是利用GCC的自定义段属性和链接脚本，将各个模块的注册结构体直接放到ROM（FLASH）的连续区域，完全不需要占用RAM。

步骤1：定义模块结构体类型 #

先在公共头文件里定义统一的模块描述结构体：

// module.h
#ifndef MODULE_H
#define MODULE_H

typedef struct {
    const char* name;       // 模块名称
    void (*init)(void);     // 模块初始化函数
    // 可添加其他模块属性，比如版本号、接口函数等
} Module;

#endif

步骤2：模块自行注册到自定义段 #

每个需要注册的模块，在自己的.c文件里定义一个const修饰的Module实例，并通过GCC的__attribute__((section(".modules")))属性把它放到自定义的.modules段：

// led_module.c
#include "module.h"

static void led_init(void) {
    // LED模块初始化逻辑，比如配置GPIO
}

// 注册到.modules段，const确保数据存ROM
const Module led_module __attribute__((section(".modules"))) = {
    .name = "LED Module",
    .init = led_init
};

// uart_module.c
#include "module.h"

static void uart_init(void) {
    // UART模块初始化逻辑
}

const Module uart_module __attribute__((section(".modules"))) = {
    .name = "UART Module",
    .init = uart_init
};

步骤3：修改链接脚本合并自定义段 #

修改项目的链接脚本（比如STM32的STM32F407ZG_FLASH.ld），添加对.modules段的处理，把所有模块的注册结构体合并成连续的ROM数组，并定义数组的起始和结束标记：

/* 在FLASH区域的段定义中添加以下内容 */
.modules : {
    __modules_start = .;    // 模块数组起始地址标记
    KEEP(*(.modules))       // 强制保留该段，防止链接器优化未直接引用的模块
    __modules_end = .;      // 模块数组结束地址标记
} > FLASH                   // 指定该段存放到FLASH（ROM）

注意：KEEP(*(.modules))必须加，否则链接器可能因为代码里没有直接引用某个模块的实例，把它从最终固件里删掉。

步骤4：在头文件声明标记，实现遍历 #

回到module.h，添加链接器定义的起始/结束标记的声明，再封装遍历宏方便使用：

// module.h 补充内容
extern const Module __modules_start[];
extern const Module __modules_end[];

// 遍历所有模块的宏，直接通过地址偏移遍历ROM数组
#define FOR_EACH_MODULE(module_ptr) \
    for (const Module* module_ptr = __modules_start; \
         module_ptr < __modules_end; \
         module_ptr++)

步骤5：主程序中使用注册的模块 #

在主程序里就可以遍历ROM里的模块数组，比如批量初始化所有模块：

#include "module.h"

int main(void) {
    // 初始化所有注册的模块
    FOR_EACH_MODULE(mod) {
        mod->init();
    }

    while(1) {
        // 主循环逻辑
    }
}

为什么不占用RAM？ #

• 所有Module实例都用const修饰，编译器会把它们放到只读数据段，最终通过链接脚本定位到FLASH（ROM）
• __modules_start和__modules_end是链接器生成的地址符号，只是存储地址值，不占用RAM空间
• 完全不需要之前的动态分配指针数组，避免了RAM的占用

注意事项 #

• 确保所有模块的Module实例都加const，否则可能被编译器放到RAM里
• 如果使用IDE（比如Keil、STM32CubeIDE），需要找到项目对应的链接脚本文件进行修改
• 不同MCU的链接脚本结构可能略有差异，但核心都是把自定义段放到ROM区域并保留

内容的提问来源于stack exchange，提问作者rom1nux