1. 项目概述与核心价值最近在捣鼓智能家居的小玩意儿手头正好有一块DFRobot的FireBeetle ESP32-E开发板想着给它找个“搭档”于是入手了配套的FireBeetle ESP32-E扩展板。这板子号称是专为ESP32-E设计的“全能接口中心”能极大简化外设连接。光看参数没意思我决定用它结合一个常见的DS18B20温度传感器和一个RGB LED灯珠做一个能根据环境温度自动变色的“温感灯”。这项目听起来简单但麻雀虽小五脏俱全它涉及到硬件接口的识别与连接、传感器数据采集与处理、PWM调色控制以及嵌入式逻辑编程非常适合用来检验这块扩展板的易用性和稳定性也适合想入门物联网和智能硬件的朋友练手。这个温感灯的核心逻辑是让ESP32-E通过扩展板读取DS18B20测得的温度值然后根据预设的温度区间动态调整RGB LED灯珠的颜色。比如低温时显示蓝色常温显示绿色高温显示红色形成一个直观的视觉温度计。整个过程FireBeetle ESP32-E扩展板扮演了至关重要的“桥梁”角色它将主控板的GPIO、电源、I2C、SPI等接口以更友好、更稳定的方式引出来让我们不用再面对一堆杜邦线和混乱的接线能更专注于逻辑和功能的实现。1.1 为什么选择FireBeetle ESP32-E扩展板市面上ESP32的扩展板Shield不少为什么偏偏是这块经过实际使用我发现它有几个设计非常贴合实际开发需求尤其是对新手和快速原型搭建特别友好。首先接口布局清晰且防呆。板子上所有的接口包括数字IO、模拟输入、I2C、SPI、UART都用清晰的图标和文字标注并且采用了防反插的PH2.0接口。这意味着你再也不用担心接错线导致短路或烧毁元件对于我这种经常在桌面上摆满元件、接线时容易眼花的人来说简直是福音。其次电源管理周到。板载了3.3V和5V的稳压输出并且为数字IO口提供了电平转换保护。当你外接一些工作电压是5V的传感器或模块时虽然DS18B20是3.3V-5V兼容的这个特性就非常省心不用担心电平不匹配的问题。最后预留了丰富的功能焊盘。比如板载了一个蜂鸣器、一个可编程按键、一个复位按键甚至还有TF卡槽和电池接口的焊盘位置。在做温感灯这个项目时那个可编程按键我就用来切换灯效模式非常方便不用额外再去连接一个物理按键了。注意虽然扩展板提供了5V输出但在连接传感器前务必确认传感器的工作电压范围。像DS18B20这种3.3V和5V供电都可以但数据引脚的电平需要与主控板匹配。FireBeetle ESP32-E的GPIO是3.3V电平所以即使使用5V为传感器供电其数据线信号也应是3.3V这点扩展板已经做了考虑。1.2 温感灯项目的核心组件与工作原理我们这个项目的硬件核心就三样主控FireBeetle ESP32-E、桥梁FireBeetle ESP32-E扩展板、感知器DS18B20温度传感器和执行器共阳极RGB LED。软件核心则是运行在ESP32上的Arduino程序负责协调所有硬件工作。DS18B20是一款非常经典的单总线1-Wire数字温度传感器。它的“单总线”特性意味着只需要一根数据线外加电源和地线就能与主控进行双向通信极大地节省了GPIO资源。它内部直接将模拟温度信号转换为数字信号输出抗干扰能力强测量精度也足以满足日常环境监测典型精度±0.5°C。在我们的项目中ESP32通过一个GPIO口模拟单总线时序向DS18B20发送命令并读取其寄存器中的温度数据。共阳极RGB LED内部有三个独立的LED芯片红、绿、蓝共享一个阳极正极。要控制它的颜色和亮度我们需要分别控制红、绿、蓝三个阴极负极到地的电流。电流越大对应颜色的亮度越低因为是阴极控制。所以我们使用ESP32的三个支持PWM脉冲宽度调制的GPIO口分别连接到LED的三个阴极。通过快速改变每个引脚输出高电平的时间比例占空比就能混合出从暗到亮、丰富多彩的颜色。温感灯的逻辑就是根据DS18B20读回的温度值计算出一组对应的红、绿、蓝的PWM占空比值从而驱动LED显示出目标颜色。整个数据流是这样的DS18B20感知环境温度 → 通过单总线将数字温度值传送给ESP32 → ESP32中的程序处理数据映射为RGB颜色值 → 通过三个PWM引脚输出控制信号 → RGB LED显示出对应颜色。FireBeetle扩展板在这个链条中为DS18B20提供了稳定可靠的电源和清晰的数据接口为RGB LED提供了带有保护电路的驱动接口让整个物理连接过程变得简洁而可靠。2. 硬件连接与电路解析动手之前理清电路连接是成功的第一步。得益于FireBeetle扩展板的设计这次的连接会比直接用杜邦线清爽和稳固得多。2.1 元器件清单与接口确认你需要准备以下硬件FireBeetle ESP32-E 主控板 x1FireBeetle ESP32-E 扩展板 x1DS18B20 温度传感器封装形式不限建议用带线版的方便布置 x1共阳极RGB LED 灯珠 x14.7kΩ 电阻 x1用于DS18B20单总线上的拉高3个 220Ω 电阻 x1用于RGB LED各阴极的限流防止电流过大烧毁LED或ESP32引脚连接线若干如果传感器和LED是PH2.0接口的可以直接插到扩展板否则可能需要焊接或使用转接线接下来确认FireBeetle ESP32-E扩展板上的接口。我们将用到数字IO口选择D2、D4、D15、D18等具体需避开一些特殊功能引脚如串口下载引脚。这里我们计划用D4连接DS18B20的数据线用D15、D18、D19作为RGB LED的红、绿、蓝控制引脚。电源接口扩展板上有清晰的3V3和5V排针。DS18B20和RGB LED的阳极正极我们都接3V3。特别注意RGB LED是共阳极所以它的公共正极接3V3。GND地扩展板上有多个GND排针传感器和LED的负极都需要连接到GND。2.2 分步连接指南与原理图解读现在开始连接。请务必在断电状态下操作。第一步安装主控与扩展板将FireBeetle ESP32-E主控板直接插入FireBeetle ESP32-E扩展板上的对应插座。注意方向板子上的USB接口方向通常是一致的。插紧后两者就合体为一个功能更强的开发平台了。第二步连接DS18B20温度传感器DS18B20有三根线通常为红、黑、黄或红、黑、蓝红线VDD 接扩展板的3V3电源引脚。黑线GND 接扩展板的任一GND引脚。黄/蓝线DQ数据线 接我们选择的GPIO例如D4。同时必须在数据线D4和电源线3V3之间连接一个4.7kΩ的上拉电阻。这是单总线协议正常工作所必需的它为总线在空闲时提供稳定的高电平。扩展板上通常没有预置这个电阻所以我们需要自己外接。第三步连接共阳极RGB LED共阳极RGB LED有四条腿最长的那条通常是公共阳极正极。另外三条较短的分别对应红色R、绿色G、蓝色B的阴极负极。公共阳极最长脚 接扩展板的3V3。红色阴极R 串联一个220Ω的限流电阻后接到我们选择的GPIO例如D15。绿色阴极G 串联一个220Ω的限流电阻后接到D18。蓝色阴极B 串联一个220Ω的限流电阻后接到D19。实操心得限流电阻不可省我曾图省事直接连接结果在输出高电平试图熄灭LED时因为电流路径问题导致引脚内部电流过大虽然短时间内没烧但芯片发热明显。串联一个220Ω电阻后电流被限制在安全范围内约(3.3V- LED压降)/220Ω ≈ 10mAESP32和LED都工作得凉爽又稳定。这是保护硬件的基本操作。第四步检查电路连接完成后对照下面的简表再检查一遍组件引脚连接到扩展板备注DS18B20VDD (红)3V3电源正极GND (黑)GND电源地DQ (黄/蓝)D4数据线需接4.7k上拉电阻至3V3RGB LED公共阳极 (最长脚)3V3共阳极接电源正极红色阴极 (R)D15串联220Ω电阻绿色阴极 (G)D18串联220Ω电阻蓝色阴极 (B)D19串联220Ω电阻至此硬件连接部分就完成了。你可以看到通过扩展板我们避免了面包板的杂乱所有连接都清晰、稳固地落在了板载的排针上。3. 软件环境搭建与核心库配置硬件搭好了接下来就是让ESP32“思考”和“行动”的软件部分。我们将使用Arduino IDE进行开发这是目前最流行、对新手最友好的ESP32开发方式之一。3.1 Arduino IDE环境配置与板卡支持首先确保你安装了最新版的Arduino IDE。然后需要添加ESP32的开发板支持。打开Arduino IDE点击文件-首选项。在“附加开发板管理器网址”中填入以下网址如果已有其他网址用逗号隔开https://espressif.github.io/arduino-esp32/package_esp32_index.json点击确定保存。点击工具-开发板-开发板管理器。在搜索框中输入“esp32”找到由“Espressif Systems”提供的“ESP32”开发板包点击安装。这个过程可能需要一些时间取决于你的网络速度。安装完成后在工具-开发板列表中选择“FireBeetle ESP32”。注意如果列表中没有可以选择“ESP32 Dev Module”大部分引脚是兼容的但最好确认一下FireBeetle的特定引脚映射。接下来需要安装本项目依赖的两个核心库DallasTemperature 用于驱动DS18B20等Dallas单总线温度传感器。OneWire DallasTemperature库的基础负责处理单总线通信协议。安装库的步骤点击工具-管理库...。在库管理器中分别搜索“DallasTemperature”和“OneWire”。找到由Miles Burton等人维护的“DallasTemperature”库和由Paul Stoffregen等人维护的“OneWire”库点击安装。3.2 温感灯核心逻辑代码剖析环境配置好后我们来编写温感灯的核心代码。代码主要分为几个部分库引用与引脚定义、传感器初始化与读数、温度-颜色映射函数、PWM输出控制。// 1. 引入必要的库 #include OneWire.h #include DallasTemperature.h // 2. 引脚定义 #define ONE_WIRE_BUS 4 // DS18B20数据线连接在GPIO4 (扩展板D4) #define LED_R 15 // RGB LED红色阴极连接GPIO15 #define LED_G 18 // RGB LED绿色阴极连接GPIO18 #define LED_B 19 // RGB LED蓝色阴极连接GPIO19 // 3. 初始化单总线和传感器对象 OneWire oneWire(ONE_WIRE_BUS); DallasTemperature sensors(oneWire); // 4. 设置PWM通道和参数 const int freq 5000; // PWM频率5kHz const int resolution 8; // PWM分辨率8位0-255 const int ledChannel_R 0;// 使用LEDC通道0控制红色 const int ledChannel_G 1;// 使用LEDC通道1控制绿色 const int ledChannel_B 2;// 使用LEDC通道2控制蓝色 void setup() { Serial.begin(115200); // 初始化串口用于调试输出 Serial.println(FireBeetle ESP32-E 温感灯启动...); // 初始化温度传感器 sensors.begin(); // 配置RGB LED的PWM通道 ledcSetup(ledChannel_R, freq, resolution); ledcSetup(ledChannel_G, freq, resolution); ledcSetup(ledChannel_B, freq, resolution); // 将PWM通道绑定到对应的GPIO引脚 ledcAttachPin(LED_R, ledChannel_R); ledcAttachPin(LED_G, ledChannel_G); ledcAttachPin(LED_B, ledChannel_B); // 初始化为灯灭状态共阳极输出高电平则灭 ledcWrite(ledChannel_R, 255); ledcWrite(ledChannel_G, 255); ledcWrite(ledChannel_B, 255); } // 5. 温度到RGB颜色的映射函数 void setColorByTemperature(float tempC) { int r, g, b; // 定义温度区间和对应的RGB颜色这里使用简单的线性插值示例 // 低温20°C蓝色 - 青色 // 常温20-28°C绿色 - 黄色 // 高温28°C红色 - 品红 // 注意共阳极LEDPWM值越大亮度越暗0最亮255最暗 if (tempC 20.0) { // 蓝色到青色过渡 int value map(tempC, 10, 20, 255, 0); // 假设10°C为全蓝20°C为青色 value constrain(value, 0, 255); r 255 - value; // 红色部分从暗到亮 g value; // 绿色部分从暗到亮 b 0; // 蓝色部分最亮 } else if (tempC 20.0 tempC 28.0) { // 绿色到黄色过渡 int value map(tempC, 20, 28, 0, 255); value constrain(value, 0, 255); r value; // 红色部分从暗到亮 g 0; // 绿色部分最亮 b 255; // 蓝色部分最暗灭 } else { // 红色到品红过渡 int value map(tempC, 28, 35, 0, 255); // 假设35°C为品红 value constrain(value, 0, 255); r 0; // 红色部分最亮 g 255 - value; // 绿色部分从暗到亮 b value; // 蓝色部分从暗到亮 } // 6. 输出PWM值控制LED // 由于是共阳极计算出的r,g,b是亮度分量需要转换为PWM占空比 // 亮度越高PWM值应越小阴极电压越低 // 这里我们简化处理将0-255的亮度值直接映射为255-0的PWM值 // 更精确的做法需要考虑LED的非线性响应伽马校正此处从略 ledcWrite(ledChannel_R, 255 - r); ledcWrite(ledChannel_G, 255 - g); ledcWrite(ledChannel_B, 255 - b); // 串口打印调试信息 Serial.print(温度: ); Serial.print(tempC); Serial.print(°C | RGB输出值: ); Serial.print(r); Serial.print(, ); Serial.print(g); Serial.print(, ); Serial.println(b); } void loop() { // 7. 主循环读取温度并更新灯光 sensors.requestTemperatures(); // 发送温度转换命令 float temperature sensors.getTempCByIndex(0); // 获取第一个传感器的摄氏温度 // 检查读数是否有效-127是DS18B20的默认错误值 if (temperature ! -127.00) { setColorByTemperature(temperature); } else { Serial.println(读取温度传感器失败); // 可以设置错误指示灯例如让LED闪烁红色 ledcWrite(ledChannel_R, 0); // 红亮 ledcWrite(ledChannel_G, 255); // 绿灭 ledcWrite(ledChannel_B, 255); // 蓝灭 delay(500); ledcWrite(ledChannel_R, 255); // 红灭 delay(500); } delay(2000); // 每2秒更新一次温度可根据需要调整 }这段代码的逻辑非常清晰。在setup()中我们初始化了串口、传感器和PWM。在loop()中循环读取温度并调用setColorByTemperature()函数将温度映射为RGB颜色再通过PWM输出。映射函数里用map()和constrain()函数实现了在不同温度区间内的平滑颜色过渡视觉上会更柔和而不是生硬地跳变。注意事项PWM通道与引脚。ESP32的LEDCLED控制硬件PWM模块功能强大但通道有限。我们为红、绿、蓝各分配了一个独立通道0,1,2这样可以实现精确的独立调光。ledcSetup()函数中的resolution参数设置为8意味着占空比可以设置为0到255之间的任意整数这对于颜色混合来说精度足够了。4. 烧录、调试与功能验证代码写好了接下来就是把它烧录到FireBeetle ESP32-E上并观察温感灯是否按预期工作。4.1 程序烧录与串口监控连接硬件用USB线将FireBeetle ESP32-E已插在扩展板上连接到电脑。选择端口在Arduino IDE的工具-端口菜单中选择对应的COM口Windows或/dev/cu.usbserial-*Mac/Linux。编译与上传点击左上角的“√”验证按钮编译代码确认无误后点击“→”上传按钮将程序烧录到板子中。打开串口监视器上传完成后点击工具-串口监视器或右上角的放大镜图标。将右下角的波特率设置为115200与代码中Serial.begin(115200)一致。如果一切正常你会在串口监视器中看到“FireBeetle ESP32-E 温感灯启动...”的提示随后会每隔2秒打印当前的温度值和计算出的RGB输出值。此时用手触摸或向DS18B20哈气观察温度变化同时看RGB LED的颜色是否随之改变。4.2 功能测试与效果优化在基础功能跑通后我们可以进行更细致的测试和优化温度准确性校准DS18B20出厂有精度误差。你可以用一个相对准确的水银温度计或数字温度计作为参考同时测量环境温度。比较串口打印的读数与参考温度计的差值如果存在固定偏差可以在代码中进行补偿。例如如果传感器始终偏高0.5°C可以在temperature sensors.getTempCByIndex(0);这行后面加上temperature temperature - 0.5;。颜色过渡平滑性测试尝试缓慢改变环境温度例如用温水袋靠近或远离传感器观察LED颜色变化是否平滑、有无明显的色阶跳跃。如果觉得过渡生硬可以调整setColorByTemperature函数中的温度区间和map函数的参数或者采用更复杂的插值算法如双线性插值来计算中间颜色。响应速度测试默认的delay(2000)是2秒更新一次。对于环境温度监测这个间隔是合适的。如果你希望响应更快可以减小这个值但要注意DS18B20完成一次温度转换需要一定时间最高精度下约750ms过快的请求会导致读取失败或增加功耗。加入模式切换利用扩展板上的可编程按键通常连接某个GPIO需查看扩展板原理图确认假设是GPIO0可以增加模式切换功能。例如单击切换“自动温感模式”和“手动调色盘模式”长按调节亮度等。这需要增加按键中断检测和状态机逻辑能让项目可玩性大大提升。实操心得调试是重头戏。第一次烧录后我的灯常亮白色且不变化。通过串口打印发现温度读数一直是-127。排查后发现是DS18B20的数据线接错了扩展板上的引脚误接了模拟口。教训是务必对照原理图或板子丝印确认你使用的数字引脚编号如D4对应ESP32的内部GPIO编号如GPIO4有时它们并不相同。FireBeetle扩展板的丝印通常就是ESP32的GPIO号这点很友好。另外单总线的4.7kΩ上拉电阻必须接否则通信会极不稳定。5. 项目扩展与深入探索一个基础的温感灯做成了但这只是起点。FireBeetle ESP32-E扩展板的潜力远不止于此结合ESP32本身的Wi-Fi和蓝牙功能我们可以把这个本地小装置升级为真正的物联网节点。5.1 无线功能集成让温感灯“上网”ESP32的核心优势之一就是双模无线。我们可以很容易地让温感灯将数据上报到云端或者通过手机APP远程控制和查看。方案一Wi-Fi数据上报例如上传到MQTT服务器或云平台引入Wi-Fi库在代码开头加入#include WiFi.h和#include PubSubClient.h如果需要MQTT。配置网络信息在setup()函数中添加连接本地Wi-Fi的代码。定时上报在loop()中在读取温度后除了控制本地LED再将温度和状态封装成JSON格式通过HTTP POST或MQTT发布到指定的服务器。云端可视化可以在云平台如阿里云IoT、ThingsBoard、Home Assistant创建仪表盘实时显示温度曲线和当前灯光颜色。方案二蓝牙低功耗BLE控制引入BLE库使用#include BLEDevice.h等库。创建BLE服务定义一个自定义的BLE服务包含两个特征Characteristic一个用于手机APP向ESP32发送控制命令如切换模式、设置颜色另一个用于ESP32向手机APP广播当前温度和灯光状态。手机端开发使用MIT App Inventor、Flutter或原生开发一个简单的手机APP扫描并连接这个BLE设备实现交互。5.2 利用扩展板其他资源增强项目FireBeetle ESP32-E扩展板上预留的资源可以让我们在不增加额外连线的情况下丰富项目功能。板载按键如前所述可以用来切换工作模式自动/手动、调节参数、开关灯等。板载蜂鸣器可以增加声音反馈。例如当温度超过某个阈值时蜂鸣器发出警报声或者在按键操作时给出“嘀”的提示音。I2C接口可以轻松接入OLED显示屏SSD1306实时显示温度数值、颜色代码、Wi-Fi连接状态等信息让设备更具交互性。TF卡槽需焊接如果需要长时间记录温度数据可以将数据以CSV格式写入TF卡实现离线数据采集。5.3 电源管理与低功耗优化如果希望温感灯能使用电池长时间工作低功耗设计就很重要。深度睡眠模式对于温度监测这种不需要实时响应的场景可以让ESP32大部分时间处于深度睡眠Deep Sleep模式定时例如每5分钟唤醒一次读取温度、更新灯光、上报数据如果需要然后再次睡眠。这能极大降低平均功耗。传感器电源管理可以通过一个MOSFET或三极管由ESP32的一个GPIO控制DS18B20的电源通断。在ESP32睡眠时彻底切断传感器的供电进一步省电。LED亮度调节在光线充足的环境下可以适当降低RGB LED的PWM占空比即提高输出值使其变暗也能节省一些电量。通过FireBeetle ESP32-E扩展板完成这个温感灯项目整个过程非常顺畅。它确实如其宣传所言极大地简化了硬件连接让开发者能聚焦于逻辑和功能本身。从简单的本地温感灯到联网的物联网设备再到低功耗的监测节点这个项目框架具有很强的可扩展性。无论是用于学习嵌入式开发、物联网协议还是单纯做一个有趣的桌面摆件它都是一个非常棒的起点。