编写程序让智能洗手液机检测手部靠近，自动出液，无需按压。

项目实战基于红外测距的智能洗手液机控制系统一、实际应用场景描述 (Scenario)在机场、医院、办公楼等公共场所传统的按压式洗手液机存在卫生隐患——每个人都需要接触同一个泵头容易造成细菌交叉感染。目标通过红外接近传感器IR Proximity Sensor检测手部位置当手部进入感应区域通常距离喷嘴 5‑15 cm时自动触发微型泵或电磁阀实现免接触出液。二、引入痛点 (Pain Points)1. 交叉感染风险多人接触同一表面病毒传播链难以切断。2. 操作不便手上拿着物品时难以腾出手按压泵头。3. 浪费严重手动按压力度不均有时按到底造成液体飞溅或过量出液。4. 维护困难缺乏液位检测经常遇到空瓶仍在使用的情况。三、核心逻辑讲解 (Core Logic)本系统采用“主动红外测距 → 数字滤波 → 防抖锁存 → PWM驱动执行器”的控制架构1. 信号采集层模拟 SHARP GP2Y0A21YK0F 红外测距传感器或 VL53L0X激光测距。输出模拟电压与距离成反比。2. 距离解算通过标定曲线或查表将 ADC 值转换为毫米级距离。3. 迟滞比较 (Hysteresis)* 触发阈值 (Trigger)手部距离 10 cm。* 释放阈值 (Release)手部距离 15 cm。防止手部在临界点时泵机反复启停。4. 状态锁存 (Latch)一次感应只出液一次例如 0.8 秒避免手部停留导致持续喷涌。四、代码模块化实现 (Code Implementation)项目结构如下smart_sanitizer/├── main.py # 主程序入口├── config.py # 配置文件├── sensors/│ └── ir_sensor.py # 红外测距传感器模块├── core/│ └── dispenser_logic.py # 出液控制逻辑├── actuators/│ └── pump_driver.py # 微型泵驱动模块└── README.md1. config.py (配置文件)# config.py# 智能洗手液机系统配置# --- 红外测距参数 ---ADC_RESOLUTION 1024 # 10-bit ADCVREF 3.3 # 参考电压# --- 距离阈值 (单位: cm) ---DETECTION_TRIGGER_CM 10.0 # 触发出液的最大距离DETECTION_RELEASE_CM 15.0 # 释放复位的最小距离 (迟滞)# --- 执行器参数 ---DISPENSE_DURATION_SEC 0.8 # 单次出液时长PUMP_PWM_DUTY 70 # 泵机PWM占空比 (%)# --- 防抖参数 ---STABILITY_SAMPLES 3 # 连续稳定采样次数2. sensors/ir_sensor.py (红外传感器模拟)# sensors/ir_sensor.pyimport randomimport mathclass InfraredProximitySensor:模拟红外接近传感器实际硬件: SHARP GP2Y0A21YK0F 或 VL53L0X原理: 红外发射管发射光线接收管检测反射强度def __init__(self, noise_level5):self.noise_level noise_levelself._distance_cm 50.0 # 默认无物体def set_hand_distance(self, distance_cm: float):外部接口设置模拟的手部距离self._distance_cm distance_cmdef read_distance_cm(self) - float:读取距离 (cm)模拟逻辑加入噪声模拟真实环境光干扰# 简化的距离-ADC模型 (反比关系)noise random.uniform(-self.noise_level, self.noise_level)measured_distance self._distance_cm noisereturn max(2.0, measured_distance) # 距离下限2cm3. core/dispenser_logic.py (核心控制逻辑 - 状态机)# core/dispenser_logic.pyfrom enum import Enum, autofrom config import *class DispenserState(Enum):IDLE auto() # 空闲等待手部DISPENSING auto() # 正在出液LOCKED auto() # 锁定等待手部移开class DispenserLogic:洗手液机核心逻辑控制器使用带迟滞的状态机def __init__(self):self.state DispenserState.IDLEself.stable_counter 0self.dispense_timer 0def update(self, distance_cm: float) - bool:更新状态机:return: True if should dispense, False otherwise# 判断是否在感应区内is_in_range distance_cm DETECTION_TRIGGER_CMif self.state DispenserState.IDLE:if is_in_range:self.stable_counter 1if self.stable_counter STABILITY_SAMPLES:self.state DispenserState.DISPENSINGself.dispense_timer DISPENSE_DURATION_SECself.stable_counter 0return True # 触发出液else:self.stable_counter 0elif self.state DispenserState.DISPENSING:# 出液完成后进入锁定状态self.dispense_timer - 0.1 # 假设每次update间隔0.1sif self.dispense_timer 0:self.state DispenserState.LOCKEDelif self.state DispenserState.LOCKED:# 只有当手部远离后才解锁if distance_cm DETECTION_RELEASE_CM:self.state DispenserState.IDLEreturn False4. actuators/pump_driver.py (执行器驱动)# actuators/pump_driver.pyimport timeclass PumpDriver:微型泵/电磁阀驱动类实际硬件: MOSFET DC Water Pump 或 微型隔膜泵def __init__(self, pwm_pin18):self.pwm_pin pwm_pinself.is_active Falsedef activate(self, duration_sec: float):激活泵机指定时长self.is_active Trueprint(f [PUMP] 泵机启动出液 {duration_sec} 秒...)# 实际硬件代码:# pwm.start(PUMP_PWM_DUTY)# time.sleep(duration_sec)# pwm.stop()self.is_active Falseprint( [PUMP] 出液完成。)5. main.py (主程序)# main.pyimport timefrom sensors.ir_sensor import InfraredProximitySensorfrom core.dispenser_logic import DispenserLogicfrom actuators.pump_driver import PumpDriverdef main():print( 智能洗手液机启动...)sensor InfraredProximitySensor()logic DispenserLogic()pump PumpDriver()# 模拟手部动作序列hand_sequence [(50.0, 2), # 手很远等待(8.0, 1), # 手靠近(7.0, 3), # 手停留(20.0, 2), # 手拿开]seq_idx 0try:while True:dist sensor.read_distance_cm()print(f[SENSOR] Distance: {dist:.2f} cm, end\r)should_dispense logic.update(dist)if should_dispense:pump.activate(DISPENSE_DURATION_SEC)time.sleep(0.1)except KeyboardInterrupt:print(\n系统关闭。)if __name__ __main__:main()五、README.md 文件# Smart Sanitizer - 智能免接触洗手液机## 项目简介这是一个基于 Python 的智能仪器模拟项目实现了公共场所常见的自动出液洗手液机核心逻辑。## 功能特性* 红外接近测距模拟* 带迟滞效应的防抖控制* 状态机管理 (空闲/出液/锁定)* 单次定量出液控制## ️ 运行指南bashpython main.py## 运行逻辑1. 程序启动传感器检测前方距离。2. 当手部距离小于 10cm 时触发泵机。3. 泵机工作 0.8 秒后停止并进入锁定状态。4. 手部移开 (15cm) 后系统恢复空闲状态。六、核心知识点卡片 (Knowledge Cards)领域 知识点 说明智能仪器 非接触式传感 利用红外线反射原理避免接触污染。嵌入式控制 迟滞比较 (Hysteresis) 设置不同的触发/释放阈值防止临界点振荡。电机控制 PWM (脉宽调制) 通过调节占空比控制微型泵的流量或速度。人机交互 状态锁存 (Latching) 一次触发只执行一次动作避免重复响应。七、总结 (Summary)在这个项目中我们实现了一个看似简单却蕴含丰富工程思维的智能设备。想强调“用户体验是由细节定义的”。如果没有迟滞Hysteresis和状态锁存Latching当你把手放在感应区时机器可能会发出“咔哒咔哒咔哒”的疯狂抽液声——这在工程上称为“颤振Chattering”。通过引入DETECTION_TRIGGER_CM 和DETECTION_RELEASE_CM 的差值以及LOCKED 状态我们赋予了机器一种“记忆”和“决断力”。这套代码架构可以直接移植到树莓派或 ESP32 上配合真实的红外传感器即可制作出合格的防疫设备。如果你对硬件感兴趣下一步可以探讨如何使用 ToF (Time of Flight) 激光测距传感器 来进一步提升感应精度️利用AI解决实际问题如果你觉得这个工具好用欢迎关注长安牧笛