1. 项目概述与核心思路
如果你对天文现象着迷，但又觉得它们遥不可及，那么这个项目或许能让你眼前一亮。我最近完成了一个“血月模拟装置”，它本质上是一个融合了物理计算、数字制造和一点艺术创意的交互式教具。核心目标很简单：让观察者能直观地、亲手操作来对比“血月”和“普通满月”这两种天文现象。血月通常发生在月全食期间，地球大气层将太阳光中的红光折射到月球表面，使其呈现暗红色；而普通满月则是我们熟悉的亮白色。这个装置通过一个内置LED灯串的泡沫球模拟月球，用触摸传感器控制两种不同的灯光模式，再配合棉花制作的“云层”和激光切割的星空外盒，营造出一个沉浸式的迷你天文馆体验。
这个项目特别适合教育工作者、创客爱好者，或者任何想将编程、电子和手工结合起来的实践者。你不需要是天文学专家，也不需要是电子工程科班出身。整个制作过程会涉及CircuitPython编程、基础电路连接、激光切割文件设计以及一些手工组装技巧。我会把每个步骤拆解得足够详细，确保即使你是第一次接触微控制器，也能跟着做出来。最终，你会得到一个既美观又实用的装置，它能清晰地展示两种月相的光学差异，其交互性也远比静态模型或幻灯片演示更有吸引力。
2. 核心硬件选型与原理剖析
2.1 主控板：为什么是Circuit Playground Bluefruit？
在这个项目中，我选择了Adafruit的Circuit Playground Bluefruit（简称CPB）作为大脑。你可能听说过更经典的Arduino Uno，但CPB有几个决定性的优势让它成为此类互动装置的首选。
首先，集成度极高。一块小小的板子上，集成了10个可编程的NeoPixel RGB LED、运动传感器、温度传感器、光线传感器、麦克风，甚至还有一个蜂鸣器。这意味着我们不需要为了添加一个呼吸灯效果或者检测环境光再去外接一堆模块，大大简化了电路和结构设计。对于我们的月球模拟，板载的NeoPixel虽然这次没用上，但为未来扩展（比如增加星空背景光效）预留了可能。
其次，它原生支持CircuitPython。与需要安装特定IDE、编写C++的Arduino传统开发方式相比，CircuitPython的学习曲线平缓得多。你只需将板子通过USB连接到电脑，它就会像一个U盘一样出现，直接把.py代码文件拖进去就能运行。修改代码也只需要保存文件，板子会自动重新加载，调试过程非常直观快捷，特别适合快速原型开发和教学场景。
最后，蓝牙功能。CPB内置蓝牙低功耗（BLE），这意味着未来你可以轻松地为这个装置开发一个手机App来控制模式切换、调整亮度甚至播放解说音频，让交互方式从物理触摸扩展到无线控制，可玩性和教学维度能进一步提升。虽然本次项目未使用，但它是一个宝贵的“未来选项”。
2.2 交互核心：MPR121电容触摸传感器
如何实现优雅的、无需按压的触摸切换？我选择了MPR121电容式触摸传感器芯片。它的原理是检测人体手指接近时引起的微小电容变化。相比于传统的机械按钮或电阻式触摸屏，电容触摸没有物理活动部件，更耐用，手感也更好，只需轻轻触碰甚至靠近即可触发，非常适合做成隐藏在精美标签后面的控制点。
MPR121有12个独立的触摸感应通道，我们只需要其中4个（血月开/关、普通月开/关）。它通过I2C协议与主控板通信，这是一种只需要两根数据线（SDA, SCL）就能连接多个设备的串行总线，接线非常简洁。CPB上有专用的I2C引脚，连接起来很方便。MPR121库在CircuitPython社区非常成熟，几行代码就能配置好灵敏度和读取触摸状态，稳定性远超自己用模拟引脚搭的简单电容感应电路。
2.3 执行单元：LED灯串与供电方案
月球的光源来自一条可寻址的RGB LED灯串（如WS2812B）。选择它而不是普通LED灯珠的原因是可编程性。通过CircuitPython强大的neopixel库，我们可以精确控制每一颗LED的颜色和亮度。对于“血月”，我们将其设置为暗红色（如RGB: 80, 0, 0）并可能加上轻微的亮度脉动以模拟神秘感；对于“普通满月”，则设置为暖白色（如RGB: 255, 220, 180）。一条灯串缠绕在泡沫球上，可以营造出均匀的、从内部发光的效果。
供电方面，整个系统功耗不高。CPB和MPR121的工作电压是3.3V，而LED灯串需要5V。这里一个常见的坑是：如果直接从CPB的3.3V引脚取电给灯串，会导致亮度严重不足或不稳定。正确的做法是使用独立的5V电源为LED灯串供电。我选择了一个3节AA电池盒（输出约4.5V），这既能满足灯串的电压需求（4.5V驱动WS2812B勉强够用，亮度稍减但可接受），又足够安全。CPB则可以通过其USB口供电，或者同样从这个电池盒取电（需注意CPB的输入电压范围）。在实际连接时，务必确保CPB与LED灯串的“地”（GND）连接在一起，这是数字信号通信的基础。
3. 结构设计与数字制造详解
3.1 星空展示盒的激光切割设计
装置的外壳是一个五面封闭、顶部开口的木质展示盒，用于营造深邃的星空背景，并承载触摸交互界面。我使用MakerCase这个在线工具来生成激光切割文件，它大大简化了设计过程。
- 尺寸规划：我确定了内腔尺寸为5英寸x5英寸x5英寸。这个大小足以容纳电路、电池，并使顶部的“月球”有合适的观赏比例。在MakerCase上选择“盒体（Box）”类型，输入尺寸，并选择“指接榫（Finger Joint）”作为连接方式。指接榫能提供很大的粘合面积，比单纯对接要牢固得多。
- 设计调整：生成基本图纸后，我导入了Adobe Illustrator（用Inkscape等免费软件也可）进行关键修改。一是在一侧面板上，设计了一个矩形开口（约0.65英寸宽 x 1英寸高），位置距顶部约3.5英寸。这个开口的作用是让连接触摸星星和内部MPR121传感器的鳄鱼夹导线能够穿出，同时保持外观整洁。二是在顶板中央，开一个直径约1.35英寸的圆孔，用于穿过支撑月球的木棍和LED灯串的导线。
- 文件准备：这是激光切割成败的关键。必须将切割线设置为纯红色（RGB: 255, 0, 0），且线宽为极细的“hairline”（0.001pt或0.01mm）。雕刻或蚀刻的部分则用黑色填充。将文件保存为PDF或DXF格式，确保尺寸单位正确。
- 材料与切割：我选用1/8英寸（约3mm）厚的桦木胶合板。在激光切割机（如Trotec、Epilog等）操作软件中，导入文件，根据材料设置合适的功率和速度参数（对于3mm椴木，通常需要较高功率和中等速度）。务必先进行焦点校准，确保激光束聚焦在材料表面，这样才能切得干净利落，边缘无焦痕。切割完成后，轻轻将零件从底板上取下。
注意：激光切割会产生烟雾和可能的有害气体，必须在通风良好的环境或配备抽风设备的专业场地操作，并全程佩戴防护眼镜。
3.2 交互介质的制作：触摸星星与标签
交互的核心是四颗铜箔包裹的亚克力星星和文字标签，它们既是装饰，也是电容触摸的电极。
- 星星制作：在Illustrator中绘制四角星形，尺寸约为3英寸（角到角的距离）。同样，外轮廓用红色细线表示切割，内部填充白色（或不填充，仅作为占位）。使用1/8英寸厚的透明亚克力板进行激光切割。切割后，用酒精清洁亚克力表面，然后仔细地将导电铜箔胶带粘贴在星星的正面。要确保铜箔平整无气泡，并完全覆盖触摸区域。铜箔的背面有导电胶，粘贴后用手指或工具压实边缘。
- 为什么用铜箔？铜是优良导体，且铜箔胶带柔软易塑形，能完美贴合异形表面。相比铝箔，铜的氧化速度较慢，导电性更持久稳定。这是实现可靠电容触摸的关键。
- 标签制作：文字标签“BLOOD”、“MOON”、“REGULAR”、“ON”、“OFF”同样用激光切割机在亚克力上制作。这里采用“切割+雕刻”工艺：文字轮廓用红色线切割出来，而文字本身的笔画则用较低的功率进行表面雕刻（engrave），使其产生磨砂效果，之后可以涂上颜料使其更醒目。标签的尺寸根据面板空间精心设计，例如“ON/OFF”标签较小（0.5”x1.2”），“REGULAR”较长（0.5”x1.6”）。
4. 月球本体与云层效果制作
4.1 月球核心：LED灯串的安装
月球由一个直径约4-5英寸的泡沫球（Styrofoam Ball）制成。选择泡沫球是因为它质地轻、易于切割和固定，且对内部光源有良好的漫反射效果。
- 固定LED灯串：将WS2812B灯串的导线端从泡沫球底部预先钻好的小孔穿入，然后开始将灯串均匀地缠绕在球体表面。缠绕时不必过于紧密，均匀分布即可，因为泡沫球自身的漫反射会使光线融合。用少量的热熔胶定点固定灯串，避免其滑动。关键点：确保数据输入（DIN）端牢固地连接在从球体伸出的导线上，并做好标记。
- 连接与测试：将灯串的电源线（5V、GND）和数据线暂时连接到CPB进行测试。写一段简单的测试代码，让所有LED亮起红色、绿色、蓝色，检查是否有坏点，以及光线是否均匀。测试无误后，将灯串的末端也用胶固定。
4.2 营造云层：棉花与Mod Podge的运用
为了模拟地球大气层或宇宙星云的效果，我在覆盖月球的透明碗内壁粘贴了棉花。
- 材料处理：市售的棉花球需要先进行“拉丝”处理。用手将每个棉花球小心地拉拽开，使其变成薄薄的、蓬松的片状或条状，这样粘贴后层次感更强，光线穿透时能形成柔和的、不均匀的晕染效果，更像云层。
- 粘贴工艺：使用Mod Podge（一种手工用胶水，干燥后透明）作为粘合剂。用刷子将Mod Podge涂在透明碗（我用了两个直径约7.8英寸的半球形碗）的内壁，然后将处理好的棉花片轻轻按压上去。可以多层叠加，营造厚度变化。
- 干燥与效果：Mod Podge干燥后完全透明，不会留下白痕，完美保持了棉花的质感。两个碗都处理好后，将它们边缘对齐，用热熔胶粘合，形成一个完整的“云层罩”。这个罩子套在发光的泡沫球外，红光或白光透过不均匀的棉花，就会产生非常自然、柔和的天体发光效果，远比单纯一个光球要生动。
5. 电路连接与系统集成
5.1 核心电路接线图
这是整个装置的电气骨架，务必在通电前仔细核对。
| 元件 | 连接到 CPB 的引脚 | 功能说明 |
|---|---|---|
| MPR121 触摸传感器 | ||
| Vin | 3.3V | 电源正极 |
| GND | GND | 电源地 |
| SDA | SDA (I2C数据线) | I2C通信 |
| SCL | SCL (I2C时钟线) | I2C通信 |
| IRQ | 引脚 D5 (可选) | 中断引脚，用于高效检测触摸 |
| LED灯串 (WS2812B) | ||
| 5V | 外部5V电源正极 | 切勿接CPB的3.3V！ |
| GND | 外部电源GND并与CPB的GND相连 | 共地至关重要 |
| DIN (数据输入) | 引脚 A1 (或任何数字引脚) | 控制数据信号 |
| 电池盒 | ||
| 正极 | LED灯串的5V输入 | 为灯串供电 |
| 负极 | LED灯串的GND并与CPB的GND相连 | 形成完整回路 |
| CPB自身供电 | USB端口 或 电池盒(需降压) | 可通过USB线供电，或通过电池盒经稳压模块供电 |
接线实操要点：
- I2C上拉电阻：CPB内部通常已有上拉电阻，但如果接线较长或干扰大，可以在SDA和SCL线上各接一个4.7kΩ电阻到3.3V，以增强信号稳定性。
- 电源去耦：在MPR121的Vin和GND之间，靠近芯片引脚处，焊接一个0.1uF的陶瓷电容，可以滤除电源噪声，防止误触发。
- 热熔胶固定：所有接线点，特别是鳄鱼夹与铜箔星星的连接处、杜邦线接口，都用热熔胶进行绝缘和应力消除固定，防止因拉扯导致断路或短路。
5.2 机械组装与总装步骤
- 盒子组装：将激光切割好的木板件用木工胶粘合成盒子（先不粘顶盖）。确保开有侧孔和顶孔的面板在正确的位置。待胶水干透后，将整个盒子内外涂成黑色，可以撒上一些金色或银色的闪粉作为星空点缀。
- 内部结构安装：
- 将CPB和MPR121用尼龙柱或双面胶固定在盒底。
- 将长约5英寸的木棍一端用热熔胶垂直固定在盒底中央。
- 把连接好LED灯串的泡沫球（月球）的木棍另一端插入球体底部并粘牢。
- 将LED灯串的导线和数据线从顶板圆孔穿出，然后将顶板套在木棍上，暂时搁置。
- 外部交互元件安装：
- 将四颗铜箔星星用热熔胶粘在盒子外侧面板的预定位置。
- 将文字标签按照“BLOOD”、“ON”、“OFF”、“REGULAR”、“MOON”的布局，用热熔胶粘在相应的星星旁边或下方。
- 将四对鳄鱼夹的一端夹在星星背面的铜箔上（确保接触良好），另一端从侧面的矩形开口穿入盒内，分别连接到MPR121的8个触摸通道引脚（例如通道0-3对应血月控制，通道4-7对应普通月控制）。
- 最终合体：
- 将“云层罩”（两个粘合的碗）小心地套在泡沫球外。
- 调整顶板位置，使其紧贴“云层罩”的底部边缘，然后用热熔胶将碗的底部边缘与顶板粘合固定。
- 将木棍底部与盒底之前的上胶点进行最终固定。
- 整理盒内导线，用扎带或胶带固定，避免杂乱。
- 将电池盒粘在盒子外侧空白面。
- 最后，将顶板与盒体四壁用热熔胶粘合密封。
6. CircuitPython代码解析与编程
6.1 代码结构与库导入
我们将代码保存为code.py，当CPB启动时会自动运行。首先需要安装必要的库文件到CPB的存储空间中。
import time import board import busio import neopixel from adafruit_mpr121 import MPR121 # 初始化I2C总线用于MPR121 i2c = busio.I2C(board.SCL, board.SDA) mpr121 = MPR121(i2c) # 初始化NeoPixel LED灯串 # 连接到引脚A1，共30个LED（根据你的灯串实际数量修改） pixel_pin = board.A1 num_pixels = 30 pixels = neopixel.NeoPixel(pixel_pin, num_pixels, brightness=0.5, auto_write=False) # 定义颜色 BLOOD_RED = (80, 0, 0) # 暗红色，模拟血月 FULL_MOON_WHITE = (255, 220, 180) # 暖白色，模拟普通满月 OFF = (0, 0, 0) # 关闭 # 初始化状态变量 current_mode = "off" # 当前模式：'off', 'blood', 'regular'代码要点：
auto_write=False：这是一个重要设置。它意味着当我们改变LED颜色时，不会立即生效，直到调用pixels.show()。这允许我们一次性更新所有LED的颜色，避免在逐一点亮时产生不和谐的闪烁。- 亮度（Brightness）：设置为0.5（50%）。这既能保证足够的视觉效果，又能有效控制电流，延长电池寿命。如果你觉得太暗或太亮，可以调整这个值（范围0.0-1.0）。
6.2 触摸检测与状态机逻辑
核心逻辑是一个“状态机”，根据触摸输入在不同模式间切换。
# 定义MPR121触摸通道映射 # 根据你的实际接线修改引脚号 TOUCH_BLOOD_ON = 0 # 触摸“血月ON”星星 TOUCH_BLOOD_OFF = 1 # 触摸“血月OFF”星星 TOUCH_REGULAR_ON = 2 # 触摸“普通月ON”星星 TOUCH_REGULAR_OFF = 3 # 触摸“普通月OFF”星星 def update_leds(mode): """根据当前模式更新所有LED颜色""" if mode == "blood": color = BLOOD_RED # 可以添加简单的呼吸效果 # 这里使用一个简单的亮度正弦波动（可选） # brightness = 0.3 + 0.2 * (time.monotonic() % 2) # 示例 # pixels.brightness = brightness elif mode == "regular": color = FULL_MOON_WHITE else: # off color = OFF pixels.fill(color) pixels.show() # 主循环 while True: # 读取当前所有触摸状态 touched = mpr121.touched_pins # 状态判断与切换 if touched[TOUCH_BLOOD_ON]: current_mode = "blood" print("切换到血月模式") elif touched[TOUCH_BLOOD_OFF]: current_mode = "off" print("血月关闭") elif touched[TOUCH_REGULAR_ON]: current_mode = "regular" print("切换到普通满月模式") elif touched[TOUCH_REGULAR_OFF]: current_mode = "off" print("普通满月关闭") # 根据当前模式更新LED update_leds(current_mode) # 短暂延迟，降低CPU占用并去抖 time.sleep(0.05)状态机逻辑解析： 这是一个简单的“互锁”式状态机。四个触摸输入对应四个明确的动作：“开血月”、“关血月”、“开普通月”、“关普通月”。current_mode变量记录了系统当前所处的唯一状态。这种设计逻辑清晰，不易出错，非常适合这种明确的模式切换场景。
6.3 功能增强与代码优化建议
基础版本已经可用，但我们可以让它更智能、更健壮。
触摸去抖与长按检测：上面的简单读取可能会因环境干扰产生误触发。可以增加去抖逻辑：
# 在循环外定义状态记录 last_touch_state = [False, False, False, False] stable_count = [0, 0, 0, 0] STABLE_THRESHOLD = 3 # 连续检测到3次才认为有效 while True: touched = mpr121.touched_pins for i in range(4): if touched[i]: stable_count[i] += 1 if stable_count[i] >= STABLE_THRESHOLD and not last_touch_state[i]: # 稳定触摸，执行动作 if i == TOUCH_BLOOD_ON: current_mode = "blood" # ... 其他判断 last_touch_state[i] = True else: stable_count[i] = 0 last_touch_state[i] = False # ... 更新LED time.sleep(0.02) # 更快的检测周期渐变过渡效果：突然的颜色切换有些生硬。可以编写一个颜色渐变函数，让模式切换时，LED颜色在1秒内平滑过渡。
def color_wipe(target_color, duration=1.0): start_time = time.monotonic() start_color = pixels[0] if pixels[0] != (0,0,0) else (0,0,0) # 简化处理 while time.monotonic() - start_time < duration: progress = (time.monotonic() - start_time) / duration r = int(start_color[0] + (target_color[0] - start_color[0]) * progress) g = int(start_color[1] + (target_color[1] - start_color[1]) * progress) b = int(start_color[2] + (target_color[2] - start_color[2]) * progress) pixels.fill((r, g, b)) pixels.show() time.sleep(0.01)然后在
update_leds函数中调用color_wipe(target_color)。低功耗优化：如果使用电池供电，可以在“OFF”模式下让CPB进入轻度睡眠，仅通过MPR121的中断（IRQ引脚）来唤醒，这将极大延长电池寿命。
7. 调试、问题排查与优化心得
7.1 常见问题速查表
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 触摸无反应 | 1. MPR121供电或接线错误。 2. I2C通信失败。 3. 铜箔接触不良。 4. 代码中引脚映射错误。 | 1. 用万用表检查3.3V和GND是否到位。 2. 在代码开始处添加 print(“MPR121 found:”, mpr121)检查初始化。3. 用万用表通断档检查鳄鱼夹到MPR121引脚是否导通。 4. 在循环中打印 touched值，观察触摸时对应位是否变化。 |
| LED灯串不亮或颜色错乱 | 1. 电源问题（电压不足、电流不够）。 2. 数据线（DIN）接触不良或接错。 3. GND未共地。 4. NeoPixel对象初始化参数错误。 | 1. 确保使用5V电源，并测量空载电压。WS2812B在4V以下工作不稳定。 2. 检查DIN是否接到正确的GPIO引脚，并重新插拔接头。 3.确保LED灯串的GND与CPB的GND可靠连接，这是最常见的问题。 4. 检查 num_pixels数量是否与实际LED数一致。 |
| LED只有部分亮或顺序乱 | 1. LED灯串中有坏点。 2. 数据流因接触不良中断。 | 1. 单独测试每个LED（写一个测试循环）。 2. 检查灯串中每个焊点，特别是数据线经过的焊点，重新焊接松动的部分。 |
| 触摸反应迟钝或误触发 | 1. MPR121灵敏度需要调整。 2. 环境电磁干扰。 3. 未做触摸去抖。 | 1. MPR121库允许设置触摸和释放阈值。尝试增加触摸阈值(mpr121.touch_threshold) 。2. 确保传感器远离电源线和电机等干扰源。在I2C线上加上拉电阻。 3. 在代码中实现如7.2所述的软件去抖逻辑。 |
| 装置耗电极快 | 1. LED亮度设置过高。 2. 在“OFF”模式下未真正关闭LED或进入低功耗。 | 1. 将brightness调至0.3或更低，肉眼感知差异不大，但省电明显。2. 在OFF模式下，除了 pixels.fill(OFF)，还可以调用pixels.deinit()彻底关闭NeoPixel硬件（再次使用需重新初始化）。考虑使用睡眠模式。 |
7.2 实操心得与进阶技巧
- “先测试，后封装”原则：在将电路装入盒子并粘死之前，务必进行完整的系统测试。包括：每个触摸星星的响应、LED两种颜色的显示、电池供电的稳定性。最好能模拟装置摆放状态测试一段时间。
- 热熔胶使用技巧：热熔胶凝固快，适合固定。但对于需要承受一定应力的地方（如木棍与球体的连接），建议先用快干胶（如401胶水）做初步固定，再用热熔胶加强和填充缝隙。涂抹热熔胶时，胶棒要匀速推进，出胶口离粘合面1-2厘米，以画圈或“之”字形走胶，覆盖面积更大更牢固。
- 电磁兼容性（EMC）简易处理：LED灯串，尤其是WS2812B在快速刷新时会产生高频噪声，可能干扰敏感的电容触摸传感器。如果发现触摸时有闪烁或误触发，可以尝试：a) 将LED灯串的电源线（正负极）绞合在一起；b) 在靠近LED灯串输入端的5V和GND之间并联一个100uF的电解电容和一个0.1uF的陶瓷电容；c) 用铝箔胶带包裹MPR121传感器背面并接地（接GND），做一个简易屏蔽。
- 扩展思路：
- 声音反馈：CPB板载有蜂鸣器。可以在模式切换时加入一个简短的提示音，体验更佳。
- 环境光感应：利用CPB板载的光线传感器，可以自动调节LED亮度。在明亮环境下调亮，黑暗环境下调暗，更智能也更护眼。
- 无线控制与数据记录：利用CPB的蓝牙，可以开发一个手机App，不仅能控制，还能记录每次演示被触摸的次数和模式切换频率，用于教学数据分析。
- 更复杂的灯光效果：模拟月食过程，让灯光从白色渐变为红色再恢复；或者让“血月”的红色带有缓慢的脉动效果，只需在
update_leds函数中动态计算颜色值即可。
这个项目从构思到实现，最大的收获不在于做出了一个多么精致的模型，而在于将编程逻辑、电子电路、物理结构和美学设计无缝衔接的整个过程。它验证了一个想法：技术可以很有温度，可以成为连接抽象知识与直观感知的桥梁。当你看到观众——尤其是孩子们——亲手触摸星星，看着“月球”随之变换颜色，眼中露出好奇与理解的光芒时，你会觉得所有的调试和打磨都是值得的。希望这份详细的指南能帮助你复现或启发属于你自己的那个“发光”的想法。如果在制作中遇到任何问题，回溯一下电路连接和代码逻辑，耐心调试，你一定能点亮属于你的那轮月亮。
