ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

ESP8266_ArtNetNode_v2 端口模式详解:DMX 输出、DMX 输入、RDM 与 WS2812 如何配置?

2026/8/19 20:11:58 拓冰建站 浏览量
ESP8266_ArtNetNode_v2 端口模式详解:DMX 输出、DMX 输入、RDM 与 WS2812 如何配置? ESP8266_ArtNetNode_v2 端口模式详解DMX 输出、DMX 输入、RDM 与 WS2812 如何配置【免费下载链接】ESP8266_ArtNetNode_v2ESP8266 based WiFi ArtNet to DMX, RDM and LED Pixels项目地址: https://gitcode.com/gh_mirrors/es/ESP8266_ArtNetNode_v2ESP8266_ArtNetNode_v2 是一款基于 ESP8266 的开源 WiFi 灯光节点固件核心功能是把网络上的 ArtNet / sACN 数据包转换成舞台灯光领域通用的DMX512、RDM 与 WS2812 像素灯带信号。对新手来说最容易卡住的就是 Web 配置页面里 Port A / Port B 的端口模式选项DMX 输出、DMX 输入、RDM 与 WS2812 到底有什么区别分别该怎么配置这篇文章带你一次看懂四种端口模式的区别、适用场景与完整的配置步骤照着做就能让你的灯光节点正常跑起来。一图看懂四种端口模式与适用场景在动手配置之前先花 30 秒搞清楚四种端口模式分别是什么、干什么用端口模式数据方向典型用途DMX 输出输出把 ArtNet 变成 DMX512 信号驱动调光器、摇头灯等传统舞台设备DMX 输出带 RDM双向输出 DMX 的同时支持 RDM 远程设备管理与参数读取DMX 输入输入把现场控台的 DMX 信号转成 ArtNet发给网络上的其他设备LED 像素WS2812输出驱动 WS2812 / WS2812B 像素灯带做像素映射或动态特效上图是官方推荐的DMX 像素双端口方案一个端口接 MAX485 输出 DMX/RDM另一个端口通过转换电路驱动 WS2812 灯带一台设备就能同时覆盖传统灯具和像素灯带两种场景。DMX 输出如何配置从 ArtNet 到舞台灯的最短路径DMX 输出是最基础、也是默认启用的端口模式固件出厂默认 Port A、Port B 均为 DMX 输出。配置步骤非常简单连接设备 Web 界面首次上电连接名为espArtNetNode的热点浏览器访问2.0.0.1。进入Port A Settings或 Port B Settings。在Port Type下拉框中选择DMX Output。设置ProtocolArtnet v4 或 Artnet v4 sACN、Net / Subnet / Universe地址。点击Save Changes保存并重启设备。这里需要重点理解Net / Subnet / Universe三个地址它们共同组成 ArtNet 的门牌号必须和你电脑上灯光软件如 Madrix、QLC、DMX Workshop里的输出地址完全一致数据才能到达节点。每个 DMX 端口占用一个完整的 512 通道 universe所以一个端口可以驱动最多 512 个 DMX 通道的灯具。小提示Merge Mode提供 LTP后到优先和 HTP高值优先两种合并方式只有当你用两台电脑同时向节点发送数据时才需要关心单机使用保持默认即可。RDM 模式如何配置给 DMX 线加上双向对讲RDMRemote Device Management是 DMX512 的扩展协议它让灯光师在控台端就能远程查询灯具型号、DMX 地址甚至修改参数不用再爬灯架手动设置地址码。启用 RDM 只需一步在端口设置页将Port Type选为DMX Output with RDM。保持 Net / Subnet / Universe 配置不变保存重启即可。固件对两个端口都提供了完整的 RDM 支持含 TOD 设备列表管理与发现流程对应代码中的rdmHandle、sendTodA/B等回调。硬件上需要选用支持 RDM 的双向 RS-485 收发器并接好方向控制脚DIR_A 默认 GPIO5、DIR_B 默认 GPIO16。上图是项目的隔离版完整原理图esp_Artnet_RDM_isolated_v2它通过光耦实现了电气隔离并用 APA106 灯珠做状态指示适合对稳定性要求更高的演出场景。DMX 输入如何配置把现场控台接入 ArtNet 网络DMX 输入模式有点反向它读取实体控台通过 DMX 线送来的 512 通道数据再打包成 ArtNet 数据包通过 UDP 广播发送给网络上的任意目标设备。配置方法端口类型选择DMX Input仅Port A支持。在出现的Broadcast Address一栏填写目标接收设备的 IP 广播地址。保存重启后把控台的 DMX 输出接到节点的 RX 引脚即可。配置好后控台推子的每一路变化都会实时转成 ArtNet 数据实现传统控台 网络化灯具的混合系统这是很多旧控台升级为网络控制时的经典玩法。WS2812 像素灯带如何配置Pixel Mapping 与 12 通道 FX把端口类型选为LED Pixels - WS2812后端口就会从 DMX 模式切换为像素驱动模式硬件上需要把信号线从 MAX485 的输出端改接到灯带数据脚官方提供了专门的转换小板。像素模式有两个子模式新手最容易在这里混淆1. Pixel Mapping像素映射模式每个像素占用 3 个 DMX 通道R/G/B每 170 个像素占满一个 universe。单个端口最多支持680 个像素4 个 universe两个端口加起来就是 1360 个像素、8 个完整 universe。这是做点对点像素灯带、LED 矩阵的推荐模式配合 Madrix 等软件可以直接把画面映射到灯带上。2. 12 Channel FX12 通道特效模式只用 12 个 DMX 通道就能控制整条灯带适合不想做复杂像素映射、只想快速出效果的用户DMX 通道功能1亮度 Intensity2特效选择静态 / 彩虹 / 剧院追逐 / 闪烁3特效速度4位置5尺寸6-8颜色 1R/G/B9-11颜色 2R/G/B12修改参数选择 12 通道 FX 后记得设置Start Channel起始通道它决定这 12 个通道从你 DMX 地址的哪个位置开始生效。特效的完整通道定义可以在README.md的 Pixel FX 章节查到。如果你完全不需要 DMX可以直接采用上图的纯像素版方案node_pix_only_v2省掉 MAX485 芯片板子更简单。注意固件里的 DMX 选项依然存在配置端口模式时不要误选否则灯带可能表现异常。端口 A 与端口 B 的区别这三个限制必须知道两个端口功能看起来一样但固件里有几个隐藏规则配置前务必了解只有 Port A 支持 DMX 输入。Port B 的下拉框里不会出现 DMX Input 选项。RDM 和 DMX 输入不能同时共存。如果 Port A 设为 DMX 输入、Port B 设为 RDM 输出固件会自动把 Port B 强制降级为普通 DMX 输出见 espArtnetNode_2.0.0_b5g.ino 中 setup 逻辑。ESP01 模块只有单端口。ESP01 版固件禁用第二路输出并把 DIR_A 移到 GPIO2选固件时要注意区分标准版、ESP01、NO_RESET、WEMOS 四种 .bin 文件。端口模式的代码实现想深入研究的看这里端口模式的类型定义集中在 store.h 的枚举中TYPE_DMX_OUT、TYPE_RDM_OUT、TYPE_DMX_IN、TYPE_WS2812端口初始化逻辑在 startFunctions.ino 的portSetup()函数里Web 界面保存/加载端口参数则位于 ajax.ino。像素特效引擎在 wsFX.h 和 wsFX.cpp 中实现。常见问题 FAQQ切换端口模式后灯带没反应怎么办A切换 WS2812 模式后必须重启设备保存设置后 Web 界面会提示重启。另外确认 DMX 地址Net/Subnet/Universe和软件端完全一致。Q选了 RDM 模式但控台搜不到设备A确认使用双向 RS-485 收发器且方向控制脚接线正确同时检查是否与另一端的 DMX 输入模式冲突。Q像素灯带超过 170 个怎么分配地址A固件会自动按每 170 像素一个 universe 的方式扩展端口在 Web 界面的 Universe 一栏依次填写 4 个连续地址即可。QDMX 输入可以同时用在两个端口吗A不能整台设备只允许 1 个 DMX 输入端口且仅 Port A 支持。掌握这四种端口模式的配置方法后无论是传统舞台灯、带 RDM 的智能灯具还是炫酷的 WS2812 像素灯带你都能用这一台 ESP8266 节点轻松驾驭。快去你的 Web 配置页面试一试吧【免费下载链接】ESP8266_ArtNetNode_v2ESP8266 based WiFi ArtNet to DMX, RDM and LED Pixels项目地址: https://gitcode.com/gh_mirrors/es/ESP8266_ArtNetNode_v2创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考