1. 温湿度数据记录仪项目概述最近在做一个环境监测的小项目核心需求是长时间、稳定地记录温度和湿度数据并且能够方便地把数据拿出来分析。市面上虽然有成品的温湿度计但要么数据只能本地看要么存储和传输方式单一很难满足一些定制化的需求比如同时支持蓝牙近距离调试和SD卡大容量离线存储。所以我就动手做了一个基于ESP32的温湿度数据记录仪它集成了蓝牙BT和SD卡存储算是一个挺实用的DIY方案。这个项目特别适合那些需要对仓库、实验室、温室或者自家地下室进行长期环境监控的朋友。你可能会想一个ESP32开发板、一个温湿度传感器再加个SD卡模块这不就是简单的堆叠吗确实硬件连接不复杂但真正要让这个系统稳定可靠地跑上几周甚至几个月里面有不少细节需要抠。比如如何低功耗运行以延长电池供电时间SD卡的文件系统怎么管理才不容易出错蓝牙通信和SD卡写入如何协调避免数据丢失这些才是项目的核心挑战和价值所在。接下来我会详细拆解整个项目的设计思路、硬件选型、软件实现以及我踩过的那些坑希望能给你提供一个从零到一、并且足够稳健的参考方案。2. 项目整体设计与核心思路拆解2.1 核心需求与方案选型这个项目的标题“Temperature and Humidity data logger (BT SD)”已经点明了所有关键要素。我们需要一个记录仪Logger核心功能是采集并记录温湿度数据同时具备两种数据交互方式蓝牙BT用于近场配置、实时查看和调试SD卡用于海量数据的离线存储。首先为什么选择ESP32作为主控原因有三点第一它自带Wi-Fi和蓝牙蓝牙部分我们正好用上Wi-Fi虽然本项目未启用但也为未来扩展如远程上传留了可能第二它的处理能力和内存通常有520KB SRAM足以运行相对复杂的逻辑和文件系统第三社区支持强大相关的库和案例丰富。如果只追求极限低功耗STM32系列可能是更纯粹的选择但那就需要额外增加蓝牙模块增加了复杂性和成本。传感器方面DHT22和SHT3x系列是常见选择。DHT22成本低但精度和响应速度一般且需要特定的时序读取。SHT31-DIS-F则是我最终采用的它的精度更高±2%RH, ±0.2°C通信方式是标准的I2C软件驱动更简单可靠虽然贵一点但对于需要可靠数据的场景是值得的。存储方案选择SD卡而非SPI Flash主要是因为容量和通用性。一张16GB的SD卡可以存储数以亿计的数据点而SPI Flash通常只有几MB到几十MB。同时SD卡可以通过读卡器直接在电脑上读取文件数据分析非常方便。这里的关键是SD卡的物理接口和文件系统稳定性。2.2 系统架构与工作流程整个系统的工作流程可以概括为一个“采集-记录-服务”的循环。主循环以固定的时间间隔例如每5分钟唤醒进行以下操作采集通过I2C总线读取SHT31传感器的温度和湿度原始数据并换算成标准单位摄氏度、百分比RH。格式化将时间戳从RTC或网络同步获得、温度值、湿度值格式化为一条结构化的字符串例如2023-10-27 14:30:00, 23.5, 45.2。记录将该条数据字符串追加写入到SD卡上的一个文本文件如datalog.csv中。同时为了应对突发断电重要数据如文件句柄状态可能需要定期同步到文件系统。服务检查蓝牙连接状态。如果有手机或电脑通过蓝牙连接并且发送了请求则系统可以中断常规记录循环执行诸如“发送最新数据”、“读取历史文件列表”、“修改记录间隔”等命令。这里的一个核心设计矛盾是低功耗与实时响应。如果让ESP32一直全速运行并监听蓝牙功耗会很高。我的解决方案是使用ESP32的深度睡眠Deep Sleep功能在两次数据采集间隔内让芯片进入深度睡眠仅由RTC定时器唤醒。此时蓝牙是关闭的。当需要蓝牙交互时可以通过一个额外的唤醒源比如一个按键将系统从深度睡眠中唤醒到全功能模式。在电池供电场景下这种“大部分时间深度睡眠偶尔唤醒干活”的模式是续航的关键。3. 硬件搭建与核心细节解析3.1 硬件清单与连接要点你需要准备以下核心部件主控芯片ESP32开发板如ESP32 DevKitC V4。注意选择引脚引出完整的型号。温湿度传感器SHT31-DIS-F采用DFN封装体积小。你也可以用SHT30或SHT35驱动兼容。SD卡模块选择支持SPI接口的Micro SD卡适配器模块。注意有些模块电平转换芯片是5V的而ESP32是3.3V确保你的模块支持3.3V逻辑或者自带电平转换。电源根据需求选择。调试时可用USB供电部署时建议用3.7V锂聚合物电池配合低压差稳压器LDO或者3节AA电池串联。其他面包板、杜邦线、10kΩ上拉电阻用于I2C总线、一个按键用于唤醒/重置。连接示意图如下务必在断电下操作ESP32 DevKitC -- 外设模块 ----------------------------- GPIO21 (SDA) -- SHT31 SDA GPIO22 (SCL) -- SHT31 SCL 3.3V -- SHT31 VIN, SD模块 VCC GND -- SHT31 GND, SD模块 GND GPIO23 (MOSI) -- SD模块 DI GPIO19 (MISO) -- SD模块 DO GPIO18 (SCK) -- SD模块 CLK GPIO5 (CS) -- SD模块 CS注意I2C总线SDA, SCL上需要接上拉电阻到3.3V通常阻值在4.7kΩ到10kΩ之间。很多开发板已经集成如果没有务必自己加上否则通信会不稳定。3.2 电源管理与低功耗设计要点如果你想用电池让设备运行数月电源管理是重中之重。ESP32在深度睡眠模式下电流可以降到10μA左右但这是“理想状态”。实际电路中SD卡模块、传感器、电平转换芯片等外围电路的静态功耗可能成为“电量杀手”。我的经验是彻底断电外围设备不要仅仅依靠ESP32进入睡眠。使用MOSFET或专用的电源开关芯片由ESP32的一个GPIO控制在进入深度睡眠前彻底切断SD卡模块和传感器的电源。唤醒后再重新上电。SHT31的功耗本身不高约0.5μA待机但SD卡模块的待机电流可能有几百μA。选择低功耗LDO如果使用锂电池选择静态电流Iq极低的LDO比如TI的TPS7A系列其Iq可低至1μA以下。普通的AMS1117-3.3的静态电流可能有几mA会持续消耗电池。优化唤醒源除了定时器唤醒如果你需要通过按键唤醒进行蓝牙配置可以将按键连接到ESP32的RTC GPIO如GPIO0, GPIO2等。这些引脚在深度睡眠时可以被配置为外部唤醒源且消耗能量极少。计算续航时间假设使用2000mAh的锂电池ESP32工作电流80mA持续2秒完成一次测量和存储睡眠电流50μA包含LDO和断电后电路的漏电流测量间隔5分钟。每小时工作(2秒 / 3600秒) * 80mA ≈ 0.044mAh每小时睡眠(3598秒 / 3600秒) * 0.05mA ≈ 0.05mAh每小时总耗电约0.094mAh理论续航2000mAh / 0.094mAh/h ≈ 21276小时 ≈ 886天这只是一个理想估算实际会因电池自放电、电路漏电、温度等因素缩短但做到一年以上的续航是很有希望的。4. 软件实现与核心代码剖析4.1 开发环境与库依赖我使用PlatformIO IDE基于VSCode进行开发它比Arduino IDE更适合管理依赖和项目结构。核心库如下传感器驱动Adafruit SHT31库。稳定且易于使用。SD卡与文件系统ESP32内置的SD库基于FS和SPI库。这是最标准的选择。蓝牙串口使用ESP32的BluetoothSerial库它可以将ESP32模拟成一个蓝牙串口设备手机或电脑连接后就像操作一个串口一样收发数据。platformio.ini配置文件示例如下[env:esp32dev] platform espressif32 board esp32dev framework arduino monitor_speed 115200 lib_deps adafruit/Adafruit SHT31 Library^2.0.54.2 主程序逻辑与状态机程序不能是简单的线性loop需要管理睡眠、测量、存储、蓝牙服务等多个状态。我采用一个简单的状态机来实现。#include Arduino.h #include “SD.h” #include “BluetoothSerial.h” #include Adafruit_SHT31.h // 引脚定义 #define SD_CS 5 #define SENSOR_POWER_CTRL 4 // 用于控制传感器和SD卡电源的GPIO #define WAKEUP_BUTTON 0 // 连接至RTC_GPIO0用于唤醒 // 全局对象 BluetoothSerial SerialBT; Adafruit_SHT31 sht31 Adafruit_SHT31(); File dataFile; // 全局变量 int logInterval 300; // 默认记录间隔5分钟单位秒 bool btConnected false; unsigned long lastLogTime 0; void setup() { Serial.begin(115200); pinMode(SENSOR_POWER_CTRL, OUTPUT); digitalWrite(SENSOR_POWER_CTRL, HIGH); // 开启外围电源 delay(100); // 等待外围稳定 // 初始化蓝牙 SerialBT.begin(“ESP32-DataLogger”); // 蓝牙设备名称 Serial.println(“蓝牙设备已启动等待连接...”); // 初始化SD卡 if (!SD.begin(SD_CS)) { Serial.println(“SD卡初始化失败”); // 这里可以加入错误处理如闪烁LED return; } Serial.println(“SD卡初始化成功。”); // 初始化传感器 if (!sht31.begin(0x44)) { // 默认I2C地址0x44 Serial.println(“找不到SHT31传感器”); while (1); } // 检查是否存在数据文件不存在则创建并写入CSV表头 if (!SD.exists(“/datalog.csv”)) { dataFile SD.open(“/datalog.csv”, FILE_WRITE); if (dataFile) { dataFile.println(“Timestamp, Temperature (C), Humidity (%)”); dataFile.close(); } } // 配置唤醒源 esp_sleep_enable_timer_wakeup(logInterval * 1000000); // 微秒 esp_sleep_enable_ext0_wakeup(GPIO_NUM_0, 0); // 低电平唤醒 } void loop() { // 状态1检查并处理蓝牙命令 handleBluetoothCommands(); // 状态2检查是否到达记录时间 if (millis() - lastLogTime logInterval * 1000) { logSensorData(); lastLogTime millis(); } // 状态3处理低功耗需求简易版延迟代替睡眠 // 在实际低功耗版本中这里会进入深度睡眠 // if (!btConnected) { // Serial.println(“进入深度睡眠...”); // digitalWrite(SENSOR_POWER_CTRL, LOW); // 关闭外围电源 // delay(100); // esp_deep_sleep_start(); // } delay(1000); // 简化版仅作演示用延迟 } void logSensorData() { float t sht31.readTemperature(); float h sht31.readHumidity(); if (isnan(t) || isnan(h)) { Serial.println(“读取传感器数据失败”); return; } // 获取时间戳简化版实际应用需用RTC或NTP String timestamp getTimestamp(); String dataString timestamp “, “ String(t) “, “ String(h); Serial.println(“记录数据: “ dataString); dataFile SD.open(“/datalog.csv”, FILE_APPEND); if (dataFile) { dataFile.println(dataString); dataFile.close(); // 及时关闭文件非常重要 } else { Serial.println(“打开文件失败”); } // 如果蓝牙已连接也通过蓝牙发送最新数据 if (btConnected) { SerialBT.println(“LATEST:” dataString); } } void handleBluetoothCommands() { if (SerialBT.available()) { String command SerialBT.readStringUntil(‘\n’); command.trim(); if (command “GET_LATEST”) { // 发送最新数据 } else if (command.startsWith(“INTERVAL”)) { int newInterval command.substring(9).toInt(); if (newInterval 10) { // 最小间隔10秒 logInterval newInterval; SerialBT.println(“OK:INTERVAL SET TO “ String(logInterval)); } } else if (command “GET_FILE_LIST”) { // 列出SD卡文件 } } // 更新连接状态 btConnected (SerialBT.hasClient()); }关键提示上面的loop()中的低功耗部分被注释掉了并用了delay代替这是为了调试方便。在实际部署的版本中你应该在完成一次记录且没有蓝牙连接后执行关闭外围电源、设置唤醒时间、然后进入esp_deep_sleep_start()。handleBluetoothCommands函数需要在深度睡眠唤醒后的全功能模式下运行。4.3 SD卡文件系统稳定性的关键处理SD卡读写最怕突然断电导致文件系统损坏。以下是我总结的几点保障措施及时关闭文件每次file.println()或file.write()后尽快执行file.close()。打开的文件句柄会缓存数据close()操作才会确保数据物理写入卡中并更新文件分配表。长时间不关闭文件句柄是损坏的常见原因。定期同步对于需要长时间打开文件进行频繁追加写入的场景虽然不推荐可以使用file.flush()强制将缓存数据写入物理介质。但flush()不能替代close()的完整性。使用稳健的文件名和路径避免使用长文件名、中文或特殊字符。使用8.3格式如DATA01.CSV兼容性最好。根目录下不要放太多文件可以按日期创建子目录例如/2024-05/2024-05-27.csv。开机检查与修复在setup()中初始化SD卡后可以尝试打开一个已知的文件进行读写测试。如果失败不要反复尝试破坏性操作可以记录错误并进入安全模式如仅通过蓝牙报告错误。切勿在单片机代码中尝试格式化SD卡这极不稳定且容易彻底损坏卡片。格式化应在电脑上用专业的工具如SD Card Formatter完成。文件系统选择对于SD卡FAT32是最通用、支持最好的选择。exFAT虽然支持大文件但兼容性略差。在初始化时使用SD.begin()即可底层会自动识别。5. 蓝牙通信协议与配置接口设计5.1 简易串口协议设计BluetoothSerial库提供了透明的串口通道我们需要设计一个简单的文本协议来区分命令和数据。协议设计原则是简单、可读、易于在手机App或串口助手上手动输入。我定义的几条基本命令GET_LATEST返回最新采集到的一条数据。INTERVAL300设置记录间隔为300秒。GET_INTERVAL返回当前记录间隔。GET_FILE_LIST返回SD卡根目录下的文件列表。READ_FILEdatalog.csv读取指定文件的内容需要分页避免数据量太大。TIME2024-05-27 14:30:00设置设备时间如果设备没有RTC此命令无效有RTC时非常重要。在ESP32端通过SerialBT.readStringUntil(‘\n’)读取一行然后解析开头的关键字。返回的数据也以明文格式加前缀如OK:表示成功ERROR:表示失败DATA:表示数据开始。5.2 手机端交互实现思路你不需要开发复杂的App。有以下几种简单方式蓝牙串口助手App在手机应用商店搜索“蓝牙串口”有很多现成的App。连接上名为“ESP32-DataLogger”的设备后就可以直接发送上述文本命令并查看返回结果。这是最快进行测试和调试的方法。MIT App Inventor 或 Kodular这些图形化编程工具可以让你在半小时内拖拽出一个简单的控制界面包含连接按钮、命令按钮和显示文本框。这对于制作一个专属的简单控制面板非常合适。Flutter 或 React Native如果你需要更专业、界面更美观的App可以使用这些框架。它们都有成熟的蓝牙插件开发起来也不复杂。实操心得在协议设计初期务必在串口助手USB和蓝牙上反复测试每条命令的发送和接收。处理好字符串解析时的空格、换行符和缓冲区溢出问题。为蓝牙通信设置一个超时机制防止因为连接意外中断导致程序卡在readStringUntil。6. 系统集成、测试与常见问题排查6.1 整体组装与功能测试流程硬件焊接或连接稳固后按以下步骤测试基础供电测试上电观察ESP32开发板上的电源指示灯是否正常。用万用表测量各模块的VCC引脚确保均为稳定的3.3V。串口日志监控通过USB连接电脑打开串口监视器115200波特率查看启动日志。应该依次看到蓝牙初始化成功、SD卡初始化成功、传感器检测成功的消息。传感器独立测试在代码中先注释掉SD和蓝牙部分只循环读取并打印传感器数据到串口。观察数值是否合理室温湿度。用手触摸传感器看温度值是否有变化。SD卡独立测试注释传感器部分测试SD卡能否创建文件、写入字符串并读取。尝试写入多行断电再上电检查数据是否持久化。蓝牙连接测试打开手机蓝牙串口助手搜索并连接“ESP32-DataLogger”。在串口助手发送GET_LATEST看是否能收到回复。全功能集成测试将所有功能打开让系统自动运行。观察每个记录周期是否正常打印日志文件是否正常增长。同时尝试用蓝牙命令打断自动记录查询数据或修改间隔。低功耗测试如适用断开USB接上电池。用万用表串联测量整机工作电流和睡眠电流。确认进入深度睡眠后电流降至预期范围例如100μA以下。6.2 常见问题与解决方案速查表以下是我在开发和部署过程中遇到的一些典型问题及解决方法问题现象可能原因排查步骤与解决方案SD卡初始化失败1. 接线错误CS/DI/DO/CLK2. 电源不稳或电流不足3. SD卡格式不对或损坏4. 模块电平不兼容5V vs 3.3V1. 用万用表蜂鸣档检查SPI四根线是否连通。2. 尝试单独给SD模块外接3.3V电源。3. 将SD卡用电脑格式化FAT32分配单元大小32KB。4. 确认模块支持3.3V逻辑或使用带电平转换的模块。能初始化但无法创建/写入文件1. 文件系统已满2. 文件路径或名称非法3. 文件未正确关闭句柄冲突1. 检查SD卡剩余空间。2. 使用简单的8.3格式文件名避免“/”。3. 确保每次open后都有对应的close避免嵌套打开。传感器读数全为NaN1. I2C地址错误2. I2C总线未上拉3. 传感器供电不足或损坏1. 使用I2C扫描程序确认传感器地址SHT31通常为0x44或0x45。2. 在SDA和SCL线上各接一个4.7kΩ上拉电阻到3.3V。3. 测量传感器VIN引脚电压是否为3.3V。蓝牙搜索不到设备1. 蓝牙未成功初始化2. 设备名称过长或包含特殊字符3. ESP32蓝牙天线问题某些板子1. 检查串口日志确认SerialBT.begin()执行成功。2. 设备名称尽量简短使用字母数字。3. 尝试重启手机蓝牙或换一个手机测试。蓝牙连接后数据收发乱码或断连1. 波特率不匹配虽然库内部处理但底层可能受影响2. 缓冲区溢出3. 信号干扰或距离过远1. 确保手机App和代码中都没有设置硬性波特率使用库默认。2. 在代码中增加延迟避免短时间内发送大量数据。3. 拉近设备与手机距离避开强干扰源。深度睡眠后无法唤醒1. 唤醒源配置错误2. 唤醒引脚外部电路影响电平3. 程序在睡眠前未正确配置引脚状态1. 确认esp_sleep_enable_ext0_wakeup()使用的GPIO号正确且电平触发条件0低1高符合按键电路设计。2. 检查按键电路睡眠时唤醒引脚应有明确的上拉或下拉电阻保持稳定状态防止浮空。3. 进入睡眠前将控制外围电源的GPIO设为低电平关闭外部电路。数据记录时间戳错乱ESP32没有硬件RTC深度睡眠后软件millis()会复位1. 使用ESP32的RTC存储器RTC_DATA_ATTR保存一个时间戳基准结合睡眠时长计算。2. 通过蓝牙在每次唤醒后从手机获取网络时间进行同步推荐。3. 外接DS3231等硬件RTC模块。6.3 数据导出与分析建议设备运行一段时间后SD卡里会有一个CSV文件。你可以直接取出SD卡用读卡器插入电脑用Excel、Google Sheets或任何文本编辑器打开。对于数据分析我推荐以下流程数据清洗用Excel打开CSV检查是否有异常值如湿度100%。可能是传感器偶尔读取错误可以过滤掉这些行。趋势可视化在Excel中选中时间和温度/湿度数据列插入“折线图”或“散点图”可以直观看到温湿度随时间的变化趋势。统计计算计算平均值、最大值、最小值、标准差了解环境的整体情况和波动范围。相关性分析可以计算温度和湿度的相关系数看看两者是否存在某种关联例如温度升高是否通常伴随湿度下降。如果你想更自动化可以写一个Python脚本用pandas库读取CSV用matplotlib画图定期生成报告。7. 项目优化与扩展方向这个基础版本已经可以稳定工作但根据不同的应用场景还有很大的优化和扩展空间1. 功耗进一步优化降低工作电压ESP32在3.0V下仍能工作且功耗更低。可以尝试使用单节锂铁电池约3.2V直接供电省去LDO的损耗。间歇性开启蓝牙仅在需要配置时由按键唤醒并开启蓝牙一段时间如5分钟超时后自动关闭蓝牙并再次进入深度睡眠。选用更低功耗的传感器有些传感器支持单次测量模式测量完毕后自动进入休眠比SHT31的周期性测量更省电。2. 增加无线传输功能Wi-Fi定时上传利用ESP32自带的Wi-Fi每隔一段时间如每6小时唤醒连接路由器将SD卡中累积的数据打包发送到云服务器如ThingsBoard、阿里云IoT或私有服务器。这样无需物理取卡。LoRa远距离传输如果部署地点没有Wi-Fi覆盖可以添加LoRa模块将关键数据如超限报警传输到数公里外的接收网关。3. 增强数据可靠性与功能双SD卡备份使用两个SD卡模块同时写入相同数据防止单卡损坏。数据加密如果记录的数据敏感可以在写入SD卡前进行简单的AES加密。本地显示增加一个小型OLED屏幕实时显示当前温湿度、电池电量、记录状态等。声光报警当温度或湿度超过设定的阈值时通过蜂鸣器或LED报警。4. 外壳与防护设计并3D打印一个防水防尘的外壳将整个电路板封装起来只在传感器处开透气孔。如果用于户外需要考虑防晒和极端温度对电池和电子元件的影响。这个温湿度记录仪项目就像一棵技能树的主干掌握了它你就具备了嵌入式数据采集系统的核心开发能力。从传感器通信、数据存储到低功耗设计和无线通信每一个环节的深入探索都能带你进入一个更专业的领域。我最深的体会是硬件项目的稳定性往往取决于对细节的苛求——一个上拉电阻、一次文件关闭操作、一条清晰的调试日志这些看似微不足道的地方恰恰是决定项目成败的关键。希望这份详细的拆解能帮助你少走弯路成功做出属于自己的稳定可靠的数据记录仪。如果在实现过程中遇到新的问题不妨回头检查一下电源、信号线和代码中的状态管理大多数难题都藏在这些基础环节里。 ESP32温湿度数据记录仪：低功耗设计与SD卡蓝牙双模存储方案
1. 温湿度数据记录仪项目概述最近在做一个环境监测的小项目核心需求是长时间、稳定地记录温度和湿度数据并且能够方便地把数据拿出来分析。市面上虽然有成品的温湿度计但要么数据只能本地看要么存储和传输方式单一很难满足一些定制化的需求比如同时支持蓝牙近距离调试和SD卡大容量离线存储。所以我就动手做了一个基于ESP32的温湿度数据记录仪它集成了蓝牙BT和SD卡存储算是一个挺实用的DIY方案。这个项目特别适合那些需要对仓库、实验室、温室或者自家地下室进行长期环境监控的朋友。你可能会想一个ESP32开发板、一个温湿度传感器再加个SD卡模块这不就是简单的堆叠吗确实硬件连接不复杂但真正要让这个系统稳定可靠地跑上几周甚至几个月里面有不少细节需要抠。比如如何低功耗运行以延长电池供电时间SD卡的文件系统怎么管理才不容易出错蓝牙通信和SD卡写入如何协调避免数据丢失这些才是项目的核心挑战和价值所在。接下来我会详细拆解整个项目的设计思路、硬件选型、软件实现以及我踩过的那些坑希望能给你提供一个从零到一、并且足够稳健的参考方案。2. 项目整体设计与核心思路拆解2.1 核心需求与方案选型这个项目的标题“Temperature and Humidity data logger (BT SD)”已经点明了所有关键要素。我们需要一个记录仪Logger核心功能是采集并记录温湿度数据同时具备两种数据交互方式蓝牙BT用于近场配置、实时查看和调试SD卡用于海量数据的离线存储。首先为什么选择ESP32作为主控原因有三点第一它自带Wi-Fi和蓝牙蓝牙部分我们正好用上Wi-Fi虽然本项目未启用但也为未来扩展如远程上传留了可能第二它的处理能力和内存通常有520KB SRAM足以运行相对复杂的逻辑和文件系统第三社区支持强大相关的库和案例丰富。如果只追求极限低功耗STM32系列可能是更纯粹的选择但那就需要额外增加蓝牙模块增加了复杂性和成本。传感器方面DHT22和SHT3x系列是常见选择。DHT22成本低但精度和响应速度一般且需要特定的时序读取。SHT31-DIS-F则是我最终采用的它的精度更高±2%RH, ±0.2°C通信方式是标准的I2C软件驱动更简单可靠虽然贵一点但对于需要可靠数据的场景是值得的。存储方案选择SD卡而非SPI Flash主要是因为容量和通用性。一张16GB的SD卡可以存储数以亿计的数据点而SPI Flash通常只有几MB到几十MB。同时SD卡可以通过读卡器直接在电脑上读取文件数据分析非常方便。这里的关键是SD卡的物理接口和文件系统稳定性。2.2 系统架构与工作流程整个系统的工作流程可以概括为一个“采集-记录-服务”的循环。主循环以固定的时间间隔例如每5分钟唤醒进行以下操作采集通过I2C总线读取SHT31传感器的温度和湿度原始数据并换算成标准单位摄氏度、百分比RH。格式化将时间戳从RTC或网络同步获得、温度值、湿度值格式化为一条结构化的字符串例如2023-10-27 14:30:00, 23.5, 45.2。记录将该条数据字符串追加写入到SD卡上的一个文本文件如datalog.csv中。同时为了应对突发断电重要数据如文件句柄状态可能需要定期同步到文件系统。服务检查蓝牙连接状态。如果有手机或电脑通过蓝牙连接并且发送了请求则系统可以中断常规记录循环执行诸如“发送最新数据”、“读取历史文件列表”、“修改记录间隔”等命令。这里的一个核心设计矛盾是低功耗与实时响应。如果让ESP32一直全速运行并监听蓝牙功耗会很高。我的解决方案是使用ESP32的深度睡眠Deep Sleep功能在两次数据采集间隔内让芯片进入深度睡眠仅由RTC定时器唤醒。此时蓝牙是关闭的。当需要蓝牙交互时可以通过一个额外的唤醒源比如一个按键将系统从深度睡眠中唤醒到全功能模式。在电池供电场景下这种“大部分时间深度睡眠偶尔唤醒干活”的模式是续航的关键。3. 硬件搭建与核心细节解析3.1 硬件清单与连接要点你需要准备以下核心部件主控芯片ESP32开发板如ESP32 DevKitC V4。注意选择引脚引出完整的型号。温湿度传感器SHT31-DIS-F采用DFN封装体积小。你也可以用SHT30或SHT35驱动兼容。SD卡模块选择支持SPI接口的Micro SD卡适配器模块。注意有些模块电平转换芯片是5V的而ESP32是3.3V确保你的模块支持3.3V逻辑或者自带电平转换。电源根据需求选择。调试时可用USB供电部署时建议用3.7V锂聚合物电池配合低压差稳压器LDO或者3节AA电池串联。其他面包板、杜邦线、10kΩ上拉电阻用于I2C总线、一个按键用于唤醒/重置。连接示意图如下务必在断电下操作ESP32 DevKitC -- 外设模块 ----------------------------- GPIO21 (SDA) -- SHT31 SDA GPIO22 (SCL) -- SHT31 SCL 3.3V -- SHT31 VIN, SD模块 VCC GND -- SHT31 GND, SD模块 GND GPIO23 (MOSI) -- SD模块 DI GPIO19 (MISO) -- SD模块 DO GPIO18 (SCK) -- SD模块 CLK GPIO5 (CS) -- SD模块 CS注意I2C总线SDA, SCL上需要接上拉电阻到3.3V通常阻值在4.7kΩ到10kΩ之间。很多开发板已经集成如果没有务必自己加上否则通信会不稳定。3.2 电源管理与低功耗设计要点如果你想用电池让设备运行数月电源管理是重中之重。ESP32在深度睡眠模式下电流可以降到10μA左右但这是“理想状态”。实际电路中SD卡模块、传感器、电平转换芯片等外围电路的静态功耗可能成为“电量杀手”。我的经验是彻底断电外围设备不要仅仅依靠ESP32进入睡眠。使用MOSFET或专用的电源开关芯片由ESP32的一个GPIO控制在进入深度睡眠前彻底切断SD卡模块和传感器的电源。唤醒后再重新上电。SHT31的功耗本身不高约0.5μA待机但SD卡模块的待机电流可能有几百μA。选择低功耗LDO如果使用锂电池选择静态电流Iq极低的LDO比如TI的TPS7A系列其Iq可低至1μA以下。普通的AMS1117-3.3的静态电流可能有几mA会持续消耗电池。优化唤醒源除了定时器唤醒如果你需要通过按键唤醒进行蓝牙配置可以将按键连接到ESP32的RTC GPIO如GPIO0, GPIO2等。这些引脚在深度睡眠时可以被配置为外部唤醒源且消耗能量极少。计算续航时间假设使用2000mAh的锂电池ESP32工作电流80mA持续2秒完成一次测量和存储睡眠电流50μA包含LDO和断电后电路的漏电流测量间隔5分钟。每小时工作(2秒 / 3600秒) * 80mA ≈ 0.044mAh每小时睡眠(3598秒 / 3600秒) * 0.05mA ≈ 0.05mAh每小时总耗电约0.094mAh理论续航2000mAh / 0.094mAh/h ≈ 21276小时 ≈ 886天这只是一个理想估算实际会因电池自放电、电路漏电、温度等因素缩短但做到一年以上的续航是很有希望的。4. 软件实现与核心代码剖析4.1 开发环境与库依赖我使用PlatformIO IDE基于VSCode进行开发它比Arduino IDE更适合管理依赖和项目结构。核心库如下传感器驱动Adafruit SHT31库。稳定且易于使用。SD卡与文件系统ESP32内置的SD库基于FS和SPI库。这是最标准的选择。蓝牙串口使用ESP32的BluetoothSerial库它可以将ESP32模拟成一个蓝牙串口设备手机或电脑连接后就像操作一个串口一样收发数据。platformio.ini配置文件示例如下[env:esp32dev] platform espressif32 board esp32dev framework arduino monitor_speed 115200 lib_deps adafruit/Adafruit SHT31 Library^2.0.54.2 主程序逻辑与状态机程序不能是简单的线性loop需要管理睡眠、测量、存储、蓝牙服务等多个状态。我采用一个简单的状态机来实现。#include Arduino.h #include “SD.h” #include “BluetoothSerial.h” #include Adafruit_SHT31.h // 引脚定义 #define SD_CS 5 #define SENSOR_POWER_CTRL 4 // 用于控制传感器和SD卡电源的GPIO #define WAKEUP_BUTTON 0 // 连接至RTC_GPIO0用于唤醒 // 全局对象 BluetoothSerial SerialBT; Adafruit_SHT31 sht31 Adafruit_SHT31(); File dataFile; // 全局变量 int logInterval 300; // 默认记录间隔5分钟单位秒 bool btConnected false; unsigned long lastLogTime 0; void setup() { Serial.begin(115200); pinMode(SENSOR_POWER_CTRL, OUTPUT); digitalWrite(SENSOR_POWER_CTRL, HIGH); // 开启外围电源 delay(100); // 等待外围稳定 // 初始化蓝牙 SerialBT.begin(“ESP32-DataLogger”); // 蓝牙设备名称 Serial.println(“蓝牙设备已启动等待连接...”); // 初始化SD卡 if (!SD.begin(SD_CS)) { Serial.println(“SD卡初始化失败”); // 这里可以加入错误处理如闪烁LED return; } Serial.println(“SD卡初始化成功。”); // 初始化传感器 if (!sht31.begin(0x44)) { // 默认I2C地址0x44 Serial.println(“找不到SHT31传感器”); while (1); } // 检查是否存在数据文件不存在则创建并写入CSV表头 if (!SD.exists(“/datalog.csv”)) { dataFile SD.open(“/datalog.csv”, FILE_WRITE); if (dataFile) { dataFile.println(“Timestamp, Temperature (C), Humidity (%)”); dataFile.close(); } } // 配置唤醒源 esp_sleep_enable_timer_wakeup(logInterval * 1000000); // 微秒 esp_sleep_enable_ext0_wakeup(GPIO_NUM_0, 0); // 低电平唤醒 } void loop() { // 状态1检查并处理蓝牙命令 handleBluetoothCommands(); // 状态2检查是否到达记录时间 if (millis() - lastLogTime logInterval * 1000) { logSensorData(); lastLogTime millis(); } // 状态3处理低功耗需求简易版延迟代替睡眠 // 在实际低功耗版本中这里会进入深度睡眠 // if (!btConnected) { // Serial.println(“进入深度睡眠...”); // digitalWrite(SENSOR_POWER_CTRL, LOW); // 关闭外围电源 // delay(100); // esp_deep_sleep_start(); // } delay(1000); // 简化版仅作演示用延迟 } void logSensorData() { float t sht31.readTemperature(); float h sht31.readHumidity(); if (isnan(t) || isnan(h)) { Serial.println(“读取传感器数据失败”); return; } // 获取时间戳简化版实际应用需用RTC或NTP String timestamp getTimestamp(); String dataString timestamp “, “ String(t) “, “ String(h); Serial.println(“记录数据: “ dataString); dataFile SD.open(“/datalog.csv”, FILE_APPEND); if (dataFile) { dataFile.println(dataString); dataFile.close(); // 及时关闭文件非常重要 } else { Serial.println(“打开文件失败”); } // 如果蓝牙已连接也通过蓝牙发送最新数据 if (btConnected) { SerialBT.println(“LATEST:” dataString); } } void handleBluetoothCommands() { if (SerialBT.available()) { String command SerialBT.readStringUntil(‘\n’); command.trim(); if (command “GET_LATEST”) { // 发送最新数据 } else if (command.startsWith(“INTERVAL”)) { int newInterval command.substring(9).toInt(); if (newInterval 10) { // 最小间隔10秒 logInterval newInterval; SerialBT.println(“OK:INTERVAL SET TO “ String(logInterval)); } } else if (command “GET_FILE_LIST”) { // 列出SD卡文件 } } // 更新连接状态 btConnected (SerialBT.hasClient()); }关键提示上面的loop()中的低功耗部分被注释掉了并用了delay代替这是为了调试方便。在实际部署的版本中你应该在完成一次记录且没有蓝牙连接后执行关闭外围电源、设置唤醒时间、然后进入esp_deep_sleep_start()。handleBluetoothCommands函数需要在深度睡眠唤醒后的全功能模式下运行。4.3 SD卡文件系统稳定性的关键处理SD卡读写最怕突然断电导致文件系统损坏。以下是我总结的几点保障措施及时关闭文件每次file.println()或file.write()后尽快执行file.close()。打开的文件句柄会缓存数据close()操作才会确保数据物理写入卡中并更新文件分配表。长时间不关闭文件句柄是损坏的常见原因。定期同步对于需要长时间打开文件进行频繁追加写入的场景虽然不推荐可以使用file.flush()强制将缓存数据写入物理介质。但flush()不能替代close()的完整性。使用稳健的文件名和路径避免使用长文件名、中文或特殊字符。使用8.3格式如DATA01.CSV兼容性最好。根目录下不要放太多文件可以按日期创建子目录例如/2024-05/2024-05-27.csv。开机检查与修复在setup()中初始化SD卡后可以尝试打开一个已知的文件进行读写测试。如果失败不要反复尝试破坏性操作可以记录错误并进入安全模式如仅通过蓝牙报告错误。切勿在单片机代码中尝试格式化SD卡这极不稳定且容易彻底损坏卡片。格式化应在电脑上用专业的工具如SD Card Formatter完成。文件系统选择对于SD卡FAT32是最通用、支持最好的选择。exFAT虽然支持大文件但兼容性略差。在初始化时使用SD.begin()即可底层会自动识别。5. 蓝牙通信协议与配置接口设计5.1 简易串口协议设计BluetoothSerial库提供了透明的串口通道我们需要设计一个简单的文本协议来区分命令和数据。协议设计原则是简单、可读、易于在手机App或串口助手上手动输入。我定义的几条基本命令GET_LATEST返回最新采集到的一条数据。INTERVAL300设置记录间隔为300秒。GET_INTERVAL返回当前记录间隔。GET_FILE_LIST返回SD卡根目录下的文件列表。READ_FILEdatalog.csv读取指定文件的内容需要分页避免数据量太大。TIME2024-05-27 14:30:00设置设备时间如果设备没有RTC此命令无效有RTC时非常重要。在ESP32端通过SerialBT.readStringUntil(‘\n’)读取一行然后解析开头的关键字。返回的数据也以明文格式加前缀如OK:表示成功ERROR:表示失败DATA:表示数据开始。5.2 手机端交互实现思路你不需要开发复杂的App。有以下几种简单方式蓝牙串口助手App在手机应用商店搜索“蓝牙串口”有很多现成的App。连接上名为“ESP32-DataLogger”的设备后就可以直接发送上述文本命令并查看返回结果。这是最快进行测试和调试的方法。MIT App Inventor 或 Kodular这些图形化编程工具可以让你在半小时内拖拽出一个简单的控制界面包含连接按钮、命令按钮和显示文本框。这对于制作一个专属的简单控制面板非常合适。Flutter 或 React Native如果你需要更专业、界面更美观的App可以使用这些框架。它们都有成熟的蓝牙插件开发起来也不复杂。实操心得在协议设计初期务必在串口助手USB和蓝牙上反复测试每条命令的发送和接收。处理好字符串解析时的空格、换行符和缓冲区溢出问题。为蓝牙通信设置一个超时机制防止因为连接意外中断导致程序卡在readStringUntil。6. 系统集成、测试与常见问题排查6.1 整体组装与功能测试流程硬件焊接或连接稳固后按以下步骤测试基础供电测试上电观察ESP32开发板上的电源指示灯是否正常。用万用表测量各模块的VCC引脚确保均为稳定的3.3V。串口日志监控通过USB连接电脑打开串口监视器115200波特率查看启动日志。应该依次看到蓝牙初始化成功、SD卡初始化成功、传感器检测成功的消息。传感器独立测试在代码中先注释掉SD和蓝牙部分只循环读取并打印传感器数据到串口。观察数值是否合理室温湿度。用手触摸传感器看温度值是否有变化。SD卡独立测试注释传感器部分测试SD卡能否创建文件、写入字符串并读取。尝试写入多行断电再上电检查数据是否持久化。蓝牙连接测试打开手机蓝牙串口助手搜索并连接“ESP32-DataLogger”。在串口助手发送GET_LATEST看是否能收到回复。全功能集成测试将所有功能打开让系统自动运行。观察每个记录周期是否正常打印日志文件是否正常增长。同时尝试用蓝牙命令打断自动记录查询数据或修改间隔。低功耗测试如适用断开USB接上电池。用万用表串联测量整机工作电流和睡眠电流。确认进入深度睡眠后电流降至预期范围例如100μA以下。6.2 常见问题与解决方案速查表以下是我在开发和部署过程中遇到的一些典型问题及解决方法问题现象可能原因排查步骤与解决方案SD卡初始化失败1. 接线错误CS/DI/DO/CLK2. 电源不稳或电流不足3. SD卡格式不对或损坏4. 模块电平不兼容5V vs 3.3V1. 用万用表蜂鸣档检查SPI四根线是否连通。2. 尝试单独给SD模块外接3.3V电源。3. 将SD卡用电脑格式化FAT32分配单元大小32KB。4. 确认模块支持3.3V逻辑或使用带电平转换的模块。能初始化但无法创建/写入文件1. 文件系统已满2. 文件路径或名称非法3. 文件未正确关闭句柄冲突1. 检查SD卡剩余空间。2. 使用简单的8.3格式文件名避免“/”。3. 确保每次open后都有对应的close避免嵌套打开。传感器读数全为NaN1. I2C地址错误2. I2C总线未上拉3. 传感器供电不足或损坏1. 使用I2C扫描程序确认传感器地址SHT31通常为0x44或0x45。2. 在SDA和SCL线上各接一个4.7kΩ上拉电阻到3.3V。3. 测量传感器VIN引脚电压是否为3.3V。蓝牙搜索不到设备1. 蓝牙未成功初始化2. 设备名称过长或包含特殊字符3. ESP32蓝牙天线问题某些板子1. 检查串口日志确认SerialBT.begin()执行成功。2. 设备名称尽量简短使用字母数字。3. 尝试重启手机蓝牙或换一个手机测试。蓝牙连接后数据收发乱码或断连1. 波特率不匹配虽然库内部处理但底层可能受影响2. 缓冲区溢出3. 信号干扰或距离过远1. 确保手机App和代码中都没有设置硬性波特率使用库默认。2. 在代码中增加延迟避免短时间内发送大量数据。3. 拉近设备与手机距离避开强干扰源。深度睡眠后无法唤醒1. 唤醒源配置错误2. 唤醒引脚外部电路影响电平3. 程序在睡眠前未正确配置引脚状态1. 确认esp_sleep_enable_ext0_wakeup()使用的GPIO号正确且电平触发条件0低1高符合按键电路设计。2. 检查按键电路睡眠时唤醒引脚应有明确的上拉或下拉电阻保持稳定状态防止浮空。3. 进入睡眠前将控制外围电源的GPIO设为低电平关闭外部电路。数据记录时间戳错乱ESP32没有硬件RTC深度睡眠后软件millis()会复位1. 使用ESP32的RTC存储器RTC_DATA_ATTR保存一个时间戳基准结合睡眠时长计算。2. 通过蓝牙在每次唤醒后从手机获取网络时间进行同步推荐。3. 外接DS3231等硬件RTC模块。6.3 数据导出与分析建议设备运行一段时间后SD卡里会有一个CSV文件。你可以直接取出SD卡用读卡器插入电脑用Excel、Google Sheets或任何文本编辑器打开。对于数据分析我推荐以下流程数据清洗用Excel打开CSV检查是否有异常值如湿度100%。可能是传感器偶尔读取错误可以过滤掉这些行。趋势可视化在Excel中选中时间和温度/湿度数据列插入“折线图”或“散点图”可以直观看到温湿度随时间的变化趋势。统计计算计算平均值、最大值、最小值、标准差了解环境的整体情况和波动范围。相关性分析可以计算温度和湿度的相关系数看看两者是否存在某种关联例如温度升高是否通常伴随湿度下降。如果你想更自动化可以写一个Python脚本用pandas库读取CSV用matplotlib画图定期生成报告。7. 项目优化与扩展方向这个基础版本已经可以稳定工作但根据不同的应用场景还有很大的优化和扩展空间1. 功耗进一步优化降低工作电压ESP32在3.0V下仍能工作且功耗更低。可以尝试使用单节锂铁电池约3.2V直接供电省去LDO的损耗。间歇性开启蓝牙仅在需要配置时由按键唤醒并开启蓝牙一段时间如5分钟超时后自动关闭蓝牙并再次进入深度睡眠。选用更低功耗的传感器有些传感器支持单次测量模式测量完毕后自动进入休眠比SHT31的周期性测量更省电。2. 增加无线传输功能Wi-Fi定时上传利用ESP32自带的Wi-Fi每隔一段时间如每6小时唤醒连接路由器将SD卡中累积的数据打包发送到云服务器如ThingsBoard、阿里云IoT或私有服务器。这样无需物理取卡。LoRa远距离传输如果部署地点没有Wi-Fi覆盖可以添加LoRa模块将关键数据如超限报警传输到数公里外的接收网关。3. 增强数据可靠性与功能双SD卡备份使用两个SD卡模块同时写入相同数据防止单卡损坏。数据加密如果记录的数据敏感可以在写入SD卡前进行简单的AES加密。本地显示增加一个小型OLED屏幕实时显示当前温湿度、电池电量、记录状态等。声光报警当温度或湿度超过设定的阈值时通过蜂鸣器或LED报警。4. 外壳与防护设计并3D打印一个防水防尘的外壳将整个电路板封装起来只在传感器处开透气孔。如果用于户外需要考虑防晒和极端温度对电池和电子元件的影响。这个温湿度记录仪项目就像一棵技能树的主干掌握了它你就具备了嵌入式数据采集系统的核心开发能力。从传感器通信、数据存储到低功耗设计和无线通信每一个环节的深入探索都能带你进入一个更专业的领域。我最深的体会是硬件项目的稳定性往往取决于对细节的苛求——一个上拉电阻、一次文件关闭操作、一条清晰的调试日志这些看似微不足道的地方恰恰是决定项目成败的关键。希望这份详细的拆解能帮助你少走弯路成功做出属于自己的稳定可靠的数据记录仪。如果在实现过程中遇到新的问题不妨回头检查一下电源、信号线和代码中的状态管理大多数难题都藏在这些基础环节里。