WLED 睡眠定时器和唤醒灯:夜里渐暗关闭,早上渐亮唤醒
用 WLED 的 Nightlight 定时器让灯在 30 分钟后(最长 255 分钟)渐暗关闭,并把灯设置成早上逐渐变亮的唤醒灯。
本文作者 Jamie Conde 在 MeowScript 开发 WLED Max。 WLED Max 是一款独立 App,与官方 WLED 项目无关,也未获其认可。
WLED 本来就有睡眠定时器。它只是叫 Nightlight(夜灯),所以很多人没发现。
启动后,灯会在您设定的分钟数内渐暗(或直接切换)到关闭,1 到 255 分钟都可以。最长就是 4 小时 15 分钟。倒计时在灯本身上运行,所以手机没电或离开家都不影响。本页前半部分的所有内容只用到 WLED 网页界面。
Nightlight 到底做什么
启动时,WLED 记住当前亮度,然后在您选择的时间内向目标亮度过渡。四种模式:
| 模式 | 发生什么 |
|---|---|
| Instant | 保持不变,时间一到切换到目标亮度 |
| Fade | 亮度在整个时长内平滑渐变到目标值 |
| Color fade | 亮度渐变,同时把主色向副色混合 |
| Sunrise | 运行 WLED 的 Sunrise 效果,上限 60 分钟。灯关着时启动是日出;灯开着时启动则播放日落 |
目标通常是 0,也就是关闭。设成 10 左右,灯会稳定在柔和的微光并保持不变。
在网页界面中设置
- 在浏览器中打开灯的 IP 地址,例如
http://192.168.1.50。 - 进入 Config›LED & Hardware(0.14 和 0.15 上叫 LED Preferences),滚动到 nightlight 部分。设置默认时长(30 分钟是个不错的起点)、模式(Fade 看起来最自然)和目标亮度(0 为关闭)。保存。
- 在主页面上点按 Timer 按钮(月亮图标)。夜灯按这些默认值启动。
- 再点一次月亮即可取消。
在网页界面中这个区块的标题是 Timed light(WLED 16 上该页面叫 LED & Hardware)。
如果您用脚本控制灯或者用家庭自动化,JSON API 可以做同样的事:
POST http://<light-ip>/json/state
{"nl": {"on": true, "dur": 30, "mode": 1, "tbri": 0}}
dur 是分钟数(1 到 255)。mode 为 0 Instant、1 Fade、2 Color fade、3 Sunrise,tbri 是目标亮度。
不用任何 App 的日出闹钟(唤醒灯)
WLED 自己不能在设定时间启动夜灯。一个定时器加一个预设可以做到大部分:
- 做一个使用 Sunrise 效果(效果 ID 104)的预设。它的第一个滑块“Time [min]”是日出的时长,1 到 60 分钟。设置精确值最干净的办法是用预设的 API 命令字段,例如
{"on": true, "bri": 255, "seg": [{"fx": 104, "sx": 20}]}表示 20 分钟的日出。 - 在 Config > Time & Macros 中确认 NTP 已开启,时区正确。
- 添加一个定时器,在工作日 6:40 运行这个预设。
为什么不在预设里直接放 mode 3 的 "nl"?因为预设同时会把灯打开,而灯已经开着时 WLED 播放的是日落。Sunrise 效果避开了这个问题。
只要您不介意编辑一点预设 JSON,这个办法就很好用。
App 中的定时计划和定时器
在 WLED Max 中,在 控制 标签页打开一盏灯,点按 定时计划和定时器。按钮本身就显示接下来会发生什么:下一个计划事件(iOS 上是“开,18:00”,Android 上是“18:00 开灯”)、正在运行的睡眠定时器倒计时,或者“未设置定时计划”。
页面标题下有两个标签。左边的 定时器 默认打开,在倒计时结束后把灯关闭一次。定时计划 在一个时间开灯、另一个时间关灯,按您选择的日子重复,并且保存在灯上。两者可以同时使用。App 会记住您上次用的标签,而在睡眠定时器运行期间,页面总是打开到“定时器”,让倒计时就在您眼前。
睡眠定时器
“定时器”标签是一张卡片:“时长”“模式”和“启动定时器”按钮。
- 在 时长 下选择 15 分钟、30 分钟、1 小时、2 小时或 4 小时,或者点按 自定义 用滑块从 1 分钟选到 4 小时 15 分钟(255 分钟,固件上限)。按钮下方那行会确认您的选择,例如“定时器:30 分钟”。
- 在 模式 下选择定时器结束的方式。立即 在定时器结束的那一刻关灯。渐变 逐渐变暗到关闭。日出 则相反:它逐渐变亮,也就是唤醒灯,并立刻启动 WLED 的 Sunrise 模式。请在灯关着的时候用它,并记住 WLED 把日出的上限设为 60 分钟。
- 点按 启动定时器。
灯开始倒计时并自己关闭,即使您关掉 App、锁上手机或离开家。这就是本页开头的 WLED Nightlight,只是从手机启动。要提前停止,回到同一个屏幕点按 取消定时器。使用“渐变”时,取消还会把亮度恢复到启动定时器时的水平,房间不会停在半暗状态。如果定时器运行期间您在 App 里改过亮度,就恢复到那个更新的值。在别处(WLED 网页、其他 App)做的更改不会被改回。如果联系不到灯,App 会告诉您,定时器则继续在灯上倒计时。“立即”和“渐变”需要灯处于开启状态;灯关着时 App 会显示“您的灯已经是关闭状态。”“日出”是例外,因为把关着的灯点亮正是它的用途。
在 iOS 上,倒计时还会以锁定屏幕和灵动岛上的实时活动的形式显示(仅 iOS)。没看到?打开 iOS 设置 > App > WLED Max,开启“实时活动”。

每日定时计划
点按 定时计划 标签。它总是显示灯上实际存在的内容,每次打开标签或下拉刷新时都重新读取,所以在 WLED 自己的网页或“设备设置 > 定时计划”里创建的计划也会显示在这里。
- 点按列表顶部的 +(列表为空时,添加定时计划 按钮作用相同)。编辑器打开时已经填好了最常见的情况:开灯时间 18:00,关灯时间 23:00,每天。两者都是时间选择器,点按时间即可更改。关灯时间早于开灯时间也没问题;摘要行会显示“关灯时间在第二天。”
- 在 重复 下点按 每天、工作日 或 周末,或者点按单个日期的圆片。
- 开启的内容 是可选项。只打开灯 让灯以之前的样子恢复。载入一个预设 则改为加载您的某个预设,所以基于 Sunrise 效果做的预设(见上面的配方)会让灯在早上渐亮,而不是一下子亮起。
- 点按 保存。稍等片刻,这一行会显示“已保存到您的灯。”
计划在控制器上运行,不在手机上。WLED Max 把它作为名为“WLED Max Schedule On”和“WLED Max Schedule Off”的定时预设(这是灯上保存的名称,App 中显示为“WLED Max 定时计划:开”和“WLED Max 定时计划:关”)写入灯自己的定时器槽位,就是我们日出和日落定时计划指南里讲的 Time-controlled presets,所以手机关机、不在家或没电时它照样工作。
每一行都有一个开关,您可以暂停某个计划再恢复,不必打开它。点按这一行可以更改时间或删除。每日计划共用灯上的八个时钟定时器槽位(WLED 16 能存更多定时器,这里也是八个),每个每日计划占用两个(一个开、一个关),所以最多放 4 个计划。列表分为两组:
- 每日定时计划 是 WLED Max 创建的开关配对。
- 这盏灯上的其他定时计划 列出其他所有定时器,包括日出和日落的。每个都有自己的开关,点按会打开常规的计划编辑器。
- 底部的“已使用 N / 8 个定时计划位置”把两组都算在内。八个全占满时,App 会告诉您,而不是覆盖任何内容。如果灯自己的定时器已经占满了全部位置,提示以“这盏灯已没有空间保存每日定时计划”(iOS)或“这盏灯已没有空间保存定时计划”(Android)开头。
- 需要处理 加上“缺少关灯时间”(或“缺少开灯时间”)表示配对中的一半在别处被删了。打开它点按 保存 修复,或者删除它。
- “灯上的关灯定时已暂停”表示有一半在别处被关掉了。这一行的开关会把两半重新设置。
- 如果在您编辑期间另一部手机或网页改动了灯,会出现“灯的定时计划已更改。请下拉刷新后重试。”
- 把“WLED Max Schedule On”或“WLED Max Schedule Off”预设改名,它就归您了。这些定时器会移到“这盏灯上的其他定时计划”,App 不会再删除它们。
- 灯离线时,您看到的是 App 上次读到的列表,锁定不可编辑,并提示重新连接。
有一个前提:灯必须知道现在的时间。如果它的时钟没有设置,“定时计划”标签顶部的横幅会提供 设置时间同步 按钮。它会打开 时间与宏(也在“设备设置”下);开启 自动同步时间(NTP),检查时区,再回来。在此之前,保存的计划会留在灯上,但无法触发。

定时器没触发,或者渐变不对
它一下子就关了,没有渐变。 模式是 Instant。在 Config > LED & Hardware(0.14 和 0.15 上是 LED Preferences)的 nightlight 部分修改,或者在 App 里选“渐变”。
每日计划没有触发。 灯不知道时间。打开“定时计划和定时器”,切到“定时计划”标签,看有没有时钟横幅;有的话点按“设置时间同步”,开启“自动同步时间(NTP)”。灯还需要能上网的 Wi-Fi 来获取时间,并且在计划的那一分钟必须有电。一盏在 18:00 被拔掉电源的灯会一直关着,直到第二天的 18:00。
计划早了或晚了一小时。 灯的时区不对,或者夏令时切换了。在“时间与宏”下检查 时区。
时间不对。 检查灯上 Config > Time & Macros 里的时区和 NTP,尤其是在夏令时切换之后。
需要超过 4 小时 15 分钟? 255 分钟是固件上限。更长的间隔请用每日定时计划,或者让设备定时器在固定时间运行一个“关闭”预设。
选对工具
想开着灯入睡,夜灯就是为此设计的,不需要别的东西。想明早在缓慢的日出中醒来,就用一个加载 Sunrise 预设的每日定时计划,或者一个运行该预设的 WLED 定时器。两者都在灯上,设置一次就不用管了。日出和日落触发以及季节性日期范围在“设备设置 > 定时计划”(网页界面中的 Time & Macros)。如果您希望颜色整天跟着太阳走,那是昼夜节律照明,是另一种设置。
还有一个方便的东西:iOS 和 Android 上的 WLED 小组件,让灯在主屏幕上一点即达。