基于ESP32与太阳能供电的物联网气象站全栈开发实践

1. 项目概述与核心价值

几年前，我在自家后院搞了个小菜园，总想实时知道温湿度变化，但市面上的气象站要么太贵，要么数据出不去家门。后来接触到ESP32和物联网，就琢磨着自己动手做一个。这个项目的核心，就是打造一个能“自己养活自己”并“主动汇报”的太阳能气象站。它不依赖市电，不依赖固定的WiFi网络，可以放在田间地头、山顶湖边，只要有阳光和手机信号，就能默默工作，把环境数据传到你的网页上。

这个气象站的大脑是ESP32，它负责读取传感器数据；心脏是SIM800L GSM模块，负责在没有WiFi的地方通过2G网络发送数据；能量来源则是一块小太阳能板和锂电池。当然，如果你只是想在自家阳台或室内使用，完全可以用更便宜的ESP8266 WiFi模块来替代，成本更低，部署也更简单。整个系统从传感器数据采集、通过GSM/WiFi双模传输、到后端Web服务器搭建和数据可视化，形成了一套完整的、可复现的物联网数据流闭环。对于想入门物联网硬件开发、学习传感器集成和远程数据传输的朋友来说，这是一个绝佳的练手项目，涵盖了从电路连接、嵌入式编程到服务器端开发的全栈技能点。

2. 整体方案设计与核心器件选型

2.1 系统架构与工作流程拆解

整个气象站的工作逻辑是一条清晰的单向数据流：感知 -> 处理 -> 传输 -> 存储 -> 展示。

首先，BME280、SI1145等传感器通过I2C总线将环境数据（温度、湿度、气压、紫外线指数）实时上报给主控芯片ESP32。ESP32读取这些数据后，会进行简单的格式化处理，比如将原始ADC值转换为实际的物理量（如摄氏度、百帕）。接下来就是关键的传输环节：系统会优先尝试通过集成的SIM800L模块，使用AT指令集连接到运营商的GPRS网络，然后以HTTP POST请求的形式，将打包好的JSON格式数据发送到我们预设的云服务器API接口。如果检测到可用的WiFi信号（比如使用ESP8266版本或在有WiFi的环境），则会自动切换至WiFi传输模式以节省流量。服务器端的PHP脚本接收到数据后，会进行验证并存入MySQL数据库。最后，任何通过浏览器访问我们网页的用户，都能看到由HTML/CSS/JavaScript渲染出的实时数据图表和历史曲线。

这个架构的优势在于其模块化和冗余设计。主控（ESP32/ESP8266）、通信（GSM/WiFi）、供电（太阳能）三大核心模块相对独立。这意味着你可以根据实际需求灵活替换。比如在深山老林做生态监测，GSM模块是唯一选择；而在城市楼顶，用WiFi版则更经济。太阳能充电系统确保了设备的长期野外生存能力，这才是“物联网”设备该有的样子——摆脱线缆的束缚。

2.2 核心器件选型背后的考量

为什么是这些芯片和模块？每一个选择背后都有具体的权衡。

主控芯片：ESP32 vs ESP8266ESP32是当之无愧的首选。它双核处理能力更强，在读取多个I2C传感器并同时处理网络通信时更从容；集成的蓝牙功能也为未来本地调试或扩展留下了可能。更重要的是，我使用的LILYGO T-Call板子直接集成了SIM800L，大大简化了硬件连接。而ESP8266（如Wemos D1 Mini Pro）则是极具性价比的备选方案。它的功耗略低于ESP32，在纯WiFi场景下完全够用，而且社区支持极其丰富。在这个项目中，我甚至在PCB上为两者都预留了接口，实现了热插拔替换，这在实际开发和后期维护中非常方便。

通信模块：SIM800L的“坑”与机遇选择SIM800L是项目能否在无网络地区部署的关键，但这里有个必须提前验证的大坑：2G网络覆盖。SIM800L仅支持GSM/GPRS（2G）网络。随着全球运营商推进2G/3G退网，很多地区可能已经关闭了2G信号。在购买模块和SIM卡前，务必咨询本地运营商，确认2G网络是否可用。我自己的经验是，选择那些主要提供物联网卡服务的运营商，他们往往对2G网络的支持周期更长。另外，要购买支持GPRS数据功能的物联网卡或手机卡，并开通最小的流量套餐（月租几块钱的那种）。我们的气象数据包非常小，按15分钟发送一次计算，一个月流量不会超过10MB。

传感器选型：精度、功耗与接口的平衡

• BME280：温湿度气压三合一传感器，I2C接口，精度和稳定性在消费级中很不错，关键是功耗极低，非常适合电池供电场景。
• SI1145：紫外线指数传感器。选择它是因为它不仅能测UV指数，还能测环境光强度和红外线，功能较多，且同样是I2C接口，便于总线扩展。
• MAX17043：锂电池电量计芯片。理想很美好，它能通过监测电池电压来估算剩余电量百分比。但实际使用中我遇到了读数不准（经常显示超过100%）的问题，这可能与TP4056充电模块的输出电压波形或分压电阻有关。对于电量监测，一个更简单可靠的备选方案是使用ESP32自身的ADC引脚，通过电阻分压电路测量电池电压，然后在代码里根据电池的放电曲线（通常3.7V-4.2V对应0%-100%）进行近似估算。

供电系统：太阳能自治的核心供电系统是野外部署的生命线。我采用了“小功率太阳能板 + TP4056充电管理 + 18650锂电池”的经典方案。

• 太阳能板：选择了6V 1W的规格。为什么是6V？因为TP4056的输入电压范围是4.5V-5.5V，6V的板子在阳光充足时输出电压在5V左右，经过一个二极管降压后刚好适合。1W的功率（约166mA电流）对于给2100mAh的电池“细水长流”地充电是足够的，尤其是在日照条件良好的地区。
• TP4056模块：这个模块至关重要。它不仅是线性充电芯片，更集成了DW01电池保护芯片和8205A MOS管，实现了过充、过放、短路和过流保护。务必购买带有保护板（带芯片）的TP4056模块，而不是只有充电功能的裸板，它能有效防止锂电池因过放而损坏。
• 18650电池：选择有品牌、容量真实的动力型或容量型18650电池。2100mAh-3000mAh是一个平衡了体积和续航的容量范围。

3. 硬件电路搭建与焊接避坑指南

3.1 电路连接原理图详解

整个系统的电路连接可以看作是以ESP32和TP4056为核心的两个子系统。

电源子系统连接：

1. 太阳能板的正负极分别连接到TP4056模块的IN+和IN-。
2. 18650电池的正负极连接到TP4056模块的B+和B-。
3. TP4056模块的OUT+和OUT-是整个气象站的供电输出端。这里接出一个电源开关，然后连接到ESP32主板、SIM800L模块以及所有传感器的VCC和GND。

重要提示：TP4056的OUT端电压就是电池电压（约3.7V-4.2V）。ESP32和大多数传感器的工作电压范围都包含3.3V，直接接4.2V可能处于临界状态。稳妥的做法是在OUT+后串联一个低压差稳压器（LDO），如AMS1117-3.3，将电压稳定在3.3V后再供给各模块。虽然ESP32的引脚大多耐受3.6V，但长期在4.2V下工作存在风险。

信号子系统连接（I2C总线）：所有传感器（BME280、SI1145、MAX17043）都挂载在同一个I2C总线上。

• ESP32端：通常默认的I2C引脚是GPIO21 (SDA)和GPIO22 (SCL)。
• 传感器端：将每个传感器的SDA引脚都并联，连接到ESP32的SDA；SCL引脚同理并联到ESP32的SCL。
• 上拉电阻：I2C总线需要上拉电阻才能可靠工作。虽然一些传感器模块板载了上拉电阻，但当总线上设备较多时，可能仍需在SDA和SCL线上各加一个4.7kΩ的电阻，上拉到3.3V。

SIM800L与ESP32的连接（针对LILYGO T-Call板）：如果是集成的LILYGO板，连接已经内置。如果是分立模块，主要连接如下：

• SIM800L VCC->ESP32 4.2V（需能提供2A峰值电流）
• SIM800L GND->ESP32 GND
• SIM800L TX->ESP32 RX（如GPIO16）
• SIM800L RX->ESP32 TX（如GPIO17）
• SIM800L RST->ESP32任一GPIO（用于硬件复位）

3.2 洞洞板焊接实战与血泪教训

为了项目的稳固性，我没有一直用面包板，而是转向了洞洞板（万用板）焊接。这是整个硬件制作中最容易出错、也最考验耐心的环节。

我的步骤是：先将所有模块（ESP32、TP4056、传感器）和排针焊接到洞洞板上，规划好大致布局，电源走一边，信号线走另一边。然后用细导线（如AWG22）根据原理图进行连接。这里我踩了一个大坑：在焊接I2C的SCL线时，由于焊点过于密集，我不小心将SCL线和旁边的一个GND焊盘桥接短路了。当时没发现，上电后I2C总线彻底瘫痪，所有传感器都找不到。

我花了整整一天半的时间排查：换传感器、换代码、用逻辑分析仪抓波形、怀疑ESP32的I2C引脚坏掉……各种绝望。最后用万用表的蜂鸣档，一个点一个点地测通断，才找到这个该死的短路点。用吸锡器清理后，一切恢复正常。那一刻的解脱感，难以言表。

给你的洞洞板焊接建议：

1. 先规划，后焊接：用笔画一下布局，尽量让电源路径简洁，信号线避免交叉。
2. 使用不同颜色的导线：电源正极用红色，负极用黑色，SDA用绿色，SCL用黄色。这样一目了然，便于后期调试。
3. 焊点要圆润饱满，但切忌过多锡：过多的锡极易造成相邻焊盘短路。焊接完成后，务必用放大镜或手机微距模式仔细检查每一个焊点。
4. 万用表是你的最佳朋友：焊接完每一根线，都用万用表通断档检查一下，确认连接正确且没有与不该连的地方短路。
5. 考虑升级为定制PCB：如果你对这个项目很认真，或者打算批量制作几个，强烈建议学习使用KiCad或EasyEDA设计一块定制PCB。成本不高（几十块钱），但能彻底告别飞线和短路烦恼，可靠性和美观度提升不止一个档次。我把这个作为未来的优化计划。

4. 嵌入式端程序开发与配置

4.1 开发环境搭建与核心库依赖

我选择使用Arduino IDE进行开发，因为它对ESP32和ESP8266的支持已经非常完善，且库管理方便。首先，需要在Arduino IDE的“开发板管理器”中添加ESP32和ESP8266的支持。随后，通过“库管理器”安装以下关键库：

• Adafruit BME280 Library：用于读取BME280传感器数据。
• Adafruit SI1145 Library：用于读取SI1145紫外线传感器数据。
• TinyGSM：这是一个极其优秀的库，它用一套统一的API封装了不同GSM模块（如SIM800、SIM900、A6等）的AT指令操作，让我们的代码可以轻松在GSM和WiFi模式间切换。
• ArduinoJson：用于构建要发送给服务器的JSON数据包。

代码结构主要包含几个部分：传感器初始化与读取、网络连接管理（GSM/WiFi）、数据打包与HTTP发送、以及低功耗睡眠循环（如果需要）。

4.2 关键代码段解析与配置要点

1. 网络连接配置（以GSM为例）：这是代码中最需要根据你的实际情况修改的部分。

// 你的SIM卡APN信息（由运营商提供） #define APN "your.apn.here" // 例如，中国移动的物联网卡可能是"cmnet" #define GPRS_USER "" // 通常为空 #define GPRS_PASS "" // 通常为空 // 你的服务器信息 #define SERVER "your.domain.com" // 或服务器IP地址 #define PATH "/api/post-data.php" // 接收数据的API路径 #define PORT 80 // HTTP端口 // 初始化TinyGSM TinyGsm modem(SerialAT); // SerialAT是连接SIM800L的硬件串口 TinyGsmClient client(modem);

你需要向你的SIM卡运营商（或物联网卡服务商）询问确切的APN（接入点名称）。用户名和密码大部分公开APN都是留空。

2. 数据读取与JSON构建：

void readSensors() { temperature = bme.readTemperature(); humidity = bme.readHumidity(); pressure = bme.readPressure() / 100.0F; // 转换为百帕 uvIndex = uv.readUV() / 100.0; // 转换UV指数 // 电池电压通过ADC读取并换算 batteryVoltage = (float)analogRead(BAT_ADC_PIN) / 4095.0 * 3.3 * 2; // 假设用了1:1分压 } String buildJsonPayload() { StaticJsonDocument<256> doc; doc["api_key"] = "your_secret_api_key_here"; // 用于服务器端验证 doc["temp"] = temperature; doc["hum"] = humidity; doc["press"] = pressure; doc["uv"] = uvIndex; doc["batt"] = batteryVoltage; // ... 其他字段 String payload; serializeJson(doc, payload); return payload; }

这里引入了一个api_key字段，这是一个简单的安全措施，防止任何人随意向你的服务器发送数据。在服务器端的PHP代码中会验证这个密钥。

3. HTTP POST发送数据：

bool sendData(String payload) { if (!modem.isNetworkConnected()) { Serial.println("Network not connected"); return false; } if (!client.connect(SERVER, PORT)) { Serial.println("Server connection failed"); return false; } client.print(String("POST ") + PATH + " HTTP/1.1\r\n"); client.print(String("Host: ") + SERVER + "\r\n"); client.print("Content-Type: application/json\r\n"); client.print("Content-Length: " + String(payload.length()) + "\r\n\r\n"); client.print(payload); // 等待并读取响应（可选，用于调试） delay(1000); while (client.available()) { String line = client.readStringUntil('\n'); Serial.println(line); } client.stop(); return true; }

4. 主循环与深度睡眠（节能关键）：对于太阳能供电，节能至关重要。我们可以让ESP32在两次数据发送间隔进入深度睡眠模式。

#define uS_TO_S_FACTOR 1000000ULL // 微秒到秒的转换因子 #define TIME_TO_SLEEP 900 // 睡眠时间（秒），例如900秒=15分钟 void loop() { readSensors(); if (sendData(buildJsonPayload())) { Serial.println("Data sent successfully!"); } else { Serial.println("Send failed, will retry after sleep."); } // 进入深度睡眠 Serial.flush(); esp_sleep_enable_timer_wakeup(TIME_TO_SLEEP * uS_TO_S_FACTOR); esp_deep_sleep_start(); // 代码执行将在此暂停，直到定时器唤醒重启 }

深度睡眠模式下，ESP32的功耗可以降到10微安左右，加上SIM800L模块在非通信时段也可以设置为最低功耗模式，整个系统的平均功耗可以做得非常低，仅靠小太阳能板就能维持。

5. 服务器端搭建与数据可视化

5.1 PHP后端与MySQL数据库设计

服务器端需要完成两件事：接收数据并存入数据库，以及提供网页查询数据。我使用最经典的LAMP（Linux, Apache, MySQL, PHP）栈。

首先，在MySQL中创建一张表来存储数据：

CREATE TABLE `weather_data` ( `id` int(11) NOT NULL AUTO_INCREMENT, `api_key` varchar(50) DEFAULT NULL, `temperature` float DEFAULT NULL, `humidity` float DEFAULT NULL, `pressure` float DEFAULT NULL, `uv_index` float DEFAULT NULL, `battery_voltage` float DEFAULT NULL, `read_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `read_time` (`read_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

api_key字段用于验证请求来源，read_time字段自动记录数据到达服务器的时间，并为其建立索引，这在查询历史数据时能极大提升效率。

接着，创建接收数据的PHP脚本（post-data.php）：

<?php header('Content-Type: application/json'); $servername = "localhost"; $username = "your_db_username"; $password = "your_db_password"; $dbname = "your_db_name"; // 获取POST的原始JSON数据 $json = file_get_contents('php://input'); $data = json_decode($json, true); // 1. 验证API密钥 $valid_api_key = "your_secret_api_key_here"; if (!isset($data['api_key']) || $data['api_key'] !== $valid_api_key) { http_response_code(403); // Forbidden echo json_encode(['error' => 'Invalid API key']); exit; } // 2. 连接数据库 $conn = new mysqli($servername, $username, $password, $dbname); if ($conn->connect_error) { http_response_code(500); echo json_encode(['error' => 'Database connection failed']); exit; } // 3. 准备并执行插入语句（使用预处理语句防止SQL注入） $stmt = $conn->prepare("INSERT INTO weather_data (api_key, temperature, humidity, pressure, uv_index, battery_voltage) VALUES (?, ?, ?, ?, ?, ?)"); $stmt->bind_param("sddddd", $data['api_key'], $data['temp'], $data['hum'], $data['press'], $data['uv'], $data['batt'] ); if ($stmt->execute()) { echo json_encode(['status' => 'success']); } else { http_response_code(500); echo json_encode(['error' => 'Data insertion failed']); } $stmt->close(); $conn->close(); ?>

这个脚本做了三件关键事：验证身份、连接数据库、安全地插入数据。返回JSON格式的响应，便于ESP32端判断是否发送成功。

5.2 前端可视化页面制作

前端页面（index.php）的目标是清晰、美观地展示数据。我使用了Bootstrap框架快速搭建响应式布局，并利用Chart.js库来绘制历史数据曲线图。

页面的核心部分包括：

1. 实时数据看板：用大号字体卡片展示最新的温度、湿度、气压、UV指数和电池电压。
2. 历史数据图表：使用Chart.js绘制折线图。通过AJAX技术，前端JavaScript会定期（或由用户选择时间范围）向另一个PHP API（get-data.php）请求数据。

// 示例：使用Fetch API获取最近24小时的数据 fetch('/api/get-data.php?hours=24') .then(response => response.json()) .then(data => { // 使用Chart.js绘制图表 new Chart(ctx, { type: 'line', data: { labels: data.timestamps, // 时间戳数组 datasets: [{ label: '温度 (°C)', data: data.temperatures, // 温度数组 borderColor: 'rgb(255, 99, 132)', tension: 0.1 }] } }); });

3. 设备状态显示：可以显示最后收到数据的时间，如果超过一定间隔（如1小时），则提示“设备可能离线”。

为了让页面自动刷新最新数据，可以使用JavaScript的setInterval函数定时（比如每60秒）调用一次数据获取函数。整个前端代码虽然看起来不少，但得益于Bootstrap和Chart.js，大部分都是组装现成的组件，逻辑并不复杂。

6. 外壳设计与3D打印

6.1 模型选择与修改

设备要放在户外，一个防水、防尘、又能让太阳能板充分接触阳光的外壳必不可少。我在Thingiverse上找到了一个设计精巧的“小房子”模型作为基础。它的斜面屋顶正好用来倾斜放置太阳能板，内部空间也足够容纳我的电路板和电池。

但是，原模型的开孔位置和我的元件布局不匹配。我使用免费的在线工具Tinkercad导入了STL文件，进行了修改：

• 侧面开孔：为SIM800L的外接天线接口开了一个小孔。
• 底部开孔：为BME280传感器开了几个小栅格，既要保证空气流通以准确测量温湿度，又要防止雨水直接溅入。
• 内部支柱调整：根据我的洞洞板尺寸和电池 holder 的位置，调整了内部用于固定螺丝的支柱位置。

6.2 打印参数与后期处理

我将修改好的模型导入到Ultimaker Cura进行切片。打印参数设置如下：

• 材料：PLA（最常用，强度足够，价格便宜）。如果追求更好的耐候性，可以考虑PETG。
• 层高：0.2mm。这是一个平衡打印质量和时间的常用设置。
• 填充密度：15%。对于这种外壳，不需要太高的填充，15%在保证结构强度的同时节省材料和时间。
• 打印温度：喷嘴200°C，热床60°C。这是PLA的通用温度。
• 打印速度：50 mm/s。
• 支撑：对于屋檐下方的悬空部分，需要生成支撑材料。

整个房子主体的打印耗时约13小时，屋顶门（单独打印）约2小时。打印完成后，需要小心地去除支撑材料，并用小锉刀或砂纸打磨毛刺和开孔边缘。为了进一步提升防水性，我还在外壳接缝处和开孔周围涂抹了一层薄薄的电子设备专用硅胶密封胶。注意，不要涂到传感器感应区。

7. 系统集成、调试与常见问题排查

7.1 整机组装与上电测试

将所有部件装入3D打印的外壳时，顺序很重要：

1. 先将电池放入 holder 并固定好。
2. 将焊接好的主控板用M2或M3螺丝固定在底板的支柱上。
3. 连接电池到TP4056，连接太阳能板到TP4056。
4. 将BME280传感器用热熔胶或螺丝固定在底部的通风孔内侧，确保其感应部分暴露在空气中。
5. 把SIM卡插入SIM800L模块，并接好外置天线（天线对信号强度影响巨大，务必安装）。
6. 最后合上屋顶，拧紧螺丝。

首次上电前，务必用万用表再次检查电源线路，确保没有短路。可以先不接太阳能板，只用充满电的电池供电。上电后，观察：

• 电源指示灯是否正常亮起。
• ESP32的串口输出（通过USB连接电脑查看）是否有启动日志。
• SIM800L的指示灯是否开始闪烁（搜索网络时是慢闪，注册成功后是快闪）。

7.2 典型问题与解决方案实录

在开发和部署过程中，我遇到了几乎所有可能遇到的问题，这里整理成排查清单：

关于MAX17043电量计读数不准的补充：我最终放弃了直接使用它。一个更稳定的方案是使用ESP32的ADC引脚，配合一个简单的电阻分压电路（例如两个1MΩ电阻串联）来测量电池电压。然后在代码中建立一个电压-电量的查找表。虽然精度不如专用芯片，但对于判断“电量充足”、“电量中等”、“电量低”这几个状态已经足够，且电路简单可靠。

整个项目从构思到最终落地，耗时超过一个月，但收获远超预期。它不仅是一个能用的气象站，更是一个涵盖了硬件设计、嵌入式编程、网络通信、服务器开发和3D打印的综合性工程实践。当你第一次在手机上看到从遥远角落传回来的实时环境数据时，那种成就感是无与伦比的。这个开源项目最大的价值在于其完整的可复现性，你可以完全照做，也可以在此基础上任意发挥——比如增加土壤湿度传感器用于农业监测，或者增加一个LoRa模块组建星型传感器网络。物联网的世界，大门已经为你打开。