1. 问题现象:串口输出卡死的诡异现象
最近在玩RT-Thread和STM32的时候遇到了一个特别诡异的问题:程序调试的时候经常会卡死在Stm32_putc函数里,而且这个问题还不稳定,有时候重新上电就能正常,有时候又不行。最让人头疼的是,这种现象完全没有规律可言,就像抽奖一样,你永远不知道下一次启动是会正常还是卡死。
具体表现就是,当你通过串口输出调试信息时,程序运行到某个点就完全不动了,查看调用栈会发现卡在了串口发送函数里。这个问题特别影响开发效率,因为你根本不知道是代码逻辑问题还是底层系统问题。我自己就曾经为了这个问题折腾了好几天,各种单步调试、打印日志,最后才发现原来问题出在内存初始化这个看似不相关的地方。
实际上,这个问题背后隐藏着RT-Thread在STM32平台上一个很重要的机制:分散加载文件和内存分配。很多开发者都会忽略这个配置,直到遇到类似的问题才恍然大悟。接下来我就详细说说我是怎么排查这个问题的,以及最终的解决方案。
2. 问题排查:一步步追踪卡死根源
2.1 初步排查:从串口初始化入手
当我第一次遇到Stm32_putc卡死的问题时,第一反应就是先检查串口初始化是否正常。因为控制台输出依赖于串口,如果串口没有正确初始化,那么后续的发送操作肯定会出问题。
我在drv_usart.c的初始化函数里打了断点,发现程序确实会进入串口初始化流程。但是通过单步调试发现了一个奇怪的现象:HAL_UART_MspInit这个函数居然没有被调用!这个函数是HAL库中用来初始化具体硬件引脚和中断的,如果它没有被执行,那串口根本不可能正常工作。
进一步查看代码发现,问题出在一个状态判断上:huart->gState不等于HAL_UART_STATE_RESET,导致初始化流程直接跳过。这就很奇怪了,为什么一个刚刚声明的结构体,其状态字段不是默认的复位值呢?
2.2 深入追踪:状态值从何而来
为了搞清楚huart->gState这个状态值到底是从哪里来的,我用了最直接的方法:全局搜索HAL_UART_STATE_READY,并在所有给gState赋值的地方都打上断点。结果令人惊讶——复位后运行程序,这些断点一个都没有触发。
这说明huart->gState的值不是在运行时被赋值的,而是在程序启动时就已经有了一个非零值。这立刻让我想到了内存初始化的问题:可能是这个结构体所在的内存区域没有被正确清零。
于是我开始追溯huart的来历。huart是uart->handle,而uart是一个stm32_uart结构体,它是通过rt_container_of宏从rt_serial_device计算出来的。这个宏是RT-Thread中常用的技巧,可以通过结构体成员的地址反推出整个结构体的起始地址。
2.3 根源定位:ZI段未清零的真相
最终我找到了stm32_uart结构体的定义和初始化位置。在rt_hw_usart_init函数中,uart_obj数组被声明为静态全局变量,并且初始化为{0}。照理说,这样声明的变量所有字段都应该被初始化为0,但实际调试发现,这些结构体的字段确实有非零值!
这时候我多年的嵌入式开发经验告诉我:这很可能是ZI段(Zero Initialized segment)没有在启动时被自动清零。ZI段指的是那些被初始化为0的全局变量和静态变量,编译器通常会为这些变量单独分配一个内存区域,并在程序启动时自动清零。
但在我的项目中,这个自动清零的过程似乎没有发生。于是我手动在初始化前添加了rt_memset(&uart_obj[i], 0, sizeof(struct stm32_uart)),果然串口卡死的问题就解决了。
3. 技术深挖:分散加载文件的作用机制
3.1 什么是分散加载文件
分散加载文件(Scatter-Loading Description File)是ARM编译器中使用的一种内存映射描述文件,它详细定义了代码和数据在内存中的布局方式。对于复杂的嵌入式系统,特别是使用RTOS的系统,分散加载文件几乎是必不可少的。
在MDK(Keil)开发环境中,默认情况下编译器会自动生成内存布局,但有时候这种自动生成的布局并不能满足我们的需求。比如在RT-Thread中,由于存在多线程、设备驱动等复杂的内存需求,往往需要手动配置分散加载文件来确保内存的正确分配。
分散加载文件的核心作用是告诉链接器:哪些代码段放在哪里,哪些数据段放在哪里,堆栈如何分配等。它就像是一个内存的"城市规划图",确保每个部分都在正确的位置。
3.2 ZI段清零的机制
ZI段的清零是在系统启动时完成的,通常是由启动文件中的代码负责。在ARM Cortex-M系统中,这个过程大致如下:
首先,启动代码会复制初始化数据从Flash到RAM中(这是针对已初始化的全局变量),然后会将ZI段对应的内存区域全部清零,最后才跳转到main函数执行。
但是,如果你使用了自定义的分散加载文件,就需要确保这个清零机制仍然正常工作。有时候因为内存布局的改变,编译器可能无法自动生成正确的ZI清零代码,这就需要手动在分散加载文件中指定。
/* 典型的分散加载文件片段 */
LR_IROM1 0x08000000 0x00010000 { ; 加载区域
ER_IROM1 0x08000000 0x00010000 { ; 执行区域
*.o (RESET, +First)
*(InRoot$$Sections)
.ANY (+RO)
}
RW_IRAM1 0x20000000 0x00020000 { ; RW数据区
.ANY (+RW +ZI)
}
}
3.3 RT-Thread中的内存管理
RT-Thread有自己的内存管理机制,特别是在启用动态内存分配时,它会维护自己的堆内存池。这与编译器的内存分配机制需要协调工作,否则就容易出现各种奇怪的问题。
在RT-Thread中,通常会在启动时初始化系统堆内存:
/* RT-Thread内存初始化示例 */
rt_system_heap_init((void*)HEAP_BEGIN, (void*)HEAP_END);
这个初始化过程需要与分散加载文件中定义的内存区域相匹配。如果两者不一致,就可能导致部分内存没有被正确管理,从而出现ZI段未清零等问题。
4. 解决方案:配置对比与实操指南
4.1 默认配置与自定义配置对比
经过实际测试,我发现MDK的默认内存分配方式(使用Target配置)和自定义分散加载文件在ZI段处理上确实有差异。以下是两种方式的对比:
默认Target配置:
- 优点:简单易用,无需额外配置
- 缺点:内存布局不够灵活,有时ZI清零不完整
- 适用场景:简单的单线程应用
自定义分散加载文件:
- 优点:完全控制内存布局,确保ZI段正确清零
- 缺点:需要手动编写和维护配置文件
- 适用场景:复杂的多线程系统,如RT-Thread
4.2 实际操作步骤
如果你也遇到了类似的问题,可以按照以下步骤来配置自定义分散加载文件:
首先,在MDK项目中取消默认的内存布局方式:
- 打开Options for Target对话框
- 选择Linker选项卡
- 取消勾选"Use Memory Layout from Target Dialog"
- 指定自定义的分散加载文件(.sct文件)
然后,创建或修改分散加载文件,确保包含正确的ZI段处理:
LR_IROM1 0x08000000 0x00100000 { ; 加载区域起始地址和大小
ER_IROM1 0x08000000 0x00100000 { ; 执行区域起始地址和大小
*.o (RESET, +First)
*(InRoot$$Sections)
.ANY (+RO)
}
RW_IRAM1 0x20000000 0x00050000 { ; RW/ZI数据区域
.ANY (+RW +ZI)
}
}
最后,在RT-Thread的board.c文件中,确保系统堆内存的初始化与分散加载文件中的定义一致:
/* 修改RT-Thread系统堆内存配置 */
#define HEAP_BEGIN 0x20000000
#define HEAP_END 0x20050000
rt_system_heap_init((void*)HEAP_BEGIN, (void*)HEAP_END);
4.3 验证配置效果
配置完成后,可以通过以下方式验证ZI段是否被正确清零:
首先,编译项目并查看生成的map文件,确认ZI段的大小和位置是否符合预期。然后,在启动代码的__main函数之前设置断点,观察ZI段内存的值(应该是未初始化状态),在__main函数执行后再观察同样的内存区域,应该已经被清零了。
还可以在应用程序中添加测试代码,检查关键全局变量的初始值:
/* ZI段清零测试 */
struct test_struct {
int value;
void *pointer;
} global_var;
void test_zi_clear(void) {
if (global_var.value != 0 || global_var.pointer != NULL) {
rt_kprintf("ZI clear failed!\n");
} else {
rt_kprintf("ZI clear success!\n");
}
}
5. 经验总结与避坑指南
在实际项目中,我遇到过好几次因为ZI段未清零导致的奇怪问题,每次排查都要花费不少时间。现在我会在项目初期就确认好内存布局和ZI段处理机制,避免后期踩坑。
对于RT-Thread开发者,我有几个建议:首先,尽量使用RT-Thread官方提供的BSP和示例项目作为起点,这些项目通常已经配置好了合适的内存布局。其次,如果要做自定义配置,一定要仔细测试ZI段的清零情况,确保没有遗漏。最后,记得定期检查map文件,确认内存使用情况符合预期。
还有一个容易忽略的点是:不同版本的编译器和RT-Thread可能在内存处理上有细微差异,升级工具链或RT-Thread版本后,最好重新验证一下内存配置。
虽然这个问题看起来很深奥,但一旦理解了背后的机制,解决起来并不复杂。关键是要有系统性的排查思路,从现象到底层原因一步步深入,而不是盲目地尝试各种解决方案。
7941



被折叠的 条评论
为什么被折叠?



