THORLABS MX 系列远程控制线性参考发射器
介绍
描述
MX 和 MBX 系列、TLX1 和 TLX2 仪器可通过 SCPI 型串行命令进行远程控制。这需要使用 USB 电缆将运行 Microsoft® Windows® 7 操作系统或更高版本的计算机连接到仪器，或将运行任何操作系统的计算机连接到仪器上的 RS-232 端口。串行命令发送到位于仪器后面板上的 USB 或 RS-232 端口。在远程控制仪器时，触摸屏界面保持活动状态，并且仍然可以通过触摸屏界面访问仪器功能。本文档描述了仪器与控制计算机的连接过程，定义了串行命令，并包括有关用作扩展程序的远程控制软件工具的信息。ample 和发送串行命令的教程。 下载远程控制软件工具及配套 file适用于您的 MX 和 MBX 系列、TLX1 和 TLX2 仪器，请访问以下页面并输入仪器的项目编号： https://www.thorlabs.com/manuals.cfm
连接计算机与 MX 和 MBX 系列、TLX1 和 TLX2 仪器
以下部分使用 MX40G 电光转换器作为前ample，但该程序和指南适用于所有 MX 和 MBX 系列、TLX1 和 TLX2 仪器。这些仪器可以通过位于后面板的 USB 或 RS-232 端口连接到计算机，如图 1 所示。请注意，不支持同时使用 USB 和 RS-232 连接。如果需要从 USB 更改为 RS-232 连接，或反之亦然，请先关闭仪器电源，更改连接，然后打开仪器电源。这将确保仪器识别新连接。 
| 标签 | 描述 |
| B1 | I/O 端口（HDDB15 连接器） |
| B2 | 激光联锁（2.5 毫米连接器） |
| B3 | RS-232 端口（DB9 连接器） |
| B4 | USB 端口（USB B 型连接器） |
| B5 | 电源连接器 |
| B6 | 电源开关电源打开； 断电 |
连接到 MX 和 MBX 系列、TLX1 和 TLX2 仪器后面板上的 USB 端口
USB 电缆可用于连接运行 Windows 7 或更高版本的计算机，仪器后面板上的端口如图 2 所示。USB 端口为 B 型。带有 B 型连接器的 USB 电缆一端是 A 型连接器，另一端是 A 型连接器，可以连接大多数计算机。
当 Windows PC 发现该仪器时，它将显示为人机接口设备 (HID)，而不是虚拟串行端口。HID 类包括计算机鼠标和键盘。请注意，PC 终端软件（例如 Tera Term）不能用于通过 USB 电缆与仪器通信。这是因为 PC 终端软件要求连接的仪器被 PC 识别为虚拟串行端口。第 3 章中讨论的 Thorlabs 远程控制应用程序可以扫描、发现并打开与连接仪器的连接。
连接到 MX 和 MBX 系列、TLX232 和 TLX1 仪器后面板上的 RS-2 端口
如果控制计算机有 RS-232 端口，或者 USB 转 RS-232 适配器连接到计算机的 USB 端口，则可以使用 RS-232 电缆在计算机和 RS-232 端口之间建立物理连接在仪器的后面板上。任何能够使用串行端口发送和接收数据的软件都可以用来控制仪器。将控制计算机的串行端口配置为 115200 波特率、8 位、无奇偶校验、1 个停止位、无流量控制。第 3 章中讨论的 Thorlabs 远程控制应用程序还可以通过 RS-1 连接控制 MX 和 MBX 系列、TLX2 和 TLX232 仪器。仪器后面板上的 DB9 连接器的引脚分配如图 3 和下表所示。
| RS-232连接器 | |
| 别针 ＃ | 描述 |
| 1 | 未连接 |
| 2 | RS-232 输入 |
| 3 | RS-232 输出 |
| 4 | 未连接 |
| 5 | Digital Ground |
| 6 | 未连接 |
| 7 | 未连接 |
| 8 | 未连接 |
| 9 | 未连接 |
使用控制计算机上的 RS-1 端口连接到 MX 和 MBX 系列、TLX2 和 TLX232 仪器
图 4 说明了使用仪器上的 RS-232 端口和控制计算机时的物理连接。连接的详细信息取决于控制计算机的 RS-232 端口。当它是：
- 9 针 DB9 公连接器，一种选择是使用母对母 9 针“零调制解调器”电缆。 National Instruments® 在此处解释了标准调制解调器电缆和零调制解调器电缆之间的区别： http://digital.ni.com/public.nsf/allkb/1EE0DD8AF67922FA86256F720071DECF
- 25 针 DB25 公头连接器，可使用在 25 针和 9 针之间转换的零调制解调器电缆。无论哪种情况，如果没有零调制解调器电缆，可以使用零调制解调器适配器和标准电缆。
如果使用控制计算机上的 USB 端口，则可以使用 USB 电缆（端接 USB 至 RS-232 适配器）来连接零调制解调器电缆。当适配器上的连接器为 9 针 DB9 公头，而零调制解调器电缆有两个 9 针母头 DB9 连接器时，可以使用适配器和零调制解调器电缆在计算机的 USB 和仪器的 RS-232 端口之间建立连接。如图 5 所示。
请注意，仪器上的 USB 端口不应连接到控制计算机上的 RS-232 端口；不支持此配置。
支持的命令
本节介绍固件版本 V1.9.4 及更高版本支持的命令。 这些命令以 IEEE 488.2 可编程仪器标准命令 (SCPI) 规范为模型。 按照此约定，下表“语法”列中的许多命令都包含大写和小写字母。 大写字母标识命令的最短可接受形式。 如果包含其他字符，则必须包含所有命令字符。 （例如amp美国之音： 确定了吗？和美国之音：设定点？ VOA: SETpoint 唯一可接受的变化是？命令。）发送到仪器的每个 SCPI 命令字符串必须以以下任一方式终止： （ ) 字符（ASCII 十进制 10）， （ASCII 十进制 13 10）， （ASCII 十进制 13），或（ASCII 十进制 10 13）。 IEEE 488 规定标准端接是特点。对于发送到仪器并保证响应的每条 SCPI 消息，仪器都会使用以下命令终止返回的响应：特点。下面描述的命令已开发为自定义集，因为 SCPI 标准中的设备都不是精确的模拟。请注意，并非以下部分中描述的每个命令都适用于每个 MX 和 MBX 系列、TLX1 和 TLX2 项目编号。对于应用于特定仪器的命令，该仪器必须具有相关的内置组件。对于前amp即，激光控制命令不适用于不包含内部可调谐激光器的仪器。 下表列出了每个仪器支持的命令。
有效命令将在收到时返回值 1。 有效查询返回一个值/字符串，如第 0 节到第 2.6 节中的查询描述中所述。 下表列出了异常处理的可能返回值。
命令返回码
| 返回值 | 返回说明 |
| 1 | 对有效命令的响应 |
| 没有“Err:”指示字符串的值 | 对有效查询的响应 |
| 错误：功能不存在 | 向没有内置硬件的仪器发出命令。请参阅 图 6 为了命令兼容性。
系统应用程序固件 < V1.9.5 报告为 Err：Hardware missing |
| Err：参数错误 | 发出了一个参数值超出可接受范围的命令。 有关可接受的值范围，请参阅命令说明。 |
| Err：非法参数值 | 发出的命令的参数值超出此设备支持的范围。 |
| 错误：数据超出范围 | 发出了一个数据值超出可接受范围的命令。 有关可接受的值范围，请参阅命令说明。 |
| Err：数值数据错误 | 发出了一个带有超出可接受范围的数值数据值的命令。 有关可接受的值范围，请参阅命令说明。 |
| Err：数据类型错误 | 发出了数据类型不正确的命令。 有关可接受的数据类型，请参阅命令说明。 |
| 错误：存储故障 | 访问内部 EEPROM 时发生错误。无法继续执行该命令。 |
| 错误：系统错误 | 系统在处理命令时遇到内部错误。 无法继续执行命令。 |
| Err：执行错误 | 尝试执行给定命令时发生错误。请检查设备是否已通电并处于运行模式。 |
| 错误：未定义的标头 | 发出无效命令、格式无效的命令或当前系统应用程序固件无法识别的命令。 |
| 错误：未选择可调谐激光器 | 在固定波长激光器处于活动状态时发出有关可调激光器的命令。仅适用于双波段仪器。 |
| 错误：激光被锁定 | 发出访问激光的命令，激光被联锁机构锁定。 |
| 错误：此命令需要引导加载程序 >= 1.7.4 | 发出了仅在引导加载程序代码 ≥ 版本 1.7.4 中受支持的命令。 |
RF Amplifier 命令
MX 系列仪器包括多种具有内置 RF 的仪器 amplifier，以下命令仅适用于这些仪器。 这 amp其中一些产品（例如 MXxxA、MXxxB 和 MXxxC）的放大器类型为数字（限制）。在其他产品（例如 MXxxD 和 MXxxE）中， amplifier 类型为线性（模拟）。 只有数字射频 amplifiers有交叉点和摆动设置，只有这些RF amplifiers可以在模拟或数字模式下运行。 相比之下，增益可以只为线性射频设置 amp升华者。 除非另有说明，以下 RF Amplifier 命令适用于两者 amp升压器类型。
| 命令 | 句法 | 描述 |
| 设置交叉点（模拟模式） | AMP：交叉：模拟：N | N 是介于 -1.0 和 1.0（含）之间的浮点值。 此参数适用于数字 amplifier 在模拟模式下运行并确定交叉点的位置。 N 没有单位； -1.0 对应于最大可能的负偏移，1.0 对应于最大可能的正偏移。 可用范围，取决于 amplifier的卷tage 限制和当前 AMP：SWING 设置，可能比这个全小 – –
1.0 至 1.0 范围。在这种情况下，N 个在 ±1.0 范围内但超出当前可用范围的值将把交叉点设置为最接近的允许值。此命令不适用于具有线性（模拟）的仪器 amp升压器类型。 |
| 获取交叉点
（模拟模式） |
AMP:CROSSing: 模拟？ | 返回一个介于 -1.0 和 1.0 之间的浮点值，包括两个值。 该值没有单位，对应于数字的当前交叉点 amplifier 在模拟模式下运行时。 此命令不适用于具有线性（模拟）的仪器 amp升压器类型。 |
| 设置交叉点（数字模式） | AMP：交叉：数字：N | N 是介于 -1.0 和 1.0（含）之间的浮点值。 此参数适用于数字 amplifier 在数字模式下运行并确定交叉点的位置。 请参见 AMP:CROSS: ANA 了解更多信息。此命令不适用于具有线性（模拟）功能的仪器 amp升压器类型。 |
| 获取交叉点
（数字模式） |
AMP:CROSSing: 数字？ | 返回一个介于 -1.0 和 1.0 之间的浮点值，包括两个值。 该值没有单位，对应于数字的当前交叉点 amplifier 在模拟模式下运行时。 此命令不适用于具有线性（模拟）的仪器 amp升压器类型。 |
| 设置增益 | AMP:增益: N | N 是一个介于 10.0 和 23.0 之间的浮点值，以分贝为单位。 该值设置线性（模拟）类型的增益 amp升华者。 此命令不适用于具有数字（限制）或固定增益的仪器 amp升压器类型。 |
| 获得收益 | AMP： 获得？ | 返回一个介于 10.0 和 23.0 之间的浮点值，以分贝为单位，对应于线性（模拟）类型的当前增益 amp升华器。 此命令不适用于具有数字（限制）或固定增益的仪器 amp升压器类型。 |
| 放 Amplifier 模式转模拟 | AMP：模式：1 | 设置数字的操作 amp升压器到模拟模式。 这包括将交叉点设置为当前为模拟模式操作指定的点（AMP:CROSS: ANA) 并施加最大可能的摆动。此命令不适用于具有线性（模拟）功能的仪器 amp升压器类型。 |
| 命令 | 句法 | 描述 |
| 放 Amplifier 模式转数字 | AMP：模式：0 | 设置数字的操作 amp升压器到数字模式。 这包括将交叉点设置为当前为数字模式操作指定的点（AMP:CROSS: DIG) 并应用当前的摆动值 (AMP： 摇摆）。 swing 的默认值为 amp放大器的 1 GHz 频率值，该值在工厂确定并存储在仪器内存中。此命令不适用于具有线性（模拟）的仪器 amp升压器类型。 |
| 得到 Amp模式 | AMP： 模式？ | 返回 0 如果 amplifier 模式设置为模拟和 1，如果 amplifier模式设置为数字。 此命令不适用于具有线性（模拟）的仪器 amp升压器类型。 |
| 放 Amp升力器开机 | AMP:力量: 1 | 套 amplifier 电源打开并在收到后返回 1
命令。 |
| 放 Amp升力器关机 | AMP:力量: 0 | 套 amplifier 电源“关闭”并在收到后返回 1
命令。 |
| 得到 Amp升压器电源状态 | AMP： 力量？ | 返回 0 如果 amp升压器电源设置为“关闭”和 1，如果 amp升压器电源设置为“开”。 该命令返回最近的 请求 电源状态，这可能不同于
amplifier 的当前活动电源状态。 AMP： 放？可以用来 验证最后请求的电源状态是否有效。 |
| 得到 Amp状态 | AMP： 设定点？ | 返回 1 并在 AMP 领域
仪器的触摸屏上 amp滤波器已完全准备就绪并已达到要求的设置。否则，将返回 0 且绿点闪烁。 Amp放大器设置更新速度很快，通常在一秒钟内。但是，发送调整命令后立即查询 amp升压器卷tage 可能会发现 amplifier 处于瞬态并返回 零。 |
| 设置 Amp利弗秋千
（数字模式） |
AMP:摇摆: N | N 是浮点值，标准范围为 3.0 至 7.0 Vpp。该命令设置数字的摆动 amp仪器在数字模式下运行时会显示读数，在模拟模式下运行时可以设置该值。一些工厂定制的装置具有扩展的摆动范围。使用仪器上的触摸屏 GUI 可以 view 可用范围。该命令不适用于仪器
线性（模拟） amp升压器类型。 |
| 获取 Amp利弗秋千
（数字模式） |
AMP： 摇摆？ | 返回以 Vpp 为单位的浮点值。 这是数字时应用的摆动设置 amplifier 以数字模式运行。 在模拟模式下操作时可以检索此值。 此命令不适用于具有线性（模拟）的仪器
amp升压器类型。 |
| 设置 Amp升力器摆动到 V （数字模式） | AMP:摇摆：VPI | 将摆动设置为 amplifier 的 Vat 1 GHz 并在收到命令时返回 1。每个仪器在出厂时都会找到该 V 值并将其保存到内存中。这是按下触摸屏界面上的 V 按钮时应用的“最佳挥杆”设置。此命令不适用于具有线性的仪器
（模拟） amp升压器类型。 |
激光控制命令
这些命令适用于 TLX1 和 TLX2 仪器以及具有内置可调谐激光器的 MX 系列产品，其中包括 MXxxB、MXxxE 和 MXxxG。下文中，如无特殊说明，“激光器”均指内置可调谐激光器。请注意，ITU 信道是使用 50 MHz 网格定义的。请注意，在“设置”命令中指定请求的激光状态与请求的状态变为活动激光状态之间会有延迟，因为仪器需要有限的时间来执行命令。下表给出了每个相关命令的典型执行时间。设置激光参数后，LASer：SETpoint?命令可用于确定激光器的活动状态。
| 命令 | 句法 | 描述 |
| 设置国际电联频道号 | 激光：通道：N | 对于C波段激光器，N是1到96的整数，对于L波段激光器，N是1到93的整数。该命令设置激光器的 ITU 通道并在收到时返回 1
命令。当调谐到所需通道时，激光器的光输出可能会暂时减少或关闭然后再打开。 |
| 获取 ITU 频道号 | 激光：频道？ | 对于 C 波段激光器，返回 1 到 96 之间的整数值（含）；对于 L 波段激光器，返回 1 到 93 之间的整数值（含）。此命令返回最新的 请求 ITU 通道，由于典型通道设置持续时间<10 秒，可能与当前活动的 ITU 通道不同。 LAS：确定了吗？命令可用于验证最后请求的 ITU 通道是否处于活动状态。 |
| 设置抖动 | 激光：抖动：1 | 将激光抖动设置为“打开”并在收到时返回 1
命令。 |
| 设置抖动关闭 | 激光：抖动：0 | 将激光抖动设置为“关闭”并在收到时返回 1
命令。 |
| 获取抖动状态 | LASer：抖动？ | 如果 dither 设置为“off”，则返回 0；如果 dither 设置为“on”，则返回 1。 该命令返回最近的 请求 抖动状态，由于典型的抖动设置时间持续时间小于 10 秒，因此可能与当前活动的抖动状态不同。LAS: SET? 命令可用于验证最后请求的抖动状态是否处于活动状态。 |
| 设置调谐频率偏移 | 激光：精细：N | N 是 -30,000 到 30,000 之间的整数（含）。输入的值是频率偏移（单位为 MHz），收到命令后返回 1。发送此命令会导致激光频率调整为当前 ITU 通道频率与此指定的微调频率偏移之和。微调频率偏移的范围涵盖 ITU 通道之间的整个频率范围。 |
| 获得微调频率偏移 | 激光师：还好吗？ | 返回一个介于 -30,000 和 30,000（含）之间的整数，对应于 请求 频率偏移，以 MHz 为单位。 由于典型的激光调谐持续时间 <30 秒，该值可能与当前频率偏移不同。 目前还没有准确的方法可以通过遥控器确定微调操作是否完成。 但是，可以使用以下方法获取其他激光状态信息：
· LAS：频率？ · 拉斯：确定？ · 拉斯：面向对象？ |
| 命令 | 句法 | 描述 |
| 获取光学激光频率 | 激光：频率？ | 返回一个浮点值，单位为 GHz。报告的光学激光频率由 ITU 通道 (LAS:CHAN: N) 和精细偏移 (LAS:FINE: N) 确定。由于返回值的分辨率限于 0.1 GHz (100 MHz)，因此使用微调功能设置的中频值将四舍五入到最接近的 0.1 GHz。 |
| 获取标称激光频率 | 激光：FREQ_NOMinal？ | 返回计算频率的正整数，从 ITU 信道的标称频率生成，加上或减去当前微调频率偏移。 该值以 MHz 为单位。 这与 LCD GUI 激光设置页面上显示的值相同。 请注意，它来自请求的频率，并不代表实时测量。 |
| 获取报告的光输出功率 (OOP) | 激光：OOP？ | 返回以 dBm 为单位的浮点值。该值对应于由集成光电二极管测量的激光模块的光输出功率。典型工作值为 13.5 dBm。这与响应 LAS::DBM. 命令时报告的测量值不同，后者通过光分接头测量下行光功率。这两个测量值可能略有不同。在激光预热和频率调整期间，光输出功率会不稳定。 |
| 设置激光电源开启 | 激光：功率：1 | 将激光功率设置为“开启”，并在收到命令后返回 1。为确保最佳稳定性和全光输出功率，开机后让激光器预热 15 分钟。 |
| 设置激光电源关闭 | 激光：功率：0 | 将激光功率设置为“关闭”，并在收到
命令。 |
| 获取激光功率状态 | 激光：功率？ | 如果激光功率设置为“关闭”，则返回 0；如果激光功率设置为“打开”，则返回 1。 该命令返回最近的 请求 功率状态，可能与激光器当前的活动功率状态不同。 LAS：确定了吗？命令可用于验证最后请求的电源状态是否处于活动状态。
可以使用以下方法获取其他激光状态和设定点信息： · 拉斯：设置了吗？ · LAS：OOP？ · LAS:TAP:DBM？ · LAS:TAP:MW？ |
| 选择 C 波段激光器 | 激光：选择：Cband | 选择 C 波段激光器并在收到命令时返回 1。此命令不适用于具有单个
激光。 |
| 选择 L 波段激光器 | 激光：选择：Lband | 选择 L 波段激光器并在收到命令时返回 1。此命令不适用于具有单个
激光。 |
| 选择 1310nm 激光 | 激光器：选择：1310 | 选择固定的 1310nm 激光器并在收到命令时返回 1。此命令不适用于具有
单激光。 |
| 获得选定的激光 | 激光仪：选择？ | 返回与当前选择的激光对应的字符串。 |
| 命令 | 句法 | 描述 |
| 获取激光状态 | 激光：设定点？ | 当以下条件都为真时，返回 1 并且仪器触摸屏的激光场中显示一个稳定的绿点。 否则，返回 0。
· 前面板上的硬件钥匙开关联锁 处于“开”位置。 · 仪器的微控制器响应远程或触摸屏控制，已命令激光器打开电源。 · 激光器当前的活动抖动状态（开或关） 与最后请求的抖动状态匹配。 · 激光器当前激活的 ITU 通道与最后请求的 ITU 通道匹配。 · 激光器当前报告它处于“就绪”状态。 · 激光器当前报告其已“启用”。 · 激光器目前报告其光输出功率大于 12.0 dBm。 |
| 以 dBm 为单位获得测量的光输出功率 | 激光：TAP：DBM？ | 返回以 dBm 为单位的浮点值。这是使用光学分接头从激光模块下游测量的光输出功率的测量值。LAS: OOP? 返回的值是由集成在激光模块中的光电二极管进行的测量。这两个测量值可能略有不同。光输出功率将是
激光预热和频率调谐期间不稳定。 |
| 以 mW 为单位获得测量的光输出功率 | 激光：TAP：MW？ | 返回以 mW 为单位的浮点值，其测量细节与 LAS:TAP: DBM 描述的相同。 |
| 获取标称激光波长 | 激光：WAVE_NOMinal？ | 返回计算波长的正整数，该波长由 ITU 信道的标称频率生成，并加上或减去当前微调频率偏移。该值以 10 fm（飞米）为单位。这与 LCD GUI 激光设置页面上显示的值相同。请注意，它是从请求的频率派生而来的，并不
代表实时测量。 |
Mach-Zehnder EO 强度调制器命令
一些 MX 系列仪器具有用于基于铌酸锂的 Mach-Zehnder EO 强度调制器 (MZM) 的内置控制器。以下命令仅适用于这些仪器，包括 MBX 系列、MXxxA、MXxxB、MXxxD、MXxxE 和 MXxxG。
| 命令 | 句法 | 描述 |
| 获取校准状态 | MZM：CALibrating？ | 如果当前未校准 MZM 偏置并且当前正在进行 0 校准，则返回 1。当首次打开 MZM 偏置控制器或手动触发重新校准时（MZM：RESET 或使用触摸屏 GUI 上的 RESET AUTO BIAS 按钮），MZM 偏置会自动校准。当偏置控制器关闭并打开且未关闭 MX 仪器电源时，校准数据会保留，但仪器关闭时不会存储 MZM 校准数据。 |
| 设置抖动 Amp纬度 | MZM：抖动：AMP纬度：N | N 是 20 至 2,000 之间的正整数（含），单位为 mVpp. 它设置抖动 amp参考该值的那些 MZM 偏置模式的纬度。 并非所有 MZM 偏置模式都使用抖动。 |
| 获取抖动 Amp纬度 | MZM：抖动： AMP纬度？ | 返回当前抖动 amp以 mV 为单位的高度设置pp 为 20 到 2,000 之间的正整数。这将返回存储的抖动设置。它不是对 MZM 输出中的抖动的测量。并非所有 MZM 偏置模式都使用抖动。 |
| 设置抖动频率 | MZM：抖动：频率：N | N 是介于 1,000 和 10,000（含）之间的正整数，单位为 Hz。 并非所有 MZM 偏置模式都使用抖动。 |
| 获取抖动频率 | MZM：抖动：频率？ | 返回当前抖动 amp以 Hz 为单位的纬度设置为 1,000 到 10,000（含）之间的正整数。 这将返回存储的抖动设置。 它不是 MZM 输出中抖动的测量值。 并非所有 MZM 偏置模式都使用抖动。 |
| 设置保持率 | MZM：持有：比率：N | N是250以上且10,000以下的正整数。它没有单位，代表实现所需输入输出功率比所需的输入功率。通过首先选择所需的输入与输出功率之比，然后将该比率乘以 100 来确定 N。（例如，如果所需的输入和输出功率值相同，则它们的比率为 1.0，且 N = 100。如果输入大 100.00 倍）比输出功率，N = 10,000。）此设置仅用于 自动功率比正 和 自动功率比负 MZM 偏置模式。 |
| 获取持有率 | MZM：持有：比率？ | 返回 250 到 10,000 之间的正整数（含）。它没有单位，表示实现所需输入输出功率比所需的输入功率，如 MZM:HOLD:R: N 条目中所述。这将返回存储的比率设置。它不是 MZM 偏置输出的测量值。它仅用于 自动功率比正 和 自动功率比
消极的 MZM 偏置模式。 |
| 设置保持音量tage | MZM：保持：音量tage: 否 | N 是介于 -10,000 和 10,000（含）之间的整数，单位为 mV。 此设置仅用于 手动卷tage MZM 偏置模式。 |
| 命令 | 句法 | 描述 |
| 获取保持音量tage | MZM：持有：成交量tage? | 返回介于 -10,000 和 10,000（含）之间的整数，单位为 mV。 这将返回存储的比率设置。 它不是 MZM 偏置输出的测量值。 它仅用于 手动卷tage MZM 偏置模式。 |
| 设置 MZM 偏置模式 | MZM：模式：N | N 是介于 0 和 9 之间的正整数，包括 XNUMX 和 XNUMX。 设置此值以选择 MZM 偏置模式。 与每个值关联的模式是：
· 0：偏置控制关闭。 MZM 偏置电压为 0 V。 · 1：自动峰值偏置模式，使用抖动保持调制功能的峰值运行。 · 2：Auto Null 偏置模式，它使用抖动来保持调制功能的最低点（null）运行。 · 3：自动Quad Pos 偏置模式，在调制功能上保持在正正交位置操作。这相当于使用触摸屏 GUI 选择四线模式和正斜率，并开启抖动。不适用于 MX110G 型号。 · 4：自动四路负偏置模式，在调制函数上保持负正交位置的操作。这相当于使用触摸屏 GUI 选择四路模式和负斜率，并开启抖动。MX110G 型号不提供此功能。 · 5：保持四轴偏置模式： o 除 MX110G 之外的所有型号：将偏置保持在最后一个卷tage 在 Quad 模式下找到。 这相当于使用触摸屏 GUI 选择 Quad Mode 和正斜率，同时关闭抖动。 o MX110G：通过将选项输入/输出比保持在峰值以下 3dB，保持在正正交位置运行。这相当于使用触摸屏 GUI 选择四路模式和正斜率。注意：在此模式下抖动关闭。 · 6：保持四负偏压模式： o 除 MX110G 之外的所有型号：将偏置保持在最后一个卷tage 在 Quad 模式下找到。 这相当于使用触摸屏 GUI 选择 Quad Mode 和负斜率，同时关闭抖动。 o MX110G：通过将选项输入/输出比保持在峰值以下 3dB，保持在正正交位置运行。这相当于使用触摸屏 GUI 选择四路模式和负斜率。注意：在此模式下抖动关闭。 · 7：手动音量tag偏置模式，这相当于使用 触摸屏 GUI 选择手动模式，同时“偏置”设置 選擇。 · 8：Auto Power Ratio Pos，相当于使用 触摸屏 GUI 选择手动模式，同时“比率”设置 并选择正斜率。 · 9：Auto Power Ratio Neg，相当于使用 触摸屏 GUI 选择手动模式，同时“比率”设置 并选择负斜率。 |
| 获取 MZM 偏置模式 | MZM：模式？ | 返回一个介于 0 和 9 之间的正整数，包括 XNUMX 和 XNUMX，对应于当前的 MZM 偏置模式。 与每个值关联的模式在 Set MZM Bias Mode 描述中定义。 |
| 触发 MZM 校准 | MZM：重置 | 触发 MZM 偏置校准并返回 1。校准运行时，MZM: CAL?命令返回 1。 |
| 获取 MZM 状态 | MZM：设定点？ | 返回 1，并且在 Bias 字段中显示一个稳定的绿点
当 MZM 偏置稳定且处于设定点时，仪器的触摸屏会显示 0。当 MZM 未处于设定点时，会返回 XNUMX，并且偏置字段中的绿点会闪烁。 |
| 以 dBm 为单位获取 MZM 后功率 | MZM：TAP：DBM？ | 返回 MZM 输出的光功率，以 dB 为单位的浮点值。 该值是在位于 MZM 输出的抽头处进行的缩放光功率测量。 |
| 获得以 mW 为单位的 MZM 后功率 | MZM：TAP：MW？ | 返回 MZM 输出的光功率，以 mW 为单位的浮点值。 该值是在位于 MZM 输出的抽头处进行的缩放光功率测量。 |
| 获取 MZM 偏差卷tage | MZM：卷tage? | 返回当前的 MZM 偏置 voltage 作为以伏特为单位的浮点值。 |
| 获取 MZM 偏差卷tage 2 | MZM：成交量TAGE2？ | 仅限 MX110G 和 MX100E 变体。报告第二偏压卷tage 作为以伏特为单位的浮点值。 |
系统指令
本节中描述的系统命令适用于所有 MX 和 MBX 系列、TLX1 和 TLX2 仪器项目编号。下面给出的 LED 亮度命令允许用户单独设置红色、绿色和蓝色 LED 的亮度，或者设置白色 LED 的亮度，白色 LED 是红色、绿色和蓝色 LED 的组合，自动控制在同一水平，有助于集成到这些仪器外壳中的底盘照明。亮度可以使用 0.0 到 1.0 的刻度来设置，默认组合是红色 LED 的值为 0.0，绿色 LED 的值为 0.0，蓝色 LED 的值为 0.75，白色 LED 的值为 0.75。这些 LED 可用于提供仪器状态变化的视觉指示器。例如amp例如，可以通过遥控命令将灯光变为绿色，以指示试驾的结束。
| 命令 | 句法 | 描述 |
| 获取系统引导加载程序版本 | 系统：BOOTloader？ | 以字符串形式返回引导加载程序版本。 |
| 获取系统固件版本 | 系统：固件？ | 以字符串形式返回固件版本。 |
| 获取系统硬件版本 | 系统：硬件？ | 以字符串形式返回硬件版本。 |
| 获取系统型号 | 系统：模型？ | 以字符串形式返回模块编号。 |
| 触发重启 | 系统：重启 | 触发安全关机并重新启动系统，以快速将所有设置恢复为默认设置。收到命令后返回 1。这还将关闭 LCD GUI。重新启动后，屏幕将关闭，系统将进入待机模式（待机按钮 LED 呈琥珀色），与开机后通常进入的状态相同。 |
| 获取系统序列号 | 系统：串行？ | 以字符串形式返回序列号。 |
| 触发睡眠 | 系统：睡眠 | 使系统处于待机状态并在收到命令后返回 1。 |
| 触发唤醒 | 系统：唤醒 | 使系统退出待机状态并在收到命令时返回 1。 |
| 设置系统波长 | 系统：WAVE长度：N | N 是正整数值类型。1310、1550 或 1590，单位为 nm。此命令设置系统波长，用于选择在配置 VOA 和评估在抽头处进行的功率测量时要使用的校准值。设置系统波长可优化仪器在该波长下的使用。设置此值相当于使用触摸屏 GUI 设置系统波长。
注意：对于 MBX2，N 是正整数值 785、852 或 940，单位为 nm，以匹配可用的校准波长。 |
| 获取系统波长 | 系统：波长？ | 返回正整数值类型。 1310、1550 或 1590，单位为 nm，与当前系统波长设置相对应。
注意：对于 MBX2，返回的正整数值将与 785、852 或 940 nm 的校准波长匹配。 |
| 命令 | 句法 | 描述 |
| 设置红色 LED 亮度 | RGB：红色：N | N 是一个介于 0 和 100 之间的整数值，用于设置有助于底盘重点照明的红色 LED 的亮度。 |
| 获得红色 LED 亮度 | RGB：红色？ | 返回一个介于 0 和 100 之间的整数值，指示有助于机箱下重点照明的红色 LED 的亮度。 |
| 设置绿色 LED 亮度 | RGB：绿色：N | N 是一个介于 0 和 100 之间的整数值，用于设置有助于底盘重点照明的绿色 LED 的亮度。 |
| 获得绿色 LED 亮度 | RGB：绿色？ | 返回一个介于 0 和 100 之间的整数值，指示有助于底盘重点照明的绿色 LED 的亮度。 |
| 设置蓝色 LED 亮度 | RGB：蓝色：N | N 是 0 到 100 之间的整数值，用于设置有助于底盘强调的蓝色 LED 的亮度
灯光。 |
| 获得蓝色 LED 亮度 | RGB：蓝色？ | 返回一个介于 0 和 100 之间的整数值，指示有助于机箱下重点照明的红色 LED 的亮度。 |
| 设置白色 LED 亮度 | RGB：白色：N | N 是一个介于 0 和 100 之间的整数值，用于设置白色重点照明的亮度。 |
| 获得白色 LED 亮度 | RGB：白色？ | 返回一个介于 0 和 100 之间的整数值，表示白色重点照明的亮度。 |
| 设置 LED 电源模式 | RGB：功率：N | N 是介于 0 和 2 之间的正整数，包括 XNUMX 和 XNUMX。 设置此值以选择重点照明模式。 与每个值关联的模式是：
· 0：重点照明关闭。 · 1. 重点照明打开，红、绿、蓝可独立改变，以控制色调和亮度。 · 2：重点照明打开，同时控制红色、绿色和蓝色以创建白色重点照明。可以更改白色来控制亮度。 |
| 获取 LED 电源状态 | RGB：电源？ | 返回一个介于 0 和 2 之间的正整数，包括 XNUMX 和 XNUMX，对应于当前的 Accent 照明模式。 与每个值关联的模式在设置 LED 电源模式描述中定义。 |
可变光衰减器 (VOA) 命令
本节中描述的 VOA 命令适用于所有 MX 和 MBX 系列、TLX1 和 TLX2 仪器项目编号。这些命令用于控制 VOA 并确定其状态，如下表所述。
| 命令 | 句法 | 描述 |
| 设置光衰减值 | 美国之音：注意：N | N 是 0.5 到 20.0 之间的浮点值（含 1 和 XNUMX），单位为 dB。该命令设置 VOA 的光衰减，收到有效 N 的命令后返回 XNUMX。如果在恒功率模式下设置，则 VOA 的工作不会受到影响。相反，当激活恒定衰减模式时，该值将被缓存并应用。
最小 N 设置随 VOA 已知响应度而变化，并且可能随波长设置而变化。最低可能设置为 0.5。 |
| 获取光衰减值 | 美国之音：注意吗？ | 将 VOA 的衰减设置返回为介于 0.5 和 20.0（含）之间的浮点值，单位为 dB。 |
| 获取实际衰减与设定值衰减之间的差异 | 美国之音： 错误或者？ | 返回 VOA 提供的衰减与衰减设定值之间的差值，以 dB 为单位的浮点值。 |
| 获得美国之音提供的测量衰减 | 美国之音：测量过吗？ | 返回 VOA 提供的衰减值，以 dB 为单位的浮点值。 衰减值是VOA前后测得的光功率的计算比值。 |
| 将 VOA 模式设置为恒定光输出 | 美国之音：模式：1 | 将 VOA 模式设置为恒定光输出功率，并在收到命令时返回 1。 在此模式下工作时，监测 VOA 后测量的光功率和 VOA 偏置电压tage 被调整以维持所要求的光输出功率。 保持光输出功率恒定需要足够的光功率输入。 |
| 将 VOA 模式设置为恒定衰减 | 美国之音：模式：0 | 将 VOA 模式设置为恒定光衰减，并在收到命令时返回 1。在此模式下操作时，将监控 VOA 之前和之后测量的光功率水平。VOA 偏置电压tage 被调整以保持两者之间的指定比率。 |
| 获取美国之音模式 | 美国之音：模式？ | 如果 VOA 模式设置为恒定光衰减，则返回 0；如果 VOA 模式设置为恒定光输出功率，则返回 1。 |
| 以 dBm 为单位设置光输出功率值 | 美国之音：输出：DBM：N | N 被解释为 -20.0 和 20.0（含）之间的浮点值，单位为 dBm。该命令设置 VOA 的光输出功率，收到命令后返回 1。虽然该范围超过了内置激光器的最大功率输出，但支持整个范围以适应更高功率的外部激光源的使用。如果在恒定衰减模式下设置该值，则不会影响 VOA 的工作。在这种情况下，当激活恒定功率模式时，该值将被缓存并应用。 |
| 命令 | 句法 | 描述 |
| 获取以 dBm 为单位的光输出功率值 | VOA：输出：DBM？ | 以 -20.0 至 20.0 之间的浮点值（含 -XNUMX 和 XNUMX）返回 VOA 的功率设置，单位为 dBm。 |
| 以 mW 为单位设置光输出功率值 | 美国之音：输出：MW：N | N 是介于 0.01 和 100.0（含）之间的浮点值，单位为 mW。此命令设置 VOA 的光输出功率，并在收到命令时返回 1。虽然此范围超出了内置激光器的最大功率输出，但支持整个范围以适应使用更高功率的外部激光源。如果在恒定衰减模式下操作时设置此值，则不会影响 VOA 的操作。在这种情况下，该值将被缓存并在激活恒定功率模式时应用。 |
| 获取以 mW 为单位的光输出功率值 | VOA：输出：MW？ | 将 VOA 的功率设置返回为介于 0.01 和 100.0（含）之间的浮点值，单位为 mW。 |
| 设置 VOA 开机 | 美国之音：功率：1 | 将 VOA 电源设置为“打开”并在收到命令时返回 1。当 VOA 通电时，会启动主动且自动的软件控制环路来改变 VOA 偏置电压tage. 这会根据 VOA 操作模式保持所需的衰减水平或光输出功率。 |
| 设置 VOA 电源关闭 | 美国之音：功率：0 | 将 VOA 电源设置为“关闭”并在收到命令时返回 1。由于 VOA 与光路一致，因此存在与之相关的插入损耗。当VOA断电时，VOA偏置电压tage 设置为 0.0 V，这将通过 VOA 的光衰减降至最低。 |
| 获取美国之音电源状态 | 美国之音：权力？ | 如果 VOA 电源设置为“关闭”，则返回 0；如果 VOA 电源设置为“打开”，则返回 1。 |
| 获取美国之音状态 | 美国之音：设定点？ | 如果 VOA 提供的衰减在衰减设定点的 1 dB 范围内，则返回 0.1，并且仪器触摸屏的 VOA 字段中会显示稳定的绿点。 VOA提供的衰减是VOA之前和之后测量的光功率的计算比率。如果在恒定功率模式下运行，衰减设定点参考最后请求的功率设置；如果在恒定衰减模式下运行，则衰减设定点参考最后请求的衰减设置。如果 VOA 提供的衰减与衰减设置点之间的差异 >0.1 dB，则返回 0。该命令返回一个有效值，无论是否
VOA 已打开。 |
| 获取 VOA 的光功率输出，单位为 dBm | VOA:TAP：DBM？ | 将 VOA 的测量光输出作为浮点值返回，单位为 dBm。 |
| 获得 VOA 的光功率输出，单位为 mW | 美国之音：TAP：兆瓦？ | 将 VOA 的测量光输出作为浮点值返回，单位为 mW。 |
遥控软件
Thorlabs 为运行 Windows 操作系统（Windows 7 及更高版本）的计算机提供软件工具。 远程控制应用程序主要用作参考 example 以及用于探索各种远程控制命令的行为和交互的工具。 使用它来试验所有当前支持的激光和 VOA 命令，以及查看 exampMX 和 MBX 系列、TLX1 和 TLX2 仪器的传出命令和回复的文件。该工具向仪器发送串行命令，但该应用软件不适用于系统集成，因为它不支持运行脚本或进程。
安装软件并打开与仪器的连接
首先访问以下链接下载应用程序软件，输入仪器的项目编号，然后单击列表中显示的软件下载图标 files 可供下载。 https://www.thorlabs.com/manuals.cfm 解压 file 其名称以“RCUP”开头。 保留“Remote Control Utility Program.exe” file 在与“platforms”文件夹和其他支持相同的目录中 files，因为如果它们分开，应用程序将无法运行。在运行应用程序之前，请使用第 1.2 节中所述的适当电缆连接仪器和控制计算机。打开仪器电源并确保前面板上的电源按钮呈绿色亮起且触摸屏处于活动状态。等待计算机发现仪器，然后启动应用程序。应用程序窗口如图 7 所示。实际的应用程序窗口不包括图 7 中所示的红色、绿色、蓝色、紫色和橙色轮廓，这些轮廓是出于说明目的而绘制在窗口图像上的。
选择与仪器上使用的连接器相对应的“连接类型”单选按钮。 （单选按钮的位置由图 7 中的红色轮廓指示。）然后单击“连接”按钮打开与仪器的连接。
单击“连接”按钮后，位于绿色轮廓包围区域底部的“状态”字段应显示几行文本。如果应用程序与仪器建立连接，状态字段中显示的文本将以“设备已成功打开”结束。如果计算机和仪器之间未建立连接，“状态”字段中的文本将指出失败。连接失败的常见原因是仪器未被计算机识别；除非计算机已发现该仪器，否则软件无法找到该仪器。计算机最多可能需要 30 秒才能识别仪器。如果设备无法成功打开，我们建议关闭远程控制应用程序，等待几秒钟，重新打开应用程序，然后再次尝试连接到仪器。应用程序可能无法成功打开与仪器的连接的其他原因包括连接已打开或应用程序的另一个副本正在运行。如果这些都不是问题的根源，并且使用不同的 USB 电缆时问题仍然存在，请联系 Thorlabs 的技术支持寻求帮助。
使用远程控制应用程序
使用应用程序时，单击应用程序窗口顶部的按钮可将串行命令发送到 MX 和 MBX 系列、TLX1 和 TLX2 仪器。单击按钮的结果会记录在三个矩形文本字段中，这些文本字段以图 7 中的绿色轮廓为边界。计算机发送的命令将写入 PC 输出字段，从仪器发送回的数据将响应命令写入远程仪器输出字段，软件状态写入状态字段。通过使用“远程仪器输出”字段右侧的“保存”和“清除”按钮，可以在“远程仪器输出”字段中保存或清除命令响应，并在图 7 中以橙色轮廓边框显示。
计算机发送并写入 PC 输出字段的命令可以使用 PC 输出字段右侧的保存和清除按钮进行保存或清除，并在图 7 中以橙色轮廓为边框。格式正确的文本 files，通过使用 PC 输出字段的保存或通过用户输入，可以使用加载按钮将包含 SCPI 命令的内容加载到应用程序。 加载后，用户可以选择“开始”按钮开始按顺序发送加载的文本 file SCPI 命令。启动后，用户可以选择“停止”按钮停止向仪器发送命令。再次点击“开始”按钮将从加载的 file. 以下前amp这些文件说明了软件的操作以及软件与包含内置激光器的仪器（例如 MX40G）前面板上的触摸屏界面之间的交互。前任ample: 使用应用程序更改激光器的 ITU 频道
- 将“通道”控件（在蓝色轮廓内）调整为 5。
- 单击“设置频道”按钮（在紫色轮廓内）。
- 发送给仪器的命令文本“LAS:CHAN 5”被打印到“PC 输出”字段（绿色轮廓内）。
- 短暂延迟后，文本“1”打印到“远程仪器输出”字段（绿色轮廓内）。这表明仪器已收到命令。
- 打印到“状态”字段的文本表示已收到响应。
- 单击“获取频道”按钮（紫色轮廓下方）。
- 文本“LAS: CHAN?”（发送到仪器的命令）被打印到“PC 输出”字段（绿色轮廓内）。
- 短暂延迟后，文本“5”，即最近请求的 ITU 通道，被打印到“远程仪器输出”字段（在绿色轮廓内）。
Example：在 MX40G 的前面板触摸屏上使用软件应用程序
- 从主屏幕导航到激光设置页面，如图 8 所示
- 使用激光设置页面将 ITU Chanel 更改为 6。
- 单击远程控制应用程序中的“获取频道”按钮（在紫色轮廓内）。
- 发送到 MX40G 的命令“LAS:CHAN?”文本被打印到“PC 输出”字段（绿色轮廓内）。
- 短暂延迟后，文本“6”，即使用触摸屏输入的 ITU 通道，将打印到“远程仪器输出”字段（绿色轮廓内）。
软件应用截图
激光选项卡（图 9）中的功能对应于第 2.3 节中描述的命令：激光控制命令
VOA 选项卡（图 10）中的功能对应于第 2.6 节：可变光衰减器 (VOA) 命令中描述的命令。
中的函数 Amp 选项卡（图 11）对应于第 2.2 节中描述的命令：RF Amplifier 命令。
MZM Bias 选项卡（图 12）中的功能对应于第 2.4 节：Mach-Zehnder EO 强度调制器命令中描述的命令。
系统选项卡（图 13）中的功能对应于第 2.5 节：系统命令中描述的命令。
定制应用程序开发
对于有兴趣开发定制软件的用户来说，一个选择是使用我们的远程控制应用程序作为参考和起点。请联系我们索取源代码。使用此源代码和开发平台（例如 Qt® 软件的免费版本），我们的 examp应用程序可以修改和扩展。当计算机连接到 MX 和 MBX 系列、TLX232 和 TLX1 仪器上的 RS-2 端口时，命令将直接发送到仪器的通用异步接收器/发射器 (UART)。对于通过 USB 与仪器通信的应用程序，情况并非如此。在这种情况下，计算机发送的命令将 Silicon Labs® USB 寻址到仪器内置的 UART 桥接芯片。UART 与桥接芯片连接。Silicon Labs 提供的动态链接库 (DLL) web站点可用于与桥接芯片进行通信。 如果您在开发自定义测试配置时有疑问或需要指导，请联系我们。 我们很乐意为您提供帮助。
Thorlabs 全球联系人
如需技术支持或销售咨询，请访问我们 www.thorlabs.com/contact 获取我们最新的联系信息。
公司总部 Thorlabs, Inc. 43 Sparta Ave Newton, New Jersey 07860 United States sales@thorlabs.com techsupport@thorlabs.com
欧盟进口商
Thorlabs GmbH Münchner Weg 1 D-85232 Bergkirchen 德国 sales.de@thorlabs.com 欧洲@thorlabs.com
产品制造商
Thorlabs 超快光电子 110 Parkland Plaza 安娜堡, 密歇根州 48103 美国 sales@thorlabs.com techsupport@thorlabs.com 英国进口商 Thorlabs Ltd. 204 Lancaster Way Business Park Ely CB6 3NX
英国
sales.uk@thorlabs.com techsupport.uk@thorlabs.com
文件/资源
 |
THORLABS MX 系列远程控制线性参考发射器 [pdf] 用户指南 MX系列、MX系列远程控制线性参考变送器、远程控制线性参考变送器、控制线性参考变送器、线性参考变送器、参考变送器、变送器 |
