1. 项目缘起与整体设计思路门磁这东西做智能家居的朋友都不陌生。一个簧片开关加一块磁铁门一开一合触点通断完事。便宜、可靠、不用供电装门上几年都不用管。但问题也恰恰出在这里——它本身不会说话你得给它配个能上报状态的“嘴”。传统做法是拉一根两芯线接到主控的GPIO上主控再通过Wi-Fi或者别的什么方式把状态发出去。可一旦门和主控之间隔着几米甚至十几米走线就成了麻烦事尤其是租房党或者老房子墙上打孔走线基本不现实。这个项目的核心思路就是把门磁开关直接挂到一块ESP32-S3上用Bluetooth LE把开关状态广播出去让附近的手机、平板或者另一个常驻的接收端来监听。ESP32-S3在这套方案里扮演的是“采集广播”的角色它不需要连Wi-Fi不需要连路由器甚至不需要配对——BLE广播本身就是一种无连接的通信方式谁在范围内谁就能收到。这样一来门磁的安装位置就彻底自由了只要塞得下一块开发板和电池贴哪儿都行。为什么选ESP32-S3而不是更便宜的ESP32-C3或者老款ESP32几个实际考量。第一S3的GPIO数量更多虽然这个项目只用一个引脚读门磁但如果你后续想扩展温湿度、蜂鸣器、LED指示灯S3的余量更足。第二S3支持BLE 5.0广播包可以携带更多数据虽然门磁状态只需要1个bit但如果你想把设备名、电量、时间戳一起塞进广播里BLE 5.0的扩展广播会方便很多。第三S3的深度睡眠电流控制得不错配合门磁的常闭/常开特性可以做到“门一动才唤醒”这对电池供电的场景非常关键。整体架构分三块感知层是门磁开关接在ESP32-S3的某个GPIO上配置内部上拉或下拉通过电平变化判断门的状态处理层是ESP32-S3固件负责去抖、状态编码、BLE广播的组装和发送接收层可以是手机上的BLE调试App、另一块ESP32、或者树莓派上的Python脚本负责扫描广播并解析出“门开了”还是“门关了”。这套方案解决的核心问题是在没有Wi-Fi、没有云平台、没有配对流程的前提下把门磁状态以最低功耗、最低延迟的方式传递出去。适合谁参考做智能家居DIY的爱好者、需要临时布防的租房场景、以及想学习BLE广播底层用法的嵌入式初学者。你不需要懂蓝牙协议栈的每一层但需要会Arduino的基本操作知道怎么点灯、怎么读按键剩下的我来补。2. 核心细节解析与实操要点2.1 门磁开关的电气特性与GPIO配置门磁开关本质上是一个常闭型簧片开关。门关着的时候磁铁靠近簧片吸合两端导通门一开磁铁远离簧片弹开两端断开。也有常开型的逻辑反过来但市面上大部分门窗磁都是常闭型。这意味着如果你把开关一端接GND另一端接GPIO并开启内部上拉那么门关时GPIO读到低电平门开时读到高电平。这个逻辑要在代码里对应好否则会出现“门关了显示开”的尴尬。ESP32-S3的GPIO内部上拉电阻典型值在45kΩ左右对于门磁这种纯机械触点来说完全够用。但有一个坑长导线会引入天线效应。如果你把门磁的引线拉得很长比如超过半米导线会像天线一样拾取环境中的电磁噪声导致GPIO读数抖动。解决办法有两个一是在GPIO和GND之间并一个100nF的陶瓷电容硬件去抖二是在代码里做软件去抖连续采样多次确认状态稳定后再上报。我一般两个都做硬件电容滤高频噪声软件去抖滤机械抖动。注意ESP32-S3的GPIO0到GPIO48并不是所有都能随便用。GPIO0是启动模式引脚上电时如果被拉低会进入下载模式所以门磁不要接GPIO0。GPIO19和GPIO20是USB D/D-如果你要用USB串口调试也别占用。推荐用GPIO4、GPIO5、GPIO6这类“干净”的引脚。2.2 BLE广播的数据结构设计BLE广播包的核心限制是31字节传统广播或255字节扩展广播。门磁状态只需要1个bit但你不能只发1个bit广播包里必须包含有意义的字段让接收端识别。我设计的广播数据结构是这样的Flags字段3字节固定值0x02 0x01 0x06表示设备支持BLE且可被发现。设备名称可变长度比如“DoorSensor-01”方便接收端过滤。厂商自定义数据包含门磁状态、电池电压、序列号。状态用1字节表示0x00为关门0x01为开门电池电压用2字节单位毫伏序列号用2字节用于区分多个门磁。为什么不用标准GATT服务而用广播因为GATT需要连接连接意味着配对、握手、维持连接功耗和延迟都上去了。广播是无连接的ESP32-S3发完就睡接收端扫到就处理延迟可以做到几十毫秒以内。对于门磁这种“事件驱动”的场景广播是更合适的选择。2.3 低功耗策略与唤醒机制如果ESP32-S3一直开着BLE广播电流大概在几十毫安级别一块2000mAh的电池撑不过两天。所以必须做低功耗。我的策略是门磁状态不变时ESP32-S3进入深度睡眠门磁状态变化时通过外部中断唤醒发送广播然后继续睡。ESP32-S3的深度睡眠电流可以做到10μA左右具体取决于你关闭了哪些外设。门磁开关接在GPIO上配置为任意电平变化唤醒。门一开GPIO电平跳变触发唤醒ESP32-S3启动BLE广播发送当前状态然后重新配置中断并进入睡眠。整个过程大概几百毫秒平均电流可以压到1mA以下一块2000mAh的电池能撑几个月。实操心得深度睡眠唤醒后BLE协议栈需要重新初始化这个过程大概需要100到200毫秒。如果你对延迟极其敏感可以考虑用轻睡眠代替深度睡眠保留BLE协议栈的状态但功耗会高一些大概在1mA到5mA之间。根据你的电池容量和可接受的延迟来权衡。3. 实操过程与核心环节实现3.1 硬件连接与开发环境搭建先列一下物料清单物料型号/规格数量备注主控板ESP32-S3开发板1推荐带USB-C和电池接口的版本门磁开关常闭型簧片开关1含磁铁引线长度按需电池18650锂电池12000mAh以上电池座18650单节电池座1带引线电容100nF陶瓷电容1用于硬件去抖电阻10kΩ1可选外部上拉接线很简单门磁开关一端接GND另一端接GPIO4同时在GPIO4和GND之间并上100nF电容。电池正极接开发板的VBAT或5V引脚取决于开发板是否带稳压负极接GND。开发环境用Arduino IDE。如果你还没装ESP32-S3的支持包在“首选项”的“附加开发板管理器网址”里加上Espressif的官方地址然后在开发板管理器里搜索“esp32”并安装。安装完成后在开发板列表里选“ESP32S3 Dev Module”。有几个参数要注意USB CDC On Boot设为“Enabled”这样串口监视器才能看到输出。Flash Size根据你的开发板选一般是4MB或8MB。Partition Scheme选“Default 4MB with spiffs”就行。Upload Speed921600快且稳。注意如果你用的是某些国产ESP32-S3开发板可能需要手动按住BOOT键再点上传否则会一直等待。这是自动下载电路设计差异导致的不是代码问题。3.2 固件代码结构与关键实现代码分几个模块BLE广播初始化、GPIO中断配置、深度睡眠管理、状态编码。先看BLE广播部分。Arduino的ESP32 BLE库提供了BLEAdvertising类但它的默认广播包结构比较固定要插入自定义数据需要手动构造原始广播数据。我试过两种方式一种是用BLEAdvertisementData的addData方法另一种是直接操作esp_ble_gap_config_adv_data_raw。前者简单但灵活性差后者复杂但完全可控。这个项目里我用前者因为数据量不大。#include BLEDevice.h #include BLEUtils.h #include BLEAdvertising.h BLEAdvertising *pAdvertising; void setupBLE() { BLEDevice::init(DoorSensor-01); pAdvertising BLEDevice::getAdvertising(); BLEAdvertisementData advData; advData.setFlags(0x06); advData.setName(DoorSensor-01); // 自定义数据状态(1B) 电池电压(2B) 序列号(2B) uint8_t customData[5]; customData[0] doorState; // 0x00关门0x01开门 uint16_t batteryMv readBatteryVoltage(); customData[1] batteryMv 0xFF; customData[2] (batteryMv 8) 0xFF; customData[3] 0x01; // 序列号低字节 customData[4] 0x00; // 序列号高字节 advData.addData(std::string((char*)customData, 5)); pAdvertising-setAdvertisementData(advData); pAdvertising-start(); }GPIO中断和深度睡眠的配合是另一个关键点。ESP32-S3的深度睡眠唤醒源可以配置为EXT0或EXT1。EXT0只支持一个引脚EXT1支持多个引脚。门磁只用了一个引脚所以EXT0就够了。#define DOOR_PIN 4 void setup() { pinMode(DOOR_PIN, INPUT_PULLUP); esp_sleep_enable_ext0_wakeup((gpio_num_t)DOOR_PIN, 1); // 高电平唤醒 // 读取当前状态并广播 doorState digitalRead(DOOR_PIN); setupBLE(); delay(500); // 等待广播发送完成 esp_deep_sleep_start(); }这里有个细节esp_sleep_enable_ext0_wakeup的第二个参数是唤醒电平。门关时GPIO为低门开时GPIO为高所以设为1表示高电平唤醒。但如果你希望门开和门关都能唤醒就需要用EXT1并配置为任意电平变化。EXT1的配置稍微麻烦一点需要构造一个位掩码。esp_sleep_enable_ext1_wakeup(1ULL DOOR_PIN, ESP_EXT1_WAKEUP_ANY_HIGH);实操心得深度睡眠唤醒后setup()会从头执行一遍。这意味着BLE协议栈会重新初始化广播会重新开始。如果你在setup()里加了串口打印每次唤醒都会输出一堆调试信息电池供电时建议关掉串口或者用条件编译控制。3.3 接收端实现与状态解析接收端我用的是另一块ESP32-S3跑一个BLE扫描程序扫到“DoorSensor-01”的广播后解析自定义数据然后通过串口打印或者点亮LED。如果你用手机可以装一个通用的BLE调试App比如“nRF Connect”或者“BLE Scanner”它们能直接显示广播包里的原始字节。接收端的扫描代码核心是BLEScan类#include BLEDevice.h #include BLEScan.h BLEScan *pBLEScan; class MyAdvertisedDeviceCallbacks : public BLEAdvertisedDeviceCallbacks { void onResult(BLEAdvertisedDevice device) { if (device.haveName() device.getName() DoorSensor-01) { std::string data device.getManufacturerData(); if (data.length() 5) { uint8_t state data[0]; uint16_t batteryMv data[1] | (data[2] 8); Serial.printf(门状态: %s, 电池: %dmV\n, state ? 开 : 关, batteryMv); } } } }; void setup() { Serial.begin(115200); BLEDevice::init(); pBLEScan BLEDevice::getScan(); pBLEScan-setAdvertisedDeviceCallbacks(new MyAdvertisedDeviceCallbacks()); pBLEScan-setActiveScan(true); pBLEScan-start(0); // 持续扫描 }这里有个坑getManufacturerData()返回的是厂商自定义数据但如果你在广播里用的是addData而不是setManufacturerData接收端可能拿不到。我实测下来用addData添加的数据在nRF Connect里能看到但在Arduino的BLEAdvertisedDevice里需要用getPayload()或者直接解析原始广播包。为了省事我建议用setManufacturerData它的格式是“公司ID(2字节) 自定义数据”接收端用getManufacturerData()就能直接拿到自定义部分。4. 常见问题与排查技巧实录4.1 广播发不出去或者接收端扫不到这是最常见的问题原因通常有三个。第一广播包超长。传统BLE广播包限制31字节如果你塞了太多数据协议栈会静默丢弃或者截断。检查方法用nRF Connect看广播包的实际长度如果接近31字节精简数据。第二设备名称太长。名称本身占广播包空间建议控制在8个字符以内。第三接收端扫描参数不对。setActiveScan(true)会发送扫描请求能拿到更多数据但功耗更高。如果接收端是电池供电可以设为false但可能拿不到扫描响应里的数据。排查步骤先用手机App确认ESP32-S3确实在广播如果手机能扫到但你的接收端扫不到问题在接收端代码如果手机也扫不到问题在发送端。4.2 深度睡眠唤醒后程序跑飞ESP32-S3从深度睡眠唤醒后相当于一次软复位所有变量都会重新初始化。如果你在全局变量里保存了门状态唤醒后它会变成默认值。解决办法是用RTC_DATA_ATTR修饰需要跨睡眠保持的变量RTC_DATA_ATTR uint8_t lastDoorState 0xFF;RTC_DATA_ATTR会把变量放在RTC内存里深度睡眠期间不掉电。但注意RTC内存容量有限别放太大的数组。另一个可能的原因是唤醒源配置冲突。如果你同时配置了EXT0和EXT1或者配置了定时唤醒和外部唤醒唤醒后需要检查esp_sleep_get_wakeup_cause()来确定是谁唤醒的否则可能进入错误的逻辑分支。4.3 门磁抖动导致误报机械开关在闭合和断开瞬间会有几十微秒到几毫秒的抖动如果代码里直接读电平就上报会出现一次开门上报好几次的情况。软件去抖的常规做法是连续采样多次比如间隔10ms采样5次如果5次电平一致才确认状态变化。但深度睡眠场景下唤醒后只采样一次就广播没法做多次采样。我的做法是唤醒后先延时20ms再读电平然后再延时20ms再读一次两次一致才广播。这样虽然增加了40ms的延迟但能滤掉大部分抖动。避坑技巧如果你用的是常闭型门磁门关时GPIO为低门开时GPIO为高。但有些门磁的引线颜色不标准红色不一定是正极。接线前用万用表蜂鸣档测一下门关时导通的那两根线就是你要接的。4.4 电池电压读取不准ESP32-S3的ADC精度一般直接读电池电压误差可能在±5%以上。如果你只是粗略估计电量够用如果要精确显示需要做校准。我的做法是用万用表测出实际电池电压然后读ADC原始值算出一个校准系数在代码里做线性补偿。另外ADC的参考电压会随温度漂移如果设备工作在室外冬天和夏天的读数会差几十毫伏。问题现象可能原因排查方法解决方案手机扫不到广播广播包超长用nRF Connect看包长精简数据名称控制在8字符内接收端扫不到但手机能扫到接收端扫描参数不对检查setActiveScan和扫描窗口设为主动扫描窗口调大唤醒后程序跑飞变量未保存在RTC内存检查全局变量是否加RTC_DATA_ATTR加RTC_DATA_ATTR修饰一次开门上报多次机械抖动示波器看GPIO波形硬件加电容软件延时二次确认电池电压读数偏差大ADC未校准万用表对比实际电压加校准系数避免极端温度5. 扩展玩法与个人经验补充这套基础框架跑通之后能扩展的方向不少。比如多门磁组网每个门磁用不同的序列号接收端根据序列号区分是前门还是后门。广播包里加一个字节的序列号就行不需要额外硬件。再比如状态历史记录接收端把每次状态变化带上时间戳存到SD卡或者发送到本地服务器就能做简单的出入记录。ESP32-S3的RTC内存里可以存几条最近的状态唤醒后一起广播出去接收端按顺序解析。还有一个实用技巧用LED做状态指示。ESP32-S3开发板上通常有一颗板载LED接在GPIO48或者别的引脚上。唤醒后点亮LED 100ms再熄灭这样你调试的时候能直观看到设备有没有工作。但注意LED本身耗电电池供电时建议只在调试阶段开启。我个人在实际操作中的体会是BLE广播的可靠性比想象中好但天线布局很关键。ESP32-S3的板载天线对方向敏感如果你把开发板贴在金属门框上广播距离会大幅缩短。解决办法是把开发板远离金属或者用外接天线版本。另外广播间隔不要设得太短1秒一次足够了太短反而增加功耗和信道拥堵。最后分享一个小技巧如果你手头没有第二块ESP32做接收端可以用树莓派或者Linux电脑上的hcitool和btmon来扫描BLE广播。btmon能直接解析广播包内容调试的时候比手机App更方便因为能看到原始字节流。命令是sudo btmon然后另开一个终端跑sudo hcitool lescan广播包就会实时打印出来。
