SCPI instruments
使用 SCPI 的台式仪器，例如万用表、电源、电子负载和数据采集仪，通过 TCP、串行线路，或经由 VISA 的 USB 和 GPIB 连接：每种连接方式、“仪器”卡片、查询和写入命令、设备发现，以及两个完整示例。
SCPI instruments 驱动读写使用 SCPI 的台式仪器。SCPI 是 IEEE 488.2 测试设备的命令语言，覆盖万用表、电源、电子负载、数据采集仪（例如 Fluke 1586A Super-DAQ）、校准器，来自 Keysight、Rigol、Tektronix、Siglent、GW Instek、B&K Precision、Fluke 等厂商。每个点位向仪器发出一条查询，例如 MEAS:VOLT:DC? 或 READ?，并读取它的应答；被写入的点位发送一条带有数值的命令，例如 VOLT 5。这正是 LabVIEW 程序通过 VISA 进行的交互，只是在面板上设置，而不是在程序框图里连线；数值也像其他所有点位的数值一样，进入 Logic、仪表板，以及 Process 测试台的运行记录。
仪器通过以下三种方式之一连接，在创建它的设备时选定：
| 传输方式 | 如何连接仪器 | 适用于 |
|---|---|---|
| TCP（LXI 套接字） | 仪器在其主机和端口上的 SCPI 套接字，大多数 LXI 仪器为 5025。本计算机上不需要安装任何东西。 | 带网口的仪器。 |
| VISA（USB、GPIB、网络） | 通过本计算机上安装的 VISA，按仪器的 VISA 资源名称连接。本产品不安装 VISA：只要装有 NI-VISA 或 Keysight IO Libraries Suite 之一，就使用它。 | 接在 USB 或 GPIB 接口上的仪器，或 VISA 按自己的名称连接的网络仪器。 |
| 在串行线路上 | 本驱动的一条串行线路，与线路上的其他仪器共用，一次只发一个请求。 | 带 RS-232 或 RS-485 接口的仪器。 |
串行线路上的仪器挂在它的线路下面，所以树的这一部分和 Generic serial and TCP 一样读作驱动 → 线路 → 设备 → 点位。通过 TCP 或 VISA 连接的仪器挂在驱动下面，可以像任何其他驱动的设备一样归入文件夹，即驱动 → 文件夹 → 设备 → 点位。设备留在创建时所在的一侧：TCP 和 VISA 可以互换，但设备绝不会在线路和网络之间移动。
驱动页面
标题栏下面那行写着“串行线路下挂共用一条总线的仪器，通过 TCP 或 VISA 连接的仪器直接挂在驱动下。添加一条线路或一台设备，然后打开它填写其查询。”，页面上下依次排着：
| 部分 | 包含什么 |
|---|---|
| 串行线路 | 驱动的线路，用标题右侧的添加线路增加：线路、物理参数组（端口 · 波特率 · 格式，不含超时，因为本驱动的线路没有超时）、设备、状态，以及打开、启用、禁用和删除操作。为空时显示“还没有串行线路。” |
| 扫描范围 | 发现设备在 VISA 列出的仪器之外还要询问的地址；见设备发现。只为有“配置 Connector”权限的角色绘制。 |
| 设备 | 驱动的所有设备，包括线路上的设备，列与任何驱动的设备表相同，用标题右侧的添加设备增加，它创建一台 TCP 设备。为空时显示“还没有设备。” |
标题栏在括号里显示设备数；只要有一条线路，树中的驱动行就会同时计数两层（“1 条线路 · 2 台设备”）。驱动的命令栏上有发现设备。右键单击驱动行会提供添加设备、添加线路、新建文件夹、刷新和发现设备，一条分隔线之后是移除驱动；在栏底的“新建…”菜单里，本驱动那一项提供新建设备、新建串行线路和新建文件夹，然后是它的线路、文件夹和设备。驱动添加之后就出现在树里的“驱动”文件夹下面，不论有没有线路或设备。
串行线路
本驱动的线路就是串行线路中描述的那种线路，字段与 Generic serial and TCP 驱动的线路相同。它的页面写着“一条物理串行总线：其上仪表共用的端口设置，一次只发一个请求。”，“物理线路”卡片包含名称、串行端口（带刷新）、波特率和串行格式，十种格式全部可选，其中 8 位的六种，7 位的四种。它没有传输模式、响应超时、最小事务间隔，也没有发现单元的卡片：每台仪器在自己的“仪器”卡片上说明什么结束它的消息、等待应答多久；仪器靠问它的内容区分，而不是靠地址，所以线路的“设备”表没有单元 ID 列。
在这里创建的线路一开始是禁用的，以便在端口打开之前输入端口设置；端口、波特率和格式只有在线路禁用时才能修改。在线路上或它的右键菜单里点添加设备，会在这条线路上创建一台本驱动的设备。线路永远属于创建它时所在的驱动：其他驱动的设备不会挂到它上面，一个端口只属于一条线路，无论线路属于哪个驱动。
驱动为线路上的所有仪器只打开一次端口，一次发送一个请求，等到应答后才发下一个。端口打开期间它保持 DTR 有效，因为通过 DTR 和 DSR 控制输出节奏的仪器（例如 Keysight 34401A 或 E36xx 电源）在 DTR 无效时什么也不发送。端口故障后，会在一段暂停后重新打开，只要故障持续，暂停时间就从 1 秒翻倍直到 1 分钟；端口上的每台仪器都会重新准备，像第一次连接时一样重新发送初始化命令。
设备
连接
| 字段 | 含义 | 默认值 |
|---|---|---|
| 传输方式 | 在驱动下创建的设备：TCP（LXI 套接字），“工作站连接到仪器的 SCPI 套接字，即其主机和端口；大多数 LXI 仪器为 5025。”，或 VISA（USB、GPIB、网络），“工作站通过本计算机上安装的 VISA，按 VISA 资源名称打开仪器。”两者可以互换；线路上的设备在这里显示它的线路。 | TCP（LXI 套接字） |
| 主机 | TCP：仪器的主机名或 IP 地址。 | 空 |
| 端口 | TCP：仪器应答 SCPI 的端口，1 到 65535。框留空时以灰色显示 5025，并按该端口连接仪器。 | 5025 |
| VISA 资源 | VISA，取代主机和端口：“VISA 列出的仪器名称，例如 USB00x09570x1A07MY12345678INSTR 或 GPIB022INSTR。发现设备会自动填入。”这就是 NI MAX 和 Keysight Connection Expert 为仪器显示的名称。 | 空 |
| 串行线路 · 固定 | 线路上的设备：线路名称及其下的端口、波特率和格式，只读。 | 添加它时所在的线路 |
新设备是一台 TCP 设备：它显示“尚未填写主机”，在有主机之前不会连接。VISA 设备不连接任何主机，也从不等待主机。切换到 VISA 会保留主机和端口，供切回 TCP 时使用；切换到 TCP 会保留资源。驱动无法处理的设备不会保存，操作记录条会说明原因：
| 你输入 | 操作记录条显示 |
|---|---|
| 1 到 65535 之外的端口 | “请输入 1 到 65535 之间的端口，或留空以使用 5025。” |
| VISA 但没有资源 | “请输入仪器的 VISA 资源，例如 USB00x09570x1A07MY12345678INSTR，或运行发现设备。” |
| 含有空格或普通 ASCII 以外字符的资源 | “VISA 资源中含有空格或普通 ASCII 以外的字符。请按 VISA 列出的样子输入。” |
标题栏显示的 Base URI 就是运行时地址：scpi://tcp/<host>:<port>、scpi://visa/<resource> 或 scpi://serial/<line id>/<port>/<baud>/<format>，后面依次跟着结束符（term）、响应超时（timeout）、写入确认（check）和初始化命令（setup，一条接一条，用 %0A 分隔）。线路上设备的副本留在那条线路上；TCP 或 VISA 设备的副本落在驱动本身这一层。
“仪器”卡片
在“连接”卡片下面，仪器卡片说明仪器是什么，以及工作站如何与它对话。
| 字段 | 含义 | 默认值 |
|---|---|---|
| 标识（*IDN?） | 只读：“工作站连接时仪器对 *IDN? 的应答：制造商、型号、序列号和固件版本。”在仪器应答之前显示“尚未应答”，设备不再连接时又回到这个显示。不应答 *IDN? 的仪器照样读取，只是没有标识。 |
|
| 结束符 | LF（换行）、CR LF（回车、换行）或 CR（回车）：“结束每条发送的命令和每条读取的应答。几乎所有仪器都用 LF；部分串口仪器使用 CR LF 或 CR。” | LF（换行） |
| 响应超时（ms） | 100 到 60000：“查询等待应答、写入等待仪器错误队列的时间。测量较慢时需要更长。” | 2000 |
| 写入确认 | “SCPI 不对任何命令作出确认，因此写入要在之后询问仪器来确认。”每个选项发送什么，见写入：错误队列（SYST:ERR?）、无：发送即确认，或者等命令执行完毕再查错误队列，即 先确认完成，再查错误队列（*OPC?、SYST:ERR?）。 | 错误队列（SYST:ERR?） |
| 初始化命令 | 每行一条命令，最多 32 条，每条最多 512 个字符：“工作站每次连接时按顺序发送，每行一条，例如 *RST 或 CONF:VOLT:DC 10。它们引起的错误写入诊断日志。” | 空 |
工作站每次连接仪器，以及串行线路每次重新打开端口时，都按顺序发送：写入确认读取错误队列时先发 *CLS，然后是初始化命令，接着把错误队列读入诊断日志（初始化命令引起的错误记在那里，不会让设备停下），最后询问 *IDN?，其应答就是“标识”字段显示的内容。卡片不接受的值不会保存，操作记录条会说明原因：“响应超时必须在 100 到 60000 ms 之间。”、“某条初始化命令含有普通 ASCII 以外的字符（例如排版引号），任何仪器都无法读取。”或“初始化命令最多 32 条，每条最多 512 个字符。”SCPI 是普通 ASCII，所以从手册里复制来、带有排版引号或不换行空格的命令，会在输入时就被拒绝，而不是发给一台读不懂它的仪器。
本计算机上的 VISA
本产品不带 VISA，也不安装 VISA。VISA 设备通过本计算机上已有的 64 位 VISA 库（visa64.dll）打开仪器，NI-VISA（LabVIEW 会安装它）和 Keysight IO Libraries Suite 都会把这个库放到这里。只有 VISA 设备需要它：走 TCP 或串行线路的仪器不用它也能连接。工作站会自己检查这个库能否加载，不必等待设备：驱动的页面、VISA 设备的页面或智能体第一次询问时检查一次，缺少期间每 30 秒再检查一次。在 Connector 启动之前，不知道是否有 VISA，因此什么也不显示。缺少期间：
| 在哪里 | 显示什么 |
|---|---|
| VISA 设备的页面 | 一条注意提示“本计算机未安装 VISA”，以及下面的步骤。它的两个链接会在计算机的浏览器里打开 NI 和 Keysight 的页面。 |
| 驱动的页面 | 只要驱动至少有一台 VISA 设备，就显示同一条提示，并附上“安装之前，此驱动中走 VISA 的设备保持离线，配置保持不变；走 TCP 或串行线路的设备不受影响。”只有 TCP 设备和串行设备的驱动不显示。 |
| VISA 设备的最后一个错误 | 同样的步骤，与驱动自身的原因一样用英文写出。设备保持离线，配置保持不变。 |
| “传输方式”列表 | 仍然提供 VISA，这样可以在安装 VISA 之前先准备好设备。 |
| 发现设备 | 只询问在“扫描范围”卡片里输入的主机，并连同两个页面一起说明：“本计算机未安装 VISA，因此扫描无法通过它列出 USB、GPIB 或网络仪器，只询问输入的主机。要列出它们，请以管理员身份安装 64 位 VISA”，后面跟着 NI-VISA 和 Keysight IO Libraries Suite 的地址。这句话会留在结束扫描的那一行里。 |
| 智能体 | driver_capabilities 在 Scpi 驱动的 prerequisite 下给出这些步骤，installed 为 false，neededBy 指出 VISA 设备；device_discover 在 cut 里说明同样的内容。 |
安装方法：
- 从 NI 的页面 NI-VISA Download 下载 NI-VISA，或者从 Keysight 的页面 IO Libraries Suite Downloads 下载 Keysight IO Libraries Suite。
- 两者任选其一即可，装有 LabVIEW 的计算机已经有 NI-VISA。NI 的页面在下载前要求用 NI 账户登录；Keysight 的页面直接链接到安装程序。请选择最新的 Windows 安装程序：在 64 位 Windows 上，两者都会安装 64 位 VISA，这是 Ganter Lab 唯一能识别的版本。
- 从 C: 盘上的文件夹以管理员身份运行安装程序（Keysight 的安装程序不能从其他盘安装），并在它要求时重启计算机。
只安装了 32 位库（visa32.dll）的 VISA（例如为 32 位 Windows 制作的）不会被识别：Ganter Lab 只读取 64 位的 visa64.dll。
安装后 30 秒内，提示会消失，VISA 设备按现有配置连接，无需重启 Ganter Lab。带网络端口的仪器也可以不用 VISA，通过 TCP 连接。
点位寻址
本驱动的点位向它的仪器发出一条查询。它的信号源卡片包含：
| 字段 | 含义 | 默认值 |
|---|---|---|
| 查询 | 点位要问的内容，按仪器编程手册的写法：MEAS:VOLT:DC?、READ?、SOUR:VOLT?、OUTP?。普通 ASCII，最多 512 个字符。只写点位什么也不问，也不需要查询。 |
必填 |
| 应答中的值 | 被读取的点位。“留空读取整个应答。填数字则读取逗号分隔应答中从 1 数起的那个值，例如 READ? 的第三个通道填 3。”框为空时显示“整个应答”。1 到 1000。 | 空 |
| 写入命令 | 被写入的点位：“写入时发送的内容，在数值所在位置放 ，例如 VOLT 或 CURR 。Boolean 以 1 或 0 发送。对 Boolean 点位，不含 的命令（例如 *TRG）在写入 true 时发送。” | 必填 |
点位的访问方式用不到的字段不会绘制，并保留它的值，等再次用到时使用。数据类型有 Boolean、Int32、Int64、Float、Double 和 String，默认 Float。字段无法成立的点位不会保存，点位页面会说明缺少什么：
| 你输入 | 点位页面显示 |
|---|---|
| 被读取的点位没有查询 | “请输入向仪器发出的查询，例如 MEAS:VOLT:DC?，或将点位设为只写。” |
| 查询含有排版引号或其他普通 ASCII 以外的字符 | “查询含有普通 ASCII 以外的字符（例如排版引号），或超过 512 个字符。” |
| 应答中的值超过 1000 | “应答中的值从 1 数到 1000。留空则读取整个应答。” |
| 被写入的点位没有写入命令 | “请输入写入时发送的命令，例如 VOLT ，或将点位设为只读。” |
不是 {value} 或 {value:FORMAT} 的花括号，或者值出现两次 |
“写入命令含有普通 ASCII 以外的字符、不是 或 的花括号，或者值出现了两次。” |
非 Boolean 点位上不含 {value} 的命令 |
“请在写入命令中数值所在位置放 。只有 Boolean 点位可以不带它发送命令。” |
| 不格式化数字的格式，或者用在 Boolean 或 String 点位上的格式 | “value: 后面的格式必须用于格式化数字，例如 0.000 或 F2，并且只有数值点位可以使用。” |
只读的源地址（总线）一行显示驱动收到的内容：读取整个应答的点位是 ask=READ?，读取其中第三个值的是 ask=READ?&field=3，既读又写的点位是 ask=VOLT?&write=VOLT {value}，只写点位是 write=*TRG。
读取
在点位的轮询间隔，工作站发送查询，并在响应超时之内读取一条直到结束符为止的应答。取出的文本，即整个应答或点位指定的那个值，先按点位的类型读取，再由点位自己的各个环节换算，和所有驱动一样（见数值转换链）：
| 应答内容 | 读作 |
|---|---|
+1.23456789E+00、-0.5、12 |
Float 或 Double：这个数，无论工作站用什么语言，小数分隔符都是点。 |
9.91E37 |
SCPI 的非数值，即仪器没有读数时的应答：在 Float 或 Double 点位上读作 NaN，由它的无效读数环节处理；在 Int32 或 Int64 点位上被拒绝。9.9E37 表示超量程，仍然读作这个数。 |
+1.20000000E+01 |
Int32 或 Int64：12。小数被拒绝。 |
1、ON、0、OFF |
Boolean：1 和 ON 为真，0 和 OFF 为假；true、false、yes 和 no 也能读。 |
"Ready, armed" |
String：去掉引号的字符，连写的两个引号变成一个。引号内的逗号不分隔值。 |
| 情况 | 读取会怎样 |
|---|---|
| 同一设备上发出相同查询的点位 | 它们在其中最短轮询间隔的一半时间内共用一条应答，所以读取多通道 READ? 各个通道的点位只花一次测量。任何一次写入都会丢弃所有保留的应答。 |
| 响应超时之内没有应答 | 读取失败。设备读取错误队列时，工作站随后会问 SYST:ERR?，所以写错的查询失败时，原因里带有仪器自己的条目，例如 -113,"Undefined header"。点位针对设备没有应答的策略决定它显示什么。 |
| 应答中的值少于点位指定的序号 | 读取失败，并说明应答有几个值。 |
| 点位类型容纳不了的文本 | 读取失败，并写出这段文本。 |
写入
写入和其他任何驱动的写入走同一个通道：写入框接收工程值，在发送原始值之前把转换环节倒过来执行（见 Connector）。发送的命令就是写入命令，在 {value} 的位置放上数值：数字用不变区域性写出，取能读回同一个数的最短文本，或按 {value:FORMAT} 用 .NET 数字格式格式化（CURR {value:0.000} 把 1.5 发送为 CURR 1.500）；Boolean 发送为 1 或 0，所有 SCPI Boolean 参数都接受；文本照原样发送，由命令自己带上所需的引号（DISP:TEXT "{value}"）。非数值和无穷大在发送任何东西之前就被拒绝。在 Boolean 点位上，不含 {value} 的命令（例如 *TRG）在写入 true 时发送，写入 false 被拒绝。
| 写入确认 | 发送什么 | 写入报告什么 |
|---|---|---|
| 错误队列（SYST:ERR?） | *CLS、命令、SYST:ERR? |
队列应答没有错误（0 或 +0,"No error"）时写入完成。任何其他条目都会用仪器自己的话拒绝写入，例如 -222,"Data out of range"。没有应答就是没有响应：不知道仪器是否接受了这个值。 |
| 先确认完成，再查错误队列（*OPC?、SYST:ERR?） | *CLS、命令、*OPC?、SYST:ERR? |
同上，但要等仪器执行完命令：用于需要稳定的输出或需要切换的继电器。 |
| 无：发送即确认 | 只有命令 | 一发送就完成，用于没有错误队列的仪器。这时没有应答的查询在报告中不带仪器的错误。 |
写入和读取一起在设备的队列里排队：在线路上，它们共用线路一次一个的请求；通过 TCP 和 VISA 时，使用设备自己的连接。
设备发现
驱动页面带有一张扫描范围卡片，里面有一个可选的框，“用于 TCP 探测的仪器地址，例如 192.168.0.20 或 192.168.0.20:5025（留空则查找 VISA 列出的仪器）”。发现设备随后依次问两个问题：
| 问题 | 何时 | 提供什么 |
|---|---|---|
VISA 列出的每个仪器资源，无论在 USB、GPIB 还是网络上，依次打开并用 *IDN? 询问。进度行逐个写出：“正在询问 USB00x09570x1A07MY12345678INSTR 的标识…”。 |
本计算机安装了 VISA 时。没有 VISA 时，扫描会说明这一点以及 VISA 的下载位置，这句话会留在结束扫描的那一行里（本计算机上的 VISA）。 | 每台应答的仪器，作为已填好资源的 VISA 设备。 |
通过 TCP 向框中的主机发 *IDN?，使用它的端口或 5025：“正在询问 192.168.0.20:5025 的标识…”。 |
只有框中有地址时。 | 这台仪器，作为该主机和端口上的 TCP 设备。 |
每台仪器有 1.5 秒应答，不应答的仪器不会提供。候选项按它应答的制造商和型号命名（Keysight Technologies 34461A），带有“仪器”卡片的所有默认值，不带任何点位，因为仪器不会公布它的查询列表：“没有报告任何点位。把设备添加进来，再在它的编辑器里配置点位。”资源已被本驱动某台设备使用的 VISA 候选项会标为已配置，提供“打开”而不是“添加”；通过 TCP 找到的仪器从不匹配，因为主机只是连接仪器的地方。VISA 把计算机的每个串口都列为资源（ASRL3::INSTR），不管有没有接东西，询问就会写到接在上面的东西上：扫描会把它们排除在外，串口仪器应放在本驱动的串行线路上。在 VISA 设备上手工输入的串口资源照样会打开。框里不是主机的内容会在框下被拒绝，发现设备变灰：“SCPI 扫描通过 TCP 请这里填写的仪器报告自身标识：填写它的 IP 地址或名称，需要时带上端口（例如 192.168.0.20 或 192.168.0.20:5025）。留空则只询问 VISA 列出的仪器。”扫描的其他行为见设备发现。
示例：TCP 上的万用表
网络上的 Keysight 34461A 在它的 LXI 套接字（端口 5025）上应答 SCPI。读取它的直流电压：
- 在驱动页面上点添加设备；命名为
DMM，保持 TCP（LXI 套接字），主机填 192.168.0.20，端口保持 5025。 - 在仪器卡片上保持 LF（换行）、响应超时（ms） 2000 和错误队列（SYST:ERR?），并输入两条初始化命令，先
*RST再CONF:VOLT:DC 10：工作站每次连接时，万用表都会复位并设为 10 V 量程的直流电压测量。 - 连接后，“标识”字段显示万用表的应答，例如
Keysight Technologies,34461A,MY53212345,A.02.14-02.40-02.14-00.49-02-01。 - 点添加点位；命名为
Voltage，Double，只读，查询填READ?，应答中的值留空，单位填 V。READ?按设定的功能测量一次并应答结果。
Base URI 为 scpi://tcp/192.168.0.20:5025?term=lf&timeout=2000&check=errorqueue&setup=*RST%0ACONF:VOLT:DC 10。智能体用两次工具调用完成同样的事：
device_upsert driver=Scpi name=DMM transport=Tcp host=192.168.0.20 port=5025 setupCommands='*RST\nCONF:VOLT:DC 10'
tag_upsert device=DMM name=Voltage opcUaType=Double address='READ?' unit=V
示例：RS-232 上的电源
Keysight E3631A 在它的 RS-232 接口上应答 SCPI，9600 波特、8 个数据位、无校验、2 个停止位；通过 RS-232 时，它要先切到远程模式才接受命令。设置它的电压、切换输出并读取电流：
- 在驱动页面上点添加线路；命名为
PSU line，选COM4，波特率设为 9600，串行格式设为8N2，然后启用这条线路。 - 在线路上点添加设备；命名为
PSU。在仪器卡片上把响应超时（ms）设为 3000，在初始化命令里只输入一行SYST:REM，并把写入确认设为先确认完成，再查错误队列（*OPC?、SYST:ERR?），这样写入要等输出跟上之后才算完成。 - 点添加点位
Setpoint，Double，读写，查询VOLT?，写入命令VOLT {value}。 - 点添加点位
Output，Boolean，读写，查询OUTP?，写入命令OUTP {value}：写入 true 发送OUTP 1，写入 false 发送OUTP 0，电源对OUTP?应答 1 或 0。 - 点添加点位
MeasuredCurrent，Double，只读，查询MEAS:CURR?，单位 A。
Setpoint 点位的总线地址是 ask=VOLT?&write=VOLT {value}。像这台一样有多路输出的电源，作用于它当前选中的那一路；再加一条初始化命令，例如 INST:SEL P6V，即可选定。用智能体的工具完成同样的事：
serial_line_upsert driver=Scpi name='PSU line' serialPort=COM4 baudRate=9600 serialFormat=8N2
device_upsert driver=Scpi name=PSU transport=SerialLine serialLineId=<id> responseTimeoutMs=3000 setupCommands='SYST:REM' writeCheck=CompletionAndErrorQueue
tag_upsert device=PSU name=Setpoint opcUaType=Double accessType=ReadAndWrite address='VOLT?' writeTemplate='VOLT {value}'
tag_upsert device=PSU name=Output opcUaType=Boolean accessType=ReadAndWrite address='OUTP?' writeTemplate='OUTP {value}'
tag_upsert device=PSU name=MeasuredCurrent opcUaType=Double address='MEAS:CURR?' unit=A
智能体工具
driver_capabilities 在 scpi 下描述本驱动：三种传输方式、本计算机是否有 VISA（在 prerequisite 下，附带安装的每个步骤）、结束符、响应超时、写入确认、初始化命令、查询和写入命令的写法、应答如何读取、设备发现，以及上面的两个示例。device_upsert driver=Scpi 接受 transport（Tcp 为默认，Visa，或由 serialLineId 隐含的 SerialLine）、TCP 用的 host 和 port、VISA 用的 visaResource、本驱动线路用的 serialLineId、terminator（Lf、CrLf 或 Cr；也接受 \n、\r\n 和 \r）、responseTimeoutMs（100 到 60000）、writeCheck（ErrorQueue、CompletionAndErrorQueue 或 None）和 setupCommands（每行一条，或用 \n 分隔；'' 清空）。tag_upsert 接受作为 address 的查询、valueField（1 到 1000；0 或省略则读取整个应答）和 writeTemplate（'' 清空）。serial_line_upsert driver=Scpi 创建本驱动的线路，只带 serialPort、baudRate 和 serialFormat。device_discover driver=Scpi 运行扫描，用 target 指定 TCP 探测。工具返回的设备带有 scpi，仪器应答后其中包含仪器的标识；点位也带有 scpi。其他工具见智能体工具。
值得了解的限制
- Fluke NetDAQ 2640A、2645A、2680A 和 2686A 说的是 Fluke 自己的协议，不是 SCPI：本驱动不读取它们。Fluke 1586A Super-DAQ 和 2638A Hydra Series III 说 SCPI，本驱动可以读取。
- 以 IEEE 488.2 二进制块（一个
#、一个长度和原始字节）发送的应答，例如波形或屏幕截图，不会读取：点位读取的是以文本写出的应答。 - 本产品不安装 VISA。本计算机上没有 NI-VISA 或 Keysight IO Libraries Suite 时，无法连接 USB 和 GPIB 仪器；TCP 仪器和串口仪器照常连接。
- 扫描不列出 VISA 的串口资源（
ASRL…::INSTR）：串口仪器应放在本驱动的串行线路上。 - 每个值都靠轮询读取：驱动不等待服务请求（SRQ），也不等待状态字节。
- 设备不能在串行线路和网络之间移动，也不能移到另一条线路：在它该在的地方创建，再删除旧的。