SPL Series Scpi Programming Guide SB - GB
SPL Series Scpi Programming Guide SB - GB
KONSTANTER SPL
3-349-710-03
SPL Series Electronic Load SCPI Programming Guide 3/12.20
( :ROOT)
[SOURce:]
MODE TRANsient
INPut
CURRent [:STATe] STATus
[:STATe]
[:LEVel] :MODE :QUEStionable
:SHORt
[:IMMediate] :LTIMe [:EVENt]?
[:STATe]
[:AMPLitude]
:CONDition?
:LATCh
:LOW
:ENABle
LIST [:STATe]
:HIGH
:ENABle?
[:STATe] :VOLTage
:TRIGgered
:OPERation
:MEMO [:LEVel]
[:AMPLitude]
:NUMBer
:RISE MEASure SYSTem
:COUNt
:RATE [:SCALar] :ERRor
:CHAin
VOLTage
:CURRent [:NEXT]?
[:LEVeI] :SAVE
[:DC]? :VERSion?
[:IMMediate] :CLEar
:VOLTage :REMote
[:AMPLitude]
[:DC]? :LOCal
BATTery
:LOW
:REMote
[:STATe]
TRIGger
RESistance :UPDate
:TERMinate
[:IMMediate]
[:LEVeI] :UPDate
:VOLTage
[:IMMediate] :SOURce
:CODE
:CAPacity
[:AMPLitude] :FUNCtion
:CLEar
:LOW ABORt
POWer
[:LEVeI]
[:IMMediate]
[:AMPLitude]
Content Page
1 SCPI Introduction ............................................................. 2 1 SCPI Introduction
1.1 What is SCPI? ...............................................................2
1.2 Command Syntax ..........................................................2 1.1 What is SCPI?
1.2.1 SCPI Keywords .............................................................2 SCPI is the Standard Commands for Programmable Instruments
1.2.1.1 Forms of Keywords .....................................................2 based on the IEEE488.1 and IEEE488.2 Standards. It conforms
1.2.1.2 Keyword Conventions .................................................3 to IEEE754 Standard for Floating-Point Arithmetic, ISO646 7-bit
1.2.2 Separators .....................................................................3 Coded Character Sets for Information Exchange, and other kinds
1.2.3 Parameters ....................................................................3 of standards.
1.2.3.1 Parameter Formats ......................................................3 SCPI Commands for SPL Series Electronic Load can be divided
1.2.3.2 Data Unit .....................................................................3 into two types: one is IEEE488.2 common commands; the other
1.2.4 Terminators ...................................................................3 is specific commands for the load.
1.3 Examples .......................................................................3 Some generic commands and queries for instruments are
1.3.1 Simple Command Statements .......................................3 defined by the IEEE488.2 common commands. All IEEE488.2
common commands consist of “*” and the mnemonic symbol of
1.3.2 Compound Command Statements ................................3
three characters. (For example: *IDN?, *SAV, *WAI etc.)
1.3.3 Simple Command Queries .............................................3
The specific commands are used to execute settings, testing,
1.3.4 Compound Command Queries ......................................3
and measuring etc. functions of the load. These commands are
organized in the form of the command tree. Each command con-
2 SCPI Commands Descriptions .......................................... 4 tains several mnemonic symbols. The nodes are separated by the
2.1 IEEE488.2 Common Commands ...................................4 character “:”, see figure 1-1. The top part of the command tree is
2.2 SCPI Root Commands ..................................................6 called “ROOT”. The entire path from “ROOT” to leaf node is a
2.2.1 ABORt ...........................................................................6 complete programming command.
2.2.2 CURRent Subsystem .....................................................6
2.2.3 VOLTage Subsystem .....................................................7
2.2.4 RESistance Subsystem ..................................................8 1.2 Command Syntax
2.2.5 POWer Subsystem ........................................................8 SCPI Commands for SPL Series Electronic Load carry on and
2.2.6 INPut Subsystem ...........................................................8 expand IEEE488.2 Standards. The programming command con-
2.2.7 TRANsient Subsystem ...................................................9 sists of keywords, separators, parameters, and terminators etc.
Take the following command as an example:
2.2.8 LIST Subsystem ..........................................................10
2.2.9 MODE ..........................................................................10 CURRent:PROTection:STATe ON
2.2.10 MEASure .....................................................................11 CURRent, PROTection, STATe are the keywords; “:” and
2.2.11 STATus Subsystem .....................................................11 spaces are separators; ON is the parameter (some commands
have several parameters; they are separated by “,”); the carriage
2.2.12 SYSTem ......................................................................12
return after the command is a terminator.
2.2.13 TRlGger Subsystem .....................................................12
To make it easy to describe, the various follow-up symbols
2.2.14 ATTery Subsystem .......................................................13
represent:
Square brackets ([]) represent the optional keywords or the
3 Error Messages .............................................................. 13 parameter can be omitted.
Braces ({}) represent the parameter options in the command
4 Status Register Reporting .............................................. 14 string.
Angle brackets (<>) represent that it is necessary to provide a
5 Product Support ............................................................. 16 numeric parameter.
Vertical line (|) is used to separate multiple parameter options.
*SRE
This command sets the condition of the Status Byte Enable regis-
ter. The programming parameters determine whether or not a 0 to
1 transition in the Status Byte register will set the RQS bit of the
Status Byte register. See Status Reporting for more details concern-
ing the Status Byte register.
Command Syntax: *SRE <NR1>
Parameter: 0~255
Query Syntax: *SRE?
Returned Parameter: <NR1>
Related Commands: *PSC
*STB?
This query reads the Status Byte register. The Status Byte register
is cleared when this query has been executed. The *STB? query
and a serial poll share the same returned parameter, but the ser-
vice request bit (bit 6) of the Status Byte register will not be
cleared when a serial poll is sent. See Status Reporting for more
details concerning the Status Byte register.
*TRG
This command which is essentially the same as the Group Exe-
cute Trigger (<GET>), generates a trigger to the load only if
TRIG:SOUR is set to BUS. This command becomes effective only
when the trigger source is set to BUS.
Command Syntax: *TRG
Parameter: None
Related Commands: TRIG TRIG:SOUR
*TST?
This query causes the load to go through a limited self-test. The
testing does not alter the mode or parameter settings of the load.
Command Syntax: *TST?
Returned Parameter: <NR1> 0 = test passed None0= a self-
test failure
*WAI
This command instructs the load not process any further com-
mands until all pending operations are completed. All pending
operations are complete including all pending trigger levels have
triggered. *WAI can be aborted only by sending the load a GPIB
DCL (Device Clear) command.
Parameter: None
Related Commands: *OPC *OPC?
2.2.1 ABORt
[SOURce:]CURRent:PROTection:DELay
This command cancels all pending [:LEVel]:TRIG operations (such Specifies time for which protection current limit may be exceeded.
as CURR:TRIG). As a result, subsequent triggers have no effect The delay period is calculated after the actual current reaches or
on the input level. ABORt has no effect on the Transient operation exceeds the protection current limit. When the delay period is
and List (Sequence) operation. reached, the load input will be turned off.
Command Syntax: ABORt Command Syntax: CURRent:PROTection:DELay <NRf+>
Parameter: None Parameter: Digits |MIN|MAX
Example: ABOR Unit: s|ms
Query Syntax: None Example: CURRent:PROTection:DELay 0.5
Related Commands: CURR[:LEVel]:TRIG, VOLT[:LEVel]:TRIG, Query Syntax: [SOURce:]CURRent:PROTection:DELay?
RES[:LEV]:TRIG, STAT:OPER:COND?
Parameter: None |MIN|MAX
Example: CURR:PROT:DEL? ; CURR:PROT:DEL?MIN ;
2.2.2 CURRent Subsystem CURR:PROT:DEL? MAX
Returned Parameter: <NR3>
[SOURce:]CURRent[:LEVel] [:IMMediate] [:AMPLitude] Related Commands: INP:PROT:CLE, CURR:PROT
Specifies the immediate current level for the load. CURR? MIN
and CURR? MAX return the maximum and minimum current level
for the present range. If the set level exceeds the range, an error [SOURce:]CURRent:PROTection:STATe
will be generated. Disables/Enables current protection function.
Command Syntax: [SOURce:]CURRent [:LEVel] [:IMMediate] Command Syntax: [SOURce:]CURRent:PROTection:STATe
<NRf+> <bool>
Parameters: Digits |MIN|MAX Parameter: ON|OFF
Unit: A|mA Example: CURR:PROT:STAT ON
Example: CURR 25A Query Syntax: [SOURce:]CURRent:PROTection:STATe?
Query Syntax: [SOURce:]CURRent[:LEVel] [:IMMediate] [:AMPLitude]? Parameter: None
Parameter: None |MIN|MAX Example: CURR:PROT:STAT?
Example: CURR? CURR? MIN CURR? MAX Returned Parameter: <NR1> Value 0=OFF, 1=ON
Returned Parameter: <NR3> Related Commands: CURR:PROT, INP:PROT:CLE
Related Commands: CURR:LOW; CURR:TRIG, CURR:RISE:RATE
[SOURce:]POWer[:LEVeI]:TRIGgered[:AMPLitude]
[SOURce:]RESistance[:LEVeI]:TRIGgered[:AMPLitude] Specifies the power trigger level. It shares the same range with
Specifies the resistance trigger level for the load. It shares the the power level. The power trigger level becomes the power level
same range with the immediate resistance level. The resistance only when the trigger signal has been received.
trigger level becomes the immediate resistance level only when Command Syntax: [SOURce:]POWer[:LE'Vel]:TRIGgered
the trigger signal has been received. [:AMPLitude]<NRf+>
Command Syntax: [SOURce:]RESistance[:LEVel]:TRIGgered Parameter: Digits |MIN|MAX
[:AMPLitude] <NRf+> Unit: W|mW
Parameter: Digits |MIN|MAX Example: POW:TRIG 10w
Unit: OHM|mOHM|kOHM Query Syntax: [SOURce:]POWer[:LEVel]:TRIGgered[:AMPLitude]?
Example: RES: TRIG 3 OHM Parameter: None |MIN|MAX
Query Syntax: [SOURce:]RESistance[:LEVel]:TRIGgered[:AMPLitude]? Example: POW:TRIG? POW:TRIG? MIN POW:TRIG? MAX
Parameter: None |MIN|MAX Returned Parameter: <NR3>
Example: RES:TRIG? RES:TRIG? MIN RES:TRIG? MAX Related Commands: INIT, INIT:CONT
Returned Parameter: <NR3>
Related Commands: INIT, INIT:CONT
2.2.6 INPut Subsystem
[SOURce:]RESistance:[LEVel]:LOW INPut[:STATe]
Specifies the transient resistance low level, which shares the Enables/Disables the load input.
same range with the immediate resistance level. Command Syntax: INPut[:STATe] <bool>
Parameter: ON |OFF
Command Syntax: [SOURce:]RESistance:[LEVel]:LOW <NRf+> Example: INP ON
Parameter: Digits |MIN|MAX Query Syntax: INPut[:STATe]?
Unit: OHM Parameter: None
Example: RES:LOW 3 OHM Example: INP?
Query Syntax: [SOURce:]RESistance:LOW? Returned Parameter: <NRI> Value:0(OFF) 1(ON)
Parameter: None |MIN|MAX Related Commands: INP:SHOR
Example: RES:LOW? RES:LOW? MIN RES:LOW? MAX
Returned Parameter: <NR3>
INPut:SHORt[:STATe]
Related Commands: RESistance:HIGH, TRAN:HTIMe
Enables/Disables the short circuit of the load.
Command Syntax: INPut:SHORt[:STATe] <bool>
[SOURce:]RESistance:[LEVel]:HIGH Parameter: ON |OFF
Specifies the transient voltage high level, which shares the same Example: INP:SHOR ON
range with the immediate resistance level. Query Syntax: INPut:SHORt[:STATe]?
Command Syntax: [SOURce:]RESistance:[LEVel]:HIGH <NRf+> Parameter: None
Parameter: Digits |MIN|MAX Example: INP:SHOR?
Unit: OHM Returned Parameter: <NR1> Value:0(OFF) 1(ON)
Example: RES:HIGH 3 OHM Related Commands: INP[:STAT]
Query Syntax: [SOURce:]RESistance[:LEVEL]:HIGH?
Parameter: None |MIN|MAX
Example: RES:HIGH? RES:HIGH? MIN RES:HIGH? MAX
Returned Parameter: <NR3>
Related Commands: RESistance:HIGH, TRAN:HTIMe
[SOURce:]LIST[:STATe]
[SOURce:]LIST:CLEar
Enables/Disables the list operation.
Deletes all steps for list operation.
Command Syntax: [SOURce:]LIST[:STATe] <bool>
Command Syntax: [SOURce:]LIST:CLEar
Parameter: On|Off
Parameter: None
Example: LIST on LIST off
Example: LIST:SAVE
Query Syntax: [SOURce:]LIST[:STATe]?
Related Commands: LIST:CLE
Returned Parameter: <NR1> Value:0 for OFF, 1for ON
Related Commands: LIST:NUMB, LIST:CONT
[SOURce:]LIST:COUNt
Sets the cycle times (Count) for list operation.
[SOURce:]LIST:MEMO
Command Syntax: [SOURce:]LIST:COUNt <NR1>
Sets the Memo of the list.
Parameter: 0~65535
Command Syntax: [SOURce:]LIST: MEMO “<aard>”
Unit: None
Parameter: “0x20-0x7f”
Example: LIST:COUNt 10
Example: LIST: MEMO “GMC”
Query Syntax: LIST:COUNt?
Query Syntax: [SOURce:]LIST:MEMO?
Returned Parameter: <NR1>
Returned Parameter: <aard>
Related Commands: LIST:NUMB, LIST:EDIT
Related Commands: LIST:NUMB, LIST:CONT
[SOURce:]LIST:CHAIn
[SOURce:]LIST:NUMBer
Sets the chained list for the present list.
Sets the list number for the list operation.
Command Syntax: [SOURce:]LIST:CHAIn <NR1>
Command Syntax: LIST:NUMBer <NR1>
Parameter: 0~6|OFF
Parameter: 0~6
Example: LIST:CHA 2
Example: LIST:NUMB 2
Query Syntax: LIST:CHA?
Query Syntax: [SOURce:]LIST:NUMBer?
Returned Parameter: <NR1>
Returned Parameter: <NR1> 0~6
Related Commands: LIST:NUMB, LIST:MEMO
Related Commands: LIST:ADD, LIST:CONT
[SOURce:]LIST[:STEP]:ADD [SOURce:]LIST:SAVe
Saves the list date according to the list number.
Adds a new step. The values for each new step include operating
mode, load value, operating time. Command Syntax: [SOURce:]LIST:SAVe
Command Syntax: [SOURce:]LIST[:STEP]:ADD Parameter: None
<aard>,<NRf>,<NRf> Example: LIST:SAVE
Parameter: CCL|CCH|CRL|CRM |CRH|CV, Digits |MIN|MAX, Digits Related Commands: LIST:CLE
|MIN|MAX
Unit: None, Current Unit| Voltage Unit| Resistance Unit, s
Example: LIST:ADD cch,1a,1s 2.2.9 MODE
Related Commands: LIST:DEL, LIST:INS MODE
Sets the basic test mode for the load.
CC Mode CCL CCH
[SOURce:]LIST[:STEP]:INSert
CV Mode CV
Inserts a new step at specified step.
CP Mode CPC CPV
Command Syntax: [SOURce:]LIST[:STEP]:INSert
<NR1>,<aard>,<NRf>,<NRf> CR Mode CRL CRM CRH
Parameter: 1~50,CCL|CCH|CRL|CRM |CRH|CV, Digits |MIN|MAX, Command Syntax: MODE <AARD>
Digits |MIN|MAX Parameter: CCL|CCH|CRL| CRM|CRH|CV|CPC|CPV
Unit: None, None, Current Unit| Voltage Unit| Resistance Unit, s Example: MODE CCL
Example: LIST:INSert 2,cch,2a,1s Query Syntax: [SOURce:]MODE?
Related Commands: LIST:DEL, LIST:ADD Returned Parameter: <AARD> CCL|CCH|CRL|
CRM|CRH|CV|CPC|CPV
[SOURce:]LIST[:STEP]:EDIT
Edits one specified step.
Command Syntax: [SOURce:]LIST[:STEP]:EDIT
<NR1>,<aard>,<NRf>,<NRf>
Parameter: 1~50,CCL|CCH|CRL|CRM |CRH|CV, Digits|MIN|MAX,
Digits|MIN|MAX
Unit: None, None, Current Unit| Voltage Unit| Resistance Unit, s
Example: LIST:EDIT 2,cch,3a,1s
STATus:QUEStionable:CONDition?
This query reads the Questionable Status Condition register. Each
0 to 1 transition of the condition of the Questionable Condition
register will set the corresponding bit of the Questionable Status
Event register. See Status Reporting for more details concerning
the Questionable Status Condition register.
Query Syntax: STATus:QUEStionable:CONDition?
Parameter: None
Returned Parameter: <NR1>
[SOURce:]BATTery[:DISCharge]:TIME?
Queries the discharged time of the battery.
Command Syntax: [SOURce:]BATTery[:DISCharge]:TIME?
Example: BATT:TIME?
Returned Parameter: <NR1>:<NR1>:<NR1>(Hour: Minute: Second)
Related Commands: BATT:VOLT
All trademarks, registered trademarks, logos, product names, and company names are the property of their respective owners.