platformio使用头文件

### 如何在 PlatformIO 中包含和使用 C/C++ 头文件

#### 设置 `platformio.ini` 文件
为了确保头文件能够被正确识别，在 `platformio.ini` 文件中配置项目的构建环境非常重要。通常情况下，需要指定额外的编译标志或包含路径。

[env:my_environment]
platform = ...
board = ...
framework = ...

build_flags =
    -I./include  ; 添加头文件目录到编译器查找路径中

这使得编译器可以在指定位置寻找所需的 `.h` 或者 `.hpp` 文件[^4]。

#### 修改 `c_cpp_properties.json`
对于集成开发环境 (IDE)，比如 Visual Studio Code 使用 PlatformIO 插件时，还需要更新 `c_cpp_properties.json` 来让编辑器知道在哪里可以找到这些头文件：

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/include",      // 自定义头文件夹的位置
                "${platformioInclude}",           // 平台自带库路径
                "${platformioLibBuilder}"         // 库依赖项自动解析后的路径
            ],
            "defines": [],
            "compilerPath": "/path/to/compiler",   // 编译器可执行文件路径
            "intelliSenseMode": "gcc-x64"
        }
    ]
}

通过这种方式设置好之后，即使 IDE 提示找不到某些头文件也不会影响实际编译过程；同时还能享受代码补全等功能带来的便利。

#### 创建并引用头文件
创建一个新的头文件（假设名为 `MyHeader.h`），将其放置于项目结构内的适当位置，例如 `/include/MyHeader.h` 下面是一个简单的例子展示如何声明函数原型以及宏定义等内容：

// MyHeader.h
#ifndef MYHEADER_H_
#define MYHEADER_H_

#include <Arduino.h>  // 如果是在 Arduino 环境下工作的话

void setup();          // 函数声明
void loop();

#endif /*MYHEADER_H_*/

接着就可以在其他源文件里利用 `#include "MyHeader.h"` 的方式引入该头文件了[^1]。

#### 实际应用案例
考虑一个具体的场景——编写一段用于控制 LED 的简单程序。首先建立相应的头文件 (`LedControl.h`) 和实现文件 (`LedControl.cpp`) ，再把它们加入到平台工程当中去。

##### LedControl.h

#ifndef LEDCONTROL_H_
#define LEDCONTROL_H_

class LedController {
public:
    void init(int pin);
    void turnOn();
    void turnOff();
private:
    int ledPin;
};

#endif /*LEDCONTROL_H_*/

##### LedControl.cpp

#include "LedControl.h"

void LedController::init(int pin){
    this->ledPin = pin;
    pinMode(this->ledPin, OUTPUT);
}

void LedController::turnOn(){
    digitalWrite(this->ledPin,HIGH);
}

void LedController::turnOff(){
    digitalWrite(this->ledPin,LOW);
}

最后，在主应用程序或者其他地方只需要导入这个类即可轻松调用其成员方法完成特定功能。