STM32多硬件C项目如何避免在引脚初始化函数中使用#ifdef？

下面提供三种无需使用#ifdef的解决方案，适配你的CMake构建流程：

方案1：CMake传递硬件专属宏定义（带默认占位符） #

通过CMake为不同硬件传递完整的引脚与时钟宏，硬件2使用无效占位符让初始化逻辑自动跳过。

修改CMakeLists.txt #

# 选择目标硬件
set(TARGET_HARDWARE "HARDWARE1" CACHE STRING "Target hardware: HARDWARE1 or HARDWARE2")

if(TARGET_HARDWARE STREQUAL "HARDWARE1")
    add_compile_definitions(HARDWARE1)
    # 为硬件1定义实际的引脚与时钟宏
    add_compile_definitions(NIT_GPIO_PORT=GPIOB)
    add_compile_definitions(NIT_GPIO_PIN=GPIO_PIN_2)
    add_compile_definitions(NIT_GPIO_CLK_ENABLE=__HAL_RCC_GPIOB_CLK_ENABLE())
elseif(TARGET_HARDWARE STREQUAL "HARDWARE2")
    add_compile_definitions(HARDWARE2)
    # 为硬件2定义无效占位符，让初始化逻辑不执行
    add_compile_definitions(NIT_GPIO_PORT=0)
    add_compile_definitions(NIT_GPIO_PIN=0)
    add_compile_definitions(NIT_GPIO_CLK_ENABLE=(void)0)
endif()

# 后续的编译、链接逻辑保持不变
add_executable(${PROJECT_NAME} main.c hard_conf.c)
target_link_libraries(${PROJECT_NAME} ...)

修改hard_conf.c #

#include "hard_conf.h"
#include "stm32f4xx_hal.h"

void InitPinNit(void) {
    // 仅当引脚端口有效时执行初始化
    if(NIT_GPIO_PORT != 0) {
        GPIO_InitTypeDef GPIO_InitStruct = {0};
        NIT_GPIO_CLK_ENABLE;
        GPIO_InitStruct.Pin = NIT_GPIO_PIN;
        GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
        GPIO_InitStruct.Pull = GPIO_NOPULL;
        GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
        HAL_GPIO_Init(NIT_GPIO_PORT, &GPIO_InitStruct);
    }
}

优点：代码改动小，无需拆分文件，适合硬件差异较小的场景。

方案2：硬件专属实现文件分离 #

将不同硬件的引脚初始化逻辑拆分到独立文件中，CMake根据选择的硬件链接对应文件，完全避免宏定义冲突。

新增硬件实现文件 #

• hardware1_conf.c（硬件1的引脚初始化）

#include "hard_conf.h"
#include "stm32f4xx_hal.h"

void InitPinNit(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    __HAL_RCC_GPIOB_CLK_ENABLE();
    GPIO_InitStruct.Pin = GPIO_PIN_2;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
}

• hardware2_conf.c（硬件2的空实现）

#include "hard_conf.h"

void InitPinNit(void) {
    // 硬件2无需该引脚，空实现即可
}

修改CMakeLists.txt #

set(TARGET_HARDWARE "HARDWARE1" CACHE STRING "Target hardware: HARDWARE1 or HARDWARE2")

# 根据硬件选择要编译的文件
if(TARGET_HARDWARE STREQUAL "HARDWARE1")
    add_compile_definitions(HARDWARE1)
    set(HARDWARE_CONF_FILE "hardware1_conf.c")
elseif(TARGET_HARDWARE STREQUAL "HARDWARE2")
    add_compile_definitions(HARDWARE2)
    set(HARDWARE_CONF_FILE "hardware2_conf.c")
endif()

add_executable(${PROJECT_NAME} main.c hard_conf.c ${HARDWARE_CONF_FILE})
target_link_libraries(${PROJECT_NAME} ...)

修改hard_conf.h #

仅保留函数声明，移除所有硬件相关宏：

#ifndef HARD_CONF_H
#define HARD_CONF_H

void InitPinNit(void);

#endif

优点：硬件逻辑完全隔离，维护性强，适合硬件差异较大的项目。

方案3：使用GCC弱符号覆盖 #

为引脚初始化函数定义默认弱实现，硬件1提供强实现覆盖它，硬件2直接使用默认空实现。

修改hard_conf.c（默认弱实现） #

#include "hard_conf.h"

// 定义弱符号函数，硬件1可提供强实现覆盖
__attribute__((weak)) void InitPinNit(void) {
    // 默认空实现，硬件2直接使用
}

新增hardware1.c（硬件1的强实现） #

#include "hardware1.h"
#include "stm32f4xx_hal.h"

// 强符号函数，编译时会覆盖弱符号
void InitPinNit(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    __HAL_RCC_GPIOB_CLK_ENABLE();
    GPIO_InitStruct.Pin = GPIO_PIN_2;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
}

修改CMakeLists.txt #

set(TARGET_HARDWARE "HARDWARE1" CACHE STRING "Target hardware: HARDWARE1 or HARDWARE2")

add_executable(${PROJECT_NAME} main.c hard_conf.c)

if(TARGET_HARDWARE STREQUAL "HARDWARE1")
    add_compile_definitions(HARDWARE1)
    target_sources(${PROJECT_NAME} PRIVATE hardware1.c)
elseif(TARGET_HARDWARE STREQUAL "HARDWARE2")
    add_compile_definitions(HARDWARE2)
endif()

target_link_libraries(${PROJECT_NAME} ...)

优点：代码侵入性低，无需修改原有函数结构，适合小范围的硬件差异适配。

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