WLED｜让桌面灯带跟着音乐跳动

免焊套件，手机调色，节拍互动

使用开源WLED与dig2go原厂完整套件，做4m、240灯的桌面音乐灯。含8步图解、5项套件物料明细及原版采购入口；预计¥350–550，税运另计，材料到齐后计划1–3小时。手机自备，不需额外麦克风。图文为资料整理，未作本站实机测试。

alan000

参数信息

灯带配置

240 颗

复现文档

开箱数清五件，不另买麦克风


采购选择4m RGB strip kit完整套件，核对控制器、4m WS2812B灯带、灯带短线、5V/3A电源与USB线。麦克风、外壳和保护电路已在控制器内。仅买Controller会缺电源和灯带；不能把12V/24V灯带接入这套5V设备。手机为已有工具。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

断电接灯带，认准DIN和箭头


先把电源拔掉，把4m灯带充分展开平放，暂不粘贴。用原配短线接控制器与灯带输入端，核对5V、DATA、GND对应，不靠线色猜。灯带箭头应从控制器指向灯带后端。图中是通用方向示意，不是本套件板卡；不要照图另购ESP8266或裸接引脚。最后接USB线与5V电源，确认状态灯稳定。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

手机连接WLED，不需要云账号



手机连接WLED-AP（部分预装名为QuinLED-AP），初始密码wled1234；浏览器打开<http://4.3.2.1。若手机提示此网络无互联网，保持连接。先选择单色确认灯带受控；若已有联网配置，使用路由器中该设备的地址。需要日常联网时再进入Config→WiFi> Setup填自家2.4GHz网络并保存；修改默认AP密码。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

设置240颗灯，先低亮度验收


在Config→LED Preferences中核对WS2812B类RGB灯带、Length 240、数据GPIO16；本控制器LED供电开关GPIO12。正常原厂预配置不必更改引脚。保留自动电流限制，初次仍用1250mA保守上限，亮度先约20%。这不是240灯全白满亮方案，不用软件关闭限流追求亮度。截图只示意字段，数字以本步骤为准。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

先玩颜色，再保存第一个效果



分别选红、绿、蓝，确认颜色正确；若红绿颠倒，在LED Preferences调整颜色顺序（常见GRB），直到实测对应。打开Effects，选一个彩色流动效果，调整速度与亮度。效果稳定后存入Preset，命名“桌面彩虹”。此时可先拍下成品短片。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

打开板载麦克风，让灯跟着节拍动


Config→Usermods→AudioReactive勾选Enabled，保存后断电重启。选择音频响应效果Gravimeter等，在附近播放音乐。若麦克风配置被覆盖，按dig2go原厂引脚核对I2S SD=19、WS=4、SCK=18；不要照其他板卡截图抄GPIO。仍没有AudioReactive页面时，先记录当前版本，再使用原厂dig2go专用恢复安装器。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

安静时停住，音乐起时亮起来


先在安静环境逐步调高Squelch，直到环境底噪不再驱动灯光，再播放正常音量音乐调Gain，必要时使用Normal AGC。不要把灵敏度拉满当作效果更好。保存第二个Preset“音乐灯”。灯带重启、闪烁或末端偏色时降低亮度并检查原配供电、接头和连接线。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。

固定摆放，拍一段可对比的视频


基础验收：五件齐全、240颗地址长度正确、三原色对应、无持续重启；静音与播放音乐各拍10秒，展示两种状态。再导出配置与预设，记录固件版本。基础方案为干燥桌面平放，不需要胶、支架或扩展供电；永久装墙、户外安装与延长灯带属于另一个BOM，不在此路线内。灯带不要卷着通电，也不要盖住散热。

[WLED官方指南](https://kno.wled.ge/basics/getting-started/) · [本套件操作与排错](https://dig2go.info/faq.html) · [文档MIT许可](https://github.com/wled/WLED-Docs/blob/main/LICENSE)

截图和方向示意：WLED-Docs，Copyright (c) 2021 Christian Schwinne，MIT；中文改写与选用路线由本页整理。截图可能来自不同版本，仅对照界面位置，不照抄示例板型和GPIO。未作本站实机测试。