1. 项目概述
触控版月球灯是一种面向便携式室内照明场景的智能LED灯具，其设计目标是在保留传统月球灯柔和漫射光效与艺术造型的基础上，彻底重构人机交互方式与能源管理逻辑。区别于市面常见的AC220V供电、机械按键或旋钮控制、单色温输出的月球台灯，本项目采用锂电池供电架构，集成环境光感知、电容式触摸交互、全彩RGB动态调光及电池状态闭环管理四大核心能力，构建出一套低功耗、高响应、自适应的嵌入式照明系统。
该系统以STM32L431RCT6作为主控制器，依托其超低功耗运行模式（Stop2模式下典型电流<1.5μA）、丰富的模拟外设（12位ADC、比较器）以及成熟的电容触摸感应库（STM32CubeMX Touch Sensing Library），实现了在资源受限的单芯片平台上完成多模态传感融合与实时灯光渲染。整机待机功耗控制在2mA量级（当前版本），实测在2000mAh锂聚合物电池供电下可维持约30天待机时间；工作状态下，10颗WS2812B灯珠满亮度运行时整机峰值功耗约350mW，满足USB充电口5V/500mA输入条件下的持续点亮需求。
项目并非单纯的功能叠加，而是在工程约束下进行的系统性权衡：选用单总线RGB LED而非分立RGB方案，降低PCB布线复杂度与BOM成本；采用PCB铜箔直接构成触摸电极，规避专用触摸IC带来的面积与成本开销；将光敏电阻置于底座边缘非直射区域，兼顾环境光采样准确性与结构隐蔽性；所有电源路径均设置过压、过流、反接及深度放电保护，确保消费级电池在长期循环使用中的安全性。这些设计选择共同指向一个明确的工程目标——在不牺牲用户体验的前提下，将智能照明功能压缩进直径80mm、高度120mm的紧凑柱状空间内。
2. 硬件系统设计
2.1 主控与电源管理架构
主控单元采用意法半导体STM32L431RCT6微控制器，该芯片基于ARM Cortex-M4F内核，主频80MHz，内置256KB Flash与64KB SRAM，支持多种低功耗模式。其关键特性与本项目需求高度匹配：
- 超低功耗能力：Stop2模式下典型电流为1.28μA（带RTC与SRAM保持），Standby模式下低至0.8μA，为实现长周期待机提供硬件基础；
- 高精度模拟前端：12位ADC具备硬件采样保持功能，支持16通道复用，可同时采集光敏电阻分压值、电池电压、充电电流等多路模拟信号；
- 丰富定时资源：拥有5个16位通用定时器与2个32位高级定时器，其中TIM1/TIM8支持互补PWM输出，虽本项目未使用，但为后续扩展冷暖白光混合调光预留接口；
- 内置电容触摸控制器（TSI）：支持最多18个电极通道，无需外部RC网络即可实现高抗扰触摸检测，本项目启用TSI_CH0~CH2三个通道对应三枚PCB触摸电极。
电源管理模块采用分层设计策略，分为输入级、电池管理级与负载供电级三级：
| 模块层级 | 功能描述 | 关键器件 | 工程考量 |
|---|---|---|---|
| 输入级 | USB 5V输入接入与极性保护 | D1（SS34肖特基二极管） | 防止USB线反插导致后级损坏，正向压降低（0.5V@3A），减少发热 |
| 电池管理级 | 锂电池充放电管理、过充/过放/过流保护 | IP5306电源管理SOC | 集成线性充电（最大500mA）、同步升压（5V/1A）、电池电量计量、四级LED电量指示，简化外围电路 |
| 负载供电级 | 为MCU、传感器、LED提供稳定电压 | AMS1117-3.3（LDO） | 低噪声、高PSRR（65dB@1kHz），保障ADC与触摸检测精度；输入耐压15V，兼容IP5306升压输出波动 |
IP5306作为核心电源管理芯片，其内部集成了完整的锂电池保护逻辑：当电池电压低于2.4V时自动切断放电回路（过放保护）；高于4.25V时停止充电（过充保护）；放电电流超过2.5A持续10ms触发过流保护。该芯片通过I²C接口与STM32通信，可读取实时电池电压、剩余容量百分比及充电状态标志，为软件层实现精准电量提示与低电量预警提供数据支撑。
2.2 光学系统与LED驱动设计
光源部分采用10颗WS2812B智能LED灯珠，每颗集成控制IC与RGB三色芯片，支持单线串行协议（归零码宽650ns±150ns，逻辑“1”高电平持续700ns，逻辑“0”高电平持续350ns）。灯珠按空间对称原则分布于灯柱内壁：顶部2颗、左侧2颗、右侧2颗、正面2颗、背面2颗，形成五组双灯单元。此布局兼顾光学均匀性与结构装配便利性——双灯并联安装可降低单点失效对整体光效的影响，五向分布则确保360°视角下均有光源覆盖，避免传统单侧布灯产生的明暗分区现象。
WS2812B的驱动在当前版本中采用GPIO模拟时序方式实现，由PA8引脚（TIM1_CH1复用）配置为推挽输出模式，通过精确控制高低电平持续时间生成符合协议要求的脉冲序列。该方案优势在于硬件成本趋近于零，且便于调试时观察波形；劣势在于占用大量CPU时间（发送24bit数据需约30μs，10颗共需300μs），在高刷新率（>60Hz）场景下易引发主程序卡顿。代码中已预留SPI硬件加速接口，计划后续利用SPI的DMA传输配合IO重映射，将WS2812B数据帧打包为特定格式（如SPI时钟极性/相位配置为Mode0，数据高位在前），通过SPI_TX引脚输出经电平转换后的方波信号，从而释放CPU资源用于环境光自适应算法运算。
光学扩散结构采用双层设计：内层为磨砂PC材质月球模型壳体，表面经喷砂处理形成微米级凹凸结构，使LED点光源转化为均匀面光源；外层为半透明亚克力罩，进一步柔化光线边缘，消除可见光斑与眩光。实测在距离灯体50cm处，照度分布标准差小于15%，符合IEC 62471光生物安全标准中对无危险类（Exempt Group）灯具的要求。
2.3 触摸交互与环境光感知电路
触摸按键采用PCB覆铜直接构成电极，三枚电极呈弧形排列于底座上表面，尺寸均为12mm×12mm，间距3mm，铜箔厚度35μm。电极底部敷设完整地平面，四周设置宽度≥2mm的隔离槽，有效抑制邻近电极间耦合干扰。每个电极通过100kΩ限流电阻连接至MCU的TSI_CHx引脚，该电阻既限制ESD泄放电流，又构成RC滤波网络（与电极寄生电容共同作用）提升抗噪能力。
环境光检测采用GL5528型光敏电阻，其亮电阻（10lux）为5~10kΩ，暗电阻（0lux）达0.5MΩ，光谱响应范围380~750nm，与人眼视见函数高度吻合。电路采用分压式接法：光敏电阻一端接3.3V，另一端接ADC_IN0（PA0），对地并联100nF陶瓷电容滤除高频噪声。该设计使ADC采样值在0~4095范围内对应光照强度约0.1~1000lux，满足从夜间床头灯到日间阅读灯的全场景覆盖需求。为消除温度漂移影响，软件层在每次采样前执行两次间隔100ms的连续读取，取平均值作为有效数据，实测25℃环境下1小时漂移量<2%FS。
2.4 电池接口与保护机制
电池接口采用JST-PH2.0两针插座，支持3.7V锂聚合物电池（标称容量2000mAh，尺寸30×40×5mm）。为防止电池反接损坏IP5306，电路在电池正极输入路径串联一颗SS34肖特基二极管（D2），其正向导通压降0.5V，在2A放电电流下功耗仅1W，远低于保险丝熔断式保护方案的热积累风险。同时，IP5306内部集成的0.1Ω电流检测电阻配合12位ADC，可实现±50mA精度的充放电电流监测，为动态功率分配算法提供依据。
深度放电保护通过双重机制实现：第一层为IP5306硬件保护（2.4V阈值），第二层为软件保护（MCU ADC检测到电池电压≤3.0V时强制进入休眠模式）。两者协同工作，确保电池循环寿命不低于300次（按IEC 62133标准测试）。
3. 软件系统实现
3.1 系统状态机与低功耗调度
软件框架基于状态机模型构建，定义四种核心状态：
- OFF_STATE：所有外设关闭，MCU处于Stop2模式，仅RTC与TSI唤醒源有效；
- IDLE_STATE：MCU运行于16MHz HSI RC时钟，ADC以10Hz频率轮询光敏电阻与电池电压，触摸引擎持续扫描；
- RUNNING_STATE：WS2812B刷新率设为30Hz，执行色彩渐变、呼吸灯、随机闪烁等预设模式；
- CHARGING_STATE：检测到USB插入且电池电压<4.1V时进入，禁用LED输出，启动IP5306充电流程。
状态切换由中断驱动：TSI检测到有效触摸事件触发EXTI9_5_IRQHandler，唤醒MCU并解析按键组合；RTC每秒产生一次更新中断（RTC_Alarm），用于维护系统时间戳与低功耗计时；ADC转换完成触发ADC1_2_IRQHandler，读取模拟量并更新状态变量。所有中断服务程序均遵循“快进快出”原则，仅置位标志位，具体业务逻辑在主循环中处理，避免中断嵌套导致的时序紊乱。
低功耗调度的关键在于外设时钟门控与电源域管理。在OFF_STATE下，通过RCC->AHB1ENR与RCC->APB1ENR寄存器关闭所有外设时钟；进入Stop2模式前，调用HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI)指令，此时1.2V内核域保持供电，但Flash、SRAM及大部分模拟外设断电。唤醒后，系统自动恢复HSI时钟并重新初始化必要外设，整个过程耗时<50μs。
3.2 触摸按键识别算法
触摸识别采用电荷转移（Charge Transfer）原理，TSI模块通过内部恒流源对电极充电，再测量放电时间常数。原始数据经数字滤波后送入自适应阈值判断引擎：
// 简化版触摸识别伪代码 uint16_t baseline[3] = {0}; // 各电极基线值 uint16_t threshold[3] = {0}; // 动态阈值 void TSI_Scan(void) { for(uint8_t i=0; i<3; i++) { uint16_t raw = HAL_TSI_ReadData(&htsi, i); // 读取原始计数值 baseline[i] = 0.95f * baseline[i] + 0.05f * raw; // IIR滤波 threshold[i] = baseline[i] + 150; // 基线+固定偏移 if(raw > threshold[i]) touch_flag |= (1<<i); // 触发标记 } }为提升鲁棒性，引入两级确认机制：单次扫描触发后，连续3次扫描（间隔20ms）均满足阈值条件才判定为有效触摸；若检测到多电极同时触发，则启动2秒倒计时，期间任一电极释放即清零计时器。该设计有效过滤偶然静电干扰与手掌误触，实测误触发率<0.1%。
3.3 WS2812B驱动与时序控制
GPIO模拟驱动的核心在于精确延时。由于Cortex-M4内核执行一条NOP指令耗时12.5ns（80MHz主频），故采用汇编内嵌方式编写关键延时函数：
__attribute__((naked)) void delay_ns(uint32_t ns) { uint32_t cycles = ns / 12; __asm volatile ( "mov r0, %0\n\t" "loop: subs r0, r0, #1\n\t" "bne loop\n\t" "bx lr" : : "r"(cycles) : "r0" ); }实际驱动函数中，对每个bit执行三次延时调用：
- 发送“1”：
delay_ns(700); GPIO_SET(); delay_ns(600); GPIO_RESET(); - 发送“0”：
delay_ns(350); GPIO_SET(); delay_ns(800); GPIO_RESET();
为避免编译器优化破坏时序，在函数声明中添加__attribute__((optimize("O0")))强制关闭优化。当前版本单颗灯珠24bit数据发送耗时约28.5μs，10颗串联共285μs，占30Hz刷新周期（33.3ms）的0.85%，余量充足。
3.4 光感自适应与色彩映射算法
环境光自适应逻辑采用分段线性映射策略，将ADC采样值（0~4095）映射为LED亮度系数（0~255）：
| 光照区间(lux) | ADC值范围 | 亮度系数 | 行为说明 |
|---|---|---|---|
| 0~1 | 0~100 | 0 | 完全熄灭，节能优先 |
| 1~10 | 100~500 | 10~60 | 微光模式，仅顶部2颗灯珠低亮 |
| 10~100 | 500~2000 | 60~180 | 常规模式，全灯珠中等亮度 |
| >100 | >2000 | 180~255 | 高亮模式，全灯珠满幅输出 |
色彩控制采用HSV色彩空间进行插值运算，用户通过左/右键调节色相（H），中键调节饱和度（S）与明度（V）。软件预置12种常用色相（0°红、30°橙...330°品红），每种色相对应一组RGB查找表（256字节），避免实时计算三角函数带来的性能损耗。实际输出时，先查表获取RGB值，再根据当前亮度系数进行比例缩放：
uint8_t r_out = (r_table[hue] * brightness) >> 8; uint8_t g_out = (g_table[hue] * brightness) >> 8; uint8_t b_out = (b_table[hue] * brightness) >> 8;该方案在保证色彩还原度的同时，将单次色彩更新运算量控制在200周期以内（Cortex-M4@80MHz），满足实时交互需求。
4. BOM清单与关键器件选型依据
| 序号 | 器件名称 | 型号 | 数量 | 选型依据 | 封装 |
|---|---|---|---|---|---|
| 1 | 主控芯片 | STM32L431RCT6 | 1 | 超低功耗+触摸+ADC集成度高，供货稳定 | LQFP64 |
| 2 | 智能LED | WS2812B | 10 | 单线控制、内置恒流、成熟生态，性价比最优 | 5050 |
| 3 | 电源管理 | IP5306 | 1 | 充放电管理+电量计量二合一，节省PCB面积 | QFN24 |
| 4 | 线性稳压器 | AMS1117-3.3 | 1 | 低压差、高PSRR，保障模拟电路信噪比 | SOT-223 |
| 5 | 光敏电阻 | GL5528 | 1 | 亮/暗电阻比>100，光谱响应匹配人眼 | Φ5mm |
| 6 | 肖特基二极管 | SS34 | 2 | 反向耐压40V，正向压降低，适合电池保护 | SMA |
| 7 | USB接口 | Micro-USB-B | 1 | 标准化接口，兼容主流充电线 | 表贴直插 |
| 8 | 电池连接器 | JST-PH2.0 | 1 | 锁扣结构防脱落，接触电阻<20mΩ | 直插 |
所有无源器件均选用X7R介质MLCC（如100nF/0805）与厚膜电阻（1%精度），确保在-20℃~60℃工作温度范围内参数稳定性。PCB采用1.6mm FR-4双面板，顶层为信号走线与触摸电极，底层为完整地平面，电源路径加宽至20mil以上，降低阻抗与温升。
5. 实测性能与优化方向
整机在25℃恒温环境下完成以下关键指标验证：
- 待机功耗：2.1mA（含IP5306自身消耗），较设计目标略高，主因是TSI模块在Stop2模式下仍存在微安级漏电流；
- 触摸响应延迟：从手指接触电极到LED颜色变化平均为85ms，满足人机工程学要求（<100ms）；
- 光感响应精度：在10~100lux区间内，亮度调节步进误差≤±5%；
- 电池续航：2000mAh电池在中等亮度（120/255）下可持续点亮约18小时；
- 充电效率：USB 5V/500mA输入下，从10%充至100%耗时2.3小时，转换效率82%。
针对当前版本存在的三项待优化项，提出具体改进路径：
- 待机功耗优化：将TSI唤醒源迁移至独立超低功耗MCU（如TI MSP430FR2155），仅负责触摸检测与RTC计时，检测到有效触摸后通过GPIO唤醒主MCU。预估可将待机电流降至5μA量级；
- WS2812B驱动升级：启用SPI+DMA方案，配置SPI1为Mode0，CLK=3.33MHz（对应WS2812B 1.25μs/bit），利用DMA双缓冲机制实现后台数据推送，释放CPU资源用于更复杂的色彩算法；
- 光感非线性补偿：增加温度传感器（如NTC10K）采集环境温度，建立GL5528阻值-光照-温度三维查表，消除高温导致的灵敏度衰减。
上述优化均已在原理图层面预留硬件接口，无需修改PCB即可完成迭代升级。
