1. 项目概述一个融合了实用与创意的智能小装置最近在整理工作室的杂物时翻出了一个闲置许久的Adafruit Circuit Playground Express开发板。这板子集成了10颗可编程RGB LED、运动传感器、光线传感器、温度传感器甚至还有麦克风和扬声器功能相当齐全但一直没想好拿它做什么。直到有一次在公共卫生间看到那个需要手动按压才能出泡沫的洗手液瓶以及旁边那个经常失灵的红外感应水龙头我忽然有了灵感为什么不做一个完全“非接触式”的洗手计时兼小夜灯呢这个想法很简单但很实用。它的核心功能是当你把手靠近时装置通过传感器检测到动作自动启动一个20秒的洗手计时并用LED灯带以动态光效进行视觉提示同时播放一段轻快的提示音。计时结束后灯光自动切换为柔和的夜灯模式提供低亮度的环境照明。整个过程无需触碰任何物理按钮既卫生又有趣。这不仅仅是一个简单的计时器更是将物联网的交互思维融入日常生活的一个小尝试。它非常适合放在家庭卫生间、儿童房或者作为创客教育中一个融合了编程、电子和产品思维的入门项目。实现它我们主要会用到Circuit Playground Express板载的电容触摸传感器模拟非接触检测、光线传感器控制夜灯自动开关、以及那圈炫酷的NeoPixel LED。编程环境则选择微软的MakeCode它提供图形化积木和JavaScript代码两种视图对新手和希望深入学习的开发者都非常友好。接下来我将从设计思路、硬件解析、代码实现到调试优化完整拆解这个项目的每一个环节。2. 核心硬件解析与选型思考2.1 主控核心为什么是Circuit Playground Express在众多微控制器中选择Circuit Playground Express后文简称CPX是基于它“开箱即用”的特性。对于这样一个集成多种功能的小项目使用Arduino Uno或ESP32等开发板意味着你需要额外连接LED灯带、声音模块和至少一个传感器不仅接线复杂体积也难以控制。CPX则将所有需要的元件浓缩在了一个直径约5厘米的圆形PCB上。集成度板载10个可独立寻址的NeoPixel RGB LED呈环形排列非常适合做进度指示和光效。一个光敏电阻光线传感器用于感知环境光强度一个运动传感器实际上是三轴加速度计以及多个电容触摸引脚。对于“非接触”检测我们虽然不直接触摸但可以利用电容传感器的敏感特性当手靠近时引起的电容微小变化也能被检测到这比单纯使用红外对管或超声波模块更简单、成本更低。易用性CPX支持USB供电和编程自带电池插座可以很方便地做成独立设备。其MakeCode开发环境提供了高度封装的积木块例如直接控制所有LED的颜色、读取光线传感器数值、播放内置旋律等极大降低了开发门槛。扩展性尽管我们本次项目只用板载资源但其边缘的多个鳄鱼夹插孔为未来添加外部传感器如真正的红外距离传感器以提升检测精度或执行器留下了可能。注意CPX上的电容触摸引脚如A1, A2, A3...默认需要直接触摸金属部分才能触发。为了实现“非接触”我们需要调整其灵敏度并利用其电容感应场微弱的延伸性。实测发现将手悬停在引脚上方1-2厘米处配合正确的代码设置可以稳定触发。2.2 传感器的工作原理解读与调参本项目的智能感知依赖于两个核心传感器电容触摸传感器用于触发光线传感器用于决策。电容式近距检测原理 CPX的电容触摸并非简单的开关。其原理是每个可触摸的引脚和它周围的地线构成一个电容。当手指或手掌靠近时相当于加入了一个接地的导体改变了这个电容的电场从而增加了该节点的对地电容。芯片内部通过测量该引脚电容的微小变化来判断触摸或接近事件。在MakeCode中这被抽象为一个on pin A1 touch的事件积木。为了实现非接触我们需要在代码中反复测试找到一个合适的悬空距离阈值这个距离会受到环境湿度、周围金属物体的影响。光线传感器与夜灯自动化 板载的光线传感器是一个光敏电阻其电阻值随光照强度增加而减小。CPX的模拟数字转换器ADC读取其分压后的电压值并映射到一个0-255的数值范围MakeCode中通常为0-100%或0-255的亮度值。我们将利用这个值来实现夜灯的“自动模式”当环境光亮度低于某个阈值例如小于20%且洗手计时未激活时自动开启低亮度夜灯当环境光变亮则自动关闭夜灯以节省电量。声音反馈的考量 CPX板载了一个小型蜂鸣器可以通过脉冲宽度调制PWM播放简单的旋律。在洗手计时启动和结束时加入声音提示能提供多模态反馈尤其对儿童或视觉辅助场景很有帮助。但需注意在夜间模式下应避免突然发出声音。因此代码中需要设置一个“静音时段”或根据光线传感器判断是否为夜晚。3. MakeCode 编程实现与核心逻辑拆解我们将使用MakeCode的JavaScript模式进行编程这样代码更清晰也方便后续复杂功能的扩展。整个程序的逻辑可以分为几个状态空闲等待、洗手计时、夜灯模式。3.1 项目初始化与全局变量定义首先我们需要定义一些控制程序状态的变量和常量。// 定义状态枚举让程序逻辑更清晰 enum DeviceState { Idle, // 空闲状态 Washing, // 洗手计时中 Nightlight // 夜灯模式 } // 全局变量 let currentState DeviceState.Idle let washTimer 0 // 洗手计时器单位秒 let nightlightBrightness 10 // 夜灯亮度 (0-255) let touchThreshold 300 // 电容触摸触发阈值原始值需校准 let lightThreshold 50 // 环境光阈值低于此值开启夜灯 (0-255) let lastTouchTime 0 // 记录最后一次触发时间用于防误触 // 常量 const TOTAL_WASH_TIME 20 // 建议洗手总时长20秒变量定义解析DeviceState枚举使状态切换的逻辑像开关一样明确避免了使用模糊的数字或字符串。touchThreshold是一个关键参数。CPX读取的电容触摸原始值范围很大可能从几百到上万我们需要通过实验测出手悬停在目标引脚比如A1上方约1-2厘米时对应的典型值并设置一个稍低于该值的阈值以确保可靠触发。lightThreshold也需要根据实际安装位置进行校准。白天室内的光线传感器读数可能高达200而夜晚仅开小夜灯时可能只有10。3.2 主循环逻辑与状态机实现微控制器的程序通常围绕一个无限循环的主函数。我们将在这个循环里检测传感器、更新状态、控制LED和声音。// 主循环函数 basic.forever(function () { // 1. 读取传感器数据 let touchValue pins.A1.analogRead() // 读取A1引脚的模拟值电容感应原始值 let lightValue input.lightLevel() // 读取光线传感器值MakeCode已映射为0-255 // 2. 状态判断与转移 switch (currentState) { case DeviceState.Idle: handleIdleState(touchValue, lightValue) break case DeviceState.Washing: handleWashingState() break case DeviceState.Nightlight: handleNightlightState(lightValue) break } // 3. 更新LED显示根据当前状态 updateLeds() // 4. 短暂延时控制循环频率降低功耗 basic.pause(100) // 100毫秒 })状态机设计心得 使用switch-case结构来实现状态机是嵌入式开发中让复杂逻辑变得清晰的经典方法。每个状态都有独立的处理函数互不干扰。例如在Idle空闲状态下程序只关心两件事是否检测到手靠近切换到Washing以及环境是否足够暗切换到Nightlight。一旦进入Washing状态就只专注于倒计时不再响应新的触发直到计时结束。3.3 各状态处理函数详解3.3.1 空闲状态处理 (handleIdleState)这是设备的默认状态主要职责是监听触发事件和环境光变化。function handleIdleState(touchVal: number, lightVal: number) { // 防误触两次触发至少间隔3秒 if (input.runningTime() - lastTouchTime 3000) { if (touchVal touchThreshold) { // 检测到手靠近 lastTouchTime input.runningTime() startWashingTimer() return // 状态已改变直接返回 } } // 检查环境光决定是否进入夜灯模式 if (lightVal lightThreshold) { currentState DeviceState.Nightlight // 进入夜灯模式时可以有一个淡入效果 fadeInNightlight() } else { // 如果环境亮且之前是夜灯模式则确保退出 // 此逻辑在handleNightlightState中处理 } }实操技巧防误触机制。电容传感器非常敏感可能因为空气流动、电磁干扰产生误信号。通过记录上次触发时间并设置一个“冷却期”如3秒可以有效避免因单次靠近产生多次触发导致计时器反复重启。input.runningTime()返回的是设备启动后的毫秒数非常适合用于此类时间间隔判断。3.3.2 洗手计时状态处理 (handleWashingState)这是项目的核心互动环节需要管理计时、更新视觉反馈和声音提示。function startWashingTimer() { currentState DeviceState.Washing washTimer TOTAL_WASH_TIME // 播放启动提示音 music.playTone(Note.C, music.beat(BeatFraction.Whole)) basic.pause(50) music.playTone(Note.E, music.beat(BeatFraction.Whole)) } function handleWashingState() { // 每秒减少计时器 basic.pause(1000) // 注意这里在主循环中已有100ms延时此处暂停是为了精确秒级递减 washTimer - 1 // 检查是否计时结束 if (washTimer 0) { endWashingTimer() } } function endWashingTimer() { // 播放结束提示音 music.playTone(Note.E, music.beat(BeatFraction.Whole)) basic.pause(50) music.playTone(Note.C, music.beat(BeatFraction.Whole)) // 重置状态回到空闲由空闲状态决定下一步进入夜灯或保持空闲 currentState DeviceState.Idle washTimer 0 // 清空LED准备显示下一个状态 light.clear() }计时精度问题在handleWashingState函数中我们使用basic.pause(1000)来确保每秒递减一次。但要注意整个主循环的周期是100ms所有处理函数的执行时间。如果其他函数执行时间过长会导致计时不准。对于20秒的洗手计时这种误差可以接受。如果追求高精度应该使用硬件定时器中断但在MakeCode的简单项目中这种方法最为直观。3.3.3 夜灯状态处理 (handleNightlightState)夜灯模式需要智能地根据环境光开启或关闭。function handleNightlightState(lightVal: number) { // 如果环境光变亮且超过阈值一定量防止在阈值附近震荡则退出夜灯模式 if (lightVal lightThreshold 20) { // 加入滞后区间防止频繁切换 currentState DeviceState.Idle fadeOutNightlight() } // 否则保持在夜灯模式。亮度可能由其他函数如updateLeds根据nightlightBrightness控制 } function fadeInNightlight() { // 淡入效果亮度从0逐渐增加到设定值 for (let i 0; i nightlightBrightness; i) { // 这里假设updateLeds函数会读取一个全局的夜灯颜色和亮度变量 // 我们暂时用一个全局变量存储当前目标亮度 setAllLedsColor(0x007F7F, i) // 例如设置一种淡青色 basic.pause(30) } } function fadeOutNightlight() { // 淡出效果 for (let i nightlightBrightness; i 0; i--) { setAllLedsColor(0x007F7F, i) basic.pause(30) } light.clear() }环境光滞回控制注意在判断退出夜灯的条件时我们使用了lightThreshold 20。这是一个经典的“滞回”设计。如果只用lightThreshold当环境光在阈值附近微小波动例如窗外飘过一片云会导致夜灯在“开”和“关”之间快速、频繁地切换用户体验极差。加入一个滞回区间如20个单位要求“变亮”需要更明显才关灯“变暗”需要更明显才开灯从而稳定了系统的行为。3.4 LED视觉反馈系统设计10颗NeoPixel LED是我们的主要输出设备需要为不同状态设计不同的光效。function updateLeds() { switch (currentState) { case DeviceState.Idle: // 空闲状态可以显示一个缓慢呼吸的待机灯或者全灭 // 这里选择全灭以省电 // light.clear() 已在状态切换时处理 break case DeviceState.Washing: updateWashingLeds() break case DeviceState.Nightlight: updateNightlightLeds() break } } function updateWashingLeds() { // 计算已过去的时间比例 let elapsedRatio (TOTAL_WASH_TIME - washTimer) / TOTAL_WASH_TIME // 计算点亮的LED数量 let ledsToLight Math.round(elapsedRatio * 10) // 10颗LED // 先清空 light.clear() // 根据进度点亮不同颜色的LED for (let i 0; i ledsToLight; i) { // 颜色从绿色开始渐变到红色结束 let hue 85 - (i * 8.5) // 绿色Hue约85红色约0线性过渡 if (hue 0) hue 0 light.setPixelColor(i, light.hsv(hue, 255, 255)) } light.show() } function updateNightlightLeds() { // 夜灯模式所有LED显示柔和、低亮度的固定颜色 // 亮度由全局变量nightlightBrightness控制颜色可自定义 setAllLedsColor(0x007F7F, nightlightBrightness) // 淡青色亮度较低 } // 辅助函数设置所有LED为同一颜色和亮度 function setAllLedsColor(rgb: number, brightness: number) { // 从RGB颜色中提取R,G,B分量 let r (rgb 16) 0xFF let g (rgb 8) 0xFF let b rgb 0xFF // 应用亮度系数 (0-255) r Math.round(r * brightness / 255) g Math.round(g * brightness / 255) b Math.round(b * brightness / 255) let adjustedColor (r 16) | (g 8) | b for (let i 0; i 10; i) { light.setPixelColor(i, adjustedColor) } light.show() }视觉进度设计在洗手计时中我们用10颗LED作为进度条。updateWashingLeds函数的关键在于计算elapsedRatio已过去时间的比例然后将其映射到要点亮的LED数量上。颜色从绿色健康/开始向红色警告/结束渐变提供了直观的时间压力感知。使用HSV色彩空间进行渐变比RGB更简单直观。4. 硬件连接、校准与外壳制作4.1 非接触检测的灵敏度校准这是项目成功的关键一步。CPX的电容触摸引脚默认是为直接触摸设计的。我们需要编写一个简单的校准程序来找到合适的touchThreshold。// 校准程序 - 上传此代码到CPX打开串口监视器查看数据 basic.forever(function () { let val pins.A1.analogRead() serial.writeValue(A1, val) // 在MakeCode的串口控制台中查看输出 basic.pause(200) })将上述代码刷入CPX。在MakeCode界面点击“显示控制台设备”或使用串口监视器工具。观察A1引脚的读数。首先记录手远离时的“基线值”例如可能是250。然后将手慢慢悬停在A1引脚上方约1.5厘米处观察数值变化。你会发现数值显著上升例如升到800。touchThreshold应该设置为一个介于基线值和触发值之间的数比如(250 800) / 2 525。在实际主程序中可以先设为525然后根据触发稳定性微调。如果太容易误触就调高如果太难触发就调低。4.2 光线传感器阈值校准同样我们需要确定安装位置的环境光范围。basic.forever(function () { let val input.lightLevel() serial.writeValue(Light, val) basic.pause(1000) })在计划安装设备的位置如卫生间墙壁分别在白天开灯/关窗、夜晚开夜灯、夜晚全黑几种情况下记录input.lightLevel()的读数。假设你得到白天开灯180夜晚开小夜灯15全黑5。那么lightThreshold可以设置为30。这样当光线低于30时进入夜灯模式。同时在handleNightlightState中退出阈值设为302050形成滞回。4.3 供电与外壳设计建议供电CPX可以通过USB口持续供电但为了美观和独立使用推荐使用3节AAA电池盒供电。CPX的工作电压范围是3.5V-6V3节碱性电池约4.5V完全合适且续航可观。外壳可以使用3D打印一个简单的外壳或者用一个透明的塑料小盒改造。关键是要确保光线传感器不被遮挡能准确感知环境光。用于电容感应的A1引脚附近不要有大的金属物体或电源线以免干扰电场。LED灯珠最好有柔光罩使光线均匀不刺眼。可以用一张半透明的磨砂纸或亚克力板覆盖。预留USB口或开关位置方便调试和充电如果使用锂电池。5. 功能扩展与优化思路基础版本完成后这个项目还有很大的扩展空间可以根据个人需求添加更多智能功能。5.1 增加真正的距离传感器如果觉得电容感应的非接触距离太短或不稳定可以外接一个VL53L0X激光测距传感器或HC-SR04超声波模块。这需要用到CPX的I2C或数字IO引脚。以VL53L0X为例通过I2C连接后可以精确测量手与传感器的距离例如在10cm内触发可靠性大大提升。代码上只需将主循环中读取touchValue的部分替换为读取距离传感器的值并与一个距离阈值如if (distance 100) // 100毫米进行比较即可。5.2 添加蓝牙或Wi-Fi连接使用CPX的兄弟型号标准的CPX没有无线功能。如果你希望实现更酷的功能比如通过手机App设置计时时长、夜灯颜色或查看洗手频率统计可以考虑使用Adafruit的Circuit Playground Bluefruit版本。它集成了蓝牙低能耗BLE可以通过MakeCode的蓝牙扩展模块与手机通信。你可以创建一个简单的App使用MIT App Inventor或Swift/ Kotlin来发送配置参数。5.3 实现更复杂的灯光模式与声音交互灯光模式可以为不同的洗手阶段设置不同的光效。例如前5秒打湿双手用蓝色流水效果中间10秒涂抹揉搓用橙色旋转效果最后5秒冲洗用绿色闪烁效果。声音交互除了简单的提示音可以播放一段完整的旋律作为计时背景音或者用语音合成模块如外接SYN6288播放“请开始洗手”、“时间到”等语音提示。低功耗优化如果使用电池供电需要对代码进行深度优化。在空闲和夜灯模式下可以调用control.waitMicros()或降低主循环频率来让CPU进入休眠状态显著延长电池寿命。CPX的NeoPixel LED在显示纯色且亮度不高时功耗较低但全亮度白色依然很耗电。5.4 数据记录与可视化利用CPX的板载存储有限或通过串口实时输出数据可以记录每次洗手事件的时间戳和时长。将这些数据导入到电脑用PythonPandas, Matplotlib进行简单的分析可以生成“家庭洗手习惯报告”对于培养孩子的良好习惯会是一个有趣的激励。6. 常见问题与调试实录在开发和测试过程中我遇到了不少典型问题这里汇总一下排查思路和解决方法。问题现象可能原因排查步骤与解决方案手靠近无法触发计时1. 电容阈值touchThreshold设置过高。2. 手距离传感器引脚太远。3. 引脚选择错误或接触不良。1. 运行校准程序确认手靠近时的读数调低阈值。2. 确保手在引脚正上方1-2厘米内。3. 检查代码中使用的引脚编号如A1是否与物理引脚对应。频繁误触发无接触也启动1. 电容阈值touchThreshold设置过低。2. 传感器附近有导电物体如金属桌面、未绝缘的电线。3. 电源噪声干扰。1. 调高阈值。2. 将设备放在绝缘材料上如木桌、塑料盒远离干扰源。3. 尝试使用电池供电排除开关电源的噪声。夜灯模式频繁开关环境光在阈值lightThreshold附近波动。引入滞回控制如文中所述设置不同的“开启”和“关闭”阈值。LED显示异常或颜色不对1. 代码中颜色值计算错误。2. NeoPixel LED损坏或虚焊CPX板载的一般不会。3. 供电不足导致信号不稳定。1. 简化测试先尝试用light.setAll(0xff0000)点亮所有红灯检查硬件。2. 确保使用稳定的5V电源。电池电量不足时也可能出现此问题。计时不准20秒感觉过快或过慢主循环中延时basic.pause的累计误差或处理函数耗时过长。1. 使用control.timer1.micros等硬件计时器进行更精确的秒级计时。2. 简化updateLeds等函数的计算避免在1秒循环内做太复杂的操作。刷入新代码后设备无反应1. 程序可能卡在某个初始化循环或错误中。2. 硬件复位不彻底。1. 尝试刷入一个最简单的“点亮一颗LED”的程序确认硬件和连接正常。2. 按一下CPX上的复位按钮Reset。3. 检查MakeCode中是否选择了正确的设备类型Circuit Playground Express。调试心法嵌入式开发中“分而治之”和“串口打印”是最有效的两大工具。当整体功能不正常时务必隔离测试每个部分先单独测试电容读数、再单独测试LED显示、最后测试状态逻辑。MakeCode的“串口输出数值”功能是你的眼睛随时把关键变量如传感器值、状态标识打印出来观察很多逻辑错误一目了然。这个“非接触洗手计时夜灯”项目从构思到实现涉及了传感器应用、状态机编程、用户交互设计和简单的产品思维。它不复杂但足够完整几乎用到了CPX的所有核心功能。最重要的是它解决了一个真实的小痛点并且制作过程充满了乐趣。希望这份详细的拆解能帮助你复现它或者激发你创造出属于自己的智能小装置。