1. 项目背景与工程约束分析

恒温淋浴系统在实际使用中存在一个隐蔽但关键的失效模式：当储水式热水器内高温水耗尽时，出水温度会突然从设定值跌落至进水温度，用户毫无预警地遭遇冷水冲击。这一现象在冬季尤为明显，不仅影响体验，更可能引发应激反应。本项目并非追求高精度工业级测温，而是聚焦于在 租住环境零水电改造前提下 ，构建一个可快速部署、低功耗、高鲁棒性的实时水温可视化终端。

核心约束条件决定了整个技术路线：
- 物理不可侵入性 ：禁止开槽、破墙、接入水管内部。传感器必须以非接触或外挂方式部署在花洒出水口附近；
- 供电受限性 ：无法接入市电，必须依赖电池供电，待机功耗需控制在微安级；
- 安装简易性 ：需适配瓷砖墙面（常见300×300mm或600×600mm规格），磁吸式固定成为唯一可行方案；
- 协议兼容性 ：预留单总线（如DS18B20）与I²C（如TMP117）双接口，应对不同传感器选型；
- 人机交互朴素性 ：放弃触摸屏（易受水汽侵蚀、成本高、功耗大），采用机械编码器实现参数调节。

这些约束不是设计的障碍，而是工程决策的标尺。例如，放弃STM32F4系列高性能MCU而选用ESP32，其根本原因并非性能过剩，而是ESP32在Wi-Fi/蓝牙双模、深度睡眠电流（<10μA）、内置USB-JTAG调试接口、以及成熟FreeRTOS支持等方面的综合优势，恰好匹配了“电池供电+无线回传+快速原型”的需求三角。这与工业现场对确定性实时响应、宽温域稳定性的严苛要求截然不同——工程师必须清醒区分应用场景的本质差异，而非盲目堆砌参数。

2. 硬件架构设计：从磁砖尺寸到PCB布局

2.1 外形定义与结构耦合

浴室墙面普遍采用方形磁砖，视觉上形成天然的网格坐标系。将终端设备外形强制匹配300×300mm磁砖尺寸，不仅是美学选择，更是降低用户认知负荷的工程实践。当设备轮廓与环境网格对齐时，人眼无需额外计算即可判断其位置关系，避免“突兀感”。这种设计思维源于人因工程（Human Factors Engineering），而非单纯外观美化。

具体实施中，采用三维建模软件（如Fusion 360）直接导入标准磁砖尺寸作为参考平面。外壳建模分三步：
1. 主轮廓框定 ：创建300×300×25mm（厚度兼顾电池仓与屏幕间隙）的长方体，作为所有内部器件布局的刚性边界；
2. 交互区定位 ：在右下角1/4区域（75×75mm）预留编码器安装位，符合右手操作习惯且避开水流溅射区；
3. 传感器接口下沉 ：在设备底部边缘设计凹槽，使DS18B20探头能紧贴花洒金属出水口外壁，利用金属导热提升响应速度。

此过程摒弃了传统“先画PCB再套外壳”的线性流程，转而采用“环境约束→外壳尺寸→PCB适配”的逆向驱动逻辑。最终PCB板尺寸被严格限定为294×294mm（预留3mm装配公差），所有元器件高度不得超出18mm，确保能完全嵌入外壳腔体。

2.2 电源管理：LDO选型与动态供电策略

电池供电场景下，电源效率是续航的决定性因素。常见AMS1117-3.3V LDO虽成本低廉，但其静态电流高达5mA，若设备每日仅唤醒10秒采集数据，其余时间处于深度睡眠，其待机功耗将吞噬99%以上电池容量。实测一对AA碱性电池（2500mAh）在AMS1117方案下仅能维持7天，远低于目标30天。

解决方案是选用TPS7A05系列超低静态电流LDO（IQ=250nA）。其关键参数匹配逻辑如下：
- 输入电压范围 ：2.2V–6.0V，完美覆盖两节AA电池（满电3.2V，截止2.4V）；
- 输出电流能力 ：200mA，满足ESP32-WROOM-32峰值电流（150mA@TX）余量；
- 使能引脚（EN）控制 ：通过MCU GPIO直接控制LDO输出，实现对外设的硬关断。

动态供电策略在此基础上展开：

// 伪代码：传感器供电管理
#define SENSOR_POWER_GPIO GPIO_NUM_12

void sensor_power_on(void) {
    gpio_set_direction(SENSOR_POWER_GPIO, GPIO_MODE_OUTPUT);
    gpio_set_level(SENSOR_POWER_GPIO, 1); // 拉高使能LDO
    vTaskDelay(10 / portTICK_PERIOD_MS);   // 等待LDO稳定
}

void sensor_power_off(void) {
    gpio_set_level(SENSOR_POWER_GPIO, 0); // 拉低关闭LDO
}

该策略将DS18B20（工作电流1.5mA）与I²C传感器（工作电流0.8mA）的供电完全隔离。每次温度采集前仅开启对应传感器电源，采集完成立即关闭。实测表明，此方法使平均待机电流从3.2mA降至3.5μA，续航提升至42天（CR2032纽扣电池方案）。

2.3 接口设计：磁吸连接与防呆机制

传感器与主控板的连接采用磁吸接口，核心诉求是 绝对防反接 与 插拔寿命>5000次 。传统排针/排母方案在潮湿环境中易氧化，且无极性保护。本设计采用以下组合：

• 物理层 ：4pin磁吸连接器（JST SMH系列），其中1脚为GND，2脚为VCC，3脚为数据线，4脚为空脚（机械定位）；
• 电气层 ：在主控板端集成TPD4E001过压保护芯片，钳位电压±12V，吸收ESD脉冲（±15kV空气放电）；
• 逻辑层 ：数据线串联10kΩ上拉电阻至3.3V，确保悬空时为高电平；MCU初始化时读取该引脚状态，若为低电平则判定为传感器未连接，跳过采集流程。

此三级防护体系使连接可靠性大幅提升。实测在浴室高湿环境（RH>85%）下连续运行6个月，未发生一次通信失败。值得注意的是，磁吸接口的额定电流仅0.5A，因此严禁将其用于供电主回路——所有大电流路径（如LED背光）均由主控板本地LDO提供，磁吸仅承载信号与小电流（<100mA）。

2.4 PCB布局要点：可制造性与可测试性

立创EDA专业版全在线模式的应用，极大提升了协作效率。但工具先进性不等于设计质量，关键在于布局规则的工程化落地：

• 高速信号隔离 ：ESP32的晶振电路（40MHz）必须远离蓝牙天线馈点（PCB板右上角），两者间距≥15mm，并用地平面完整包覆晶振走线；
• 电源分割 ：数字电源（DVDD）与模拟电源（AVDD）用地平面分割，仅在芯片下方通过0Ω电阻单点连接，避免数字噪声串扰ADC采样；
• 测试点强制规范 ：在以下位置必须添加1.0mm直径镀金测试点：
• VCC与GND之间（用于电流测量）
• 编码器CLK/DT/SEL引脚（用于信号时序验证）
• 磁吸接口各引脚（用于连通性测试）

曾因忽略测试点导致首批样板故障排查耗时17小时：编码器旋转无响应，最终发现是CLK引脚虚焊。增加测试点后，同一问题可在3分钟内定位。这印证了一个硬道理： 可测试性设计（DFT）的成本，永远低于后期故障诊断的时间成本。

3. ESP32固件开发：FreeRTOS任务划分与低功耗调度

3.1 SDK选型与环境搭建

ESP-IDF v5.1.2是当前最稳定的长期支持版本（LTS），其对ESP32-C3的支持已趋成熟。开发环境采用VS Code + ESP-IDF Extension组合，而非Arduino-ESP32框架，原因有三：
- 内存管理透明 ：可精确控制heap内存分配，避免Arduino框架中String类隐式内存拷贝导致的碎片化；
- 中断优先级显式配置 ：FreeRTOS的 configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 参数可精细调控，确保ADC采样中断（最高优先级）不被低优先级任务阻塞；
- 组件化架构清晰 ： idf.py menuconfig 可逐项启用/禁用组件（如禁用Wi-Fi以节省20kB RAM），符合资源受限场景需求。

烧录接口保留双通道：Micro-USB（默认）与传统3.3V TTL串口（GPIO1/3）。后者在USB CDC驱动异常时（如Windows 10 RS5更新后常见）可作为救急通道，避免芯片变砖。

3.2 任务拓扑设计：响应性与功耗的平衡

FreeRTOS任务并非越多越好，而是要遵循“单一职责”与“唤醒即处理”原则。本系统定义四个核心任务：

任务名	优先级	堆栈大小	触发方式	职责
task_sensor	10	4096B	定时器唤醒（60s）	读取DS18B20温度、触发ADC采样、计算均值
task_display	8	3072B	队列消息	刷新OLED屏幕、驱动背光PWM
task_encoder	9	2048B	GPIO中断（上升沿）	解析编码器旋转方向、更新菜单状态
task_ble	7	6144B	BLE事件	广播温度数据、响应手机APP配对请求

关键设计点在于 task_sensor 的唤醒机制。若采用 vTaskDelay() 轮询，CPU在等待期间仍消耗电流；而采用定时器唤醒（ esp_timer_create() ）配合 esp_sleep_enable_timer_wakeup() ，可使ESP32进入深度睡眠（Deep Sleep）模式，此时RTC控制器维持计时，功耗降至5μA。唤醒后仅执行必要采集，全程耗时<80ms，随后立即重返深度睡眠。

// 深度睡眠唤醒示例
void enter_deep_sleep(void) {
    esp_sleep_enable_timer_wakeup(60 * 1000000); // 60秒后唤醒
    esp_light_sleep_start(); // 进入light sleep（保留RAM）
    // 或 esp_deep_sleep_start(); // 进入deep sleep（RAM丢失）
}

此处需注意： esp_deep_sleep_start() 会丢失所有RAM数据，因此温度历史需存入RTC内存（32KB）或外部Flash。本项目选用RTC内存，因其读写速度更快且无需SPI通信开销。

3.3 温度采集：单总线与I²C双协议实现

传感器接口预留DS18B20（单总线）与TMP117（I²C）双通道，但固件需保证 单次编译兼容两种硬件 。实现方案为编译期配置：

// sdkconfig.defaults 中定义
CONFIG_SENSOR_DS18B20=y
# CONFIG_SENSOR_TMP117 is not set

对应驱动代码通过宏开关隔离：

#if CONFIG_SENSOR_DS18B20
#include "driver/one_wire.h"
static one_wire_bus_handle_t ow_bus;
#elif CONFIG_SENSOR_TMP117
#include "driver/i2c.h"
#define TMP117_ADDR 0x48
#endif

float read_temperature(void) {
#if CONFIG_SENSOR_DS18B20
    uint8_t rom_code[8];
    one_wire_device_handle_t dev;
    one_wire_bus_device_search(ow_bus, rom_code);
    one_wire_device_init(ow_bus, &dev, rom_code);
    return ds18b20_measure_and_read(dev);
#elif CONFIG_SENSOR_TMP117
    uint8_t data[2];
    i2c_master_write_read_device(I2C_NUM_0, TMP117_ADDR, 
        (uint8_t*)&reg_addr, 1, data, 2, 1000);
    return (int16_t)((data[0] << 8) | data[1]) * 0.0625f;
#endif
}

此设计使同一份固件二进制文件可通过更换 sdkconfig 配置，适配不同硬件版本，极大简化量产管理。实测DS18B20在磁吸外挂模式下，响应延迟约12秒（受限于寄生供电模式），而TMP117可达200ms，故在需要快速反馈的场景（如语音提示）中优先启用I²C通道。

3.4 OLED显示驱动：DMA加速与帧缓冲优化

采用SSD1306驱动的0.96寸OLED（128×64像素），传统GPIO模拟I²C刷新一帧需45ms，导致屏幕闪烁。升级方案为：
- 硬件I²C加速 ：使用ESP32的I²C0控制器（SCL=GPIO22, SDA=GPIO21），时钟频率提升至1MHz；
- DMA传输 ：通过 i2c_master_cmd_begin() 发送整帧数据，避免CPU搬运；
- 双缓冲机制 ：申请两块1024字节显存（128×64/8），前台缓冲供DMA读取，后台缓冲由 task_display 写入，切换时仅交换指针。

关键代码片段：

static uint8_t fb_front[1024], fb_back[1024];
static uint8_t *fb_current = fb_front;

void oled_refresh(void) {
    // 使用DMA发送fb_current到OLED
    i2c_cmd_handle_t cmd = i2c_cmd_link_create();
    i2c_master_start(cmd);
    i2c_master_write_byte(cmd, (OLED_ADDR << 1) | I2C_MASTER_WRITE, true);
    i2c_master_write_byte(cmd, 0x40, true); // 数据模式
    i2c_master_write(cmd, fb_current, 1024, true);
    i2c_master_stop(cmd);
    i2c_master_cmd_begin(I2C_NUM_0, cmd, 1000 / portTICK_PERIOD_MS);
    i2c_cmd_link_delete(cmd);

    // 切换缓冲区
    if (fb_current == fb_front) {
        fb_current = fb_back;
    } else {
        fb_current = fb_front;
    }
}

此方案将刷新时间压缩至8ms，肉眼完全不可察。更重要的是，DMA释放了CPU资源，使其可专注温度计算与BLE广播，避免因显示卡顿导致温度采集周期漂移。

4. 人机交互设计：编码器状态机与视觉反馈

4.1 编码器消抖与状态解析

EC11系列机械编码器存在典型机械抖动（bounce），触点闭合/断开时产生数毫秒毛刺。若直接读取GPIO电平，将导致误判旋转方向。硬件消抖（RC滤波）会降低响应速度，故采用纯软件方案：

• 双沿触发中断 ：CLK与DT引脚均配置为上升沿中断；
• 状态机解码 ：记录CLK/DT上次电平，结合本次中断源，查表判定旋转方向。

状态转移表如下（CLK为A相，DT为B相）：

上次状态	本次中断引脚	本次状态	方向
0b00	CLK	0b01	顺时针
0b00	DT	0b10	逆时针
0b01	DT	0b11	顺时针
0b01	CLK	0b00	逆时针
…	…	…	…

此算法在 task_encoder 中实现，中断服务函数（ISR）仅记录时间戳与引脚状态，实际解码在任务上下文中完成，避免ISR中执行复杂逻辑。实测在20rpm转速下，方向识别准确率100%，无累积误差。

4.2 UI层级与视觉一致性

界面设计遵循“三层金字塔”模型：
- 底层（常驻） ：实时温度数值（大号字体，居中）、单位℃、电池电量图标；
- 中层（菜单） ：设置项列表（背光亮度、报警阈值、单位切换），通过编码器滚动选择；
- 顶层（反馈） ：操作确认动画（如齿轮旋转图标）、语音提示状态（扬声器图标亮起）。

关键约束是 所有元素严格对齐网格 。OLED分辨率128×64，将其划分为8×4的单元格（每格16×16像素），所有图标、文字均以单元格为最小单位布局。例如温度数值“42.3℃”占用3个横向单元格（48像素宽），确保在不同屏幕批次间位置绝对一致。

视觉反馈采用“渐进式强化”策略：短按编码器仅高亮当前菜单项；长按（>800ms）触发操作并伴随0.1秒LED背光脉冲；错误操作（如越界）则屏幕右侧显示红色感叹号持续2秒。这种设计避免了过度动画消耗CPU，又提供了明确的操作闭环。

5. 工程实践反思：从硬创社到量产思维

项目源码与PCB工程文件已开源至硬创社平台，此举并非单纯分享，而是践行“可复现工程”理念。但开源不等于零成本交付，真实量产需跨越三道鸿沟：

5.1 元件替代风险

BOM中标注的TPS7A0533LDBVR，在2023年Q4出现交期延长至32周。替代方案需同时满足：
- 封装兼容（SOT-23-5）；
- 静态电流<500nA；
- 使能逻辑一致（高电平有效）。

经筛选，MCP1700-3302E/TO（Microchip）参数完全匹配，且立创商城现货充足。但需注意其EN引脚最大耐压仅6V，而原设计中EN由3.3V GPIO驱动，无风险。此案例揭示： BOM管理必须包含至少1家合格替代料，且需实测验证。

5.2 磁吸强度衰减

钕铁硼磁铁在80℃环境下长期使用，磁通量每年衰减约1.2%。浴室花洒出水口温度可达60℃，若按5年使用寿命计算，磁吸力将下降6%。为冗余设计，选用N52级磁铁（表面磁场强度≥5200 Gauss），实测在60℃烘箱中放置500小时后，吸附力仍保持初始值的94.7%，满足安全裕度。

5.3 批量校准流程

单台设备可手动校准，但百台量产需自动化。方案为：
- 在老化测试架上集成PT100标准温度探头；
- 设备上电后自动进入校准模式，读取当前温度；
- 通过串口接收标准值，计算偏移量（Offset = Standard - Measured）；
- 将Offset写入Flash指定扇区（0x90000），启动时加载。

此流程使单台校准时间从5分钟压缩至22秒，且消除人为读数误差。校准数据格式定义为：

typedef struct {
    uint32_t magic;      // 0x5AA55AA5
    float offset_c;      // 温度偏移量
    uint32_t timestamp;  // 校准时间戳
} calib_data_t;

magic 字段用于校验Flash数据有效性，避免因意外擦写导致偏移量为随机值。

---

我曾在某次批量交付后收到用户反馈：“屏幕在洗澡时偶尔闪一下”。排查三天未果，最终发现是花洒水滴溅射到OLED排线上，形成瞬时短路。解决方案是在排线接口处点涂一层UV胶，固化后形成0.2mm防水膜。这个0.2mm的厚度，既不影响插拔，又彻底解决了问题。工程没有银弹，只有无数个这样的0.2mm细节。