Keysight Technologies U2040 X-Series Operating instructions

Keysight U2040 X-Series
Wide Dynamic Range Power
Sensors
Wide dynamic range power sensors for
any modulated signals
Programming
Guide

2Keysight U2040 X-Series Programming Guide
Notices
Copyright Notice
© Keysight Technologies 2015-2019
No part of this manual may be repro-
duced in any form or by any means
(including electronic storage and
retrieval or translation into a foreign
language) without prior agreement and
written consent from Keysight Technol-
ogies as governed by United States and
international copyright laws.
Manual Part Number
U2041-90003
Edition
Edition 4, April 12, 2019
Printed in:
Printed in Malaysia
Published by:
Keysight Technologies
Bayan Lepas Free Industrial Zone,
11900, Penang, Malaysia
Technology Licenses
The hardware and/or software
described in this document are fur-
nished under a license and may be
used or copied only in accordance with
the terms of such license.
Declaration of Conformity
Declarations of Conformity for this
product and for other Keysight prod-
ucts may be downloaded from the
Web. Go to http://www.keysight.com/
go/conformity. You can then search by
product number to find the latest Dec-
laration of Conformity.
U.S. Government Rights
The Software is “commercial computer
software,” as defined by Federal Acqui-
sition Regulation (“FAR”) 2.101. Pursu-
ant to FAR 12.212 and 27.405-3 and
Department of Defense FAR Supple-
ment (“DFARS”) 227.7202, the U.S.
government acquires commercial com-
puter software under the same terms
by which the software is customarily
provided to the public. Accordingly,
Keysight provides the Software to U.S.
government customers under its stan-
dard commercial license, which is
embodied in its End User License
Agreement (EULA), a copy of which can
be found at http://www.keysight.com/
find/sweula. The license set forth in the
EULA represents the exclusive authority
by which the U.S. government may use,
modify, distribute, or disclose the Soft-
ware. The EULA and the license set
forth therein, does not require or per-
mit, among other things, that Keysight:
(1) Furnish technical information
related to commercial computer soft-
ware or commercial computer software
documentation that is not customarily
provided to the public; or (2) Relinquish
to, or otherwise provide, the govern-
ment rights in excess of these rights
customarily provided to the public to
use, modify, reproduce, release, per-
form, display, or disclose commercial
computer software or commercial com-
puter software documentation. No
additional government requirements
beyond those set forth in the EULA
shall apply, except to the extent that
those terms, rights, or licenses are
explicitly required from all providers of
commercial computer software pursu-
ant to the FAR and the DFARS and are
set forth specifically in writing else-
where in the EULA. Keysight shall be
under no obligation to update, revise or
otherwise modify the Software. With
respect to any technical data as
defined by FAR 2.101, pursuant to FAR
12.211 and 27.404.2 and DFARS
227.7102, the U.S. government
acquires no greater than Limited Rights
as defined in FAR 27.401 or DFAR
227.7103-5 (c), as applicable in any
technical data.
Warranty
THE MATERIAL CONTAINED IN THIS
DOCUMENT IS PROVIDED “AS IS,”
AND IS SUBJECT TO BEING
CHANGED, WITHOUT NOTICE, IN
FUTURE EDITIONS. FURTHER, TO THE
MAXIMUM EXTENT PERMITTED BY
APPLICABLE LAW, KEYSIGHT DIS-
CLAIMS ALL WARRANTIES, EITHER
EXPRESS OR IMPLIED, WITH REGARD
TO THIS MANUAL AND ANY INFORMA-
TION CONTAINED HEREIN, INCLUD-
ING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MER-
CHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE. KEYSIGHT
SHALL NOT BE LIABLE FOR ERRORS
OR FOR INCIDENTAL OR CONSE-
QUENTIAL DAMAGES IN CONNECTION
WITH THE FURNISHING, USE, OR
PERFORMANCE OF THIS DOCUMENT
OR OF ANY INFORMATION CON-
TAINED HEREIN. SHOULD KEYSIGHT
AND THE USER HAVE A SEPARATE
WRITTEN AGREEMENT WITH WAR-
RANTY TERMS COVERING THE MATE-
RIAL IN THIS DOCUMENT THAT
CONFLICT WITH THESE TERMS, THE
WARRANTY TERMS IN THE SEPARATE
AGREEMENT SHALL CONTROL.
Safety Information
CAUTION
A CAUTION notice denotes a hazard. It
calls attention to an operating proce-
dure, practice, or the like that, if not
correctly performed or adhered to,
could result in damage to the product
or loss of important data. Do not pro-
ceed beyond a CAUTION notice until
the indicated conditions are fully
understood and met.
WARNING
A WARNING notice denotes a hazard. It
calls attention to an operating proce-
dure, practice, or the like that, if not
correctly performed or adhered to,
could result in personal injury or death.
Do not proceed beyond a WARNING
notice until the indicated conditions are
fully understood and met.

Keysight U2040 X-Series Programming Guide 3
Table of Contents
1 U2040 X-Series Remote Operation
Configuring the USB/LAN Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Introduction to the SCPI Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Zeroing and Calibrating the U2040 X-Series . . . . . . . . . . . . . . . . . . . . 25
Making Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Using Frequency-Dependent Offset Tables . . . . . . . . . . . . . . . . . . . . . 37
Setting the Averaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Setting Offsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Setting Measurement Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Getting the Best Speed Performance . . . . . . . . . . . . . . . . . . . . . . . . . . 51
How Measurements are Calculated . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Saving and Recalling U2040 X-Series Configurations . . . . . . . . . . . . . 65
Using Device Clear to Halt Measurements . . . . . . . . . . . . . . . . . . . . . . 66
Making Measurements on Wireless Communication Standards . . . . . 67
2 IEEE-488 Common Commands
*CLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
*DDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
*ESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
*ESR? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
*IDN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
*LRN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
*OPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
*OPT? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
*RCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
*RST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
*SAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
*SRE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
*STB? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
*TRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
*TST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
*WAI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

4Keysight U2040 X-Series Programming Guide
3ABORtSubsystem
ABORt[1] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
4 CALCulate Subsystem
CALCulate[1]|2|3|4:FEED[1]|2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
CALCulate[1]|2|3|4:GAIN:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
CALCulate[1]|2|3|4:GAIN[:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . .93
CALCulate[1]|2|3|4:LIMit:CLEar:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . .94
CALCulate[1]|2|3|4:LIMit:CLEar[:IMMediate] . . . . . . . . . . . . . . . . . . . . .95
CALCulate[1]|2|3|4:LIMit:FAIL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
CALCulate[1]|2|3|4:LIMit:FCOunt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
CALCulate[1]|2|3|4:LIMit:LOWer[:DATA] . . . . . . . . . . . . . . . . . . . . . . . . .99
CALCulate[1]|2|3|4:LIMit:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
CALCulate[1]|2|3|4:LIMit:UPPer[:DATA] . . . . . . . . . . . . . . . . . . . . . . . .102
CALCulate[1]|2|3|4:MATH [:EXPRession] . . . . . . . . . . . . . . . . . . . . . . .104
CALCulate[1]|2|3|4:MATH [:EXPRession]:CATalogue? . . . . . . . . . . . . .105
CALCulate[1]|2|3|4:PHOLd:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
CALCulate[1]|2|3|4:RELative:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . .107
CALCulate[1]|2|3|4:RELative[:MAGNitude]:AUTO . . . . . . . . . . . . . . . .108
5 CALibration Subsystem
CALibration Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
CALibration[1]:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
CALibration[1]:ZERO:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
CALibration[1]:ZERO:TYPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
CALibration[1]:ZERO:NORMal:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . .114
CALibration[1][:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
6 CONFigure Subsystem
CONFigure[1]|2|3|4[:SCALar][:POWer][:AC] . . . . . . . . . . . . . . . . . . . . .118
CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence . . . . . . . . . . .119
CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence:RELative . . . .120
CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:RATio . . . . . . . . . . . . . . . .122
CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:RATio:RELative . . . . . . . .123
CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:RELative . . . . . . . . . . . . .124
CONFigure[1]|2|3|4? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125

Keysight U2040 X-Series Programming Guide 5
7FETChSubsystem
FETCh[1]|2|3|4[:SCALar][:POWer][:AC]? . . . . . . . . . . . . . . . . . . . . . . . . 128
FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence? . . . . . . . . . . . . . . 130
FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence:RELative? . . . . . . 132
FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:RATio? . . . . . . . . . . . . . . . . . . 134
FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:RATio:RELative? . . . . . . . . . . . 136
FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:RELative? . . . . . . . . . . . . . . . . 138
8 FORMat Subsystem
FORMat[:READings]:BORDer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
FORMat[:READings][:DATA] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
9INITiateSubsystem
INITiate[1]:CONTinuous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
INITiate[1]:CONTinuous:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
INITiate[1]:CONTinuous:SEQuence[1] . . . . . . . . . . . . . . . . . . . . . . . . . 148
INITiate[1][:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
INITiate[1][:IMMediate]:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
INITiate[1][:IMMediate]:SEQuence[1] . . . . . . . . . . . . . . . . . . . . . . . . . . 151
10 INPut Subsystem
INPut:TRIGger:IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
11 LXI Subsystem
LXI:IDENtify[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
12 MEASure Subsystem
MEASure[1]|2|3|4[:SCALar][:POWer][:AC]? . . . . . . . . . . . . . . . . . . . . . 158
MEASure[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence? . . . . . . . . . . . . 159
MEASure[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence:RELative? . . . . 160
MEASure[1]|2|3|4[:SCALar][:POWer][:AC]:RATio? . . . . . . . . . . . . . . . . 161
MEASure[1]|2|3|4[:SCALar][:POWer][:AC]:RATio:RELative? . . . . . . . . . 162
MEASure[1]|2|3|4[:SCALar][:POWer][:AC]:RELative? . . . . . . . . . . . . . . 163
13 MEMory Subsystem
MEMory:CATalog:STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
MEMory:CATalog:TABLe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
MEMory:CATalog[:ALL]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

6Keysight U2040 X-Series Programming Guide
MEMory:CLEar:TABLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
MEMory:CLEar[:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
MEMory:FREE:STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
MEMory:FREE:TABLe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
MEMory:FREE[:ALL]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
MEMory:NSTates? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
MEMory:NTABles? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
MEMory:STATe:CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176
MEMory:STATe:DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
MEMory:TABLe:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178
MEMory:TABLe:FREQuency:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . .180
MEMory:TABLe:MOVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
MEMory:TABLe:GAIN[:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . .182
MEMory:TABLe:GAIN[:MAGNitude]:POINts? . . . . . . . . . . . . . . . . . . . .184
MEMory:TABLe:SELect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
MEMory:TABLe:SGAMma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
MEMory:TABLe:SGAMma:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
MEMory:TABLe:SPARam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
MEMory:TABLe:SPARam:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
14 OUTPut Subsystem
OUTPut:TRIGger[1][:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
15 READ Subsystem
READ[1]|2|3|4[:SCALar][:POWer][:AC]? . . . . . . . . . . . . . . . . . . . . . . . . .194
READ[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence? . . . . . . . . . . . . . . .196
READ[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence:RELative? . . . . . . .198
READ[1]|2|3|4[:SCALar][:POWer][:AC]:RATio? . . . . . . . . . . . . . . . . . . .200
READ[1]|2|3|4[:SCALar][:POWer][:AC]:RATio:RELative? . . . . . . . . . . . .202
READ[1]|2|3|4[:SCALar][:POWer][:AC]:RELative? . . . . . . . . . . . . . . . . .204
16 SENSe Subsystem
[:SENSe[1]:]AVERage2:COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
[:SENSe[1]:]AVERage2[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
[:SENSe[1]:]AVERage:COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
[:SENSe[1]:]AVERage:COUNt:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . .213

Keysight U2040 X-Series Programming Guide 7
[:SENSe[1]:]AVERage:RESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
[:SENSe[1]:]AVERage:SDETect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
[:SENSe[1]:]AVERage[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
[:SENSe[1]:]BANDwidth|BWIDth:VIDeo . . . . . . . . . . . . . . . . . . . . . . . . 218
[:SENSe[1]:]BANDwidth|BWIDth:VIDeo:STATe . . . . . . . . . . . . . . . . . . 219
[:SENSe[1]:]BUFFer:COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
[:SENSe[1]:]BUFFer:MTYPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
[:SENSe[1]:]CORRection:CSET2:STATe . . . . . . . . . . . . . . . . . . . . . . . . 222
[:SENSe[1]:]CORRection:CSET3:STATe . . . . . . . . . . . . . . . . . . . . . . . . 223
[:SENSe[1]:]CORRection:CSET4:STATe . . . . . . . . . . . . . . . . . . . . . . . . 224
[:SENSe[1]:]CORRection:CSET2[:SELect] . . . . . . . . . . . . . . . . . . . . . . 225
[:SENSe[1]:]CORRection:CSET3[:SELect] . . . . . . . . . . . . . . . . . . . . . . 227
[:SENSe[1]:]CORRection:CSET4[:SELect] . . . . . . . . . . . . . . . . . . . . . . 228
[:SENSe[1]:]CORRection:DCYCle|GAIN3:STATe . . . . . . . . . . . . . . . . . 229
[:SENSe[1]:]CORRection:DCYCle|GAIN3[:INPut][:MAGNitude] . . . . . . 230
[:SENSe[1]:]CORRection:FDOFfset|GAIN4[:INPut][:MAGNitude]? . . . 232
[:SENSe[1]:]CORRection:GAIN2[:INPut]:STATe . . . . . . . . . . . . . . . . . . 233
[:SENSe[1]:]CORRection:GAIN2[:INPut][:MAGNitude] . . . . . . . . . . . . 234
[:SENSe[1]:]CORRection:LOSS2[:INPut]:STATe . . . . . . . . . . . . . . . . . . 235
[:SENSe[1]:]CORRection:LOSS2[:INPut][:MAGNitude] . . . . . . . . . . . . 236
[:SENSe[1]:]CORRection:SGAMma? . . . . . . . . . . . . . . . . . . . . . . . . . . 237
[:SENSe[1]:]CORRection:SGAMma:STATe . . . . . . . . . . . . . . . . . . . . . . 238
[:SENSe[1]:]CORRection:SGAMma:MAGNitude . . . . . . . . . . . . . . . . . 239
[:SENSe[1]:]CORRection:SGAMma:PHASe . . . . . . . . . . . . . . . . . . . . . 240
[:SENSe[1]:]CORRection:SPARam? . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
[:SENSe[1]:]DETector:FUNCtion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
[:SENSe[1]:]FREQuency[:CW|:FIXed] . . . . . . . . . . . . . . . . . . . . . . . . . . 243
[:SENSe[1]:]FREQuency[:CW|:FIXed]:STARt . . . . . . . . . . . . . . . . . . . . 244
[:SENSe[1]:]FREQuency[:CW|:FIXed]:STOP . . . . . . . . . . . . . . . . . . . . . 246
[:SENSe[1]:]FREQuency[:CW|:FIXed]:STEP . . . . . . . . . . . . . . . . . . . . . 248
[:SENSe[1]:]LIST:FREQuency:STARt . . . . . . . . . . . . . . . . . . . . . . . . . . 250
[:SENSe[1]:]LIST:FREQuency:STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
[:SENSe[1]:]LIST:MTYPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
[:SENSe[1]:]LIST:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

8Keysight U2040 X-Series Programming Guide
[:SENSe[1]:]LIST:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
[:SENSe[1]:]LIST:TSCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
[:SENSe[1]:]LIST:TSLot:EXCLude:OFFSet:TIME . . . . . . . . . . . . . . . . . .257
[:SENSe[1]:]LIST:TSLot:EXCLude:TIME . . . . . . . . . . . . . . . . . . . . . . . .258
[:SENSe[1]:]LIST:TSLot:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259
[:SENSe[1]:]LIST:TSLot:TREF1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260
[:SENSe[1]:]LIST:TSLot:TREF2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261
[:SENSe[1]:]MRATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262
[:SENSe[1]:]SWEep:[1]|2|3|4:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . .264
[:SENSe[1]:]SWEep:[1]|2|3|4:AUTO:REF1|REF2 . . . . . . . . . . . . . . . . . .265
[:SENSe[1]:]SWEep[1]|2|3|4:OFFSet:TIME . . . . . . . . . . . . . . . . . . . . . .266
[:SENSe[1]:]SWEep[1]|2|3|4:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267
[:SENSe[1]:]SWEep:APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .268
[:SENSe[1]:]SWEep:APERture:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . .270
[:SENSe[1]:]TEMPerature? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
[:SENSe[1]:]TRACe:OFFSet:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272
[:SENSe[1]:]TRACe:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273
[:SENSe[1]:]TRACe:UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
[:SENSe[1]:]TRACe:AUToscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275
17 SERVice Subsystem
SERVice:BIST:CW:ZSET:NUMber? . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
SERVice:BIST:PEAK[1]:LINearity . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279
SERVice:BIST:PEAK[1]:LINearity:PERRor? . . . . . . . . . . . . . . . . . . . . . .280
SERVice:BIST:PEAK[1]:ZSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
SERVice:BIST:PEAK[1]:ZSET:NUMber? . . . . . . . . . . . . . . . . . . . . . . . .282
SERVice:BIST:RAM:MODE <character_data> . . . . . . . . . . . . . . . . . . .283
SERVice:BIST:TBASe:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
SERVice:LAN:PHOStname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285
SERVice:SECure:ERASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .286
SERVice:SENSor[1]:CDATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287
SERVice:SENSor[1]:CPLace? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288
SERVice:SENSor[1]:FREQuency:MAXimum? . . . . . . . . . . . . . . . . . . . .289
SERVice:SENSor[1]:FREQuency:MINimum? . . . . . . . . . . . . . . . . . . . .290
SERVice:SENSor[1]:POWer:AVERage:MAXimum? . . . . . . . . . . . . . . .291

Keysight U2040 X-Series Programming Guide 9
SERVice:SENSor[1]:POWer:PEAK:MAXimum? . . . . . . . . . . . . . . . . . . 292
SERVice:SENSor[1]:POWer:USABle:MAXimum? . . . . . . . . . . . . . . . . . 293
SERVice:SENSor[1]:POWer:USABle:MINimum? . . . . . . . . . . . . . . . . . 294
SERVice:SENSor[1]:RADC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
SERVice:SENSor[1]:SNUMber? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
SERVice:SENSor[1]:TYPE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
SERVice:SNUMber? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
18 STATus Subsystem
STATus Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Status Register Set Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Device Status Register Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Operation Register Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
STATus:OPERation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
STATus:OPERation:CALibrating[:SUMMary] . . . . . . . . . . . . . . . . . . . . 308
STATus:OPERation:LLFail[:SUMMary] . . . . . . . . . . . . . . . . . . . . . . . . . 309
STATus:OPERation:MEASuring[:SUMMary] . . . . . . . . . . . . . . . . . . . . . 310
STATus:OPERation:SENSe[:SUMMary] . . . . . . . . . . . . . . . . . . . . . . . . 311
STATus:OPERation:TRIGger[:SUMMary] . . . . . . . . . . . . . . . . . . . . . . . 312
STATus:OPERation:ULFail[:SUMMary] . . . . . . . . . . . . . . . . . . . . . . . . 313
STATus:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Questionable Register Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
STATus:QUEStionable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
STATus:QUEStionable:CALibration[:SUMMary] . . . . . . . . . . . . . . . . . 317
STATus:QUEStionable:POWer:CHA . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
STATus:QUEStionable:POWer[:SUMMary] . . . . . . . . . . . . . . . . . . . . . 319
Status Block Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
19 SYSTem Subsystem
SYSTem:COMMunicate:LAN:AIP[:STATe] . . . . . . . . . . . . . . . . . . . . . . 322
SYSTem:COMMunicate:LAN:DHCP[:STATe] . . . . . . . . . . . . . . . . . . . . 323
SYSTem:COMMunicate:LAN:ADDRess . . . . . . . . . . . . . . . . . . . . . . . . 324
SYSTem:COMMunicate:LAN:DGATeway . . . . . . . . . . . . . . . . . . . . . . . 325
SYSTem:COMMunicate:LAN:DNAMe . . . . . . . . . . . . . . . . . . . . . . . . . 326
SYSTem:COMMunicate:LAN:HNAMe . . . . . . . . . . . . . . . . . . . . . . . . . 327

10 Keysight U2040 X-Series Programming Guide
SYSTem:COMMunicate:LAN:MAC . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
SYSTem:COMMunicate:LAN:SMASk . . . . . . . . . . . . . . . . . . . . . . . . . .329
SYSTem:COMMunicate:LAN:RESTart . . . . . . . . . . . . . . . . . . . . . . . . .330
SYSTem:COMMunicate:LAN:CURRent:ADDRess? . . . . . . . . . . . . . . .331
SYSTem:COMMunicate:LAN:CURRent:DGATeway? . . . . . . . . . . . . . .332
SYSTem:COMMunicate:LAN:CURRent:DNAMe? . . . . . . . . . . . . . . . . .333
SYSTem:COMMunicate:LAN:CURRent:SMASk? . . . . . . . . . . . . . . . . .334
SYSTem:COMMunicate:LAN:KEEPalive . . . . . . . . . . . . . . . . . . . . . . . .335
SYSTem:COMMunicate:TCPip:CONTrol? . . . . . . . . . . . . . . . . . . . . . . .337
SYSTem:ERRor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338
SYSTem:HELP:HEADers? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
SYSTem:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
SYSTem:SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .400
SYSTem:VERSion? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .401
20 TRACe Subsystem
TRACe[1]:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .404
TRACe[1]:UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405
TRACe[1][:DATA]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .406
TRACe[1]:DEFine:DURation:REFerence . . . . . . . . . . . . . . . . . . . . . . . .408
TRACe[1]:DEFine:TRANsition:REFerence . . . . . . . . . . . . . . . . . . . . . . .409
TRACe[1]:MEASurement:REFerence? . . . . . . . . . . . . . . . . . . . . . . . . .410
TRACe[1]:MEASurement:INSTant:REFerence? . . . . . . . . . . . . . . . . . .411
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:AM? . . . . . . . . .412
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:AT? . . . . . . . . .413
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:DCYCle? . . . . .414
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:DURation? . . .415
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:PERiod? . . . . .416
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:SEParation? . .417
TRACe[1]:MEASurement:PULSe[1]|2|3|4|5|6|7|8|9|..20:TILT? . . . . . . . .418
TRACe[1]:MEASurement:TRANsition[1]|2|3|4|5|6|7|8|9|..20:NEGative:DURat
ion? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .419
TRACe[1]:MEASurement:TRANsition[1]|2|3|4|5|6|7|8|9|..20:NEGative:OCCur
ence? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .420
TRACe[1]:MEASurement:TRANsition[1]|2|3|4|5|6|7|8|9|..20:POSitive:DURati

Keysight U2040 X-Series Programming Guide 11
on? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
TRACe[1]:MEASurement:TRANsition[1]|2|3|4|5|6|7|8|9|..20:POSitive:OCCur
ence? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
TRACe[1]:MEASurement:TILT:UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
TRACe[1]:OFFSet:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
TRACe[1]:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
TRACe[1]:AUToscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
21 TRIGger Subsystem
TRIGger[1][:SEQuence[1]]:COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
TRIGger[1][:SEQuence[1]]:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
TRIGger[1][:SEQuence[1]]:DELay:AUTO . . . . . . . . . . . . . . . . . . . . . . . 431
TRIGger[1][:SEQuence[1]]:HOLDoff . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
TRIGger[1][:SEQuence[1]]:HYSTeresis . . . . . . . . . . . . . . . . . . . . . . . . . 433
TRIGger[1][:SEQuence[1]][:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . 434
TRIGger[1][:SEQuence[1]]:LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
TRIGger[1][:SEQuence[1]]:LEVel:AUTO . . . . . . . . . . . . . . . . . . . . . . . . 436
TRIGger[1][:SEQuence[1]]:QUALifier:TIME . . . . . . . . . . . . . . . . . . . . . 437
TRIGger[1][:SEQuence[1]]:SLOPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
TRIGger[1][:SEQuence[1]]:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
22 UNIT Subsystem
UNIT[1]|2|3|4:POWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
UNIT[1]|2|3|4:POWer:RATio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
23 Programming Examples
Example 1: Two Time Slot GSM Measurement . . . . . . . . . . . . . . . . . . 446
Example 2: Achieve Measurement Speed of >20000 Readings/s . . . 447
Example 3: Achieve Fast Measurement Speed of 50000 Readings/s . 449
Example 4: Capture Every Timeslot in GSM Frames . . . . . . . . . . . . . . 450

12 Keysight U2040 X-Series Programming Guide
THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK.

Keysight U2040 X-Series Programming Guide 13
List of Figures
Figure 1-1 Frequency-dependent offset tables . . . . . . . . . . . . . . 38
Figure 1-2 Typical averaged readings . . . . . . . . . . . . . . . . . . . . . . 45
Figure 1-3 Typical averaged readings (continued) . . . . . . . . . . . . 46
Figure 1-4 Dynamic range hysteresis . . . . . . . . . . . . . . . . . . . . . . 46
Figure 1-5 Limits checking results . . . . . . . . . . . . . . . . . . . . . . . . 49
Figure 1-6 How measurements are calculated . . . . . . . . . . . . . . . 54
Figure 1-7 Generalized status register model . . . . . . . . . . . . . . . 55
Figure 1-8 Typical status register bit changes . . . . . . . . . . . . . . . 56
Figure 1-9 Status system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Figure 19-1 IEEE-488.2 arbitrary block program data format . . . 343

14 Keysight U2040 X-Series Programming Guide
THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK.

Keysight U2040 X-Series Programming Guide 15
List of Tables
Table 1-1 MEASure? and CONFigure preset states . . . . . . . . . . 26
Table 1-2 Range of values for limits . . . . . . . . . . . . . . . . . . . . . . 49
Table 1-3 Bit definitions - Status byte register . . . . . . . . . . . . . . 59
Table 1-4 Bit definitions - Standard event register . . . . . . . . . . . 60
Table 1-5 Bit definitions - Questionable status registers . . . . . . 61
Table 1-6 Bit change conditions for questionable status register .
61
Table 1-7 Bit definitions - Operation status . . . . . . . . . . . . . . . . 62
Table 1-8 Bit change conditions for operation status . . . . . . . . . 62
Table 1-9 Bit definitions - Device status register . . . . . . . . . . . . 63
Table 1-10 Bit change conditions for device status register . . . . . 63
Table 2-1 *ESE mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Table 2-2 *ESR? mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Table 2-3 *SRE mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Table 2-4 *STB? mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Table 4-1 Measurement units . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Table 4-2 Measurement units . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Table 13-1 Frequency and offset factor list . . . . . . . . . . . . . . . . . 182
Table 18-1 Commands and events affecting the status register 300
Table 19-1 DEFault: U2040 X-Series presets . . . . . . . . . . . . . . . 346
Table 19-2 GSM900: U2040 X-Series presets . . . . . . . . . . . . . . . 348
Table 19-3 GSM900: U2040 X-Series presets for calc setup . . . 349
Table 19-4 EDGE: U2040 X-Series presets . . . . . . . . . . . . . . . . . 350
Table 19-5 EDGE: U2040 X-Series presets for calc setup . . . . . 351
Table 19-6 NADC: U2040 X-Series presets . . . . . . . . . . . . . . . . . 353
Table 19-7 NADC: U2040 X-Series presets for calc setup . . . . . 354
Table 19-8 BLUetooth: U2040 X-Series presets . . . . . . . . . . . . . 356
Table 19-9 BLUetooth: U2040 X-Series presets for calc setup . 357
Table 19-10 CDMAone: U2040 X-Series presets . . . . . . . . . . . . . 358
Table 19-11 CDMAone: U2040 X-Series presets for calc setup . . 359
Table 19-12 W-CDMA: U2040 X-Series presets . . . . . . . . . . . . . . 361
Table 19-13 W-CDMA: U2040 X-Series presets for calc setup . . 362
Table 19-14 CDMA2000: U2040 X-Series presets . . . . . . . . . . . . 364
Table 19-15 CDMA2000: U2040 X-Series presets for calc setup . 365
Table 19-16 iDEN: U2040 X-Series presets . . . . . . . . . . . . . . . . . 367
Table 19-17 iDEN: U2040 X-Series presets for calc setup . . . . . . 368
Table 19-18 MCPa: U2040 X-Series presets . . . . . . . . . . . . . . . . . 370
Table 19-19 MCPa: U2040 X-Series presets for calc setup . . . . . 371
Table 19-20 RADar: U2040 X-Series presets . . . . . . . . . . . . . . . . 372

16 Keysight U2040 X-Series Programming Guide
Table 19-21 RADar: U2040 X-Series presets for calc setup . . . . .373
Table 19-22 WL802DOT11A: U2040 X-Series presets . . . . . . . . .374
Table 19-23 WL802DOT11A: U2040 X-Series presets for calc setup .
375
Table 19-24 WL802DOT11B: U2040 X-Series presets . . . . . . . . .376
Table 19-25 WL802DOT11B: U2040 X-Series presets for calc setup .
377
Table 19-26 XEVDO: U2040 X-Series presets . . . . . . . . . . . . . . . .378
Table 19-27 XEVDO: U2040 X-Series presets for calc setup . . . .379
Table 19-28 XEVDV: U2040 X-Series presets . . . . . . . . . . . . . . . .380
Table 19-29 XEVDV: U2040 X-Series presets for calc setup . . . .381
Table 19-30 TDSCdma: U2040 X-Series presets . . . . . . . . . . . . . .382
Table 19-31 TDSCdma: U2040 X-Series presets for calc setup . .383
Table 19-32 DVB: U2040 X-Series presets . . . . . . . . . . . . . . . . . .384
Table 19-33 TDVB: U2040 X-Series presets for calc setup . . . . . .385
Table 19-34 HIPERLAN2: U2040 X-Series presets . . . . . . . . . . . .386
Table 19-35 HIPERLAN2: U2040 X-Series presets for calc setup .387
Table 19-36 WIMAX: U2040 X-Series presets . . . . . . . . . . . . . . . .388
Table 19-37 WIMAX: U2040 X-Series presets for calc setup . . . .389
Table 19-38 HSDPA: U2040 X-Series presets . . . . . . . . . . . . . . . .390
Table 19-39 HSDPA: U2040 X-Series presets for calc setup . . . .391
Table 19-40 DME: U2040 X-Series presets . . . . . . . . . . . . . . . . . .392
Table 19-41 DME: U2040 X-Series presets for calc setup . . . . . .393
Table 19-42 DMEPRT: U2040 X-Series presets . . . . . . . . . . . . . . .394
Table 19-43 DMEPRT: U2040 X-Series presets for calc setup . . .395
Table 19-44 LTEFDD: U2040 X-Series presets . . . . . . . . . . . . . . .396
Table 19-45 LTEFDD: U2040 X-Series presets for calc setup . . . .397
Table 19-46 LTETDD: U2040 X-Series presets . . . . . . . . . . . . . . .398
Table 19-47 LTETDD: U2040 X-Series presets for calc setup . . . .399

Keysight U2040 X-Series
Wide Dynamic Range Power Sensors
Programming Guide
1 U2040 X-Series Remote Operation
Configuring the USB/LAN Interface 19
Introduction to the SCPI Language 20
Mnemonic forms 20
Using a colon “:” 20
Using a semicolon “;” 20
Using a comma “,” 21
Using whitespace 21
Using “?” commands 21
Using “*” commands 21
Syntax conventions 22
SCPI data types 22
Input message terminators 24
Zeroing and Calibrating the U2040 X-Series 25
Zeroing 25
Calibration 25
Making Measurements 26
Using MEASure? 26
Using the CONFigure command 29
Using the lower-level commands 36
Using Frequency-Dependent Offset Tables 37
Setting the Averaging 44
Overview 37
Editing frequency-dependent offset tables 39
Selecting a frequency-dependent offset table 42
Enabling a frequency-dependent offset table 42
Making the measurement 42
Setting Offsets 47
Averaging 44
Auto-averaging mode 44
Filter length 46
Setting Measurement Limits 49
Channel offsets 47

1 U2040 X-Series Remote Operation
18 Keysight U2040 X-Series Programming Guide
CALCulate offsets 47
Getting the Best Speed Performance 51
Setting limits 49
Checking for limit failures 50
How Measurements are Calculated 54
Measurement rate 51
Trigger mode 51
Output format 53
Units 53
Command used 53
Fast mode 53
Status Reporting 55
Saving and Recalling U2040 X-Series Configurations 65
The general status register model 55
How to use registers 57
Device Status register 63
Using the Operation Complete commands 64
Using Device Clear to Halt Measurements 66
How to save and recall a configuration 65
Making Measurements on Wireless Communication Standards 67
Starting a preset example 68
This chapter describes the parameters that configure the U2040 X-Series, and helps you
determine the settings to optimize performance.

U2040 X-Series Remote Operation 1
Keysight U2040 X-Series Programming Guide 19
Configuring the USB/LAN Interface
The USB interface requires no front panel or remote configuration.
Before connecting the USB/LAN cable, make sure that the Keysight IO Libraries software is
installed on your PC.
NOTE
For further information on connecting and verifying the U2040 X-Series via USB/LAN, refer
to the U2040 X-Series User’s Guide.
NOTE
– For more information on configuring the USB/LAN remote interface connectivity, refer
to the Keysight USB/LAN/GPIB Interfaces Connectivity Guide.
– If you have installed the IO Libraries Suite, you can access the Connectivity Guide via
the IO Libraries Control icon or via the Web at www.keysight.com/find/connectivity.
– If you have installed other I/O software, refer to the documentation that accompanies
the software.

1 U2040 X-Series Remote Operation
20 Keysight U2040 X-Series Programming Guide
Introduction to the SCPI Language
Standard Commands for Programmable Instruments (SCPI) is an ASCII-based instrument
command language designed for test and measurement instruments. SCPI commands are
based on a hierarchical structure, also known as a tree system. In this system, associated
commands are grouped together under a common node or root, thus forming subsystems.
A portion of the SYSTem subsystem is shown below to illustrate the tree system.
SYSTem:
PRESet [<character_data>[,<character_data>]]
SYSTem is the root keyword of the command and PRESet is the second-level keyword. A
colon “:” separates a command keyword from a lower-level keyword.
Mnemonic forms
Each keyword has both a long and a short form. A standard notation is used to differentiate
the short-form keyword from the long-form keyword. The long form of the keyword is
shown, with the short-form portion shown in upper-case characters, and the rest of the
keyword shown in lower-case characters. For example, the short form of TRIGger is TRIG.
Using a colon “:”
When a colon is the first character of a command keyword, it indicates that the next
command mnemonic is a root-level command. When a colon is inserted between two
command mnemonics, the colon moves the path down one level in the present path (for
the specified root-level command) of the command tree. You must separate command
mnemonics from each other using a colon. You can omit the leading colon if the command
is the first of a new program line.
Using a semicolon “;”
Use a semicolon to separate two commands within the same command string. The
semicolon does not change the present path specified. For example, the following two
statements are equivalent. Note that in the first statement, the first colon is optional but
the third is compulsory.
SENS:AVER ON;SENS:AVER:COUN 1
SENS:AVER ON;AVER:COUN 1