STM32嵌入式项目CMake交叉编译多模块拆分配置问题求助

问题根因 #

你遇到的参数丢失、VFP寄存器链接报错的核心原因是：原配置中所有编译参数、宏定义、头路径都以PRIVATE属性绑定到了最终可执行目标上，新增的子模块静态库目标完全无法继承这些配置，导致不同编译单元的浮点ABI、架构参数不一致，触发链接冲突。

改造步骤 #

1. 先修正交叉编译工具链文件 #

原工具链直接在编译器变量后拼接参数的写法不规范，会导致子项目参数继承异常，修改为以下写法：

set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(TOOLCHAIN_PREFIX arm-none-eabi-)

# 用INIT变量初始化全局编译选项，不要直接拼接在编译器路径后
set(CMAKE_C_FLAGS_INIT "-fdata-sections -ffunction-sections --specs=nano.specs" CACHE INTERNAL "")
set(CMAKE_CXX_FLAGS_INIT ${CMAKE_C_FLAGS_INIT} CACHE INTERNAL "")
set(CMAKE_EXE_LINKER_FLAGS_INIT "-Wl,--gc-sections" CACHE INTERNAL "")

set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}gcc CACHE INTERNAL "")
set(CMAKE_ASM_COMPILER ${CMAKE_C_COMPILER} CACHE INTERNAL "")
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}g++ CACHE INTERNAL "")
set(CMAKE_OBJCOPY ${TOOLCHAIN_PREFIX}objcopy CACHE INTERNAL "")
set(CMAKE_SIZE ${TOOLCHAIN_PREFIX}size CACHE INTERNAL "")

set(CMAKE_EXECUTABLE_SUFFIX_ASM ".elf" CACHE INTERNAL "")
set(CMAKE_EXECUTABLE_SUFFIX_C ".elf" CACHE INTERNAL "")
set(CMAKE_EXECUTABLE_SUFFIX_CXX ".elf" CACHE INTERNAL "")

set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY CACHE INTERNAL "")

2. 根CMakeLists.txt改造：抽离公共配置为INTERFACE目标 #

新增一个全局公用的INTERFACE目标，所有子模块通过链接该目标自动继承全局编译参数，不需要重复配置：

# 原有变量定义保留（APP_DIR、Core_DIR、CUBEMX_DIR、MCU_MODEL、EXECUTABLE等）
set(CPU_PARAMETERS
    -mcpu=cortex-m4
    -mthumb
    -mfpu=fpv4-sp-d16
    -mfloat-abi=hard)

set(CPP_FLAGS
    "-fno-rtti -fno-exceptions -fno-threadsafe-statics")

set(STARTUP_SCRIPT ${CUBEMX_DIR}/startup_stm32fxxxxx.s)
set(MCU_LINKER_SCRIPT ${CUBEMX_DIR}/STM32Fxxxxxxx_FLASH.ld)

# ---------------------- 新增：全局公共配置目标 ----------------------
add_library(stm32_common INTERFACE)
# 全局编译选项
target_compile_options(stm32_common INTERFACE
    ${CPU_PARAMETERS}
    -Wall
    -Wextra
    -Wpedantic
    -Wno-unused-parameter
    $<$<COMPILE_LANGUAGE:CXX>:
        ${CPP_FLAGS}
        -Wno-volatile
        -Wold-style-cast
        -Wuseless-cast
        -Wsuggest-override>
    $<$<CONFIG:Debug>:-Og -g3 -ggdb>
    $<$<CONFIG:Release>:-Og -g0>
)
# 全局宏定义
target_compile_definitions(stm32_common INTERFACE
    ${MCU_MODEL}
    USE_HAL_DRIVER
)
# 全局公共头路径
target_include_directories(stm32_common INTERFACE
    ${CMAKE_SOURCE_DIR}
    ${CUBEMX_DIR}/Core/Inc
    # 其他CubeMX生成的头路径都加在这里
    ${Core_DIR}/OwnFramework/CoreModule1
    ${Core_DIR}/OwnFramework/CoreModule2
)
# -------------------------------------------------------------------

# 编译CubeMX生成的代码为独立静态库（可选，拆分后不用每次重新编译这部分）
file(GLOB_RECURSE STM32CUBEMX_SOURCES
    ${CUBEMX_DIR}/Core/*.c
    ${CUBEMX_DIR}/Drivers/*.c
    ${CUBEMX_DIR}/Middlewares/Third_Party/FreeRTOS/Source/*.c
)
add_library(cubemx STATIC ${STM32CUBEMX_SOURCES})
target_link_libraries(cubemx PUBLIC stm32_common)

# 加载子模块
add_subdirectory(Core/OwnFramework/CoreModule1)
add_subdirectory(Core/OwnFramework/CoreModule2)
add_subdirectory(App/Module1)
add_subdirectory(App/Module2)
# 加载第三方库，比如ETL，直接把ETL源码放到Core/Libs/ETL下即可
add_subdirectory(Core/Libs/ETL)

# 生成最终可执行文件
add_executable(${EXECUTABLE}
    ${CUBEMX_DIR}/Core/Src/main.c
    ${STARTUP_SCRIPT}
)
# 链接所有依赖
target_link_libraries(${EXECUTABLE} PRIVATE
    stm32_common
    cubemx
    coremodule1 # 对应CoreModule1的库名
    coremodule2 # 对应CoreModule2的库名
    module1 # 对应Module1的库名
    module2 # 对应Module2的库名
)

# 链接选项仅需放在最终可执行目标上
target_link_options(${EXECUTABLE} PRIVATE
    -T${MCU_LINKER_SCRIPT}
    ${CPU_PARAMETERS}
    -Wl,-Map=${CMAKE_PROJECT_NAME}.map
    --specs=nosys.specs
    -Wl,--start-group
    -lc
    -lm
    -lstdc++
    -lsupc++
    -Wl,--end-group
    -Wl,--print-memory-usage
)

# 原有后处理命令保留
add_custom_command(TARGET ${EXECUTABLE} POST_BUILD
    COMMAND ${CMAKE_SIZE} $<TARGET_FILE:${EXECUTABLE}>
    COMMAND ${CMAKE_OBJCOPY} -O ihex $<TARGET_FILE:${EXECUTABLE}> ${EXECUTABLE}.hex
    COMMAND ${CMAKE_OBJCOPY} -O binary $<TARGET_FILE:${EXECUTABLE}> ${EXECUTABLE}.bin
)

3. 子模块CMakeLists.txt写法示例 #

以App/Module1的CMakeLists.txt为例，仅需配置模块自身的源码、头路径、依赖，全局参数通过链接stm32_common继承：

set(MODULE_NAME module1)

# 建议手动列源码，用GLOB的话加上CONFIGURE_DEPENDS确保新增文件能被检测到
file(GLOB_RECURSE MODULE_SOURCES CONFIGURE_DEPENDS
    ./*.c
    ./*.cpp
)

add_library(${MODULE_NAME} STATIC ${MODULE_SOURCES})

# 链接全局公共配置，以及依赖的其他模块
target_link_libraries(${MODULE_NAME} PUBLIC
    stm32_common
    coremodule1 # 如果依赖CoreModule1就加，不需要就去掉
    ETL::ETL # 如果用到ETL就加
)

# 模块自身的头路径，PUBLIC属性可以让依赖该模块的其他目标自动继承头路径
target_include_directories(${MODULE_NAME} PUBLIC
    ${CMAKE_CURRENT_LIST_DIR}
)

第三方库适配说明 #

ETL这类符合现代CMake规范的第三方库无需额外适配，直接将源码放到Libs目录下用add_subdirectory引入，需要使用的模块链接ETL::ETL即可，编译参数会自动继承全局的stm32_common配置。

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