基于PIR传感器与HalloWing的自动惊吓陷阱：嵌入式系统交互实践

1. 项目概述：一个会“思考”的自动惊吓陷阱

如果你玩腻了那些静态的装饰，想给万圣节或者朋友聚会来点真正“活”的互动惊吓，那么这个基于HalloWing和PIR传感器的自动惊吓陷阱项目，绝对能让你过足创客的瘾。这不仅仅是一个简单的“人过灯亮”装置，而是一个集环境感知、逻辑判断、多模态反馈（视觉、听觉、动作）于一体的完整嵌入式系统。它就像一个潜伏在门框上的小恶魔，静静地等待“猎物”进入最佳攻击位置，然后精准地释放它的“恐怖”道具——一只悬挂的橡胶虫子，并配以嘶嘶的恐怖音效。

项目的核心在于PIR（被动红外）运动传感器。很多人用过它，但未必深究过其原理。简单来说，人体会持续向外辐射红外线。PIR传感器内部有一片特殊的“热释电”材料，当移动的热源（比如人）进入其视野，导致传感器接收到的红外辐射量发生变化时，这片材料就会产生微弱的电信号。传感器电路将这个信号放大、比较，最终输出一个高/低电平的跳变。这个过程完全被动，不发出任何光线或波，因此非常节能且隐蔽。我们正是利用这个跳变信号作为整个陷阱的“扳机”。

主控板选择了Adafruit的HalloWing M0 Express，这是一块骷髅头形状、自带1.44英寸彩色屏幕的开发板，基于ATSAMD21芯片。选择它不只是因为造型应景，更因为它高度集成：内置了音频放大器可直接驱动扬声器，有多个方便的JST PH端口用于连接传感器和执行器，还支持CircuitPython——一种基于Python的、对初学者极其友好的嵌入式编程语言。这意味着你可以像写Python脚本一样控制硬件，大大降低了开发门槛。

整个系统的工作流清晰而富有逻辑：上电初始化 -> 伺服电机复位至“待发”位置 -> PIR传感器进入监控状态 -> 一旦检测到运动，立即触发音效播放和伺服电机动作（释放虫子） -> 等待手动复位。这个过程里，板载屏幕会实时显示状态（“请等待”、“陷阱已设”、“陷阱触发”），让设置和调试过程一目了然。接下来，我将从电路搭建、代码解析到调试部署，完整拆解这个项目的每一个细节，并分享我在实际制作中积累的经验和踩过的坑。

2. 核心硬件选型与电路设计思路

2.1 主控与传感器：为什么是HalloWing与PIR？

在这个项目中，硬件选型直接决定了实现的便捷性和最终效果。Adafruit HalloWing M0 Express是一个“All-in-One”的解决方案，这省去了大量麻烦。如果使用普通的Arduino开发板，你需要额外连接屏幕（需要处理SPI/I2C）、音频模块（需要DAC或专用芯片）、以及为伺服电机提供足够电流。HalloWing把这些都集成在了一块板子上：TFT屏幕通过高速总线直连，A0引脚直接连接了一个内置的Class D音频放大器，NEOPIXEL端口提供了精准的PWM输出以控制伺服电机，SENSE端口则方便连接数字传感器。这种集成度让我们可以专注于逻辑和交互，而不是底层电路的调试。

PIR传感器的选型也有讲究。项目使用的是最常见的那种带白色半球形菲涅尔透镜的模块。这个透镜是关键，它将探测区域分割成多个灵敏区，提高了检测移动（而不仅仅是温度变化）的准确性。模块上通常有两个旋钮：一个调节灵敏度（探测距离），一个调节延时时间（触发后输出高电平的持续时间）。在陷阱项目中，我们不希望延时时间太长，否则一次触发后，传感器会长时间输出高电平，导致陷阱无法快速复位进入下一次待机状态。通常我会把这个延时调到最小（约1-2秒），让检测更“瞬时”。

注意：不同品牌PIR模块的输出逻辑可能不同。大部分是检测到运动时输出高电平（3.3V或5V），持续一段时间后恢复低电平。务必在接入电路前，用万用表或主控板的GPIO读取功能测试一下，确认其行为是否符合预期。

2.2 执行器与供电：让陷阱“动”起来

微型伺服电机是陷阱的执行机构。这里选用的是常见的9克微型180度舵机。它的工作原理是接收一个周期为20ms（频率50Hz）的PWM信号，通过信号脉宽（通常为0.5ms到2.5ms）来控制输出轴的角度。HalloWing的NEOPIXEL端口（内部是GPIO D4）可以输出这样的PWM信号。舵机有三根线：棕色（GND）、红色（VCC，通常4.8V-6V）、黄色（信号线）。需要注意的是，舵机在转动瞬间，尤其是遇到阻力时，电流消耗会很大（可达数百mA），如果供电不足会导致主控板复位或行为异常。

这就引出了供电方案。虽然HalloWing可以通过Micro USB供电，但为了确保舵机和整个系统稳定运行，特别是需要长时间部署时，一个独立的5V/2.5A的开关电源是更可靠的选择。这种电源能提供充足且干净的电流。连接时，电源的5V和GND可以接到一个面包板或接线排上，同时为HalloWing（通过其VUSB引脚或USB口，注意电压范围）和舵机供电。务必确保所有设备的“地”（GND）连接在一起，这是电路正常工作的基础。

扬声器的选择比较灵活，一个4欧姆或8欧姆、功率0.5W到2W的小型动圈喇叭就足够了。HalloWing的A0引脚内部已经连接到音频放大器，所以只需要将喇叭的两根线焊接到板子背面标有“SPK+”和“SPK-”的焊盘上即可。如果声音太小，可以尝试更换阻抗更小（如4欧姆）或灵敏度更高的喇叭。

2.3 电路连接与安全规范

根据原始指南，电路连接非常直接，利用了HalloWing的专用端口：

1. 扬声器：直接插入板子侧面的SPEAKER A0端口。
2. 伺服电机：通过一根JST PH 3针公头转杜邦母头线连接。连接关系为：舵机棕色线（GND）接黑线，红色线（VCC）接红线，黄色线（信号）接白线。然后将此线的JST端插入HalloWing的NEOPIX 4端口。
3. PIR传感器：通过一根JST PH 3针母头转杜邦母头线连接。连接关系为：PIR模块的GND接黑线，OUT接白线，VCC接红线。然后将此线的JST端插入HalloWing的SENSE端口。

这种使用预制连接线的方式极大避免了接错线的风险。在实际操作中，我强烈建议在通电前，用万用表的蜂鸣档或电阻档，再次确认一下每根线的连通性是否正确。特别是舵机的电源线，如果接反了可能会立即烧毁舵机或主控板。

实操心得：对于需要长时间运行的项目，所有接线点最好进行焊接，或者使用带锁紧功能的杜邦接头。仅仅插接在面包板上，可能会因为震动或氧化导致接触不良，让陷阱在关键时刻“掉链子”。我在第一次户外测试时，就因为杜邦头松动，导致PIR传感器间歇性失灵，闹了个乌龙。

3. 结构组装与机械优化要点

3.1 主体框架搭建与传感器校准

项目的结构载体建议使用瓦楞塑料板，它比纸板坚固、防潮，又比木板轻便、易加工。按照指南，裁切一块大约25cm x 10cm（10英寸x4英寸）的板子作为主体。为PIR传感器开孔是第一步，也是影响检测精度的关键。

开孔位置需要仔细考量。你需要设想陷阱最终的部署位置（比如门框上沿），并确定希望检测的区域（比如门前一步的地面）。PIR传感器的探测范围是一个扇形区域。开孔时，不仅仅是挖一个能让传感器塞进去的洞，更重要的是利用开孔的位置和朝向，来初步限定传感器的视野。你可以将板子模拟安装在目标位置，用手持传感器大致确定其朝向，再在板子上标记开孔中心。

切割时，使用美工刀和钢尺，多次划切，直到切透。务必确保孔洞边缘平整，这样传感器塞进去后才能紧密固定，不会晃动。晃动会导致背景热源（如暖气片、窗户）在传感器视野中轻微移动，可能引发误触发。

3.2 视野聚焦：自制“遮光罩”的必要性

原始项目中最巧妙的一个机械优化，就是为PIR传感器制作的卡纸遮光罩。默认的菲涅尔透镜提供的是约120度的广角视野，这意味着从侧面很远地方经过的人也可能触发陷阱。我们的目标是让“惊吓”发生在正下方，因此需要将视野收窄，聚焦在一个更小、更向前的锥形区域内。

用黑色卡纸制作遮光罩的原因有二：一是黑色能吸收杂散光，避免外部光线干扰（虽然PIR对可见光不敏感，但好习惯要保持）；二是卡纸容易弯折定型。将一小块卡纸折成一个倒U型或筒状，套在传感器的半球透镜上，就像给相机加了一个长焦镜头筒。通过调整筒的长度和口径，你可以像调节光圈一样控制探测区域的宽窄和远近。一个简单的测试方法：在传感器通电状态下，用手在目标区域移动，同时观察HalloWing板载LED（在代码中它与PIR状态联动）或通过串口打印输出，反复调整遮光罩，直到只有目标区域内的移动能被稳定检测到。

3.3 组件布局与伺服安装技巧

其他组件的布局遵循两个原则：重心稳定和便于维护。HalloWing和扬声器可以用厚实的双面泡沫胶固定在板子中部。泡沫胶有一定厚度，可以缓冲震动，也便于日后拆卸。注意扬声器的振膜不要被完全贴死，背面最好留有一些空间让声音透出。

伺服电机的安装是机械部分的核心。你需要考虑“虫子”下落的轨迹。舵机应安装在板子边缘，其转轴尽可能悬空，这样系着虫子的线才不会在释放时刮蹭到板子。用扎带或强力的胶带将舵机牢牢固定。舵机的摆臂（通常随舵机附赠多个形状）需要选择一个合适的。我推荐使用最长的那个摆臂，并在其末端用热熔胶粘上一小段对折的牙签或塑料片，形成一个“挂钩”，这样悬挂虫子的线圈就很容易套上去且不易滑脱。

关于“虫子”的悬挂，单丝鱼线是理想选择，它几乎隐形且结实。线的一端系住橡胶虫子，另一端固定在板子上（可以在板子上打个小孔穿过去系紧）。线的中间部分做一个可滑动的活套，套在伺服摆臂的“挂钩”上。当舵机转动90度时，摆臂会甩开，活套从挂钩上滑脱，虫子便自由落体。这个“活套”设计比直接系死在摆臂上更可靠，释放动作更干脆。

4. CircuitPython代码深度解析与自定义

4.1 开发环境搭建与库管理

首先确保你的HalloWing刷写了最新版本的CircuitPython。访问CircuitPython官网，找到HalloWing M0 Express的页面，下载最新的.uf2文件。按住HalloWing上的复位键，再插入USB线，电脑上会出现一个名为HALLOWBOOT的U盘，把下载的.uf2文件拖进去，板子会自动重启并变成CIRCUITPY盘符。这个过程叫“刷固件”。

代码编辑推荐使用Mu Editor，它专为CircuitPython设计，内置了串口监视器，非常方便。接下来是库文件。项目只需要adafruit_motor库来控制舵机。从Adafruit的CircuitPython库包中，找到lib文件夹里的adafruit_motor文件夹，将其复制到HalloWing的CIRCUITPY盘符下的lib文件夹中即可。CircuitPython的魅力就在于，你只需要把.py文件当作主程序，把库文件放在指定位置，一切就准备就绪了，无需复杂的编译环境。

4.2 主程序逻辑流拆解

让我们深入看看code.py的核心逻辑。程序启动后，按顺序执行：

1. 初始化：导入所有必要的库，设置PIR传感器引脚为输入，板载LED为输出，初始化舵机、电容触摸按钮和音频输出。
2. 硬件自检与就绪：调用servo_ready()将舵机归零位（虫子悬挂的位置）。播放一声提示音，在屏幕上显示“请等待”图片。然后进行一个3秒的倒计时（countdown(3)），这个时间是为了让PIR传感器内部稳定下来，避免上电时的误信号。
3. 主循环前的准备：倒计时结束后，屏幕显示“陷阱已设”，程序进入while True主循环。
4. 主循环监控：在主循环中，程序不断做两件事：
   • pir_value = pir.value：读取PIR传感器的数字状态。
   • ready = ready_button.value：读取左侧“牙齿”电容触摸按钮的状态。
5. 触发判断：如果pir_value为True（检测到运动）且triggered标志为False（陷阱未处于触发后的等待复位状态），则执行触发序列：
   • 调用play_wave()：播放hiss01.wav音频文件，同时控制舵机转到90度（servo_release()）释放虫子。
   • 屏幕切换为“陷阱触发”图片。
   • 等待8秒（countdown(8)），给“受害者”足够的惊吓时间。
   • 将triggered标志设为True，防止在复位前被重复触发。
   • 舵机归位，屏幕切换为“请复位”图片。
6. 复位判断：如果triggered为True，且检测到电容触摸按钮被按下（ready为True），则执行复位序列：
   • 播放提示音。
   • 屏幕切换为“请等待”，再次进行8秒倒计时（让用户有时间重新挂好虫子）。
   • 重置triggered标志为False，屏幕切回“陷阱已设”，陷阱重新进入监控状态。

这个逻辑清晰、健壮，形成了一个完整的“待机-触发-复位”状态机。

4.3 关键函数与音频处理剖析

音频播放部分用了两种方式，这是代码的一个亮点。对于简单的“嘀嘀”提示音，它没有使用占存储空间的WAV文件，而是通过audiocore.RawSample()动态生成了一个880Hz的正弦波样本。tone_volume变量控制音量，frequency_hz变量控制音高。beep(count)函数通过循环播放这个样本很短时间来实现蜂鸣，非常节省资源。

对于复杂的“嘶嘶”音效，则使用audiocore.WaveFile()播放预先录制好的hiss01.wav文件。这里需要注意，CircuitPython播放WAV文件对格式有要求：必须是单声道、16位、22kHz或以下的采样率。如果你自己录制或下载音效，可能需要用Audacity等软件进行转换。

舵机控制通过adafruit_motor.servo库实现。初始化时指定PWM引脚（board.D4）。servo.angle属性直接设置角度（0-180）。在servo_ready()和servo_release()函数中，分别设置为0度和90度。这里90度是释放动作，你可以根据摆臂安装的初始位置，微调这个角度值，确保释放动作干脆利落。

屏幕显示部分，代码使用了显示BMP位图的方式。HalloWing的屏幕驱动在CircuitPython中非常高效。show_image()函数负责切换图片。注意图片需要是128x128像素、16位色的BMP文件。代码中先关闭背光（backlight.duty_cycle = 0），然后清空显示组、加载新图片、刷新屏幕，最后再打开背光。这个“先关后开”的操作可以避免屏幕切换时的花屏现象。

代码优化建议：原代码的play_wave()函数中，while audio.playing:这个循环可能会因为音频播放卡住而影响其他操作（虽然本项目影响不大）。一个更稳健的做法是使用非阻塞方式，或者将音频播放放在一个状态机里。此外，可以将PIR的灵敏度调节（通过代码滤波）做得更精细。例如，可以连续读取多次PIR值，只有连续N次都为高电平时才判定为有效触发，这能有效过滤掉一些短暂的干扰信号。

5. 系统调试、部署与实战经验

5.1 分阶段测试与问题排查

不要等到全部组装好再测试，分阶段调试是成功的关键。

1. 基础功能测试：只连接HalloWing和USB线到电脑。在Mu编辑器的串口监视器中，运行一个简单的脚本，测试电容触摸按钮和板载LED。确认你能通过触摸“牙齿”控制LED亮灭，这确保了主控板基本功能正常。
2. PIR传感器测试：将PIR传感器接入SENSE端口。编写几行代码，循环读取pir.value并打印到串口，同时用板载LED指示状态。用手在传感器前移动，观察输出变化。调整传感器上的灵敏度旋钮和延时旋钮，感受其影响。这是校准检测范围的最佳时机。
3. 舵机测试：连接舵机。编写代码让舵机在0度和90度之间来回转动。观察转动是否平滑，是否准确到达指定位置。听声音，正常的舵机转动声音是平稳的“嗡嗡”声，如果发出“咔咔”或抖动，可能是电源功率不足或机械阻力太大。
4. 音频测试：连接扬声器。先测试beep()函数，确认有声音。然后将hiss01.wav文件放到HalloWing的根目录，编写代码调用play_wave()函数，确认能播放完整的音效。
5. 集成测试：将所有部件连接，运行完整的code.py。按照屏幕提示，测试整个“待机-触发-复位”流程。用手触发PIR，看虫子是否掉落、声音是否播放、屏幕切换是否正常。

5.2 常见问题与解决方案实录

在实际制作中，你可能会遇到以下问题，这里是我的排查记录：

5.3 最终部署与效果提升技巧

部署时，选择门廊、走廊入口或橱柜门上方等必经之路。用布基胶带将整个装置板固定在合适位置，这种胶带粘性强且移除后不留痕迹。调整板子角度，确保PIR传感器的聚焦区域覆盖你想要触发的位置（比如门前一块地砖的范围）。

供电方面，如果部署点附近有插座，使用长的Micro USB线连接5V电源适配器是最稳妥的。如果想做成无线的，可以考虑使用大容量的USB充电宝，但需要测试其续航时间。注意，有些充电宝在输出电流过小时会自动关机，需要在HalloWing的代码中确保有定期的微小动作（比如每几分钟让LED闪烁一下）来“保持唤醒”。

为了增强惊吓效果，可以做一些个性化改造：

• 音效定制：录制或寻找更恐怖、更突然的音效替换hiss01.wav。突然的尖叫、玻璃破碎声效果都不错。
• 多轴联动：如果HalloWing的GPIO还有富余，可以再接一个舵机控制一个闪光灯（通过继电器控制），在触发瞬间亮起，实现声光同步。
• 延迟触发：修改代码，在PIR首次触发后，不立即动作，而是延迟1-2秒。当人完全走入陷阱下方正疑惑时再突然发动，效果更佳。
• 随机化：让每次触发后的等待时间（countdown(8)）在一个范围内随机，避免被识破规律。

这个项目最吸引我的地方，在于它用一个简单的传感器和一个执行机构，结合巧妙的逻辑和反馈，创造出了一个充满趣味的交互场景。它不仅仅是代码和电路的堆砌，更是对时机、心理预期和物理反馈的综合设计。当你看到朋友被它成功吓到时，那种亲手创造“魔法”的成就感，是任何现成玩具都无法比拟的。动手去试，调试，改进，这才是创客精神的精髓。