4. 仪器通信接口与协议
量子光学实验的自动化，本质上不是“让电脑控制仪器”，而是让上位机通过一条确定的物理链路，用一套双方都认得的语言，把参数写进仪器、把数据读回来。物理链路决定了速率、距离、拓扑和抗干扰能力；语言决定了命令怎么写、状态怎么查、错误怎么定位。把这两层分开理解，调试时就不会一遇到“连不上”就盲目换线或重装驱动。
物理层：五种接口各自的位置
GPIB（IEEE-488）是最经典的仪器总线，8 位并行、最高约 8 MB/s，一条总线最多挂 15 台设备，靠地址（0～30）区分。它的优势是确定性好、多机共享一条线、老牌激光器/锁相放大器/波长计几乎都带。缺点是线缆粗、需要专用 PCIe/USB-GPIB 卡，长距离布线不便。在量子光学里，它常用来连接需要频繁设定且对时序不敏感的设备，例如可调衰减器、部分激光控制器。
USB（USBTMC）是当前最普遍的接口，即插即用、速率高，适合示波器、数字化仪、单光子计数器等大数据量设备。注意 USB 是点对点拓扑，一台主机要接多台仪器必须用带供电的 Hub，且 Hub 质量差会引入偶发超时。USB 设备通常用厂商 ID/序列号识别，重插后端口号可能变化，脚本里应绑定序列号而非 COM 号。
以太网（LAN，含 LXI）适合分布式、长距离、高吞吐场景。它支持 TCP/IP 的 VXI-11、HiSLIP 或原始 socket 三种方式，一台仪器一个 IP，天然支持多主机访问。量子光学中常见的多机箱、跨光学平台、需要长时间无人值守采集的系统，优先选以太网。缺点是网络抖动会带来延迟不确定性，对硬实时触发不友好。
串口（RS-232/RS-485）速率低（常见 9600～115200 bps），但简单、可靠、延迟确定，很多温控器、步进电机驱动器、真空计、部分激光二极管控制器仍只提供串口。RS-485 还支持多点总线，适合把多台温控器串在一条线上。串口调试的核心是波特率、数据位、停止位、校验位、流控五项必须与仪器手册完全一致。
VISA：把五种接口统一成一套调用
VISA（Virtual Instrument Software Architecture）是 NI 主导的 I/O 抽象层，它把 GPIB、USB、TCP/IP、串口统一成“打开资源—写入—读取—关闭”四个动作。无论底层是哪种线，程序里都只面对一个资源字符串。资源字符串的通用格式是：
接口类型::板卡/地址::INSTR
GPIB0::8::INSTR # GPIB 板卡0，仪器地址8
USB0::0x0699::0x0401::C012345::INSTR # 厂商ID::型号ID::序列号
TCPIP0::192.168.1.20::INSTR # 以太网 VXI-11
TCPIP0::192.168.1.20::5025::SOCKET # 原始 socket，端口5025
ASRL3::INSTR # 串口 COM3（Linux 为 /dev/ttyUSB0）用 PyVISA 打开并查询的最小闭环如下。注意 query 等价于“写一条以 ? 结尾的命令，再读回一行”，而 write 只写不读。读回时 VISA 默认以换行符 \n 作为终止符，若仪器用 \r\n，需在 read_termination 中显式设置，否则会一直等到超时。
import pyvisa
rm = pyvisa.ResourceManager()
inst = rm.open_resource("TCPIP0::192.168.1.20::INSTR")
inst.timeout = 3000 # 单位 ms
inst.read_termination = "\n"
inst.write_termination = "\n"
print(inst.query("*IDN?")) # 例：Keysight Technologies,N9020A,...
inst.write(":SOUR:VOLT 2.500") # 设定激光调制偏置
inst.write(":OUTP ON")
print(inst.query(":MEAS:VOLT?")) # 读回实际值
print(inst.query(":SYST:ERR?")) # 查错误队列
inst.close()SCPI：命令怎么写、状态怎么查
SCPI（Standard Commands for Programmable Instruments）是建立在 IEEE-488.2 之上的命令语法。它用冒号分层，例如 :SOURce:VOLTage:LEVel:IMMediate:AMPLitude 2.5，可以缩写为 :SOUR:VOLT 2.5。带 ? 的是查询，返回一行文本；不带 ? 的是设置，通常不返回内容。量子光学中常用的几类命令：
- 识别与复位：
*IDN?、*RST、*CLS。 - 同步：
*OPC?在操作完成后返回 1，用于等待长程扫描或波长切换结束。 - 错误查询：
:SYSTem:ERRor?返回“错误号,描述”，0,"No error" 表示正常。 - 数据读取：
:READ?触发并读数，:FETCh?只取最近一次结果，:MEAS?立即测量。 - 状态位：
*ESR?读事件状态寄存器，*STB?读状态字节，用于轮询而非死等。
:SOUR:VOLT 合法，:SO:VO 不合法。建议脚本里保留完整拼写，便于日后阅读。实际调试：从连不上到稳定采集
假设一台单光子计数器通过以太网接入，程序报超时。按下面的顺序排查，通常几分钟内能定位：
- 物理连通：在终端执行
ping 192.168.1.20，确认网络可达；若不通，检查子网掩码与仪器 IP 是否同网段。 - 端口可达：用
telnet 192.168.1.20 5025或nc -vz 192.168.1.20 5025测试 socket 端口；VXI-11 则测 111 端口。 - 资源字符串：用
rm.list_resources()列出 VISA 实际看到的资源，避免手写地址拼错。 - 终止符与超时：把
timeout临时调到 10000 ms，read_termination分别试\n与\r\n。 - 命令正确性：先只发
*IDN?，通了再逐步加业务命令；每步后查:SYST:ERR?。 - 同步问题：长扫描后立即读数会读到旧值，应在设置后加
*OPC?或固定延时。
串口调试的典型坑是“能发不能收”：多数情况是波特率或流控不匹配，少数是仪器要求 \r\n 结尾而程序只发了 \n。GPIB 的典型坑是地址冲突或总线上一台设备未上电导致整条总线挂死，此时应逐台断开定位。USB 的典型坑是 Hub 供电不足导致偶发掉线，换带外部供电的 Hub 即可。
time.sleep() 代替 *OPC? 做同步。延时是猜测，*OPC? 是确认；在需要重复上千次的量子光学扫描中，猜测式延时要么拖慢整体，要么在个别慢操作上读到错误数据。一份可直接套用的接口选型与配置检查表
| 场景 | 推荐接口 | 资源字符串示例 | 关键配置 |
|---|---|---|---|
| 多台老式激光控制器共享总线 | GPIB | GPIB0::8::INSTR | 地址唯一、总线末端接终端电阻 |
| 示波器/数字化仪高速取数 | USB | USB0::0x0699::0x0401::SN::INSTR | 绑定序列号、用带供电 Hub |
| 跨光学平台、无人值守长采 | 以太网 | TCPIP0::192.168.1.20::INSTR | 固定 IP、关闭节能、设 read_termination |
| 温控器/位移台/真空计 | RS-232/485 | ASRL3::INSTR | 波特率、数据位、停止位、校验、流控五项一致 |
把这张表当作起点：先按场景选链路，再用 *IDN? 验证连通，用 :SYST:ERR? 验证命令，用 *OPC? 验证同步。三步都通过，才把该仪器接入正式的采集循环。这样即使后续换仪器、换接口，调试路径也是同一套，不必每次从零摸索。