1. 项目概述一个会跳舞的智能珠宝盒如果你对Arduino、Micro:bit这类微控制器项目感兴趣但又觉得从零开始布线、焊接太麻烦那Adafruit的Circuit Playground Bluefruit后文简称CPB绝对是你的“梦中情板”。它集成了加速度计、光线传感器、温度传感器、蜂鸣器、RGB LED灯甚至还有蓝牙功能开箱即用。今天我就用它来做一个特别的“互动珠宝盒”——打开盒盖里面的小舞者会随着音乐旋转周围的LED灯带也会变幻色彩为你的首饰增添一份仪式感和趣味。这个项目非常适合作为硬件编程的入门实践。它不涉及复杂的电路焊接核心是学习如何用一块集成的开发板去驱动外部的执行器伺服电机和LED灯带并通过编程让它们协同工作。你将掌握CPB的基本使用、CircuitPython编程、伺服电机控制以及NeoPixel灯带的驱动。最终成品不仅是一个有趣的装饰品更是一个生动的“物理计算”案例展示了如何用代码让冰冷的硬件变得有生命。2. 核心硬件选型与功能解析2.1 大脑为什么是Circuit Playground Bluefruit在众多微控制器中选择CPB主要基于其“All-in-One”的特性和极低的上手门槛。对于创客和DIY项目尤其是这种融合了灯光、动作和声音的互动装置CPB提供了几个无法拒绝的优势内置传感器丰富板载的LIS3DH三轴加速度计是本项目的关键。我们可以用它来检测珠宝盒的“开合”状态。当盒子平放盖着时加速度计Z轴读数接近1G约9.8 m/s²当盒子被拿起或打开姿态发生变化Z轴读数会显著改变。这个变化就是我们触发舞蹈和灯光效果的“开关”。如果换用普通的Arduino Uno你需要额外购买并连接加速度计模块增加了布线和编程复杂度。集成度高免焊接CPB板周围一圈是10个鳄鱼夹兼容的焊盘标明了GND、VOUT、A0-A7等。这意味着连接伺服电机和LED灯带只需要用鳄鱼夹夹上去即可完全避免了焊接对新手极其友好也方便后续调试和修改。CircuitPython开发体验佳CPB原生支持CircuitPython这是一种基于Python的微控制器编程语言。相比Arduino的CPython语法更简洁直观读写文件、处理数据都更方便。例如控制LED灯带在CircuitPython中可能就是一行strip.fill((255,0,0))而在Arduino中则需要调用特定的库函数并处理颜色格式。对于快速原型开发CircuitPython能大幅提升效率。供电与蓝牙CPB可以通过USB口供电也可以通过其JST接口连接3.7V锂电池实现移动供电。内置的蓝牙LE功能虽然本项目未使用但为未来升级留下了空间比如你可以用手机APP远程控制珠宝盒的灯光模式。注意Adafruit还有一款“Circuit Playground Express”它与Bluefruit的主要区别在于后者集成了蓝牙模块。如果你不需要蓝牙功能Express版本性价比更高且本项目代码完全兼容。2.2 骨骼与肌肉伺服电机与NeoPixel灯带伺服电机SG90/SG92R我们选择 TowerPro SG92R 这类9克微型伺服电机原因在于其尺寸小、扭矩适中、价格低廉。它的工作原理是接收来自CPB的PWM脉冲宽度调制信号。信号脉冲的宽度通常在0.5ms到2.5ms之间决定了电机输出轴的位置0度到180度。在本项目中我们并不需要它精确运动到某个角度而是让它连续旋转稍作修改或在一定角度范围内来回摆动以模拟舞蹈动作。选择它时要注意其工作电压通常4.8V-6V和电流需求CPB的VOUT引脚3.3V可能无法直接驱动需要外部供电这是后面接线时要解决的关键问题。NeoPixel LED灯带Adafruit的NeoPixel系列之所以成为创客项目的标配是因为它采用了单线控制协议。无论一条灯带上有多少颗LED你只需要连接一根数据线Data到微控制器的一个数字引脚就能控制每一颗灯珠的RGB颜色。这极大地简化了布线。我们选择0.5米30颗的规格刚好可以环绕一个小型珠宝盒底部一圈。每颗LED在全白最亮时约消耗60mA电流30颗全亮就是1.8A这远超了CPB板载稳压器或USB口的供电能力。因此外部供电是必须的否则会导致灯光闪烁、微控制器复位甚至损坏硬件。2.3 躯壳珠宝盒本体与舞者制作盒体本身没有特殊电子要求任何材质木、纸、亚克力的盒子都可以。使用激光切割 Baltic birch 薄板1/8英寸约3mm是一种美观且坚固的选择。MakerCase这类在线工具可以帮你生成不同尺寸盒子的切割图纸输入长宽高即可下载SVG文件。舞者的制作是体现个性的地方。原作者用白色织物覆盖伺服电机并撒上亮粉这是一个聪明的方法织物轻盈不会给伺服电机带来过大负载其飘逸感在旋转时能增强舞蹈的视觉效果同时完美隐藏了下方的机械结构。你也可以用轻质卡纸、羽毛甚至3D打印一个微型人偶。核心原则是质量轻、重心稳、不易缠绕。3. 硬件连接与供电方案详解这是项目中最容易出错的部分正确的连接是稳定工作的基石。我们将采用外部电源为伺服电机和LED灯带独立供电以保护CPB。3.1 安全第一理解供电分离原理CPB的USB口或电池接口其供电能力有限通常500mA-1A。伺服电机在启动和堵转时会产生瞬间大电流NeoPixel灯带在全亮时更是“电老虎”。如果让CPB直接为它们供电轻则导致板子复位程序重启重则可能损坏CPB的稳压芯片。因此我们采用“共地”分离供电方案控制信号由CPB提供CPB的IO引脚输出微弱的控制信号PWM给伺服数据信号给灯带。电力由外部电源提供一个独立的5V电源如旧的手机充电器USB线或专用的5V DC电源适配器为伺服电机和LED灯带供电。共地是关键将外部电源的负极GND与CPB的GND引脚连接起来。这样控制信号就有了统一的电压参考点才能被正确识别。3.2 接线步骤与示意图你需要准备一些公对母杜邦线或直接使用鳄鱼夹。以下是具体连接方法准备外部5V电源找一个输出为5V、电流不小于2A的DC电源适配器。剪掉设备端露出红正极、黑负极两根线。连接NeoPixel灯带灯带输入端通常有3个焊盘5V(VCC),GND,DI(Data In)。将外部电源的红线5V连接到灯带的5V。将外部电源的黑线GND连接到灯带的GND。同时从这一点引出一根线连接到CPB板上的任何一个GND焊盘。这就是“共地”。用一根信号线将CPB上的A1引脚或其他任意数字引脚代码中需对应连接到灯带的DI。连接伺服电机伺服电机有三根线红色电源棕色或黑色GND橙色或黄色信号。将外部电源的红线5V也连接到伺服的红线。你可以使用面包板或者将多根线拧在一起用焊锡固定。将外部电源的黑线GND也连接到伺服的黑线。至此外部电源的GND已同时连接了灯带、伺服和CPB。用一根信号线将CPB上的A2引脚连接到伺服的信号线黄/橙。最终检查确保所有GND都连通了CPB GND - 灯带GND - 伺服GND - 外部电源GND。确保5V只供给灯带和伺服绝不连到CPB的VOUT或USB口。实操心得在实际组装前强烈建议先在桌面上用面包板完成所有连接并测试代码。确认一切工作正常后再将其装入珠宝盒内进行固定。这能避免在狭窄空间内调试的抓狂。4. CircuitPython代码深度剖析与编写我们将使用Adafruit的CircuitPython库它让控制硬件变得异常简单。首先确保你的CPB已经刷入了最新的CircuitPython固件并用Mu Editor或VS Code with CircuitPython插件进行编程。4.1 代码结构规划我们的程序需要实现以下功能初始化设置引脚初始化伺服电机和灯带对象。状态检测循环读取加速度计数据判断盒子是否被移动打开。触发动作当检测到打开状态时启动“表演模式”——伺服电机开始摆动灯带开始播放灯光动画同时蜂鸣器播放旋律。结束表演当盒子被放回静止状态一段时间后停止所有动作进入低功耗待机状态。4.2 核心代码实现以下是code.py的主要内容CircuitPython设备会自动运行根目录下的code.py文件import time import board import pwmio from adafruit_motor import servo from adafruit_circuitplayground import cp import neopixel import random # 1. 硬件初始化 # 初始化NeoPixel灯带连接到A1引脚30颗灯珠 pixels neopixel.NeoPixel(board.A1, 30, brightness0.2, auto_writeFalse) # 初始化伺服电机连接到A2引脚 pwm pwmio.PWMOut(board.A2, frequency50) my_servo servo.Servo(pwm) # 全局状态变量 performance_active False idle_start_time 0 PERFORMANCE_DURATION 10 # 表演持续10秒 IDLE_TRIGGER_TIME 2 # 静止2秒后结束表演 # 一个简单的音乐旋律用蜂鸣器播放以频率和持续时间列表表示 # 这里以《小星星》片段为例 twinkle_melody [ (262, 0.5), (262, 0.5), (392, 0.5), (392, 0.5), (440, 0.5), (440, 0.5), (392, 1), # 哆哆嗦嗦啦啦嗦 (349, 0.5), (349, 0.5), (330, 0.5), (330, 0.5), (294, 0.5), (294, 0.5), (262, 1) # 发发咪咪来来哆 ] melody_index 0 def check_box_opened(): 通过加速度计判断盒子是否被拿起/打开 # 读取Z轴加速度。当盒子平放静止时Z轴约等于9.8 # 当被拿起或倾斜时绝对值会显著减小或变为负值 x, y, z cp.acceleration # 计算加速度矢量的模排除轻微震动干扰 magnitude (x**2 y**2 z**2)**0.5 # 如果模与重力加速度相差较大则认为被移动 if abs(magnitude - 9.8) 3.0: # 阈值可根据实测调整 return True return False def start_performance(): 启动舞蹈、灯光和音乐 global performance_active, melody_index performance_active True melody_index 0 cp.play_tone(523, 0.1) # 一个简短的启动提示音 print(表演开始) def stop_performance(): 停止所有表演 global performance_active performance_active False my_servo.angle 90 # 让伺服回到中立位置 pixels.fill((0, 0, 0)) # 关闭所有LED pixels.show() cp.stop_tone() print(表演结束。) def update_performance(): 更新表演的每一帧伺服摆动、灯光动画、音乐播放 global melody_index # 1. 伺服电机摆动在40度到140度之间正弦摆动 import math angle 90 50 * math.sin(time.monotonic() * 3) # 3控制摆动速度 my_servo.angle angle # 2. NeoPixel灯光动画彩虹渐变 for i in range(len(pixels)): # 根据时间和灯珠位置计算色相 hue (time.monotonic() * 0.5 i * 0.02) % 1.0 # 将色相转换为RGB颜色使用colorsys库或手动计算此处简化 # 这里使用一个简单的彩虹函数替代 r, g, b wheel(hue) pixels[i] (r, g, b) pixels.show() # 3. 播放音乐旋律 if melody_index len(twinkle_melody): freq, duration twinkle_melody[melody_index] if not cp._speaker_enabled: cp._speaker_enabled True cp.play_tone(freq, duration) melody_index 1 def wheel(pos): 输入一个0-1的值返回一个彩虹色RGB元组 if pos 0.33: return (int(255 * (0.33 - pos) * 3), int(255 * pos * 3), 0) elif pos 0.66: pos - 0.33 return (0, int(255 * (0.66 - pos) * 3), int(255 * pos * 3)) else: pos - 0.66 return (int(255 * pos * 3), 0, int(255 * (1 - pos) * 3)) # 主循环 while True: box_moved check_box_opened() if box_moved and not performance_active: # 检测到移动且当前不在表演中则开始表演 start_performance() idle_start_time 0 # 重置空闲计时器 elif not box_moved and performance_active: # 盒子静止但表演还在进行开始计时 if idle_start_time 0: idle_start_time time.monotonic() elif time.monotonic() - idle_start_time IDLE_TRIGGER_TIME: # 静止时间超过阈值停止表演 stop_performance() elif performance_active: # 表演正在进行中更新每一帧 update_performance() # 检查表演是否超时 if time.monotonic() - (idle_start_time if idle_start_time 0 else time.monotonic()) PERFORMANCE_DURATION: stop_performance() time.sleep(0.05) # 短暂延迟降低CPU占用4.3 代码关键点解析加速度计滤波check_box_opened函数中我们计算了加速度的矢量模并与标准重力加速度比较。这比单纯检查某个轴的数据更稳健因为盒子可能以任何角度被拿起。阈值3.0可能需要根据你的盒子和伺服电机震动情况进行微调。状态机逻辑程序通过performance_active这个布尔变量清晰地管理“待机”和“表演”两种状态。这是嵌入式编程中常见的模式避免逻辑混乱。非阻塞式音乐播放我们通过melody_index索引逐音符播放而不是用time.sleep()长延迟来播放一个音符。这样在播放音乐的同时伺服和灯光动画依然能流畅运行。节能考虑当表演停止后伺服归中、灯带关闭、蜂鸣器停止程序进入低功耗的主循环仅定期检查加速度计。5. 机械组装与美学优化技巧硬件和代码测试无误后就可以进行最终组装了。这一步决定了成品的可靠性和美观度。5.1 伺服电机与舞者的安装固定伺服使用热熔胶或强力双面胶将伺服电机牢固地粘在珠宝盒盖子的内侧中央。确保电机轴所在的盖子区域有足够空间让舞者旋转而不碰到盒壁。制作舞者剪一块直径约4-5厘米的圆形轻薄白纱或无纺布。在中心剪一个小孔套过伺服电机的输出轴。可以使用伺服电机附带的圆形舵盘将纱巾边缘用胶水点在舵盘上这样旋转时更有形。撒上亮粉或粘贴微型亮片。隐藏走线将连接伺服的电线沿着盒盖内侧用胶带或线卡固定并从盒子后方的铰链处或预先钻好的小孔引入盒体内部。避免电线被铰链压到。5.2 NeoPixel灯带的安装成型将条状灯带弯曲成一个圆圈使其恰好能放入珠宝盒底部。灯带背面有胶条但为了更牢固可以使用透明的热熔胶或硅胶沿边缘少量点胶固定。光线扩散直接看LED灯珠会刺眼。为了获得柔和的光晕效果可以在灯带上方覆盖一层乳白色的亚克力板或磨砂的PET塑料片作为光扩散层。这能让你看到均匀的色彩而不是一个个光点。供电线管理5V电源线和信号线同样需要从盒子底部或后方的小孔引出。在盒内可以用扎带或胶水固定防止其松动影响灯带。5.3 整体集成与调试CPB主板固定将CPB板用尼龙柱或双面胶固定在盒子内部空闲位置确保其加速度计方向与盒子方向一致通常板子平放正面朝上。最终连接在盒内将所有鳄鱼夹或杜邦线接头连接好。建议用一点热熔胶固定接头防止因震动脱落。功能测试合上盖子静置几秒然后打开或拿起盒子。观察舞者是否开始旋转灯光是否亮起音乐是否播放。放下盒子等待几秒所有动作是否停止。灵敏度调整如果发现太敏感轻微触碰就触发或太迟钝需要大力摇晃回到代码中调整check_box_opened函数里的阈值3.0这个值。6. 常见问题排查与进阶优化即使按照教程操作你也可能会遇到一些问题。这里列出一些常见坑点及其解决方案。6.1 问题速查表问题现象可能原因排查步骤与解决方案上电后无任何反应1. CPB未正确供电。2.code.py程序错误导致崩溃。1. 检查USB线是否插紧CPB上红色电源LED是否亮起。2. 连接电脑用Mu Editor打开串行控制台Serial查看错误信息。通常是因为库未安装或语法错误。伺服电机不转发出滋滋声1. 供电不足。2. 信号线连接错误。3. 机械卡死。1.这是最常见原因确保使用外部5V电源为伺服供电且电流足够1A以上。2. 检查信号线是否连接到CPB的指定引脚如A2代码中引脚定义是否一致。3. 手动拨动一下舵盘看是否被舞者或线材卡住。LED灯带不亮或部分不亮1. 供电不足或接反。2. 数据流方向错误。3. 单颗LED损坏。1. 确保外部5V电源正常工作用万用表测量灯带输入端电压。确认5V和GND没有接反接反会瞬间烧毁灯带2. NeoPixel灯带有方向性数据输入DI端必须接CPB输出DO端空置或接下一段。3. 如果从某颗LED之后都不亮可能是该颗LED损坏。尝试在该处剪断跳过坏点焊接。灯带颜色错乱、闪烁1. 电源干扰。2. 信号线过长。3. 共地不良。1. 为外部5V电源并联一个470μF以上的电解电容以平滑伺服电机动作引起的电压波动。2. 数据线尽量短50cm如果必须延长可在CPB数据输出端串联一个300-500欧姆的电阻。3.再次确认CPB的GND和外部电源的GND已可靠连接这是最容易被忽略的一点。加速度计检测不灵敏1. 阈值设置不当。2. 板子安装方向影响读数。1. 在代码中添加print(cp.acceleration)并打开串口监视器观察拿起和放下盒子时的数值变化据此调整阈值。2. 确保CPB板子与盒子相对固定不要晃动。音乐播放断断续续1. 主循环延迟过长。2. 蜂鸣器被其他任务阻塞。1. 确保主循环中的time.sleep延迟非常短如0.05秒。2. CircuitPython的cp.play_tone是非阻塞的但播放下一个音符前需要调用cp.stop_tone()或等待前一个音符时长结束。检查update_performance中的音乐逻辑。6.2 项目进阶优化思路当基础功能实现后你可以尝试以下升级让珠宝盒更具个性多种表演模式通过CPB板载的按键A/B键来切换不同的灯光模式和舞蹈动作。例如按A键切换彩虹波浪按B键切换呼吸灯效舞蹈动作可以从正弦摆动改为随机角度变化。光敏模式利用CPB板载的光线传感器实现“夜间模式”——当环境光变暗时自动开启柔和的底灯作为小夜灯使用。蓝牙控制利用CPB的Bluefruit功能编写一个简单的手机APP使用Adafruit的Bluefruit LE Connect应用或自己用MIT App Inventor开发实现用手机远程切换灯光颜色、控制舞者启停。电池供电与低功耗使用一块3.7V锂电池通过JST接口为整个系统供电。在代码中深度优化当盒子长时间静止时让CPB进入“睡眠”模式仅通过加速度计中断唤醒从而大幅延长电池续航。更复杂的音乐将更长的MIDI音乐文件转换为频率数组或者利用CPB的存储空间直接播放WAV音频文件需要额外的音频放大电路让珠宝盒播放你最喜欢的旋律。这个项目从概念到实现完整地走通了一个互动装置的设计流程。它教会你的远不止是连接几根线、写几行代码更重要的是如何将创意分解为硬件选型、电路设计、软件逻辑和机械组装等具体问题并逐一解决。当你看到自己制作的舞者随着你编写的旋律翩翩起舞时那种软硬件结合带来的成就感正是创客精神的精髓所在。