直流可编程电子负载 DCL8000 系列 SCPI 通信协议
直流可编程电子负载 DCL8000 系列 SCPI 通信协议
1.0 SCPI 协议概述
（1）本协议所有通信命令与数据均为 ASCII 字符，一个完整的命令串总是以规定的结束符 NL 结束，NL 为<CR><LF>的组合，其中<CR>为 0x0D，<LF>为 0x0A。本仪器在返回查询结果时总是用 NL 结束符来结束。例如：
发送：FETCH:CURRENT?<CR><LF>回传：1.000<CR><LF>
（2）命令格式可采用长格式或短格式的方式，且不区分大小写。短格式为只使用长格 式关键字的前 3 个或 4 个字母，如：CURR、VOLT 等均为短格式关键字。在关键字定义中， 每一个关键字的短格式字母以大写字母表示，以便于记忆。电子负载可接受Volt、volt、voltage、 VOLTAGE、volTAGE 等格式。但是，若关键字不完整，如：“VOL”、“curre” 等则属于非法的 未知命令。
（3）数据格式定义：
符号 | 说明 | 范例 |
NR1 | 整数，不含小数点 | 123、0123 |
NR2 | 整数或小数，可含小数点 | 123、12.3、0.123 |
Bool | 选项型 | 0 | 1、ON | OFF |
（4）协议通信中所有发送/回传的数据一律不带单位，仪器将根据参数类别自动固定其单位，具体详见各命令解释。
数据 | 默认单位 |
电压 | V |
电流 | A |
电阻 | Ω |
功率 | W |
时间 | ms |
（5）协议命令中使用的助记符号相关说明如下。
助记符 | 意义 |
[ ] | 方括号表示可以选择的项 |
< > | 尖括号用以代替命令的参数 |
| | 竖线符号表示可替代的参数 |
（6）当电子负载处于就地[Local]控制时，上位机只能读取电子负载的实时数据和状态，相关写操作是不被允许的。若上位机需要控制电子负载的运行，则必须将电子负载设置为远控[Remote]方式。电子负载处于远控且 Local 按键被锁定时，若约 10s 内未收到任何通信数据，则电子负载认为通信线路中断，自动解锁 Local 按键。
1.1 公用命令
公用命令以“*”开始，且必须位于行首，位于命令行中间的公用命令是非法的。
公用命令 | 说明 | 描述 |
*CLS | 清除事件 | 清除电子负载中的所有事件。 命令语法：*CLS |
*IDN? | 查询装置信息 | 命令语法：*IDN? 返回参数：<Company>,<Product>,< S/N >,< Version > |
<Company> 制造商 <Product> 产品型号 <S/N> 产品序列号 < Version> 软件版本号查询范例：*IDN? 回传范例：DINGCHEN,DCL8001,L20170001A,V1.00 | ||
*TRG | 总线触发 | 当电子负载触发源为非 EXTERNAL 方式时，这条命令将会产生一个触发信号，功能与 TRIG 命令相同。 命令语法：*TRG 相关命令：TRIG, TRIG:SORU |
*ESR? | 查询标准事件 | 命令语法：*ESR?返回参数：<NR1> Bitn 表示十六进制数据中的第 n 位。 |
Bit0 | 语法错误 |
Bit1 | 未知命令 |
Bit2 | 格式错误 |
Bit3 | 数值超限 |
Bit4 | 非法操作 |
1.2 子系统命令
设备支持以下子系统命令：
FETCh、STATus、EVENt、CONFigure、LOAD、TRIG、CURRent、VOLTage、RESistance、 POWer、TRAN、OCP、OPP、BATTery、CVCC、CVCR、CRCC、LED、LIST、TIMING、OVP、
EFFect 等。详见具体子系统应用说明。
1.2.1 FETCh 子系統
FETCh:CURRent?
说明： 回传实时电流值。
查询语法： FETCh:CURRent?
回传参数： <NR2>, [单位: A]
查询范例： FETCh:CURR?
回传范例： 1.000
FETCh:VOLTage?
说明： 回传实时电压值。
查询语法： FETCh:VOLTage?
回传参数： <NR2>, [单位: V]
查询范例： FETCh:VOLT?
回传范例： 12.000
FETCh:POWer?
说明： 回传实时电压值。
查询语法： FETCh:POWer?
回传参数： <NR2>, [单位: W]
查询范例： FETCh:POWer?
回传范例： 3.000
FETCh:TIME?
说明： 回传运行计时。
查询语法： FETCh:TIME?
回传参数： <NR2>, [单位: s]
查询范例： FETCh:TIME?
回传范例： 50
FETCh:IPP?
说明： 回传电流峰峰值。
查询语法： FETCh:IPP?
回传参数： <NR2>, [单位: A]
查询范例： FETCh:IPP?
回传范例： 0.003
FETCh:VPP?
说明： 回传电压峰峰值。
查询语法： FETCh:VPP?
回传参数： <NR2>, [单位: V]
查询范例： FETCh:VPP?
回传范例： 0.020
FETCh:MAXI?
说明： 回传 OCP 最大保护电流。
查询语法： FETCh:MAXI?
回传参数： <NR2>, [单位: A]
查询范例： FETCh:MAXI?
回传范例： 4.500
FETCh:MAXP?
说明： 回传 OPP 最大保护功率。
查询语法： FETCh:MAXP?
回传参数： <NR2>, [单位: W]
查询范例： FETCh:MAXP?
回传范例： 8.000
FETCh:XXXX?
说明： 回传时间测试、OVP 等模式下的上升/下降时间。
查询语法： FETCh:TRIS?
回传参数： <NR2>, [单位: ms]
查询范例： FETCh:XXXX?
回传范例： 40.000
FETCh:CAPacity?
说明： 回传电池放电累计电量。
查询语法： FETCh:CAPacity?
回传参数： <NR2>, [单位: AH/WH,取决于放电模式]
查询范例： FETCh:CAPacity?
回传范例： 3.250
FETCh:EFFect
说明： 回传负载调整率百分比。
查询语法： FETCh:EFFect?
回传参数： <NR2>, [单位: %]
查询范例： FETCh:EFF?
回传范例： 0.50
FETCh:DELTV
说明： 回传△V。
查询语法： FETCh:DELTV?
回传参数： <NR2>, [单位: V]
查询范例： FETCh:DELTV?
回传范例： 0.100
1.2.2 STATus 子系統
STATus:RUN?
说明： 回传电子负载运行状态。
查询语法： STATus:RUN?
回传参数： 0 | 1, [0 停止, 1 运行]
查询范例： STATus:RUN?
回传范例： 0
STATus:TRIG?
说明： 回传等待触发请求状态。
查询语法： STATus:TRIG?
回传参数： 0 | 1, [0 无等待, 1 等待触发]
查询范例： STATus:TRIG?
回传范例： 1
STATus:RESn?
说明： 回传第 n 个测试结果。列表模式每步对应一个测试结果，其他测试模式测试结果均为 RES1。
命令语法： STATus:RES<NR1>?
命令参数： 1~16
回传参数： 0 | 1, [0 Fail, 1 Pass]
查询范例： STATus:RES1?
回传范例： 1
1.2.3 EVENt 子系統
EVENt?
说明： 回传电子负载事件报告。
查询语法： EVENt?
回传参数： <NR1>, 事件代码如下所示：
事件代码 | |||
Bit0： | 联机失败 | Bit8： | 数据超限 |
Bit1： | 自检失败 | Bit9： | 数位超限 |
Bit2： | 极性错误 | Bit10： | 档位错误 |
Bit3： | 过压保护 | Bit11： | 非法操作 |
Bit4： | 过流保护 | Bit12： | 逻辑错误 |
Bit5： | 功率保护 | Bit13： | 读写错误 |
Bit6： | 过热保护 | Bit14： | 初始化错误 |
Bit7： | 欠压保护 | Bit15： | 测试结束 |
Bitn 表示十六进制数据中的第 n 位。
查询范例： EVENt?
回传范例： 8
1.2.4 CONFigure 子系統
CONFigure:VPRO
说明： 设置过压保护值。
命令语法： CONFigure:VPRO <NR2>?
命令参数： <NR2>,[单位: V]
查询范例： CONFigure:VPRO?
回传范例： 120.000
CONFigure:IPRO
说明： 设置过流保护值。
命令语法： CONFigure:IPRO <NR2>
命令参数： <NR2> ,[单位: A]
查询范例： CONFigure:IPRO?
回传范例： 15.000
CONFigure:PPRO
说明： 设置过功率保护值。
命令语法： CONFigure:PPRO <NR2>
命令参数： <NR2>,[单位: W]
查询范例： CONFigure:PPRO?
回传范例： 150.00
CONFigure:VON
说明： 设置带载电压值。
命令语法： CONFigure:VON <NR2>
命令参数： <NR2>,[单位: V]
查询范例： CONFigure:VON?
回传范例： 1.00
1.2.5 LOAD 子系統
LOAD
说明： 负载启/停控制。
命令语法： LOAD <Bool>
命令参数： <ON|OFF>
设定范例： LOAD ON
LOAD:SENSe
说明： 远端电压补偿开关。
命令语法： LOAD:SENSe <Bool>
命令参数： <ON|OFF>
设定范例： LOAD:SENSe ON
查询范例： LOAD:SENSe?
回传范例： OFF
LOAD:REMote
说明： 远程控制开关
命令语法： LOAD:REMote <Bool>
命令参数： <ON|OFF>
设定范例： LOAD:REMote ON
查询范例： LOAD:REMote?
回传范例： OFF
LOAD:RMLOCK
说明： LOCAL 键锁定
命令语法： LOAD:RMLOCK <Bool>
命令参数： <ON|OFF>
设定范例： LOAD:RMLOCK ON
LOAD:SHORt
说明： 短路测试开关。
命令语法： LOAD:SHORt <Bool>
命令参数： <ON|OFF>
设定范例： LOAD:SHORt ON
查询范例： LOAD:SHORt?
回传范例： ON
LOAD:PAUSe
说明： 测试暂停开关
命令语法： LOAD:PAUSe <Bool>
命令参数： <ON|OFF>
设定范例： LOAD:PAUSe ON
查询范例： LOAD:PAUSe?
回传范例： OFF
LOAD:ERCLS
说明： 告警事件清除。
命令语法： LOAD:ERCLS <Bool>
命令参数： <ON>
设定范例： LOAD:ERCLS ON
LOAD:CACLS
说明： 计算量清除。
命令语法： LOAD:CACLS <Bool>
命令参数： <ON>
设定范例： LOAD:CACLS ON
1.2.6 TRIG 子系統
TRIG
说明： 启动一次触发，触发源为 Manual 时才有效。
命令语法： TRIG <Bool>
命令参数： <ON>
TRIG:SOURce
说明：
触发源选择。MANual 为面板按键触发或通信触发方式，EXTernal 为外部触发方式。
命令语法： TRIG:SOURce <Bool>
命令参数： <MANual|EXTernal>
查询范例： TRIG:SOURce?
回传范例： MANUAL, [范围 MANUAL 或 EXTERNAL]
1.2.7 CURRent 子系統
CURRent
说明： 设置恒流值。
命令语法： CURRent <NR2>
命令参数： <NR2>,[单位: A]
查询范例： CURRent?
回传范例： 1.000
1.2.8 VOLTage 子系統
VOLTage
说明： 设置恒压值。
命令语法： VOLTage <NR2>
命令参数： <NR2> ,[单位: V]
查询范例： VOLTage?
回传范例： 5.000
1.2.9 RESistance 子系統
RESistance
说明： 设置恒阻值。
命令语法： RESistance <NR2>
命令参数： <NR2>,[单位:Ω]
查询范例： RESistance?
回传范例： 100.00
1.2.10 POWer 子系統
POWer
说明： 设置恒功率值。
命令语法： POWer <NR2>
命令参数： <NR2> ,[单位:W]
查询范例： POWer?
回传范例： 50.00
1.2.11 TRAN 子系統
TRAN:MODE
说明： 设置动态模式。
命令语法： TRAN:MODE <Bool>
命令参数： <CC|CV>
查询范例： TRAN:MODE?
回传范例： CC
TRAN:RUNWay
说明： 设置动态运行方式。
命令语法： TRAN:RUNWay <Bool>
命令参数： < CONT|PULSE|REVE>,[CONT 连续, PULSE 脉冲, REVE 翻转]
查询范例： TRAN:RUNWay?
回传范例： CONT
TRAN:LEVA
说明： 设置 A 段定值与 A 段定时。
命令语法： TRAN:LEVA <NR2>,<NR2>
命令参数： <A 段定值>,<A 段定时>,[单位:A 或 V(取决于动态模式), ms]
查询范例： TRAN:LEVA?
回传范例： 1.000,1000
TRAN:LEVB
说明： 设置 B 段定值与 B 段定时。
命令语法： TRAN:LEVB <NR2>,<NR2>
命令参数： <B 段定值>,<B 段定时>,[单位:A 或 V(取决于动态模式), ms]
查询范例： TRAN:LEVB?
回传范例： 3.000,1000
TRAN:RISE
说明： 设置上升斜率。，
命令语法： TRAN:RISE <NR2>
命令参数： <上升斜率>,[单位:A/us 或 V/us(取决于动态模式)]
查询范例： TRAN:RISE?
回传范例： 0.100
TRAN:FALL
说明： 设置下降斜率
命令语法： TRAN:FALL <NR2>
命令参数： <下降斜率>,[单位:A/us 或 V/us(取决于动态模式)]
查询范例： TRAN:FALL?
回传范例： 0.100
TRAN:REPeat
说明： 设置重复次数。
命令语法： TRAN:REPeat <NR1>
命令参数： <重复次数>,[单位:次]
查询范例： TRAN:REPeat?
回传范例： 100
1.2.12 OCP 子系統
OCP:STVAL
说明： 设置初始电流值。
命令语法： OCP:STVAL <NR2>
命令参数： <电流值>,[单位:A]
查询范例： OCP:STVAL?
回传范例： 0.100
OCP:STPVAL
说明： 设置步进电流值。
命令语法： OCP:STPVAL <NR2>
命令参数： <电流值>,[单位:A]
查询范例： OCP:STPVAL?
回传范例： 0.500
OCP:ENDVAL
说明： 设置截止电流值。
命令语法： OCP:ENDVAL <NR2>
命令参数： <电流值>,[单位:A]
查询范例： OCP:ENDVAL?
回传范例： 5.000
OCP:STIM
说明： 设置步近时间。
命令语法： OCP:STIM <NR2>
命令参数： <步近时间>,[单位:ms]
查询范例： OCP:STIM?
回传范例： 1000.00
OCP:MINVOL
说明： 设置截止电压。
命令语法： OCP:MINVOL <NR2>
命令参数： <截止电压>,[单位:V]
查询范例： OCP:MINVOL?
回传范例： 4.500
1.2.13 OPP 子系統
OPP:STVAL
说明： 设置初始功率值。
命令语法： OPP:STVAL <NR2>
命令参数： <功率值>,[单位:W]
查询范例： OPP:STVAL?
回传范例： 0.100
OPP:STPVAL
说明： 设置步进功率值。
命令语法： OPP:STPVAL <NR2>
命令参数： <功率值>,[单位:W]
查询范例： OCP:STPVAL?
回传范例： 1.000
OPP:ENDVAL
说明： 设置截止功率值。
命令语法： OPP:ENDVAL <NR2>
命令参数： <功率值>,[单位:W]
查询范例： OPP:ENDVAL?
回传范例： 3.000
OPP:STIM
说明： 设置步近时间。
命令语法： OPP:STIM <NR2>
命令参数： <步近时间>,[单位:ms]
查询范例： OPP:STIM?
回传范例： 1000.00
OPP:MINVOL
说明： 设置截止电压。
命令语法： OPP:MINVOL <NR2>
命令参数： <截止电压>,[单位:V]
查询范例： OPP:MINVOL?
回传范例： 4.500
1.2.14 BATTery 子系統
BATTery:MODE
说明： 设置电池放电模式。
命令语法： BATTery:MODE <Bool>
命令参数： <CC|CR|CP>, [恒流/恒阻/恒功率放电]
查询范例： BATTery:MODE?
回传范例： CC
BATTery:VALue
说明： 设置负载带载参数。
命令语法： BATTery:VALue <NR2>
命令参数： <带载参数>,[单位:A/Ω/W,取决于放电模式]
查询范例： BATTery:VALue?
回传范例： 1.000
BATTery:ENDVoltage
说明： 设置放电截止电压。
命令语法： BATTery:ENDVoltage <NR2>
命令参数： <截止电压>,[单位:V]
查询范例： BATTery:ENDV?
回传范例： 12.000
1.2.15 CRCC 子系統
CRCC:STVAL
说明： 设置组合模式的初始值。
命令语法： CRCC:STVAL <NR2>
命令参数： <恒阻值>,[单位:Ω]
查询范例： CRCC:STVAL?
回传范例： 10.000
CRCC:SWVAL
说明： 设置组合模式的切换值。
命令语法： CRCC:SWVAL <NR2>
命令参数： <恒流值>,[单位:A]
查询范例： CRCC:SWVAL?
回传范例： 2.000
1.2.16 CVCR 子系統
CVCR:STVAL
说明： 设置组合模式的初始值。
命令语法： CVCR:STVAL <NR2>
命令参数： <恒压值>,[单位:V]
查询范例： CVCR:STVAL?
回传范例： 3.000
CVCR:SWVAL
说明： 设置组合模式的切换值。
命令语法： CVCR:SWVAL <NR2>
命令参数： <恒阻值>,[单位:Ω]
查询范例： CVCR:SWVAL?
回传范例： 1.000
1.2.17 CVCC 子系統
CVCC:STVAL
说明： 设置组合模式的初始值。
命令语法： CVCC:STVAL <NR2>
命令参数： <恒压值>,[单位:V]
查询范例： CVCC:STVAL?
回传范例： 3.000
CVCC:SWVAL
说明： 设置组合模式的切换值。
命令语法： CVCC:SWVAL <NR2>
命令参数： <恒流值>,[单位:A]
查询范例： CVCC:SWVAL?
回传范例： 5.000
1.2.18 LED 子系統
LED:OPPV
说明： 设置 LED 操作点电压。
命令语法： LED:OPPV <NR2>
命令参数： <操作点电压>,[单位:V]
查询范例： LED:OPPV?
回传范例： 24.000
LED:OPPI
说明： 设置 LED 操作点电流。
命令语法： LED:OPPI <NR2>
命令参数： <操作点电流>,[单位:A]
查询范例： LED:OPPI?
回传范例： 2.500
LED:COEF
说明： 设置 LED 系数。
命令语法： LED:COEF <NR2>
命令参数： <系数>,[范围 0.1~0.4]
查询范例： LED:COEF?
回传范例： 0.100
1.2.19 LIST 子系統
LIST:STPNum
说明： 设置列表的总步数。
命令语法： LIST:STPNum <NR1>
命令参数： 1~16,[范围 1~16 步]
查询范例： LIST:STPNum?
回传范例： 3
LIST:REPeat
说明： 设置列表运行的重复次数。
命令语法： LIST:REPeat <NR1>
命令参数： 1~99999, [范围 1~99999 次]查询范例： LIST:REPeat?
回传范例： 10
LIST:RUNWay
说明： 设置运行方式。
命令语法： LIST:RUNWay <Bool>
命令参数： <CONT|TRIG|CONTERR|TRIGERR >
CONT 连续运行方式
TRIG 触发方式
CONTERR 连续运行，发生错误时停止
TRIGERR 触发方式，发生错误时停止
查询范例： LIST:RUNWay?
回传范例： CONT
LIST:STEPn
说明： 设置第 n 步的相应参数。
命令语法： LIST:STEPn <Bool>,<NR2>,<NR2>,<Bool>,<NR2>,<NR2>
命令参数： ①<CC|CV|CR|CP|OPEN|SHORt>,带载模式
②<NR2>,带载值, [单位:A/V/Ω/W]
③<NR2>,带载时间，[单位:ms]
④<OFF|CURR|VOLT|POWER>,检查类型
⑤<NR2>,检查上限值
⑥<NR2>,检查下限值
查询范例： LIST:STEP1?
回传范例： CC,1.000,1000.0,VOLT,4.500,5.500
1.2.20 TIMING 子系統
TIMING:MODE
说明： 设置时间测试的带载模式。
命令语法： TIMING:MODE <Bool>
命令参数： <CC|CV|CR|CP|OPEN>
查询范例： TIMING:MODE?
回传范例： CC
TIMING:VALue
说明： 设置时间测试的带载值。
命令语法： TIMING:VALue <NR2>
命令参数： <NR2>,[单位: A/V/Ω/W]
查询范例： TIMING:VALue?
回传范例： 1.00
TIMING:STTRIG
说明： 设置时间测试的起始触发源。
命令语法： TIMING:STTRIG <Bool>
命令参数： <CURR|VOLT|EXT>
查询范例： TIMING:STTRIG?
回传范例： VOLT
TIMING:STEDGE
说明： 设置时间测试的起始边沿。
命令语法： TIMING:STEDGE <Bool>
命令参数： <RISE|FALL>
查询范例： TIMING:STEDGE?
回传范例： RISE
TIMING:STLEV
说明： 设置时间测试的起始电平。
命令语法： TIMING:STLEV <NR2>
命令参数： <NR2>,[单位: A/V]
查询范例： TIMING:STLEV?
回传范例： 1.00
TIMING:ENDTRIG
说明： 设置时间测试的结束触发源。
命令语法： TIMING:ENDTRIG <Bool>
命令参数： <CURR|VOLT|EXT>
查询范例： TIMING:ENDTRIG?
回传范例： VOLT
TIMING:ENDEDGE
说明： 设置时间测试的结束边沿。
命令语法： TIMING:ENDEDGE <Bool>
命令参数： <RISE|FALL>
查询范例： TIMING:ENDEDGE?
回传范例： RISE
TIMING:ENDLEV
说明： 设置时间测试的结束电平。
命令语法： TIMING:ENDLEV <NR2>
命令参数： <NR2>,[单位: A/V]
查询范例： TIMING:ENDLEV?
回传范例： 1.00
1.2.21 OVP 子系統
OVP:VTRig
说明： 设置 OVP 测试的触发电平。
命令语法： OVP:VTRig <NR2>
命令参数： <NR2>,[单位: V]
查询范例： OVP:VTRig?
回传范例： 5.00
1.2.22 EFFect 子系統
EFFect:VRATE
说明： 设置负载效应测试的电源额定电压。
命令语法： EFFect:VRATE <NR2>
命令参数： <NR2>,[单位: V]
查询范例： EFFect:VRATE?
回传范例： 5.00
EFFect:IRATE
说明： 设置负载效应测试的电源额定电流。
命令语法： EFFect:IRATE <NR2>
命令参数： <NR2>,[单位: A]
查询范例： EFFect:IRATE?
回传范例： 2.00