LuxDMX 开源舞台灯光网络信号网关

LuxDMX 是一款基于 ESP32 系列主控开发的开源 NetDMX 灯光网关，实现以太网 / Wi-Fi 网络灯光协议与传统 DMX512 硬件总线信号互相转换。项目完整开源硬件原理图、PCB 工程、固件源码、配套 Web 管理系统，面向舞台灯光、商业景观照明领域。

LuxDMX 开源舞台灯光网络信号网关封面
oshw_hqzl2026-07-29 18:08:00MIT
103
Star1

PCBA

设计文件

KiCad图标hardware.zip13.82MB（8次下载）

其他附件

EDA查看器

复制嵌入代码

详细介绍

一、项目概述

LuxDMX 是一款基于 ESP32 系列主控开发的开源 NetDMX 灯光网关，实现以太网 / Wi-Fi 网络灯光协议与传统 DMX512 硬件总线信号互相转换。项目完整开源硬件原理图、PCB 工程、固件源码、配套 Web 管理系统，面向舞台灯光、商业景观照明领域，用于将上位机灯光控制软件输出的 ArtNet /sACN（E1.31）网络数据流，转换为标准 RS485 差分 DMX512 信号，驱动帕灯、摇头灯、LED 灯带等 DMX 受控灯具。

项目原生支持 WT32-ETH01（以太网 ESP32 模块）、ESP32-WROOM、ESP32-S3 等硬件平台，同时支持有线以太网、Wi-Fi 双模网络接入，具备网页可视化管理、在线 OTA 升级、总线状态诊断、通道测试等功能，可替代商业 EtherDMX/ArtNet 节点，大幅降低分布式灯光控制系统硬件成本。

二、核心技术背景

传统 DMX512 采用有线串行总线，传输距离受限、布线繁琐，大型灯光系统布线成本极高；ArtNet、sACN 作为主流灯光网络协议，通过标准局域网传输控制信号，支持远距离传输、分布式节点部署。二者协议载体互不兼容，因此需要网关设备完成协议解析与信号转换。

  • ArtNet：行业普及最广的灯光 UDP 网络协议；

  • sACN(E1.31)：ANSI 标准化新一代灯光网络传输协议；

  • DMX512-A：舞台灯光通用硬件控制总线标准，基于 RS485 差分电平。

LuxDMX 在嵌入式 ESP32 平台上完成网络数据包接收、通道数据重组、时序封装，最终输出符合标准时序的 DMX 差分信号。

三、硬件方案

1. 主控选型

优先推荐 WT32-ETH01（ESP32 + 内置 LAN8720 以太网 PHY），自带 RJ45 网口，实现稳定有线网络；也可适配纯 Wi-Fi 版本 ESP32 模组、ESP32-S3 开发板搭配 W5500 以太网扩展模块。

2. 信号链路

ESP32 串口 → MAX485 收发芯片 → XLR3/XLR5 DMX 输出接口

  • MAX485 实现 TTL 电平与 RS485 差分电平隔离转换，保障长线传输抗干扰；

  • 预留 120Ω 终端电阻焊盘，匹配 DMX 总线阻抗规范；

  • 硬件增加电源滤波、静电防护器件，适配剧场、酒吧等复杂电磁环境。

3. 硬件物料清单核心构成

ESP32 主控模块、MAX485 收发器、XLR 灯光插座、稳压电源、LED 状态指示灯、拨码 / 可选配置按键。

4. 硬件优势

  • 模块化设计，PCB 小型化，便于集成进配电箱、灯具设备内部；

  • 有线以太网优先，Wi-Fi 作为备用链路，兼顾稳定性与部署灵活性；

  • 开源硬件，用户可按需修改层数、尺寸、增加多路 DMX 输出通道。

四、固件软件功能

1. 协议处理核心

✅ 同时兼容 ArtNet 协议、sACN（E1.31）协议接收

✅ 支持自定义 DMX 域（Universe）映射，灵活绑定网络流与硬件输出

✅ 支持多数据流冲突检测，自动告警多路控制台抢占同一通道

2. 内置 Web 管理控制台

无需额外上位软件，电脑 / 手机浏览器访问网关 IP 即可操作：

  • DMX 512 通道数值实时可视化监控；

  • 手动通道推拉测试，直接调试灯具；

  • 网络参数配置（静态 IP/DHCP、Wi-Fi 配网）；

  • 协议优先级、Universe 编号、输出时序参数设置；

  • 数据包帧率、丢包统计、总线运行日志；

  • 网关设备名称、工作模式自定义。

3. 运维功能

  • OTA 远程固件升级，无需反复拆卸硬件烧录；

  • WebSocket 实时状态推送，可对接第三方监控系统；

  • 硬件状态指示灯：网络连接、DMX 数据流运行状态指示。

4. 软件开发环境

基于 ESP-IDF 官方物联网开发框架开发，C 语言编写固件；Web 前端页面嵌入固件，支持按需自定义界面样式。

五、典型应用场景

  1. 小型舞台 / 演出灯光系统：搭配 QLC+、Chamsys 等灯光控台软件，实现电脑网络控制灯具；

  2. 酒吧、餐吧固定景观灯光系统：分布式部署多台网关，远距离布线；

  3. 展会、装置艺术灯光项目：低成本分布式灯光控制节点；

  4. 校园、工作室灯光实训平台：开源方案适合灯光相关教学、二次开发学习。

六、项目核心优势

  1. 完全开源：硬件 PCB 工程、固件源码、WebUI 全部开放，支持商用二次修改；

  2. 高性价比：硬件物料成本远低于商业品牌 ArtNet 网关；

  3. 双网络备份 有线以太网 + Wi-Fi 双模，满足不同现场布线条件；

  4. 完善调试工具：内置诊断页面，方便现场排查网络、灯具通讯故障；

  5. 跨平台兼容：主流灯光软件均可识别，协议标准无设备锁。

七、拓展开发方向（可选拓展内容）

  • 扩展双路独立 DMX512 输出；

  • 增加 DMX 输入功能（DMX 转网络信号双向网关）；

  • 增加本地离线动画预设，断网状态下自动运行灯光效果；

  • 接入 MQTT 物联网协议，实现楼宇中控系统联动灯光。

八、License

MIT License

九、项目地址

https://github.com/tombueng/LuxDMX