查看“Light Stream Converter 设置”的源代码

[[ru:Настройка Light Stream Converter]] [[en:Light Stream Converter Setup]] [[zh: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 地址。设备报告显示端口当前的工作模式以及选择的芯片。

设备报告大致如下：<code>#0001[0035] UCS1903(High,340)Tb=125,T0=30,T1=100,Tr=290</code>。其中 <code>UCS1903</code> 是所选芯片，<code>340</code> 是端口模式（每端口 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'''列表用于设置设备端口的工作方式：

{| class="wikitable"
! 取值 !! 含义
|-
| '''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。

{| class="wikitable"
! 列 !! 显示内容
|-
| '''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'''类型与线路上实际安装的芯片不一致。

== 另请参阅 ==

* [[Light Stream Converter 参数]]
* [[Light Stream Player 设置]]
* [[固定装置的地址分配]]
* [[固定装置的种类与类型]]
* [[设置]]
* [[属性]]
* [[术语]]