Light Stream Converter 设置
转换器（Converter）是一种设备，它从电脑接收网络信号，并通过自己的端口分发给灯具。要让它在现场工作，需要对其进行配置：设置网络地址、端口模式、像素芯片类型和 Universe 编号。这一切都可以直接在 Light Stream 中通过网络完成，无需任何单独的工具。
本文介绍的是对物理设备本身的配置。转换器在项目内部的参数（向哪个地址、用哪种协议发送数据，项目中描述了多少端口和 Universe）是另一个窗口，见文章 Light Stream Converter 参数。设备设置与项目设置必须一致：如果两者不一致，程序会照常发送数据，但灯具不会亮。
配置通过网络广播请求进行。电脑和转换器必须连接到同一网络，且电脑的网卡必须与设备处于同一子网。
在网络中查找设备
一切从Art-Net Node Discovery（搜索 Art-Net 节点）窗口开始。可以通过两种方式打开它：
- 在Fixtures（固定装置）窗口中——底部面板上带放大镜图标的Search（搜索）按钮，位于Add Device（添加设备）按钮旁边；
- 在程序设置的Network（网络）部分——Search（搜索）按钮（见 设置）。
操作步骤：
- 在Network Device（网络设备）列表中选择转换器所连接的网卡。所选内容会被记住，并在下次打开窗口时自动带出。
- 点击Search。轮询网络期间，按钮下方会显示进度指示；搜索大约需要几秒钟。
- 找到的设备会出现在左侧列表中：设备的IP和Name（名称）。
- 选中某一行——右侧会显示所选设备的信息：完整名称和简称、IP 地址、设备报告（Node report）、固件版本、ESTA 和 OEM 代码、MAC 地址。设备报告显示端口当前的工作模式以及选择的芯片。
设备报告大致如下：#0001[0035] UCS1903(High,340)Tb=125,T0=30,T1=100,Tr=290。其中 UCS1903 是所选芯片，340 是端口模式（每端口 340 个像素）。
有用的提示：
- 搜索期间程序会停止发送 Art-Net，搜索结束后自动恢复。如果现场的灯在配置过程中熄灭，这是正常的，之后会恢复。
- Ping按钮会让选中的设备做出响应：真实的转换器会闪烁指示灯。这样便于分辨配电箱里哪一个盒子对应找到的 IP。该按钮仅对 Light Stream 设备有效。
- Settings（设置）按钮会打开所选设备的设置窗口。只有当列表中恰好选中一台 Light Stream 设备时才可用：其他厂商的设备以及Light Stream Player在这里没有设置项。
- 如果列表为空，请检查是否选择了正确的网卡，以及它是否与转换器处于同一子网。
将找到的设备添加到项目中
Add Selected Nodes（添加选中节点）按钮会将勾选的设备连同其真实设置一起添加到项目中。可以同时选中多行。
- 找到的Light Stream Player会作为播放器添加到项目中，并带上它的 IP 地址。
- 找到的转换器会作为转换器添加：带有设备的名称和 IP 地址、其起始 Universe，以及设备实际拥有的端口数量。如果端口工作在 1024 通道模式下，程序会将其计为每端口两个 Universe。
这是在项目中描述已配置好的设备最快的方法：无需手动核对地址和 Universe。添加之后，剩下的工作就是把灯具分配（patch）到端口上——见 固定装置的地址分配。
添加操作可以像项目中的任何其他操作一样，通过 Ctrl+Z 撤销。
"Controller Settings（控制器设置）"窗口
该窗口通过搜索窗口中的Settings按钮打开，分为四个部分：
- Main Settings（主要设置）——网络地址、设备名称、端口模式和芯片；
- Ports（端口）——按端口列出 Universe 的表格；
- Information（信息）——设备当前报告的自身状态；
- Send Art-Net Macro（发送 Art-Net 宏命令）——用于技术支持指令的服务字段。
所有更改只有在点击相应的Set（设置）按钮后才会发送到设备。仅仅在字段中输入数值是不够的。
每次写入成功后，程序会将设备标记为已更改，当你关闭窗口时，网络搜索会自动重新进行——已找到设备的列表会随之更新。
IP Address（IP 地址）与 Mask（子网掩码）
- 输入所需的IP Address和Mask。
- 点击Set IP（设置 IP）。
- 在Change IP?（更改 IP？）窗口中确认操作。
- 成功后会出现消息IP set successfully（IP 设置成功）。
旁边有一个Ping按钮——作用与搜索窗口中的相同：让设备闪烁指示灯。用它可以方便地确认你正在编辑的确实是想要的那台转换器。
更改设备地址后，务必在项目中为该转换器设置相同的地址——在Properties（属性）窗口的IP Address字段中（见 Light Stream Converter 参数）。否则程序会继续向旧地址发送数据。
如果电脑和转换器最终处于不同的子网，设备可能在更改地址后从搜索结果中消失——请将电脑网卡调整到新的子网，然后重新搜索。
Device Name（设备名称）
Full Name（完整名称）字段和旁边的Set按钮会把设备名称写入转换器。该名称会显示在已找到设备的列表和 Art-Net 报告中，因此有意义的名称（例如“北立面”“屋顶”）会让在有十几个相同盒子的现场工作轻松得多。
Port Mode（端口模式）与 Chip（芯片）
Port Mode列表用于设置设备端口的工作方式：
| 取值 | 含义 |
|---|---|
| DMX 512 | 普通 DMX：512 通道，每端口一个 Universe |
| DMX 1024HS | 通道数加倍的 DMX：1024 通道，每端口两个 Universe |
| SPI 170 Pix | 像素模式，每端口最多 170 个像素 |
| SPI 340 Pix | 像素模式，每端口最多 340 个像素 |
| SPI 680 Pix | 像素模式，每端口最多 680 个像素 |
Chip列表仅在SPI模式下出现——DMX 端口没有芯片选项。用于选择 LED 灯带或像素模块所使用的驱动芯片型号：GS8206、WS2811、WS2811L、WS2812、WS2814、WS2818、SK6812、UCS1903、UCS8903、TM1803、TM1914。该数值必须与所连接线路上实际安装的芯片一致，否则像素会杂乱闪烁、显示错误颜色，或者根本不亮。
程序仅在像素模式下，通过设备报告来判断这两个列表的当前取值。如果转换器工作在 DMX 模式下，Port Mode字段可能显示为空——这不是错误，只需自行选择所需的值即可。
要应用模式和芯片，请点击Port Mode列表右侧的Set按钮——它会一次性发送两项设置。设备不会立即完成重新配置：光标会变成“沙漏”状态持续十几秒，之后程序会重新读取转换器的状态，并在Information中显示新的报告。请等待其完成，不要关闭窗口。
模式和芯片是针对整台设备、其所有端口一次性设置的。
单个端口的模式
单个端口的模式在Ports表格中指定：右键点击端口所在行，会打开包含DMX IN、DMX OUT、RDM和SPI选项的菜单。选择后，程序会提示Port mode set successfully（端口模式设置成功），并刷新设备数据。
- DMX IN —— 该端口接收来自外部调光台的 DMX 信号。
- DMX OUT —— 该端口向灯具输出 DMX 信号。
- RDM —— 该端口通过 RDM 协议进行带反馈的通信。
- SPI —— 该端口驱动一条像素线路。
例如，可以方便地将一个端口保留为接收外部 DMX，其余端口用作输出。
端口的 Universe
Ports表格显示设备上各端口所分配的 Universe。
| 列 | 显示内容 |
|---|---|
| Short Name（简称） | 设备报告的端口名称。如果一个端口占用两个 Universe，会有两行同名的记录 |
| Universe | 总体 Universe 编号，范围 0 到 32767。这是你在项目中与端口 Universe 进行比对的数值 |
| Net / Subnet / Univ. | 同一个编号按 Art-Net 标准拆分成三部分：Net（0–127）、Sub（0–15）和Universe（0–15） |
两种表示方式是关联的：修改总体编号，三个字段会自动重新计算，反之亦然。总体编号的计算方式为 Net × 256 + Sub × 16 + Universe。按你觉得方便的方式设置编号即可。
Net和Subnet是同一端口共用的。如果某端口分配了两个 Universe，在其中一行修改这两个字段也会同步修改另一行——这两行只在最后一个字段Universe上有区别。
表格下方的按钮：
- Select All（全选） —— 选中所有行。
- Edit Selected（编辑所选） —— 询问Starting Universe（起始 Universe），并从该值开始依次为所选行编号。这是按顺序排列 Universe 最快的方法。
- Set —— 将更改写入设备。写入期间 Art-Net 的发送会暂停。完成后，程序会重新读取设备并核对结果：如果全部写入成功，会显示Saved successfully（保存成功）；否则显示Save error（保存出错）。
写入设备的 Universe 必须与项目中转换器的端口 Universe 一致。在项目中它们不是逐个设置的：你只需指定Starting Universe和Universes per Port（每端口 Universe 数），其余按顺序自动计算。最简单的方法是用Edit Selected按钮把设备的 Universe 依次编号，并在项目中设置相同的起始 Universe。
Information（信息）
Information部分显示设备当前报告的自身状态：Full Name、Short Name、IP Address、MAC、Status（状态，即设备报告）、固件Version（版本）、ESTA和OEM代码。这些字段为只读，每次程序重新读取设备时都会更新——即在写入名称、端口模式、芯片或 Universe 之后。通过它们可以方便地确认更改是否真正生效。
服务性元素
Send Art-Net Macro部分中的Data（数据）字段和Send Macro（发送宏）按钮用于向设备发送服务指令。仅在技术支持的指示下使用它们。该窗口中的Reset Settings（重置设置）按钮处于不可用状态。
配置新转换器的步骤
- 将转换器接入网络，并为电脑设置同一子网内的地址。
- 打开Art-Net Node Discovery，选择网卡，点击Search。
- 在列表中找到所需设备，用Ping按钮确认响应的正是它。
- 点击Settings，为设备设置工作用的IP Address和Mask。
- 设置一个便于识别该设备的Full Name。
- 选择Port Mode，对于SPI模式还要选择Chip。点击Set并等待设备完成重新配置。
- 在Ports表格中为 Universe 编号，然后点击Set。
- 关闭设置窗口——程序会自动重新进行搜索——然后用Add Selected Nodes按钮把设备添加到项目中。
- 核对项目中转换器的参数：IP Address、Starting Universe、Number of Ports（端口数量）、Universes per Port和Controller Type（控制器类型）（像素线路选SPI）。
- 将灯具分配（patch）到端口上，并启用Art-Net。
如果出现问题
搜索什么都找不到。 检查所选的网卡、物理连接，以及电脑地址是否与转换器处于同一子网。部分网络交换机和 Wi-Fi 适配器不会转发广播请求——请改用有线连接。
更改 IP 后设备消失了。 新地址落在了不同的子网中。将电脑网卡的地址调整到新子网，然后重新搜索。
写入 Universe 时出现 Save error。 设备没有确认更改。请重试写入；如果错误依旧出现，请用Ping按钮检查与设备的连接，并确认写入期间没有其他人在访问该转换器。
"Ping"和"Settings"按钮不可用。 列表中选中了不止一台设备，或所选设备来自其他厂商，或是Light Stream Player。此窗口中的设置仅对 Light Stream 转换器可用。
模式和芯片没有生效。 设备需要时间完成重新配置——最长可达几十秒。在等待光标消失之前不要关闭窗口，并对照Information部分的报告进行核对。
现场没有出现灯光。 请核对设备设置与项目中转换器参数是否一致：IP 地址、Universe 编号、端口模式。像素线路无论在设备上还是在项目中都需要SPI模式（对应项目中的Controller Type参数），否则画面会在 Universe 边界处出现错位。
像素颜色不对或闪烁。 Chip类型与线路上实际安装的芯片不一致。