Agilent X-Series Signal Analyzer: N9061A Remote Language Compatibility Guide
Agilent X-Series Signal Analyzer: N9061A Remote Language Compatibility Guide
Agilent X-Series Signal Analyzer: N9061A Remote Language Compatibility Guide
Signal Analyzer
This manual provides documentation for the
following X-Series Analyzers:
N9061A
Remote Language
Compatibility Guide
Notices
© Agilent Technologies, Inc. 2008, 2009 Manual Part Number licensed as “Commercial computer soft-
ware” as defined in DFAR 252.227-7014
No part of this manual may be reproduced N9020-90119 (June 1995), or as a “commercial item” as
in any form or by any means (including Supersedes:N9020-90091 defined in FAR 2.101(a) or as “Restricted
electronic storage and retrieval or transla-
computer software” as defined in FAR
tion into a foreign language) without prior
agreement and written consent from Agi-
Print Date 52.227-19 (June 1987) or any equivalent
agency regulation or contract clause. Use,
lent Technologies, Inc. as governed by October 2009 duplication or disclosure of Software is
United States and international copyright
Printed in USA subject to Agilent Technologies’ stan-
laws.
dard commercial license terms, and non-
Agilent Technologies, Inc. DOD Departments and Agencies of the
Trademark 1400 Fountaingrove Parkway U.S. Government will receive no greater
Santa Rosa, CA 95403 than Restricted Rights as defined in FAR
Acknowledgements
52.227-19(c)(1-2) (June 1987). U.S. Gov-
Microsoft® is a U.S. registered Warranty ernment users will receive no greater than
trademark of Microsoft Corporation. Limited Rights as defined in FAR 52.227-
The material contained in this doc- 14 (June 1987) or DFAR 252.227-7015
® ® ument is provided “as is,” and is (b)(2) (November 1995), as applicable in
Windows and MS Windows are
U.S. registered trademarks of subject to being changed, without any technical data.
Microsoft Corporation. notice, in future editions. Further,
to the maximum extent permitted Safety Notices
Adobe Reader® is a U.S. registered by applicable law, Agilent dis-
trademark of Adobe System claims all warranties, either
Incorporated. express or implied, with regard to CAUTION
this manual and any information
Java™ is a U.S. trademark of Sun
contained herein, including but not
Microsystems, Inc. A CAUTION notice denotes a
limited to the implied warranties of
hazard. It calls attention to an
MATLAB® is a U.S. registered merchantability and fitness for a
particular purpose. Agilent shall operating procedure, practice, or
trademark of Math Works, Inc.
not be liable for errors or for inci- the like that, if not correctly per-
Norton Ghost™ is a U.S. trademark dental or consequential damages in formed or adhered to, could result
of Symantec Corporation. connection with the furnishing, use, in damage to the product or loss of
or performance of this document or important data. Do not proceed
of any information contained beyond a CAUTION notice until
herein. Should Agilent and the user the indicated conditions are fully
have a separate written agreement understood and met.
with warranty terms covering the
material in this document that con-
WARNING
flict with these terms, the warranty
terms in the separate agreement
shall control. A WARNING notice denotes a
hazard. It calls attention to an
Technology Licenses operating procedure, practice,
or the like that, if not correctly
The hardware and/or software described
performed or adhered to, could
in this document are furnished under a
license and may be used or copied only in result in personal injury or
accordance with the terms of such license. death. Do not proceed beyond a
WARNING notice until the
Restricted Rights Legend indicated conditions are fully
understood and met.
If software is for use in the performance
of a U.S. Government prime contract or
subcontract, Software is delivered and
2
Warranty
This Agilent technologies instrument product is warranted against defects in material and workmanship for
a period of one year from the date of shipment. During the warranty period, Agilent Technologies will, at
its option, either repair or replace products that prove to be defective.
For warranty service or repair, this product must be returned to a service facility designated by Agilent
Technologies. Buyer shall prepay shipping charges to Agilent Technologies and Agilent Technologies
shall pay shipping charges to return the product to Buyer. However, Buyer shall pay all shipping charges,
duties, and taxes for products returned to Agilent Technologies from another country.
3
4
Contents
1. Getting Started
N9061A Application Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Documentation for the N9061A application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
N9061A General Rules and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Hardware and Firmware Requirements for N9061A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Installing the N9061A application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Setting up N9061A on the X-Series Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Running Software that Requires SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Service and Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4. Programming Commands
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Programming Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
A1 [one]
Clear Write for Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
A2 [two]
Maximum Hold for Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
A3 [three]
View Mode for Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
A4 [four]
Blank Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
ACPALPHA
Adjacent Channel Power Alpha Weighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
ACPALTCH
Adjacent Channel Power Alternate Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
ACPBRPER
Adjacent Channel Power Burst Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ACPBRWID
Adjacent Channel Power Burst Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ACPBW
Adjacent Channel Power Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
ACPCOMPUTE
Adjacent Channel Power Compute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ACPFRQWT
Adjacent Channel Power Frequency Weighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
ACPLOWER
Lower Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
ACPMAX
Maximum Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
ACPMEAS
Measure Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
ACPMSTATE
5
Contents
6
Contents
C2 [two]
A Minus B Into A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
CA
Couple Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
CARROFF
Carrier Off Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
CARRON
Carrier On Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
CF
Center Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
CHANNEL
Channel Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
CHANPWR
Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
CHPWRBW
Channel Power Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
CLRAVG
Clear Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
CLRW
Clear Write . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
CONTS
Continuous Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
COUPLE
Input Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
CR
Couple Resolution Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
CS
Couple Frequency Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
CT
Couple Sweep Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
CV
Couple Video Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
DA
Display Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
DELMKBW
Occupied Power Bandwidth Within Delta Marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
DET
Detection Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
DL
Display Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
DLE
Display Line Enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
DLYSWP
Delay Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
DONE
Done . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
DR
Display Read . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
E1[one]
7
Contents
8
Contents
IP
Instrument Preset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
KS,
Mixer Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
KS=
8566A/B: Automatic Preselector Tracking
8568A/B: Marker Counter Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
KS(
Lock Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
KS)
Unlock Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
KSA
Amplitude in dBm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
KSa
Normal Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
KSB
Amplitude in dBmV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
KSb
Positive Peak Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
KSC
Amplitude in dBuV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
KSc
A Plus B to A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
KSD
Amplitude in Volts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
KSd
Negative Peak Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
KSE
Title Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
KSe
Sample Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
KSG
Video Averaging On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
KSg
Display Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
KSH
Video Averaging Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
KSh
Display On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
KSi
Exchange Trace B and Trace C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
KSj
View Trace C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
KSK
Marker to Next Peak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
KSk
Blank Trace C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
KSL
Marker Noise Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
9
Contents
KSl
Transfer Trace B to Trace C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
KSM
Marker Noise On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
KSm
Graticule Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
KSN
Marker Minimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
KSn
Graticule On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
KSO
Marker Span . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
KSo
Annotation Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
KSp
Annotation On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
KST
Fast Preset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
KSV
Frequency Offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
KSx
External Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
KSy
Video Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
KSZ
Reference Level Offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
L0 [zero]
Display Line Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
LF
Low Frequency Preset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
LG
Logarithmic Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
LIMF
Limit Line Frequency Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
LIMIFAIL
Limits Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
LIMIPURGE
Delete Current Limit Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
LIMIREL
Relative Limit Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
LIML
Lower-Limit Amplitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
LIMTSL
Slope Limit Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
LIMU
Upper-Limit Amplitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
LN
Linear Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
M1 [one]
10
Contents
11
Contents
MKOFF
Marker Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
MKP
Marker Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
MKPK
Marker Peak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
MKPT
Marker Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
MKPX
Marker Peak Excursion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
MKREAD
Marker Readout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
MKRL
Marker to Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
MKSP
Marker Span . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
MKSS
Marker to Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
MKT
Marker Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
MKTRACE
Marker Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
MKTRACK
Marker Track . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
MKTYPE
Marker Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
ML
Mixer Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
MT0 [zero]
Marker Track Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
MT1 [one]
Marker Track On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
MXMH
Maximum Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
NORMLIZE
Normalize Trace Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
NRL
Normalized Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
NRPOS
Normalized Reference Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
O1 [one]
Format - Display Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
O2 [two]
Format - Two 8-Bit Bytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
O3 [three]
Format - Real Amplitude Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
O4 [four]
Format - One 8-Bit Byte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
OA or ?
12
Contents
13
Contents
SAVES
Save State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
SER
Serial Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
SETDATE
Set Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
SETTIME
Set Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
SMOOTH
Smooth Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
SNGLS
Single Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
SP
Frequency Span . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
SRQ
Service Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
SS
Center Frequency Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
ST
Sweep Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
STB
Status Byte Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
STDEV
Standard Deviation of Trace Amplitudes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
SUM
Sum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
SV
Save State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
SWPCPL
Sweep Couple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
T1 [one]
Free Run Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
T2 [two]
Line Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
T3 [three]
External Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
T4 [four]
Video Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
TA
Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
TB
Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
TDF
Trace Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
TH
Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
THE
Threshold Enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
TIMEDATE
14
Contents
15
Contents
16
1 Getting Started
17
Getting Started
N9061A Application Description
NOTE The 8566A/B and the 8568A/B are not considered part of the 8560 series of
analyzers.
The X-Series analyzer with the N9061A application installed is designed to replace these analyzers in
many automated systems with minimal or no modification to the currently used measurement software.
There are two options for N9061A. One is N9061A-1FP, 8566A/B and 8568A/B remote language
compatibility, the other is N9061A-2FP, 8560 Series remote language compatibility.
18
Getting Started
Documentation for the N9061A application
19
Getting Started
N9061A General Rules and Limitations
Remote Control
The N9061A application in X-Series signal analyzers supports remote operation through the GPIB
interface. It does not support working over LAN, USB or Telnet.
Units
The N9061A application supports all units used in legacy products. The allowed units are HZ, KHZ,
MHZ, GHZ, KZ, MZ, GZ, DBM, DBMV, DBUV, MV, UV, V, MW, UW, W, DB, DM, MS, US, SC,
and S (case insensitive in 8566/68). A command terminator such as ";" also acts as a unit terminator.
Numeric Ranges
Numeric ranges are limited to that of the X-Series unless otherwise stated, although commands such as
FS or IP that go to a default range will use the range of the legacy instrumentation.
Returning Data
The X-Series and legacy instruments have a different approach when returning data to the controller.
The X-Series and 8560-series analyzers operate a FIFO buffer for command return values. If a command
returns a value that the controller does not read, the returned data is stored until such a time that the
controller requires the value. The 8566, 8568, and 8590-series legacy analyzers only store one value at a
time. Any value stored is overwritten each time a command returns a value. The N9071A application
handles this difference appropriately only within a single command string.
In the case of query string, it returns the query result for the last command in the string. For example, if
"CF?MA?FA?" is sent, the result of FA? will be returned. However, this rule does not work if the query
is located at both sides of the "TS" command. When the command string "MA;TS;CF?" is sent, the result
of CF? will be returned in the next query.
AC/DC Coupling
The 44 GHz and 50 GHz X-Series analyzers only have DC coupling. The X-Series analyzers with a 26.5
GHz frequency range and lower, default to AC coupling on preset. The N9061A application will ensure
that DC coupling is the default when the selected instrument is HP8566A, HP8566B, HP8563, HP8564,
or HP8565.
When AC coupled, the 8560E/61E/62E have a 100 kHz low frequency limit, while the X-Series
analyzers has a 10 MHz limit.
For HP8568A/B compatibility and consistency, the I1 and I2 commands have been supported. These
select AC or DC coupling at the RF input. Note tht the HP8568A/B has two RF input ports in
comparison with the X-Series, which only has one.
20
Getting Started
N9061A General Rules and Limitations
Markers
The N9071A application emulates the behavior of legacy products. If someone uses a marker state which
is not available in the legacy instrument, further marker behavior is undefined until instrument preset.
On systems that supported MKACT, there are 4 completely different marker pairs, each with its own
information. The N9061A will store the currently active value of MKACT. If MKACT is 2 then it will
use Markers 3 and 4 instead of 1 and 2.
Parsing
For 8566B and 8568B, the N9061A will remember the active function and supports UP, DN, and OA, all
of which change the active function. It also supports '?', which does not change the active function.
One difference between N9061A and 8566/68 is that the 8566/68 parses a command for example CF
10.3GZ, immediately when it recognizes a complete command, in this example after the GZ. However
the N9061A parses at the end of a line when it sees the line termination sequence.
Couplings
To provide the most optimized use of the X-Series analyzers, the N9061A application uses the auto
coupling features of the X-Series analyzers and does not attempt to mimic the exact behavior of coupling
in the legacy analyzers. To eliminate the possibilities of "Meas Uncal" errors between auto and manual
values, values will default to the X-Series auto settings where applicable (for example resolution
bandwidth). There are several exceptions below.
To prevent timeout errors in the legacy code, the resolution bandwidth minimum matches the minimum
in the legacy analyzer. Resolution bandwidth steps and resolution, however, will be X-Series values.
The video bandwidth will couple to the resolution bandwidth according to the Video bandwidth coupling
offset value, specified by the VBO or VBR command. The X-Series analyzers sets the video bandwidth
according to the VBO or VBR setting, but uses the X-Series analyzers available bandwidths to prevent
'Meas Uncal' errors.
Predefined Functions
In the 8566/8568/8560 Series analyzers, a “predefined function” is an analyzer command that returns a
number that can be operated on by other analyzer commands. “Predefined variables” follow the same
idea, except the value to be passed as a parameter to the next command is stored in a variable.
The N9061A application does not support this type of behavior, so any commands that originally acted
as predefined functions or variables, or that allowed predefined functions or variables as arguments in
the 8566/8568/8560 Series no longer do so.
User-defined Functions
No user-defined functions, traces, or variables (FUNCDEF, TRDEF or VARDEF) can be used as
arguments or commands in programs controlling any analyzer running the N9061A application. In
addition, the behavior of certain commands that rely on the “active functions” (UP, DN, etc.) may be
slightly different.
21
Getting Started
N9061A General Rules and Limitations
Supported Commands
Only a subset of the 8566/8568/8560 Series commands is supported in this application (through a GPIB
interface). The list of supported commands was determined by feedback from our customers combined
with technical considerations and constraints.
EP is the enable parameter in the 8560 series that, when used as a secondary keyword after a command,
transfers control and allows front panel operator entry. This command is supported in the N9061A
application for the same active functions as the 8560 series, but is not displayed in any of the format
diagrams for individual commands.
The N9061A application supports the OA parameter that is found in several legacy commands such as
AT and CF. OA is the equivalent of a query so that “CF OA” has a return value equivalent to “CF?”.
Device clear is supported by the N9061A application and causes a mode preset of the signal analyzer.
22
Getting Started
Hardware and Firmware Requirements for N9061A
For maximum compatibility, you should select an X-Series analyzer that equals or exceeds the frequency
range of the legacy analyzer you are replacing (currently not possible for the 8564E/EC or 8565E/EC).
The frequency limits of the legacy instruments are listed below.
Table 1-4 Frequency Ranges of the Legacy Analyzers
23
Getting Started
Hardware and Firmware Requirements for N9061A
24
Getting Started
Installing the N9061A application
Installation
The license is installed on the X-Series analyzer in one of the following ways:
• If you purchased a new X-Series analyzer with the N9061A application then the product is installed
and licensed and ready to use.
• If you have an X-Series analyzer and have subsequently purchased the N9061A application then you
can download the N9061A application from the Agilent website. The N9061A application is installed
as part of a software upgrade. See the link below for Signal Analyzers software upgrade site. After
upgrading your software you should then use your entitlement certificate to license the product (see
Licensing below).
The latest revision of the software may be downloaded from:
http://www.agilent.com/find/pxa_software
http://www.agilent.com/find/mxa_software
http://www.agilent.com/find/exa_software
Licensing
When you order a licensed product, you receive an entitlement certificate. Instructions are provided on
your entitlement certificate to direct you to the Web site to redeem your certificate for a license key. You
need to provide your instrument product number and serial number, and the entitlement certificate
number.
The license is downloaded from the license website onto a USB storage device so that it can be loaded
into the instrument.
25
Getting Started
Installing the N9061A application
A license key is usually for one instrument model/serial number combination. The license key can only
be installed on that instrument.
26
Getting Started
Setting up N9061A on the X-Series Analyzer
Mode Mode
Spectrum
Analyzer
IQ Analyzer
(BASIC)
W-CDMA with
HSDPA/PSUPPA
Phase Noise
Remote
Language
Compatibility
27
Getting Started
Setting up N9061A on the X-Series Analyzer
Then, to select the legacy analyzer you wish to emulate, press the Mode Setup hardkey on the front
panel. Figure 1-2 shows the menu map that allows you to select the 8560 series analyzer or 8566A/B,
8568A/B and therefore the remote control commands to be used in the X-Series analyzer.
Figure 1-2 Mode Setup > Legacy Instrument Selection Menu Map
Mode Setup HP8560 Series
HP8560E/EC
Mode Setup
HP8561E/EC
HP8564E/EC
HP8566/68
HP8565E/EC
HP8566A
HP8566/68
HP8566B HP8566B
HP8568A
Cmd Error
On Off HP8568B
Logging Logging
Preferences Preferences
Restore Mode
Defaults
The HP8560 series and HP8566A/B, 8568A/B key allow you to select which legacy instrument to
emulate. The selected instrument determines the response to the “ID?” command and affects the
behavior of commands such as IP. You can use any command offered by any of the legacy instruments
regardless of the language setting. However, if the command is not correct for the selected legacy
instrument there is no guarantee that the command will work as expected. This does not affect the
response to the SCPI command “*IDN?”.
28
Getting Started
Setting up N9061A on the X-Series Analyzer
29
Getting Started
Setting up N9061A on the X-Series Analyzer
NOTE Setting the remote language to anything other than ‘SCPI’ does not affect the
response to the SCPI command ‘*IDN?’ This command will still return the model
number and firmware version number of the X-Series signal analyzer.
Table 1-5 Span, Trace Points, Couplings, VBW/RBW Ratio, and Span/RBW Ratio
Settings
30
Getting Started
Setting up N9061A on the X-Series Analyzer
Table 1-5 Span, Trace Points, Couplings, VBW/RBW Ratio, and Span/RBW Ratio
Settings
31
Getting Started
Setting up N9061A on the X-Series Analyzer
Cmd Error
Turning Cmd Error On or Off enables or disables the display of the "CMD ERR" error messages. The
default setting is On. The error message appears in the Message bar and also can be queried using
“ERR?”. The error message will occur if either the command syntax or any of its parameters are
incorrectly formed. The selected value is preserved after presetting or power cycling the instrument.
Disabling the display of command errors disables the display of all error types.
The format of the errors are as follows:
1.CMD ERR, <string>
This string will be limited to the first 20 characters of the input string (message unit).
Further details of these errors, after they have occurred, can be reviewed in the Cmd Error Log, as long
as Cmd Error Logging is enabled.
32
Getting Started
Setting up N9061A on the X-Series Analyzer
Logging
The N9061A application allows the logging of errors. These errors comprise details of command errors
and legacy commands that have been received but are not supported by the N9061A application. To
enable and view the error log select the Mode Setup hardkey from the front panel. Then select the
Logging softkey.
Logging Logging
Previous Page
Next Page
Refresh
Clear Log
33
Getting Started
Setting up N9061A on the X-Series Analyzer
Refresh
To update the log page with new entries, select Refresh.
Clear Log
The Clear Log softkey clears the error log.
The log can only be cleared by using the Clear Log function and cannot be cleared on power-up, remote
language switch or mode switch.
34
Getting Started
Setting up N9061A on the X-Series Analyzer
Preferences
The Preferences menu allows you to configure some analyzer settings when in remote language
compatibility mode. Figure 1-4 shows the Preferences menu map that is accessed by selecting the Mode
Setup hardkey on the front panel and then selecting the Preferences softkey. Preferences are not
affected by a power cycle, a remote language change, a mode switching or a mode preset. They are only
preset to their default state using Restore Mode Defaults key in the Mode Setup menu (see Figure 1-2),
INST:DEF or SYST:PRES:PERS command.
Preferences Preferences
Limit RBW/VBW
On Off
Atten Offset
On Off
Swp Type Rules
Limit
Allow
SwpSCPI
Time Always Best Speed
On
On Off
Off DC Coupled
Legacy
Always
AC Coupled
Limit RBW/VBW
Setting Limit RBW/VBW to On limits the valid resolution bandwidth (RBW) and video bandwidth
(VBW) values to those appropriate for the currently selected remote language. While this limitation
reduces measurement flexibility, it helps to ensure that the measurement time in emulation mode is the
same as the legacy measurement time, and ensures that the responses to RB? and VB? match the legacy
instrument. The default state is Off. Setting this key to Off causes the RBW and VBW filters to use the
X-Series analyzer range of values for all remote languages.
Atten Offset
Setting Atten Offset to On allows larger input power to be applied to the analyzer, while significantly
increasing the noise floor. Since many of the older spectrum analyzers had noise floor 10 dB higher than
the X-Series analyzer, this gives the most accurate emulation. The default state is Off.
35
Getting Started
Setting up N9061A on the X-Series Analyzer
RF Coupling
RF Coupling allows you to override the legacy instrument behavior for AC and DC coupling. This
command is required because legacy instruments had AC cutoff frequencies of 100 kHz and the X-series
analyzers have an AC cutoff frequency of 10 MHz.
As Legacy sets coupling to AC or DC whenever the legacy instrument would be set to AC or DC
coupled mode via power on, preset, or an explicit command. Due to changes in the coupling cutoff
frequency, measurement performance below 10 MHz while in AC-coupled mode may not match the
legacy analyzer performance.
Always AC sets AC coupling while in Language Compatibility Mode, overriding other instrument
settings including power on, preset, or an explicit command. This setting maximizes instrument
robustness, and is recommended for instruments that are not used to measure signals below 10 MHz.
Always DC sets DC coupling while in Language Compatibility Mode, overriding other instrument
settings including power on, preset, or explicit command. This will maximize instrument sensitivity to
signals below 10 MHz, and may be required for measurements between 100 KHz and 10 MHz. When in
this mode, extra care should be taken to ensure that DC voltage levels are within the allowable range for
the X-Series analzysers.
HP8566A/B, HP8568A/B 20 ms 1 us
HP8560 series 50 ms 50 us
36
Getting Started
Setting up N9061A on the X-Series Analyzer
Send Commands
After you finish setting up the N9061A application, you can send the commands of the legacy products
(8560 Series, 8566A/B, or 8568A/B) to X-Series analyzers. It is recomanded to use Agilent 82357B
USB/GPIB interface and free instrument to PC connection tool Agilent IO Libraries Suite when you
connct the instrument to a PC. For more details, visit:
http://www.agilent.com/find/82357B
http://www.agilent.com/find/iolib
NOTE The commands can ONLY be sent via a GPIB connection. It will not work for a
LAN connecttion.
37
Getting Started
Running Software that Requires SCPI Commands
:SYSTem:LANGuage?
[:SENSe]:RLC:SWEep:TYPE:AUTO:RULes?
38
Getting Started
Running Software that Requires SCPI Commands
[:SENSe]:RLC:BANDwidth:LIMit?
1. After changing into or out of RLC mode, allow a 1s delay before sending subsequent com-
mands.
2. This command is only available if the N9061A application is installed on your analyzer.
39
Getting Started
Service and Calibration
40
2 Legacy Analyzer Command List
41
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
ABS Absolute No No No
42
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
43
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
ADD Add No No No
AMB Trace A − trace B -> trace A Yes Yes Yes Page 100
APB Trace A + trace B -> trace A Yes Yes Yes Page 103
AVG Average No No No
44
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
BL Trace B − Display line -> trace Yes Yes N/A Page 114
B
BML Trace B − Display line -> trace Yes Yes Yes Page 116
B
45
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
46
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
DIV Divide No No No
DLE Turns the display line on/off Yes Yes N/A Page 143
47
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
DSPLY Display No No No
EDITDONE Indicates limit line editing is N/A N/A Yes Page 151
complete
48
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
ERR Queries the error queue Yes Yes Yes Page 152
EXP Exponential No No No
49
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
50
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
IF Conditional Programming No No No
(If…then…else…endif)
INT Integer No No No
51
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
KS( Locks the save registers Yes Yes N/A Page 181
KS) Unlocks the save registers Yes Yes N/A Page 182
52
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
KSA Sets amplitude units to dBm Yes Yes N/A Page 183
KSB Sets amplitude units to dBmV Yes Yes N/A Page 185
KSb Selects positive peak detection Yes Yes N/A Page 186
KSC Sets amplitude units to dBuV Yes Yes N/A Page 187
KSc Trace A + trace B -> trace A Yes Yes N/A Page 188
KSd Selects negative peak detection Yes Yes N/A Page 190
KSE Sets the analyzer title mode Yes Yes N/A Page 191
KSg Turns off the display Yes Yes N/A Page 194
KSH Turns off video averaging Yes Yes N/A Page 195
53
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
KSL Turns off marker noise function Yes Yes N/A Page 201
KSl Moves trace B into trace C Yes Yes N/A Page 202
KSM Turns on marker noise function Yes Yes N/A Page 203
KSm Turns off the graticule Yes Yes N/A Page 204
KSo Turns off the annotation Yes Yes N/A Page 208
54
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
KSx Sets trigger mode to external Yes Yes N/A Page 212
KSy Sets trigger mode to video Yes Yes N/A Page 213
L0 Turns off the display line Yes Yes Yes Page 215
LIMF Frequency value for limit-line N/A N/A Yes Page 219
segment
55
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
LIMIPURGE Disposes of current limit line, N/A N/A Yes Page 221
not limit line table
LIMIREL Determine whether limit line N/A N/A Yes Page 222
values absolute/relative
LIML Amplitude value for limit line N/A N/A Yes Page 223
segment in lower limit line
LIMU Amplitude value for limit line N/A N/A Yes Page 225
segment in upper limit line
56
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
LOG Log No No No
MC0 Turns off the marker frequency N/A Yes N/A Page 232
counter
MC1 Turns on the marker frequency N/A Yes N/A Page 233
counter
MEAN Returns mean value of trace in Yes Yes Yes Page 235
display units
57
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
MIN Minimum No No No
MINPOS Returns the minimum position Yes Yes N/A Page 240
in the trace
MKA Amplitude of the active marker Yes Yes Yes Page 241
MKACT Specifies the active marker Yes Yes N/A Page 242
MKCF Moves the active marker to Yes Yes Yes Page 244
center frequency
MKF Specifies the frequency of the Yes Yes Yes Page 246
active marker
MKFC Turns the marker frequency N/A Yes Yes Page 247
counter on or off
MKFCR Specifies the marker frequency N/A Yes Yes Page 248
counter resolution
58
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
MKOFF Turns all markers or the active Yes Yes Yes Page 253
marker off
MKP Specifies the horizontal position Yes Yes N/A Page 254
of the marker
MKREAD Specifies marker readout mode Yes Yes N/A Page 258
MKRL Moves the active marker to Yes Yes Yes Page 260
reference level
MKT Position marker in units of time N/A N/A Yes Page 263
MKTRACK Turns the marker signal track on Yes Yes Yes Page 265
or off
MKTYPE Specifies the type of active Yes Yes N/A Page 266
marker to be used
MOD Modulo No No No
59
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
MOV Move No No No
MPY Multiply No No No
MT0 Turns off marker signal track Yes Yes Yes Page 269
MT1 Turns on marker signal track Yes Yes Yes Page 270
MXM Maximum No No No
60
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
OP Output parameters No No No
PA Plot absolute No No No
61
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
PD Pen down No No No
PEAKS Sorts the signal peaks by Yes Yes Yes Page 285
amplitude/frequency
PR Plot relative No No No
62
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
PU Pen up No No No
R2 Allows service request 140 & Yes Yes N/A Page 292
104
R3 Allows service request 140 & Yes Yes N/A Page 293
110
R4 Allows service request 140 & Yes Yes N/A Page 294
102
63
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
REV Returns the revision string to Yes Yes Yes Page 300
the controller
SAVES Saves analyzer state to specified Yes Yes Yes Page 308
register
64
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
SETDATE Set the date of spectrum N/A N/A Yes Page 310
analyzer
SETTIME Set the time of spectrum N/A N/A Yes Page 311
analyzer
SMOOTH Smooths given trace over Yes Yes Yes Page 312
specified number points
65
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
SUB Subtract No No No
T1 Sets the trigger mode to free run Yes Yes Yes Page 326
T2 Sets the trigger mode to line Yes Yes Yes Page 327
T3 Sets the trigger mode to external Yes Yes Yes Page 328
T4 Sets the trigger mode to video Yes Yes Yes Page 329
66
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
THE Turns the threshold on or off Yes Yes N/A Page 334
TIMEDATE Allows setting of time & date N/A N/A Yes Page 335
for analyzer
67
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
TRSTAT Returns current trace states to Yes Yes N/A Page 343
controller
VAVG Turns video averaging on or off Yes Yes Yes Page 345
68
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
Table 2-1 Alphanumeric List of all Legacy Commands Showing their N9061A Support
VIEW Stores and views the specified Yes Yes Yes Page 351
trace
XCH Exchanges the two specified Yes Yes N/A Page 354
traces.
ZMKPKNL Zone marker for next peak left N/A N/A N/A
ZMKPKNR Zone marker for next peak right N/A N/A N/A
69
Legacy Analyzer Command List
Table of All Legacy Analyzer Commands
70
3 Hints and Tips
This chapter includes a list of helpful hints and tips that will help you get the most from the N9061A
application on your X-Series analyzer.
71
Hints and Tips
Hints and Tips
WARNING If the input signal to the X-series analyzer has a DC component, ensure that
when you select a legacy instrument with a possible coupling change to DC,
the input signal does not exceed the input specifications of the X-series
analyzer.
The X-series analyzers also have one RF input port. When using the X-Series analyzers, you must use
DC coupling to see calibrated frequencies of less than 20 MHz. Signals of less than 20 MHz are not
72
Hints and Tips
Hints and Tips
73
Hints and Tips
Hints and Tips
74
4 Programming Commands
This chapter lists all the supported 8560 Series, 8566A/B and 8568A/B compatible commands in
alphanumeric order, and gives brief details on their syntax and operation. For more detailed information
on these commands, see your 8566A/B, 8568A/B, 8560 Series User’s Guide.
75
Programming Commands
Command Syntax
Command Syntax
Command syntax is represented pictorially.
• Ovals enclose command mnemonics. The command mnemonic must be entered as shown with the
exception that the case can be upper or lower.
• Circles and ovals surround secondary keywords or special numbers and characters. The characters in
circles and ovals are considered reserved words and must be entered as shown with the exception that
the case can be upper or lower.
• Rectangles contain the description of a syntax element defined in Table 4-1, “Syntax Elements.”
• A loop above a syntax element indicates that the syntax element can be repeated.
• Solid lines represent the recommended path.
• Dotted lines indicate an optional path for bypassing secondary keywords or using alternate units.
• Arrows and curved intersections indicate command path direction.
• Semicolons are the recommended command terminators. Using semicolons makes programs easier to
read, prevents command misinterpretation, and is recommended by IEEE Standard 728.
NOTE Uppercase is recommended for entering all commands unless otherwise noted.
Syntax Elements are shown in the syntax diagrams as elements within rectangles. In the syntax
diagrams, characters and secondary keywords are shown within circles or ovals.
Table 4-1 Syntax Elements
Analyzer command Any analyzer command in this chapter, with required parameters and terminators.
Character SP a b c d e f g h i j k l m n o p q r s t u v w x y z databyte.
Character & EOI 8-bit byte containing only character data and followed by end-or-identify (EOI)
condition, where the EOI control line on GPIB is asserted to indicate the end of the
transmission. END signifies the EOI condition.
76
Programming Commands
Command Syntax
Data byte & EOI 8-bit byte containing numeric or character data followed by end-or-identify (EOI)
condition, where the EOI control line on GPIB is asserted to indicate the end of the
transmission. END signifies the EOI condition.
Delimiter | \ @ ˆ $ % ; ! Matching characters that mark the beginning and end of a character
string, or a list of analyzer commands. Choose delimiting characters that are not used
within the string they delimit.
Digit 0123456789
lsb length Represents the least significant byte of a two-byte word that describes the number of
bytes returned or transmitted. See msb length.
msb length Represents the most significant byte of a two-byte word that describes the number of
bytes returned or transmitted. See lsb length.
Output termination Line feed (LF) and end-or-identify (EOI) condition. ASCII code 10 (line feed) is sent
via GPIB and the end-or-identify control line on GPIB sets to indicate the end of the
transmission.
77
Programming Commands
Programming Command Descriptions
78
Programming Commands
A1 [one] Clear Write for Trace A
A1 [one]
Clear Write for Trace A
Syntax
A1 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The A1 command sets Trace A to clear write which means that it continuously displays any signal
present at the analyzer input. The A1 command initially clears Trace A, setting all elements to zero.
NOTE The functions of the command A1 are identical to the CLRW TRA command
(page 130).
79
Programming Commands
A2 [two] Maximum Hold for Trace A
A2 [two]
Maximum Hold for Trace A
Syntax
A2 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The A2 command updates each trace element with the maximum level detected during the period that the
trace has been active.
NOTE The functions of the command A2 are identical to the MXMH TRA command
(page 271).
80
Programming Commands
A3 [three] View Mode for Trace A
A3 [three]
View Mode for Trace A
Syntax
A3 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The A3 command displays Trace A and then stops the sweep if no other traces are active. Trace A does
not get updated with new data.
NOTE The functions of the command A3 are identical to the VIEW TRA command
(page 351).
81
Programming Commands
A4 [four] Blank Trace A
A4 [four]
Blank Trace A
Syntax
A4 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The A4 command blanks Trace A and stops the sweep if no other traces are active. Trace A is not
updated.
NOTE The functions of the command A4 are identical to the BLANK TRA command
(page 115).
82
Programming Commands
ACPALPHA Adjacent Channel Power Alpha Weighting
ACPALPHA
Adjacent Channel Power Alpha Weighting
Syntax
ACPALPHA SP real ;
? LF
CR
SP
Legacy Products
8560 series
Description
This command sets the alpha weighting for ACP measurements.
Range: Any real number between 0 and 1
83
Programming Commands
ACPALTCH Adjacent Channel Power Alternate Channels
ACPALTCH
Adjacent Channel Power Alternate Channels
Syntax
ACPALTCH SP 0 ;
1 LF
2
CR
?
SP
Legacy Products
8560 series
Description
The ACPALTCH command sets the number of alternate channels to be measured by an adjacent channel
power measurement to either 0, 1, or 2. The number of alternate channels is used with the ACPRSLTS
command (page 95).
Range: 0, 1, or 2.
Default value: 0.
84
Programming Commands
ACPBRPER Adjacent Channel Power Burst Period
ACPBRPER
Adjacent Channel Power Burst Period
Syntax
ACPBRPER SP real S ;
MS LF
US
CR
SC
? SP
Legacy Products
8560 series
Description
The ACPBRPER command sets the cycle time (period) of the burst RF signal. The cycle time is needed
to set the sweep times when using the peak, two bandwidth, burst power, and gated methods for adjacent
channel power measurements.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only and therefore, although the user can set ACPBRPER, it does not do
anything when in RLC mode.
85
Programming Commands
ACPBRWID Adjacent Channel Power Burst Width
ACPBRWID
Adjacent Channel Power Burst Width
Syntax
ACPBRWID SP real S ;
MS LF
US
CR
SC
? SP
Legacy Products
8560 series
Description
The ACPBRWID command sets the on-time (pulse width) of the burst RF signal. The pulse width is
needed to set the gating times when using the gated method for adjacent channel power measurements.
Range 5 μs to 9.5 seconds
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only and therefore, although the user can set ACPBRWID, it does not do
anything when in RLC mode.
86
Programming Commands
ACPBW Adjacent Channel Power Bandwidth
ACPBW
Adjacent Channel Power Bandwidth
Syntax
ACPBW SP real HZ ;
KHZ LF
MHZ
CR
GHZ
UP KZ
SP
DOWN MZ ,
GZ
Legacy Products
8560 series
Description
The ACPBW command sets the bandwidth of the channels as an active function for the ACPMEAS
(page 92) and ACPCOMPUTE (page 88) commands.
87
Programming Commands
ACPCOMPUTE Adjacent Channel Power Compute
ACPCOMPUTE
Adjacent Channel Power Compute
Syntax
ACPCOMPUTE ;
LF
CR
SP
Legacy Products
8560 series
Description
Calculates the ACP of a transmitter based on data on the display. This function does not make a new
measurement before computing. The measurement must have been made with ANALOG or PEAK
method selected so the appropriate data is available for the calculation.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
88
Programming Commands
ACPFRQWT Adjacent Channel Power Frequency Weighting
ACPFRQWT
Adjacent Channel Power Frequency Weighting
Syntax
ACPFRQWT SP RRCOS ;
OFF LF
?
CR
SP
Legacy Products
8560 series
Description
The ACPFRQWT command is used to control the frequency weighting when making an Adjacent
Channel Power measurement. Weighting is not used in the measurement if OFF has been selected.
Root-raised-cosine weighting is selected with the RRCOS parameter.
Default value: OFF
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
89
Programming Commands
ACPLOWER Lower Adjacent Channel Power
ACPLOWER
Lower Adjacent Channel Power
Syntax
ACPLOWER ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The ACPLOWER query command returns the power ratio result of the Adjacent Channel Power
measurement for the lower frequency channel.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
90
Programming Commands
ACPMAX Maximum Adjacent Channel Power
ACPMAX
Maximum Adjacent Channel Power
Syntax
ACPMAX ? ;
LF
CR
SP
The ACPMAX query command returns the maximum adjacent channel power of the adjacent channel
power measurement.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
91
Programming Commands
ACPMEAS Measure Adjacent Channel Power
ACPMEAS
Measure Adjacent Channel Power
Syntax
ACPMEAS ;
LF
CR
SP
Legacy Products
8560 series
Description
The ACPMEAS command makes a measurement and calculates the adjacent channel power (ACP) of a
transmitter. The measurement determines the leakage power that is in the channels adjacent to the
carrier. The result is the ratio of the leakage power in the channel adjacent to the total power transmitted
by the transmitter.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
92
Programming Commands
ACPMSTATE Adjacent Channel Power Measurement State
ACPMSTATE
Adjacent Channel Power Measurement State
Syntax
ACPMSTATE SP CURR ;
DFLT LF
?
CR
SP
Legacy Products
8560 series
Description
Sets the parameters of the measurement state to either the default state (determined by the setup) or the
current state. The state parameters that could change between the default state and a current state
include:
• Resolution bandwidth
• Video bandwidth
• Span
• Sweep time
• Detector mode
• Gating parameters
• Trigger parameters
• Video averaging
Default value: DFLT
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
93
Programming Commands
ACPPWRTX Adjacent Channel Power Total Power Transmitted
ACPPWRTX
Adjacent Channel Power Total Power Transmitted
Syntax
ACPPWRTX ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The ACPPWRTX query command returns the result of the total power transmitted calculation of the
adjacent channel power measurement. The measurement must be made with the analog or burst power
method selected.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
94
Programming Commands
ACPRSLTS Adjacent Channel Power Measurement Results
ACPRSLTS
Adjacent Channel Power Measurement Results
Syntax
ACPRSLTS ? ;
LF
CR
SP
Legacy Products
8560 series
Description
Returns an array of power data resulting from an ACP measurement of an RF signal. The number of
alternate channel pairs selected by the ACPALTCH (page 84) command determines the size of the array.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
95
Programming Commands
ACPSP Adjacent Channel Power Channel Spacing
ACPSP
Adjacent Channel Power Channel Spacing
Syntax
ACPSP SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
UP KZ
DOWN MZ ,
GZ
Legacy Products
8560 series
Description
Sets the channel spacing for the ACPMEAS (page 92) and ACPCOMPUTE (page 88) commands.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
96
Programming Commands
ACPT Adjacent Channel Power T Weighting
ACPT
Adjacent Channel Power T Weighting
Syntax
ACPT SP real S ;
MS LF
US
CR
SC
SP
? ,
Legacy Products
8560 series
Description
The ACPT command is used to set the T used in weighting for an adjacent channel power measurement.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
97
Programming Commands
ACPUPPER Upper Adjacent Channel Power
ACPUPPER
Upper Adjacent Channel Power
Syntax
ACPUPPER ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The ACPUPPER query command returns the power ratio result of the adjacent channel power
measurement for the upper frequency channel.
NOTE The N9061A application supports the ACP measurement using the ANALOG
method only.
98
Programming Commands
ADJALL LO and IF Adjustments
ADJALL
LO and IF Adjustments
Syntax
ADJALL ;
LF
CR
SP
Legacy Products
8560 series
Description
The ADJALL command activates the RF local oscillator (LO) and intermediate frequency (IF)
alignment routines. These are the same routines that occur when the analyzer is switched on. They are
also the same routines that are performed when you press System, Alignments, Align Now, All.
Commands following ADJALL are not executed until after the analyzer has finished the alignment
routines.
99
Programming Commands
AMB A minus B into A
AMB
A minus B into A
Syntax
AMB SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The AMB command subtracts the points in Trace B from the corresponding points in Trace A, and sends
the results to Trace A. Thus, AMB can restore the original trace after an APB (page 103) or a KSc
(page 188) command has been executed.
The query command AMB? returns different responses depending on the language being used. The 8560
Series languages return either a 1 or a 0 to indicate the On or Off status.The 8566, 8568 Series languages
all return either ON or OFF.
NOTE The functions of the command AMB are identical to the C2 [two] command
(page 120).
100
Programming Commands
AMBPL (A minus B) plus Display Line into A
AMBPL
(A minus B) plus Display Line into A
Syntax
8560 series:
AMBPL SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
8566A/B, 8568A/B:
AMBPL ;
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The AMBPL command does a point-by-point subtraction of Trace B from Trace A, and then adds the
display line point values to the difference. The results are sent to Trace A.
The query command AMBPL? returns different responses depending on the language being used.
Query response is either 1 or 0, indicating ON or OFF state for 8560 series, is ON or OFF indicating state
for 8566A/B, 8568A/B.
101
Programming Commands
ANNOT Annotation
ANNOT
Annotation
Syntax
ANNOT SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The ANNOT command turns on or off all annotation on the analyzer display. Softkey labels are not
affected by this command and remain displayed.
NOTE The functions of the command ANNOT are identical to the KSo command
(page 208) and KSp command (page 209). Note also that these two alternative
commands, KSo and KSp, are only valid when the remote language is either
HP8566A, HP8566B, HP8568A, or HP8568B.
102
Programming Commands
APB Trace A Plus Trace B to A
APB
Trace A Plus Trace B to A
Syntax
APB ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The APB command does a point-by-point addition of Trace A and Trace B, and sends the results to
Trace A. Thus, APB can restore the original trace after an AMB (page 100) or a C2 (page 120) command
has been executed.
NOTE The functions of the command APB are identical to the KSc command (page 188).
Note also that the alternative command, KSc, is only valid when the remote
language is either HP8566A, HP8566B, HP8568A, or HP8568B.
103
Programming Commands
AT Input Attenuation
AT
Input Attenuation
Syntax
8560 Series:
AT SP number DB ;
LF
SP UP
DN CR
AUTO
SP
MAN
,
OA
?
8566A/B, 8568A/B:
AT SP number DB ;
SP UP
DN
OA
?
Table 4-2
Preset State: 10 dB
Step Increment: 10 dB
104
Programming Commands
AT Input Attenuation
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the RF input attenuation.
Although the attenuation level in the X-series of analyzers can be specified using absolute values, you
can never set attenuation below 10 dB using the DOWN steps. This is a safety feature to prevent
inadvertent setting of attenuation to a level that could damage the analyzer.
NOTE In PXA/MXA, the auto attenuation range is 6-70 dB and in EXA, it is 6-60 dB.
CAUTION Signal levels above +30 dBm will damage the signal analyzer.
NOTE You cannot step down below 10 dB. To set levels below 10 dB, you must specify
the attenuation absolutely. For example, to set attenuation to 0 dB, you must use
the command AT 0DB.
105
Programming Commands
AUNITS Absolute Amplitude Units
AUNITS
Absolute Amplitude Units
Syntax
8560 series
AUNITS SP AUTO ;
MAN LF
DBM
CR
DBMV
SP
DBUV
V ,
DM
?
8566A/B, 8568A/B
AUNITS SP DBM ;
DBMV
DBUV
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the amplitude readout units for the reference level, the marker, and the display line.
NOTE If your selected remote language is any of the 8560 Series analyzers, If the
AUNITS setting is AUTO, then a change from log scale (LG) to linear scale (LN)
automatically changes the AUNITS setting. For all other settings, no change to
AUNITS occurs, even when the scale is changed.
106
Programming Commands
AUNITS Absolute Amplitude Units
NOTE The functions of the command AUNITS are identical to the commands KSA
(page 183), KSB (page 185), KSC (page 187), and KSD (page 189). Note also that
these four alternative commands, KSA, KSB, KSC, and KSD are only valid when
the remote language is either HP8566A, HP8566B, HP8568A, or HP8568B.
107
Programming Commands
AUTOCPL Auto Coupled
AUTOCPL
Auto Coupled
Syntax
AUTOCPL ;
LF
CR
SP
Legacy Products
8560 series
Description
Sets video bandwidth, resolution bandwidth, input attenuation, sweep time and center frequency
step-size to coupled mode.
108
Programming Commands
AXB Exchange Trace A and Trace B
AXB
Exchange Trace A and Trace B
Syntax
AXB ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
This command exchanges Trace A and Trace B, point by point.
NOTE The functions of the command AXB are identical to the EX command (page 155)
and to the XCH TRA,TRB command (page 354).
109
Programming Commands
B1 [one] Clear Write for Trace B
B1 [one]
Clear Write for Trace B
Syntax
B1 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The B1 command sets Trace B to clear write. That is, it continuously displays any signal present at the
analyzer input. The B1 command initially clears Trace B, setting all elements to zero. The sweep trigger
then signals the start of the sweep, and Trace B is continually updated as the sweep progresses.
Subsequent sweeps send new amplitude information to the display addresses.
NOTE The functions of the command B1 are identical to the CLRW TRB command
(page 130).
110
Programming Commands
B2 [two] Maximum Hold for Trace B
B2 [two]
Maximum Hold for Trace B
Syntax
B2 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The B2 command updates each trace element with the maximum level detected while the trace is active.
NOTE The functions of the command B2 are identical to the MXMH TRB command
(page 271).
111
Programming Commands
B3 [three] View Mode for Trace B
B3 [three]
View Mode for Trace B
Syntax
B3 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The B3 command displays Trace B and then stops the sweep if no other traces are active. Trace B does
not get updated.
NOTE The functions of the command B3 are identical to the VIEW TRB command
(page 351).
112
Programming Commands
B4 [four] Blank Trace B
B4 [four]
Blank Trace B
Syntax
B4 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The B4 command blanks Trace B and stops the sweep if no other traces are active. Trace B is not
updated.
NOTE The functions of the command B4 are identical to the BLANK TRB command
(page 115).
113
Programming Commands
BL Trace B minus Display Line to Trace B
BL
Trace B minus Display Line to Trace B
Syntax
BL ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The BL command subtracts the display line from Trace B and sends the results to Trace B.
The command BL is calculated differently depending on the language being used; for the 8560 Series the
calculation is performed in units of dBm.
8560 Series The calculation is performed in units of dBm.
8566A The calculation is performed in display units.
8566B The calculation is performed in display units.
8568A The calculation is performed in display units.
8568B The calculation is performed in display units.
NOTE The functions of the command BL are identical to the BML command (page 116).
114
Programming Commands
BLANK Blank Trace
BLANK
Blank Trace
Syntax
8560 Series:
BLANK SP TRA ;
TRB LF
CR
SP
8566A/B, 8568A/B:
BLANK SP TRA ;
TRB
TRC
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Blanks Trace 1 or trace 2 and stops taking new data into the specified trace. TRA corresponds to Trace 1
and TRB corresponds to Trace 2.
For information on the trace settings of the X-series analyzers, see Table 4-4, “Legacy Products
command mapping to X-series for trace/detector settings.”
NOTE The functions of the command BLANK are identical to A4 (page 82), B4
(page 113) or KSJ, and KSk command (page 200) command.
115
Programming Commands
BML Trace B Minus Display Line
BML
Trace B Minus Display Line
Syntax
BML ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The BML command subtracts the display line from trace B (point by point), and sends the difference to
trace B. Trace B corresponds to Trace 2.
The command BML is calculated differently depending on the language being used; for the 8560 Series
the calculation uses units of dBm.
For the 8566A, HP8566B, HP8568A, HP8568B - the BML command uses display units.
NOTE The functions of the command BML are identical to the BL command (page 114).
116
Programming Commands
BTC Transfer Trace B to Trace C
BTC
Transfer Trace B to Trace C
Syntax
BTC ;
Legacy Products
8566A/B, 8568A/B
Description
The BTC command transfers Trace B data to Trace C
NOTE Trace C cannot be an active trace. This means that the data in Trace C cannot be
updated as the analyzer sweeps. To ensure that the current settings of the analyzer
are reflected in the data transferred from Trace B to Trace C, you must follow the
four step process below.
• Select single sweep mode (S2 or SNGLS command)
• Select the desired analyzer settings
• Take one complete sweep
• Transfer the data
NOTE The functions of the command BTC are identical to the KSl command (page 202).
117
Programming Commands
BXC Exchange Trace B and Trace C
BXC
Exchange Trace B and Trace C
Syntax
BXC ;
Legacy Products
8566A/B, 8568A/B
Description
The BXC command exchanges Trace B data with Trace C data.
NOTE Trace C must not be an active trace. This means that the data in Trace C cannot be
updated as the analyzer sweeps. To ensure that the current settings of the analyzer
are reflected in the data exchanged between Trace B and Trace C, you must follow
the four step process below.
• Select single sweep mode (S2 or SNGLS command)
• Select the desired analyzer settings
• Take one complete sweep
• Exchange the data
NOTE The functions of the command BXC are identical to the KSi command (page 197)
and to the XCH TRB,TRC command (page 354).
118
Programming Commands
C1 [one] Set A Minus B Mode Off
C1 [one]
Set A Minus B Mode Off
Syntax
C1 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The C1 command turns the A Minus B mode off. That is, it switches off the functionality that was
switched on by the C2 command (page 120) or by the AMB ON command (page 100).
NOTE The functions of the command C1 are identical to the AMB OFF command
(page 100).
119
Programming Commands
C2 [two] A Minus B Into A
C2 [two]
A Minus B Into A
Syntax
C2 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The C2 command subtracts the points in Trace B from the corresponding points in Trace A, and sends
the results to Trace A. Thus, if your input signal remains unchanged, C2 can restore the original trace
after an APB command (page 103) or a KSc (page 188) command has been executed.
NOTE The functions of the command C2 are identical to the AMB ON command
(page 100).
120
Programming Commands
CA Couple Attenuation
CA
Couple Attenuation
Syntax
CA ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
During normal operation, the analyzer’s input attenuation is coupled to the reference level. This coupling
keeps the mixer input at a level such that a continuous wave signal displayed at the reference level is at
or below -10 dBm (or the value specified in the ML command.)
The CA command sets the threshold to -10 dBm (or to the value specified by the ML command
(page 267) or the KS, command (page 179)). The counterpart to the CA command is the AT command
(page 104), which allows levels less than the threshold value at the mixer input.
121
Programming Commands
CARROFF Carrier Off Power
CARROFF
Carrier Off Power
Syntax
CARROFF SP TRA , ? ;
TRB LF
CR
SP
Legacy Products
8560 series
Description
Measures the average and peak power of the carrier during the portion of time when the power is off
(when it is not within 20 dB of its peak level). The powers are combined to provide a calculation of the
leakage power.
The measurement needs to be in zero span for the measurement to run.
122
Programming Commands
CARRON Carrier On Power
CARRON
Carrier On Power
Syntax
CARRON SP TRA , ? ;
TRB LF
CR
SP
Legacy Products
8560 series
Description
Measures the average power of the carrier during the portion of time when it is on and within 20 dB of its
peak level.
The measurement needs to be in zero span for the measurement to run.
123
Programming Commands
CF Center Frequency
CF
Center Frequency
Syntax
CF SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
SP UP
DN
OA
?
Table 4-3
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The CF command specifies the value of the center frequency.
The step size depends on whether the frequency has been coupled to the span width using the CS
command (page 135). When coupled, the step size is 10% of the span, or one major graticule division;
when uncoupled, the step size is determined by the SS command (page 317).
NOTE Although the analyzer allows entry of frequencies not in the specified frequency
range, using frequencies outside the frequency span of the analyzer is not
124
Programming Commands
CF Center Frequency
125
Programming Commands
CHANNEL Channel Selection
CHANNEL
Channel Selection
Syntax
CHANNEL SP UP ;
DN LF
CR
SP
Legacy Products
8560 series
Description
Increments or decrements the analyzer center frequency by one channel spacing.
NOTE The channel spacing value is set using the ACPSP command (page 96).
126
Programming Commands
CHANPWR Channel Power
CHANPWR
Channel Power
Syntax
CHANPWR SP TRA , real HZ , ? ;
TRB KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
Legacy Products
8560 series
Description
Measures the power within the specified channel bandwidth.
127
Programming Commands
CHPWRBW Channel Power Bandwidth
CHPWRBW
Channel Power Bandwidth
Syntax
CHPWRBW SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
Legacy Products
8560 series
Description
Queries or sets the current value of the channel power bandwidth. Channel power can be measured with
the CHANPWR command (page 127).
128
Programming Commands
CLRAVG Clear Average
CLRAVG
Clear Average
Syntax
CLRAVG ;
Legacy Products
8566A/B, 8568A/B
Description
The CLRAVG command restarts the VAVG command by resetting the number of averaged sweeps to
one. The video averaging routine resets the number of sweeps, but does not stop video averaging. Use
"VAVG OFF;" to stop video averaging.
129
Programming Commands
CLRW Clear Write
CLRW
Clear Write
Syntax
CLRW SP TRA ;
TRB
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Clears the specified trace and enables trace data acquisition. The CLRW command places the indicated
trace in clear-write mode. Data acquisition begins at the next sweep. (See the TS command (page 344)
for more information about data acquisition.)
TRA corresponds to Trace 1 and TRB corresponds to Trace 2.
NOTE The functions of the command CLRW are identical to the A1 command (page 79)
and B1 command (page 110).
On the 8560 series, 8566A/B, and 8568A/B analyzers the trace settings are set by the trace mode
parameters, CLRW, VIEW, BLANK, MINH and MAXH and the averaging settings by VAVG. On the
X-series the same settings are set in the Trace/Detector and View/Blank parameters. The following table
describes what the N9061A application sets in the X-series box when the legacy commands for trace
mode and averaging are sent.
130
Programming Commands
CLRW Clear Write
Table 4-4 Legacy Products command mapping to X-series for trace/detector settings
For example if the 8560 series sends CLRW and the averaging is set to ON, the 8560 series analyzer
detector is automatically set to Sample. The N9061A application sets the X-series instrument trace type
to Trace Average, View/Blank to On and the Detector to Sample.
131
Programming Commands
CONTS Continuous Sweep
CONTS
Continuous Sweep
Syntax
CONTS ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The CONTS command sets the analyzer to continuous sweep mode. In the continuous sweep mode, the
analyzer takes its next sweep as soon as possible after the current sweep (as long as the trigger conditions
are met). A sweep may temporarily be interrupted by data entries made over the remote interface or from
the front panel.
NOTE The functions of the command CONTS are identical to the S1 command
(page 306).
132
Programming Commands
COUPLE Input Coupling
COUPLE
Input Coupling
Syntax
COUPLE SP AC ;
DC LF
?
CR
SP
Legacy Products
8560 series
Description
The COUPLE command selects AC or DC coupling.
NOTE When using the X-series analyzers, you must use DC coupling to see calibrated
frequencies of less than 20 MHz. Signals of less than 20 MHz are not calibrated
when using AC coupling on these analyzers.
133
Programming Commands
CR Couple Resolution Bandwidth
CR
Couple Resolution Bandwidth
Syntax
CR ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The CR command couples the resolution bandwidth to the span.
The counterpart to the CR command is the RB command (page 295) which breaks the coupling. Use the
CR command to re-establish coupling after executing an RB command.
NOTE CR uses the legacy instrument settings for resolution bandwidth only if Mode
Setup > Preferences> Limit RBW/VBW is set to ON.
134
Programming Commands
CS Couple Frequency Step Size
CS
Couple Frequency Step Size
Syntax
CS ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The CS command couples the center frequency step size to the span width so that the step size equals
10% of the span width, or one major graticule division.
The counterpart to the CS command is the SS command (page 317) which breaks the coupling. Use the
CS command to re-establish coupling after an SS command has been executed.
135
Programming Commands
CT Couple Sweep Time
CT
Couple Sweep Time
Syntax
CT ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The CT command couples the sweep time to the span, resolution bandwidth and video bandwidth.
The counterpart to the CT command is the ST command (page 318) which breaks the coupling. Use the
CT command to re-establish coupling after an ST command has been executed.
136
Programming Commands
CV Couple Video Bandwidth
CV
Couple Video Bandwidth
Syntax
CV ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The CV command couples the video bandwidth to the resolution bandwidth.
The counterpart to the CV command is the VB command (page 347) which breaks the coupling. Use the
CV command to re-establish coupling after executing a VB command.
NOTE CV uses the legacy signal analyzer settings for video bandwidth only if Mode
Setup > Preferences> Limit RBW/VBW is set to ON.
137
Programming Commands
DA Display Address
DA
Display Address
Syntax
DA SP number ;
Legacy Products
8566A/B, 8568A/B
Description
The DA command returns the contents of the given display address to the controller
NOTE This command only supports the use of the DA 1, DA 1025, and DA 3073; these
display addresses contain the trace data and are equivalent to using the commands
TRA? (page 338), TRB? (page 339), TRC? (page 340), TA (page 330) and TB
(page 331).
138
Programming Commands
DELMKBW Occupied Power Bandwidth Within Delta Marker
DELMKBW
Occupied Power Bandwidth Within Delta Marker
Syntax
DELMKBW SP TRA , real , ? ;
TRB LF
CR
SP
Legacy Products
8560 series
Description
Calculates the OBW with respect to the power between the displayed delta markers. The power between
the displayed markers is then used as the reference, rather than using the total power in the frequency
span as is done in the PWRBW (page 290) command.
If the DELMKBW command is used when no marker is active, a delta marker is activated at the center
frequency, and the returned bandwidth is 0. If the active marker is a normal marker when the
DELMKBW command is used, the marker type is changed to delta, and the returned bandwidth is 0.
139
Programming Commands
DET Detection Mode
DET
Detection Mode
Syntax
DET SP POS ;
SMP LF
NEG
CR
NRM
SP
?
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The DET command selects the type of analyzer detection (positive-peak, negative peak, sample, normal,
and so on).
POS enables positive-peak detection, which displays the maximum video signal detected
over a number of instantaneous samples for a particular frequency.
SMP enables sample detection, which uses the instantaneous video signal value. Video
averaging and noise-level markers, when activated, activate sample detection
automatically.
NEG enables negative peak detection.
NRM enables the ‘rosenfell’ detection algorithm that selectively chooses between positive
and negative values.
NOTE The functions of the DET command are identical to the KSa command (page 184),
the KSb command (page 186), the KSd command (page 190), and the KSe
command (page 192).
140
Programming Commands
DL Display Line
DL
Display Line
Syntax
8560 series:
DL SP number DB ;
DBM LF
SP UP DBMV
CR
DN DBUV
SP
OFF MV
ON UV ,
MW
UW
DM
8566A/B, 8568A/B:
DL SP number ;
UP
DN
OA
141
Programming Commands
DL Display Line
Table 4-5
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Defines the level of the display line and displays it on the analyzer screen.
142
Programming Commands
DLE Display Line Enable
DLE
Display Line Enable
Syntax
DLE SP ON ;
OFF
Legacy Products
8566A/B, 8568A/B
Description
Enables or disables the display line.
143
Programming Commands
DLYSWP Delay Sweep
DLYSWP
Delay Sweep
Syntax
DLYSWP SP number US ;
MS LF
SC
CR
S
SP ON SP
OFF
,
SP 1
Legacy Products
8560 series
Description
Delays the start of the sweep until the specified time after the trigger event has elapsed.
144
Programming Commands
DONE Done
DONE
Done
Syntax
DONE ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Allows you to determine when the analyzer has parsed a list of analyzer commands and has executed all
commands prior to and including DONE. The DONE command returns a value of “1” when all
commands in a command string or command list have been completed.
If a take sweep (TS command (page 344)) precedes the command list, the TS command acts as a
synchronizing function since the command list execution begins after the sweep has been completed.
145
Programming Commands
DR Display Read
DR
Display Read
Syntax
DR ;
Legacy Products
8566A/B, 8568A/B
Description
The DR command sends the contents of the current display address to the controller.
146
Programming Commands
E1[one] Peak Marker
E1[one]
Peak Marker
Syntax
E1 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The E1 command positions the marker at the signal peak.
NOTE The functions of the E1 command are identical to MKPK (no secondary keyword)
and MKPK HI (page 255).
147
Programming Commands
E2 [two] Marker to Center Frequency
E2 [two]
Marker to Center Frequency
Syntax
E2 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The E2 command positions the marker on the screen at the center frequency position.
NOTE Unlike MKCF (page 244), which moves the CF to the current position of the active
marker, the function of E2 centers the active marker to the center frequency on the
analyzer screen.
148
Programming Commands
E3 [three] Delta Marker Step Size
E3 [three]
Delta Marker Step Size
Syntax
E3 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The E3 command establishes the center frequency step size as being the frequency difference between
the delta marker and the active marker.
NOTE The functions of the E3 command are identical to the MKSS command (page 262).
149
Programming Commands
E4 [four] Marker to Reference Level
E4 [four]
Marker to Reference Level
Syntax
E4 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The E4 command moves the active marker to the reference level.
NOTE Unlike MKRL (page 260), which moves to the level of the delta Marker when in
delta Maker mode.
150
Programming Commands
EDITDONE Edit Done
EDITDONE
Edit Done
Syntax
EDITDONE ;
LF
CR
SP
Legacy Products
8560 series
Description
This command is used at the completion of limit-line editing within the EDITLIML command.
During the limit line commands beginning with EDITLIML and ending with EDITDONE, you can enter
the limit line data.
151
Programming Commands
ERR Error
ERR
Error
Syntax
ERR ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The ERR command returns a list of three-digit error codes if errors are present. A code of “0” means that
there are no errors present. Executing ERR? clears all GPIB errors.
If a command is a valid legacy command but not accepted by the N9061A application, no error message
is generated and the response to ERR? is 0. However, if logging is enabled, the N9061A application
command log registers a “Cmd not Supported” error.
If a command is not a valid legacy command, a command error is generated; CMD ERR is displayed on
the front panel and the response to ERR? is 112. If logging is enabled then Cmd Error is written to the
command error log.
Table 4-6
Error codes are provided in RLC mode for some X-series errors such as external reference, hardware and
alignment errors. The X-series error codes are translated to 8560 series error codes so that an error query
returns the legacy instrument error code. To review the error via the front panel, select the System
hardkey and then select Show > Errors. The following table shows the X-series error codes and the
translated value.
152
Programming Commands
ERR Error
Table 4-7
503 Frequency Reference 336 10 MHz Ref Cal oscillator failed to lock
Unlocked when going to internal 10 MHz
reference.
505 2nd LO Unlocked 336 10 MHz Ref Cal oscillator failed to lock
when going to internal 10 MHz
reference.
515 Calibration Oscillator 336 10 MHz Ref: Cal oscillator failed to lock
Unlocked when going to internal 10 MHz
reference
521 External Ref missing or 905,333 EXT REF: Unable to lock cal oscillator
out of range when set to external reference. Check
that the external reference is within
tolerance.
600 UNLK: 600 MHz reference
oscillator PLL is unlocked
153
Programming Commands
ET Elapsed Time
ET
Elapsed Time
Syntax
ET ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The ET command returns to the controller the elapsed time (in hours) of analyzer operation.
154
Programming Commands
EX Exchange Trace A and Trace B
EX
Exchange Trace A and Trace B
Syntax
EX ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
This command exchanges Trace A and Trace B, point by point.
NOTE The functions of the EX command are identical to the AXB command
(page 109)and to the XCH TRA,TRB command (page 354).
155
Programming Commands
FA Start Frequency
FA
Start Frequency
Syntax
FA SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
SP UP
DN
OA
?
Table 4-8
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The FA command specifies the start frequency value. The start frequency is equal to the center
frequency minus (the span divided by two) (FA = CF − SP/2). Changing the start frequency changes the
center frequency and span.
NOTE The OA parameter only returns the current value to the controller. It does not set
the active function to the start frequency.
156
Programming Commands
FB Stop Frequency
FB
Stop Frequency
Syntax
FB SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
SP UP
DN
OA
?
Table 4-9
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The FB command specifies the stop frequency value. The stop frequency is equal to the center frequency
plus the span divided by two (FB = CF + SP/2). Changing the stop frequency changes the center
frequency and span.
NOTE The OA parameter only returns the current value to the controller. It does not set
the active function to the stop frequency.
157
Programming Commands
FDSP Frequency Display Off
FDSP
Frequency Display Off
Syntax
FDSP SP OFF ;
? LF
CR
SP
Legacy Products
8560 series
Description
The FDSP command turns the frequency annotation OFF.
NOTE It is not possible enable or disable the frequency annotation alone, leaving other
annotation unaffected. Thus, the FDSP command behaves in the same way as
ANNOT (page 102) If the FDSP command has been used to disable the frequency
annotation, sending the ANNOT ON command does not re-enable the display
annotation. The display annotation is only displayed by sending the IP (page 178)
command.
158
Programming Commands
FOFFSET Frequency Offset
FOFFSET
Frequency Offset
Syntax
FOFFSET SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
SP UP
DN
OA
?
Table 4-10
Preset State: 0 Hz
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The FOFFSET command selects a value that offsets the frequency scale for all absolute frequency
readouts (for example, center frequency). Relative values such as span and marker delta are not offset.
When an offset is in effect, it is displayed beneath the bottom graticule line on the analyzer screen.
Execute “FOFFSET 0;” or “IP;” to turn off the offset.
159
Programming Commands
FOFFSET Frequency Offset
NOTE The functions of the FOFFSET command are identical to the KSV command
(page 211).
160
Programming Commands
FPKA Fast Preselector Peak
FPKA
Fast Preselector Peak
Syntax
FPKA ;
LF
CR
SP
Legacy Products
8566A/B
Description
The FPKA command automatically adjusts the preselector frequency to yield the greatest signal level at
the active marker. The FPKA command peaks the preselector faster than the preselector-peak command,
PP Although this command can be executed in all frequency spans, it performs best when the instrument
is in zero span. Use the standard preselector peak for all other frequency spans. The FPKA command
also returns the amplitude value of active marker.
161
Programming Commands
FREF Frequency Reference
FREF
Frequency Reference
Syntax
FREF SP INT ;
EXT LF
?
CR
SP
Legacy Products
8560 series
Description
The FREF command specifies whether an external source or an internal source is being used.
162
Programming Commands
FS Full Span
FS
Full Span
Syntax
FS ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
8560 series: The FS command sets the frequency span of the analyzer to full span. Resolution
bandwidth, video bandwidth, and sweep time are all set to auto-coupled.
8566A/B, 8568A/B: The FS command does an instrument preset, then sets the low band.
NOTE The functions of the FS command are identical to the LF command (page 216).
NOTE Whenever the frequency range of the analyzer you are using does not match the
remote language’s own range, the span is limited by the capabilities of the
replacement analyzer. The tables on the following pages list the frequency ranges
for all the supported remote languages when running on any of Agilent’s X-series
analyzers.
163
Programming Commands
FS Full Span
Remote
Frequency Range Frequency Range Frequency Range Frequency Range
Language
Remote
Frequency Range Frequency Range Frequency Range Frequency Range
Language
164
Programming Commands
FS Full Span
Remote
Frequency Range Frequency Range Frequency Range Frequency Range
Language
165
Programming Commands
GATE Gate
GATE
Gate
Syntax
GATE SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
Legacy Products
8560 series
Description
Turns the time-gating function on or off. When the time-gating function is turned on, the analyzer
activates the time gate circuitry according to the parameters controlled by gate length (GL), gate delay
(GD) and the gate trigger input.
The query command GATE? returns different responses depending on the language being used.
8560 Series Query response is either 1 or 0, indicating ON or OFF state.
166
Programming Commands
GATECTL Gate Control
GATECTL
Gate Control
Syntax
GATECTL SP EDGE ;
LEVEL LF
?
CR
SP
Legacy Products
8560 series
Description
Selects between the edge and level mode for time gate function. In the edge mode, a specified trigger
edge starts the gate delay timer that in turn starts the gate length timer. In the level mode, the gate follows
the trigger input level. The gate delay timer (GD) and the gate time length (GL) are operational in the
edge mode, but not in the level mode.
167
Programming Commands
GD Gate Delay
GD
Gate Delay
Syntax
GD SP real US ;
MS LF
SC
CR
S
SP
SP UP
,
DN
OA
?
Preset State: 3 μs
Legacy Products
8560 series
Description
Sets the delay time from when the gate trigger occurs to when the gate is turned on. GD only applies if
GATECTL is set to EDGE.
168
Programming Commands
GL Gate Length
GL
Gate Length
Syntax
GL SP real US ;
MS LF
SC
CR
S
SP
SP UP
,
DN
OA
?
Preset State: 1 μs
Legacy Products
8560 series
Description
Sets the length of time the time gate is turned on. GL only applies if GATECTL is set to EDGE.
169
Programming Commands
GP Gate Polarity
GP
Gate Polarity
Syntax
GP SP NEG ;
POS LF
?
CR
SP
Legacy Products
8560 series
Description
Sets the polarity (positive or negative) for the gate trigger. If the gate control (GATECTL) is in the edge
mode, the gate delay timer can be triggered on either a positive or negative edge of the trigger input. If
the gate control is in level mode and positive is selected, the gate is on when the trigger input is high. If
the gate control is in level mode and negative is selected, the gate is on when the trigger is low.
170
Programming Commands
GRAT Graticule
GRAT
Graticule
Syntax
GRAT SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Turns the graticule on or off.
NOTE The functions of the GRAT command are identical to the KSm command
(page 204) and the KSn command (page 206).
The query command GRAT? returns different responses depending on the language being used.
8560 Series For Phoenix2 cut sentence above and paste here
8566A Query response is either ON or OFF.
8566B Query response is either ON or OFF.
8568A Query response is either ON or OFF.
8568B Query response is either ON or OFF.
171
Programming Commands
HD Hold Data Entry
HD
Hold Data Entry
Syntax
HD ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Disables data entry via the analyzer numeric keypad, knob, or step keys. The active function readout is
blanked, and any active function is deactivated.
172
Programming Commands
I1 [one] Set RF Coupling to DC
I1 [one]
Set RF Coupling to DC
Syntax
I1 ;
LF
CR
SP
Legacy Products
8568A/B
Description
The I1 [one] command sets the RF coupling to DC.
The tables below list the frequency specifications for all X-Series analyzers for both DC and AC
coupling.
Table 4-14 8568A/B Analyzer Frequency Coupling Specifications
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9010A)
173
Programming Commands
I1 [one] Set RF Coupling to DC
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9010A)
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9020A)
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9030A)
174
Programming Commands
I2 [two] Set RF Coupling to AC
I2 [two]
Set RF Coupling to AC
Syntax
I2 ;
LF
CR
SP
Legacy Products
8568A/B
Description
The I2 [two] command sets the RF coupling to AC.
The tables below list the frequency specifications for all X-Series analyzers for both DC and AC
coupling.
Table 4-18 8568A/B Analyzer Frequency Coupling Specifications
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9010A)
175
Programming Commands
I2 [two] Set RF Coupling to AC
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9010A)
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9020A)
Analyzer Model Min. Freq. Max. Freq. Min. Freq. Max. Freq.
(N9030A)
176
Programming Commands
ID Identify
ID
Identify
Syntax
ID ? ;
SP OA LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The ID command returns the current remote language to the controller (for example, “HP8563E”).
The response value is determined by your remote language selection. This is configured via the
front-panel menu selection in Mode Setup when in RLC mode. The remote language selection can also
be set using the SCPI command SYSTem:LANGuage.
ID? also works when you are not in RLC mode. In this case the instrument model number is returned.
The string that is returned is identical to the second field of text that is returned from the *IDN?
command.
For more information see:
“Setting up N9061A on the X-Series Analyzer” on page 27
“Running Software that Requires SCPI Commands” on page 38
177
Programming Commands
IP Instrument Preset
IP
Instrument Preset
Syntax
IP ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Performs an instrument preset, setting the analyzer back to its factory settings. IP does not affect the
contents of any data or trace registers or stored preselector data. IP does not clear the input or output data
buffers on the 8560-series analyzers, but does clear them on the 8566A/B, 8568A/B.
Instrument preset automatically occurs when you turn on the analyzer. IP is a good starting point for
many measurement processes. When IP is executed remotely, the analyzer does not necessarily execute a
complete sweep, however. You should execute a take sweep (TS) to ensure that the trace data is valid
after an IP.
The N9061A application executes this command after any language switch on the X-Series analyzer.
NOTE The functions of the IP command are identical to the KST command (page 210).
NOTE If the external amplifier gain has been set, executing an IP command does not reset
this value. This is to protect the analyzer.
178
Programming Commands
KS, Mixer Level
KS,
Mixer Level
Syntax
KS, SP real DM ;
MV
UV
OA
?
Legacy Products
8566A/B, 8568A/B
Description
The KS, command specifies the maximum signal level that is applied to the input mixer for a signal that
is equal to or below the reference level.
The effective mixer level is equal to the reference level minus the input attenuator setting. When KS, is
activated, the effective mixer level can be set from -10 dBm to -70 dBm in 10 dB steps.
As the reference level is changed, the coupled input attenuator automatically changes to limit the
maximum signal at the mixer input to your specified setting for signals less than or equal to the reference
level.
NOTE If the external amplifier gain has been set, executing an IP command will not reset
this value. This is to protect the analyzer.
NOTE The functions of the KS, command are identical to the ML command (page 267).
179
Programming Commands
KS= 8566A/B: Automatic Preselector Tracking 8568A/B: Marker Counter Resolution
KS=
8566A/B: Automatic Preselector Tracking
8568A/B: Marker Counter Resolution
Syntax
KS= SP real HZ ;
KZ
MZ
GZ
Legacy Products
8566A/B, 8568A/B
Description
8566A/B: Use the KS= command to reinstate automatic preselector tracking after KS/ has been
executed. Normally, the center of the preselector filter automatically tracks signal responses in the four
frequency bands of the 2 to 22 GHz range.
The KS/ command allows manual adjustment of the preselector tracking and the X-Series analyzers can
swallow this command with no action.
8568A/B: Specifies the resolution of the marker frequency counter.
NOTE For 8568A/B, the functions of the KS= command are identical to the MKFCR
command (page 248).
180
Programming Commands
KS( Lock Registers
KS(
Lock Registers
Syntax
KS( ;
Legacy Products
8566A/B, 8568A/B
Description
The KS( command secures the contents of registers one through six. When the registers are secured, the
SV and SAVE commands cannot save more instrument states in the registers, but instead write "SAVE
LOCK" on the analyzer display. To save an instrument state in a locked register, first execute KS) to
unlock the registers.
The recall function of the analyzer is not affected by this function.
181
Programming Commands
KS) Unlock Registers
KS)
Unlock Registers
Syntax
KS) ;
Legacy Products
8566A/B, 8568A/B
Description
The KS) command unlocks the registers where instrument states are stored with SV and SAVE
commands.
182
Programming Commands
KSA Amplitude in dBm
KSA
Amplitude in dBm
Syntax
KSA ;
Legacy Products
8566A/B, 8568A/B
Description
The KSA command sets the amplitude readout (reference level, marker, display line and threshold) to
dBm units.
NOTE The functions of the KSA command are identical to the AUNITS DBM command
(page 106).
183
Programming Commands
KSa Normal Detection
KSa
Normal Detection
Syntax
KSa ;
Legacy Products
8566A/B, 8568A/B
Description
The KSa command selects normal input detection. That is, it enables the ‘rosenfell’ detection algorithm
that selectively chooses between positive and negative values.
NOTE The functions of the KSa command are identical to the DET NRM command
(page 140).
184
Programming Commands
KSB Amplitude in dBmV
KSB
Amplitude in dBmV
Syntax
KSB ;
Legacy Products
8566A/B, 8568A/B
Description
The KSB command sets the amplitude readout (reference level, marker, display line and threshold) to
dBmV units.
NOTE The functions of the KSB command are identical to the AUNITS DBMV
command (page 106).
185
Programming Commands
KSb Positive Peak Detection
KSb
Positive Peak Detection
Syntax
KSb ;
Legacy Products
8566A/B, 8568A/B
Description
The KSb command enables positive peak input detection for displaying trace information. Trace
elements are only updated when the detected signal level is greater than the previous signal level.
NOTE The functions of the KSb command are identical to the DET POS command
(page 140).
186
Programming Commands
KSC Amplitude in dBuV
KSC
Amplitude in dBuV
Syntax
KSC ;
Legacy Products
8566A/B, 8568A/B
Description
The KSC command sets the amplitude readout (reference level, marker, display line and threshold) to
dBuV units.
NOTE The functions of the KSC command are identical to the AUNITS DBUV command
(page 106).
187
Programming Commands
KSc A Plus B to A
KSc
A Plus B to A
Syntax
KSc ;
Legacy Products
8566A/B, 8568A/B
Description
The KSc command does a point-by-point addition of Trace A and Trace B, and sends the results to Trace
A. Thus, if your input signal remains unchanged, KSc can restore the original trace after an AMB or a C2
command has been executed.
NOTE The functions of the command KSc are identical to the APB command (page 103).
188
Programming Commands
KSD Amplitude in Volts
KSD
Amplitude in Volts
Syntax
KSD ;
Legacy Products
8566A/B, 8568A/B
Description
The KSD command sets the amplitude readout (reference level, marker, display line and threshold) to
voltage units.
NOTE The functions of the KSD command are identical to the AUNITS V command
(page 106).
189
Programming Commands
KSd Negative Peak Detection
KSd
Negative Peak Detection
Syntax
KSd ;
Legacy Products
8566A/B, 8568A/B
Description
The KSd command selects negative-peak input detection for displaying trace information. Each trace
element is updated with the minimum value detected during the sweep.
NOTE The functions of the command KSd are identical to the DET NEG command
(page 140).
190
Programming Commands
KSE Title Mode
KSE
Title Mode
Syntax
Legacy Products
8566A/B, 8568A/B
Description
The KSE command activates the title mode, writing a message to the top line of the display.
NOTE The only characters that the N9061A application accepts as a terminator are the
‘@’ character and the carriage return.
191
Programming Commands
KSe Sample Detection
KSe
Sample Detection
Syntax
KSe ;
Legacy Products
8566A/B, 8568A/B
Description
The KSe command selects sample input detection for displaying trace information.
NOTE The functions of the command KSe are identical to the DET SMP command
(page 140).
192
Programming Commands
KSG Video Averaging On
KSG
Video Averaging On
Syntax
average
KSG SP
length
;
ON
OA
Legacy Products
8566A/B, 8568A/B
Description
The KSG command enables video averaging. The averaged trace is displayed in Trace A.
If video averaging is off when either KSG? or KSG OA is sent to the instrument, video averaging is
turned on and the current average count is returned to the controller.
NOTE The functions of the KSG command are identical to the VAVG ON command
(page 345).
193
Programming Commands
KSg Display Off
KSg
Display Off
Syntax
KSg ;
Legacy Products
8566A/B, 8568A/B
Description
The KSg command turns the analyzer’s display Off.
NOTE On the legacy spectrum analyzers, this command turned the CRT beam power off
to avoid unnecessary wear on the CRT. Although this command is supported,
displays used on the X-Series analyzers have a much longer life than the CRTs
used in the legacy spectrum analyzers.
194
Programming Commands
KSH Video Averaging Off
KSH
Video Averaging Off
Syntax
KSH ;
Legacy Products
8566A/B, 8568A/B
Description
The KSH command switches video averaging Off.
NOTE The functions of the KSH command are identical to the VAVG OFF command
(page 345).
195
Programming Commands
KSh Display On
KSh
Display On
Syntax
KSh ;
Legacy Products
8566A/B, 8568A/B
Description
The KSh command turns the analyzer’s display On.
NOTE On the early models of spectrum analyzers, CRT beam power was often switched
Off to prevent wear of the CRT. This command (KSh) was used to turn the CRT
beam power on again. Although this command is supported, displays used on the
X-Series analyzers have a much longer life than the CRTs used in the legacy
spectrum analyzers.
196
Programming Commands
KSi Exchange Trace B and Trace C
KSi
Exchange Trace B and Trace C
Syntax
KSi ;
Legacy Products
8566A/B, 8568A/B
Description
The KSi command exchanges Trace B data with Trace C data.
NOTE Trace C cannot be an active trace. This means that the data in Trace C cannot be
updated as the analyzer sweeps. To ensure that the current settings of the analyzer
are reflected in the data exchanged between Trace B and Trace C, you must follow
the four step process below.
• Select single sweep mode (S2 (page 307) or SNGLS command (page 313))
• Select the desired analyzer settings
• Take one complete sweep using the TS command (page 344)
• Exchange the data
NOTE The functions of the command KSi are identical to the BXC command (page 118)
and the XCH TRB,TRC command (page 354).
197
Programming Commands
KSj View Trace C
KSj
View Trace C
Syntax
KSj ;
Legacy Products
8566A/B, 8568A/B
Description
The KSj command displays Trace C.
NOTE The functions of the command KSj are identical to the VIEW TRC command
(page 351).
198
Programming Commands
KSK Marker to Next Peak
KSK
Marker to Next Peak
Syntax
KSK ;
Legacy Products
8566A/B, 8568A/B
Description
If there is a marker on the screen, the KSK command moves this marker to the next signal peak of lower
amplitude.
NOTE The functions of the KSK command are similar to the MKPK NH command
(page 255), except that KSK does not take into account the marker peak threshold
value or the marker peak excursion value. For more details on marker peak
threshold, see the MKPT command (page 256) and the TH command (page 333).
For more details on marker peak excursion, see the MKPX command (page 257).
199
Programming Commands
KSk Blank Trace C
KSk
Blank Trace C
Syntax
KSk ;
Legacy Products
8566A/B, 8568A/B
Description
The KSj command blanks Trace C.
NOTE The functions of the command KSk are identical to the BLANK TRC command
(page 115))
200
Programming Commands
KSL Marker Noise Off
KSL
Marker Noise Off
Syntax
KSL ;
Legacy Products
8566A/B, 8568A/B
Description
The KSL command disables the noise density function which displays the RMS noise density at the
marker. KSL does not blank the marker.
NOTE The functions of the KSL command are identical to the MKNOISE OFF command
(page 252).
201
Programming Commands
KSl Transfer Trace B to Trace C
KSl
Transfer Trace B to Trace C
Syntax
KSl ;
Legacy Products
8566A/B, 8568A/B
Description
The KSl command transfers Trace B data to Trace C
NOTE Trace C cannot be an active trace. This means that the data in Trace C cannot be
updated as the analyzer sweeps. To ensure that the current settings of the analyzer
are reflected in the data transferred from Trace B to Trace C, you must follow the
four step process below.
• Select single sweep mode (S2 (page 307) or SNGLS command (page 313))
• Select the desired analyzer settings
• Take one complete sweep using the TS command (page 344)
• Transfer the data
NOTE The functions of the command KSl are identical to the BTC command (page 117).
202
Programming Commands
KSM Marker Noise On
KSM
Marker Noise On
Syntax
KSM ;
?
OA
Legacy Products
8566A/B, 8568A/B
Description
The KSM command displays the noise density at the marker. The noise density is normalized to a 1Hz
bandwidth.
NOTE The functions of the KSM command are identical to the MKNOISE ON command
(page 252).
203
Programming Commands
KSm Graticule Off
KSm
Graticule Off
Syntax
KSm ;
Legacy Products
8566A/B, 8568A/B
Description
The KSm command blanks the graticule on the analyzer display.
NOTE The functions of the command KSm are identical to the GRAT OFF command
(page 171).
204
Programming Commands
KSN Marker Minimum
KSN
Marker Minimum
Syntax
KSN ;
Legacy Products
8566A/B, 8568A/B
Description
The KSN command moves the marker to the minimum value detected.
NOTE The functions of the KSN command are identical to the MKMIN command
(page 250).
205
Programming Commands
KSn Graticule On
KSn
Graticule On
Syntax
KSn ;
Legacy Products
8566A/B, 8568A/B
Description
The KSn command turns on the graticule on the analyzer display.
NOTE The functions of the command KSn are identical to the GRAT ON command
(page 171).
206
Programming Commands
KSO Marker Span
KSO
Marker Span
Syntax
KSO ;
Legacy Products
8566A/B, 8568A/B
Description
The KSO command operates only when the delta marker is On (see MKD (page 245) or M3 (page 229)).
When the delta marker is on and the KSO command is executed, the left marker specifies the start
frequency, and the right marker specifies the stop frequency. If the delta marker is off, the command
does nothing.
NOTE If the active marker is not a delta marker, there is no change in its position.
NOTE The functions of the KSO command are identical to the MKSP command
(page 261).
207
Programming Commands
KSo Annotation Off
KSo
Annotation Off
Syntax
KSo ;
Legacy Products
8566A/B, 8568A/B
Description
The KSo command blanks the annotation on the analyzer display.
NOTE The functions of the command KSo are identical to the ANNOT OFF command
(page 102).
208
Programming Commands
KSp Annotation On
KSp
Annotation On
Syntax
KSp ;
Legacy Products
8566A/B, 8568A/B
Description
The KSp command activates the annotation on the analyzer display.
NOTE The functions of the command KSp are identical to the ANNOT ON command
(page 102).
209
Programming Commands
KST Fast Preset
KST
Fast Preset
Syntax
KST ;
Legacy Products
8566A/B, 8568A/B
Description
Performs an instrument preset, setting the analyzer back to its factory settings.
NOTE There is no fast preset for X-Series analyzers. Instead, the Code Compatibility
software performs an instrument preset (IP) when the KST command is issued.
The functions of the command KST are therefore identical to the IP command
(page 178).
210
Programming Commands
KSV Frequency Offset
KSV
Frequency Offset
Syntax
KSV SP real HZ ;
KZ
MZ
GZ
OA
?
Legacy Products
8566A/B, 8568A/B
Description
The KSV command allows you to specify a value that offsets the frequency scale for all absolute
frequency readouts, for example, center frequency. Relative values, for example, span and delta marker,
are not offset.
NOTE The functions of the KSV command are identical to the FOFFSET command
(page 159).
211
Programming Commands
KSx External Trigger
KSx
External Trigger
Syntax
KSx ;
Legacy Products
8566A/B, 8568A/B
Description
The KSx command activates the normal external trigger mode. When the KSx command is executed, the
RF input signal is only displayed when the external trigger level exceeds the trigger threshold level.
NOTE If an 8566A/B or an 8568A/B analyzer is in zero span and the sweep time is less
than 20 msec, the display only gets refreshed when a fresh trace has been taken.
This can cause the displayed trace to flicker.
In the N9061A application of X-Series analyzers, all traces are displayed
continuously, so all traces are therefore free of flicker.
NOTE The functions of the command KSx are identical to the TM EXT command
(page 337).
212
Programming Commands
KSy Video Trigger
KSy
Video Trigger
Syntax
KSy ;
Legacy Products
8566A/B, 8568A/B
Description
The KSy command activates the normal video trigger mode. When the KSy command is executed, the
RF input signal is only displayed when the video trigger signal, which is internally triggered off the input
signal, exceeds the trigger threshold level.
NOTE If an 8566A/B or an 8568A/B analyzer is in zero span and the sweep time is less
than 20 msec, the display only gets refreshed when a fresh trace has been taken.
This can cause the displayed trace to flicker.
In the N9061A application of X-Series analyzers, all traces are displayed
continuously, so all traces are therefore free of flicker.
NOTE The functions of the command KSy are identical to the TM VID command
(page 337) and to the T4 command (page 329).
213
Programming Commands
KSZ Reference Level Offset
KSZ
Reference Level Offset
Syntax
KSZ SP real DM ;
MV
UV
OA
?
Legacy Products
8566A/B, 8568A/B
Description
The KSZ command offsets all amplitude readouts on the display but without affecting the trace. Note the
8566A/B only supports unit DM.
Once activated, the KSZ command displays the amplitude offset on the left side of the screen.
Entering KSZ 0 or presetting the spectrum analyzer eliminates an amplitude offset.
NOTE The functions of the KSZ command are identical to the ROFFSET command
(page 304).
214
Programming Commands
L0 [zero] Display Line Off
L0 [zero]
Display Line Off
Syntax
L0 ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The L0 [zero] command disables the display line.
NOTE The functions of the L0 [zero] command are identical to the DLE OFF command
(page 143).
215
Programming Commands
LF Low Frequency Preset
LF
Low Frequency Preset
Syntax
LF ;
Legacy Products
8566A/B
Description
Performs a low frequency preset. That is, it selects a Start Frequency of 0 Hz and a Stop Frequency of
2.5 GHz, a Reference Level of 0dBm, and sets all coupled functions to automatic.
216
Programming Commands
LG Logarithmic Scale
LG
Logarithmic Scale
Syntax
LG SP number DB ;
DM LF
SP UP
CR
DN
SP
OA
?
,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the amplitude (vertical graticule divisions) as logarithmic units, without changing the reference
level. The integer ranges vary between the different remote languages. The following table lists the
ranges for each remote language.
Table 4-22
8560E/EC 1, 2, 5, and 10
8561E/EC 1, 2, 5, and 10
8562E/EC 1, 2, 5, and 10
8563E/EC 1, 2, 5, and 10
8564E/EC 1, 2, 5, and 10
8565E/EC 1, 2, 5, and 10
8566A 1, 2, 5, and 10
8566B 1, 2, 5, and 10
8568A 1, 2, 5, and 10
217
Programming Commands
LG Logarithmic Scale
Table 4-22
8568B 1, 2, 5, and 10
218
Programming Commands
LIMF Limit Line Frequency Value
LIMF
Limit Line Frequency Value
Syntax
LIMF SP number HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
Legacy Products
8560 series
Description
The LIMF command is used to enter a frequency value for a limit-line segment.
NOTE The response to the query command LIMF? is not supported by N9061A.
219
Programming Commands
LIMIFAIL Limits Failed
LIMIFAIL
Limits Failed
Syntax
LIMIFAIL ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The LIMIFAIL command returns a number between 0 and 3 which specifies whether the active trace
passed or failed the upper and lower limit line tests. The meanings of the returned numbers are shown
below.
Table 4-23 Results of the LIMIFAIL Command
Result Meaning
0 The active trace passed both the upper and the lower limit tests.
3 The active trace failed both the upper and the lower limit tests.
220
Programming Commands
LIMIPURGE Delete Current Limit Line
LIMIPURGE
Delete Current Limit Line
Syntax
LIMIPURGE ;
Legacy Products
8560 series
Description
The LIMIPURGE command deletes the current limit line.
221
Programming Commands
LIMIREL Relative Limit Lines
LIMIREL
Relative Limit Lines
Syntax
LIMIREL SP ON ;
OFF
SP 1
Legacy Products
8560 series
Description
Specifies whether the current limit lines are fixed or relative.
222
Programming Commands
LIML Lower-Limit Amplitude
LIML
Lower-Limit Amplitude
Syntax
LIML SP number DB ;
DBM
Legacy Products
8560 series
Description
The LIML command assigns the lower-limit amplitude value to a limit-line segment.
223
Programming Commands
LIMTSL Slope Limit Line
LIMTSL
Slope Limit Line
Legacy Products
8560 series
Description
The LIMTSL command makes the selected limit-line segment sloped. Default setting is sloped.
224
Programming Commands
LIMU Upper-Limit Amplitude
LIMU
Upper-Limit Amplitude
Syntax
LIMU SP number DB ;
DBM
Legacy Products
8560 series
Description
The LIMU command assigns the upper-limit amplitude value to a limit-line segment.
225
Programming Commands
LN Linear Scale
LN
Linear Scale
Syntax
LN ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Scales the amplitude (vertical graticule divisions) proportional to the input voltage, without changing the
reference level. The bottom line of the graticule represents 0 V.
226
Programming Commands
M1 [one] Marker Off
M1 [one]
Marker Off
Syntax
M1 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The M1 [one] command blanks any markers showing on the display.
NOTE Unlike the MKOFF ALL command (page 253), it blanks inactive markers as well.
227
Programming Commands
M2 [two] Marker Normal
M2 [two]
Marker Normal
Syntax
M2 SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
SP UP GZ
DN S
OA MS
US
SC
Legacy Products
8566A/B, 8568A/B
Description
The M2 [two] command moves the active marker to the marker frequency. If the active marker type is
not currently normal (for example, if it is delta), the M2 command changes it to a normal marker.
NOTE The functions of the M2 command are identical to the MKN command (page 251).
NOTE If the active marker has not been declared with MKACT, a normal marker is
turned on and this active marker is assumed to be marker number 1 [one].
228
Programming Commands
M3 [three] Delta Marker
M3 [three]
Delta Marker
Syntax
M3 SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
SP UP GZ
DN S
OA MS
US
SC
Legacy Products
8566A/B, 8568A/B
Description
The M3 [three] command computes the frequency and amplitude difference between the active marker
and the delta (or difference) marker.
If a delta marker is not displayed on the screen, the M3 command places one at the specified frequency
or on the right hand edge of the display. If an active marker is not displayed on the screen, the M3
command places an active marker at the center of the screen.
NOTE The active marker is the number 1 marker unless otherwise specified by the
MKACT command (page 242).
NOTE The functions of the M3 command are identical to the MKD command (page 245).
229
Programming Commands
M4 [four] Marker Zoom
M4 [four]
Marker Zoom
Syntax
M4 SP real HZ ;
KHZ
MHZ
GHZ
KZ
MZ
SP UP GZ
DN S
OA MS
US
SC
Legacy Products
8566A/B, 8568A/B
Description
The M4 [four] command, when specifying either the UP or DN parameter, increases or decreases the
frequency span by one step. When specifying a numeric value, the M4 command moves the markers
horizontal (X) position to the specified position in frequency or time.
NOTE The OA option only returns the current value to the controller; it does not set the
active function to the active marker.
230
Programming Commands
MA Marker Amplitude Output
MA
Marker Amplitude Output
Syntax
MA ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The MA command returns the amplitude level of the active marker if the marker is on the screen. If both
the active marker and the delta marker are displayed, the MA command returns the amplitude difference
between the two markers.
The format of the returned data when using the MKA command is dependent on the currently set trace
data format (refer to TDF, MDS, O1, O2, O3, or O4) when the selected remote language 8566.
8560 Series: The marker amplitude is always returned as an ASCII value (TDF P).
NOTE The functions of the MA command are identical to the MKA command
(page 241).
231
Programming Commands
MC0 [zero] Marker Frequency Counter Off
MC0 [zero]
Marker Frequency Counter Off
Syntax
MC0 ;
Legacy Products
8568A/B
Description
The MC0 [zero] command turns the marker frequency counter off.
NOTE The functions of the MC0 [zero] command are identical to the MKFC OFF
command (page 247).
232
Programming Commands
MC1 [one] Marker Frequency Counter On
MC1 [one]
Marker Frequency Counter On
Syntax
MC1 ;
Legacy Products
8568A/B
Description
The MC1 [one] command turns the marker frequency counter on.
NOTE The functions of the MC1 [one] command are identical to the MKFC ON
command (page 247).
233
Programming Commands
MDS Measurement Data Size
MDS
Measurement Data Size
Syntax
MDS SP B ;
Legacy Products
8566A/B, 8568A/B
Description
The MDS command formats binary data in one of the following formats:
B selects a data size of one 8-bit byte.
W selects a data size of one word, which is two 8-bit bytes.
If no keyword is specified in the command, the default value of W is assumed.
234
Programming Commands
MEAN Trace Mean
MEAN
Trace Mean
Syntax
MEAN SP TRA ;
TRB LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Returns the mean value of the specified trace in display units.
235
Programming Commands
MEANPWR Mean Power measurement
MEANPWR
Mean Power measurement
Syntax
TRB LF
CR
SP
Legacy Products
8560 series
Description
The MEANPWR command measures the average power of the carrier during that portion of the time
when it is on. The on state is defined as the time when the signal is within a selected number of dB of its
peak level. The range of amplitudes that is defined as the on state can be set with the command. The
amplitude range is set relative to the peak value of the signal.
NOTE The MEANPWR command is similar to the CARRON command (page 123),
except that the CARRON command defines ‘on’ as that time when the signal is
within 20 dB of its peak level.
236
Programming Commands
MEAS Meas
MEAS
Meas
Syntax
MEAS ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Returns the current sweep status. If the analyzer is set to sweep and make measurements continuously,
the command returns CONTS. If it is set to make a single sweep with a single measurement, the
command returns SNGLS.
The analyzer can be set to single sweep using the SNGLS command and it can be set to continuos sweep
using the CONTS command.
237
Programming Commands
MF Marker Frequency Output
MF
Marker Frequency Output
Syntax
8560 series:
MF ? ;
LF
CR
SP
8566A/B, 8568A/B:
MF ;
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Returns the frequency (or time) of the on-screen active marker. If both an active marker and the delta
marker are on the screen, the frequency difference is returned.
NOTE 8566 and 8568 only: If the active marker has marker frequency count set to On
when using the MF? command, the marker frequency count value is returned to the
controller.
238
Programming Commands
MINH Minimum Hold
MINH
Minimum Hold
Syntax
MINH SP TRA ;
TRB LF
CR
SP
Legacy Products
8560 series
Description
The MINH command updates the chosen trace with the minimum signal level detected at each trace-data
point from subsequent sweeps.
For information on the trace settings of the X-series analyzers when legacy instrument trace settings are
sent, see Table 4-4, “Legacy Products command mapping to X-series for trace/detector settings.”
239
Programming Commands
MINPOS Minimum X Position
MINPOS
Minimum X Position
Syntax
MINPOS SP TRA ;
TRB
TRC
Legacy Products
8566A/B, 8568A/B
Description
The MINPOS command returns the X co-ordinate value that corresponds to the minimum amplitude of
the specified trace.
240
Programming Commands
MKA Marker Amplitude
MKA
Marker Amplitude
Syntax
MKA ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The MKA command returns the amplitude level of the active marker if the marker is on the screen. If
both the active marker and the delta marker are displayed, the MKA command returns the amplitude
difference between the two markers.
8560 Series: The marker amplitude is always returned as an ASCII value (TDF P).
8566 and 8568 Series: Specifies the amplitude of the active marker in dBm when the active marker is the
fixed or amplitude type (refer to the MKTYPE command).
NOTE The functions of the MKA command are identical to the MA command
(page 231).
241
Programming Commands
MKACT Activate Marker
MKACT
Activate Marker
Syntax
marker
MKACT SP
number
;
Table 4-24
Legacy Products
8566A/B, 8568A/B
Description
MKACT specifies the active marker. There can be four different markers, but only one marker can be
active at any time.
242
Programming Commands
MKBW Marker Bandwidth
MKBW
Marker Bandwidth
Syntax
MKBW SP number , ? ;
LF
CR
SP
Legacy Products
8560 series
Description
Returns the bandwidth at the specified power level relative to an on-screen marker (if present) or the
signal peak (if no on-screen marker is present).
243
Programming Commands
MKCF Marker to Center Frequency
MKCF
Marker to Center Frequency
Syntax
MKCF ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Sets the center frequency equal to the marker frequency and moves the marker to the center of the
screen.
NOTE The functions of the MKCF command are identical to the E2 command
(page 148).
244
Programming Commands
MKD Marker Delta
MKD
Marker Delta
Syntax
MKD SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
SP UP GZ
DN S
OA MS
US
SC
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The MKD command computes the frequency and amplitude difference of the active marker and the delta
marker. These values are displayed on the screen.
If a delta marker is not displayed on the screen, the MKD command places one at the specified frequency
or on the left or right hand edge of the display. If an active marker is not displayed on the screen, the
MKD command places an active marker at the center of the screen.
NOTE For 8566A/B and 8568A/B, the functions of the MKD command are identical to
the M3 command (page 229).
245
Programming Commands
MKF Marker Frequency
MKF
Marker Frequency
Syntax
MKF SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
SP UP GZ
DN S
OA MS
US
SC
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the frequency value of the active marker.
8560 Series: The data is returned in ASCII format.
For all other languages, the format of the returned data is determined by the TDF (Trace Data Format)
(page 332) command and, if TDF B (binary data format) has been selected, by the MDS command
(page 234).8566 and 8568 only: If the active marker has marker frequency count set to On when using
the MKF? command, the marker frequency count value is returned to the controller.
246
Programming Commands
MKFC Marker Counter
MKFC
Marker Counter
Syntax
MKFC SP ON ;
OFF LF
SP 1 CR
0
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Turns on or off the marker frequency counter. The resolution of the frequency marker counter is
determined by the MKFCR command (page 248).
NOTE The functions of the MKFC command are identical to the MC0 [zero] command
(page 232) and MC1 [one] command (page 233).
NOTE For 8568A/B, the functions of the MKFC command are identical to the MC0 or
MC1 command.
247
Programming Commands
MKFCR Marker Counter Resolution
MKFCR
Marker Counter Resolution
Syntax
8560 series:
MKFCR SP real HZ ;
KHZ LF
MHZ CR
GHZ SP
KZ
,
MZ
GZ
SP OA
8566A/B, 8568A/B:
MKFCR SP real HZ ;
KHZ
MHZ
GHZ
KZ
MZ
SP UP GZ
DN
OA
Legacy Products
8560 series, 8566A/B, 8568A/B
248
Programming Commands
MKFCR Marker Counter Resolution
Description
Sets the resolution of the marker frequency counter. The marker counter resolution value is always given
either in Hertz or in seconds depending on whether the analyzer is operating in the frequency domain or
the time domain.
NOTE For 8566A/B, 8568A/B, the functions of the MKFCR command are identical to the
KS= command (page 180).
249
Programming Commands
MKMIN Marker Minimum
MKMIN
Marker Minimum
Syntax
MKMIN ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Moves the active marker to the minimum value detected.
NOTE For 8566A/B, 8568A/B, the functions of the MKMIN command are identical to
the KSN command (page 205).
250
Programming Commands
MKN Marker Normal
MKN
Marker Normal
Syntax
MKN SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
SP UP GZ
DN S
OA MS
US
SC
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The MKN command moves the active marker to the specified frequency. If no marker is currently turned
on, a normal marker is turned on. If the active marker type is not currently normal (for example, it is
delta), the MKN command changes it to a normal marker.
NOTE The functions of the MKN command are identical to the M2 [two] command
(page 228).
251
Programming Commands
MKNOISE Marker Noise
MKNOISE
Marker Noise
Syntax
MKNOISE SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Displays the average RMS noise density at the marker.
NOTE For 8566A/B, 8568A/B, the functions of the MKNOISE command are identical to
the KSM command (page 203).
252
Programming Commands
MKOFF Marker Off
MKOFF
Marker Off
Syntax
MKOFF SP ALL ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Turns off either the active marker or all the markers. If the ALL parameter is omitted, only the active
marker is turned off.
253
Programming Commands
MKP Marker Position
MKP
Marker Position
Syntax
MKP SP integer ;
Legacy Products
8566A/B, 8568A/B
Description
Specifies the marker position horizontally, in display units.
254
Programming Commands
MKPK Marker Peak
MKPK
Marker Peak
Syntax
MKPK SP HI ;
NH LF
NR
CR
NL
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Executing MKPK HI, or simply MKPK (no secondary keyword), positions the active marker at the
highest signal detected. If an active marker is on the screen, the MKPK parameters move the marker as
follows:
HI (highest) moves the active marker to the highest peak.
NH (next highest) moves the active marker to the next signal peak of lower amplitude.
NR (next right) moves the active marker to the next signal peak to the right of the current marker.
NL (next left) moves the active marker to the next signal peak to the left of the current marker.
NOTE The functions of the MKPK command (no secondary keyword) and the MKPK HI
command are identical to the E1 commands: (page 147).
NOTE For 8566A/B, 8568A/B, the functions of the MKPK NH command are similar to
the KSK command (page 199), except that KSK does not take in to account the
marker peak excursion or marker peak threshold values. For more details on
marker peak excursion, see the MKPX command (page 257).
255
Programming Commands
MKPT Marker Threshold
MKPT
Marker Threshold
Syntax
MKPT SP number DBM ;
LF
SP UP
DN CR
OA
SP
?
,
Legacy Products
8560 series
Description
The MKPT command sets the minimum amplitude level from which a peak on the trace can be detected.
256
Programming Commands
MKPX Marker Peak Excursion
MKPX
Marker Peak Excursion
Syntax
MKPX SP real DB ;
LF
SP UP
DN CR
OA
SP
?
Preset State: 6 dB
Step Increment: 1 dB
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the minimum signal excursion for the analyzer’s internal peak identification routine.
The default value is 6 dB. In this case, any signal with an excursion of less than 6 dB on either side of the
marker would not be identified. Thus, if an MKPK NH command were to be executed on such a signal,
the analyzer would not place a marker on this signal peak.
257
Programming Commands
MKREAD Marker Readout
MKREAD
Marker Readout
Syntax
MKREAD SP FRQ ;
SWT
IST
PER
?
Legacy Products
8566A/B, 8568A/B
Description
Selects the type of active trace information displayed by the spectrum analyzer marker readout.
The MKREAD command can select the following types of active trace information:
FRQ frequency
SWT sweep time
IST inverse sweep time
PER period
NOTE The Inverse Sweep Time (IST) readout is only available when using a delta marker
in zero span.
The results of the data depend on the MKREAD parameter and the frequency span, and whether the
marker delta function is used.
Table 4-25
258
Programming Commands
MKREAD Marker Readout
Table 4-25
SWT Reads time since the Reads delta time Waveform Waveform
start of sweep between end points measurements of measurements of
detected detected modulation
modulation
NOTE FFT (Fast Fourier Transform) is not available in the Programming Code
Compatibility Suite option.
259
Programming Commands
MKRL Marker to Reference Level
MKRL
Marker to Reference Level
Syntax
MKRL ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The MKRL command moves the active marker to the reference level.
NOTE The functions of the MKRL command are identical to the E4 command
(page 150).
260
Programming Commands
MKSP Marker Span
MKSP
Marker Span
Syntax
MKSP ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The MKSP command operates only when the delta marker is On (see MKD (page 245) or M3
(page 229)). When the delta marker is On and MKSP is executed, the delta marker and active marker
determine the start and stop frequencies. The left marker specifies the start frequency, and the right
marker specifies the stop frequency. If marker delta is Off, there is no operation.
NOTE If the active marker is not a delta marker, there is no change in its position.
NOTE For 8566A/B, 8568A/B, The functions of the MKSP command are identical to the
KSO command (page 207).
261
Programming Commands
MKSS Marker to Step Size
MKSS
Marker to Step Size
Syntax
MKSS ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Sets the center-frequency step-size equal to the marker frequency. If the analyzer is in the delta mode,
the step size is set to the frequency difference between the active and the delta marker.
NOTE When the marker is a delta marker, the functions of the MKSS command are
identical to the E3 command (page 149).
262
Programming Commands
MKT Marker Time
MKT
Marker Time
Syntax
MKT SP real S ;
MS LF
US
CR
SC
SP
OA
? ,
Legacy Products
8560 series
Description
Places a marker at a position that corresponds to a specified point in time during the sweep.
263
Programming Commands
MKTRACE Marker Trace
MKTRACE
Marker Trace
Syntax
MKTRACE SP TRA ;
TRB
TRC
?
NOTE TRA corresponds to Trace 1, TRB corresponds to Trace 2, and TRC corresponds
to Trace 3.
Legacy Products
8566A/B, 8568A/B
Description
Moves the active marker to the corresponding position in Trace 1, Trace 2, or Trace 3.
264
Programming Commands
MKTRACK Marker Track
MKTRACK
Marker Track
Syntax
MKTRACK SP ON ;
OFF LF
SP 1 CR
0
SP
?
,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Moves the signal on which the active marker is located to the center of the analyzer display and keeps the
signal peak at center screen.
To keep a drifting signal at center screen, place the active marker on the desired signal before turning on
MKTRACK.
NOTE For 8566A/B, 8568A/B, the functions of the MKTRACK command are identical
to the MT0 [zero] command (page 269) and the MT1 [one] command (page 270).
265
Programming Commands
MKTYPE Marker Type
MKTYPE
Marker Type
Syntax
MKTYPE SP PSN ;
AMP
FIXED
?
Legacy Products
8566A/B, 8568A/B
Description
Specifies the type of marker.
MKTYPE PSN allows the marker to be positioned horizontally in display units (default). Use the MKP
and MKF commands to position the marker.
MKTYPE AMP allows the marker to be positioned according to amplitude. Use the MKA command to
position the marker.
MKTYPE FIXED allows a marker to be placed at any fixed point on the display. Use the MKP, MKF,
and MKA commands to position the marker.
NOTE Marker type can only be set for an active marker. The marker type is reset to PSN
when the marker is turned off (using the MKOFF command) or the instrument is
preset.
266
Programming Commands
ML Mixer Level
ML
Mixer Level
Syntax
8560 series:
ML SP real DBM ;
LF
SP UP
DN CR
?
SP
8566A/B, 8568A/B:
ML SP real DB ;
DM
SP UP MV
DN UV
OA
?
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The ML command specifies the maximum signal level that is applied to the input mixer for a signal that
is equal to or below the reference level.
The effective mixer level is equal to the reference level minus the input attenuator setting.
267
Programming Commands
ML Mixer Level
NOTE If an external amplifier gain value is set, the mixer level is determined using the
following equation:
Mixer Level = Ref. Level - Attenuation + Ext. Amplifier Gain
The external amplifier gain is not preset by doing an IP command in case the
analyzer is measuring a large signal. This is to protect the analyzer from damage
from a large signal. For a helpful suggestion, see Chapter 3 , “Hints and Tips,” on
page 71.
NOTE For 8566A/B, 8568A/B, the functions of the ML command are identical to the KS,
command (page 179).
268
Programming Commands
MT0 [zero] Marker Track Off
MT0 [zero]
Marker Track Off
Syntax
MT0 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The MT0 [zero] command disables the marker tracking mode.
NOTE The functions of the MT0 [zero] command are identical to the MKTRACK OFF
command (page 265).
269
Programming Commands
MT1 [one] Marker Track On
MT1 [one]
Marker Track On
Syntax
MT1 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
Moves the signal on which the active marker is located to the center of the analyzer display and keeps the
signal peak at center screen.
To keep a drifting signal at center screen, place the active marker on the desired signal before issuing an
MT1 [one] command.
NOTE The functions of the MT1 command are identical to the MKTRACK ON command
(page 265).
270
Programming Commands
MXMH Maximum Hold
MXMH
Maximum Hold
Syntax
MXMH SP TRA ;
TRB LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Updates each trace element with the maximum level detected.
MXMH updates the specified trace (either Trace A or Trace B) with a new value from a detector only if
the new value is larger than the previous trace data value.
NOTE The functions of the MXMH command are identical to the A2 command
(page 80)and B2 command (page 111).
For information on the trace settings of the X-series analyzers when legacy instrument trace settings are
sent, see Table 4-4, “Legacy Products command mapping to X-series for trace/detector settings.”
271
Programming Commands
NORMLIZE Normalize Trace Data
NORMLIZE
Normalize Trace Data
Syntax
NORMLIZE SP ON ;
OFF LF
OA
CR
SP 1
SP
0
? ,
Legacy Products
8560 series
Description
Activates or de-activates the normalization routine for stimulus-response measurements. This function
subtracts trace B from trace A, offsets the result by the value of the normalized reference position (NRL)
and displays the result in trace A.
If active (ON), the NORMLIZE command is automatically turned off with an instrument preset (IP) or at
power on.
The OA option only returns the current value to the controller; it does not set the active function to the
normalization state.
Normalization is not available when using linear mode and is mutually exclusive with other trace math.
272
Programming Commands
NRL Normalized Reference Level
NRL
Normalized Reference Level
Syntax
NRL SP number DB LF
LF
?
CR
SP
Legacy Products
8560 series
Description
Sets the normalized reference level. It is intended to be used with the NORMLIZE command. When
using NRL, the input attenuator and IF step gains are not affected. This function is a trace-offset function
enabling the user to offset the displayed trace without introducing hardware switching errors into the
stimulus-response measurement. The unit of measure for NRL is dB.
273
Programming Commands
NRPOS Normalized Reference Position
NRPOS
Normalized Reference Position
Syntax
NRPOS SP number ;
LF
SP UP
DN CR
OA
SP
?
Legacy Products
8560 series
Description
The NRPOS command adjusts the normalized reference-position that corresponds to the position on the
graticule where the difference between the measured and calibrated traces reside. The dB value of the
normalized reference position is equal to the normalized reference level. The normalized reference
position can be adjusted between 0.0 and 10.0, corresponding to the bottom and top graticule lines,
respectively.
274
Programming Commands
O1 [one] Format - Display Units
O1 [one]
Format - Display Units
Syntax
O1 ;
Legacy Products
8566A/B, 8568A/B
Description
The O1 [one] command transmits trace amplitude and position information as decimal values in display
units.
275
Programming Commands
O2 [two] Format - Two 8-Bit Bytes
O2 [two]
Format - Two 8-Bit Bytes
Syntax
O2 ;
Legacy Products
8566A/B, 8568A/B
Description
The O2 [two] command transmits trace amplitude and position information as two 8-bit binary numbers,
or one instruction word.
276
Programming Commands
O3 [three] Format - Real Amplitude Units
O3 [three]
Format - Real Amplitude Units
Syntax
O3 ;
Legacy Products
8566A/B, 8568A/B
Description
The O3 [three] command transmits trace vertical axis information only, in measurement units of Hz,
dBm, dB, volts or seconds.
277
Programming Commands
O4 [four] Format - One 8-Bit Byte
O4 [four]
Format - One 8-Bit Byte
Syntax
O4 ;
Legacy Products
8566A/B, 8568A/B
Description
The O4 [four] command transmits trace amplitude information only as a binary number.
278
Programming Commands
OA or ? Query Active Function
OA or ?
Query Active Function
Legacy Products
8566A/B, 8568A/B
Description
Query active function.
The active functions are ACPBW, ACPSP, AT, CF, CRTHPOS, CRTVPOS, DA, DL, DOTDENS, FA,
FB, FMGAIN, GD, GL, LG, MKA, MKD, MKFCR, MKN, MKPAUSE, MKPX, ML, NDB, NRL, RB,
RCLS, ROFFSET, RL, RLPOS, SAVES, SAVRCLN, SETDATE, SETTIME, SP, SQLCH, SRCALC,
SRCAT, SRCPOFS, SRCPSWP, SRCPWR, SRCTK, SS, ST, TH, TVLINE, VB, VBR, and
user-defined active function specified by the ACTDEF command.
279
Programming Commands
OCCUP Percent Occupied Power Bandwidth
OCCUP
Percent Occupied Power Bandwidth
Syntax
OCCUP SP number ;
LF
?
CR
SP
Legacy Products
8560 series
Description
The OCCUP command is used to query the current value of the percent occupied power. This value is set
by the DELMKBW (page 139) and the PWRBW command (page 290) command. The OCCUP
command can also be used to set the percent occupied power.
280
Programming Commands
OL Output Learn String
OL
Output Learn String
Syntax
80 byte binary
OL SP
string
;
Legacy Products
8566A/B, 8568A/B
Description
The OL command transmits information to the controller that describes the state of the analyzer when
the OL command is executed. This information is called the “learn string.” The learn string can be sent
from the controller memory back to the analyzer to restore the analyzer to its original state.
NOTE The OL command is not completely supported, due to differences between the
X-Series and 8566/8568. The following table outlines each byte of the array and
the bits supported within that byte.
3 to 9 Supported
10 Supported
12 to 17 Supported
281
Programming Commands
OL Output Learn String
19 Supported:
Bits 7, 6, 4, 3, and 0
Bit 5 on X-Series only
Unsupported:
Bits 1 and 2
21 Supported
23 to 25 Supported
27 Supported
29 to 30 Supported
32 to 37 Supported
39 to 45 Supported
48 to 53 Supported
63 Supported
282
Programming Commands
OL Output Learn String
66 to 71 Supported
78 Unsupported
283
Programming Commands
OT Output Trace Annotations
OT
Output Trace Annotations
Syntax
OT ;
Legacy Products
8566A/B, 8568A/B
Description
The OT command sends 32 character-strings to the controller. Each character-string can be up to 64
characters long.
NOTE The 'data invalid indicator' status report given in string 27 of the returned text is
only supported on X-Series analyzers.
284
Programming Commands
PEAKS Peaks
PEAKS
Peaks
Syntax
8560 series:
8566A/B, 8568A/B:
PEAKS SP TRA , TRA , AMP ;
TRC TRC
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The PEAKS command sorts the signal peaks in the source trace by frequency or amplitude, and sends
the results to destination trace.
285
Programming Commands
PKPOS Peak Position
PKPOS
Peak Position
Syntax
PKPOS SP TRA ;
TRB
TRC
Legacy Products
8568
Description
The PKPOS command returns the X co-ordinate value of the maximum peak in the specified trace.
286
Programming Commands
PLOT Plot
PLOT
Plot
Syntax
PLOT SP value , value , value , value ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The PLOT command allows you transfer trace data, graticule and annotation information to a printer
using a parallel port.
The legacy analyzers transferred data directly to a plotter via the GPIB connection. The PLOT command
now transfers data to a printer, and prints the entire screen.
Although the PLOT command reads in plotter dimension values, these are ignored.
NOTE In legacy instruments, the PLOT command also returns HPGL. The X-series
instruments with the N9061A application installed does not return HPGL.
287
Programming Commands
PP Preselector Peak
PP
Preselector Peak
Syntax
PP ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B
Description
The PP command optimizes preselector tracking to peak the amplitude of a signal at the active marker. If
a marker is not on the screen, PP places a marker at the highest signal level, and optimizes preselector
tracking at that frequency.
NOTE This command is only supported when the X-series analyzer’s maximum
frequency limit is greater than 3.6 GHz. If the command is issued on an analyzer
with a maximum frequency limit of 3.6 GHz or less the command is not
implemented and no error is generated.
288
Programming Commands
PRINT Print
PRINT
Print
Syntax
PRINT ;
LF
CR
SP
Legacy Products
8560 series
Description
Transfers trace data, graticule and annotation of the analyzer screen directly to the X-series analyzer’s
default printer.
289
Programming Commands
PWRBW Power Bandwidth
PWRBW
Power Bandwidth
Syntax
8560 Series:
TRB LF
CR
SP
8566A/B, 8568A/B:
TRB
TRC
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Computes the combined power of all signal responses in the specified trace, and returns the bandwidth of
the specified percentage of total power. The number in the command is a percentage value, that is, it has
a range of 0 to 100.
NOTE If the percent total power is 100%, the power bandwidth equals the frequency
span.
NOTE On the 8566A/B analyzer, this command stops the trace. That is not the case with
this the N9061A application.
290
Programming Commands
R1 [one] Illegal Command SRQ
R1 [one]
Illegal Command SRQ
Syntax
R1 ;
Legacy Products
8566A/B, 8568A/B
Description
The R1 [one] command deactivates all analyzer service requests (SRQs) except SRQ140, the
illegal-command service request.
291
Programming Commands
R2 [two] End-of-Sweep SRQ
R2 [two]
End-of-Sweep SRQ
Syntax
R2 ;
Legacy Products
8566A/B, 8568A/B
Description
The R2 [two] command activates the end-of-sweep and illegal-command service requests.
292
Programming Commands
R3 [three] Hardware Broken SRQ
R3 [three]
Hardware Broken SRQ
Syntax
R3 ;
Legacy Products
8566A/B, 8568A/B
Description
The R3 [three] command activates the hardware-broken and illegal-command service requests.
293
Programming Commands
R4 [four] Units-Key-Pressed SRQ
R4 [four]
Units-Key-Pressed SRQ
Syntax
R4 ;
Legacy Products
8566A/B, 8568A/B
Description
The R4 [four] command activate the units-key-pressed and illegal-command SRQs. Same as RQS 34.
NOTE X-Series analyzers cannot replicate the units-key-pressed service request since no
front panel interaction is supported.
294
Programming Commands
RB Resolution Bandwidth
RB
Resolution Bandwidth
Syntax
8560 series:
RB SP real HZ ;
KHZ LF
SP UP MHZ
CR
DN GHZ
SP
AUTO KZ
MAN MZ ,
OA GZ
8566A/B, 8568A/B:
RB SP real HZ
KHZ
MHZ
SP UP
GHZ
DN
KZ
OA
MZ
GZ
?
Preset State:
8560 series: 1 MHz, auto coupled
8566A/B, 8568A/B: 3 MHz, auto coupled
Step Increment: In a 1, 3, 10 series
Preset State: 3 MHz, auto coupled
Step Increment: In a 1, 3, 10 series
295
Programming Commands
RB Resolution Bandwidth
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The RB command specifies the resolution bandwidth. Available bandwidths are 1 Hz, 3 Hz, 10 Hz, 30
Hz, 300 Hz, 1 kHz, 3kHz, 30 kHz, 100 kHz, 300 kHz, 1 MHz, and 3 MHz. The resolution bandwidths,
video bandwidths, and sweep time are normally coupled. Executing RB decouples them. Execute CR
(page 134) to re-establish coupling.
NOTE Default values on X-Series analyzers may vary from the legacy analyzers. Refer to
the X-Series User’s and Programmer’s Reference to find out any restrictions that
may apply.
296
Programming Commands
RBR Resolution Bandwidth to Span Ratio
RBR
Resolution Bandwidth to Span Ratio
Syntax
RBR SP real ;
LF
SP UP
DN CR
OA
SP
?
Legacy Products
8560 series
Description
This command sets the coupling ratio between the frequency span and the resolution bandwidth. It
allows you to set the Span/RBW ratio to 1/<value>, where <value> is set by the user.
297
Programming Commands
RC Recall State
RC
Recall State
Syntax
8560 series:
RC SP LAST ;
PWRON LF
CR
SP number
SP
8566A/B, 8568A/B:
RC SP digit ;
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Recalls analyzer state data from the specified state register in the analyzer’s memory.
Registers one through six are reserved for the user, and contain instrument states (such as front panel
configuration) saved with the SAVES command (page 308) or the SV command (page 324).
NOTE The functions of the RC command are identical to the RCLS command (page 299).
298
Programming Commands
RCLS Recall State
RCLS
Recall State
Syntax
RCLS SP LAST ;
PWRON LF
CR
SP number
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Recalls analyzer state data from the specified state register in the analyzer’s memory.
Registers one through six are reserved for the user, and contain instrument states (such as front panel
configuration) saved with the SAVES command (page 308) or the SV command (page 324).
NOTE The functions of the RCLS command are identical to the RC command (page 298).
299
Programming Commands
REV Revision
REV
Revision
Syntax
REV ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The REV command returns the firmware revision number.
In X-Series analyzers, this command returns the build date of the N9061A application that you have
installed in your analyzer. The date is returned in YYMMDD format (where YY is the number of years
since 1950, and MM is the month and DD is the date).
300
Programming Commands
RL Reference Level
RL
Reference Level
Syntax
8560 series:
RL SP real DBM ;
DBMV LF
DBUV
CR
MV
SP
UV
V ,
SP UP MW
DN UW
OA W
DM
8566A/B, 8568A/B:
RL SP real DB ;
DM
SP UP MV
DN UV
OA
?
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the amplitude level of the top graticule line on the display. This represents the reference level.
301
Programming Commands
RL Reference Level
CAUTION Signal levels above +30 dBm will damage the analyzer. For a helpful suggestion
on this subject, see Chapter 3 , “Hints and Tips,” on page 71.
NOTE The 8566A/B and 8568A/B have the reference level from -89.9 dBm to +30 dBm.
The range of reference level for the MXA and PXA is -170 dBm to +30 dBm with
0 dB attanuation). The range of refernce level for EXA is -170 dBm to +23 dBm.
NOTE If the display line is on, changing the reference level does not adjust the position of
the display line.
302
Programming Commands
RMS Root Mean Square Value
RMS
Root Mean Square Value
Syntax
RMS SP TRA ;
TRB
TRC
Legacy Products
8566A/B, 8568A/B
Description
The RMS command returns the RMS value of the trace, in display units.
303
Programming Commands
ROFFSET Reference Level Offset
ROFFSET
Reference Level Offset
Syntax
8560 series:
ROFFSET SP real DB ;
LF
SP UP
DN CR
?
SP
8566A/B, 8568A/B:
ROFFSET SP real DM ;
MV
UV
DB
OA
?
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Offsets all amplitude readouts without affecting the trace.
Once activated, the ROFFSET command displays the amplitude offset on the left side of the screen.
Entering ROFFSET 0 or presetting the analyzer eliminates an amplitude offset.
NOTE For 8566A/B, 8568A/B, the functions of the ROFFSET command are identical to
the KSZ command (page 214).
304
Programming Commands
RQS Request Service Conditions
RQS
Request Service Conditions
Syntax
RQS SP number ;
LF
?
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Sets a bit mask for service requests, each service request has a corresponding bit number and decimal
equivalent of that bit number as shown in the table below.Use the decimal equivalents to set the bit mask.
For example, to set a mask for bits 4 and 5, add the decimal equivalents (16 + 32 = 48), then send the
command RQS 48.
Table 4-26 Status Byte Definition
5 Error Present
305
Programming Commands
S1[one] Continuous Sweep
S1[one]
Continuous Sweep
Syntax
S1 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The S1 command sets the analyzer to continuous sweep mode. In the continuous sweep mode, the
analyzer takes its next sweep as soon as possible after the current sweep (as long as the trigger conditions
are met). A sweep may temporarily be interrupted by data entries made over the remote interface.
NOTE The functions of the command S1 are identical to the CONTS command
(page 132).
306
Programming Commands
S2 [two] Single Sweep
S2 [two]
Single Sweep
Syntax
S2 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The S2 command sets the analyzer to single sweep mode. Each subsequent time that the command S2 is
sent, one sweep is started if the trigger conditions are met.
NOTE The functions of the S2 command are similar to the SNGLS command (page 313).
307
Programming Commands
SAVES Save State
SAVES
Save State
Syntax
SAVES SP digit ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Saves the current state of the analyzer in any of the registers one through six.
NOTE The functions of the SAVES command are identical to the SV command
(page 324).
308
Programming Commands
SER Serial Number
SER
Serial Number
Syntax
SER ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The SER command returns the X-series analyzer serial number to the controller.
309
Programming Commands
SETDATE Set Date
SETDATE
Set Date
Syntax
SETDATE SP number ;
LF
?
CR
SP
Legacy Products
8560 series
Description
The SETDATE command sets the date of the real-time clock of the analyzer. The date takes the form
YYMMDD (Year, Month, Day)
310
Programming Commands
SETTIME Set Time
SETTIME
Set Time
Syntax
SETTIME SP number ;
LF
?
CR
SP
Legacy Products
8560 series
Description
The SETTIME command sets the date of the real-time clock of the analyzer. The time takes the form
HHMMSS (Hour, Minute, Second).
311
Programming Commands
SMOOTH Smooth Trace
SMOOTH
Smooth Trace
Syntax
number
SMOOTH SP TRA ,
of points
;
TRB
TRC
NOTE TRA corresponds to Trace 1, TRB corresponds to Trace 2, and TRC corresponds
to Trace 3.
Legacy Products
8566A/B, 8568A/B
Description
Smooths the trace according to the number of points specified for the running average.
Each point value is replaced with the average of the values (in measurement units) of the given number
of points centered on it. Increasing the number of points increases smoothing at the cost of decreasing
resolution. If the number of points is an even number, then the number of points is increased by one.
Smoothing decreases at the endpoints.
NOTE Some differences may be noticed between the smoothed trace in the legacy
analyzers and the smoothed trace using the same signal in X-Series analyzers.
312
Programming Commands
SNGLS Single Sweep
SNGLS
Single Sweep
Syntax
SNGLS ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Sets the analyzer to single-sweep mode. Each time TS (take sweep) is sent, one sweep taken as long as
the trigger conditions are met.
NOTE The functions of the SNGLS command are identical to the S2 command
(page 307).
313
Programming Commands
SP Frequency Span
SP
Frequency Span
Syntax
8560 series:
SP SP real HZ ;
KHZ LF
MHZ
CR
GHZ
SP
KZ
MZ ,
GZ
SP UP
DN
OA
FULL
ZERO
LAST
?
314
Programming Commands
SP Frequency Span
8566A/B, 8568A/B:
SP SP real HZ ;
KHZ
MHZ
GHZ
KZ
MZ
GZ
SP UP
DN
OA
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Changes the total displayed frequency range symmetrically about the center frequency.
If resolution and video bandwidths are coupled to the span width, the bandwidths change with the span
width to provide a predetermined level of resolution and noise averaging. Likewise, the sweep time
changes to maintain a calibrated display, if coupled. All of these functions are normally coupled, unless
RB (page 295), VB (page 347), or ST (page 318) have been executed.
315
Programming Commands
SRQ Service Request
SRQ
Service Request
Syntax
SRQ SP digit ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The SRQ command sends a service request to the controller when the SRQ operand fits the mask
supplied with the RQS command.
NOTE The N9061A application does not support the setting of bit 1 (units-key-pressed)
of the status byte. Bit-1 of the status byte is always set to Off.
316
Programming Commands
SS Center Frequency Step Size
SS
Center Frequency Step Size
Syntax
8560 series:
SS SP real HZ ;
KHZ LF
MHZ
SP UP CR
GHZ
DN
SP
KZ
AUTO
MZ ,
MAN
GZ
OA
8566A/B, 8568A/B:
SS SP real HZ ;
KHZ
MHZ
SP UP
GHZ
DN
KZ
OA
MZ
GZ
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The SS command specifies center frequency step size.
317
Programming Commands
ST Sweep Time
ST
Sweep Time
Syntax
8560 series:
ST SP real S ;
MS LF
US
SP UP CR
SC
DN
SP
AUTO
,
MAN
OA
8566A/B, 8568A/B:
ST SP real SC ;
MS
US
SP UP
DN
OA
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The ST command specifies the time in which the analyzer sweeps the displayed frequency or time span.
NOTE The OA option in the ST command behaves in the same manner as the ST?
command in that it returns the current value to the controller. However, the OA
318
Programming Commands
ST Sweep Time
319
Programming Commands
STB Status Byte Query
STB
Status Byte Query
Syntax
STB ? ;
LF
CR
SP
Legacy Products
8560 series
Description
The STB command returns to the controller the decimal equivalent of the bits set in the status byte (see
the RQS (page 305) and SRQ (page 316) commands). STB is equivalent to a serial poll.
320
Programming Commands
STDEV Standard Deviation of Trace Amplitudes
STDEV
Standard Deviation of Trace Amplitudes
Syntax
STDEV SP TRA ;
TRB
TRC
NOTE TRA corresponds to Trace 1, TRB corresponds to Trace 2, and TRC corresponds
to Trace 3.
Legacy Products
8566A/B, 8568A/B
Description
Returns the standard deviation of the trace amplitude in display units.
321
Programming Commands
SUM Sum
SUM
Sum
Syntax
8560 Series:
SUM Sp TRA , ? ;
LF
TRB
CR
SP
8566A/B, 8568A/B:
SUM Sp TRA , ? ;
LF
TRB
CR
TRC
SP
Legacy Products
8560 series
Description
Returns the sum of all the trace values to the controller.
NOTE The 8560 series of analyzers returns display units, range (0-610)*601 points or if
322
Programming Commands
SUM Sum
323
Programming Commands
SV Save State
SV
Save State
Syntax
SV SP digit ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
Saves the current state of the analyzer in any of the registers one through six.
NOTE The functions of the SV command are identical to the SAVES command
(page 308).
324
Programming Commands
SWPCPL Sweep Couple
SWPCPL
Sweep Couple
Syntax
SWPCPL SP SA ;
SR LF
?
CR
SP
Legacy Products
8560 series
Description
Selects either a stimulus-response (SR) or signal-analyzer (SA) auto-coupled sweep time. In stimulus
response mode, auto-coupled sweep times are usually much faster for swept response measurements.
Stimulus response auto-coupled sweep times are typically valid in stimulus-response measurements
when the system frequency span is less than 20 times the bandwidth of the device under test.
325
Programming Commands
T1 [one] Free Run Trigger
T1 [one]
Free Run Trigger
Syntax
T1 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The T1 [one] command sets the analyzer sweep to free run trigger mode.
NOTE The functions of the T1 [one] command are identical to the TM FREE command
(page 337).
326
Programming Commands
T2 [two] Line Trigger
T2 [two]
Line Trigger
Syntax
T2 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The T2 [two] command sets the analyzer sweep to line trigger mode.
NOTE The functions of the T2 [two] command are identical to the TM LINE command
(page 337).
327
Programming Commands
T3 [three] External Trigger
T3 [three]
External Trigger
Syntax
T3 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The T3 [three] command sets the analyzer sweep to external trigger mode.
NOTE The functions of the T3 [three] command are identical to the TM EXT command
(page 337).
328
Programming Commands
T4 [four] Video Trigger
T4 [four]
Video Trigger
Syntax
T4 ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
The T4 [four] command sets the analyzer sweep to video trigger mode.
NOTE The functions of the T4 [four] command are identical to the TM VID command
(page 337).
329
Programming Commands
TA Trace A
TA
Trace A
Syntax
TA ? ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
Returns trace A amplitude values from the analyzer to the controller.
The display unit values are transferred in sequential order (from left to right) as seen on the screen.
Display unit values can be transferred to the controller in any one of the four output formats as
determined by the O1 [one] (page 275), O2 [two] (page 276), O3 [three] (page 277) and O4 [four]
commands (page 278).The format of the returned data is also affected by the TDF (Trace Data Format)
(page 332) command and, if TDF B (binary data format) has been selected, by the MDS command
(page 234).
330
Programming Commands
TB Trace B
TB
Trace B
Syntax
TB ? ;
LF
CR
SP
Legacy Products
8566A/B, 8568A/B
Description
Returns trace B amplitude values from the analyzer to the controller.
The display unit values are transferred in sequential order (from left to right) as seen on the screen.
Display unit values can be transferred to the controller in any one of the four output formats as
determined by the O1 [one] (page 275), O2 [two] (page 276), O3 [three] (page 277) and O4 [four]
commands (page 278). The format of the returned data is also affected by the TDF (Trace Data Format)
(page 332) command and, if TDF B (binary data format) has been selected, by the MDS command
(page 234).
331
Programming Commands
TDF Trace Data Format
TDF
Trace Data Format
Syntax
TDF SP P ;
A LF
I
CR
M
SP
B
? ,
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Formats trace information for return to the controller.
The different trace data formats are as follows:
• M selects the ASCII data format.
• P selects parameter data format. Numbers are in Hz, Volts, Watts, dBm, dBmV, DBuV, DBV.
• Specifying A returns data as an A-block data field. The MDS command determines whether data
comprises one or two 8-bit bytes. (See MDS (page 234))
• Specifying I returns data as an I-block data field. The MDS command determines whether data
comprises one or two 8-bit bytes. (See MDS (page 234))
• B selects binary data format. The MDS command determines whether data comprises one or two
8-bit bytes
332
Programming Commands
TH Threshold
TH
Threshold
Syntax
8560 series:
TH SP real DM ;
MV LF
SP UP UV
CR
DN DB
SP
ON
OFF ,
OA
8566A/B, 8568A/B:
TH SP real DM ;
MV
SP UP UV
DN DB
OA
?
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The TH command blanks signal responses below the threshold level, similar to a base line clipper. The
threshold level is nine major divisions below the reference level, unless otherwise specified. The UP and
DN commands move the threshold 10 dB.
333
Programming Commands
THE Threshold Enable
THE
Threshold Enable
Syntax
THE SP ON ;
OFF
?
Legacy Products
8566A/B, 8568A/B
Description
Turns the threshold on or off.
334
Programming Commands
TIMEDATE Time Date
TIMEDATE
Time Date
Syntax
TIMEDATE SP number ;
LF
?
CR
SP
Legacy Products
8560 series
Description
Sets and returns the date and time of the real-time clock of the analyzer. The number takes the form
YYMMDDHHMMSS (Year, Month, Day, Hour, Minute, Second).
TIMEDATE ON and TIMEDATE OFF commands are supported on some models of the 8560 series.
This set of commands displays or hides the time and date in the graticule. The N9061A application on
the X-series analyzers does not support these commands but accepts them and does not display a CMD
ERR error or CMD NOT SUPPORTED error.
NOTE This command changes the system clock of the instrument and may invalidate any
time-based licenses installed on the instrument.
335
Programming Commands
TITLE Title
TITLE
Title
Syntax
string string
TITLE delimiter
char real
delimiter
;
LF
CR
SP
Legacy Products
8560 series
Description
The TITLE command activates the screen title mode, enabling you to enter your own title for the screen.
Valid string delimiters which must be used to start and terminate the title are shown below. See 8560
Series User’s Guide for more details.
• !
• “
• $
• %
• &
• ‘
• /
• :
• =
• \
• ~
• @
336
Programming Commands
TM Trigger Mode
TM
Trigger Mode
Syntax
TM SP FREE ;
VID LF
LINE
CR
EXT
SP
?
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Selects a trigger mode: free, line, video, or external.
NOTE The functions of the TM command are identical to the T1 (page 326), T2
(page 327), T3 (page 328) and T4 (page 329) commands.
337
Programming Commands
TRA Trace Data Input and Output
TRA
Trace Data Input and Output
Syntax
TRA ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The TRA command transfers Trace A amplitude values from the analyzer to the controller. The format
depends on the trace data format selected. See the TDF command (page 332) for details on formatting.
338
Programming Commands
TRB Trace Data Input and Output
TRB
Trace Data Input and Output
Syntax
TRB ? ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
The TRB command transfers Trace B amplitude values between the analyzer and the controller. The
format depends on the trace data format selected. See “TDF Trace Data Format” on page 332 for details
on formatting.
339
Programming Commands
TRC Trace Data Input and Output
TRC
Trace Data Input and Output
Syntax
TRC ? ;
Legacy Products
8566A/B, 8568A/B
Description
The TRC command transfers Trace Amplitude values from the analyzer to the controller. The format
depends on the trace data format selected. See the TDF command (page 332) for details on formatting.
340
Programming Commands
TRDSP Trace Display
TRDSP
Trace Display
Syntax
TRDSP SP TRA , ON ;
TRB SP OFF
TRC 1
Legacy Products
8566A/B, 8568A/B
Description
Displays a trace or turns it off.
341
Programming Commands
TRIGPOL Trigger Polarity
TRIGPOL
Trigger Polarity
Syntax
TRIGPOL SP POS ;
NEG LF
?
CR
SP
Legacy Products
8560 series
Description
Selects the edge (positive or negative) of the trigger input that causes the trigger event. TRIGPOL is
available in all trigger modes.
342
Programming Commands
TRSTAT Trace State
TRSTAT
Trace State
Syntax
TRSTAT ? ;
Legacy Products
8566A/B, 8568A/B
Description
The TRSTAT command returns trace states to the controller. Valid trace states are Clear-write, Off,
View, Maximum Hold, and Blank.
Table 4-27 Possible Trace States
Clear-write CLRW
View VIEW
Blank BLANK
343
Programming Commands
TS Take Sweep
TS
Take Sweep
Syntax
TS ;
LF
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Starts and completes one full sweep before the next command is executed. A TS command is required
for each sweep in the single-sweep mode. TS always restarts a sweep even if a sweep is already in
progress.
344
Programming Commands
VAVG Video Average
VAVG
Video Average
Syntax
8560 series:
average
VAVG SP
length
;
LF
SP UP
CR
DN
ON SP
OFF
,
?
8566A/B, 8568A/B:
average
VAVG SP
length
;
SP ON
OFF
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Enables the video-averaging function, which averages trace points to smooth the displayed trace. When
queried, the VAVG command returns the number of averages for the 8560 series of analyzers.
345
Programming Commands
VAVG Video Average
NOTE There are a few differences in the way video averaging works in the N9061A
application compared to the legacy analyzers. See the following table for a
summary of these differences.
All conditions. 8566 and 8568 only - Original Only displays the averaged trace.
trace is displayed in Trace C. The averaged trace is displayed
in Trace A.
Average Count value set to 0. Cannot be set to 0. Video averaging is turned off if
the Averaging Count is set to 0.
Change in Average Count 8566 and 8568 only - Resets the counter to zero and
setting to a higher value. Continues counting from starts the measurement again.
where the previous value left
off.
Change in average counter 8566 and 8568 only - Updates If the new count value has not
setting to a lower value. the screen annotation with the been reached, continues until the
lower averaging value. new lower count has been
reached.
If the new, lower count value has
already been reached, the
analyzer will stop and wait until
you take a new sweep.
Averaging turned on. Sweep time remains Sweep time changes due to the
unchanged. selection of the sample detector.
Change in resolution 8566 and 8568 only - In single Continues the measurement
bandwidth, video bandwidth, sweep mode, resets counter to without resetting the counter.
sweep time, reference level zero and starts the averaging
or attenuation. again.
Change in center frequency In single sweep mode, resets In single sweep mode the
or span. counter to zero and starts the X-Series analyzer uses all stored
averaging again. 8566 and averages. Does not reset the
8568 only - Also reset the counter after changes in RBW,
counter after changes in RBW, VBW, Sweep Time, Ref. Level
VBW, Sweep Time, Ref. Level and Attenuation.
and Attenuation.
NOTE For 8566A/B, 8568A/B, the functions of the VAVG command are identical to the
KSG (page 193)or KSH command (page 195).
346
Programming Commands
VB Video Bandwidth
VB
Video Bandwidth
Syntax
8560 series:
VB SP real HZ ;
KHZ LF
MHZ
CR
SP UP
GHZ
DN SP
KZ
AUTO
MZ ,
MAN
GZ
OA
8566A/B, 8568A/B:
VB SP real HZ ;
KHZ
MHZ
SP UP
GHZ
DN
KZ
OA
MZ
GZ
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Specifies the video bandwidth, which is a post-detection, low-pass filter.
347
Programming Commands
VB Video Bandwidth
When auto coupled, the video bandwidth is calculated as Resolution Bandwidth x Video Resolution
Bandwidth Ratio. See the VBO command (page 349) for more details.
348
Programming Commands
VBO Video Bandwidth Coupling Offset
VBO
Video Bandwidth Coupling Offset
Syntax
VBO SP 1 ;
-1
Legacy Products
8566A/B, 8568A/B
Description
The VBO command specifies the relationship between the video and resolution bandwidths which is
maintained when these bandwidths are coupled. The bandwidths are usually coupled unless the RB
command (page 295) or VB command (page 347) have been executed.
• When 0 is selected, the ratio remains fixed at 1. That is, the resolution bandwidth and the video
bandwidth are always equal
• When 1 is selected, the video bandwidth is one step higher than the resolution bandwidth. That is, the
video bandwidth:resolution bandwidth ratio is three.
• When -1 is selected, the video bandwidth is one step lower than the resolution bandwidth. That is, the
video bandwidth:resolution bandwidth ratio is 0.3.
349
Programming Commands
VBR Video Bandwidth to Resolution Bandwidth Ratio
VBR
Video Bandwidth to Resolution Bandwidth Ratio
Syntax
VBR SP number ;
LF
SP UP
DN CR
OA
SP
?
Legacy Products
8560 series
Description
The VBR command specifies the relationship between the video and resolution bandwidths that is
maintained when these bandwidths are coupled.
NOTE VBR uses the legacy signal analyzer settings for video bandwidth only if Mode
Setup > Preferences> Limit RBW/VBW is set to ON.
350
Programming Commands
VIEW View Trace
VIEW
View Trace
Syntax
8560 series:
VIEW SP TRA ;
TRB LF
CR
SP
8566A/B, 8568A/B:
VIEW SP TRA ;
TRB LF
TRC
CR
SP
Legacy Products
8560 series, 8566A/B, 8568A/B
Description
Displays Trace A or Trace B and stops taking new data into the viewed trace.
NOTE The functions of the VIEW command are identical to the A3 (page 81) and B3
(page 112) commands. For 8566A/B, 8568A/B, the VIEW command is also
identical to KSj (page 198).
351
Programming Commands
VIEW View Trace
For information on the settings of the X-series analyzers when legacy instrument trace settings are sent,
see Table 4-4, “Legacy Products command mapping to X-series for trace/detector settings.”
352
Programming Commands
VTL Video Trigger Level
VTL
Video Trigger Level
Syntax
VTL SP number DB ;
DBM LF
SP UP DBM V
CR
DN DBUV
SP
MV
UV ,
MW
UW
DM
Legacy Products
8560 series
Description
The VTL command sets the signal level that triggers a sweep.
Note that setting a value for VTL sets the trigger mode to VIDEO, even if it was not already set to
VIDEO. (See “TM Trigger Mode” on page 337).
353
Programming Commands
XCH Exchange
XCH
Exchange
Syntax
TRB TRB
TRC TRC
Legacy Products
8566A/B, 8568A/B
Description
The XCH command exchanges the contents of the source and destination traces. The traces are analyzed
and adjusted to fit the number of display points on the screen.
NOTE The functions of the XCH TRA,TRB command are identical to the AXB
(page 109) and EX (page 155) commands.
The functions of the XCH TRB,TRC command are identical to the BXC
(page 118) and KSi (page 197) commands.
354
5 A Brief Introduction to the SCPI
Language
355
A Brief Introduction to the SCPI Language
SCPI Language Basics
NOTE The command SENS:FREQU:STAR is not valid because FREQU is neither the
short, nor the long form of the command. Only the short and long forms of the
keywords are allowed in valid commands.
356
A Brief Introduction to the SCPI Language
SCPI Language Basics
command. These are examples of valid commands for a given command syntax:
[SENSe:]BANDwidth[:RESolution] <freq> The following sample commands are all identical. They
all cause the same result.
• Sense:Band:Res 1700
• BANDWIDTH:RESOLUTION 1.7e3
• sens:band 1.7KHZ
• SENS:band 1.7E3Hz
• band 1.7kHz
• bandwidth:RES 1.7e3Hz
MEASure:SPECtrum[n]? • MEAS:SPEC?
• Meas:spec?
• meas:spec3?
The number 3 in the last meas example causes it to
return different results then the commands above it.
See the command description for more information.
• INIT:CONT ON
• init:continuous 1
357
A Brief Introduction to the SCPI Language
SCPI Language Basics
358
A Brief Introduction to the SCPI Language
SCPI Language Basics
Parameters in Commands
There are four basic types of parameters: booleans, keywords, variables and arbitrary block program
data.
OFF|ON|0|1
(Boolean) This is a two state boolean-type parameter. The numeric value 0 is equivalent to OFF.
Any numeric value other than 0 is equivalent to ON. The numeric values of 0 or 1 are
commonly used in the command instead of OFF or ON. Queries of the parameter
always return a numeric value of 0 or 1.
keyword The keywords that are allowed for a particular command are defined in the command
syntax description.
Units Numeric variables may include units. The valid units for a command depend on the
variable type being used. See the following variable descriptions. The indicated
default units are used if no units are sent. Units can follow the numerical value with,
or without, a space.
Variable A variable can be entered in exponential format as well as standard numeric format.
The appropriate range of the variable and its optional units are defined in the
command description.
The following keywords may also be used in commands, but not all commands allow
keyword variables.
• DEFault - resets the parameter to its default value.
• UP - increments the parameter.
• DOWN - decrements the parameter.
• MINimum - sets the parameter to the smallest possible value.
• MAXimum - sets the parameter to the largest possible value.
The numeric value for the function’s MINimum, MAXimum, or DEFault can be
queried by adding the keyword to the command in its query form. The keyword must
be entered following the question mark.
Example query: SENSE:FREQ:CENTER? MAX
359
A Brief Introduction to the SCPI Language
SCPI Language Basics
Variable Parameters
<integer> is an integer value with no units.
<real> Is a floating point number with no units.
<freq>
<bandwidth> Is a positive rational number followed by optional units. The default unit is Hertz.
Acceptable units include: Hz, kHz, MHz, GHz.
<time>
<seconds> Is a rational number followed by optional units. The default units are seconds.
Acceptable units include: ks, s, ms, us, ns.
<voltage> Is a rational number followed by optional units. The default units are Volts.
Acceptable units include: V, mV, μV, nV
<current> Is a rational number followed by optional units. The default units are Amperes.
Acceptable units include: A, mA, μA, nA.
<power> Is a rational number followed by optional units. The default units are W. Acceptable
units include: mAW, kW, W, mW, μW, nW, pW.
<ampl> Is a rational number followed by optional units. The default units are dBm.
Acceptable units include: dBm, dBmV, dBμV.
<rel_power>
<rel_ampl> Is a positive rational number followed by optional units. The default units are dB.
Acceptable units include: dB.
<percent> Is a rational number between 0 and 100. You can either use no units or use PCT.
<angle>
<degrees> Is a rational number followed by optional units. The default units are degrees.
Acceptable units include: DEG, RAD.
<string> Is a series of alpha numeric characters.
<bit_pattern> Specifies a series of bits rather than a numeric value. The bit series is the binary
representation of a numeric value. There are no units.
Bit patterns are most often specified as hexadecimal numbers, though octal, binary or
decimal numbers may also be used. In the SCPI language these numbers are specified
as:
• Hexadecimal, #Hdddd or #hdddd where ‘d’ represents a hexadecimal digit 0 to 9
and ‘a’ to ‘f’. So #h14 can be used instead of the decimal number 20.
• Octal, #Odddddd or #odddddd where ‘d’ represents an octal digit 0 to 7. So #o24
can be used instead of the decimal number 20.
• Binary, #Bdddddddddddddddd or #bdddddddddddddddd where ‘d’ represents a 1
or 0. So #b10100 can be used instead of the decimal number 20.
360
A Brief Introduction to the SCPI Language
SCPI Language Basics
361
A Brief Introduction to the SCPI Language
SCPI Language Basics
The following are some examples of good and bad commands. The examples are created from a
theoretical instrument with the simple set of commands indicated below:
[:SENSe]
:POWer
[:RF]
:ATTenuation 40dB
:TRIGger
[:SEQuence]
:EXTernal [1]
:SLOPe
POSitive
[:SENSe]
:FREQuency
:STARt
:POWer
[:RF]
:MIXer
:RANGe
[:UPPer]
The MIX:RANG command is in the same :SENSE subsystem as FREQ, but executing
the FREQ command puts you back at the SENSE level. You must specify POW to get to
the MIX:RANG command.
:POW:ATT?:FREQ:STAR? :POW:ATT?;:FREQ:STAR?
:POW and FREQ are within the same :SENSE subsystem, but they are two separate
commands, so they should be separated with a semicolon, not a colon.
362
Index
363
Index
364
Index
365
Index
minimum O preset
hold, 239 O1, 275 fast, 210
marker, 205, 250 O2, 276 preset instrument, 178
x position, 240 O3, 277 PRINT, 289
MINPOS, 240 O4, 278 programming
mixer level, 179, 267 OA, 279 command parameters, 359
MKA, 241 OCCUP, 280 command syntax, 356
MKACT, 242 occupied power bandwidth, 280 SCPI basics, 356
MKBW, 243 occupied power bandwidth within delta valid commands, 356
MKCF, 244 marker, 139 PWRBW, 290
MKD, 245 offset
MKF, 246 frequency, 159, 211 Q
MKFC, 247 reference level, 214, 304 query
MKFCR, 248 video bandwidth status byte, 320
MKMIN, 250 coupling, 349 sweep, 237
MKN, 251 OL, 281
MKNOISE, 252 OT, 284 R
MKOFF, 253 output data, identifying block size, 361
MKP, 254 R1, 291
output learn string, 281
MKPK, 255 R2, 292
output termination, 77
MKPT, 256 R3, 293
output trace annotations, 284
MKPX, 257 R4, 294
MKREAD, 258 P
ratio
MKRL, 260 VBW/RBW, 350
MKSP, 261 parameter (variables), 360 RB, 134, 295
MKSS, 262 parameters (commands), 359 RBR, 297
MKT, 263 parameters, variable, 360 RBW to span ratio, 297
MKTRACE, 264 parsing done, 145 RBW/VBW, 35
MKTRACK, 265 peak RC, 298
MKTYPE, 266 excursion marker, 257 RCLS, 299
ML, 267 marker, 147, 255 readout
mnemonic negative peak detection, 190 marker, 258
command, 76 pre-selector, 288 recall last state, 298
msb length, 77 peak position, 286 recall state, 299
MT0, 269 PEAKS, 285 recommended path, 76
MT1, 270 peaks, 285 reference level, 301
MXMH, 271 percent occupied power bandwidth, marker to, 150, 260
280 normalized, 273
N percent parameter (variables), 360 offset, 304
phase parameter (variables), 360 reference level offset, 214
N9061A-2FP - installation, 25 PKPOS, 286 reference position
negative peak detection, 190 PLOT, 287 normalized, 274
noise polarity Refresh log file, 34
marker, 252 trigger, 342 relative limit lines, 222
marker off, 201 position relative power parameter (variables),
marker on, 203 minimum x, 240 360
measurement, 252 positive peak detection, 186 remote language
signal to noise ratio, 252 power 8560E/EC, 29
normal bandwidth, 290 8561E/EC, 29
detection, 184 carrier off, 122 8562E/EC, 29
marker, 228, 251 carrier on, 123 8563E/EC, 29
normalize trace data, 272 channel, 127 8564E/EC, 29
normalized reference level, 273 percent occupied bandwidth, 280 8565E/EC, 29
normalized reference position, 274 power measurement HP8566B, 29
NORMLIZE, 272 mean, 236 HP8568B, 29
NRL, 273 power parameter (variables), 360 selection, 29
NRPOS, 274 PP, 288 repeating syntax element, 76
number syntax, 77 pre-selector peak, 288 request service conditions, 305
366
Index
367
Index
sweep times, 72 U W
synchronization, 72 units, 77 website
TITLE, 336 units parameter (commands), 359 firmware updates, 19
title, 336 units-key-pressed SRQ, 294
title mode, 191 unlock registers, 182 X
TM, 337 upper adjacent channel power, 98
TRA, 338 XCH, 354
upper-limit amplitude, 225
trace URL
A plus B to A, 188 signal analyzer updates, 19
Z
blank, 82, 115 user-defined SRQ, 316 zoom marker, 230
blank trace C, 200
data format, 332 V
data I/O, 330, 331, 338, 339
data input, 340 variable parameter (commands), 359
data output, 340 variables
exchange, 354 angle parameter, 360
exchange B and C, 197 bit_data parameter, 360
mean, 235 degree parameter, 360
output annotations, 284 frequency parameter, 360
returning values, 330, 331, 338, integer parameter, 360
339, 340 parameters, 360
smooth, 312 percent parameter, 360
standard deviation of amplitudes, phase parameter, 360
321 power parameter, 360
state, 343 relative power parameter, 360
storing values, 330, 331, 338, 339, string parameter, 360
340 time parameter, 360
transfer B to C, 202 voltage parameter, 360
view, 81, 112 VAVG, 345
view trace C, 198 VB, 347
trace B minus display line, 116 VBO, 349
trace data format, 361 VBR, 350
trace data input, 340 VBW/RBW ratio, 350
trace data input and output, 340 video average, 345
trace data output, 340 video averaging
trace display, 341 off, 195
trace marker, 264 on, 193
track marker, 265 video bandwidth, 347
transfer traces coupling, 137
B to C, 117, 202 coupling offset, 349
TRB, 339 video bandwidth to resolution
TRC, 340 bandwidth ratio, 350
TRCSP, 341 video trigger, 213, 329
trigger video trigger level, 353
external, 212, 328 video trigger mode, 337
free run, 326 VIEW, 351
line, 327 view
mode, 337 mode, 81, 112
polarity, 342 trace, 351
video, 213, 329 trace C, 198
video level, 353 view trace, 81, 112
triggering the analyzer, 337 view trace, trace
TRIGPOL, 342 view, 351
TRSTAT, 343 voltage parameter (variables), 360
TS, 344 VTL, 353
turning logging on, 33
TV trigger mode, 337
368