WLED Wi-Fi 离线 故障排除 通知 WLED Max

WLED 灯为什么总是掉线,以及如何在掉线时收到提醒

WLED 控制器为什么会从 Wi-Fi 掉线(信号弱、Wi-Fi 休眠、电源、DHCP、mDNS),每种情况怎么修,以及如何收到离线提醒。

作者: 发布于 更新于

本文作者 Jamie Conde 在 MeowScript 开发 WLED Max。 WLED Max 是一款独立 App,与官方 WLED 项目无关,也未获其认可。

**快速回答:**先在灯的 Info 页面看 Wi-Fi 信号。好于 -70 dBm 没问题,-70 到 -80 dBm 勉强可用,低于 -80 dBm 就会掉线。如果信号良好,原因几乎总是这几个:Wi-Fi 省电、电源不够、IP 地址不停变化,或者 App 在一个拦截 mDNS 的网络上按名字找灯。

这里的修复方法都不需要 App,全是 WLED 和路由器的设置。

先确认:它真的离线了吗?

在浏览器里打开灯的 IP 地址。如果网页界面能加载,灯本身没问题,麻烦出在 App 怎么找到它(直接跳到下文的 mDNS 一节)。如果打不开,从电脑上 ping 它:

ping 192.168.1.50

完全没有回应:灯已经不在网络上。时有时无的回应:Wi-Fi 太差。

信号

在 WLED 网页界面点 Info,查看 Wi-Fi 信号。它以百分比和 dBm 两种形式显示。

信号预期表现
好于 -70 dBm正常
-70 到 -80 dBm勉强可用,偶尔响应慢
低于 -80 dBm掉线,尤其是在运行数据量大的效果时

ESP 开发板的天线很小。把它放进金属盒、塞到电视后面或装进檐沟槽里,信号会损失很多。有帮助的做法:把接入点挪近一点或在附近加一个,换一块带外置天线的开发板(很多 ESP32 板有天线接口),把控制器从金属盒里拿出来,并让开发板的天线一端远离灯带和电源。

WLED 只支持 2.4 GHz。2.4 和 5 GHz 共用一个网络名通常没问题。不过有些 Mesh 系统会过于积极地把客户端在节点之间来回切换,给 IoT 设备单独建一个 2.4 GHz 网络往往就能解决。

Wi-Fi 休眠

在 Config > WiFi & Network(0.14 和 0.15 上叫 WiFi Setup)里有一个名为 Disable WiFi sleep 的复选框。把它勾上。

WiFi & Network(页面底部)
Disable WiFi sleep☑

页面末尾附近的一个复选框。在 WLED Max 里对应“设备设置”的“Wi-Fi 设置”中的“Wi-Fi 休眠”开关(关闭即不休眠)。

Modem sleep 能省一点电,但灯的响应会变慢,在某些路由器上还会彻底掉线。ESP32 固件默认勾选了它,ESP8266 固件没有,所以通常是 ESP8266 的灯需要这一步。

反复重启:欠压(错误 91)

它是不是每次显示亮白色时就“掉线”?那是欠压(brownout)。LED 消耗的电流太大,ESP 重启,每次重启都会让它离开网络几秒。您会看到灯闪一下或效果从头开始,Info 页面显示的运行时间很短。

WLED 网页界面
手机上的 WLED LED 设置页面:LED 总数 283,推荐电源提示,Enable automatic brightness limiter 已勾选,Maximum PSU Current 850 mA,Use per-output limiter 未勾选
LED 设置页面顶部的亮度限制器(WLED 16.0.1)。要设置的数字是 Maximum PSU Current。

换一个更大的电源能解决,补电(电源注入)也行,或者在 Config > LED & Hardware 里调低 Maximum PSU Current(WLED Max 的“LED 设置”中叫“最大电流”),让 WLED 限制亮度。WLED 设置详解有具体数字。在运行 WLED 16 的 ESP32 板上,这样重启之后网页界面会显示错误 91;WLED 错误代码有解释。

更新后离线

一盏固件更新前好好的、更新后找不到的灯,通常属于下面几种情况之一:

  • **它回到了 WLED-AP 模式。**Wi-Fi 设置没能在更新中保留下来。找一个叫 WLED-AP 的网络,连上它(密码 wled1234),重新设置 Wi-Fi,然后恢复您的备份。
  • **它换了新 IP 地址。**重启时向路由器要地址,拿到了一个不同的。在路由器的客户端列表里找到它,添加 DHCP 地址保留(下一节)。
  • **它在不停重启。**WLED 0.15.5 和 16 会在连续 5 次快速崩溃后察觉到启动循环并自行回退。ESP32 在刚更新之后的第一步是切回上一个固件。否则它们会先恢复最后一次正常的配置,再重置配置。等几分钟,然后检查您的设置有没有变。
  • **刷错了固件。**比如一块以太网开发板刷了没有以太网支持的固件,有线连接就永远回不来。在 install.wled.me 通过 USB 刷回匹配的固件。该用哪个 .bin 可以帮您选。

IP 地址变化

路由器重启后,灯可能以新 IP 回到网络,保存了旧地址的 App 就找不到它。在路由器里为它的 MAC 地址做一个 DHCP 地址保留(MAC 在 Info 页面上),或者在 WLED 的 WiFi & Network 页面设置静态 IP。路由器端的保留更容易管理。

iOS
WLED Max 中一盏灯的“Wi-Fi 设置”界面:网络 HomeWiFi 和密码栏,“IP 配置”中“使用 DHCP”已开启,mDNS 名称 porch-lights,以及 WLED-AP 热点设置
WLED Max 中的 Wi-Fi 设置。保持“使用 DHCP”开启,改在路由器里保留地址。

按名字找到(mDNS)

App 通过 mDNS 找 WLED 灯,而 mDNS 默认不跨 VLAN 和访客网络,还会被一些 Mesh 路由器过滤。如果浏览器能打开灯而 App 不行,这很可能就是原因,WLED App 找不到您的灯逐步讲了解决办法,包括 iPhone 的“本地网络”权限。

灯掉线时收到提醒

WLED Max 有一个可选的 设备离线通知(“灯离线几分钟后通知我”)。它免费,默认关闭。位置在 设置›App 偏好设置›通知(Android 上是“应用偏好设置”)。

它故意做得很安静。灯必须在您的手机连着 Wi-Fi 时停止响应几分钟,App 还会再检查一次才会提醒您。然后您会收到一条通知,比如“Porch Lights 已离线”,“设备”标签页会给这盏灯做标记。如果那一刻您正看着“设备”标签页,列表里会直接显示,不再发通知。同时掉线的几盏灯共用一条通知,同一盏灯每次故障最多提醒一次,每天最多一次。移动数据下什么都不发,灯恢复后通知会自动消失。它只在 App 打开时运行,不是全天候监控。要全天候监控,Home Assistant 或路由器的设备提醒做得更好。

1.1.4 版让这些提醒更安静了,如果您在旧版本里因为太吵而关掉了它,可以再试一次。

如果这里的办法都没用,WLED 社区(Discord、Reddit 的 r/WLED、论坛)几乎见过所有不稳定的控制器。如果看起来是 App 的问题,WLED Max 设置里的 联系我们可以直接找到我们,回复会在 App 内送达。

检查清单

从上往下逐项检查

大多数不稳定的灯靠前三项就能修好。浏览器能打开灯而 App 不行时,网络相关的几项才重要。

  • 控制器处的信号好于 -70 dBm
  • 已勾选 Disable WiFi sleep
  • 电源按 LED 数量选够,已设置最大电流
  • 为灯做了 DHCP 地址保留
  • 和手机在同一网络(或有 mDNS 反射器)
  • iPhone 上已开启“本地网络”权限

固件也过时了?在 ESP8266 和 ESP02 上更新 WLED 有说明,做任何大改动之前,值得先备份配置。

我们的 iOS 和 Android App WLED Max:一盏灯即可免费使用全部功能。