WLED 设置 LED 设置 电源 WLED Max 操作指南

WLED 设置详解:用手机搞定最大电流、LED 输出、同步和安全

重要的 WLED 设置各自做什么,附真实数字:每颗 LED 的最大电流、LED 输出和 GPIO、同步接口以及 OTA 锁。

作者: 发布于 更新于

一条全新的 300 颗 LED 灯带看起来出奇地暗,通常不是坏了。WLED 的亮度限制器默认从 850 mA 起步,差不多就是一个手机充电器能给的电流,所以它会把一切都调暗以保持在这个值之下。很多 WLED 的“bug”都是这样:某项设置在尽职工作,只是那个数字从来没人改过。

下面的每一项设置都在 WLED 网页界面里,表格则告诉您同一项在 WLED Max 中的位置。

先看症状

您看到的通常是
灯带偏暗,或者全白显得很弱最大电流 相对您的电源设得太低
只有前几颗 LED 亮LED 数量 太小,或者 数据 GPIO 选错
红绿颠倒颜色顺序
全白在远端变成橙色电压下降(补电;调低最大电流只能掩盖它)
全白时灯重启电源过载,调低最大电流
远处随机闪烁数据信号或接地问题,不是设置

最后一条让很多人栽跟头。加一根共地线、缩短第一段数据线,或者用电平转换器。没有哪个复选框能修好它。

各项设置在哪里

WLED 网页界面(Config)WLED Max 的设备设置里面有什么
WiFi & Network(0.14 和 0.15 上是 WiFi Setup)Wi-Fi 设置网络、静态 IP、热点
LED & Hardware(0.14 和 0.15 上是 LED Preferences)LED 设置输出、LED 类型、数量、GPIO、电流限制、颜色顺序、开机默认值、夜灯默认值
2D Configuration2D 配置矩阵面板、布局
User Interface用户界面服务器描述(WLED 16 上是 Device Name)。在 WLED Max 中这一部分还包含 Alexa 名称、按键、红外遥控器和继电器,网页界面把这些放在 Sync Interfaces 和 LED & Hardware 下
Sync Interfaces同步接口UDP 同步、Alexa、MQTT、E1.31/DMX/Art-Net、Philips Hue、Serial/Adalight
Time & Macros时间与宏、定时计划NTP、时区、位置、定时器
Usermods用户模块AudioReactive 之类的附加模块
Security & Updates安全与更新OTA 锁、密码、重启(备份在网页的这一页;在 App 中位于“备份与恢复”下)

在 WLED Max 中,打开一盏灯,点菜单,选择 设备设置。顶部显示设备信息:IP、固件、MAC 地址、LED 数量和 mDNS 名称,还有 打开网页界面。少数项目只能在网页上操作,恢复出厂设置和一些高级选项就在其中,App 会在您碰到这类项目时告诉您。

WLED 网页界面
WLED 16 设置菜单,按钮包括 Back、WiFi and Network、LED and Hardware、Pin Info、2D Configuration、User Interface、Sync Interfaces、Time and Macros、Usermods
WLED 16.0.1 上的 Config 菜单。在 0.14 和 0.15 上前两个按钮写的是 WiFi Setup 和 LED Preferences。
iOS
WLED Max 的“设备设置”列表:Wi-Fi 设置、LED 设置、2D 配置、用户界面、同步接口、定时计划、时间与宏、用户模块、安全与更新,然后是带 IP 地址的“设备信息”
WLED Max 中的设备设置,同样的分区。

最大电流和每颗 LED 的电流

自动亮度限制器(ABL) 估算 LED 的电流消耗,并降低亮度以把总量控制在您的限值之下。它需要两个数字。

最大电流(mA) 是您的电源能提供的电流减去一个余量。一个 5 V 10 A 的电源是 10,000 mA,所以设大约 8,500,给控制器和损耗留出空间。

每个 LED 的电流(mA) 是一颗 LED 在全白时的电流。WLED 为它提供了预设值:55 mA(典型的 5 V WS281x)、35 mA(节能型 WS2812)、30 mA(典型的 12 V)、12 mA(WS2815)和 15 mA(铜线灯,即满天星像素)。您也可以自己输入。

举个例子。300 颗 55 mA 的 WS2812B LED 在全白时可能拉到 16.5 A。用 10 A 电源、最大电流 设为 8,500 mA 时,WLED 会把全白限制在大约一半亮度。彩色耗电更少,所以可以更亮。这是限制器在工作,不是故障。不要把最大电流设得高于电源和线路能承受的值。5 V 灯带每 100 到 150 颗 LED 补一次电,每一路都加保险丝。打算做整条屋檐线?屋檐线与户外供电指南会帮您算出电源、补电点和线径。

在 WLED Max 中,这两个字段都在 LED 设置 > 电源与性能 下。目标 FPS 也在那里。42 适合大多数灯带,调高只对短灯带有帮助。

WLED 网页界面
WLED LED 设置页:Enable automatic brightness limiter 已勾选,Maximum PSU Current 850 mA,以及一条提示:283 颗 LED 全白时建议使用 16 A 电源
网页界面中的限制器。850 mA 是默认值。
iOS
WLED Max 的“LED 设置”滚动到“电源与性能”:最大电流 850 mA、每个 LED 的电流 55 mA、目标 FPS,然后是过渡和伽马设置
WLED Max 中的最大电流和每个 LED 的电流。

LED 输出和 GPIO

一个输出就是从控制器到一条灯带的一根数据线。每个输出您需要设置:

  • LED 类型(WS281x、SK6812 RGBW、APA102 等)
  • 数据 GPIO,四线灯带还要设 时钟 GPIO
  • 开始 和 长度(这个输出上的 LED 数量)
  • 颜色顺序(WS2812B 通常是 GRB)
  • 已反转 和 跳过前面的 LED(用于当作电平转换器牺牲掉的第一颗像素)
WLED 网页界面
WLED 的 LED 输出区块:输出 1 类型 SK6812/WS2814 RGBW,每颗 LED 55 mA,颜色顺序 GRB,start 0,length 283,data GPIO 16,Reversed,Skip first LEDs 0,Auto-calculate W channel 设为 Brighter
网页界面中的一个输出。
iOS
WLED Max 的“LED 设置”:LED 类型 SK6812/WS2814 RGBW、颜色顺序 GRB、交换为“无”、LED 数量 283、GPIO 引脚 16、已反转、跳过前面的 LED 为 0、关闭时刷新、自动白光为“更亮”,以及一个“添加输出”按钮
WLED Max 中的同一个输出,下方是“添加输出”。

接在另一个引脚上的第二条灯带就是第二个输出。网页界面在 LED & Hardware 下有一个“+”按钮。WLED Max 在那里有 添加输出 和 移除输出,而且会先检查固件报告的限制:能有多少个输出、哪些 GPIO 空闲、还剩多少 LED 内存。如果加不了,它会告诉您原因。这在 ESP8266 上最要紧,它能带的 LED 和输出比 ESP32 少得多。

在网页界面中,WLED 一保存就应用新的输出设置。WLED Max 会要求您 保存并重启,灯随后带着新的硬件设置重启。

Sync Interfaces

UDP 同步(WLED Sync) 让几盏 WLED 灯保持同一个效果。一盏灯开 Send,其他的开 Receive。控制多台 WLED 设备讲得更深入。

Receive UDP realtime 允许工具暂时直接驱动像素:Hyperion、xLights、Home Assistant 脚本,或 WLED Max 中的灯光提醒。除非有东西一直劫持这盏灯,否则保持开启。如果真的有,WLED Max 会在“控制”标签页显示出来,并带一个 接管控制 按钮,其余内容见 WLED 卡在实时模式。

iOS
WLED Max 的“同步接口”:“UDP 同步:发送”中的“启用发送”关闭,“UDP 同步:接收”中的亮度、颜色、效果和分段数据开启,UDP 端口,Alexa 和 MQTT
UDP 同步的发送和接收。
iOS
WLED Max 的“同步接口”滚动到 E1.31、DMX 和 Art-Net:已启用,DMX 模式 Multi RGB,端口 5568,起始 universe 1,超时 25,强制最大亮度开启
再往下是 E1.31、DMX 和 Art-Net。

E1.31、Art-Net、DDP 用于灯光软件和演出。Universe 和起始地址在这里设置。MQTT 和 Alexa 覆盖 Home Assistant 自带集成之外的家庭自动化。

Security & Updates

OTA 锁(网页界面:“Lock wireless (OTA) software update”;App:锁定 OTA 更新)会阻止固件上传,只有您的密码能再把它解开。锁定 Wi-Fi 设置 用同样的方式保护网络设置。在合租的房子或店铺里值得开。ArduinoOTA、同子网更新限制和 重启 也在这里,App 中还有 解锁并重启。更新过程本身见 在 ESP8266 和 ESP02 上进行 WLED OTA 更新。

iOS
WLED Max 的“安全与更新”:“锁定 OTA 更新”和“锁定 Wi-Fi 设置”关闭,“启用 ArduinoOTA”和“仅允许同一子网内的 OTA”开启,已设置 OTA 密码,“保存安全设置”,“设备操作”
WLED Max 中的安全与更新。

App 不会写入设置的灯

从 1.1.4 版起,WLED Max 不会更改已设置了 I2C 引脚、或者读不到这些引脚的 ESP32 灯的设置。这类灯通常接着传感器、显示屏或音频板,App 发出的设置更改可能会打乱那套配置。您会看到“这盏灯使用了额外的硬件,所以请在灯自己的设置页面中更改此项”,并附上可在浏览器中打开的灯的地址。如果灯的设置用 PIN 锁住了,App 会说明这一点,不做任何更改,并请您先在 WLED 网页界面中解锁。

注意

更改 Wi-Fi 设置可能让灯换到新地址,甚至离开您的网络。先备份。

最后一个常让人中招的地方:更改 Wi-Fi 设置(静态 IP、换一个网络)可能让灯换地址。如果保存后它消失了,查看路由器的客户端列表,或者等 WLED-AP 热点出现。另外,大改动之前先备份配置。