基于ESP32的便携式紫外线与多参数环境监测终端

1. 项目概述

紫外线（UV）辐射强度是影响人体健康与户外活动安全的重要环境参数。过量紫外线暴露可导致皮肤晒伤、光老化甚至增加皮肤癌风险，而适度紫外线照射则有助于维生素D合成。在气象监测、农业光照管理、户外运动装备及个人健康防护等领域，实时、便携的紫外线强度检测设备具有明确的应用价值。本项目设计并实现了一款基于ESP32-WROOM-32D的集成式环境感知终端——简易ESP紫外线检测盒。该设备不仅采集核心的紫外线指数（UVI），还同步获取环境温湿度、大气压强与海拔高度，并通过Wi-Fi联网获取实时天气、空气质量及网络时间信息，最终在1.8英寸TFT屏幕上以多级菜单形式进行可视化呈现。

项目定位为一款功能完整、工程可复现的嵌入式环境监测终端。其设计遵循“传感器数据采集→本地处理→网络服务交互→人机界面呈现”的典型物联网终端架构。硬件层面采用模块化设计思路，主控、传感、显示、电源与人机交互各子系统边界清晰；软件层面采用分层架构，将硬件驱动、网络协议栈、业务逻辑与用户界面解耦，便于功能扩展与维护。整机采用单板集成方案，PCB尺寸紧凑，配合3D打印外壳，具备良好的便携性与实用性。所有设计决策均以工程可靠性、成本可控性与开发可维护性为优先考量，不追求技术堆砌，而是聚焦于解决实际场景中的核心需求。

2. 系统架构与功能定义

2.1 整体系统框图

系统由五大功能域构成：主控与通信域、环境传感域、人机交互域、显示输出域以及电源管理域。各域之间通过标准数字接口互联，形成一个闭环的数据流与控制流系统。

• 主控与通信域：以ESP32-WROOM-32D-N8为核心，承担全部数据处理、任务调度、Wi-Fi通信及外设驱动职责。其内置双核Xtensa LX6处理器、丰富的片上外设（SPI、I²C、ADC、PWM、LED PWM控制器）及完整的Wi-Fi/BLE射频前端，为本项目提供了理想的硬件基础。
• 环境传感域：包含三个独立传感器节点。GUVA-S12SD作为紫外线传感器，其输出为模拟电压信号，需经ADC采样后换算为UVI；AHT20为数字式温湿度传感器，通过I²C总线传输高精度数据；BMP280为数字式气压/温度传感器，同样挂载于I²C总线，其气压数据可用于计算相对海拔高度。
• 人机交互域：采用四档机械式拨轮开关作为主要输入设备，提供直观、可靠、低功耗的页面切换与功能选择能力；板载RESET与BOOT按键用于系统调试与固件更新。
• 显示输出域：采用1.8英寸ST7735S驱动的TFT LCD屏幕，分辨率为128×160像素。屏幕通过SPI总线与主控高速通信，并支持通过GPIO引脚独立控制背光亮度，实现功耗优化。
• 电源管理域：支持双电源输入模式——USB Type-C外部供电或3.7V锂聚合物电池供电。系统内置PMOS电源路径管理电路，确保外部电源接入时自动切断电池放电回路；同时集成TP4056线性充电管理芯片，为锂电池提供恒流/恒压充电功能。

2.2 核心功能详解

2.2.1 紫外线指数（UVI）检测

GUVA-S12SD是一款专为紫外线波段（240–370 nm）设计的硅光电二极管传感器。其核心特性在于对UVA与UVB波段具有高灵敏度，且对可见光与红外光具有良好的抑制能力。传感器输出为微弱的光电流，项目中采用运放搭建的跨阻放大电路将其转换为0–3.3 V范围内的模拟电压信号，再由ESP32的ADC1通道进行采样。根据DFRobot官方提供的校准数据，电压值与UVI呈近似线性关系：0.00–0.20 V对应UVI 0–1（低风险），0.20–0.40 V对应UVI 2–3（中等风险），0.40–0.60 V对应UVI 4–5（高风险），0.60–0.80 V对应UVI 6–7（很高风险），0.80–1.00 V对应UVI 8–10（极高风险）。固件中通过查表法或线性插值法将ADC读数映射为整数UVI值，并在UI层标注相应的风险等级与防护建议。

2.2.2 多参数环境监测

• 温湿度监测（AHT20）：AHT20是一款高精度、低功耗的数字温湿度传感器，采用I²C接口，支持单次测量与周期测量模式。其典型精度为±0.3℃（温度）与±2%RH（湿度），响应时间快，长期稳定性好。在本项目中，AHT20被配置为单次触发模式，每30秒执行一次完整测量，所得数据用于环境舒适度评估与气象数据融合。
• 气压与海拔监测（BMP280）：BMP280是一款高精度数字气压传感器，同时集成温度传感器。其气压测量范围为300–1100 hPa，绝对精度达±0.12 hPa（等效于±1米海拔误差）。项目利用其气压与温度数据，通过国际标准大气模型（ISA）公式计算相对海拔高度：h = 44330 * (1 - (P/P₀)^(1/5.255))，其中P为实测气压，P₀为海平面标准气压（1013.25 hPa）。该计算结果虽为相对值，但对判断所处地形（如室内楼层、山地海拔变化）具有实用参考价值。

2.2.3 网络化气象信息服务

设备通过Wi-Fi接入互联网，调用第三方API获取权威气象数据：

• 和风天气API：项目接入其免费开发者计划，每日1000次调用配额足以满足个人使用需求。通过/weather/now接口获取当前温度、体感温度、天气状况、风速风向及湿度；通过/weather/daily接口获取未来6天逐日最高/最低温、天气预报及降水概率；通过/air/now接口获取PM2.5、PM10、SO₂、NO₂、CO、O₃等六项核心空气质量参数及AQI指数。
• NTP网络授时：使用NTPClient库向公共NTP服务器（如pool.ntp.org）发起时间同步请求，获取UTC时间后，根据设备配置的时区偏移量（如东八区+8小时）计算本地时间，确保时钟显示准确。
• 哔哩哔哩用户数据：通过调用https://api.bilibili.com/x/relation/stat?vmid={uid}接口，可获取指定UP主的关注数（following）与粉丝数（follower），作为UI中一个趣味性信息展示模块。

2.2.4 多级用户界面（UI）系统

UI系统采用树状菜单结构，共设计4个一级功能页：

• 主页（Home）：集中显示当前UVI、温度、湿度、气压、海拔、时间及日期，是信息密度最高的概览页面。
• 天气页（Weather）：分为“今日天气”与“未来预报”两个子页，前者展示当前天气图标、温度、体感、风速及空气质量；后者以横向滚动列表形式展示未来6天的天气图标、最高/最低温及简要描述。
• 设置页（Settings）：提供Wi-Fi配网入口、屏幕亮度调节（0–100%）、背光超时关闭时间设置（30s–5min）及系统重启选项。
• 关于页（About）：显示固件版本号、设备MAC地址、开发信息及版权说明。

所有页面均采用TFT_eSPI图形库绘制，支持自定义字体、图标与色彩方案。UI响应逻辑由OneButton库驱动，拨轮开关的短按、双击、长按事件被分别映射为“页面切换”、“进入子页”与“返回上级”操作，符合直觉化交互设计原则。

3. 硬件设计详述

3.1 主控电路设计

ESP32-WROOM-32D-N8模块集成了ESP32-D0WD-Q6芯片、4MB PSRAM、8MB Flash及匹配的无源晶振与RF巴伦。其外围电路严格遵循Espressif官方《ESP32-WROOM-32D Data Sheet》推荐设计：

• 复位电路：采用RC延时复位方案，R=10kΩ，C=100nF，确保上电时序满足芯片要求。原设计中BOOT按钮旁的100nF电容被证实会导致上电异常，已移除，仅保留必要的复位按键。
• 晶振电路：32.768 kHz RTC晶振（Y1）与26 MHz主晶振（Y2）均采用0603封装，旁路电容选用22pF NP0材质，布局紧邻芯片对应引脚，走线短而直，避免干扰。
• RF匹配与天线：模块自带PCB板载天线，馈点处预留π型匹配网络（L1, C1, C2），出厂已预调谐，无需额外调整。所有RF相关走线均远离高速数字信号线，并在其下方铺满接地铜箔。

3.2 电源管理电路

3.2.1 双电源自动切换

电路采用一颗SI2301 P沟道MOSFET（Q1）作为电源路径开关。其工作原理如下：当USB 5V输入存在时，Q1的栅极（G）通过R1（10kΩ）被拉至5V，源极（S）为5V，故V_GS≈ 0V，Q1关断，电池（BAT）供电回路被切断；当USB移除后，Q1的G极通过R2（100kΩ）被下拉至地，S极为BAT电压（约3.7–4.2V），故V_GS< 0V，Q1导通，系统由BAT供电。该设计实现了无缝、无损耗的电源切换，且无反向电流风险。

3.2.2 锂电池充电管理

TP4056芯片构成完整的单节锂电充电解决方案。其关键外围元件包括：

• 充电电流设定电阻（R_prog）：根据BOM中选用的2.4kΩ电阻，充电电流I_CHG= 1200 / R_prog(kΩ) ≈ 500 mA，符合1C充电规范，兼顾速度与电池寿命。
• 电池保护：芯片内部集成过充（4.25V）、过放（2.9V）、过流（1.5A）及过热（125℃）多重保护机制。
• 状态指示：CHRG引脚驱动LED1（红灯）指示充电中，STDBY引脚驱动LED2（绿灯）指示充电完成或待机。

3.3 传感器与外设接口

3.3.1 紫外线传感电路

GUVA-S12SD输出光电流I_PH，典型值为0.14 µA/(µW/cm²)。电路采用LM358双运放中的一路构建跨阻放大器（TIA）：传感器阳极接运放反相输入端，阴极接地；反馈电阻R_f= 10 MΩ，将I_PH转换为电压V_out= I_PH× R_f。例如，当UVI=5时，辐照度约5 mW/cm²，I_PH≈ 0.7 µA，V_out≈ 7 V，超出ESP32 ADC量程，故在运放输出端串联分压电阻网络（R1=2MΩ, R2=1MΩ），使V_out衰减至0–3.3 V范围内。运放同相输入端通过100kΩ电阻接地，提供直流偏置。

3.3.2 I²C总线设计

AHT20与BMP280共享同一I²C总线（SCL: GPIO21, SDA: GPIO22）。为保障信号完整性，总线上配置了4.7kΩ上拉电阻（R_{pu_scl}, R_{pu_sda}）至3.3V。两器件地址分别为0x38（AHT20）与0x76（BMP280），无地址冲突。固件中在初始化传感器前，显式调用Wire.begin(21, 22)指定引脚，避免默认引脚（22, 21）与屏幕SPI MISO引脚冲突。

3.3.3 TFT显示接口

ST7735S屏幕通过标准SPI 4线制（MOSI, SCLK, CS, DC）与ESP32连接。关键引脚分配如下：

• TFT_MOSI: GPIO23
• TFT_SCLK: GPIO18
• TFT_CS: GPIO5 （片选，低有效）
• TFT_DC: GPIO2 （数据/命令控制）
• TFT_RST: GPIO4 （硬件复位，亦可设为-1使用ESP32内部复位）
• TFT_BL: GPIO17 （背光PWM控制）

TFT_eSPI库的User_Setup.h文件需精确配置上述引脚及屏幕参数（ST7735_DRIVER,TFT_WIDTH=128,TFT_HEIGHT=160,ST7735_GREENTAB2），否则将出现花屏、颜色错乱或无法初始化等问题。

3.3.4 人机交互与灯光

• 拨轮开关：四档机械开关，每档对应一个独立的GPIO（GPIO12, 13, 14, 15），采用上拉输入模式（内部或外部上拉），通过检测引脚电平变化识别档位切换。
• WS2812灯珠：单颗RGB LED，数据线（DIN）连接至GPIO16。使用FastLED库驱动，通过DMA方式发送精确时序的单线协议信号，实现全彩渐变与呼吸效果。

4. 软件架构与关键实现

4.1 开发环境与框架

项目基于PlatformIO IDE与VS Code构建，采用Arduino框架。核心软件栈分层如下：

• 硬件抽象层（HAL）：封装所有底层外设驱动（sensor_aht20_init()、sensor_bmp280_init()、tft_init()），向上提供统一的C函数接口。
• 中间件层：包含Wi-Fi管理（wifi_connect()）、HTTP客户端（doClient()）、JSON解析（ArduinoJson）、NTP时间同步（NTPClient）等通用服务。
• 应用层：实现业务逻辑，如get_weather_now()解析API响应并提取关键字段，sensor_uv_data()执行ADC采样与UVI查表。
• UI层：ui目录下存放所有页面绘制函数（ui_draw_home(),ui_draw_weather()），button目录处理拨轮开关状态机。

4.2 关键代码片段分析

4.2.1 UVI数据采集与处理

// sensor/sensor_uv.c #include "driver/adc.h" #include "esp_adc_cal.h" #define ADC_CHANNEL ADC1_CHANNEL_6 // GPIO34 #define ADC_WIDTH ADC_BITWIDTH_12 #define ADC_ATTEN ADC_ATTEN_DB_11 static esp_adc_cal_characteristics_t *adc_chars; void sensor_uv_init(void) { adc1_config_width(ADC_WIDTH); adc1_config_width(ADC_ATTEN); adc_chars = calloc(1, sizeof(esp_adc_cal_characteristics_t)); esp_adc_cal_value_t val = esp_adc_cal_characterize(ADC_UNIT_1, ADC_ATTEN, ADC_WIDTH, DEFAULT_VREF, adc_chars); } uint8_t sensor_uv_data(void) { uint32_t adc_reading = adc1_get_raw((adc1_channel_t)ADC_CHANNEL); uint32_t voltage_mv = esp_adc_cal_raw_to_voltage(adc_reading, adc_chars); // UVI mapping based on voltage (mV) if (voltage_mv < 200) return 0; else if (voltage_mv < 400) return 2; else if (voltage_mv < 600) return 4; else if (voltage_mv < 800) return 6; else return 8; }

4.2.2 Wi-Fi配网流程（SoftAP模式）

// network/wifi_config.c #include <WiFi.h> #include <WebServer.h> WebServer server(80); void ap_init(void) { WiFi.softAP("ESP_UV_BOX_WIFI", "uvbox123"); IPAddress IP = WiFi.softAPIP(); Serial.printf("AP IP address: %s\n", IP.toString().c_str()); } void handleRoot() { String html = "<html><body><h1>UV Box Config</h1>" "<form action='/config' method='POST'>" "SSID: <input name='ssid'><br>" "Password: <input name='pass'><br>" "Location ID: <input name='loc_id'><br>" "<input type='submit' value='Save'></form></body></html>"; server.send(200, "text/html", html); } void handleConfigWifi() { String ssid = server.arg("ssid"); String pass = server.arg("pass"); String loc_id = server.arg("loc_id"); // Save to SPIFFS or NVS preferences.putString("wifi_ssid", ssid); preferences.putString("wifi_pass", pass); preferences.putString("loc_id", loc_id); server.send(200, "text/plain", "Saved! Restarting..."); delay(1000); ESP.restart(); }

4.2.3 TFT背光PWM控制

// ui/ui_common.c #include "driver/ledc.h" #define LEDC_CHANNEL LEDC_CHANNEL_0 #define LEDC_TIMER LEDC_TIMER_0 #define LEDC_GPIO 17 #define LEDC_RESOLUTION 8 // 0-255 void backlight_init(void) { ledc_timer_config_t timer_conf = { .speed_mode = LEDC_LOW_SPEED_MODE, .timer_num = LEDC_TIMER, .duty_resolution = LEDC_RESOLUTION, .freq_hz = 5000, .clk_cfg = LEDC_AUTO_CLK }; ledc_timer_config(&timer_conf); ledc_channel_config_t channel_conf = { .gpio_num = LEDC_GPIO, .speed_mode = LEDC_LOW_SPEED_MODE, .channel = LEDC_CHANNEL, .intr_type = LEDC_INTR_DISABLE, .timer_sel = LEDC_TIMER, .duty = 0, .hpoint = 0 }; ledc_channel_config(&channel_conf); } void set_backlight(uint8_t brightness) { // 0-100% uint32_t duty = (brightness * 255) / 100; ledc_set_duty(LEDC_LOW_SPEED_MODE, LEDC_CHANNEL, duty); ledc_update_duty(LEDC_LOW_SPEED_MODE, LEDC_CHANNEL); }

5. 物料清单（BOM）与选型依据

6. 实物制作与调试要点

6.1 PCB焊接与装配

• 传感器焊接：AHT20与BMP280为0.4mm间距QFN封装，强烈建议使用恒温热风枪与助焊膏。焊接前需用尖头烙铁清理焊盘氧化层，热风温度设为350℃，风速中档，待焊锡熔融后迅速移开，避免芯片过热失效。
• CH340K下载电路：确保D+与D-线长度匹配，USB接口外壳必须良好接地，以抑制EMI。若出现下载失败，首先检查CH340K的VCC是否稳定为5V，其次确认D+、D-与ESP32的GPIO12、GPIO13（默认USB引脚）连接正确。
• 屏幕排线：1.8寸TFT通常采用0.5mm间距FPC连接器。插入排线时需用力均匀，听到“咔哒”声表示锁扣到位；拔出时先用镊子轻压锁扣两侧再水平抽出，切忌斜向硬拔导致排线断裂。

6.2 软件调试常见问题

• 屏幕不显示：检查User_Setup.h中TFT_CS、TFT_DC、TFT_RST引脚定义是否与原理图一致；确认ST7735_GREENTAB2宏已启用；使用逻辑分析仪抓取SPI波形，验证MOSI/SCLK时序是否正常。
• Wi-Fi无法配网：确认ap_init()中SSID与密码未含非法字符；检查handleRoot()生成的HTML是否被浏览器缓存，可强制刷新（Ctrl+F5）；在server.handleClient()前添加Serial.println("Handling client...")确认WebServer循环是否运行。
• 传感器读数异常：AHT20/BMP280需在Wire.begin()后初始化；GUVA-S12SD的ADC参考电压必须为3.3V（非1.1V），且adc_chars校准结构体需在sensor_uv_init()中正确初始化。

7. 性能测试与实测数据

在标准实验室环境下（25℃，50%RH，常压），对设备核心功能进行量化测试：

该设备已通过基础功能验证，各项指标达到设计预期，可作为一款可靠的个人环境监测工具投入日常使用。