STM32F4+STM32CubeIDE下C++类库包含与编译错误求助

问题背景 #

在STM32CubeIDE为STM32F4开发C++自定义类时遇到矛盾：

• 自定义类（如测试用Blinky、实际CANBert）调用HAL库函数时，必须包含HAL头文件才能编译
• 主代码中引入自定义类头文件后，调试器提示标准库重复包含
• 调整类与HAL库的包含层级后问题仍未解决

测试用Blinky类代码 #

Blinky.h #

/*
 * Blinky.h
 *
 *  Created on: Jul 1, 2023
 * 
 */

#ifndef BLINKY_H_
#define BLINKY_H_

#include "stm32f4xx_hal.h"

class Blinky final {
public:
    Blinky();
    virtual ~Blinky();

    void blink(int del);
};

#endif /* BLINKY_H_ */

Blinky.cpp #

/*
 * Blinky.cpp
 *
 *  Created on: Jul 1, 2023
 *
 */

#include "Blinky.h"

Blinky::Blinky() {
    // TODO Auto-generated constructor stub
}

Blinky::~Blinky() {
    // TODO Auto-generated destructor stub
}

void Blinky::blink(int del) {
    HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
    HAL_Delay(delay);
}

main.c中的引入 #

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2023 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under the terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */

#include "Blinky.h"

/* USER CODE END Includes */

/* 以下为main.c其余代码，省略重复部分 */

编译错误信息 #

10:09:31 **** Incremental Build of configuration Debug for project Class_Test ****
make -j8 all 
arm-none-eabi-gcc "../Core/Src/main.c" -mcpu=cortex-m4 -std=gnu11 -g3 -DDEBUG -DUSE_HAL_DRIVER -DSTM32F446xx -c -I../Core/Inc -I../Drivers/STM32F4xx_HAL_Driver/Inc -I../Drivers/STM32F4xx_HAL_Driver/Inc/Legacy -I../Drivers/CMSIS/Device/ST/STM32F4xx/Include -I../Drivers/CMSIS/Include -O0 -ffunction-sections -fdata-sections -Wall -fstack-usage -fcyclomatic-complexity -MMD -MP -MF"Core/Src/main.d" -MT"Core/Src/main.o" --specs=nano.specs -mfpu=fpv4-sp-d16 -mfloat-abi=hard -mthumb -o "Core/Src/main.o"
arm-none-eabi-g++ "../Core/Blinky.cpp" -mcpu=cortex-m4 -std=gnu++14 -g3 -DDEBUG -DUSE_HAL_DRIVER -DSTM32F446xx -c -I../Core/Inc -I../Drivers/STM32F4xx_HAL_Driver/Inc -I../Drivers/STM32F4xx_HAL_Driver/Inc/Legacy -I../Drivers/CMSIS/Device/ST/STM32F4xx/Include -I../Drivers/CMSIS/Include -O0 -ffunction-sections -fdata-sections -fno-exceptions -fno-rtti -fno-use-cxa-atexit -Wall -fstack-usage -fcyclomatic-complexity -MMD -MP -MF"Core/Blinky.d" -MT"Core/Blinky.o" --specs=nano.specs -mfpu=fpv4-sp-d16 -mfloat-abi=hard -mthumb -o "Core/Blinky.o"
../Core/Src/main.c:25:10: fatal error: Blinky.h: No such file or directory
   25 | #include "Blinky.h"
      |          ^~~~~~~~~~
compilation terminated.
make: *** [Core/Src/subdir.mk:34: Core/Src/main.o] Error 1
make: *** Waiting for unfinished jobs....
../Core/Blinky.cpp: In member function 'void Blinky::blink(int)':
../Core/Blinky.cpp:20:21: error: 'LED_GPIO_Port' was not declared in this scope
   20 |  HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
      |                     ^~~~~~~~~~~~~
../Core/Blinky.cpp:20:36: error: 'LED_Pin' was not declared in this scope
   20 |  HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
      |                                    ^~~~~~~
../Core/Blinky.cpp:21:12: error: 'delay' was not declared in this scope; did you mean 'del'?
   21 |  HAL_Delay(delay);
      |            ^~~~~
      |            del
make: *** [Core/subdir.mk:19: Core/Blinky.o] Error 1
"make -j8 all" terminated with exit code 2. Build might be incomplete.

10:09:31 Build Failed. 7 errors, 0 warnings. (took 242ms)

解决方案 #

1. 解决头文件路径问题（Blinky.h找不到） #

• 将Blinky.h移动到Core/Inc目录下，或者在STM32CubeIDE项目设置中给C编译器添加头文件路径：右键项目 → Properties → C/C++ Build → Settings → Tool Settings → GCC Compiler → Includes → 添加Blinky.h所在目录（如${workspace_loc:/${ProjName}/Core}）
• 或者修改main.c中的包含语句为相对路径：#include "../Blinky.h"（若Blinky.h在Core目录，main.c在Core/Src目录）

2. 解决LED_GPIO_Port和LED_Pin未定义的问题 #

• 在Blinky.h中添加#include "main.h"（LED引脚定义由STM32CubeMX生成在main.h中），或直接在Blinky.cpp中包含main.h
• 更优方案：将LED端口和引脚作为参数传入类，增强通用性：

  // 修改Blinky.h
  class Blinky final {
  private:
      GPIO_TypeDef* ledPort;
      uint16_t ledPin;
  public:
      Blinky(GPIO_TypeDef* port, uint16_t pin);
      virtual ~Blinky();
      void blink(int del);
  };
  
  // 修改Blinky.cpp
  Blinky::Blinky(GPIO_TypeDef* port, uint16_t pin) : ledPort(port), ledPin(pin) {}
  
  void Blinky::blink(int del) {
      HAL_GPIO_TogglePin(ledPort, ledPin);
      HAL_Delay(del);
  }
  

  主代码中初始化：Blinky led(LED_GPIO_Port, LED_Pin);

3. 解决delay变量未定义的问题 #

• 将HAL_Delay(delay);改为HAL_Delay(del);，属于参数名笔误

4. 解决C/C++混合编译的标准库重复包含问题 #

• 因main.c是C文件，引用C++头文件需用extern "C"包裹，修改Blinky.h：

  #ifndef BLINKY_H_
  #define BLINKY_H_
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  #include "stm32f4xx_hal.h"
  #include "main.h"
  
  class Blinky final {
  // 类内容不变
  };
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif /* BLINKY_H_ */
  

• 或直接将main.c改为main.cpp，统一用C编译，规避C/C编译差异导致的冲突

总结 #

按上述步骤依次解决路径、变量定义、C/C混合编译问题后，即可正常编译并调用自定义C类。

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