Chapter 2 Commands

2.1 Command Summary

2.1.1 Standard Commands Specified by IEEE 488.2
CommandData
(for a query, response data)
Explanation
*CLS Clears the status byte and associated queues.
*ESR? A<NR1>:0 to 255 Queries SESR.
*IDN? Maker's name, model number
serial number,software version
Queries device ID.
*OPC Sets the LSB of SESR after all action has been completed.
*OPC? A<NR1> ASCII 1 is the response after all action has been completed.
*OPT? A<NR1>:0=none,other=exist Queries device option provision.
*RST Device initial setting.
*STB? A<NR1>:0 to 255 Reads the STB and the MSS bit,without performing
serial polling.
*TST? A<NR1>:0=OK,1=NG Queries the result of the ROM/RAM check.
*WAI Executes the following command after action has been completed.
:ESRO?A<NR1>:0 to 255 Queries ESR0.


2.1.2 Specific Commands

(1) Execution control etc.
CommandData
(for a query, response data)
Explanation
:ABORTForce halt.
:CERROR?A,B,C<NR1>(number of times)
A:parity error,
B:overrun error,
C:framing error
Queries the communication errors.
:ERROR?A<NR1>:error numberQueries error number.
:HCOPYSame as holding down the Card key for 2 seconds.
:STARTSame as the START key.
:STOPSame as the STOP key.
:COMPCLRClears comparison result output.


(2) Setting and querying the time axis range, the recording length, etc.

CommandData
(for a query, response data)
Explanation
:TDIV A
:TDIVH
A:TIME/DIV(unit s)
A<NR3>(unit s)
Sets the time axis range.
Queries
:SAMP?A<NR3>(unit s)Queries the sampling period.
:SHOT A
:SHOT?
A:recording length(unit DIV)
A<NR1>(unit DIV)
Sets the recording length.
Queries
:FORM A$
:FORM?
A$:SING,DUAL,XY
A$
Sets the display format.
Queries
:AVE A
:AVE?
A:0(OFF),2,4,8,16
A<NR1>
Sets the averaging count.
Queries
:OLAY A$
:OLAY?
A$:OFF,ON
A$
Sets the overlay function.
Queries
:ATSA A$(,B$)

:ATSA?
A$:OFF,CARD,LAN
B$:BIN,TXT
A$(,B$)
Sets the auto save.

Queries
:SVTH A$
:SVTH?
A$:OFF,2,5,10,20,50,100
A$
Sets the text interval for auto save function.
Queries
:DIRT A$(,'NAME$')

:DIRT?
A$:NAME,DATE,TIME
NAME$:directory name
A$(,'NAME$')
Sets the dirctory for auto save function.

Queries
:CSTP A$
:CSTP?
A$:OR,AND
A$
Sets the common stop mode.
Queries
:COMPEXEExecute compare.
:SMOD AA:1 to 16Registers test mode.
:LMOD AA:1 to 16Switches test mode.
:CMOD AA:1 to 16Deletes test mode.
:WSET A$
:WSET?
A$:OFF,ON
A$
Sets the area-comparison setting.
Queries
:WCON A$,B$

:WCON? A$
A$:CH1,CH2,XY
B$:OFF,OUT,ALLO
A$,B$
Sets the waveform decision mode.

Queries
:WARE A$,B

:WARE? A$
A$:CH1,CH2,XY
B:1 to 16(AREA)
A$,B
Sets the waveform decision area.

Queries
:WSAV A$
:WSAV?
A$:OFF,CARD,LAN
A$
Sets the BMP save.
Queries
:BCMP A$
:BCMP?
A$:NONE,COMP
A$
Sets BMP data format.
Queries
:WSTP A$
:WSTP?
A$:OK,NG,OK_NG
A$
Sets the stop mode.
Queries
:RTOTAL?A<NR1>(total comparison result)Queries total comparison results.
:RAREA? A$A$:ALL,CH1,CH2,XY
B<NR1>(area-comparison result)
Queries area-comparison results.
:RMEAS? A$A$:ALL,NO1,NO2,NO3,NO4
B<NR1>(value-comparison result)
Queries value-comparison results.
:RNEW A$
:RNEW?
A$:OFF,STOP,ON
A$
Sets refresh disp.
Queries
:OKBP A$
:OKBP?
A$:OFF,BEEP1,BEEP2,BEEP3
A$
Sets beep pattern in OK judge.
Queries
:NGBP A$
:NGBP?
A$:OFF,BEEP1,BEEP2,BEEP3
A$
Sets beep pattern in NG judge.
Queries
:CNT?A<NR1>,B<NR1>,C<NR1>Queries number of test.
(V1.31 and later)


(3) Setting and querying trigger.
CommandData
(for a query, response data)
Explanation
:TGMD A$
:TGMD?
A$:SING,REPE,AUTO
A$
Sets the trigger mode.

Queries
:PRTG A
:PRTG?
A:0 to 100(%)
A<NR1>
Sets the pre-trigger.
Queries
:TGSO A$
:TGSO?
A$:OR,AND
A$
Sets the trigger logical operator.
Queries
:TGKD ch$,A$
:TGKD? ch$
A$:OFF,LEVE,IN,OUT,PERI
ch$,A$
Sets the type of trigger.
Queries
:TGLV ch$,A
:TGLV? ch$
A:trigger level
ch$,A<NR3>
Sets the trigger level.
Queries
:TGSL ch$,A$
:TGSL? ch$
A$:UP,DOWN
ch$,A$
Sets the trigger slope.
Queries
:TGFL ch$,A

:TGFL? ch$
A:0(OFF),0.1,0.2,0.5,1.0,1.5,2
 2.5,5.0,10.0(DIV)
ch$,A<NR2>
Sets the trigger filter.

Queries
:TGUP ch$,A

:TGUP? ch$
A:upper limit level

ch$,A<NR3>
Sets upper limit level of
window-in/-out trigger.
Queries
:TGLO ch$,A

:TGLO? ch$
A:lower limit level

ch$,A<NR3>
Sets lower limit level of
window-in/-out trigger.
Queries
:TPUP ch$,A

:TPUP? ch$
A:upper limit level

ch$,A<NR3>
Sets upper period limit of
period trigger.
Queries
:TPLO ch$,A

:TPLO? ch$
A:lower limit level

ch$,A<NR3>
Sets lower period limit of
period trigger.
Queries
:EXTG A$
:EXTG?
A$:OFF,ON
A$
Sets external trigger.
Queries
:TMTG A$
:TMTG?
A$:OFF,ON
A$
Sets timer trigger.
Queries
:TSTT
month,day,
hour,min

:TSTT?
month:1 to 12
day:1 to 31
hour:0 to 23
min:0 to 59
month,day,hour,min<NR1>
Sets start time of timer trigger.



Queries
:TSTP
month,day,
hour,min
:TSTP?
same as TSTT
Sets stop time of timer trigger.


Queries
:TITV
day,hour,min,sec


:TITV?
day: 0 to 99
hour: 0 to 23
min: 0 to 59
sec:0 to 59
day,hour,min,sec<NR1>
Sets time interval for timer trigger.



Queries
:DETECTD
year,month,day

:DETECTD?
year:0 to 99
month: 1 to 12
day:1 to 31
year,month,day <NR1>
Sets the date for trigger detection.


Queries
:DETECTT
hour,min,sec

:DETECTT?
hour: 0 to 23
min: 0 to 59
sec:0 to 59
hour,min,sec <NR1>
Sets the time for trigger detection.


Queries


(4) Setting and querying input channel.
CommandData
(for a query, response data)
Explanation
:URNG ch$,A
:URNG? ch$
A:voltage axis range(V)
ch$,A<NR3>
Sets the voltage axis range.
Queries
:UCPL ch$,A$
:UCPL? ch$
A$:DC,GND
ch$,A$
Sets the coupling method of input signals.
Queries
:UPOS ch$,A
:UPOS? ch$
A:position value(unit %)
ch$,A<NR1>
Sets the zero position for input signals.
Queries
:UFLT ch$,A
:UFLT? ch$
A:0(OFF),5 to 50000(Hz)
ch$,A<NR3>
Sets a low-pass filter for input signals.
Queries
:ADJUSTCarries out zero adjustment.


(5) Setting and querying changeover of the screen mode, waveform display.
CommandData
(for a query, response data)
Explanation
:SCRN A$
:SCRN?
A$:(screen)
A$
Sets the screen mode.
Queries
:UCOL ch$,A$
:UCOL? ch$
A$:OFF,C1 to C4
ch$,A$
Sets waveform display color.
Queries
:UGR ch$,A
:UGR? ch$
A:1,2
ch$,A<NR1>
Sets waveform display graph.
Queries
:TMMG A

:TMMG?
A:0.01 to 10

A<NR3>
Sets the magnification/compression
ratio on the time axis.
Queries
:UMAG ch$,A

:UMAG? ch$
A:0.5,1,2,5,10

ch$,A<NR3>
Sets the magnification/compression
ratio on the voltage axis.
Queries
:WAVE A$A$:ACUR,TRIG,POINTExecutes waveform display.
:UVRI ch$,A$
:UVRI? ch$
A$:OFF,ON
ch$,A$
Sets the variable function.
Queries
:UPLO
ch$,B,C
:UPLO? ch$
B:C: -9.9999E+19 to 9.9999E+19

ch$,B<NR3>,C<NR3>
Sets ther upper andlower limit values
of the variable function.
Queries
:INFOT A$
:INFOT? A$
A$:OFF,COMM,SET,COUNT,C_FC,C_CC
A$
Sets the information(upper).
Queries
:INFOL A$
:INFOL? A$
A$:OFF,GAU1,GAU2,COMP,MEAS
A$
Sets the information(left).
Queries


(6) Cursor setting and reading.
CommandData
(for a query, response data)
Explanation
:CSRON A$
:CSRON?
A$:OFF,A,AB
A$
Chooses among the A, B cursors.
Queries
:TCSR A$
:TCSR?
A$:TIME,VOLT,TRACE
A$
Sets the A and B cursor type.
Queries
:TCSRA A$
:TCSRA?
A$:ALL,CH1,CH2
ch$,A$
Sets the A cursor channel.
Queries
:TCSRB A$
:TCSRB?
A$:ALL,CH1,CH2
ch$,A$
Sets the B cursor channel.
Queries
:XCSR A$
:XCSR?
A$:X,Y,TRACE
A$
Sets the A and B cursor type.
Queries
:APOS A

:APOS?
(vertical cursor,trace cursor)
A:0 to amount of stored data
A<NR1>
Sets the position of the A cursor.

Queries
:BPOS A
:BPOS?
(same as APOS)
A<NR1>
Sets the position of the B cursor.
Queries
:DTRE? A$

B<NR3>:readout value(t)
A$:A,B,B_A
Queries the cursor readout value (t).
:DVRE? A$

B<NR3>(,C<NR3>):readout value(v)
A$:A,B,B_A
Queries the cursor readout value (V).


(7) Setting and querying input and output, etc., from the memory.
CommandData
(for a query, response data)
Explanation
:POINT ch$,A

:POINT?
ch$:CH1,CH2
A:0 to max storaged data
ch$,A<NR1>
Sets point in memory for input and output.

Queries
:PREPARE

Prepares the memory for
receipt of waveform data.
:ADATA BB<NR1>:-1616 to 2000Input data to memory (ASCII).
:ADATA? A

A:1 to max storaged data
B,C<NR1>,...:-1616 to 2000
Output data from memory(ASCII).
:VDATA BB:voltageInput data to memory(voltage).
:VDATA? A

A:1 to max storaged data
B,C<NR3>,...:voltage
Output data to memory(voltage).


(8) Setting and querying the adjust/system screen.
CommandData
(for a query, response data)
Explanation
:STBK A$
:STBK?
A$:ON,OFF
A$
Sets the start backup function.
Queries
:BKLT A
:BKLT?
A:0(OFF),1 to 30(min)
A
Sets the backlight saver.
Queries
:DATE
year,month,day

:DATE?
year :0 to 99
month:1 to 12
day :1 to 31
year,month,day<NR1>
Sets the calendar.


Queries
:TIME hour,min

:TIME?
hour:0 to 23
min :0 to 59
hour,min,sec<NR1>
Sets the time.

Queries
:DATACClear the waveform data.
:BEEP A$
:BEEP?
A$:OFF,ON
A$
Sets the beep sound.
Queries
:EXTI A$
:EXTI?
A$:COMP_CLR,START_STOP
A$
Sets EXT_IN condition.
Queries
:EXTO NO$,A$



:EXTO? NO$
NO$:NO1 to NO5
A$:TOTAL_OK,TOTAL_NG,AREA_OK,AREA_NG,
 MEAS1_OK,MEAS1_NG,MEAS2_OK,MEAS2_NG,
 MEAS3_OK,MEAS3_NG,MEAS4_OK,MEAS4_NG
NO$,A$
Sets EXT_OUT condition.



Queries
:CNTRST A
:CNTRST?
A:-11 to 9
A
Sets the contrast.
Queries
:RNGOV A$
:RNGOV?
A$:OFF,ON
A$
Sets over-range detection.
Queries
:LANG A$
:LANG?
A$:JPN,ENG
A$
Sets the language.
Queries


(9) Setting and querying scaling.
CommandData
(for a query, response data)
Explanation
:SCAL ch$,A$

:SCAL? ch$
ch$:CH1,CH2
A$:OFF,ON
ch$,A$
Sets scaling function.

Queries
:SCEU ch$,A

:SCEU? ch$
ch$:CH1,CH2
A:-9.999E+9 to 9.999E+9
ch$,A<NR3>
Sets the scaling conversion value(RATIO).

Queries
:SCOS ch$,A

:SCOS? ch$
ch$:CH1,CH2
A:-9.999E+9 to 9.999E+9
ch$,A<NR3>
Sets scaling offset(RATIO).

Queries
:SCVOL ch$,B,C

:SCVOL? ch$
ch$:CH1,CH2
B,C:-9.999E+19 to 9.999E+19
ch$,B,C<NR3>
Sets the scaling VOLT UP, LOW(POINT).

Queries
:SCSCA ch$,B,C

:SCSCA? ch$
ch$:CH1,CH2
B:C: -9.999E+19 to 9.999E+19
ch$,B,C<NR3>
Sets the scaling SC UP, LOW(POINT).

Queries
:SUNT ch$,"A$"

:SUNT? ch$
ch$:CH1,CH2
A$:scaling unit(7 character)
ch$,"A$"
Sets the scaling unit.

Queries


(10) Setting and querying comments.
CommandData
(for a query, response data)
Explanation
:UCOM ch$,"A$"

:UCOM? ch$
ch$:CH1,CH2
A$:comment string(16 characters)
ch$,"A$"
Sets the comment for each channel.

Queries
:FCOM "A$"
:FCOM?
A$:comment string(20 characters)
"A$"
Sets file comment.
Queries
:HCOM? NO$NO$:NO1 to NO10
NO$,"A$"
Queries the comment history.



(11) Setting and querying numerical calculation.
CommandData
(for a query, response data)
Explanation
:MEAS A$
:MEAS?
A$:OFF,ON
A$
Sets the numerical calculation.
Queries
:MSAV A$

:MSAV?
A$:OFF,CARD,LAN

A$
Sets the store destination of a
 numerical calculation result.
Queries
:MEASS NO$,A$(,ch$(,B))




:MEASS? NO$
NO$:NO1 to NO4
A$:OFF,AVE,RMS,PP,MAX,MIN,MAXT,MINT,
 PERI,FREQ,RISE,FALL,AREA,INTEG,DIFF,
 PWID,DUTY,LEVE,PCOU,UPLO,XYAREA
ch$:CH1,CH2
B:level
A$,ch$,B<NR3>
Sets the item of numerical calculation.




Queries
:ANSW? NO$NO$,A$,B<NR1>,C<NR3>(,D<NR3>)
NO$:NO1 to NO4
A$:calculation item
B:judge result
C,D:calculation result
Queries a calculation result.
:MARE A$(,B,C)

:MARE?
A$:ALL,PART
B,C:0 to max storaged data
A$
Sets the range of numerical calculation.
Queries
:MSTP A$

:MSTP?
A$:OK,NG,OK_NG

A$
Sets the stop mode of numerical
calculation.
Queries
:MCOMP NO$,A$

:MCOMP? NO$
NO$:NO1 to NO4
A$:OFF,ON
NO$,A$
Sets the decision for numerical
 calculation.
Queries
:COMPA NO$,A,B


:COMPA? NO$
NO$:NO1 to NO4
A,B:upper,lower
(-9.9999E+19 to +9.9999E+19)
NO$,A<NR3>,B<NR3>
Sets upper and lower limits for decision for numerical calculation.

Queries
:MSLP NO$,A$

:MSLP? NO$
NO$:NO1 to NO4
A$:UP,DOWN
NO$,A$
Sets slope for numerical calculation.

Queries


(12) Setting and querying waveform calculation.
CommandData
(for a query, response data)
Explanation
:CWAV A$
:CWAV?
A$:OFF,ON
A$
Sets the waveform calculation.
Queries
:CWVF ch$,A$

:CWVF? ch$
ch$:CH1,CH2
A$:OFF,ABS,RECT,ADD,SUB,MULT,DIVI
A$
Sets the type of waveform calculation.

Queries
:CALCEXEExecutes waveform calculation.


(13) Setting and querying file operation.
CommandData
(for a query, response data)
Explanation
:SVBI "NAME$"NAME$:file name(8 characters)Saves waveform data for binary.
:SVTX "NAME$",ANAME$:file name(8 characters)
A:thin out
Saves waveform data for text.
:SVST "NAME$"NAME$:file name(8 characters)Saves setting conditions.
:BACKUP "NAME$"NAME$:file name(8 characters)Saves area and mode.
:LDNA "NAME$"(,A)NAME$:file name(8 characters)
A<NR1>:area number
Load a file.
:LDNO A(,B)A:file number
B<NR1>:area number
Load a file.
:INFO? NO
NO,"NAME$","DATE$","TIME",A,B$
,C$,"TDATE$,"TTIME$"

NO:file or directory number
NAME$:file or directory name
DATE$:year/month/day of save
TIME$:year/month/day of save
A:file size (bytes)
B$:measurement contents
C:recording length
TDATE$:year/month/day of trigger
TTIME$:hour:min:sec of trigger
Queries information about a file.
:DELE "NAME$"NAME$:file or directory nameDeletes a file or a directory.
:NDEL NONO:file or directory numberDeletes a file or a directory.
:FOMTFormats media.
:MDIR "NAME$"
NAME$:directory name
Creates a directory.
:CHDIRN "NAME$"NAME$:directory nameChanges the current directory.
:CHDIR NONO:directory numberChanges the current directory.
:CDRTChanges the current directory to root.
:FILE?A<NR1>:number of filesQueries the number of files.
:NINF? NONO,"NAME$",A$
NO:file number
NAME$:file name
A$:directory of a file
Queries filename.
:DIR?"NAME$":directory nameQueries the current directory.
:FREE?A<NR1>:allowable number of bytesQueries the allowable number of bytes
:CARD?A<NR1>:0=none, 1=existQueries card existance.
:SVSA "NAME$"NAME$:file name(8 characters)Saves SET&AREA.


(14) Commands relating to graphics editor.
CommandData
(for a query, response data)
Explanation
:EDIT A$
:EDIT?
A$:OFF,ON
A$
Sets the graphic editor mode.
Queries
:STOR (ch$)ch$:CH1,CH2Loads a waveform into the editor(normal).
:STORO (ch$)ch$:CH1,CH2Loads a waveform into the editor(overlay).
:STORM ch$,A,Bch$:CH1,CH2
A,B:volt width
Loads a waveform into the editor
(magnification).
:ALOAD AA:1 to 16(area)Loads an area into the editor.
:SETB X1,Y1,X2,Y2X1,Y1:(points)
X2,Y2:(points)
Sets edit window from(X1,Y1) to (X2,Y2)
:CLRBResets edit window.
:AMAG A,B,C,DA,B,C,D:0 to 5.0(DIV)Carries out a parallel movement
 of the drawing.
:ACUT A,B,C,DA,B,C,D:0 to 5.0(DIV)Carries out a parallel movement
 of the drawing.
:CLEAClears the edit window.
:REVEReverses the video of the drawing.
:LINE X1,Y1,X2,Y2X1,Y1:(points)
X2,Y2:(points)
Draws a line from(X1,Y1) to (X2,Y2)
:RECT X1,Y1,X2,Y2X1,Y1:(points)
X2,Y2:(points)
Draws a box from(X1,Y1) to (X2,Y2)
:BOXP X1,Y1,X2,Y2X1,Y1:(points)
X2,Y2:(points)
Box-paints from(X1,Y1) to (X2,Y2)
:CIRC X,Y,RX,Y:center points
R:radius
Draws a circle (X,Y) width radius (R)
:CIRP X,Y,RX,Y:center points
R:radius
Circle-paints from(X1,Y1) to (X2,Y2)
:PAINT X,YX,Y:(points)Begins solid fill from the point
 specified by(X,Y)
:CLSPPaints closed area.
:ERAS X1,Y1,X2,Y2X1,Y1:(points)
X2,Y2:(points)
Erases a line from(X1,Y1) to (X2,Y2)
:ADEL AA:0(all),1 to 16(area number)Deletes the comparison area.
:UNDOReverses the effect of the immediately
 previous editor command.
:ASAVE AA:1 to 16(area number)Saves the decision area created with
 the editor.
:SVAR "NAME$"NAME$:file name(8 characters)Saves area to "ARE" file.
:SVBM "NAME$"NAME$:file name(8 characters)Saves area to "BMP" file.
:LDAR "NAME1$.NAME2$"NAME1$.NAME2$:file name(8.3 characters)Load a area file.