Unit UPO3000E Series Owner's manual

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
UNI-T
Programming Manual
UPO3000E&UPO2000E Series
Programmable Digital Oscilloscope

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
Warranty and Statement
Copyright
2017 U n i - T r e n d T e c h n o l o g y ( C h i n a ) C o . , L t d .
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

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
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

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
 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

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
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
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"

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
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.

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
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
*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.

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:AUTO
 Command format：
:AUTO
 Functional description：
Set the instrument control value automatically to display waveform to the best effect.
:SYSTem:LOCK
 Command format：
:SYSTem:LOCK {{1 | ON} | {0 | OFF}}
:SYSTem:LOCK?
 Functional description：
For lock/unlock full qwerty.
 Return format：
Query return lock full qwerty status，0 presents unlock, 1 presents lock.
 For example：
:SYSTem:LOCK ON/:SYST:LOCK 1 lock full qwerty
:SYSTem:LOCK OFF/:SYST:LOCK 0 unlock full qwerty
:SYSTem:LOCK? query return 1，it presents lock
:SYSTem:ERRor
 Command format：
:SYSTem:ERRor
:SYSTem:ERRor?
 Functional description：
Empty error message queue.
 Return format：
Query return the last error message, like Undefined header.
 For example：
:SYSTem:ERR empty error message queue
:SYSTem:ERR? query return Undefined header
:SYSTem:SETup
 Command format：
:SYSTem:SETup <setup_data>
:SYSTem:SETup?
 Functional description：
For system configuration data, <setup_data> is conform to binary data IEEE 488.2 # format.

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
 Return format：
Query return setup data, return data conform to binary data IEEE 488.2 # format.
:SYSTem:LANGuage
 Command format：
:SYSTem:LANGuage { ENGLish | SIMPlifiedchinese | TRADitionalchinese }
:SYSTem:LANGuage?
 Functional description：
Set system language.
 Return format：
Query return{ ENGLish | SIMPlifiedchinese | TRADitionalchinese }。
 For example：
:SYSTem:LANGuage ENGL set system language as English
:SYSTem:LANGuage? query return ENGLish
:SYSTem:RTC
 Command format：
:SYSTem:RTC <year>,<month>,<day>,<hour>,<minute>,<second>
:SYSTem:RTC?
 Functional description：
Set system time.
 Return format：
Query return year, month, date, hour, minute and second.
 For example：
:SYSTem:RTC 2017,7,7,20,8,8 set system time at 20:08:08 July 7,2017
:SYSTem:RTC? query return 2017,7,7,20,8,8
:SYSTem:CAL
 Command format：
:SYSTem:CAL
 Functional description：
Set system self-calibration, the instrument can not communicate when in self-calibration.
:SYSTem:CLEAr
 Command format：
:SYSTem:CLEAr
 Functional description：
Empty system storage waveform and setup data.

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:SYSTem:CYMOmeter
 Command format：
:SYSTem:CYMOmeter {1 | ON} | {0 | OFF}
:SYSTem:CYMOmeter?
 Functional description：
The switch of frequency meter.
 Return format：
Query return frequency meter status，1 presents on, 0 presents off.
 For example：
:SYSTem:CYMOmeter ON turn on frequency meter
:SYSTem:CYMOmeter? query return1
:SYSTem:SQUare:SELect
 Command format：
:SYSTem:SQUare:SELect { 10Hz | 100Hz | 1KHz | 10KHz }
:SYSTem:SQUare:SELect?
 Functional description：
Select square wave output.
 Return format：
Query return{ 10Hz | 100Hz | 1KHz | 10KHz }.
 For example：
:SYSTem:SQUare:SELect 10Hz select 10Hz square wave output
:SYSTem:SQUare:SELect? query return 10Hz
:SYSTem:OUTPut:SELect
 Command format：
:SYSTem:OUTPut:SELect { TRIGger | PASS_FAIL }
:SYSTem:OUTPut:SELect?
 Functional description：
Set output selection, TRIGger, PASS_FAIL（pass &fail）.
 Return format：
Query return{ TRIGger | PASS_FAIL }.
 For example：
:SYSTem:OUTPut:SELect TRIG select TRIG
:SYSTem:OUTPut:SELect? query return TRIG

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:SYSTem:MNUDisplay
 Command format：
:SYSTem:MNUDisplay { 1S | 2S | 5S | 10S | 20S | INFinite}
:SYSTem:MNUDisplay?
 Functional description：
Set menu display time，INFinite present menu stay on.
 Return format：
Query return{ 1S | 2S | 5S | 10S | 20S | INFinite }.
 For example：
: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
: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.
 For example：
:SYST:VERS? query returnHW:1.0;SW:1.0;PD:2014-11-20;ICV:1.4.0

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:SYSTem:COMMunicate:LAN:APPLy
 Command format：
:SYSTem:COMMunicate:LAN:APPLy
 Functional description：
Set the current internet parameter to take effect immediately.
:SYSTem:COMMunicate:LAN:GATEway
 Command format：
:SYSTem:COMMunicate:LAN:GATEway <gateway>
:SYSTem:COMMunicate:LAN:GATEway?
 Functional description：
Set the default gateway, <gateway> is belong to ASCII character string parameter，the format is
xxx.xxx.xxx.xxx.
 Return format：
Query return the default gateway.
 For example：
:SYST:COMM:LAN:GATE "192.168.1.1" set the default gateway as 192.168.1.1
:SYST:COMM:LAN:GATE? query return192.168.1.1
:SYSTem:COMMunicate:LAN:SMASK
 Command format：
:SYSTem:COMMunicate:LAN:SMASK <submask>
:SYSTem:COMMunicate:LAN:SMASK?
 Functional description：
Set subnet mask, <submask> is belong to ASCII character string, the format is xxx.xxx.xxx.xxx.
 Return format：
Query return subnet mask.
 For example：
:SYST:COMM:LAN:SMASK "255.255.255.0" set subnet mask 255.255.255.0
:SYST:COMM:LAN:SMASK? query return 255.255.255.0

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:SYSTem:COMMunicate:LAN:IPADdress
 Command format：
:SYSTem:COMMunicate:LAN:IPADdress <ip>
:SYSTem:COMMunicate:LAN:IPADdress?
 Functional description：
Set IP address, <ip> is belong to ASCII character string, the format is xxx.xxx.xxx.xxx.
 Return format：
Query return IP IP address.
 For example：
:SYST:COMM:LAN:IPAD "192.168.1.10" set IP address 192.168.1.10
:SYST:COMM:LAN:IPAD? query return 192.168.1.10
:SYSTem:COMMunicate:LAN:DHCP
 Command format：
:SYSTem:COMMunicate:LAN:DHCP {{1 | ON} | {0 | OFF}}
:SYSTem:COMMunicate:LAN:DHCP?
 Functional description：
To switch configuration mode（auto IP）and（manual IP）.
 Return format：
Query return dynamic configuration mode, 0 presents（manual IP）, 1 presents（auto IP）.
 For example：
:SYST:COMM:LAN:DHCP ON turn on IP dynamic configuration mode
:SYST:COMM:LAN:DHCP? query return 1
:SYSTem:COMMunicate:LAN:MAC?
 Command format：
:SYSTem:COMMunicate:LAN:MAC?
 Return format：
Query return MAC physical address
 For example：
:SYST:COMM:LAN:MAC? query return 00-2A-A0-AA-E0-56

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
KEY Command
This command is to control key and knob on oscilloscope panel.
:KEY:<key>
 Command format：
:KEY:<key>
:KEY:<key>:LOCK { {1 | ON} | {0 | OFF} }
:KEY:<key>:LOCK?
:KEY:<key>:LED?
 Functional description：
Set key function and lock/unlock this key. <key> definition and description see Appendix 1：
<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
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
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}.
:CHANnel<n>:BWLimit
 Command format：
:CHANnel<n>:BWLimit {{1|ON}|{0|OFF}}
:CHANnel<n>:BWLimit?
 Functional description：
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
:CHANnel<n>:COUPling
 Command format：
:CHANnel<n>:COUPling {DC|AC|GND}
:CHANnel<n>:COUPling?
 Functional description：
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

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:CHANnel<n>:DISPlay
 Command format：
:CHANnel<n>:DISPlay { {1|ON} | {0|OFF} }
:CHANnel<n>:DISPlay?
 Functional description：
The switch setting of the specified channel.
 Return format：
Query return 1 or 0，it presents ON or OFF.
 For example：
:CHAN1:DISP ON turn on channel 1
:CHAN1:DISP? query return 1，it presents channel 1 is turn on
:CHANnel<n>:INVert
 Command format：
:CHANnel<n>:INVert { {1|ON} | {0|OFF} }
:CHANnel<n>:INVert?
 Functional description：
Turn on/off inversion display function, ON（turn on inversion display function）or OFF（waveform
normal display）.
 Return format：
Query return 1 or 0，it presents ON or OFF.
 For example：
:CHAN1:INV OFF turn off channel 1 inversion display function
:CHAN1:INV?
Query return 0，it presents channel 1 inversion display function is turn off
:CHANnel<n>:OFFSet
 Command format：
:CHANnel<n>:OFFSet <offset>
:CHANnel<n>:OFFSet?
 Functional description：
Set waveform offset on vertical position, <n> take value as 1/2/3/4/5, it presents {CH1/CH2/CH3/
CH4/ MATH }.
 Return format：
Query return offset value by scientific notation method，unit is V.
 For example：
:CHAN1:OFFS 20V set channel 1 vertical offset as 20V
:CHAN1:OFFS? query return 2.000e001

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:CHANnel<n>:PROBe
 Command format：
:CHANnel<n>:PROBe { 0.001X | 0.01X | 0.1X | 1X | 10X | 100X | 1000X }
:CHANnel<n>:PROBe?
 Functional description：
Set the probe attenuation factor corresponding to the probe.
 Return format：
Query return { 0.001X | 0.01X | 0.1X | 1X | 10X | 100X | 1000X }.
 For example：
: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
:CHANnel<n>:FILTer
 Command format：
:CHANnel<n>:FILTer { {1|ON} | {0|OFF} }
:CHANnel<n>:FILTer?
 Functional description：
The switch setting of digital filter function.
 Return format：
Query return 1 or 0，it presents ON or OFF.
 For example：
:CHAN1:FILT OFF turn off channel 1 digital filter function
:CHAN1:FILT? Query return 0，it presents channel 1 digital filter function is turn off

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:CHANnel<n>:UNITs
 Command format：
:CHANnel<n>:UNITs {VOLTs|AMPeres|WATTs|UNKNown}
:CHANnel<n>:UNITs?
 Functional description：
Set channel unit as VOLTs, AMPeres, WATTs and UNKNown.
 Return format：
Query return VOLTs, AMPeres, WATTs or UNKNown.
 For example：
:CHAN1:UNIT VOLT set channel 1 unit as voltage
:CHAN1:UNIT? query return VOLTs
:CHANnel<n>:VERNier
 Command format：
:CHANnel<n>:VERNier { {1|ON} | {0|OFF} }
:CHANnel<n>:VERNier?
 Functional description：
Set position accommodation mode, ON presents Fine tuning，to further subdivides between coarse
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
:CHANnel<n>:BIAS
 Command format：
:CHANnel<n>:BIAS { {1|ON} | {0|OFF} }
:CHANnel<n>:BIAS?
 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

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
:CHANnel<n>:BIASV
 Command format：
:CHANnel<n>:BIASV <value>
:CHANnel<n>:BIASV?
 Functional description：
Set channel bias voltage value.
 Return format：
Query return bias voltage value by scientific notation method，unit is V.
 For example：
:CHAN1:BIASV 2 set channel 1 bias voltage value as 2V
:CHAN1:BIASV? query return 2.000e000
:CHANnel<n>:BIASV:ZREO
 Command format：
:CHANnel<n>:BIASV:ZERO
 Functional description：
Set channel bias voltage go to zero.
:CHANnel<n>:SELect
 Command format：
:CHANnel<n>:SELect
:CHANnel<n>:SELect?
 Functional description：
For channel selection.
 Return format：
Query return 1 or 0，it presents ON or OFF.
 For example：
:CHAN1:SELect select channel 1
:CHAN1:SELect? query return 1，it presents channel 1 has been selected

UNI-T
UPO 3000E&UPO2000E Series Oscilloscope Programming Manual
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, wave shift relative to screen center.
 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。