IEEE 488.2 通用命令

IEEE 488.2 通用命令

这些命令与查询与 IEEE 488.2 标准相关。

命令概要

*CLS

*ESE

*ESR?

*IDN?

*LRN?

*OPC

*OPC?

*OPT?

*PSC

*RCL

*RST

*SAV

*SRE

*STB?

*TRG

*TST?

*WAI

标准事件寄存器

下表介绍标准事件寄存器。

位编号	位名称	十进制值	定义
0	操作完成	1	*OPC 之前且包括其在内的所有命令均已执行。
1	未使用	2	返回 0。
2	查询错误	4	该仪器试图读取输出缓冲器，但它是空的。 或者，在读取上一次查询之前接收到一个新的命令行。 或者，输入和输出缓冲区均已满。
3	设备特定的错误	8	发生设备特定错误，包括自检错误或校准错误（已产生 -300 量程内的错误或任何正误差） 请参见 SCPI 错误消息了解完整的 SCPI 错误消息列表。
4	执行错误	16	发生执行错误（已产生 -200 量程内的错误）。
5	命令错误	32	发生命令语法错误（已产生 -100 量程内的错误）。
6	未使用	64	返回 0。
7	通电	128	自上次读取或清除事件寄存器后，已关闭并打开电源。

状态字节寄存器

下表介绍了状态字节寄存器。

位编号	位名称	十进制值	定义
0	未使用	1	（保留以备将来使用）
1	未使用	2	（保留以备将来使用）
2	错误序列	4	在 错误序列 中已经存储了一个或多个错误。 使用 SYSTem:ERRor? 读取并删除错误。
3	可疑数据摘要	8	在可疑数据寄存器中设置一个或多个位（必须启用这些位，请参见 STATus:QUEStionable:ENABle）。
4	可用信息	16	仪器输出缓冲区中的数据可用。
5	标准事件摘要	32	在标准事件寄存器中设置一个或多个位（必须启用这些位，请参见 *ESE）。
6	主累加	64	一个或多个位在状态字节寄存器中设置且可能生成服务请求 (RQS)。 必须使用 *SRE 启用位。
7	标准操作摘要	128	在标准操作寄存器中设置一个或多个位（必须启用这些位，请参见 STATus:OPERation:ENABle）。

*CLS

清除状态命令。 清除所有寄存器组中的事件寄存器。 也会清除错误队列。

参数	典型返回
（无）	（无）
清除事件寄存器位和错误队列： *CLS

*ESE <enable_value>
*ESE?

事件状态启用命令和查询。 为标准事件寄存器组启用使能寄存器中的位。 随后将所选位报告给状态字节寄存器的 5 位。 使能寄存器可定义事件寄存器中的哪些位将被报告给“状态字节”寄存器组。 使能寄存器是可读写的。

有关 SCPI 状态系统的详细信息，请参见状态子系统简介。

参数	典型返回
寄存器位的十进制总和，默认为 0。例如为了启用位 2（值 4）、位 3（值 8）和位 7（值 128），十进制和要为 140 (4 + 8 + 128)。 默认为 0。	+48
配置 100 直流电压的测量，并在测量完成时生成一个 SRQ： *CLS *ESE 1 *SRE 32 CONF:VOLT:DC SAMP:COUN 100 INIT *OPC

• 使用 *PSC 控制是否在加电时清除标准事件使能寄存器。 例如，*PSC 0 在整个电源周期保留使能寄存器内容。
• *CLS 清除事件寄存器，但不清除使能寄存器。

• <enable> 设置是非易失性的；其在出厂重置 (*RST)、仪器预设 (SYSTem:PRESet)、状态预设 (STATus:PRESet) 或清空状态 (*CLS) 之后不会更改。

*ESR?

标准事件状态寄存器查询。 查询标准事件寄存器组的事件寄存器。

事件寄存器是只读寄存器，从条件寄存器锁存事件。 设置事件位时，将忽略与该位相对应的随后发生的事件。

参数	典型返回
（无）	+24
读取事件寄存器（设置 3 位和 4 位）。 *ESR?

• 为了向状态字节寄存器报告，必须由 *ESE 启用使能寄存器中的相应位。
• 任一或全部状态都可以通过使能寄存器报告给标准事件摘要位。 要设置使能寄存器掩码，使用 *ESE 将一个十进制值写入寄存器。
• 一旦设置了位，则保持设置直至通过读取事件寄存器或通过发送 *CLS（清除状态）清除。

*IDN?

标识查询。 返回仪器的标识字符串。

参数	典型返回
（无）	（请参见下文）
返回仪器的标识字符串： *IDN?

• 标识字符串包括 4 个由逗号分隔的字段：
  
  制造商名称、型号、序列号、修订版代码
  
  如果设置了 SYSTem:IDENtify DEFault，返回的字符串格式如下：
  Agilent Technologies、34460A、<序列号>、ff.ff-pp.pp-mm.mm-gg.gg-bb-pp
  Agilent Technologies，34461A，<序列号>，ff.ff-pp.pp-mm.mm-gg.gg-bb-pp
  
  如果设置了 SYSTem:IDENtify HP34401A，返回的字符串格式如下：
  HEWLETT-PACKARD，34401A，<序列号>，ff.ff-pp.pp-mm.mm-gg.gg-bb-pp
  
  其中：

ff.ff	主要固件修订版
pp.pp	前面板固件修订版
mm.mm	测量板固件修订版
gg.gg	测量板 FPGA 修订版
bb	测量板修订版
pp	前面板修订版

*LRN?

返回将仪器置于其当前状态所需要的所有命令的 ASCII 字符串。

参数	典型返回
（无）	SCPI 命令的 ASCII 字符串，命令之间用分号分隔 (";")。
返回学习字符串： *LRN?

• 可以通过相同命令的 [SENSe:]FREQuency 或 [SENSe:]PERiod 版本来设置一些参数。 *LRN 字符串将始终返回此命令的 FREQuency 版本，即使通过 PERiod 版本来设置参数。 类似的，可以用相同命令的 RESistance 或 FRESistance 版本设置的参数将始终返回 FRESistance 版本。

*OPC

在完成当前操作时，在标准事件寄存器中设置“操作完成”（0 位）。

参数	典型返回
（无）	（无）
配置 100 直流电压的测量，并在测量完成时生成一个 SRQ： *CLS *ESE 1 *SRE 32 CONF:VOLT:DC SAMP:COUN 100 INIT *OPC

• 在设置运行完成位之前，可以执行其他命令。
• *OPC 和 *OPC? 之差是当前操作完成时 *OPC? 输出 "1"。

*OPC?

在所有的未决命令完成后，将 1 返回到输出缓冲器。 在该命令完成之前，无法执行其他命令。

参数	典型返回
（无）	1
当测量结束时，配置 100 直流电压测量并返回 "1"： CONF:VOLT:DC SAMP:COUN 100 INIT *OPC?

• 该命令的目的是将应用与仪器同步起来。
• *OPC 和 *OPC? 之差是当前操作完成时 *OPC? 输出 "1"。

*OPT?

返回标识任何已安装选件的字符串。

参数	典型返回
（无）	（请参见下文）
返回已安装的选件： *OPT?

• 查询返回具有下列格式的字符串：
  
  34460A： {GPB|0}、{LAN|0}、{SEC|0}
  34461A： {GPB|0},{SEC|0}
  
  在每种情况下，将选件作为 0（未安装）或 GPB、LAN、或 SEC 返回。
  
  例如，仅安装有 GPIB 的 34461A 将返回 GPB,0；仅安装有 GPB 和 SEC 的 34460A 将返回 GPB,0,SEC。
• 选件因型号不同而变化，如此处所示。

*PSC {0|1}
*PSC?

加电状态清除。 启用 (1) 或禁用 (0) 在加电时清除某些使能寄存器：

• 可疑数据寄存器 (STATus:QUEStionable:ENABle)
• 标准操作寄存器 (STATus:OPERation:ENABle)
• 状态字节条件寄存器 (*SRE)
• 标准事件使能寄存器 (*ESE)

*PSC 命令不影响清除条件或事件寄存器，只影响使能寄存器。 有关 SCPI 状态系统的详细信息，请参见状态子系统简介。

参数	典型返回
{0|1}，默认 1	0 或 1
禁用加电清除受影响的寄存器： *PSC 0

*RCL {0|1|2|3|4}
*SAV {0|1|2|3|4}

将当前仪器状态储存至内部闪存文件系统根文件夹中的状态文件 STATE_<n>.sta 中，或从内部闪存文件系统根文件夹中的该文件调用仪器状态，其中 <n> 为指定的数字。

参数	典型返回
{0|1|2|3|4}	（无）
将仪器状态储存至内部闪存文件系统根文件夹中的状态文件 STATE_1.sta 中。 *SAV 1

• *SAV <n> 等同于 MMEMory:STORe:STATe "INT:STATE_n.sta"。
• *RCL <n> 等同于 MMEMory:LOAD:STATe "INT:STATE_n.sta"。
• 由 *SAV 0 创建的状态文件被称为 STATE_0.sta，驻留在内部闪存文件系统根文件夹中。 重新打开电源时，该状态文件会被仪器的断电状态所覆盖。
• 仪器状态启用设置储存于非易失性存储器中。 当电源已关闭，出厂重置 (*RST) 或仪器预置 (SYSTem:PRESet) 后，它们不再改变。

*RST

将仪器恢复为出厂默认状态，独立于 MMEMory:STATe:RECall:AUTO 设置。 这与 SYSTem:PRESet 类似。 区别是：对于 SCPI 操作，*RST 重置仪器，而对于面板操作，SYSTem:PRESet 重置仪器。 其结果是，*RST 关闭直方图和统计数据，而 SYSTem:PRESet 将其打开 (CALC:TRAN:HIST:STAT ON)。

参数	典型返回
（无）	（无）
重置仪器： *RST

• 不会影响储存的仪器状态（请参见 *SAV）。

*SRE <enable_value>
*SRE?

服务请求启用。 为状态字节寄存器组启用使能寄存器中的位。 使能寄存器可定义事件寄存器中的哪些位将被报告给“状态字节”寄存器组。 使能寄存器是可读写的。

参数	典型返回
寄存器位的十进制总和，默认为 0。例如为了启用位 2（值 4）、位 3（值 8）和位 7（值 128），十进制和要为 140 (4 + 8 + 128)。 默认为 0。	+24
启用使能寄存器中的 3 和 4 位： *SRE 24

• 要启用特定位，指定寄存器中与位的二进制加权值总和相对应的十进制值。 对选定的位在状态字节寄存器的“主累加”位（6 位）上进行累加。 如果有任一个选定的位从 0 改为 1，则仪器将产生服务请求信号。
• *CLS 清除事件寄存器，但不清除使能寄存器。 事件寄存器是只读寄存器，从条件寄存器锁存事件。 设置事件位时，将忽略与该位相对应的随后发生的事件。
• *PSC （加电状态清除）确定是否在加电时清除了状态字节使能寄存器。 例如，*PSC 0 在整个电源周期保留使能寄存器内容。
• *RST 没有清除状态字节使能寄存器。

*STB?

读取状态字节查询。 查询状态字节寄存器组的条件寄存器并返回一个十进制值，该值等于寄存器中设置的所有位的二进制加权值总和。

条件寄存器可不间断地监控仪器的状态。 条件寄存器位实时更新；它们既不锁定亦无缓冲。

参数	典型返回
（无）	+40
读取条件寄存器（具有 3 和 5 位设置）： *STB?

• 与串行轮询相似，但执行方式与任何其他仪器命令一样。 该寄存器为只读；当读取时，不清除位。
• 返回与串行轮询相同的结果，但 *STB? 不会清除“主累加”位（6 位）。
• 关闭再打开电源并 *RST 清除条件寄存器中的所有位。

*TRG

如果选择了 TRIGger:SOURce BUS，则触发仪器。

参数	典型返回
（无）	（无）
返回五次直流电压测量结果，使用软件触发开始测量： CONF:VOLT:DC SAMP:COUN 5 TRIG:SOUR BUS INIT *TRG FETCH? 典型响应：+1.00520000E+01, … （5 个测量结果）

• 设置触发源之后，必须发送 INITiate 将数字万用表置于等待触发状态。 除非数字万用表处于等待触发状态，否则无法接受 *TRG 命令。

*TST?

执行仪器的基本自检并返回通过/失败指示。 TEST:ALL? 自检比 *TST? 自检更加全面。

参数	典型返回
（无）	+0（通过）或 +1（一个或多个测试失败）
进行自检： *TST?

• 自检只需几秒就能完成。
• 如果一个或多个测试失败，该查询返回 +1 并在错误队列中存储一个错误。 要了解自检故障相关的错误消息的完整列表，请参见自检错误消息。
• 完成测试之后，仪器返回到自检之前的仪器状态。

*WAI

配置仪器的输出缓冲区，等待所有未决操作完成之后，再通过接口执行任何其他命令。

参数	典型返回
（无）	（无）
等待所有未决操作完成： *WAI