UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 2
UNI-T
Warranty and Statement
Copyright
2017 U n i - T r e n d T e c h n o l o g y (Ch i n a ) C o . , L td .
Brand Information
UNI-T is the registered trademark of Uni-Trend Technology (China) Co., Ltd.
Software Version
00.00.01
Software upgrade may have some change and add more function, please subscribe
UNI-T website to get the new version or contact UNI-T.
Statement
UNI-T products are protected by patents (including obtained and pending) in China and
other countries and regions.
UNI-T reserves the right to change specifications and prices.
The information provided in this manual supersedes all previous publications.
Information provided in this manual is subject to change without prior notice.
UNI-T shall not be liable for any errors that may be contained in this manual. For any
incidental or consequential damages, arising out of the use or the information and
deductive functions provided in this manual.
Without the written permission of UNI-T, this manual cannot photocopied, reproduced
or adapted.
Product Certification
UNI-T has certified that the product conforms to China national product standard and
industry product standard as well as ISO9001:2008 standard and ISO14001:2004
standard. UNI-T will go further to certificate product to meet the standard of other
member of the international standards organization.
Contact Us
If you have any question or problem, you can contact us,
Website:https://www.uni-trend.com
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 3
UNI-T
SCPI
SCPI was defined as an additional layer on top of the IEEE 488.2-1987 specification
"Standard Codes, Formats, Protocols, and Common Commands".The standard
specifies a common syntax, command structure, and data formats, to be used with all
instruments. It introduced generic commands (such as CONFigure and MEASure) that
could be used with any instrument. These commands are grouped into subsystems.
SCPI also defines several classes of instruments. For example, any controllable power
supply would implement the same DCPSUPPLY base functionality class. Instrument
classes specify which subsystems they implement, as well as any instrument-specific
features.
The physical hardware communications link is not defined by SCPI. While it was
originally created for the IEEE-488.1 (GPIB) bus, SCPI can also be used with RS-232,
RS-422, Ethernet, USB, VXIbus, HiSLIP, etc.
SCPI commands are ASCII textual strings, which are send to the instrument over the
physical layer (e.g., IEEE-488.1). Commands are a series of one or more keywords,
many of which take parameters. In the specification, keywords are written
CONFigure: The entire keyword can be used, or it can be abbreviated to just the
uppercase portion. Responses to Query commands are typically ASCII strings.
However, for bulk data, binary formats can be used.
This section introduces the format, symbols, parameters, and abbreviations of the
SCPI command.
Instruction Format
The SCPI command is a tree-like hierarchy consisting of multiple subsystems, each
consisting of a root keyword and one or more hierarchical key words. The command
line usually begins with a colon ":"; Keywords are separated by the colon ":",
followed by optional parameter settings. The command keyword is separated by
spaces from the first parameter. The command string must end with a newline
<NL>character. Add the question mark "? " after the command line. It is
usually indicated that this feature is being queried.
Symbol Description
The following four symbols are not part of SCPI command, it cannot send with the
command. It usually used as supplementary description of command parameter.
Brace { } usually contains multiple optional parameters, it should select one
parameter when send command.
Such as DISPlay:GRID:MODE { FULL | GRID | CROSS | NONE}command
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 4
UNI-T
Vertical Bar | used to separated multiple parameters, it should select one parameter
when send command.
Such as DISPlay:GRID:MODE { FULL | GRID | CROSS | NONE} command
Square Brackets [ ] the contents in square brackets (command keywords) can
omissible. If the parameter is ignoret, the instrument will set the parameter as the
default value.
Such as MEASure:NDUTy? [<source>] command, it presents current channel
Triangular Brackets < > The parameter in the brackets must be replaced with a
valid value.
Such as use DISPlay:GRID:BRIGhtness 30 form to send DISPlay:GRID:BRIGhtness
<count> command
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 5
Parameter Description
The parameter in this manual can divide into five types: Boolean, Integer, Real,
Discrete, ASCII string
Boolean
Parameter value can set “ON” (1) or “OFF” (0)
Such as SYSTem:LOCK {{1 | ON} | {0 | OFF}}
Integer
Parameter can take any valid integer value unless there have some other
descriptions.
Such as command: DISPlay:GRID:BRIGhtness <count> , parameter of
<count> can take integer from 0~100
UNI-T
Note: Do not set decimal as parameter, otherwise it may occur error.
Real
Parameter can take any valid integer value unless there have some other
descriptions.
Such as for command CH1, CHANnell: OFFSet <offset> , parameter of <offset>
can take integer value.
Discrete
Parameter can only take some specified numbers or characters.
Such as command DISPlay:GRID:MODE { FULL | GRID | CROSS | NONE}
parameter can only take FULL, GRID, CROSS, NONE
ASCII Character String
String parameter contain all ASCII string sets. Strings must begin and end
with paired quotes; it can use single or double quotation marks. The quotation
and delimiter can also be part of a string by typing it twice and not adding any
characters.
Such as set IP SYST:COMM:LAN:IPAD "192.168.1.10"
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 6
UNI-T
Shorthand Rule
All command can identify capital and small letter, if command need enter shorthand,
it should be all capital letter.
Data Return
Data return is divided into single data and batch data. The single data return is the
corresponding parameter type, in which the real return type is presents by the
scientific notation method. The part before e retains three figure behind the decimal
point, and the e part retains three figure; the batch return must be obey IEEE
488.2# string data format, ‘#’+ the length of character bits[fixed to one character]+
ASCII valid value+ valid data+ end string[‘\n’]
Such as #3123xxxxxxxxxxxxxxxxxxx\n presents 123 strings batch data return format,
‘3’ presents “123” occupies three character bits.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 7
SCPI Command
IEEE488.2 Common Command
*IDN?
Command format:
*IDN?
Functional description:
For query manufacture name, model, product serial number and software version.
Return format:
Manufacture name, model, product serial number, software version separated by dot
mark.
For example:
UNI-T Technologies, UPO2000CS, UPO1000, 00.00.01
UNI-T
*RST
Command format:
*RST
Functional description:
Restore factory settings and clear the entire error message, send and receive queue buffers.
SYSTem Command
This command is for oscilloscope basic operation, including operating control, lock
full qwerty, error queue and system data.
:RUN
Command format:
:RUN
Functional description:
Start to sampling, execute :STOP command to stop it.
:STOP
Command format:
:STOP
Functional description:
Stop sampling, execute :RUN command to restart it.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 8
:AUTO
Command format:
:AUTO
Functional description:
Set the instrument control value automatically to display waveform to the best effect.
:SYSTem:MNUDisplay 1S set menu display time as 1s, fold menu fold automatically
:SYSTem:MNUDisplay? query return 1S
:SYSTem:BRIGhtness
Command format:
:SYSTem:BRIGhtness <count>
:SYSTem:BRIGhtness?
Functional description:
Set screen luminance, <count> take value from 1~100,the number greater the screen brighter .
Return format:
Query return the current screen luminance.
For example:
:SYSTem:BRIGhtness 50 set screen luminance as 50
:SYSTem:BRIGhtness? query return 50
UNI-T
:SYSTem:VERSion?
Command format:
:SYSTem:VERSion?
Return format:
Query return version information, character string information of 128 bytes.
HW is hardware version number, SW is software version number,PD is creation date,ICV is
protocol version number.
Set key function and lock/unlock this key. <key> definition and description see
<Key> List.
Return format:
Query return lock status or LED status.
Lock status:0 presents unlock, 1 presents lock;
LED status:0 presents light off,1 presents light on(green),2 presents light on(red).
For example:
:KEY:AUTO set oscilloscope control value
:KEY:AUTO:LOCK ON/OFF lock/unlock key
:KEY:AUTO:LOCK? query return lock status of this key , 1 presents lock.
:KEY:AUTO:LED? query return LED status,0 presents light off
UNI-T
Appendix 1:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 15
UNI-T
CHANnel Command
This command is set channel independently, <n> take value as 1/2/3/4/5/6/7/8/9, it
presents {CH1/CH2/ CH3/ CH4/ MATH/ REF-A/ REF-B/ REF-C/ REF-D}.
Set bandwidth limit function is ON(turn on bandwidth limit to 20MHz,to reduce display noise)
or OFF(turn off bandwidth limit to achieve full display bandwidth).
Return format:
Query return 1 or 0,it presents ON or OFF.
For example:
:CHAN1:BWL ON turn on channel 1 bandwidth limit.
:CHAN1:BWL? query return 1,it presents channel 1 bandwidth limit is turn on
Set channel coupling mode, DC presents the AC and DC component of input signal; AC presents
blocked the DC component of input signal; GND presents cut off input signal.
Return format:
Query AC, DC or GND.
For example:
:CHAN1:COUP DC set channel 1 coupling mode as DC
:CHAN1:COUP? query return DC
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:CHAN1:PROB 10X set channel 1 probe attenuation factor as 10
:CHAN1:PROB? query return 10X
:CHANnel<n>:SCALe
Command format:
:CHANnel<n>:SCALe {<scale> | UP | DOWN}
:CHANnel<n>:SCALe?
Functional description:
Set voltage base in vertical position.
<scale>:voltage base value;
UP:plus one position based on the current position;
DOWN :minus one position based on the current position.
Return format:
Query return the current voltage position value by scientific notation method, unit is V.
For example:
:CHAN1:SCAL 20V set channel 1 voltage base as 20V
:CHAN1:SCAL? query return 2.000e001
:CHAN1:SCAL UP plus one position based on 20V voltage base
Set position accommodation mode, ON presents Fine tuning,to further
tuning settings to improve vertical resolution; OFF presents Coarse tuning, based on 1-2-5
system to set vertical sensitivity.
Return format:
Query return 1 or 0,it presents ON or OFF.
For example:
:CHAN1:VERN ON turn on channel 1 fine tuning function
:CHAN1:VERN? query return 1
subdivides between coarse
UNI-T
:CHANnel<n>:BIAS
Command format:
:CHANnel<n>:
:CHANnel<n>:
Functional description:
The switch setting of channel bias voltage.
Return format:
Query return 1 or 0,it presents ON or OFF.
For example:
:CHAN1:BIAS ON turn on channel 1 bias voltage function
:CHAN1: BIAS? query return 1
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
BIAS { {1|ON} | {0|OFF} }
BIAS?
Page 19
:CHANnel<n>:BIASV
Command format:
:CHANnel<n>:
:CHANnel<n>:
Functional description:
Set channel bias voltage value.
Return format:
Query return bias voltage value by scientific notation method,unit is V.
For example:
:CHAN1:
:CHAN1:
BIASV <value>
BIASV?
BIASV 2 set channel 1 bias voltage value as 2V
BIASV? query return 2.000e000
:CHANnel<n>:BIASV:ZREO
Command format:
:CHANnel<n>:
Functional description:
Set channel bias voltage go to zero.
BIASV:ZERO
UNI-T
:CHANnel<n>:SELect
Command format:
:CHANnel<n>:
:CHANnel<n>:
Functional description:
For channel selection.
Return format:
Query return 1 or 0,it presents ON or OFF.
For example:
:CHAN1:
:CHAN1:
SELect
SELect?
SELect select channel 1
SELect? query return 1,it presents channel 1 has been selected
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 20
UNI-T
TIMebase Command
This command is to change the current channel horizontal scale (time base) and
horizontal position of trigger in memory (trigger offset). Horizontal scale change will
make waveform expand or shrink relative to screen center. Horizontal position change
will make wave shift relative to screen center.
:TIMebase:MODE
Command format:
:TIMebase:MODE {MAIN | WINDow}
:TIMebase:MODE?
Functional description:
Set timebase mode, MAIN or WINDow (zoom timebase <Zoomed>)
Return format:
Query return MAIN or WINDow.
For example:
:TIM:MODE MAIN set timebase mode as MAIN
:TIM:MODE? query return MAIN
:TIMebase:OFFSet
Command format:
:TIMebase:OFFSet <offset>
:TIMebase:OFFSet?
Functional description:
For adjust MAIN offset value,
Return format:
Query return<offset> value by scientific notation,unit is s.
For example:
:TIM:OFFS 1s set MAIN offset value as 1s
:TIM:OFFS? query return 1.000e000。
wave shift relative to screen center.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
For adjust WINDow offset value(zoom timebase <Zoomed>),wave shift relative to screen center.
Return format:
Query return<offset> value by scientific notation method, unit is s.
For example:
:TIM:WIND:OFFS 1 set WINDow offset value as 1s
:TIM:WIND:OFFS? query return 1.000e000
:TIMebase:SCALe
Command format:
:TIMebase:SCALe {<scale> | UP | DOWN}
:TIMebase:SCALe?
Functional description:
Set timebase position of MAIN, s/div.
<scale>:timebase value;
UP:plus one position based on the current position;
DOWN :minus one position based on the current position.
Return format:
Query return< scale> value by scientific notation method, unit is s/div.
For example:
:TIM:SCAL 2 set MAIN offset value as 2s/div
:TIM:SCAL? query return 2.000e000
The switch setting of independent mode of time base.
Return format:
Query return 1 or 0,it presents ON or OFF.
For example:
:TIM:INDP ON turn on independent mode of time base
:TIM:INDP? query return 1
FUNCtion Command
Display the operational result plus, minus, multiply, divide, AND, OR, negation,
exclusive OR and FFT of CH1,CH2,CH3,CH4 waveform, set filter to use expression
operation.
Set the logic threshold of specified channel, if great than the logic threshold take value as 1, less
than the logic threshold take value as 0, n take value as 1, 2, 3, 4.
Return format:
Query return 1.000e000,unit is V.
For example:
:FUNC:DIG1:THR 1V set the logic threshold value of channel 1 as 1V
:FUNC:DIG1:THR? query return 1.000e000
UNI-T
:FUNCtion:SOURce<m>
Command format:
:FUNCtion:SOURce<m> <
:FUNCtion:SOURce<m>?
Functional description:
SOURce <m> presents source 1 or source 2, <m> take vaule as 1, 2.
SOURce1 is to select the first source of operator and math function or it can be single source of
Filter and FFT.
SOURce2 is to select the second source of operator and math function. Single source of Filter,
and FFT is not applicable.
<value> presents CHANnel<n>,<n> take vaule as 1/2/3/4{CH1/ CH2/ CH3/ CH4}.
Set unit of FFT vertical diection as dbrms or VRMS. dbrms presents root mean square of power;
VRMS presents root mean square of voltage.
Return format:
Query return VRMS, DBRMS.
For example:
:FUNCtion:SOUR1 CHAN1 set channel 1 as source 1
:FUNC:FFT:VTYP VRMS
set unit of FFT vertical direction as root mean square of voltage
:FUNC:FFT:VTYP? query return VRMS
:FUNCtion:FFT:FREQuency
Command format:
:FUNCtion:FFT:FREQuency?
Functional description:
The center frequency of spectrum and waveform after obtaining FFT.
Return format:
Query return 1.000e003,unit is Hz.
For example:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 25
:FUNCtion:SOUR1 CHAN1 set channel 1 as source 1
:FUNC:FFT:FREQ? query return 1.000e003
The setting of the upper frequency limit of filter. It is applicable for high-pass filter, band-pass
filer and band-stop filter.
Return format:
Query return 1.000e003,unit is Hz.
For example:
:FUNCtion:SOUR1 CHAN1 set channel 1 as source 1
:FUNC:FILT:FREQ:HIGH 1KHz set the upper frequency limit of filter as 1kHz
:FUNC:FILT:FREQ:HIGH? query return 1.000e003
The setting of the low frequency limit of filter. It is applicable for high-pass filter, band-pass filer
and band-stop filter.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 26
Return format:
Query return 6.000e001,unit is Hz.
For example:
:FUNC:SOUR1 CHAN1 set channel 1 as source 1
:FUNC:FILT:FREQ:LOW 60Hz set the low frequency limit of filter as 60Hz
:FUNC:FILT:FREQ:LOW? query return 6.000e001
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 28
:MEASure:PDUTy?
Command format:
:MEASure:PDUTy? [<source>]
Functional description:
Measuring positive duty ratio of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 or CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e001,unit is %.
:MEASure:NDUTy?
Command format:
:MEASure:NDUTy? [<source>]
Functional description:
Measuring negative duty ratio of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3, and CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e001,unit is %。
UNI-T
:MEASure:PDELay?
Command format:
:MEASure:PDELay? [<source1>,<source2>]
Functional description:
Measuring <source1> and <source2> relative to time delay of rise edge, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return-1.000e-004,unit is s.
For example:
Measuring the relative to time delay of rise edge
{
:MEAS:DEL:SOUR CHAN1,CHAN2
:MEASure:PDEL?
}
equivalent to
{
:MEASure:PDEL? CHAN1,CHAN2
}
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 29
:MEASure:NDELay?
Command format:
:MEASure:NDELay? [<source1>,<source2>]
Functional description:
Measuring <source1> and <source2> relative to time delay of fall edge, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return-1.000e-004,unit is s.
For example:
Measuring the relative to time delay of fall edge
{
:MEAS:DEL:SOUR CHAN1,CHAN2
:MEASure:NDEL?
}
equivalent to
{
:MEASure:NDEL? CHAN1,CHAN2
}
UNI-T
:MEASure:PHASe?
Command format:
:MEASure:PHASe? [<source1>,<source2>]
Functional description:
Timing measuring <source1> relative to <source2> the advance or hysteretic of time quantum, it
presents by degree, 360°as a period, source take value as CHANnel1, CHANnel2, CHANnel3,
and CHANnel4.
Return format:
Query return 1.000e001,unit is degree.
For example:
Measuring <source1> relative to <source2> the advance or hysteretic of time quantum
{
:MEAS:PHAS:SOUR CHAN1,CHAN2
:MEASure:PHAS?
}
equivalent to
{
:MEASure:PHAS? CHAN1,CHAN2
}
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 30
:MEASure:VPP?
Command format:
:MEASure:VPP? [<source>]
Functional description:
Measuring peak-to-peak value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 3.120e000,unit is V.
:MEASure:VMAX?
Command format:
:MEASure:VMAX? [<source>]
Functional description:
Measuring the maximum value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return2.120e000,unit is V.
UNI-T
:MEASure:VMIN?
Command format:
:MEASure:VMIN? [<source>]
Functional description:
Measuring the minimum value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return -2.120e000,unit is V.
:MEASure:VAMPlitude?
Command format:
:MEASure:VAMPlitude? [<source>]
Functional description:
Measuring the amplitude value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return3.120e000,unit is V.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 31
:MEASure:VTOP?
Command format:
:MEASure:VTOP? [<source>]
Functional description:
Measuring the top value of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 3.120e000,unit is V.
:MEASure:VBASe?
Command format:
:MEASure:VBASe? [<source>]
Functional description:
Measuring the bottom value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return-3.120e000,unit is V.
UNI-T
:MEASure:VMIDdle?
Command format:
:MEASure:VMIDdle? [<source>]
Functional description:
Measuring the middle value of the specified channel waveform,<source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return0.120e000,unit is V.
:MEASure:VAVerage?
Command format:
:MEASure:VAVerage? [<interval>][,<source>]
Functional description:
Measuring the average value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3, CHANnel4 and MATH. If there has no designated <source>,
the current channel as <source> by default; <interval> appoint the measurement separation, take
value as CYCLe and DISPlay, CYCLe presents integer cycle period, DISPlay presents full screen.
If there has no designated <interval>, take DISPlay by default.
Return format:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 32
Query return1.120e000,unit is V.
:MEASure:VRMS?
Command format:
:MEASure:VRMS? [<interval>][,<source>]
Functional description:
Measuring the root mean square value of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3, CHANnel4 and MATH. If there has no designated <source>,
the current channel as <source> by default; <interval> appoint the measurement separation, take
value as CYCLe and DISPlay, CYCLe presents integer cycle period, DISPlay presents full screen.
If there has no designated <interval>, take DISPlay by default.
Return format:
Query return1.230e000,unit is V.
:MEASure:AREa?
UNI-T
Command format:
:MEASure:AREa? [<interval>][,<source>]
Functional description:
Measuring the area of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3, CHANnel4 and MATH. If there has no designated <source>, the current
channel as <source> by default; <interval> appoint the measurement separation, take value as
CYCLe and DISPlay, CYCLe presents integer cycle period, DISPlay presents full screen. If there
has no designated <interval>, take DISPlay by default.
Return format:
Query return 3.456e002,unit is Vs.
:MEASure:OVERshoot?
Command format:
:MEASure:OVERshoot? [<source>]
Functional description:
Measuring overshoot of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return1.230e002,unit is V.
:MEASure:PREShoot?
Command format:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 33
:MEASure:PREShoot? [<source>]
Functional description:
Measuring preshoot of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return1.230e-002,unit is V.
:MEASure:FREQuency?
Command format:
:MEASure:FREQuency? [<source>]
Functional description:
Measuring frequency of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 2.000e003,unit is Hz.
UNI-T
:MEASure:RISetime?
Command format:
:MEASure:RISetime? [<source>]
Functional description:
Measuring rise time of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e-005,unit is s.
:MEASure:FALLtime?
Command format:
:MEASure:FALLtime? [<source>]
Functional description:
Measuring fall time of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e-005,unit is s.
:MEASure:PERiod?
Command format:
:MEASure:PERiod? [<source>]
Functional description:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 34
Measuring period of the specified channel waveform, <source> take value as CHANnel1,
CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:PWIDth?
Command format:
:MEASure:PWIDth? [<source>]
Functional description:
Measuring positive pulse width of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:NWIDth?
UNI-T
Command format:
:MEASure:NWIDth? [<source>]
Functional description:
Measuring negative pulse width of the specified channel waveform, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:FRR?
Command format:
:MEASure:FRR? <source1>,<source2>
Functional description:
Measuring time of the first rise edge between <source1> and <source2>, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:FRF?
Command format:
:MEASure:FRF? <source1>,<source2>
Functional description:
Measuring time of the first fall edge between <source1> and <source2>, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4. Ignore means the current channel.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 35
Return format:
Query return 5.000e-003,unit is s.
:MEASure:FFR?
Command format:
:MEASure:FFR? <source1>,<source2>
Functional description:
Measuring time between the first fall edge of <source1> and the first rise edge of <source2>,
<source> take value as CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:FFF?
Command format:
:MEASure:FFF? <source1>,<source2>
Functional description:
Measuring time of the first fall edge between <source1> and <source2>, <source> take value as
CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
UNI-T
:MEASure:LRR?
Command format:
:MEASure:LRR? <source1>,<source2>
Functional description:
Measuring time between the first rise edge of <source1> and the rise edge of <source2>, <source>
take value as CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:LRF?
Command format:
:MEASure:LRF? <source1>,<source2>
Functional description:
Measuring time between the first rise edge of <source1> and the first fall edge of <source2>,
<source> take value as CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 36
:MEASure:LFR?
Command format:
:MEASure:LFR? <source1>,<source2>
Functional description:
Measuring time between the first fall edge of <source1> and the last rise edge of <source2>,
<source> take value as CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
:MEASure:LFF?
Command format:
:MEASure:LFF? <source1>,<source2>
Functional description:
Measuring time between the first fall edge of <source1> and the last fall edge of <source2>,
<source> take value as CHANnel1, CHANnel2, CHANnel3 and CHANnel4.
Return format:
Query return 5.000e-003,unit is s.
UNI-T
TRIGger Command
This command is to control trigger sweep mode and trigger standard, trigger decide
when oscilloscope start to collect data and display waveform.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 37
For example:
:TRIGger:MODE NE N edge trigger
:TRIGger:MODE? query return NE
:TRIGger:FORCe
Command format:
:TRIGger:FORCe
Functional description:
Execute the command if the oscilloscope has no apporiate trigger term. Force the oscilloscope to
produce a trigger signal to trigger and display the input waveform.
Select trigger sweep mode.
AUTO:If there has no trigger term, internal will produce trigger signal to force trigger
NORMal:Trigger only when in trigger term
SINGle:In trigger term, trigger one time and stop
:TRIGger:SWEep AUTO set channel 1 as auto trigger mode
:TRIGger:SWEep? query return AUTO
:TRIGger:LEVel:ASETup
Command format:
:TRIGger:LEVel:ASETup
Functional description:
Set trigger level on the vertical center point of signal amplitude.
For example:
:TRIG:LEVel:ASETup set trigger level on the center point
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 38
:TRIGger:LEVel
Command format:
:TRIGger:LEVel <level>
:TRIGger:LEVel?
Functional description:
Set the trigger level value of NORMal mode. <level> value must set based on the conversion of
voltage base and screen information.
Return format:
Query return <level> value, unit is V.
For example:
:TRIG:LEV 2 set trigger level as 2V
:TRIG:LEV? query return 2.000e000
:TRIGger:LEVel:LOW
UNI-T
Command format:
:TRIGger:LEVel:LOW <level>
:TRIGger:LEVel:LOW?
Functional description:
Set low level value of slope trigger. <level>value must set based on the conversion of voltage
base and screen information.
Return format:
Query return <level> value, unit is V.
For example:
:TRIG:LEV:LOW 2 set trigger level as 2V
:TRIG:LEV:LOW? query return 2.000e000
:TRIGger:LEVel:HIGH
Command format:
:TRIGger:LEVel:HIGH <level>
:TRIGger:LEVel:HIGH?
Functional description:
Set high level value of slope trigger. <level> value must set based on the conversion of voltage
base and screen information.
Return format:
Query return <level> value, unit is V.
For example:
:TRIG:LEV:HIGH 2 set trigger level as 2V
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 39
:TRIG:LEV:HIGH? query return 2.000e000
:TRIGger:SOURce
Command format:
:TRIGger:SOURce <source>
:TRIGger:SOURce?
Functional description:
Set single information source trigger, input channel(CHANnel1, CHANnel 2, CHANnel 3,
CHANnel 4), external trigger( EXT, EXT5), AC Line. Only EDGE/ PULSe / VIDeo support AC
Line, EXT and EXT5.
<source> presents information source trigger,
CHANnel<n>|EXT|EXT5|ACLine,<n> take value as 1, 2, 3, 4.
Return format:
Query return information source trigger { CHANnel1| CHANnel2| CHANnel3|
CHANnel4|EXT|EXT5|ACLINE}.
For example:
:TRIGger:SOUR CHAN1 set channel 1 as edge trigger
:TRIGger:SOUR? query return CHANnel1
:CURSor:SOURce CHAN1 set channel 1 as cursor source
:CURSor:SOURce? query return CHANnel1
:CURSor:CURA
Command format:
:CURSor:CURA <value>
:CURSor:CURA?
Functional description:
Set the horizontal or vertical position of A cursor line. It is related with directive CURSor:TYPE,
amplitude presents the vertical position, time presents the horizontal position. Vertical line range
[0,699],horizontal line range [28,227].
Return format:
Query return the position of A cursor line.
For example:
:CURSor:CURA 50 set manual A cursor line position as 50
:CURSor:CURA? query return 50
UNI-T
:CURSor:CURB
Command format:
:CURSor:CURB <value>
:CURSor:CURB?
Functional description:
Set the horizontal or vertical position of B cursor line. It is related with directive CURSor:TYPE.
Return format:
Query return the position of B cursor line.
For example:
:CURSor:CURB 50 set manual B cursor line position as 50
:CURSor:CURB? query return 50
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 58
STORage Command
This command is to set and read waveform data and system setup.
:STORage:TYPE
Command format:
:STORage:TYPE {
:STORage:TYPE?
Functional description:
Set storage mode, SETUP and WAVE.
Return format:
Query return{ SETUP | WAVE}.
For example:
:STORage:TYPE WAVE set storage mode as WAVE
:STORage:TYPE? query return WAVE
Set waveform luminance, <count> take value as 1~100,the number is greater the waveform
brighter.
Return format:
Query return the current waveform luminance.
For example:
:DISPlay:WAVE:BRIGhtness 50 set waveform luminance as 50
:DISPlay:WAVE:BRIGhtness? query return 50
:DISPlay:GRID:MODE
Command format:
:DISPlay:GRID:MODE { FULL | GRID | CROSS | NONE}
:DISPlay:GRID:MODE?
Functional description:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 64
Display format of grid, FULL(display grid and coordinate)、GRID(display grid)、CROSS
(display coordinate)、NONE(not display grid and coordinate).
Return format:
Query return{ FULL | GRID | CROSS | NONE}.
For example:
:DISPlay:GRID:MODE FULL set display grid and coordinate
:DISPlay:GRID:MODE? query return FULL
:DISPlay:CLEar
Command format:
:DISPlay:CLEar
Functional description:
Empty waveform display on the screen.
:DISPlay:TYPE
UNI-T
Command format:
:DISPlay:TYPE {XY12| XY34|YT}
:DISPlay:TYPE?
Functional description:
Set the display type of time base as XY12 (X-Y method: display amplitude of channel 1 on the
horizontal axis, display amplitude of channel 2 on the vertical axis). XY34 (X-Y method: display
amplitude of channel 3 on the horizontal axis, display amplitude of channel 4 on the vertical axis).
YT (Y-T method: display the relative relationship of vertical voltage and horiziontal time).
Return format:
Query return XY12, XY34 and YT.
For example:
:DISP:TYPE YT set the time base as YT method
:DISP:TYPE? query return YT
WAVeform Command
This command is to read waveform data and relevant parameters.
:WAVeform:FORMat
Command format:
:WAVeform:FORMat { WORD |
:WAVeform:FORMat?
Functional description:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
BYTE |ASCII | CSV | DAT }
Page 65
Set return format of waveform AD data. This command is only valid for AD data.
BYTE:return 8 bits value, single byte binary data
WORD:return 16 bits valule, short type binary data
ASCII:return waveform AD data character string, single AD value turn to ASCII character string,
each data point separated by comma mark. In addition, it is conform to binary data IEEE488.2
format, for example #41234120,125,128..........\n.
CSV:return waveform AD data set of CSV file format <filed separated by comma mark, line
separated by\n >, single AD value turn to ASCII character string.
DAT: set return waveform data by built-in data format
For example:single point of AD value is 120
BYTE:return 0x78
WORD:return two bytes 0x78 and 0x00,(little end format)
ASCII:return '120' of ASCII character string
CSV:return '120' of ASCII character string by CSV standard format
Return format:
Query return { WORD |
For example:
:WAVeform:FORMat BYTE return format of waveform data is single byte mode
:WAVeform:FORMat? query return BYTE
Set return format of waveform point voltage data, this command is only valid for voltage data,
unit is the current channel unit.
BYTE:return float type binary data
ASCII:return waveform voltage data character string, single voltage value turn to ASCII character
string, each data separated by comma mark and it’s conform to binary data IEEE488.2 format. For
example#412342.0, 2.1, 2.3.............\n.
CSV:return waveform AD data set of CSV file format <file separated by comma mark, line
separated by\n >, single voltage value turn to ASCII character string
For example:voltage value of single point is 2.0V
BYTE:return 0x40、0x00、0x00、0x00
ASCII:return '2.0' of ASCII character string
CSV:return '2.0' of ASCII character string by
Return format:
Query return{ BYTE |
For example:
ASCII | CSV }
ASCII | CSV }
CSV standard format
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 66
:WAVeform:VOLtage:FORMat BYTE
return format of waveform data is single byte mode
:WAVeform:VOLtage:FORMat? query return BYTE
:WAVeform:SOURce
Command format:
:WAVeform:SOURce {CHANnel<n> }
:WAVeform:SOURce?
Functional description:
Set signal source of the cuurent query waveform data
Return format:
Query return{ CHANnel1 |
For example:
:WAVeform:SOURce CHAN1
set signal source of the current query waveform data as channel 1
:WAVeform:SOURce? query return CHANnel1
CHANnel2 |CHANnel3 | CHANnel4 }.
UNI-T
:WAVeform:POINts
Command format:
:WAVeform:POINts <points>
:WAVeform:POINts?
Functional description:
Set return waveform point, the default value is 0.
Return format:
Query return waveform point.
For example:
:WAVeform:POINts 120 set return waveform point as 120
:WAVeform:POINts? query return 120
:WAVeform:DATA?
Command format:
:WAVeform:DATA?
Functional description:
To read waveform data of the specified data source.
Return format:
Query return:WAVeform:POINts the specified quantity of waveform data, waveform data source
is related with :WAVeform:SOURc, data format is related with WAVeform:FORMat, returns data
is conform to format of binary data IEEE 488.2 # format.
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 67
For example:
The execute order to obtain the specified data source the waveform data as
following,
:WAVeform:FORMat BYTE
:WAVeform:SOURce CHAN1
The return format of waveform data is AD single byte mode
Set channel 1 as singal source of query waveform data
:WAVeform:POINts 120 set return 120 waveform point
:WAVeform:DATA? acquire waveform data
:WAVeform:PREamble?
Command format:
:WAVeform:PREamble?
Functional description:
Query return the current setup parameter of system waveform.
Return format:
Query return separated by comma mark “,”
Return data format: Format,Type,Points,Count,Xinc,Xor,Xref,Yinc,Yor,Yref.
Format:BYTE (0), WORD (1), ASCII (2)
Type:NORMAL (0), PEAK (1), AVER (2), ENVelope (3), HRESolution (4)
Points:return point of waveform data
Count:average count in average sampling, other mode is 1
Xinc:the time difference between in two point of X direction of waveform data source
Xor:the relative time of trigger point
Xref:X reference
Yinc:unit voltage of Y direction
Yor:the relative position of Y direction and YREF zero position
Yref:the reference value of Y direction, the center point of screen
Set vertical position value of bus, parameter type is integer, stepped as 6, range [-160,160],
screen center as zero point, up to positive, down to negative.
Return format:
Query return vertical position value.
For example:
:SBUS:VERTical:POSition 10 vertical position value of bus is 10
:SBUS:VERTical:POSition? query return 10
Select the sweep mode of bus trigger.
AUTO:if there no trigger term, internal will produce trigger signal to force trigger.
NORMal:only trigger when in trigger term.
Return format:
Query return trigger sweep mode {AUTO|NORMal}.
For example:
:SBUS:TRIGger:SWEep AUTO set sweep mode of bus trigger as AUTO
:SBUS:TRIGger:SWEep? query return AUTO
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:SBUS:RS232:STOP:BIT 6 set stop bit as 6
:SBUS:RS232:STOP:BIT? query return 6
:SBUS:RS232:DATA
Command format:
:SBUS:RS232:DATA <value>
:SBUS:RS232:DATA?
Functional description:
Set RS232 bus data,, parameter is character string of 0x format, range is related with setup
parameter of command SBUS:RS232:DATA:BIT, which is [0~2^databit – 1].
Return format:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 75
Query return character string of 0x format of bus data.
For example:
:SBUS:RS232:DATA "0x7F" set RS232 bus data as 0x7F
:SBUS:RS232:DATA? query return 0x7F
:SBUS:I2C:ADIRection READ et I2C bus address direction as read only
:SBUS:I2C:ADIRection? query return READ
:SBUS:I2C:ADDRess
Command format:
:SBUS:I2C:ADDRess <value>
:SBUS:I2C:ADDRess?
Functional description:
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 77
Set I2C bus address, parameter is character string of 0x format, range is related with setup
parameter of command SBUS:I2C:ASIZe, which is [0~2^addressbit – 1].
Return format:
Query return character string address value of 0x format.
For example:
:SBUS:I2C:ADDRess "0x7F" I2C bus address as 0x7F
:SBUS:I2C:ADDRess? query return 0x7F
Set host computer input and slave computer output source of SPI bus.
Return format:
Query return{ CHANnel1 |
For example:
:SBUS:SPI:MISO:SOURce CHANnel1
set channel 1 as host computer input and slave computer output source of SPI bus
:SBUS:SPI:MISO:SOURce? query return CHANnel1
Set host computer output and slave computer input source of SPI bus
Return format:
Query return{ CHANnel1 |
For example:
:SBUS:SPI:MOSI:SOURce CHANnel1
set channel 1 as host computer output and slave computer input source of SPI bus
:SBUS:SPI:MOSI:SOURce? query return CHANnel1
Set offset byte of USB data pack, <offset> is integer data, range 0~15.
Return format:
Query return offset of USB data pack.
For example:
:SBUS:USB:DATA:OFFSet 2 set offset byte as 2
:SBUS:USB:DATA:OFFSet? query return 2
UNI-T
:SBUS:USB:DATA:LOW
Command format:
:SBUS:USB:DATA:LOW <string>
:SBUS:USB:DATA:LOW?
Functional description:
Set low trigger data of USB data pack, parameter is character string of 0x format, data range
0x0~0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF.
Return format:
Query return character string of 0x format.
For example:
:SBUS:USB:DATA:LOW "0x5F" set negative data of USB signal line as 0x5F
:SBUS:USB:DATA:LOW? query return 0x5F
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 93
:SBUS:USB:DATA:HIGH
Command format:
:SBUS:USB:DATA:HIGH <string>
:SBUS:USB:DATA:HIGH?
Functional description:
Set high trigger data of USB data pack, parameter is character string of 0x format, data range
0x0~0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF.
Return format:
Query return character string of 0x format.
For example:
:SBUS:USB:DATA:HIGH "0x5F" set positive data of USB signal line as 0x5F
:SBUS:USB:DATA:HIGH? query return 0x5F
:SBUS:USB:ERRor:TYPE
UNI-T
Command format:
:SBUS:USB:ERRor:TYPE {PID | TOKEN | DATA | BITFILL}
:SBUS:USB:ERRor:TYPE?
Functional description:
Set error mode of USB.
Return format:
Query return{PID | TOKEN | DATA | BITFILL}.
For example:
:SBUS:USB:ERRor:TYPE PID set error mode as PID
:SBUS:USB:ERRor:TYPE? query return PID
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Page 94
Appendix 1:<Key> Table
Key Functional Description LED
AUTOAuto setting to display waveform
RSControl the operating status of oscilloscope, continuous to send the
command, oscilloscope will switch between stop and run status
TMENuTrigger menu
SINGleSingle trigger√
TFOReForce trigger
HELPHelp system
HMENuHorizontal system menu
DISPlay Display menu
MATH mathematical operation function and meue √
REF Reference waveform function and menu √
CH1 The switch of channel 1 √
CH2 The switch of channel 2 √
CH3 The switch of channel 3 √
CH4 The switch of channel 4 √
F1 Select the first menu item
F2 Select the second menu item
F3 Select the third menu item
F4 Select the fourth menu item
F5 Select the fifth menu item
MENu Menu display function
PSCReen One-button print or One-button save screen image