1. 项目概述让老式红外设备“活”起来家里那台老空调遥控器找不到了每次都得踩着凳子去按机身按钮客厅的电视、功放、风扇遥控器堆了一茶几用的时候总要翻找半天。这些依靠红外IR遥控的设备虽然功能完好但在智能家居时代显得格格不入。这个项目的核心就是利用一块成本不到20元的ESP32开发板将这些“笨拙”的红外设备彻底智能化。你不再需要实体遥控器通过手机网页、语音助手如小爱同学、天猫精灵需额外桥接甚至定时任务就能轻松控制家里所有红外电器。这不仅仅是复制一个万能遥控器。传统万能遥控器需要学习码值操作繁琐且无法远程控制。而基于ESP32的方案是一个完全自主的、可联网的智能红外网关。ESP32本身具备Wi-Fi和蓝牙功能这意味着你可以将它接入家庭局域网通过一个简洁的网页界面我们使用ESPUI库来构建来控制所有设备。无论你是在卧室、办公室还是出差在外只要能连上家里的网络或通过内网穿透实现远程访问就能随时操控。项目涉及的核心技术点包括ESP32的GPIO控制、红外信号的接收与发射使用IRremote库、以及嵌入式Web服务器ESPUI的搭建。整个过程就像给旧设备安装了一个智能大脑让它们无缝融入你的智能生活场景。2. 核心思路与方案选型为什么是ESP32ESPUIIRremote面对“智能化红外设备”这个需求有多种技术路径可选。你可以用树莓派配合红外发射管功能强大但成本高、功耗大也可以用简单的Arduino Uno搭配以太网模块但需要额外解决网络接入和交互界面问题。经过综合权衡ESP32成为了最优解。2.1 硬件核心ESP32的不可替代性ESP32是一颗集成了Wi-Fi和蓝牙的双核微控制器芯片其核心优势在此项目中体现得淋漓尽致强大的网络能力内置Wi-Fi STA/AP模式轻松接入家庭路由器这是实现远程控制的基础。相比之下Arduino Uno需要额外增加昂贵的Wi-Fi扩展板。充足的硬件资源相比传统的ATmega328pArduino Uno主控ESP32拥有更快的CPU、更多的内存RAM和存储Flash能够轻松运行一个轻量级的Web服务器ESPUI并处理复杂的HTTP请求与红外码值逻辑。丰富的外设接口我们仅需使用一个普通的GPIO引脚如GPIO4来连接红外接收头另一个GPIO引脚如GPIO5来连接红外发射管。ESP32的引脚完全够用甚至绰绰有余。极低的功耗与成本在深度睡眠模式下ESP32的功耗可低至10μA级别虽然本项目作为常供电网关对功耗不敏感但其高集成度带来的成本优势非常明显一块NodeMCU-32S开发板价格非常亲民。2.2 软件框架ESPUI的简洁之美实现网页控制我们需要在ESP32上运行一个Web服务器。虽然可以使用传统的Arduino WebServer库或AsyncWebServer库但ESPUI提供了更优的解决方案。无需前端知识ESPUI允许你完全使用C代码在ESP32上创建并管理一个包含按钮、滑块、标签等元素的现代化网页界面。你不需要编写任何HTML、CSS或JavaScript代码极大地降低了开发门槛。异步与响应式ESPUI基于异步网络服务器构建界面操作响应迅速不会阻塞主循环。其生成的网页自适应不同尺寸的屏幕在手机和电脑上都有良好的显示效果。事件驱动编程通过回调函数机制将网页按钮的点击事件直接绑定到控制红外发射的C函数上逻辑清晰代码易于维护。2.3 红外通信基石IRremote库的全面支持IRremote库是Arduino/ESP平台下最成熟、最通用的红外通信库。它的优势在于广泛的协议支持支持NEC、Sony SIRC、Philips RC5、RC6以及众多空调厂商的复杂协议如格力、美的的空调码兼容性极强。简化的收发APIIRrecv用于接收并解码红外信号IRsend用于发射编码后的红外信号。库函数封装良好只需几行代码即可完成信号的捕获与重放。活跃的社区遇到生僻的协议或问题容易找到相关的资料和解决方案。注意务必使用由crankyoldgit维护的IRremoteESP8266库尽管名字带有8266但它完美支持ESP32。原版的Arduino-IRremote库对ESP32的支持可能不完整。在Arduino IDE的库管理中搜索“IRremoteESP8266”进行安装。方案总结ESP32提供网络与算力基础ESPUI提供人性化的交互界面IRremote库处理专业的红外通信。这三者组合形成了一个稳定、高效、易开发且成本极低的完整解决方案完美契合“将红外设备智能化”的核心需求。3. 硬件准备与电路连接从零开始的物料清单动手之前我们需要准备好所有硬件。这个项目的硬件部分非常简单几乎不需要焊接使用杜邦线即可。3.1 必备物料清单物料名称规格/型号数量说明主控板ESP32开发板如NodeMCU-32S、ESP32-DevKitC1项目核心确保引脚引出方便。红外接收头VS1838B、HS0038等38kHz通用型1用于学习原始遥控器的红外信号。注意引脚顺序VCC, GND, OUT。红外发射管940nm波长透明或蓝紫色1-2个发射信号用。单个功率有限可并联两个增强发射距离和角度。电阻100Ω 1/4W1限流电阻保护红外发射管和ESP32的GPIO引脚。三极管8050NPN型1用于驱动红外发射管。因为ESP32的GPIO驱动电流通常~40mA可能不足以直接驱动多个红外管达到最佳效果。杜邦线公对公、母对母若干用于连接各组件。USB数据线Micro-USB或Type-C根据ESP32板型1供电与程序烧录。电源5V/1A USB充电器1项目最终需长期供电。3.2 电路连接详解与原理电路连接的核心是红外接收电路和红外发射驱动电路。正确的连接是稳定工作的前提。红外接收电路非常简单红外接收头有三个引脚。以VS1838B为例正面弧面朝向自己从左至右依次为输出(OUT)、地(GND)、电源(VCC)。OUT引脚 - 连接到ESP32的某个GPIO例如GPIO4。这个引脚将把接收到的红外信号一串高低电平脉冲传送给ESP32解码。GND引脚 - 连接到ESP32的GND。VCC引脚 - 连接到ESP32的3.3V。切记不要接5V虽然很多接收头标称工作电压范围宽3.3V-5V但ESP32的GPIO电平是3.3V直接接5V输出可能会损坏ESP32。红外发射驱动电路这是关键。我们不能直接用ESP32的GPIO如GPIO5驱动红外发射管原因有二1) 驱动电流可能不足导致发射距离短2) 红外发射管在导通时瞬间电流较大可能损坏GPIO。因此需要三极管作为开关进行驱动。三极管连接以NPN三极管8050为例。将集电极(C)通过红外发射管注意正负极长脚为正连接到电源正极3.3V或5V建议用5V以获得更强发射功率。发射极(E)直接连接到电源地(GND)。基极(B)通过一个1kΩ的电阻连接到ESP32的发射控制引脚例如GPIO5。限流电阻计算红外发射管正向压降约为1.2V。如果我们使用5V电源那么加在“红外管限流电阻”上的总电压为5V - 1.2V 3.8V。红外管工作电流建议在20-100mA。以目标电流50mA计算根据欧姆定律R V / I限流电阻应为3.8V / 0.05A 76Ω。选择最接近的标准值100Ω此时实际电流约为3.8V / 100Ω 38mA处于安全且有效的范围内。将这个100Ω电阻串联在红外管正极与电源5V之间。工作原理当ESP32的GPIO5输出高电平3.3V时三极管导通红外发射管所在回路接通发光。当GPIO5输出低电平时三极管截止红外管熄灭。ESP32通过快速切换GPIO5的高低电平模拟出38kHz的载波和具体的协议波形。实操心得如果你只是控制单个设备且距离很近1-2米可以尝试省去三极管将红外发射管直接串联一个100Ω电阻接到GPIO5和GND之间。但稳定性、距离和安全性都会打折扣。对于空调等需要强信号穿透的设备或者希望一个发射器覆盖整个房间强烈建议使用三极管驱动电路并可以考虑并联2-3个红外发射管以扩大辐射角度。4. 软件环境搭建与核心代码解析硬件连接好后我们进入软件部分。首先需要配置开发环境然后编写核心逻辑代码。4.1 开发环境配置Arduino IDE安装Arduino IDE从Arduino官网下载并安装最新版IDE。添加ESP32开发板支持打开IDE进入文件 - 首选项在“附加开发板管理器网址”中输入https://espressif.github.io/arduino-esp32/package_esp32_index.json然后进入工具 - 开发板 - 开发板管理器搜索“esp32”找到由“Espressif Systems”提供的包点击安装。安装必要的库ESPUI在项目 - 加载库 - 管理库...中搜索“ESPUI”选择由“s00500”开发的版本进行安装。IRremoteESP8266同样在库管理中搜索“IRremoteESP8266”选择由“crankyoldgit”开发的版本安装。4.2 核心代码结构与逻辑拆解整个项目的代码主要分为四个部分网络连接、Web服务器ESPUI界面构建、红外信号学习接收解码、红外信号发射控制。#include Arduino.h #include WiFi.h #include ESPUI.h #include IRrecv.h #include IRsend.h #include IRutils.h // 1. 网络配置 const char* ssid 你的Wi-Fi名称; const char* password 你的Wi-Fi密码; // 2. 红外引脚定义 const uint16_t kRecvPin 4; // 红外接收头接在GPIO4 const uint16_t kIrLedPin 5; // 红外发射控制接在GPIO5 // 3. 创建红外对象 IRrecv irrecv(kRecvPin); IRsend irsend(kIrLedPin); // 4. 存储学习到的红外码 decode_results learnedCode; bool codeLearned false; String codeType UNKNOWN; String codeHex ; // 5. ESPUI控件ID存储用于动态更新界面 uint16_t statusLabelId; uint16_t learnButtonId; uint16_t sendButtonId; uint16_t codeTypeLabelId; uint16_t codeHexLabelId; void setup() { Serial.begin(115200); delay(1000); // 初始化红外 irrecv.enableIRIn(); // 启动红外接收 irsend.begin(); // 初始化红外发射对于ESP32begin()可带引脚参数但这里已在对象构造时指定 // 连接Wi-Fi WiFi.begin(ssid, password); Serial.print(Connecting to WiFi); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(\nConnected! IP: WiFi.localIP().toString()); // 构建ESPUI网页界面 // 主标签 statusLabelId ESPUI.label(Status: Ready, ControlColor::Turquoise, 等待操作); // 学习按钮 learnButtonId ESPUI.button(Learn IR Code, ControlColor::Peterriver, [](Control* sender, int type) { if (type B_DOWN) { ESPUI.updateLabel(statusLabelId, Status: Learning... Point remote at receiver!); codeLearned false; // 清空之前的码值显示 ESPUI.updateLabel(codeTypeLabelId, Type: ---); ESPUI.updateLabel(codeHexLabelId, Hex: ---); // 实际学习逻辑在loop()中通过irrecv.decode()实现 } }); // 显示学习结果的标签 codeTypeLabelId ESPUI.label(Protocol Type, ControlColor::Alizarin, Type: ---); codeHexLabelId ESPUI.label(Raw Code (Hex), ControlColor::Alizarin, Hex: ---); // 发送按钮初始不可用学习到码后才启用 sendButtonId ESPUI.button(Send Learned Code, ControlColor::Emerald, [](Control* sender, int type) { if (type B_DOWN codeLearned) { ESPUI.updateLabel(statusLabelId, Status: Sending IR Code...); // 调用函数发送学习到的码值 sendLearnedCode(); ESPUI.updateLabel(statusLabelId, Status: Code Sent!); } }); ESPUI.setEnabled(sendButtonId, false); // 初始禁用发送按钮 // 开始ESPUI服务器 ESPUI.begin(Smart IR Controller); } void loop() { // 处理红外学习 if (!codeLearned) { decode_results results; if (irrecv.decode(results)) { // 成功解码到信号 learnedCode results; // 保存解码结果 codeType typeToString(results.decode_type); codeHex resultToHexidecimal(results); // 更新网页界面显示 ESPUI.updateLabel(codeTypeLabelId, Type: codeType); ESPUI.updateLabel(codeHexLabelId, Hex: codeHex); ESPUI.updateLabel(statusLabelId, Status: Code Learned!); // 启用发送按钮 ESPUI.setEnabled(sendButtonId, true); codeLearned true; // 在串口监视器也打印一下方便调试 Serial.println(Code learned!); Serial.print(Type: ); Serial.println(codeType); Serial.print(Hex: ); Serial.println(codeHex); Serial.println(); irrecv.resume(); // 准备接收下一个信号 } } // ESPUI的处理是异步的无需在loop中频繁调用 delay(10); } // 发送学习到的红外码的函数 void sendLearnedCode() { if (!codeLearned) return; // 根据解码到的协议类型调用不同的发送函数 // 这是IRremoteESP8266库的通用发送方法 irsend.send(learnedCode.decode_type, learnedCode.value, learnedCode.bits); // 对于某些复杂协议如空调码可能需要使用更具体的send函数这里是一个通用示例。 // 重要发送完成后需要重新启用红外接收否则无法学习下一个信号 irrecv.enableIRIn(); }代码逻辑解析初始化与连接setup()函数中初始化串口、红外收发模块连接Wi-Fi。界面构建使用ESPUI创建标签和按钮。标签用于显示状态和学到的码值按钮绑定回调函数。学习按钮被点击时会更新状态标签并重置学习标志。发送按钮的回调函数会调用sendLearnedCode()。信号学习循环在loop()中持续检查是否收到红外信号(irrecv.decode())。如果收到且处于学习模式(!codeLearned)则解码信号保存协议类型和原始数据十六进制并更新网页界面同时启用发送按钮。信号发送sendLearnedCode()函数读取保存的learnedCode根据其协议类型调用irsend.send()方法将红外信号原样发射出去。发送后必须调用irrecv.enableIRIn()重新开启接收否则接收器将一直处于休眠状态。注意事项上述代码是一个最简化的通用示例。实际应用中你需要为每个设备如电视、空调的每个功能开关、音量、温度学习并存储一个独立的码值。你需要扩展代码使用数组或结构体来管理多个码值并在网页上创建对应的多个按钮。例如可以创建一个“电视控制”面板里面有“电源”、“音量”、“音量-”、“信号源”等按钮每个按钮对应一个之前学习好的红外码。5. 进阶功能与深度优化实践基础的单信号学习与发送实现后我们可以让这个智能红外网关变得更实用、更强大。5.1 多设备与多按键管理一个实用的红外网关需要控制多个设备的多个按键。我们需要一个数据结构来存储这些信息。// 定义一个结构体来存储一个红外命令 struct IRCommand { String deviceName; // 设备名如 LivingRoom_AC String buttonName; // 按键名如 Power, Temp_Up decode_type_t protocol; // 协议类型 uint64_t code; // 红外码值 uint16_t bits; // 码值位数 }; // 创建一个数组来存储所有命令 IRCommand commandList[50]; // 假设最多存储50个命令 int commandCount 0; // 学习新命令时将其存入数组 void learnNewCommand(String devName, String btnName) { if (irrecv.decode(learnedCode)) { commandList[commandCount].deviceName devName; commandList[commandCount].buttonName btnName; commandList[commandCount].protocol learnedCode.decode_type; commandList[commandCount].code learnedCode.value; commandList[commandCount].bits learnedCode.bits; commandCount; // 将数组保存到ESP32的Flash中如Preferences库防止断电丢失 saveCommandsToFlash(); } } // 根据设备名和按键名查找并发送命令 void sendIRCommand(String devName, String btnName) { for (int i 0; i commandCount; i) { if (commandList[i].deviceName devName commandList[i].buttonName btnName) { irsend.send(commandList[i].protocol, commandList[i].code, commandList[i].bits); break; } } }在网页界面上你可以动态生成多个面板ESPUI.addControl每个面板对应一个设备面板内包含该设备的所有功能按钮。按钮的回调函数调用sendIRCommand并传入对应的设备名和按键名。5.2 定时任务与自动化利用ESP32的内部实时时钟RTC可以实现简单的定时控制例如让空调在每天上午10点自动开启。#include time.h const char* ntpServer pool.ntp.org; const long gmtOffset_sec 8 * 3600; // 东八区 const int daylightOffset_sec 0; void setupTime() { configTime(gmtOffset_sec, daylightOffset_sec, ntpServer); } void checkSchedule() { struct tm timeinfo; if(!getLocalTime(timeinfo)){ return; } int currentHour timeinfo.tm_hour; int currentMin timeinfo.tm_min; // 示例每天10:00执行 if(currentHour 10 currentMin 0) { sendIRCommand(LivingRoom_AC, Power_On); // 添加防重发机制例如标记今天已执行 } }在loop()函数中定期调用checkSchedule()即可。对于更复杂的自动化逻辑如“如果温度高于28度则开空调”可以接入Home Assistant等智能家居平台ESP32通过MQTT协议上报传感器数据并接收控制指令。5.3 信号发射的稳定性增强红外信号易受环境光干扰且发射方向性强。为确保可靠性硬件上如之前所述使用三极管驱动并并联多个红外发射管将它们分散在不同角度或使用“红外发射棒”将多个发射管集成在一个柱状结构中以实现全向发射。软件上对于关键指令如空调开关可以连续发送2-3次同一信号间隔100ms确保设备一定能接收到。void sendIRCommandRobust(String devName, String btnName, int repeat 2) { for (int i 0; i repeat; i) { sendIRCommand(devName, btnName); delay(100); // 间隔100毫秒 } }5.4 集成到主流智能家居平台要让小爱同学或天猫精灵控制ESP32本身不支持直接对接。通常的桥接方案是通过Home Assistant桥接这是最强大和通用的方法。在树莓派或NAS上安装Home Assistant。ESP32通过MQTT协议接入Home Assistant并在Home Assistant中暴露为一个“遥控器”实体。然后在Home Assistant中安装小爱或天猫精灵的插件将实体同步到语音平台。这样你就可以说“小爱同学打开客厅空调”指令经由Home Assistant通过MQTT下发给ESP32ESP32再发射红外信号。使用特定固件有些为ESP32定制的固件如ESPHome、Tasmota原生集成了对红外的控制和与Home Assistant的发现协议配置起来更简单无需编写大量C代码。6. 常见问题排查与调试心得实录在实际制作过程中你几乎一定会遇到下面这些问题。这里是我踩过坑后总结的排查清单。6.1 红外信号学习失败网页显示无反应现象按下学习按钮后用原装遥控器对准接收头按键网页状态始终不变串口监视器也无输出。排查步骤检查硬件连接这是最常见的问题。用万用表测量红外接收头的VCC是否为3.3VGND是否接通。检查OUT引脚是否确实连接到了ESP32指定的GPIO如GPIO4。检查遥控器与距离确保遥控器有电可用手机摄像头观察遥控器发射头按下按键时能看到紫白光闪烁。将遥控器发射头对准接收头距离在5-15厘米内。检查代码引脚定义确认代码中kRecvPin如4与硬件连接一致。查看串口输出打开Arduino IDE的串口监视器波特率115200看是否有Wi-Fi连接成功的信息以及irrecv.decode()相关的调试信息。可以在loop()里加一句Serial.println(Loop running...);看程序是否卡死。协议兼容性极少数非常古老的设备可能使用生僻协议。尝试在setup()里加上irrecv.setUnknownThreshold(12)来尝试接收更长的原始数据或者换用其他万能遥控器APP试试能否学习到该设备的信号。6.2 学习成功但发射无效设备不响应现象网页显示成功学习到协议和码值但点击发送时被控设备毫无反应。排查步骤发射电路与方向首先确认红外发射管已正确连接驱动电路且发射管正面透明半球对准被控设备的红外接收窗。尝试将发射管贴近2-3厘米接收窗测试。发射管状态在发送信号时用手机摄像头观察发射管应能看到它快速闪烁发出肉眼不可见的红外光。如果不亮检查三极管基极电阻是否过大、GPIO引脚是否配置正确、代码中kIrLedPin是否正确。电源功率如果使用USB线连接电脑供电可能功率不足尤其是在驱动多个红外管时。换用5V/1A以上的独立电源适配器供电。协议与码值重发有些设备特别是空调需要连续收到两次完全相同的信号才执行。在发送函数里增加重发逻辑如irsend.send(..., 2)发送两次或像前面一样用循环发送。信号冲突确保学习时没有其他红外源干扰。学习到的码值可以在串口监视器看到与网上找到的同型号设备码值对比一下如果找得到看是否合理。6.3 网页界面无法访问或卡顿现象ESP32启动后在浏览器输入其IP地址无法打开控制页面或页面打开后操作无响应。排查步骤IP地址确认在串口监视器查看ESP32获取到的正确IP地址。确保手机/电脑和ESP32连接在同一个Wi-Fi网络同一个子网。浏览器缓存尝试使用浏览器的无痕模式访问或清除缓存。ESP32内存不足如果创建的控件过多几十上百个可能导致ESP32内存不足而崩溃。优化界面或考虑使用更轻量的库如AsyncWebServer自行构建简单API。网络干扰2.4GHz Wi-Fi信道干扰。可以尝试在路由器后台更改ESP32所连Wi-Fi的信道。6.4 信号学习混乱或误触发现象学习到的码值每次都不一样或者设备偶尔会自己误动作。排查步骤环境光干扰强烈的日光灯、太阳光可能包含红外成分。尽量在环境光稳定的情况下学习或为红外接收头加一个遮光罩一小段黑色热缩管。电源噪声使用劣质电源或开发板上的开关电源模块可能产生噪声被接收头误判为信号。给ESP32的3.3V和GND之间并联一个100μF的电解电容和一个0.1μF的瓷片电容进行滤波。软件防抖在红外接收的中断服务函数或解码逻辑中可以增加简单的去抖判断但IRremoteESP8266库内部已有一定处理。这个项目从想法到实现最耗时的部分往往不是编码而是硬件调试和信号稳定性优化。当你看到自己编写的网页按钮成功控制客厅灯光熄灭的瞬间那种成就感是购买成品智能家居无法比拟的。整个系统搭建完成后稳定性极高我已经稳定运行超过一年成为了家庭智能控制体系中不可或缺的“老设备兼容层”。