Repolode
提交项目
wled

wled/WLED

基于 ESP32 的开源固件，可通过 WiFi 控制可寻址 RGB LED 灯带、2D 矩阵和 HUB75 面板。

可替代:Philips Hue

在 GitHub 查看官网
Star
18,904
Fork
4,418
未关闭 Issue
514
最近提交
22小时前

这是什么？

WLED 是运行在 ESP32 微控制器上的固件，用于驱动 WS2812B 等多种数字可寻址 RGB LED。设备运行后可通过网页界面、手机 App 或外部系统经 WiFi 控制灯光。

固件内置 200 多种效果，其中不少支持音频响应，并提供 50 多种调色板和调色板编辑器。分段功能可让同一套灯光的不同部分同时运行不同效果；预设和播放列表则用于保存并循环切换配置。它还支持带面板映射的 2D 矩阵、ESP32 上的 HUB75 RGB 矩阵面板，以及 RGBW、RGB+CCT 和纯白灯带。

在集成方面，WLED 支持 MQTT 与 Home Assistant、Alexa 语音控制和 Philips Hue 同步，并兼容 E1.31、Art-Net、DDP 等 DMX 类协议。此外还提供 JSON 和 HTTP API、设备间 UDP 同步、ESP-NOW 无路由器同步，以及用于扩展功能的 usermod 模块系统。

核心功能

  • 01内置 200 多种效果，包括音频响应和 2D 矩阵效果
  • 02分段功能可在同一套灯光的不同部分运行不同效果和调色板
  • 03支持 WS2812B、SK6812、APA102 等多种可寻址 LED 芯片
  • 04支持 2D 矩阵和 HUB75 RGB 面板，并可灵活映射
  • 05支持 MQTT 与 Home Assistant 自动发现，以及 E1.31、Art-Net、DDP 等 DMX 控制协议
  • 06提供 JSON 和 HTTP API，并可通过 usermod 扩展功能

适用场景

  • 为房间、电视或书桌搭建可通过手机或 Home Assistant 控制的氛围灯
  • 制作音频响应式 LED 装置或音乐同步灯光
  • 用 ESP32 驱动大型 LED 矩阵招牌或 HUB75 面板
  • 将可寻址灯光接入舞台或专业 DMX 灯光系统

快速上手

  1. 1

    在 kno.wled.ge 阅读快速入门指南和文档

  2. 2

    按照 wiki 教程将固件刷入 ESP32 开发板

  3. 3

    使用 Android 或 iOS 版 WLED 应用连接设备

使用前须知

  • 仅面向 ESP32 微控制器，运行需要兼容的硬件。
  • 采用 EUPL v1.2 许可证，这是一种 copyleft 许可证，衍生作品须保持开源。
  • README 提醒光敏性癫痫患者不建议使用。

收录于专题

嵌入式开发与单片机工具

标签

#esp32#led#wifi#iot#home-automation#firmware#microcontroller#home-assistant#esp8266#hacktoberfest

常见问题

WLED 是什么？
基于 ESP32 的开源固件，可通过 WiFi 控制可寻址 RGB LED 灯带、2D 矩阵和 HUB75 面板。 WLED 是运行在 ESP32 微控制器上的固件，用于驱动 WS2812B 等多种数字可寻址 RGB LED。设备运行后可通过网页界面、手机 App 或外部系统经 WiFi 控制灯光。
WLED 可以免费使用吗？用的什么许可证？
WLED 以 EUPL-1.2 许可证开源。用于商业产品前，请先确认许可证条款。
WLED 还在维护吗？
活跃维护中。WLED 最近一次提交是在 2026年10月23日。
WLED 适合用来做什么？
为房间、电视或书桌搭建可通过手机或 Home Assistant 控制的氛围灯 制作音频响应式 LED 装置或音乐同步灯光 用 ESP32 驱动大型 LED 矩阵招牌或 HUB75 面板 将可寻址灯光接入舞台或专业 DMX 灯光系统
WLED 怎么安装和运行？
在 kno.wled.ge 阅读快速入门指南和文档 按照 wiki 教程将固件刷入 ESP32 开发板 使用 Android 或 iOS 版 WLED 应用连接设备
在哪里获取 WLED？
源代码和安装说明在 GitHub 上：https://github.com/wled/WLED

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目