1. 项目概述一个“过剩”但极具学习价值的智能温度计几年前我做过一个基于ATTINY85的极简温度计一节电池能撑140天现在还在我窗台上默默工作。它很省电但说实话功能也仅限于“显示温度”无论是硬件焊接还是程序烧录对新手都不太友好。这次我想做个不一样的——一个功能“过剩”的智能温度计。它集成了Wi-Fi、WebSocket实时推流、自动休眠、网页控制甚至自带USB编程和充电电路。听起来用牛刀杀鸡没错但正是这种“过剩”能让我们把嵌入式开发、物联网通信、PCB设计、功耗优化这些关键环节都亲手摸一遍。这个项目的核心是ESP-01FWi-Fi模块和WebSocket协议。ESP-01F负责连接网络并运行一个微型Web服务器而WebSocket则负责在设备和你的浏览器之间建立一条“双向高速公路”让温度数据能像聊天消息一样实时推送过去无需页面刷新。整个设备由一块定制PCB承载上面除了ESP-01F还集成了CP2102 USB转串口芯片用于编程、TP4056锂电池充电管理芯片、一个物理按键、一个0.91英寸OLED屏以及DS18B20温度传感器探头。最终成品你只需要按一下按钮它就会创建一个Wi-Fi热点你用手机或电脑连上打开浏览器就能看到一个实时更新温度曲线的网页还能远程控制它休眠。对于想从点灯、测温迈入真正物联网设备开发的朋友来说这个项目就像一份浓缩的“实战手册”。2. 核心硬件选型与设计思路拆解2.1 为什么是ESP-01F不仅仅是Wi-Fi在众多ESP8266模块中选择ESP-01F而非更常见的ESP-12F或NodeMCU开发板主要基于以下几点考量尺寸与集成度ESP-01F的尺寸极小约25mm x 14mm非常适合嵌入到对空间有严格限制的最终产品中。它已经包含了必要的晶振和Flash外围电路极其简单。Flash容量相比老旧的ESP-01通常512KBESP-01F标配1MB1024KB的Flash。这个容量对于存储Web服务器代码、WebSocket库、驱动OLED和传感器的程序来说游刃有余。我实测在包含所有功能并启用OTA空中升级选项后固件大小约在400KB左右仍有充足空间。成本与引脚它价格低廉且引出了足够用的GPIO。对于本项目我们只需要用到两个GPIO用于I2C驱动OLEDSCL, SDA一个GPIO用于单总线驱动DS18B20一个GPIO用于控制模块的EN/CH_PD引脚以实现硬重启或深度睡眠唤醒。ESP-01F的引脚刚好够用。注意ESP-01F没有板载USB转串口也没有复位和Flash模式按钮这是它作为独立模块的“缺点”但也是我们设计PCB时必须解决的问题。2.2 关键外围电路设计从“能用”到“好用”一个产品化的原型不能总是依赖外接的USB-TTL模块和手动接线来编程。我的设计目标是插上Micro USB线既能充电也能编程。CP2102 USB转串口电路选型理由相比CH340CP2102在macOS和Linux下的驱动兼容性通常更好相比FT232RL它的价格和封装SSOP-28更友好。其内置的时钟源和电平转换器使得电路非常简洁。核心设计自动下载电路这是精髓。通过一个NPN三极管如BC817和几个电阻我们利用CP2102的DTR和RTS信号自动控制ESP-01F的GPIO0和RST引脚使其在上传代码时自动进入下载模式。原理是Arduino IDE在上传前会控制DTR和RTS产生特定的电平序列这个电路将其转换为对ESP-01F的复位和模式选择信号。这样用户只需在IDE里点击“上传”无需手动按任何按钮。电平匹配CP2102的IO电压是3.3V与ESP-01F完美匹配无需额外电平转换。TP4056锂电池充电与管理电路作用为项目中的3.7V锂电池提供完整的充电管理恒流/恒压、充电状态指示红灯充电、绿灯充满和电池保护防止过放。设计要点充电电流设置通过PROG引脚对地的电阻Rprog来设定。公式为I_{CHG} 1200V / R_{prog}。例如对于150mAh的小电池选择约1.2KΩ的电阻充电电流约为1A1200/1.21000mA。但这里要注意1C150mA充电对电池寿命更友好。我选择了10KΩ电阻充电电流约为120mA属于慢充但更安全。电源路径TP4056的OUT引脚直接连接到后续的3.3V稳压电路的输入。这样有USB时由USB供电并给电池充电无USB时由电池供电。实现了无感切换。3.3V稳压电路ESP-01F和所有外围芯片OLED、DS18B20都需要3.3V供电。我选用了一颗低压差的线性稳压器LDO如AMS1117-3.3。其输入来自TP4056的输出电池电压约3.7V-4.2V。LDO能提供稳定、干净的3.3V电压尽管效率不如DCDC但电路简单噪声小。关键计算在最坏情况电池电压3.7V输出3.3V下LDO的压差为0.4V。假设系统峰值电流200mA则LDO上的功耗为P (V_{in} - V_{out}) * I 0.4V * 0.2A 0.08W。这个功耗在可接受范围内AMS1117的SOT-223封装足以散热。2.3 PCB布局的“坑”与技巧PCB设计是硬件项目的骨架布局不当会导致性能下降甚至无法工作。天线净空区ESP-01F的Wi-Fi天线是PCB上的一个倒F形走线。在PCB布局时必须在其周围尤其是天线区域下方和相邻层严格禁止铺设任何铜皮或走线。这被称为“净空区”。我的做法是在天线区域对应的所有层Top和Bottom都放置一个禁止布线区Keep-Out Layer确保天线性能不受干扰。电源去耦在ESP-01F的VCC引脚附近1cm以内必须放置一个10uF的钽电容或电解电容并联一个0.1uF的陶瓷电容。前者应对模块发射Wi-Fi信号时的瞬时大电流需求后者滤除高频噪声。这个细节直接关系到系统稳定性很多莫名其妙的复位都是这里没做好。OLED接口的“反向”问题这是我踩过的坑。我在PCB上设计了排母来插接OLED模块但画封装时把方向搞反了。补救方案不要强行掰弯引脚很容易损坏模块。我用四根细导线飞线将OLED的VCC, GND, SCL, SDA直接焊接到PCB正确的焊盘上然后用热熔胶固定OLED模块。虽然不完美但可靠。3. 软件架构与核心代码实现3.1 开发环境与库依赖项目在Arduino IDE中进行开发。你需要安装以下支持包和库开发板管理在“首选项”的附加开发板管理器网址中添加http://arduino.esp8266.com/stable/package_esp8266com_index.json。然后在开发板管理器中搜索安装“esp8266”。库安装通过库管理器安装以下库Adafruit_SSD1306和Adafruit_GFX用于驱动OLED显示屏。DallasTemperature和OneWire用于驱动DS18B20温度传感器。ESP8266WiFi核心Wi-Fi功能已包含在开发板包中。ESPAsyncTCP和ESPAsyncWebServer这是关键我们使用异步Web服务器库它能高效处理并发连接并且原生支持WebSocket。3.2 核心程序流程解析整个固件的逻辑围绕“低功耗”和“实时通信”两个核心展开。#include ESPAsyncWebServer.h #include WebSocketsServer.h #include ESP8266WiFi.h // ... 其他库 // 全局对象 AsyncWebServer server(80); // HTTP服务器端口80 WebSocketsServer webSocket WebSocketsServer(81); // WebSocket服务器端口81 bool clientConnected false; unsigned long lastActivityTime 0; const long ACTIVITY_TIMEOUT 60000; // 无操作60秒后休眠 void setup() { Serial.begin(115200); // 1. 初始化硬件OLED, 传感器 initHardware(); // 2. 启动Wi-Fi接入点AP模式 WiFi.mode(WIFI_AP); WiFi.softAP(SmartThermometer, NULL); // 设置AP名称无密码 // 3. 设置HTTP路由 server.on(/, HTTP_GET, [](AsyncWebServerRequest *request){ request-send(SPIFFS, /index.html, text/html); // 从SPIFFS文件系统发送网页 }); server.on(/style.css, HTTP_GET, [](AsyncWebServerRequest *request){ request-send(SPIFFS, /style.css, text/css); }); server.on(/script.js, HTTP_GET, [](AsyncWebServerRequest *request){ request-send(SPIFFS, /script.js, application/javascript); }); server.begin(); // 4. 启动WebSocket服务器并绑定事件处理函数 webSocket.begin(); webSocket.onEvent(webSocketEvent); // 5. 显示设备IP地址到OLED方便用户连接 displayIP(WiFi.softAPIP().toString()); lastActivityTime millis(); // 重置活动计时器 } void loop() { webSocket.loop(); // 必须持续调用以处理WebSocket事件 // 定期读取温度并发送给已连接的WebSocket客户端 static unsigned long lastSensorRead 0; if (millis() - lastSensorRead 2000) { // 每2秒读一次 float temp readTemperature(); displayTemperature(temp); // 更新OLED // 如果有WebSocket客户端连接则推送数据 if (clientConnected) { String jsonData {\temp\: String(temp, 1) }; webSocket.broadcastTXT(jsonData); // 广播给所有客户端 lastActivityTime millis(); // 有数据活动重置休眠计时器 } lastSensorRead millis(); } // 超时检测如果超过设定时间无客户端连接或无数据进入深度睡眠 if (millis() - lastActivityTime ACTIVITY_TIMEOUT) { goToDeepSleep(); } } void webSocketEvent(uint8_t num, WStype_t type, uint8_t * payload, size_t length) { switch(type) { case WStype_CONNECTED: clientConnected true; lastActivityTime millis(); // 新客户端连接重置计时器 break; case WStype_DISCONNECTED: clientConnected false; break; case WStype_TEXT: // 处理从网页发来的指令例如 SLEEP if (strcmp((char*)payload, SLEEP) 0) { goToDeepSleep(); } lastActivityTime millis(); // 收到指令重置计时器 break; } } void goToDeepSleep() { display.clearDisplay(); display.display(); // 关闭OLED显示 // 将唤醒引脚GPIO16连接到RST引脚并通过此唤醒 ESP.deepSleep(0); // 参数为0表示无限期睡眠直到外部复位 // 实际代码中我们用一个物理按钮连接RST和GND按下按钮相当于给RST一个低电平唤醒设备 }代码要点解析异步服务器优势ESPAsyncWebServer不会阻塞loop()函数。传统的ESP8266WebServer需要你在loop()中不断调用handleClient()且在处理请求时会阻塞。异步库则通过回调函数处理请求效率高得多。SPIFFS文件系统网页文件HTML, CSS, JS通过Arduino IDE的“ESP8266 Sketch Data Upload”工具上传到模块的Flash中SPIFFS分区。这样网页代码就固化在设备里无需额外服务器。WebSocket通信端口81的WebSocket服务器负责实时数据。当有浏览器客户端通过JavaScript连接后服务器便可以通过broadcastTXT()主动推送数据。网页上的“睡眠”按钮点击后会通过WebSocket发送“SLEEP”指令设备收到后执行休眠函数。深度睡眠唤醒ESP8266深度睡眠后消耗电流极低约20uA。唤醒方式有多种本项目采用最简单的“外部复位唤醒”。将ESP-01F的GPIO16D0引脚连接到RST引脚。在深度睡眠前将GPIO16设置为低电平并保持睡眠结束后内部计时器会将GPIO16拉高从而产生一个上升沿触发RST复位实现唤醒。但我们这里用了更直接的方法物理按钮直接短接RST到GND进行手动唤醒。3.3 网页前端简陋但有效的实时图表网页端不使用任何复杂框架只用纯HTML/CSS/JS。index.html (核心部分):!DOCTYPE html html body h1智能温度计实时监控/h1 div当前温度: span idtemperature--/span °C/div canvas idtempChart width800 height400/canvas br button onclicksendSleepCommand()让设备休眠/button script const ws new WebSocket(ws:// window.location.hostname :81/); const ctx document.getElementById(tempChart).getContext(2d); // 使用Chart.js库绘制实时曲线图 const chart new Chart(ctx, { /* 配置项 */ }); ws.onmessage function(event) { const data JSON.parse(event.data); document.getElementById(temperature).textContent data.temp.toFixed(1); // 更新图表 chart.data.labels.push(new Date().toLocaleTimeString()); chart.data.datasets[0].data.push(data.temp); if (chart.data.labels.length 20) { // 只保留最近20个点 chart.data.labels.shift(); chart.data.datasets[0].data.shift(); } chart.update(); }; function sendSleepCommand() { if (ws.readyState WebSocket.OPEN) { ws.send(SLEEP); alert(休眠指令已发送); } } /script !-- 引入Chart.js库 -- script srchttps://cdn.jsdelivr.net/npm/chart.js/script /body /html实操心得网页文件不宜过大。Chart.js库我们通过CDN引入而不是放在SPIFFS里节省了宝贵的Flash空间。网页的逻辑很简单建立WebSocket连接监听消息更新DOM和图表提供一个发送休眠指令的按钮。4. 功耗实测与优化策略功耗是电池供电设备的生命线。我们为这个“功能过剩”的设备付出了多少代价4.1 各状态功耗测量使用高精度万用表串联在电池供电回路中测量不同工作模式下的电流工作状态测量电流主要耗电单元说明深度睡眠~1.8 mACP2102, TP4056, LDO静态电流远高于ESP-01F本身的20uA外围电路是耗电大户。Wi-Fi AP模式空闲~70 mAESP-01F (RF发射)模块启动创建热点但无客户端连接。Wi-Fi AP模式有1客户端连接~93 mAESP-01F (RF发射/接收)有设备连接到热点射频活动增加。OLED全亮显示增加 ~10-20 mAOLED屏幕屏幕亮度越高电流越大。4.2 功耗分析与优化空间深度睡眠功耗过高1.8mA理想情况应低于100uA。问题主要出在CP2102即使USB未连接其VCC引脚仍由电池供电存在静态电流。TP4056在电池供电模式下其自身存在一定的静态消耗。AMS1117 LDO存在约5mA的静态电流Quiescent Current。优化方案对于产品化设计可以增加一个由ESP-01F GPIO控制的MOSFET开关电路在进入深度睡眠前彻底切断CP2102、TP4056除保护电路外等外围芯片的供电只保留ESP-01F和唤醒电路的供电。这能将睡眠电流拉低到接近ESP-01F本身的20uA水平。工作电流大ESP-01F在射频工作时电流峰值可达200mA平均70-90mA是正常范围。对于150mAh的电池理论持续工作时间仅约1.5-2小时。优化方向缩短工作时间进一步减少ACTIVITY_TIMEOUT比如从60秒改为30秒。使用STA模式如果环境有现成Wi-Fi让设备连接路由器STA模式并定时向服务器发送数据然后迅速休眠。这比维持一个AP要省电因为AP需要持续广播信标帧。降低发射功率通过WiFi.setOutputPower(10.5)可以降低RF功率减少耗电但会牺牲连接距离。重要提示功耗优化是一个系统工程需要在功能、用户体验和续航之间取得平衡。本项目的主要目标是演示功能集成因此接受了当前功耗水平。若追求长续航应优先考虑使用专为低功耗设计的蓝牙模块如BLE而非Wi-Fi。5. 组装、调试与问题排查实录5.1 3D打印外壳设计与组装外壳设计遵循“无紧固件”原则通过卡扣和摩擦力固定。设计要点上下盖定位设计榫卯结构或定位柱确保PCB位置准确。按钮开孔预留孔位让物理按钮微动开关露出。传感器开孔为DS18B20的探头线留出通道。散热与天线避免金属部件靠近ESP-01F的PCB天线区域。外壳最好使用非屏蔽材料如PLA。USB接口开口精确对准Micro USB端口。打印设置材料PLA强度更好。层高0.2mm平衡精度与速度。填充20%提供足够强度。支撑对于悬空结构如卡扣内部需要开启支撑。组装时先将电池用双面胶固定在下壳内然后放入PCB最后扣上上盖。确保按钮手感清晰USB插拔顺畅。5.2 典型问题与解决方案速查表在开发过程中你几乎一定会遇到以下问题。这里是我的排查笔记现象可能原因排查步骤与解决方案上电无反应OLED不亮1. 电源问题2. 焊接短路/虚焊1. 用万用表测量TP4056输出端是否有~4V电压AMS1117输出端是否为3.3V。2. 检查电池是否已充电USB线是否供电正常。3. 仔细检查PCB特别是电源路径VCC/GND有无短路或断路。重点查LDO和电容。Arduino IDE无法上传程序1. 驱动未安装2. 自动下载电路失效3. 板型/端口选择错误1. 确认电脑已安装CP2102驱动可从Silicon Labs官网下载。2. 尝试手动进入下载模式按住PCB上的“FLASH”按钮GPIO0拉低再按一下“RST”按钮然后释放“FLASH”。3. 在IDE中选择开发板为“Generic ESP8266 Module”Flash Mode为“DIO”Flash Size为“1M (64K SPIFFS)”端口选择正确的COM口。能上传程序但运行后无法创建Wi-Fi热点1. 程序错误2. SPIFFS文件未上传3. 天线问题1. 打开串口监视器波特率115200查看启动日志。ESP会打印IP地址等信息。2. 确保已通过“工具”-“ESP8266 Sketch Data Upload”上传了网页文件到SPIFFS。3. 检查PCB上天线区域是否被金属外壳遮挡或有无异物短路。网页能打开但WebSocket连接失败无实时数据1. 防火墙/安全软件拦截2. 网页JS代码端口错误3. ESP代码中WebSocket未启动1. 尝试关闭电脑防火墙或杀毒软件临时测试。2. 检查浏览器控制台F12的报错信息。确认JS中WebSocket连接的端口号81与代码中一致。3. 在串口日志中确认webSocket.begin()已执行。设备发热严重1. LDO或CP2102短路2. 持续大电流工作1. 立即断电用手触摸找出发热芯片检查其引脚焊接是否有桥接。2. 如果只是温热可能是Wi-Fi持续全功率发射导致属于正常现象但应优化代码使其尽快进入睡眠。深度睡眠后无法通过按钮唤醒1. 唤醒电路连接错误2. 代码中深度睡眠配置有误1. 确认物理按钮连接在RST和GND之间。按下按钮应导致RST引脚被拉低产生复位信号。2. 确保在goToDeepSleep()函数中没有将用于唤醒的GPIO如GPIO16设置为高阻态或输出高电平这可能会干扰复位电路。5.3 最后的个人体会做完这个项目我最大的感触是从模块堆叠到集成PCB设计是业余爱好者和初级开发者迈向“做产品”思维的关键一步。过程中你会被迫考虑电源完整性、信号完整性、可制造性、可测试性和用户体验。比如那个自动下载电路就为了省去用户手动按按钮的麻烦比如集成充电就是为了让设备更像一个完整的商品。ESP-01F和WebSocket的组合为微型物联网设备打开了一扇门。虽然它的功耗在电池场景下是个挑战但在许多有源供电的场景如智能家居传感器、工业监测点里它提供的网络能力和实时性是非常宝贵的。这个项目里用到的异步服务器、SPIFFS、深度睡眠这些技术都是ESP8266/ESP32生态中的核心技能。如果你也想动手我的建议是先不要追求一次完美。可以用面包板把核心功能ESP-01FDS18B20OLED跑通写出能WebSocket推送数据的代码。然后再用EDA软件比如立创EDA画一个最小系统的PCB只包含ESP-01F、CP2102和必要的电阻电容去打样试试。一步步来每步踩的坑都会变成实实在在的经验。这个“过剩”的温度计最终带给你的远不止一个能显示温度的装置。
基于ESP-01F与WebSocket的智能温度计：物联网开发实战指南
发布时间：2026/6/2 22:07:29
1. 项目概述一个“过剩”但极具学习价值的智能温度计几年前我做过一个基于ATTINY85的极简温度计一节电池能撑140天现在还在我窗台上默默工作。它很省电但说实话功能也仅限于“显示温度”无论是硬件焊接还是程序烧录对新手都不太友好。这次我想做个不一样的——一个功能“过剩”的智能温度计。它集成了Wi-Fi、WebSocket实时推流、自动休眠、网页控制甚至自带USB编程和充电电路。听起来用牛刀杀鸡没错但正是这种“过剩”能让我们把嵌入式开发、物联网通信、PCB设计、功耗优化这些关键环节都亲手摸一遍。这个项目的核心是ESP-01FWi-Fi模块和WebSocket协议。ESP-01F负责连接网络并运行一个微型Web服务器而WebSocket则负责在设备和你的浏览器之间建立一条“双向高速公路”让温度数据能像聊天消息一样实时推送过去无需页面刷新。整个设备由一块定制PCB承载上面除了ESP-01F还集成了CP2102 USB转串口芯片用于编程、TP4056锂电池充电管理芯片、一个物理按键、一个0.91英寸OLED屏以及DS18B20温度传感器探头。最终成品你只需要按一下按钮它就会创建一个Wi-Fi热点你用手机或电脑连上打开浏览器就能看到一个实时更新温度曲线的网页还能远程控制它休眠。对于想从点灯、测温迈入真正物联网设备开发的朋友来说这个项目就像一份浓缩的“实战手册”。2. 核心硬件选型与设计思路拆解2.1 为什么是ESP-01F不仅仅是Wi-Fi在众多ESP8266模块中选择ESP-01F而非更常见的ESP-12F或NodeMCU开发板主要基于以下几点考量尺寸与集成度ESP-01F的尺寸极小约25mm x 14mm非常适合嵌入到对空间有严格限制的最终产品中。它已经包含了必要的晶振和Flash外围电路极其简单。Flash容量相比老旧的ESP-01通常512KBESP-01F标配1MB1024KB的Flash。这个容量对于存储Web服务器代码、WebSocket库、驱动OLED和传感器的程序来说游刃有余。我实测在包含所有功能并启用OTA空中升级选项后固件大小约在400KB左右仍有充足空间。成本与引脚它价格低廉且引出了足够用的GPIO。对于本项目我们只需要用到两个GPIO用于I2C驱动OLEDSCL, SDA一个GPIO用于单总线驱动DS18B20一个GPIO用于控制模块的EN/CH_PD引脚以实现硬重启或深度睡眠唤醒。ESP-01F的引脚刚好够用。注意ESP-01F没有板载USB转串口也没有复位和Flash模式按钮这是它作为独立模块的“缺点”但也是我们设计PCB时必须解决的问题。2.2 关键外围电路设计从“能用”到“好用”一个产品化的原型不能总是依赖外接的USB-TTL模块和手动接线来编程。我的设计目标是插上Micro USB线既能充电也能编程。CP2102 USB转串口电路选型理由相比CH340CP2102在macOS和Linux下的驱动兼容性通常更好相比FT232RL它的价格和封装SSOP-28更友好。其内置的时钟源和电平转换器使得电路非常简洁。核心设计自动下载电路这是精髓。通过一个NPN三极管如BC817和几个电阻我们利用CP2102的DTR和RTS信号自动控制ESP-01F的GPIO0和RST引脚使其在上传代码时自动进入下载模式。原理是Arduino IDE在上传前会控制DTR和RTS产生特定的电平序列这个电路将其转换为对ESP-01F的复位和模式选择信号。这样用户只需在IDE里点击“上传”无需手动按任何按钮。电平匹配CP2102的IO电压是3.3V与ESP-01F完美匹配无需额外电平转换。TP4056锂电池充电与管理电路作用为项目中的3.7V锂电池提供完整的充电管理恒流/恒压、充电状态指示红灯充电、绿灯充满和电池保护防止过放。设计要点充电电流设置通过PROG引脚对地的电阻Rprog来设定。公式为I_{CHG} 1200V / R_{prog}。例如对于150mAh的小电池选择约1.2KΩ的电阻充电电流约为1A1200/1.21000mA。但这里要注意1C150mA充电对电池寿命更友好。我选择了10KΩ电阻充电电流约为120mA属于慢充但更安全。电源路径TP4056的OUT引脚直接连接到后续的3.3V稳压电路的输入。这样有USB时由USB供电并给电池充电无USB时由电池供电。实现了无感切换。3.3V稳压电路ESP-01F和所有外围芯片OLED、DS18B20都需要3.3V供电。我选用了一颗低压差的线性稳压器LDO如AMS1117-3.3。其输入来自TP4056的输出电池电压约3.7V-4.2V。LDO能提供稳定、干净的3.3V电压尽管效率不如DCDC但电路简单噪声小。关键计算在最坏情况电池电压3.7V输出3.3V下LDO的压差为0.4V。假设系统峰值电流200mA则LDO上的功耗为P (V_{in} - V_{out}) * I 0.4V * 0.2A 0.08W。这个功耗在可接受范围内AMS1117的SOT-223封装足以散热。2.3 PCB布局的“坑”与技巧PCB设计是硬件项目的骨架布局不当会导致性能下降甚至无法工作。天线净空区ESP-01F的Wi-Fi天线是PCB上的一个倒F形走线。在PCB布局时必须在其周围尤其是天线区域下方和相邻层严格禁止铺设任何铜皮或走线。这被称为“净空区”。我的做法是在天线区域对应的所有层Top和Bottom都放置一个禁止布线区Keep-Out Layer确保天线性能不受干扰。电源去耦在ESP-01F的VCC引脚附近1cm以内必须放置一个10uF的钽电容或电解电容并联一个0.1uF的陶瓷电容。前者应对模块发射Wi-Fi信号时的瞬时大电流需求后者滤除高频噪声。这个细节直接关系到系统稳定性很多莫名其妙的复位都是这里没做好。OLED接口的“反向”问题这是我踩过的坑。我在PCB上设计了排母来插接OLED模块但画封装时把方向搞反了。补救方案不要强行掰弯引脚很容易损坏模块。我用四根细导线飞线将OLED的VCC, GND, SCL, SDA直接焊接到PCB正确的焊盘上然后用热熔胶固定OLED模块。虽然不完美但可靠。3. 软件架构与核心代码实现3.1 开发环境与库依赖项目在Arduino IDE中进行开发。你需要安装以下支持包和库开发板管理在“首选项”的附加开发板管理器网址中添加http://arduino.esp8266.com/stable/package_esp8266com_index.json。然后在开发板管理器中搜索安装“esp8266”。库安装通过库管理器安装以下库Adafruit_SSD1306和Adafruit_GFX用于驱动OLED显示屏。DallasTemperature和OneWire用于驱动DS18B20温度传感器。ESP8266WiFi核心Wi-Fi功能已包含在开发板包中。ESPAsyncTCP和ESPAsyncWebServer这是关键我们使用异步Web服务器库它能高效处理并发连接并且原生支持WebSocket。3.2 核心程序流程解析整个固件的逻辑围绕“低功耗”和“实时通信”两个核心展开。#include ESPAsyncWebServer.h #include WebSocketsServer.h #include ESP8266WiFi.h // ... 其他库 // 全局对象 AsyncWebServer server(80); // HTTP服务器端口80 WebSocketsServer webSocket WebSocketsServer(81); // WebSocket服务器端口81 bool clientConnected false; unsigned long lastActivityTime 0; const long ACTIVITY_TIMEOUT 60000; // 无操作60秒后休眠 void setup() { Serial.begin(115200); // 1. 初始化硬件OLED, 传感器 initHardware(); // 2. 启动Wi-Fi接入点AP模式 WiFi.mode(WIFI_AP); WiFi.softAP(SmartThermometer, NULL); // 设置AP名称无密码 // 3. 设置HTTP路由 server.on(/, HTTP_GET, [](AsyncWebServerRequest *request){ request-send(SPIFFS, /index.html, text/html); // 从SPIFFS文件系统发送网页 }); server.on(/style.css, HTTP_GET, [](AsyncWebServerRequest *request){ request-send(SPIFFS, /style.css, text/css); }); server.on(/script.js, HTTP_GET, [](AsyncWebServerRequest *request){ request-send(SPIFFS, /script.js, application/javascript); }); server.begin(); // 4. 启动WebSocket服务器并绑定事件处理函数 webSocket.begin(); webSocket.onEvent(webSocketEvent); // 5. 显示设备IP地址到OLED方便用户连接 displayIP(WiFi.softAPIP().toString()); lastActivityTime millis(); // 重置活动计时器 } void loop() { webSocket.loop(); // 必须持续调用以处理WebSocket事件 // 定期读取温度并发送给已连接的WebSocket客户端 static unsigned long lastSensorRead 0; if (millis() - lastSensorRead 2000) { // 每2秒读一次 float temp readTemperature(); displayTemperature(temp); // 更新OLED // 如果有WebSocket客户端连接则推送数据 if (clientConnected) { String jsonData {\temp\: String(temp, 1) }; webSocket.broadcastTXT(jsonData); // 广播给所有客户端 lastActivityTime millis(); // 有数据活动重置休眠计时器 } lastSensorRead millis(); } // 超时检测如果超过设定时间无客户端连接或无数据进入深度睡眠 if (millis() - lastActivityTime ACTIVITY_TIMEOUT) { goToDeepSleep(); } } void webSocketEvent(uint8_t num, WStype_t type, uint8_t * payload, size_t length) { switch(type) { case WStype_CONNECTED: clientConnected true; lastActivityTime millis(); // 新客户端连接重置计时器 break; case WStype_DISCONNECTED: clientConnected false; break; case WStype_TEXT: // 处理从网页发来的指令例如 SLEEP if (strcmp((char*)payload, SLEEP) 0) { goToDeepSleep(); } lastActivityTime millis(); // 收到指令重置计时器 break; } } void goToDeepSleep() { display.clearDisplay(); display.display(); // 关闭OLED显示 // 将唤醒引脚GPIO16连接到RST引脚并通过此唤醒 ESP.deepSleep(0); // 参数为0表示无限期睡眠直到外部复位 // 实际代码中我们用一个物理按钮连接RST和GND按下按钮相当于给RST一个低电平唤醒设备 }代码要点解析异步服务器优势ESPAsyncWebServer不会阻塞loop()函数。传统的ESP8266WebServer需要你在loop()中不断调用handleClient()且在处理请求时会阻塞。异步库则通过回调函数处理请求效率高得多。SPIFFS文件系统网页文件HTML, CSS, JS通过Arduino IDE的“ESP8266 Sketch Data Upload”工具上传到模块的Flash中SPIFFS分区。这样网页代码就固化在设备里无需额外服务器。WebSocket通信端口81的WebSocket服务器负责实时数据。当有浏览器客户端通过JavaScript连接后服务器便可以通过broadcastTXT()主动推送数据。网页上的“睡眠”按钮点击后会通过WebSocket发送“SLEEP”指令设备收到后执行休眠函数。深度睡眠唤醒ESP8266深度睡眠后消耗电流极低约20uA。唤醒方式有多种本项目采用最简单的“外部复位唤醒”。将ESP-01F的GPIO16D0引脚连接到RST引脚。在深度睡眠前将GPIO16设置为低电平并保持睡眠结束后内部计时器会将GPIO16拉高从而产生一个上升沿触发RST复位实现唤醒。但我们这里用了更直接的方法物理按钮直接短接RST到GND进行手动唤醒。3.3 网页前端简陋但有效的实时图表网页端不使用任何复杂框架只用纯HTML/CSS/JS。index.html (核心部分):!DOCTYPE html html body h1智能温度计实时监控/h1 div当前温度: span idtemperature--/span °C/div canvas idtempChart width800 height400/canvas br button onclicksendSleepCommand()让设备休眠/button script const ws new WebSocket(ws:// window.location.hostname :81/); const ctx document.getElementById(tempChart).getContext(2d); // 使用Chart.js库绘制实时曲线图 const chart new Chart(ctx, { /* 配置项 */ }); ws.onmessage function(event) { const data JSON.parse(event.data); document.getElementById(temperature).textContent data.temp.toFixed(1); // 更新图表 chart.data.labels.push(new Date().toLocaleTimeString()); chart.data.datasets[0].data.push(data.temp); if (chart.data.labels.length 20) { // 只保留最近20个点 chart.data.labels.shift(); chart.data.datasets[0].data.shift(); } chart.update(); }; function sendSleepCommand() { if (ws.readyState WebSocket.OPEN) { ws.send(SLEEP); alert(休眠指令已发送); } } /script !-- 引入Chart.js库 -- script srchttps://cdn.jsdelivr.net/npm/chart.js/script /body /html实操心得网页文件不宜过大。Chart.js库我们通过CDN引入而不是放在SPIFFS里节省了宝贵的Flash空间。网页的逻辑很简单建立WebSocket连接监听消息更新DOM和图表提供一个发送休眠指令的按钮。4. 功耗实测与优化策略功耗是电池供电设备的生命线。我们为这个“功能过剩”的设备付出了多少代价4.1 各状态功耗测量使用高精度万用表串联在电池供电回路中测量不同工作模式下的电流工作状态测量电流主要耗电单元说明深度睡眠~1.8 mACP2102, TP4056, LDO静态电流远高于ESP-01F本身的20uA外围电路是耗电大户。Wi-Fi AP模式空闲~70 mAESP-01F (RF发射)模块启动创建热点但无客户端连接。Wi-Fi AP模式有1客户端连接~93 mAESP-01F (RF发射/接收)有设备连接到热点射频活动增加。OLED全亮显示增加 ~10-20 mAOLED屏幕屏幕亮度越高电流越大。4.2 功耗分析与优化空间深度睡眠功耗过高1.8mA理想情况应低于100uA。问题主要出在CP2102即使USB未连接其VCC引脚仍由电池供电存在静态电流。TP4056在电池供电模式下其自身存在一定的静态消耗。AMS1117 LDO存在约5mA的静态电流Quiescent Current。优化方案对于产品化设计可以增加一个由ESP-01F GPIO控制的MOSFET开关电路在进入深度睡眠前彻底切断CP2102、TP4056除保护电路外等外围芯片的供电只保留ESP-01F和唤醒电路的供电。这能将睡眠电流拉低到接近ESP-01F本身的20uA水平。工作电流大ESP-01F在射频工作时电流峰值可达200mA平均70-90mA是正常范围。对于150mAh的电池理论持续工作时间仅约1.5-2小时。优化方向缩短工作时间进一步减少ACTIVITY_TIMEOUT比如从60秒改为30秒。使用STA模式如果环境有现成Wi-Fi让设备连接路由器STA模式并定时向服务器发送数据然后迅速休眠。这比维持一个AP要省电因为AP需要持续广播信标帧。降低发射功率通过WiFi.setOutputPower(10.5)可以降低RF功率减少耗电但会牺牲连接距离。重要提示功耗优化是一个系统工程需要在功能、用户体验和续航之间取得平衡。本项目的主要目标是演示功能集成因此接受了当前功耗水平。若追求长续航应优先考虑使用专为低功耗设计的蓝牙模块如BLE而非Wi-Fi。5. 组装、调试与问题排查实录5.1 3D打印外壳设计与组装外壳设计遵循“无紧固件”原则通过卡扣和摩擦力固定。设计要点上下盖定位设计榫卯结构或定位柱确保PCB位置准确。按钮开孔预留孔位让物理按钮微动开关露出。传感器开孔为DS18B20的探头线留出通道。散热与天线避免金属部件靠近ESP-01F的PCB天线区域。外壳最好使用非屏蔽材料如PLA。USB接口开口精确对准Micro USB端口。打印设置材料PLA强度更好。层高0.2mm平衡精度与速度。填充20%提供足够强度。支撑对于悬空结构如卡扣内部需要开启支撑。组装时先将电池用双面胶固定在下壳内然后放入PCB最后扣上上盖。确保按钮手感清晰USB插拔顺畅。5.2 典型问题与解决方案速查表在开发过程中你几乎一定会遇到以下问题。这里是我的排查笔记现象可能原因排查步骤与解决方案上电无反应OLED不亮1. 电源问题2. 焊接短路/虚焊1. 用万用表测量TP4056输出端是否有~4V电压AMS1117输出端是否为3.3V。2. 检查电池是否已充电USB线是否供电正常。3. 仔细检查PCB特别是电源路径VCC/GND有无短路或断路。重点查LDO和电容。Arduino IDE无法上传程序1. 驱动未安装2. 自动下载电路失效3. 板型/端口选择错误1. 确认电脑已安装CP2102驱动可从Silicon Labs官网下载。2. 尝试手动进入下载模式按住PCB上的“FLASH”按钮GPIO0拉低再按一下“RST”按钮然后释放“FLASH”。3. 在IDE中选择开发板为“Generic ESP8266 Module”Flash Mode为“DIO”Flash Size为“1M (64K SPIFFS)”端口选择正确的COM口。能上传程序但运行后无法创建Wi-Fi热点1. 程序错误2. SPIFFS文件未上传3. 天线问题1. 打开串口监视器波特率115200查看启动日志。ESP会打印IP地址等信息。2. 确保已通过“工具”-“ESP8266 Sketch Data Upload”上传了网页文件到SPIFFS。3. 检查PCB上天线区域是否被金属外壳遮挡或有无异物短路。网页能打开但WebSocket连接失败无实时数据1. 防火墙/安全软件拦截2. 网页JS代码端口错误3. ESP代码中WebSocket未启动1. 尝试关闭电脑防火墙或杀毒软件临时测试。2. 检查浏览器控制台F12的报错信息。确认JS中WebSocket连接的端口号81与代码中一致。3. 在串口日志中确认webSocket.begin()已执行。设备发热严重1. LDO或CP2102短路2. 持续大电流工作1. 立即断电用手触摸找出发热芯片检查其引脚焊接是否有桥接。2. 如果只是温热可能是Wi-Fi持续全功率发射导致属于正常现象但应优化代码使其尽快进入睡眠。深度睡眠后无法通过按钮唤醒1. 唤醒电路连接错误2. 代码中深度睡眠配置有误1. 确认物理按钮连接在RST和GND之间。按下按钮应导致RST引脚被拉低产生复位信号。2. 确保在goToDeepSleep()函数中没有将用于唤醒的GPIO如GPIO16设置为高阻态或输出高电平这可能会干扰复位电路。5.3 最后的个人体会做完这个项目我最大的感触是从模块堆叠到集成PCB设计是业余爱好者和初级开发者迈向“做产品”思维的关键一步。过程中你会被迫考虑电源完整性、信号完整性、可制造性、可测试性和用户体验。比如那个自动下载电路就为了省去用户手动按按钮的麻烦比如集成充电就是为了让设备更像一个完整的商品。ESP-01F和WebSocket的组合为微型物联网设备打开了一扇门。虽然它的功耗在电池场景下是个挑战但在许多有源供电的场景如智能家居传感器、工业监测点里它提供的网络能力和实时性是非常宝贵的。这个项目里用到的异步服务器、SPIFFS、深度睡眠这些技术都是ESP8266/ESP32生态中的核心技能。如果你也想动手我的建议是先不要追求一次完美。可以用面包板把核心功能ESP-01FDS18B20OLED跑通写出能WebSocket推送数据的代码。然后再用EDA软件比如立创EDA画一个最小系统的PCB只包含ESP-01F、CP2102和必要的电阻电容去打样试试。一步步来每步踩的坑都会变成实实在在的经验。这个“过剩”的温度计最终带给你的远不止一个能显示温度的装置。
![[开源] 双通道药房对账协调器：面向医院药房与零售药店处方协同的CLI对账工具](http://pic.xiahunao.cn/yaotu/[开源] 双通道药房对账协调器：面向医院药房与零售药店处方协同的CLI对账工具)
