1. 为什么ESP32成了智能家居DIY的首选方案如果你最近两年逛过任何创客社区或者智能家居论坛ESP32这个名字出现的频率绝对排在前三。我最早接触它是在2019年当时还在用ESP8266做简单的继电器控制后来发现ESP32多出来的蓝牙通道和双核处理能力直接把可玩性拉高了一个量级。现在手头同时跑着五六个ESP32节点从阳台的温湿度采集到客厅的灯带控制再到卧室的BLE门锁联动整套系统跑了两年多稳定性比我早期用某品牌成品网关还要好。这个方案的核心思路其实很直接用一颗ESP32芯片同时承载WiFi和BLE两条通信链路WiFi负责接入家庭局域网做远程控制和数据上报BLE负责近场配网、低功耗传感器接入以及手机直连调试。这样做的好处是省掉了一个独立的蓝牙网关硬件成本压到三十块钱以内而且所有逻辑都跑在本地不依赖任何云平台断网也能正常执行自动化场景。适合看这篇内容的人大概分三类第一类是刚入门想找个完整项目练手的电子爱好者第二类是有一定编程基础想把自己的家改造成个性化智能系统的开发者第三类是做物联网产品原型验证的工程师。不管你是哪一类下面这些从实际项目里踩出来的经验应该都能帮你少走弯路。2. 整体架构设计与核心选型逻辑2.1 双模通信的分工策略ESP32同时支持WiFi和BLE但这两者并不是随便用就行的。我一开始犯过一个错误让WiFi和BLE同时高频工作结果发现2.4GHz频段上两者互相干扰BLE连接经常断WiFi的TCP重传率也飙升。后来调整了策略WiFi保持长连接用于MQTT通信BLE只在需要配网或者手机靠近时才广播平时处于低占空比扫描状态。具体来说BLE广播间隔设为500msWiFi的DTIM周期保持默认的3这样两者共存时丢包率从原来的15%降到了2%以下。这个分工逻辑背后的原理是ESP32的射频前端只有一个WiFi和BLE通过时分复用的方式共享天线。如果两者都要求高实时性冲突就不可避免。所以我的建议是把WiFi当作主干数据通道BLE当作辅助通道不要让BLE承担持续的大数据量传输。2.2 为什么不用成品智能家居网关市面上能买到的智能家居网关我基本都试过便宜的功能太单一贵的又太封闭。一个支持WiFi和BLE双模的网关动辄两三百而且很多只支持自家生态的传感器。ESP32方案的优势在于完全可控你想接什么传感器就接什么想用什么协议就用什么MQTT、HTTP、甚至自己写TCP私有协议都行。我现在的系统里混用了三种不同品牌的温湿度传感器通过BLE广播采集数据统一转成MQTT消息发到本地服务器这在成品网关上几乎做不到。成本方面算一笔账一块ESP32-WROOM-32模组大概15块加上电源模块、PCB板和外围元件单个节点控制在35块以内。如果批量做十个节点总成本不到四百块覆盖全屋的灯光、温湿度、门窗磁和红外控制绰绰有余。2.3 网络拓扑的确定我的方案采用星型拓扑以本地MQTT服务器为中心所有ESP32节点作为客户端接入。这样做的好处是节点之间不需要互相知道对方的存在新增或移除节点不影响其他设备。MQTT服务器跑在一台常年开机的迷你主机上用Mosquitto做broker配置了持久化会话即使节点短暂离线重连后也能收到离线期间的消息。对于没有本地服务器的朋友也可以用ESP32做一个小型的HTTP服务器节点之间通过HTTP请求通信。但这种方式在节点数量超过五个之后管理起来会很麻烦所以我还是推荐至少用一个树莓派或者旧笔记本跑MQTT broker。3. 硬件选型与电路设计要点3.1 ESP32模组的版本选择ESP32的模组型号很多我实际用过的有ESP32-WROOM-32、ESP32-WROVER-B和ESP32-S3。对于纯智能家居控制场景WROOM-32足够用它有4MB Flash跑Arduino框架或者ESP-IDF都绰绰有余。WROVER-B多出来的PSRAM在处理音频或者图像时才有必要普通传感器采集用不上。S3的话如果你需要USB直连调试或者更多的GPIO可以考虑但价格贵一些。这里要提醒一个坑市面上有些便宜的ESP32模组用的是二手拆机芯片烧录的时候经常出现“Failed to connect to ESP32: Timed out waiting for packet header”的错误。我买过一批十块钱以内的模组十块里有三块烧录不稳定。后来固定从正规渠道拿货单价贵两三块但良品率接近百分之百。3.2 电源电路的设计细节ESP32的峰值电流可以到500mAWiFi发射瞬间甚至更高。如果电源设计不到位会出现反复重启或者WiFi连接不稳定的情况。我的做法是每个节点用一块AMS1117-3.3稳压芯片输入侧加一个220uF的电解电容和一个0.1uF的陶瓷电容输出侧再加一个100uF的电解电容。这样在WiFi发射瞬间电容能提供足够的瞬态电流避免电压跌落导致芯片复位。如果你用USB供电一定要选质量好的电源适配器。我实测过某些便宜的5V/1A适配器在ESP32发射时输出电压会跌到4.3V以下AMS1117的压差不够输出只有2.9V左右芯片直接进入欠压复位循环。后来换用5V/2A的适配器问题就消失了。3.3 传感器接口的预留我在PCB设计时预留了I2C、SPI和几个GPIO接口方便后续扩展。I2C用于接温湿度传感器比如SHT30或者AHT20SPI留给显示屏或者LoRa模块GPIO用来接继电器或者红外发射管。这里有个经验不要把所有的GPIO都用在输出上至少留两个作为输入方便以后加按键或者门窗磁。另外ESP32的GPIO34到GPIO39是只输入引脚没有内部上拉电阻接按键的时候需要外部加上拉。GPIO6到GPIO11通常连接内部Flash不要占用。这些细节在画板子之前一定要确认清楚否则打回来的板子可能没法用。4. 软件开发环境搭建与核心代码解析4.1 Arduino框架还是ESP-IDF这个问题我被问过很多次。如果你之前用过Arduino那从Arduino框架入手最快库生态丰富社区支持好。但如果你要做复杂的BLE自定义服务或者对功耗有严格要求ESP-IDF更合适因为它能更精细地控制射频参数和电源管理。我的做法是混合使用用Arduino框架做快速原型验证等逻辑稳定后再把关键部分移植到ESP-IDF。对于大多数智能家居场景Arduino框架的性能完全够用。下面这段代码是用Arduino框架同时启动WiFi和BLE的典型结构#include WiFi.h #include BLEDevice.h #include BLEServer.h #include BLEUtils.h #define SERVICE_UUID 4fafc201-1fb5-459e-8fcc-c5c9c331914b #define CHARACTERISTIC_UUID beb5483e-36e1-4688-b7f5-ea07361b26a8 void setup() { Serial.begin(115200); // WiFi连接 WiFi.begin(your_ssid, your_password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(\nWiFi connected); // BLE初始化 BLEDevice::init(ESP32_SmartHome); BLEServer *pServer BLEDevice::createServer(); BLEService *pService pServer-createService(SERVICE_UUID); BLECharacteristic *pCharacteristic pService-createCharacteristic( CHARACTERISTIC_UUID, BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_WRITE ); pCharacteristic-setValue(Hello); pService-start(); BLEAdvertising *pAdvertising BLEDevice::getAdvertising(); pAdvertising-addServiceUUID(SERVICE_UUID); pAdvertising-start(); } void loop() { // 主循环处理传感器数据和MQTT消息 delay(1000); }这段代码看起来简单但有几个地方需要注意。第一WiFi连接的超时处理不能少否则路由器故障时设备会卡死在while循环里。第二BLE的服务UUID和特征UUID要符合标准格式否则某些手机APP会识别不了。第三广播间隔默认是100ms如果电池供电需要调大但会牺牲连接速度。4.2 MQTT通信的稳定性优化MQTT是ESP32和服务器通信的主要方式但默认配置下经常出现断连。我总结了几个关键参数keepalive设为30秒socket timeout设为10秒重连间隔从1秒开始指数退避到最大60秒。另外一定要启用clean session为false这样断线重连后能收到离线消息。还有一个容易被忽略的点MQTT客户端的缓冲区大小。默认是256字节如果发送的JSON数据超过这个长度消息会被截断。我在发布温湿度数据时JSON字符串大概120字节没问题。但后来加了门窗状态和光照强度总长度超过300字节就出现了消息丢失。把缓冲区调到1024字节后问题解决。4.3 BLE配网流程的实现BLE配网是我这个方案里最实用的功能之一。新节点上电后如果WiFi连接失败自动进入BLE配网模式。手机APP通过BLE发送WiFi的SSID和密码ESP32收到后保存到NVS非易失性存储然后重启连接WiFi。这里有个安全考虑BLE配网通道不能永久开放否则邻居也能连上来改你的WiFi密码。我的做法是配网模式只持续三分钟超时自动关闭。另外配网时要求手机发送一个预设的PIN码验证通过才接受WiFi信息。PIN码存在ESP32的efuse里不容易被读取。配网完成后BLE并没有完全关闭而是切换到一个低功耗的广播模式只广播设备状态不接受写入。这样手机靠近时还能查看设备信息但无法修改配置。5. 常见问题排查与避坑指南5.1 WiFi连接不稳定的排查思路WiFi断连是ESP32项目里最常见的问题。我的排查顺序是这样的先看电源用示波器测3.3V轨在WiFi发射瞬间有没有跌落再看天线PCB板载天线的周围有没有铺铜或者金属遮挡最后看路由器2.4GHz频段是不是太拥挤换个信道试试。有一个案例我印象很深一个节点放在金属配电箱里WiFi信号强度显示-70dBm但就是连不上。后来把天线引出到箱体外面信号强度变成-55dBm连接立刻稳定。所以如果你要把ESP32放在金属外壳里一定要用外置天线或者把天线区域开窗。5.2 BLE连接失败的常见原因BLE连接失败通常有三个原因一是手机APP的BLE扫描参数设置不对扫描窗口太短导致错过广播二是ESP32的BLE广播间隔太长手机要等很久才能发现三是UUID不匹配APP按照标准服务UUID去发现但ESP32用的是自定义UUID。我的建议是先用通用的BLE调试APP比如nRF Connect确认ESP32的广播包内容看看服务UUID、设备名称、发射功率这些字段是否正确。如果nRF Connect能发现但自己的APP发现不了那就是APP的扫描逻辑有问题。5.3 烧录失败的几种情况和解决方法烧录失败我遇到过至少五种情况。第一种是驱动没装好设备管理器里显示未知设备装CP2102或者CH340驱动解决。第二种是USB线质量差只能充电不能传数据换线解决。第三种是GPIO0没有拉低ESP32没进入下载模式手动短接GPIO0到GND再复位。第四种是Flash大小选错了Arduino IDE里要选对模组型号。第五种是串口被其他程序占用关掉串口监视器再烧录。这里特别说一下有些ESP32开发板用的是CH9102串口芯片Windows 11下可能需要手动安装驱动而且安装后要禁用驱动签名强制。这个坑我踩过两次后来干脆都用CP2102的板子省心。5.4 内存不足和看门狗复位ESP32的SRAM大概320KB跑Arduino框架加WiFi和BLE协议栈之后可用内存大概只剩100KB左右。如果代码里频繁用String拼接很容易造成内存碎片最终导致分配失败。我的做法是尽量用字符数组代替StringJSON序列化用ArduinoJson的StaticJsonDocument在编译期就确定大小。看门狗复位通常是因为某个任务阻塞太久。比如在loop里用了delay(5000)看门狗就会触发。解决办法是把长延时拆成多个短延时或者用millis()做非阻塞延时。另外如果开了BLEloop的执行时间不能超过几毫秒否则BLE协议栈会报错。6. 实际部署中的经验与扩展思路6.1 节点固件的OTA升级方案节点部署到墙上之后再想用USB线升级就很麻烦所以OTA空中升级是必须的。Arduino框架自带ArduinoOTA库用起来很简单但要注意几点OTA升级时WiFi必须稳定升级过程中断电会导致固件损坏升级文件大小不能超过Flash分区里OTA分区的大小默认是1.2MB左右如果固件太大需要调整分区表。我的做法是在MQTT服务器上放一个固件版本号节点定期检查发现新版本就自动下载升级。升级前先发一条消息通知服务器升级完成后重启并上报新版本号。这样十个节点可以在几分钟内全部更新完毕。6.2 低功耗场景的优化如果节点用电池供电功耗就是关键。ESP32在WiFi保持连接时平均电流大概80mA用2000mAh的电池只能撑一天多。要延长续航必须用深度睡眠。我的做法是节点每5分钟唤醒一次采集数据、连接WiFi、发送MQTT消息然后立刻进入深度睡眠。这样平均电流降到2mA左右2000mAh电池可以撑一个多月。深度睡眠的唤醒源可以用定时器或者外部GPIO。定时器唤醒适合周期性采集GPIO唤醒适合门窗磁这种事件触发。注意深度睡眠时BLE和WiFi都会关闭所以BLE配网功能在电池节点上要单独考虑通常只在首次配置时用。6.3 多协议共存的干扰规避前面提到WiFi和BLE会互相干扰其实如果再加上Zigbee或者Thread2.4GHz频段会更拥挤。我的经验是如果必须多协议共存给WiFi分配固定的信道比如信道1、6、11中的一个BLE的广播信道避开WiFi信道。另外降低BLE的发射功率也能减少干扰一般设为0dBm就够了覆盖一个房间没问题。还有一个技巧是用ESP32的双核特性把WiFi任务固定在核心0BLE和传感器任务固定在核心1这样两个协议栈不会互相抢占CPU时间。Arduino框架下可以用xTaskCreatePinnedToCore来实现。6.4 与语音模块的联动热词里提到了语音模块和ESP32的配合我实际做过一个方案用离线语音识别模块接ESP32的串口识别到关键词后ESP32执行对应动作比如开灯、关窗帘。语音模块负责唤醒和识别ESP32负责执行和状态上报。这样分工的好处是语音识别不占用ESP32的资源响应速度也更快。接线方面语音模块的TX接ESP32的RXRX接TX波特率一般设为9600。注意电平匹配有些语音模块是5V电平ESP32是3.3V需要加电平转换电路否则长期工作可能损坏ESP32的串口引脚。7. 关于这套方案的一些个人体会这套ESP32双模方案我前前后后迭代了四个版本从最初的面包板到现在的小批量PCB中间踩过的坑写满了一个笔记本。最大的感受是不要追求一步到位先把WiFi通信跑通再加BLE再加传感器每加一个功能就稳定运行一周再继续。我见过太多人一开始就想做全屋智能结果卡在某个细节上放弃了。另外本地化部署真的很重要。我早期用过某云平台结果平台改政策导致设备全部离线从那以后所有数据都走本地MQTT。现在即使外网断了家里的自动化场景照常运行手机连上WiFi也能控制所有设备。最后分享一个调试小技巧在ESP32上跑一个简单的Web服务器实时显示WiFi信号强度、内存剩余、BLE连接状态这些信息。手机浏览器打开就能看比串口打印方便多了。这个Web服务器只占几KB的Flash但对调试的帮助非常大。
ESP32双模智能家居DIY：WiFi与BLE共存实战指南
1. 为什么ESP32成了智能家居DIY的首选方案如果你最近两年逛过任何创客社区或者智能家居论坛ESP32这个名字出现的频率绝对排在前三。我最早接触它是在2019年当时还在用ESP8266做简单的继电器控制后来发现ESP32多出来的蓝牙通道和双核处理能力直接把可玩性拉高了一个量级。现在手头同时跑着五六个ESP32节点从阳台的温湿度采集到客厅的灯带控制再到卧室的BLE门锁联动整套系统跑了两年多稳定性比我早期用某品牌成品网关还要好。这个方案的核心思路其实很直接用一颗ESP32芯片同时承载WiFi和BLE两条通信链路WiFi负责接入家庭局域网做远程控制和数据上报BLE负责近场配网、低功耗传感器接入以及手机直连调试。这样做的好处是省掉了一个独立的蓝牙网关硬件成本压到三十块钱以内而且所有逻辑都跑在本地不依赖任何云平台断网也能正常执行自动化场景。适合看这篇内容的人大概分三类第一类是刚入门想找个完整项目练手的电子爱好者第二类是有一定编程基础想把自己的家改造成个性化智能系统的开发者第三类是做物联网产品原型验证的工程师。不管你是哪一类下面这些从实际项目里踩出来的经验应该都能帮你少走弯路。2. 整体架构设计与核心选型逻辑2.1 双模通信的分工策略ESP32同时支持WiFi和BLE但这两者并不是随便用就行的。我一开始犯过一个错误让WiFi和BLE同时高频工作结果发现2.4GHz频段上两者互相干扰BLE连接经常断WiFi的TCP重传率也飙升。后来调整了策略WiFi保持长连接用于MQTT通信BLE只在需要配网或者手机靠近时才广播平时处于低占空比扫描状态。具体来说BLE广播间隔设为500msWiFi的DTIM周期保持默认的3这样两者共存时丢包率从原来的15%降到了2%以下。这个分工逻辑背后的原理是ESP32的射频前端只有一个WiFi和BLE通过时分复用的方式共享天线。如果两者都要求高实时性冲突就不可避免。所以我的建议是把WiFi当作主干数据通道BLE当作辅助通道不要让BLE承担持续的大数据量传输。2.2 为什么不用成品智能家居网关市面上能买到的智能家居网关我基本都试过便宜的功能太单一贵的又太封闭。一个支持WiFi和BLE双模的网关动辄两三百而且很多只支持自家生态的传感器。ESP32方案的优势在于完全可控你想接什么传感器就接什么想用什么协议就用什么MQTT、HTTP、甚至自己写TCP私有协议都行。我现在的系统里混用了三种不同品牌的温湿度传感器通过BLE广播采集数据统一转成MQTT消息发到本地服务器这在成品网关上几乎做不到。成本方面算一笔账一块ESP32-WROOM-32模组大概15块加上电源模块、PCB板和外围元件单个节点控制在35块以内。如果批量做十个节点总成本不到四百块覆盖全屋的灯光、温湿度、门窗磁和红外控制绰绰有余。2.3 网络拓扑的确定我的方案采用星型拓扑以本地MQTT服务器为中心所有ESP32节点作为客户端接入。这样做的好处是节点之间不需要互相知道对方的存在新增或移除节点不影响其他设备。MQTT服务器跑在一台常年开机的迷你主机上用Mosquitto做broker配置了持久化会话即使节点短暂离线重连后也能收到离线期间的消息。对于没有本地服务器的朋友也可以用ESP32做一个小型的HTTP服务器节点之间通过HTTP请求通信。但这种方式在节点数量超过五个之后管理起来会很麻烦所以我还是推荐至少用一个树莓派或者旧笔记本跑MQTT broker。3. 硬件选型与电路设计要点3.1 ESP32模组的版本选择ESP32的模组型号很多我实际用过的有ESP32-WROOM-32、ESP32-WROVER-B和ESP32-S3。对于纯智能家居控制场景WROOM-32足够用它有4MB Flash跑Arduino框架或者ESP-IDF都绰绰有余。WROVER-B多出来的PSRAM在处理音频或者图像时才有必要普通传感器采集用不上。S3的话如果你需要USB直连调试或者更多的GPIO可以考虑但价格贵一些。这里要提醒一个坑市面上有些便宜的ESP32模组用的是二手拆机芯片烧录的时候经常出现“Failed to connect to ESP32: Timed out waiting for packet header”的错误。我买过一批十块钱以内的模组十块里有三块烧录不稳定。后来固定从正规渠道拿货单价贵两三块但良品率接近百分之百。3.2 电源电路的设计细节ESP32的峰值电流可以到500mAWiFi发射瞬间甚至更高。如果电源设计不到位会出现反复重启或者WiFi连接不稳定的情况。我的做法是每个节点用一块AMS1117-3.3稳压芯片输入侧加一个220uF的电解电容和一个0.1uF的陶瓷电容输出侧再加一个100uF的电解电容。这样在WiFi发射瞬间电容能提供足够的瞬态电流避免电压跌落导致芯片复位。如果你用USB供电一定要选质量好的电源适配器。我实测过某些便宜的5V/1A适配器在ESP32发射时输出电压会跌到4.3V以下AMS1117的压差不够输出只有2.9V左右芯片直接进入欠压复位循环。后来换用5V/2A的适配器问题就消失了。3.3 传感器接口的预留我在PCB设计时预留了I2C、SPI和几个GPIO接口方便后续扩展。I2C用于接温湿度传感器比如SHT30或者AHT20SPI留给显示屏或者LoRa模块GPIO用来接继电器或者红外发射管。这里有个经验不要把所有的GPIO都用在输出上至少留两个作为输入方便以后加按键或者门窗磁。另外ESP32的GPIO34到GPIO39是只输入引脚没有内部上拉电阻接按键的时候需要外部加上拉。GPIO6到GPIO11通常连接内部Flash不要占用。这些细节在画板子之前一定要确认清楚否则打回来的板子可能没法用。4. 软件开发环境搭建与核心代码解析4.1 Arduino框架还是ESP-IDF这个问题我被问过很多次。如果你之前用过Arduino那从Arduino框架入手最快库生态丰富社区支持好。但如果你要做复杂的BLE自定义服务或者对功耗有严格要求ESP-IDF更合适因为它能更精细地控制射频参数和电源管理。我的做法是混合使用用Arduino框架做快速原型验证等逻辑稳定后再把关键部分移植到ESP-IDF。对于大多数智能家居场景Arduino框架的性能完全够用。下面这段代码是用Arduino框架同时启动WiFi和BLE的典型结构#include WiFi.h #include BLEDevice.h #include BLEServer.h #include BLEUtils.h #define SERVICE_UUID 4fafc201-1fb5-459e-8fcc-c5c9c331914b #define CHARACTERISTIC_UUID beb5483e-36e1-4688-b7f5-ea07361b26a8 void setup() { Serial.begin(115200); // WiFi连接 WiFi.begin(your_ssid, your_password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(\nWiFi connected); // BLE初始化 BLEDevice::init(ESP32_SmartHome); BLEServer *pServer BLEDevice::createServer(); BLEService *pService pServer-createService(SERVICE_UUID); BLECharacteristic *pCharacteristic pService-createCharacteristic( CHARACTERISTIC_UUID, BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_WRITE ); pCharacteristic-setValue(Hello); pService-start(); BLEAdvertising *pAdvertising BLEDevice::getAdvertising(); pAdvertising-addServiceUUID(SERVICE_UUID); pAdvertising-start(); } void loop() { // 主循环处理传感器数据和MQTT消息 delay(1000); }这段代码看起来简单但有几个地方需要注意。第一WiFi连接的超时处理不能少否则路由器故障时设备会卡死在while循环里。第二BLE的服务UUID和特征UUID要符合标准格式否则某些手机APP会识别不了。第三广播间隔默认是100ms如果电池供电需要调大但会牺牲连接速度。4.2 MQTT通信的稳定性优化MQTT是ESP32和服务器通信的主要方式但默认配置下经常出现断连。我总结了几个关键参数keepalive设为30秒socket timeout设为10秒重连间隔从1秒开始指数退避到最大60秒。另外一定要启用clean session为false这样断线重连后能收到离线消息。还有一个容易被忽略的点MQTT客户端的缓冲区大小。默认是256字节如果发送的JSON数据超过这个长度消息会被截断。我在发布温湿度数据时JSON字符串大概120字节没问题。但后来加了门窗状态和光照强度总长度超过300字节就出现了消息丢失。把缓冲区调到1024字节后问题解决。4.3 BLE配网流程的实现BLE配网是我这个方案里最实用的功能之一。新节点上电后如果WiFi连接失败自动进入BLE配网模式。手机APP通过BLE发送WiFi的SSID和密码ESP32收到后保存到NVS非易失性存储然后重启连接WiFi。这里有个安全考虑BLE配网通道不能永久开放否则邻居也能连上来改你的WiFi密码。我的做法是配网模式只持续三分钟超时自动关闭。另外配网时要求手机发送一个预设的PIN码验证通过才接受WiFi信息。PIN码存在ESP32的efuse里不容易被读取。配网完成后BLE并没有完全关闭而是切换到一个低功耗的广播模式只广播设备状态不接受写入。这样手机靠近时还能查看设备信息但无法修改配置。5. 常见问题排查与避坑指南5.1 WiFi连接不稳定的排查思路WiFi断连是ESP32项目里最常见的问题。我的排查顺序是这样的先看电源用示波器测3.3V轨在WiFi发射瞬间有没有跌落再看天线PCB板载天线的周围有没有铺铜或者金属遮挡最后看路由器2.4GHz频段是不是太拥挤换个信道试试。有一个案例我印象很深一个节点放在金属配电箱里WiFi信号强度显示-70dBm但就是连不上。后来把天线引出到箱体外面信号强度变成-55dBm连接立刻稳定。所以如果你要把ESP32放在金属外壳里一定要用外置天线或者把天线区域开窗。5.2 BLE连接失败的常见原因BLE连接失败通常有三个原因一是手机APP的BLE扫描参数设置不对扫描窗口太短导致错过广播二是ESP32的BLE广播间隔太长手机要等很久才能发现三是UUID不匹配APP按照标准服务UUID去发现但ESP32用的是自定义UUID。我的建议是先用通用的BLE调试APP比如nRF Connect确认ESP32的广播包内容看看服务UUID、设备名称、发射功率这些字段是否正确。如果nRF Connect能发现但自己的APP发现不了那就是APP的扫描逻辑有问题。5.3 烧录失败的几种情况和解决方法烧录失败我遇到过至少五种情况。第一种是驱动没装好设备管理器里显示未知设备装CP2102或者CH340驱动解决。第二种是USB线质量差只能充电不能传数据换线解决。第三种是GPIO0没有拉低ESP32没进入下载模式手动短接GPIO0到GND再复位。第四种是Flash大小选错了Arduino IDE里要选对模组型号。第五种是串口被其他程序占用关掉串口监视器再烧录。这里特别说一下有些ESP32开发板用的是CH9102串口芯片Windows 11下可能需要手动安装驱动而且安装后要禁用驱动签名强制。这个坑我踩过两次后来干脆都用CP2102的板子省心。5.4 内存不足和看门狗复位ESP32的SRAM大概320KB跑Arduino框架加WiFi和BLE协议栈之后可用内存大概只剩100KB左右。如果代码里频繁用String拼接很容易造成内存碎片最终导致分配失败。我的做法是尽量用字符数组代替StringJSON序列化用ArduinoJson的StaticJsonDocument在编译期就确定大小。看门狗复位通常是因为某个任务阻塞太久。比如在loop里用了delay(5000)看门狗就会触发。解决办法是把长延时拆成多个短延时或者用millis()做非阻塞延时。另外如果开了BLEloop的执行时间不能超过几毫秒否则BLE协议栈会报错。6. 实际部署中的经验与扩展思路6.1 节点固件的OTA升级方案节点部署到墙上之后再想用USB线升级就很麻烦所以OTA空中升级是必须的。Arduino框架自带ArduinoOTA库用起来很简单但要注意几点OTA升级时WiFi必须稳定升级过程中断电会导致固件损坏升级文件大小不能超过Flash分区里OTA分区的大小默认是1.2MB左右如果固件太大需要调整分区表。我的做法是在MQTT服务器上放一个固件版本号节点定期检查发现新版本就自动下载升级。升级前先发一条消息通知服务器升级完成后重启并上报新版本号。这样十个节点可以在几分钟内全部更新完毕。6.2 低功耗场景的优化如果节点用电池供电功耗就是关键。ESP32在WiFi保持连接时平均电流大概80mA用2000mAh的电池只能撑一天多。要延长续航必须用深度睡眠。我的做法是节点每5分钟唤醒一次采集数据、连接WiFi、发送MQTT消息然后立刻进入深度睡眠。这样平均电流降到2mA左右2000mAh电池可以撑一个多月。深度睡眠的唤醒源可以用定时器或者外部GPIO。定时器唤醒适合周期性采集GPIO唤醒适合门窗磁这种事件触发。注意深度睡眠时BLE和WiFi都会关闭所以BLE配网功能在电池节点上要单独考虑通常只在首次配置时用。6.3 多协议共存的干扰规避前面提到WiFi和BLE会互相干扰其实如果再加上Zigbee或者Thread2.4GHz频段会更拥挤。我的经验是如果必须多协议共存给WiFi分配固定的信道比如信道1、6、11中的一个BLE的广播信道避开WiFi信道。另外降低BLE的发射功率也能减少干扰一般设为0dBm就够了覆盖一个房间没问题。还有一个技巧是用ESP32的双核特性把WiFi任务固定在核心0BLE和传感器任务固定在核心1这样两个协议栈不会互相抢占CPU时间。Arduino框架下可以用xTaskCreatePinnedToCore来实现。6.4 与语音模块的联动热词里提到了语音模块和ESP32的配合我实际做过一个方案用离线语音识别模块接ESP32的串口识别到关键词后ESP32执行对应动作比如开灯、关窗帘。语音模块负责唤醒和识别ESP32负责执行和状态上报。这样分工的好处是语音识别不占用ESP32的资源响应速度也更快。接线方面语音模块的TX接ESP32的RXRX接TX波特率一般设为9600。注意电平匹配有些语音模块是5V电平ESP32是3.3V需要加电平转换电路否则长期工作可能损坏ESP32的串口引脚。7. 关于这套方案的一些个人体会这套ESP32双模方案我前前后后迭代了四个版本从最初的面包板到现在的小批量PCB中间踩过的坑写满了一个笔记本。最大的感受是不要追求一步到位先把WiFi通信跑通再加BLE再加传感器每加一个功能就稳定运行一周再继续。我见过太多人一开始就想做全屋智能结果卡在某个细节上放弃了。另外本地化部署真的很重要。我早期用过某云平台结果平台改政策导致设备全部离线从那以后所有数据都走本地MQTT。现在即使外网断了家里的自动化场景照常运行手机连上WiFi也能控制所有设备。最后分享一个调试小技巧在ESP32上跑一个简单的Web服务器实时显示WiFi信号强度、内存剩余、BLE连接状态这些信息。手机浏览器打开就能看比串口打印方便多了。这个Web服务器只占几KB的Flash但对调试的帮助非常大。
![[基础篇06] 用 OpenCode 模板引擎生成代码片段：从 md-expand 到自定义命令的 TaoToken 配置骨架](http://pic.xiahunao.cn/yaotu/[基础篇06] 用 OpenCode 模板引擎生成代码片段：从 md-expand 到自定义命令的 TaoToken 配置骨架)
