1. 项目概述与核心思路如果你玩过火流星或者接触过LED表演道具肯定对那种在空中划出绚丽光轨的效果着迷。那种效果背后就是视觉暂留Persistence of Vision POV技术。简单来说当一系列光源高速移动时由于人眼的视觉残留特性离散的光点会被大脑“脑补”成连续的图像或图案。Supernova Poi这个项目就是把这项技术塞进一对你可以拿在手里挥舞的球里让它变成你个人灯光秀的核心。我选择Teensy 3.2和Dotstar LED来打造这对Poi是经过一番考量的。普通的Arduino Uno在处理大量LED数据和复杂图像时内存和速度常常捉襟见肘。Teensy 3.2拥有256KB的Flash和64KB的RAM性能堪比一些低端ARM芯片足以存储数百张图像并流畅驱动高速LED。而Dotstar LEDAPA102相比更常见的WS2812BNeoPixel最大的优势是拥有独立的时钟线。这意味着它不依赖于精确的时序信号刷新速率极高且稳定特别适合POV这种对刷新率和同步要求苛刻的应用能有效避免在高速运动时出现画面撕裂或闪烁。整个项目的目标很明确制作一对能够显示自定义图像、通过红外遥控切换模式、续航持久且坚固耐用的可编程流光球。它不仅仅是一个焊接练习更是一个融合了嵌入式编程、电源管理、机械结构和艺术设计的综合性创客项目。无论你是想为你的火舞表演增添科技感还是想制作一个炫酷的互动装置这个指南都能带你走完全程。2. 核心硬件选型与物料清单解析动手之前把家当备齐是关键。原教程的清单是基础但根据我的实际制作经验有些细节和替代方案值得深入聊聊。这里列出的物料是制作一个Poi所需的要做一对记得数量乘二。2.1 主控与灯带性能基石Teensy 3.2这是大脑。为什么是3.2而不是4.0对于这个项目3.2的性能已经绰绰有余且其引脚布局和3.3V逻辑电平与周边模块如红外接收头的兼容性非常成熟。购买时务必确认附带排针方便焊接。Dotstar LED灯带 (144灯/米 0.5米)这是画笔。144灯/米的密度在12英寸约30厘米长的灯带上能提供约36颗LED这是形成清晰图像的理想高度。我强烈建议购买带防水硅胶套的版本它不仅能在组装时提供物理保护后期套在亚克力管里也能起到柔光作用让光线更均匀。剪裁时一定要数清楚36颗LED并在第36和第37颗之间的切割线上动手保留第37颗LED正极的焊盘以备焊接。2.2 电源与充电管理能量心脏3.7V 2200mAh 圆柱形锂离子电池容量是关键。2200mAh对于驱动72颗高亮LED和Teensy来说能保证数小时的续航。务必选择带保护板的电池防止过充过放。品牌方面像Panasonic、Sanyo的18650电芯是可靠的选择。Pro Trinket LiPo/LiPoly Backpack充电模块这是充电管家。它集成了充电管理TP4056芯片和升压输出5V。教程中要求“桥接”背面的两个焊盘这实际上是短接BAT和5V的测试点能绕过升压电路直接用电池电压约3.7V-4.2V给系统供电。这么做有两个好处一是减少升压电路带来的能量损耗提升续航二是Dotstar LED在3.5V以上就能工作电压完全足够。注意这要求你的整个系统Teensy、LED都能在3.7V下稳定运行而Teensy 3.2的VIN引脚支持3.6V-6V输入Dotstar的工作电压范围是3.3V-5V因此完全可行。SPST微型滑动开关控制总电源。选择质量好的开关因为频繁的开关和振动是常态。2.3 结构件与外壳物理骨架14英寸 x 1英寸聚碳酸酯管内径至少7/8英寸这是主体外壳。聚碳酸酯PC比丙烯酸亚克力更耐冲击不易摔裂。内径务必测量准确要能宽松地容纳电池直径通常18mm和所有组件。3D打印端盖教程提供了STL文件。打印时建议使用PETG材料。相比PLAPETG韧性更好更耐冲击和轻微形变相比ABS它打印时气味小不易翘边。层高可以设为0.2mm填充率25%-30%即可保证强度。8英寸 x 5/8英寸木棍内部支撑结构。它的作用是将电池在一端和Teensy主板在另一端连接起来并作为灯带的粘贴基板。确保木棍直径略小于管子内径方便滑动。Poi系绳与手柄关乎安全和使用体验。不要用普通绳子一定要用专业的火舞Poi绳它们通常由耐高温、抗磨损的凯夫拉或棉质内芯外加彩色套筒制成连接处有金属扣环。手柄要选择握感舒适、带安全腕带的款式。2.4 辅助材料与工具导线强烈推荐使用硅胶线特别是30AWG用于数据、时钟线和26AWG用于电源线。它极度柔软耐弯折在狭小空间内布线时优势巨大。颜色务必区分红VCC、黑GND、绿Data、黄Clock、白开关线。全息背胶乙烯基贴纸这不是单纯的装饰。它的反射特性可以将LED光线在管内多次反射形成均匀的“光柱”效果避免看到一颗颗离散的灯珠让显示的画面更柔和、专业。工具除了常规电烙铁、焊锡丝、热熔胶枪、万用表外助焊膏和吸锡带在处理密集焊点时非常有用。一把精密剪线钳和剥线钳也能极大提升效率和工艺。注意在焊接电池导线时绝对不要同时剪断电池的正负极线。即使电池有保护板剪钳的金属刀口同时接触正负极也可能瞬间短路产生大量热量甚至引发危险。务必分开操作剪断一根处理好绝缘或焊接再处理另一根。3. 软件环境搭建与代码解析硬件是身体软件是灵魂。先把编程环境搭好并理解代码是如何工作的这样在后续焊接和调试时才能心中有数。3.1 开发环境配置安装Arduino IDE前往Arduino官网下载最新版1.8.x或以上均可。安装后打开首选项在“附加开发板管理器网址”中添加https://www.pjrc.com/teensy/td_155/Teensyduino.txt。安装Teensyduino运行Teensyduino安装程序。它会自动检测你的Arduino IDE路径。在组件选择页面确保勾选了Teensy 3.2对应的选项。安装完成后在IDE的“工具”-“开发板”菜单中选择“Teensy 3.2”并将“CPU速度”设置为“72 MHz optimized”。安装必要的库Adafruit DotStar Library最简单的方法是通过IDE的“库管理器”工具-管理库搜索“DotStar”并安装。IRremote库PJRC修改版这是关键一步。Teensy 3.x需要使用PJRC专门修改的版本。不要从Arduino库管理器安装通用版。你需要从PJRC的网站下载IRremote.zip然后在Arduino IDE中通过“项目”-“加载库”-“添加.ZIP库”来手动安装。3.2 项目代码结构与工作原理从GitHub下载的Kinetic_POV代码包中我们主要关注supernova_poi文件夹。用Arduino IDE打开supernova_poi.ino你会看到另一个标签页graphics.h。主程序 (supernova_poi.ino)这是控制逻辑的核心。它主要做以下几件事初始化设置Dotstar LED的引脚Data11 Clock13、LED数量每边36共72、亮度以及红外接收引脚5。主循环不断检查红外接收器是否有信号。一旦接收到特定按键码就切换到对应的图像或动画模式。图像渲染根据当前模式从graphics.h中读取对应的调色板(palette)和像素数据(pixels)然后通过Dotstar库的setPixelColor()和show()函数将数据刷写到LED灯带上。为了实现POV效果代码会根据一个内部计时器或外部传感器本项目未使用来循环显示图像的一列列像素。图像数据文件 (graphics.h)这里存储了所有要显示的图像。图像并非存储为常见的JPG或PNG而是被转换成了两种更高效的数据结构调色板 (Palette)一个颜色查找表。例如一个4色调色板就是一个包含4个RGB值的数组。这样做可以极大压缩数据量因为每个像素不再存储24位的RGB值而是存储一个指向调色板的索引0-3仅需2位。像素索引数组 (Pixels)一个二维数组每个元素的值对应调色板中的某个颜色索引。代码在运行时根据当前要显示的列从这个数组中取出对应的一行索引再通过调色板转换为实际颜色输出到LED。3.3 代码烧录与初步测试在焊接任何东西之前先给Teensy烧录一个最简单的测试程序如Blink确保你的开发环境和USB数据线是好的。然后可以尝试编译并上传supernova_poi的代码。虽然此时没有连接LED但编译成功意味着库和基础设置没问题。记得上传时需要手动按下Teensy板上的白色小按钮进入编程模式。4. 电路焊接与系统集成详解这是最需要耐心和细心的部分。清晰的规划和正确的焊接顺序能避免很多麻烦。4.1 核心模块预处理切割并预处理LED灯带用美工刀小心剥去两端约2厘米的硅胶套露出焊盘。用吸锡带和烙铁清理掉原厂焊点上的残锡。数两遍在第36颗LED后切割。用万用表通断档确认切割后两段灯带的“DI”数据输入和“CI”时钟输入端是连通的。修改充电模块找到LiPoly Backpack背面标注“J1”或两个靠得很近的银白色焊盘用焊锡将它们桥接起来。这个操作是为了给本项目提供直通供电如前所述。修剪红外接收头引脚将其三个引脚剪短至约1厘米并预先焊上三根长约15厘米的硅胶线建议颜色VCC-红 GND-黑 Data-蓝。套上热缩管再焊接焊好后加热收缩。4.2 分层焊接策略我建议采用“从核心向外辐射”的焊接策略先完成Teensy这个核心枢纽的所有连接再向外连接其他模块。第一步焊接Teensy上的“输出”线。这包括两路LED灯带的电源3.3V、地GND、数据Pin 11和时钟Pin 13。因为有两路灯带所以每个引脚需要焊出两根线共8根。焊接时将线头穿过Teensy的过孔再焊接机械强度远高于直接搭焊。第二步焊接充电模块到Teensy的连接线。这是系统的“输入”。需要三根线充电模块的BAT焊接到 Teensy 的VIN或标为BAT的引脚。充电模块的G焊接到 Teensy 的GND。充电模块的5V焊接到 Teensy 背面一个标有USB的测试点注意不是VUSB引脚。这路5V是给Teensy的USB电路供电确保即使在使用电池时连接到电脑也能被识别。第三步焊接红外接收头。将其黑线GND焊到Teensy上剩余的某个GND孔红线VCC焊到3.3V蓝线Data焊到数字引脚5。4.3 电池与开关组装将两根白色导线焊接到滑动开关的两个引脚上。极其小心地先剪断电池红色正极线将准备好的红色电源线与之焊接套好热缩管并加热。完全处理好这一根线后再同样处理黑色负极线。用少量热熔胶将开关固定在电池的负极平坦一端注意开关滑杆的方向确保安装到外壳后便于操作。将电池、开关以及引出的红黑电源线用全息贴纸紧密地包裹成一个圆柱体确保导线平整地贴在两侧不交叉凸起。在电池正极一端有凸起触点涂上热熔胶将木棍牢固粘上。然后将木棍部分也包裹上贴纸。4.4 总装与连接将两段LED灯带“IN”端朝向Teensy用少量热熔胶或双面胶平行地粘在木棍的另外两侧与电池/开关形成十字布局。务必保证两段灯带的起始像素第37颗严格对齐这是画面同步的关键。将Teensy模块连同已焊好的充电模块和红外接收头用热熔胶固定在木棍的顶端。红外接收头的接收窗应朝向管壁方向。最后进行连接将来自Teensy的8根LED控制线分别焊接到两段灯带的对应焊盘上VCC GND DI CI。这里有一个重要技巧如果灯带正面的焊盘不好焊可以尝试焊接到背面的对应测试点上通常更容易操作。将电池开关引出的两根白线焊接到充电模块上标有“SW”的两个焊盘。最终也是最关键的一步将电池引出的红正、黑负线焊接到充电模块上标有“B”和“B-”的焊盘。焊接时先焊接地线黑负再焊接电源线红正。如果焊接时看到充电模块或Teensy上的LED亮了迅速拨动一下开关即可关闭。5. 系统测试、外壳组装与问题排查在把所有东西塞进管子之前必须进行全面的通电测试。5.1 上电测试流程打开电源开关。此时Dotstar LED灯带应该会亮起并显示默认的图案或动画。拿起红外遥控器对准红外接收头的方向大约在管子中上部位置按下左右方向键或其他预设按键。LED显示的图案应该随之切换。轻轻挥动整个组件观察LED形成的图像是否连续、清晰。如果图像模糊或断裂很可能是两排LED没有严格对齐或者焊接有虚焊导致数据传输不稳定。5.2 常见故障排查速查表现象可能原因排查步骤LED完全不亮1. 电池没电或开关损坏。2. 主电源回路断路电池-开关-充电模块-Teensy VIN。3. Teensy未正常工作。1. 用USB线连接Teensy看充电模块和Teensy上的指示灯是否亮起。2. 用万用表电压档从电池正极开始沿电路路径逐点测量电压找到断点。3. 重新给Teensy烧录Blink程序确认其本身是否完好。LED亮但无图案/全白/乱码1. 数据线D11或时钟线D13接反、接错或虚焊。2. Dotstar库初始化参数LED数量、引脚错误。3. 代码未成功上传。1. 检查Teensy到LED的Data和Clock线是否与灯带上的DI、CI一一对应且焊接牢固。2. 打开Adafruit DotStar库中的strandtest示例修改引脚和灯珠数量后上传测试硬件连接。3. 确认Arduino IDE中已选择正确的开发板和端口。红外遥控失灵1. 红外接收头VCC/GND接反或接错。2. 数据线未接到D5或代码中引脚定义错误。3. 遥控器电池没电或接收头被遮挡。1. 确认接收头三根线VCC GND Data连接正确。2. 检查代码中IR_RECEIVE_PIN的定义是否为5。3. 用手机摄像头对准遥控器发射头按按键看是否有白光闪烁手机摄像头能捕捉红外光。图像显示错位/不同步两排LED的起始像素第37颗物理位置未对齐。这是组装阶段最难修正的问题。必须拆开外壳重新调整并固定两排灯带确保它们在圆周上处于完全对称的位置。第一颗LED损坏常亮或熄灭焊接时静电或过热击穿。如果只是第一颗LED坏了可以直接将其剪掉将信号线焊到第二颗LED的输入端。程序里需要将LED总数减1改为71颗但视觉效果影响很小。5.3 最终外壳组装测试无误后用热熔胶加固所有主要焊点特别是LED灯带上的焊点和Teensy上的排线。将红外接收头用热熔胶固定在管壁内侧确保其接收窗前方无遮挡。将整个组件从Teensy一端开始小心地滑入聚碳酸酯管。因为电池端是直径最大的部分最后进入会更顺滑。调整内部组件使开关滑杆对准底盖的开孔USB口对准顶盖的开孔。使用E6000或类似的柔性粘合剂来粘合端盖。这种胶干燥后有弹性能缓冲冲击比纯粹的热熔胶或强力胶更耐摔。在管口和端盖接合处均匀涂抹一圈按压固定静置24小时使其完全固化。最后将Poi系绳穿过管顶的孔洞打好牢固的死结并用打火机轻轻灼烧绳头防止散开。一个属于你的Supernova Poi就诞生了。6. 自定义图像制作与高级玩法项目自带的图案很棒但注入自己的创意才是乐趣所在。将自定义图像转换为代码需要一点命令行操作但一旦掌握你就拥有了无限可能。6.1 图像转换原理与工具配置转换脚本convert.py的核心工作就是“降维”和“索引化”。尺寸归一化将任意图片缩放或裁剪到宽度不限但高度必须恰好为36像素你的LED数量。颜色量化分析图片中的所有颜色将其归并为至多16种取决于调色板模式PALETTE4是4色PALETTE16是16色。这是为了压缩数据。生成调色板和索引图创建一个包含这些颜色的调色板数组然后将原图中每个像素的颜色替换为调色板中对应颜色的索引生成一个纯数字的像素索引数组。输出C代码将调色板和像素数组格式化为C语言头文件(graphics.h)的格式。6.2 在Windows/Mac上搭建转换环境教程推荐树莓派但在日常电脑上操作更直接。安装Python从Python官网下载并安装最新版3.x安装时务必勾选“Add Python to PATH”。安装PILPillow打开命令提示符CMD或终端输入pip install Pillow即可。修改转换脚本用文本编辑器如VS Code Notepad打开convert.py找到开头附近的参数设置部分修改为适合Supernova Poi的配置batterySize 2200 # 电池容量单位毫安时 runTime 2.5 # 预估最大运行时间单位小时时间越长LED越暗以省电 parallelStrips 2 # 并行LED灯带数量准备图片将你的图片支持GIF BMP PNG JPG等放到一个方便操作的文件夹例如D:\poi_images。图片内容最好是高对比度、线条清晰的图案或文字复杂渐变色在量化后可能效果不佳。6.3 执行转换并集成假设你的图片是my_dragon.gif高度已经是36像素。打开命令行切换到convert.py脚本所在的目录。执行转换命令python convert.py D:\poi_images\my_dragon.gif new_graphics.h这条命令会将转换后的C代码输出到new_graphics.h文件中。用文本编辑器打开生成的new_graphics.h和项目原有的graphics.h。从new_graphics.h中复制整个// my_dragon.gif -----------------------------------------------------------------部分包括调色板数组paletteXX和像素数组pixelsXX粘贴到原有graphics.h文件的类似代码块后面。注意变量名不能重复如果原有最后一个图像是palette06/pixels06那么你的新图像应该顺延为palette07/pixels07。在graphics.h文件最底部的const image PROGMEM images[]数组中添加新的一行来引用你的图像例如{ PALETTE4 , 40, (const uint8_t *)palette07, pixels07 }, // 假设你的龙图宽度是40像素保存graphics.h在Arduino IDE中重新编译并上传整个项目到Teensy。6.4 红外遥控功能定制代码中通过IR_RECEIVE_PIN定义了红外接收引脚并在loop()函数中监听红外信号。你可以修改switch (irCode)语句将不同的红外按键码映射到你想要的任何功能。例如不仅可以切换图像还可以调整亮度、切换动画模式、改变旋转速度等。你需要先通过一个简单的测试程序读取你遥控器各个按键发出的原始码值然后将这些码值替换到主程序的判断条件中。我个人在实际制作和后续使用中发现为不同的图像模式编组并用遥控器上的“上一组/下一组”和“组内上一张/下一张”来管理体验会好很多。这需要你稍微重构一下代码逻辑定义一个二维的图像数组和对应的索引指针但这会让拥有上百张图片的Poi变得非常易于操控。