从NeoPixel到可穿戴光效：基于CircuitPython的智能手环DIY全解析

1. 项目概述：打造你的专属光效手环

几年前，我第一次接触到可编程LED灯带，那种通过几行代码就能让灯光“活”起来的感觉，让我彻底迷上了硬件DIY。从简单的跑马灯到复杂的音乐频谱，我尝试了各种玩法，但总觉得少了点什么——它们大多固定在某个地方，缺乏互动和个性。直到我开始琢磨可穿戴设备，才找到了答案：把光效戴在身上，让它成为你情绪和风格的一部分。

这个基于Adafruit QT Py和NeoPixel LED的智能手环项目，就是我探索路上的一个结晶。它不仅仅是一个会发光的手镯，更是一个融合了电路设计、结构制作和颜色编程的完整工程实践。手环的核心是一个小巧但功能强大的QT Py微控制器，它驱动着两排侧发光LED灯带。灯光透过热熔胶形成的“宝石”进行混合与扩散，从而产生平滑、动态的彩虹渐变效果。最巧妙的设计在于，为手环供电的锂电池通过一个改造的USB-C接口连接，而这个接口本身又充当了手环的搭扣——扣上即通电，打开则断电，无需额外的电源开关。

整个制作过程涉及从切割EVA泡沫结构、焊接电路，到封装热熔胶导光体和编写渐变算法的多个环节。无论你是想入门CircuitPython编程，还是希望亲手制作一个独一无二的电子穿戴饰品，这个项目都能提供从硬件到软件的全流程指导。接下来，我将拆解每一个步骤，分享我在制作过程中积累的经验和避坑技巧。

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

2.1 为什么选择QT Py与NeoPixel这个组合？

在开始动手之前，理解每个核心元件的选型理由至关重要。这决定了项目的可行性、效果和最终体验。

主控板：Adafruit QT Py SAMD21我选择QT Py，首要原因是其极致的尺寸（约22mm x 18mm）和完整的微控制器功能。对于手腕佩戴的设备，每一毫米的空间都极其宝贵。QT Py在如此小的面积上集成了ARM Cortex-M0+核心的SAMD21芯片，运行频率高达48MHz，处理复杂的灯光动画绰绰有余。其次，它原生支持CircuitPython，这是一种基于Python的微控制器编程语言，语法简单直观，非常适合快速原型开发和创意编程。你不需要复杂的开发环境，只需像操作U盘一样将代码文件拖入板载存储即可运行，极大降低了编程门槛。

灯光单元：NeoPixel侧发光LED灯带NeoPixel是Adafruit对WS2812系列可寻址LED的统称。其核心优势在于“智能”和“串联”。每个LED芯片内部都集成了驱动电路和信号整形器，你只需要一根信号线（Data In）就能控制成百上千个灯珠，每个灯珠的RGB颜色都可以独立设置。这简化了布线，也使得复杂的灯光图案成为可能。

注意：市面上常见的NeoPixel灯带大多是正面发光（光线垂直于灯带表面）。而这个项目特意选用了**侧发光（Side Light）**型号。这种灯珠（通常是4020封装，4mm x 2mm）的光线是从侧面射出的。为什么这么设计？因为我们的目标是让光线在水平方向（沿着手腕）传播，并注入到旁边的热熔胶“宝石”中进行混合。如果使用正面发光的灯带，光线会直射向上，难以在相邻的“宝石”间形成平滑的渐变过渡。侧发光灯带完美解决了这个问题，光线沿着灯带边缘射出，能更有效地被导光材料捕获和扩散。

供电方案：集成USB-C接口的锂电池项目采用了一块3.7V、350mAh的锂聚合物电池。这个容量在亮度适中（代码中设置为40%）的情况下，可以提供数小时的续航，满足日常佩戴需求。整个供电设计的精髓在于将USB-C公头 breakout板直接焊接到电池导线上，并以此作为物理搭扣。这实现了两个关键目标：一是省去了一个独立的电源开关，简化了电路和结构；二是利用了USB-C接口坚固的物理特性，使其能承受反复的插拔（即佩戴和摘下手环）。这种“功能复用”的设计思路，在空间受限的可穿戴项目中非常值得借鉴。

2.2 结构设计：如何在柔软与坚固之间取得平衡？

一个舒适的电子穿戴设备，其结构设计的重要性不亚于电路。本项目采用了一种“三明治”结构，在两层EVA泡沫之间夹入所有电子元件和记忆钢丝。

EVA泡沫：保护与固定的基石EVA（乙烯-醋酸乙烯酯）泡沫是一种柔软、有弹性且易于切割的工艺材料，厚度选择2-3mm为宜。它扮演了多重角色：

1. 缓冲与舒适：柔软的质地确保了佩戴的舒适性，避免了硬质电路板直接接触皮肤。
2. 绝缘与保护：将电路、焊点和导线包裹在内，防止短路，也避免了日常磕碰对元件的损伤。
3. 固定与定位：通过上层泡沫的精确开槽，可以将QT Py和每一颗LED灯珠牢牢固定在预设位置，这是实现规整光效的基础。

记忆钢丝：赋予形状与保持张力记忆钢丝是一种具有“形状记忆”特性的弹簧钢线。将其弯成环形后，它会顽强地保持这个形状。在项目中，两圈记忆钢丝被放置在泡沫夹层中，它们的作用是：

• 定义手环形状：让手环自然地保持环形，贴合手腕。
• 提供结构支撑：防止柔软的泡沫在反复弯折后变形或疲劳。
• 分散应力：当手环被撑开佩戴时，弯曲的应力主要由记忆钢丝承担，而不是直接传递到脆弱的焊点和QT Py的USB-C插座上，极大提高了产品的耐用性。

热熔胶“宝石”：光线的混合器与扩散器这是实现梦幻渐变效果的关键。透明的白色热熔胶充当了导光和散光介质。当两个相邻但发出不同颜色光的LED从两侧将光线射入同一块热熔胶时，光线会在胶体内发生多次反射、折射和混合，最终从表面射出时，呈现的是两种颜色融合后的新颜色。通过编程让两个LED的颜色和亮度随时间变化，就能在单颗“宝石”上看到色彩的流动与渐变。选择带闪粉的胶棒，还能在光效中加入星星点点的闪光，增加质感。

3. 分步制作详解：从材料到组装

3.1 准备工艺材料与模板

制作始于材料的准备。你需要下载项目提供的矢量模板文件（SVG格式），它包含了三种尺寸（小、中、大）的手环外层和内层泡沫切割图。选择与你自己手腕周长最匹配的尺寸进行打印。

切割EVA泡沫的两种方法：

1. 机器切割（推荐）：如果你有激光切割机或高精度的 vinyl cutter，这是最佳选择。将SVG文件导入机器软件，使用EVA泡沫专用参数进行切割。激光切割边缘光滑精准，效率极高。
2. 手工切割：用剪刀或美工刀沿着打印好的模板轮廓仔细切割。这里有个技巧：先切割内部那些小的矩形开槽，最后再切割外轮廓。因为内部开槽更精细，先处理它们时，泡沫还有较大的外部面积可供手持和固定，操作更稳。切割时不必追求绝对的完美，因为后续注入的热熔胶会填充边缘，微小的瑕疵会被掩盖。

处理记忆钢丝：从记忆钢丝卷上剪下两段，每段的长度应恰好能形成一个完整的圆环。用尖嘴钳将每一段的两端都弯回，形成一个垂直于圆环平面的小钩。这一步至关重要：弯折的钩子可以锚定在泡沫夹层中，防止钢丝圈滑动或旋转；同时，将尖锐的断口弯回去，能彻底避免其在使用中刺穿泡沫，划伤皮肤或损坏内部电路。

3.2 改造电池：制作USB-C搭扣

这是整个电路部分第一个需要焊接的环节，也是安全要求最高的步骤。

安全第一：切割电池导线原装电池带有一个JST插头，我们需要将其剪掉。必须严格遵守的操作是：一次只剪断一根线！先用剪线钳剪断红线（正极），处理好绝缘（可以用一小段热缩管封住）或立即进行下一步焊接，然后再去剪断黑线（负极）。绝对禁止同时剪断两根线，因为剪钳的金属刃口会在瞬间连接正负极，导致电池短路。锂聚合物电池短路会产生大量热量，可能引发鼓包、漏液甚至起火，非常危险。

焊接USB-C Breakout板取一个USB-C公头 breakout板，找到标有VBUS（或VCC，+5V）和GND的焊盘。分别给这两个焊盘和电池导线的线头上锡（预先镀上一层薄薄的焊锡）。同样遵循“焊完一根再处理下一根”的原则，先将电池红线焊接到VBUS焊盘，检查无误后，再将黑线焊接到GND焊盘。

焊接完成后，立即用热熔胶覆盖焊点。这不仅能固定导线，防止拉扯导致脱焊，更重要的是提供了可靠的绝缘，防止焊点与后续包裹的电池或金属部件接触短路。接着，套上一段直径合适的热缩管，用热风枪或打火机（小心操作）加热收缩，给连接处提供第二层保护和应力缓冲。

固定与绝缘最后，用电工胶带将USB-C breakout板牢固地捆绑在锂电池的侧面。确保USB-C插头的金属部分朝向外部，且其长度方向与电池边缘对齐，以便后续能顺利插入QT Py的USB母座。胶带要缠绕紧密，确保连接器不会晃动。

3.3 焊接与连接电子部分

裁剪与准备LED灯带从整卷NeoPixel侧发光灯带上剪下两段，每段包含7颗LED。关键技巧在于下剪的位置：一定要在两组焊盘的正中间剪下。这样，剪断后的每一段灯带，其两端都会保留完整的“输入”和“输出”焊盘（通常标有DI/DO，VCC，GND）。如果你剪在了没有焊盘的位置，这一段灯带就无法接线了。

布局与连线规划参考项目的连线图，核心逻辑是“串联供电，信号级联”。电源布线（VCC和GND）采用“星型”或“总线”连接：从QT Py的3V和GND引脚引出线，同时并联接到两段灯带的VCC和GND上。信号线则是“串联”：QT Py的MOSI引脚（在CircuitPython中用作NeoPixel信号输出）连接到第一段灯带的DI（数据输入）；然后从第一段灯带的DO（数据输出）引出一根线，连接到第二段灯带的DI。这样，QT Py发送一串数据，就能按顺序控制总共14颗LED。

在焊接前，最好将所有元件（QT Py，两段灯带）在切割好的上层泡沫上摆好位置，模拟最终的安装状态。然后用尺子估算各连接点之间所需的导线长度，并预留一点余量（约1-2厘米）用于弯曲和应力释放。使用26AWG的硅胶线最佳，它极其柔软，耐弯折，非常适合可穿戴设备。

焊接与测试按照规划的长度剪线、剥线、上锡，然后逐一焊接。我的顺序建议是：

1. 先焊接QT Py与第一段灯带之间的VCC、GND和信号线。
2. 焊接两段灯带之间的信号线（DO -> DI）。
3. 最后焊接第二段灯带到QT Py的VCC和GND（完成电源回路）。

每完成一组焊接（如三个焊点），就用热熔胶覆盖加固，并套上热缩管收缩保护。这种“焊一点，保护一点”的方法，能有效避免在后续复杂操作中焊点因意外拉扯而断开。

全部连接完成后，务必先进行通电测试！将改造好的电池USB-C头插入QT Py，此时QT Py和灯带应该会亮起。然后通过USB数据线将QT Py连接到电脑，它会以一个名为CIRCUITPY的U盘形式出现。你可以先复制一个简单的NeoPixel测试程序（例如让所有灯珠依次显示红、绿、蓝色）到根目录下的code.py文件中。如果所有14颗LED都能正确响应，说明焊接成功。如果部分不亮，检查对应的焊点、导线，以及信号线的连接顺序是否正确。

3.4 组装手环主体

这是将分散的部件整合成一个坚固整体的过程，需要耐心和细致。

1. 固定电子部分：撕掉上层EVA泡沫背胶的大部分保护纸，仅保留末端长条翻盖部分的纸。将焊接好的电子组件，LED朝下，对准泡沫上的开槽轻轻放下。确保QT Py卡入端部的缺口，其USB-C母座边缘与泡沫边缘对齐。然后从QT Py开始，用手仔细地将每一颗LED灯珠按压进对应的矩形开槽中，同时顺势将泡沫和灯带一起弯成一个弧形。灯珠应位于开槽短边的中央，灯带主体则隐藏在泡沫背面。
2. 放入记忆钢丝：将两段处理好的记忆钢丝圈放入弯好的泡沫弧形内侧，平行放置。确保它们位于泡沫边缘和LED灯带之间，且不会触碰到任何电子元件。记忆钢丝一端的弯钩应靠近QT Py所在的一端。
3. 放入电池：将用胶带包好的电池放入手环，使其USB-C接头刚好嵌在泡沫末端两个长条翻盖形成的“U”型缺口里。
4. 闭合泡沫夹层：这是最关键的一步。撕掉下层矩形泡沫背胶的一角，从QT Py端开始，将其与上层泡沫的背胶对齐贴合。一边撕保护纸，一边像贴手机膜一样，仔细地将两层泡沫按压粘合。过程中要不断对齐边缘，并确保记忆钢丝被牢牢夹在中间。粘合到电池部分时，可能需要用剪刀小心地修剪下层泡沫，使其刚好包住电池边缘，切记不要剪到电池本身。
5. 处理翻盖：最后，将上层泡沫末端的长条翻盖背面的纸撕掉，绕过电池两侧，折向手环内侧并粘牢。这两个翻盖就像“安全带”，将电池进一步固定在手环结构中。

组装完成后，可以试戴一下，练习用单手将电池的USB-C头插入QT Py的插座来完成佩戴。你会听到轻微的“咔哒”声，同时LED灯亮起，表示电路接通。

3.5 注入灵魂：制作热熔胶“宝石”

这是最具艺术性也最需要手感的一步。热熔胶的填充质量直接决定最终的光效是否均匀、漂亮。

填充技巧详解：

1. 预热与准备：使用透明或半透明的白色热熔胶棒。胶枪充分预热。一次只处理一个“宝石”槽。
2. 起胶与引导：将胶枪嘴靠近矩形槽的一端，对准该端的LED。开始挤胶，让融化的胶体流向LED方向。然后缓慢向后移动胶枪，让胶水填充槽的底部。
3. 转向与填充：当胶体填充到槽的中部时，将手环旋转180度，将胶枪嘴移到槽的另一端，对准另一侧的LED。再次挤胶，让新挤出的胶流向中部，与之前的胶汇合。
4. 封顶与塑形：当槽被填充到约90%满时，轻轻抬起胶枪，以非常小的出胶量，在已挤出的胶体表面快速、轻柔地扫过一层薄薄的胶。这层“封面胶”会利用自身热量融化下层胶的表面，形成一个光滑、平整的弧面，看起来更像一颗打磨过的宝石。
5. 冷却定型：填充完一个后，立即将手环水平静置，等待这个“宝石”完全冷却固化（约1-2分钟），再进行下一个。如果胶体未冷却时就移动手环，液态胶会因重力流动，导致表面不平或溢出。

实操心得：热熔胶冷却时会轻微收缩，表面可能形成凹陷。我的经验是，填充量可以稍微溢出槽口一点点，这样在冷却收缩后刚好能形成饱满的弧面。如果不小心溢出，在胶体完全硬化前，可以用牙签的尖端轻轻刮掉。如果不满意某个“宝石”的形状，可以用热风枪（低档）或吹风机热风远距离、均匀地加热它，胶体软化后会重新流动，此时将其水平放置，它会在表面张力作用下再次形成光滑曲面。

3.6 制作专用充电适配器

由于电池的接口已被改造成USB-C公头，无法直接使用常见的JST接口充电器。我们需要自制一个转接头。

找一块USB-C母座的breakout板（如Adafruit USB Type C Breakout Board），我们只需要用到它的VBUS（电源）和GND（地）引脚。将之前从电池上剪下来的那个JST插头的红线焊接到VBUS，黑线焊接到GND。这样，你就得到了一个一头是USB-C母座、另一头是JST插头的转接线。

充电时，将手环的USB-C搭扣插入这个转接头的母座，再将转接头的JST插头插入标准的Micro-Lipo充电器的JST插座，最后给充电器接通5V USB电源即可。这个自制的转接头解决了专用接口的充电问题，是一个非常实用的配件。

4. 编程实现动态渐变光效

硬件组装完成，接下来就是赋予它灵魂的编程部分。我们将使用CircuitPython来编写控制代码。

4.1 环境准备与库文件

首先确保你的QT Py板子已经刷入了CircuitPython固件（新购买的Adafruit板子通常已预装）。将板子通过USB线连接电脑，会出现一个名为CIRCUITPY的驱动器。

为了实现NeoPixel控制，你需要将必要的库文件放入该驱动器的lib文件夹内。核心库是neopixel.mpy。由于QT Py的特定硬件支持，通常还需要adafruit_pypixelbuf.mpy和adafruit_bus_device（可能是一个文件夹）。这些库都可以从Adafruit的官方CircuitPython库包中获取。下载后，解压找到对应的文件，复制到CIRCUITPY盘的lib目录下即可。

4.2 代码解析：色彩与亮度的舞蹈

项目提供的示例代码实现了一种优雅的彩虹渐变加亮度交替的效果。我们来逐段解析其原理：

import time import board from rainbowio import colorwheel import neopixel # 定义LED总数（两段灯带，每段7颗） NUM_PIXELS = 14 # 初始化NeoPixel对象，信号引脚为board.MOSI，亮度设为40% pixels = neopixel.NeoPixel(board.MOSI, NUM_PIXELS, pixel_order=neopixel.GRB, auto_write=False, brightness=0.4)

首先进行必要的导入和初始化。colorwheel是一个很实用的函数，它接收一个0-255的整数，返回一个对应的RGB颜色元组，就像在色轮上取色。brightness=0.4是一个经验值，在保证视觉效果的同时，能有效控制功耗，延长电池续航。

def scale(tup, frac): return tuple((x*frac)//255 for x in tup) def sawtooth(x): return int(2*(127.5 - abs((x % 255) - 127.5))) def oppositeHue(x): return ((x + 128) % 256)

这里定义了三个辅助函数：

• scale(tup, frac): 用于按比例缩放RGB元组的亮度。frac是一个0-255的值，代表亮度比例。
• sawtooth(x): 生成一个周期为255的三角波（锯齿波）函数。输入x递增，输出会在0到255之间先上升后下降，形成平滑的周期性变化。这将被用来控制亮度变化。
• oppositeHue(x): 计算色轮上相反的颜色（相差180度）。用于生成对比色。

hueIndex = 0 # 主色调索引 brightnessIndex = 0 # 亮度函数输入值 brightnessSpeed = 3 # 亮度变化速度 while True: # 计算当前亮度值（0-255） bright = sawtooth(brightnessIndex) # 获取主色调颜色，并按当前亮度缩放 mainColor = scale(colorwheel(hueIndex), bright) # 获取互补色调颜色，并按（255-当前亮度）缩放，形成亮度互补 oppColor = scale(colorwheel(oppositeHue(hueIndex)), 255 - bright) # 遍历所有LED（每对为一组） for i in range(NUM_PIXELS//2): pixels[i*2] = mainColor # 每组第一个LED设为mainColor pixels[i*2 + 1] = oppColor # 每组第二个LED设为oppColor # 更新显示 pixels.show() # 递增索引，实现动画 hueIndex = (hueIndex + 1) % 255 # 色调缓慢循环 brightnessIndex = (brightnessIndex + brightnessSpeed) % 255 # 亮度以更快速度变化

核心逻辑解析：

1. 颜色对：程序将14颗LED视为7对。每对中的两颗LED被赋予在色轮上相对（互补）的两种颜色。
2. 亮度交替：通过sawtooth函数生成一个周期性变化的亮度值bright。在同一时刻，一对LED中的一颗亮度为bright，另一颗亮度则为255 - bright。这意味着当一颗灯变亮时，另一颗就在变暗，形成“此消彼长”的呼吸交替效果。
3. 色彩流动：hueIndex每循环一次增加1，使得主色调mainColor在色轮上缓慢移动。由于oppColor是它的互补色，所以整个色系也在同步移动。
4. 视觉效果：在每一颗“宝石”内，两个LED发出的互补色光，随着亮度交替变化，在热熔胶中混合。你看到的不是两颗灯在闪烁，而是整颗“宝石”的颜色在两种互补色之间平滑渐变、流动。同时，由于所有“宝石”的色调是同步变化的，整个手环会呈现出一道流动的彩虹光谱。

你可以通过调整brightnessSpeed变量来改变亮度交替的快慢，数值越大，呼吸闪烁的速度越快。也可以修改brightness初始值来改变整体亮度，但要注意电池续航。

5. 调试心得与进阶玩法

5.1 常见问题与排查

在制作和调试过程中，你可能会遇到以下问题：

5.2 进阶创意与扩展

这个项目是一个绝佳的起点，你可以在此基础上进行无限扩展：

1. 传感器交互：QT Py板载了STEMMA QT连接器，可以轻松接入各种传感器。例如，加入一个加速度计（如ADXL343），让手环的颜色根据你的手势或运动速度变化；加入一个光线传感器，让亮度随环境光自动调节。
2. 蓝牙控制：使用支持蓝牙的QT Py版本（如QT Py ESP32-S2），你可以编写一个简单的手机App（用Adafruit的Bluefruit LE Connect应用或自己开发），通过手机蓝牙实时改变手环的灯光模式和颜色。
3. 音频可视化：通过麦克风传感器（如SPW2430）采集环境声音，将音频的频谱或音量映射为灯光颜色和亮度，让你的手环随着音乐节奏跳动。
4. 多设备同步：如果你制作了多个这样的手环，可以利用无线模块（如RFM69无线电）让它们之间进行简单的通信，实现灯效的同步或传递，在派对或演出中会非常酷。
5. 改变外观：EVA泡沫和热熔胶只是载体。你可以尝试用硅胶模具浇筑环氧树脂“宝石”，或者使用3D打印一个更精致的外壳。灯带也可以换成其他类型的NeoPixel，比如RGBW灯珠（增加白色）以获得更丰富的色彩表现。

这个项目的魅力在于，它清晰地展示了一个想法如何从概念（动态渐变光效），通过合理的硬件选型（QT Py + 侧发光NeoPixel）、巧妙的结构设计（泡沫夹层+记忆钢丝+USB-C搭扣）和简洁的软件逻辑（互补色+亮度交替），最终变成一个可以握在手中、戴在腕上的实物。每一次调试成功，每一次灯光如预期般亮起，都是对创造者最好的回报。希望这份详细的指南能帮助你顺利制作出属于自己的智能光效手环，并激发你更多的创作灵感。