用ESP32 BLE Client做一个智能家居遥控器：手把手连接智能灯泡实战

用ESP32 BLE Client打造智能家居遥控器：从零连接Yeelight灯泡实战

当你窝在沙发里，发现客厅的智能灯泡还亮着，却懒得起身去关——这种场景下，一个自制的ESP32遥控器就能成为你的"懒人救星"。本文将带你用不到50元的硬件成本，构建一个能控制Yeelight等BLE智能灯泡的万能遥控器，同时深入解析BLE协议栈的实战应用技巧。

1. 项目准备：硬件选型与环境搭建

硬件清单就像厨师的食材，选对才能做出好菜。你需要准备：

• ESP32开发板（推荐带蓝牙4.2以上的型号）
• Yeelight彩光灯泡（型号YLDP06YL）
• 微型按键开关（用于控制触发）
• 面包板与杜邦线若干

开发环境配置有个小窍门：在Arduino IDE中安装ESP32 BLE Arduino库时，建议选择2.0.0版本，新版本可能存在API兼容性问题。以下是快速验证环境是否就绪的代码片段：

#include <BLEDevice.h> void setup() { Serial.begin(115200); BLEDevice::init("ESP32_Remote"); Serial.println("BLE初始化完成"); } void loop() {}

常见坑点：很多初学者会卡在开发板驱动安装上。Windows用户遇到端口识别问题时，可以尝试先安装CP210x USB驱动，再重新插拔设备。

2. BLE设备扫描与目标识别

智能灯泡就像派对上的宾客，我们需要先"认出"想交谈的对象。Yeelight灯泡的BLE广播包含特定服务UUID：0xFE0F。以下是优化后的扫描代码：

BLEScan* pBLEScan = BLEDevice::getScan(); pBLEScan->setActiveScan(true); // 启用主动扫描获取更多信息 pBLEScan->setInterval(100); // 扫描间隔(ms) pBLEScan->setWindow(99); // 扫描窗口(ms) // 自定义回调类 class MyAdvertisedDeviceCallbacks : public BLEAdvertisedDeviceCallbacks { void onResult(BLEAdvertisedDevice advertisedDevice) { if(advertisedDevice.haveServiceUUID() && advertisedDevice.getServiceUUID().equals(BLEUUID("FE0F"))) { Serial.printf("发现Yeelight灯泡: %s\n", advertisedDevice.getAddress().toString().c_str()); advertisedDevice.getScan()->stop(); } } }; // 在setup中添加 pBLEScan->setAdvertisedDeviceCallbacks(new MyAdvertisedDeviceCallbacks());

参数调优对照表：

实测发现，当环境中有多个BLE设备时，设置1秒的扫描超时可提高目标识别准确率：

BLEScanResults foundDevices = pBLEScan->start(1, false);

3. 连接建立与服务发现

成功识别设备后，就像拿到了派对邀请函。连接阶段需要特别注意MTU协商——这决定了每次数据传输的最大容量。Yeelight灯泡通常支持128字节的MTU：

bool connectToServer(BLEAddress pAddress) { BLEClient* pClient = BLEDevice::createClient(); pClient->setMTU(128); // 关键设置 if (!pClient->connect(pAddress)) { Serial.println("连接失败"); return false; } // 获取服务 BLERemoteService* pRemoteService = pClient->getService(BLEUUID("FE0F")); if (pRemoteService == nullptr) { Serial.println("服务未找到"); pClient->disconnect(); return false; } return true; }

连接状态机是稳定性的关键。建议实现以下状态处理：

1. 连接中 → 显示脉冲动画
2. 已连接 → 绿灯常亮
3. 断开 → 红灯闪烁并自动重连

通过pClient->isConnected()可以实时监测连接状态，避免发送失败指令。

4. 特征值操作与灯泡控制

Yeelight的控制协议就像灯泡的"语言密码"。通过分析抓包数据，我们发现两个关键特征：

灯光控制指令采用二进制协议。以下是设置RGB颜色的代码模板：

void setColor(BLERemoteCharacteristic* pChar, uint8_t r, uint8_t g, uint8_t b) { uint8_t cmd[8] = {0x56, r, g, b, 0x00, 0xF0, 0xAA, 0x0B}; pChar->writeValue(cmd, 8, false); // 注意最后一个参数设置无响应 }

专业技巧：在批量发送指令时，建议添加50ms的延迟，避免灯泡处理不过来：

setColor(pChar, 255,0,0); // 红色 delay(50); setColor(pChar, 0,255,0); // 绿色

亮度调节则需要不同的指令格式：

void setBrightness(BLERemoteCharacteristic* pChar, uint8_t brightness) { uint8_t cmd[4] = {0x03, brightness, 0xAA, 0x0B}; pChar->writeValue(cmd, 4, false); }

5. 状态同步与用户界面设计

好的遥控器应该像镜子一样反映设备状态。通过订阅FF02特征的NOTIFY，我们可以实时获取灯泡状态：

// 在特征发现后注册通知 pRemoteCharacteristic->registerForNotify(notifyCallback); // 回调函数实现 void notifyCallback(BLERemoteCharacteristic* pBLERemoteCharacteristic, uint8_t* pData, size_t length, bool isNotify) { Serial.print("状态更新: "); for(int i=0; i<length; i++){ Serial.printf("%02X ", pData[i]); } Serial.println(); }

物理按键设计推荐使用中断触发模式，避免轮询带来的延迟：

#define BUTTON_PIN 0 void IRAM_ATTR handleButton() { xTaskResumeFromISR(controlTaskHandle); // 唤醒控制任务 } void setup() { pinMode(BUTTON_PIN, INPUT_PULLUP); attachInterrupt(BUTTON_PIN, handleButton, FALLING); }

对于多设备控制场景，可以扩展以下架构：

1. 使用SPIFFS存储多个灯泡的MAC地址
2. 通过EEPROM记住最后连接的设备
3. 添加NFC模块实现"碰一碰"控制

6. 电源优化与量产建议

想让遥控器摆脱充电烦恼？低功耗设计是关键：

功耗对比表：

实现自动休眠的代码逻辑：

void controlTask(void *pvParameters) { for(;;) { if(xTaskGetTickCount() - lastActiveTime > 10000) { esp_deep_sleep_start(); // 进入深度睡眠 } vTaskDelay(100/portTICK_PERIOD_MS); } }

量产建议：

• 改用ESP32-C3模组降低成本
• 使用3D打印外壳
• 添加锂电池充放电管理电路

7. 故障排查与进阶调试

当遇到连接不稳定时，可以启用BLE调试日志：

// 在setup()中添加 esp_log_level_set("*", ESP_LOG_DEBUG);

常见问题排查指南：

1. 连接频繁断开

   • 检查天线摆放位置
   • 降低MTU大小到64
   • 添加esp_ble_gap_update_conn_params优化连接参数

2. 指令无响应

   • 确认特征属性包含WRITE
   • 尝试改用WRITE_TYPE_NO_RESPONSE
   • 检查指令CRC校验字节

3. 距离过短

   • 更换PCB天线为外置天线
   • 调整发射功率：esp_ble_tx_power_set(ESP_BLE_PWR_TYPE_DEFAULT, ESP_PWR_LVL_P9)

对于想深入协议分析的用户，建议使用nRF Connect App抓包，对比正常通信的数据格式。