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 元器件清单与接口确认

你需要准备以下硬件：

1. FireBeetle ESP32-E 主控板 x1
2. FireBeetle ESP32-E 扩展板 x1
3. DS18B20 温度传感器（封装形式不限，建议用带线版的，方便布置） x1
4. 共阳极RGB LED 灯珠 x1
5. 4.7kΩ 电阻 x1（用于DS18B20单总线上的拉高）
6. 3个 220Ω 电阻 x1（用于RGB LED各阴极的限流，防止电流过大烧毁LED或ESP32引脚）
7. 连接线若干（如果传感器和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Ω ≈ 10mA），ESP32和LED都工作得凉爽又稳定。这是保护硬件的基本操作。

第四步：检查电路连接完成后，对照下面的简表再检查一遍：

至此，硬件连接部分就完成了。你可以看到，通过扩展板，我们避免了面包板的杂乱，所有连接都清晰、稳固地落在了板载的排针上。

3. 软件环境搭建与核心库配置

硬件搭好了，接下来就是让ESP32“思考”和“行动”的软件部分。我们将使用Arduino IDE进行开发，这是目前最流行、对新手最友好的ESP32开发方式之一。

3.1 Arduino IDE环境配置与板卡支持

首先，确保你安装了最新版的Arduino IDE。然后，需要添加ESP32的开发板支持。

1. 打开Arduino IDE，点击文件->首选项。
2. 在“附加开发板管理器网址”中，填入以下网址（如果已有其他网址，用逗号隔开）：https://espressif.github.io/arduino-esp32/package_esp32_index.json
3. 点击确定保存。
4. 点击工具->开发板->开发板管理器。
5. 在搜索框中输入“esp32”，找到由“Espressif Systems”提供的“ESP32”开发板包，点击安装。这个过程可能需要一些时间，取决于你的网络速度。
6. 安装完成后，在工具->开发板列表中，选择“FireBeetle ESP32”。（注意：如果列表中没有，可以选择“ESP32 Dev Module”，大部分引脚是兼容的，但最好确认一下FireBeetle的特定引脚映射）。

接下来需要安装本项目依赖的两个核心库：

• DallasTemperature： 用于驱动DS18B20等Dallas单总线温度传感器。
• OneWire： DallasTemperature库的基础，负责处理单总线通信协议。

安装库的步骤：

1. 点击工具->管理库...。
2. 在库管理器中，分别搜索“DallasTemperature”和“OneWire”。
3. 找到由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）：红色 -> 品红 // 注意：共阳极LED，PWM值越大，亮度越暗（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的LEDC（LED控制）硬件PWM模块功能强大，但通道有限。我们为红、绿、蓝各分配了一个独立通道（0,1,2），这样可以实现精确的独立调光。ledcSetup()函数中的resolution参数设置为8，意味着占空比可以设置为0到255之间的任意整数，这对于颜色混合来说精度足够了。

4. 烧录、调试与功能验证

代码写好了，接下来就是把它烧录到FireBeetle ESP32-E上，并观察温感灯是否按预期工作。

4.1 程序烧录与串口监控

1. 连接硬件：用USB线将FireBeetle ESP32-E（已插在扩展板上）连接到电脑。
2. 选择端口：在Arduino IDE的工具->端口菜单中，选择对应的COM口（Windows）或/dev/cu.usbserial-*（Mac/Linux）。
3. 编译与上传：点击左上角的“√”（验证）按钮编译代码，确认无误后点击“→”（上传）按钮将程序烧录到板子中。
4. 打开串口监视器：上传完成后，点击工具->串口监视器（或右上角的放大镜图标）。将右下角的波特率设置为115200，与代码中Serial.begin(115200)一致。

如果一切正常，你会在串口监视器中看到“FireBeetle ESP32-E 温感灯启动...”的提示，随后会每隔2秒打印当前的温度值和计算出的RGB输出值。此时，用手触摸或向DS18B20哈气，观察温度变化，同时看RGB LED的颜色是否随之改变。

4.2 功能测试与效果优化

在基础功能跑通后，我们可以进行更细致的测试和优化：

1. 温度准确性校准：DS18B20出厂有精度误差。你可以用一个相对准确的水银温度计或数字温度计作为参考，同时测量环境温度。比较串口打印的读数与参考温度计的差值，如果存在固定偏差，可以在代码中进行补偿。例如，如果传感器始终偏高0.5°C，可以在temperature = sensors.getTempCByIndex(0);这行后面加上temperature = temperature - 0.5;。

2. 颜色过渡平滑性测试：尝试缓慢改变环境温度（例如用温水袋靠近或远离传感器），观察LED颜色变化是否平滑、有无明显的色阶跳跃。如果觉得过渡生硬，可以调整setColorByTemperature函数中的温度区间和map函数的参数，或者采用更复杂的插值算法（如双线性插值）来计算中间颜色。

3. 响应速度测试：默认的delay(2000)是2秒更新一次。对于环境温度监测，这个间隔是合适的。如果你希望响应更快，可以减小这个值，但要注意DS18B20完成一次温度转换需要一定时间（最高精度下约750ms），过快的请求会导致读取失败或增加功耗。

4. 加入模式切换：利用扩展板上的可编程按键（通常连接某个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服务器或云平台）

1. 引入Wi-Fi库：在代码开头加入#include <WiFi.h>和#include <PubSubClient.h>（如果需要MQTT）。
2. 配置网络信息：在setup()函数中，添加连接本地Wi-Fi的代码。
3. 定时上报：在loop()中，在读取温度后，除了控制本地LED，再将温度和状态封装成JSON格式，通过HTTP POST或MQTT发布到指定的服务器。
4. 云端可视化：可以在云平台（如阿里云IoT、ThingsBoard、Home Assistant）创建仪表盘，实时显示温度曲线和当前灯光颜色。

方案二：蓝牙低功耗（BLE）控制

1. 引入BLE库：使用#include <BLEDevice.h>等库。
2. 创建BLE服务：定义一个自定义的BLE服务，包含两个特征（Characteristic）：一个用于手机APP向ESP32发送控制命令（如切换模式、设置颜色），另一个用于ESP32向手机APP广播当前温度和灯光状态。
3. 手机端开发：使用MIT App Inventor、Flutter或原生开发一个简单的手机APP，扫描并连接这个BLE设备，实现交互。

5.2 利用扩展板其他资源增强项目

FireBeetle ESP32-E扩展板上预留的资源可以让我们在不增加额外连线的情况下，丰富项目功能。

• 板载按键：如前所述，可以用来切换工作模式（自动/手动）、调节参数、开关灯等。
• 板载蜂鸣器：可以增加声音反馈。例如，当温度超过某个阈值时，蜂鸣器发出警报声；或者在按键操作时给出“嘀”的提示音。
• I2C接口：可以轻松接入OLED显示屏（SSD1306），实时显示温度数值、颜色代码、Wi-Fi连接状态等信息，让设备更具交互性。
• TF卡槽（需焊接）：如果需要长时间记录温度数据，可以将数据以CSV格式写入TF卡，实现离线数据采集。

5.3 电源管理与低功耗优化

如果希望温感灯能使用电池长时间工作，低功耗设计就很重要。

1. 深度睡眠模式：对于温度监测这种不需要实时响应的场景，可以让ESP32大部分时间处于深度睡眠（Deep Sleep）模式，定时（例如每5分钟）唤醒一次，读取温度、更新灯光、上报数据（如果需要），然后再次睡眠。这能极大降低平均功耗。
2. 传感器电源管理：可以通过一个MOSFET或三极管，由ESP32的一个GPIO控制DS18B20的电源通断。在ESP32睡眠时，彻底切断传感器的供电，进一步省电。
3. LED亮度调节：在光线充足的环境下，可以适当降低RGB LED的PWM占空比（即提高输出值，使其变暗），也能节省一些电量。

通过FireBeetle ESP32-E扩展板完成这个温感灯项目，整个过程非常顺畅。它确实如其宣传所言，极大地简化了硬件连接，让开发者能聚焦于逻辑和功能本身。从简单的本地温感灯，到联网的物联网设备，再到低功耗的监测节点，这个项目框架具有很强的可扩展性。无论是用于学习嵌入式开发、物联网协议，还是单纯做一个有趣的桌面摆件，它都是一个非常棒的起点。