Elektro-Automatik IF-G1 User manual

SCPI
STANDARD COMMANDS FOR PROGRAMMABLE INSTRUMENTS
可编程仪器标准指令
电子负载系列的
指令清单
Command List
For Electronic Loads
适用于 / For use with
IF-G1 / IF-E1B / IF-E2B / IF-E1*
* 已停产 / discontinued

2
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
目录
页码
1. 结束符............................................................................................... 3
2. 语法格式............................................................................................ 3
3. SCPI指令............................................................................................. 4
3.1 IEEE488.2通用指令.................................................................................. 4
3.2 事件系统........................................................................................... 4
3.3 寄存器区........................................................................................... 5
3.4 状态指令........................................................................................... 6
3.5 系统指令........................................................................................... 6
3.6 控制输入指令....................................................................................... 9
3.7 测量指令........................................................................................... 9
3.8 设定值指令......................................................................................... 9
3.9 特殊指令.......................................................................................... 12
3.9.1SYST:DATA:SET和SYST:DATA:REQ................................................................ 12
4. 错误................................................................................................ 13
5. 附录................................................................................................ 14
5.1 SCPI指令概览...................................................................................... 14

3
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
<B1> NONE：本地操作，可转为远程控制
LOCal：本地操作，可读取数据
REMote：允许产品远程受控
<B2> ON或1：按x个循环自动测量
ONCE或0：按x个循环测量一次，用*TRG触发
<ERR> 错误和事件数 (-800至399)
<SRD> 字符串
<LF> 一行结束的标识 (换行符，0x0 A)
<Time> [[ddd], [hh], [mm], [s]s.s[s][s][s][s][s][s]
标准格式是以秒(s.s)为单位
; 分号用来分割一条消息内的多个指令
: 冒号用来分开主要和次要关键字
[ ] 在括号内的小写字母和项目为可选项
? 问号等同于询问。查询可结合数据传输。此时需
耐心等待系统回应
-> 产品回复
SCPI
1. 结束符
提示
这只适用于 GPIB (IF-G1) 卡！使用以太网卡时，不需特殊
结束符，只要普通字符串 EOS (0x00) 字节即可。
SCPI指令以纯文本发送。末尾必须用下面其中一个分界符
表示：
• LF (Line Feed, 0xA, ASCII 10)
从产品发出的信息需先由主机（PC/SPC等）发送一消息。
如果主机等待回复，就是说指令结尾带有一“?”，IF-G1
会回复。
用来设定状态或数值的指令始终由指令本身和一个或多个数
值，以逗号隔开而组成。举例：
<指令><数值 1>,<数值 2>....
可按缩减或完整格式发送任何指令。下面章节描述以大写字
母组成的简短格式的指令，它们始终是完整格式的一部分。
3.03 以上 IF-G1 固件版本的产品有更改：
▪另外还有这些分界符：
CR+LF
CR
都跟EOI一起使用
▪指令也可以小写字母组成
2. 语法格式
按照“1999 SCPI Command reference”规则。
下列句法格式可能出现于指令中和/或回复中：
<Numeric value>
这个数值相当于显示器上的值，取决于产品的
额定值。它适用：
- 该值必须在指令后发送，且用空格隔开
- 也可用下面的代替数值
MIN (相当于最小参数值)
注意！
大于额定值的设定值将返回一错误！
<NR1> 无小数点的数值
<NR2> 带小数点的数值
<NR3> 带小数点和指数的数值
<NRf> 包含<NR1>或<NR2>或<NR3>
单位 V Volt
A Ampere
W Watt
OHM Ohm
s 分钟
<CHAR> 0..255：十进制数（输出）
<+INT> 0..32768：正整数（输出）
<B0> 1或ON：功能被激活
0或OFF：功能未启用

4
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
3. SCPI指令
3.1 IEEE488.2通用指令
*IDN? 返回产品识别码，包括：
用户文本，产品供销商，产品名称，系列号，固
件版本，插入的接口卡系列号和固件版本<LF>
*RST 按下列步骤重设产品：
- 设为远程控制模式（如果允许）
- 设输入为OFF
- 重设产品所有过去的报警
*STB? 读出Status Byte Register，然后清除
下列指令仅支持GPIB卡IF-G1：
*TRG 触发一个测量
*CLS 清除GPIB控制器的所有事件和状态寄存器
*ESE <CHAR> 设置Event Status Enable Register
*ESE? 读出Event Status Enable Register
*ESR? 读出Event Status Register，读取后即清除
*SRE <CHAR> 设置Service Request Enable Register
*SRE? 读出Service Request Enable Register
3.2 事件系统
事件寄存器与寄存器分配的原理在下也图表中有解释。
可通过读取Status Register STB (GPIB, Ethernet)查询产品
上的事件。
状态寄存器STB包括下面几个位元：
Bit 0: 不用
Bit 1: 不用
Bit 2: err，错误队列已满；该队列读取后即清除，并重设
位元。此队列可容纳至少4个错误。
Bit 3: ques, Questionable Status Register被激活（出现一
个或多个事件）
Bit 4: 不用
Bit 5: esr，标准的Event Status Register (ESR)，被Event
Status Enable Register (ESE)屏蔽，以信号显示出
现了一个或多个事件
Bit 6: rsv，始终为激活状态
Bit 7: oper，以信号显示出现了一个或多个事件，并存储于
Operation Status Register内
如果出现的事件可以报告，可通过使能寄存器里的对应位元
（*ESE，*SRE和STAT:QUES:ENAB, STAT:OPER:ENAB）
将各种事件元报告给STB。
ESR 的位元组成如下：
Bit 0: 操作完成
Bit 1: 不用
Bit 2: 查询错误
Bit 3: Device Dependent Error (硬件缺陷等)；从-399
至-300，以及100...399
Bit 4: Execution Error (超过电流极限和其它极限）；
从-299至-200
Bit 5: Command Error(指令错误）；Errors从-199至-100
Bit 6: 不用
Bit 7 Power On (产品被打开)
用*CLS指令可清除事件和状态寄存器。

5
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
0
U/D
MODE_A
MODE_B
MODE_AB
MODE_BAT
MODE_CR1
MODE_CR2
MODE_CV
OPC = OPeration Complete bit
EXE= EXecution Error
QYE= QuerY Error
CME= CoMmand Errors
DDE= Device Depend Error
Questionable Status
QUES
CV
CC
CR
LOCAL
EXTERNAL
Input on
err
oper
Event
OR
Operation Status
OPER
ques
Service
Request
Enable
SRE
STATUS
STB
0 0
0 0
z U
z U
z
z U
z0
z U
0
1
7
6
5
4
3
2
OR
mss
rsv
Service Request
Generation
Condition
0/1
0
0/1
0/1
0/1
0/1
0
0
0
1
7
6
5
4
3
2
Standard Event Status
Register
ESR
OPC
EXE
CME
DDE OR
esr
CP
Error
Error
0
Error Queue
<>0
REMOTE
z
z
z
z
z
z
z
0
z
z
z
0
0
0
0
0/1
0/1
0/1
0/1
0/1
0/1
0/1
0
0/1
0/1
0/1
0
0
0
0
0
1
7
6
5
4
3
2
8
9
10
11
12
13
14
U
U
U
U
U/D
U/D
U/D
0
U
U
U
0
0
0
0
0
U/D
U/D
U/D
U/D
U/D
U/D
U/D
0
U/D
U/D
U/D
0
0
0
0
U/D
U/D
U/D
U/D
U/D
U/D
0
U/D
U/D
U/D
0
0
0
0
Enable
Condition
Positive transition
Negative transition
Event
OR
z
z
z
z
0
0
0
0
0
0
0
z
0
0
0
0/1
0/1
0/1
0/1
0
0
0
0
0
0
0
0/1
0
0
0
0
1
7
6
5
4
3
2
8
9
10
11
12
13
14
U
U
U
U
0
0
0
0
0
0
0
U/D
0
0
0
U/D
U/D
U/D
U/D
0
0
0
0
0
0
0
U/D
0
0
0
U/D
U/D
U/D
U/D
0
0
0
0
0
0
0
U/D
0
0
0
Enable
Condition
Positive transition
Negative transition
Enable
U
0
U
U
U
U
0
0
Event
z
0
z
z
z
z
0
0
QYE
U = User defined
z = State of the indicated information
D = Set after power on
图解：
CC/CV/CP/CR = 当前运行的调整模式
Input / Output on = 产品的输入和输出都打开
MODE_A/B/AB/BAT = 用旋转开关选择实际操作模式
MODE_CR1/CR2 = 当前选择的阻值范围（CR1为较小范围）
LOCAL = 产品位于本地模式，不允许进入远程控制模式
REMOTE = 产品经数字接口被远程控制着
EXTERNAL = 产品经模拟接口卡和内置模拟接口而受控
3.3 寄存器区

6
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
3.4 状态指令
(按照“1999 SCPI Command reference”规格：20 Status Subsystem)
Operation Status Register (OPER) (见上页图表)将多个状态（远程，本机等）存储于Condition寄存器内，一旦用Enable按
键激活，即可转给Event寄存器.Positive transition和Negative transition掩码决定是否由上升沿或下降沿来触发事件。可用
这个功能感测状态的出现和/或消失。
这同样适用于Questionable Status Register (QUES)。OPER的配置如上图所示，只有当“local”信号从低至高变化时，它才
产生一事件。另一方面，“Function mode”信号在下降沿也会产生事件。
STATus
:OPERation 根据状态操作
【:EVENT】?-><NR1> 查询Status Operation Register内的事件
:CONDition? -><NR1> 查询OPER事件条件
:ENABle <NR1> 启动OPER事件
:ENABle? -><NR1> 查询
:PTRtransition <NR1> 只有在上升沿才可触发事件
:PTRtransition? -><NR1> 查询
:NTRtransition <NR1> 只有在下降沿才可触发事件
:NTRtransition? -><NR1> 查询
:QUEStionable 产品和函数的具体事件
【:EVENT】?-><NR1> 查询Questionable Status Register下的事件
:CONDition? -><NR1> 查询QUES事件条件
:ENABle <NR1> 启动QUES事件
:ENABle? -><NR1> 查询
:PTRtransition <NR1> 只有在上升沿才可触发事件
:PTRtransition? -><NR1> 查询
:NTRtransition <NR1> 只有在下降沿才可触发事件
:NTRtransition? -><NR1> 查询
举例：
STAT:OPER? 查询OPERation Status Event Register
STAT:OPER:ENAB1919 启动OPERation Status Event register所有事件
3.5 系统指令
(按照“1999 SCPI Command reference”规格：19 Source Subsystem)
SYSTem:
ERRor:ALL? -><Err>[,<Err>]… 查询错误队列，用来读取错误描述和代码；
err，esr和ESR位元：Condition被清除
ERRor:NEXT? -><Err> 查询队列的最后一个错误；如果队列为空，
err，esr 和ESR位元：Condition被清除
提示
询问错误时会卡返回一通讯与设备错误，而卡则只返回通讯错误。
LOCK
[:STATE] <B0> 1 或 ON=如果未被锁定，产品进入遥控模式。
0 或 OFF=退出远程控制模式，返回正常操作
注意！
只有产品未处于远程模式时才可进行监控。意思是：此时只能查询实际数值和状态。要查询设定状态、模式和设定值，需
通过LOCK:STATE 1或LOCK 1，以及*RST (见章节3.1)将产品转为远程模式。
若想完成这个转换，必须解锁远程模式。关于条件、锁定和模式的更多信息，请查看您使用产品的操作指南。

7
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
锁定状态可通过下面这个指令查询：
SYSTem:
LOCK
:OWNer? -><B1> 获取当前锁定状态
NONE：如果返回，可将产品设为远程模式
(在OPER:Condition下，位元8,9,10=0)
LOCal：产品处于本机模式，禁止进入远程模式
（在OPER:Condition下，位元8=1,9=0,10=0 )
外部模式被当做LOCal模式。
(在OPER:Condition下，位元8=0,9=0,10=1)
REMote：产品处于远程模式
(在OPER Register下，位元8=0,9=1,10=0)
VERSion? -><SRD> 查询SCPI-版本
举例：
SYST:LOCK:OWN? 查询锁定状态，决定是否允许进入远程模式
SYST:LOCK:STAT1将产品转为远程模式（现在允许设定数值）
LOCKON 同上
注意！
下面两指令仅在IF-E1, IF-E2B与IF-E1B卡下才有效！
SYSTem:
DATA
:SET <CHAR> 传输二进制格式的封装电报
这儿：发送数据（SET）（见章节3.9.1)
在另外的„Programming“用户手册和相关object list 文档内可查到更多关于封
装电报的信息
举例：
SYST:DATA:SET51,100,0发送十六进制电报0x33 0x64 0x00到产品上。
如果产品处于远程控制模式， Level A 的限流设为100%。
SYSTem:
DATA
:REQuest <CHAR> 传输二进制格式的封装电报
这儿：请求数据（也可见章节3.9.1）
在另外的„Programming“用户手册和相关object list文档内可查到更多关于封
装电报信息
举例：
SYST:DATA:REQ50 发送十六进制电报0x32到产品上。
它请求电压设定值 相当于SCPI指令 SOUR:VOLT?.
将返回两个值例如100，0。它们相当于0x6400十六进制值，表示100%的设定值。
SCPI

8
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
注意！
下面的指令仅在以太网卡IF-E1B下有效！
SYSTem:
COMMunicate:
NETwork
:MAC? -><SRD> 查询以太网卡的MAC地址
:IPADdress? -><SRD> 查询产品的实际IP地址，将以典型格式返回。如：192.168.0.2
:IPADdress <CHAR> 以逗号分开的十进制命令设定IP地址。
这仅当产品关闭并再次打开后方有效。
:MASK? -><SRD> 查询产品实际子网掩码地址，将以典型格式返回。如：255.0.0.0
:MASK <CHAR> 用命令设置子网掩码。这仅当产品关闭并再次打开后方有效。
:GATEway? -><SRD> 查询产品实际网关地址，将以典型格式返回。如：0.0.0.0
:GATEway <CHAR> 用命令设置网管掩码。这仅当产品关闭并再次打开后方有效。
举例：
SYST:COMM:NET:IPAD192,168,0,2 如果产品位于远程控制模式，将设定IP地址为192.168.0.2。
SCPI

9
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
3.6 控制输入指令
激活/停止功率输入。
INPut[:STATe]? ->B0 查询电子负载输入状态
INPut[:STATe] <B0> 打开/关闭电子负载输入
举例：
INPON 打开电源输入，但不重设报警或警告。意即：若出现报警，则不能执行该指令。
3.7 测量指令
用来读取最新测量结果（实际值）。
MEASure
[:SCALar]
:VOLTage[:DC]? -><NRf>Unit 查询：实际电压
:CURRent[:DC]? -><NRf>Unit 查询：实际电流
:POWer[:DC]? -><NRf>Unit 查询：实际功率
:ARRay? -><NRf>Unit, <NRf>Unit … 查询：实际电压、电流和功率
举例：
MEAS:CURR? 测量实际电流，返回平均测量值。
MEAS:ARR? 返回一组实际值，包括：U，I，P。
3.8 设定值指令
提示
指令后加一问号可回读设定值。关于电子负载的 A ， B 和 A/B 模式，请阅读该产品的说明书！
I. 电压设定值/过压门限
(按照“1999 SCPI Command reference”规格：19 Source Subsystem)
电子负载适用：
▪这些指令支持3.01以上产品固件版本的电子负载。
▪HIGH设定值始终要大于LOW设定值，否则出现错误。HIGH和LOW指令仅在Level A/B操作下有效。如果处于其他不同控
制模式，会产生错误。
▪查询和设置设定值始终针对当前选定的“Level Control”和预选“Mode”。即：如果在Level A模式，且预选了CV模式，
用VOLT发送的设定值只针对Level A模式。否则将忽略设定值，并产生一错误。必须在产品设为远程操作模式前选择控制
模式。不属于预选模式的其他设定值就不能设定，必须预设。因此，继续远程控制产品时，建议在设置菜单下将“Keep
set values”选项设为“no”，故在转换“Mode”时将设定值重设为默认值。
[SOURce:]
VOLTage
[:LEVel]? -><NRf>Unit 查询最后设定电压值
Level A或B，看当前处于哪个模式
[:LEVel] <NRf+>[Unit] 设定电压
Level A或B，看当前处于哪个模式
:HIGH <NRf+>[Unit] 在Level A/B操作下为Level A设置电压设定值
:HIGH? -><NRf>Unit 在Level A/B操作下查询Level A的设定电压
:LOW <NRf+>[Unit] 在Level A/B操作下为Level B设置电压设定值
:LOW? -><NRf>Unit 在Level A/B操作下查询Level B的设定电压
举例：
VOLT5.05 设置电压极限为5,05 V，（A或B模式）
VOLT6.91V带单位的实例
VOLT? 查询最后设定值
VOLT:LOW47    在Level A/B模式下将Level B电压设为 47 V，但只有当Level A/B模式被激活时方可执行。

10
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
II. 电流设定值
(按照“1999 SCPI Command reference”规格：19 Source Subsystem)
电子负载适用：
▪这些指令支持 3.01以上产品固件版本的电子负载。
▪HIGH设定值始终大于LOW设定值，否则出现错误。HIGH和LOW指令仅在Level A/B操作下有效，在其他不同级别的控制
模式下会返回一错误。
▪设定值的查询和设定始终针对当前所选“Level Control”。意即：如果Level A被激活，用CURR发送的设定值只针对Level
A模式。否则将忽略设定值，并产生一错误。必须在产品设为远程操作模式前选择控制模式。不属于预选模式的其他设定
值就不能设定，必须预先设置。因此，继续远程控制产品时，建议在设置菜单下将“Keep set values”选项设为“no”
，故在转换“Mode”时将设定值重设为默认值。
[SOURce:]
CURRent
[:LEVel]? -><NRf>[Unit] 查询电流最后设定值
Level A或B，看当前处于哪个模式
[:LEVel] <NRf+>Unit 设定电流
Level A或B，看当前处于哪个模式
:HIGH <NRf+>[Unit] 在Level A/B操作下为Level A设定电流设定值
:HIGH? -><NRf>Unit 在Level A/B操作下查询Level A的设定电流
:LOW <NRf+>[Unit] 在Level A/B操作下为Level B设定电流设定值
:LOW? -><NRf>Unit 在Level A/B操作下查询Level B的设定电流
举例：
CURR20.00 将输入电流极限设为20 A（A或B）
CURR:HIGH? 在Level A/B操作下查询Level A的电流设定值
SOUR:CURR:LOW0.4A在Level A/B操作下将Level B的电流设定值设为0.4 A
III. 功率设定值
(按照“1999 SCPI Command reference”规格：19 Source Subsystem)
电子负载适用：
▪这些指令支持 3.01以上产品固件版本的电子负载。
▪HIGH设定值始终大于LOW设定值，否则出现错误。HIGH和LOW指令仅在Level A/B操作下有效，在其他不同级别的控制
模式下会返回一错误。
▪设定值的查询和设定始终针对当前所选“Level Control”。意即：如果Level A被激活，用CURR发送的设定值只针对Level
A模式。否则将忽略设定值，并产生一错误。必须在产品设为远程操作模式前选择控制模式。不属于预选模式的其他设定
值就不能设定，必须预先设置。因此，继续远程控制产品时，建议在设置菜单下将“Keep set values”选项设为“no”
，故在转换“Mode”时将设定值重设为默认值。
[SOURce:]
POWer
[:LEVel]? -><NRf>Unit 查询功率最后设定值
Level A或B，看当前处于哪个模式
[:LEVel] <NRf+>[Unit] 设定功率
Level A或B，看当前处于哪个模式
:HIGH <NRf+>[Unit] 在Level A/B操作下为Level A设定功率设定值
:HIGH? -><NRf>Unit 在Level A/B操作下查询Level A的设定功率
:LOW <NRf+>[Unit] 在Level A/B操作下为Level B设定功率设定值
:LOW? -><NRf>Unit 在Level A/B操作下查询Level B的设定功率
举例：
POW:LEV2300 将产品功率极限设为2300 W，只要该值在允许范围内。
POW:HIGH1500
POW:LOW300 将这两指令调节Level A/B动态操作下两水平的功率值设。
注意：必须将产品转至„CP“模式，以便运作动态功率。

11
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
IV. 内阻设定值
(按照“1999 SCPI Command reference”规格：19 Source Subsystem)
电子负载适用如下：
▪某些特定指令仅支持 3.01以上产品固件版本的电子负载。
▪HIGH设定值始终大于LOW设定值，否则出现错误。HIGH和LOW指令只在Level A/B操作下有效，在其他不同级别的控制
模式下会返回以错误。
▪设定值的查询和设定始终针对当前所选“Level Control”。意即：如果Level A被激活，用CR发送的设定值只针对Level A
模式。否则将忽略设定值，并产生一错误。必须在产品设为远程操作模式前选择控制模式。不属于预选模式的其他设定值
就不能设定，必须预先设置。因此，继续远程控制产品时，建议在设置菜单下将“Keep set values”选项设为“no”，故
在转换“Mode”时将设定值重设为默认值。
适用于电子负载：阻值范围1是两阻值范围较小的那一组
[SOURce:]
RESistance (阻值范围1或2，根据当前激活的模式而定)
[:LEVel]? -><NRf>Unit 查询内阻最后设定值
Level A或B，看当前处于哪个模式
[:LEVel] <NRf+>[Unit] 设定内阻
Level A或B，看当前处于哪个模式
:HIGH <NRf+>[Unit] 在Level A/B操作下为Level A设定内阻设定值
:HIGH? -><NRf>Unit 在Level A/B操作下查询Level A的设定内阻
:LOW <NRf+>[Unit] 在Level A/B操作下为Level B设定内阻设定值
:LOW? -><NRf>Unit 在Level A/B操作下查询Level B的设定内阻
举例：
RES1.300 将所需内阻设定值设为1.3Ω。
RES:HIGH? 查询Level A/B操作下Level A最小的内阻范围，内阻范围1或2。
V. 设定值的脉宽和上升时间(Level A/B操作)
(按照“1999 SCPI Command reference”规格：19 Source Subsystem)
支持3.01或以上产品固件版本的产品。
可随时查询A (HIGH)和B (LOW)脉宽设定值，以及上升时间。也可见项目I.至IV。只有激活Level A/B操作和远程控制模式时
才能设定。时间必须以秒为单位。范围确定如下：
A或B脉宽：0.0005 s ... 100.0 s
上升时间：0.0003 s ... 0.2 s
这形成一个(=脉宽A + B)100µs...200 s的时间段，对应10 kHz...0,005 Hz。因此可在50µs至100 s或0,025%至99,975%间调
节占空比。
提示
时间值必须始终带小数点，否则返回一错误。
[SOURce:]
PULSe
:TRANsition[:LEADing] <Time>[Unit] 设定上升/下降时间
:TRANsition[:LEADing]? -><Time>Unit 查询上升/下降时间
:WIDTh
:HIGH <Time>[Unit] 设定Level A(较高级别)脉宽
:HIGH? -><Time>Unit 查询Level A(较高级别)脉宽
:WIDTh
:LOW <Time>[Unit] 设定Level B(较低级别)脉宽
:LOW? -><Time>Unit 查询Level B(较低级别)脉宽
举例：
PULS:TRAN0.1s 与时间段不同，将上升/下降时间设为100 ms
PULS:WIDT:HIGH50 .0 将Level A的脉宽设为50 s
SCPI

12
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
3.9 特殊指令
3.9.1SYST:DATA:SET和SYST:DATA:REQ
提示
这只应用于 IF-E1B- 以太网卡！
只有经以太网端口，网卡才能运行SCPI指令，从章节3开始
有详细介绍。
此外，本卡提供了两个以十六进制格式给产品发送电报的指
令，它与面向对象二进制协议相似（在“Programming”说
明指导中有描述）。这些指令的目的是控制那些无特定SCPI
指令的产品功能。经过这两个SCPI指令，用户甚至可控制
PSI 9000或PSI 8000系列的函数管理器。执行该操作，仅
需建立如下的字节顺序即可：
对于SYST:DATA:SET : ON, DATA
对于SYST:DATA:REQ : ON
所有ON与DATA字节都转化成十进制数值，并通过
SYST:DATA:SET指令发送给产品。 重点！所有字节必须用
冒号隔开。
发送参数，如一设定值或以状态给产品时，需用到
DATA。DATA字节数必须正确，否则接口卡会返回一错
误。DATA长度在对象清单（见object lists说明指导）中有
定义，而且会有不同。
以发送设定电压值为例，需要一个16位的整数，形成两个字
节和由两冒号分开的十进制数值，从而组成SYST:DATA:SET
指令。
第一个值ON，代表对象清单第一栏的对象号（即：一指令）
。它定义DATA的目标。对象号和数据组合一起被当做一组指
令，而对象号仅被认为是一个查询指令。
例1：
要将水平控制设为„Level A/B“，动态模式。已知电子负载已
根据EL3000/EL9000object list 设为远程模式，需使用对象
54。该清单定义控制字节的第5和6位选择水平模式，二进
制值10将设为„Level A/B“。故控制字节为0x40与十进制值64
。需要的掩码为0x60与十进制值96。在不影响其他位元的条
件下，该掩码通过控制字节选择位元以更改和启动某反应。
形成的 SCPI 指令类似如下：
SYST:DATA:SET54,96,64
关于数值意思的更多信息请参考“Programming”说明指导
和相关object list 。
例2：
可从产品上查询电压、电流和功率的实际值。这需由RE-
Quest完成。按照对象清单，对象71可一次性返回所有6个
单字节的实际值。请求类似如下：
SYST:DATA:REQ71
产品可能返回这样的6个十进制数值：
71,67,37,21,127,24,16
第一个数值为对象，其它为实际值。 两个比邻数值组成一
个16位值，它代表百分比式的实际值。
故这6个值形成下面组合十六进制值：
67,37,21,127,24,16
0x4325, 0x157F, 0x1810
将其转换成十进制或十六进制百分比值为（VB，C或其它
类似）：
百分比值 = 第一个值 * 256 + 第二个值
上面例子的头两个字节则转换成的十进制值17189，即：67
* 256 + 37和0x4325十六进制。
形成三个16位的值或者顺序定义如下：
第一个值为是几点呀，第二个为时间电流，第三则为实际功
率，每个都为额定值的百分比数值。之后，需将他们转换成
实际值。可参考“Programming”说明指导章节1.7。
为了将转换后的百分比值转成真实实际值，需用到负载的
额定值。举例：如一台EL 9080-200负载，其额定值为80
V，200 A 和4800 W。形成的第二个公式如下：
真实实际值 = 额定值 * 百分比值 / 25600
按照上面举例产品，0x157F的百分比电流值将为：
200 A * 5503 / 25600 = 43 A
提示
这个实例相当于 SCPI 指令 MEAS:ARR? 。意思是，该指
令将按计算值返回相同数值。可能会出现由 MEAS:ARR?
指令返回的数值因很小的转换错误而使小数位出现细微的
不同。

13
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
SCPI
4. 错误
错误信息按错误队列集合在一起。err位元指示是否有新的错误出现。可通过服务请求呼叫查询错误。可分开查询错误队列，
读取后自动清除。
<ERR> 信息 描述
0 “No error“ 错误队列为空，未出现任何错误
-100 “Command error“ 使用了无效的指令
-101 “Invalid character” ...在指令字符串内
-102 “Syntax error“
-103 “Invalid separator“
-108 “Parameter not allowed”
-109 “Missing parameter“
-113 “Undefined header“ 未知指令
-120 “Numeric data error”
-131 “Invalid suffix” 或者单位
-141 “Invalid character data“
-151 “Invalid string data“
-200 “Execution error“ 一般错误，用于各种状态
-201 “Invalid while in local” 产品为本地模式，故阻止进入远程模式
-203 „Command protected“ 拒绝进入序列控制或
该功能未启用（R模式）
拒绝访问函数参数
-223 “Too much data“
-224 “Illegal parameter value”
-225 “Out of memory”
-240 “Hardware error” 超过最大CAN节点/未知的CAN节点/无网管功能
-241 „Hardware missing”
-220 “Parameter error” 未定义对象
-221 “Settings conflict“ 读-写规则被破坏，禁止访问
仅当OUTPUT OFF时方可进入菜单
拒绝访问设定值
-222 “Data out of range” 数值超过上限或下限
-223 “Too much data“ 对象长度不正确
-232 “Invalid format“ 时间格式错误
-350 “Queue overflow” 错误和事件缓冲区已满
-360 “Communication error” 多种通讯错误（也见Programming用户手册中章节3.7）
结构错误
校验和不正确
等
-361 “Parity error in program message“ RS232处：奇偶性错误
-362 “Framing error in program message“
-363 “Input buffer overrun“
-365 “Time out error“
产品形成的有关报警、警告和通知类错误信息（详情请见对应产品的使用说明和接口卡的使用说明）：
<ERR> 信息 描述
100 - 199 见„Programming“用户手册中第3.9章
节的报警表 仅显示，第一列和第十列错误节点与该表中的错误节点相同
200 - 299 见„Programming“用户手册中第3.9章
节的报警表 警告，第一列和第十列错误节点与该表中的错误节点相同
300 - 399 见„Programming“用户手册中第3.9章
节的报警表 报警，第一列和第十列错误节点与该表中的错误节点相同

14
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
Main 1.Sub 2.Sub 3.Sub 数值
PS8000T
PS8000DT/2U/3U PSI8000T/DT/2U/3U
PSI800R
PSI9000
EL3000/EL9000
备注
CURR 0...Imax 
CURR? Iset 
CURR: LEV 0...Imax EL系列：A 或 B级别，视设定项目而定
CURR: LEV? Iset EL系列：A 或 B级别，视设定项目而定
CURR: HIGH CURR:LOW...Imax EL系列：AB级
CURR: HIGH? 0...Imax EL系列：AB级
CURR: LOW 0...CURR:HIGH EL系列：AB级
CURR: LOW? 0...Imax EL系列：AB级
ERR: ALL? 3个错误字符串 
ERR: NEXT? 1个错误字符串 
INP 1, 0, ON, OFF 
INP? ON, OFF 
INP: STAT 1, 0, ON, OFF 
INP: STAT? ON, OFF 
LOCK 1, 0, ON, OFF 
LOCK? 
LOCK: STAT 1, 0, ON, OFF 
LOCK: STAT? 
LOCK: OWN? REM, LOC, NONE 
MEAS: VOLT? 1个值 
MEAS: CURR? 1个值 
MEAS: POW? 1个值 
MEAS: ARR? 3个值 
MEAS: VOLT: DC? 1个值 
MEAS: CURR: DC? 1个值 
MEAS: POW: DC? 1个值 
MEAS: SCAL: VOLT? 1个值 
MEAS: SCAL: CURR? 1个值 
MEAS: SCAL: POW? 1个值 
MEAS: SCAL: ARR? 3个值 
MEAS: SCAL: VOLT: DC? 1个值 
MEAS: SCAL: CURR: DC? 1个值 
MEAS: SCAL: POW: DC? 1个值 
OUTP 1, 0, ON, OFF 
OUTP? ON, OFF 
OUTP: STAT 1, 0, ON, OFF 
OUTP: STAT? ON, OFF 
POW 0...Pmax 
POW? Pset 
POW: LEV 0...Pmax 
POW: LEV? Pset 
POW: HIGH POW:LOW...Pmax 
POW: HIGH? 0...Pmax 
POW: LOW 0...POW:HIGH 
POW: LOW? 0...Pmax 
PULS: WIDT: LOW 50us...100s EL系列：AB级
PULS: WIDT: LOW? 50us...100s EL系列：AB级
PULS: WIDT: HIGH 50us...100s EL系列：AB级
PULS: WIDT: HIGH? 50us...100s EL系列：AB级
PULS: TRAN 30us...200ms EL系列：AB级
PULS: TRAN? 30us...200ms EL系列：AB级
PULS: TRAN: LEAD 30us...200ms EL系列：AB级
PULS: TRAN: LEAD? 30us...200ms EL系列：AB级
RES 0...Rmax  EL系列：A 或 B级别，视设定项目而定
RES? Rset  EL系列：A 或 B级别，视设定项目而定
RES: LEV 0...Rmax  EL系列：A 或 B级别，视设定项目而定
RES: LEV? Rset  EL系列：A 或 B级别，视设定项目而定
RES: HIGH RES:LOW...Rmax 
RES: HIGH? 0...Rmax 
RES: LOW 0...RES:HIGH 
RES: LOW? 0...Rmax 
SOUR: VOLT 0...Umax 
SOUR: VOLT? Uset 
SOUR: VOLT: LEV 0...Umax 
SOUR: VOLT: LEV? Uset 
SOUR: VOLT: HIGH VOLT:LOW...Umax 
SOUR: VOLT: HIGH? 0..Umax 
SOUR: VOLT: LOW 0...VOLT:HIGH 
SOUR: VOLT: LOW? 0...Umax 
SCPI
5. 附录
5.1 SCPI指令概览

15
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
Main 1.Sub 2.Sub 3.Sub 数值
PS8000T
PS8000DT/2U/3U PSI8000T/DT/2U/3U
PSI800R
PSI9000
EL3000/EL9000
备注
SOUR: CURR 同上 
SOUR: CURR? 同上 
SOUR: CURR: LEV 同上 
SOUR: CURR: LEV? 同上 
SOUR: CURR: HIGH 同上 
SOUR: CURR: HIGH? 同上 
SOUR: CURR: LOW 同上 
SOUR: CURR: LOW? 同上 
SOUR: POW 同上 
SOUR: POW? 同上 
SOUR: POW: LEV 同上 
SOUR: POW: LEV? 同上 
SOUR: POW: HIGH 同上 
SOUR: POW: HIGH? 同上 
SOUR: POW: LOW 同上 
SOUR: POW: LOW? 同上 
SOUR: RES 同上  
SOUR: RES? 同上  
SOUR: RES: LEV 同上  
SOUR: RES: LEV? 同上  
SOUR: RES: HIGH 同上 
SOUR: RES: HIGH? 同上 
SOUR: RES: LOW 同上 
SOUR: RES: LOW? 同上 
SOUR: VOLT: PROT 0...110% Umax  OVP
SOUR: VOLT: PROT? 0...110% Umax  OVP
SOUR: VOLT: PROT: LEV 0...110% Umax  OVP
SOUR: VOLT: PROT: LEV? 0...110% Umax  OVP
SOUR: PULS: WIDT: LOW 同上 
SOUR: PULS: WIDT: LOW? 同上 
SOUR: PULS: WIDT: HIGH 同上 
SOUR: PULS: WIDT: HIGH? 同上 
SOUR: PULS: TRAN 同上 
SOUR: PULS: TRAN? 同上 
SOUR: PULS: TRAN: LEAD 同上 
SOUR: PULS: TRAN: LEAD? 同上 
STAT: OPER? 
STAT: OPER: EVENT? 0-32767 
STAT: OPER: COND? 0-32767 
STAT: OPER: ENAB 0-32767 
STAT: OPER: ENAB? 0-32767 
STAT: OPER: PTR 0-32767 
STAT: OPER: PTR? 0-32767 
STAT: OPER: NTR 0-32767 
STAT: OPER: NTR? 0-32767 
STAT: QUES? 0-32767 
STAT: QUES: EVENT? 0-32767 
STAT: QUES: COND? 0-32767 
STAT: QUES: ENAB 0-32767 
STAT: QUES: ENAB? 0-32767 
STAT: QUES: PTR 0-32767 
STAT: QUES: PTR? 0-32767 
STAT: QUES: NTR 0-32767 
STAT: QUES: NTR? 0-32767 
SYST: COMM: NET: IPAD 0, 0, 0, 0 - 255, 255, 255, 255  仅IF-E1B/IF-E2B有
SYST: COMM: NET: IPAD? 0.0.0.0 - 255.255.255.255  仅IF-E1B/IF-E2B有
SYST: COMM: NET: GATE 0, 0, 0, 0 - 255, 255, 255, 255  仅IF-E1B/IF-E2B有
SYST: COMM: NET: GATE? 0.0.0.0 - 255.255.255.255  仅IF-E1B/IF-E2B有
SYST: COMM: NET: MAC?  仅IF-E1B/IF-E2B有
SYST: COMM: NET: MASK 0, 0, 0, 0 - 255, 255, 255, 255  仅IF-E1B/IF-E2B有
SYST: COMM: NET: MASK? 0.0.0.0 - 255.255.255.255  仅IF-E1B/IF-E2B有
SYST: DATA: SET 如ASCII样的电报对象 仅IF-Ex有：设置一些东西
SYST: DATA: REQ 如ASCII样的电报对象 仅IF-Ex有：请求一些东西
SYST: ERR: ALL? 同上 
SYST: ERR: NEXT? 同上 
SYST: LOCK 同上 
SYST: LOCK: STAT 同上 
SYST: LOCK: OWN? 同上 
SYST: VERS? SCPI版 (1999.0) 
SCPI

16
CN
电子负载产品用
SCPI 指令操作说明书 日期：23-07-2015
Main 1.Sub 2.Sub 3.Sub 数值
PS8000T
PS8000DT/2U/3U PSI8000T/DT/2U/3U
PSI800R
PSI9000
EL3000/EL9000
备注
VOLT 同上 
VOLT? 同上 
VOLT: LEV 同上 
VOLT: LEV? 同上 
VOLT: HIGH 同上 
VOLT: HIGH? 同上 
VOLT: LOW 同上 
VOLT: LOW? 同上 
VOLT: PROT 同上  OVP
VOLT: PROT? 同上  OVP
VOLT: PROT: LEV 同上  OVP
VOLT: PROT: LEV? 同上  OVP
*RST 
*IDN? 字符串，最多128个字符 
*STB? 0...255 
*ESR? 0...255 
*ESE 0...255 
*ESE? 0...255 
*CLS 
*TRG 
*SRE 0...255 
*SRE? 0...255 
要求设备已处于远程控制模式
仅IF-E1或IF-E2网卡才有，有些指令要求远程控制模式
仅GPIB卡IF-G1有
SCPI

18
EN
Instruction Manual
SCPI Commands for Electronic Loads Date: 23-07-2015
Table of Contents
Page
1. End tokens ................................................................................................................................................................... 19
2. Syntax format .............................................................................................................................................................. 19
3. SCPI commands .......................................................................................................................................................... 20
3.1 Common IEEE488.2 commands............................................................................................................................. 20
3.2 Event system........................................................................................................................................................... 20
3.3 Register block ......................................................................................................................................................... 21
3.4 Status commands ................................................................................................................................................... 22
3.5 System commands.................................................................................................................................................. 22
3.6 Commands to control the input ............................................................................................................................... 25
3.7 Measurement commands........................................................................................................................................ 25
3.8 Set value commands............................................................................................................................................... 25
3.9 Special commands.................................................................................................................................................. 29
3.9.1 SYST:DATA:SET and SYST:DATA:REQ .......................................................................................................... 29
4. Errors............................................................................................................................................................................ 30
5. Appendix ...................................................................................................................................................................... 31
5.1 SCPI command overview........................................................................................................................................ 31

19
EN
Instruction Manual
SCPI Commands for Electronic Loads Date: 23-07-2015
SCPI
<CHAR> 0..255: Decimal number
<+INT> 0..32768: positive integer number (output)
<B0> 1 or ON: Function is activated
0 or OFF: Function is deactivated.
<B1> NONE: local operation, switching to remote
control is possible
LOCal: local operation, reading of data is pos-
sible
REMote: remote control of the device is allowed
<B2> ON or 1: automatic measurement with x rounds
ONCE or 0: one-shot measurement with x
rounds, triggered by *TRG
<ERR> Error and event number (-800 to 399)
<SRD> String
<LF> End of line token (line feed, 0x0 A)
<Time> [[ddd], [hh], [mm], [s]s.s[s][s][s][s][s][s]
Standard format is in seconds (s.s)
; The semicolon is used to seperate multiple
command within a message
: The colon is used to seperate major keywords
from minor keywords
[ ] Small letters and items in rectangular brackets
are optional
? The question mark identifies a query. The query
can be combined with a data transmission. Here
you need to take care to wait for response of the
system before sending data
-> Reply from the device
1. End tokens
Note
This applies only to GPIB (IF-G1)! Using Ethernet, no
special end token is required, just the normal string EOS
byte (0x00).
SCPI commands are sent as plain text. The end has to be
marked with one of these delimiters:
• LF (Line Feed, 0xA, ASCII 10)
A transmission from the device requires to first sent a mes-
sage from the host (PC/SPC etc). The IF-G1 will reply, if
the host expects a reply. This is the case, if the end of the
command is a „?“.
Commands that have to set a state or a value always consist
of the command itself and one or multiple values, seperated
by commas. Example:
<COMMAND><Numeric value 1>,<Numeric value 2>...
You can sent any command in its short or complete form. In
the following section the short form is given in capital letters
and is always a part of the complete form.
Changes since IF-G1 firmware version 3.03:
• Additional delimiters accepted:
CR+LF
CR
each together with EOI
• Commands can also be given in lowercase letters
2. Syntax format
Specification according „1999 SCPI Command reference”.
Following syntax formats can occur in commands and/or
replies:
<Numeric value>
This numeric value corresponds to the value in
the display of the device and depends on the
nominal values of the device. It applies:
- the value must be sent after the command and
seperated by a space
- instead of a numeric value you can also use
MIN (corresponds to the minimum value
of the parameter)
Attention!
Set values bigger than nominal values will
return an error!
<NR1> Numeric value without decimal place
<NR2> Numeric value with decimal place
<NR3> Numeric value with decimal place and exponent
<NRf> Contains <NR1>,<NR2>,<NR3>
<NRf+> Contains <NR1>, <NR2>, <NR3>
Unit V Volt
A Ampere
W Watt
OHM Ohm
s Seconds

20
EN
Instruction Manual
SCPI Commands for Electronic Loads Date: 23-07-2015
SCPI
3. SCPI commands
3.1 Common IEEE488.2 commands
*IDN? Returns the device identification, consisting of:
User text, device vendor, device name, device
serial number, device firmware version, serial
number(s) and firmware version(s) of plugged
interface cards<LF>
*RST Resets the device by doing this:
- setting it into remote control mode (if allowed)
- setting input to OFF
- resetting all past alarms of the device
*STB? Reads the Status Byte Register, which is cle-
ared after reading
The following commands are only supported by the GPIB
interface IF-G1:
*TRG Triggers a measurement
*CLS Clears all event and status registers of the
GPIB controller
*ESE <CHAR> Sets the Event Status Enable Register
*ESE? Reads the Event Status Enable Register
*ESR? Reads the Event Status Register, which is cle-
ared after reading
*SRE <CHAR> Sets the Service Request Enable Register
*SRE? Reads the Service Request Enable Register
3.2 Event system
The scheme of the event registration and register assignment
is illustrated in the diagram on the next page.
Events can be queried from the device by reading the Status
Register STB (GPIB, Ethernet).
The status register STB consists of these bits:
Bit 0: Not used
Bit 1: Not used
Bit 2: err, Error queue full; this queue is cleared by reading
it and the bit is also reset. The list can hold up to 4
of the last errors
Bit 3: ques, Questionable status register is active (on or
more events have occured)
Bit 4: Not used
Bit 5: esr, the standard Event Status Register (ESR), mas-
ked by the Event Status Enable Register (ESE), is
signalising that one or more events have occured
Bit 6: rsv, always active
Bit 7: oper, signalises, that one or more events have occu-
red and are stored in the Operation Status Register
The event bits of the various registers report to the STB, if
events have occured that are enabled to be reported, by the
corresponding bits in the enable registers (*ESE, *SRE resp.
STAT:QUES:ENAB, STAT:OPER:ENAB).
The bits of the ESR are as follows:
Bit 0: Operation complete
Bit 1: Not used
Bit 2: Query error
Bit 3: Device Dependent Error (Hardware defective etc.);
errors from -399 to -300 resp. 100...399
Bit 4: Execution Error (current limitation, other limits ex-
ceeded); errors from -299 to -200
Bit 5: Command Error; Errors from -199 to -100
Bit 6: Not used
Bit 7 Power On (device was turned on)
Event and status registers can be cleared by using the
command *CLS.