WLED 2 红 1 白图案(以及其他重复图案)
在 WLED 灯带上做出 2 红 1 白的图案:用 Solid Pattern(Speed 1、Intensity 0),用叠放分段实现 3 种或更多颜色,或者用 WLED Max 中的图案制作器。
本文作者 Jamie Conde 在 MeowScript 开发 WLED Max。 WLED Max 是一款独立 App,与官方 WLED 项目无关,也未获其认可。
快速回答:两种颜色的话,用 WLED 的 Solid Pattern 效果,颜色 1 选红、颜色 2 选白,Speed 设为 1(也就是 2 颗颜色 1 的 LED),Intensity 设为 0(1 颗颜色 2 的 LED)。三种或更多颜色,或者灯泡之间要有暗区?用 grouping(编组)和 spacing(间隔)把多个分段叠放在同一批 LED 上。或者用 WLED Max 中的图案制作器(1.1.4 新增):点选颜色和数量,在灯带上实时查看,再保存为预设。
两种网页界面方法在 WLED 0.14、0.15 和 16 上都可用。无需安装任何东西。
目标:红、红、白,沿着灯带不断重复。
两种颜色:Solid Pattern 效果
Solid Pattern 沿分段重复“X 颗颜色 1 的 LED,然后 Y 颗颜色 2 的 LED”。在它的代码里,亮起的 LED 数是 Speed + 1,背景 LED 数是 Intensity + 1。所以:
| 图案 | 颜色 1 | 颜色 2 | Speed | Intensity |
|---|---|---|---|---|
| 2 红 1 白 | 红 | 白 | 1 | 0 |
| 1 红 1 白 | 红 | 白 | 0 | 0 |
| 3 红 2 白 | 红 | 白 | 2 | 1 |
| 2 蓝 1 白(光明节) | 蓝 | 白 | 1 | 0 |
在网页界面中打开 Effects,选择 Solid Pattern 效果,设置两种颜色,再设置滑块。界面上这两个滑块叫“Fg size”和“Bg size”。

在 0 到 255 的滑块上用手指精确停在 1 很费劲,所以用 JSON API 更省事。效果 83 就是 Solid Pattern:
curl -X POST -H "Content-Type: application/json" \
-d '{"seg":[{"fx":83,"sx":1,"ix":0,"pal":0,"col":[[255,0,0],[255,255,255]]}]}' \
http://192.168.1.57/json/state
更大的“灯泡”: 如果每个灯泡应占 3 颗 LED(高密度灯带上很常见),把分段的 Grouping 设为 3。图案的每一步就会覆盖 3 颗 LED。
还有一个 Solid Pattern Tri,重复三种颜色,但三种颜色的大小相同,所以做不出 2 红 1 白。
三种或更多颜色:叠放分段
这是灵活的做法。每一段颜色都成为自己的分段,全部覆盖整条灯带,各自的起点依次往后错开:
- Grouping = 连续多少颗 LED 显示该颜色。
- Spacing = 每组之后跳过多少颗 LED。
- 对于每 C 颗 LED 重复一次的图案,一段 L 颗 LED 的颜色对应 grouping 为 L、spacing 为 C 减 L。
在 150 颗 LED 的灯带上做 2 红 1 白(C = 3):
| 分段 | Start | Stop | Grouping | Spacing | 效果、颜色 |
|---|---|---|---|---|---|
| 1 | 0 | 150 | 2 | 1 | Solid,红 |
| 2 | 2 | 150 | 1 | 2 | Solid,白 |
分段 1 点亮 LED 0 和 1,跳过 2,点亮 3 和 4,以此类推。分段 2 从 LED 2 开始,点亮它,跳过两颗,点亮 5。合在一起:红、红、白、红、红、白。
分段 1(grouping 2、spacing 1),分段 2(start 2、grouping 1、spacing 2),以及两者同时开启时您看到的效果。

要做带暗区的复古灯泡(1 红、1 暗、1 绿、1 暗,C = 4),把暗区也作为单独的黑色分段加进去:红色从 start 0 开始(grouping 1、spacing 3),黑色在 1,绿色在 2,黑色在 3,每个都是 grouping 1、spacing 3。在 0.14 和 0.15 上,没有任何分段覆盖的 LED 可能保留旧颜色,所以给暗灯泡一个真正的黑色分段,而不是让它们空着。
两点提醒。不要用分段的 Offset 字段来做这个。如果灯带长度不是图案长度的整数倍,最后一个不完整的重复会绕回到开头的几颗 LED 上。另外,每一段颜色都要占用一个分段:ESP8266 版本允许 16 个分段,ESP32 版本 32 个(带 PSRAM 的 WLED 16 开发板 64 个,运行 0.15.1 及之后 0.15 版本的 ESP32-S2 为 20 个)。一个带暗区的五色图案就已经用掉 10 个。
WLED Max 中的图案制作器(1.1.4 新增)
在 控制 标签页点 制作图案(“重复颜色,比如 2 红 1 白”)。当某个图案覆盖整盏灯时,它会变成 编辑图案。您也可以从 预设 标签页开始:先点 +,再点 新图案。在 iOS 和 Android 上的操作相同。

- 从模板或空白开始。 “起始模板”行会按当季内容打开(9 月和 10 月是“万圣节”,11 月 1 日到 11 日是“排灯节油灯”,11 月 12 日起是“经典圣诞”,12 月 26 日到 1 月 1 日是“跨年夜”),查看全部 列出全部 34 个模板,分为六组:圣诞、万圣节与秋季、节日、体育与球队、节庆与公益和日常。已经很接近 2 红 1 白的有:拐杖糖(2 红 2 白)、光明节(2 蓝 1 白)、圣帕特里克节(2 绿 1 白)、粉红丝带(2 粉 1 白)、焦橙与白(2 橙 1 白)和栗与白(2 深红 1 白)。
- 设置颜色和数量。 最多 6 种颜色,每种连续 1 到 10 个灯泡。要做 2 红 1 白:红色填 2,白色填 1。快捷颜色:红色、绿色、蓝色、橙色、金色、黄色、白色、暖白、冷白、紫色、粉色、深红、浅蓝色和青绿色,或者从色轮中任选一种颜色。
- 颜色之间的暗灯泡,0 到 4 个,“就像经典的大灯泡串灯”。
- 实时查看。 您编辑时图案会显示在灯上(“正在您的灯上实时显示”)。取消 会把灯恢复原样。
- 添加动效(可选):无、星光闪烁、柔光、闪光、波浪、扫光或跑马灯,并有一个从“慢”到“快”的“速度”滑块。跑马灯会让图案本身沿灯带移动,并给灯添加一个自定义调色板(“跑马灯会给您的灯添加一个调色板。取消则会移除它。”)。
- 选择位置。 如果您的灯被分成几个部分(分段),选择 整盏灯 或其中一个部分。
- 保存。 保存为预设 把它存进一个空闲的预设槽位(“您的其他预设不会改变”),或者点 使用但不保存。编辑已保存的图案时会提供 更新 或 另存为新预设。开启 灯打开时从这个图案开始 可以把它设为开机预设。
一个重复单元最多 16 个灯泡(颜色加暗灯泡),计数器会显示您用了多少。如果之后您在正显示图案的灯上更改颜色或效果,App 会先问“替换图案?”,这样就不会不小心把它抹掉。
要求: WLED 0.14 或更新版本,以及支持 RGB 彩色的灯带。图案制作器不会在 2D 矩阵、纯白灯带或分组上显示。
两三台控制器上的常设屋檐灯?在一台控制器上保存图案,再复制到其他控制器。我们关于 WLED Max 中的常设灯 的页面会带您用这种方式控制整栋房子的灯。
图案出错时
灯带末端的图案从一个灯泡的中间开始。 灯带长度不是图案长度的整数倍。把分段缩短到整数倍(150 颗 LED 正好容纳重复长度 3),或者接受末尾有一个不完整的重复。
红色显示成绿色。 颜色顺序错了。在做图案之前,先在网页界面的 Config > LED & Hardware(WLED 0.14 和 0.15 上是 LED Preferences)下修正颜色顺序(GRB 与 RGB)。
最后几种颜色一直不出现,或者 App 提示“这盏灯放不下这么精细的图案。” 灯的分段用完了。到达上限后网页界面会把 Add segment 灰掉,而要求更多分段的预设或 API 调用只会默默跳过多出来的部分,不报错。减少颜色数或暗灯泡数。ESP8266 的灯会更早碰到这个问题。
白色在红色旁边看起来发蓝。 RGB 白是冷白。试试暖白,或者稍微降低亮度。
图案会漂移或跳动。 某个分段上运行着 Solid 之外的效果,或者播放列表在切换预设。把每个分段都设回 Solid,或者检查您的播放列表。
常见问题
如何在 WLED 中做拐杖糖图案? Solid Pattern,红色和白色,Speed 1、Intensity 1(2 和 2)。在 WLED Max 中选“拐杖糖”模板。
可以让重复图案动起来吗? 可以。在网页界面中,给每个分段运行一个移动效果,或者用 Running 配合调色板。图案制作器的动效选项一点就能做到。
这在 2D 矩阵上可行吗? Solid Pattern 可以,但它把矩阵当作一条长线处理。图案制作器只支持灯带。
想要带精确数字的完整节日灯效(拐杖糖、复古 C9 灯泡、油灯),见 圣诞与排灯节图案指南。如果您对分段还不熟悉,WLED 分段详解 更深入地讲解了 grouping 和 spacing,预设与开机预设 则演示如何让图案成为灯开机后显示的第一样东西。