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