如何向同网络内的LANBOX LCX发送UDP/Art-Net命令？

前置验证步骤 #

• 确认LANBOX LCX与控制电脑处于同一局域网，且设备已开启Art-Net接收功能（查阅设备手册的网络配置章节，找到Art-Net输入选项并启用）。
• 核对DMX线路：确保灯泡的DMX地址设置正确，LANBOX的DMX输出端口与灯泡的DMX输入端口连接无误。

用pyartnet快速实现控制（新手首选） #

pyartnet是封装好的Art-Net库，操作简单，步骤如下：

1. 安装库：

   pip install pyartnet
   

2. 基础控制代码（替换为你的LANBOX IP、目标DMX通道和亮度值）：

   import pyartnet
   import time
   
   # 初始化Art-Net节点，填入LANBOX的IP地址
   node = pyartnet.ArtNetNode("你的LANBOX_IP")
   
   # 添加DMX universe（LANBOX默认接收universe 0，可通过设备配置确认）
   universe = node.add_universe(0)
   
   # 指定要控制的DMX起始通道（比如通道1对应单灯泡亮度）
   light_channel = universe.add_channel(start=1, width=1)
   
   # 点亮灯泡（亮度值范围0-255，0为熄灭，255为最亮）
   light_channel.set_value(255)
   time.sleep(5)
   
   # 调暗灯泡（设置亮度为100）
   light_channel.set_value(100)
   time.sleep(10)
   

3. 注意：若LANBOX使用非默认universe编号，需修改add_universe的参数，可通过LANBOX的web控制台查看Art-Net接收配置。

手动构造UDP数据包（进阶方案） #

需严格遵循Art-Net协议格式构造数据包，示例代码如下：

import socket

# 目标设备信息
target_ip = "你的LANBOX_IP"
target_port = 6454  # Art-Net默认端口

# 构造Art-Net数据包
header = b'Art-Net\x00'
op_code = b'\x00\x50'  # OpOutput（发送DMX数据的操作码）
protocol_ver = b'\x00\x0e'  # Art-Net协议版本14
sequence = b'\x00'  # 序列码，可设为0
physical_port = b'\x00'
universe = b'\x00\x00'  # Universe编号
dmx_len = b'\x02\x00'  # DMX数据固定为512字节
dmx_data = b'\xff' + b'\x00'*511  # 通道1设为255，其余通道置0

packet = header + op_code + protocol_ver + sequence + physical_port + universe + dmx_len + dmx_data

# 发送UDP包
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
sock.sendto(packet, (target_ip, target_port))
sock.close()

排障关键要点 #

• 用Wireshark抓包确认UDP数据包是否成功发送到LANBOX，检查包结构是否符合Art-Net规范。
• 检查LANBOX的Art-Net权限设置：是否允许接收来自控制电脑IP的数据包，是否正确映射universe到DMX输出端口。
• 核对灯泡的DMX地址：多灯泡场景下，需确保代码中设置的通道与灯泡的起始DMX地址对应。

内容的提问来源于stack exchange，提问作者Ramees Shahzad