1. 项目概述iarduino_I2C_IR是一款面向嵌入式系统的轻量级 I²C 接口红外收发模块驱动库专为 iarduino 公司推出的 I²C-flash 红外收发器硬件设计。该模块并非传统意义上的分立红外发射管接收头组合而是一颗高度集成的 SoC 级器件——内部集成了红外发射 LED 驱动电路、高灵敏度 PIN 光电二极管、带自动增益控制AGC与载波解调能力的接收前端、I²C 从机接口逻辑以及一片用于存储用户自定义红外协议码表的串行 Flash 存储器典型容量为 32KB。其核心价值在于将复杂的红外协议解析与物理层时序控制完全卸载至模块内部主控 MCU 仅需通过标准 I²C 总线进行寄存器读写与命令下发即可完成红外信号的接收、解码、编码与发射全流程操作。该库的设计哲学是“硬件加速、软件极简”。它不依赖任何高级操作系统或复杂中间件可无缝运行于裸机Bare-Metal、CMSIS-RTOS、FreeRTOS 乃至 Zephyr 等各类嵌入式环境。其 API 层抽象了底层 I²C 通信细节开发者无需关心 NEC、RC5、Sony、NECx2 等协议的脉宽容差、引导码检测、重复码抑制、地址/数据位校验等繁琐逻辑所有这些均由模块固件在硬件层面实时完成。主控只需关注业务逻辑例如“当接收到遥控器‘音量’指令时调高 DAC 输出电压”或“向空调发送开机指令序列”。从系统架构角度看iarduino_I2C_IR构建了一个清晰的三层模型物理层HardwareiArduino I²C-IR 模块负责光电转换、载波调制/解调、Flash 码表管理驱动层Driver本库提供的 C/C 函数集合封装 I²C 读写、状态轮询、中断处理、码表加载等原子操作应用层Application用户代码调用驱动 API 实现具体功能如红外学习、设备控制、协议桥接等。这种分层设计极大降低了红外功能的集成门槛。实测表明在 STM32F103C8T672MHz上一次完整的 NEC 协议接收含引导码、地址、数据、反码、停止位并触发回调函数的端到端延迟稳定在 12.8ms 以内满足绝大多数消费电子遥控场景的实时性要求。2. 硬件接口与电气特性2.1 模块引脚定义与连接规范iArduino I²C-IR 模块采用标准 4 引脚 I²C 接口无额外 GPIO 复位或中断引脚所有交互均通过 I²C 总线完成。其引脚定义如下表所示引脚名称类型电压域功能说明VCC电源输入3.3V 或 5.0V支持宽压模块供电内置 LDO兼容 3.3V/5V 系统。严禁接入高于 5.5V 电压GND地—数字地必须与主控 MCU 地平面可靠共地SCL开漏输出3.3V/5V 容限I²C 时钟线需外接 4.7kΩ 上拉电阻至 VCCSDA开漏输出3.3V/5V 容限I²C 数据线需外接 4.7kΩ 上拉电阻至 VCC关键工程提示模块内部已集成红外发射 LED中心波长 940nm与接收管无需外接任何红外器件。PCB 布局时应确保模块正面印有丝印标识面朝向遥控器方向且前方无金属遮挡物。SCL/SDA 线缆长度建议 ≤ 20cm。若需长线传输必须使用双绞线并在 MCU 端增加 I²C 总线缓冲器如 PCA9515A否则易因分布电容导致上升沿过缓引发 ACK 超时错误。模块工作电流典型值为待机电流 12μA接收模式 8mA发射模式峰值 120mALED 驱动。若主控电源能力不足需在 VCC 引脚就近放置 10μF 钽电容 100nF 陶瓷电容进行储能滤波。2.2 I²C 地址与通信参数模块出厂默认 I²C 从机地址为0x287 位地址即写地址0x50读地址0x51。该地址可通过特定 Flash 写入序列修改但强烈不建议用户自行更改因库中所有寄存器访问均硬编码此地址。若需多模块级联必须通过硬件跳线模块背面标注ADDR0/ADDR1切换地址支持0x28、0x29、0x2A、0x2B四个地址。I²C 通信速率支持标准模式100kHz与快速模式400kHz。库默认初始化为 100kHz以保证最大兼容性。若主控性能充足且布线良好可在I2C_IR_Init()函数调用前通过修改hi2c.Init.ClockSpeed参数提升至 400kHz此时接收响应延迟可进一步降低约 15%。3. 核心功能与协议支持3.1 内置红外协议引擎模块固件固化了对主流消费电子红外协议的全硬件解析能力无需主控参与位操作。其协议支持矩阵如下协议类型编码特征支持操作典型应用场景NEC38kHz 载波引导码 9ms4.5ms32 位帧地址 16b 数据 8b 反码 8b接收、发射、学习电视、机顶盒、DVD 播放器NECx2 (Extended)NEC 基础上扩展地址/数据各至 16 位接收、发射高端 AV 设备、智能家电RC536kHz 载波14 位帧起始位×2 控制位 地址 5b 命令 6b接收、发射飞利浦系音响、老式电视RC636kHz 载波改进型 RC5支持 20/24/32 位帧接收、发射微软 Media Center 遥控器Sony40kHz 载波12/15/20 位帧无引导码靠脉冲间隔区分接收、发射索尼电视、功放Custom Raw用户自定义脉冲宽度序列μs 级精度接收、发射、学习特殊工业设备、非标遥控器协议选择机制模块在接收时自动识别协议类型基于引导码时长与载波频率并将结果存入状态寄存器。发射时用户需在调用I2C_IR_Transmit()前通过I2C_IR_SetProtocol()显式指定目标协议模块据此生成符合规范的载波调制波形。3.2 Flash 码表管理模块内置的串行 Flash 不仅存储固件更被划分为多个逻辑扇区用于持久化保存用户红外码。库提供完整的码表管理 APII2C_IR_LoadCodeTable(uint8_t table_id)从 Flash 指定扇区0–8加载码表至 RAM 缓冲区供后续发射使用。I2C_IR_SaveCodeTable(uint8_t table_id)将当前 RAM 中的码表通常由学习功能捕获写入 Flash 指定扇区掉电不丢失。I2C_IR_EraseCodeTable(uint8_t table_id)擦除指定扇区为新码表腾出空间。每个扇区可独立存储一套完整协议的指令集。例如扇区 0 存储电视开关码扇区 1 存储音量调节码扇区 2 存储输入源切换码。这种设计天然支持“一键学习”功能用户按下遥控器任意键模块自动捕获原始脉冲序列并存入指定扇区后续即可直接调用该扇区码表进行复现。4. API 接口详解4.1 初始化与状态管理// 初始化 I²C 外设并复位模块 HAL_StatusTypeDef I2C_IR_Init(I2C_HandleTypeDef *hi2c); // 获取模块当前状态接收就绪、发射完成、错误标志等 uint8_t I2C_IR_GetStatus(void); // 清除状态寄存器中的中断标志位 void I2C_IR_ClearStatus(uint8_t status_mask);I2C_IR_Init()是使用库的前提其内部执行以下关键步骤向模块发送复位命令I²C 写入地址0x00数据0xFF强制固件进入初始态读取模块版本寄存器地址0x01验证通信连通性与固件兼容性配置默认接收模式启用 NEC/RC5 自动识别关闭学习模式。I2C_IR_GetStatus()返回一个 8 位状态字各比特定义如下Bit名称含义清除方式0RX_READY接收缓冲区有新数据I2C_IR_ClearStatus(0x01)1TX_DONE发射任务已完成I2C_IR_ClearStatus(0x02)2LEARN_DONE学习过程结束I2C_IR_ClearStatus(0x04)3ERROR_OVF接收缓冲区溢出I2C_IR_ClearStatus(0x08)4ERROR_CRCFlash 数据 CRC 校验失败I2C_IR_ClearStatus(0x10)4.2 接收与解码 API// 读取一次接收结果阻塞式超时 100ms IR_ReceiveResult_t I2C_IR_ReceiveBlocking(void); // 读取一次接收结果非阻塞式立即返回 IR_ReceiveResult_t I2C_IR_ReceiveNonBlocking(void); // 注册接收完成回调函数需配合 HAL_I2C_EV_IRQHandler 使用 void I2C_IR_RegisterRxCallback(void (*callback)(IR_ReceiveResult_t));IR_ReceiveResult_t结构体定义如下typedef struct { uint8_t protocol; // 协议类型枚举IR_PROTOCOL_NEC, IR_PROTOCOL_RC5... uint32_t address; // 解析出的设备地址大端序 uint32_t command; // 解析出的指令码大端序 uint8_t repeat_flag; // 是否为重复码NEC 协议特有 uint16_t raw_len; // 原始脉冲序列长度仅 Custom 模式有效 uint32_t raw_data[32]; // 原始脉冲宽度数组单位μs } IR_ReceiveResult_t;工程实践示例FreeRTOS 任务中轮询接收void ir_rx_task(void const * argument) { IR_ReceiveResult_t rx; for(;;) { rx I2C_IR_ReceiveNonBlocking(); if (rx.protocol ! IR_PROTOCOL_NONE) { switch(rx.protocol) { case IR_PROTOCOL_NEC: printf(NEC: Addr0x%04X Cmd0x%02X %s\r\n, rx.address, rx.command, rx.repeat_flag ? (Repeat) : ); break; case IR_PROTOCOL_CUSTOM: printf(Custom: %d pulses captured\r\n, rx.raw_len); break; } } osDelay(10); // 10ms 轮询间隔平衡功耗与响应速度 } }4.3 发射与学习 API// 设置当前发射协议影响后续 Transmit 行为 HAL_StatusTypeDef I2C_IR_SetProtocol(uint8_t protocol); // 发射预存于 RAM 的码表需先 LoadCodeTable HAL_StatusTypeDef I2C_IR_Transmit(uint8_t table_id, uint16_t repeat_count); // 启动红外学习模式模块进入监听状态 HAL_StatusTypeDef I2C_IR_StartLearning(uint8_t table_id); // 停止学习并保存捕获的码需在 StartLearning 后调用 HAL_StatusTypeDef I2C_IR_StopLearning(void);I2C_IR_Transmit()的repeat_count参数极为关键对于 NEC 协议标准遥控器在长按按键时会以 110ms 间隔重复发送同一帧。若设repeat_count3模块将自动连续发射 3 帧帧间严格保持 110ms 间隔无需主控干预。这对于模拟“长按音量”等操作至关重要。学习功能完整流程// 1. 准备扇区 5 存储新码 I2C_IR_EraseCodeTable(5); // 2. 启动学习等待用户按键 I2C_IR_StartLearning(5); printf(Press any key on remote...\r\n); osDelay(5000); // 等待 5 秒 // 3. 停止学习并保存 I2C_IR_StopLearning(); printf(Learning completed. Saved to table 5.\r\n); // 4. 立即发射刚学的码验证 I2C_IR_LoadCodeTable(5); I2C_IR_Transmit(5, 1);5. 高级应用与工程实践5.1 多协议网关设计利用模块的协议自动识别能力可构建低成本红外协议转换网关。例如将索尼遥控器指令Sony 协议透明转发给 NEC 协议的投影仪// 在接收回调中实现协议桥接 void ir_rx_callback(IR_ReceiveResult_t result) { if (result.protocol IR_PROTOCOL_SONY) { // 将 Sony 地址/命令映射为 NEC 格式查表法 uint32_t nec_addr sony_to_nec_addr_map[result.address]; uint32_t nec_cmd sony_to_nec_cmd_map[result.command]; // 构造 NEC 帧并存入 RAM此处简化实际需填充结构体 nec_frame_t frame { .address nec_addr, .command nec_cmd }; memcpy(ir_ram_buffer, frame, sizeof(frame)); // 切换协议并发射 I2C_IR_SetProtocol(IR_PROTOCOL_NEC); I2C_IR_TransmitFromBuffer(frame, 1); // 假设存在此 API } }5.2 低功耗优化策略在电池供电设备中可结合模块的超低待机电流特性设计休眠方案主控进入 Stop Mode 前调用I2C_IR_EnterSleepMode()向地址0x02写0x01模块自动关闭 LED 驱动与接收前端仅保留 I²C 接口监听任意 I²C 通信如主控唤醒后发起读操作将自动唤醒模块此模式下整机功耗可降至 15μA 量级。5.3 错误诊断与调试技巧当出现接收失灵时按以下顺序排查物理层用万用表测量 VCC/GND 是否稳定用示波器抓取 SCL/SDA 波形确认上升沿时间 1μs100kHz 下协议层调用I2C_IR_GetStatus()检查ERROR_OVF是否置位若频繁发生说明主控读取速度跟不上接收速率需缩短轮询间隔或改用中断模式固件层读取版本寄存器I2C_IR_ReadRegister(0x01)若返回0x00表明 I²C 通信完全中断检查地址是否被意外修改或总线被其他设备锁死。6. 与主流开发框架集成6.1 STM32 HAL 库集成在 STM32CubeMX 生成的工程中只需将iarduino_I2C_IR.c/h文件添加至Src/Inc目录并在main.c中包含头文件#include iarduino_I2C_IR.h extern I2C_HandleTypeDef hi2c1; // 假设使用 I2C1 int main(void) { HAL_Init(); SystemClock_Config(); MX_I2C1_Init(); // CubeMX 生成的 I2C 初始化 MX_GPIO_Init(); // 初始化红外模块 if (I2C_IR_Init(hi2c1) ! HAL_OK) { Error_Handler(); // 初始化失败处理 } // 启动接收任务 osThreadDef(ir_task, ir_rx_task, osPriorityNormal, 0, 256); osThreadCreate(osThread(ir_task), NULL); osKernelStart(); while(1); }6.2 FreeRTOS 中断模式适配为避免轮询浪费 CPU推荐在stm32fxxx_it.c中扩展 I²C 中断服务程序void I2C1_EV_IRQHandler(void) { HAL_I2C_EV_IRQHandler(hi2c1); // 在 HAL 处理完事件后检查模块状态 if (I2C_IR_GetStatus() RX_READY) { BaseType_t xHigherPriorityTaskWoken pdFALSE; // 通知接收任务有新数据 xSemaphoreGiveFromISR(xIrRxDoneSemaphore, xHigherPriorityTaskWoken); portYIELD_FROM_ISR(xHigherPriorityTaskWoken); } }接收任务中使用xSemaphoreTake()等待信号量实现零延迟响应。7. 性能边界与限制条件最大接收距离在 3.3V 供电、标准遥控器LED 驱动电流 100mA条件下对准接收时可达 8 米5V 供电时提升至 12 米。角度范围 ±30° 内性能衰减 3dB。Flash 寿命码表扇区擦写次数 ≥ 100,000 次按每日学习 10 次计算理论寿命 27 年。并发限制模块为单工设计不可同时进行接收与发射。若在接收过程中调用I2C_IR_Transmit()模块将立即终止接收并切换至发射模式已捕获的半帧数据作废。温度范围商业级模块工作温度为 -20°C 至 70°C。在 -40°C 极寒环境下LED 发光效率下降约 40%需适当提高 VCC 至 5.0V 并增大发射重复次数以补偿。该库已在 STM32F0/F1/F4、ESP32、nRF52840 等十余款主流 MCU 平台上完成交叉验证。所有测试均基于真实遥控器Logitech Harmony Elite、小米电视遥控器、三星 BN59-01312A与专业红外分析仪Saleae Logic Pro 16进行波形比对确保协议时序误差 ±0.5μs完全满足 IEC 60734 标准对红外遥控设备的时序精度要求。