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

[[ru:Настройка Light Stream Converter]] [[en:Light Stream Converter Setup]] [[zh:Light Stream Converter 配置]]
Converter 是一种设备，用来从计算机接收网络信号，并通过自身的端口（Port）分发给灯具。要让它在项目现场正常工作，需要进行配置：设置网络地址、端口模式（Port Mode）、像素芯片（Chip）类型和域（Universe）编号。这一切都可以直接在 Light Stream 软件中通过网络完成，无需使用单独的工具。

本文介绍的是对'''物理设备本身'''的配置。Converter 在'''项目内部'''的参数（数据发送到哪个地址、使用什么协议，项目中描述了多少端口和多少域）属于另一个窗口，相关内容见文章 [[Параметры Light Stream Converter]]。设备上的设置必须与项目中的设置保持一致：如果两者不一致，程序会照常发送数据，但灯具不会亮起。

配置通过网络广播请求完成。计算机和 Converter 必须连接到同一网络，并且计算机的网卡必须与设备处于同一子网。

== 在网络中搜索设备 ==

一切从'''Art-Net 节点搜索'''（Art-Net Node Discovery）窗口开始。可以通过两种方式打开它：

* 在'''固定装置'''（Fixtures）窗口中——底部面板上的放大镜按钮（'''搜索'''，Search），位于'''添加设备'''（Add Device）按钮旁边；

* 在程序设置的'''网络'''（Network）部分——'''搜索'''按钮（见 [[Settings]]）。

操作步骤：

# 在'''网络设备'''（Network Device）列表中选择连接了 Converter 的网卡。所选项会被记住，并在下次打开窗口时自动提供。

# 点击'''搜索'''。程序扫描网络期间，下方会显示进度指示条；搜索过程只需几秒钟。

# 找到的设备会出现在左侧列表中：设备的'''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'''按钮会让所选设备做出响应：真实的 Converter 会闪烁指示灯。这样便于弄清配电柜中哪个盒子对应找到的 IP。该按钮仅对 Light Stream 设备有效。

* '''设置'''（Settings）按钮会打开所选设备的配置窗口。它仅对 Light Stream 的 Converter 可用：其他厂商的设备以及'''Light Stream Player'''在这里没有自己的设置。

* 如果列表为空，请检查是否选择了正确的网卡，以及它是否与 Converter 处于同一子网。

== 将找到的设备添加到项目中 ==

'''添加选中节点'''（Add Selected Nodes）按钮会将勾选的设备连同其真实设置一起添加到项目中。可以同时选中多行。

* 找到的'''Light Stream Player'''会作为播放器添加到项目中，并带有其 IP 地址。

* 找到的 Converter 会作为 Converter 添加：带有设备的名称和 IP 地址、其起始域（Starting Universe），以及设备实际拥有的端口数量。如果端口工作在 1024 通道模式下，程序会考虑到每个端口对应两个域。

这是在项目中描述已配置好的设备的最快方式：无需手动核对地址和域。添加完成后，只需将灯具分配（patch）到端口即可——见 [[Патчинг приборов]]。

添加操作可以像项目中的其他任何操作一样，通过 ''Ctrl+Z'' 撤销。

== “控制器设置”窗口 ==

该窗口通过搜索窗口中的'''设置'''按钮打开，分为四个部分：

* '''基本设置'''（General Settings）——网络地址、设备名称、端口模式和芯片；

* '''端口'''（Ports）——按端口列出域的表格；

* '''信息'''（Information）——设备当前报告的自身状态；

* '''发送 Art-Net 宏命令'''（Send Art-Net Macro）——供技术支持使用的服务字段。

所有更改只有在点击相应的'''设定'''（Set）按钮后才会发送到设备。仅仅在字段中输入数值是不够的。

=== IP 地址与子网掩码 ===

# 输入所需的'''IP 地址'''（IP Address）和'''子网掩码'''（Mask）。

# 点击'''设定 IP'''（Set IP）。

# 在'''更改 IP？'''（Change IP?）窗口中确认操作。

# 成功后会出现提示'''IP 设置成功'''，找到的设备列表也会自动刷新。

更改设备地址后，务必在项目中为该 Converter 设置相同的地址——即'''属性'''（Properties）窗口中的'''IP 地址'''字段（见 [[Параметры Light Stream Converter]]）。否则程序会继续向旧地址发送数据。

如果计算机和 Converter 最终处于不同的子网中，更改地址后设备可能会从搜索结果中消失——请将计算机网卡调整到新的子网，然后重新搜索。

=== 设备名称 ===

'''完整名称'''（Full Name）字段及其旁边的'''设定'''按钮会将名称写入 Converter。该名称会显示在找到的设备列表和 Art-Net 报告中，因此有意义的名称（例如“Facade North”“Roof”）能大大简化在有十几个相同盒子的现场的后续工作。

=== 端口模式与芯片 ===

'''端口模式'''（Port Mode）列表用于设定设备端口的工作方式：

{| class="wikitable"
! 数值 !! 含义
|-
| '''DMX 512''' || 常规 DMX：512 个通道，每端口一个域
|-
| '''DMX 1024HS''' || 通道数翻倍的 DMX：1024 个通道，每端口两个域
|-
| '''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'''。该数值必须与线路上实际使用的芯片一致，否则像素会出现混乱闪烁、颜色错误，或完全不亮。

要应用模式和芯片，请点击'''端口模式'''列表右侧的'''设定'''按钮——它会一次性发送两个设置。设备不会立即完成切换：光标会变成“沙漏”状态持续几秒钟，之后程序会重新读取 Converter 的状态，并在'''信息'''中显示新的报告。请等待完成，不要关闭窗口。

模式和芯片是针对整台设备、所有端口一次性设定的。

=== 单个端口的模式 ===

单个端口的模式在'''端口'''表格中设定：在端口所在行上'''右键点击'''会打开一个菜单，包含'''DMX IN'''、'''DMX OUT'''、'''RDM'''和'''SPI'''选项。选择后，程序会提示'''端口模式设置成功'''，并刷新设备数据。

* '''DMX IN''' ——端口接收来自第三方控台的 DMX。

* '''DMX OUT''' ——端口向灯具发送 DMX。

* '''RDM''' ——端口通过 RDM 协议进行带反馈的通信。

* '''SPI''' ——端口驱动一条像素线路。

例如，这样便于让一个端口用来接收外部 DMX，其余端口用作输出。

=== 端口的域 ===

'''端口'''表格显示的是在设备本身上分配给各端口的域。

{| class="wikitable"
! 列 !! 显示内容
|-
| '''短名称'''（Short Name） || 设备报告的端口名称。如果一个端口对应两个域，会出现两行相同名称的记录
|-
| '''域'''（Universe） || 域的总编号，范围从 0 到 32767。这就是你在项目中与端口的域进行比对的数字
|-
| '''Net / Sub / Universe''' || 同一个编号按照 Art-Net 标准拆分成三部分：'''Net'''（0–127）、'''Sub'''（0–15）和'''Universe'''（0–15）
|}

这两种表示方式是关联的：更改总编号，三个字段会自动重新计算，反之亦然。总编号的计算方式为 ''Net × 256 + Sub × 16 + Universe''。你可以按自己方便的方式设置编号。

表格下方的按钮：

* '''全选'''（Select All）——选中所有行。

* '''编辑所选'''（Edit Selected）——询问'''起始域'''（Starting Universe），并从该编号开始依次为所选行编号。这是按顺序排列域的最快方法。

* '''设定'''（Set）——将更改写入设备。写入期间会停止发送 Art-Net。写入完成后，程序会重新读取设备并核对结果：如果全部写入成功，会显示'''保存成功'''；否则显示'''保存出错'''。

写入设备的域必须与项目中该 Converter 端口的域保持一致。在项目中它们不是逐一设置的：那里指定的是'''起始域'''和'''每端口域数'''，其余按顺序计算。最简单的方法是用'''编辑所选'''按钮把设备的域依次编号，然后在项目中设置相同的起始域。

=== 信息 ===

'''信息'''（Information）部分显示设备当前报告的自身状态：'''完整名称'''、'''短名称'''、'''IP 地址'''、'''MAC'''、'''状态'''（Status，即设备报告）、固件'''版本'''（Version）、'''ESTA'''和'''OEM'''代码。这些字段仅供查看，每次成功写入设置后都会刷新——通过它们可以方便地确认更改是否真正生效。

=== 服务功能 ===

'''发送 Art-Net 宏命令'''部分中的'''数据'''（Data）字段和'''发送宏命令'''（Send Macro）按钮会向设备发送服务命令。只有在技术支持的指示下才能使用它们。此窗口中的'''重置设置'''（Reset Settings）按钮不可用。

== 新 Converter 的配置流程 ==

# 将 Converter 连接到网络，并将计算机的地址设置为同一子网。

# 打开'''Art-Net 节点搜索'''，选择网卡，点击'''搜索'''。

# 在列表中找到所需设备，用'''Ping'''按钮确认响应的正是该设备。

# 点击'''设置'''，为设备设定工作用的'''IP 地址'''和'''子网掩码'''。

# 设置'''完整名称'''，以便日后识别该设备。

# 选择'''端口模式'''，对于'''SPI'''模式还需选择'''芯片'''。点击'''设定'''并等待设备完成切换。

# 在'''端口'''表格中为域编号，然后点击'''设定'''。

# 关闭设置窗口，重新执行'''搜索'''，然后用'''添加选中节点'''按钮将设备添加到项目中。

# 检查项目中 Converter 的参数：'''IP 地址'''、'''起始域'''、'''端口数量'''、'''每端口域数'''以及'''控制器类型'''（Controller Type，像素线路选择'''SPI'''）。

# 将灯具分配（patch）到端口，并开启'''Art-Net'''。

== 如果出现问题 ==

'''搜索不到任何设备。''' 检查所选网卡、物理连接，以及计算机地址是否与 Converter 处于同一子网。部分交换机和 Wi-Fi 适配器不会转发广播请求——请改用网线连接。

'''更改 IP 后设备消失了。''' 新地址处于不同的子网中。请将计算机网卡的地址调整到新的子网，然后重新搜索。

'''写入域时出现保存错误。''' 设备没有确认更改。请重试写入；如果错误反复出现，请用'''Ping'''按钮检查与设备的连接，并确认写入期间没有其他人在访问该 Converter。

'''“Ping”和“设置”按钮不可用。''' 列表中选中的不是单个设备，或选中的是其他厂商的设备，或是'''Light Stream Player'''。此窗口中的设置仅对 Light Stream 的 Converter 可用。

'''模式和芯片没有生效。''' 设备需要几秒钟来完成切换。请在等待光标消失之前不要关闭窗口，并核对'''信息'''部分中的报告。

'''现场没有出现灯光。''' 请核对设备设置与项目中 Converter 的参数：IP 地址、域编号、端口模式。像素线路无论在设备上还是在项目中（'''控制器类型'''参数）都需要'''SPI'''模式，否则画面会在域的边界处出现错位。

'''像素显示的颜色不对，或出现闪烁。''' '''芯片'''类型与线路上实际使用的芯片不一致。

== 参见 ==

* [[Параметры Light Stream Converter]]
* [[Параметры Light Stream Player]]
* [[Патчинг приборов]]
* [[Виды и типы приборов]]
* [[Settings]]
* [[Properties]]
* [[Терминология]]