无libc及启动文件的STM32H7固件中添加sprintf调用的链接错误问题求助

阿华AIGC实验室

2026-3-31

无libc及启动文件的STM32H7固件中添加sprintf调用的链接错误问题解决

看起来你已经离解决问题很近了！最后遇到的undefined reference to 'end'是nosys库的_sbrk函数依赖的链接器符号，下面给你一步步的解决方法，完全贴合你不想改动太多现有固件、手动管理堆的需求：

核心问题分析

当你使用nosys.specs时，它提供的_sbrk实现（sprintf的某些版本依赖它做动态内存分配）需要end符号来确定堆的起始地址——这个符号通常由链接器脚本定义，标记BSS段的结束位置，也就是堆应该开始的地方。

第一步：在链接脚本中定义`end`符号

打开你的xxx.ld链接脚本，找到BSS段的定义部分，在BSS段结束后添加end = .;即可。示例如下：

/* 假设你的BSS段定义是这样的 */
.bss :
{
  __bss_start__ = .;
  *(.bss*)
  *(COMMON)
  __bss_end__ = .;
} > RAM

/* 添加这一行，定义堆的起始符号 */
end = .;

这会让链接器自动生成end符号，解决当前的未定义引用错误。

第二步：手动控制堆的范围（可选但强烈推荐）

既然你希望手动初始化堆，不如完全接管堆的管理，避免nosys默认实现可能带来的内存溢出风险。你可以：

先在链接脚本中定义堆的结束地址（根据你的STM32H7 RAM大小调整，比如预留64KB堆空间，同时给栈留足够余量）：

/* 假设你的RAM起始是0x20000000，大小是512KB */
_heap_end = 0x20000000 + 0x80000 - 0x1000; /* 栈通常从RAM顶端向下生长，留4KB余量 */

在你的固件初始化代码中，替换nosys的_sbrk实现，严格限制堆的使用范围：

#include <errno.h>
#include <stdint.h>

/* 引用链接脚本中定义的符号 */
extern char end[];
extern char _heap_end[];

/* 堆当前的指针，初始化为堆的起始位置 */
static char* current_heap_ptr = end;

/* 自定义_sbrk实现，用于动态内存分配 */
void* _sbrk(int incr) {
    char* prev_heap_ptr = current_heap_ptr;

    /* 检查堆是否超出预设的结束地址，避免溢出到栈或其他内存区域 */
    if ((current_heap_ptr + incr) > _heap_end) {
        errno = ENOMEM;
        return (void*)-1;
    }

    current_heap_ptr += incr;
    return prev_heap_ptr;
}

这样你就完全掌控了堆的内存范围，比依赖nosys的默认实现更安全，也符合你尽量少依赖标准库的需求。

第三步：调整链接命令，确保sprintf正常工作

结合你的需求，最终的链接命令可以调整为：

arm-none-eabi-gcc -T"xxx.ld" -Wl,-Map=xxx.map -o xxx -mcu=cortex-m7 -mfpu=fpv5-d16 -mfloat-abi=hard -mthumb -L<path to libm> -specs=nano.specs -specs=nosys.specs -nostartfiles -u _printf_float

这里的关键参数说明：

-nostartfiles：继续跳过标准启动文件，和你现有固件的启动流程兼容，避免之前出现的main未定义错误
-u _printf_float：如果你的sprintf需要处理浮点数，必须加这个参数，否则浮点数输出会被忽略或出错（如果不需要浮点数可以去掉）
保留-specs=nano.specs：使用轻量的newlib-nano库，减小固件体积

额外注意事项

手动初始化BSS段：如果你还没做这一步，必须在固件的复位处理函数（比如Reset_Handler）中手动清零BSS段，否则堆起始位置的内存可能有残留垃圾数据：

void Reset_Handler(void) {
    /* 清零BSS段 */
    extern char __bss_start__, __bss_end__;
    for (char* ptr = &__bss_start__; ptr < &__bss_end__; ptr++) {
        *ptr = 0;
    }

    /* 其他初始化代码（比如时钟、外设）... */
    /* 调用你的固件主逻辑入口 */
}