如何在C++中自定义限定符将数据类型移至外部Flash？

一、核心原理说明 #

Teensy 4.0的EXTMEM本质是通过编译器属性+链接脚本，将指定变量映射到外部Flash的内存段，再配合硬件访问逻辑实现数据的存储与读取。你需要从编译器标记、内存映射、硬件适配三个核心环节入手。

二、具体实现步骤 #

1. 定义自定义EXTMEM限定符 #

利用GCC的__attribute__((section))扩展，封装成直观的宏：

// 自定义EXTMEM宏，标记变量放入指定段
#define EXTMEM __attribute__((section(".extmem.data")))
// 针对只读常量的版本（外部Flash通常只读）
#define EXTMEM_CONST __attribute__((section(".extmem.const")))

编译时，被标记的变量会被归类到.extmem.data或.extmem.const段，而非默认的内部Flash/RAM段。

2. 修改链接脚本映射外部Flash #

在你的链接脚本（通常为.ld文件）中，添加外部Flash的内存区域定义，并将自定义段映射到该区域：

// 定义内存区域：内部Flash、外部Flash、内部RAM
MEMORY
{
    INTERNAL_FLASH (rx) : ORIGIN = 0x00000000, LENGTH = 512K
    EXTERNAL_FLASH (rx) : ORIGIN = 0x10000000, LENGTH = 16M // 按需修改地址和大小
    INTERNAL_RAM (rwx) : ORIGIN = 0x20000000, LENGTH = 128K
}

// 段映射配置
SECTIONS
{
    // 保留原有内部Flash/RAM的段定义...

    // 将EXTMEM变量映射到外部Flash
    .extmem.data :
    {
        __extmem_start = .;
        *(.extmem.data)
        __extmem_end = .;
    } > EXTERNAL_FLASH

    // 只读常量段
    .extmem.const :
    {
        *(.extmem.const)
    } > EXTERNAL_FLASH
}

如果需要可修改的EXTMEM数据，需将段的运行地址设为内部RAM，加载地址设为外部Flash，后续由Bootloader复制：

.extmem.data :
{
    __extmem_start = .;
    *(.extmem.data)
    __extmem_end = .;
} > INTERNAL_RAM AT> EXTERNAL_FLASH

3. 适配处理器的外部Flash访问逻辑 #

因为是自制微控制器，需根据指令集和硬件设计适配访问方式：

• 直接地址映射：如果处理器通过地址译码电路将外部Flash映射到0x10000000地址空间，可直接访问标记的变量，无需额外处理。
• 外设接口访问：如果外部Flash通过SPI/I2C连接，需封装访问函数读取数据：

// SPI读取外部Flash的底层函数示例
uint32_t spi_flash_read(uint32_t flash_offset) {
    // 硬件操作：发送地址、读取数据
    spi_select();
    spi_send_byte(0x03); // 读指令
    spi_send_byte((flash_offset >> 16) & 0xFF);
    spi_send_byte((flash_offset >> 8) & 0xFF);
    spi_send_byte(flash_offset & 0xFF);
    uint32_t data = spi_read_byte() << 24;
    data |= spi_read_byte() << 16;
    data |= spi_read_byte() << 8;
    data |= spi_read_byte();
    spi_deselect();
    return data;
}

// 读取EXTMEM常量的包装函数
#define READ_EXTMEM_CONST(var) spi_flash_read((uint32_t)&var - 0x10000000)

// 使用示例
const EXTMEM_CONST uint32_t large_lookup_table[1024] = {0x00, 0x01, ...};
uint32_t val = READ_EXTMEM_CONST(large_lookup_table[512]);

4. 配合Bootloader完成数据加载 #

如果是可修改的EXTMEM数据，Bootloader需要在启动时将外部Flash中的.extmem.data段复制到内部RAM：

// Bootloader中的复制逻辑
void copy_extmem_to_ram() {
    extern uint32_t __extmem_start;    // 内部RAM中的目标起始地址
    extern uint32_t __extmem_end;      // 内部RAM中的目标结束地址
    extern uint32_t __extmem_load_start; // 外部Flash中的加载起始地址

    uint32_t *src = &__extmem_load_start;
    uint32_t *dst = &__extmem_start;
    uint32_t word_count = (&__extmem_end - &__extmem_start);

    for (uint32_t i = 0; i < word_count; i++) {
        dst[i] = spi_flash_read((uint32_t)&src[i] - 0x10000000);
    }
}

启动时先调用该函数，再跳转到应用程序入口。

三、验证方法 #

编译代码后查看生成的.map文件，确认被EXTMEM标记的变量地址落在0x10000000开头的外部Flash区域；通过调试或串口输出验证变量读取/修改是否正常。

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