用Arduino与加速度计打造可编程电子万花筒：从传感器原理到光学实现

1. 项目概述与核心思路

几年前我第一次接触Arduino和各类传感器时，就在想，能不能用这些电子元件做一些“不插电”感觉的玩具，让技术回归到一种质朴的、物理的互动乐趣里。后来看到Adafruit的Circuit Playground开发板，它把加速度计、麦克风、温度传感器还有一圈NeoPixel彩灯都集成在一块巴掌大的板子上，当时就觉得，这简直是做互动装置的“瑞士军刀”。于是，用加速度计和NeoPixel做一个电子万花筒的想法就冒出来了。

这个项目的核心逻辑非常直观：我们小时候玩的万花筒，是靠转动筒身，让内部的彩色碎片反射形成变幻的对称图案。在这个电子版本里，我们用加速度计来模拟“转动”这个动作，用NeoPixel环形灯来模拟“彩色碎片”，再用一个日常的圆筒（比如薯片罐）和反光材料（比如铝箔）作为光学腔体。当你旋转这个装置的一端时，加速度计会感知到角度的变化，Arduino程序根据这个变化计算出当前的方向，并驱动NeoPixel灯环切换不同的色彩模式。灯光通过反光腔体的多次反射，在你的眼睛里形成不断变化、绚丽对称的光影图案，效果和传统万花筒异曲同工，但内核完全数字化、可编程。

它适合所有对硬件互动、Arduino编程或者创意制作感兴趣的朋友。你不需要是电子或编程专家，只要跟着步骤一步步来，就能亲手做出一个独一无二的、会发光的现代万花筒。整个过程，你会学到如何读取传感器数据、如何将物理动作映射为视觉反馈，以及如何巧妙地利用身边材料解决硬件封装问题——这些都是创客项目的核心乐趣所在。

2. 核心硬件解析与材料准备

2.1 Circuit Playground开发板深度解析

这个项目的“大脑”和“感官”都集成在一块Adafruit Circuit Playground经典版开发板上。选择它而不是普通的Arduino Uno加一堆扩展模块，原因有几个：首先是高度集成，它自带10个可编程的NeoPixel RGB LED（排列成一个环）、一个三轴加速度计（LIS3DH）、麦克风、温度传感器等多个常用元件，省去了繁琐的接线，极大降低了硬件门槛和出错概率。其次是易用性，板载的USB接口可以直接供电和编程，两侧的大号鳄鱼夹插孔方便连接外部设备，对新手非常友好。最后是社区与库支持，Adafruit为其提供了完善的Adafruit_CircuitPlayground库，用几行代码就能调用复杂功能，让我们能专注于创意逻辑而非底层驱动。

这里重点说一下我们将用到的两个核心部件：

1. 三轴加速度计（LIS3DH）：它本质上是一个微机电系统（MEMS），内部有一个微小的“质量块”。当板子移动或倾斜时，惯性会使质量块相对于芯片发生位移，这个位移被转化为电容变化，进而输出代表三个轴（X, Y, Z）加速度值的电信号。在静止状态下，它主要感知的是重力加速度（1g）。因此，通过测量重力加速度在X和Y轴上的分量，我们就可以精确计算出板子相对于水平面的倾斜角度，这正是我们检测“旋转”动作的物理基础。
2. NeoPixel环形灯：这不是普通的LED，每个灯珠都是一个集成了驱动芯片的智能RGB LED。你只需要一根数据线，就能通过特定的时序信号控制上百个灯珠的颜色和亮度，实现复杂的动画效果。Circuit Playground上的10个NeoPixel排列成环，非常适合制作 radial（放射状）的光效，为万花筒的对称视觉效果提供了完美的光源。

2.2 材料清单与替代方案

原项目建议的核心材料是一个长薯片罐（如品客薯片罐）和一个能套在它一端的短罐。这个选择非常巧妙：薯片罐直径（约73mm）与Circuit Playground板子（约50mm宽）和常见的3节AAA电池盒尺寸匹配，且是现成的圆筒，强度尚可，表面容易加工。

必备材料清单：

• 主控与显示：Adafruit Circuit Playground经典版开发板 x1
• 电源：3节AAA电池盒（带开关）x1， 或一块小型3.7V锂聚合物电池（如350mAh）。锂电池更轻薄，但AAA电池盒更容易获取。
• 光学腔体：
  • 长薯片罐（约245mm）x1
  • 短薯片罐（约80mm）或另一个长罐裁剪而成 x1
• 反光材料（二选一）：
  • 铝箔（厨房用）：约235mm x 245mm一张。优点是家家都有，容易塑形产生不规则反光。
  • 镀铝PET膜（即“镭射膜”或某些礼品包装纸）：尺寸同上。优点是反光率更高，图案更锐利，在文具店或网上易购得。
• 固定材料：
  • 强力双面胶（约30mm长）或蓝丁胶（Blu Tack）/橡皮泥。强烈建议使用蓝丁胶，它可重复使用、不导电、不留残胶，方便后期拆卸修改。
• 工具：剪刀、美工刀、尺子、胶棒或透明胶带（用于固定反光材料）。

材料选择的深层考量与替代方案：

• 为什么是圆筒？圆筒是形成无限反射对称图案的理想几何结构。光线在圆形反射面内会形成完美的径向对称，这是万花筒视觉效果的核心。方筒或其他形状会破坏这种对称性。
• 罐子直径的权衡：罐子内径决定了观察视野和反射路径。太细（如乒乓球筒）会导致视野狭窄，NeoPixel灯光可能无法充分反射展开；太粗（如燕麦罐）则会使光线衰减过快，图案暗淡。薯片罐的直径是一个经过实践验证的折中值。
• 反光材料的选择：铝箔的漫反射较多，形成的图案边缘较柔和，带有一种“梦幻”的光晕感，且褶皱会产生随机纹理，增加趣味性。镀铝膜是镜面反射，图案更清晰、锐利，色彩更鲜艳。你可以都试试，感受不同的艺术效果。
• 安全提示：使用美工刀切割罐子时务必小心，最好有成人协助。罐子切口可能锋利，完成后可以用胶带包边处理。

3. 程序设计：从传感器数据到光影魔法

这是项目的灵魂所在。我们不仅要让灯亮起来，还要让灯的变化与你旋转罐子的动作丝滑、直观地关联起来。

3.1 代码结构与核心逻辑拆解

提供的代码骨架已经搭建得很好，我们来深入理解每一部分在做什么，以及为什么要这么做。

#include <Adafruit_CircuitPlayground.h> // 引入核心库，这是所有功能的基础 const int NUMBER_OF_LEDS_ON_RING = 10; // NeoPixel的数量，固定为10 const int brightness = 25; // 全局亮度设置，25（约10%亮度）足够在暗环境下观看，且省电 int ledPosition, led, previousLed = 0; // 用于追踪当前和上一个被“点亮”的LED索引 float x, y, nx, ny, angle; // 存储加速度计原始值、归一化值和计算出的角度

setup()函数：这是标准配置，初始化开发板并设置亮度。将亮度设为25是一个经验值，在黑暗环境中这个亮度既能产生绚丽的反射，又不会因为过亮而刺眼或让图案失去层次感。

loop()函数的核心流程：

1. 读取数据：CircuitPlayground.motionX()和motionY()获取当前X轴和Y轴的加速度值（单位通常是m/s²）。我们忽略Z轴，因为在这个应用中，我们只关心在水平面内的旋转。
2. 数据归一化：将原始加速度值除以10.0。这是一个关键的标定（Scaling）步骤。加速度计在静止时，由于重力，单轴输出值约在9.8左右（取决于方向）。除以10是为了将数值范围大致映射到-1.0到1.0之间，方便后续的角度计算，避免数值过大。
3. 计算倾斜角度：使用atan2(y, x)函数是二维平面角度计算的黄金标准。它接受Y和X值，返回从X轴正方向到点(x, y)的弧度制角度，范围在-π到π之间。代码中atan(ny/nx)的写法在nx为0或负值时容易出错，更健壮的写法是使用atan2(ny, nx)。随后将弧度转换为角度（乘以180/π）。
4. 角度范围修正：atan2返回的角度范围是-180°到180°。为了编程方便，我们通常将其转换到0°到360°的连续范围。后面的一连串if-else判断就是在做这件事，根据nx和ny的正负号，将角度“平移”到正确的象限。
5. 角度到LED索引的映射：这是实现“旋转控制光效”的关键一步。我们将0-360度的范围，均匀映射到0-9这10个LED索引上。公式angle / (360 / NUMBER_OF_LEDS_ON_RING)实现了这一点。例如，当角度为0°时，对应LED 0；36°时，对应LED 1，以此类推。
6. 平滑过渡处理：这是原代码非常精妙的一处设计。如果计算出的目标LED（led）与上一个LED（previousLed）相同，则什么都不做。如果不同，则判断两个LED在环上的“逆时针距离”。如果这个距离小于等于8（这是一个经验阈值，意味着是“小幅度”顺时针旋转），则让光效沿着彩虹环顺时针走一步（previousLed + 1）；否则，就逆时针走一步（previousLed - 1）。这个逻辑确保了当你缓慢旋转罐子时，光效是平滑地、一步一步地过渡，而不是突兀地跳转到目标位置，大大提升了交互的质感和自然度。
7. 驱动LED显示：最后，调用rainbowCycle函数，并传入一个代表变化速度的索引（这里巧妙地复用了led变量作为速度索引，但更清晰的做法是使用独立变量）。这个函数根据当前时间和速度，为每个LED计算一个在色轮（color wheel）上偏移的颜色，从而产生流动的彩虹效果。

3.2 关键算法优化与自定义空间

原代码提供了一个可靠的基础，但这里正是你可以发挥创意的地方。

1. 角度计算的稳健性改进：建议将角度计算部分替换为更标准的atan2函数，避免除零错误：

// 更稳健的角度计算 angle = atan2(ny, nx) * 180.0 / 3.14159265359; // 使用atan2和更精确的PI值 if (angle < 0) { angle += 360.0; // 将范围从(-180, 180)转换到(0, 360) }

2. 映射关系的自定义：原程序是“角度变化”驱动“彩虹色相变化”。你可以尝试其他映射关系：

• 亮度控制：将角度映射到亮度值（0-255），旋转改变整体明暗。
• 色彩模式切换：将360度划分为4-6个区间，每个区间触发一种固定的颜色模式（如纯色、双色渐变、闪烁等）。
• 动态速度：将角度变化的速度（而不仅仅是位置）映射为彩虹动画的速度，转得快则流光快，转得慢则流光慢。

3. 丰富的光效函数：rainbowCycle只是其中一种效果。你可以定义多个光效函数，例如：

void solidColor(int hue) { // 将所有LED设置为色轮上某个固定色调的颜色 for(int i=0; i<10; ++i) { CircuitPlayground.strip.setPixelColor(i, CircuitPlayground.colorWheel(hue)); } CircuitPlayground.strip.show(); } void breathing(int hue) { // 呼吸灯效果，亮度正弦变化 int brightness = (int)((sin(millis() / 1000.0) + 1) * 127.5); CircuitPlayground.setBrightness(brightness); solidColor(hue); }

然后在主循环中，根据angle所在的区间，调用不同的光效函数。

4. 添加声音反馈（进阶）：Circuit Playground还有蜂鸣器。你可以让它在切换到特定颜色或旋转过快时，发出简短的提示音，增加多维互动体验。

实操心得：调试传感器在编写和测试代码时，务必先用串口监视器打印出x, y, angle的值。将板子水平放置，缓慢旋转，观察角度值是否在0-360之间平稳变化。这能帮你快速定位是传感器数据问题、计算逻辑问题还是映射问题。这是硬件编程中最高效的调试方法。

4. 硬件组装与光学调试

写完代码并上传到板子后，硬件组装就是见证奇迹的最后一步。这个过程一半是工程，一半是艺术。

4.1 罐体加工与反光层铺设

1. 切割长罐：用美工刀和尺子，小心地切掉长薯片罐的底部。切口尽量平整。这是未来我们观察万花筒的“目镜”端。
2. 制作短罐套筒：
   • 如果短罐和长罐直径完全相同，需要在长罐被套的一端，纵向切割一个40-50mm的缝隙。这个缝隙能让短罐更紧密地套上去，且便于调节松紧。
   • 如果短罐直径略大于长罐（比如用了不同品牌的罐子），则可能不需要开缝，直接套上即可，但可能需要一点胶带加固。
3. 铺设反光层：
   • 铝箔方案：将铝箔亮面朝内，小心地卷成圆筒，塞入长罐内部。故意保留一些轻微的褶皱，这会让反射光产生有趣的、不可预测的纹理，效果更接近传统万花筒中的碎玻璃。用胶棒或双面胶在几个点固定铝箔与罐壁，防止其松脱。注意不要产生大的气泡或完全遮挡的接缝。
   • 镀铝膜方案：由于膜更挺括，需要更精确地裁剪和卷曲。确保亮面朝内，接缝处用透明胶带粘合。这种方案能得到更干净、锐利的几何反射图案。
   • 关键检查：完成后，从切掉底部的“目镜”端看向罐内，应该看到一个深邃的、由多重反射形成的无限隧道。如果看不到清晰的重复反射，可能是反光层有褶皱遮挡了视线，或者没有贴平整。

4.2 电路固定与总装

1. 固定电池与主板：
   • 取一小块蓝丁胶，揉捏激活后，粘在3节AAA电池盒的背面（没有开关的一面）。
   • 将Circuit Playground开发板NeoPixel灯环朝外（即朝向罐底方向），按压在电池盒上，使蓝丁胶同时粘住电池盒和主板。确保主板固定牢固，不会晃动。
   • 再取一点蓝丁胶，粘在电池盒的底部（有开关的一面）。
2. 装入短罐：将粘好电路和电池的组件，NeoPixel灯环朝下，放入短罐的底部。按压电池盒底部的蓝丁胶，使其固定在罐底。此时，从短罐开口看去，应该能看到Circuit Playground板子稳稳地坐在底部，10个NeoPixel清晰可见。
3. 连接与测试：打开电池开关。Circuit Playground板上的绿色电源LED应亮起，NeoPixel灯环应开始发出预设光效（如彩虹循环）。如果没亮，立即关闭电源，检查电池极性、电量以及主板与电池盒的连接是否松动。
4. 最终合体：将短罐（带电路的一端）套在已经铺好反光层的长罐上。套上后，短罐的底部（现在装有电路）就成为了万花筒的“物镜”端，光线从这里发出，在长罐的反光壁中不断反射。

注意事项：散热与安全NeoPixel在较高亮度下长时间工作会产生热量。我们将亮度设置在25，且项目是间歇性使用，所以散热不是问题。但如果你自定义程序将亮度调到很高（比如>150），并长时间点亮，务必确保电路部分有轻微的空气流通，不要完全密封在绝热材料里。此外，使用蓝丁胶而非强力胶固定，就是为了方便随时拆卸，既能回收元件，也便于排查故障。

5. 效果优化与创意扩展

基础版本完成后，你可以从光学和编程两方面进行升级，让它变得更具个性和表现力。

5.1 光学效果的进阶玩法

1. 添加“物镜”滤镜：
   • 在短罐的开口端（即NeoPixel灯环前方），用美工刀在另一个薯片罐的塑料盖上切割出星形、雪花形或多边形孔洞，然后盖上去。这会在光路中形成遮罩，让反射出的光斑呈现特定的形状，而不仅仅是圆点。
   • 寻找小型凸透镜或平凸透镜（可从旧玩具放大镜或激光笔镜头中获得），安装在短罐端。这会产生聚焦和放大效果，让图案中心更亮，边缘产生畸变，更具迷幻感。
2. 引入散射与折射介质：
   • 在两个罐盖之间撒入一些彩色透明珠子、碎糖纸或磨砂塑料片，然后密封盖好，做成一个可插入的“效果模块”。当光线穿过这些不规则介质时，会发生散射和折射，产生类似传统万花筒中彩色碎玻璃的星光点点效果。
3. 外部装饰：用丙烯颜料、贴纸或包装纸装饰罐身外部。一个好看的外壳能让作品从“实验原型”升级为“创意礼物”。

5.2 程序效果的深度定制

1. 多模式切换：利用Circuit Playground上的左右按键（A4, A5），实现光效模式的切换。例如，按左键在“彩虹循环”、“呼吸灯”、“随机火花”等模式间循环。

   if (CircuitPlayground.leftButton()) { mode = (mode + 1) % TOTAL_MODES; // 模式循环 delay(250); // 简单防抖 } // 在loop中根据mode值调用不同的光效函数

2. 环境光感应：利用板载的光敏传感器，让万花筒在黑暗环境中自动降低亮度，在明亮环境中提高亮度，或者完全关闭灯光以省电。
3. 声音互动：利用板载麦克风，将环境声音的幅度或频率映射到颜色变化或亮度上。拍手或说话就能让万花筒“随声起舞”。
4. 运动记忆：利用板载的EEPROM（非易失存储器），保存最后一种光效模式或颜色偏好。即使断电重启，也能恢复到上次的状态。

6. 故障排查与常见问题

在制作过程中，你可能会遇到以下问题。别担心，大部分都有简单的解决办法。

这个项目最吸引我的地方，在于它完美地诠释了“创客”精神：用简单的电子模块（传感器+执行器），加上一点巧思和编程，就能把日常废弃物品变成充满惊喜的互动艺术品。它不像一个冰冷的电子实验，而更像一个你可以拿在手里把玩、向朋友展示的魔法道具。当你缓慢转动罐身，看着里面的光影随着你的动作流淌变幻时，那种直接、即时的物理反馈所带来的愉悦感，是纯屏幕交互无法比拟的。

我建议你在完成基础版本后，一定要尝试修改代码。哪怕只是改变colorWheel的偏移量，或者尝试一下我上面提到的solidColor函数，你都会立刻看到截然不同的视觉效果。硬件项目最大的成就感，就来自于“我改了一行代码，世界就变了样”的瞬间。这个小小的万花筒，就是你探索物理计算和创意编程的一个绝佳起点。