Agilent X-Series Signal Analyzer This manual provides documentation for the following X-Series Analyzers: EXA Signal Analyzer N9010A MXA Signal Analyzer N9020A N9061A Remote Language Compatibility Guide Agilent Technologies Notices © Agilent Technologies, Inc. 2008 Manual Part Number No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Agilent Technologies, Inc. as governed by United States and international copyright laws. N9020-90091 Supersedes: N9020-90080 October 2008 Printed in USA Agilent Technologies, Inc. 1400 Fountaingrove Parkway Santa Rosa, CA 95403 Trademark Acknowledgements Microsoft® is a U.S. registered trademark of Microsoft Corporation. ® Print Date ® Windows and MS Windows are U.S. registered trademarks of Microsoft Corporation. Adobe Reader® is a U.S. registered trademark of Adobe System Incorporated. Java™ is a U.S. trademark of Sun Microsystems, Inc. MATLAB® is a U.S. registered trademark of Math Works, Inc. Norton Ghost™ is a U.S. trademark of Symantec Corporation. Warranty The material contained in this document is provided “as is,” and is subject to being changed, without notice, in future editions. Further, to the maximum extent permitted by applicable law, Agilent disclaims all warranties, either express or implied, with regard to this manual and any information contained herein, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. Agilent shall not be liable for errors or for incidental or consequential damages in connection with the furnishing, use, or performance of this document or of any information contained herein. Should Agilent and the user have a separate written agreement with warranty terms covering the material in this document that conflict with these terms, the warranty terms in the separate agreement shall control. Technology Licenses The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license. Restricted Rights Legend If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and licensed as “Commercial computer soft- ware” as defined in DFAR 252.227-7014 (June 1995), or as a “commercial item” as defined in FAR 2.101(a) or as “Restricted computer software” as defined in FAR 52.227-19 (June 1987) or any equivalent agency regulation or contract clause. Use, duplication or disclosure of Software is subject to Agilent Technologies’ standard commercial license terms, and non-DOD Departments and Agencies of the U.S. Government will receive no greater than Restricted Rights as defined in FAR 52.227-19(c)(1-2) (June 1987). U.S. Government users will receive no greater than Limited Rights as defined in FAR 52.22714 (June 1987) or DFAR 252.227-7015 (b)(2) (November 1995), as applicable in any technical data. Safety Notices CAUTION: A CAUTION notice denotes a hazard. It calls attention to an operating procedure, practice, or the like that, if not correctly performed or adhered to, could result in damage to the product or loss of important data. Do not proceed beyond a CAUTION notice until the indicated conditions are fully understood and met. WARNING: A WARNING notice denotes a hazard. It calls attention to an operating procedure, practice, or the like that, if not correctly performed or adhered to, could result in personal injury or death. Do not proceed beyond a WARNING notice until the indicated conditions are fully understood and met. 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 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. Where to Find the Latest Information Documentation is updated periodically. For the latest information about this analyzer, including firmware upgrades, application information, and product information, see the following URLs: http://www.agilent.com/find/mxa http://www.agilent.com/find/exa To receive the latest updates by email, subscribe to Agilent Email Updates: http://www.agilent.com/find/emailupdates Information on preventing analyzer damage can be found at: http://www.agilent.com/find/tips Contents Getting Started N9061A Application Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Hardware and Firmware Requirements for N9061A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Installing the N9061A application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Setting up N9061A on the X-Series Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Running Software that Requires SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Service and Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Documentation for the N9061A application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 2. Legacy Analyzer Command List Table of All Legacy Analyzer Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 3. Hints and Tips Hints and Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 4. Programming Commands Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Programming Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 A1 [one] Clear Write for Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 A2 [two] Maximum Hold for Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 A3 [three] View Mode for Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 A4 [four] Blank Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 ACPALPHA Adjacent Channel Power Alpha Weighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 ACPALTCH Adjacent Channel Power Alternate Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 ACPBRPER Adjacent Channel Power Burst Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 ACPBRWID Adjacent Channel Power Burst Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 ACPBW Adjacent Channel Power Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 ACPCOMPUTE Adjacent Channel Power Compute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 ACPFRQWT Adjacent Channel Power Frequency Weighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 ACPLOWER Lower Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 ACPMAX Maximum Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 ACPMEAS Measure Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 ACPMSTATE Adjacent Channel Power Measurement State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 5 Table of Contents 1. Table of Contents Contents ACPPWRTX Adjacent Channel Power Total Power Transmitted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACPRSLTS Adjacent Channel Power Measurement Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACPSP Adjacent Channel Power Channel Spacing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACPT Adjacent Channel Power T Weighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACPUPPER Upper Adjacent Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADJALL LO and IF Adjustments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AMB A minus B into A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AMBPL (A minus B) plus Display Line into A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ANNOT Annotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . APB Trace A Plus Trace B to A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AT Input Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AUNITS Absolute Amplitude Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AUTOCPL Auto Coupled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AXB Exchange Trace A and Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B1 [one] Clear Write for Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B2 [two] Maximum Hold for Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B3 [three] View Mode for Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B4 [four] Blank Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BL Trace B minus Display Line to Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BLANK Blank Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BML Trace B Minus Display Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C1 [one] Set A Minus B Mode Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C2 [two] A Minus B Into A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CA Couple Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CARROFF 6 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 Contents 7 Table of Contents Carrier Off Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 CARRON Carrier On Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 CF Center Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 CHANNEL Channel Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 CHANPWR Channel Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 CHPWRBW Channel Power Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 CLRW Clear Write . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 CONTS Continuous Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 COUPLE Input Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 CR Couple Resolution Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 CS Couple Frequency Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 CT Couple Sweep Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 CV Couple Video Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 DELMKBW Occupied Power Bandwidth Within Delta Marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 DET Detection Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 DL Display Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 DLYSWP Delay Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 DONE Done . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 E1[one] Peak Marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 E2 [two] Marker to Center Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 E3 [three] Delta Marker Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 E4 [four] Marker to Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 ERR Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 ET Elapsed Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 EX Exchange Trace A and Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Table of Contents Contents FA Start Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FB Stop Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FDSP Frequency Display Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FOFFSET Frequency Offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FREF Frequency Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FS Full Span . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GATE Gate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GATECTL Gate Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GD Gate Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GL Gate Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GP Gate Polarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GRAT Graticule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HD Hold Data Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I1 [one] Set RF Coupling to DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I2 [two] Set RF Coupling to AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ID Identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IP Instrument Preset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L0 [zero] Display Line Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LG Logarithmic Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LN Linear Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M1 [one] Marker Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M2 [two] Marker Normal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . M3 [three] Delta Marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MA Marker Amplitude Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MEAN 8 117 118 119 120 121 122 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 142 Contents 9 Table of Contents Trace Mean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 MEANPWR Mean Power measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 MEAS Meas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 MF Marker Frequency Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 MINH Minimum Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 MKA Marker Amplitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 MKBW Marker Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 MKCF Marker to Center Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 MKD Marker Delta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 MKF Marker Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 MKFC Marker Counter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 MKFCR Marker Counter Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 MKMIN Marker Minimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 MKN Marker Normal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 MKNOISE Marker Noise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 MKOFF Marker Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 MKPK Marker Peak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 MKPT Marker Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 MKPX Marker Peak Excursion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 MKRL Marker to Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 MKSP Marker to Span . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 MKSS Marker to Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 MKT Marker Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 MKTRACK Marker Track . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 ML Mixer Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Table of Contents Contents MT0 [zero] Marker Track Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MT1 [one] Marker Track On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MXMH Maximum Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NORMLIZE Normalize Trace Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NRL Normalized Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NRPOS Normalized Reference Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OCCUP Percent Occupied Power Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PLOT Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PP Preselector Peak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PRINT Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PWRBW Power Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RB Resolution Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RBR Resolution Bandwidth to Span Ratio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RC Recall State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RCLS Recall State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . REV Revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RL Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ROFFSET Reference Level Offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RQS Request Service Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S1[one] Continuous Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S2 [two] Single Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAVES Save State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SER Serial Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SETDATE Set Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SETTIME 10 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 Contents 11 Table of Contents Set Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 SNGLS Single Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 SP Frequency Span . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 SRQ Service Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 SS Center Frequency Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 ST Sweep Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 STB Status Byte Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 SUM Sum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 SV Save State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 SWPCPL Sweep Couple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 T1 [one] Free Run Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 T2 [two] Line Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 T3 [three] External Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 T4 [four] Video Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 TA Trace A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 TB Trace B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 TDF Trace Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 TH Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 TIMEDATE Time Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 TITLE Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 TM Trigger Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 TRA Trace Data Input and Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 TRB Trace Data Input and Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 TRIGPOL Trigger Polarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 TS Take Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 Table of Contents Contents VAVG Video Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VB Video Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBR Video Bandwidth to Resolution Bandwidth Ratio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VIEW View Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VTL Video Trigger Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. 12 218 219 220 221 222 A Brief Introduction to the SCPI Language SCPI Language Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 Getting Started 1 Getting Started 13 Getting Started N9061A Application Description N9061A Application Description The N9061A application is the remote language compatibility suite for the Agilent Technologies’ X-Series of signal analyzers. It allows the analyzers to be controlled using many of the remote programming commands from the following analyzers: • 8560 E/EC Series Portable Spectrum Analyzers, comprising: Getting Started — — — — — — — — — — — — 8560E 8560EC 8561E 8561EC 8562E 8562EC 8563E 8563EC 8564E 8564EC 8565E 8565EC 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. N9061A Limitations The N9061A application has been designed to emulate as closely as possible the operation of the specified spectrum analyzers. It is not, however, intended as an absolute direct replacement for these analyzers. Supported commands Only a subset of the 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 which 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 which 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. 14 Chapter 1 Getting Started N9061A Application Description Predefined Functions In the 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 8560 Series no longer do so. User-defined Functions Chapter 1 15 Getting Started No user-defined functions, traces, or variables (FUNCDEF, TRDEF or VARDEF) can be used as arguments or commands in programs controlling any analyzer running N9061A. In addition, the behavior of certain commands that rely on the “active functions” (UP, DN, etc.) may be slightly different. Getting Started Hardware and Firmware Requirements for N9061A Hardware and Firmware Requirements for N9061A One of the following Agilent signal analyzers is required to run the N9061A application. Getting Started Table 1-1 Compatible Agilent EXA Series Signal Analyzers Analyzer Model Number Upper Frequency Limit Firmware N9010A-503 3.6 GHz Rev A.01.60 or later N9010A-507 7 GHz Rev A.01.60 or later N9010A-513 13.6 GHz Rev A.01.60 or later N9010A-526 26.5 GHz Rev A.01.60 or later Table 1-2 Compatible Agilent MXA Series Signal Analyzers Analyzer Model Number Upper Frequency Limit Firmware N9020A-503 3.6 GHz Rev A.01.60 or later N9020A-507 8.4 GHz Rev A.01.60 or later N9020A-513 13.6 GHz Rev A.01.60 or later N9020A-526 26.5 GHz Rev A.01.60 or later 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-3 Frequency Ranges of the Legacy Analyzers Remote Language 16 Start Frequency Stop Frequency 8560E/EC 30 Hz 2.9 GHz 8561E/EC 30 Hz 6.5 GHz 8562E/EC 30 Hz 13.2 GHz 8563E/EC 9 kHz 26.5 GHz 8564E/EC 9 kHz 40.0 GHz 8565E/EC 9 kHz 50.0 GHz Chapter 1 Getting Started Installing the N9061A application Installing the N9061A application Remote language compatibility for the 8560 series of analyzers is a licensed application on the X-Series analyzers and is called N9061A-2FP. The application must be installed on the X-Series analyzer and licensed for it to work correctly. Installation The N9061A-2FP 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/exa_software http://www.agilent.com/find/mxa_software NOTE No calibration is required after the N9061A application is installed. 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. Required Information: Front Panel Key Path: Model #: (Ex. N9020A) Instrument Serial Number: __________________ System > Show > System The license is downloaded from the license website onto a USB storage device so that it can be loaded into the instrument. A license key is usually for one instrument model/serial number combination. The license key can only be installed on that instrument. Chapter 1 17 Getting Started • Getting Started Installing the N9061A application Getting Started License Installation Procedure over USB 1. Redeem the Option Upgrade Entitlement Certificate by following the instructions on the Certificate. 2. After redeeming your Option Upgrade Entitlement Certificate you will receive an e-mail with an attached License File. 3. Locate a USB storage device and save the .lic file to the root directory of the USB storage device. 4. Connect the USB storage device to one of the signal analyzer USB ports. Windows detects the new hardware and may display the configuration menu. This menu may be configured according to your preferences. 5. The signal analyzer automatically consumes the license file. (This may take a few minutes) When the license is consumed the Agilent License Manager displays a “Successful License Installation” message. 6. Alternatively the license file can be manually installed over USB or LAN by placing the license file in the following folder on the signal analyzer. C:\Program Files\Agilent\licensing Verify the Installation 1. Press System > Show > System to display the list of installed applications. 2. Verify that the new application appears in the list. If you require further assistance, please contact the Agilent support team. Online assistance: http://www.agilent.com/find/assist If you do not have access to the Internet, contact your local Agilent Technologies Sales and Service Office, or if in the United States, call 1-800-829-4444. 18 Chapter 1 Getting Started Setting up N9061A on the X-Series Analyzer Setting up N9061A on the X-Series Analyzer Figure 1-1 is an example mode menu map showing the N9061A (Remote Language Compatibility) application selection on your signal analyzer. To select the N9061A application, press the Mode hardkey on the X-Series analyzer front panel and then select the Remote Language Compatibility mode. If there are more than six modes on the signal analyzer, then use the More button to find the Remote Language Compatibility selection. Figure 1-1 Example Mode Menu Map for X-Series Analyzers Mode Mode Getting Started Spectrum Analyzer IQ Analyzer (BASIC) W-CDMA with HSDPA/PSUPPA Phase Noise Remote Language Compatibility Chapter 1 19 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 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 Mode Setup HP8560E/EC HP8560 series HP8563E/EC Getting Started HP8561E/EC HP8562E/EC HP8563E/EC Cmd Error On Off Logging HP8564E/EC Logging HP8565E/EC Preferences Preferences Restore Mode Defaults The HP8560 series key allows 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. A customer 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?”. 20 Chapter 1 Getting Started Setting up N9061A on the X-Series Analyzer The legacy instrument selections are as follows: 8560E/EC 8561E/EC 8562E/EC 8564E/EC 8565E/EC Table 1-4 Span, Trace Points, Couplings, VBW/RBW Ratio, and Span/RBW Ratio Settings Remote Language Start Freq. Stop Freq. Number of Trace Points RF Coupling VBW/ RBW Ratio Span/RBW Ratio 8560E/EC 30 Hz 2.9 GHz 601 AC 1 91 8561E/EC 30 Hz 6.5 GHz 601 AC 1 91 8562E/EC 30 Hz 13.2 GHz 601 AC 1 91 8563E/EC 30 Hz 26.5 GHz 601 DC 1 91 8564E/EC 30 Hz 40 GHz 601 DC 1 91 8565E/EC 30 Hz 50 GHz 601 DC 1 91 Chapter 1 21 Getting Started 8563E/EC Selects the 8560E/EC remote programming language and sets the response to the remote programming command ‘ID?’ to HP8560E. It also performs an instrument preset and sets Span, Trace Points, couplings, VBW/RBW ratio, and Span/RBW ratio appropriately as shown in Table 1-4. Selects the 8561E/EC remote programming language and sets the response to the remote programming command ‘ID?’ to HP8561E. It also performs an instrument preset and sets Span, Trace Points, couplings, VBW/RBW ratio, and Span/RBW ratio appropriately as shown in Table 1-4. Selects the 8562E/EC remote programming language and sets the response to the remote programming command ‘ID?’ to HP8562E. It also performs an instrument preset and sets Span, Trace Points, couplings, VBW/RBW ratio, and Span/RBW ratio appropriately as shown in Table 1-4. Selects the 8563E/EC remote programming language and sets the response to the remote programming command ‘ID?’ to HP8563E. It also performs an instrument preset and sets Span, Trace Points, couplings, VBW/RBW ratio, and Span/RBW ratio appropriately as shown in Table 1-4. This is the default setting for the N9061A application. Selects the 8564E/EC remote programming language and sets the response to the remote programming command ‘ID?’ to HP8564E. It also performs an instrument preset and sets Span, Trace Points, couplings, VBW/RBW ratio, and Span/RBW ratio appropriately as shown in Table 1-4. Selects the 8565E/EC remote programming language and sets the response to the remote programming command ‘ID?’ to HP8565E. It also performs an instrument preset and sets Span, Trace Points, couplings, VBW/RBW ratio, and Span/RBW ratio appropriately as shown in Table 1-4. 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. Figure 1-3 Logging Menu Map Logging Logging Previous Page Getting Started Next Page Cmd Error Log On Off Refresh Clear Log When you are in the Logging menu, the main Signal Analysis display is obscured by the logging page. Previous Page and Next Page allow you to scroll through the log file. To include commands sent to the analyzer since the log window display was opened, press Refresh. The Cmd Error Log option allows you to turn the command error logging on or off. The default is Off. Logging should not be used in a secure environment. When set to On, all error messages are stored in a log file, regardless of whether they have been displayed on the screen. When set to Off, no further command error messages are written to the log file. Switching Cmd Error Log to Off does not clear the log file. Only the Clear Log softkey clears the error log. To update the log page with new entries, select Refresh. The log file is also stored as a text file, called Logfile.txt, on the instrument; it is stored in the D:\ drive, in a folder called \User_My_Documents\[USERNAME]\My Documents\RLC\data. The log is cleared on power-up, or if you change the remote language selection. The maximum size of the log is 10 MB. When the file reaches its maximum size, the first ten percent of the file is automatically discarded, in order to clear space for subsequent error messages. 22 Chapter 1 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 which 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 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). Figure 1-4 Preferences Menu Map Preferences Preferences Limit RBW/VBW On Off On Swp Type Rule Off Sweep Type Rules Auto AC/DC Mode As Legacy Getting Started Atten Offset Auto AC/DC Mode As Legacy Always DC Coupled Always Best Dynamic Range Best Speed Legacy AC Coupled 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. 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. Sweep Type Rules changes the Auto rules for determining whether the instrument uses FFT or Swept mode (this can be manually overridden). FFT mode offers substantially faster measurements in some cases. 8560-series analyzers use both FFT and Swept mode, in which case “Legacy” is equivalent to “Dynamic range”. Chapter 1 23 Getting Started Setting up N9061A on the X-Series Analyzer Getting Started AC/DC Mode allows the user 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. 24 Chapter 1 Getting Started Running Software that Requires SCPI Commands Running Software that Requires SCPI Commands When a legacy remote language has been selected, you only have access to a very small subset of SCPI commands. If you are not familiar with the SCPI remote programming language, Chapter 5 , “A Brief Introduction to the SCPI Language,” on page 223 contains some useful information. The SCPI commands available while using other remote languages are: Table 1-5 SCPI Commands Description *IDN? Queries and returns the instrument identification string. *RST Performs an instrument preset. INSTrument:DEFault Restores mode defaults. INSTrument:SELect Selects an application by mode name. (Use RLC to select the N9061A application)a. INSTrument:SELect? INSTrument:NSELect INSTrument:NSELect? [:SENSe]:SWEep:TYPE AUTO|SWEep|FFT Getting Started SCPI Commands Selects an application by mode number. (Use 266 to select the N9061A application)a. Sets the Sweep Type. Defaults to AUTO. [:SENSe]:SWEep:TYPE? :SYSTem:OPTions? Returns a list of installed options. INPut:COUPling AC|DC|RLC Sets the input coupling.b Defaults to RLC. INPut:COUPling? :SYSTem:LANGuage HP8560E | HP8561E | HP8562E | HP8563E | HP8564E | HP8565E Sets the current remote language.b :SYSTem:LANGuage? [:SENSe]:RLC:SWEep:TYPE:AUTO:RULes AUTO|SPEed|DRANge|LEGACY Sets the auto rule setting for Sweep Type.b [:SENSe]:RLC:SWEep:TYPE:AUTO:RULes? [:SENSe]:RLC:BANDwidth:LIMit ON|OFF|1|0 [:SENSe]:RLC:BANDwidth:LIMit? [:SENSe]:RLC:ATTenuation:STATe ON|OFF|1|0 [:SENSe]:RLC:ATTenuation:STATe? Toggles legacy bandwidth limiting on and off.b Toggles internal attenuation on and off.b Defaults to OFF. a. After changing into or out of RLC mode, allow a 1s delay before sending subsequent commands. b. This command is only available if the N9061A application is installed on your analyzer. Chapter 1 25 Getting Started Service and Calibration Service and Calibration Getting Started Since the Performance Verification and Adjustment Software uses the SCPI command language, you need to leave the N9061A (RLC) application and change to the Spectrum Analyzer application prior to calibration or service of your Agilent signal analyzer. 26 Chapter 1 Getting Started Documentation for the N9061A application Documentation for the N9061A application Signal Analyzers with N9061A When you purchase your X-Series signal analyzer with the Remote Language Compatibility Suite (N9061A), this manual - the Remote Language Compatibility Guide (N9020-90080) is included on the documentation CD and is installed on the analyzer in the online help. For information on EXA series analyzers and other related documentation, refer to the EXA web site at http://www.agilent.com/find/exa/. This Remote Language Compatibility Guide is not designed to be a comprehensive guide to all legacy commands. It gives brief descriptions of the supported commands, and highlights important functional or behavioral differences that you should be aware of when transferring your existing code to your X-Series analyzer. For a fuller description of these commands, refer to the manuals supplied with your original analyzer. Signal Analyzer Updates For the latest information about this instrument, including software upgrades, application information, and product information, please visit the URL below. http://www.agilent.com/find/mxa/ Chapter 1 27 Getting Started For information on MXA series analyzers and other related documentation, refer to the MXA web site at http://www.agilent.com/find/mxa/. Getting Started Getting Started Documentation for the N9061A application 28 Chapter 1 Legacy Analyzer Command List 2 Legacy Analyzer Command List 29 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table of All Legacy Analyzer Commands The following table lists all of the original programming commands from the legacy analyzers (that is, the 8560 Series), and indicates which are supported in N9061A. Refer to the alphabetical listing of commands in Chapter 4 , “Programming Commands,” on page 47 for more detailed information about each supported command. Legacy Analyzer Command List Table 2-1 30 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details A1 Clear-writes trace A Yes Page 51 A2 Max Holds trace A Yes Page 52 A3 View trace A Yes Page 53 A4 Blanks trace A Yes Page 54 ABORT Interrupt operation of all user-defined functions No ABS Absolute No ACPACCL Accelerate adjacent channel power measurement No ACPALPHA Adjacent channel power alpha weighting Yes Page 55 ACPALTCH Adjacent channel power alternate channels Yes Page 56 ACPBRPER Adjacent channel power burst period Yes Page 57 ACPBRWID Adjacent channel power burst width Yes Page 58 ACPBW Specifies channel bandwidth for ACP measurement Yes Page 59 ACPCOMPUTE Compute adjacent channel power Yes Page 60 ACPFRQWT Adjacent channel power frequency weighting Yes Page 61 ACPGRAPH Compute adjacent channel power graph No ACPLOWER Lower adjacent channel power Yes Page 62 Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Description Supported by N9061A Page for Further Details ACPMAX Maximum adjacent channel power Yes Page 63 ACPMEAS Measure adjacent channel power Yes Page 64 ACPMETHOD Adjacent channel power measurement method No ACPMSTATE Adjacent channel power measurement state Yes Page 65 ACPPWRTX Total power transmitted Yes Page 66 ACPRSLTS Adjacent channel power measurement results Yes Page 67 ACPSP Channel spacing Yes Page 68 ACPT Adjacent channel power T weighting Yes Page 69 ACPUPPER Upper adjacent channel power Yes Page 70 ACTVFUNC Creates a user defined active function No ADD Add No ADJALL LO & IF adjustment Yes ADJCRT Adjust CRT alignment No ADJIF Adjust IF No AMB Trace A − trace B -> trace A Yes Page 72 AMBPL Trace A − trace B + Display Line -> trace A Yes Page 73 AMPCOR Applies amplitude correction at specified frequencies No AMPCORDATA Amplitude correction data No AMPCORSAVE Save amplitude correction data No AMPCORSIZE Amplitude correction data array size No AMPCORRCL Amplitude correction recall No ANNOT Display Annotation Yes Chapter 2 Legacy Analyzer Command List Command Page 71 Page 74 31 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Legacy Analyzer Command List Table 2-1 32 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details APB Trace A + trace B -> trace A Yes Page 75 ARRAYDEF Defines an array No AT Input Attenuation Yes Page 76 AUNITS Amplitude Units Yes Page 77 AUTOCPL Auto couple Yes Page 78 AUTOEXEC Turns on or off the function defined with AUTOFUNC No AUTOFUNC Defines a function for automatic execution No AUTOSAVE Automatically saves trace No AVG Average No AXB Exchange Traces A & B Yes Page 79 B1 Clear-writes trace B Yes Page 80 B2 Max Holds trace B Yes Page 81 B3 View trace B Yes Page 82 B4 Blanks trace B Yes Page 83 BL Trace B − Display line -> trace B Yes Page 84 BLANK Blanks specified trace Yes Page 85 BML Trace B − Display line -> trace B Yes Page 86 C1 Turns off A - B Yes Page 87 C2 A − B -> A Yes Page 88 CA Couples Attenuation Yes Page 89 CARDLOAD Copies data from memory card to module memory No CARDSTORE Copies data to memory card No CARROFF Carrier off power Yes Page 90 CARRON Carrier on power Yes Page 91 CATALOG Catalog No Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details CF Center Frequency Yes Page 92 CHANNEL Channel selection Yes Page 93 CHANPWR Channel power Yes Page 94 CHPWRBW Channel power bandwidth Yes Page 95 CLRDSP Clear display No CLRSCHED Clears autosave & autoexec schedule buffer No CLRW Clear-writes specified trace Yes CNTLA Auxiliary interface control line A No CNTLB Auxiliary interface control line B No CNTLC Auxiliary interface control line C No CNTLD Auxiliary interface control line D No CNTLI Auxiliary interface control line input No CNVLOSS Selects ref level offset to calibrate amplitude display No CONTS Continuous sweep mode Yes Page 98 COUPLE Selects AC or DC coupling Yes Page 99 CR Couples Resolution BW Yes Page 100 CS Couples Step Size Yes Page 101 CT Couples Sweep Time Yes Page 102 CTRLHPIB Allows SA to control HP-IB No CV Couples Video Bandwidth Yes DATEMODE Set the date display format No DELMKBW Occupied power bandwidth within delta marker Yes DEMOD Turns the demodulator on or off No Legacy Analyzer Command List Chapter 2 Page 96 Page 103 Page 104 33 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Legacy Analyzer Command List Table 2-1 34 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details DEMODAGC Demodulation automatic gain control No DEMODT Demodulation time No DET Detection Mode Yes DISPOSE Frees Memory No DIV Divide No DL Display Line Level Yes Page 106 DLYSWP Delay sweep Yes Page 107 DONE Synchronizing function Yes Page 108 DSPLY Display No E1 Active marker to maximum signal Yes Page 109 E2 Active marker to center frequency Yes Page 110 E3 Active marker frequency to CF step size Yes Page 111 E4 Active marker to reference level Yes Page 112 EDITDONE Indicates limit line editing is complete No EDITLIML Allows current limit line to be edited No ELSE Conditional Programming (If…then…else…endif) No EM Erase user display memory No ENTER Enter from HP-IB No ERR Queries the error queue Yes Page 113 ET Elapsed time Yes Page 115 EX Exchanges trace A & B Yes Page 116 EXP Exponential No EXTMXR Presets external mixing mode No FA Start frequency Yes Page 105 Page 117 Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details FB Stop frequency Yes Page 118 FDIAG Frequency diagnostics No FDSP Frequency display off Yes FFT Fast fourier transform No FOFFSET Frequency offset Yes FORMAT Erase & format the selected memory device No FREF Frequency reference Yes Page 121 FS Full frequency span Yes Page 122 FULBAND Set start/stop freq for ext mixing bands No FUNCDEF Function definition No GATE Turn time-gating on or off Yes Page 124 GATECTL Gate control Yes Page 125 GD Gate delay Yes Page 126 GL Gate length Yes Page 127 GP Sets the polarity (positive/negative) of the gate trigger Yes Page 128 GRAT Graticule on/off Yes Page 129 HD Holds data entry Yes Page 130 HNLOCK Harmonic lock No HNUNLK Harmonic band unlock No ID Instrument identification Yes IDCF Identified signal to center frequency No IDFREQ Identified signal frequency No IF Conditional Programming (If…then…else…endif) No INT Integer No IP Instrument preset Yes Page 120 Legacy Analyzer Command List Chapter 2 Page 119 Page 133 Page 134 35 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Legacy Analyzer Command List Table 2-1 36 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A KEYCLR Clear user defined keys No KEYDEF Assign function to soft key No L0 Turns off the display line Yes LB Writes text label No LCLVAR Defines a local variable for use No LG Selects log scale Yes LIMD Delta amplitude value for limit line segment No LIMF Frequency value for limit-line segment No LIMIFAIL Limit line fail No LIMIPURGE Disposes of current limit line, not limit line table No LIMIRCL Load stored limit line into limit line table No LIMIREL Determine whether limit line values absolute/relative No LIMISAV Save contents of limit line table for recall No LIMITEST Compare active trace data to limit line parameters No LIML Amplitude value for limit line segment in lower limit line No LIMM Middle amplitude value for limit-line segment No LIMTFL Specifies a flat limit-line segment No LIMTSL Specifies a sloped limit-line segment No LIMU Amplitude value for limit line segment in upper limit line No LN Selects linear scale Yes LOG Log No Page for Further Details Page 135 Page 136 Page 137 Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details M1 Turns off all markers Yes Page 138 M2 Marker Normal Yes Page 139 M3 Marker Delta Yes Page 140 MA Returns the amplitude of active marker Yes Page 142 MBIAS Mixer bias No MEAN Returns mean value of trace in display units Yes Page 143 MEANPWR Mean power measurement Yes Page 144 MEAS Measurement status Yes Page 145 MEM Returns amount of memory available No MENU Menu No MF Returns frequency of the active marker Yes MIN Minimum No MINH Min Hold Yes Page 147 MKA Amplitude of the active marker Yes Page 148 MKBW Marker bandwidth Yes Page 149 MKCF Moves the active marker to center frequency Yes Page 150 MKCHEDGE Marker to channel edge No MKD Delta marker Yes MKDELCHBW Delta markers to channel power bandwidth No MKDR Reciprocal of marker delta No MKF Specifies the frequency of the active marker Yes Page 153 MKFC Turns the marker frequency counter on or off Yes Page 154 MKFCR Specifies the marker frequency counter resolution Yes Page 155 Legacy Analyzer Command List Chapter 2 Page 146 Page 151 37 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Legacy Analyzer Command List Table 2-1 38 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details MKMCF Marker mean to center frequency No MKMIN Moves active marker to minimum signal detected Yes Page 156 MKN Normal marker Yes Page 157 MKNOISE Marker noise function Yes Page 158 MKOFF Turns all markers or the active marker off Yes Page 159 MKPK Marker peak Yes Page 160 MKPT Marker peak threshold Yes Page 161 MKPX Marker peak excursion Yes Page 162 MKRL Moves the active marker to reference level Yes Page 163 MKSP Marker span Yes Page 164 MKSS Marker step size Yes Page 165 MKT Position marker in units of time Yes Page 166 MKTRACK Turns the marker signal track on or off Yes Page 167 ML Mixer Level Yes Page 168 MOD Modulo No MODRCLT Recalls trace from module memory No MODSAVT Saves trace in module memory No MOV Move No MPY Multiply No MSDEV Specifies mass storage device No MT0 Turns off marker signal track Yes Page 169 MT1 Turns on marker signal track Yes Page 170 MXM Maximum No MXMH Max Hold Yes MXRMODE Mixer mode No Page 171 Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Description Supported by N9061A Page for Further Details NORMLIZE Normalize trace data Yes Page 172 NRL Normalized reference level Yes Page 173 NRPOS Normalized reference position Yes Page 174 OCCUP Percent occupied power bandwidth Yes Page 175 ONEOS On end of sweep No OP Output parameters No OR Set position of origin No OUTPUT Output - sending data to the GPIB from function No PA Plot absolute No PD Pen down No PDA Probability distribution amplitude No PDF Probability distribution frequency No PEAKS Sorts the signal peaks by amplitude/frequency No PLOT Prints the screen Yes PLOTORG Display origins No PLOTSRC Plot source No PP Peaks the preselector Yes PR Plot relative No PRINT Print Yes PSDAC Preselector DAC number No PSTATE Protect state No PU Pen up No PWRBW Power bandwidth Yes Page 179 RB Resolution bandwidth Yes Page 180 RBR Resolution bandwidth/Span ratio Yes Page 181 Chapter 2 Legacy Analyzer Command List Command Page 176 Page 177 Page 178 39 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Legacy Analyzer Command List Table 2-1 40 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details RC Recalls state register Yes Page 182 RCLOSCAL Recall open/short average No RCLS Recall state Yes RCLT Recall trace No RCLTHRU Recall internal thru-reference trace into trace B No RELHPIB Release control of GPIB No REPEAT Conditional Programming (Repeat .. Until …) No RETURN Return to user defined function origination point No REV Returns the revision string to the controller Yes Page 184 RL Reference level Yes Page 185 RLCAL Reference level calibration No RMS Root mean square No ROFFSET Reference level offset Yes Page 186 RQS SRQ mask Yes Page 187 S1 Continuous sweep mode Yes Page 188 S2 Single sweep mode Yes Page 189 SADD Adds a limit line segment No SAVES Saves analyzer state to specified register Yes SAVET Save trace No SDEL Deletes a limit line segment No SDON Indicates limit line segment is done No SEDI Edits limit line segment No SENTER Segment entry for frequency limit lines No SER Serial number Yes Page 183 Page 190 Page 191 Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Description Supported by N9061A Page for Further Details SETDATE Set the date of analyzer Yes Page 192 SETTIME Set the time of analyzer Yes Page 193 SHOWMENU Shows menu No SIGID External mixing frequency bands signal identifier No SKYCLR Clears user softkey No SKYDEF Defines user softkey No SMOOTH Smooths given trace over specified number points No SNGLS Single sweep mode Yes Page 194 SP Frequency Span Yes Page 195 SQR Square root No SQUELCH Adjusts squelch level No SRCALC Selects internal or external level control No SRCCRSTK Coarse tracking adjust No SRCFINTK Fine tracking adjust No SRCPOFS Offset source power level No SRCPSTP Select source power step size No SRCPSWP Select sweep range of source output No SRCPWR Select source power level No SRCTKPK Auto adjust tracking of source output with SA sweep No SRQ Service request Yes Page 196 SS Frequency Step Size Yes Page 197 ST Sweep Time Yes Page 198 STB Status byte query Yes Page 199 STDEV Standard deviation of trace amplitude No STOREOPEN Save current instrument state No Chapter 2 Legacy Analyzer Command List Command 41 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Legacy Analyzer Command List Table 2-1 42 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Command Description Supported by N9061A Page for Further Details STORESHORT Store short No STORETHRU Store thru-calibration trace in trace B No SUB Subtract No SUM Sum of trace element amplitudes in display units Yes SUMSQR Squares trace element amplitudes & returns sum No SV Saves state Yes Page 201 SWPCPL Sweep couple Yes Page 202 SWPOUT Sweep output No T1 Sets the trigger mode to free run Yes Page 203 T2 Sets the trigger mode to line Yes Page 204 T3 Sets the trigger mode to external Yes Page 205 T4 Sets the trigger mode to video Yes Page 206 TA Returns trace A amplitude values to controller Yes Page 207 TB Returns trace B amplitude values to controller Yes Page 208 TDF Trace data format Yes Page 209 TEXT Writes text on the analyzer screen No TH Threshold Yes THEN Conditional Programming (If…then…else…endif) No TIMEDATE Allows setting of time & date for analyzer Yes Page 211 TITLE Title entry Yes Page 212 TM Trigger Mode Yes Page 213 TRA Returns trace A amplitude values to controller Yes Page 214 Page 200 Page 210 Chapter 2 Legacy Analyzer Command List Table of All Legacy Analyzer Commands Table 2-1 Alphanumeric List of all 8560 series Legacy Commands Showing their N9061A Support Description Supported by N9061A Page for Further Details TRB Returns trace B amplitude values to controller Yes Page 215 TRDEF Trace define No TRIGPOL Trigger polarity Yes Page 216 TS Takes a sweep Yes Page 217 TWNDOW Formats trace information for FFT. No UNTIL Conditional Programming (Repeat…Until…) No VARDEF Variable definition No VARIANCE Returns the amplitude variance of specified trace No VAVG Turns video averaging on or off Yes Page 218 VB Video Bandwidth Yes Page 219 VBR Video Bandwidth Ratio Yes Page 220 VIEW Stores and views the specified trace Yes Page 221 VTL Video trigger level Yes Page 222 Chapter 2 Legacy Analyzer Command List Command 43 Legacy Analyzer Command List Legacy Analyzer Command List Table of All Legacy Analyzer Commands 44 Chapter 2 3 Hints and Tips 45 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. Hints and Tips Hints and Tips Hints and Tips These pages lists a few hints and tips that will help you get the most from your analyzer and the N9061A application. • Compatibility - speed and consistency - for best compatibility with your legacy analyzer, the N9061A application should be used on the analyzer whose frequency range most closely matches the frequency range of your legacy analyzer. For example, the best match for the 8563E with its 26.5 GHz upper frequency limit is the MXA N9020A - 526 analyzer which also has an upper frequency limit of 26.5 GHz. • Sweep Times -When analyzing stationary signals, you can change to the Best Speed setting, which is accessed from the Mode Setup > Preferences > Swp Type Rule menu. This results in faster sweep times on a X-Series analyzer than on the legacy analyzers because of the X-Series analyzer’s better performance. In the majority of applications, this faster speed would be desirable, but that is not always the case. • Time-out - Agilent recommends increasing the timeout on a serial poll (SPOLL) due to differences in Sweep Times on some settings. Note, however, that this may not be necessary when using the Best Speed setting on the Preferences > Swp Type Rule menu (accessed from the Mode Setup hardkey). • Synchronization (1) - to synchronize after an IP command, Agilent recommends that you use the DONE command. We also suggest that the DONE command is used in conjunction with a timeout of about 5 seconds in case the analyzer starts to auto align. Alternatively, you could set auto alignment to Off. To set auto alignment to Off, press System, Alignments, Auto Align on the front panel. • Synchronization (2) - Agilent recommends that synchronization (using the DONE command) is used with marker functions when signal tracking is turned on. • Changing Modes - After changing into or out of RLC mode, allow at least a 1 second delay before sending subsequent commands. • AC and DC Coupling - The 8560 Series of legacy analyzers have one RF input port, and support AC and DC coupling through the COUPLE command (page 99). Hints and Tips WARNING If the input signal to the X-series analyzer has a DC component, then 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 calibrated when using AC coupling on these analyzers. 46 Chapter 3 Programming Commands 4 Programming Commands This chapter lists all the supported 8560 Series compatible commands in alphanumeric order, and gives brief details on their syntax and operation. For more detailed information on these commands, see your 8560 Series User’s Guide. 47 Programming Commands Programming Commands Command Syntax Command Syntax Command syntax is represented pictorially. NOTE • 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. 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. 48 Chapter 4 Table 4-1 Syntax Elements Syntax Component Definition/Range 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. Character string A list of characters. Data byte 8-bit byte containing numeric or character data. 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. Number Expressed as integer, decimal, or in exponential (E) form. Real Number Range: ± 1.797693134862315 × 10308, including 0. Up to 15 significant figures allowed. Numbers may be as small as ± 2.225073858507202 × 10−308 Integer Number Range: −32,768 through +32,767 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. Units Represent standard scientific units. Frequency Units: GZ, GHZ, MZ, MHZ, KZ, KHZ, HZ Amplitude Units: DB, DBMV, DM, DBM, DBUV, V, MV, UV, W, MW, UW Time Units: SC, S, MS, US Chapter 4 49 Programming Commands Programming Commands Command Syntax Programming Commands Programming Commands Programming Command Descriptions Programming Command Descriptions All supported commands are listed here, along with their descriptions and cross-references to similar commands. This chapter is not designed to be a comprehensive guide to all 8560 Series commands. It gives brief descriptions of the supported commands, and highlights important functional or behavioral differences that you should be aware of when transferring existing 8560 Series code to your X-Series analyzer. For a fuller description of the commands, refer to the 8560 Series or Operating and Programming Manual. In the descriptions of the commands, TRA corresponds to Trace 1 and TRB corresponds to Trace 2. To avoid confusion between numbers and letters, all commands that incorporate numbers have had the number spelled out and placed in square brackets after the command. For example, the command ‘I1’ is shown as ‘I1 [one]’ - that is, the capital letter ‘I’ followed by the number ‘1’, and then the word ‘one’ italicized in square brackets. The italicized word in brackets does not form part of the command. 50 Chapter 4 A1 [one] Clear Write for Trace A Syntax A1 ; LF CR SP , 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 96). Chapter 4 51 Programming Commands Programming Commands A1 [one] Clear Write for Trace A Programming Commands Programming Commands A2 [two] Maximum Hold for Trace A A2 [two] Maximum Hold for Trace A Syntax A2 ; LF CR SP , 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 171). 52 Chapter 4 A3 [three] View Mode for Trace A Syntax A3 ; LF CR SP , 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 221). Chapter 4 53 Programming Commands Programming Commands A3 [three] View Mode for Trace A Programming Commands Programming Commands A4 [four] Blank Trace A A4 [four] Blank Trace A Syntax A4 ; LF CR SP , 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 85). 54 Chapter 4 ACPALPHA Adjacent Channel Power Alpha Weighting Syntax ACPALPHA SP real ? ; LF CR SP , Description This command sets the alpha weighting for ACP measurements. Range: Chapter 4 Any real number between 0 and 1 55 Programming Commands Programming Commands ACPALPHA Adjacent Channel Power Alpha Weighting Programming Commands Programming Commands ACPALTCH Adjacent Channel Power Alternate Channels ACPALTCH Adjacent Channel Power Alternate Channels Syntax ACPALTCH SP 0 ; 1 LF 2 ? CR SP , 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 67). Range: 0, 1, or 2. Default value: 0. 56 Chapter 4 ACPBRPER Adjacent Channel Power Burst Period Syntax ACPBRPER SP real S ; MS LF US CR SC ? SP , 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. Chapter 4 57 Programming Commands Programming Commands ACPBRPER Adjacent Channel Power Burst Period Programming Commands 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 , 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 NOTE 5 μs to 9.5 seconds 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. 58 Chapter 4 ACPBW Adjacent Channel Power Bandwidth Syntax ACPBW SP real HZ ; KHZ LF MHZ CR GHZ UP KZ DOWN MZ SP , GZ ? Description The ACPBW command sets the bandwidth of the channels as an active function for the ACPMEAS (page 64) and ACPCOMPUTE (page 60) commands. Chapter 4 59 Programming Commands Programming Commands ACPBW Adjacent Channel Power Bandwidth Programming Commands Programming Commands ACPCOMPUTE Adjacent Channel Power Compute ACPCOMPUTE Adjacent Channel Power Compute Syntax ACPCOMPUTE ; LF CR SP , 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. 60 Chapter 4 ACPFRQWT Adjacent Channel Power Frequency Weighting Syntax ACPFRQWT SP RRCOS ; OFF LF ? CR SP , 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: NOTE OFF The N9061A application supports the ACP measurement using the ANALOG method only. Chapter 4 61 Programming Commands Programming Commands ACPFRQWT Adjacent Channel Power Frequency Weighting Programming Commands Programming Commands ACPLOWER Lower Adjacent Channel Power ACPLOWER Lower Adjacent Channel Power Syntax ACPLOWER ? ; LF CR SP , 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. 62 Chapter 4 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. Chapter 4 63 Programming Commands Programming Commands ACPMAX Maximum Adjacent Channel Power Programming Commands Programming Commands ACPMEAS Measure Adjacent Channel Power ACPMEAS Measure Adjacent Channel Power Syntax ACPMEAS ; LF CR SP , 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. 64 Chapter 4 ACPMSTATE Adjacent Channel Power Measurement State Syntax ACPMSTATE SP CURR ; DFLT LF ? CR SP , 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: NOTE DFLT The N9061A application supports the ACP measurement using the ANALOG method only. Chapter 4 65 Programming Commands Programming Commands ACPMSTATE Adjacent Channel Power Measurement State Programming Commands Programming Commands ACPPWRTX Adjacent Channel Power Total Power Transmitted ACPPWRTX Adjacent Channel Power Total Power Transmitted Syntax ACPPWRTX ? ; LF CR SP , 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. 66 Chapter 4 ACPRSLTS Adjacent Channel Power Measurement Results Syntax ACPRSLTS ? ; LF CR SP , 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 56) command determines the size of the array. NOTE The N9061A application supports the ACP measurement using the ANALOG method only. Chapter 4 67 Programming Commands Programming Commands ACPRSLTS Adjacent Channel Power Measurement Results Programming Commands Programming Commands ACPSP Adjacent Channel Power Channel Spacing ACPSP Adjacent Channel Power Channel Spacing Syntax ACPSP SP real HZ ; KHZ LF MHZ CR GHZ UP KZ DOWN MZ SP , GZ ? Description Sets the channel spacing for the ACPMEAS (page 64) and ACPCOMPUTE (page 60) commands. NOTE The N9061A application supports the ACP measurement using the ANALOG method only. 68 Chapter 4 ACPT Adjacent Channel Power T Weighting Syntax ACPT SP real S ; MS LF US CR SC SP ? , 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. Chapter 4 69 Programming Commands Programming Commands ACPT Adjacent Channel Power T Weighting Programming Commands Programming Commands ACPUPPER Upper Adjacent Channel Power ACPUPPER Upper Adjacent Channel Power Syntax ACPUPPER ? ; LF CR SP , 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. 70 Chapter 4 ADJALL LO and IF Adjustments Syntax ADJALL ; LF CR SP , 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. Chapter 4 71 Programming Commands Programming Commands ADJALL LO and IF Adjustments Programming Commands Programming Commands AMB A minus B into A AMB A minus B into A Syntax AMB SP SP ON ; OFF LF 1 CR 0 SP ? , 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 75) 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. NOTE The functions of the command AMB are identical to the C2 [two] command (page 88). 72 Chapter 4 AMBPL (A minus B) plus Display Line into A Syntax AMBPL SP SP ON ; OFF LF 1 CR 0 SP ? , 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. Chapter 4 73 Programming Commands Programming Commands AMBPL (A minus B) plus Display Line into A Programming Commands Programming Commands ANNOT Annotation ANNOT Annotation Syntax ANNOT SP SP ON ; OFF LF 1 CR 0 SP ? , Preset State: ANNOT ON 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. 74 Chapter 4 APB Trace A Plus Trace B to A Syntax APB ; LF CR SP , 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 72) or a C2 (page 88) command has been executed. Chapter 4 75 Programming Commands Programming Commands APB Trace A Plus Trace B to A Programming Commands Programming Commands AT Input Attenuation AT Input Attenuation Syntax AT SP number DB ; LF UP SP DN CR AUTO SP MAN , OA ? Table 4-2 Item Description/Default Number Any real number or integer. If the value you enter is not a valid value for the analyzer you are using, it switches automatically to the closest valid setting. Default units are dB. Range 0 to 70 dB specified absolutely and 10 to 70 dB in 10 dB stepsa a. The range is limited to 0 to 60 dB if 8564E/EC or 8565E/EC is selected. Preset State: 10 dB Step Increment: 10 dB 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. 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. 76 Chapter 4 AUNITS Absolute Amplitude Units Syntax AUNITS SP AUTO ; MAN LF DBM CR DBMV DBUV V SP , W DM ? Description Specifies the amplitude readout units for the reference level, the marker, and the display line. NOTE 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. Chapter 4 77 Programming Commands Programming Commands AUNITS Absolute Amplitude Units Programming Commands Programming Commands AUTOCPL Auto Coupled AUTOCPL Auto Coupled Syntax AUTOCPL ; LF CR SP , Description Sets video bandwidth, resolution bandwidth, input attenuation, sweep time and center frequency step-size to coupled mode. 78 Chapter 4 AXB Exchange Trace A and Trace B Syntax AXB ; LF CR SP , Description This command exchanges Trace A and Trace B, point by point. Chapter 4 79 Programming Commands Programming Commands AXB Exchange Trace A and Trace B Programming Commands Programming Commands B1 [one] Clear Write for Trace B B1 [one] Clear Write for Trace B Syntax B1 ; LF CR SP , 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. The functions of the command B1 are identical to the CLRW TRB command (page 96). 80 Chapter 4 B2 [two] Maximum Hold for Trace B Syntax B2 ; LF CR SP , Description The B2 command updates each trace element with the maximum level detected while the trace is active. The functions of the command B2 are identical to the MXMH TRB command (page 171). Chapter 4 81 Programming Commands Programming Commands B2 [two] Maximum Hold for Trace B Programming Commands Programming Commands B3 [three] View Mode for Trace B B3 [three] View Mode for Trace B Syntax B3 ; LF CR SP , Description The B3 command displays Trace B and then stops the sweep if no other traces are active. Trace B does not get updated. The functions of the command B3 are identical to the VIEW TRB command (page 221). 82 Chapter 4 B4 [four] Blank Trace B Syntax B4 ; LF CR SP , Description The B4 command blanks Trace B and stops the sweep if no other traces are active. Trace B is not updated. The functions of the command B4 are identical to the BLANK TRB command (page 85). Chapter 4 83 Programming Commands Programming Commands B4 [four] Blank Trace B Programming Commands 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 , Description The BL command subtracts the display line from Trace B and sends the results to Trace B. The command BL is calculated in units of dBm. The functions of the command BL are identical to the BML command (page 86). 84 Chapter 4 BLANK Blank Trace Syntax BLANK SP TRA ; TRB LF CR SP , Preset State: BLANK TRB 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. The functions of the command BLANK are identical to the A4 command (page 54) and the B4 command (page 83). For information on the trace settings of the X-series analyzers when legacy instrument trace settings are sent, see Table 4-4, “8560 series command mapping to X-series for trace/detector settings.” Chapter 4 85 Programming Commands Programming Commands BLANK Blank Trace Programming Commands Programming Commands BML Trace B Minus Display Line BML Trace B Minus Display Line Syntax BML ; LF CR SP , 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 uses units of dBm. The functions of the command BML are identical to the BL command (page 84). 86 Chapter 4 C1 [one] Set A Minus B Mode Off Syntax C1 ; LF CR SP , 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 88) or by the AMB ON command (page 72). The functions of the command C1 are identical to the AMB OFF command (page 72). Chapter 4 87 Programming Commands Programming Commands C1 [one] Set A Minus B Mode Off Programming Commands Programming Commands C2 [two] A Minus B Into A C2 [two] A Minus B Into A Syntax C2 ; LF CR SP , 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 75) has been executed. The functions of the command C2 are identical to the AMB ON command (page 72). 88 Chapter 4 CA Couple Attenuation Syntax CA ; LF CR SP , 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 168). The counterpart to the CA command is the AT command (page 76), which allows levels less than the threshold value at the mixer input. Chapter 4 89 Programming Commands Programming Commands CA Couple Attenuation Programming Commands Programming Commands CARROFF Carrier Off Power CARROFF Carrier Off Power Syntax CARROFF SP TRA , ? TRB ; LF CR SP , 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. 90 Chapter 4 CARRON Carrier On Power Syntax CARRON SP TRA , ? TRB ; LF CR SP , 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. Chapter 4 91 Programming Commands Programming Commands CARRON Carrier On Power Programming Commands 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 Item REAL Description/Default Any real or integer number. Default unit is HZ. Range Frequency range of the analyzer 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 101). 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 197). 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 recommended and is not warranted to meet specifications. 92 Chapter 4 CHANNEL Channel Selection Syntax CHANNEL SP UP ; DN LF CR SP , Description Increments or decrements the analyzer center frequency by one channel spacing. NOTE The channel spacing value is set using the ACPSP command (page 68). Chapter 4 93 Programming Commands Programming Commands CHANNEL Channel Selection Programming Commands Programming Commands CHANPWR Channel Power CHANPWR Channel Power Syntax CHANPWR TRA SP TRB , real HZ , KHZ ? ; LF MHZ CR GHZ KZ MZ SP , GZ Description Measures the power within the specified channel bandwidth. NOTE If no channel bandwidth is specified in the command, the channel bandwidth is set using the CHPWRBR command (page 95). 94 Chapter 4 CHPWRBW Channel Power Bandwidth Syntax CHPWRBW SP real HZ ; KHZ LF MHZ CR GHZ KZ MZ SP , GZ SP UP DN OA ? Description Queries or sets the current value of the channel power bandwidth. Channel power can be measured with the CHANPWR command (page 94). Chapter 4 95 Programming Commands Programming Commands CHPWRBW Channel Power Bandwidth Programming Commands Programming Commands CLRW Clear Write CLRW Clear Write Clears the specified trace and enables trace data acquisition. Syntax CLRW SP TRA ; TRB LF CR SP , Preset State: CLRW TRA Description The CLRW command places the indicated trace in clear-write mode. Data acquisition begins at the next sweep. (See the TS command (page 217) 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 51) and B1 command (page 80). On the 8560 series of 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. 96 Chapter 4 Table 4-4 8560 series command mapping to X-series for trace/detector settings 8560 series X-series Trace commands Averaging (VAVG) Detector (DET) Trace/Detector Trace Type View/Blank Detector CLWR Off Normal ClearWrite On Last set CLWR On Sample Trace Average On Sample MXMH Off Peak Max Hold On Peak MXMH On Sample Trace Average On Peak MINH Off NegPeak Min Hold On NegPeak MINH On Sample Trace Average On NegPeak VIEW Off Normal No change View No change VIEW On Sample Trace Average View Sample BLANK Off Normal No change Blank No change BLANK On Sample Trace Average Blank Sample 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. Chapter 4 97 Programming Commands Programming Commands CLRW Clear Write Programming Commands Programming Commands CONTS Continuous Sweep CONTS Continuous Sweep Syntax CONTS ; LF CR SP , Preset State: CONTS 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 188). 98 Chapter 4 COUPLE Input Coupling Syntax COUPLE SP AC ; DC LF ? CR SP , 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. Chapter 4 99 Programming Commands Programming Commands COUPLE Input Coupling Programming Commands Programming Commands CR Couple Resolution Bandwidth CR Couple Resolution Bandwidth Syntax CR ; LF CR SP , Description The CR command couples the resolution bandwidth to the span. The counterpart to the CR command is the RB command (page 180) 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. 100 Chapter 4 CS Couple Frequency Step Size Syntax CS ; LF CR SP , 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 197) which breaks the coupling. Use the CS command to re-establish coupling after an SS command has been executed. Chapter 4 101 Programming Commands Programming Commands CS Couple Frequency Step Size Programming Commands Programming Commands CT Couple Sweep Time CT Couple Sweep Time Syntax CT ; LF CR SP , 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 198) which breaks the coupling. Use the CT command to re-establish coupling after an ST command has been executed. 102 Chapter 4 CV Couple Video Bandwidth Syntax CV ; LF CR SP , Description The CV command couples the video bandwidth to the resolution bandwidth. The counterpart to the CV command is the VB command (page 219) 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. Chapter 4 103 Programming Commands Programming Commands CV Couple Video Bandwidth Programming Commands Programming Commands DELMKBW Occupied Power Bandwidth Within Delta Marker DELMKBW Occupied Power Bandwidth Within Delta Marker Syntax DELMKBW SP TRA TRB , real , ? ; LF CR SP , 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 179) 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. 104 Chapter 4 DET Detection Mode Syntax DET SP POS ; SMP LF NEG CR NRM ? SP , Preset State: DET NRM 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. Chapter 4 105 Programming Commands Programming Commands DET Detection Mode Programming Commands Programming Commands DL Display Line DL Display Line Syntax DL SP number SP DB ; DBM LF UP DBMV DN DBUV OFF MV ON UV CR SP , V MW UW W DM ? Table 4-5 Item NUMBER Description/Default Any real or integer number. Default units are dBm. Range Dependent on the reference level Preset State: DL OFF Step Increment: 1 major graticule division Description Defines the level of the display line and displays it on the analyzer screen. 106 Chapter 4 DLYSWP Delay Sweep Syntax DLYSWP SP number US ; MS LF SC CR S ON SP SP OFF , 1 SP 0 ? Description Delays the start of the sweep until the specified time after the trigger event has elapsed. NOTE A query response of 0 indicates that DLYSWP is switched off. Chapter 4 107 Programming Commands Programming Commands DLYSWP Delay Sweep Programming Commands Programming Commands DONE Done DONE Done Syntax DONE ? ; LF CR SP , 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 217)) precedes the command list, the TS command acts as a synchronizing function since the command list execution begins after the sweep has been completed. 108 Chapter 4 E1[one] Peak Marker Syntax E1 ; LF CR SP , 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 160). Chapter 4 109 Programming Commands Programming Commands E1[one] Peak Marker Programming Commands Programming Commands E2 [two] Marker to Center Frequency E2 [two] Marker to Center Frequency Syntax E2 ; LF CR SP , Description The E2 command positions the marker on the screen at the center frequency position. NOTE The functions of the E2 command are identical to the MKCF command (page 150). 110 Chapter 4 E3 [three] Delta Marker Step Size Syntax E3 ; LF CR SP , 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 165). Chapter 4 111 Programming Commands Programming Commands E3 [three] Delta Marker Step Size Programming Commands Programming Commands E4 [four] Marker to Reference Level E4 [four] Marker to Reference Level Syntax E4 ; LF CR SP , Description The E4 command moves the active marker to the reference level. NOTE The functions of the E4 command are identical to the MKRL command (page 163). 112 Chapter 4 ERR Error Syntax ERR ? ; LF CR SP , 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 Code 112 Description CMD ERR 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. Chapter 4 113 Programming Commands Programming Commands ERR Error Programming Commands Programming Commands ERR Error Table 4-7 X-series error code Description 8560 series error code Description 40 TG Alignment Failure 758 SYSTEM: Unknown system error 42 RF Alignment Failure 758 SYSTEM: Unknown system error 44 IF Alignment Failure 758 SYSTEM: Unknown system error 46 LO Alignment Failure 758 SYSTEM: Unknown system error 48 ADC Alignment Failure 758 SYSTEM: Unknown system error 50 FM Demod Alignment Failure 758 SYSTEM: Unknown system error 54 Extended Align Failure Sum 758 SYSTEM: Unknown system error 71 Characterize Preselector Failure 758 SYSTEM: Unknown system error -200.3310 Execution Error; Preselector Centering failed 758 SYSTEM: Unknown system error 503 Frequency Reference Unlocked 336 10 MHz Ref Cal oscillator failed to lock 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. 509 LO Unlocked 300 YTO UNL: YTO (1st LO) phase-locked loop (PLL) is unlocked. 513 IF Synthesizer Unlocked 450 IF SYSTM: IF hardware failure. Check other error messages. 515 Calibration Oscillator Unlocked 336 10 MHz Ref: Cal oscillator failed to lock when going to internal 10 MHz reference 521 External Ref missing or out of range 905,333 EXT REF: Unable to lock cal oscillator when set to external reference. Check that the external reference is within tolerance. 600 UNLK: 600 MHz reference oscillator PLL is unlocked 114 Chapter 4 ET Elapsed Time Syntax ET ? ; LF CR SP , Description The ET command returns to the controller the elapsed time (in hours) of analyzer operation. Chapter 4 115 Programming Commands Programming Commands ET Elapsed Time Programming Commands Programming Commands EX Exchange Trace A and Trace B EX Exchange Trace A and Trace B Syntax EX ; LF CR SP , 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 79). 116 Chapter 4 FA Start Frequency Syntax FA SP HZ real ; KHZ LF MHZ CR GHZ SP KZ MZ , GZ UP SP DN OA ? Table 4-8 Item REAL Description/Default Any real or integer number. Default unit is Hz. Range Frequency range of the analyzer Step Increment: Frequency span divided by 10 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. Chapter 4 117 Programming Commands Programming Commands FA Start Frequency Programming Commands Programming Commands FB Stop Frequency FB Stop Frequency Syntax FB SP real HZ KHZ ; LF MHZ CR GHZ KZ MZ SP , GZ UP SP DN OA ? Table 4-9 Item REAL Description/Default Any real or integer number. Default unit is Hz. Range Frequency range of the analyzer Step Increment: Frequency span divided by 10 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. 118 Chapter 4 FDSP Frequency Display Off Syntax FDSP OFF SP ? ; LF CR SP , 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 74) 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 134) command. Chapter 4 119 Programming Commands Programming Commands FDSP Frequency Display Off Programming Commands Programming Commands FOFFSET Frequency Offset FOFFSET Frequency Offset Syntax FOFFSET SP real HZ ; KHZ LF MHZ CR GHZ SP KZ MZ , GZ UP SP DN OA ? Table 4-10 Item REAL Description/Default Range Any real or integer number. Default unit is Hz. Preset State: 0 Hz 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. 120 Chapter 4 FREF Frequency Reference Syntax FREF SP INT ; EXT LF ? CR SP , Description The FREF command specifies whether an external source or an internal source is being used. Chapter 4 121 Programming Commands Programming Commands FREF Frequency Reference Programming Commands Programming Commands FS Full Span FS Full Span Syntax FS ; LF CR SP , Description 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. 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. 122 Chapter 4 Table 4-11 Table 4-12 EXA Series - Frequency Ranges Set by the FS Command N9010A-503 N9010A-507 N9010A-513 N9010A-526 Remote Language Frequency Range Frequency Range Frequency Range Frequency Range 8560E/EC 0 Hz - 2.9 GHz 0 Hz - 2.9 GHz 0 Hz - 2.9 GHz 0 Hz - 2.9 GHz 8561E/EC 0 Hz - 3.6 GHz 0 Hz - 6.5 GHz 0 Hz - 6.5 GHz 0 Hz - 6.5 GHz 8562E/EC 0 Hz - 3.6 GHz 0 Hz - 7.0 GHz 0 Hz - 13.2 GHz 0 Hz - 13.2 GHz 8563E/EC 0 Hz - 3.6 GHz 0 Hz - 7.0 GHz 0 Hz - 13.6 GHz 0 Hz - 27.0 GHz 8564E/EC 0 Hz - 3.6 GHz 0 Hz - 7.0 GHz 0 Hz - 13.6 GHz 0 Hz - 27.0 GHz 8565E/EC 0 Hz - 3.6 GHz 0 Hz - 7.0 GHz 0 Hz - 13.6 GHz 0 Hz - 27.0 GHz MXA Series - Frequency Ranges Set by the FS Command N9020A-503 N9020A-508 N9020A-513 N9020A-526 Remote Language Frequency Range Frequency Range Frequency Range Frequency Range 8560E/EC 0 Hz - 2.9 GHz 0 Hz - 2.9 GHz 0 Hz - 2.9 GHz 0 Hz - 2.9 GHz 8561E/EC 0 Hz - 3.6 GHz 0 Hz - 6.5 GHz 0 Hz - 6.5 GHz 0 Hz - 6.5 GHz 8562E/EC 0 Hz - 3.6 GHz 0 Hz - 8.4 GHz 0 Hz - 13.2 GHz 0 Hz - 13.2 GHz 8563E/EC 0 Hz - 3.6 GHz 0 Hz - 8.4 GHz 0 Hz - 13.6 GHz 0 Hz - 27.0 GHz 8564E/EC 0 Hz - 3.6 GHz 0 Hz - 8.4 GHz 0 Hz - 13.6 GHz 0 Hz - 27.0 GHz 8565E/EC 0 Hz - 3.6 GHz 0 Hz - 8.4 GHz 0 Hz - 13.6 GHz 0 Hz - 27.0 GHz Chapter 4 123 Programming Commands Programming Commands FS Full Span Programming Commands Programming Commands GATE Gate GATE Gate Syntax GATE SP SP ON ; OFF LF 1 CR 0 SP ? , Preset State: GATE OFF 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. Query response is either 1 or 0, indicating ON or OFF state. 124 Chapter 4 GATECTL Gate Control Syntax GATECTL SP EDGE ; LEVEL LF ? CR SP , Preset State: GATECTL EDGE 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. Chapter 4 125 Programming Commands Programming Commands GATECTL Gate Control Programming Commands Programming Commands GD Gate Delay GD Gate Delay Syntax GD SP US real MS ; LF SC CR S SP SP UP DN , OA ? Preset State: 3 μs 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. 126 Chapter 4 GL Gate Length Syntax GL SP US real MS ; LF SC CR S SP SP UP DN , OA ? Preset State: 1 μs Description Sets the length of time the time gate is turned on. GL only applies if GATECTL is set to EDGE. Chapter 4 127 Programming Commands Programming Commands GL Gate Length Programming Commands Programming Commands GP Gate Polarity GP Gate Polarity Syntax GP SP NEG ; POS LF ? CR SP , Preset State: GP POS 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. 128 Chapter 4 GRAT Graticule Syntax GRAT SP SP ON ; OFF LF 1 CR 0 SP ? , Preset State: GRAT ON Description Turns the graticule on or off. Query response is either 1 or 0, indicating ON or OFF state. Chapter 4 129 Programming Commands Programming Commands GRAT Graticule Programming Commands Programming Commands HD Hold Data Entry HD Hold Data Entry Syntax HD ; LF CR SP , 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. 130 Chapter 4 I1 [one] Set RF Coupling to DC Syntax I1 ; LF CR SP , Description The I1 [one] command sets the RF coupling to DC. The tables below list the frequency specifications for all EXA series and MXA analyzers for both DC and AC coupling. Table 4-13 Table 4-14 NOTE EXA Series Analyzer Frequency Coupling Specifications DC Coupled Range AC Coupled Range Analyzer Model (N9010A) Min. Freq. Max. Freq. Min. Freq. Max. Freq. Option 503 9 kHz 3.6 GHz 10 MHz 3.6 GHz Option 507 9 kHz 7.0 GHz 10 MHz 7.0 GHz Option 513 9 kHz 13.6 GHz 10 MHz 13.6 GHz Option 526 9 kHz 27.0 GHz 10 MHz 27.0 GHz MXA Series Analyzer Frequency Coupling Specifications DC Coupled Range AC Coupled Range Analyzer Model (N9020A) Min. Freq. Max. Freq. Min. Freq. Max. Freq. Option 503 20 Hz 3.6 GHz 10 MHz 3.6 GHz Option 508 20 Hz 8.4 GHz 10 MHz 8.4 GHz Option 513 20 Hz 13.6 GHz 10 MHz 13.6 GHz Option 526 20 Hz 27.0 GHz 10 MHz 27.0 GHz The EXA and MXA analyzers only have a single RF input port. Chapter 4 131 Programming Commands Programming Commands I1 [one] Set RF Coupling to DC Programming Commands Programming Commands I2 [two] Set RF Coupling to AC I2 [two] Set RF Coupling to AC Syntax I2 ; LF CR SP , Description The I2 [two] command sets the RF coupling to AC. The tables below list the frequency specifications for all EXA series and MXA analyzers for both DC and AC coupling. Table 4-15 Table 4-16 NOTE EXA Series Analyzer Frequency Coupling Specifications DC Coupled Range AC Coupled Range Analyzer Model (N9010A) Min. Freq. Max. Freq. Min. Freq. Max. Freq. Option 503 9 kHz 3.6 GHz 10 MHz 3.6 GHz Option 507 9 kHz 7.0 GHz 10 MHz 7.0 GHz Option 513 9 kHz 13.6 GHz 10 MHz 13.6 GHz Option 526 9 kHz 27.0 GHz 10 MHz 27.0 GHz MXA Series Analyzer Frequency Coupling Specifications DC Coupled Range AC Coupled Range Analyzer Model (N9020A) Min. Freq. Max. Freq. Min. Freq. Max. Freq. Option 503 20 Hz 3.6 GHz 10 MHz 3.6 GHz Option 508 20 Hz 8.4 GHz 10 MHz 8.4 GHz Option 513 20 Hz 13.6 GHz 10 MHz 13.6 GHz Option 526 20 Hz 27.0 GHz 10 MHz 27.0 GHz The EXA and MXA analyzers only have a single RF input port. 132 Chapter 4 ID Identify Syntax ID SP ? ; OA LF CR SP , 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 19 “Running Software that Requires SCPI Commands” on page 25 Chapter 4 133 Programming Commands Programming Commands ID Identify Programming Commands Programming Commands IP Instrument Preset IP Instrument Preset Syntax IP ; LF CR SP , Description Performs an instrument preset, setting the analyzer back to its factory settings. 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 If the external amplifier gain has been set, executing an IP command does not reset this value. This is to protect the analyzer. 134 Chapter 4 L0 [zero] Display Line Off Syntax L0 ; LF CR SP , Description The L0 [zero] command disables the display line. Chapter 4 135 Programming Commands Programming Commands L0 [zero] Display Line Off Programming Commands Programming Commands LG Logarithmic Scale LG Logarithmic Scale Syntax LG SP number DB ; DM LF UP SP CR DN SP OA ? , 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-17 Remote Language 136 Integer Range using the LG Command 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 Chapter 4 LN Linear Scale Syntax LN ; LF CR SP , 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. Chapter 4 137 Programming Commands Programming Commands LN Linear Scale Programming Commands Programming Commands M1 [one] Marker Off M1 [one] Marker Off Syntax M1 ; LF CR SP , Description The M1 [one] command blanks any markers showing on the display. NOTE The functions of the M1 [one] command are identical to the MKOFF ALL command (page 159). 138 Chapter 4 M2 [two] Marker Normal Syntax M2 SP real HZ ; KHZ LF MHZ CR GHZ KZ MZ SP UP GZ DN S OA MS SP , US SC ? 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 157). Chapter 4 139 Programming Commands Programming Commands M2 [two] Marker Normal Programming Commands Programming Commands M3 [three] Delta Marker M3 [three] Delta Marker Syntax M3 SP real HZ ; KHZ LF MHZ CR GHZ KZ MZ SP UP GZ DN S OA MS SP , US SC ? 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. If the M3 command is executed with the marker noise function active (MKNOISE ON or KSM), the marker amplitude displayed and returned by the MKA? command (page 148) or the MA command (page 142) is the difference between the noise densities at the reference marker and at the delta marker position. NOTE If the M3 command is executed before marker noise has been activated (using the MKNOISE ON or KSM commands), the marker noise amplitude that is displayed on the screen is the difference between the carrier wave power and the noise density at the delta marker position. The value returned by the MKA? or MA command is the difference between the carrier wave power and the noise density at the delta marker position. That is, the value returned by MKA? and MA agrees with that displayed on the screen of the X-Series analyzers. 140 Chapter 4 The functions of the M3 command are identical to the MKD command (page 151). Chapter 4 141 Programming Commands Programming Commands M3 [three] Delta Marker Programming Commands Programming Commands MA Marker Amplitude Output MA Marker Amplitude Output Syntax MA ; LF CR SP , 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 marker amplitude is always returned as an ASCII value (TDF P). The functions of the MA command are identical to the MKA command (page 148). 142 Chapter 4 MEAN Trace Mean Syntax MEAN SP TRA ; TRB LF CR SP , Description Returns the mean value of the specified trace in display units. NOTE TRA corresponds to Trace 1 and TRB corresponds to Trace 2. Chapter 4 143 Programming Commands Programming Commands MEAN Trace Mean Programming Commands Programming Commands MEANPWR Mean Power measurement MEANPWR Mean Power measurement Syntax MEANPWR SP TRA TRB , number , ? ; LF CR SP , 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 91), except that the CARRON command defines ‘on’ as that time when the signal is within 20 dB of its peak level. 144 Chapter 4 MEAS Meas Syntax MEAS ? ; LF CR SP , 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. Chapter 4 145 Programming Commands Programming Commands MEAS Meas Programming Commands Programming Commands MF Marker Frequency Output MF Marker Frequency Output Syntax MF ? ; LF CR SP , 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. 146 Chapter 4 MINH Minimum Hold Syntax MINH SP TRA ; TRB LF CR SP , 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, “8560 series command mapping to X-series for trace/detector settings.” Chapter 4 147 Programming Commands Programming Commands MINH Minimum Hold Programming Commands Programming Commands MKA Marker Amplitude MKA Marker Amplitude Syntax MKA ? ; LF CR SP , 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. The marker amplitude is always returned as an ASCII value (TDF P). The functions of the MKA command are identical to the MA command (page 142). 148 Chapter 4 MKBW Marker Bandwidth Syntax MKBW SP number , ? ; LF CR SP , 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). Chapter 4 149 Programming Commands Programming Commands MKBW Marker Bandwidth Programming Commands Programming Commands MKCF Marker to Center Frequency MKCF Marker to Center Frequency Syntax MKCF ; LF CR SP , 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 110). 150 Chapter 4 MKD Marker Delta Syntax MKD SP real HZ ; KHZ LF MHZ CR GHZ KZ MZ SP UP GZ DN S OA MS SP , US SC ? Step Increment: by 1/10 of the frequency span 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. Chapter 4 151 Programming Commands Programming Commands MKD Marker Delta Programming Commands Programming Commands MKD Marker Delta If the MKD command is executed with the marker noise function active (MKNOISE ON or KSM), the marker amplitude displayed and returned by the MKA? command (page 148) or the MA command (page 142) is the difference between the noise densities at the reference marker and at the delta marker position. If the MKD command is executed before marker noise has been activated (using the MKNOISE ON or KSM commands), the marker noise amplitude that is displayed on the screen is the difference between the carrier wave power and the noise density at the delta marker position. The value returned by the MKA? or MA command is the difference between the carrier wave power and the noise density at the delta marker position. That is, the value returned by MKA? and MA agree with that displayed on the screen of the X-Series analyzers. The functions of the MKD command are identical to the M3 command (page 140). 152 Chapter 4 MKF Marker Frequency Syntax MKF SP HZ ; KHZ LF real MHZ CR GHZ KZ MZ SP UP GZ DN S OA MS SP , US SC ? Description Specifies the frequency value of the active marker. The data is returned in ASCII format. Chapter 4 153 Programming Commands Programming Commands MKF Marker Frequency Programming Commands Programming Commands MKFC Marker Counter MKFC Marker Counter Syntax MKFC SP SP ON ; OFF LF 1 CR 0 SP , Description Turns on or off the marker frequency counter. The resolution of the frequency marker counter is determined by the MKFCR command (page 155). 154 Chapter 4 MKFCR Marker Counter Resolution Syntax MKFCR real SP HZ ; KHZ LF MHZ CR GHZ SP KZ , MZ GZ OA SP ? 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. On the X-Series analyzers, setting the marker frequency resolution causes the Gate Time to change. The Gate Time is calculated using the following formula: 1 Gate Time = ----------------------------------------Resolution Value Chapter 4 155 Programming Commands Programming Commands MKFCR Marker Counter Resolution Programming Commands Programming Commands MKMIN Marker Minimum MKMIN Marker Minimum Syntax MKMIN ; LF CR SP , Description Moves the active marker to the minimum value detected. 156 Chapter 4 MKN Marker Normal Syntax MKN SP real HZ ; KHZ LF MHZ CR GHZ KZ MZ SP UP GZ DN S OA MS SP , US SC ? Step Increment: by 1/10 of the frequency span. 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 139). Chapter 4 157 Programming Commands Programming Commands MKN Marker Normal Programming Commands Programming Commands MKNOISE Marker Noise MKNOISE Marker Noise Syntax MKNOISE SP SP ON ; OFF LF 1 CR 0 SP ? , Description Displays the average RMS noise density at the marker. Some differences in marker noise may be seen between the legacy analyzers and the X-Series analyzers due to the greater dynamic range of the X-Series analyzers. If either the M3 command or the MKD command is executed with the marker noise function active (MKNOISE ON or KSM), the marker amplitude displayed and returned by the MKA? command (page 148) or the MA command (page 142) is the difference between the noise densities at the reference marker and at the delta marker position. If either the M3 command or the MKD command is executed before marker noise has been activated (using the MKNOISE ON or KSM commands), the marker noise amplitude that is displayed on the screen is the difference between the carrier wave power and the noise density at the delta marker position. The value returned by the MKA? or MA command is the difference between the carrier wave power and the noise density at the delta marker position. That is, the value returned by MKA? and MA agrees with that displayed on the screen of the X-Series analyzers. 158 Chapter 4 MKOFF Marker Off Syntax MKOFF SP ALL ; LF CR SP , Description Turns off either the active marker or all the markers. If the ALL parameter is omitted, only the active marker is turned off. Chapter 4 159 Programming Commands Programming Commands MKOFF Marker Off Programming Commands Programming Commands MKPK Marker Peak MKPK Marker Peak Syntax MKPK SP HI ; NH LF NR CR NL SP , 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 109). NOTE For more details on marker peak excursion, see the MKPX command (page 162). 160 Chapter 4 MKPT Marker Threshold Syntax MKPT SP number SP UP DN DBM ; LF CR OA SP ? , Description The MKPT command sets the minimum amplitude level from which a peak on the trace can be detected. Chapter 4 161 Programming Commands Programming Commands MKPT Marker Threshold Programming Commands Programming Commands MKPX Marker Peak Excursion MKPX Marker Peak Excursion Syntax MKPX SP SP real UP DN DB ; LF CR OA ? SP , Preset State: 6 dB Step Increment: 1 dB 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. 162 Chapter 4 MKRL Marker to Reference Level Syntax MKRL ; LF CR SP , 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 112). Chapter 4 163 Programming Commands Programming Commands MKRL Marker to Reference Level Programming Commands Programming Commands MKSP Marker to Span MKSP Marker to Span Syntax MKSP ; LF CR SP , Description The MKSP command operates only when the delta marker is On (see MKD (page 151) or M3 (page 140)). 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. 164 Chapter 4 MKSS Marker to Step Size Syntax MKSS ; LF CR SP , 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 111). Chapter 4 165 Programming Commands Programming Commands MKSS Marker to Step Size Programming Commands Programming Commands MKT Marker Time MKT Marker Time Syntax MKT SP real S ; MS LF US CR SC OA ? SP , Description Places a marker at a position that corresponds to a specified point in time during the sweep. NOTE The default unit of time is seconds (‘S’ or ‘SC’). 166 Chapter 4 MKTRACK Marker Track Syntax MKTRACK SP SP ON ; OFF LF 1 CR 0 SP ? , 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 The functions of the MKTRACK command are identical to the MT0 [zero] command (page 169) and the MT1 [one] command (page 170). Chapter 4 167 Programming Commands Programming Commands MKTRACK Marker Track Programming Commands Programming Commands ML Mixer Level ML Mixer Level Syntax ML SP SP real DBM ; UP LF DN CR ? SP , 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. 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 45. 168 Chapter 4 MT0 [zero] Marker Track Off Syntax MT0 ; LF CR SP , 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 167). Chapter 4 169 Programming Commands Programming Commands MT0 [zero] Marker Track Off Programming Commands Programming Commands MT1 [one] Marker Track On MT1 [one] Marker Track On Syntax MT1 ; LF CR SP , 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 167). 170 Chapter 4 MXMH Maximum Hold Syntax MXMH SP TRA ; TRB LF CR SP , 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 52)and B2 command (page 81). NOTE TRA corresponds to Trace 1 and TRB corresponds to Trace 2. For information on the trace settings of the X-series analyzers when legacy instrument trace settings are sent, see Table 4-4, “8560 series command mapping to X-series for trace/detector settings.” Chapter 4 171 Programming Commands Programming Commands MXMH Maximum Hold Programming Commands Programming Commands NORMLIZE Normalize Trace Data NORMLIZE Normalize Trace Data Syntax NORMLIZE SP ON ; OFF LF OA CR 1 SP 0 ? SP , The preset state is OFF. 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. 172 Chapter 4 NRL Normalized Reference Level Syntax NRL SP number DB LF LF ? CR SP , The preset value is 0 dB. 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. Chapter 4 173 Programming Commands Programming Commands NRL Normalized Reference Level Programming Commands Programming Commands NRPOS Normalized Reference Position NRPOS Normalized Reference Position Syntax NRPOS SP number ; SP UP LF DN CR OA ? SP , The preset value is 10. 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. 174 Chapter 4 OCCUP Percent Occupied Power Bandwidth Syntax OCCUP SP number ? ; LF CR SP , Description The OCCUP command is used to query the current value of the percent occupied power. This value is set by the DELMKBW (page 104) and the PWRBW command (page 179) command. The OCCUP command can also be used to set the percent occupied power. Chapter 4 175 Programming Commands Programming Commands OCCUP Percent Occupied Power Bandwidth Programming Commands Programming Commands PLOT Plot PLOT Plot Syntax PLOT SP value , value , value , value ; LF CR SP , 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. 176 Chapter 4 PP Preselector Peak Syntax PP ; LF CR SP , 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. Chapter 4 177 Programming Commands Programming Commands PP Preselector Peak Programming Commands Programming Commands PRINT Print PRINT Print Syntax PRINT ; LF CR SP , Description Transfers trace data, graticule and annotation of the analyzer screen directly to the X-series analyzer’s default printer. 178 Chapter 4 PWRBW Power Bandwidth Syntax PWRBW SP TRA TRB , number ? ; LF CR SP , 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. Chapter 4 179 Programming Commands Programming Commands PWRBW Power Bandwidth Programming Commands Programming Commands RB Resolution Bandwidth RB Resolution Bandwidth Syntax RB SP real SP HZ ; KHZ LF UP MHZ DN GHZ AUTO KZ MAN MZ OA GZ CR SP , ? Preset State: 1 MHz, auto coupled Step Increment: In a 1, 3, 10 series 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 100) to re-establish coupling. 180 Chapter 4 RBR Resolution Bandwidth to Span Ratio Syntax RBR SP SP real UP DN ; LF CR OA ? SP , 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. Chapter 4 181 Programming Commands Programming Commands RBR Resolution Bandwidth to Span Ratio Programming Commands Programming Commands RC Recall State RC Recall State Syntax RC SP LAST ; PWRON LF CR SP number SP , 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 190) or the SV command (page 201). NOTE The functions of the RC command are identical to the RCLS command (page 183). 182 Chapter 4 RCLS Recall State Syntax RCLS SP LAST ; PWRON LF CR SP number SP , 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 190) or the SV command (page 201). The functions of the RCLS command are identical to the RC command (page 182). Chapter 4 183 Programming Commands Programming Commands RCLS Recall State Programming Commands Programming Commands REV Revision REV Revision Syntax REV ? ; LF CR SP , 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). 184 Chapter 4 RL Reference Level Syntax RL SP real DBM DBMV DBUV ; LF CR MV UV V SP UP MW DN UW OA W SP , DM ? Description Specifies the amplitude level of the top graticule line on the display. This represents the 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 45. NOTE If the display line is on, changing the reference level does not adjust the position of the display line. Chapter 4 185 Programming Commands Programming Commands RL Reference Level Programming Commands Programming Commands ROFFSET Reference Level Offset ROFFSET Reference Level Offset Syntax ROFFSET SP real DB UP SP DN ? ; LF CR SP , 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. 186 Chapter 4 RQS Request Service Conditions Syntax RQS SP number ; LF ? CR SP , Description Sets a bit mask for service requests. Chapter 4 187 Programming Commands Programming Commands RQS Request Service Conditions Programming Commands Programming Commands S1[one] Continuous Sweep S1[one] Continuous Sweep Syntax S1 ; LF CR SP , 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 98). 188 Chapter 4 S2 [two] Single Sweep Syntax S2 ; LF CR SP , 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 194). Chapter 4 189 Programming Commands Programming Commands S2 [two] Single Sweep Programming Commands Programming Commands SAVES Save State SAVES Save State Syntax SAVES SP digit ; LF CR SP , 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 201). 190 Chapter 4 SER Serial Number Syntax SER ? ; LF CR SP , Description The SER command returns the X-series analyzer serial number to the controller. Chapter 4 191 Programming Commands Programming Commands SER Serial Number Programming Commands Programming Commands SETDATE Set Date SETDATE Set Date Syntax SETDATE SP number ? ; LF CR SP , Description The SETDATE command sets the date of the real-time clock of the analyzer. The date takes the form YYMMDD (Year, Month, Day) 192 Chapter 4 SETTIME Set Time Syntax SETTIME SP number ? ; LF CR SP , Description The SETTIME command sets the date of the real-time clock of the analyzer. The time takes the form HHMMSS (Hour, Minute, Second) Chapter 4 193 Programming Commands Programming Commands SETTIME Set Time Programming Commands Programming Commands SNGLS Single Sweep SNGLS Single Sweep Syntax SNGLS ; LF CR SP , 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 189). 194 Chapter 4 SP Frequency Span Syntax SP SP real HZ ; KHZ LF MHZ CR GHZ KZ MZ SP , GZ SP UP DN OA FULL ZERO LAST ? Step Increment: 1, 2, 5, 10 sequence (up to the stop frequency of the analyzer) 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 180), VB (page 219), or ST (page 198) have been executed. Chapter 4 195 Programming Commands Programming Commands SP Frequency Span Programming Commands Programming Commands SRQ Service Request SRQ Service Request Syntax SRQ SP digit ; LF CR SP , 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. 196 Chapter 4 SS Center Frequency Step Size Syntax SS SP real UP SP DN AUTO MAN OA HZ ; KHZ LF MHZ CR GHZ KZ MZ SP , GZ ? Description The SS command specifies center frequency step size. Chapter 4 197 Programming Commands Programming Commands SS Center Frequency Step Size Programming Commands Programming Commands ST Sweep Time ST Sweep Time Syntax ST SP real UP SP DN S ; MS LF US CR SC SP AUTO MAN , OA ? 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 option does not set the active function to Sweep Time. 198 Chapter 4 STB Status Byte Query Syntax STB ? ; LF CR SP , Description The STB command returns to the controller the decimal equivalent of the bits set in the status byte (see the RQS (page 187) and SRQ (page 196) commands). STB is equivalent to a serial poll. Chapter 4 199 Programming Commands Programming Commands STB Status Byte Query Programming Commands Programming Commands SUM Sum SUM Sum Syntax SUM Sp TRA , ? ; LF TRB CR SP , Description Returns the sum of all the trace values to the controller. NOTE Returns display units, range (0-610)*601 points or if Trace Data Format (TDF) is set to M, it returns ASCII. 200 Chapter 4 SV Save State Syntax SV SP digit ; LF CR SP , 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 190). Chapter 4 201 Programming Commands Programming Commands SV Save State Programming Commands Programming Commands SWPCPL Sweep Couple SWPCPL Sweep Couple Syntax SWPCPL SP SA ; SR LF ? CR SP , The preset value is SA. 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. 202 Chapter 4 T1 [one] Free Run Trigger Syntax T1 ; LF CR SP , 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 213). Chapter 4 203 Programming Commands Programming Commands T1 [one] Free Run Trigger Programming Commands Programming Commands T2 [two] Line Trigger T2 [two] Line Trigger Syntax T2 ; LF CR SP , 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 213). 204 Chapter 4 T3 [three] External Trigger Syntax T3 ; LF CR SP , 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 213). Chapter 4 205 Programming Commands Programming Commands T3 [three] External Trigger Programming Commands Programming Commands T4 [four] Video Trigger T4 [four] Video Trigger Syntax T4 ; LF CR SP , 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 213). 206 Chapter 4 TA Trace A Syntax TA ? ; LF CR SP , 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. The format of the returned data is affected by the TDF (Trace Data Format) (page 209) command. Chapter 4 207 Programming Commands Programming Commands TA Trace A Programming Commands Programming Commands TB Trace B TB Trace B Syntax TB ? ; LF CR SP , 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. The format of the returned data is affected by the TDF (Trace Data Format) (page 209) command. 208 Chapter 4 TDF Trace Data Format Syntax TDF SP P ; A LF I CR M B ? SP , The preset value for TDF is P. 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. • Specifying I returns data as an I-block data field. • B selects binary data format. Chapter 4 209 Programming Commands Programming Commands TDF Trace Data Format Programming Commands Programming Commands TH Threshold TH Threshold Syntax TH SP real SP DM ; MV LF UP UV DN DB CR ON OFF SP , OA ? 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. 210 Chapter 4 TIMEDATE Time Date Syntax TIMEDATE SP number ? ; LF CR SP , 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. Chapter 4 211 Programming Commands Programming Commands TIMEDATE Time Date Programming Commands Programming Commands TITLE Title TITLE Title Syntax string delimiter TITLE char real string delimiter ; LF CR SP , 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. • ! • “ • $ • % • & • ‘ • / • : • = • \ • ~ • @ 212 Chapter 4 TM Trigger Mode Syntax TM SP FREE ; VID LF LINE CR EXT ? SP , Description Selects a trigger mode: free, line, video, or external. NOTE The functions of the TM command are identical to the T1 (page 203), T2 (page 204), T3 (page 205) and T4 (page 206) commands. Chapter 4 213 Programming Commands Programming Commands TM Trigger Mode Programming Commands Programming Commands TRA Trace Data Input and Output TRA Trace Data Input and Output Syntax TRA ? ; LF CR SP , 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 209) for details on formatting. 214 Chapter 4 TRB Trace Data Input and Output Syntax TRB ? ; LF CR SP , 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 209 for details on formatting. Chapter 4 215 Programming Commands Programming Commands TRB Trace Data Input and Output Programming Commands Programming Commands TRIGPOL Trigger Polarity TRIGPOL Trigger Polarity Syntax TRIGPOL SP POS ; NEG LF ? CR SP , Description Selects the edge (positive or negative) of the trigger input that causes the trigger event. TRIGPOL is available in all trigger modes. 216 Chapter 4 TS Take Sweep Syntax TS ; LF CR SP , 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. Chapter 4 217 Programming Commands Programming Commands TS Take Sweep Programming Commands Programming Commands VAVG Video Average VAVG Video Average Syntax VAVG SP average length SP UP ; LF DN ON CR SP OFF , ? 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. 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. Table 4-18 Legacy Analyzers - Video Averaging Behavioral Differences Condition Legacy Spectrum Analyzers N9061A application Average Count value set to 0. Cannot be set to 0. Video averaging is turned off if the Averaging Count is set to 0. Averaging turned on. Sweep time remains unchanged. Sweep time changes due to the selection of the sample detector. Change in center frequency or span. In single sweep mode, resets counter to zero and starts the averaging again. In single sweep mode the X-Series analyzer uses all stored averages. Does not reset the counter after changes in RBW, VBW, Sweep Time, Ref. Level and Attenuation. 218 Chapter 4 VB Video Bandwidth Syntax VB SP real HZ ; KHZ LF MHZ UP SP DN AUTO MAN CR GHZ KZ MZ SP , GZ OA ? Description Specifies the video bandwidth, which is a post-detection, low-pass filter. Chapter 4 219 Programming Commands Programming Commands VB Video Bandwidth Programming Commands Programming Commands VBR Video Bandwidth to Resolution Bandwidth Ratio VBR Video Bandwidth to Resolution Bandwidth Ratio Syntax VBR SP number ; SP UP LF DN CR OA ? SP , 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. 220 Chapter 4 VIEW View Trace Syntax VIEW SP TRA ; TRB LF CR SP , 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 53) and B3 (page 82) commands. NOTE TRA corresponds to Trace 1 and TRB corresponds to Trace 2. For information on the settings of the X-series analyzers when legacy instrument trace settings are sent, see Table 4-4, “8560 series command mapping to X-series for trace/detector settings.” Chapter 4 221 Programming Commands Programming Commands VIEW View Trace Programming Commands Programming Commands VTL Video Trigger Level VTL Video Trigger Level Syntax VTL SP number SP DB ; DBM LF UP DBM V DN DBUV MV UV CR SP , V MW UW W DM ? 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 213). 222 Chapter 4 A Brief Introduction to the SCPI Language 5 A Brief Introduction to the SCPI Language 223 A Brief Introduction to the SCPI Language SCPI Language Basics SCPI Language Basics This section is not intended to teach you everything about the SCPI (Standard Commands for Programmable Instruments) programming language. The SCPI Consortium or IEEE can provide that level of detailed information. A Brief Introduction to the SCPI Language Topics covered in this chapter include: • “Command Keywords and Syntax” on page 224 • “Creating Valid Commands” on page 224 • “Special Characters in Commands” on page 225 • “Parameters in Commands” on page 227 • “Putting Multiple Commands on the Same Line” on page 229 For more information refer to: IEEE Standard 488.1-2004, IEEE Standard Digital Interface for Programmable Instrumentation. New York, NY, 1998. IEEE Standard 488.2-2004, IEEE Standard Codes, Formats, Protocols and Comment Commands for Use with ANSI/IEEE Std488.1-1987. New York, NY, 1998. Command Keywords and Syntax A typical command is made up of keywords set off by colons. The keywords are followed by parameters that can be followed by optional units. Example: SENSe:FREQuency:STARt 1.5 MHZ The instrument does not distinguish between upper and lower case letters. In the documentation, upper case letters indicate the short form of the keyword. The lower case letters, indicate the long form of the keyword. Either form may be used in the command. Example: Sens:Freq:Star 1.5 mhz is the same as SENSE:FREQ:start 1.5 MHz 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. Creating Valid Commands Commands are not case sensitive and there are often many different ways of writing a particular command. These are examples of valid commands for a given 224 Chapter 5 A Brief Introduction to the SCPI Language SCPI Language Basics command syntax: Command Syntax Sample Valid Commands [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 • 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. [:SENSe]:DETector[:FUNCtion] NEGative|POSitive|SAMPle • DET:FUNC neg • Detector:Func Pos INITiate:CONTinuous ON|OFF|1|0 The sample commands below are identical. • INIT:CONT ON • init:continuous 1 Special Characters in Commands Special Character | Meaning A vertical stroke between parameters indicates alternative choices. The effect of the command is different depending on which parameter is selected. Example Command: TRIGger:SOURce EXTernal|INTernal|LINE The choices are external, internal, and line. Ex: TRIG:SOURCE INT is one possible command choice. A vertical stroke between keywords indicates identical effects exist for both keywords. The command functions the same for either keyword. Only one of these keywords is used at a time. Chapter 5 Command: SENSe:BANDwidth|BWIDth: OFFSet Two identical commands are: Ex1: SENSE:BWIDTH:OFFSET Ex2: SENSE:BAND:OFFSET 225 A Brief Introduction to the SCPI Language MEASure:SPECtrum[n]? • A Brief Introduction to the SCPI Language SCPI Language Basics Special Character A Brief Introduction to the SCPI Language [] <> Meaning Example keywords in square brackets are optional when composing the command. These implied keywords are executed even if they are omitted. Command: [SENSe:]BANDwidth[:RESolu tion]:AUTO Angle brackets around a word, or words, indicates they are not to be used literally in the command. They represent the needed item. Command: SENS:FREQ <freq> The following commands are all valid and have identical effects: Ex1: bandwidth:auto Ex2: band:resolution:auto Ex3: sense:bandwidth:auto In this command example the word <freq> should be replaced by an actual frequency. Ex: SENS:FREQ 9.7MHz. {} 226 Parameters in braces can optionally be used in the command either not at all, once, or several times. Command: MEASure:BW <freq>{,level} A valid command is: meas:BW 6 MHz, 3 dB, 60 dB Chapter 5 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. 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 Chapter 5 227 A Brief Introduction to the SCPI Language keyword 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> A Brief Introduction to the SCPI Language <time> <seconds> Is a positive rational number followed by optional units. The default unit is Hertz. Acceptable units include: Hz, kHz, MHz, GHz. 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> <percent> <angle> <degrees> Is a positive rational number followed by optional units. The default units are dB. Acceptable units include: dB. Is a rational number between 0 and 100. You can either use no units or use PCT. 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: • • • 228 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. Chapter 5 A Brief Introduction to the SCPI Language SCPI Language Basics Block Program Data Some parameters consist of a block of data. There are a few standard types of block data. Arbitrary blocks of program data can also be used. <trace> Is an array of rational numbers corresponding to displayed trace data. See FORMat:DATA for information about available data formats. A SCPI command often refers to a block of current trace data with a variable name such as: Trace1, TRACE2, or trace3, depending on which trace is being accessed. Block data example: suppose the header is #512320. • The first digit in the header (5) tells you how many additional digits/bytes there are in the header. • The 12320 means 12 thousand, 3 hundred, 20 data bytes follow the header. • Divide this number of bytes by your current data format (bytes/data point), either 8 (for real,64), or 4 (for real,32). For this example, if you’re using real64 then there are 1540 points in the block. Putting Multiple Commands on the Same Line Multiple commands can be written on the same line, reducing your code space requirement. To do this: • Commands must be separated with a semicolon (;). • If the commands are in different subsystems, the key word for the new subsystem must be preceded by a colon (:). • If the commands are in the same subsystem, the full hierarchy of the command key words need not be included. The second command can start at the same key word level as the command that was just executed. SCPI Termination and Separator Syntax All binary trace and response data is terminated with <NL><END>, as defined in Section 8.5 of IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and Common Commands for Use with ANSI/IEEE Std 488.1-1987. New York, NY, 1992. (Although one intent of SCPI is to be interface independent, <END> is only defined for IEEE 488 operation.) Chapter 5 229 A Brief Introduction to the SCPI Language <arbitrary block data> Consists of a block of data bytes. The first information sent in the block is an ASCII header beginning with #. The block is terminated with a semi-colon. The header can be used to determine how many bytes are in the data block. There are no units. (You do not get block data if your data type is ASCII, using FORMat:DATA ASCII command. Your data is comma separated ASCII values. 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: A Brief Introduction to the SCPI Language [:SENSe] :POWer [:RF] :ATTenuation 40dB :TRIGger [:SEQuence] :EXTernal [1] :SLOPe POSitive [:SENSe] :FREQuency :STARt :POWer [:RF] :MIXer :RANGe [:UPPer] Bad Command Good Command PWR:ATT 40dB POW:ATT 40dB The short form of POWER is POW, not PWR. FREQ:STAR 30MHz;MIX:RANG -20dBm FREQ:STAR 30MHz;POW:MIX:RANG -20dBm 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. FREQ:STAR 30MHz;POW:MIX RANG -20dBm FREQ:STAR 30MHz;POW:MIX:RANG -20dBm MIX and RANG require a colon to separate them. :POW:ATT 40dB;TRIG:FREQ:STAR 2.3GHz :POW:ATT 40dB;:FREQ:STAR 2.3GHz :FREQ:STAR is in the :SENSE subsystem, not the :TRIGGER subsystem. :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. :POW:ATT -5dB;:FREQ:STAR 10MHz :POW:ATT 5dB;:FREQ:STAR 10MHz Attenuation cannot be a negative value. 230 Chapter 5 Index Numerics 8560E/EC remote language, 8561E/EC remote language, 8562E/EC remote language, 8563E/EC remote language, 8564E/EC remote language, 8565E/EC remote language, AMB, 72 AMBPL, 73 amplitude marker, 148 amplitude units, 49, 77 analyzer command, 49 angle parameter (variables), 228 ANNOT, 74 annotation, 74 APB, 75 arbitrary block data, 229 AT, 76 attenuation, 76 coupling, 89 AUNITS, 77 auto couple, 78 AUTOCPL, 78 average video, 218 AXB, 79 B B minus display line, 84 B1, 80 B2, 81 B3, 82 B4, 83 bandwidth channel power, 95 marker, 149 occupied power, 175 power, 179 resolution, 180 video, 219 bit_pattern parameter (variables), 228 BL, 84 BLANK, 85 blank trace, 54, 83, 85 blanking threshold, 210 block data arbitrary, 229 identifying block size, 229 parsing output, 229 BML, 86 boolean parameter (commands), 227 C C1, 87 C2, 88 CA, 89 carrier off power, 90 carrier on power, 91 CARROFF, 90 CARRON, 91 center frequency, 92 marker, 110, 150 step size, 197 CF, 92 CHANNEL, 93 channel power, 94 bandwidth, 95 channel selection, 93 CHANPWR, 94 character EOI, 49 characters, 48 CHPWRBW, 95 clear write, 51, 80, 96 Clear Log, 22 CLRW, 96 Cmd Error log softkey, 22 command mnemonic, 48 terminators, 48 commands boolean parameter, 227 keyword parameter, 227 multiple on a line, 229 parameters, 227 syntax, 224 termination, IEEE, 229 units parameter, 227 valid commands, 224 variable parameter, 227 variable parameter keywords, 227 continuous sweep, 98, 188 CONTS, 98 counter marker, 154 COUPLE, 99 couple attenuation, 89 auto, 78 frequency step size, 101 input, 99 resolution bandwidth, 100 sweep time, 102 video bandwidth, 103 couple sweep, 202 coupling AC/DC, 131, 132 CR, 100 CS, 101 CT, 102 current units, 49 CV, 103 D data arbitrary blocks, 229 data byte, 49 data byte EOI, 49 data entry hold, 130 231 Index A A minus B into A, 72, 88 off, 87 plus display line, 73 A plus B to A, 75 A1, 51 A2, 52 A3, 53 A4, 54 absolute amplitude units, 77 AC coupling, 132 AC/DC, 131, 132 ACPALPHA, 55 ACPALTCH, 56 ACPBRPER, 57 ACPBRWID, 58 ACPBW, 59 ACPCOMPUTE, 60 ACPFRQWT, 61 ACPLOWER, 62 ACPMAX, 63 ACPMEAS, 64 ACPMSTATE, 65 ACPPWRTX, 66 ACPRSLTS, 67 ACPSP, 68 ACPT, 69 ACPUPPER, 70 adjacent channel power alpha weighting, 55 alternate channels, 56 bandwidth, 59 burst period, 57 burst width, 58 channel spacing, 68 compute, 60 frequency weighting, 61 lower, 62 maximum, 63 measure, 64 measurement results, 67 measurement state, 65 T weighting, 69 total power transmitted, 66 upper, 70 ADJALL, 71 alpha weighting, 55 21 21 21 21 21 21 Index Index data format trace, 209 date, 211 set, 192 DC coupling, 131 degree parameter (variables), 228 delay sweep, 107 delimiter, 49 DELMKBW, 104 delta marker, 140, 151 occupied power bandwidth, 104 step size, 111 DET, 105 detection mode, 105 digit, 49 display frequency, 119 line, 106 line off, 135 DL, 106 DLYSWP, 107 documentation, 27 DONE, 108 done parsing, 108 dotted lines optional path, 48 E E1, 109 E2, 110 E3, 111 E4, 112 elapsed time, 115 ERR, 113 error, 113 errors clearing, 22 ET, 115 EX, 116 exchange traces A and B, 79, 116 excursion marker peak, 162 external trigger, 205 external trigger mode, 213 F FA, 117 FB, 118 FDSP, 119 FOFFSET, 120 format trace data, 209 232 free run trigger, 203 free trigger mode, 213 FREF, 121 frequency center, 92 display off, 119 marker, 153 offset, 120 reference, 121 span, 195 start, 117 stop, 118 units, 49 frequency parameter (variables), 228 FS, 122 full span, 122 G GATE, 124 gate, 124 gate control, 125 gate delay, 126 gate length, 127 gate polarity, 128 GATECTL, 125 GD, 126 getting started, 14 GL, 127 GP, 128 GRAT, 129 graticule, 129 H hardware requirements, 16 HD, 130 hints compatibility, 46 speed, 46 synchronization, 46 hold data entry, 130 maximum, 171 minimum, 147 I I1, 131 I2, 132 ID, 133 identify remote language, 133 IEEE command termination, 229 IF adjustment, 71 impedance units, 49 input attenuation, 76 coupling, 99 input attenuation, 23 installing N9061A, 17 instrument preset, 134 integer variable (variables), 228 IP, 134 K keyword parameter (commands), 227 L L0, 135 legacy instrument selection, 21 level mixer, 168 reference, 185 reference offset, 186 video trigger, 222 LG, 136 licensing, 17 licensing N9061A, 17 limitations commands supported, 14 predefined functions, 15 user-defined functions, 15 line trigger, 204 line trigger mode, 213 linear scale, 137 LN, 137 LO adjustment, 71 LO and IF adjustment, 71 loading N9061A, 17 log file, 22 logarithmic scale, 136 logging, 22 lower adjacent channel power, 62 lsb length, 49 M M1, 138 M2, 139 M3, 140 MA, 142 marker amplitude, 148 amplitude output, 142 bandwidth, 149 center frequency, 110, 150 counter resolution, 155 delta, 140, 151 delta step size, 111 frequency, 153 frequency counter, 154 frequency output, 146 minimum, 156 noise, 158 normal, 139, 157 Index N N9061A-2FP - installation, 17 noise marker, 158 measurement, 158 signal to noise ratio, 158 normal marker, 139, 157 normalize trace data, 172 normalized reference level, 173 normalized reference position, 174 NORMLIZE, 172 NRL, 173 NRPOS, 174 number syntax, 49 O OCCUP, 175 occupied power bandwidth, 175 occupied power bandwidth within delta marker, 104 offset frequency, 120 reference level, 186 output data, identifying block size, 229 output termination, 49 P parameter (variables), 228 parameters (commands), 227 parameters, variable, 228 parsing done, 108 peak excursion marker, 162 marker, 109, 160 pre-selector, 177 percent occupied power bandwidth, 175 percent parameter (variables), 228 phase parameter (variables), 228 PLOT, 176 polarity trigger, 216 power bandwidth, 179 carrier off, 90 carrier on, 91 channel, 94 percent occupied bandwidth, 175 power measurement mean, 144 power parameter (variables), 228 PP, 177 pre-selector peak, 177 preset instrument, 134 PRINT, 178 programming command parameters, 227 command syntax, 224 SCPI basics, 224 valid commands, 224 PWRBW, 179 Q query status byte, 199 sweep, 145 R ratio VBW/RBW, 220 RB, 100, 180 RBR, 181 RBW to span ratio, 181 RBW/VBW, 23 RC, 182 RCLS, 183 recall last state, 182 recall state, 183 recommended path, 48 reference level, 185 marker to, 112, 163 normalized, 173 offset, 186 reference position normalized, 174 Refresh log file, 22 relative power parameter (variables), 228 remote language 8560E/EC, 21 8561E/EC, 21 8562E/EC, 21 8563E/EC, 21 8564E/EC, 21 8565E/EC, 21 selection, 21 repeating syntax element, 48 request service conditions, 187 reserved words, 48 resolution marker counter, 155 resolution bandwidth, 180 coupling, 100 to span ratio, 181 video bandwidth ratio, 220 results data, identifying block size, 229 returning or storing trace values, 207, 208, 214, 215 REV, 184 revision, 184 RL, 185 ROFFSET, 186 233 Index occupied power bandwidth, 104 off, 138, 159 peak, 109, 160 peak excursion, 162 reference level, 112 step size, 111, 165 threshold, 161 time, 166 to center frequency, 110 to reference level, 112, 163 to span, 164 track, 167 track off, 169 track on, 170 max mixer level, 23 maximum adjacent channel power, 63 maximum hold, 52, 81, 171 MEAN, 143 mean power measurement, 144 trace, 143 MEANPWR, 144 MEAS, 145 MF, 146 MINH, 147 minimum hold, 147 marker, 156 mixer level, 168 MKA, 148 MKBW, 149 MKCF, 150 MKD, 151 MKF, 153 MKFC, 154 MKFCR, 155 MKMIN, 156 MKN, 157 MKNOISE, 158 MKOFF, 159 MKPK, 160 MKPT, 161 MKPX, 162 MKRL, 163 MKSP, 164 MKSS, 165 MKT, 166 MKTRACK, 167 ML, 168 mnemonic command, 48 msb length, 49 MT0, 169 MT1, 170 MXMH, 171 Index Index RQS, 187 S S1, 188 S2, 189 save state, 190, 201 SAVES, 190 scale linear, 137 logarithmic, 136 SCPI language basic info, 224 command parameters, 227 command syntax, 224 keyword parameters, 227 valid commands, 224 screen title, 212 display, 212 scrolling log file, 22 secondary keywords, 48 select remote language, 21 selection channel, 93 SER, 191 serial number, 191 service request, 196 set date, 192 RF coupling to AC, 132 RF coupling to DC, 131 time, 193 SETDATE, 192 SETTIME, 193 shipment verification list, 27 signal-to-noise ratio, 158 single sweep, 189, 194 SNGLS, 194 softkeys 8560 Series, 21 8560E/EC, 21 8561E/EC, 21 8562E/EC, 21 8563E/EC, 21 8564E/EC, 21 8565E/EC, 21 Atten Offset, 23 Clear Log, 22 Cmd Error Log, 22 Limit RBW/VBW, 23 Next Page, 22 Previous Page, 22 Refresh, 22 SP, 195 span, 181, 195 frequency, 195 full, 122 234 marker, 164 special, 48 numbers, 48 SRQ, 196 user-defined, 196 SS, 197 ST, 198 start frequency, 117 state recall, 182, 183 save, 190, 201 status byte query, 199 STB, 199 step size center frequency, 197 marker, 165 stop frequency, 118 string parameter (variables), 228 SUM, 200 sum of traces, 200 SV, 201 sweep continuous, 98, 188 couple, 202 delay, 107 query, 145 single, 189, 194 take, 217 time, 198 sweep time coupling, 102 SWPCPL, 202 syntax elements, 48 syntax for commands, 48 T T weighting adjacent channel power, 69 T1, 203 T2, 204 T3, 205 T4, 206 TA, 207 take sweep, 217 TB, 208 TDF, 209 terminators command, 48 TH, 210 threshold, 210 marker, 161 time, 211 elapsed, 115 marker, 166 set, 193 units, 49 time date, 211 time parameter (variables), 228 TIMEDATE, 211 time-gating, 124 tips compatibility, 46 speed, 46 synchronization, 46 TITLE, 212 title, 212 TM, 213 TRA, 214 trace blank, 54, 85 data format, 209 data I/O, 207, 208, 214, 215 mean, 143 returning values, 207, 208, 214, 215 storing values, 207, 208, 214, 215 view, 53, 82 trace B minus display line, 86 trace data format, 229 track marker, 167 TRB, 215 trigger external, 205 free run, 203 line, 204 mode, 213 polarity, 216 video, 206 video level, 222 triggering the analyzer, 213 TRIGPOL, 216 TS, 217 turning logging on, 22 TV trigger mode, 213 U units, 49 units parameter (commands), 227 upper adjacent channel power, 70 URL signal analyzer updates, 27 user-defined SRQ, 196 V variable parameter (commands), 227 variables angle parameter, 228 bit_data parameter, 228 degree parameter, 228 frequency parameter, 228 integer parameter, 228 parameters, 228 percent parameter, 228 phase parameter, 228 power parameter, 228 relative power parameter, 228 Index string parameter, 228 time parameter, 228 voltage parameter, 228 VAVG, 218 VB, 219 VBR, 220 VBW/RBW ratio, 220 video average, 218 video bandwidth, 219 coupling, 103 video bandwidth to resolution bandwidth ratio, 220 video trigger, 206 video trigger level, 222 video trigger mode, 213 VIEW, 221 view mode, 53, 82 trace, 221 view trace, 53, 82 view trace, trace view, 221 voltage parameter (variables), 228 VTL, 222 W website firmware updates, 27 Index 235 Index Index 236
* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project
advertisement