WLED 与 xLights:什么时候需要它、DDP 设置,以及如何拿回控制权
什么时候单靠 WLED 就够了,什么时候值得用 xLights;如何通过 DDP 或 E1.31 把 xLights 发送到 WLED;两边各有哪些设置重要;以及演出结束后 WLED 如何拿回控制权。
本文作者 Jamie Conde 在 MeowScript 开发 WLED Max。 WLED Max 是一款独立 App,与官方 WLED 项目无关,也未获其认可。
**快速回答:**WLED 自己就能运行效果;xLights 用于跨多个道具、配合音乐编排的演出。两者可以配合:xLights 通过网络发送每个像素的颜色,WLED 只负责显示。在 xLights 中把灯添加为以太网控制器,厂商(Vendor)选 WLED,协议(Protocol)选 DDP。WLED 这边不需要为 DDP 做任何设置。xLights 停止发送后,WLED 会在 2.5 秒后回到自己的效果。
您真的需要 xLights 吗?
大多数用 WLED 的人不需要。WLED 论坛上有一条经验法则说得很清楚:很多 LED 装置 WLED 自己就能搞定,当您想把整个院子当作一场演出来控制时,xLights 才是合适的工具。
| 您想要 | 用 |
|---|---|
| 屋檐线、树或窗户上的漂亮效果,按时间表切换 | 单用 WLED,配合预设、播放列表和定时器 |
| 红白相间或拐杖糖之类的节日图案 | 单用 WLED,见圣诞图案 |
| 几盏灯同步显示同一个效果 | 单用 WLED,配合 UDP 同步 |
| 灯光逐拍跟着一首歌走 | xLights |
| 巨型圣诞树、矩阵、拱门和屋檐线作为一个整体显示 | xLights |
| 每晚按时间表自动运行、不需要电脑的演出 | 用 xLights 制作,用 Raspberry Pi 上的 Falcon Player(FPP)播放 |
xLights 免费且强大,同时也是一项独立的爱好。编排一首歌可能要花一个晚上。如果您只是想让房子在十二月看起来漂亮,单用 WLED 就能满足大部分需求。
两者如何配合
演出期间,WLED 不再是大脑。xLights(或播放演出的 FPP)发送一连串帧,每一帧包含每个像素的颜色。WLED 切换进实时模式:清空灯带,显示收到的任何内容,并忽略自己的效果、预设和定时器,直到数据流停止。
这就是为什么 WLED 论坛上最常见的 xLights 问题其实是“为什么我的 WLED 不理 App 了?”那一侧的内容见 WLED 卡在实时模式。
选 DDP 还是 E1.31?
WLED 接受三种演出协议。DDP 和 E1.31 默认开启。Art-Net 需要在 Sync Interfaces 的 Network DMX input 下把 Type 设为 Art-Net,这会把监听端口从 5568 移到 6454,所以 E1.31 和 Art-Net 不能同时开启。
| DDP | E1.31(sACN) | Art-Net | |
|---|---|---|---|
| 端口 | 4048 | 5568 | 6454 |
| WLED 中的设置 | 无,始终开启 | Network DMX input,DMX mode | 同上,Type 选 Art-Net |
| Universe | 无,只有一个像素偏移 | 每个 universe 170 个 RGB 像素 | 与 E1.31 相同 |
| RGBW | WLED 支持,但 xLights 的 WLED 上传会拒绝 | 支持,DMX mode 选 Multi RGBW | 支持 |
| xLights 对 WLED 的默认选项 | 是 |
用 DDP,除非您有不用的理由。它是 xLights 发现 WLED 控制器时的默认选择,没有需要对齐的 universe,而且效率高。用 E1.31 的情况:RGBW 像素,或者您的演出在 FPP 中是围绕 universe 搭建的。
设置 WLED
对 DDP 来说几乎无事可做。在 Config›LED & Hardware(0.14 和 0.15 上是 LED Preferences)中检查以下几点:
- LED 数量和各输出的顺序与实际接线一致。
- 灯有固定地址(在路由器里做 DHCP 保留)。
对 E1.31,打开 Config›Sync Interfaces,在 Realtime 部分找到 Network DMX input:
- Type: E1.31 (sACN)。
- Start universe: xLights 发给这盏灯的第一个 universe(默认为 1)。
- DMX mode: RGB 像素用 Multi RGB,RGBW 用 Multi RGBW。WLED 的文档称 Multi RGB 是“the mode you want to use for xLights”。
- Multicast: 与 xLights 发送的方式一致。单播(关闭)在 Wi-Fi 上更简单。
Realtime 部分的其余设置对两种协议都有影响:
- Timeout(默认 2500 ms):最后一帧之后 WLED 等待多久才回到自己的效果。
- Force max brightness: 以全亮度显示数据流,而不是您的 WLED 亮度。
- Use main segment only: 数据流只绘制主分段,其他分段继续运行各自的 WLED 效果。开启后,WLED 会忽略下文描述的
lor覆盖。 - Respect LED Maps(0.15 及更新版本):把您的 LED 映射(ledmap.json)也应用到数据流上。
在 iPhone 上的 WLED Max 中,E1.31 设置和超时在“设备设置”、“同步接口”下的 E1.31 / DMX / Art-Net 部分。Android 上位置相同:设备设置、同步接口、E1.31 / DMX / Art-Net。App 的超时字段以 100 ms 为步进计数,所以那里填 25 就等于 2500 ms。
设置 xLights
xLights 内置了 WLED 作为控制器厂商,提供通用 ESP8266 和 ESP32 开发板以及几款 QuinLED 开发板的型号。
- 打开 Controllers 标签页,点击 Add Ethernet。(或者试试 Discover:它会在您的网络上找到 WLED 灯并填好其余内容。)
- 输入灯的 IP Address,Vendor 选 WLED,然后 Model 选 WLED、Variant 选 Generic ESP32 或 Generic ESP8266,或者在 Model 中直接选您的开发板(QuinLED Dig-Uno、Dig-Quad、Dig-Octa 等)。
- Protocol 设为 DDP。Keep Channel Numbers 保持关闭。
- 在 Layout 标签页搭建您的道具,然后回到控制器,点击 Visualise,把每个道具拖到它实际接线的端口上。
- 开启 Auto Size 后,xLights 会根据道具算出通道数。手动算的话,RGB 是 LED 数 × 3。
- 保存,然后打开灯光输出(工具栏上的灯泡按钮)。
该让 xLights 上传到 WLED 吗?
Upload Output 按钮会把端口设置(LED 数量、GPIO 引脚、LED 类型、颜色顺序)写进 WLED 并重启灯。对一块全新的控制器很方便,但它会覆盖 WLED 的 LED 设置,论坛上也有它清掉 GPIO 设置的报告。如果您的 WLED 已经设置好并正常工作,就自己在 WLED 里设置 LED 数量,跳过上传。无论哪种方式都先备份:WLED 备份与恢复。
您可能看到的两个上传错误及其含义:
- “The DDP ‘Keep Channel Numbers’ option is not support with WLED”:关闭该选项。
- “Four Channel Pixles and DDP, do not work well in WLED”:您的道具是 RGBW。把该控制器切换到 E1.31,并把 WLED 的 DMX mode 设为 Multi RGBW。
Wi-Fi、帧率和大型演出
通过 Wi-Fi 推流对几台控制器来说没问题。演出规模变大后就越来越难:每一帧的每个像素都要经过无线传输,论坛上有帖子描述十几台 Wi-Fi 控制器的演出掉到每秒几帧。
- 让发送演出的电脑或 FPP 走网线,只让最后一跳是 Wi-Fi。
- 在 xLights 中为该控制器开启 Suppress Duplicate Frames,没有变化的帧就不会重复发送。
- 对 E1.31,WLED 的文档建议每盏灯不超过 3 个 universe(510 个 RGB 像素)以保证流畅的每秒 40 帧,ESP8266 上最多 9 个 universe。
- WLED 最快每 16 ms 显示一帧新的推流画面,所以无论您发多快,上限都是每秒 60 帧出头。
- 大型显示装置用 ESP32 开发板,能用有线以太网开发板的地方就用。
演出结束后拿回控制权
数据流停止后,WLED 等待超时时间(默认 2.5 秒),然后回到它之前正在做的事:同样的效果,同样的亮度。推流不会改变 WLED 自己的任何设置。
当您在 xLights 中关闭输出时,它会先发送一帧全黑。所以灯会在超时时长内保持熄灭,然后 WLED 的效果才回来。
如果 WLED 一直不回来,说明还有东西在发送。从灯的 /json/info 里找它(lip 字段显示发送方的 IP),或者直接覆盖:
- 向
/json/state发送{"lor":1},忽略数据流直到它停止;或发送{"lor":2},忽略到下次重启。 - 发送
{"live":false}立刻退出实时模式。如果发送方还在推流,下一个数据包会把灯直接送回实时模式,所以要么停掉发送方,要么用lor。
在 WLED Max 中,当灯被 xLights 或其他任何东西驱动时,“控制”标签页会显示一条写着“外部控制中”的横幅(iOS 和 Android 相同,Android 从 WLED Max 1.1.4 起)。点 接管控制,选择 接管直到数据停止 或 接管直到重启。这就是上面那两个覆盖值。在 Android 1.1.2 及更早的版本中,横幅会显示发送方的名称(“… is controlling this device”,那时 App 只有英文版),两个按钮叫 Until Data Stops 和 Until Reboot。
如果想让灯保持最后一帧,把超时设为 65000,WLED 会把它当作永不超时。
常见问题
用 WLED 需要 xLights 吗? 不需要。WLED 自己就能运行效果、预设、播放列表和定时器。xLights 用于跨多个道具、与音乐同步的演出。
xLights 用哪个端口连接 WLED? DDP 用 4048,E1.31 用 5568,Art-Net 用 6454。
我必须在 WLED 中启用 DDP 吗? 不必。WLED 始终监听 DDP。E1.31 和 Art-Net 在 Sync Interfaces 的 Network DMX input 下设置:Type 选择 E1.31 或 Art-Net,DMX mode 不能是 Disabled。
为什么演出结束后 WLED 一直黑着? 您关闭输出时 xLights 发送了一帧黑色,WLED 会显示它直到超时结束。如果黑的时间更长,说明还有别的发送方在推流。
我可以同时使用 WLED 效果和 xLights 吗? 可以,有两种方式:开启 Use main segment only,让演出在一个分段上运行,其他分段保留 WLED 效果;或者让 WLED 正常运行,只在演出播放时切到 xLights。