IRremoteESP8266开发者指南：如何添加新协议和扩展功能

【免费下载链接】IRremoteESP8266 项目地址: https://gitcode.com/gh_mirrors/irr/IRremoteESP8266

IRremoteESP8266是一款强大的红外遥控库，专为ESP8266和ESP32微控制器设计，支持数十种品牌的空调、电视等设备的红外协议。本文将详细介绍如何为该库添加新的红外协议和扩展功能，帮助开发者快速扩展设备兼容性。

准备工作：了解项目结构

在开始之前，建议先熟悉IRremoteESP8266的项目结构，关键目录和文件如下：

• 协议实现目录：src/ - 存放所有红外协议的实现文件，如ir_Daikin.cpp、ir_Gree.cpp等
• 协议头文件：src/ir_*.h - 定义各协议的类和接口，如ir_Daikin.h
• 通用接口：src/IRac.h - 提供统一的空调控制接口
• 测试文件：test/ - 包含各协议的单元测试，如ir_Daikin_test.cpp

步骤1：创建新协议文件

添加新协议的第一步是创建对应的实现文件和头文件。按照项目规范：

1. 在src/目录下创建ir_<品牌名>.cpp和ir_<品牌名>.h文件
2. 参考现有协议（如src/ir_Daikin.cpp）的结构实现基础类

例如，为"NewBrand"空调创建协议文件：

// src/ir_NewBrand.h
#ifndef IR_NEWBRAND_H_
#define IR_NEWBRAND_H_

#include "IRremoteESP8266.h"
#include "IRsend.h"

class IRNewBrandAc {
 public:
  explicit IRNewBrandAc(const uint16_t pin, const bool inverted = false, const bool use_modulation = true);
  void send(const uint16_t repeat = kNewBrandDefaultRepeat);
  // 其他必要方法...
 private:
  IRsend _irsend;
  uint8_t _state[NEWBRAND_STATE_LENGTH];
  // 其他私有成员...
};

#endif  // IR_NEWBRAND_H_

步骤2：实现协议解码与编码

每个红外协议都有独特的帧结构和编码规则，实现时需要：

1. 分析协议特征：通过红外接收器（如IRrecvDumpV2示例）捕捉原始红外数据，分析脉冲宽度、数据位格式和校验方式
2. 实现编码逻辑：在.cpp文件中实现将设备状态（如温度、模式）转换为红外信号的函数
3. 实现解码逻辑：编写将原始红外数据解析为设备状态的函数

参考示例：src/ir_Gree.cpp中的IRGreeAC::send()方法实现了格力空调协议的编码逻辑。

步骤3：集成到IRac统一接口

为了让新协议支持IRac类提供的统一控制接口，需要：

1. 在IRac.h中添加新协议的头文件引用：

// src/IRac.h
#include "ir_NewBrand.h"  // 添加新协议头文件

2. 在IRac.cpp中实现协议适配方法：

// src/IRac.cpp
#if SEND_NEWBRAND
void IRac::newbrand(IRNewBrandAc *ac, const bool on, const stdAc::opmode_t mode, ...) {
  // 实现状态转换逻辑
}
#endif  // SEND_NEWBRAND

3. 添加编译开关：在library.properties和相关配置文件中添加SEND_NEWBRAND编译选项

步骤4：编写单元测试

为确保新协议的稳定性，需在test/目录下创建对应的测试文件，如ir_NewBrand_test.cpp，测试内容应包括：

• 协议编码生成的正确性
• 解码逻辑的准确性
• 边界条件处理（如最小/最大温度）

可参考现有测试文件结构：test/ir_Daikin_test.cpp

步骤5：扩展功能示例

除了添加新协议，还可以扩展库的功能，例如：

添加自定义发送逻辑

通过继承IRsend类实现特殊的发送需求：

class IRNewSend : public IRsend {
 public:
  using IRsend::IRsend;
  void customSend(const uint16_t *data, const uint16_t len) {
    // 自定义发送逻辑
  }
};

实现Web控制界面

参考examples/Web-AC-control/示例，该示例提供了通过网页控制空调的功能，界面如下：

提交贡献的最佳实践

1. 遵循编码规范：使用项目提供的CPPLINT.cfg检查代码风格
2. 更新文档：修改SupportedProtocols.md添加新支持的设备
3. 提交PR：确保所有测试通过后提交Pull Request，详细描述协议实现细节

通过以上步骤，你可以为IRremoteESP8266库添加新的红外协议或扩展功能，为开源社区贡献力量。如有疑问，可参考项目官方文档或参与社区讨论。

【免费下载链接】IRremoteESP8266 项目地址: https://gitcode.com/gh_mirrors/irr/IRremoteESP8266