STM32WB55 Thread项目编译出现Undefined Reference错误求助

数据老陈

2026-7-3

修复STM32WB55 Thread FTD项目Undefined Reference链接错误的方案

检查STM32_WPAN组件配置完整性
确认STM32CubeMX中STM32_WPAN模块的THREAD模式下，已勾选所有必要子组件：展开配置项，确保OpenThread FTD、SHCI Thread Interface、内存管理组件等选项全部启用。生成代码后，查看Middlewares/ST/STM32_WPAN目录，确认包含amm.c、lst.c、shci_thread.c等依赖源文件，缺失则重新生成代码并保存配置。
验证链接脚本与内存分配
检查项目的.ld链接脚本，确保为Thread栈、堆及SHCI共享内存分配了符合STM32WB55双核布局的空间（CM4与CM0+的内存分区需正确映射）。同时核对stm32wbxx_hal_conf.h中AMM_MEMORY_SIZE等内存管理宏定义，避免因配置不匹配导致函数未编译。
检查编译选项与源文件包含
确认STM32CubeIDE工程中，已将Middlewares/ST/STM32_WPAN/OpenThread和Middlewares/ST/STM32_WPAN/SHCI目录下的所有.c源文件添加到编译列表。全局启用-fvisibility=default编译选项，确保相关函数可见性未被设为hidden。
核对OpenThread版本与适配层
使用与官方Thread示例一致的STM32CubeWB包版本，避免版本不兼容导致otInstanceInitSingle等函数接口不匹配。检查用户代码中是否正确包含openthread.h、shci_thread.h等头文件，且头文件路径配置无误。
清理与重新构建项目
执行Clean Project后再进行Build Project，清除旧编译缓存。确认项目预编译选项中已定义STM32WB55xx、THREAD_FTD、USE_FULL_LL_DRIVER等必要宏，避免编译条件缺失导致函数未生成。