可穿戴交互式光明节毛衣：用NeoPixel灯带与Gemma M0实现触摸点亮

1. 项目概述：当传统节日遇上可穿戴科技

每年年底，节日氛围总是被红绿相间的圣诞元素所包围。作为一名喜欢动手制作的电子爱好者，我总想为不同的文化节日增添一些独特的科技光彩。这次，我决定将目光投向光明节（Hanukkah），这个也被称为“光明节”的节日，其核心仪式便是连续八天每晚点燃一支烛台上的蜡烛。传统的烛台（Menorah）是静态的，但如果我们能让它“穿”在身上，并且通过触摸来交互式地点亮呢？这个想法催生了这个项目：一件可以穿戴的、可编程的交互式光明节毛衣。

这个项目的核心，是将可编程的LED灯带（NeoPixel）和一块微型微控制器（Adafruit Gemma M0）巧妙地整合到一件普通的毛衣上。最终的效果是，当你触摸毛衣上代表中心烛（Shamash）的特定位置时，旁边的八支“蜡烛”会像真实的仪式一样，一支接一支地顺序点亮。它不仅仅是一件有灯的毛衣，更是一个融合了嵌入式系统、图形化编程和织物电子的完整项目。整个过程无需焊接或缝纫，非常适合作为亲子手工或编程入门项目，在创造节日氛围的同时，也能学到实实在在的硬件和编程知识。

2. 核心组件选型与原理解析

在开始动手之前，理解我们使用的核心组件及其工作原理至关重要。这不仅能帮你更好地完成项目，还能在遇到问题时快速定位。

2.1 大脑：Adafruit Gemma M0微控制器

我们选择Adafruit Gemma M0作为项目的大脑。这是一款专为可穿戴项目设计的超小型微控制器板，直径大约只有一枚大硬币大小。它的核心是一颗ATSAMD21微处理器，性能足以驱动LED灯带和处理触摸输入。

注意：市面上有旧版的Gemma（基于ATtiny85）和M0版。务必选择Gemma M0，因为它原生支持Microsoft MakeCode图形化编程环境，并且其ATSAMD21芯片自带硬件电容触摸感应功能，这是我们实现触摸交互的关键。旧版Gemma无法在MakeCode中轻松实现可靠的触摸检测。

为什么是Gemma M0？

1. 尺寸与形态：圆形设计且无尖锐边角，非常适合嵌入衣物，不会造成不适或钩挂。
2. 供电灵活：它可以通过USB口或一个3.7V锂电池供电。对于可穿戴设备，锂电池是必须的。
3. 编程友好：除了支持MakeCode，它还兼容Arduino IDE和CircuitPython，为后续进阶提供了可能。
4. 内置电容触摸：板载的D0引脚被设计为电容触摸感应垫，我们正是利用这个特性来检测手指触摸，无需额外触摸传感器。

2.2 光芒：WS2812B NeoPixel可寻址LED灯带

NeoPixel是Adafruit对WS2812B可寻址LED的商标名称。这种LED的神奇之处在于，每个LED内部都集成了一个微型控制芯片。你只需要用微控制器的一根数据线，就能控制成百上千个LED，并让每个LED独立显示任何颜色。

工作原理简述： 微控制器通过单根数据线，发送一系列严格按照时间要求的数字信号（0和1）。第一个LED读取并执行属于自己的颜色数据，然后将后续的数据信号原样转发给下一个LED，如此接力下去。这就好比一列火车，车头（微控制器）发出指令包，每节车厢（LED）拿走属于自己的那个包，然后把剩下的包传递给下一节。

在本项目中的应用： 我们只需要9个LED：1个作为中心烛（Shamash），8个代表八天的蜡烛。我们购买一条软性线缆封装的NeoPixel灯带（如Adafruit产品#4560），然后从中剪下9个灯珠使用。这种灯带非常柔软，适合缝制或粘贴在织物上。

实操心得：购买灯带时，注意区分“可寻址RGB”（如WS2812）和“非可寻址RGB”。非可寻址灯带整条只能显示一种颜色，无法实现我们需要的逐个点亮效果。WS2812灯带的数据线输入（DI）和输出（DO）端通常有箭头标识，或者仔细观察LED上的微小芯片，其一角会有一个缺口或圆点，指向数据流方向（从IN流向OUT）。连接时务必确保数据方向正确。

2.3 桥梁：MakeCode图形化编程环境

对于初学者或不熟悉传统文本编程的人来说，Microsoft MakeCode是一个福音。它将复杂的代码逻辑转化为色彩鲜艳、可拖拽的积木块，让你通过拼接就能完成编程。

MakeCode的优势：

• 直观可视化：变量、循环、条件判断都变成看得见的积木。
• 即时模拟：编写代码时，网页上的虚拟硬件模拟器会实时运行你的程序，无需反复烧录到硬件即可调试。
• 低门槛：彻底消除了语法错误的风险，让创作者可以专注于逻辑本身。

在这个项目中，我们将用MakeCode为Gemma M0编写程序，逻辑是：上电后，中心烛LED亮起红色；每次触摸D0引脚，变量“天数”加1，并点亮对应序号的LED为金色；通过逻辑判断跳过中心烛的序号，实现八支蜡烛的顺序点亮。

3. 硬件连接与组装详解

正确的硬件连接是项目成功的基础。这一步需要细心，但按照步骤来并不复杂。

3.1 材料与工具清单

除了核心的Gemma M0和NeoPixel灯带，你还需要：

• 电源：一块3.7V、500mAh的锂电池。容量无需太大，足够点亮LED数小时即可，体积小更重要。
• 连接器：一个“螺栓固定套件”（Bolt-On Kit）。它包含螺丝和螺母，可以将Gemma M0直接固定在织物上，同时螺丝本身可作为触摸电极。
• 织物部分：一件针织较密的毛衣（最好是蓝色）、热转印乙烯基（HTV）、可熔性衬布、背胶魔术贴圆点、织物胶。
• 工具：裁切机（如Cricut）或美工刀、电熨斗、螺丝刀、锥子。

3.2 电路连接步骤

1. 识别灯带方向：找到你的NeoPixel灯带的“IN”端。如前所述，查看LED上的微小标记或箭头。用放大镜看，通常会有一个带尖角的小点，尖角指向即为数据流向（从IN到OUT）。
2. 裁剪灯带：保留“IN”端，从“OUT”端剪下带有连接器的部分。然后，从“IN”端开始数，在第9个和第10个LED之间剪断，这样我们就得到了一个9灯珠的独立灯带段。
3. 连接Gemma M0：
   • 将剪下的连接器的三根线连接到Gemma M0。
   • 红色线（+5V）→ 连接到Gemma的VOUT引脚。
   • 中间线（数据）→ 连接到Gemma的D1引脚。（这是编程中指定的数据引脚）
   • 剩余线（地线）→ 连接到Gemma的GND引脚。
   • 连接方式可以是焊接（更牢固），也可以使用螺栓套件中的接线端子压接（无需焊接）。
4. 初步测试：将灯带的“IN”端插头连接到刚才焊好的连接器上，接上电池。此时，Gemma M0上的电源LED应亮起，并且NeoPixel灯带的第1和第4个灯珠可能会亮起（这是Gemma的默认测试模式）。用手指触摸Gemma板上标有“D0”的金属焊盘，其他灯珠应该会依次亮起。这个测试能快速验证硬件连接和主板基本功能是否正常。

注意事项：在进行焊接或任何操作前，务必断开电池供电。连接电源时，务必确认正负极（红正黑负）正确，反接会瞬间损坏Gemma或LED灯带。如果使用焊接，动作要快，避免过热烫坏NeoPixel灯珠。

4. 使用MakeCode进行图形化编程

编程是项目的灵魂。我们将使用MakeCode构建一个直观的交互逻辑。

4.1 创建项目与基础设置

1. 访问maker.makecode.com，点击“新建项目”。
2. 在硬件选择界面，搜索并选择“Adafruit Gemma M0”。
3. 项目创建后，你会看到一个当开机时的积木块。所有初始化设置都放在这里。
   • 设置灯带：在“灯光”类别下，点击“更多”，找到将 strip 设为 引脚 P0 连接灯带 型号 WS2812 像素数量 30积木。将其拖入当开机时。
     • 将引脚P0改为D1（与我们硬件连接对应）。
     • 将像素数量30改为9（我们只有9个LED）。
   • 设置亮度：从“灯光”->“更多”中，拖拽strip 设置亮度 255积木放入。亮度值范围0-255，255最亮。
   • 关闭板载LED：Gemma M0正面有一个RGB LED。为了省电和美观，我们关闭它。在“灯光”类别下，拖拽设置像素颜色 为 红积木，将其颜色改为黑。
   • 初始化变量：点击“变量”，创建一个名为day的变量。拖拽将 day 设为 0积木到初始化区域。这个变量将记录当前要点亮第几支蜡烛（从0开始计数）。

4.2 实现核心交互逻辑

1. 点亮中心烛（Shamash）：在当开机时块内，从“灯光”->“更多”中拖入strip 设置像素 0 颜色为 红。将像素编号0改为4。因为我们的9个LED索引是0-8，我们指定第5个（索引4）为中心烛，并设为红色。
2. 主循环与触摸触发：
   • 我们需要一个持续运行的检查机制。但在这个简单逻辑中，我们可以将主要动作放在触摸事件中。
   • 从“输入”类别中，拖出当 引脚 D0 被触摸积木。这定义了一个触摸事件处理函数。
   • 在这个触摸事件块内，首先，我们让代表蜡烛的LED亮起：拖入strip 设置像素 0 颜色为 红，将0替换为变量day，颜色改为金色（如橙）。
   • 然后，增加天数：拖入以 1 更改 day。
3. 解决中心烛被覆盖的问题：上述代码有一个BUG：当day增加到4时，它会将中心烛（像素4）的颜色从红色覆盖为金色。我们需要在每次触摸后，强制将像素4设回红色。在触摸事件块内，在更改day之后，添加strip 设置像素 4 颜色为 红。
4. 添加逻辑跳过中心烛：为了让体验更流畅，我们可以让程序在计数时自动跳过中心烛的索引4。
   • 在触摸事件块内，在“更改day”之前，加入一个逻辑判断。从“逻辑”类别拖入如果 true 则块。
   • 点击true旁边的齿轮图标，选择=比较块。
   • 将比较块左侧拖入变量day，中间选择=，右侧填入3（注意：是在点亮第4支蜡烛，即索引3之后，下一次要跳过的就是索引4）。
   • 在如果 day = 3 则的内部，放入以 1 更改 day。这样，当day等于3时，执行完点亮像素3后，会再增加1，使day变成4，紧接着外层的以 1 更改 day会再执行一次，最终day变成5，从而跳过了对像素4的赋值。
5. 添加重置功能：当点亮全部8支蜡烛（day增加到8）后，我们希望程序能重置，以便重新开始。
   • 在触摸事件块的最后，添加另一个如果 true 则块。
   • 条件设置为day = 8（因为点亮第8支蜡烛后，day是7，再触摸一次，day变为8）。
   • 在这个条件块内，添加将 day 设为 0和strip 清除显示积木。这样，当第8支蜡烛点亮后再次触摸，所有LED熄灭，并从第一支蜡烛重新开始。

4.3 模拟测试与程序烧录

MakeCode编辑器左侧有一个虚拟的Gemma M0和一条9像素的灯带模拟器。编写代码时，你可以随时点击虚拟板上的D0触摸垫来测试程序逻辑，观察虚拟灯带的点亮顺序是否符合预期。这是极其高效的调试方式。

测试无误后，点击编辑器底部的“下载”按钮，会得到一个.uf2文件。

1. 用USB数据线连接Gemma M0和电脑。
2. 快速按一下Gemma板正面的“Reset”按钮。板载LED将闪烁绿色，电脑上会出现一个名为GEMMABOOT的U盘。
3. 将下载的.uf2文件拖入GEMMABOOT盘符。盘符会自动弹出，程序即烧录完成。

5. 织物整合与穿戴组装

将电子部分优雅且牢固地整合到毛衣上，是这个项目从“原型”变成“可穿戴设备”的关键。

5.1 制作烛台图案并转印

1. 设计定位：首先确定烛台图案在毛衣上的位置。最好穿上毛衣，用大头针粗略标记出图案顶点和中心烛的位置，确保图案平整且位置美观，并为上方的LED“火焰”留出空间。
2. 加固织物：毛衣具有弹性，而热转印乙烯基（HTV）没有。直接熨烫HTV，毛衣拉伸时图案会开裂。解决方法是在毛衣内侧对应图案区域熨烫一块可熔性衬布。衬布能有效消除该区域的弹性，为HTV提供一个稳定的基底。衬布尺寸应比图案大一圈。
3. 切割与转印图案：
   • 使用SVG文件在裁切机（如Cricut）上切割HTV。关键：HTV需哑光面朝下放置在切割垫上，机器只切割背面的离型纸和胶层，保留正面的透明保护膜。
   • 如果没有裁切机，可以打印PDF图案作为模板，用美工刀小心裁切。手工裁切可能需切透所有层，熨烫时需在图案上另盖一张烘焙纸防止粘连。
   • 将切割好的HTV图案（连同保护膜）放置在毛衣正面预定位置，用熨斗高温加压熨烫（遵循HTV产品说明）。冷却后，小心揭去表面的透明保护膜。

5.2 安装LED灯带与控制器

1. 标记位置：在已熨烫衬布的毛衣内侧，根据外侧烛台图案，用可擦记号笔精确标出9个LED灯珠的位置（8支蜡烛+1支中心烛）。
2. 固定灯带：使用织物胶（如Aleene‘s Fabric Fusion）将NeoPixel灯带粘贴在标记的位置上。从最左边的灯珠开始，在灯珠背面点一小滴胶，按压固定在衬布上。将连接线也顺直地用胶或线钉稍作固定。确保灯珠朝向一致（数据流向从IN到OUT）。
3. 绝缘与保护：等待胶水完全干透后，为了保护和绝缘背面的电线，可以再剪一块稍大的衬布，覆盖在整个电路区域（避开LED灯珠发光面），用熨斗低温熨烫固定。注意：熨烫前务必断开电池！低温快速熨烫，避免高温长时间接触损坏LED。
4. 安装Gemma M0：在中心烛（Shamash）灯珠对应的内侧位置，用锥子小心地在衬布和毛衣上戳一个小孔。将Gemma M0的D0触摸焊盘朝向毛衣内侧，用螺栓套件中的螺丝穿过小孔，从毛衣正面（中心烛下方）拧上螺母固定。这个螺丝有两个作用：一是固定控制器，二是其金属头部将作为我们触摸的电容电极，通过毛衣纤维感知手指的触摸。
5. 电源管理：用橡皮筋将锂电池捆好，同时将连接灯的线缆也轻轻束在一起，这能提供应力释放，防止线缆在弯折处断裂。在电池背面和毛衣内侧合适位置贴上背胶魔术贴，方便电池的安装与拆卸。

6. 调试、优化与问题排查实录

即使按照步骤操作，也可能会遇到一些小问题。这里记录了我实践中遇到的情况和解决方法。

6.1 常见问题速查表

6.2 项目优化与扩展思路

基础功能实现后，你可以尝试以下优化，让毛衣更具个性：

1. 动画效果：目前是瞬间点亮。你可以在MakeCode的“循环”类别中使用渐变亮度或自定义动画序列积木，让蜡烛像真实火焰一样缓缓亮起或微微闪烁。
2. 多色模式：修改程序，让八支蜡烛每天点亮不同的颜色，或者让中心烛在触摸时变色。
3. 声音反馈：如果希望更有仪式感，可以添加一个微型蜂鸣器到Gemma M0的另一个引脚，在每次触摸时播放一个简短的音调。
4. 无线控制：进阶玩法是换用支持蓝牙的微控制器（如Adafruit Circuit Playground Bluefruit），通过手机App远程控制灯光模式或颜色。
5. 更牢固的整合：对于需要经常穿着的版本，可以考虑用导电缝纫线将LED灯带和控制器电路缝制在织物上，并用硅胶或热熔胶进行防水绝缘处理，提升耐用性。

完成后的毛衣，在夜晚点亮时效果非常迷人。它不仅是一件有趣的节日服饰，更是一个展示了硬件、编程与手工艺术如何结合的完整作品。最重要的是，整个制作过程充满了学习和创造的乐趣。当你触摸毛衣，看着“蜡烛”一支支亮起时，那种亲手实现创意的满足感，是任何现成商品都无法替代的。