12.07.2015 Views

Volume 1: Syntax and Style

Volume 1: Syntax and Style

Volume 1: Syntax and Style

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

St<strong>and</strong>ardComm<strong>and</strong>s forProgrammableInstruments(SCPI)<strong>Volume</strong> 1: <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>VERSION 1997.0May, 1997Printed in U.S.A.


NOTICE, STATEMENT of INTENT<strong>and</strong>AUTHORIZATION TO COPY© Copyright 1997 SCPI ConsortiumThis document defines the St<strong>and</strong>ard-Comm<strong>and</strong>s-for-Programmable-Instruments (SCPI) Consortium’sSCPI st<strong>and</strong>ard. Although the Consortium hereby expressly disclaims any <strong>and</strong> all warranties whatsoeverregarding the SCPI st<strong>and</strong>ard, the Consortium has published this document with the intent that the SCPIst<strong>and</strong>ard will be seriously considered <strong>and</strong> adopted, in whole, by the test <strong>and</strong> measurement marketplace.Consistent with that intent, permission is hereby granted by the Consortium to make copies of thisentire document as a whole, PROVIDED THAT this NOTICE, STATEMENT of INTENT <strong>and</strong>AUTHORIZATION TO COPY shall prominently appear on each such whole copy. Further consistentwith that intent, permission is hereby granted by the consortium to make copies of portions of thisdocument, absent this NOTICE, STATEMENT of INTENT <strong>and</strong> AUTHORIZATION TO COPY,PROVIDED THAT each such portion-copies shall only be used in a manner which is consistent withthe purposes of implementing, promoting, disseminating, or enhancing (as opposed to deviating from)the SCPI st<strong>and</strong>ard as herein defined, such as the inclusion of such a portion-copy in an instrument (orinstrument-related) product manual which implements SCPI (as defined herein) or in use for design ofsuch an instrument (or instrument related) product. However, under no circumstances may copies ofthis document, or any portion of this document, be made solely for purposes of sale of the copy orcopies.For information, contact:Fred Bode, Executive DirectorSCPI Consortium8380 Hercules Drive, Suite P3La Mesa, CA 91942Phone: (619) 697-8790FAX: (619) 697-5955CompuServe Number: 76516,254fbode@vxinl.comi


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>ForewordCommercial computer-controlled test instruments introduced in the 1960s used a wide variety ofnon-st<strong>and</strong>ard, proprietary interfaces <strong>and</strong> communication protocols. In 1975, the Institute of Electrical<strong>and</strong> Electronic Engineers approved IEEE 488-1975. IEEE 488 defined a st<strong>and</strong>ard electrical <strong>and</strong>mechanical interface for connectors <strong>and</strong> cables. It also defined h<strong>and</strong>shaking, addressing, <strong>and</strong> generalprotocol for transmitting individual bytes of data to <strong>and</strong> from instruments <strong>and</strong> computers. This st<strong>and</strong>ardhas been updated <strong>and</strong> is now IEEE 488.1-1987.Although it solved the problem of how to send bytes of data between instruments <strong>and</strong> computers, IEEE488 did not specify the data bytes’ meanings. Instrument manufacturers freely invented new comm<strong>and</strong>sas they developed new instruments. The format of data returned from instruments varied as well. Bythe early 1980s, work began on additional st<strong>and</strong>ards to specify how to interpret data sent via IEEE 488.In 1987, the IEEE released IEEE 488.2-1987, Codes, Formats, Protocols <strong>and</strong> Common Comm<strong>and</strong>s forUse with IEEE 488.1-1987. This st<strong>and</strong>ard defined the roles of instruments <strong>and</strong> controllers in ameasurement system <strong>and</strong> a structured scheme for communication. In particular, IEEE 488.2 describedhow to send comm<strong>and</strong>s to instruments <strong>and</strong> how to send responses to controllers. It defined somefrequently used “housekeeping” comm<strong>and</strong>s explicitly, but each instrument manufacturer was left withthe task of naming any other types of comm<strong>and</strong> <strong>and</strong> defining their effect. IEEE 488.2 specified howcertain types of features should be implemented if they were included in an instrument. It generally didnot specify which features or comm<strong>and</strong>s should be implemented for a particular instrument. Thus, itwas possible that two similar instruments could each conform to IEEE 488.2, yet they could have anentirely different comm<strong>and</strong> set.St<strong>and</strong>ard Comm<strong>and</strong>s for Programmable Instruments (SCPI) is the new instrument comm<strong>and</strong> languagefor controlling instruments that goes beyond IEEE 488.2 to address a wide variety of instrumentfunctions in a st<strong>and</strong>ard manner. SCPI promotes consistency, from the remote programming st<strong>and</strong>point,between instruments of the same class <strong>and</strong> between instruments with the same functional capability.For a given measurement function such as frequency or voltage, SCPI defines the specific comm<strong>and</strong> setthat is available for that function. Thus, two oscilloscopes made by different manufacturers could beused to make frequency measurements in the same way. It is also possible for a SCPI counter to make afrequency measurement using the same comm<strong>and</strong>s as an oscilloscope.SCPI comm<strong>and</strong>s are easy to learn, self-explanatory <strong>and</strong> account for both novice <strong>and</strong> expertprogrammer’s usage. Once familiar with the organization <strong>and</strong> structure of SCPI, considerableefficiency gains can be achieved during control program development, independent of the controlprogram language selected.iii


Table of ContentsChapter 1 Introduction1.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11.2 Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11.3 SCPI Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11.4 SCPI Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21.5 Instrument Interchangeability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3Chapter 2 ReferencesChapter 3 Life Cycle3.1 Adding a Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13.2 Obsoleting a Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13.3 Device Dependent Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Chapter 4 SCPI Compliance Criteria4.1 IEEE 488.2 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.1 IEEE M<strong>and</strong>ated Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.2 IEEE Optional Common Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.3 IEEE Common Comm<strong>and</strong> Implications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.3.1 Overlapped <strong>and</strong> Sequential Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.3.2 *CLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.3.3 *OPC <strong>and</strong> *WAI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34.1.3.4 *OPC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34.1.3.5 *RST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.1.3.5.1 Interaction With the Synchronization Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.1.3.5.2 Implications For *SAV <strong>and</strong> *RCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.1.3.5.3 *RST <strong>and</strong> *RCL as Overlapped Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.1.3.6 *IDN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2 SCPI Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2.1 Required Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2.2 Optional Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2.3 Documentation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6Chapter 5 Notation5.1 Interpreting Comm<strong>and</strong> Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15.2 Interpreting <strong>Syntax</strong> Flow Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2v


8.3.1.2 Precedence Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-38.3.1.3 Semantics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-38.3.2 Channel Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-38.3.3 Numeric Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6Chapter 9 Status Reporting9.1 The Device-Dependent Register Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-39.2 Transition Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-39.3 Operation Status Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-39.4 QUEStionable Data/Signal Status Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-49.5 Multiple Logical Instruments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-59.6 Status Structure for the Exp<strong>and</strong>ed Capability Trigger Model . . . . . . . . . . . . . . . . . . . . . . . . . 9-7Chapter 10 *RST ConditionsChapter 11 Naming Conventions11.1 :DEFine , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211.2 :DEFine? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211.3 :DELete[:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211.4 :DELete:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211.5 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2Chapter A Programming Tips1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>vii


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>viii


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>1 Introduction1.1 RequirementsThis volume, “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>,” is global in nature <strong>and</strong> shall be used with all other volumesof the SCPI st<strong>and</strong>ard.1.2 OrganizationThe first five chapters of <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong> are an introduction to the overall concept of SCPI1997. They describe an overview of the st<strong>and</strong>ard, reference other st<strong>and</strong>ards, describe SCPIcompliance criteria, <strong>and</strong> how to interpret comm<strong>and</strong> tables <strong>and</strong> syntax flow diagrams. Thenext three chapters in this volume describe the program headers, parameters <strong>and</strong> expressionsfrom which SCPI comm<strong>and</strong>s <strong>and</strong> responses are built. Following this are chapters whichdescribe the status reporting model, style guidelines for creating new comm<strong>and</strong>s, the effectof *RST on parameter values, <strong>and</strong> facilities for managing named sets of data in aninstrument.This volume, <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, is the first of the four-volume set that makes up the SCPI1997 St<strong>and</strong>ard. The second <strong>and</strong> largest volume is the SCPI Comm<strong>and</strong> Reference, whichcontains the actual language constructs which appear in instruments. The third volume, DataInterchange Format, defines a st<strong>and</strong>ard representation for data sets which may be usedbetween instruments <strong>and</strong> applications, between applications, or directly betweeninstruments. The fourth volume, Instrument Classes, defines the SCPI comm<strong>and</strong>s <strong>and</strong>behavior needed to implement functionality sets associated with common classes ofinstruments. These four volumes form the complete 1997 SCPI St<strong>and</strong>ard <strong>and</strong> should be usedas a set.This document is intended to apply to “systems” instruments. It defines both organization<strong>and</strong> content of messages at the controller-to-instrument <strong>and</strong> instrument-to-controllerinformation interchange level. This document was developed so that, an instrumentdesigned in accordance with it, shall be able to conform to IEEE Std. 488.1-1987 St<strong>and</strong>ardDigital Interface for Programmable Instrumentation, <strong>and</strong> IEEE Std. 488.2-1987 Codes,Formats <strong>and</strong> Common Comm<strong>and</strong>s For Use With IEEE Std. 488.1-1987. Conformance toIEEE 488.1-1987 <strong>and</strong> IEEE 488.2-1987 is not required by this document, recognizing thatsome instruments implement physical interfaces other than the IEEE 488.1-1987. However,SCPI is based upon the concepts <strong>and</strong> terminology used within these st<strong>and</strong>ards.This document may impact the related person-to-instrument <strong>and</strong> the instrument-to-personinformation interchange levels. Though the main purpose of this document is to define theinterface as it relates to remote control, implementation of these codes <strong>and</strong> formats mayaffect the “front panel” of the instrument involved.1.3 SCPI GoalsThe goal of St<strong>and</strong>ard Comm<strong>and</strong>s for Programmable Instruments (SCPI) is to reduceAutomatic Test Equipment (ATE) program development time. SCPI accomplishes this goalby providing a consistent programming environment for instrument control <strong>and</strong> data usage.This consistent programming environment is achieved by the use of defined program12345678Bode91011121314Bode151617181920212223242526Introduction 1-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>1messages, instrument responses, <strong>and</strong> data formats across all SCPI instruments, regardless ofmanufacturer.A consistent program environment uses the same comm<strong>and</strong>s <strong>and</strong> parameters to controlinstruments that have the same functionality. These program comm<strong>and</strong>s <strong>and</strong> parameters aresent from a controller to an instrument using IEEE 488.1, VXIbus, RS-232C, etc., interfaces.SCPI instruments are very flexible in accepting a range of comm<strong>and</strong> <strong>and</strong> parameter formats,which makes the instrument easier to program. The instrument resonses sent back to thecontroller can be either data or status information. SCPI instrument response format of aparticular query is well-defined <strong>and</strong> reduces the programming effort to underst<strong>and</strong>instrument data <strong>and</strong> status information. Data information can be formatted so that it isdevice- <strong>and</strong> measurement-independent.SCPI programming consistency is both vertical <strong>and</strong> horizontal. Vertical programmingconsistency defines program messages within an instrument class. An example of verticalconsistency is using the same comm<strong>and</strong> for reading DC voltage from several differentmultimeters. Horizontal consistency is using the same comm<strong>and</strong> to control similar functionsacross instrument classes. For example, the trigger comm<strong>and</strong> would be the same for anidentical trigger function found among counters, oscilloscopes, function generators, etc.A key to consistent programming is the reduction of multiple ways to control similarinstrument functions. The philosophy of SCPI is for the same instrument functions to becontrolled by the same SCPI comm<strong>and</strong>s. To simplify learning, SCPI uses industry-st<strong>and</strong>ardnames <strong>and</strong> terms that are manufacturer <strong>and</strong> customer supported.SCPI provides several different levels of instrument control. Simple Measure comm<strong>and</strong>sprovide users easy <strong>and</strong> quick control of SCPI instrumentation, while more detailedcomm<strong>and</strong>s provide traditional instrument control.SCPI is designed to be exp<strong>and</strong>ed with new defined comm<strong>and</strong>s in the future without causingprogramming problems. As new instruments are introduced, the intent is to maintainprogram compatibility with existing SCPI instruments. SCPI ATE test programs designed torun with new instruments may not be compatible with existing instruments. In other words,the test programs are upward-compatible, but not downward-compatible.To promote wide industry acceptance, SCPI is publicly available for implementation byanyone, whether or not they are a member of the SCPI Consortium.The Consortium does not release working documents or provisional documentation. Onlyapproved st<strong>and</strong>ards are released to the public.1.4 SCPI UsageThe advantage of SCPI for the ATE system programmer is reducing the time learning how toprogram new SCPI instruments after programming their first SCPI instrument.Programmers who use programming languages such as BASIC, C, FORTRAN, etc., to sendinstrument comm<strong>and</strong>s to instruments will benefit from SCPI. Also, programmers whoimplement instrument device drivers for ATE program generators <strong>and</strong>/or softwareinstrument front panels will benefit by SCPI’s advantages. SCPI defines instrument1-2 Introduction


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>comm<strong>and</strong>s, parameters, data, <strong>and</strong> status. It is not an application package, programminglanguage, or software intended for instrument front panel control.SCPI is designed to be layered on top of the hardware-independent portion of IEEE 488.2.SCPI can be used with controller-to-instrument interfaces such as IEEE 488.1, VXIbus,RS-232C, etc.1.5 Instrument InterchangeabilityBy providing a consistent programming environment, replacing one SCPI instrument withanother SCPI instrument in an ATE system will usually require less effort than withnon-SCPI instruments. SCPI is not a st<strong>and</strong>ard which completely provides for interchangeableinstrumentation. SCPI helps move toward interchangeability by defining instrumentcomm<strong>and</strong>s <strong>and</strong> responses, but it does not define instrument functionality, accuracy,resolution, connectors, etc., which is needed to provide true instrument interchangeabilitywithout affecting the ATE system hardware <strong>and</strong> software.1234567891011121314151617181920212223242526Introduction 1-3


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>11-4 Introduction


HP0HP0HP0HP0HP0HP01997 SCPI <strong>Syntax</strong> & <strong>Style</strong>2 References“ANSI S1.4”ANSI X3.4-1977, American National St<strong>and</strong>ard Code for Information Interchange;ISO Std.646-1983, ISO 7 bit Coded Character Set for Information InterchangeANSI X3.42-1975, American National St<strong>and</strong>ard Representation of NumericValues in Character Strings for Information Interchange; ISO Std. 6093-1985,Representation of Numeric Values in Character Strings for InformationInterchangeANSI/EIA/TIA-562-1989, Electrical Characteristics for an Unbalanced DigitalInterfaceANSI/IEEE Std 181-1977, IEEE St<strong>and</strong>ard on Pulse Measurement <strong>and</strong> Analysis byObjective TechniquesANSI/IEEE Std 194-1977, IEEE St<strong>and</strong>ard Pulse Terms <strong>and</strong> DefinitionsANSI/IEEE Std. 260-1978, An American National St<strong>and</strong>ard IEEE St<strong>and</strong>ard LetterSymbols for Units of Measurement (SI Units, Customary Inch-Pound Units, <strong>and</strong>Certain Other Units); ISO Std.1000-1981, SI Units <strong>and</strong> Recommendations for theUse of Their Multiples <strong>and</strong> Certain Other UnitsANSI/IEEE Std 488.1-1987, IEEE St<strong>and</strong>ard Digital Interface for ProgrammableInstrumentationANSI/IEEE Std 488.2-1992, IEEE St<strong>and</strong>ard Codes, Formats, Protocols, <strong>and</strong>Common Comm<strong>and</strong>s for use with ANSI/IEEE Std 488.1-1987ANSI/IEEE Std 754-1985, IEEE St<strong>and</strong>ard for Binary Floating-Point ArithmeticBell Telephone “Per BTSM 41004”“CCIR Recommendation 468-2”“CCITT Recommendation P53”CCITT Recommendation V.42, Fascile V111.1 (Blue book, 1988), ErrorCorrecting Procedures for DCE’s Using Asynchronous-to-SynchronousConversion“Dolby Labs Bulletin No 19/4”EIA RS-232-D, Interface Between Data Terminal Equipment <strong>and</strong> DataCommunication Equipment Employing Serial Binary Data InterchangeEIA RS-422, Electrical Characteristics of Balanced Voltage Digital InterfaceCircuits“Fields <strong>and</strong> Waves in Communication Electronics,” Ramo, Whinnery, <strong>and</strong>Van Duzer“IEC Recommendation 179”12345TK01467891011121312-4-94 ltr14151617181920TK014212223 TK01424TK0142526References 2-1


HP0191997 SCPI <strong>Syntax</strong> & <strong>Style</strong>2IEEE Micro, <strong>Volume</strong> 8, Number 4, August, 1988, pp 62-76ISO Std. 2955-1983, Information processing–Representation of SI <strong>and</strong> other unitsin systems with limited character sets“On the Use of Windows for Harmonic Analysis with the Discrete FourierTransform,” F.J. Harris, Proc. of the IEEE, Vol 66-1, January, 1978, pp 51-83“Tuning a Control Loop Performance,” Gregory K. McMillan, InstrumentSociety of America, ISBN 0-87664-694-1VXI Consortium INC, VMEbus Extensions for Instrumentation SystemsSpecification, Revision 1.3XSS01c2-2 References


HP0Ed Chan1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>3 Life CycleSCPI is a “living” st<strong>and</strong>ard. Additional comm<strong>and</strong>s will always be needed to meet the needsof new technologies <strong>and</strong> new instruments. The SCPI Consortium meets regularly to propose<strong>and</strong> review extensions to the comm<strong>and</strong> set. New comm<strong>and</strong>s may be proposed by members ofthe Consortium, <strong>and</strong> by other interested parties.Proposals accepted by the Consortium are published <strong>and</strong> distributed to member companies<strong>and</strong> are available for immediate use. Approved proposals are reviewed annually. After theannual review, a new revision of the SCPI St<strong>and</strong>ard is published, <strong>and</strong> the comm<strong>and</strong>s becomea permenant part of the st<strong>and</strong>ard.All copies of the SCPI St<strong>and</strong>ard contain a version year of issue. All SCPI instruments can bequeried to determine the version-year to which they conform.3.1 Adding a CapabilityIn general, a comm<strong>and</strong> proposed as an extension to SCPI will be approved if it is wellformed according to the rules set forth in “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>”, if it conforms in style tocomm<strong>and</strong>s in the subsystem where it is placed, <strong>and</strong> if there is not already a comm<strong>and</strong> tocontrol the same functionality. The Consortium rejects comm<strong>and</strong>s only on the basis ofobjective criteria.SCPI is designed to grow in an upwardly compatible way. For a control program, this meansthat the aditions to SCPI will not change the meanings of existing comm<strong>and</strong>s, <strong>and</strong> st<strong>and</strong>ardprograms will not need to be rewritten except to add new functionality. For an instrument,upward compatibility means that the instrument functionality will not become inaccessabledue to additions to the language; existing instruments will not become obsolete by theextension of SCPI.3.2 Obsoleting a CapabilityIt is possible that a comm<strong>and</strong> may someday have to be altered or deleted in order to permitimportant new functionality to be implemented. Such an event represents the failure of theextension process because it breaks upward compatibility. Proposals for changes that breakupward compatibility will only be accepted if there is overwhelming evidence that thebenefits to users <strong>and</strong> the member companies of the Consortium outweigh the cost to existingusers.The following comm<strong>and</strong>s have been deleted from the SCPI <strong>Volume</strong> II, Comm<strong>and</strong> Referenceas a part of the SCPI life cycle process. Reuse is discouraged. Any reinstatement is to beaccompanied by a careful review of compatibility issues with all previous versions of theSCPI st<strong>and</strong>ard.KEYWORD PARAMETER FORM NOTES DELETION DATESTATus 1996:QUEue 1996:ENABle 1996[:NEXT]? [query only] 19961234567891011121314151617181920212223242526Life Cycle 3-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>3.3 Device Dependent Comm<strong>and</strong>sFrom time to time manufacturers may elect to build instruments with capabilities that are notcovered by a current version of this st<strong>and</strong>ard. Presumably the manufacturer will submit thesenew comm<strong>and</strong>s into the SCPI Life Cycle process. If the consortium adopts comm<strong>and</strong>s thatare incompatible those originally used by the manufacturer, the manufacturer is permitted toprovide his original comm<strong>and</strong>s in subsequent products for compatibility.33-2 Life Cycle


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>4 SCPI Compliance CriteriaThis section indicates m<strong>and</strong>atory <strong>and</strong> optional capabilities of SCPI. These capabilities arefully specified elsewhere, in “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>”, “Comm<strong>and</strong> Reference”, “Data InterchangeFormat” <strong>and</strong> IEEE 488.2, <strong>and</strong> an instrument designer shall fully comply with the referencedsections. Only designs conforming to these requirements shall be able to claim conformanceto the SCPI specification.4.1 IEEE 488.2 RequirementsAll SCPI instruments shall conform to the specifications for devices in IEEE 488.2, exceptthat section 4.1 IEEE 488.1 Requirements shall be omitted where an instrument does notimplement an IEEE 488.1 interface.Additionally, a SCPI instrument shall be able to parse <strong>and</strong> , to h<strong>and</strong>le the tree structured comm<strong>and</strong>s inSCPI.4.1.1 IEEE M<strong>and</strong>ated Comm<strong>and</strong>sAll SCPI instruments shall implement all the common comm<strong>and</strong>s declared m<strong>and</strong>atory byIEEE 488.2.Mnemonic Name 488.2 Section*CLS Clear Status Comm<strong>and</strong> 10.3*ESE St<strong>and</strong>ard Event Status Enable Comm<strong>and</strong> 10.10*ESE? St<strong>and</strong>ard Event Status Enable Query 10.11*ESR? St<strong>and</strong>ard Event Status Register Query 10.12*IDN? Identification Query 10.14*OPC Operation Complete Comm<strong>and</strong> 10.18*OPC? Operation Complete Query 10.19*RST Reset Comm<strong>and</strong> 10.32*SRE Service Request Enable Comm<strong>and</strong> 10.34*SRE? Service Request Enable Query 10.35*STB? Read Status Byte Query 10.36*TST? Self-Test Query 10.38*WAI Wait-to-Continue Comm<strong>and</strong> 10.394.1.2 IEEE Optional Common Comm<strong>and</strong>sIEEE Std. 488.2 describes several optional comm<strong>and</strong>s which may be implemented in adevice. None of these comm<strong>and</strong>s are required by SCPI.4.1.3 IEEE Common Comm<strong>and</strong> ImplicationsProper implementation of some of the IEEE 488.2 common comm<strong>and</strong>s carry someimplications which are not immediately obvious. Primarily this has to do with thesynchronization comm<strong>and</strong>s.1234567891011121314151617181920212223KI005242526SCPI Compliance Criteria 4-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>44.1.3.1 Overlapped <strong>and</strong> Sequential Comm<strong>and</strong>sIEEE 488.2 defines a distinction between overlapped <strong>and</strong> sequential comm<strong>and</strong>s. As definedin IEEE 488.2, a sequential comm<strong>and</strong> is one which finishes executing before the nextcomm<strong>and</strong> starts executing. An overlapped comm<strong>and</strong> is one which does not finish executingbefore the next comm<strong>and</strong> starts executing. These types of comm<strong>and</strong>s are described in IEEE488.2, section 12. Examples are given in IEEE 488.2, appendix B.IEEE 488.2 defines three common comm<strong>and</strong>s (*OPC, *WAI, *OPC?) which a devicecontroller can use to synchronize its operation to the execution of overlapped comm<strong>and</strong>s.The definitions for these common comm<strong>and</strong>s appear in sections 10.18, 10.19, <strong>and</strong> 10.39 ofIEEE 488.2. All three are required by IEEE 488.2, even if none of the device’s comm<strong>and</strong>sare overlapped.Implementing any device comm<strong>and</strong>s as overlapped will increase the complexity of theimplementation of the three synchronization common comm<strong>and</strong>s.Each overlapped comm<strong>and</strong> has associated with it a Pending Operation flag. The device setsthis flag TRUE when it passes the corresponding comm<strong>and</strong> from the Execution Controlblock to the Device Action block. The device sets the flag false when the device operation isfinished, or has been aborted.IEEE 488.2 defines a No Operation Pending flag. This flag is FALSE whenever any PendingOperation flag is TRUE, <strong>and</strong> is TRUE whenever all Pending Operation flags are FALSE.IEEE 488.2 also permits device designers to decide which overlapped comm<strong>and</strong>s areincluded in the No Operation Pending flag. A device may implement comm<strong>and</strong>s whichselect which overlapped comm<strong>and</strong>s are included in the No Operation Pending flag, althoughthe SCPI st<strong>and</strong>ard does not include such a comm<strong>and</strong>.IEEE 488.2 requires user documentation to clearly indicate which comm<strong>and</strong>s, if any, areoverlapped, <strong>and</strong> which overlapped comm<strong>and</strong>s are included <strong>and</strong> which are excluded from theNo Operation Pending flag.4.1.3.2 *CLSThis comm<strong>and</strong> clears all status data structures in a device. For a device which minimallycomplies with SCPI, these registers are:SESR (IEEE 488.2)OPERation Status Register(SCPI)QUEStionable Status Register(SCPI)Error/Event Queue(SCPI)Execution of *CLS shall also clear any additional status data structures implemented in thedevice. The corresponding enable registers are unaffected. See the table in Comm<strong>and</strong>Reference, 20.7.*CLS forces the device into OCIS <strong>and</strong> OQIS (see 4.1.3.3 <strong>and</strong> 4.1.3.4) without setting the NoOperation Pending flag TRUE <strong>and</strong> without setting the OPC bit of the SESR TRUE <strong>and</strong>without placing a “1” into the Output Queue.4-2 SCPI Compliance CriteriaKI005KI005KI005KI005KI005KI005KI005KI005KI005KI005KI005KI005


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>For example, suppose a device implements INITiate[:IMMediate] as an overlappedcomm<strong>and</strong>. Assuming that the trigger model is programmed so that it will eventually return tothe IDLE state, <strong>and</strong> that INITiate[:IMMediate] takes longer to execute than *OPC, sendingthese comm<strong>and</strong>s to this device:INITiate;*OPCresults in initiating the trigger model <strong>and</strong>, after some time, setting the OPC bit in the SESR.However, sending these comm<strong>and</strong>s:INITiate;*OPC;*CLSstill initiates the trigger model. Since the operation is still pending when the device executes*CLS, the device does not set the OPC bit until it executes another *OPC comm<strong>and</strong>.4.1.3.3 *OPC <strong>and</strong> *WAIA device is in the Operation Complete Comm<strong>and</strong> Active State (OCAS) after it has executed*OPC. The device returns to the Operation Complete Comm<strong>and</strong> Idle State (OCIS) wheneverthe No Operation Pending flag is TRUE, at the same time setting the OPC bit of the SESRTRUE. See IEEE 488.2 Fig 12-4. The following events force the device into OCIS withoutsetting the No Operation Pending flag TRUE <strong>and</strong> without setting the OPC bit of the SESR:power onreceipt of the dcas message (device clear)execution of *CLSexecution of *RSTImplementation of the *OPC <strong>and</strong> *WAI comm<strong>and</strong>s is straightforward in devices whichimplement only sequential comm<strong>and</strong>s. When executing *OPC the device simply sets theOPC bit of SESR. Executing *WAI is a no-operation. The device is, in effect, always inOCIS.In devices which implement overlapped comm<strong>and</strong>s the implementation of *OPC <strong>and</strong> *WAIis a little more complicated. After executing *OPC the device must not set the OPC bit ofSESR until the device returns to OCIS, even though it continues to parse <strong>and</strong> executecomm<strong>and</strong>s. After executing *WAI the device must execute no further comm<strong>and</strong>s or queriesuntil the No Operation Pending flag is TRUE, or receipt of a dcas message, or a power on.4.1.3.4 *OPC?SCPI adds the requirement that *OPC? is implemented as a sequential comm<strong>and</strong>.A device is in the Operation Complete Query Active State (OQAS) after it has executed*OPC?. The device returns to the Operation Complete Query Idle State (OQIS) wheneverthe No Operation Pending flag is TRUE, at the same time placing a “1" in the Output Queue.See IEEE 488.2 Fig 12-6. The following events force the device into OQIS without settingthe No Operation Pending flag TRUE <strong>and</strong> without placing a ”1" in the Output Queue:power onreceipt of the dcas message (device clear)KI005 1KI005 23KI0054KI00556KI005KI005 78910KI00511KI00512 KI005KI00513KI005141516KI00517181920KI00521 KI00522 KI005232425KI00526KI005KI005SCPI Compliance Criteria 4-3


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>4.1.3.6 *IDN?KI005IEEE 488.2 is purposefully vague about the content of each of the four fields in the responsesyntax. SCPI adds no further requirement, but here are some suggestions:KI005All devices produced by a company should implement the *IDN? responseKI0051consistently.Field 1, the Manufacturer field, should be identical for all devices produced by a KI005 2single company.3Field 2, the Model field, should NOT contain the word “MODEL”.KI005Field 4, the Firmware level field, should contain information about all separately KI005 4revisable subsystems. This information can be contained in single or multiplerevision codes.564.2 SCPI RequirementsIEEE 488.2 describes the syntax of programming <strong>and</strong> device behavior to a certain level. 7Further refinement of the syntax <strong>and</strong> addition rules are imposed by SCPI in order to give 8instruments a common “look <strong>and</strong> feel”. The “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>” volume of this st<strong>and</strong>arddescribes the concepts behind SCPI <strong>and</strong> sets guidelines for originating new comm<strong>and</strong>s. A 9SCPI device shall follow these guidelines <strong>and</strong> style requirements.104.2.1 Required Comm<strong>and</strong>s11The following comm<strong>and</strong>s are required in all SCPI instruments:12Mnemonic Comm<strong>and</strong> Reference Section <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong> Section:SYSTem13:ERRor 21.814[:NEXT]? 21.8.3e (see Note 1) 1996:VERSion? 19.16 (see Note 2) 1991 15PH0:STATus 18 516:OPERation[:EVENt]?17:CONDition?:ENABle:ENABle?:QUEStionable[:EVENt]?:CONDition?:ENABle:ENABle?:PRESet18192021222324Note 1: The requirement changed from SYSTem:ERRor? to SYSTem:ERRor[:NEXT]? inversion 1995.1.Note 2: Requirement applies for all versions greater than 1990.02526SCPI Compliance Criteria 4-5


PH022HP076HP000,HP001HP0001997 SCPI <strong>Syntax</strong> & <strong>Style</strong>44.2.2 Optional Comm<strong>and</strong>sAll other comm<strong>and</strong>s in the “Comm<strong>and</strong> Reference” are considered optional, depending on thecapabilities of the instrument. That is, the control of any instrument capability that isdescribed in SCPI shall be implemented exactly as specified by using the appropriate SCPIdefined comm<strong>and</strong>s. For example, an instrument dedicated to voltage measurement wouldnot implement comm<strong>and</strong>s for sensing frequency. Certain comm<strong>and</strong>s, if implemented,require that other comm<strong>and</strong>s also be implemented.When a device does not support all alternative parameter values that are allowed for a SCPIcomm<strong>and</strong>, it may implement a subset of these values unless otherwise stated. For example,if an instrument implements only RECTangular <strong>and</strong> UNIForm data shaping for itsCALCulate:TRANSform:WINDow comm<strong>and</strong>, it may generate an error on receipt of anyother SCPI defined parameter value (FLATtop,HAMMing, etc). However, a device mustimplement all parameters of a multi-parameter SCPI comm<strong>and</strong>.Comm<strong>and</strong>s required to implement a SCPI-described capability may be omitted under specialconditions. The special condition exists when a comm<strong>and</strong> to be implemented affects a partof the instrument in which the configuration is fixed, <strong>and</strong> that the fixed configuration for thatcomm<strong>and</strong> corresponds to the value it would take on when an IEEE 488.2 *RST resetcomm<strong>and</strong> is issued. For example, an instrument with a display that is configured to bepermanently on does not need to implement the comm<strong>and</strong> that turns the display ON or OFF,since at *RST it is required by SCPI to be ON. If an instrument has a fixed configuration inwhich a setting does not correspond to the *RST value, then the instrument shall implementthe comm<strong>and</strong> for that setting even though it has only a single legal value.4.2.3 Documentation RequirementsThe documentation for a SCPI instrument shall list the version number for which theinstrument complies. This information shall appear on instrument specification sheets <strong>and</strong>related documents, as well as the programming manual.The manual for a SCPI instrument shall have a separate section titled “SCPI ConformanceInformation”. This section shall list separately:The SCPI version to which the instrument compliesThe syntax of all SCPI confirmed comm<strong>and</strong>s implemented by the instrument.Confirmed comm<strong>and</strong>s are those comm<strong>and</strong>s which are published in the latestversion of SCPI to which the instrument conforms. Comm<strong>and</strong>s in theDIAGnostic subsystem, <strong>and</strong> other comm<strong>and</strong>s which are not intended for end-useruse need not be documented in this section.The syntax of all SCPI approved comm<strong>and</strong>s implemented by the instrument.Approved comm<strong>and</strong>s are those comm<strong>and</strong>s which have been approved by theSCPI Consortium, but are not contained in the version of SCPI to which theinstrument conforms.The syntax of all comm<strong>and</strong>s implemented by the instrument, which are not part of4-6 SCPI Compliance Criteria


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>the SCPI definition.1234567891011121314151617181920212223242526SCPI Compliance Criteria 4-7


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>5 NotationExtensive use is made of syntax flow diagrams <strong>and</strong> tables throughout this document.Associated with these are notational styles, which are described in this chapter.5.1 Interpreting Comm<strong>and</strong> TablesComm<strong>and</strong> tables are used to define a set of SCPI comm<strong>and</strong>s. A table shows the comm<strong>and</strong>s,their hierarchical relationships, related parameters (if any), <strong>and</strong> associated notes. The table isbroken into 3 columns; the KEYWORD, the PARAMETER FORM, <strong>and</strong> any NOTES.The KEYWORD column provides the name of the comm<strong>and</strong>. The actual name of thecomm<strong>and</strong> consists of one or more keywords since SCPI comm<strong>and</strong>s are based on ahierarchical structure, also known as a tree system. In such a system, associated comm<strong>and</strong>sare grouped together under a common node in the hierarchy, analogous to the way leaves ata same level are connected at a common branch. This <strong>and</strong> similar branches are connected tofewer <strong>and</strong> thicker branches, until they meet at the root of the tree. The closer to the root, thehigher a node is considered in the hierarchy. To obtain a particular leaf or a particularcomm<strong>and</strong>, the full path to it must be specified. This path is represented in the tables byplacing the highest node in the hierarchy in the left-most position. Lower nodes in thehierarchy are indented one position to the right, below the parent node.Square brackets ([]) are used to enclose a keyword that is optional when programming thecomm<strong>and</strong>; that is, the instrument shall process the comm<strong>and</strong> to have the same effect whetherthe option node is omitted by the programmer or not. Such a node is called a default node.Letter case in tables is used to differentiate between the accepted short form (the uppercasecharacters) <strong>and</strong> the long form (the whole keyword). The significance of the short <strong>and</strong> longform keywords is explained in the “Program Headers” chapter.The PARAMETER FORM column indicates the number <strong>and</strong> order of parameters in acomm<strong>and</strong> <strong>and</strong> their legal values. A comm<strong>and</strong> may allow the use of a SCPI-definedparameter type, a literal, or a combination of the two. The SCPI-defined parameter types aredescribed in the “Parameters” chapter, <strong>and</strong> are distinguished by enclosing the type name inangle brackets (). A literal is typically a word that enumerates a setting that cannot bedescribed using the SCPI-defined parameter types.In the PARAMETER FORM column, a number of characters have special significance.Square brackets ([]) are used to enclose one or more parameters that are optional whencontrolling the instrument. Braces ({}), or curly brackets, are used to enclose one or moreparameters that may be included zero or more times. The vertical bar (|) can be read as “or”<strong>and</strong> is used to separate alternative parameter options.The query form of a comm<strong>and</strong> is generated by appending a question mark to the lastkeyword. However, not all comm<strong>and</strong>s have a query form, <strong>and</strong> some comm<strong>and</strong>s exist only inthe query form. The NOTES column is used to indicate this.As an example, suppose the existance of the following table.1234567891011121314151617181920212223242526Notation 5-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>KEYWORD PARAMETER FORM COMMENTS:FREQuency[:CW]:AUTO :CENTer :SPAN5To set the frequency value for a Continuous Wave signal, the following comm<strong>and</strong> would besent:FREQuency:CW 2000000Alternatively, since the CW node is optional the following comm<strong>and</strong> is also valid:FREQuency 2000000To set the value of AUTO, either of the following comm<strong>and</strong>s are allowed, again due to theoptional CW node:FREQuency:CW:AUTO OFFFREQuency:AUTO OFFThe query form of the AUTO comm<strong>and</strong> is either of the following:FREQuency:CW:AUTO?FREQuency:AUTO?In the “Comm<strong>and</strong> Descriptions,” the detailed descriptions of the individual comm<strong>and</strong>s areprovided immediately after the comm<strong>and</strong> table, in the order in which the comm<strong>and</strong>s appearin the table, reading from top to bottom.5.2 Interpreting <strong>Syntax</strong> Flow Diagrams<strong>Syntax</strong> flow diagrams are used extensively throughout the SCPI document <strong>and</strong> IEEE 488.2to provide pictorial representations of syntax. These representations are also known asrailroad diagrams.The flow through a diagram is given by lines <strong>and</strong> arrows. These link together the variousobjects used to form a comm<strong>and</strong>. Objects exist in the diagram as either a circle or a box.Circles indicate literal characters <strong>and</strong> the boxes represent a syntactic structure that is definedelsewhere in this document or in IEEE 488.2. Flow through the diagrams generally proceedsleft-to-right. Diagrams are entered on the left, <strong>and</strong> the syntax is satisfied when the diagramis exited on the right. When an element or group of elements in the diagram is repeatable, areverse, right-to-left path will be shown around <strong>and</strong> above the element(s), <strong>and</strong> is marked witha left-facing arrow. When an element or group of elements in the diagram are optional, aleft-to-right bypass path will be shown around <strong>and</strong> below the element(s). A branch in thepath indicates a choice of elements.Lowercase <strong>and</strong> uppercase letters are considered equivalent; however, no attempt has beenmade to specify both alternatives in every instance. Whitespace characters (as defined inIEEE 488.2, section 7.4.1.2) are optional in many places, <strong>and</strong> no attempt has been made tospecify “optional whitespace” everywhere it may exist.5-2 Notation


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>6 Program HeadersProgram headers are keywords that identify the comm<strong>and</strong>. The program headers follow thesyntax described in section 7.6 of IEEE 488.2. Instruments shall accept both upper <strong>and</strong>lowercase characters without distinguishing between the cases. Program headers consist oftwo distinct types, common comm<strong>and</strong> headers <strong>and</strong> instrument-control headers.6.1 Common Comm<strong>and</strong> <strong>and</strong> Query HeadersThe common comm<strong>and</strong> <strong>and</strong> query program header syntax is specified in IEEE 488.2 for usewith the IEEE 488.2-defined common comm<strong>and</strong>s <strong>and</strong> queries. Their syntax is:6.2 Instrument-Control HeadersInstrument-control headers are used for all other instrument comm<strong>and</strong>s, typically thoserelated to source <strong>and</strong> measurement control. The syntax for instrument-control headers is:The definition of the effect of the colons in an instrument-control header is covered later in“Traversal of the Header Tree.”6.2.1 Mnemonic Generation RulesEach instrument-control header or keyword has both a long <strong>and</strong> a short form. A SCPIinstrument shall accept only the exact short <strong>and</strong> the exact long forms. Sending a header thatis not the short form, nor the complete long form to a SCPI instrument shall cause it togenerate an error. IEEE 488.2 limits the length of a header to 12 characters, including anynumeric suffix that may appear. The long form header is either a single word or anabbreviation of a phrase. The short form header is an abbreviation of the long form header.In order to maintain a consistent set of mnemonics, SCPI defines the rules to generate amnemonic.The long form mnemonic is generated from either a single word or a phrase. If a single wordis used, then that word becomes the mnemonic. If a phrase is used, then the mnemonic is the1234567891011121314151617181920212223242526Program Headers 6-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>6first letter of each word <strong>and</strong> the entire last word. For example the phrase “relative velocity”would generate RVELOCITY as the long form comm<strong>and</strong> header.The short form mnemonic is usually the first four characters of the long form comm<strong>and</strong>header. The exception to this is when the long form consists of more than four characters <strong>and</strong>the fourth character is a vowel. In such cases, the vowel is dropped <strong>and</strong> the short formbecomes the first three characters of the long form. For example, the short form of FREE isFREE, however, the short form of SWEEP is SWE. Note that elsewhere in this document aspecial notation is employed to differentiate the short form keyword from the longform ofthe same keyword. The long form of the keyword is shown, with the short form portionshown in uppercase characters, <strong>and</strong> the rest of the keyword is shown in lowercase characters.Thus Relative VELocity keyword would be shown as RVELocity.The short form generation rules imply that phrases such as “Jump Start” <strong>and</strong> “Jump Stop”are not allowed. Although the long forms JSTART <strong>and</strong> JSTOP are unique, the short form isthe same in both cases, “JST.” This can be overcome by changing the phrases to “JumpBegin” <strong>and</strong> “Jump End”, thus creating unique long <strong>and</strong> short forms. Alternatively, themnemonic JUMP can become an additional level in the tree, allowing STARt <strong>and</strong> STOP tobecome their own mnemonics, giving JUMP:STARt <strong>and</strong> JUMP:STOP.The mnemonic generation rules allow keywords such as “TIME” <strong>and</strong> “TIMer” at the sametree level, since these are unique in both forms. This is not recommended since an unfamiliaruser may select the wrong function unintentionally. If the two functions have the samenumber <strong>and</strong> type of parameters, the instrument may not signal an error, further exacerbatingthe situation.All instrument comm<strong>and</strong> headers are allowed a numeric suffix to differentiate multipleinstances of the same structure, such as multi-channel instruments. The numeric suffix isapplied to both the long <strong>and</strong> short forms. For example, TRIG1 is the short form ofTRIGger1. A numeric suffix of 1 is implied on all instrument comm<strong>and</strong> headers that do notexplicitly define a suffix; thus, TRIG is equivalent to TRIG1.As a general rule, a mnemonic should contain no digits. Ending a short or long formmnemonic in a digit creates an ambiguity in separating the mnemonic from any addednumeric suffix.6.2.2 Building the Comm<strong>and</strong> TreeSCPI comm<strong>and</strong>s are based on a hierarchical structure. This allows the sameinstrument-control header (keyword) to be used several times for different purposes,providing that the mnemonic occurs in a unique position in the hierarchy. That is, themnemonic does not collide with any other mnemonics at the same level, or one leveldifferent where a default node exists.Using hierarchical comm<strong>and</strong>s should eliminate the need for most multiword mnemonics.The use of multiword mnemonics is discouraged <strong>and</strong> they should only be used when:A). The use of the hierarchical scheme would add several additional layers to the tree,<strong>and</strong>19966-2 Program Headers


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>B). No further growth at the level of those potentially intermediate nodes isanticipated.These style guidelines should act as a starting point for creating new comm<strong>and</strong>s.1. The lowest nodes should have the broadest base possible. For example, the centerfrequency comm<strong>and</strong> should be FREQuency:CENTer rather than CENTer:FREQuency. Sincecenter is an adjective to the noun frequency, the tree will build with fewer duplicate nodes ifFREQuency:CENTer is chosen.2. If a function is broad-based <strong>and</strong> thought of as a separate subsystem, make it a separatesubsystem even if it could properly be classified under another subsystem. For example,b<strong>and</strong>width is a separate subsystem, even though it could be classified under frequency.B<strong>and</strong>width is generally thought of as a separate subsystem <strong>and</strong> not classified with otherfrequency comm<strong>and</strong>s by customers.3. Keep the tree as shallow as possible, usually three levels or less. If the tree for a givenimplementation is considerably deeper than it is wide, something may be wrong with thecomm<strong>and</strong> structure.4. Some nodes may be made optional. When choosing to define a node as the default at aparticular level, be sure that it is the most common choice at that level. Also, check carefullyfor conflicting keywords, since all nodes below a default are effectively promoted by onelevel when the default node is assumed.5. Some root keywords are optional, depending on the instrument capabilities. In aninstrument which is primarily a source, the root mnemonic [SOURce] is optional. [SENSe]is optional for instruments which are primarily sensors, <strong>and</strong> [ROUTe] is optional forscanners. This is at the discretion of the device designer. For horizontal compatibilitypurposes, the instrument should accept this node if it is sent as part of a program message.6. A complete tree path shall be unique within SCPI. Thus, if a path is assigned a particularfunction in any instrument, it must perform the same function in all instruments whichimplement that path.7. SCPI also discourages the use of different keywords performing the same function. Thisproblem is more difficult because of industry-st<strong>and</strong>ard terminology. A good example issetting the output level on a source. Microwave sources call this power level, RF sources useamplitude level, <strong>and</strong> power supplies use voltage level, yet the function is the same in allthree. One of the tools available is to provide aliases for the function in order to provide bothsets of terminology. Whenever possible, SCPI shall implement as aliases those instanceswhere duplicate names are necessary. Where aliases are used, one term shall be definedwhich is the primary keyword. This keyword shall appear in all instruments.8. The tree structure shall follow the general form of the instrument model described in the“Comm<strong>and</strong> Reference.”9. Implementations shall use the language constructs described in the “Comm<strong>and</strong>Reference,” if a construct exists for the desired feature. If the feature does not exist, the1234567891011121314151617181920212223242526Program Headers 6-3


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>designer is responsible for following the life cycle described in an earlier chapter in order tointegrate the capability into SCPI.10. The value or syntax of a parameter shall not change the type or number of otherparameters in that comm<strong>and</strong>. If such a condition is encountered, additional nodes should beadded to the tree.For example, SCPI shall not include the structures such as::SYSTem:BEEPer 1,:BEEPer 2,6Rather, SCPI uses a structure such as::SYSTem:BEEPer:FREQuency :TIME 11. In general, parameters should only appear at the leaf nodes of the tree. In the undesirableexample below, the comm<strong>and</strong> to set a single frequency is placed at a different level to thecomm<strong>and</strong>s that are used for setting a range (span) of frequencies. Conceptually equivalentlevel comm<strong>and</strong>s are being placed at different levels, leading to possible misconceptions inuse. “Optional” nodes should be created as required to accomplish the same task. Forexample, suppose an instrument superficially wants the following set of comm<strong>and</strong>s:FREQuency :CENTer :SPAN The SCPI implementation shall overcome this by creating a node under frequency thatrepresents a comm<strong>and</strong> to set a single frequency, such as CW (Continuous Wave). Causing allthe comm<strong>and</strong> parameters to be associated with leaf nodes. To retain simple operation as inthe case of setting a single frequency, the CW node can be made optional, providing it doesnot create a keyword conflict. Thus our example becomes:FREQuency[:CW] :CENTer :SPAN Exceptions to this guideline are the AUTO <strong>and</strong> STEP constructs defined in this document.The AUTO <strong>and</strong> STEP comm<strong>and</strong>s are formed from the leaf node for the value. Otherexceptions may be defined. In these cases, the exception shall be noted in the comm<strong>and</strong>structure of the language document.Nodes should not be added to a comm<strong>and</strong> tree simply to make the tree have a uniform depth.If the only usable names for a terminal seem not to have any meaning (for instance, VALue),the addition may not be helpful <strong>and</strong> the tree should be implemented unbalanced. An example6-4 Program Headers


FL01997 SCPI <strong>Syntax</strong> & <strong>Style</strong>of this is the SOURce:FREQuency:SPAN node, which has the comm<strong>and</strong>s HOLD, LINK,<strong>and</strong> FULL beneath it.12. If a particular device function is not alterable or does not exist, then the associated SCPIcomm<strong>and</strong> need not be implemented unless the value of the function is different than thedefined *RST value for that function. If the *RST value is device-dependent, then thefunction need not be implemented. For example:A. A source that has no amplitude modulation does NOT have to implementAM:STATe OFF because AM:STATe OFF is specified at *RST.B. A device that only sweeps in frequency (<strong>and</strong> has no CW function) mustimplement FREQ:MODE SWEep because FREQ:MODE is specified as CW at*RST. However, it is permissable to allow only SWEep as a parameter toFREQ:MODE.C. A device that produces a single, nonalterable CW frequency of 100 MHZ neednot accept FREQ[:CW] 100 MHZ since the *RST value of FREQ:CW isdevice-dependent.The intent of this rule is to allow common features with varying complexities to be accessed.This rule specifies the minimum conditions of including a node. However, designers areencouraged to include additional degenerate nodes which are important to their market. Inexample A above, a designer may include AM:STATe OFF as a comm<strong>and</strong>, <strong>and</strong> isencouraged to do so if the instrument is being targeted into markets where AM modulation isa typical feature of instruments in this market.13. A new comm<strong>and</strong> may not be added if there is already a comm<strong>and</strong> to control the samefunctionality. This rule insures two instruments will not be needlessly incompatible whendesigners choose arbitrarily among multiple comm<strong>and</strong>s available to control a particularfunction. (Notice that SCPI assures compatibility when aliased comm<strong>and</strong>s are implementedby making one path required). A new comm<strong>and</strong> may not be added to the st<strong>and</strong>ard unless itcan be shown to control functions not controlled by any existing comm<strong>and</strong>s. The followingguidelines may help in determining whether a comm<strong>and</strong> controls new functionality orrepresents illegal duplication, <strong>and</strong> guide selection of one comm<strong>and</strong> over another.Does the setting of the new comm<strong>and</strong> affect the measurement result returned?Signal preconditioning comm<strong>and</strong>s (like ATTenuator, FILTer, GAIN) appear in the INPutsubsystem <strong>and</strong> in SENSe. These comm<strong>and</strong>s are not aliases; The setting ofINPut:ATTenuator changes the reported signal level, while SENSe:ATTenuator would becompensated for so the reported signal level would not be affected. Since these comm<strong>and</strong>saffect the returned value differently, they control different functions <strong>and</strong> are not duplicatecontrols.Does the new comm<strong>and</strong> control a function with a different purpose than any existingcomm<strong>and</strong>?Numerical post-processing comm<strong>and</strong>s (like WINDow, AVERage, SMOothing) appear in thesensor <strong>and</strong> also in CALC. The function properly belongs in the sensor when its purpose is toProgram Headers 6-51234567891011121314151617181920212223242526


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>6enhance accuracy or correct for artifacts introduced by the sensor. The function belongs inCALCulate when its purpose is to change the presentation of the data or provide analyticaltools not directly related to measurement.Does the comm<strong>and</strong> control measurement hardware?Some functions (like SMOothing) may be performed directly on the signal in hardware or insoftware after A/D conversion. While this rule can be difficult to apply, the fact that acomm<strong>and</strong> controls measurement hardware often indicates that it belongs in the sensor ratherthan CALCulate.Does it make sense if the same operation may be done twice?Another way to tell that a comm<strong>and</strong> controls new functionality is if it makes sense for thecontrolled function to appear twice in a single instrument. The AVERage subsystem is agood example; it is not unreasonable to build an instrument that averages several readings toimprove the accuracy of the measurement, <strong>and</strong> also provides averaging as a statisticalfunction in the CALCulate subsystem.14. In general, SCPI comm<strong>and</strong>s which are only events without a query form do not have anyparameters. Including a parameter might mislead a user into believing the value could bequeried as most comm<strong>and</strong>s in SCPI have a query form, see 6.2.3.An exception to this guideline is when the action is performed on a named object within theinstrument <strong>and</strong> these objects cannot be enumerated. For example, ,, <strong>and</strong> are objects whose values cannot be entirely listed withinSCPI. The user can create any number of or . The signalrouting concepts in SCPI allow a large number of possible .6.2.3 QueriesAll comm<strong>and</strong>s, unless otherwise noted, have an additional query form. As defined in IEEE488.2, a query is a comm<strong>and</strong> header with a question mark symbol appended (for example,FREQ:CENT?). When a query form of a comm<strong>and</strong> is received, the current setting associatedwith the comm<strong>and</strong> is placed in the output buffer. Query responses do not include thecomm<strong>and</strong> header. Execution of a query form has no side effects. It shall not cause anysettings or couplings within the instrument to change. An exception is in MEASurementsubsystem, where instrument settings may change as a result of the measurement.Both the comm<strong>and</strong> <strong>and</strong> query forms shall be implemented unless a comment or noteindicating otherwise appears in the keyword summary. Even when a comm<strong>and</strong> accepts onlya single selection, both the comm<strong>and</strong> <strong>and</strong> query forms shall still be implemented. A note ofthe form “[event; no query]” or “[no query]” indicates that only the comm<strong>and</strong> form <strong>and</strong> notthe query form shall be implemented. A note of the form “[query only]” indicates that onlythe query form <strong>and</strong> not the comm<strong>and</strong> form shall be implemented.When character data is used for a parameter, both longform <strong>and</strong> shortform values shall berecognized. If the comm<strong>and</strong> has a query form with character response data, the shortformvalue is always returned.HP082HP082HP0956-6 Program Headers


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>When numeric parameters are queried, the result shall be returned in fundamental unitsunless otherwise specified or requested. When several different units may be consideredfundamental (for example, dBuV or dBm), the units of the returned result shall bedocumented in the query response description for the comm<strong>and</strong>. A query may have a related:UNITs node to change the default units of the accepted or returned value, where this existsthe coupling shall be clearly indicated in the comm<strong>and</strong> description.6.2.4 Traversal of the Header TreeIEEE 488.2 allows the designer some discretion on how compound headers are h<strong>and</strong>ledwithin the rules of section 7.6.1.5. SCPI imposes additional requirements regarding how acompound comm<strong>and</strong> is parsed.Multiple elements may be sent in a . The first comm<strong>and</strong> is always referenced to the root node. Subsequentcomm<strong>and</strong>s, however, are referenced to the same tree level as the previous comm<strong>and</strong> in amessage unit. SCPI parsers shall follow the example presented in IEEE 488.2, section A.1.1.A SCPI parser shall NOT implement the enhanced tree walking implementation described insection A.1.2.For example, if a hypothetical instrument had the comm<strong>and</strong> tree:FREQuency:STARt :STOP :SLEW :AUTO | ONCE:BANDwidth POWer:STARt :STOP BAND A|B|C|DThen the following comm<strong>and</strong>s shall behave as described:FREQ:STAR 3 MHZ;STOP 5 MHZ shall set the start frequency to 3 MHz<strong>and</strong> the stop frequency to 5 MHz.FREQ:STAR 3 MHZ;:FREQ:STOP 5 MHZ shall set the start frequency to 3MHz <strong>and</strong> the stop frequency to 5 MHz.FREQ:STAR 3 MHZ;POW:STOP 5 DBM may set the start frequency to 3MHz <strong>and</strong> shall generate an error because POW is not a node at the current parserlevel.FREQ:STAR 3 MHZ;SLEW:AUTO ON shall set the start frequency to 3MHZ <strong>and</strong> couple the frequency slew rate.FREQ:SLEW:AUTO ON;STOP 5 MHZ may couple the slew rate <strong>and</strong> shallgenerate a comm<strong>and</strong> error since the coupling comm<strong>and</strong> is not at the same level asthe stop comm<strong>and</strong>.1234567891011121314151617181920212223242526Program Headers 6-7


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>6FREQ:SLEW 3 MHZ/S;AUTO ON may set the frequency slew rate to 3MHZ/S <strong>and</strong> shall generate a comm<strong>and</strong> error because :AUTO is not at the samelevel.FREQ:START 3 MHZ;BAND 1 MHZ shall set the start frequency to 3 MHz<strong>and</strong> the b<strong>and</strong>width to 1 MHz.FREQ:START 3 MHz;:BAND A shall set the start frequency to 3 MHz <strong>and</strong>select b<strong>and</strong> A.FREQ:SLEW:AUTO ON;3 MHZ/S may couple the frequency slew rate <strong>and</strong>shall generate a syntax error, because IEEE 488.2 specifies that headers must besent with each comm<strong>and</strong>.Default nodes in the tree shall not alter the header path of the parser in order to follow theIEEE 488.2 rules for compound headers. IEEE 488.2, section 7.6.1.5 makes no mention ofdefault nodes, so adding something to the header path is not allowed. For example, if ahypothetical instrument had the comm<strong>and</strong> tree:DISPlay[:STATe] :DATA Then the following situations would have these results:DISP:STAT ON;DATA “Hello, world!” shall turn the display on <strong>and</strong> display“Hello, world!”.DISP ON;DATA “Hello, world!” may turn the display on <strong>and</strong> shall flag anerror (assuming that DATA is not a root mnemonic).6.2.5 Multiple Capabilities <strong>and</strong> Numeric Keyword SuffixesMany instruments provide multiple capabilities, by duplicating internal functional blocks.One example is an instrument that can display more than one measurement at a time.Another example is an instrument that can make a particular measurement on one of severalinput channels. SCPI provides a mechanism to address this duplicate functionality whileretaining the same hierarchy for each duplication.6.2.5.1 Single Instrument with Many Electrical PortsWhen only electrical ports (front panel terminals) are involved, the notationis sufficient to describe the measurement connection. An instrument which needs to selectone or more of several input terminals can be logically modeled as a simple instrument withone set of inputs connected to a scanner (signal multiplexor).6.2.5.2 Multiple Identical CapabilitiesWhen an instrument has several independent measurement channels (or other capabilities,such as displays or sources), the selection of which to use is designated by a numeric suffixattached to a program mnemonic. If the suffix is absent, the comm<strong>and</strong> is treated as beingdesignated for capability number one. In this way, channel one of a multiple channelinstrument can accept the same comm<strong>and</strong>s as a single channel instrument to allow for6-8 Program Headers


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>upward compatibility. Further, adding multiple channels or capabilities to an instrumentclass where multiple channels were not anticipated becomes possible.The node that contains the numeric suffix is the one where the multiple capability occurs.This may be at any level of the tree: root, intermediate or terminal node. As an example,OUTP5:MOD3:FM2 would specify the second FM signal component of the thirdmodulation signal on the fifth output channel.Devices which implement multiple channels/capabilities shall recognize nodes which do nothave numeric suffixes <strong>and</strong> treat them as channel/capability 1. Instruments with a singlechannel/capability are not required to accept a numeric suffix. This allows for upwardcompatibility.6.2.5.3 Logical InstrumentsA complex instrument such as a VXI card cage can be logically modeled as separateinstruments, each with its own (secondary) bus address. For example, common functions forall instruments can be located at secondary address 00, <strong>and</strong> otherwise each instrumentresponds individually to IEEE 488.2 comm<strong>and</strong>s. This requires that each logical instrument(card) implement its own status model <strong>and</strong> I/O buffers.1234567891011121314151617181920212223242526Program Headers 6-9


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>66-10 Program Headers


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>7 ParametersSCPI uses the parameter forms described in IEEE 488.2, section 7.7, with some additionalrestrictions. Also note that SCPI specifies the values for all comm<strong>and</strong>s upon receipt of*RST. In some cases, these reset values are device-dependent, but all measurementparameters must be set to some deterministic value for that particular instrument, which inturn must be documented in the instrument manual.7.1 Character Program DataWhere possible, the same truncation rules are used for parameters as for headers. However,in many cases industry st<strong>and</strong>ards take precedence. For example, IDC is a better choice forDC current than anything SCPI rules would define, simply because it is an existing st<strong>and</strong>ardwith wide acceptance. In addition, several character program data forms are predefined asextensions of .7.2 Decimal Numeric Program DataNumeric elements shall be used only for representing numeric quantities. They shall not beused for selecting functions on a “One of N” position switch.Implementations shall accept numeric data as described in IEEE 488.2, section 7.7.2.4.However, any number which exceeds +-9.9 E 37 shall generate an execution error (-222,“Data out of range”). Numbers shall be rounded to the closest “correct” value that theinstrument accepts without error. This document does not define the value a parameter is setto if an out-of-range value is received.7.2.1 DefinitionThe decimal numeric element is abbreviated as throughout this document.This is different from the described in section 7.7.2.1 of IEEE 488.2 in several ways.Several forms of are defined as special forms ofnumbers. These are: MINimum, MAXimum, DEFault, UP, DOWN, Not A Number (NAN),INFinity, <strong>and</strong> Negative INFinity (NINF). Individual comm<strong>and</strong>s are required to accept MIN<strong>and</strong> MAX. DEFault, UP, DOWN, NAN, INFinity, <strong>and</strong> NINFinity may be implemented at thediscretion of the designer, in which case it shall be noted in the instrument documentation.Where an optional form is accepted, it will be noted in the comm<strong>and</strong> description.A (IEEE 488.2, section 7.7.4), a , or a is part of if an instrument implements these features.7.2.1.1 DEFaultThe special parameter DEFault may be provided to allow the instrument toselect a value for a parameter. When DEFault is sent, the instrument shall select a valuewhich is deemed to be convenient to the customer. The setting may be device-dependent, orit may be defined as part of this st<strong>and</strong>ard. The use of DEFault is optional on acomm<strong>and</strong>-by-comm<strong>and</strong> basis. Individual comm<strong>and</strong>s shall document where DEFault isrequired.For example, to use the SYST:TIME comm<strong>and</strong> to set a device’s clock ahead one hour(Daylight Savings Time), a program might send SYST:TIME UP,DEF,DEF.1234567891011121314151617181920212223242526Parameters 7-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>7Another example is found in the MEASure comm<strong>and</strong>s. The syntax of the comm<strong>and</strong> whichmeasures DC voltage is:MEASure:VOLTage:DC [[,]]The MEASure comm<strong>and</strong> specifies that parameters are defaulted from the right <strong>and</strong> that anyparameter may be defaulted by using DEFault in place of the parameter. The followingcomm<strong>and</strong> would measure DC voltage, defaulting the range to an instrument dependent value(possibly autorange), but specifying the resolution at 0.001 Volt:MEASure:VOLTage:DC DEFault,0.001V7.2.1.2 MINimum|MAXimumThe special form numeric parameters MINimum <strong>and</strong> MAXimum shall be provided whichassume the limit values for the parameter. The maximum <strong>and</strong> minimum shall be queryableby sending ? MAXimum|MINimum. The MAXimum value refers to the largestvalue that the function can currently be set to, <strong>and</strong> MINimum refers to the value closest tonegative infinity that the function can be currently set to.Some comm<strong>and</strong>s have multiple parameters. The query form of these comm<strong>and</strong>s returns a listof values representing the current value of each of the parameters, in the order of theirnormal occurrence in a program message. If a MINimum/MAXimum query of multipleparameters is allowed, the keywords MINimum <strong>and</strong> MAXimum must occur as many times inthe query as there are parameters. MINimum requests that the instrument return the legalvalue which is closest to negative infinity for the parameter; MAXimum requests the legalvalue which is closest to positive infinity.For example, suppose an instrument implements the SYST:TIME comm<strong>and</strong>, which requiresthree parameters, <strong>and</strong> allows MIN/MAX queries on this comm<strong>and</strong>. The following queriesshall have these results:SYST:TIME? shall return the current setting of the time-of-day clock in theinstrument.SYST:TIME? MAX,MAX,MAX could return 23,59,59.SYST:TIME? MAX shall set an error (-109, “Missing parameter”), sincethree parameters are required <strong>and</strong> only one was sent.7.2.1.3 UP/DOWNAn instrument may optionally allow the use of steps for some or all of its numeric entry. Ifsteps are used, the keywords UP <strong>and</strong> DOWN shall be used as numeric parameters whichperform stepping. Steps may be adjustable through the step node for each individualparameter.The instrument may step a parameter when UP or DOWN is received in lieu of a numericvalue. This capability is optional. However, if the capability is implemented, the deviceshall include a node for each comm<strong>and</strong> which accepts step parameters. This node willspecify the step. The step may either be a fixed linear size or a logarithmic numberrepresenting number of decades/step.7-2 Parameters


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>7.2.1.3.1 STEP Subsystem Comm<strong>and</strong> <strong>Syntax</strong>The form of the step subsystem is as follows::STEP[:INCRement] :PDECade :MODELINear|LOGarithmic|L125|L13:AUTO|ONCE7.2.1.3.2 [:INCRement] This comm<strong>and</strong> controls the step size in absolute units when STEP:MODE LINear is selected.At *RST, this value is device-dependent.7.2.1.3.3 :PDECade This comm<strong>and</strong> controls the number of steps per decade when STEP:MODE LOGarithmic isselected.At *RST, this value is device-dependent.7.2.1.3.4 :MODE LINear|LOGarithmic|L125|L13This comm<strong>and</strong> controls the linearity of steps. The various parameters have the followingmeanings:LINear: Steps are a fixed value added to or subtracted from the current value ofthe parameter.LOGarithmic: Steps are placed at points spaced logarithmically. If the currentvalue of the function is x, the value of the function after executing an up shall bedetermined by the following formula:10⎡⎣log10(x)∗STEP:PDECade⎣+ 1⎤⎢⎣ STEP:PDECade⎥⎦<strong>and</strong> the value of the function after executing a DOWN shall be determined by:10⎡⎡log10(x)∗STEP:PDECade⎡− 1⎤⎢⎥⎣ STEP:PDECade ⎦where ⎣ is the symbol for floor, <strong>and</strong> ⎡ is the symbol for ceiling.L125 — Steps are determined by the sequence... 0.1,0.2,0.5,1,2,5,10,20,50,100 ...Executing UP will set the value of the function to the next higher value in the sequence.Executing DOWN will set the value of the function to the next lower value in the sequence.1234567891011121314151617181920212223242526DTParameters 7-3


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>7L13 — Steps are determined by the sequence... 0.1,0.3,1,3,10,30,100 ...Executing UP will set the value of the function to the next higher value in the sequence.Executing DOWN will set the value of the function to the next lower value in the sequence.At *RST, this value is device-dependent.7.2.1.3.5 :AUTO |ONCEThe step mode <strong>and</strong> increment is coupled to other instrument settings <strong>and</strong> physical inputswhen AUTO is ON.7.2.1.3.6 STEP Subsystem ExamplesFREQ:CENT:STEP 5 MHZFREQ:CENT UPsets the center frequency step to 5 MHz, <strong>and</strong> then increments the current value by 5 MHz.BAND:RES 1MHZBAND:RES:STEP:MODE LOG;PDEC 3BAND:RES UPThe above sequence would specify a logarithmic step, set three steps/decade, <strong>and</strong> thenincrement the resolution b<strong>and</strong>width by 1/3 decade (logarithmic) to a final value of 2.154MHz.BAND:RES 1MHZBAND:RES:STEP:MODE L125BAND:RES UPThe above sequence would specify a 125 logarithmic sequence, <strong>and</strong> then increment theresolution b<strong>and</strong>width to the next step in the sequence to a final value of 2.0 MHz.7.2.1.4 INFinity <strong>and</strong> Negative INFinity (NINF)A special case is made for infinity. Positive infinity is represented as 9.9 E 37. Negativeinfinity is -9.9 E 37. Instruments shall accept numbers within this range as valid numericdata. They shall also limit response data to this range. If a valid instrument setting is infinityor negative infinity, the values 9.9 E 37 <strong>and</strong> -9.9 E 37 shall be accepted <strong>and</strong> returned torepresent positive <strong>and</strong> negative infinity respectively, <strong>and</strong> on input, the implementation shallaccept INFinity as an alias for positive infinity, <strong>and</strong> NINFinity as an alias for negativeinfinity.The numeric values for positive <strong>and</strong> negative infinity were chosen so that they fit into a32-bit IEEE 754 floating point number. This allows easy implementation using st<strong>and</strong>ardtools in all popular languages <strong>and</strong> operating systems. Note that this does not limit thenumeric resolution. These values are larger than any quantities used or anticipated ininstruments.7.2.1.5 Not A Number (NAN)Not a number is represented as 9.91 E 37. Not a number is defined in IEEE 754. Typicalapplications are dividing zero by zero or subtracting infinity from infinity. Not a number is7-4 Parameters


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>also used to represent missing data. A typical application is when a portion of a trace has notbeen acquired yet. On input, devices shall accept NAN as an alias for not a number.The numeric value for NAN was chosen so that it can be represented as a 32-bit IEEE 754floating point number. This allows easy implementation using st<strong>and</strong>ard tools in all popularlanguages <strong>and</strong> operating systems. Note that this does not limit the numeric resolution. Thisvalue is larger than any quantities used or anticipated in instruments.7.2.2 Unit SuffixesThe may be followed by an optional suffix.All parameters which have associated units shall accept a suffix. Only suffixes appropriatefor the comm<strong>and</strong> should be accepted. All suffixes must include the associated unit. SeeIEEE 488.2, 7.7.3, , for a complete discussion of this topic.Suffixes must accept multipliers except in cases where the multiplier is illogical, such asdBm or PCT. Table 7-2 in IEEE 488.2 lists the allowed multipliers. If any of the multipliersare allowed with a suffix, then all the multipliers shall be interpreted properly. Compoundsuffixes are allowed.If a suffix is included, the suffix <strong>and</strong> associated multiplier, if implemented, are applied to theparameter. If the suffix is omitted, default units are used. The default unit is determinedeither from the :UNIT subsystem as described in 7.5 of <strong>Syntax</strong> & <strong>Style</strong> <strong>and</strong> in Chapter 23 ofthe Comm<strong>and</strong> Reference, or it is the fundamental unit associated with the parameter.Fundamental units are either described in the appropriate subsystem or in the one shown inIEEE 488.2, table 7-1.7.3 Boolean Program DataThe form is used throughout this document as a shorth<strong>and</strong> for the formON|OFF|. Boolean parameters have a value of 0 or 1 <strong>and</strong> are unitless.On input, an is rounded to an integer. A nonzero result is interpreted as 1. Thisalgorithm is the same as the one described in IEEE 488.2, section 10.25.3.The elements ON <strong>and</strong> OFF shall be accepted on inputfor increased readability. ON corresponds to 1 <strong>and</strong> OFF corresponds to 0.Queries shall return 1 or 0, never ON or OFF.7.4 Coupling of FunctionsThere are two forms of coupling: functional <strong>and</strong> value. A coupling occurs when sending acomm<strong>and</strong> changes the value associated with another comm<strong>and</strong>. In general, functionalcouplings are discouraged except in the MEASure subsystem. Value couplings are allowedif the coupling equations are well specified.Some functions may have the ability to be decoupled. If functions can be decoupled, theability to recouple them shall also exist. If a function cannot be decoupled, then a node to setits value shall not exist, or shall be implemented as query-only. If a node is settable undersome conditions, then the node may exist.1234567891011121314151617181920212223242526Parameters 7-5


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>7Another level in the tree is used to control coupling. The keyword AUTO shall be used tocontrol coupling. For example, the comm<strong>and</strong> to couple resolution b<strong>and</strong>width would be:BAND:RES:AUTO ONSetting a value explicitly for a function shall cause the function to be decoupled (:AUTOOFF), if decoupling is possible. Otherwise an error shall be generated.Selecting :AUTO ONCE shall cause the function to select the most appropriate value forcurrent conditions (range, signal level, etc), <strong>and</strong> then be decoupled. A subsequent query ofan :AUTO? will always return 0, since ONCE is an event which leaves the function inAUTO OFF mode.7.4.1 Functional CouplingFunctional coupling occurs when a comm<strong>and</strong> causes side effects in the basic operatingmode of the device. An example is a comm<strong>and</strong> which sets the start frequency <strong>and</strong> also startsa sweep.If a comm<strong>and</strong> which invokes a functional coupling is necessary, the instrument shall alsoimplement primitive comm<strong>and</strong>s which do not have functional couplings. The instrumentmay then implement a complex comm<strong>and</strong> which is described as a combination of theseprimitive comm<strong>and</strong>s. This complex comm<strong>and</strong> may contain functional couplings, <strong>and</strong> mustdocument the sequence of primitive comm<strong>and</strong>s used in its programming documentation.For example, if a source needs a comm<strong>and</strong> which sets the AM modulation level, <strong>and</strong> whichhas the side effect of turning the modulation ON, the following could be implemented:Primitives:AM:STATE[:DEPTh] Complex comm<strong>and</strong> added:AM:SDEPth Where AM:SDEPth is defined in the manual as:AM:DEPth;:STATeON7.4.2 Value CouplingThe other form of coupling is called value coupling, which is allowed in SCPI. Values arecoupled when a comm<strong>and</strong> changes the value of other numeric settings in the instrument. Thecoupling relation would follow device-dependent equations. For example, b<strong>and</strong>width in areceiver may be coupled to the frequency span. The individual comm<strong>and</strong> descriptions definethese coupling equations.7-6 Parameters


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>Groups of functions may be coupled in complex ways which affect the values for each other.For example START, STOP, CENTER, <strong>and</strong> SPAN are all value-coupled. CENTER is thearithmetic average of START <strong>and</strong> STOP. SPAN is the difference between START <strong>and</strong>STOP. Changing any one affects the value of two others.7.4.3 Automatic CouplingA special type of coupling is the automatic coupling. This is when the device provides analgorithm to select the value of a parameter. This algorithm could be based upon physicalinputs or other settings. When it is desirable to turn this algorithm on <strong>and</strong> off, the keywordAUTO is added. The AUTO comm<strong>and</strong> may accept parameters of ON|OFF|ONCE. ONenables the instrument algorithm. OFF disables the instrument algorithm. ONCE causes thealgorithm to be employed once, changing the associated parameter, <strong>and</strong> then reverting toAUTO OFF.7.5 Units of Measure <strong>and</strong> SuffixesMost of the information on units <strong>and</strong> suffixes is specified in IEEE 488.2, section 7.7.3.However, further clarification is needed for units of power <strong>and</strong> amplitude, <strong>and</strong> for unitlessquantities.7.5.1 Units of Amplitude <strong>and</strong> PowerThe fundamental unit of linear power is the Watt (W).The fundamental unit of linear amplitude is the Volt (V).The fundamental unit of logarithmic power is the dBm.The fundamental unit of logarithmic amplitude is the dBV.Industry practices have caused other units to become widely used in various disciplines,particularly the units of uV, dBuV, dBuW <strong>and</strong> dBmV. Furthermore, many instruments covera broad spectrum of applications where different units are considered the st<strong>and</strong>ard.Therefore, instruments which implement comm<strong>and</strong>s whose parameters might be expressed inseveral different amplitude or power units shall provide the following means of setting <strong>and</strong>measuring amplitude <strong>and</strong> power functions:If the unit is not specified, the default unit shall be that specified with a comm<strong>and</strong> in theUNIT subsystem, or a UNIT comm<strong>and</strong> in the appropriate sub-tree. The *RST values ofsettings in the UNIT subsystem shall be device-dependent. However, if a *RST unit isdifferent than the specified default unit, or is a logarithmic unit, then the comm<strong>and</strong> in theUNIT subsystem for that unit must be implemented.If a suffix is sent with an , the unit corresponding to that suffix shall override thedefault unit for that parameter.If an instrument accepts units from one of the classifications described above, it must acceptall suffixes of that classification. For example, if an instrument accepts Watts, it must alsoaccept uW, mW, etc. This includes all suffix multipliers described for that unit in IEEE488.2. However, it may, but is not required, to accept Volts as a unit. In instrument whichaccepts both requires a defined impedance for the conversion1234567891011121314151617181920212223242526Parameters 7-7


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>(Power= Voltage2Impedance )7either explicitly through an input or output impedance comm<strong>and</strong> or implicitly if theimpedance of the instrument is known <strong>and</strong> fixed. A further restriction, is that if aninstrument accepts logarithmic units, it shall also accept the comparable linear unit. Forexample, an instrument which accepts dBms must also accept Watts, MW, UW, etc. Forexample:POW:UNIT DBUVPOW:LEV 50shall set the amplitude level to 50 dBuV.POW:UNIT DBMPOW:LEV 5Vwould set the power level to 5 Volts.Since some instruments are used in applications where both power <strong>and</strong> voltage units areappropriate, the system’s impedance may be important to the user. This impedance isneeded to do the conversion between power <strong>and</strong> voltage (<strong>and</strong> maybe even current). Allinstruments are encouraged to provide a node for at least querying this impedance. The nodeshall be called :IMPedance, <strong>and</strong> will generally appear under the INPut or OUTPutsubsystem. Open circuits shall be expressed by setting IMPedance INFinity. It is thereforepossible to express output power in Volts:POW:UNIT VOUTP:IMP 50 OHMPOW:LEV 5would set the power level to 5 Volts into a 50 Ohm load, or 0.5 Watt.It is also sometimes necessary to determine which amplitude measurement is being made.Therefore, a measurement qualification may be appended to the suffix. The suffixappendices are described as:PK: Peak amplitudePP: Peak-to-peak amplitudeRMS: RMS amplitudeIf no suffix appendix is specified, the default is device-dependent. However, all instrumentsshall accept the suffix appendix for all types they support.For example, a voltmeter which measures RMS voltage shall accept the suffixes V <strong>and</strong>VRMS. A function generator which outputs peak voltage would accept the suffixes V <strong>and</strong>VPK. An RF signal source might accept dBUV, dBUVRMS <strong>and</strong> dBUVPK.7-8 Parameters


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>7.5.2 Expressing Unitless QuantitiesThe ratio of two linear quantities shall default to a unitless ratio (A/B). For example, if theinput power for a system is 5 Watts, <strong>and</strong> the output power is 20 Watts, the power gain =20W/5W = 4.The difference between two logarithmic quantities shall be expressed in dB. For example ifthe input power of a system is 3 dBm <strong>and</strong> the output power is 5 dBm then the gain of thesystem is 5 dBm-3 dBm=2 dB.Under exceptional conditions other units may be used for the ratio of two quantities. A validexception would be if a st<strong>and</strong>ards-setting organization (Bell, CCITT, military, IEEE, IEC,etc.) specifies that a measurement shall be made using a special unit like PCT (percent).1234567891011121314151617181920212223242526Parameters 7-9


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>77-10 Parameters


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>8 Expressions8.1 FunctionThe described in IEEE 488.2 is more tightly definedin this section. SCPI defines five types of expressions, numeric expressions, channel lists,numeric lists, Data Interchange Format (dif) expressions, <strong>and</strong> instrument specifierexpressions. The dif expressions are defined in <strong>Volume</strong> 3, “Data Interchange Format.”Instrument specifiers are defined in <strong>Volume</strong> 4, “Instrument Class Applications.”Other expression types may be added in future releases of this document, including but notlimited to logical expressions, trigger expressions, <strong>and</strong> sequence expressions. Other uses ofIEEE 488.2 expressions are legal, <strong>and</strong> may be documented in the individual comm<strong>and</strong>descriptions.8.2 UsageThe use of expressions is optional in SCPI. For expression types defined in this section, it ispermissible to use any subset. Only expression types which are required by a particularcomm<strong>and</strong> may be recognized as parameters of that comm<strong>and</strong>.8.3 <strong>Syntax</strong>Inside expressions, white space as defined in IEEE 488.2, section 7.4.1.2 is allowed betweenany lexical elements. For expressions defined in this section, a lexical element is defined asany operator, punctuation, or IEEE 488.2 syntactic element. For a , spacesmay appear around block names, block modifiers, keywords, or value types. See DataInterchange Format, Section 3.2. Note that explicit white space may be required to separatelexical elements. No semantic meaning should be attached to the case of alpha charactersTWV41C DIF0112345678DIF019101112131415161718192021DIF012223242526Expressions 8-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>used in operators. For example, the following are instances of the same operator:AND<strong>and</strong>And8.3.1 Numeric ExpressionA numeric expression is a collection of terms which evaluates to a trace, number, array, orother data element.88.3.1.1 <strong>Syntax</strong> TEK002Where is defined as:8-2 Expressions


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>Where is defined as:Unary operators should not be used with signed numbers.Where or is defined as the diagram shows:8.3.1.2 Precedence RulesExpressions shall be evaluated according to the following precedence rules:1. Enclosed by parentheses2. Unary operators (+ <strong>and</strong> -)3. ^(exponentiation)4. * (multiplication), / (division), MOD <strong>and</strong> DIV5. + (addition) <strong>and</strong> - (subtraction)6. NOT7. AND8. OR <strong>and</strong> EXOR9. Left to right8.3.1.3 SemanticsAs stated in the syntax diagram, expressions may contain terms which are numbers, traces,variables, or expressions.Elements in a numeric expression are promoted to the size <strong>and</strong> type of the most complexelement, <strong>and</strong> the result of the expression is of that type. That is, an expression containing a will be evaluated according to the rules for arithmetic on traces, <strong>and</strong> the resultwill be a trace. If an expression contains both a <strong>and</strong> scalar data, a trace iscreated with all elements set to the value of the scalar data before arithmetic is performed.For example, if TREF is a trace_name, the expression (TREF-3) results in a trace the samesize as TREF, with each data element lower by three.8.3.2 Channel ListsChannel lists are used to specify electrical ports on an instrument. They are typically used forsignal routing either in a st<strong>and</strong>alone switch box or in an instrument with multiple inputchannels. An instrument with multiple channels may or may not do any signal switching as1234567891011121314151617181920212223242526Expressions 8-3


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>the result of a channel list. Completely separate sensing channels are allowed, but mayappear to the language the same as channels which are switched.A channel list may appear in measurement, configuration, <strong>and</strong> other such comm<strong>and</strong>s. Forexample, MEAS:VOLT? (@1,3,4:6) says measure the voltage on channels 1, 3, <strong>and</strong> 4through 6. Whether the measurements are performed simultaneously or in the order in thelist is unspecified. Channel lists are also used by the ROUTe subsystem, “Comm<strong>and</strong>Reference,” 15.1.The syntax for a is:KI0048Where is defined as:Where both instances of must contain the same number of dimensions.Where is defined as:8-4 Expressions


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>Where indicates all the channels from the first number through the secondnumber <strong>and</strong> where is defined as:Where is defined as:The number of dimensions in a is one greater than the number ofoccurrances of the ‘!’ character in the When a of dimension greater than one is scanned, the right-most index ofthe varies most rapidly.The multidimensional channel range is to be considered as a list of single dimension channelranges. For example, (@1!1:2!3) means dimension 1 (row) ranges from 1 to 2 <strong>and</strong> dimension2 (column) ranges from 1 to 3. If the size of the matrix in this example is 2X8, then the range(@1!1:2!3) does not mean: row 1, column 1 through 8 <strong>and</strong> subsequently row 2, column 1through 3, but row 1, column 1 through 3 <strong>and</strong> next row 2 column 1 through 3. This methodprovides a functional compatibility between comm<strong>and</strong>s sent to matrix switches withdifferent row lengths.Channel lists are order sensitive. For example:SCAN (@5:3) means close 5, 4, 3 in order.SCAN (@1!1:2!3) means close 1!1, 1!2, 1!3, 2!1, 2!2, 2!3 in order.SCAN (@1!3:2!1) means close 1!3, 1!2, 1!1, 2!3, 2!2, 2!1 in order.123456789101112131415161718PH020,DT1920212223242526Expressions 8-5


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>8.3.3 Numeric ListsA numeric list is a an expression format for compactly expressing numbers <strong>and</strong> ranges ofnumbers in a single parameter.The syntax for is:PH020,DT8Where is defined as:The range is inclusive of the specified numbers.8-6 Expressions


Ed chan1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>9 Status ReportingSCPI requires the status mechanism described in chapter 11 of IEEE 488.2, including fullimplementation of the Event Status register structure.A SCPI device shall include the SCPI-defined OPERation status register <strong>and</strong> QUEStionabledata/signal status register with the associated condition, event, <strong>and</strong> enable comm<strong>and</strong>s. InFigure 9-1 on the following page, “Minimum Status Reporting Structure Required by SCPI”,a pictorial representation is given that shows the core of the SCPI-required status reportingcapability. Additional requirements are established for instruments that support eithermultiple logical INSTruments or the exp<strong>and</strong>ed capability TRIGger model.In general, a status register should fit into a 16-bit integer with the most-significant bitalways zero (positive logic).In the figures in this chapter, an elongated box is used to represent the “Status DataStructure-Register Model,” which is defined in IEEE 488.2. SCPI consists of condition,event, enable <strong>and</strong> optional transition registers. Two concentric circles with a cross throughthe center one indicates a logical summing.1234TK046 567891011121314151617181920212223242526Status Reporting 9-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>9Figure 9-1 Minimum Status Reporting Structure Required by SCPI9-2 Status Reporting


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>9.1 The Device-Dependent Register ModelThe Device-Dependent Register model follows the structure described in IEEE 488.2,section 11.4.2. The transition filter described in figure 11-6 is actually a pair ofprogrammable transition filters which are described below.The comm<strong>and</strong>s which access these registers are described in the “SCPI LanguageDescription.”If the Error/Event Queue Summary is reported in the Status Model, then bit 2 of the StatusByte shall be used to reflect the Empty/Non-Empty status of the queue. A bit value of 1indicates the queue is not empty. See the SYSTem:ERRor subsystem, Comm<strong>and</strong> Reference,21.8.9.2 Transition FiltersTransition filters are described in IEEE 488.2, section 11.4.2.2.1. SCPI allows the use ofprogrammable transition filters. When transition filters are used, SCPI requires the use ofseparate positive <strong>and</strong> negative transition filters. A positive transition filter allows an event tobe reported when a condition changes from false to true. A negative filter allows an event tobe reported when a condition changes from true to false. Setting both positive <strong>and</strong> negativefilters true allows an event to be reported anytime the condition changes. Clearing bothfilters disables event reporting.The contents of transition filters are unchanged by *CLS <strong>and</strong> *RST.9.3 Operation Status RegisterThe OPERation status register contains conditions which are part of the instrument’s normaloperation.The definition of each of these bits (condition register) is as follows:0-CALibrating — The instrument is currently performing a calibration.1-SETTling — The instrument is waiting for signals it controls to stabilizeenough to begin measurements.2-RANGing — The instrument is currently changing its range.3-SWEeping — A sweep is in progress.4-MEASuring — The instrument is actively measuring.5-Waiting for TRIG — The instrument is in a “wait for trigger” state of thetrigger model.6-Waiting for ARM — The instrument is in a “wait for arm” state of the triggermodel.7-CORRecting — The instrument is currently performing a correction.1234TK012 567891011121314151617181920212223242526Status Reporting 9-3


Ed Change1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>98-12 available to designer13-INSTrument Summary Bit One of n multiple logical instruments isreporting OPERational status.14-PROGram running — A user-defined programming is currently in the runstate.15 always zero9.4 QUEStionable Data/Signal Status RegisterThe QUEStionable status register set contains bits which give an indication of the quality ofvarious aspects of the signal.A bit set in the condition register indicates that the data currently being acquired orgenerated is of questionable quality due to some condition affecting the parameter associatedwith that bit. For example, if the FREQ bit were set, this would mean that the frequencyaccuracy of the signal was of questionable quality.The frequency bit might, in turn, have a register set associated with it, further refining theerror into device-dependent conditions such as loop unlocked, oven cold, or reference signalmissing. This layering of registers is called “fan-out”. See Figure 9-2 for an illustration ofthis technique. The device designer should be aware that adding registers to the status modelincreases complexity. At the same time, it may be the only way to communicate timesensitive status information to the instrument controller.Figure 9-2 Hierarchical Expansion of the QUEStionable Status RegisterBit 14 is defined as the Comm<strong>and</strong> Warning bit. This bit indicates a non-fatal warning thatrelates to the instrument’s interpretation of a comm<strong>and</strong>, query, or one or more parameters ofa specific comm<strong>and</strong> or query. Setting this bit is a warning to the application that the resultantinstrument state or action is probably what was expected but may deviate in some manner.TK0489-4 Status Reporting


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>For example, the Comm<strong>and</strong> Warning bit is set whenever a parameter in one of theMeasurement Instruction comm<strong>and</strong>s or queries is ignored during execution. Such aparameter may be ignored because it cannot be specified by a particular instrument.Bit 13, INSTrument summary, is described later in this chapter in association with multiplelogical instruments.Bits in both OPERation <strong>and</strong> QUEStionable status registers may be redefined by theapplication programmer. This optional feature allows an application program to configuretwo registers in whatever form it likes. Any error or event number from the entire pool oferrors/events the instrument can generate may be mapped into any bit of the OPERation orQUEStionable register.For example, an application program controlling a voltmeter may choose to map VOLTageevent X, VOLTage event Y <strong>and</strong> VOLTage event Z directly into the QUEStionable registerso that it has more direct access to them. Another purpose for this feature is to minimize theneed for adding complex hierarchical registers to the status model. The mapping iscontrolled by the STATus:OPERation:MAP <strong>and</strong> STATus:QUEStionable:MAP comm<strong>and</strong>s.9.5 Multiple Logical InstrumentsA SCPI device that supports multiple logical instruments may include an INSTrumentsummary status register <strong>and</strong> an individual instrument ISUMmary for each logical instrument.Figure 9-3 Expansion of the INSTrument Summary Bit for Multiple Logical InstrumentsTK0481234567891011121314151617181920212223242526Status Reporting 9-5


Ed ChangeEd Change1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>The ISUMmary registers shall report to the INSTrument register, which in turn shall reportto bit 13 of the QUEStionable or OPERation status register. This is shown pictorially inFigure 9-3, “Expansion of the INSTrument Summary Bit for Multiple Logical Instruments.”Such a multilogical instrument may also exp<strong>and</strong> the QUEStionable <strong>and</strong> OPERation registerin the manner shown in Figure 9-4, “Expansion of QUEStionable Register for MultipleLogical Instruments.”Using such a status register configuration allows a status event to be cross-referenced byinstrument <strong>and</strong> type of event. Further, when using a single logical instrument, the statusstructure is seen to behave in a manner that is directly compatible with a single physicalinstrument of the same capability. This affords upward compatibility.For multiple logical instruments, the INSTrument register indicates which instrument(s)have generated an event. The ISUMmary register is a pseudo-questionable status register for9Figure 9-4 Expansion of QUEStionable Register for Multiple Logical Instruments9-6 Status Reporting


Ed Chan1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>a particular logical instrument. There may be two INSTrument registers for each logicalinstrument in the device. For each event type, such as VOLTage, all the events may be ORedtogether from each logical instrument to provide a summary by event type to theQUEStionable status register.9.6 Status Structure for the Exp<strong>and</strong>ed Capability Trigger ModelFor instruments that implement the exp<strong>and</strong>ed capability trigger model, those instrumentsmay implement status structures to indicate the exact point in which the wait for ARM orTRIGger is occurring. If multiple SEQuences are employed, then the status structure shallexist to indicate in which SEQuences the wait for ARM or TRIGger is occurring. If multipleARM LAYers are employed, then the status structure shall exist to indicate in which LAYerthe wait for ARM or TRIGger is occurring. Figure 9-5, “Expansion of the OPERationalRegister for the Exp<strong>and</strong>ed Capability Trigger Model,” shows the structure for an instrumentthat employs more than one TRIGger sequence, more than one ARM sequence, <strong>and</strong> multipleARM LAYers.* The use of Bit 15 is not allowed since some controllers may have difficulty reading a 16 bitunsigned integer. The value of this bit shall always be 0.** The extension bit is used, where required, to summarize the events in INSTrument15 <strong>and</strong> up.The extension of the status structure shall conform to IEEE 488.2Figure 9-5 Expansion of OPERation Register for the Exp<strong>and</strong>ed Capability Trigger Model1234567891011121314151617181920212223242526Status Reporting 9-7


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>99-8 Status Reporting


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>10 *RST ConditionsAll instruments shall return to a known configuration when the IEEE 488.2 *RST comm<strong>and</strong>is received. The “Comm<strong>and</strong> Reference” specifies the *RST condition for every comm<strong>and</strong>. Insome cases, the condition may be instrument-dependent. Instrument-dependent means thatthe designer may determine the setting at *RST. However, the setting shall be known for theinstrument. Leaving a setting undefined at *RST is not allowed, unless specifically permittedin the comm<strong>and</strong> description.Consideration shall be given to safety if the instrument is capable of producing hazardousconditions.Operation after a *RST is optimized for remote operation.A *RST comm<strong>and</strong> returns the instrument to a state where it is waiting for a comm<strong>and</strong> toinitiate measurements or other instrument actions.All instruments shall place themselves in the trigger idle state. Source instruments should notbe sourcing power at any output port. This condition may be reached by lowering thepower/voltage level or by turning the output state to OFF. Input ranges should normally beset to AUTORANGE or minimum sensitivity. Settings which are normally coupled shouldbe coupled. Special modes, complex modulations, postprocessing, or similar functions whichare generally application-dependent should be disabled leaving the instrument in its mostfundamental mode of operation.Finally, thought should be given to implementing *RST conditions so that the incrementalprogramming necessary after *RST for the applications be minimized.The SYSTem:PRESet comm<strong>and</strong> performs the same action as the front panel preset key. Thistypically sets all instrument parameters to values for good local/human interaction. Inmanual operation, it is often desirable to have SYSTem:PRESet enable continuousmeasurements. This may be different from the *RST state <strong>and</strong> the power-on state.Status structures are not affected by *RST. The status event bits are cleared by *CLS <strong>and</strong> byreading the event register. The error/event queue is also cleared by *CLS. Device-dependent<strong>and</strong> SCPI status registers <strong>and</strong> queues are preset with the SCPI required STATus:PRESetcomm<strong>and</strong>.If a device is unable to implement the *RST condition of a function, it may choose adifferent *RST condition. However, under these circumstances, the comm<strong>and</strong> for thisfunction must be implemented, even if only one selection is available. If the deviceimplements the stated *RST setting, the function must assume that value at *RST.1234567KI001a 891011121314151617181920 TK012212223242526*RST Conditions 10-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>1010-2 *RST Conditions


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>11 Naming ConventionsIn many SCPI subsystems there is the need for assigning names to structures or expressionsor arbitrary data memory.This includes naming of windows in the DISPlay subsystem, traces in TRACe, expressionsto specify events <strong>and</strong> sequences in TRIGger, expressions to specify cards <strong>and</strong> channel lists inROUTe, <strong>and</strong> various items elsewhere. If possible, these naming operations should all havethe same form so that these operations in the various subsystems can be consistent. A usercan therefore transfer knowledge gained in one area to a similar task in another subsystem.For this proposed general-purpose naming facility, there is no “enable” comm<strong>and</strong>; allcurrently defined names will be associated with their data at define/assign time <strong>and</strong> existuntil deleted. There are two forms of the “purge” comm<strong>and</strong>: one which operates onindividual names as well as one for the whole name space. Names have implicit types <strong>and</strong>memory is allocated based on the subsystem in which the name is created. Names must beunique within the system to allow a designer to implement these comm<strong>and</strong>s using one globalname space.The same keywords for naming will be used in all subsystems which allow names. Eventhough TRACe:DEFine <strong>and</strong> DISPlay:WINDow:DEFine require different parameters, theoperations are similar <strong>and</strong> the instrument programmer can expect similar keywords.The name space is not affected by *RST, <strong>and</strong> names remain associated with their data afterthis operation.KEYWORD PARAMETER FORM NOTESNaming Sub-subsystem::DEFine,:DEFine?:DELete[:NAME] :ALL[event; no query]:CATalog?[query only]Comm<strong>and</strong> DescriptionsDifferences among these comm<strong>and</strong>s <strong>and</strong> differences from the macro definition facility arenoted in the descriptions.The name is sent as rather than as a string, because that is the simplestIEEE 488.2 type that meets the requirements. Macro definitions needed the typebecause macro names could contain colons <strong>and</strong> queries, <strong>and</strong> their total length could be morethan 12 characters. Names do not have those extensions. When a name is returned (forexample, in a “CATalog?” query), it must be sent as so that a nullstring ("") can indicate that nothing is defined.1234567891011121314151617181920212223242526Naming Conventions 11-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>Names defined using these comm<strong>and</strong>s are not purged at *RST. The only way of deletingthem is through a DELete or DELete:ALL comm<strong>and</strong>.11.1 :DEFine ,This comm<strong>and</strong> associates a user-specified with data . The type of isdependent on the subsystem in which the comm<strong>and</strong> occurs, <strong>and</strong> must be specified in thesyntax for that tree. The field may be optional for some subsystems.11.2 :DEFine? This query requests the instrument to return the definition of . The type of datareturned depends on the specific subsystem in which the comm<strong>and</strong> occurs. If possible (thatis, if IEEE 488.2 allows), it should be returned in the same form it was sent.11.3 :DELete[:NAME] This comm<strong>and</strong> undefines the name, disassociates it from any data, <strong>and</strong> frees the name <strong>and</strong> itsdata memory for use by other definitions. There is no query associated with this action.1111.4 :DELete:ALLThis comm<strong>and</strong> undefines all names in this subsystem, <strong>and</strong> frees any associated data memory.There is no query associated with this action.11.5 :CATalog?This query requests a list of defined names in this subsystem. The instrument must return alist of one or more strings, each containing one name <strong>and</strong> separated by commas. If no namesare defined, a single null string is returned.11-2 Naming Conventions


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>A Programming Tips HP077By following a set of simple guidelines, a programmer can reduce the number of errorsencountered when using SCPI instruments. All references in this appendix are to <strong>Volume</strong> I:<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, unless otherwise specified.1. Avoid sending default nodes. See 5.1 <strong>and</strong> 6.2.2 item 5. Default nodes are used withinSCPI to allow the language to grow. Thus, older instruments will not have implemented thedefault node. A comm<strong>and</strong> is more likely to work with more instruments if the default nodesare omitted. For example, use:INP:FILT ONrather than:INP:FILT:LPAS:STAT ON2. Avoid sending a numeric suffix of 1 in applications that only use the default capability.See 6.2.5.2. An instrument with multiple capabilities is required to interpret a header withoutthe numeric suffix as if a numeric suffix of one had been used. Leaving off the numericsuffix means the same comm<strong>and</strong>s will work with an instrument that has multiple capabilities<strong>and</strong> an instrument that does not. For example, use:OUTP ONrather thanOUTP1 ON3. Be careful when sending coupled comm<strong>and</strong>s. See 7.4.2. Many instruments adhere to thesuggestion in IEEE 488.2 section 6.4.5.3. If the coupled comm<strong>and</strong>s are contiguous in thesame program message, the instrument is more likely to resolve any conflict between thecurrent settings <strong>and</strong> the new settings. For example, use::FREQ:STAR 100;SPAN 100which sets START to 100, STOP to 200, CENTER to 150, <strong>and</strong> SPAN to 100. Assume thatSTART was 200 <strong>and</strong> STOP was 500 before sending;:FREQ:STAR 100Now, START is 100, STOP is 500, CENTER is 300, <strong>and</strong> SPAN is 400. Then send::FREQ:SPAN 100which sets START to 250, STOP to 350, SPAN to 100, <strong>and</strong> leaves CENTER at 300 . Thesestates are very different <strong>and</strong> the second is probably not the intended one.4. Verify instrument settings when knowing their exact value is required. If the actual valueof a setting is important, query the setting after programming it. An instrument is required toround parameters. See 7.2. For example, sending:1234567891011A1314151617181920212223242526Programming Tips A-1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>A:VOLT 1.68:VOLT?may return 1.68, 1.7, or 2 depending on the capability of the instrument.5. Send comm<strong>and</strong>s <strong>and</strong> queries in different program messages.The response from a query combined in a program message with comm<strong>and</strong>s that affect thequeried value is not predictable. Sending::FREQ:STAR 100;SPAN 100:FREQ:STAR?always returns 100. When::FREQ:STAR 100;STAR?;SPAN 100is sent, however, the result is not specified by SCPI. The result could be the value of STARTbefore the comm<strong>and</strong> was sent since the instrument might defer executing the individualcomm<strong>and</strong>s until a program message terminator is received. The result could also be 100 ifthe instrument executes comm<strong>and</strong>s as they are received.6. Use the highest level comm<strong>and</strong>s possible for compatibility across instruments. Wheneverfeasible, use the MEASure, CONFigure, READ?, FETCh?, <strong>and</strong> INITiate comm<strong>and</strong>s. Use thelower level comm<strong>and</strong>s only when a special characteristic of an instrument must bemanipulated.A-2 Programming Tips


Index 5-1[] 5-1{} 5-1| 5-1Aaliases 6-3ANSIX3.4-1977 2-1X3.42-1975 2-1ANSI/EIATIA-562-1989 2-1ARM 9-3BBell Telephone BTSM 41004 2-1 7-5BTSM 41004 2-1building comm<strong>and</strong> trees 6-2CCALibrating 9-3capability, multiple 6-8CATalog 11-2CCIR Recommendation468-2 2-1CCITT RecommendationP53 2-1V.42 2-1channellists 8-3channel list 8-1channel_list 6-8, 8-4 8-4 - 8-5 8-5charactercase 5-2character case 6-1 11-1CHARACTER PROGRAM DATA 7-5comm<strong>and</strong> table notation 5-1common comm<strong>and</strong> header 6-1common comm<strong>and</strong>seffects of *RST 10-1m<strong>and</strong>atory 4-1optional 4-1compliance criteria 4-1CORRecting 9-3coupling 7-5functional 7-6value 7-6Ddata interchange format 8-17-1, 7-5DEFault 7-1default node 5-1DEFine 11-2query 11-2definition, macro 11-1DELete 11-2device dependence 3-2devices 4-1dif 8-1display window naming 11-1Dolby Labs Bulletin No 19/4 2-1DOWN 7-1 - 7-2STEP 7-3EEIARS-232-D 2-1RS-422 2-1elementlexical 8-1syntactic 8-1expressionchannel list 8-1data interchange format 8-1dif 8-1instrument specifier 8-1numeric 8-1 - 8-2numeric list 8-1precedence rules 8-3 8-1Index - 1


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>Fflow diagram notation 5-2formlong 5-1, 6-1short 5-1, 6-1front panel 1-1Hheadercomm<strong>and</strong> comm<strong>and</strong> 6-1comm<strong>and</strong> tree generation 6-2instrument control 6-1keyword generation 6-1longform 6-1numeric suffix 6-2, 6-8queries 6-6query 6-1short form 6-2tree traversal 6-7hierarchical structure 5-1IIEC Recommendation179 2-1IEEEStd. 181-1977 2-1Std. 194-1977 2-1Std. 260-1978 2-1Std. 488.1-1987 1-1, 2-1, 4-1Std. 488.2-1987 1-1, 1-3, 4-1, 6-1, 6-7Std. 488.2-1992 2-1Std. 754-1985 2-1INFinity 7-1, 7-4INSTrument 9-6instrument control header 6-1instrument dependent 10-1instrument specifier expression 8-1INSTrument Summary Bit 9-4ISOStd. 2955-1983 2-2ISUMmary 9-6KKEYWORD 5-1keywords 6-1Llabel 7-1lexical element 8-1life cycle 3-1 - 3-3living st<strong>and</strong>ard 3-1logical instruments 6-9long form 5-1, 6-1Mmacro definition 11-1m<strong>and</strong>ated comm<strong>and</strong>s 4-1MAXimum 7-1MEASuring 9-3MINimum 7-1 - 7-2 8-4 8-5multiplecapabilities 6-8electrical ports 6-8indentical capabilities 6-8logical instruments status 9-5Nnaming conventions 11-1CATalog 11-2DEFine 11-2DELete 11-2NAN (not a number) 7-4nomenclaturesee notation 5-1 7-1Not A Number (NAN) 7-1notation 5-1comm<strong>and</strong> tables 5-1query 5-1status structure diagrams 9-1syntax flow diagrams 5-2NOTES 5-1 7-1numeric expression 8-1 - 8-2numeric list 8-1 7-1 8-6 8-2 8-6Index - 2


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>Oobsolesence 3-1OFF 7-5ON 7-5OPERation 9-1OPERation Status Register 9-3optionaluse of expressions 8-1comm<strong>and</strong>s 4-6common comm<strong>and</strong>s 4-1IEEE 488.1 interface 4-1nodes 6-4SCPI comm<strong>and</strong>s 4-6PPARAMETER FORM 5-1parameters 7-1 7-1 7-1 7-1Boolean program data 7-5character program data 7-1decimal numeric program data 7-1DEFault 7-1DOWN 7-2INFinity 7-4MAXimum 7-2NAN (not a number) 7-4STEP UP/DOWN 7-3unit suffixes 7-5UP 7-2precedence rules 8-3primary keyword 6-3program headers 6-1queries 6-6 6-7 6-7PROGram running 9-4Qqueries 6-6QUEStionable 9-1QUEStionable Data 9-4Rrailroad diagrams 5-2RANGing 9-3References 2-1requirementsdocumentation 4-6IEEE 488.1 4-1IEEE 488.2 4-1IEEE m<strong>and</strong>ated comm<strong>and</strong>s 4-1minimum status structure 9-1multiple capabilities 6-9safety 10-1SCPI 4-5SCPI comm<strong>and</strong>s 4-5roundingnumeric program data 7-1Ssafety requirements 10-1SCPIrequirements 4-5semantics 8-3SETTling 9-3short form 5-1, 6-1Signal Status Register 9-4square brackets 5-1status reporting 9-1device dependent registers 9-3diagram notation 9-1effect of *CLS 9-3effect of *RST 9-3enhanced TRIGger model 9-7minimum requirement 9-1multiple logical instruments 9-5OPERation 9-1, 9-3QUEStionable 9-1, 9-4transition filters 9-3TRIGger model 9-1STEP 7-3AUTO 7-4INCRement 7-3MODE 7-3PDECade 7-3 11-1 7-5SWEeping 9-3<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong> 1-1syntax flow diagram notation 5-2systems instruments 1-1Ttrace naming 11-1 8-3transition filters 9-3Index - 3


1997 SCPI <strong>Syntax</strong> & <strong>Style</strong>negative 9-3positive 9-3Traversal of header tree 6-7tree system 5-1tree walking 6-7enhanced 6-7TRIGger 9-3LAYers 9-7SEQuences 9-7U 8-3unitamplitude <strong>and</strong> power 7-7suffixes 7-5unitless quantities 7-9units of measure 7-7UP 7-1 - 7-2STEP 7-3V 8-3VXI 2-2, 6-9Index - 4


St<strong>and</strong>ardComm<strong>and</strong>s forProgrammableInstruments(SCPI)<strong>Volume</strong> 2: Comm<strong>and</strong> ReferenceVERSION 1997.0May, 1997Printed in U.S.A.


NOTICE, STATEMENT of INTENT<strong>and</strong>AUTHORIZATION TO COPY© Copyright 1997 SCPI ConsortiumThis document defines the St<strong>and</strong>ard-Comm<strong>and</strong>s-for-Programmable-Instruments (SCPI) Consortium’sSCPI st<strong>and</strong>ard. Although the Consortium hereby expressly disclaims any <strong>and</strong> all warranties whatsoeverregarding the SCPI st<strong>and</strong>ard, the Consortium has published this document with the intent that the SCPIst<strong>and</strong>ard will be seriously considered <strong>and</strong> adopted, in whole, by the test <strong>and</strong> measurement marketplace.Consistent with that intent, permission is hereby granted by the Consortium to make copies of thisentire document as a whole, PROVIDED THAT this NOTICE, STATEMENT of INTENT <strong>and</strong>AUTHORIZATION TO COPY shall prominently appear on each such whole copy. Further consistentwith that intent, permission is hereby granted by the consortium to make copies of portions of thisdocument, absent this NOTICE, STATEMENT of INTENT <strong>and</strong> AUTHORIZATION TO COPY,PROVIDED THAT each such portion-copies shall only be used in a manner which is consistent withthe purposes of implementing, promoting, disseminating, or enhancing (as opposed to deviating from)the SCPI st<strong>and</strong>ard as herein defined, such as the inclusion of such a portion-copy in an instrument (orinstrument-related) product manual which implements SCPI (as defined herein) or in use for design ofsuch an instrument (or instrument related) product. However, under no circumstances may copies ofthis document, or any portion of this document, be made solely for purposes of sale of the copy orcopies.For information, contact:Fred Bode, Executive DirectorSCPI Consortium8380 Hercules Drive, Suite P3La Mesa, CA 91942Phone: (619) 697-8790FAX: (619) 697-5955CompuServe Number: 76516,254fbode@vxinl.comii


Table of ContentsChapter 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Introduction 1-1Chapter 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Instrument Model 2-1Chapter 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Measurement Instructions 3-1Chapter 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALCulate Subsystem 4-1Chapter 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALibration Subsystem 5-1Chapter 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTrol Subsystem 6-1Chapter 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .DIAGnostic Subsystem 7-1Chapter 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .DISPlay Subsystem 8-1Chapter 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMat Subsystem 9-1Chapter 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HCOPy 10-1Chapter 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .INPut Subsystem 11-1Chapter 12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INSTrument Subsystem 12-1Chapter 13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MEMory Subsystem 13-1Chapter 14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .MMEMorySubsystem 14-1Chapter 15 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .OUTPut Subsystem 15-1Chapter 16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PROGram Subsystem 16-1Chapter 17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ROUTe Subsystem 17-1Chapter 18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .SENSe Subsystem 18-1Chapter 19 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SOURce Subsystem 19-1Chapter 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .STATus Subsystem 20-1Chapter 21 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTem Subsystem 21-1Chapter 22 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .TEST Subsystem 22-1Chapter 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TRACe | DATA 23-1Chapter 24 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TRIGger Subsystem 24-1Chapter 25 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .UNIT Subsystem 25-1Chapter 26 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VXI Subsystem 26-1iii


Table of ContentsChapter 1 Introduction1.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11.2 Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Chapter 2 Instrument Model2.1 Signal Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22.1.1 Setting the Destination for Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22.2 Measurement Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32.2.1 INPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32.2.2 SENSe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.2.3 CALCulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.3 Signal Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.3.1 OUTPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.3.2 SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.3.3 CALCulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.4 TRIGger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.5 MEMory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.6 FORMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.7 Internal Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.7.1 Data <strong>and</strong> Control Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.7.2 Numeric Suffixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72.7.3 Lamina <strong>and</strong> Cloned Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72.7.3.1 FEED Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.7.3.2 Amorphous SENSe Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.7.3.3 Other Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.7.4 FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.7.4.1 Sensor Function Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.7.4.2 FEEDs from CALCulate Sub-Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-122.7.5 COMBine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-122.7.6 Memory Associated with Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-122.7.7 Querying the Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-142.7.8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14Chapter 3 Measurement Instructions3.1 CONFigure: [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.2 FETCh[:]? [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.3 READ[:]? [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43.4 MEASure:? [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-53.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5v


1997 SCPI Comm<strong>and</strong> Reference3.6 Presentation Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73.6.1 Presentation Comm<strong>and</strong> Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73.6.2 [:SCALar] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73.6.3 :ARRay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73.7 Fundamental Measurement Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73.7.1 Fundamental Measurement Comm<strong>and</strong> Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73.7.2 :VOLTage [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83.7.3 :CURRent [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83.7.4 :POWer [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83.7.5 :RESistance [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83.7.6 :FRESistance [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83.7.7 :TEMPerature [[, [,[,]]]] . . . . . . . . . 3-83.8 Measurement Function Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1 Simple Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1.1 Simple Measurements Comm<strong>and</strong> Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1.2 :AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1.3 [:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1.4 :FREQuency [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1.4.1 :BURSt [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93.8.1.4.2 :PRF [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103.8.1.5 :PERiod [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103.8.1.6 :PHASe [[,]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103.8.2 Time Domain Waveform Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103.8.2.1 Waveform Measurements Comm<strong>and</strong> Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103.8.2.2 :AMPLitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-113.8.2.3 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.4 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.5 :RISE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.5.1 :TIMe [[,[,[,]]]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.5.2 :OVERshoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.5.3 :PREShoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.6 :RTIMe [[,[,[,]]]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-123.8.2.7 :FALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133.8.2.7.1 :TIME [[,[,[,]]]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133.8.2.7.2 :OVERshoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133.8.2.7.3 :PREShoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133.8.2.8 :FTIMe [[,[,[,]]]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133.8.2.9 :PWIDth [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133.8.2.10 :NWIDth [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-143.8.2.11 :PDUTycycle|:DCYCle [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-143.8.2.12 :NDUTycycle [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14vi


1997 SCPI Comm<strong>and</strong> Reference3.8.2.13 :TMAXimum Layer:Time Domain Waveform Measurements . . . . . . . . . . . . . . . . . 3-143.8.2.14 :TMINimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-143.8.2.15 :MINimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-143.8.2.16 :MAXimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-143.8.2.17 :PTPeak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14Chapter 4 CALCulate Subsystem4.1 :AVERage subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64.1.1 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64.1.2 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.1.2.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.1.3 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.1.4 :TCONtrol EXPonential | MOVing | NORMal | REPeat . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.1.5 :TYPE COMPlex | ENVelope | MAXimum | MINimum | RMS | SCALar . . . . . . . . . . . . 4-84.2 :CLIMits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94.2.1 :FAIL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94.2.2 :FLIMits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94.2.2.1 [:DATA]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94.2.2.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94.3 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.3.1 :PREamble? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.4 :DERivative . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.4.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.4.2 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.5 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.6 :FILTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1 [:GATE] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1.1 :TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1.1.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1.1.2 [:TYPE ] BPASs|NOTCh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1.1.3 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1.1.4 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114.6.1.1.5 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.6 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.7 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.7.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.8 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.9 :KBESsel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.10 :EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6.1.1.11 :FORCe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134.6.1.2 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134.6.1.2.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134.6.1.2.2 [:TYPE ] BPASs|NOTCh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13vii


1997 SCPI Comm<strong>and</strong> Reference4.6.1.2.3 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134.6.1.2.4 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134.6.1.2.5 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.6 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.7 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.7.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.8 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.9 :KBESsel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.10 :EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144.6.1.2.11 :FORCe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154.7 :FORMat NONE|MLINear|MLOGarithmic|PHASe|REAL|IMAGinary|SWR|GDELay|COMPlex|NYQuist|NICHols|POLar|UPHase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154.7.1 :UPHase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-164.7.1.1 :CREFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174.7.1.2 :PREFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174.8 :GDAPerture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174.8.1 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174.8.2 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174.9 :IMMediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184.9.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184.10 :INTegral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184.10.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184.10.2 :TYPE SCALar | MOVing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184.11 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184.11.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194.11.2 :CONTrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194.11.2.1 [:DATA] {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194.11.2.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194.11.3 :UPPer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194.11.3.1 [:DATA] {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194.11.3.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.4 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.4.1 [:DATA] {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.4.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.4.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.5 :FAIL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.6 :FCOunt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.7 :REPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.7.1 [:DATA]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-204.11.7.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.11.8 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21viii


1997 SCPI Comm<strong>and</strong> Reference4.11.8.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.11.8.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.11.9 :INTerpolate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.12 :MATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.12.1 [:EXPRession] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.12.1.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-214.12.1.2 [:DEFine] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-224.12.1.3 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-224.12.1.3.1 [:SELected] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-224.12.1.3.2 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-224.12.1.4 :NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-224.12.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-234.13 :SMOothing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-234.13.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-234.13.2 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-234.13.3 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-234.14 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-234.15 :TRANsform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-234.15.1 :HISTogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-244.15.1.1 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-244.15.1.2 :ORDinate RATio | PERCent | PCT | COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-244.15.1.3 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-244.15.1.4 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-244.15.1.4.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.1.5 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.2 :TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.2.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.2.2 [:TYPE ] LPASs|BPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.2.3 :STIMulus STEP|IMPulse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.2.4 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-254.15.2.5 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-264.15.2.6 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-264.15.2.7 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-264.15.2.8 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-264.15.2.8.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-264.15.2.9 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-264.15.2.10 :KBESsel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.2.11 :EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.2.12 :FORCe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.3 :DISTance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.3.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.3.2 [:TYPE ] LPASs|BPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.3.3 :STIMulus STEP|IMPulse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-274.15.3.4 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28ix


1997 SCPI Comm<strong>and</strong> Reference4.15.3.5 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-284.15.3.6 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-284.15.3.7 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-284.15.3.8 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-284.15.3.8.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-284.15.3.9 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.3.10 :KBESsel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.3.11 :EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.3.12 :FORCe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.4 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.4.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.4.2 [:TYPE ] LPASs|BPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-294.15.4.3 :STIMulus STEP|IMPulse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-304.15.4.4 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-304.15.4.5 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-304.15.4.6 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-304.15.4.7 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-304.15.4.8 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.15.4.8.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.15.4.9 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.15.4.10 :KBESsel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.15.4.11 :EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.15.4.12 :FORCe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.16 :PATH(MATH|TRANsform|FILTer|SMOothing|FORMat|LIMit|AVERage){,(MATH|TRANsform|FILTER|SMOothing|FORMat|LIMit|AVERage)} . . . . . . . . . . . 4-31Chapter 5 CALibration Subsystem5.1 [:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15.2 [:ALL]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15.3 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-15.4 :DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15.5 :SOURce INTernal|EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.6 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.7 :VALue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.8 :ZERO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.8.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2Chapter 6 CONTrol Subsystem6.1 :BLOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.1.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.2 :COMPressor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.2.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1x


1997 SCPI Comm<strong>and</strong> Reference6.3 :APOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.3.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1Chapter 7 DIAGnostic SubsystemChapter 8 DISPlay Subsystem8.1 :ANNotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.1.1 [:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.1.2 :AMPLitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.1.3 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.2 :BRIGhtness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.3 :CMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.3.1 :DEFault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.3.2 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48.3.2.1 :HSL ,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-58.3.2.2 :RGB ,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-58.4 :CONTrast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-58.5 :ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-58.6 :MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.6.1 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.6.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.6.3 :KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.7 [:WINDow] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.7.1 :BACKground . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.7.1.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.7.2 :GEOMetry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-68.7.2.1 :LLEFt , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.2.2 :SIZE , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.2.3 :URIGht , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.3 :GRAPhics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.3.1 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.3.2 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.3.3 :CSIZe [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-78.7.3.4 [:DRAW] , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.5 :PCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.6 :HPGL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.7 :IDRaw , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.8 :IMOVe , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.9 :LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.10 :LDIRection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.11 :LTYPe [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-88.7.3.12 :MOVE , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-98.7.3.13 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-98.7.4 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9xi


1997 SCPI Comm<strong>and</strong> Reference8.7.5 :TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-98.7.5.1 :ATTRibutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-98.7.5.2 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-98.7.5.3 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-98.7.5.4 :CSIZe [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.5.5 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.5.6 [:DATA] | . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.5.7 :LOCate [, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.5.8 :PAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.5.9 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.6 :TRACe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.6.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.6.2 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-108.7.6.3 :GRATicule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.1 :AXIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.1.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.2 :FRAMe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.2.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.3 :GRID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.3.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.3.3.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.4 :PERSistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.4.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.5 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-118.7.6.6 :X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-128.7.6.6.1 :LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-128.7.6.6.2 [:SCALe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-128.7.6.6.2.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-128.7.6.6.2.2 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-128.7.6.6.2.3 :LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-128.7.6.6.2.4 :PDIVision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-138.7.6.6.2.5 :RIGHt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-138.7.6.7 :Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-138.7.6.7.1 :LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-138.7.6.7.2 :RLINe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-138.7.6.7.3 [:SCALe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-138.7.6.7.3.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-148.7.6.7.3.2 :BOTTom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-148.7.6.7.3.3 :PDIVision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-148.7.6.7.3.4 :RLEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-148.7.6.7.3.5 :RPOSition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.7.3.6 :TOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.7.4 :SPACing LOGarithmic | LINear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.8 :R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.8.1 :LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-15xii


1997 SCPI Comm<strong>and</strong> Reference8.7.6.8.2 [:SCALe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.8.2.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.8.2.2 :CPOint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-158.7.6.8.2.3 :OEDGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-168.7.6.8.3 :SPACing LOGarithmic | LINear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-16Chapter 9 FORMat Subsystem9.1 :BORDer NORMal|SWAPped . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19.2 [:DATA] [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-19.3 :DINTerchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-29.4 :SREGister ASCii | BINary | HEXadecimal | OCTal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3Chapter 10 HCOPy10.1 :ABORt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-410.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-410.3 :DESTination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-410.4 :DEVice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-510.4.1 :CMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-510.4.1.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-510.4.1.1.1 :HSL ,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-510.4.1.1.2 :RGB ,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-510.4.1.2 :DEFault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-610.4.2 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-610.4.3 :LANGuage PCL[] | HPGL[] | POSTscript[] . . . . . . . . . . . . . . . . . . . . . . . . 10-610.4.4 :MODE TABLe | GRAPh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.4.5 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.4.5.1 :UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.4.6 :SPEed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.4.6.1 :UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.5 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.6 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.7 :ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-710.7.1 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.1.1 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.2 :ANNotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.2.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.2.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.2.3 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.2.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.3 :CUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-810.7.3.1 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.3.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9xiii


1997 SCPI Comm<strong>and</strong> Reference10.7.4 :FFEed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.4.1 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.4.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.4.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.5 :LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.5.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-910.7.5.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.5.3 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.5.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.5.5 :TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.6 :MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.6.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.6.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.6.3 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.6.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1010.7.7 :TDSTamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.7.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.7.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.7.3 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.7.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.8 [:WINDow] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.8.1 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.8.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.8.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.8.4 :TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1110.7.8.4.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.4.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.4.3 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.4.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5 :TRACe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5.3 :GRATicule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5.3.1 :COLor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5.3.2 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1210.7.8.5.3.3 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.7.8.5.3.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.7.8.5.4 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.7.8.5.5 :LTYPe SOLid | DOTTed | DASHed | STYLe . . . . . . . . . . . . . . . . . . . . . . . 10-1310.7.8.5.6 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.8 :PAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.8.1 :DIMensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.8.1.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1310.8.1.2 :LLEFt , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1410.8.1.3 :QUADrant[] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14xiv


1997 SCPI Comm<strong>and</strong> Reference10.8.1.4 :URIGht , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1410.8.2 :LENGth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1410.8.3 :ORIentation LANDscape | PORTrait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1410.8.4 :SCALe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1410.8.5 :SIZE CUSTom|A|B|C|D|E|A0|A1|A2|A3|A4|B0|B1|B2|B3|B4|B5 . . . . . . . . . . . . . . . . 10-1510.8.6 :UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1510.8.7 :WIDTh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1510.9 :SDUMp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1510.9.1 :DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1510.9.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15Chapter 11 INPut Subsystem11.1 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-311.1.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-311.1.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-311.2 :BIAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-311.2.1 :CURRent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-311.2.1.1 :AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2.1.2 [:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2.3 :TYPE CURRent | VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2.4 :VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2.4.1 :AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2.4.2 [:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.3 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.4 :FILTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.1 :AWEighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.1.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.2 :HPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.2.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.2.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.3 [:LPASs] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.3.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.4.3.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-511.5 :GAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.5.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.5.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.6 :GUARd LOW|FLOat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.7 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.8 :LOW FLOat|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.9 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.9.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.10 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.11 :POLarization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-7xv


1997 SCPI Comm<strong>and</strong> Reference11.11.1 :HORizontal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.11.2 :VERTical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.12 :POSition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.12.1 [:X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-811.12.1.1.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2 [:DISTance] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.12.1.2.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2 :Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.12.2.1.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2 [:DISTance] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1111.12.2.2.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3 :Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12xvi


1997 SCPI Comm<strong>and</strong> Reference11.12.3.1.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1211.12.3.1.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2 [:DISTance] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1311.12.3.2.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1411.13 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1411.14 :TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-14Chapter 12 INSTrument Subsystem12.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-112.1.1 :FULL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-112.2 :COUPle[:] ALL|NONE| . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-212.3 :DEFine , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-212.4 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-212.4.1 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-212.4.2 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-312.5 :NSELect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-312.6 [:SELect] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-312.7 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3Chapter 13 MEMory Subsystem13.1 :CATalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-313.1.1 [:ALL]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-313.1.2 :ASCii? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-313.1.3 :BINary? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-313.1.4 :MACRo? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-413.1.5 :STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-413.1.6 :TABLe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-413.2 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-413.2.1 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-413.2.2 :TABLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-413.3 :COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-513.3.1 [:NAME] , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-513.3.2 :TABLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5xvii


1997 SCPI Comm<strong>and</strong> Reference13.4 :DATA, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-513.5 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-513.5.1 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.5.2 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.6 :EXCHange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.6.1 [:NAME] , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.6.2 :TABLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.7 :FREE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.7.1 [:ALL]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-613.7.2 :ASCii? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.7.3 :BINary? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.7.4 :MACRo? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.7.5 :STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.7.6 :TABLe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.8 :NSTates? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.9 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-713.9.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-813.9.2 :DEFine , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-813.10 :TYPE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-813.11 :TABLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-813.11.1 :CONDition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-813.11.1.1 [:MAGNitude] {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-813.11.1.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.2 :CURRent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.2.1 [:MAGNitude] {,} . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.2.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.2.2 :PHASe {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.2.2.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.3 :DEFine [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-913.11.4 :FREQuency {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1013.11.4.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1013.11.5 :LOSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1013.11.5.1 [:MAGNitude] {,} . . . . . . . . . . . . . . . . . . . . . . 13-1013.11.5.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1013.11.5.2 :PHASe {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.5.2.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.6 :POWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.6.1 [:MAGNitude] {,} . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.6.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.7 :RESistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.7.1 [:MAGNitude] {,} . . . . . . . . . . . . . . . . . . . . . . 13-1113.11.7.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1213.11.8 :SELect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1213.11.9 :VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1213.11.9.1 [:MAGNitude] {,} . . . . . . . . . . . . . . . . . . . . . . 13-12xviii


1997 SCPI Comm<strong>and</strong> Reference13.11.9.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1213.11.9.2 :PHASe {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1213.11.9.2.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-12Chapter 14 MMEMorySubsystem14.1 :CATalog? [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-214.2 :CDIRectory [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-314.3 :CLOSe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-314.4 :COPY , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-314.5 :DATA , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-314.6 :DELete [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-314.7 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-414.8 :INITialize [[,(LIF|DOS|HFS)[,]]] . . . . . . . . . . . . . . . . . . . . . . . . 14-414.9 :LOAD <strong>and</strong> :STORe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-414.9.1 :DINTerchange ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-414.9.1.1 :TRACe ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-414.9.2 :MACRo ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-414.9.3 :STATe ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-414.9.4 :TABLe ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-514.9.5 :TRACe ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-514.10 :MSIS [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-514.11 :MOVE (,)|(,,,) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-514.12 :NAME [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-514.13 :OPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-614.14 :PACK [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-6Chapter 15 OUTPut Subsystem15.1 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-315.2 :COUPling AC|DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-315.3 :FILTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-315.3.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-315.3.2 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-315.3.2.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.3 :HPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.3.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.3.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.3.3 :TYPE BESSel | CHEByshev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.4 [:LPASs] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.4.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.4.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.3.4.3 :TYPE BESSel | CHEByshev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-415.4 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.5 :LOW FLOat|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5xix


1997 SCPI Comm<strong>and</strong> Reference15.6 :POLarity NORMal | INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.7 :POLarization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.7.1 :HORizontal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.7.2 :VERTical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.8 :POSition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.8.1 [:X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-515.8.1.1 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.1.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-615.8.1.2 [:DISTance] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.1.2.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-715.8.2 :Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.1.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-815.8.2.2 [:DISTance] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.2.2.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-915.8.3 :Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-10xx


1997 SCPI Comm<strong>and</strong> Reference15.8.3.1.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.1.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1015.8.3.2 [:DISTance] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.1 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.3 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.3.1 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.3.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.3.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.8.3.2.5 :VELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1115.9 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.9.1 :DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.9.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.9.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.9.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.10 :ROSCillator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.10.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.11 :TTLTrg|:ECLTrg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.11.1 :IMMediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1215.11.2 :LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1315.11.3 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1315.11.4 :PROTocol SYNChronous|SSYNchronous|ASYNchronous . . . . . . . . . . . . . . . . . . . . . 15-1315.11.5 :WIDTh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1315.11.6 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1315.11.7 :SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1315.12 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1415.13 :TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-14Chapter 16 PROGram Subsystem16.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2 [:SELected] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2.1 :DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2.2 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2.2.1 [:SELected] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2.2.2 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2.3 :EXECute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-216.2.4 :MALLocate |DEFault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3xxi


1997 SCPI Comm<strong>and</strong> Reference16.2.5 :NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-316.2.6 :NUMBer {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-316.2.7 :STATe RUN|PAUSe|STOP|CONTinue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-316.2.8 :STRing {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-416.2.9 :WAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-416.3 :EXPLicit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-416.3.1 :DEFine , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-416.3.2 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-516.3.3 :EXECute , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-516.3.4 :MALLocate ,(|DEFault) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-516.3.5 :NUMBer ,{,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-516.3.6 :STATe ,(RUN|PAUSe|STOP|CONTinue) . . . . . . . . . . . . . . . . . . . . . . . . . 16-516.3.7 :STRing ,{,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-616.3.8 :WAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-6Chapter 17 ROUTe Subsystem17.1 :CLOSe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-117.1.1 :STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-217.2 :OPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-217.2.1 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-217.3 :SCAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-217.4 :PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.4.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.4.2 [:DEFine] , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.4.3 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.4.3.1 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.4.3.2 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.5 :MODule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-317.5.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-417.5.2 [:DEFine] , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-417.5.3 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-417.5.3.1 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-417.5.3.2 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-417.6 TERMinals FRONt | REAR | BOTH | NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-4Chapter 18 SENSe Subsystem18.1 AM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.1.1 [:DEPTh] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.1.1.1 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.1.1.1.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.1.1.1.2 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.1.1.1.3 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.1.2 :TYPE LINear|LOGarithmic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-318.2 AVERage Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5xxii


1997 SCPI Comm<strong>and</strong> Reference18.2.1 A typical device action for SENS:AVERage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-518.2.2 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-618.2.2.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-618.2.3 [:STATE] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-618.2.4 :TCONtrol EXPonential | MOVing | NORMal | REPeat . . . . . . . . . . . . . . . . . . . . . . . . . 18-618.2.5 :TYPE COMPlex | ENVelope | MAXimum | MINimum | RMS | SCALar . . . . . . . . . . . 18-718.3 BANDwidth|BWIDth Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-918.3.1 [:RESolution] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-918.3.1.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-918.3.1.2 :RATio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-918.3.1.3 :TRACk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-918.3.2 :VIDeo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-918.3.2.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1018.3.2.2 :RATio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1018.4 CONDition Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1118.4.1 :LEVel | TTL ECL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1118.5 CORRection Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1218.5.1 :COLLect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1318.5.1.1 [:ACQuire] STANdard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1318.5.1.2 :METHod TPORt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1318.5.1.3 :SAVE [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1318.5.2 :CSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1418.5.2.1 [:SELect] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1418.5.2.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1418.5.3 :EDELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1418.5.3.1 :DISTance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1418.5.3.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.3.3 [:TIME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.4 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.4.1 [:INPut]|:OUTPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.4.1.1 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.4.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.5 :LOSS|:GAIN|:SLOPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1518.5.5.1 [:INPut]|:OUTPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1618.5.5.1.1 :AUTO ON|OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1618.5.5.1.2 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1618.5.5.1.3 :PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1618.5.5.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1718.5.6 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1718.5.6.1 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1718.5.6.2 :PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1718.5.6.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1718.5.7 :RVELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1718.5.7.1 :COAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1818.5.7.2 :MEDium COAX|WAVeguide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-18xxiii


1997 SCPI Comm<strong>and</strong> Reference18.5.7.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1818.5.7.4 :WAVeguide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1818.5.7.4.1 :FCUToff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1818.5.8 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1818.6 CURRent Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1918.6.1 :AC|[:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1918.6.1.1 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1918.6.1.2 :NPLCycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.3 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.3.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.4 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.4.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.4.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.4.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.4.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2018.6.1.5 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.1 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.2 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.3 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.3.1 :DIRection UP|DOWN|EITHer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.3.2 :LLIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.3.3 :ULIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2118.6.1.5.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2218.6.1.5.5 :PTPeak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2218.6.1.6 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2218.6.1.6.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2218.6.1.7 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2218.6.1.7.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2218.6.2 :DETector INTernal | EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2318.7 DETector Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2418.7.1 :BANDwidth | BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2418.7.2 [:FUNCtion] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2418.7.2.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2518.7.3 :SHAPe LINear|LOGarithmic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2518.8 FILTer Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2618.8.1 [:LPASs] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2618.8.1.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2618.8.1.2 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2618.8.2 :HPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2618.8.2.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.2.2 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.3 :DEMPhasis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.3.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.3.2 :TCONstant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.4 :CCITt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-27xxiv


1997 SCPI Comm<strong>and</strong> Reference18.8.4.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.5 :CMESsage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.5.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2718.8.6 :CCIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2818.8.6.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2818.8.7 :CARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2818.8.7.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2818.8.8 :AWEighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2818.8.8.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2818.9 FM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2918.9.1 [:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2918.9.1.1 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2918.9.1.1.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2918.9.1.1.2 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2918.9.1.1.3 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2918.10 FREQuency Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3018.10.1 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3018.10.2 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3018.10.3 [:CW|:FIXed] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3118.10.3.1 :AFC |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3118.10.3.2 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3118.10.4 :MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3118.10.5 :MODE CW|FIXed|SWEep|LIST|SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3118.10.6 :MULTiplier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3218.10.7 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3218.10.8 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3218.10.8.1 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3218.10.8.2 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3218.10.8.3 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3218.10.9 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3318.10.9.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3318.10.10 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3318.10.10.1 :HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3318.10.10.2 :LINK CENTer|STARt|STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3318.10.10.3 :FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3318.10.11 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3418.10.12 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3418.11 FUNCtion & DATA Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3518.11.1 DATA? [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3518.11.1.1 SENSe s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3518.11.1.2 :PREamble? [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3618.11.2 :FUNCtion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3618.11.2.1 :CONCurrent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3618.11.2.2 :OFF {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3718.11.2.2.1 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-37xxv


1997 SCPI Comm<strong>and</strong> Reference18.11.2.2.2 :COUNt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3718.11.2.3 [:ON] {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3718.11.2.3.1 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3818.11.2.3.2 :COUNt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3818.11.2.4 :STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3818.11.2.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3818.11.2.6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199118.11.2.6.1 [XNONe:] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4018.11.2.6.2 XTIMe: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4018.11.2.6.3 XFRequency: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4018.11.2.6.4 XPOWer: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4018.11.2.6.5 XVOLtage: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4018.11.2.6.6 XCURrent: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4018.11.2.7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4118.11.2.8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4218.11.2.8.1 AM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.1.1 [:DEPTh] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.1.2 :DISTortion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.1.3 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.1.4 :SNDRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.1.5 :SNR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.1.6 :THD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4318.11.2.8.2 CONDition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.3 CURRent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.3.1 [:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.3.2 :AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4 FM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4.1 :[DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4.2 :DISTortion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4.3 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4.4 :SNDRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4.5 :SNR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.4.6 :THD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.5 FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4418.11.2.8.6 FRESistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.7 PERiod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.8 PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9 PM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9.1 [:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9.2 :DISTortion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9.3 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9.4 :SNDRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9.5 :SNR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.9.6 :THD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4518.11.2.8.10 POWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-45xxvi


1997 SCPI Comm<strong>and</strong> Reference18.11.2.8.10.1 :AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.2 :ACHannel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.3 :COHerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.4 :CROSs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.5 [:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.6 :DISTortion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.7 :PSDensity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.8 :S11|:S12|:S22|:S21 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4618.11.2.8.10.9 :SNDRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.10.10 :SNR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.10.11 :THD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.11 PULM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.12 RESistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.13 SSB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.14 TINTerval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.15 TOTalize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.16 VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4718.11.2.8.16.1 :AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4818.11.2.8.16.2 :CDFunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4818.11.2.8.16.3 [:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4818.11.2.8.16.4 :HISTogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4818.11.2.8.16.5 :PDFunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4818.12 LIST Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4918.12.1 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4918.12.2 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4918.12.3 :DWELl {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4918.12.3.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4918.12.4 :FREQuency {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5018.12.4.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5018.12.5 :SEQuence {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5018.12.5.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5018.12.5.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5018.13 MIXer Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5118.13.1 :BIAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5118.13.1.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5118.13.1.2 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5118.13.2 :HARMonic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5118.13.2.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5118.13.3 :LOSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5218.13.3.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5218.14 PM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5318.14.1 [:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5318.14.1.1 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5318.14.1.1.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5318.14.1.1.2 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-53xxvii


1997 SCPI Comm<strong>and</strong> Reference18.14.1.1.3 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5318.15 POWer Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5418.15.1 :ACHannel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5418.15.1.1 :SPACing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5418.15.1.1.1 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.1.1.1.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.1.1.2 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.2 :AC|[:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.2.1 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.2.2 :NPLCycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.2.3 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5518.15.2.3.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.4 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.4.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.4.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.4.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.4.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.5 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.5.1 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5618.15.2.5.2 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.5.3 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.5.3.1 :DIRection UP|DOWN|EITHer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.5.3.2 :LLIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.5.3.3 :ULIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.5.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.5.5 :PTPeak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5718.15.2.6 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5818.15.2.6.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5818.15.2.7 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5818.15.2.7.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5818.15.3 :DETector INTernal | EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5818.16 RESistance|FRESistance Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5918.16.1 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5918.16.2 :NPLCycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5918.16.3 :OCOMpensated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5918.16.4 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.4.1 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.4.2 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.4.3 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.4.3.1 :DIRection UP|DOWN|EITHer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.4.3.2 :LLIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.4.3.3 :ULIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6018.16.5 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6118.16.5.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6118.16.6 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-61xxviii


1997 SCPI Comm<strong>and</strong> Reference18.16.6.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6118.17 ROSCillator Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6218.17.1 [:INTernal] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6218.17.1.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6218.17.2 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6218.17.2.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6218.17.3 :SOURce INTernal|EXTernal|NONE|CLK10|CLK100 . . . . . . . . . . . . . . . . . . . . . . . . . 18-6218.17.3.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6318.18 SMOothing Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6418.18.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6418.18.2 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6418.18.3 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6418.19 SSB Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6518.19.1 :TYPE USB|LSB|A1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6518.20 SWEep Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6618.20.1 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6718.20.2 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6718.20.3 :DWELl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6718.20.3.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6818.20.4 :GENeration STEPped|ANALog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6818.20.5 :MODE AUTO|MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6818.20.6 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6818.20.6.1 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6818.20.6.2 :TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6818.20.7 :OREFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6918.20.7.1 :LOCation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6918.20.7.2 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6918.20.8 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6918.20.9 :REALtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7018.20.9.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7018.20.10 :SPACing LINear|LOGarithmic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7018.20.11 :STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7118.20.12 :TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7118.20.12.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7118.20.12.2 :LLIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7218.20.13 :TINTerval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7218.21 VOLTage Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7318.21.1 :AC|[:DC] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7318.21.1.1 :APERture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7318.21.1.2 :NPLCycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.3 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.3.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.4 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.4.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.4.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-74xxix


1997 SCPI Comm<strong>and</strong> Reference18.21.1.4.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.4.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7418.21.1.5 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.1 [:UPPer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.2 :LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.3 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.3.1 :DIRection UP|DOWN|EITHer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.3.2 :LLIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.3.3 :ULIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7518.21.1.5.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7618.21.1.5.5 :PTPeak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7618.21.1.6 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7618.21.1.6.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7618.21.1.7 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7618.21.1.7.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7618.21.2 :DETector INTernal | EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7718.22 WINDow Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7818.22.1 [:TYPE] RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7818.22.1.1 :KBESsel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7818.22.1.2 :EXPonential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7818.22.1.3 :FORCe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-78Chapter 19 SOURce Subsystem19.1 AM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-519.1.1 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-519.1.2 [:DEPTh] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-519.1.3 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-519.1.3.1 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-619.1.3.2 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-619.1.3.3 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-619.1.4 :INTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-619.1.4.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-619.1.5 :MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-619.1.6 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-719.1.7 :SENSitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-719.1.8 :SOURce EXTernal|INTernal{,EXTernal|,INTernal} . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-719.1.9 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-719.1.10 :TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-819.2 COMBine Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-919.2.1 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-919.3 CORRection Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1019.3.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1019.3.2 :COLLect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-11xxx


1997 SCPI Comm<strong>and</strong> Reference19.3.2.1 [:ACQUire] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1119.3.2.2 :METHod PMETer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1119.3.2.3 :SAVE [] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1119.3.3 :CSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1119.3.3.1 [:SELect] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1119.3.3.2 STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1119.3.4 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1219.3.4.1 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1219.3.4.2 :PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1219.3.4.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1219.3.5 :LOSS|:GAIN|:SLOPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1219.3.5.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.5.2 [:OUTPut] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.5.2.1 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.5.2.2 :PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.6 :EDELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.6.1 [:TIME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.6.2 :DISTance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1319.3.6.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.3.7 :RVELocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.3.7.1 :MEDIum COAX|WAVeguide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.3.7.2 :COAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.3.7.3 :WAVeguide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.3.7.3.1 :FCUToff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.3.7.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1419.4 CURRent Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1619.4.1 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1719.4.1.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1719.4.2 :ALC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1719.4.2.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1719.4.2.2 :SEARch |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1719.4.2.3 :SOURce INTernal|DIODe|PMETer|MMHead . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1819.4.2.4 :BANDwidth|:BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1819.4.2.4.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1819.4.3 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1819.4.4 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1819.4.4.1 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1819.4.4.1.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1919.4.4.1.1.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1919.4.4.1.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1919.4.4.1.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1919.4.4.1.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1919.4.4.2 :TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2019.4.4.2.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2019.4.4.2.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-20xxxi


1997 SCPI Comm<strong>and</strong> Reference19.4.4.2.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2019.4.4.2.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2019.4.5 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2019.4.5.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2019.4.5.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2119.4.5.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2119.4.5.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2119.4.5.5 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2119.4.6 :MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2119.4.7 :MODE FIXed|SWEep|LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2119.4.8 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.8.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.8.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.8.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.8.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.9 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.9.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.10 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2219.4.10.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.11 :SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.12 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.12.1 :FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.12.2 :HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.12.3 :LINK CENTer|STARt|STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.13 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2319.4.14 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2419.5 DM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2519.5.1 :FORMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.3 :SOURce EXTernal|PRBS|CALibrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.4 :FILTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.4.1 [:SOURce] INTernal|EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.4.2 :ICORrection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.4.3 :QCORrection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2619.5.5 :IQRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.5.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.5.2 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.6 :LEAKage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.6.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.6.2 [:MAGNitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.6.3 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.7 :QUADrature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2719.5.7.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.7.2 :ANGLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.8 :COUPling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-28xxxii


1997 SCPI Comm<strong>and</strong> Reference19.5.8.1 [:ALL] AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.8.2 :DATA AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.8.3 :CLOCk AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.9 :THReshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.9.1 [:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.9.2 :DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.9.3 :CLOCk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2819.5.10 :DMODe SERial|PARallel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.11 :FRAMe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.11.1 :SOURce INTernal|EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.12 :POLarity [:ALL] NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.12.1 :I NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.12.2 :Q NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.12.3 :ICLock NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.12.4 :QCLock NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.13 :CLOCk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2919.5.13.1 :SOURce NONE|INTernal|EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3019.6 FM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3119.6.1 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3119.6.2 [:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3119.6.3 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3119.6.3.1 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3219.6.3.2 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3219.6.3.3 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3219.6.4 :INTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3219.6.4.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3219.6.5 :MODE LOCKed|UNLocked . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3219.6.6 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3319.6.7 :SENSitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3319.6.8 :SOURce EXTernal|INTernal{,EXTernal|,INTernal} . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3319.6.9 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3319.7 FREQuency Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3419.7.1 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3419.7.2 [:CW|:FIXed] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3419.7.2.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3419.7.3 :MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3519.7.4 :MODE CW|FIXed|SWEep|LIST|SENSe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3519.7.5 :MULTiplier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3519.7.6 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3519.7.7 :RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3619.7.7.1 AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3619.7.8 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3619.7.8.1 :FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3619.7.8.2 :HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3619.7.8.3 :LINK CENTer|STARt|STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-36xxxiii


1997 SCPI Comm<strong>and</strong> Reference19.7.9 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3719.7.10 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3719.8 FUNCtion Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3819.8.1 [:SHAPe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3819.8.2 :MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3819.9 LIST Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3919.9.1 :AM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4019.9.1.1 :DEPTh {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4019.9.1.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4019.9.2 :APRobe {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4019.9.2.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4019.9.3 :CONCurrent {,} . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4019.9.3.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.3.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4 :CONTrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4.1 :APOWer {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4.2 :BLOWer {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4.2.1 :POINTs? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4.3 :COMPressor {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.4.3.1 :POINTs? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.5 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.6 :CURRent {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.6.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4119.9.7 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.8 :DWELl {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.8.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.9 :FREQuency {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.9.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.10 :GENeration DSEQuence|SEQuence|DCONcurrent|CONCurrent . . . . . . . . . . . . . . . . 19-4219.9.11 :PULM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.11.1 :STATe {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.11.1.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4219.9.12 :POWer {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.12.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.13 :RESistance {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.13.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.14 :RTIMe {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.14.1 :POINTs? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.15 :SEQuence {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.15.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.15.2 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.16 :TEMPerature {,} . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.16.1 :POINTs? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4319.9.17 :VOLTage {,} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-44xxxiv


1997 SCPI Comm<strong>and</strong> Reference19.9.17.1 :POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4419.10 MARKer Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4519.10.1 :AMPLitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4519.10.2 :AOFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4519.10.3 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4519.10.4 :MODE FREQuency|POSition|DELTa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4519.10.5 :POINt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4519.10.6 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4619.10.7 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4619.11 PHASe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4719.11.1 [:ADJust] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4719.11.1.1 :STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4719.11.2 :SOURce INTernal|EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4719.11.3 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4719.12 PM Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4819.12.1 [:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4819.12.2 :SENSitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4819.12.3 :MODE LOCKed|UNLocked . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4819.12.4 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4919.12.5 :SOURce EXTernal|INTernal{,EXTernal|,INTernal} . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4919.12.6 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4919.12.7 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4919.12.8 :INTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5019.12.8.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5019.12.9 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5019.12.9.1 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5019.12.9.2 :COUPling AC|DC|GROund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5019.12.9.3 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5019.13 POWer Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5119.13.1 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5219.13.1.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5219.13.2 :ALC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5219.13.2.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5219.13.2.2 :SEARch |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5219.13.2.3 :SOURce INTernal|DIODe|PMETer|MMHead . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5319.13.2.4 :BANDwidth|:BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5319.13.2.4.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5319.13.3 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5319.13.4 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5319.13.4.1 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5319.13.4.1.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5419.13.4.1.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5419.13.4.1.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5419.13.4.1.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5419.13.4.2 :TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-54xxxv


1997 SCPI Comm<strong>and</strong> Reference19.13.4.2.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.4.2.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.4.2.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.4.2.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.5 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.5.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.5.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5519.13.5.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.5.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.5.5 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.6 :MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.7 :MODE FIXed|SWEep|LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.8 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.8.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5619.13.8.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.8.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.8.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.9 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.9.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.10 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.10.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.11 :SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5719.13.12 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5819.13.12.1 :HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5819.13.12.2 :LINK CENTer|STARt|STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5819.13.12.3 :FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5819.13.13 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5819.13.14 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5819.14 PULse Modulation Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5919.14.1 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5919.14.1.1 :HYSTeresis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5919.14.1.2 :IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5919.14.1.3 :LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5919.14.1.4 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6019.14.2 :INTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6019.14.2.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6019.14.3 MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6019.14.4 :POLarity NORMal|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6019.14.5 :SOURce EXTernal|INTernal{,EXTernal|,INTernal} . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6119.14.6 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6119.15 PULSe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6219.15.1 :PERiod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6219.15.2 :WIDTh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6219.15.3 :DCYCle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6219.15.4 :HOLD WIDTh|DCYCle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-62xxxvi


1997 SCPI Comm<strong>and</strong> Reference19.15.5 :DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.6 :DOUBle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.6.1 [:STATE] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.6.2 :DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.7 :TRANsition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.7.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.7.2 [:LEADing] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6319.15.7.3 :TRAiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6419.15.7.3.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6419.15.8 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6419.15.9 :POLarity NORMal|COMPlement|INVerted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6419.16 RESistance Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6519.16.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.1 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.1.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.1.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.1.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.1.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.2 :TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6619.16.1.2.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.1.2.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.1.2.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.1.2.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.2 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.2.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.2.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.2.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6719.16.2.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.3 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.3.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.3.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.3.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.3.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.4 :SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.5 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.6 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6819.16.6.1 :HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6919.16.6.2 :LINK CENTer|STARt|STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6919.16.6.3 :FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6919.16.7 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6919.16.8 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6919.16.9 :MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6919.16.10 :MODE FIXed|SWEep|LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7019.16.11 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7019.16.11.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-70xxxvii


1997 SCPI Comm<strong>and</strong> Reference19.16.12 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7019.16.12.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7019.17 ROSCillator Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.17.1 [:INTernal] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.17.1.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.17.2 :EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.17.2.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.17.3 :SOURce INTernal|EXTernal|NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.17.3.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7119.18 SWEep Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7319.18.1 :TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7319.18.1.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7319.18.1.2 :LLIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7319.18.2 :DWELl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7319.18.2.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7419.18.3 :DIRection UP|DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7419.18.4 :MODE AUTO|MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7419.18.5 :SPACing LINear|LOGarithmic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7419.18.6 :GENeration STEPped|ANALog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7419.18.7 :STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7519.18.8 :POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7519.18.9 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7519.19 TEMPeratureSubsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7619.19.1 :APRobe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7619.19.2 :DWELl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7619.19.3 :LCONstants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7719.19.3.1 :DERivative . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7719.19.3.2 [:GAIN] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7719.19.3.3 :INTegral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7719.19.4 :MODE FIXed|LIST|PROGram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7819.19.5 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7819.19.5.1 [:HIGH] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7819.19.5.1.1 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7819.19.5.1.2 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7819.19.5.1.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.1.4 :TOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.1.5 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.2 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.2.1 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.2.2 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.2.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7919.19.5.2.4 :TOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8019.19.5.2.5 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8019.19.6 :RTIMe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8019.19.7 [:SPOint] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-80xxxviii


1997 SCPI Comm<strong>and</strong> Reference19.20 VOLTage Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8119.20.1 :ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8219.20.1.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8219.20.2 :ALC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8219.20.2.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8219.20.2.2 :SEARch |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8219.20.2.3 :SOURce INTernal|DIODe|PMETer|MMHead . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8319.20.2.4 :BANDwidth|:BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8319.20.2.4.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8319.20.3 :CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8319.20.4 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8319.20.4.1 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8319.20.4.1.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8419.20.4.1.1.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8419.20.4.1.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8419.20.4.1.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8419.20.4.1.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8419.20.4.2 :TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.4.2.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.4.2.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.4.2.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.4.2.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.5 :LIMit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.5.1 [:AMPLitude] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8519.20.5.2 :OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8619.20.5.3 :HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8619.20.5.4 :LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8619.20.5.5 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8619.20.6 :MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8619.20.7 :MODE FIXed|SWEep|LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8619.20.8 :PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.8.1 [:LEVel] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.8.2 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.8.3 :TRIPped? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.8.4 :CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.9 :RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.9.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.10 :REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8719.20.10.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8819.20.11 :SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8819.20.12 :SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8819.20.12.1 :HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8819.20.12.2 :LINK CENTer|STARt|STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8819.20.12.3 :FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-8819.20.13 :STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-88xxxix


1997 SCPI Comm<strong>and</strong> Reference19.20.14 :STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-89Chapter 20 STATus Subsystem20.1 [:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-320.2 :CONDition? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-320.3 :ENABle | . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-320.4 :PTRansition | . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-320.5 :NTRansition | . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-420.6 :MAP , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-420.7 :PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-4Chapter 21 SYSTem Subsystem21.1 :ALTernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-321.1.1 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-321.2 :BEEPer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-321.2.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-321.2.2 [:IMMediate][[,[,]]] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-321.2.3 :STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-321.2.4 :TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.2.5 :VOLume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.3 :CAPability? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.4 :COMMunicate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.4.1 :CENTronics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.4.1.1 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.4.2 :GPIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.4.2.1 :RDEVice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-421.4.2.1.1 :ADDRess [,] . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.2.1.2 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.2.2 [:SELF] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.2.2.1 :ADDRess [,] . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.3 :SERial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.3.1 :CONTrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.3.1.1 :DTR ON|OFF|STANdard|IBFull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-521.4.3.1.2 :RTS ON|OFF|STANdard|IBFull|RFR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-621.4.3.2 :FEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-721.4.3.3 [:RECeive] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-721.4.3.3.1 :BAUD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-721.4.3.3.2 :BITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-721.4.3.3.3 :PACE XON|ACK|NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-721.4.3.3.3.1 :THReshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-721.4.3.3.4 :PARity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-821.4.3.3.4.1 :CHECk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-821.4.3.3.4.2 [:TYPE] EVEN|ODD|ZERO|ONE|NONE|IGNore . . . . . . . . . . . . . . . . . . . . . 21-821.4.3.3.5 :SBITs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-8xl


1997 SCPI Comm<strong>and</strong> Reference21.4.3.4 :TRANsmit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-821.4.3.4.1 :AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-821.4.3.4.2 :BAUD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-821.4.3.4.3 :BITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.4.3.4.4 :DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.4.3.4.5 :PACE XON|ACK|NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.4.3.4.6 :PARity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.4.3.4.6.1 [:TYPE] EVEN|ODD|ZERO|ONE|NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.4.3.4.7 :SBITs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.5 :CPON |ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-921.6 :CTYPe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1021.7 :DATE ,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1021.8 :ERRor Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1021.8.1 The Error/Event Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1121.8.2 Error/Event numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1121.8.3 No Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.4 ALL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.5 CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.5.1 ALL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.5.2 [NEXT]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.6 COUNt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.7 [NEXT]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1221.8.8 Comm<strong>and</strong> Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1321.8.9 Execution Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1721.8.10 Device-Specific Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2221.8.11 Query Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2421.8.12 Power On Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2421.8.13 User Request Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2521.8.14 Request Control Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2521.8.15 Operation Complete Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2621.9 :HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2621.9.1 :HEADers? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2721.9.2 :SYNTax? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2821.10 :KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2921.10.1 :CATalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3021.10.2 :DEFine ,[,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3021.10.3 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3021.11 :KLOCk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3021.12 :LANGuage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3021.13 :LFRequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3121.13.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3121.14 :PASSword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3121.14.1 :CDISable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3221.14.2 [:CENable] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3221.14.2.1 :STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-32xli


1997 SCPI Comm<strong>and</strong> Reference21.14.3 :NEW , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3221.15 :PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3221.16 :SECurity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3221.16.1 :IMMediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3221.16.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3321.17 :SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3321.18 :TIME ,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3421.19 :TZONe [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3421.20 :VERSion? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-35Chapter 22 TEST SubsystemChapter 23 TRACe | DATA23.1 :CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-223.2 :COPY , ( | ) . . . . . . . . . . . . . . . . . . . . . . . . . . 23-223.3 [:DATA] ,(||({,})) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-223.3.1 :LINE ,,,, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-323.3.2 :PREamble? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-323.3.3 :VALue ,, . . . . . . . . . . . . . . . . . . . . . . 23-323.4 :DEFine [,(|)] . . . . . . . . . . . . . . . . . . . . . . . . 23-323.5 :DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-423.5.1 [:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-423.5.2 :ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-423.6 :FEED , ( | NONE ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-423.6.1 :CONTrol , ALWays | OCONdition | NEXT | NEVer . . . . . . . . . . . . . . . 23-423.6.2 :OCONdition , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-523.7 :FREE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-523.8 :POINts [,] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-523.8.1 :AUTO ,(|ONCE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-5Chapter 24 TRIGger Subsystem24.1 ARM-TRIGger Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-124.2 Model Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-224.2.1 IDLE State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-224.2.2 Initiated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-224.2.3 Event Detection Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-324.3 Sequence Event Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-424.4 Exp<strong>and</strong>ed Capability Trigger Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-524.4.1 LAYer Nomenclature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-624.4.2 St<strong>and</strong>ard SEQuences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-724.4.3 Subservient Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-724.5 ABORt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-12xlii


1997 SCPI Comm<strong>and</strong> Reference24.6 ARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1224.6.1 [:SEQuence] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1224.6.1.1 :DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1224.6.1.1.1 MGRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1324.6.1.2 [:LAYer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1424.6.1.2.1 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1424.6.1.2.2 :COUPling AC|DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1424.6.1.2.3 :DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1424.6.1.2.3.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1424.6.1.2.4 :ECL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1524.6.1.2.5 :ECOunt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1524.6.1.2.6 :FILTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1524.6.1.2.6.1 :HPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1524.6.1.2.6.2 [:LPASs] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1524.6.1.2.7 :HYSTeresis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1624.6.1.2.8 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1624.6.1.2.9 :LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1624.6.1.2.9.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1624.6.1.2.10 :LINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1724.6.1.2.11 PROTocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1724.6.1.2.11.1 VXI SYNChronous|SSYNchronous|ASYNchronous . . . . . . . . . . . . . . . . . 24-1724.6.1.2.12 :SIGNal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1724.6.1.2.13 :SLOPe POSitive|NEGative|EITHer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1824.6.1.2.14 :SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1824.6.1.2.15 :TIMer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1924.6.1.2.16 :TTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1924.6.1.2.17 :TYPE EDGE | VIDeo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1924.6.1.2.18 :VIDeo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1924.6.1.2.18.1 :FIELd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1924.6.1.2.18.2 :FORMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2024.6.1.2.18.3 :LINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2024.6.1.2.18.4 :SSIGnal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2024.7 INITiate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2124.7.1 :CONTinuous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2124.7.1.1 [:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2224.7.1.2 :NAME , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2224.7.1.3 :SEQuence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2224.7.2 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2224.7.2.1 [:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2224.7.2.2 :NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2324.7.2.3 :SEQuence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2324.7.3 :POFLag INCLude | EXCLude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2324.8 TRIGger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2324.8.1 [:SEQuence] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2324.8.1.1 :ATRigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-23xliii


1997 SCPI Comm<strong>and</strong> Reference24.8.1.1.1 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2424.8.1.2 :COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2424.8.1.3 :COUPling AC|DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2424.8.1.4 : DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2424.8.1.4.1 MGRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2524.8.1.5 :DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2524.8.1.5.1 :AUTO |ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.6 :ECL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.7 :ECOunt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.8 :FILTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.8.1 :HPASs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.8.1.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.8.1.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.8.2 [:LPASs] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2624.8.1.8.2.1 :FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2724.8.1.8.2.2 [:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2724.8.1.9 :HOLDoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2724.8.1.10 :HYSTeresis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2724.8.1.11 [:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2724.8.1.12 :LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2824.8.1.12.1 :AUTO | ONCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2824.8.1.13 :LINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2824.8.1.14 :PROTocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2824.8.1.14.1 :VXI SYNChronous|SSYNchronous|ASYNchronous . . . . . . . . . . . . . . . . . . . . 24-2924.8.1.15 :SIGNal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2924.8.1.16 :SLOPe POSitive|NEGative|EITHer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2924.8.1.17 :SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2924.8.1.18 :TIMer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3024.8.1.19 :TTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3024.8.1.20 :TYPE EDGE | VIDeo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21 :VIDeo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21.1 :FIELd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21.1.1 [:NUMBer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21.1.2 :SELect ODD | EVEN | ALL | NUMBer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21.2 :FORMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21.2.1 :LPFRame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3124.8.1.21.3 :LINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3224.8.1.21.3.1 [:NUMBer] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3224.8.1.21.3.2 :SELect ALL | NUMBer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3224.8.1.21.4 :SSIGnal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3224.8.1.21.4.1 :POLarity POSitive | NEGative . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-32Chapter 25 UNIT Subsystem25.1 :ANGLe DEG|RAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-1xliv


1997 SCPI Comm<strong>and</strong> Reference25.2 :CURRent, :POWer, <strong>and</strong> :VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-125.3 :TEMPerature C|CEL|F|FAR|K . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-225.4 :TIME HOUR|MINute|SECond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-2Chapter 26 VXI Subsystem26.1 :CONFigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-326.1.1 :DNUMber? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-326.1.2 :HIERarchy? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-326.1.2.1 :ALL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-426.1.2.2 :VERBose? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-426.1.2.2.1 :ALL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-426.1.3 :INFormation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-426.1.3.1 :ALL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-626.1.3.2 :VERBose? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-626.1.3.3 :ALL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-626.1.4 :LADDress? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-626.1.5 :NUMBer? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-726.2 REGister . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-726.2.1 :READ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-726.2.1.1 :VERBose? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-826.2.2 :WRITe ( | ), . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-826.3 :RESet? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-826.3.1 :VERBose? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.4 :SELect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.5 :WSPRotocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.5.1 :COMM<strong>and</strong> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.5.1.1 [:ANY] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.5.1.2 :AHLine , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.5.1.3 :AILine , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-926.5.1.4 :AMControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.5 :ANO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.6 :BAVailable , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.7 :BNO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.8 :BRQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.9 :CEVent , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.10 :CLR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1026.5.1.11 :CLOCk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.12 :CRESponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.13 :ENO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.14 :GDEVice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.15 :ICOMm<strong>and</strong>er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.16 :RDEVice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.17 :RHANdlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1126.5.1.18 :RHLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-12xlv


1997 SCPI Comm<strong>and</strong> Reference26.5.1.19 :RILine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1226.5.1.20 :RINTerrupter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1226.5.1.21 :RMODid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1226.5.1.22 :RPERror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1226.5.1.23 :RPRotocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1226.5.1.24 :RSTB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1226.5.1.25 :RSARea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.1.26 :SLModid , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.1.27 :SLOCk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.1.28 :SUModid , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.1.29 :TRIGger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.2 :MESSage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.2.1 :RECeive? | . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.2.2 :SEND [,(END|NEND)] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1326.5.3 :QUERy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.1 [:ANY]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.2 :AHLine? , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.3 :AILine? , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.4 :AMControl? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.5 :ANO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.6 :BNO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1426.5.3.7 :BRQ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.8 :CEVent? , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.9 :CRESponse? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.10 :ENO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.11 :RDEVice? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.12 :RHANdlers? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.13 :RHLine? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1526.5.3.14 :RILine? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.15 :RINTerrupter? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.16 :RMODid? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.17 :RPERror? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.18 :RPRotocol? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.19 :RSTB? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.20 :RSARea? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1626.5.3.21 :SLModid? , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1726.5.3.22 :SUModid? , . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-1726.5.4 :RESPonse? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-17xlvi


1997 SCPI Comm<strong>and</strong> Reference1 Introduction1.1 RequirementsThis volume of the SCPI st<strong>and</strong>ard, “Comm<strong>and</strong> Reference,” shall be used in conjunction withthe “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>” volume.1.2 OrganizationThe first chapter in this volume of the SCPI st<strong>and</strong>ard describes the SCPI model that is usedin defining the functional areas of SCPI. The subsequent chapters describe each functionalarea, known as a subsystem, <strong>and</strong> are in alphabetic order by subsystem name.1234567891011121314151617181920212223242526Introduction 1-1


1997 SCPI Comm<strong>and</strong> Reference11-2 Introduction


1997 SCPI Comm<strong>and</strong> Reference2 Instrument ModelA model is used within SCPI as a means of achieving compatibility. SCPI concerns itselfwith three types of compatibility. The first form of compatibility is called verticalcompatibility. Vertical compatibility is where two instruments of the same type haveidentical controls (e.g. two oscilloscopes both have the same controls for their timebases,triggers, <strong>and</strong> voltage settings).The second form of compatibility is called horizontal compatibility. Horizontal compatibilityis where two instruments can make the same measurement, regardless of the actualmeasurement techniques used. To be horizontally compatible, both instruments would usethe same comm<strong>and</strong>s to make this measurement. For example, both an oscilloscope <strong>and</strong> acounter can perform a risetime measurement on a pulse. The two instruments are said to behorizontally compatible if the same comm<strong>and</strong> is used in both instruments.The third form of compatibility is called functional compatibility. Functional compatibility iswhere two instruments which perform the same function do so with the same comm<strong>and</strong>s. Forexample, a spectrum analyzer <strong>and</strong> an rf source may both sweep in frequency. If the samefrequency <strong>and</strong> sweep comm<strong>and</strong>s are used in both instruments, they would be functionallycompatible in this area.Figure 2-1 Model of a Programmable InstrumentFigure 2-1, “Model of a Programmable Instrument,” represents the way in which instrumentfunctionality is viewed <strong>and</strong> categorized by SCPI. The purpose of this categorization is toprovide organization <strong>and</strong> consistency between the various comm<strong>and</strong>s available in SCPI forall the different types of instrumentation. The model defines where elements of the languagemust be assigned in the SCPI hierarchy. Major areas of signal functionality are shownbroken into blocks; each of these blocks are major comm<strong>and</strong> subtrees in SCPI. In thisvolume of the SCPI st<strong>and</strong>ard, each subtree is discussed in its own chapter.The model describes the flow of measurement <strong>and</strong> applied signal data through theinstrument. The administrative data flows associated with comm<strong>and</strong>s, queries, performingcalibrations, mass memory accesses, <strong>and</strong> other related functions are not included in thismodel. The model does not define how an instrument h<strong>and</strong>les or formats data internally. In1234567891011121314151617181920212223242526Instrument Model 2-1


1997 SCPI Comm<strong>and</strong> Reference2Figure 2-1, data flow is represented by solid arrows <strong>and</strong> control flow is represented bydashed arrows.Individual instruments shall only implement those blocks which apply to theirimplementation. For example, a voltmeter which has a single input <strong>and</strong> no user addressablememory might include the measurement function, TRIGger, <strong>and</strong> FORMat blocks.Figure 2-2 Simplified Model for a Sensor InstrumentSimilarly, a non-triggered, single output power supply might include the signal generation<strong>and</strong> FORMat blocks.Figure 2-3 Simplified Model for a Source InstrumentAn instrument with a particular block is not always required to implement a subtree or anycomm<strong>and</strong>s associated with that block. This occurs when the block exists in a fixedconfiguration that does not conflict with related comm<strong>and</strong>s, <strong>and</strong> that have the *RST defaultvalues. For example, an instrument might have a fixed TTL level external trigger, with noadjustable TRIGger parameters. In this case no part of the TRIGger subsystem need beimplemented. However, if trigger controls exist, those controls shall be implemented asdefined in the TRIGger subsystem.2.1 Signal RoutingThe purpose of the signal routing block is to control the routing of signals between aninstrument’s signal ports <strong>and</strong> its internal signal functionality. Signal routing also controls theconnection from signal port to signal port, where such capability exists. The comm<strong>and</strong>swhich control this block are described in the SCPI tree under the ROUTe subsystem. Theimplementation of this subsystem is optional for those instruments that have fixedconnections to the measurement function block or the signal generation block.2.1.1 Setting the Destination for Data Flow HP063eThe FEED model works well when the user is focused on setting the source for the data flowinto a block. Occasionally, the user’s focus in on the destination of data flow from a block.When this view is appropriate, a DESTination comm<strong>and</strong> is used.2-2 Instrument Model Signal Routing


1997 SCPI Comm<strong>and</strong> ReferenceDESTination is an event; it has no query form. The comm<strong>and</strong> sets one or more FEEDsettings to known values. Assume the subsystem where the DESTination comm<strong>and</strong> islocated could be accessed with a of . WhenDESTination is executed, any FEED comm<strong>and</strong> which is currently set to shall be set to “”. The FEED comm<strong>and</strong> under the 1subsystem shall be set to . Any subsystem which may appear in the shall contain a FEED comm<strong>and</strong>. An allowed value of the for 2that FEED comm<strong>and</strong> shall be .32.2 Measurement Function HP0The measurement function block converts a physical signal into an internal data form that is 4available for formatting into bus data. It may perform the additional tasks of signal5conditioning <strong>and</strong> post conversion calculation. The measurement function box is subdividedinto three distinct parts: INPut, SENSe, <strong>and</strong> CALCulate. These are shown as solid boxes in 6Figure 2-4, “Exp<strong>and</strong>ed Measurement Function Model.” The dotted boxes shown represent 7blocks from Figure 2-1, “Model of a Programmable Instrument.”891011121314Figure 2-4 Exp<strong>and</strong>ed Measurement Function Model1516The subdivisions INPut, SENSe, <strong>and</strong> CALCulate are not detailed in the “Model of a17Programmable Instrument” figure because at this lower level of division, functionality acrossdifferent instruments can no longer be considered horizontally compatible. For example, 18measuring the frequency of a signal is done in SENSe block on a counter, but is done in the19CALCulate block in a spectrum analyzer. The two instruments are considered compatiblesince they both can perform the function. However, the horizontal compatibility only occurs 20at the high level MEASurement comm<strong>and</strong>s.212.2.1 INPut22The purpose of the INPut block is to condition the incoming signal before it is converted intodata by the SENSe block. INPut block functions include filtering, biasing, frequency 23conversion (such as a mixer or prescaler function), <strong>and</strong> attenuation. The INPut block appears 24in the SCPI tree under the INPut subsystem. The implementation of this subsystem isoptional for those instruments that have no INPut block characteristics.2526Instrument Model Measurement Function 2-3


1997 SCPI Comm<strong>and</strong> Reference22.2.2 SENSeThe purpose of the SENSe block is to convert signal(s) into internal data that can bemanipulated by normal computer techniques. The comm<strong>and</strong>s associated with the SENSeblock control the various characteristics of the conversion process. Examples are range,resolution, gate time, normal mode rejection, etc. This block does not include anymathematical manipulation of the data after it has been converted.The SENSe comm<strong>and</strong>s appear in the SCPI tree under the SENSe subsystem. The SENSeblock is required for all sensor instruments, since the nature of a bus programmableinstrument implies a conversion from an electrical signal to a “number.” However, theSENSe subsystem contains a large number of subservient subsystems, subdividing thedifferent signal characteristics being sensed. An instrument is required to only implement theappropriate comm<strong>and</strong>s from those subservient subsystems that apply.2.2.3 CALCulateThe purpose of the CALCulate block is to convert or derive sensed data into a form moreuseful to the application. Typical calculations include converting units, <strong>and</strong> postprocessingcalculations (for example, calculation of rise time from a time domain waveform). TheCALCulate comm<strong>and</strong>s are described in the CALCulate subsystem.2.3 Signal GenerationThe signal generation block is responsible for the conversion of data into physical signals. Itmay perform additional tasks of preconversion calculation <strong>and</strong> signal conditioning. Thesignal generation box is subdivided into three distinct parts: CALCulate, SOURce, <strong>and</strong>OUTPut. These are shown as solid boxes in Figure 2-5, “Exp<strong>and</strong>ed Signal GenerationModel.” The dotted boxes shown represent blocks from Figure 2-1, “Model of aProgrammable Instrument.”Figure 2-5 Exp<strong>and</strong>ed Signal Generation ModelThe subdivisions CALCulate, SOURce, <strong>and</strong> OUTPut are not detailed in the “Model of aProgrammable Instrument,” because at this lower level of division, functionality acrossdifferent instruments can no longer be considered horizontally compatible.2.3.1 OUTPutThe purpose of the OUTPut block is to condition the outgoing signal after it has beengenerated. The OUTPut block functions include filtering, biasing, frequency conversion(such as a mixer function), <strong>and</strong> attenuation. The OUTPut block appears in the SCPI tree2-4 Instrument Model Signal Generation


1997 SCPI Comm<strong>and</strong> Referenceunder the OUTPut subsystem. As with the INPut block in sensor-type instruments, this blockappears in all source-type instruments, though the comm<strong>and</strong>s may not.2.3.2 SOURceThe purpose of the SOURce block is to generate a signal based on specified characteristics<strong>and</strong>/or supplied data. The comm<strong>and</strong>s associated with this block describe the characteristicsof the generated signal.The SOURce comm<strong>and</strong>s are described in the SOURce subsystem. The SOURce block isrequired for all source instruments. The SOURce subsystem contains a large number ofsubservient subsystems, sub-dividing the different signal characteristics being sourced. Aninstrument is only required to implement the appropriate comm<strong>and</strong>s from those subservientsubsystems that apply.123452.3.3 CALCulateThe purpose of the CALCulate block is to convert application data to account for anomaliesin generating a signal, such as correcting for external effects, converting units <strong>and</strong> changingdomains. The comm<strong>and</strong>s associated with the CALCulate block are defined in the CALCulatesubsystem.67892.4 TRIGger10The purpose of the TRIGger block is to provide an instrument with synchronizationcapability with external events. The TRIGger block is described in chapter 22, <strong>and</strong> appears 11in the SCPI tree as TRIGger, ARM, INITiate, <strong>and</strong> ABORt subsystems. Two models exist in 12the TRIGger block, one complex <strong>and</strong> the other simple. Both models may be reduced to alevel that corresponds to the sophistication of an instrument’s trigger capabilities.132.5 MEMory14The purpose of the MEMory block is to hold data inside the instrument. The memory may be 15implicit <strong>and</strong> inaccessible to the user (for example, internal calibration data), <strong>and</strong> may befixed (for example, current measurement data) or may be allocated <strong>and</strong> user-addressed. 16The allocation of memory appears in SCPI under the MEMory subsystem. The manipulation 17of memory is performed by comm<strong>and</strong>s throughout the SENSe, SOURce, FORMat, DISPlay, 18<strong>and</strong> other subsystems. While every programmable instrument contains memory, not all suchinstruments provide the user with explicit control of this memory. In such cases there is no 19requirement to implement the MEMory subsystem.2.6 FORMatThe purpose of the format block is to convert between data representations, especially on thedata that is transferred over the external interface. An example is conversion of internal dataformats to ASCII.20212223Formatting appears in SCPI under the FORMat subsystem. All instruments are required to24use the formats described in IEEE 488.2.2.7 Internal Routing 25TWIThe instrument model presented so far introduced the fundamental elements or blocks from 26which an instrument is constructed, <strong>and</strong> defined a simple or lamina arrangement of theconnections between those blocks, known as the “Lamina Model.” This model is adequateInstrument Model TRIGger 2-5


1997 SCPI Comm<strong>and</strong> Referencefor many instruments. In some instruments the connections may not be as shown, as multipleinstances of certain individual blocks from the Lamina Model may exist in the instrument. Insuch instruments the connections between blocks may be programmable. Each instance of ablock is differentiated by means of the numeric suffix used with the block name.22.7.1 Data <strong>and</strong> Control Flow TWIR01All of the solid lines in the Lamina Model represent data flow between the blocks. Theexternal signal (often electrical) can be considered as data, since it contains information. In asensor type instrument using the Lamina Model, this data is routed through the ROUTeblock into the INPut block, the data then flows into the SENSe block, then on to theCALCulate block, <strong>and</strong> finally into the DISPlay block or to the system controller over thebus. In a source type instrument using the Lamina Model, data from the controller flows overthe bus, through the CALCulate block, then through the SOURce block. Finally, the data inthe form of an external signal (often electrical) flows into the OUTPut block, <strong>and</strong> is thendistributed through the ROUTe block.Obviously, each block has points where data flow is absorbed <strong>and</strong> emitted. Many blockshave only one point where the data is absorbed <strong>and</strong> one point where data is emitted, howeverthere is no restriction on how many of either of these points a block must have, further thenumber of points where data is absorbed <strong>and</strong> the number of points where data is emitted donot have to appear in equal numbers.When describing the data flow, the SCPI model specifies for each point where data isabsorbed where that data is obtained from. This selection of data flow into a block is madewith the FEED comm<strong>and</strong>.There are certain restrictions that apply to the data FEED for each block; these restrictionsare enumerated under each block’s comm<strong>and</strong> description for its FEED. That is, a particularblock’s FEED is only allowed access to certain points in the data stream, generally the FEEDmust select a block which is of the same type as the block that immediately precedes it in inthe instrument model described earlier. For example a SENSe block which deals withphysical signals, is not allowed to FEED data from a CALCulate block, which is in aninternal format, typically numeric data. Further, SENSe blocks are only allowed to FEEDdata from INPut blocks. Instruments that effectively have no INPut functionality, that is noform of signal conditioning, still are considered to have INPut blocks, so an INPut isavailable to be specified as the FEED of the SENSe block. A block, such as the INPut blockjust described, is called a null block.Associated with the data flow is a control mechanism to ensure the coherent processing ofthe data. Each process has points where control flow is absorbed <strong>and</strong> emitted. There is norestriction on how many of either of these control flow points a block must have. A controlflow carries messages or events. These messages or events are absorbed from a control flowby a process, to control the progress <strong>and</strong> direction of the process. In turn, each process emitsmessages or events that are used by other processes. The action of moving from one processto another is an event. Each process may be sub-divided into a series of steps, the actionfrom moving from one step to another is also an event.2-6 Instrument Model Internal Routing


1997 SCPI Comm<strong>and</strong> ReferenceIn a particular instrument, there will be a number of control flows established as part of theinstrument’s configuration. A typical example is found in the TRIGger block, where the finallayer in a trigger sequence generates an event that causes the “device action” to beperformed, <strong>and</strong> a subsequent event is returned by the block(s) performing the device actionto indicate its completion. Another example, is one where the completion of a dataacquistion by the SENSe block is an event that is used by the CALCulate block toautomatically start the calculation process.In certain cases some of the control flows may be programmable, allowing a user to selectthe controlling events. When describing the control flow, the SCPI model specifies for eachpoint where control information flows in, where it obtains its control flow from. Theselection of a control flow into a block is made with the LINK comm<strong>and</strong>.123452.7.2 Numeric Suffixes TWI6Numeric suffixes are associated with each block to provide them with a unique identifier.The way in which a block with a particular suffix is related to other blocks in an instrumentdepends upon the model employed. The next section describes the Lamina Model <strong>and</strong> theclosely related Cloned Model, also described is the Amorphous SENSe Model.7892.7.3 Lamina <strong>and</strong> Cloned Models TWI10The Model of a Programmable instrument shows one instance of each of the major blocks(or subsystems) that are available in SCPI. In this case each block is given a numeric suffixof 1. This numeric suffix is not usually shown, as it may be defaulted. The relationshipbetween the blocks is fixed in the order shown. For example, Figure 2-6 shows the LaminaModel for a sensor instrument where the name of each block is shown in its explicit form.11121314151617181920Figure 2-6 Lamina Model for a Sensor InstrumentThe Cloned Model repeats the Lamina Model as many times as required. Each repetition of2122the Lamina Model is accompanied with a different numeric suffix, incremented by 1 from 23the last. The cloned model is suitable for instruments that have multiple independentcapabilities. For example, shown in Figure 2-7 is the Cloned Model that could be used to 24represent a multiple independent capability source instrument.2526Instrument Model Internal Routing 2-7


1997 SCPI Comm<strong>and</strong> Reference2.7.3.1 FEED Exceptions TWIR01As mentioned earlier, a particular block’s FEED is only allowed access to certain points inthe data stream, generally the FEED must select a block which is of the same type as theblock that immediately precedes it, in the Instrument Model.2Figure 2-7 Cloned Model for a Multi-Channel InstrumentCALCulate typically follows this rule, obtaining data from the preceding block, which in thecase of a sensor instrument would be the SENSe block. However, where an implementationpermits, CALCulate blocks may be cascaded to provide complex functionality, it ispermissible for a CALCulate block to use another CALCulate block as its FEED, as shownin Figure 2-8:Figure 2-8 Cascaded CALCulate BlocksDISPlay is also a special case, it may obtain data from any point where the data is in aninternal format, typically numeric data. Examples include a CALCulate block or a SENSeblock.2.7.3.2 Amorphous SENSe Model TWIR01In certain sensor instruments there are SENSe blocks that produce parallel independentresults, where certain parts of the SENSe subsystem are shared. A distinguishing feature ofthe Amorphous SENSe Model is that the SENSe block has more than one INPut block2-8 Instrument Model Internal Routing


1997 SCPI Comm<strong>and</strong> Referenceattached to it. In this model the numeric suffix associated with the INPut block is associatedwith the subsystems of the SENSe block, not the SENSe itself. Thus INPut, where is a number, would relate to the subsystems of SENSe such as, SENSe:VOLTage,SENSe:CORRection or SENSe:DETector. This is typical, unless a particularsubsystem of SENSe has been explicitly configured differently, to provide different oradditional combinations of functionality.One example, is where a SENSe block with two power sensors, provides two POWer results<strong>and</strong> a cross-product result such as a POWer:RATio. Another example, is where a SENSeblock with two voltage sensors <strong>and</strong> two independent time sweep capabilities can be arrangedto provide four different results.12342.7.3.3 Other Subsystems5TWIOnly one instance of certain blocks (or subsystems) is permitted in an instrument, these areFORMat, INSTrument, MEMory, MMEMory, STATus, SYSTem <strong>and</strong> TRACe. In mostinstruments there is only one DISPlay, since it is rare to find instruments with two or moredisplays that are entirely separate <strong>and</strong> distinct.6782.7.4 FEED 9TWIThe parameter to a FEED comm<strong>and</strong> is . All s are defined to beIEEE 488.2 STRING PROGRAM DATA. Along a data stream there are discrete pointswhere data may be picked up. These points have names that are called s. Forblocks with a single point where data is emitted, the block name with its numeric suffix isthe . For example, the for CALCulate3 is the string“CALCulate3”.Note that the in the FEED comm<strong>and</strong> may consist of either long or shortforms mnemonics. However the query shall return the short form <strong>and</strong> shall omit any defaultnodes. Thus, the query for the above example would return the string “CALC3”.The s for the different SENSe block found in each of the model, is describedin the following sections.10111213141516172.7.4.1 Sensor Function Selection 18TWISelecting a sensor’s function effects the data flow inside of the SENSe block. Selecting aparticular enables the data flow associated with it. If a is enabled then there must be a associated with the data flow generated bythat function. A SENSe block that has only a single point where data is emitted has a singleSENSe:FUNCtion selected. The selections are mutually exclusive of one another, that isenabling one function would disable another. In the case shown in Figure 2-10, the19202122SENSe:FUNCtion selected is “RESistance”, since it is the only data flow emitted from the23block, SENSe1 is all that is needed to create a unique for this case.24In instruments which have amorphous SENSe blocks one or more functions can be enabledsimultaneously within the same block, that is selecting a function adds to the list of currently 25enabled functions. Such a SENSe block has one or more points where data is emitted, thusthe SENSe block <strong>and</strong> its suffix is no longer sufficient to distinguish the different data flows.26Instrument Model Internal Routing 2-9


1997 SCPI Comm<strong>and</strong> ReferenceIt is necessary for the for these data flows to include the SENSe:FUNCtionthat generated the flow, along with the SENSe block <strong>and</strong> its numeric suffix.2Figure 2-10 Single Function Active SENSe BlockIn Figure 2-9, the sensed characteristic alone is not sufficient, to uniquely specify a function,<strong>and</strong> therefore cannot be used to uniquely indentify a data flow. By including in the the INPut block number(s) associated with a particular data flow, withinthe SENSe block, a unique specification for the <strong>and</strong> thus a unique can be formed. Where the is included in a ,the SENSe node with the optional numeric suffix of 1, may be omitted altogether, sincemany instruments that employ an amorphous SENSe block, will have only one SENSeblock, that is SENSe1.Figure 2-9 Amorphous SENSe Block with Cross-Product2-10 Instrument Model Internal Routing


1997 SCPI Comm<strong>and</strong> ReferenceA specification of a shall consist of the function <strong>and</strong> optionally the INPutblock number. The default INPut suffix is 1. For the cross-product POWer:RATio, bothINPuts must be included. To define an INPut block in the specification, only the INPutsuffix is included, <strong>and</strong> not the mnemonic INPut. For the example above thes <strong>and</strong> corresponding s are, respectively from top to bottom:DESCRIPTION The power function on INPut1 "POWer 1" "SENSe:POWer 1"The power ratio on INPut1 & INPut2 "POWer:RATio 1,2" "SENSe:POWer:RATio 1,2"The power function on INPut2 "POWer 2" "SENSe:POWer 2"The amorphous SENSe block has an additional level of complexity, where SENSesubsystems (or sub-blocks) are used in combination as shown in Figure 2-11.Figure 2-11 shows an amorphous SENSe block with shared SWEep subsystems, <strong>and</strong> thecorresponding s. It should be noted that the function part of thespecification indicates the physical characteristic being sensed, <strong>and</strong> not which subsystem ofSENSe is used. The subsystems used are specified by association with the INPut block, inthe example above VOLTage1 <strong>and</strong> CORRection1 are tied to the data flow associated withINPut1. Where the association is not as specified above, the subsystem with its numericsuffix is appended to the specification after the literal token ’ON’. Note how SWEep1associated with INPut1 <strong>and</strong> SWEep2 associated with INPut2 can be defaulted, as they followthe default relationship of an amorphous SENSe block.(1) "VOLTage:AC 1 ON SWEep1" or "VOLTage:AC 1"(2) "VOLTage:AC 2 ON SWEep1"(3) "VOLTage:AC 1 ON SWEep2"(4) "VOLTage:AC 2 ON SWEep2" or "VOLTage:AC 2"Figure 2-11 Amorphous SENSe Block with Shared SWEep1234567891011121314151617181920212223242526Instrument Model Internal Routing 2-11


1997 SCPI Comm<strong>and</strong> ReferenceThe is then the preceded by the SENSe block <strong>and</strong> itssuffix. Thus a FEED for a display trace from an amorphous SENSe block, as shown above,might look like:DISPlay:WINDow:TRACe:FEED “SENSe1:VOLTage:AC 2 ON SWEep1"22.7.4.2 FEEDs from CALCulate Sub-Blocks TWIR01The CALCulate block has only one data stream through it. The CALCulate block is dividedinto smaller sub-blocks, which correspond to the subsystems found in the CALCulatesubsystem.Due to the discrete way in which each active sub-block exists, the data stream is accessibleafter each sub-block, where permitted by the implementation. The name of the CALCulateblock <strong>and</strong> its numeric suffix is not sufficient to select the intermediate points. Therefore the to access these intermediate points is comprised of the CALCulate blockname <strong>and</strong> numeric suffix followed by a colon (:) <strong>and</strong> the name of a CALCulate sub-block.For example, if a CALCulate consists of MATH1, TRANsform, followed by MATH2, thenthe to select the data flow after the TRANsform, but before MATH2, wouldbe the string “CALCulate:TRANsform”2.7.5 COMBineThe COMBine block acts to combine several data streams or signals. Each separate input toa COMBine block has a FEED comm<strong>and</strong>.The output is the sum of the inputs. For example if the inputs are complex vectorsrepresenting waveforms with certain phases, then the ouput is the linear combination of theinputs which is also a complex vector.Several different FEED comm<strong>and</strong>s might possibly specify the same , in effectrouting a single data stream into multiple subsystems.HP0862.7.6 Memory Associated with Data Flow TWIR01In the Model of a Programmable Instrument a MEMory block is shown adjacent to the otherblocks in the model. For the user area memory this appears to be the correct model, however,for “instrument data” this proves to be cumbersome. A better model for “instrument data” isobtained by imagining that memory is something that pervades the whole model, any pointalong the data flow potentially may have memory associated with it. In general termsmemory exists at all points along this flow of data.The examples in Figure 2-12 show how memory is associated with the simplest of blocks, itthen shows how memory is associated with a CALCulate block consisting of threesub-blocks. This is a very simple model to present to the user; at every point along the dataflow memory exists. The fact that it exists, does not mean that a particular implementationhas to allow the user access to it, as the data may not be in a form useful to the user. If accessis provided to these intermediate memory stores, certain restrictions may apply depending onthe memory usage. Within this model there are two types of memory:TRANSIENT - memory <strong>and</strong> data are retained only long enough to be used bynext step in data flow2-12 Instrument Model Internal Routing


1997 SCPI Comm<strong>and</strong> ReferenceSTATIC - memory is permanently allocated <strong>and</strong> data is retained, until next“acquisition”If the memory is transient then it is not possible to obtain data from it after the data hasflowed past this point. Thus, querying such a point will not return anything, until new dataflows into the newly created transient memory. This would occur if such a query were sentin the same program message as an INITiate comm<strong>and</strong>.Figure 2-12 MEMory Association with a Generic <strong>and</strong> a CALCulate BlockStatic memory is permanently allocated to the specified point in the data flow. Any dataflowing past this point will fill this memory, <strong>and</strong> the data at that point may be queried at anytime. However, should a new data flow start, for example with an INITiate, then the contentsof the memory shall be replaced with the new data.The names used in querying memory should reflect where they occur in the data flow. Tobest achieve this the “h<strong>and</strong>les” given to these points for connecting blocks together are alsoappropriate in data query.There is a third type of memory, user memory which is already defined in theTRACe|DATA subsystem.Given the FEED mechanism it is possible for a TRACe name, such as MY-TRACE, to tapthe data flow. Every time that new data flows past the “tapped” point, MY-TRACE will beupdated with the new data. While this may be useful, a significant benefit can be achievedby providing a control mechanism that selectively allows data into the TRACe, upon aspecified condition of events. For example, it should be possible to set up the control so thatMY-TRACE will only receive new data when a limit test fails.1234567891011121314151617181920212223242526Instrument Model Internal Routing 2-13


1997 SCPI Comm<strong>and</strong> ReferenceIt can be seen that a user can create a TRACe, such as MY- TRACE, that may track the“tapped” point, but MY-TRACE <strong>and</strong> the memory at the tapped point are distinct <strong>and</strong>separate. Note that the memory at that point will always (while it exists) reflect the latestdata flow, while MY-TRACE may not since the data flow into it may be gated. It is notpermitted to create TRACe | DATA names identical to any data h<strong>and</strong>les.22.7.7 Querying the Data Flow TWIR01SCPI allows the data flow to be queried, so that a system controller can obtain intermediateresults. This is only possible where the data flow is in an internal format, typically numericdata. That is, if the data flow is some physical characteristic such as an electrical signal, thenthe data flow at such a point is not queryable.The form of the query is generally the block name followed by :DATA?. In certain cases,this either does not provide a unique data flow, or more resolution is required than just theblock level. The SENSe:DATA? query has an optional function name as a parameter todefine the particular data flow required out of the SENSe block. An implementation mayallow access to the data flow after each sub-block subsystem in the CALCulate block. Thus,the query becomes the heirarchical name of the sub-block followed by :DATA?, for examplethe data flow after MATH1 could be obtained with CALCulate:MATH1:DATA?. Thereturned data is affected by the format subsystem.2.7.8 TWIR01The is the way events are described that are used by the LINK comm<strong>and</strong>sthroughout SCPI. Events may exist in all blocks of the Instrument Model, although aparticular implementation will dictate what events are available to be used with each LINKcomm<strong>and</strong> implemented.The general form of is:to be determinedEvents that are commonplace in instruments, are those found in the TRIGger subsystem; theaction of exiting any layer generates an event. The s to reference theseTRIGger generated events are of the form:“ARM[:SEQuence[:LAYer]]” or “TRIGger[:SEQuence]”Other common examples include completion of a process in a block or an instrument statetransition.2-14 Instrument Model Internal Routing


1997 SCPI Comm<strong>and</strong> Reference3 Measurement InstructionsThe purpose of the MEASure group of instructions is to acquire data using a set of high-levelinstructions. The MEASure group of instructions have a duality, in that they exhibitcomm<strong>and</strong> <strong>and</strong> query characteristics. The exception to this is CONFigure, which has distinctquery <strong>and</strong> comm<strong>and</strong> forms. These instructions are independent of the block diagram <strong>and</strong>refer to the characteristics of the signal being measured. These instructions are intended to beused with the measurement referenced later in this chapter.The MEASure group of comm<strong>and</strong>s are structured to allow the user to trade offinterchangeability with fine control of the measurement process. MEASure? provides acomplete capability where the instrument is configured, a measurement taken, <strong>and</strong> resultsreturned in one operation. Often, more precise control of the measurement is required.Therefore, MEASure? is complemented by providing two comm<strong>and</strong>s, CONFigure <strong>and</strong>READ?. CONFigure performs the configuration portion of the measurement <strong>and</strong> READ?performs the data acquisition, postprocessing, <strong>and</strong> data output portions of the measurement.This allows the user to perform a generic configuration of the measurement throughCONFigure <strong>and</strong> then customize the measurement by changing particularinstrument-dependent functions. The READ? then completes the measurement process.READ?, in turn, is broken down into two additional comm<strong>and</strong>s INITiate[:IMMediate] <strong>and</strong>FETCh?. INITiate[:IMMediate] performs the data acquisition. This comm<strong>and</strong> is described inchapter 22. FETCh? performs the postprocessing function <strong>and</strong> returns the data. This allowsthe user to perform several different FETCh? functions on a single set of acquired data. Forexample, an oscilloscope can acquire measurement data that can yield many different signalcharacteristics such as frequency or AC <strong>and</strong> DC voltages. Thus, a transient signal may becaptured once using a MEASure?, READ? or INITiate. A FETCh? may then be used toobtain each of the different signal characteristics without reacquiring a new measurement.MEASure? provides the best compatibility between instruments because no knowledge ofthe instrument is required to perform the operation. CONFigure/READ? is less compatible ifinstrument reconfiguration is performed between the CONFigure <strong>and</strong> READ? operations.This is because the reconfiguration is, by necessity, instrument-specific. FETCh? is also lesscompatible because knowledge of the instrument is necessary to determine whether thenecessary information has been captured by the instrument. For example, an oscilloscopecan capture both rise time <strong>and</strong> pulse width in a single acquisition. Therefore, if pulse widthwas acquired through a MEASure? comm<strong>and</strong>, it would be possible to FETCh? rise time.However, if pulse width were measured with a counter, the rise time information might notbe available without performing another data acquisition. Therefore FETCh? could not beused.Changing certain parts of an instrument’s configuration shall cause existing measurementdata to be invalidated. Specifically, in figure 2-1, “Generalized Model of a ProgrammableInstrument” in chapter 2, “Instrument Model,” any reconfiguration of signal routing,measurement function, signal generation <strong>and</strong>/or trigger shall cause existing readings to beinvalidated. For example, the sequence:INITiate;CONFIGure:VOLTage;FETCh:VOLTage?1234567891011121314151617181920212223242526Measurement Instructions 3-1


1997 SCPI Comm<strong>and</strong> Reference3would cause an error to be generated as the data was invalidated by the CONFigurecomm<strong>and</strong>. Reconfiguring the display or format blocks shall not have this effect.KEYWORD PARAMETER FORM NOTESCONFigure: [,]FETCh[:]? [,][query only]READ[:]? [,] [query only]MEASure:?[,][query only]3.1 CONFigure: [,]Sets up the instrument in order to perform the measurement specified by the function.Individual functions are described in later in this chapter. The parameters of thiscomm<strong>and</strong> are described in the individual function descriptions. The execution of theCONFigure comm<strong>and</strong> may affect the value of any other setting in the instrument. The stateof the instrument is not specified after the execution of this comm<strong>and</strong>, except that asubsequent READ? QUERY operation would perform the specified function.If parameters are omitted, they shall assume the values specified by the particular functiondescription. Parameters may be defaulted from the right by omitting them, or anywhere bysubstituting the keyword DEFault. DEFault must be accepted as a parameter for thiscomm<strong>and</strong>.The query form of the comm<strong>and</strong>, CONFigure?, returns the setup configured by the lastCONFigure or MEASure? query. If the instrument state has changed through receivingcomm<strong>and</strong>s other than CONFigure or MEASure?, the information returned by a CONFigure?may not reflect the actual measurement conditions. However, it is permissible for aninstrument to attempt to track these changes <strong>and</strong> construct an accurate CONFigure queryresponse. The format of the response data is which is of theform:“ ”For example, if the previous CONFigure comm<strong>and</strong>:CONFIGURE:VOLTage:AC 5,.001had been executed, the query CONFigure? would return:“VOLT:AC 5.0,0.001"A special parameter type is the . The is syntactically a as described in “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>.” The purpose of the is to specify thephysical port which is the source of the measurement. For example, (@2) would specify thatthe measurement should occur on channel 2. Multiple channels can be specified by usingmultiple channels in the channel list. For example, (@1,3:5,9) specifies that measurementsare to be taken on channels 1,3,4,5, <strong>and</strong> 9. SCPI does not specify if the acquisitions aresimultaneous or sequential. A function which requires multiple channels, such as timeinterval, would specify each channel as a separate list. For example, (@1),(@2) wouldspecify a two-channel measurement between channels 1 <strong>and</strong> 2. A multiple channel, multiplemeasurement is specified by using multiple channels in each of the lists. For example,3-2 Measurement Instructions


PH01997 SCPI Comm<strong>and</strong> Reference(@1,2),(@3,4) specifies a pair of two-channel measurements, the first between channels 1<strong>and</strong> 3 <strong>and</strong> the second between channels 2 <strong>and</strong> 4.At *RST, the configuration is set to a device-dependent value.3.2 FETCh[:]? [,]Retrieves the measurements taken by the INITiate comm<strong>and</strong> <strong>and</strong> places them into thedevice’s output buffer. By specifying a function as part of a compound header, the devicewill retrieve the value of the function requested derived from the data taken by the latestINITiate comm<strong>and</strong>. For instance, even if a WAVeform was the original function when themeasurement was taken, functions that can be calculated from the stored data can beFETChed. When is omitted, the last fetched, read, or measured shallbe used.The FETCh? query will return data any time that the last reading is valid. Data becomesinvalid under the following conditions:When *RST is executed,When an INITiate is executed.When there is any reconfiguration of signal routing, measurement function, signalgeneration <strong>and</strong>/or trigger blocks.When the sensor begins acquisition of a new reading.If data is invalid, the FETCh? query shall not be complete until all data is valid. Theexceptions to this are, if the instrument is in the trigger IDLE state <strong>and</strong> the data is invalid, orthe instrument has been reconfigured as defined above <strong>and</strong> no new measurement has beeninitiated. In such cases, the FETCh? routine shall generate an error -230 <strong>and</strong> no result shallbe returned. A common cause for this error is receiving a FETCh? after a *RST.Parameters are allowed in the FETCh? query. They may be defaulted from the right byomitting them, or in any other position by substituting the keyword DEFault. DEFault mustbe accepted as a parameter for this query. If a parameter is specified, it is used in thecalculation if applicable. If the parameter is invalid because it conflicts with the acquireddata, an error -221 shall be generated. If the instrument receives a parameter which isunexpected (too many parameters), it shall process the query <strong>and</strong> return the data. Theunexpected parameter shall be ignored, <strong>and</strong> the “comm<strong>and</strong> warning” bit of the “dataQUEStionable” status register shall be set.A special parameter type is the . The is syntactically a as described in “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>.” The purpose of the is to specify thephysical port which is the source of the measurement. For example, (@2) would specify thatthe measurement should occur on channel 2. Multiple channels can be specified by usingmultiple channels in the channel list. For example, (@1,3:5,9) specifies that measurementsare to be taken on channels 1,3,4,5, <strong>and</strong> 9. SCPI does not specify if the acquisitions aresimultaneous or sequential. A function which requires multiple channels, such as timeinterval, would specify each channel as a separate list. For example, (@1),(@2) wouldspecify a two-channel measurement between channels 1 <strong>and</strong> 2. A multiple channel, multiple1234567891011121314151617181920212223242526Measurement Instructions 3-3


1997 SCPI Comm<strong>and</strong> Reference3measurement is specified by using multiple channels in each of the lists. For example,(@1,2),(@3,4) specifies a pair of two-channel measurements, the first between channels 1<strong>and</strong> 3 <strong>and</strong> the second between channels 2 <strong>and</strong> 4.The format of the returned data is determined by the FORMat comm<strong>and</strong>.3.3 READ[:]? [,]The READ? query is identical to:ABORt;INITiate;FETCh[:]? [,]The READ? function provides a method of performing a FETCh? operation on fresh data.A common application is to use the READ? in conjunction with a CONFigure comm<strong>and</strong> inorder to provide a MEASure? capability in which the application programmer is allowed toprovide fine adjustments to the instrument’s block diagram. For example,CONFigure:VOLTage:RISE:TIME 10 PCT, 90 PCT, 0.001 SSWEep:TIME .05 SVOLTage:AC:RANGe 5 VREAD:VOLTage:RISE:TIME?Allows the applications programmer to specify the amplitude sensitivity <strong>and</strong> sweep time inorder to provide the exact measurement needed.If parameters are omitted, they are assumed to be those currently in use. Parameters may bedefaulted from the right by omitting them, or anywhere by substituting the keywordDEFault. DEFault shall be accepted as a parameter for this query. If the instrument receivesa parameter which is unexpected (too many parameters), it shall process the query <strong>and</strong> returnthe data, ignoring the unexpected parameter <strong>and</strong> shall also set the “comm<strong>and</strong> warning” bit ofthe “data QUEStionable” status register.A special parameter set is the . The is syntactically a as described in “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>.” The purpose of the is to specify thephysical port which is the source of the measurement. For example (@2) would specify thatthe measurement should occur on channel 2. Multiple channels can be specified by usingmultiple channels in the channel list. For example, (@1,3:5,9) specifies that measurementsare to be taken on channels 1,3,4,5, <strong>and</strong> 9. SCPI does not specify if the acquisitions aresimultaneous or sequential. A function which requires multiple channels, such as timeinterval, would specify each channel as a separate list. For example, (@1),(@2) wouldspecify a two-channel measurement between channels 1 <strong>and</strong> 2. A multiple channel, multiplemeasurement is specified by using multiple channels in each of the lists. For example,(@1,2),(@3,4) specifies a pair of two channel measurements, the first between channels 1<strong>and</strong> 3 <strong>and</strong> the second between channels 2 <strong>and</strong> 4.The format of the returned data is determined by the FORMat comm<strong>and</strong>.3-4 Measurement Instructions


1997 SCPI Comm<strong>and</strong> ReferenceIf TRIGger:SOURce BUS is selected, execution of this query shall cause an error -214 to begenerated <strong>and</strong> no data shall be returned. If ARM:SOURce BUS is selected, the same actionshall occur, except that the error returned shall be -215.3.4 MEASure:? [,]The MEASure? query is a query identical to:ABORt;CONFigure: ;READ:? [,];The MEASure? query provides a complete measurement sequence, including configuration<strong>and</strong> reading of the data. MEASure? is used when the generic measurement is acceptable <strong>and</strong>fine adjustment of the instrument block diagram is unnecessary.If parameters are omitted, they shall assume the values specified by the particular functiondescription. Parameters may be defaulted from the right by omitting them, or anywhere bysubstituting the keyword DEFault. DEFault must be accepted as a parameter for this query.If the instrument receives a parameter which is unexpected (too many parameters), it shallprocess the query <strong>and</strong> return the data, ignoring the unexpected parameter <strong>and</strong> shall also setthe “comm<strong>and</strong> warning” bit of the “Data questionable” status register.A special parameter set is the . The is syntactically a as described in “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>.” The purpose of the is to specify thephysical port which is the source of the measurement. For example (@2) would specify thatthe measurement should occur on channel 2. Multiple channels can be specified by usingmultiple channels in the channel list. For example, (@1,3:5,9) specifies that measurementsare to be taken on channels 1,3,4,5, <strong>and</strong> 9. SCPI does not specify if the acquisitions aresimultaneous or sequential. A function which requires multiple channels, such as timeinterval, would specify each channel as a separate list. For example, (@1),(@2) wouldspecify a two-channel measurement between channels 1 <strong>and</strong> 2. A multiple channel, multiplemeasurement is specified by using multiple channels in each of the lists. For example,(@1,2),(@3,4) specifies a pair of two-channel measurements, the first between channels 1<strong>and</strong> 3 <strong>and</strong> the second between channels 2 <strong>and</strong> 4.The format of the returned data is determined by the FORMat comm<strong>and</strong>.If TRIGger:SOURce BUS is selected, execution of this query shall cause an error -214 to begenerated <strong>and</strong> no data shall be returned. If ARM:SOURce BUS is selected, the same actionshall occur, except that the error returned shall be -215.3.5 Functions define the measurement operation to be used by the MEASure?, CONFigure,READ?, <strong>and</strong> FETCh? instructions <strong>and</strong> are used directly in combination with theseinstructions. The functions used in conjunction with the MEASure?instructions are differentthan those described in the SENSe chapter, in that the MEASure? functions aresignal-oriented <strong>and</strong> potentially independent of the hardware.1234567891011121314151617181920212223242526Measurement Instructions 3-5


1997 SCPI Comm<strong>and</strong> Reference3A function is described as a subtree under the CONFigure, READ?, FETCH?, <strong>and</strong>MEASure? instructions. The functions are layered into presentation, fundamentalmeasurement, <strong>and</strong> measurement function layers as follows:MEASure[:][:]:?For example, to measure an array of DC Voltage measurements, we specify the following:MEASure:ARRay:VOLTage:DC?The presentation layer defaults to a simple scalar measurement. The fundamentalmeasurement layer has a device dependent default. For example, an oscilloscope woulddefault VOLTage as its . Therefore to perform a rise timemeasurement on an oscilloscope, the instrument shall accept any <strong>and</strong> all of the followingcomm<strong>and</strong>s:MEASure:SCALar:VOLTage:RISE:TIME?MEASure:VOLTage:RISE:TIME?MEASure:SCALar:RISE:TIME?MEASure:RISE:TIME?Each layer of the function can have a set of parameters associated with it. Within each set,parameters default from the right. Any parameter in a set may be optional unless thecomm<strong>and</strong> description states that the parameter is required. Further, any parameter which isallowed to be defaulted may be defaulted by substituting the keyword DEFault for theparameter.Each set of parameters is separated from the others by enclosing them in parentheses. Theexception is that the rightmost parameter set may omit the parentheses. Therefore the syntaxis as follows:MEASure:::?[[[()],()],][,]For example, if we wished to measure an array of voltage rise times, where we wished toacquire 100 readings, <strong>and</strong> the approximate voltage value was 5 V, <strong>and</strong> the expected 10-90rise time was 5 ms, we could write the following query:MEASure:ARRay:VOLTage:RISE:TIME? (100),(5 V),10,90,5 MSThe parameter group is only allowed when the corresponding header is part of the comm<strong>and</strong>.For example, the comm<strong>and</strong>:MEASure:RISE:TIME? (5 V),10,90,5 MSwould generate an error because the fundamental measurement parameters have beenspecified without specifying the fundamental measurement layer in the header. However, as3-6 Measurement Instructions


1997 SCPI Comm<strong>and</strong> Referencethe syntax shows, it is permissible to default groups of parameters from the left. Therefore itis possible to default the fundamental measurement parameters while specifying thefundamental measurement layer as follows:MEASure:VOLTage:RISE:TIME? 10,90,5 MSA majority of the functions share two parameters, expected value <strong>and</strong> resolution. Expectedvalue is a guess as to the actual value of the measurement. It is used instead of range becauserange is a device-dependent concept, describing the actual sensor characteristics, whileexpected value is signal-oriented, describing the expected signal.Resolution describes the absolute resolution of the measurement. If the parameter is omitted,the instrument selects a resolution. If the instrument cannot provide a measurement at thedesired resolution, an error -231 is generated, but an answer is still returned if possible.3.6 Presentation LayerThe purpose of the presentation layer is to h<strong>and</strong>le groups of data <strong>and</strong> present them in the waythe user specifies. This area is still under discussion, <strong>and</strong> therefore most of the presentationtypes (for example, histograms, time <strong>and</strong> frequency domain waveforms, <strong>and</strong> so on) are notincluded in this release.3.6.1 Presentation Comm<strong>and</strong> SummaryPRESENTATION KEYWORDPARAMETER[:SCALar]:ARRay3.6.2 [:SCALar]A SCALar or single value of the desired measurement is taken. SCALar has no associatedparameters, <strong>and</strong> is a default node at this level.3.6.3 :ARRay An array of readings is specified. No domain information (time or frequency spacing) isimplied in the record. There is one associated parameter, size. This specifies the number ofreadings to be taken. This parameter cannot be defaulted.3.7 Fundamental Measurement LayerThe purpose of the fundamental measurement layer is to specify the fundamental signalcharacteristic being measured.3.7.1 Fundamental Measurement Comm<strong>and</strong> SummaryKEYWORD PARAMETERVOLTage[[,]]CURRent[[,]]POWer[[,]]RESistance [[,]]FRESistance [[,]]TEMPerature [[,[,[,]]]]1234567891011121314151617181920212223242526Measurement Instructions 3-7


JP Change1997 SCPI Comm<strong>and</strong> Reference33.7.2 :VOLTage[[,]]Measures the voltage characteristics of the signal. If resolution is not specified, theinstrument chooses a resolution based on its own tradeoffs. If is notspecified, either autoranging or a default range is selected.3.7.3 :CURRent [[,]]Measures the current characteristics of the signal. If resolution is not specified, theinstrument chooses a resolution based on its own tradeoffs. If is notspecified, either autoranging or a default range is selected.3.7.4 :POWer [[,]]Measures the power characteristics of the signal. If resolution is not specified, the instrumentchooses a resolution based on its own tradeoffs. If is not specified, eitherautoranging or a default range is selected.3.7.5 :RESistance [[,]]Measures the resistance at the input. If resolution is not specified, the instrument chooses aresolution based on its own tradeoffs. If is not specified, eitherautoranging or a default range is selected.3.7.6 :FRESistance [[,]]Measures the four-wire resistance at the input. If resolution is not specified, the instrumentchooses a resolution based on its own tradeoffs. If is not specified, eitherautoranging or a default range is selected.3.7.7 :TEMPerature [[, [,[,]]]]Measures the temperature at the sensor. The parameter is character data whichcan take on the following values:KEYWORD DESCRIPTIONTCoupleThermocoupleTHERmistor ThermistorFTHermistor Four-wire thermistorRTDResistive temperature deviceFRTDFour-wire resistive temperature deviceIf a transducer is not specified, the instrument-dependent default is used.The parameter is either character data or format data, depending on whichtransducer is specified. If TCouple is selected, the parameter is character data specifying thethermocouple type. Examples of valid values for thermocouple type are: J,K,R,S,T,B,E, <strong>and</strong>N14.Thermistors <strong>and</strong> four-wire thermistors use the nominal resistance value for the type, as anumeric parameter. Typical values are 2250, 5000, <strong>and</strong> 10000.RTDs <strong>and</strong> FRTDs use a which is specified by the manufacturer. Typicalvalues are 85 <strong>and</strong> 92.If a type is not specified, an instrument-dependent default is used.3-8 Measurement Instructions


PH0PH0PH01997 SCPI Comm<strong>and</strong> ReferenceIf resolution is not specified, the instrument chooses a resolution based on its own tradeoffs.If is not specified, either autoranging or a default range is selected.3.8 Measurement Function LayerThis layer presents the specific functions to be measured. This layer has been broken downinto groups of measurements to provide clarity. This is only done for purposes of clarifyingthe presentation <strong>and</strong> there is no grouping provided in the tree.A trailing :RATio node may be added to the Measurement Function layer, to request for aRATio measurement between the characteristics of two signals. The RATio taken, relates tothe signal characteristics specified by the preceding nodes.The consists of two parameters if the RATio node is employedin the comm<strong>and</strong>. The first parameter specifies the numerator <strong>and</strong> the secondone is the denominator. For example, MEASure:FREQuency:RATio? (@1),(@2) measuresthe ratio of the signal frequency of channel 1 to the signal frequency on channel 2.The parameters, specified with a ratio measurement comm<strong>and</strong>, relate to the signal8characteristics of the first ; this is the signal which determines the numerator.93.8.1 Simple MeasurementsThe simple measurements set the fundamental characteristics of steady state signals. 103.8.1.1 Simple Measurements Comm<strong>and</strong> Summary11KEYWORD PARAMETER12:AC[:DC]13:FREQuency [[,]]14:BURSt [[,]] 1992 PH02:PRF [[,]] 1992 15PH02:PERiod[[,resolution>]]16:PHAse [[,resolution>]] 1992 PH03.8.1.2 :ACMeasures the AC RMS characteristic of the signal.183.8.1.3 [:DC]Measures the DC level of the signal.19203.8.1.4 :FREQuency[[,]]Measures the frequency of the signal. If resolution is not specified, the instrument chooses aresolution based on its own tradeoffs. If is not specified, eitherautoranging or a default range is selected.2122233.8.1.4.1 :BURSt [[,]] PH0224Measures the frequency of an ON-OFF modulated signal during its ON period. Such signalsare often referred to as burst signals. The characteristic to be measured is the frequencyinside the burst as is shown in Figure 3-1. If is not specified, the instrumentchooses a resolution based on its own tradeoffs. If is not specified eitherauto ranging or a device dependent, particular range is selected.2526Measurement Instructions 3-9123456717


PH031PH0371997 SCPI Comm<strong>and</strong> Reference33.8.1.4.2 :PRF [[,]] PH029AMeasures the repetition frequency of the ON-OFF modulation of a signal that is periodicallyswitched ON <strong>and</strong> OFF. This characteristic is often referred to as Pulsed RepetitionFrequency (PRF) as shown in Figure 3-1. If is not specified, the instrumentchooses a resolution based on its own tradeoffs. If is not specified eitherauto ranging or a default range is selected.3.8.1.5 :PERiod [[,]]The period (that is, 1/frequency) of a signal. If resolution is not specified, the instrumentFigure 3-1 Burst Signalchooses a resolution based on its own tradeoffs. If is not specified, eitherautoranging or a default range is selected.3.8.1.6 :PHASe [[,]]Measures the PHASe. If is not specified, the instrument chooses a resolutionbased on its own tradeoffs. If is not specified either auto ranging or adefault range is selected.If two channel lists are specified, the second shall be the reference.3.8.2 Time Domain Waveform MeasurementsThese functions measure the time domain characteristics of pulsed signals.Figure 3-2 is used to illustrate the terms being used to describe pulse signal characteristics.3.8.2.1 Waveform Measurements Comm<strong>and</strong> SummaryKEYWORD PARAMETER FORM:AMPLitude:LOW:HIGH:RISE:TIME:OVERshoot:PREShoot[[,[,[,]]]]3-10 Measurement Instructions


KEYWORD:RTIME:FALL:TIMe:OVERshoot:PREShoot:FTIME1997 SCPI Comm<strong>and</strong> ReferencePARAMETER FORM[[,[,[,]]]][[,[,[,]]]][[,[,[,]]]]:PDUTycycle|:DCYCle []:NDUTycycle []:TMAXimum:TMINimum:MINimum:MAXimum:PTPeak:NWIDth[]:PWIDth[]199245678910PH03.8.2.2 :AMPLitudeAmplitude is the signal amplitude calculated by taking HIGH - LOW.Figure 3-2 Pulse Measurement TerminologyMeasurement Instructions 3-1112311121314151617181920212223242526


1997 SCPI Comm<strong>and</strong> Reference33.8.2.3 :LOWThis comm<strong>and</strong> specifies the LOW signal level. LOW is defined as the less positive of theBASE <strong>and</strong> TOP signal levels as defined in IEEE Std 194 sections 3.2.1 <strong>and</strong> 3.2.2.3.8.2.4 :HIGHThe HIGH signal level. HIGH is defined as the more positive of the BASE <strong>and</strong> TOP signallevels as defined in IEEE Std 194 sections 3.2.1 <strong>and</strong> 3.2.2.3.8.2.5 :RISEThis node specifies measurements on a rising edge of a waveform. This node has noassociated parameters. This node specifies the first rising edge of the waveform.3.8.2.5.1 :TIMe [[,[,[,]]]]The time interval during which the instantaneous amplitude of a pulse increases from the lowreference to high reference of the normal pulse amplitude.This function is an alias to RTIMe. If RISE:TIME is implemented, RTIMe shall also beimplemented. It is recommended that RISE:TIME also be implemented.Default low <strong>and</strong> high references are 10% <strong>and</strong> 90% of normal high-signal level. Thesedefaults may be changed via the parameters. The reference parameters have a default unit ofpercent. An implementation may allow the references to be entered in absolute sensor units.For example, an implementation may choose to allow the following syntax:MEASure:VOLTage:RISE:TIME 0.2V,4.5V,.005Sto measure the 0.2 to 4.5 Volt rise time of a voltage signal.3.8.2.5.2 :OVERshootThe difference between the HIGH <strong>and</strong> the peak amplitude to which the instantaneous pulsewaveform initially rises. This function uses the first edge of the waveform, expressed as apercentage of the waveform amplitude.3.8.2.5.3 :PREShootThe difference between the LOW signal level <strong>and</strong> the negative peak signal value to whichthe waveform initially falls expressed as a percentage of waveform amplitude.3.8.2.6 :RTIMe [[,[,[,]]]]The time interval during which the instantaneous amplitude of a pulse increases from the lowreference to high reference of the normal pulse amplitude.RISE:TIME is an alias to this function. If RISE:TIME is implemented, RTIMe shall also beimplemented.Default low <strong>and</strong> high references are 10% <strong>and</strong> 90% of normal high-signal level. Thesedefaults may be changed via the parameters. The reference parameters have a default unit ofpercent. An implementation may allow the references to be entered in absolute sensor units.For example, an implementation may choose to allow the following syntax:MEASure:VOLTage:RISE:TIME 0.2V,4.5V,.005S3-12 Measurement Instructions


1997 SCPI Comm<strong>and</strong> Referenceto measure the 0.2 to 4.5 Volt rise time of a voltage signal.3.8.2.7 :FALLThis node specifies measurements on a falling edge of a waveform. This node has noassociated parameters. This node assumes the first falling edge of the waveform.3.8.2.7.1 :TIME [[,[,[,]]]]The time interval during which the instantaneous amplitude of a pulse decreases from thehigh reference to low reference of the normal pulse amplitude.This function is an alias to FTIMe. If FALL:TIME is implemented, FTIMe shall also beimplemented. It is recommended that FALL:TIME also be implemented.Default low <strong>and</strong> high references are 10% <strong>and</strong> 90% of normal high-signal level. Thesedefaults may be changed via the parameters.The reference parameters have a default unit ofpercent. An implementation may allow the references to be entered in absolute sensor units.For example, an implementation may choose to allow the following syntax:MEASure:VOLTage:FALL:TIME 0.2V,4.5V,.005Sto measure the 4.5 to 0.2 Volt fall time of a voltage signal.3.8.2.7.2 :OVERshootThe difference between the LOW <strong>and</strong> the negative peak amplitude to which theinstantaneous pulse waveform initially falls, expressed as a percentage of the waveformamplitude.3.8.2.7.3 :PREShootThe difference between the HIGH signal level <strong>and</strong> the positive peak signal value to whichthe waveform initially rises expressed as a percentage of waveform amplitude.3.8.2.8 :FTIMe [[,[,[,]]]]The time interval during which the instantaneous amplitude of a pulse decreases from thehigh reference to low reference of the normal pulse amplitude.FALL:TIME is an alias to this function. If FALL:TIME is implemented, FTIMe shall also beimplemented.Default low <strong>and</strong> high references are 10% <strong>and</strong> 90% of normal high-signal level. Thesedefaults may be changed via the parameters.The reference parameters have a default unit ofpercent. An implementation may allow the references to be entered in absolute sensor units.For example, an implementation may choose to allow the following syntax:MEASure:VOLTage:FALL:TIME 0.2V,4.5V,.005Sto measure the 4.5 to 0.2 Volt fall time of a voltage signal.3.8.2.9 :PWIDth []The positive width expressed in seconds from the first rising edge reference to the nextfalling edge reference. The same reference is used for the rising <strong>and</strong> falling edges. The1234567891011121314151617181920212223242526Measurement Instructions 3-13


1997 SCPI Comm<strong>and</strong> Reference3default reference is defined as midway between HIGH <strong>and</strong> LOW levels. Other positivereferences may be specified by the parameter.3.8.2.10 :NWIDth []The negative width expressed in seconds from the first falling edge reference to the nextrising edge reference. The same reference is used for the rising <strong>and</strong> falling edges. The defaultreference is midway between HIGH <strong>and</strong> LOW levels. Other references may be specified bythe parameter.3.8.2.11 :PDUTycycle|:DCYCle []Positive dutycycle. The ratio of PWIDth to PERiod. The reference specifies the point on thepulse where the duty cycle is determined. This parameter defaults to 50%.3.8.2.12 :NDUTycycle []Negative dutycycle. The ratio of NWIDth to PERiod. The reference specifies the point onthe pulse where the duty cycle is determined. This parameter defaults to 50%.3.8.2.13 :TMAXimum Layer:Time Domain Waveform MeasurementsThe time at which the first occurrence of the maximum voltage occurs.3.8.2.14 :TMINimumThe time at which the first occurrence of the minimum voltage occurs.3.8.2.15 :MINimumThe MINimum comm<strong>and</strong> calculates the minimum value of the waveform.3.8.2.16 :MAXimumThe MAXimum comm<strong>and</strong> calculates the maximum value of the waveform.3.8.2.17 :PTPeak PH037This comm<strong>and</strong> measures the Peak To Peak value of the signal which is (MAXimum -MINimum).3-14 Measurement Instructions


TWIR011997 SCPI Comm<strong>and</strong> Reference4 CALCulate SubsystemThe CALCulate subsystem exists to perform postacquisition data processing. Functions inthe SENSe subsystem are related to data acquisition, while the CALCulate subsystemoperates on the data acquired by a SENSe function.The CALCulate subsystem is logically between the SENSe subsystem <strong>and</strong> data output toeither the bus or the display. When a measurement is triggered by a MEASure comm<strong>and</strong>, anINITiate comm<strong>and</strong>, or meeting the prevailing TRIGger conditions, the SENSe subsystemcollects data. This data is transformed by CALCulate, as specified, <strong>and</strong> then passed on to theselected output. In effect, the collection of new data triggers the CALCulate subsystem. TheCALCulate subsystem may also be directed by comm<strong>and</strong> to perform a transform, making itpossible to change the configuration of CALCulate <strong>and</strong> consequently derive a different set ofresults from the same SENSed data set without reacquiring sense data.The CALCulate subsystem consists of a number of independent subsystems. Each of thesubsystems is a sub-block of the CALCulate block. The data flows through the sub-blocks ina serial fashion, through the first sub-block, then onto the second sub-block <strong>and</strong> so on. Themanner in which these sub-blocks are arranged is specified in the PATH comm<strong>and</strong>. It ispermissible for a CALCulate block to have more than one instance of any of the sub-blocks.Instances of the same sub-block are differentiated by a numeric suffix. For example, twoindependent filters would exist as the :CALCulate:FILTer1 <strong>and</strong> the :CALCulate:FILTer2subsystem sub-blocks.Note: The notation Xn* indicates the complex conjugate of a number. So:XX* = MAG 2 (X) = |X| 21234567891011121314 HP081bKEYWORD PARAMETER FORM NOTESCALCulate15:AVERage 1992 HP016:CLEar [no query] 1992 HP0:COUNt 1992 17HP0:AUTO | ONCE 1992 HP018[:STATe] 1992 HP0:TCONtrol EXPonential | MOVing | NORMal | REPeat 1992 19HP0:TYPE COMPlex | ENVelope | MAXimum20| MINimum | RMS | SCALar 1992 HP0:CLIMits 1991 21HP0:FAIL? [query only] 1991 HP022:FLIMits 1991 HP0[:DATA]? [query only] 1991 23HP0:POINts? [query only] 1991 24:DATA? [query only] 1995 TK056:DATA 1995 25 TK056:PREamble? [query only] 1994 TK032a 26:DERivative 1993 PH071:STATe 1993 PH071CALCulate 4-1


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:POINts 1993 PH071:FEED 1991 TWIR01p13:FILTER[:GATE]:TIME4:STATe 1992 HP066[:TYPE ] BPASs|NOTCh:STARt :STOP :SPAN :CENTer :POINts :AUTO |ONCE:WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential:KBESsel :EXPonential:FORCe :FREQuency4-2 CALCulate:STATe 1992 HP066[:TYPE ] BPASs|NOTCh:STARt :STOP :SPAN :CENTer :POINts :AUTO |ONCE:WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential:KBESsel :EXPonential:FORCe :FORMat NONE|MLINear|MLOGarithmic|PHASe|REAL|IMAGinary|SWR|GDELay|COMPlex|NYQuist|NICHols|POLar 1991|UPHase 1991 HP0031991 HP003:UPHase:CREFerence 1991 HP003:PREFerence 1991 HP003:GDAPerture:SPAN :APERture


HP01997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:IMMediate:AUTO 1992:INTegral 1993 PH071:STATe 1993 PH0711:TYPE SCALar | MOVing 1993 PH071:LIMit 1991 HP02:STATe 1991,2 HP03:CONTrol 1991 HP0[:DATA] {,} 1991 HP04:POINts? [query only] 1991 HP05:UPPer 1991 HP0[:DATA] {,} 1991 HP06:POINts? [query only] 1991 HP07:STATe 1991 HP0:LOWer 1991 HP08[:DATA] {,} 1991 HP09:POINts? [query only] 1991 HP0:STATe 1991 10HP0:FAIL? [query only] 1991 HP011:FCOunt? [query only] 1991 HP0:REPort 1991 12HP0[:DATA]? [query only] 1991 HP013:POINts? [query only] 1991 HP0:CLEar 1991 14HP0:AUTO 1991 HP015[:IMMediate] [no query] 1991 HP0:INTerpolate 1991 16HP0:MATH17[:EXPRession] 1991 TWI:CATalog? 1993 18 HP083a[:DEFine] 1993 HP083a19:DELete 1993 HP083a[:SELected] 1993 20 HP083a:ALL 1993 HP083a21:NAME 1993 HP083a:STATe 1992 22HP0:SMOothing23[:STATe] 1992 HP0:APERture 24:POINts 25:STATe 1992 HP0:TRANsform26:HISTogram 1993 PH070:COUNt 1993CALCulate 4-3


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES PH070:ORDinate RATio | PERCent | PCT | COUNt 1993 PH070:POINts 1993 PH070:RANGe 1993 PH070:AUTO 1993 PH070:STATe 1993 PH070:TIME4:STATe 1992 HP066[:TYPE ] LPASs|BPASs:STIMulus STEP|IMPulse:STARt :STOP :SPAN :CENTer :POINts :AUTO |ONCE:WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|FORCe|EXPonential:KBESsel:EXPonential:FORCe:DISTance4-4 CALCulate:STATe 1992 HP066[:TYPE ] LPASs|BPASs:STIMulus STEP|IMPulse:STARt :STOP :SPAN :CENTer :POINts :AUTO |ONCE:WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|FORCe|EXPonential:KBESsel :EXPonential :FORCe :FREQuency:STATe 1992 HP066[:TYPE ] LPASs|BPASs:STIMulus STEP|IMPulse:STARt :STOP :SPAN


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:CENTer :POINts :AUTO |ONCE:WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonential:KBESsel :EXPonential 123:FORCe 4:PATH(MATH|TRANsform|FILTer|SMOothing|FORMat|LIMit 199156|AVERage) 1992 HP07{,(MATH|TRANsform|FILTer[query only]|SMOothing|FORMat|LIMit 1991|AVERage)} 19929HP010811121314151617181920212223242526CALCulate 4-5


HP054 FL005HP0541997 SCPI Comm<strong>and</strong> Reference4.1 :AVERage subsystemCALCulate:AVERageThis subsystem provides an analytical post-processing function. The AVERage subsystemcombines successive measurements to produce a new composite result. The new result hasthe same number of points <strong>and</strong> control axis as the original measurement.4A :COUNt comm<strong>and</strong> is provided to specify the number of measurements to combine. When:COUNT averages are reached, the TerminalCONtrol switch specifies the operation of theaverage subsystem. The TerminalCONtrol switch can be configured to continue replacingold values with new values (MOVing), to exponentially weight new measurements(EXPonential), to automatically repeat (REPeat), or to continue adding new measurements inthe NORMal fashon, as specified by :TYPE.The average operation differs from CALC:SMOOthing in the fact that AVERage combinesthe jth point of each measurement with the jth point of preceeding measurements, whereas inSMOOthing the jth point is processed with adjacent points (...., j-2, j-1, j, j+1, j+2, ...) of thecurrent measurement set.A typical device action for CALC:AVERagePH075Figure 4-1 AVERage device action4.1.1 :CLEarCALCulate:AVERage:CLEarThis comm<strong>and</strong> causes the average data to be cleared <strong>and</strong> the average counter reset to zero.4-6 CALCulate:AVERage subsystem


Ed ChangeEd ChangeHP0541997 SCPI Comm<strong>and</strong> Reference4For :TYPE RMS when Xn is realAVGn = √⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺1k Xn2 + k − 1k AVGn 2− 1For :TYPE RMS when Xn is complexAVGn = √⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺1k XnXn∗ + k − 1k AVGn 2− 1The exponential factor k is equal to the AVERage:COUNt value. Someinstruments may use an approximation to true exponential.Operation with EXPonential :TCON is undefined with a :TYPE setting ofMINimum, MAXimum, or ENVelope.MOVing As new data is added the oldest data is discarded.REPeat Clear average data <strong>and</strong> counter <strong>and</strong> restart the average process.NORMal Additional averages continue to be accumulated according to the :TYPEselection.At *RST, this value is device dependent.4.1.5 :TYPE COMPlex | ENVelope | MAXimum | MINimum | RMS | SCALarCALCulate:AVERage:TYPEThis comm<strong>and</strong> selects the type of averaging, as follows:COMPlex The points in the summation are treated as real/imaginary pairs.AVG(n) = 1 nn ∑ X ii = 1ENVelopeIf Xn is realBoth the MIN <strong>and</strong> MAX values are retained.MAXimum AVG(n) = MAX(X1... Xn )MINimum AVG(n) = MIN(X1...Xn)HP081bnRMS AVG(n) =√⎺⎺⎺ 1n ∑i = 1SCALarIf Xn is complexXi 2The scalar magnitude of each point is averaged.AVG(n) = 1 nn ∑ Xii = 1MAXimum AVG(n) = MAX( MAG(X1)... MAG(Xn) )4-8 CALCulate:AVERage subsystemHP081b


HP0HP0HP0HP0HP0HP01997 SCPI Comm<strong>and</strong> ReferenceMINimum AVG(n) = MIN( MAG(X1)...MAG(Xn) )nRMS AVG(n) =√⎺⎺⎺⎺ 1n ∑ XiXi∗i = 1SCALar The scalar magnitude of each point is averaged.AVG(n) = 1 nn ∑ | Xi |i = 1At *RST, this value is device dependent.4.2 :CLIMitsCALCulate:CLIMitsThis node defines comm<strong>and</strong>s to obtain Composite LIMit results within the specifiedCALCulate. It is permissible for CALCulate to contain two or more LIMit tests. These testsmay be active simultaneously. The comm<strong>and</strong>s under CLIMits provide a mechanism todetermine a summary of the PASS/FAIL information, <strong>and</strong> also a way to directly ascertainwhich particular LIMit tests are failing.4.2.1 :FAIL?CALCulate:CLIMits:FAIL?FAIL is a summary of all the individual LIMit:FAILs. If any of the individual LIMit:FAILshave a non-zero value, indicating a failure, the composite FAIL query shall return a 1. Ifthere are no failures then a 0 shall be returned. When all the failed LIMits have beenCLEared, then the composite FAIL shall also be cleared.4.2.2 :FLIMitsCALCulate:CLIMits:FLIMitsThis node provides the information to determine the Failed LIMits, that is, identify howmany <strong>and</strong> which LIMit tests have failed. When all the failed LIMits have been CLEared,then FLIMits shall also be cleared.4.2.2.1 [:DATA]?CALCulate:CLIMits:FLIMits:DATA?This query returns a number or list of numbers, each number corresponds to an instance ofthe LIMit subsystem within the CALCulate block. For example, if CALC:LIMit1,CALC:LIMit2 <strong>and</strong> CALC:LIMit3 existed, the query shall return 1,3, if LIMit1 <strong>and</strong> LIMit3had failed. If there are no failures then NAN shall be returned.4.2.2.2 :POINts?CALCulate:CLIMits:FLIMits:POINts?This query shall return the number of failed LIMits in DATA. If there are no failures then a 0shall be returned.1234567891011121314151617181920212223242526CALCulate:CLIMits 4-9


TWIR01p131997 SCPI Comm<strong>and</strong> Reference44.3 :DATA?CALCulate:DATA?Provides access to the result of the CALCulate subsystem. The query form outputs thepresent CALCulate results.This comm<strong>and</strong> is query-only <strong>and</strong> therefore has no *RST condition.4.3.1 :PREamble?CALCulate:DATA:PREamble?PREamble? returns the preamble information supporting the DATA(CURVe(VALues)) butomits the following data:DIF blocks of waveform, measurement, <strong>and</strong> delta.DIF curve block keywords VALues <strong>and</strong> CSUM <strong>and</strong> their parameters.The DIF difid block must contain the keyword SCOPe with the parameter of PREamble.While the PREamble? query is designed to efficiently transmit data relating directly to thecurve, the various notes <strong>and</strong> identification parameters may be sent if absolutely required.4.4 :DERivativeCALCulate:DERivativeThis subsystem calculates the derivative of the points in a data set. Each point in thedifferentiated data set is the derivative at the corresponding point in the original data set(note this requires some approximation at the end points). The units of the result of thisprocess is the quotient of the currently selected amplitude units of the differentiated data <strong>and</strong>the units of the X-axis.4.4.1 :STATe CALCulate:DERivative:STATeDetermines whether the derivative function is enabled.At *RST this function is OFF4.4.2 :POINts CALCulate:DERivative:POINtsSpecifies the number of points provided to the differential algorithm. They will be centeredabout the current data point.At *RST this value is device dependent.4.5 :FEED CALCulate:FEEDSets or queries the data flow to be fed into the CALCulate block.At *RST, FEED shall be set to a device dependent value.TK056PH071PH071PH0714-10 CALCulate:DATA?


HP01997 SCPI Comm<strong>and</strong> Reference4.6 :FILTerCALCulate:FILTerThis subsystem defines a filtering process to be performed on the SENSe data. A filter canoperate in domains, which may or may not be the domain of the acquisition data.4.6.1 [:GATE]CALCulate:FILTer:GATESpecifies the or modification of the data set according to the selected parameters in a specificdomain.4.6.1.1 :TIMECALCulate:FILTer:GATE:TIMEThis filter selection will modify the acquisition data to remove or modify information in aspecified time region. Units of time are seconds.4.6.1.1.1 :STATe CALCulate:FILTer:GATE:TIME:STATeDetermines whether the time filter is enabled.At *RST, this function is OFF.4.6.1.1.2 [:TYPE ] BPASs|NOTChCALCulate:FILTer:GATE:TIME:TYPESpecifies what occurs to the data in the specific time region. The parameters have thefollowing meanings:BPASs — Pass all information in specified time region <strong>and</strong> reject all else.NOTCh — Reject all information in specified time region <strong>and</strong> pass all else.At *RST, this value is device-dependent.4.6.1.1.3 :STARt CALCulate:FILTer:GATE:TIME:STARtSpecifies the start time of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STARt is set to MIN.4.6.1.1.4 :STOP CALCulate:FILTer:GATE:TIME:STOPSpecifies the stop time of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STOP is set to MIN.1234567891011121314151617181920212223242526CALCulate:FILTer 4-11


1997 SCPI Comm<strong>and</strong> Reference44.6.1.1.5 :SPAN CALCulate:FILTer:GATE:TIME:SPANSpecifies the time span of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, SPAN is set to MIN.4.6.1.1.6 :CENTer CALCulate:FILTer:GATE:TIME:CENTerSpecifies the center time of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, CENTer is set to MIN.4.6.1.1.7 :POINts CALCulate:FILTer:GATE:TIME:POINtsSpecifies the number of points output by the filter subsystem.At *RST, this value is device-dependent.4.6.1.1.7.1 :AUTO |ONCECALCulate:FILTer:GATE:TIME:POINts:AUTOSetting AUTO ON allows POINts to be set by device-dependent parameters (for example,the size of incoming SENSe data).At *RST, AUTO is ON.4.6.1.1.8 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonentialCALCulate:FILTer:GATE:TIME:WINDowSpecifies the type <strong>and</strong> parameter of data windowing (shaping) done prior to the filter.Individual windowing algorithms are defined in “On the Use of Windows for HarmonicAnalysis with the Discrete Fourier Transform,” F. J. Harris, Proc. of the IEEE, Vol. 66-1,January 1978, pp 51-83.At *RST, this value is device-dependent.4.6.1.1.9 :KBESsel CALCulate:FILTer:GATE:TIME:KBESselThe Kaiser BESsel comm<strong>and</strong> sets the parametric window parameter for the Kaiser Besselwindow.At *RST, this value is device-dependent.4.6.1.1.10 :EXPonential CALCulate:FILTer:GATE:TIME:EXPonentialEnters the exponential decay time constant which characterizes the EXPonential window.4-12 CALCulate:FILTer


HP01997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.4.6.1.1.11 :FORCe CALCulate:FILTer:GATE:TIME:FORCeEnters the time value parameter corresponding to the width of the gated portion of the inputtime record for FORCe windows.At *RST, this value is device-dependent.4.6.1.2 :FREQuencyCALCulate:FILTer:GATE:FREQuencyThis filter selection will modify the acquisition data to remove or modify information in aspecified frequency region.Units are Hertz.4.6.1.2.1 :STATe CALCulate:FILTer:GATE:FREQuency:STATeDetermines whether the frequency filter is enabled.At *RST, this function is OFF.4.6.1.2.2 [:TYPE ] BPASs|NOTChCALCulate:FILTer:GATE:FREQuency:TYPESpecifies what occurs to the data in the specific frequency region. The parameters have thefollowing meanings:BPASs — Pass all information in specified time region <strong>and</strong> reject all else.NOTCh — Reject all information in specified frequency region <strong>and</strong> pass all else.At *RST, this value is device-dependent.4.6.1.2.3 :STARt CALCulate:FILTer:GATE:FREQuency:STARtSpecifies the start frequency of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STARt is set to MIN.4.6.1.2.4 :STOP CALCulate:FILTer:GATE:FREQuency:STOPSpecifies the stop frequency of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STOP is set to MIN.1234567891011121314151617181920212223242526CALCulate:FILTer 4-13


1997 SCPI Comm<strong>and</strong> Reference44.6.1.2.5 :SPAN CALCulate:FILTer:GATE:FREQuency:SPANSpecifies the frequency span of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, SPAN is set to MIN.4.6.1.2.6 :CENTer CALCulate:FILTer:GATE:FREQuency:CENTerSpecifies the center frequency of the filter. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, CENTer is set to MIN.4.6.1.2.7 :POINts CALCulate:FILTer:GATE:FREQuency:POINtsSpecifies the number of points output by the filter subsystem.At *RST, this value is device-dependent.4.6.1.2.7.1 :AUTO |ONCECALCulate:FILTer:GATE:FREQuency:POINts:AUTOSetting AUTO ON allows POINts to be set by device-dependent parameters (for example,the size of incoming SENSe data).At *RST, AUTO is ON.4.6.1.2.8 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonentialCALCulate:FILTer:GATE:FREQuency:WINDowSpecifies the type <strong>and</strong> parameter of data windowing (shaping) done prior to the filter.Individual windowing algorithms are defined in “On the Use of Windows for HarmonicAnalysis with the Discrete Fourier Transform,” F. J. Harris, Proc of the IEEE, Vol. 66-1,January 1978, pp 51-83.At *RST, this value is device-dependent.4.6.1.2.9 :KBESsel CALCulate:FILTer:GATE:FREQuency:KBESselThe Kaiser BESsel comm<strong>and</strong> sets the parametric window parameter for the Kaiser Besselwindow.At *RST, this value is device-dependent.4.6.1.2.10 :EXPonential CALCulate:FILTer:GATE:FREQuency:EXPonentialEnters the exponential decay time constant which characterizes the EXPonential window.4-14 CALCulate:FILTer


HP00HP0HP0HP0HP0HP01997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.4.6.1.2.11 :FORCe CALCulate:FILTer:GATE:FREQuency:FORCeEnters the time value parameter corresponding to the width of the gated portion of the inputtime record for FORCe windows.At *RST, this value is device-dependent.4.7 :FORMat NONE|MLINear|MLOGarithmic|PHASe|REAL|IMAGinary|SWR|GDELay|COMPlex|NYQuist|NICHols|POLar|UPHaseCALCulate:FORMatDetermines a simple post-processing of SENSe data. This subsystem is limited to simplepoint-by-point post processing. SENSe data description is x + jy, <strong>and</strong> if no y data, assumey=0. Regardless of the unprocessed data form, the data shall be interpreted as x + jy for thepurposes of defining the formats in the table below.NYQuist is an optional alias for COMPlex. If NYQuist is implemented, COMPlex shall alsobe implemented.NAME EQUATION TYPENONE NONE Unprocessed dataMLINear √⎺⎺⎺⎺⎺ x 2 + y 2(scalar)MLOGarithmic 10∗log(x 2 + y 2 ) (scalar, LOG is base 10)PHASe arctan ( y ) (scalar in current anglexunits, ±180 degrees)IMAGinary y (linear scalar)REAL x (linear scalar)COMPlex|NYQuist pair (x,y) (linear scalar) 1991POLar pair (r1, r2) 1991r1 = √⎺⎺⎺⎺⎺ x 2 + y 2 1991r2 = arctan(y/x) 1991NICHols pair (r1, r2) 1991r1 = 10∗log(x 2 + y 2 ) 1991r2 = arctan(y/x) 19911234567891011121314151617181920212223242526CALCulate:FORMat 4-15


HP002HP003HP0031997 SCPI Comm<strong>and</strong> ReferenceNAME EQUATION TYPE4SWRGDELay(1 + r)WHERE r = MagLIN(data) (scalar)(1 − r)−d(phase)360∗d(frequency)(Scalar; units areseconds. Phasespecified in currentangle units. If currentangle units are radians,replace the constant 360with 2*PI. Thed(frequency) term isreplaced withCALCulate:GDAPerture:APERture in practice.)UPHase UNWRAP(arctan(y/x)) (scalar in current 1991angle units)At *RST, this value is device-dependent.4.7.1 :UPHaseCALCulate:FORMat:UPHaseThe UPHase subsystem is used to specify how unwrapped phase is computed. A referenceposition is specified which is used as an estimate of what the unwrapped phase of calculatedresult should be. The calculated result is constrained to be within +/- 180 degrees of thereference position. Other points are calculated to produce a result which is compatible withthe above constraint <strong>and</strong> does not “wrap” when cardinal points such as +/- 180 degrees arecrossed. The reference position would typically be a well known point in a measurementsuch as the center of a b<strong>and</strong> pass filter.4-16 CALCulate:FORMat


HP0HP01997 SCPI Comm<strong>and</strong> Reference4.7.1.1 :CREFerence CALCulate:FORMat:UPHase:CREFerenceThe Control REFerence comm<strong>and</strong> designates the reference position on the independentdimension, called the control axis (typically the X axis) where the phase unwrap referencepoint is located. This value in combination with the :PREF value identifies the phase unwrapreference point.At *RST, this value is device dependent.4.7.1.2 :PREFerence CALCulate:FORMat:UPHase:PREFerenceThe Phase REFerence comm<strong>and</strong> designates the phase of the phase unwrap reference point.This value in combination with the :CREFerence value identifies the reference point. TheCALC result is constrained to be within +/- 180 degrees of this value at the pointcorresponding to the :CREFerence position.At *RST, this value is device dependent.4.8 :GDAPertureCALCulate:GDAPertureGroup Delay Aperture is defined as the negative of the derivative of phase with respect tofrequency. The group delay format requires specifying an aperture over which themeasurement is made. Since the frequency span of the measurement is known, the frequencystep over the entire span can be thought of as d(freq) This function permits the setting of thataperture. APERture is tightly coupled to SPAN by the equation:APERture = GDAPerture:SPAN/(SENSe|SOURce):FREQuency:SPAN4.8.1 :SPAN CALCulate:GDAPerture:SPANSpecifies the aperture in Hertz. Minimum value is instrument-dependent.At *RST, this function is set to MIN.4.8.2 :APERture CALCulate:GDAPerture:APERtureSpecifies the aperture as a ratio of desired aperture span/measured frequency span.At *RST, this value is set to MIN.1234567891011121314151617181920212223242526CALCulate:GDAPerture 4-17


HP068HP0071997 SCPI Comm<strong>and</strong> Reference44.9 :IMMediateCALCulate:IMMediateCauses the CALCulate subsystem to reprocess existing SENSe data without reacquiring thedata. This permits the user to change a CALCulate subsystem, setting <strong>and</strong> output new resultswithout initiating a data acquisition.Note that CALC:IMMediate? is semantically equivalent to CALC:IMM;DATA?. The queryform outputs the results of the new calculation.This comm<strong>and</strong> describes an event <strong>and</strong> therefore has no associated *RST condition.4.9.1 :AUTO CALCulate:IMMediate:AUTOThe AUTO comm<strong>and</strong> is used to specify if the CALCulate subsystem continually transformsthe data (AUTO ON) whenever any changes are made which would affect the CALCulatesubsystem output. With CALC:IMM:AUTO set to OFF, CALCulate only produces new datawhen data is received or when the CALC:IMMediate comm<strong>and</strong> is received. OnceCALC:IMM:AUTO is set to ON, the CALCulate Subsystem shall produce results when anyCALC subsystem comm<strong>and</strong> is processed, even when new data is not being received. Thisallows the user to make configuration changes in the CALCulate subsystem <strong>and</strong> immediatelyhave new CALC:DATA results on the same sensed data.At *RST, this value is set to OFF.4.10 :INTegralCALCulate:INTegralThis subsystem provides a point to point integration of a data set. The result is an estimate ofthe integral of the input. The units of the result of this process is the product of the currentlyselected amplitude units of the integrated data <strong>and</strong> the units of the X- axis.4.10.1 :STATe CALCulate:INTegral:STATeDetermines whether the integrate function is enabled.At *RST this function is OFF4.10.2 :TYPE SCALar | MOVingCALCulate:INTegral:TYPESpecifies whether the result is a single value (SCALar) or a set of data points (MOVing). IfSCALar is selected the result is an estimate of the definite integral over the entire data set. IfMOVing is selected each point in the integrated data set is the integral up to thecorresponding point in the original data set.At *RST this function is set to a device dependent value.4.11 :LIMitCALCulate:LIMitThe LIMit node collects together the comm<strong>and</strong>s associated with controlling <strong>and</strong> gettingreports from a single LIMit test. The LIMit test may defined as an UPPer limit, a LOWerPH071PH071PH0714-18 CALCulate:IMMediate


HP0HP0HP0HP0HP0HP0HP0HP01997 SCPI Comm<strong>and</strong> Referencelimit, or both. A LIMit test may be defined as being scalar, that is UPPer or LOWer areprovided a single value each.Alternatively, UPPer or LOWer may be defined as a series of points (a vector) representing awaveform limit. For such a vector limit test, each point in the series (vector) must bequalified by where it occurs with respect to the control (typically the X) axis. The CONTrolnode is used to define the points along the control axis. UPPer <strong>and</strong> LOWer represent thedependent (typically the Y) axis, <strong>and</strong> are given values corresponding to these control axispoints. That is, the first value for UPPer <strong>and</strong> LOWer corresponds to the first value ofCONTrol, the second value for UPPer <strong>and</strong> LOWer corresponds to the second value ofCONTrol, <strong>and</strong> so on. UPPer, LOWer <strong>and</strong> CONTrol shall contain the same number of points,or an error shall be generated when data processing commences. For scalar limit tests, asdescribed earlier, the CONTrol subsystem is not used.If the data <strong>and</strong> the limit are scalar (single values), then LIMit shall produce results for eachpiece of scalar data tested. If the data <strong>and</strong> the limit are both vectors, then LIMit shall produceresults for each vector data tested. If the limit is scalar <strong>and</strong> the data is a vector, then LIMitshall perform a the limit test by treating the scalar limit as an equivalent vector (all pointshaving the same value).4.11.1 :STATe CALCulate:LIMit:STATeIs used to set or query if the LIMit test is active or not.At *RST, this is set to OFF.4.11.2 :CONTrolCALCulate:LIMit:CONTrolThis node collects the comm<strong>and</strong>s <strong>and</strong> queries used to set up the control axis of the limit data,where the limit test is not based on a single point.4.11.2.1 [:DATA] {,}CALCulate:LIMit:CONTrol:DATASets or queries the CONTrol axis data.4.11.2.2 :POINts?CALCulate:LIMit:CONTrol:POINts?The POINts? query returns the number of points currently in CONTrol:DATA.4.11.3 :UPPerCALCulate:LIMit:UPPerUPPer is used to define the upper limit to be used in the LIMit test. When the data is greaterthan the value specified in UPPer, LIMit shall report a fail. That is, when the data is equal tothe limit, a fail shall not be reported.4.11.3.1 [:DATA] {,}CALCulate:LIMit:UPPer:DATASets or queries the UPPer axis data.1234567891011121314151617181920212223242526CALCulate:LIMit 4-19


HP007HP007HP007HP007HP007HP007HP007HP007HP007HP0071997 SCPI Comm<strong>and</strong> Reference4.11.3.2 :POINts?CALCulate:LIMit:UPPer:POINts?The POINts? query returns the number of points currently in UPPer:DATA.4.11.3.3 :STATe CALCulate:LIMit:UPPer:STATeSets or queries if the individual LIMit test is enabled.4At *RST, this is set to ON.4.11.4 :LOWerCALCulate:LIMit:LOWerLOWer is used to define the lower limit to be used in the LIMit test. When the data is lessthan the value specified in LOWer, LIMit shall report a fail. That is, when the data is equalto the limit, a fail shall not be reported.4.11.4.1 [:DATA] {,}CALCulate:LIMit:LOWer:DATASets or queries the LOWer axis data.4.11.4.2 :POINts?CALCulate:LIMit:LOWer:POINts?The POINts? query returns the number of points currently in LOWer:DATA.4.11.4.3 :STATe CALCulate:LIMit:LOWer:STATeSets or queries if the individual LIMit test is enabled.At *RST, this is set to ON.4.11.5 :FAIL?CALCulate:LIMit:FAIL?This query returns a 0 or 1, to indicate if the LIMit test has failed or not; 0 represents pass<strong>and</strong> 1 represents fail.4.11.6 :FCOunt?CALCulate:LIMit:FCOunt?This Fail COunt query returns the number of times that the LIMit test has failed. With a 0indicating no failures. With vector limits <strong>and</strong> vector data, only one failure shall be recordedwith each (measurement) vector that is tested, even if many points are outside the limits.4.11.7 :REPortCALCulate:LIMit:REPortThis node collects together comm<strong>and</strong>s to get a more detailed information on vector limittests.4.11.7.1 [:DATA]?CALCulate:LIMit:REPort:DATA?This query returns a number or list of numbers, each number corresponds to a value of theCONTrol variable where either the UPPer or LOWer limit test has failed. Note that: When4-20 CALCulate:LIMit


HP0HP0HP0HP0HP0TWIR011997 SCPI Comm<strong>and</strong> ReferenceINTerpolate ON has been selected, the returned DATA shall correspond to the points alongthe CONTrol axis where a failure has occured, which may or may not coincide with pointsdefined for CONTrol. If there are no failures then NAN shall be returned.4.11.7.2 :POINts?CALCulate:LIMit:REPort:POINts?This query shall return the number of points in the DATA. If there are no failures then a 0shall be returned.4.11.8 :CLEarCALCulate:LIMit:CLEarThe CLEar node collects together the comm<strong>and</strong>s that are used to clear the information inDATA, FAIL <strong>and</strong> REPort.4.11.8.1 :AUTO | ONCECALCulate:LIMit:CLEar:AUTOSets or queries if the information is to be CLEared with each INITiate comm<strong>and</strong>, or moreprecisely when the TRIGger state machine exits the “IDLE state.” Such an INITiate shallcause the information in FAIL, FCOunt <strong>and</strong> REPort to be cleared if AUTO is set to ON. IfAUTO is set to OFF, no such effect shall occur.At *RST, AUTO shall be set to ON.4.11.8.2 [:IMMediate]CALCulate:LIMit:CLEar:IMMediateIMMediate shall cause the information in FAIL, FCOunt <strong>and</strong> REPort to be clearedIMMediately.4.11.9 :INTerpolate CALCulate:LIMit:INTerpolateSets or queries whether or not limit tests will be performed at points between those specifiedby the CONTrol variable. The interpolation shall be straight line between points, howeverthe algorithm determining the number of samples between points is device dependent.At *RST, it shall be OFF.4.12 :MATHCALCulate:MATHThis subsystem permits processing of sense data in numerical expression format. Theoperators are +, -, *, / <strong>and</strong> use of constants <strong>and</strong> data arrays are permitted.4.12.1 [:EXPRession] CALCulate:MATH:EXPRessionThis subsystem controls which expression is used by the CALCulate block.4.12.1.1 :CATalog?CALCulate:MATH:EXPRession:CATalog?12345678910111213141516171819202122232425HP083a26CALCulate:MATH 4-21


1997 SCPI Comm<strong>and</strong> ReferenceThe CATalog query lists all the defined expressions. Response is a list of comma-separatedstrings. Each string contains the name of an expression. If no expressions are currentlydefined, the response ia a null string ("").4.12.1.2 [:DEFine] CALCulate:MATH:EXPRession:DEFineDefines the expression used for the math operations. The maycontain any of the following as oper<strong>and</strong>s <strong>and</strong> they may occur in any combination:HP083a4A The reserved keyword IMPLiedThe associated with another blockThe reserved keyword IMPLied, refers to the IMPLied output of the previous CALCulatesub-block. The ordering of the sub-blocks is specified by the PATH comm<strong>and</strong>. If the MATHsubsystem appears first in the PATH, then the IMPLied keyword refers to the specified with the FEED comm<strong>and</strong>.For example, to subtract a reference trace from the SENSe data, the following comm<strong>and</strong>would configure the MATH appropriately.CALCulate:MATH:EXPRession (IMPLied - MY-TRACE)This example assumes that the FEED comm<strong>and</strong> has been configured to select the appropriateSENSe . The IMPLied CALCulate data flow can be ignored <strong>and</strong> the SENSedata may be used directly in a :CALCulate:MATH:EXPRession ( “SENSe1:POWer 3" - MY-TRACE)At *RST, this function is undefined.4.12.1.3 :DELeteCALCulate:MATH:EXPRession:DELeteThe DELete subsytem deletes expressions.4.12.1.3.1 [:SELected] CALCulate:MATH:EXPRession:DELete:SELectedThis comm<strong>and</strong> causes the selected expression to be deleted.4.12.1.3.2 :ALLCALCulate:MATH:EXPRession:DELete:ALLThis comm<strong>and</strong> causes the all expressions to be deleted.4.12.1.4 :NAME CALCulate:MATH:EXPRession:NAMEThe NAME comm<strong>and</strong> defines the name of the expression to be selected. If the expressionname, , already exists, then that existing expression shall be selected. Ifthe expression name does not exist, then the new name shall be selected, but no expressionshall be defined by this selection. is character data.HP083aHP083aHP083aHP083aAt *RST the value of NAME is device dependent.4-22 CALCulate:MATH


HP0HP0HP01997 SCPI Comm<strong>and</strong> Reference4.12.2 :STATe CALCulate:MATH:STATeDetermines whether math processing is done.At *RST, this function is OFF.4.13 :SMOothingCALCulate:SMOothingThis subsystem specifies point-to-point smoothing of a data set. A data point in a smootheddata set is the average of adjacent points from a single original data set. Smoothing differsfrom averaging, in which a given point is the average of corresponding points from multipledata sets or acquisitions.4.13.1 [:STATe] CALCulate:SMOothing:STATeDetermines whether the smoothing algorithm is enabled.At *RST, this function is OFF.4.13.2 :APERture CALCulate:SMOothing:APERtureSpecifies the size of the smoothing APERture as a ratio of smoothing aperture points/tracepoints.At *RST, this function is device-dependent.4.13.3 :POINts CALCulate:SMOothing:POINtsControls the number of points to be included in the running average. POINts is coupled toAPERture by the equation:POINts = APERture * TRACe:POINts4.14 :STATe CALCulate:STATeControls whether postprocessing is enabled. If disabled, this subsystem is effectivelytransparent.At *RST, this is set ON.4.15 :TRANsformCALCulate:TRANsformTRANsform is the subsystem that permits sense data to be transformed from one domain toanother. Examples are from frequency domain to time domain or time domain to frequencydomain. This is different from a SENSe:FUNC selection of domain because in SENSe, thedata is actually collected in the selected domain, while in CALCulation:TRANsform, thedata is computed, for example, by use of Fourier Transform.1234567891011121314151617181920212223242526CALCulate:SMOothing 4-23


1997 SCPI Comm<strong>and</strong> Reference4.15.1 :HISTogramCALCulate:TRANsform:HISTogramThis subsystem transforms the data into a histogram. The histogram provides an amplitudedistribution of the incoming signal. The points in a histogram specify the ratio between thenumber number of times a data point is within a particular amplitude belt <strong>and</strong> the totalnumber of incoming data points that participate in the transformation. The ratio is expressedas a percentage.PH0704The resolution of the histogram is specified by the number of points of the output signal. Itdetermines the amplitude belt wherein the data points are counted, using the equation:amplitude belt = amplitude range / histogram pointsThe units of the amplitude range are the currently selected amplitude units of the data to betransformed.4.15.1.1 :COUNt CALCulate:TRANsform:HISTogram:COUNtThis specifies the number of measurements to include in the histogram.PH070For scalar measurements, COUNt is the number of incoming data points that are used tocreate the histogram.The COUNt for array based results is independent of the number of points in the result array.For example, an instrument which normally provides a measurement result which is a 401point array would specify a histogram count of two to create a histogram based on 802 datapoints.At *RST this value is device dependent4.15.1.2 :ORDinate RATio | PERCent | PCT | COUNtCALCulate:TRANsform:HISTogram:ORDinateWhen ORDinate is set to RATio, the output of the HISTogram function is an absolute ratio.When ORDinate is set to PERCent, the output of the HISTogram function is PERCent(RATio*100). When ORDinate is set to COUNt, the output of the HISTogram function isthe number of points in that amplitude belt.PH070PCT is provided as a synonym for PERCent since IEEE 488.2 allows the use of PCT as anumeric suffix.At *RST this value is device dependent.4.15.1.3 :POINts CALCulate:TRANsform:HISTogram:POINtsSpecifies the number of POINts (amplitude belts) in the histogram.PH070At *RST this value is device dependent.4.15.1.4 :RANGeCALCulate:TRANsform:HISTogram:RANGeThis node collects the comm<strong>and</strong>s used to control the size of the amplitude belts.PH0704-24 CALCulate:TRANsform


HP01997 SCPI Comm<strong>and</strong> Reference4.15.1.4.1 :AUTO CALCulate:TRANsform:HISTogram:RANGe:AUTOWith AUTO ON, the number of output points is determined by the amplitude of theincoming data via a device dependent algorithm.At *RST this function is set to a device dependent value.4.15.1.5 :STATe CALCulate:TRANsform:HISTogram:STATeDetermines whether the histogram transformation is enabled.At *RST this function is OFF4.15.2 :TIMECALCulate:TRANsform:TIMESpecifies a transformation of data into its equivalent time representation. The parametersspecify the time region over which the output data is transformed. The units are seconds.4.15.2.1 :STATe CALCulate:TRANsform:TIME:STATeDetermines whether the time transform is enabled.At *RST, this function is OFF.4.15.2.2 [:TYPE ] LPASs|BPASsCALCulate:TRANsform:TIME:TYPESelects a particular method to be used in b<strong>and</strong> limiting information or the manner in whichwindows should be applied.When LPASs is selected, the windowing shall affect only the end of the data set. LPASsrequires data to start from zero in the appropriate units, such as Hertz <strong>and</strong> seconds. If thedata set does not extend to zero, then the instrument shall either compute by extrapolationthe extra points needed to complete the data set, or shall generate an execution (-200) error.When BPASs is selected, the applied window shall affect both the start <strong>and</strong> end parts of thedata set.At *RST, this value is device-dependent.4.15.2.3 :STIMulus STEP|IMPulseCALCulate:TRANsform:TIME:STIMulusSpecifies the type of stimulus to be simulated in the transform process.At *RST, this value is device-dependent.4.15.2.4 :STARt CALCulate:TRANsform:TIME:STARtSpecifies the start time of the output data record. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STARt is set to MIN.PH07012PH07034567891011121314151617181920212223242526CALCulate:TRANsform 4-25


1997 SCPI Comm<strong>and</strong> Reference44.15.2.5 :STOP CALCulate:TRANsform:TIME:STOPSpecifies the stop time of the output data record. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STOP is set to MIN.4.15.2.6 :SPAN CALCulate:TRANsform:TIME:SPANSpecifies the time span of the output data record. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, SPAN is set to MIN.4.15.2.7 :CENTer CALCulate:TRANsform:TIME:CENTerSpecifies the center time of the output data record. Range is instrument- <strong>and</strong> setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, CENTer is set to MIN.4.15.2.8 :POINts CALCulate:TRANsform:TIME:POINtsSpecifies the number of points output by the transform subsystem.At *RST, this value is device-dependent.4.15.2.8.1 :AUTO |ONCECALCulate:TRANsform:TIME:POINts:AUTOWhen AUTO is ON, the number of points is determined by the size of the incoming SENSeData.At *RST, AUTO is ON.4.15.2.9 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonentialCALCulate:TRANsform:TIME:WINDowSpecifies the type <strong>and</strong> parameter of data windowing (shaping) done prior to thetransformation.At *RST, this value is device-dependent.Individual windowing algorithms are defined in “On the Use of Windows for HarmonicAnalysis with the Discrete Fourier Transform,” F. J. Harris, Proc. of the IEEE, Vol. 66-1,January 1978, pp 51-83.4-26 CALCulate:TRANsform


HP01997 SCPI Comm<strong>and</strong> Reference4.15.2.10 :KBESsel CALCulate:TRANsform:TIME:KBESselThe Kaiser BESsel comm<strong>and</strong> sets the parametric window parameter for the Kaiser Besselwindow.At *RST, this value is device-dependent.4.15.2.11 :EXPonential CALCulate:TRANsform:TIME:EXPonentialEnters the exponential decay time constant which characterizes the EXPonential window.At *RST, this value is device-dependent.4.15.2.12 :FORCe CALCulate:TRANsform:TIME:FORCeEnters the time value parameter corresponding to the width of the gated portion of the inputtime record for FORCe windows.At *RST, this value is device-dependent.4.15.3 :DISTanceCALCulate:TRANsform:DISTanceThis subsystem specifies a transformation of data into its equivalent distance representation.The parameters specify the distance region over which the output data is transformed. Theunits are meters.4.15.3.1 :STATe CALCulate:TRANsform:DISTance:STATeDetermines whether the distance transform is enabled.At *RST, this function is OFF.4.15.3.2 [:TYPE ] LPASs|BPASsCALCulate:TRANsform:DISTance:TYPESelects a particular method to be used in limiting information or the manner in whichwindows shall be applied for the specified transform.When LPASs is selected, the windowing shall affect only the end of the data set. LPASsrequires data to start from zero in the appropriate units, such as Hertz <strong>and</strong> seconds. If thedata set does not extend to zero, then the instrument shall either compute by extrapolationthe extra points needed to complete the data set, or shall generate an execution (-200) error.When BPASs is selected, the applied window shall affect both the start <strong>and</strong> end parts of thedata set.At *RST, this value is device-dependent.4.15.3.3 :STIMulus STEP|IMPulseCALCulate:TRANsform:DISTance:STIMulusSpecifies the type of stimulus to be simulated in the transform process.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526CALCulate:TRANsform 4-27


1997 SCPI Comm<strong>and</strong> Reference44.15.3.4 :STARt CALCulate:TRANsform:DISTance:STARtSpecifies the start distance of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STARt is set to MIN.4.15.3.5 :STOP CALCulate:TRANsform:DISTance:STOPSpecifies the stop distance of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STOP is set to MIN.4.15.3.6 :SPAN CALCulate:TRANsform:DISTance:SPANSpecifies the distance span of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, SPAN is set to MIN.4.15.3.7 :CENTer CALCulate:TRANsform:DISTance:CENTerSpecifies the center distance of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, CENTer is set to MIN.4.15.3.8 :POINts CALCulate:TRANsform:DISTance:POINtsSpecifies the number of points output by the transform subsystem.At *RST, this is set to a device-dependent value.4.15.3.8.1 :AUTO |ONCECALCulate:TRANsform:DISTance:POINts:AUTOWhen AUTO is ON, the number of points is determined by the size of the incoming SENSedata.At *RST, AUTO is ON.4-28 CALCulate:TRANsform


HP01997 SCPI Comm<strong>and</strong> Reference4.15.3.9 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonentialCALCulate:TRANsform:DISTance:WINDowSpecifies the type <strong>and</strong> parameter of data windowing (shaping) done prior to thetransformation.At *RST, this value is device-dependent.Individual windowing algorithms are defined in “On the Use of Windows for HarmonicAnalysis with the Discrete Fourier Transform,” F. J. Harris, Proc. of the IEEE, Vol. 66-1,January 1978, pp 51-83.4.15.3.10 :KBESsel CALCulate:TRANsform:DISTance:KBESselThe Kaiser BESsel comm<strong>and</strong> sets the parametric window parameter for the Kaiser Besselwindow.At *RST, this value is device-dependent.4.15.3.11 :EXPonential CALCulate:TRANsform:DISTance:EXPonentialEnters the exponential decay time constant which characterizes the EXPonential window.At *RST, this value is device-dependent.4.15.3.12 :FORCe CALCulate:TRANsform:DISTance:FORCeEnters the time value parameter corresponding to the width of the gated portion of the inputtime record for FORCe windows.At *RST, this value is device-dependent.4.15.4 :FREQuencyCALCulate:TRANsform:FREQuencyThis subsystem specifies a transformation of data into its equivalent frequencyrepresentation. The parameters specify the frequency region over which the output data istransformed. The units are Hertz.4.15.4.1 :STATe CALCulate:TRANsform:FREQuency:STATeDetermines whether the frequency transform is enabled.At *RST, this function is OFF.4.15.4.2 [:TYPE ] LPASs|BPASsCALCulate:TRANsform:FREQuency:TYPESelects a particular method to be used in limiting information or the manner in whichwindows shall be applied for the specified transform.When LPASs is selected, the windowing shall affect only the end of the data set. LPASsrequires data to start from zero in the appropriate units, such as Hertz <strong>and</strong> seconds. If the1234567891011121314151617181920212223242526CALCulate:TRANsform 4-29


1997 SCPI Comm<strong>and</strong> Reference4data set does not extend to zero, then the instrument shall either compute by extrapolationthe extra points needed to complete the data set, or shall generate an execution (-200) error.When BPASs is selected, the applied window shall affect both the start <strong>and</strong> end parts of thedata set.At *RST, this value is device-dependent.4.15.4.3 :STIMulus STEP|IMPulseCALCulate:TRANsform:FREQuency:STIMulusSpecifies the type of stimulus to be simulated in the transform process.At *RST, this selection is device-dependent.4.15.4.4 :STARt CALCulate:TRANsform:FREQuency:STARtSpecifies the start frequency of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STARt is set to MIN.4.15.4.5 :STOP CALCulate:TRANsform:FREQuency:STOPSpecifies the stop frequency of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, STOP is set to MIN.4.15.4.6 :SPAN CALCulate:TRANsform:FREQuency:SPANSpecifies the frequency span of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, SPAN is set to MIN.4.15.4.7 :CENTer CALCulate:TRANsform:FREQuency:CENTerSpecifies the center frequency of the output data record. Range is instrument- <strong>and</strong>setup-dependent.The couplings between STARt, STOP, CENTer, <strong>and</strong> SPAN are the same as described in theSENSe subsystem.At *RST, CENTer is set to MIN.4-30 CALCulate:TRANsform


HP01997 SCPI Comm<strong>and</strong> Reference4.15.4.8 :POINts CALCulate:TRANsform:FREQuency:POINtsSpecifies the number of points output by the transform subsystem.At *RST, this value is device-dependent.4.15.4.8.1 :AUTO |ONCECALCulate:TRANsform:FREQuency:POINts:AUTOWhen AUTO is ON, the number of points is determined by the size of the incoming SENSeData.At *RST, AUTO is ON.4.15.4.9 :WINDow RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonentialCALCulate:TRANsform:FREQuency:WINDowThis specifies the type <strong>and</strong> parameter of data windowing (shaping) done prior to thetransformation.At *RST, this value is device-dependent.Individual windowing algorithms are defined in “On the Use of Windows for HarmonicAnalysis with the Discrete Fourier Transform,” F. J. Harris, Proc. of the IEEE, Vol. 66-1,January 1978, pp 51-83.4.15.4.10 :KBESsel CALCulate:TRANsform:FREQuency:KBESselThe Kaiser BESsel comm<strong>and</strong> sets the parametric window parameter for the Kaiser Besselwindow.At *RST, this value is device-dependent.4.15.4.11 :EXPonential CALCulate:TRANsform:FREQuency:EXPonentialEnters the exponential decay time constant which characterizes the EXPonential window.At *RST, this value is device-dependent.4.15.4.12 :FORCe CALCulate:TRANsform:FREQuency:FORCeEnters the time value parameter corresponding to the width of the gated portion of the inputtime record for FORCe windows.At *RST, this value is device-dependent.4.16 :PATH (MATH|TRANsform|FILTer|SMOothing|FORMat|LIMit|AVERage){,(MATH|TRANsform|FILTER|SMOothing|FORMat|LIMit|AVERage)}CALCulate:PATHThis subsystem defines the order in which CALCulate subsystems are to be performed. Inmany instruments this will be fixed <strong>and</strong> instrument-dependent. If it is possible to order theoperations, then PATH is the method.1234567891011121314151617181920212223242526CALCulate:PATH 4-31


TWIR01p141997 SCPI Comm<strong>and</strong> Reference4For example, if TRANsform is first, then FILTer, <strong>and</strong> finally MATH, the following wouldbe sent:CALCulate:PATH TRANsform,FILTer,MATHEven if not settable, the query of PATH should return the actual order of operations.The suffix of each subsystem used as a parameter in the PATH comm<strong>and</strong> corresponds to theinstance of the specified CALCulate subsystem sub-block. For example, the comm<strong>and</strong>PATH FILTer1, FILTer2, sets up the data flow through the filter defined byCALCulate:FILTer1 <strong>and</strong> then through the filter defined by CALCulate:FILTer2.At *RST, the PATH definition is set to a device-dependent setting.4-32 CALCulate:PATH


1997 SCPI Comm<strong>and</strong> Reference5 CALibration SubsystemThis subsystem has the function of performing system calibration.KEYWORD PARAMETER FORM NOTESCALibration[:ALL] [event; no query] 1994[:ALL]?[event; query]:AUTO|ONCE:DATA:SOURce INTernal|EXTernal:STATe:VALue:ZERO:AUTO |ONCE5.1 [:ALL]CALibration:ALLThe CALibrate:ALL comm<strong>and</strong> performs the same function as the CALibrate:ALL? exceptthere is no response. An instrument shall report calibration errors through thestatus-reporting mechanism.If this comm<strong>and</strong> is implemented as overlapped it shall be included in the No OperationPending flag (see IEEE 488.2 chapter 12).While this comm<strong>and</strong> is executing the CALibrating bit of the Operation Status Conditionregister shall be set (see 9.3 of <strong>Syntax</strong> & <strong>Style</strong>).5.2 [:ALL]?CALibration:ALL?The ALL? query performs a full calibration of the instrument <strong>and</strong> responds with a indicating the success of the calibration. A zero shall be returned ifcalibration is completed successfully; otherwise a nonzero value which represents theappropriate error number shall be returned. An instrument shall still report calibration errorsthrough the status-reporting mechanism, even though an error is reported by the value of thequery response.5.3 :AUTO |ONCECALibration:AUTOAUTO sets whether or not the instrument should perform auto calibration atdevice-dependent intervals without user intervention.At *RST, AUTO OFF is selected.5.4 :DATA CALibration:DATATransfers the calibration data as arbitrary block program data. The query form returns thecurrent calibration data. The block is transferred into the current calibration data. If an erroroccurs during the transfer causing the calibration to be lost, an error -313 shall be generatedin addition to the execution error.1TK0292EDIT34567TK0298TK029 91011 TK0291213 TK02914151617181920212223242526CALibration[:ALL] 5-1


1997 SCPI Comm<strong>and</strong> Reference55.5 :SOURce INTernal|EXTernalCALibration:SOURceControls the source of the calibration signal. If set to INTernal, a reference internal to theinstrument is selected. If SOURce is set to EXTernal, then an external reference shall beapplied.5.6 :STATe CALibration:STATeSTATe is used to select if the calibration data is applied or not. If STATe is ON then theinstrument uses the calibration data for correction. If STATe OFF is selected, then nocorrection using the calibration data shall be made.At *RST, STATe is set to ON.5.7 :VALue CALibration:VALueEnters the value of the reference signal which is used in the calibration. For example, avoltmeter may calibrate its input to a reference signal which has a proven value of4.99327513 Volts.5.8 :ZEROCALibration:ZEROThis subsystem controls the autozero calibration of the sensor.5.8.1 :AUTO |ONCECALibration:ZERO:AUTOControls whether autozeroing calibration occurs.At *RST, this value is set to OFF.5-2 CALibration:SOURce


1997 SCPI Comm<strong>and</strong> Reference6 CONTrol Subsystem XSS01cThe CONTrol subsystem is used primarily to turn on <strong>and</strong> off electromechanical devices thatare used in the test <strong>and</strong> process control environments.KEYWORD PARAMETER FORM NOTES1:CONTRol 1993 XSS01c:BLOWer 1993 XSS01c 2[:STATe] 1993 XSS01c 3:COMPressor 1993 XSS01c[:STATe] 1993 XSS01c 4:APOWer 1993 XSS01c 5[:STATe] 1993 XSS01c66.1 :BLOWer XSS01cCONTrol:BLOWer7Controls the BLOWer.8For example, in order to keep a uniform temperature inside the environment chamber, the air 9inside needs to be thoroughly mixed. This is usually accomplished using a blower.106.1.1 :STATe XSS01cCONTrol:BLOWer:STATe11Turns the BLOWer ON <strong>and</strong> OFF.At *RST this value is set to OFF.12136.2 :COMPressor XSS01c14CONTrol:COMPressorControls the COMPressor.For example in an environmental chamber, a compressor is often needed additional controlof the heating <strong>and</strong> cooling.1516176.2.1 :STATe XSS01c18CONTrol:COMPressor:STATeTurns the COMPressor ON <strong>and</strong> OFF.At *RST this value is set to OFF.19206.3 :APOWer 21 XSS01cCONTrol:APOWerControls the Auxiliary POWer. Auxiliary POWer are additional power outlets that can beused to power devices.22236.3.1 :STATe 24 XSS01cCONTrol:APOWer:STATeTurns the APOWer ON <strong>and</strong> OFF.At *RST this value is set to OFF.2526CONTrol Subsystem:BLOWer 6-1


1997 SCPI Comm<strong>and</strong> Reference66-2 CONTrol Subsystem:APOWer


1997 SCPI Comm<strong>and</strong> Reference7 DIAGnostic SubsystemThe purpose of the DIAGnostic subsystem is to provide a tree node for all of the instrumentservice <strong>and</strong> diagnostic routines used in routine maintenance <strong>and</strong> repair. The actualcomm<strong>and</strong>s in this subsystem are considered instrument-specific, <strong>and</strong> therefore are notincluded in this document. Instrument designers are free to add service <strong>and</strong> diagnosticcomm<strong>and</strong>s to meet the needs of individual instruments.1234567891011121314151617181920212223242526DIAGnostic Subsystem 7-1


1997 SCPI Comm<strong>and</strong> Reference77-2 DIAGnostic Subsystem


1997 SCPI Comm<strong>and</strong> Reference8 DISPlay SubsystemThe DISPlay subsystem controls the selection <strong>and</strong> presentation of textual, graphical, <strong>and</strong>TRACe information. This information includes measurement data, user-interaction displays,<strong>and</strong> data presented to the instrument by the controller. DISPlay is independent of, <strong>and</strong> doesnot modify, how data is returned to the controller.Multiple DISPlay subsystems are used to represent independent display medium. A frontpanel mounted display <strong>and</strong> an attached terminal used only for information display are 3examples of independent displays. Conversely, an instrument with many dedicatedindicators is considered to have one general display because of the dependencies in operation 4that exist between the indicators.5Within a DISPlay, information may be separated into individual WINDows (this is always 6the case for instruments with dedicated indicators). Each window is considered to consist ofthree overlapped planes, one each for text, graphics, <strong>and</strong> trace data. Thus, text, graphics, <strong>and</strong> 7trace information may be presented at the same time in a given window.Most of the *RST conditions in the DISPlay subsystem are device-dependent, toaccommodate for typical display functions that exist for each of the various categories ofinstrumentation.8910KEYWORD PARAMETER FORM NOTES11DISPlay12:ANNotation[:ALL]13:AMPLitude 14:CMAP:DEFault [event; no query]:COLor 1992:FREQuency :BRIGhtness 151617:HSL ,, 1992 18:RGB ,, 1992:CONTrast 19:ENABle 20:MENU[:NAME] 21:STATe 1992 HP022:KEY[:WINDow]:BACKground:COLor :GEOMetry232425:LLEFt ,26:SIZe ,:URIGht ,DISPlay 8-112


1997 SCPI Comm<strong>and</strong> Reference8KEYWORD PARAMETER FORM NOTES:GRAPhics:CLEar[event; no query]:COLor :CSIZe [:DRAW] ,:PCL:HPGL :IDRaw ,:IMOVe ,:LABel :LDIRection :LTYPe [,]:MOVE ,:STATe [:STATe] :TEXT:ATTRibutes :CLEar[event; no query]:COLor :CSIZe [:DATA] | :FEED 1991 TWIR01p15:LOCate [,]:PAGE 1991 HP005:STATe :TRACe:COLor :FEED 1991 TWIR01p15:GRATicule:AXIS[:STATe]:COLor:FRAMe[:STATe]:GRID:AUTO[:STATe]:PERSistence:AUTO[:STATe]:X:LABel[:SCALe]|ONCE8-2 DISPlay


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:AUTO | ONCE 1991 HP0:CENTer 1991 BalanHP0:LEFT :PDIVision 1991 HP01:LINK LEFT|CENTer|RIGHt 1991 HP0:RIGHt 2:SPACing LINear | LOGarithmic:Y3:LABel 4:RLINe 1991 HP05[:SCALe]:AUTO | ONCE 1991 HP06:BOTTom7:PDIVision 1991 HP0:RLEVel 1991 HP08:AUTO 1991 HP09:RPOSition 1991 HP0:TOP 10:SPACing LINear | LOGarithmic:R11:LABel 12[:SCALe]13:AUTO | ONCE 1991 HP0:CPOint 14:OEDGe :SPACing LINear | LOGarithmic151617181920212223242526DISPlay 8-3


JP Change1997 SCPI Comm<strong>and</strong> Reference8.1 :ANNotationDISPlay:ANNotationThis subsystem controls which annuciators are visible. ANNotation does not affect thevisibility of GRATicule. If SYSTem:SECurity is enabled, annotation cannot be switchedfrom OFF to ON.The ANNotation parameters are set to ON at *RST, unless SYSTem:SECurity is enabled.8.1.1 [:ALL] DISPlay:ANNotation:ALLControls ALL of the annotation information.8.1.2 :AMPLitude DISPlay:ANNotation:AMPLitudeControls the amplitude annotation information.88.1.3 :FREQuency DISPlay:ANNotation:FREQuencyControls the frequency annotation information.8.2 :BRIGhtness DISPlay:BRIGhtnessControls the intensity of the display. The range of the parameter is 0 to 1, where 1 is fullintensity <strong>and</strong> 0 is fully blanked.8.3 :CMAPDISPlay:CMAPThe CMAP subsystem controls the physical color associated with logical color numbers inthe color map of the display. On a monochrome DISPlay, the CMAP may be used torepresent different intensity levels of the same shade. When a color is redefined, allinformation associated with that color number may change immediately.Two methods are available for defining a particular color, HSL <strong>and</strong> RGB models. If both areimplemented in a device, then they shall be coupled such that redefining a color with onemodel shall be reflected in the values of the other model.At *RST, COLor[1] shall represent “black,” <strong>and</strong> COLor2 shall represent “white” or theactual color of a monochrome display.8.3.1 :DEFaultDISPlay:CMAP:DEFaultSets the color map to the instrument’s default values for all colors, except that COLor[1]shall be represent “black,” <strong>and</strong> COLor2 shall represent “white” or the actual color of amonochrome display.8.3.2 :COLorDISPlay:CMAP:COLorThis subsystem controls the color map for the instrument.8-4 DISPlay:ANNotation


1997 SCPI Comm<strong>and</strong> Reference8.3.2.1 :HSL ,,DISPlay:CMAP:COLor:HSLThe HSL comm<strong>and</strong> sets the instrument’s color map based on the Hue/Saturation/Luminancelevels color model. A query of HSL shall return three s separated by commas.Hue ranges from zero to one, circularly, with a value of zero resulting in the same hue as avalue of one. The approximate color progression is (starting at zero): red, orange, yellow,green, cyan, blue, magenta, <strong>and</strong> back to red.Saturation is the amount of pure color to be mixed with white. The saturation value rangesfrom zero to one, with zero specifying no color (only white or gray, depending on intensity)<strong>and</strong> one specifying no white.Luminance specifies the brightness per unit area of the color. A luminance of zero results inblack; a luminance of one results in the brightest color available.At *RST, these parameters are set to the DEFault values, equivalent to executing DEFaultcomm<strong>and</strong>. The HSL comm<strong>and</strong> is coupled to the RGB comm<strong>and</strong>. Changing values in eitherwill affect the values of the other.8.3.2.2 :RGB ,,DISPlay:CMAP:COLor:RGBThe RGB comm<strong>and</strong> sets the instrument’s color map based on the Red/Green/Blue colormodel. A query of RGB shall return three s separated by commas.Red ranges from zero to one, with zero indicating “no red” <strong>and</strong> one indicating “full intensityred.”Green ranges from zero to one, with zero indicating “no green” <strong>and</strong> one indicating “fullintensity green.”Blue ranges from zero to one, with zero indicating “no blue” <strong>and</strong> one indicating “fullintensity blue.”At *RST, these parameters are set to the DEFault values, equivalent to executing DEFaultcomm<strong>and</strong>. The RGB comm<strong>and</strong> is coupled to the HSL comm<strong>and</strong>. Changing values in eitherwill affect the values of the other.8.4 :CONTrast DISPlay:CONTrastDetermines the relative difference in brightness between “full” intensity <strong>and</strong> “no” intensityas displayed. The parameter ranges in value from 0 to 1; 0 indicates no difference betweendata <strong>and</strong> background, <strong>and</strong> 1 indicates maximum contrast.8.5 :ENABle DISPlay:ENABleControls whether the whole display is visible. If SYSTem:SECurity is enabled, DISPlaycannot be switched from OFF to ON.1234567891011121314151617181920212223242526ENABle is set to ON at *RST, unless SYSTem:SECurity is enabled.DISPlay:CONTrast 8-5


HP0661997 SCPI Comm<strong>and</strong> Reference8.6 :MENUDISPlay:MENUAllows selection of predefined device-dependent menus for display. A menu is basically asoftkey help screen, <strong>and</strong> it may consist of only key labels or more extensive information.8.6.1 [:NAME] DISPlay:MENU:NAMEThe NAME comm<strong>and</strong> selects a menu by name from an instrument-predefined list of validmenu names.8.6.2 :STATe DISPlay:MENU:STATeTurns the current menu page ON or OFF.88.6.3 :KEY DISPlay:MENU:KEYAssigns the soft key label to key. This affects only the displayed key label; it doesnot change the key definition.8.7 [:WINDow]DISPlay:WINDowThe WINDow subtree contains comm<strong>and</strong>s to enable a window, to set its size <strong>and</strong> location,<strong>and</strong> control its contents. Multiple instances of WINDow may exist under a particularDISPlay.8.7.1 :BACKgroundDISPlay:WINDow:BACKgroundThis subsystem controls the characteristics of the window background.8.7.1.1 :COLor DISPlay:WINDow:BACKground:COLorSelects from the CMAP the value given by to become the backgroundcolor.8.7.2 :GEOMetryDISPlay:WINDow:GEOMetryThis subtree is used to define the position <strong>and</strong> size of the WINDow with respect to thedisplay. A window may be specified by using any two of LLEFt, URIGht or SIZEcomm<strong>and</strong>s, since SIZe = URIGht - LLEFt. If any one of these comm<strong>and</strong>s is implemented,then all three shall be implemented <strong>and</strong> the coupling between them shall be maintained.For the GEOMetry subtree, the lower left corner of the whole display is defined to be (0,0);zero in the horizontal direction <strong>and</strong> zero in the vertical direction. The upper right corner isdefined to be (1,1).The effect of changing the size or aspect ratio of a WINDow that already is displayinginformation is device-dependent. The device may choose to rescale the information to fit thenew WINDow or it may leave the information unchanged, clipping it where it exceeds theWINDow boundaries.8-6 DISPlay:MENU


1997 SCPI Comm<strong>and</strong> Reference8.7.2.1 :LLEFt ,DISPlay:WINDow:GEOMetry:LLEFtThis specifies (or queries) the location of the lower left corner of the window in the range 0to 1.8.7.2.2 :SIZE ,DISPlay:WINDow:GEOMetry:SIZEThis specifies (or queries) the size of the display window. The first parameter represents thelength in the horizontal direction, <strong>and</strong> the second parameter represents the length in thevertical direction.The parameters may be set in the range greater than zero to 1. Where the existence of awindow can be represented by an icon, the device shall accept SIZE 0,0 to indicate thewindow is to be replaced by an icon.If a window is represented by an icon, any valid SIZE comm<strong>and</strong> with non-zero parametersshall reset the size of the window, <strong>and</strong> shall cause the icon to be replaced by the window.8.7.2.3 :URIGht ,DISPlay:WINDow:GEOMetry:URIGhtThis specifies (or queries) the location of the upper right corner of the display window in therange 0 to 1.8.7.3 :GRAPhicsDISPlay:WINDow:GRAPhicsThe GRAPhics subtree allows for the display of graphical information in the WINDow. Forexample, it allows direct control of the WINDow by the controller, using it as a plotteroutput device.For the GRAPhics subtree, the lower left corner of the WINDow is defined to be (0,0); zeroin the horizontal direction <strong>and</strong> zero in the vertical direction. The upper right corner is definedto be (1,1).8.7.3.1 :CLEarDISPlay:WINDow:GRAPhics:CLEarErases the graphics from the WINDow.This comm<strong>and</strong> defines an event <strong>and</strong> therefore has no query form or *RST value.8.7.3.2 :COLor DISPlay:WINDow:GRAPhics:COLorSelects from the CMAP the value given by to become the color for thenext GRAPhics operation. It is similar in function to selecting a pen on a plotter.8.7.3.3 :CSIZe [,]DISPlay:WINDow:GRAPhics:CSIZeSets the size <strong>and</strong> optional aspect ratio (width/height) of the character cell used by the LABelcomm<strong>and</strong>. The actual physical size of the resulting character is device-dependent.1234567891011121314151617181920212223242526DISPlay[:WINDow] 8-7


1997 SCPI Comm<strong>and</strong> Reference88.7.3.4 [:DRAW] ,DISPlay:WINDow:GRAPhics:DRAWDraws a line from the current “pen” position to the specified X <strong>and</strong> Y coordinate (the firstparameter is X, the second is Y; both parameters are required). The current line type <strong>and</strong> pennumber are used.8.7.3.5 :PCL DISPlay:WINDow:GRAPhics:PCLGraphics <strong>and</strong> text data are sent to the instrument using Hewlett-Packard “*” terminal<strong>and</strong>printer-style escape sequences. These are described in the Hewlett-Packard “PrinterComm<strong>and</strong> Language” document. Some escape sequences may interact with globalparameters such as color selection. The effect of these changes is global in scope <strong>and</strong> notrestricted to the :GRAPhics subsystem.8.7.3.6 :HPGL DISPlay:WINDow:GRAPhics:HPGLGraphics <strong>and</strong> text data are sent to the instrument using HP-GL (Hewlett-Packard-GraphicsLanguage) plotter language. Some HP-GL sequences will interact with global parameterssuch as color selection; the effect of these changes is global in scope <strong>and</strong> not restricted to the:GRAPhics subsystem.8.7.3.7 :IDRaw ,DISPlay:WINDow:GRAPhics:IDRawDraws a line from the current pen position to a new position determined by adding an Xoffset (first parameter) <strong>and</strong> a Y offset (second parameter) to the current coordinates.8.7.3.8 :IMOVe ,DISPlay:WINDow:GRAPhics:IMOVeUpdates the current pen position by adding an X offset (first parameter) <strong>and</strong> a Y offset(second parameter) to the current coordinates. No line is drawn.8.7.3.9 :LABel DISPlay:WINDow:GRAPhics:LABelPlaces text on the graphics display at the current pen position, using the current pen, with thelabel direction set by LDIR.8.7.3.10 :LDIRection DISPlay:WINDow:GRAPhics:LDIRectionDefines the angle (in radians) at which labels are drawn. An angle of 0 is normal horizontalprinting. The angle increases counter-clockwise; PI/2 is bottom-to-top.8.7.3.11 :LTYPe [,]DISPlay:WINDow:GRAPhics:LTYPeSelects a line type <strong>and</strong> optional repeat length for all subsequent lines drawn by IDRaw orDRAW. Although the specific line types are device-dependent, line type 1 is by tradition a“plain” line (solid), while other types include dots <strong>and</strong> dashes or combinations of dots <strong>and</strong>dashes.8-8 DISPlay[:WINDow]


1997 SCPI Comm<strong>and</strong> Reference8.7.3.12 :MOVE ,DISPlay:WINDow:GRAPhics:MOVEUpdates the pen position without drawing a new line.8.7.3.13 :STATe DISPlay:WINDow:GRAPhics:STATeControls whether the GRAPhics is visible or not.8.7.4 [:STATe] DISPlay:WINDow:STATeControls whether the WINDow is visible or not. The comm<strong>and</strong> DISPlay refers tothis node. If SYSTem:SECurity is enabled, WINDow cannot be switched from OFF to ON.At *RST, DISPlay[:WINDow][:STATe] is set to ON, unless SYSTem:SECurity is enabled.8.7.5 :TEXTDISPlay:WINDow:TEXTThe TEXT subtree allows for the display of textual information in the WINDow. Forexample, it allows direct control of the WINDow by the controller, using it as a VDT (VisualDisplay Terminal) output device.For the TEXT subtree, the upper left corner of the WINDow is defined to be (1,1). The lowerright corner is dependent on the WINDow:SIZE <strong>and</strong> the TEXT:Character SIZE selected.8.7.5.1 :ATTRibutes DISPlay:WINDow:TEXT:ATTRibutesATTRibutes allows the device to interpret the ANSI St<strong>and</strong>ard Terminal escape sequenceswhen displaying TEXT:DATA. Escape sequences that generate an inquiry are not permitted.The device may absorb escape sequences that it cannot interpret to prevent them fromappearing on the display.If ATTRibutes is ON, escape sequences embedded in the data are used to control theattributes of the string, such as blinking, or underline. ATTRibutes set to OFF disables theinterpretation of display sequences, but does not affect the current display. A blinkingdisplay keeps on blinking until it is overwritten. The device may absorb the escapesequences to prevent them from appearing on the display.8.7.5.2 :CLEarDISPlay:WINDow:TEXT:CLEarErases the text from the WINDow.This comm<strong>and</strong> defines an event, <strong>and</strong> therefore has no query form or *RST value.8.7.5.3 :COLor DISPlay:WINDow:TEXT:COLorSelects from the CMAP the value given by to become the color for thenext DATA stream.1234567891011121314151617181920212223242526DISPlay[:WINDow] 8-9


TWIR01p15HP005TWIR01p151997 SCPI Comm<strong>and</strong> Reference8.7.5.4 :CSIZe [,]DISPlay:WINDow:TEXT:CSIZeSets the size <strong>and</strong> optional aspect ratio (width/height) of the character cell used by DATA.Actual physical size of the resulting character is device-dependent.8.7.5.5 :FEED DISPlay:WINDow:TEXT:FEEDSets or queries what data flow is fed into the TEXT display window.At *RST, the is set to a device-dependent value.8.7.5.6 [:DATA] | DISPlay:WINDow:TEXT:DATAThe data that gets written to the text display area. Note that writing to the display overwritesany data that may have already been written. The result of overwriting a string with a shorterstring is not defined; the excess characters may or may not be cleared.88.7.5.7 :LOCate [,DISPlay:WINDow:TEXT:LOCateThis comm<strong>and</strong> selects the display ROW <strong>and</strong> display COLumn where the next LINE ofTEXT DATA is to appear. Row number 1 is the top row of the instrument display; columnnumber 1 is the left-most column.8.7.5.8 :PAGE DISPlay:WINDow:TEXT:PAGEThe PAGE comm<strong>and</strong> sets the page to be displayed. This comm<strong>and</strong> may accept UP <strong>and</strong>DOWN as defined in .8.7.5.9 :STATe DISPlay:WINDow:TEXT:STATeControls whether the TEXT is visible or not.8.7.6 :TRACeDISPlay:WINDow:TRACeThe TRACe subtree allows for the display of trace data in the WINDow; for example,directly from measurement data or from MEMory. The format of the data (<strong>and</strong> associatedinformation) is used by the TRACe subsystem to define how comm<strong>and</strong>s are to be interpreted<strong>and</strong> whether on not they are valid.8.7.6.1 :COLor DISPlay:WINDow:TRACe:COLorSelects from the CMAP the value given by to become the color for theTRACe.8.7.6.2 :FEED DISPlay:WINDow:TRACe:FEEDSets or queries what data flow is fed into the TRACe display window.At *RST, the is set to a device-dependent value.8-10 DISPlay[:WINDow]


HP01997 SCPI Comm<strong>and</strong> Reference8.7.6.3 :GRATiculeDISPlay:WINDow:TRACe:GRATiculeThe GRATicule subtree is used to set the type of graticule displayed in relation to theTRACe.8.7.6.3.1 :AXISDISPlay:WINDow:TRACe:GRATicule:AXISThe axes are either X <strong>and</strong> Y AXIS with markings (divisions), or the R AXIS with markings(divisions) with respect to the TRACe.8.7.6.3.1.1 [:STATe] DISPlay:WINDow:TRACe:GRATicule:AXIS:STATeDetermines if the AXIS is visible or not.8.7.6.3.2 :FRAMeDISPlay:WINDow:TRACe:GRATicule:FRAMeThe FRAMe is the perimeter boundary <strong>and</strong> markings with respect to the TRACe.8.7.6.3.2.1 [:STATe] DISPlay:WINDow:TRACe:GRATicule:FRAMe:STATeDetermines if the FRAMe is visible or not.8.7.6.3.3 :GRIDDISPlay:WINDow:TRACe:GRATicule:GRIDThe GRID provides constant lines of X, Y or R with respect to the TRACe.8.7.6.3.3.1 :AUTO DISPlay:WINDow:TRACe:GRATicule:GRID:AUTOAUTO couples the subtree of GRID to FRAMe. Turning ON FRAMe, with AUTO set toON, shall cause GRID to turn on also.8.7.6.3.3.2 [:STATe] DISPlay:WINDow:TRACe:GRATicule:GRID:STATeDetermines if the GRID is visible or not.8.7.6.4 :PERSistence DISPlay:WINDow:TRACe:PERSistenceSets how long trace data written to the screen will remain visible. The parameter is inseconds.8.7.6.4.1 :AUTO |ONCEDISPlay:WINDow:TRACe:PERSistence:AUTOWhen AUTO is set to ON, the persistence is determined by the device.At *RST, this value is set to ON.8.7.6.5 :STATe DISPlay:WINDow:TRACe:STATeControls whether the TRACe <strong>and</strong> related information is visible or not.1234567891011121314151617181920212223242526DISPlay[:WINDow] 8-11


HP006HP004HP006HP0061997 SCPI Comm<strong>and</strong> Reference88.7.6.6 :XDISPlay:WINDow:TRACe:XThis subsystem controls the setting of the X axis. The X axis is displayed horizontally, <strong>and</strong> itis usually the independent variable of the data, such as time or frequency. The :X node isused to define the parameters associated with the X axis. It is only available when the formatof the data is Cartesian.8.7.6.6.1 :LABel DISPlay:WINDow:TRACe:X:LABelSpecifies custom axis labeling.8.7.6.6.2 [:SCALe]DISPlay:WINDow:TRACe:X:SCALeThe SCALe subtree is used to define which portion of the (TRACe) data is to be displayed,by defining the end points of the axis as they appear in the WINDow. The values are in thesame UNITs as the UNIT of data for the x axis. The x scale can be defined in terms ofCENTer, LEFT, RIGHt <strong>and</strong>/or PDIVision, where the following equations express therelationship of these parameters:RIGHt - LEFT = (RIGHt - CENTer) * 2 = PDIVision * # of graticule divisions.If an instrument implements x axis scaling, the comm<strong>and</strong>s RIGHt <strong>and</strong> LEFT must beimplemented, while implementing PDIVision <strong>and</strong> CENTer are optional.8.7.6.6.2.1 :AUTO | ONCEDISPlay:WINDow:TRACe:X:SCALe:AUTOThe AUTO ON comm<strong>and</strong> sets the display to always configure the scaling on the particularaxis to best display the data. This rescaling may affect the values of any of the parametersunder the SCALe node. When AUTO is ON the display may be rescaled after eachmeasurement or sweep. Setting AUTO to ONCE, turns auto ON, adjusting the scaling of theaxis for one measurement <strong>and</strong> then turns auto OFF. Turning AUTO ON can change any ofthe parameters which can be set under the SCALe node.At *RST AUTO is set to OFF.8.7.6.6.2.2 :CENTer DISPlay:WINDow:TRACe:X:SCALe:CENTerSet or queries the value represented by the center point of the x-axis. This value may bebounded by the range of the data. When a new CENTer value is entered, the PDIVisionvalue is kept constant <strong>and</strong> the RIGHT <strong>and</strong> LEFT values are changed.At *RST, this parameter value is device dependent.8.7.6.6.2.3 :LEFT DISPlay:WINDow:TRACe:X:SCALe:LEFTSet or queries the value represented by the minimum (left) edge of the x-axis. This valuemay be bounded by the range of the data. When a new LEFT value is entered, the PDIVisionvalue is kept constant <strong>and</strong> the CENTer <strong>and</strong> RIGHT values are changed.At *RST, this parameter value is device dependent.8-12 DISPlay[:WINDow]


HP0HP0HP0HP0HP01997 SCPI Comm<strong>and</strong> Reference8.7.6.6.2.4 :PDIVision DISPlay:WINDow:TRACe:X:SCALe:PDIVisionSet or query the value between two grid graticules (value “per division”). When a newPDIVision value is entered, the parameter set as the PDIVision:LINK is held constant <strong>and</strong>the other two are changed.At *RST, this parameter value is device dependent.8.7.6.6.2.4.1 :LINK LEFT | CENTer | RIGHtDISPlay:WINDow:TRACe:X:SCALe:PDIVision:LINKLINK selects the parameter, either CENTer, LEFT or RIGHt that shall not be changed whenthe PDIVision value is changed. For example, if LINK is set to LEFT, then changingPDIVision shall cause CENTer <strong>and</strong> RIGHt, not LEFT, to change.At *RST the value of LINK is device dependent.8.7.6.6.2.5 :RIGHt DISPlay:WINDow:TRACe:X:SCALe:RIGHtSet or queries the value represented by the maximum (right) edge of the x-axis. This valuemay be bounded by the range of the data. When a new RIGHt value is entered, thePDIVision value is kept constant <strong>and</strong> the CENTer <strong>and</strong> LEFT values are changed.At *RST, this parameter value is device dependent.8.7.6.7 :YDISPlay:WINDow:TRACe:YThis subsystem controls the setting of the Y axis. The :Y node is displayed vertically, <strong>and</strong> itis usually the dependent variable of the data, such as power or voltage. The :Y node is usedto define the parameters associated with the Y axis. It is only available when the format ofthe data is Cartesian.8.7.6.7.1 :LABel DISPlay:WINDow:TRACe:Y:LABelSpecifies custom axis labeling.8.7.6.7.2 :RLINe DISPlay:WINDow:TRACe:Y:RLINeTurn on/off a line which is positioned on the graticule at the current Reference POSition.At *RST RLINe is off.8.7.6.7.3 [:SCALe]DISPlay:WINDow:TRACe:Y:SCALeThe SCALe subtree is used to define which portion of the (TRACe) data is to be displayed,by defining the end points of the axis as they appear in the WINDow. The values are in thesame UNITs as the UNIT of data for the y axis. The y scale can be defined in terms of TOP,1234567891011121314151617181920212223242526DISPlay[:WINDow] 8-13


HP004HP006HP006HP0061997 SCPI Comm<strong>and</strong> Reference8BOTTom, PDIVision or Reference LEVel <strong>and</strong> Reference POSition. These values arecoupled together in the following manner:TOP - BOTTom = PDIVision * # of graticule divisionsTOP = Reference LEVel when Reference POSition is 100 %BOTTom = Reference LEVel when Reference POSition is 0 %If an instrument implements y axis scaling, the comm<strong>and</strong>s TOP <strong>and</strong> BOTTom must beimplemented, while implementing the RLEVel <strong>and</strong> RPOSition <strong>and</strong> PDIVision comm<strong>and</strong>sare optional.8.7.6.7.3.1 :AUTO | ONCEDISPlay:WINDow:TRACe:Y:SCALe:AUTOThe AUTO ON comm<strong>and</strong> sets the display to always configure the scaling on the particularaxis to best display the data. This rescaling may affect the values of any of the parametersunder the SCALe node. When AUTO is ON the display may be rescaled after eachmeasurement or sweep. Setting AUTO to ONCE, turns auto ON, adjusting the scaling of theaxis for one measurement <strong>and</strong> then turns auto OFF. Turning AUTO ON can change any ofthe parameters which can be set under the SCALe node.At *RST AUTO is set to OFF.8.7.6.7.3.2 :BOTTom DISPlay:WINDow:TRACe:Y:SCALe:BOTTomSets or queries the value represented by the minimum (bottom) edge of the display. Thevalue may be bounded by the range of the data.8.7.6.7.3.3 :PDIVision DISPlay:WINDow:TRACe:Y:SCALe:PDIVisionSet or query the value between two grid graticules (value “per division”). When a newPDIVision value is entered, the current Reference LEVel is kept the same, while adjustingthe top <strong>and</strong> bottom scaling for the new PDIVision value.At *RST, this parameter value is device dependent.8.7.6.7.3.4 :RLEVel DISPlay:WINDow:TRACe:Y:SCALe:RLEVelSet or query the value represented at the designated Reference POSition on the y-axis.Setting a new Reference LEVel does not affect the value of PDIVision.At *RST, this parameter value is device dependent.8.7.6.7.3.4.1 :AUTO DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:AUTOSetting RLEVel:AUTO to ON causes the display to automatically choose a reference level tobest display the particular data. When AUTO is ON, a new reference level may be selectedeach time new data is received.At *RST AUTO is off.8-14 DISPlay[:WINDow]


HP0HP01997 SCPI Comm<strong>and</strong> Reference8.7.6.7.3.5 :RPOSition DISPlay:WINDow:TRACe:Y:SCALe:RPOSitionSet or query the point on the y-axis to be used as the reference position as a percentage of thelength of the y- axis. The top of the y axis is defined to have a Reference POSition of 100%,while the bottom of the y axis is defined to have a Reference POSition of 0%. The ReferencePOSition is the point on the y-axis which should equal the Reference LEVel.At *RST, this parameter value is device dependent.8.7.6.7.3.6 :TOP DISPlay:WINDow:TRACe:Y:SCALe:TOPSets or queries the value represented by the top edge of the display. The value may bebounded by the range of the data.8.7.6.7.4 :SPACing LOGarithmic | LINearDISPlay:WINDow:TRACe:Y:SPACingThe SPACing comm<strong>and</strong> is used to set the scale to either linear or log.8.7.6.8 :RDISPlay:WINDow:TRACe:RThis subsystem controls the R axis. The :R axis is displayed radially from the center point<strong>and</strong> usually represents magnitude of complex data. It is only available when the format of thedata is in polar coordinates.8.7.6.8.1 :LABel DISPlay:WINDow:TRACe:R:LABelSpecifies custom axis labeling.8.7.6.8.2 [:SCALe]DISPlay:WINDow:TRACe:R:SCALeThe SCALe subtree is used to define which portion of the (TRACe) data is to be displayedby defining the end points of the axis as they appear in the WINDow. The values are in thesame UNITs as the UNIT of the data for that AXIS.8.7.6.8.2.1 :AUTO | ONCEDISPlay:WINDow:TRACe:R:SCALe:AUTOThe AUTO ON comm<strong>and</strong> sets the display to always configure the scaling on the particularaxis to best display the data. This rescaling may affect the values of any of the parametersunder the SCALe node. When AUTO is ON the display may be rescaled after eachmeasurement or sweep. Setting AUTO to ONCE, turns auto ON, adjusting the scaling of theaxis for one measurement <strong>and</strong> then turns auto OFF. Turning AUTO ON can change any ofthe parameters which can be set under the SCALe node.At *RST AUTO is set to OFF.8.7.6.8.2.2 :CPOint DISPlay:WINDow:TRACe:R:SCALe:CPOintSets or queries the value represented by the minimum (Center POint) of the circular display.The value may be bounded by the range of the data.1234567891011121314151617181920212223242526DISPlay[:WINDow] 8-15


1997 SCPI Comm<strong>and</strong> Reference8.7.6.8.2.3 :OEDGe DISPlay:WINDow:TRACe:R:SCALe:OEDGeSets or queries the value represented by the Outside EDGe of the circular display. The valuemay be bounded by the range of the data.8.7.6.8.3 :SPACing LOGarithmic | LINearDISPlay:WINDow:TRACe:R:SPACingThe SPACing comm<strong>and</strong> is used to set the scale to either linear or log.88-16 DISPlay[:WINDow]


1997 SCPI Comm<strong>and</strong> Reference9 FORMat SubsystemThe FORMat subsystem sets a data format for transferring numeric <strong>and</strong> array information.This data format is used for both comm<strong>and</strong> <strong>and</strong> response data by those comm<strong>and</strong>s that arespecifically designated to be affected by the FORMat subsystem. The designation is eithergiven as part of a comm<strong>and</strong> description, or in the definition of block or array data used by acomm<strong>and</strong>. The data format for comm<strong>and</strong> data may override the definition of FORMat if thedata received is self typing (indicates its type), for the duration of that data transfer.123KEYWORD PARAMETER FORM NOTESFORMat4:BORDer NORMal|SWAPped5[:DATA] [,]:DINTerchange 6:SREGister ASCii | BINary | HEXadecimal | OCTal 1992 PH0789Byte ORDer. Controls whether binary data is transferred in normal or swapped byte order.10At *RST, this value is set to NORMal.1112The DATA comm<strong>and</strong> selects the data format; the <strong>and</strong> type . Valid types are 13 TK055ASCii, INTeger, UINTeger, REAL, HEXadecimal, OCTal, BINary, <strong>and</strong> PACKed. The14 parameter is optional for all types; its meaning is dependent on the type selected.15The parameter is an . In the query response is returned as . TK03316If the type INTeger, UINTeger, REAL, or PACKed is selected the data is transferred in a TK055block. The types ASCii, HEXadecimal, OCTal, <strong>and</strong> BINary are self typing. That is, the 17syntax designates the type. In these cases, the FORMat subsystem is only necessary to18determine the output format.19At *RST, ASCii is selected as the default type, the type length is device-dependent.20The various types are defined as:21 Interpretation:22ASCii Numeric data is transferred as ASCii bytes in , or format, as appropriate. The numbers are separated by commas as specified 23in IEEE 488.2. Forgiving listening allows ASCii input to always be valid.24The optional parameter specifies the number of significant digits tobe returned.25A value of zero indicates that the device selects the number of 26 TK033significant digits to be returned. When a of zero has been9.1 :BORDer NORMal|SWAPpedFORMat:READings:BORDer9.2 [:DATA] [,]FORMat:READings:DATAFORMat:BORDer 9-1


1997 SCPI Comm<strong>and</strong> Referencespecified, the FORMat[:DATA]? query shall return zero as its secondparameter.9BINaryHEXadecimalINTegerOCTalPACKedREALData is encoded as a non-decimal numeric, base 2, preceded by “#B” asspecified in IEEE 488.2. The parameter is the number of binarydigits in each number (not including the “#B”).Data is encoded as a non-decimal numeric, base 16, preceded by “#H” asspecified in IEEE 488.2. The parameter is the number ofhexadecimal digits in each number (not including the “#H”).Data is transferred in a definite length block as signed integers of the lengthspecified (in bits; default is 16). Scaling <strong>and</strong> offset, if required forinterpretation of measurement data, are determined by measurementparameters set in some other subsystem. Valid values of forINTeger data are 8, 16 <strong>and</strong> 32.Data is encoded as a non-decimal numeric, base 8, preceded by “#Q” asspecified in IEEE 488.2. The parameter is the number of octaldigits in each number (not including the “#Q”).Data is transferred in a definite length block, in a manner specified in thedevice documentation. The parameter may be used to conveyadditional information about the device-dependent format.Data is transferred in a definite length block as IEEE 754 floating pointnumbers of the specified length (in bits; default is 64). Valid values of for REAL data are 32 <strong>and</strong> 64.UINTegerData is transferred in a definite length block as unsigned integers of thelength specified (in bits; default is 16). Scaling <strong>and</strong> offset, if required forinterpretation of measurement data, are determined by measurementparameters set in some other subsystem. Valid values of forUINTeger data are 8, 16, 32 <strong>and</strong> 64.TK0559.3 :DINTerchange FORMat:READings:DINTerchangeDetermines whether measurement data is formatted as a . See DataInterchange Format, <strong>Volume</strong> 3. When DINTerchange ON is selected, returned data isencapsulated in this structure.The comm<strong>and</strong>s which are affected by this switch are a device dependent subset of thoseaffected by the FORMat:DATA comm<strong>and</strong>, but at a minimum shall include SENSe:DATA?,CALCulate:DATA?, TRACe:DATA?, MEASure?, READ?, <strong>and</strong> FETCh?The DIF encoding format for its DATA(CURVe(VALues)) block follows that specified inFORMat[:DATA] <strong>and</strong> FORMat:BORDer.DIF01TK032aTK032aAt *RST this function is set to OFF.9-2 FORMat:DINTerchange


PH01997 SCPI Comm<strong>and</strong> Reference9.4 :SREGister ASCii | BINary | HEXadecimal | OCTalFORMat:SREGisterThis comm<strong>and</strong> selects the data type of the response to queries for any CONDition, EVENt<strong>and</strong> ENABle register <strong>and</strong> for PTRansition <strong>and</strong> NTRansition filters that belong to the statussubsystem. Note that this includes the IEEE 488.2 status register queries.ASCii The data is transferred as ASCii bytes in format. This argument isrequired if the comm<strong>and</strong> is implemented.BINary The data is encoded as non-decimal numeric, base 2, preceded by ‘#B’ asspecified in IEEE 488.2HEXadecimal The data is encoded as non-decimal numeric, base 16, preceded by ‘#H’ asspecified in IEEE 488.2OCTal The data is encoded as non-decimal numeric, base 8, preceded by ‘#Q’ asspecified in IEEE 488.2At *RST, ASCii is selected as the default response data type.1234567891011121314151617181920212223242526FORMat:SREGister 9-3


1997 SCPI Comm<strong>and</strong> Reference99-4 FORMat:SREGister


1997 SCPI Comm<strong>and</strong> Reference10 HCOPy HP063eThe Hard COPy subsystem controls the setup of plotting <strong>and</strong> printing to an external device.The Hard COPy subsystem does not perform any data formatting, that is it does not convertthe data from one representation to another, such as COMPlex to POLar. Instead HCOPyadds the necessary page formatting (dependent upon the hard copy device language) to turnthe data into an acceptable form for the hard copy device.The HCOPy subsystem may FEED data from SENSe or CALCulate, <strong>and</strong> this data may beprinted or plotted. A FEED may be established from a DISPlay:WINDow. In this case theHCOPy output shall reflect what is currently displayed in that WINDow. In particular, anyscaling <strong>and</strong> offset that applies shall be employed.The selection of the interface <strong>and</strong> any address information is accomplished in theSYSTem:COMMunicate subsystem. DATA may be streamed to an external device withoutsending it through the HCOPy subsystem, where no page formatting comm<strong>and</strong>s are needed.The HCOPy subsystem gives a user several ways to select <strong>and</strong> initiate a plot or print. A usermay request all aspects of the data be plotted or printed, or the user may select a subset thatis of interest.The ITEM subsystem provides the means to select the desired aspects of the data in one oftwo ways. First, the ITEM of interest can be directly plotted or printed. For example, theTRACe data can be plotted or printed immediately by using theHCOPy:ITEM:...:IMMediate comm<strong>and</strong> or the HCOPy:ITEM:...:DATA? query.Alternatively, the user may set the STATe to ON for all the ITEMs of interest, <strong>and</strong> then usethe HCOPy:IMMediate comm<strong>and</strong> or the HCOPy:DATA? query to plot or print the selecteditems in one transaction with the hard copy device.If the user wishes to plot or print all the data, pointed to by the FEED, <strong>and</strong> does not want toindividually initiate each ITEM or change each ITEM’s STATe to ON, the user can send theHCOPy:ITEM:ALL[:IMMediate] comm<strong>and</strong> or the HCOPy:ITEM:ALL:DATA? query.The :HCOPy:SDUMp:IMMediate comm<strong>and</strong> <strong>and</strong> the :HCOPy:SDUMp:DATA? query allowthe user to do a Screen DUMp of the whole DISPlay, mimicking the traditional role of acamera recorder, <strong>and</strong> provide a simple hard copy scheme for instruments with a DISPlay.The HCOPy subsystem provides two schemes, IMMediate <strong>and</strong> DATA?, for getting hardcopy data out of an instrument. First, all of the IMMediate events can be implemented <strong>and</strong>used where the instrument is capable of directly controlling the interface. For example,RS-232, Centronics, or GPIB where the instrument can talk directly to the hard copy deviceby becoming the active controller. Any instrument which requires control of the systeminterface to execute the IMMediate comm<strong>and</strong> shall also implement the *PCB commoncomm<strong>and</strong>, see IEEE 488.2 10.21.IMMediate can also be used on GPIB when the active controller addresses the instrument totalk <strong>and</strong> the hard copy device to listen while monitoring the data flow by shadowh<strong>and</strong>shaking. The format of the data sent in response to an IMMediate comm<strong>and</strong> is notnecessarily an IEEE 488.2 format. This behavior is allowed by IEEE 488.2 section 8.1.HCOPy 10-11234567891011121314151617181920212223242526


1997 SCPI Comm<strong>and</strong> ReferenceWARNING:The IEEE 488.2 message exchange protocol requirements are violated when theIMMediate comm<strong>and</strong> generates a response that is sent when the instrument is addressedto talk. The instrument shall revert to the normal message exchange protocol if itreceives a device clear or any data on the system interface. Designers should use thecontrol passing method rather than shadow h<strong>and</strong>shaking method to avoid this escape ofthe IEEE 488.2 message exchange protocol.10Second, the DATA? query exists for use on buses, such as GPIB, where the data flow fromthe instrument to the hard copy device by way of a separate controller is acceptable ornecessary. It is also useful when the controller wants to store formatted data for later use.The instrument returns the formatted data in an element, see IEEE 488.2 section 8.7.10. This response data elementhas a leading #0 <strong>and</strong> a trailing NL^END. The controller could strip the header <strong>and</strong> trailer <strong>and</strong>send the remainder to an appropriate printer or plotter. The indefinite form is used becausethe block’s size or nature may prevent the instrument from computing the block’s lengthuntil after it is sent.A device may implement IMMediate or DATA? or both of these forms to plot or printresults.The result from HCOPy can also be fed to the Mass MEMory subsystem. The user couldthen retreive the results from the stored files at a more convenient time.KEYWORD PARAMETER FORM NOTESHCOPy 1993:ABORt [event;no query] 1993:DATA? 1993:DESTination [event;no query] 1993:DEVice 1993:CMAP 1993:COLor 1993:HSL ,, 1993:RGB ,, 1993:DEFault [event;no query] 1993:COLor 1993:LANGuage PCL[] | HPGL[] | POSTscript[] 1993:MODE TABLe | GRAPh 1993:RESolution 1993:UNIT 1993:SPEed 1993:UNIT 1993:FEED 1993[:IMMediate] 1993:ITEM 199310-2 HCOPy


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:ALL 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:ANNotation 1993:COLor 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:CUT 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:FFEed 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:LABel 1993:COLor 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:TEXT 1993:MENU 1993:COLor 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:TDSTamp 1993:COLor 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993[:WINDow] 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:TEXT 1993:COLor 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993:TRACe 1993:COLor 1993:DATA? [query only] 19931234567891011121314151617181920212223242526HCOPy 10-3


1997 SCPI Comm<strong>and</strong> Reference10KEYWORD PARAMETER FORM NOTES:GRATicule 1993:COLor 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 1993:STATe 1993[:IMMediate] [event;no query] 1993:LTYPe SOLid | DOTTed | DASHed | STYLe 1993:STATe 1993:PAGE 1993:DIMensions 1993:AUTO 1993:LLEFt , 1993:QUADrant [event;no query] 1993:URIGht , 1993:LENGth 1993:ORIentation LANDscape | PORTrait 1993:SCALe 1993:SIZE CUSTom |A | B | C | D | E 1993| A0 | A1 | A2 | A3 | A4 1993| B0 | B1 | B2 | B3 | B4 | B5 1993:UNIT 1993:WIDTH 1993:SDUMp 1993:DATA? [query only] 1993[:IMMediate] [event;no query] 199310.1 :ABORtHard COPy:ABORtAbort the current hard copy operation. A new program message automatically aborts anyincomplete response from an :HCOPy:...:DATA? query as that is an INTERRUPTEDcondition.10.2 :DATA?Hard COPy:DATA?This query initiates the plot or print according to the current Hard COPy setup parameters.All of the items under the ITEM node which are turned ON (STATe ON) are encapsulated inan element.10.3 :DESTinationHard COPy:DESTinationAn event which sets all :FEED connections which had been set to “HCOPy” to “”. The:FEED connection pointed to by is set to “HCOPy”. Any which can be used as a parameter to :DESTination shall have a :FEED comm<strong>and</strong> under itwhich can be set to “HCOPy”.10-4 HCOPy:ABORt


1997 SCPI Comm<strong>and</strong> Reference10.4 :DEViceHard COPy:DEViceThis subsystem is used to set <strong>and</strong> query characteristics relating to the hard copy device <strong>and</strong>its output.10.4.1 :CMAPHard COPy:DEVice:CMAPThe CMAP subsystem controls the physical color associated with logical color numbers inthe color map of the display. On a monochrome DISPlay, the CMAP may be used torepresent different intensity levels of the same shade. When a color is redefined, allinformation associated with that color number may change immediately.Two methods are available for defining a particular color, HSL <strong>and</strong> RGB models. If both areimplemented in a device, then they shall be coupled such that redefining a color with onemodel shall be reflected in the values of the other model.At *RST, COLor[1] shall represent “black,” <strong>and</strong> COLor2 shall represent “white” or theactual color of a monochrome display.10.4.1.1 :COLorHard COPy:DEVice:CMAP:COLorThis subsystem controls the color map for the instrument.10.4.1.1.1 :HSL ,,Hard COPy:DEVice:CMAP:COLor:HSLThe HSL comm<strong>and</strong> sets the instrument’s color map based on the Hue/Saturation/Luminancelevels color model. A query of HSL shall return three s separated by commas.Hue ranges from zero to one, circularly, with a value of zero resulting in the same hue as avalue of one. The approximate color progression is (starting at zero): red, orange, yellow,green, cyan, blue, magenta, <strong>and</strong> back to red.Saturation is the amount of pure color to be mixed with white. The saturation value rangesfrom zero to one, with zero specifying no color (only white or gray, depending on intensity)<strong>and</strong> one specifying no white.Luminance specifies the brightness per unit area of the color. A luminance of zero results inblack; a luminance of one results in the brightest color available.At *RST, these parameters are set to the DEFault values, equivalent to executing DEFaultcomm<strong>and</strong>. The HSL comm<strong>and</strong> is coupled to the RGB comm<strong>and</strong>. Changing values in eitherwill affect the values of the other.10.4.1.1.2 :RGB ,,Hard COPy:DEVice:CMAP:COLor:RGBThe RGB comm<strong>and</strong> sets the instrument’s color map based on the Red/Green/Blue colormodel. A query of RGB shall return three s separated by commas.Red ranges from zero to one, with zero indicating “no red” <strong>and</strong> one indicating “full intensityred.”1234567891011121314151617181920212223242526HCOPy:DEVice 10-5


1997 SCPI Comm<strong>and</strong> Reference10Green ranges from zero to one, with zero indicating “no green” <strong>and</strong> one indicating “fullintensity green.”Blue ranges from zero to one, with zero indicating “no blue” <strong>and</strong> one indicating “fullintensity blue.”At *RST, these parameters are set to the DEFault values, equivalent to executing DEFaultcomm<strong>and</strong>. The RGB comm<strong>and</strong> is coupled to the HSL comm<strong>and</strong>. Changing values in eitherwill affect the values of the other.10.4.1.2 :DEFaultHard COPy:DEVice:CMAP:DEFaultSets the color map to the instrument’s default values for all colors, except that COLor[1]shall be represent “black,” <strong>and</strong> COLor2 shall represent “white” or the actual color of amonochrome display.10.4.2 :COLor Hard COPy:DEVice:COLorSets or queries whether color information should be sent as part of the plot or printinformation, in those languages that support both color <strong>and</strong> monochrome (black <strong>and</strong> white).At *RST, the value of this parameter is OFF.10.4.3 :LANGuage PCL[] | HPGL[] | POSTscript[]Hard COPy:DEVice:LANGuageSelects the control language or data format to be used when sending out plot or printinformation.PCL Hewlett-Packard’s Printer Control Language.HPGL Hewlett-Packard’s Graphics Language.Information about PCL <strong>and</strong> HPGL is available by contacting:HP Peripheral Developer Program16399 West Bernardo DriveSan Diego, CA 92127-1899(619) 487-4100POSTscript Adobe Systems printer language.Information about PostScript is available by contacting:Adobe Systems Incorporated1585 Charleston RoadMountain View, CA 94039-7900(415) 961-4400The optional number, [], following the languages, refers to a specific version of thatlanguage.At *RST, the value of this parameter is device dependent.10-6 HCOPy:DEVice


1997 SCPI Comm<strong>and</strong> Reference10.4.4 :MODE TABLe | GRAPhHard COPy:DEVice:MODESets or queries how the data is to be represented in the hard copy. TABLe implies the data isformatted into a table rather than a pictorial form. Only characters appear on the output.GRAPh implies the format is a graph or picture. The graph may be generated using vectors,raster, or other available technology.At *RST, the value of this setting is device dependent.10.4.5 :RESolution Hard COPy:DEVice:RESolutionSets or queries the resolution of the result on the hard copy device. This setting is generallyused to affect the quality of the output from a raster printer.At *RST, the value of this parameter is device dependent.10.4.5.1 :UNIT Hard COPy:DEVice:RESolution:UNITSets or queries the units of the RESolution setting.At *RST, the value of this parameter is device dependent.10.4.6 :SPEed Hard COPy:DEVice:SPEedSets or queries the speed at which vectors are drawn. This setting is generally used to affectthe quality of the output from a pen plotter.At *RST, the value of this parameter is device dependent.10.4.6.1 :UNIT Hard COPy:DEVice:SPEed:UNITSets or queries the units of the SPEed setting.At *RST, the value of this parameter is cm/sec.10.5 :FEED Hard COPy:FEEDSets or queries the data flow to be fed into the Hard COPy block.At *RST, the value of this parameter is device dependent.10.6 [:IMMediate]Hard COPy:IMMediateThis comm<strong>and</strong> immediately initiates the plot or print according to the current Hard COPysetup parameters. All of the items under the ITEM node which are turned ON (STATe ON)are plotted or printed.10.7 :ITEMHard COPy:ITEMThe :ITEM subsystem collects together comm<strong>and</strong>s to configure what items of data will beplotted or printed, <strong>and</strong> how that data shall appear.1234567891011121314151617181920212223242526HCOPy:FEED 10-7


1997 SCPI Comm<strong>and</strong> Reference10Most data item nodes have :COLor nodes to allow the user to set the color of the specificdata item. The parameter to the COLor node selects either the actual pen number of thehardcopy device, or the color map number, whichever value the hardcopy device expects.Some devices may elect not to support some or all of the COLor nodes. For example, adevice which has a color DISPlay may elect to use just the existing colors in the DISPlaywhen plotting or printing a color hardcopy.10.7.1 :ALLHard COPy:ITEM:ALLThis subsystem is used to plot or print all ITEMs.10.7.1.1 :DATA?Hard COPy:ITEM:ALL:DATA?All ITEMs, regardless of their individual states, are encapsulated in an element.10.7.1.2 [:IMMediate]Hard COPy:ITEM:ALL:IMMeditateImmediately plot or print all ITEMs, regardless of their individual states.10.7.2 :ANNotationHard COPy:ITEM:ANNotationConfigures the plotting or printing of any display annotation.10.7.2.1 :COLor Hard COPy:ITEM:ANNotation:COLorSets or queries the color to be used for plotting or printing the display annotation.At *RST, the value of this parameter is device dependent.10.7.2.2 :DATA?Hard COPy:ITEM:ANNotation:DATA?Returns the display annotation encapsulated in an element.10.7.2.3 [:IMMediate]Hard COPy:ITEM:ANNotation:IMMeditateImmediately plot or print the display annotation.10.7.2.4 :STATe Hard COPy:ITEM:ANNotation:STATeSets or queries whether ANNotation should be plotted or printed when theHCOPy:IMMediate comm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.7.3 :CUTHard COPy:ITEM:CUTConfigures cutting the page after the plot or print is complete.10-8 HCOPy:ITEM


1997 SCPI Comm<strong>and</strong> Reference10.7.3.1 :DATA?Hard COPy:ITEM:CUT:DATA?Returns what would be sent to the hard copy device to cut the page encapsulated in an element.10.7.3.2 [:IMMediate]Hard COPy:ITEM:CUT:IMMediateImmediately cut the page.10.7.3.3 :STATe Hard COPy:ITEM:CUT:STATeSets or queries whether a page cut should be performed as part of the HCOPy:IMMediatecomm<strong>and</strong> or HCOPy:DATA? query.At *RST, the value of this parameter is device dependent.10.7.4 :FFEedHard COPy:ITEM:FFEEdConfigures form-feeding after the plot or print is complete.10.7.4.1 :DATA?Hard COPy:ITEM:FFEEd:DATA?Returns what would be sent to the hard copy device to do a form feed encapsulated in an element.10.7.4.2 [:IMMediate]Hard COPy:ITEM:FFEEd:IMMediateImmediately form-feed the page.10.7.4.3 :STATe Hard COPy:ITEM:FFEEd:STATeSets or queries whether a form feed should be performed as part of the HCOPy:IMMediatecomm<strong>and</strong> or HCOPy:DATA? query.At *RST, the value of this parameter is device dependent.10.7.5 :LABelHard COPy:ITEM:LABelConfigures the plotting or printing of the user entered label or title. The text for LABel is notsupplied by the source of the FEED connection. The TEXT is supplied by a setting in thissubsystem since it could only be generated by the user. It might reflect specific operatingconditions or refer to a specific part being tested. Where on the physical page theLABel:TEXT is actually plotted/printed is device dependent.10.7.5.1 :COLor Hard COPy:ITEM:LABel:COLorSets or queries the color to be used for plotting or printing the label.At *RST, the value of this parameter is device dependent.1234567891011121314151617181920212223242526HCOPy:ITEM 10-9


1997 SCPI Comm<strong>and</strong> Reference1010.7.5.2 :DATA?Hard COPy:ITEM:LABel:DATA?Returns the label encapsulated in an element.10.7.5.3 [:IMMediate]Hard COPy:ITEM:LABel:IMMediateImmediately plot or print the label.10.7.5.4 :STATe Hard COPy:ITEM:LABel:STATeSets or queries whether the label should be plotted or printed when the HCOPy:IMMediatecomm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.7.5.5 :TEXT Hard COPy:ITEM:LABel:TEXTSets or queries the contents of the user label. The contents of the is placed in anappropriate place on the hard copy output. The string may contain formatting characters. Atextual label containing the empty string ("") shall be plotted/printed as a single blank line.At *RST, all textual labels are set to the empty string.10.7.6 :MENUHard COPy:ITEM:MENUConfigures the plotting or printing of the device menu.10.7.6.1 :COLor Hard COPy:ITEM:MENU:COLorSets or queries the color to be used for plotting or printing the menu.At *RST, the value of this parameter is device dependent.10.7.6.2 :DATA?Hard COPy:ITEM:MENU:DATA?Returns the menu encapsulated in an element.10.7.6.3 [:IMMediate]Hard COPy:ITEM:MENU:IMMediateImmediately plot or print the menu.10.7.6.4 :STATe Hard COPy:ITEM:MENU:STATeSets or queries whether the menu should be plotted or printed when the HCOPy:IMMediatecomm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10-10 HCOPy:ITEM


1997 SCPI Comm<strong>and</strong> Reference10.7.7 :TDSTampHard COPy:ITEM:TDSTampConfigures the plotting or printing of a time <strong>and</strong> date stamp.10.7.7.1 :COLor Hard COPy:ITEM:TDSTamp:COLorSets or queries the color to be used for plotting or printing the time <strong>and</strong> date stamp.At *RST, the value of this parameter is device dependent.10.7.7.2 :DATA?Hard COPy:ITEM:TDSTamp:DATA?Returns the time <strong>and</strong> date stamp encapsulated in an element.10.7.7.3 [:IMMediate]Hard COPy:ITEM:TDSTamp:IMMediateImmediately plot or print the time <strong>and</strong> date stamp.10.7.7.4 :STATe Hard COPy:ITEM:TDSTamp:STATeSets or queries whether the time <strong>and</strong> date stamp should be plotted or printed when theHCOPy:IMMediate comm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.7.8 [:WINDow]Hard COPy:ITEM:WINDowConfigures the plotting or printing of windows.10.7.8.1 :DATA?Hard COPy:ITEM:WINDow:DATA?Returns the window encapsulated in an element.10.7.8.2 [:IMMediate]Hard COPy:ITEM:WINDow:IMMediateImmediately plot or print the window.10.7.8.3 :STATe Hard COPy:ITEM:WINDow:STATeSets or queries whether the window should be plotted or printed when theHCOPy:IMMediate comm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.7.8.4 :TEXTHard COPy:ITEM:WINDow:TEXTConfigures the plotting or printing of text blocks or textual labels.1234567891011121314151617181920212223242526HCOPy:ITEM 10-11


1997 SCPI Comm<strong>and</strong> Reference1010.7.8.4.1 :COLor Hard COPy:ITEM:WINDow:TEXT:COLorSets or queries the color to be used for plotting or printing TEXT.At *RST, the value of this parameter is device dependent.10.7.8.4.2 :DATA?Hard COPy:ITEM:WINDow:TEXT:DATA?Returns the menu encapsulated in an element.10.7.8.4.3 [:IMMediate]Hard COPy:ITEM:WINDow:TEXT:IMMediateImmediately plot or print the text blocks or textual labels.10.7.8.4.4 :STATe Hard COPy:ITEM:WINDow:TEXT:STATeSets or queries whether the text blocks or textual labels should be plotted or printed when theHCOPy:IMMediate comm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.7.8.5 :TRACeHard COPy:ITEM:WINDow:TRACeConfigures the plotting or printing of graphical trace data.10.7.8.5.1 :COLor Hard COPy:ITEM:WINDow:TRACe:COLorSets or queries the color to be used for plotting or printing the trace.At *RST, the value of this parameter is device dependent.10.7.8.5.2 :DATA?Hard COPy:ITEM:WINDow:TRACe:DATA?Returns the trace encapsulated in an element.10.7.8.5.3 :GRATiculeHard COPy:ITEM:WINDow:TRACe:GRATiculeConfigures the plotting or printing of the graticule.10.7.8.5.3.1 :COLor Hard COPy:ITEM:WINDow:TRACe:GRATicule:COLorSets or queries the color to be used for plotting or printing the graticule.At *RST, the value of this parameter is device dependent.10.7.8.5.3.2 :DATA?Hard COPy:ITEM:WINDow:TRACe:GRATicule:DATA?Returns the graticule encapsulated in an element.10-12 HCOPy:ITEM


1997 SCPI Comm<strong>and</strong> Reference10.7.8.5.3.3 [:IMMediate]Hard COPy:ITEM:WINDow:TRACe:GRATicule:IMMediateImmediately plot or print the graticule.10.7.8.5.3.4 :STATe Hard COPy:ITEM:WINDow:TRACe:GRATicule:STATeSets or queries whether the graticule should be plotted or printed when theHCOPy:IMMediate comm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.7.8.5.4 [:IMMediate]Hard COPy:ITEM:WINDow:TRACe:IMMediateImmediately plot or print the trace.10.7.8.5.5 :LTYPe SOLid | DOTTed | DASHed | STYLeHard COPy:ITEM:WINDow:TRACe:LTYPeSets or queries the line type to be used for plotting or printing the trace.For each value of in the STYLe parameter, the appearance of the line type shall bedifferent. The STYLe line types should be chosen so they appear different on the specifichard copy device being used. The actual appearance is device dependent.At *RST, the value of this parameter is device dependent.10.7.8.5.6 :STATe Hard COPy:ITEM:WINDow:TRACe:STATeSets or queries whether the trace should be plotted or printed when the HCOPy:IMMediatecomm<strong>and</strong> or HCOPy:DATA? query is sent.At *RST, the value of this parameter is device dependent.10.8 :PAGEHard COPy:PAGEThis subsystem contains comm<strong>and</strong>s to set up parameters relating to the medium of the plotor print output.10.8.1 :DIMensionsHard COPy:PAGE:DIMensionsSets the plot or print dimensions. Different plotters or printers allow the user to set the pagedimensions in different ways, such as length, width dimensions of the page, selecting ast<strong>and</strong>ard page size, or setting "corners" of the page in terms of plotter units (that is p1 <strong>and</strong>p2). A device will likely support the setting of plot or print dimensions in a subset of theseways, depending on which plotter or printer(s) it supports. The interaction of the variousdimension comm<strong>and</strong>s is device dependent.10.8.1.1 :AUTO Hard COPy:PAGE:DIMensions:AUTOWhen AUTO is on the device selects the default page dimensions. When AUTO is OFF thepage dimensions are set by the other setting in this subsystem.1234567891011121314151617181920212223242526HCOPy:PAGE 10-13


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, the value of this parameter is ON.10.8.1.2 :LLEFt ,Hard COPy:PAGE:DIMensions:LLEFtSets or queries the x,y position of lower left corner of the page. Units are percent of thewidth <strong>and</strong> length of the page.At *RST, the value of this parameter is device dependent.10.8.1.3 :QUADrant[]Hard COPy:PAGE:DIMensions:QUADrantSets dimensions so that the plot/print occupies one quadrant of the page.10 quadrant1 upper right 2 12 upper left3 lower left4 lower right 3 4This comm<strong>and</strong> is an event only.10.8.1.4 :URIGht ,Hard COPy:PAGE:DIMensions:URIGhtSpecifies the x,y position of upper right corner of the page. Units are percent of the width<strong>and</strong> length of the page.At *RST, the value of this parameter is device dependent.10.8.2 :LENGth Hard COPy:PAGE:LENGthSets or queries the length of the page to be plotted or printed.At *RST, the value of this parameter is device dependent.10.8.3 :ORIentation LANDscape | PORTraitHard COPy:PAGE:ORIentationSets or queries the orientation of the plot or print. Switching between LANDscape <strong>and</strong>PORTrait rotates the hardcopy result by 90 degrees. No other settings are changed.At *RST, the value of this parameter is device dependent.10.8.4 :SCALe Hard COPy:PAGE:SCALeSets or queries a scaling factor which is applied to the hard copy output. This factor appliesto both dimensions. The output from HCOPy shall not attempt to place anything on the pageoutside the limits set under :DIMensions even when :SCALe is greater than one.At *RST, the value of this setting is one.10-14 HCOPy:PAGE


1997 SCPI Comm<strong>and</strong> Reference10.8.5 :SIZE CUSTom|A|B|C|D|E|A0|A1|A2|A3|A4|B0|B1|B2|B3|B4|B5Hard COPy:PAGE:SIZESets or queries the size of the paper in terms of a st<strong>and</strong>ard paper size. If LENGth or WIDthare set, the value of this setting becomes CUSTom.At *RST, the value of this parameter is device dependent.10.8.6 :UNIT Hard COPy:PAGE:UNITSets or queries the units for LENGth <strong>and</strong> WIDTh under DIMensions.At *RST, the value of this parameter is device dependent.10.8.7 :WIDTh Hard COPy:PAGE:WIDThSets or queries the width of the page to be plotted or printed.At *RST, the value of this parameter is device dependent.10.9 :SDUMpHard COPy:SDUMpThe Screen DUMp subsystem obtains its FEED from the whole DISPlay subsystem, <strong>and</strong>shall only be used where a DISPlay subsystem is present in an instrument.10.9.1 :DATA?Hard COPy:SDUMp:DATA?Returns the whole DISPlay encapsulated in an element.10.9.2 [:IMMediate]Hard COPy:SDUMp:IMMediateThis event shall cause the whole DISPlay to be plotted or printed.1234567891011121314151617181920212223242526HCOPy:SDUMp 10-15


1997 SCPI Comm<strong>and</strong> Reference1010-16 HCOPy:SDUMp


1997 SCPI Comm<strong>and</strong> Reference11 INPut SubsystemThe INPut subsystem controls the characteristics of a sensor’s input ports.KEYWORD PARAMETER FORM NOTESINPut1:ATTenuation :AUTO |ONCE2:STATe 1994 RS013 3:BIAS 1991 HP0:CURRent 1991 4HP0:AC 1991 HP05[:DC] 1991 HP0[:STATe] 1991 6HP0:TYPE CURRent | VOLTage 1991 HP07:VOLTage 1991 HP0:AC 1991 8HP0[:DC] 1991 HP09:COUPling AC|DC|GROund 1991 10TWOS:FILTer11:AWEighting 1991 HP0[:STATe] 1991 12HP0:HPASs[:LPASs]:FREQuency:FREQuency[:STATe][:STATe]13141516:GAIN17:AUTO |ONCE:STATe 1994 18 RS013:GUARd LOW|FLOat19:IMPedance :LOWFLOat|GROund20:OFFSet 1991 TWOS21:STATe 1991 TWOS:POLarity NORMal|INVerted 1994 22 TK019:POLarization 1994 RS010a 23:HORizontal [no query] 1994 RS010a:VERTical [no query] 1994 RS010a 24:POSition 1994 RS010a 25[:X] 1994 RS010a:ANGLe 1994 RS010a 26:DIRection UP|DOWN 1994 RS010aINPut 11-1


1997 SCPI Comm<strong>and</strong> Reference11KEYWORD PARAMETER FORM NOTES[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994[:DISTance] 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994:Y 1994:ANGLe 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994[:DISTance] 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994:Z 1994:ANGLe 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 199411-2 INPutRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a


HP0HP01997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:VELocity 1994 RS010a[:DISTance] 1994 RS010a:DIRection UP|DOWN 1994 RS010a[:IMMediate] 1994 RS010a1:LIMit 1994 RS010a:HIGH 1994 RS010a 2:LOW 1994 RS010a3[:STATe] 1994 RS010a:OFFSet 1994 RS010a 4:VELocity 1994 RS010a5[:STATe] :TYPE 1992 RS0611.1 :ATTenuation 7INPut:ATTenuation8Sets the input ATTenuation. The default units are in the current relative amplitude units.9This should only be used where the setting is not reflected within the SENSe system. Forexample, setting the input attenuation to 10 dB will cause the measured signal to decrease in 10amplitude by 10 dB.11This setting is not coupled to INPut:GAIN. If both ATTenuation <strong>and</strong> GAIN were set to 10 12dB, the net result would be a signal of the original amplitude.13At *RST, this value is device-dependent.1411.1.1 :AUTO |ONCEINPut:ATTenuation:AUTO15AUTO ON changes the ATTenuation to achieve maximum sensitivity without overloading 16the input channel. Programming a specified ATTenuation sets AUTO OFF.17At *RST, this value is set to ON.1811.1.2 :STATe INPut:ATTenuation:STATeTurns the input attenuator ON <strong>and</strong> OFF. OFF means, that any attenuation circuits are takenout of the signal path, thus, no distortion to the signal will happen.At *RST, this value is device dependent.RS0131920212211.2 :BIAS23INPut:BIASThis subsystem is used to control the bias applied to an external tr<strong>and</strong>ucer/detector. 2411.2.1 :CURRent25INPut:BIAS:CURRentSpecifies the specific bias current being generated.26INPut:ATTenuation 11-3


HP034HP034HP034HP034HP034HP034HP034TWOS02TWOS021997 SCPI Comm<strong>and</strong> Reference11.2.1.1 :AC INPut:BIAS:CURRent:ACSpecifies the AC component of the bias current. The parameter is specified in Amperes.At *RST, this value is device-dependent.11.2.1.2 [:DC] INPut:BIAS:CURRent:DCSpecifies the DC component of the bias current. The parameter is specified in Amperes.At *RST, this value is device-dependent.11.2.2 [:STATe] INPut:BIAS:STATeSets or queries whether or not input biasing is enabled.11At *RST, this value is device-dependent.11.2.3 :TYPE CURRent | VOLTageINPut:BIAS:TYPE CURRentSpecifies the type of bias to be generated. CURRent specifies a current bias <strong>and</strong> VOLTagespecifies a voltage bias.At *RST, this value is device-dependent.11.2.4 :VOLTageINPut:BIAS:VOLTageSpecifies the specific bias voltage being generated.11.2.4.1 :AC INPut:BIAS:VOLTage:ACSpecifies the AC component of the bias voltage. The parameter is specified in Volts.At *RST, this value is device-dependent.11.2.4.2 [:DC] INPut:BIAS:VOLTage:DCSpecifies the DC component of the bias voltage. The parameter is specified in Volts.At *RST, this value is device-dependent.11.3 :COUPling AC|DC|GROundINPut:COUPlingSelects AC or DC coupling for the specified signal. DC coupling allows the measurementsignal’s AC <strong>and</strong> DC component to pass. AC coupling passes only the measurement signal’sAC component. GROund coupling allows no signal to pass at all <strong>and</strong> grounds the inputamplifier without grounding the input signal.At *RST, this value is device-dependent.11-4 INPut:COUPling AC|DC|GROund


HP0HP01997 SCPI Comm<strong>and</strong> Reference11.4 :FILTerINPut:FILTerThe FILTer function allows a filter to be inserted in the path of the measurement signal. TheFREQuency function allows the programming of a specific break frequency. The STATecomm<strong>and</strong> enables the filter.11.4.1 :AWEightingINPut:FILTer:AWEightingControls the “A” weighting input filter. This is a human hearing compensation filterdescribed in the IEC Recommendation 179 <strong>and</strong> ANSI S1.4.11.4.1.1 [:STATe] INPut:FILTer:AWEighting:STATeTurns the “A” weighting input filter on <strong>and</strong> off.At *RST this value is device-dependent.11.4.2 :HPASsINPut:FILTer:HPASsControls the high pass filter.11.4.2.1 :FREQuency INPut:FILTer:HPASs:FREQuencyDetermines the cutoff frequency of the high pass filter. Default units are Hertz.At *RST, this value is device-dependent.11.4.2.2 [:STATe] INPut:FILTer:HPASs:STATeTurns the high pass filter ON <strong>and</strong> OFF.At *RST, this value is device-dependent.11.4.3 [:LPASs]INPut:FILTer:LPASsControls the low pass filter.11.4.3.1 :FREQuency INPut:FILTer:LPASs:FREQuencyDetermines the cutoff frequency of the low pass filter. Default units are Hertz.At *RST, this value is device-dependent.11.4.3.2 [:STATe] INPut:FILTer:LPASs:STATeTurns the low pass filter ON <strong>and</strong> OFF.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526INPut:FILTer 11-5


1997 SCPI Comm<strong>and</strong> Reference1111.5 :GAIN INPut:GAINSets the input GAIN. The default units are in the current relative amplitude units.This should only be used where the setting is not reflected within the SENSe system. Forexample, setting the input gain to 10 dB will cause the measured signal to increase inamplitude by 10 dB.This setting is not coupled to INPut:ATTenuation. If both ATTenuation <strong>and</strong> GAIN were setto 10 dB, the net result would be a signal of the original amplitude.At *RST, this value is device-dependent.11.5.1 :AUTO |ONCEINPut:GAIN:AUTOAUTO ON changes the GAIN to achieve maximum sensitivity without overloading the inputchannel.AT *RST, this value is set to ON.11.5.2 :STATe INPut:GAIN:STATeTurns the input gain (preamplifier) ON <strong>and</strong> OFF. OFF means, that any preamplifier circuitsare taken out of the signal path, thus, no distortion to the signal will happen. OFF is not thesame as INPut:GAIN 0 dB, because an isolation preamplifier will have that gain.At *RST, this value is device dependent.11.6 :GUARd LOW|FLOatINPut:GUARdConnects guard to signal low terminal or allows guard to float.At *RST, this value is device-dependent.11.7 :IMPedance INPut:IMPedanceTermination input impedance for the input signal specified in Ohms.At *RST, this value is device-dependent.11.8 :LOW FLOat|GROundINPut:LOWConnects the low signal terminal to ground or allows it to float.At *RST, this value is device-dependent.RS01311-6 INPut:GAIN


TWOSTWOS1997 SCPI Comm<strong>and</strong> Reference11.9 :OFFSet INPut:OFFSetSets or queries the input OFFSet. OFFSet may take on positive <strong>and</strong> negative values. TheOFFSet shall be subtracted from the input, thus making OFFSet more positive shall make thesignal more negative. The default units are in the current amplitude unitsIntroducing an OFFSet in the input has the effect of offsetting the input signal, prior todetection in the SENSe block. Any offset introduced in the input block shall not be correctedfor in the sensor <strong>and</strong> subsquently the sensor results. For example, if the current amplitudeunits are in volts, a value of 5 shall decrease the input signal by 5 volts.At *RST, the value of OFFSet is device-dependent.11.9.1 :STATe INPut:OFFSet:STATeTurns the effect of OFFSet ON or OFF.At *RST, STATe shall be OFF.11.10 :POLarity NORMal|INVertedINPut:POLaritySets or queries the input polarity. NORMal causes the input signal to pass through the INPutblock without inversion. INVerted causes the polarity of the input signal to be reversed. Anyinversion introduced in the INPut block shall not be corrected for in the sensor <strong>and</strong>subsequently the sensor results.At *RST, this value is NORMal.11.11 :POLarization INPut:POLarizationSets the polarization of the input. The default units are radian.At *RST, this value is device-dependent.11.11.1 :HORizontalINPut:POLarization:HORizontalSets the polarization of the input to zero. This comm<strong>and</strong> is an event. Therefore it has noassociated query or meaning at *RST.11.11.2 :VERTicalINPut:POLarization:VERTicalSets the polarization of the input to PI/2 radians. This comm<strong>and</strong> is an event. Therefore it hasno associated query or meaning at *RST.11.12 :POSitionINPut:POSitionThe characteristics of an incoming signal can be affected by the input’s spatial position <strong>and</strong>orientation relative to the origin. The definition of the origin is application specific. Thissubsystem uses a righth<strong>and</strong> coordinate system <strong>and</strong> has only one origin.In this subsystem only the IMMediate comm<strong>and</strong>s initiate movement.12345678TK019 910111213RS010a 14151617RS010a181920RS010a212223RS010a242526INPut:OFFSet 11-7


1997 SCPI Comm<strong>and</strong> Reference11In this subsystem velocity is always positive.11.12.1 [:X]INPut:POSition:XControls the settings concerning the X-axis.11.12.1.1 :ANGLeINPut:POSition:X:ANGLeSpecifies the angle of rotation around the X-axis.11.12.1.1.1 :DIRection UP|DOWNINPut:POSition:X:ANGLe:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP11.12.1.1.2 [:IMMediate] INPut:POSition:X:ANGLe:IMMediateThis comm<strong>and</strong> indicates that the input is moved to the specified position without waiting forfurther comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.11.12.1.1.3 :LIMitINPut:POSition:X:ANGLe:LIMitSets the maximum bounds on the physical POSition.11.12.1.1.3.1 :HIGH INPut:POSition:X:ANGLe:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the clockwise physical limit.11.12.1.1.3.2 :LOW INPut:POSition:X:ANGLe:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the counterclockwise physical limit.11.12.1.1.3.3 :STATe INPut:POSition:X:ANGLe:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.11.12.1.1.4 :OFFSet INPut:POSition:X:ANGLe:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.RS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a11-8 INPut:POSition


1997 SCPI Comm<strong>and</strong> Reference11.12.1.1.5 :VELocity INPut:POSition:X:ANGLe:VELocityControls the velocity of the angular rotation around the x-axis.At *RST, this value is device dependent.11.12.1.2 [:DISTance]INPut:POSition:X:DISTanceControls the settings in linear direction of the X-axis.11.12.1.2.1 :DIRection UP|DOWNINPut:POSition:X:DISTance:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP11.12.1.2.2 [:IMMediate] INPut:POSition:X:DISTance:IMMediateThis comm<strong>and</strong> indicates that the input is moved to the specified position without waiting forfurther comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.11.12.1.2.3 :LIMitINPut:POSition:X:DISTance:LIMitSets the maximum bounds on the physical POSition.11.12.1.2.3.1 :HIGH INPut:POSition:X:DISTance:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the upper physical limit.11.12.1.2.3.2 :LOW INPut:POSition:X:DISTance:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the lower physical limit.11.12.1.2.3.3 :STATe INPut:POSition:X:DISTance:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.11.12.1.2.4 :OFFSet INPut:POSition:X:DISTance:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.RS010a1RS010a23RS010a456RS010a 78910RS010a 111213RS010a141516RS010a171819RS010a 20212223RS010a242526INPut:POSition 11-9


1997 SCPI Comm<strong>and</strong> Reference1111.12.1.2.5 :VELocity INPut:POSition:X:DISTance:VELocityControls the velocity of the displacement on the x-axis.At *RST, this value is device dependent.11.12.2 :YINPut:POSition:YControls the settings concerning the Y-axis.11.12.2.1 :ANGLeINPut:POSition:Y:ANGLeSpecifies the angle of rotation around the Y-axis.11.12.2.1.1 :DIRection UP|DOWNINPut:POSition:Y:ANGLe:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP11.12.2.1.2 [:IMMediate] INPut:POSition:Y:ANGLe:IMMediateThis comm<strong>and</strong> indicates that the input is moved to the specified position without waiting forfurther comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.11.12.2.1.3 :LIMitINPut:POSition:Y:ANGLe:LIMitSets the maximum bounds on the physical POSition.11.12.2.1.3.1 :HIGH INPut:POSition:Y:ANGLe:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the clockwise physical limit.11.12.2.1.3.2 :LOW INPut:POSition:Y:ANGLe:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the counterclockwise physical limit.11.12.2.1.3.3 :STATe INPut:POSition:Y:ANGLe:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.11.12.2.1.4 :OFFSet INPut:POSition:Y:ANGLe:OFFSetThis defines a single value that is subtracted from the physical POSition.RS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a11-10 INPut:POSition


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.11.12.2.1.5 :VELocity INPut:POSition:Y:ANGLe:VELocityControls the velocity of the angular rotation around the y-axis.At *RST, this value is device dependent.11.12.2.2 [:DISTance]INPut:POSition:Y:DISTanceControls the settings in linear direction of the Y-axis.11.12.2.2.1 :DIRection UP|DOWNINPut:POSition:Y:DISTance:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP11.12.2.2.2 [:IMMediate] INPut:POSition:Y:DISTance:IMMediateThis comm<strong>and</strong> indicates that the input is moved to the specified position without waiting forfurther comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.11.12.2.2.3 :LIMitINPut:POSition:Y:DISTance:LIMitSets the maximum bounds on the physical POSition.11.12.2.2.3.1 :HIGH INPut:POSition:Y:DISTance:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the upper physical limit.11.12.2.2.3.2 :LOW INPut:POSition:Y:DISTance:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the lower physical limit.11.12.2.2.3.3 :STATe INPut:POSition:Y:DISTance:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.11.12.2.2.4 :OFFSet INPut:POSition:Y:DISTance:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.RS010a12RS010a34RS010a567RS010a 891011RS010a 121314RS010a151617RS010a181920RS010a 21222324RS010a2526INPut:POSition 11-11


1997 SCPI Comm<strong>and</strong> Reference1111.12.2.2.5 :VELocity INPut:POSition:Y:DISTance:VELocityControls the velocity of the displacement on the y-axis.At *RST, this value is device dependent.11.12.3 :ZINPut:POSition:ZControls the settings concerning the Z-axis11.12.3.1 :ANGLeINPut:POSition:Z:ANGLeSpecifies the angle of rotation around the Z-axis.11.12.3.1.1 :DIRection UP|DOWNINPut:POSition:Z:ANGLe:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP11.12.3.1.2 [:IMMediate] INPut:POSition:Z:ANGLe:IMMediateThis comm<strong>and</strong> indicates that the input is moved to the specified position without waiting forfurther comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.11.12.3.1.3 :LIMitINPut:POSition:Z:ANGLe:LIMitSets the maximum bounds on the physical POSition.11.12.3.1.3.1 :HIGH INPut:POSition:Z:ANGLe:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the clockwise physical limit.11.12.3.1.3.2 :LOW INPut:POSition:Z:ANGLe:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the counterclockwise physical limit.11.12.3.1.3.3 :STATe INPut:POSition:Z:ANGLe:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.11.12.3.1.4 :OFFSet INPut:POSition:Z:ANGLe:OFFSetThis defines a single value that is subtracted from the physical POSition.RS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a11-12 INPut:POSition


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.11.12.3.1.5 :VELocity INPut:POSition:Z:ANGLe:VELocityControls the velocity of the angular rotation around the z-axis.At *RST, this value is device dependent.11.12.3.2 [:DISTance]INPut:POSition:Z:DISTanceControls the settings in linear direction of the Z-axis.11.12.3.2.1 :DIRection UP|DOWNINPut:POSition:Z:DISTance:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP11.12.3.2.2 [:IMMediate] INPut:POSition:Z:DISTance:IMMediateThis comm<strong>and</strong> indicates that the input is moved to the specified position without waiting forfurther comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.11.12.3.2.3 :LIMitINPut:POSition:Z:DISTance:LIMitSets the maximum bounds on the physical POSition.11.12.3.2.3.1 :HIGH INPut:POSition:Z:DISTance:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the upper physical limit.11.12.3.2.3.2 :LOW INPut:POSition:Z:DISTance:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the lower physical limit.11.12.3.2.3.3 :STATe INPut:POSition:Z:DISTance:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.11.12.3.2.4 :OFFSet INPut:POSition:Z:DISTance:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.RS010a12RS010a34RS010a567RS010a 891011RS010a 121314RS010a151617RS010a181920RS010a 21222324RS010a2526INPut:POSition 11-13


RS0071997 SCPI Comm<strong>and</strong> Reference11.12.3.2.5 :VELocity INPut:POSition:Z:DISTance:VELocityControls the velocity of the displacement on the z-axis.RS010aAt *RST, this value is device dependent.11.13 [:STATe] INPut:STATeThe STATe comm<strong>and</strong> connects the input terminal to the measurement signal path when ON.It can be turned OFF to allow maximum isolation of the measurement signal. Note that thisdoes not mean ground the input signal.At *RST, STATe ON shall be selected.11.14 :TYPE INPut:TYPESelects the input characteristic to be used if more than one is available.The following characteristics are currently defined for instruments:BALanced – balanced or differential input.11UNBalanced – unbalanced with respect to ground.At *RST the TYPE is device-dependent.11-14 INPut[:STATe]


Cha1997 SCPI Comm<strong>and</strong> Reference12 INSTrument SubsystemAn instrument may support multiple logical instruments. A dual channel power supply forexample is considered as two logical instruments. The logical instruments are not required tohave identical functionality, nor does the functionality have to be available simultaneously.The INSTrument subsystem provides a mechanism to identify <strong>and</strong> select logical instrumentsby either name or number. In this way a particular logical instrument could be selected <strong>and</strong> itwould respond to comm<strong>and</strong>s, such as MEASure, in the same manner as a dedicatedinstrument having the same functionality as the logical instrument. The INSTrumentidentifiers have no fixed correspondence to the numeric suffixes allowed with comm<strong>and</strong>headers.JPKEYWORD PARAMETER FORM NOTESINSTrument:CATalog? [query only] 1994:FULL? [query only] 1994:COUPle[:] ALL|NONE|:DEFine , 1994:DELete 1994[:NAME] [event; no query] 1994:ALL [event; no query] 1994:NSELect [:SELect] :STATe 12.1 :CATalog?INSTrument:CATalog?The CATalog query returns a comma-separated list of strings which contains the names ofall logical instruments. If no logical instruments are defined, a single null string is returned.Some instruments may have one or more intrinsic (permanent) ’s. These arelisted along with any user-named ’s.12.1.1 :FULL?INSTrument:CATalog?:FULL?CATalog:FULL? query returns a list of string - number pairs. The string contains the nameof the logical instrument. The immediately following NR1-formatted number is itsassociated logical instrument number. All response data elements are comma separated. If nological instrument is defined, a null string followed by a zero is returned.Intrinsic ’s associated with logical instrument numbers are listed along with anyuser-named ’s <strong>and</strong> numbers.123456TK026 7TK02689TK02610 TK02611 TK026TK02612131415 TK02616 TK0261718 TK02619TK0262021 TK026222324 TK02625TK02626INSTrument Subsystem 12-1


1997 SCPI Comm<strong>and</strong> Reference1212.2 :COUPle[:] ALL|NONE|INSTrument:COUPleDefines a coupling between various logical instruments or between various channels withinan instrument. The COUPle comm<strong>and</strong> consists of an optional subsystem node followed by asingle parameter.The subsystem node denotes a SCPI subsection which can either affect each instrumentindividually, or affect all instruments/channels collectively. This node is used only when theuser can turn this coupling ON or OFF. Predefined couplings need not use this node. If nonode follows the COUPle comm<strong>and</strong>, then the entire instrument is assumed to be coupled.Coupling a node lower in the tree overrides any couplings which are assigned at a higherlevel.The parameter indicates to which logical instruments the specified coupling is to apply. ALLindicates that specified coupling is to apply to all logical instruments. NONE indicates thatspecified coupling is to removed. A list of instruments specifies a particular set of logicalinstruments to be coupled.Within SCPI certain subsystems, such as SYSTem, STATus, MEMory, MMEMory, TEST<strong>and</strong> DIAGnostic, are considered common to all logical instruments. That is, they appearcoupled across all logical instruments, <strong>and</strong> they cannot be uncoupled. The IEEE commoncomm<strong>and</strong>s are assumed to always operate on all logical instruments.At *RST, all subsystems are uncoupled as far as the instrument hardware allows.12.3 :DEFine ,INSTrument:DEFineThe comm<strong>and</strong> form defines a logical instrument name, , <strong>and</strong> associates it with alogical instrument number, . The is in character data format.The query form takes only as a parameter <strong>and</strong> returns the logical instrumentnumber.12.4 :DELeteINSTrument:DELeteThe DELete subsystem disassociates ’s <strong>and</strong> logical instrument numbers. After aDELete comm<strong>and</strong> executes, neither the nor the corresponding logicalinstrument number are accessible until they are redefined. The instrument behaves as if theynever existed.12.4.1 [:NAME] INSTrument:DELete:NAMEThis comm<strong>and</strong> is an event which disassociates the named from its logicalinstrument number. There is no query form.Attempting to delete the currently selected logical instrument or any intrinsic (permanent) - number associations results in an -221, (settings conflict) execution error.This comm<strong>and</strong> is an event, <strong>and</strong> therefore has no *RST value associated with it.TK026TK026TK026TK026TK026TK026TK026TK02612-2 INSTrument Subsystem


ChaJP ChaHP066, JP Chan1997 SCPI Comm<strong>and</strong> Reference12.4.2 :ALLINSTrument:DELete:ALLThis comm<strong>and</strong> is an event which disassociates all ’s from their logicalinstrument numbers except the currently selected logical instrument <strong>and</strong> any intrinsic - number associations. There is no query form.The situation of “nothing to delete” does not cause an execution error.This comm<strong>and</strong> is an event, <strong>and</strong> therefore has no *RST value associated with it.*RST has no effect.12.5 :NSELect JPINSTrument:NSELectThis comm<strong>and</strong> is used in conjunction with the SELect comm<strong>and</strong>. It serves the same purpose,except that it uses a numeric value instead of the identifier used in the SELect comm<strong>and</strong>.When queried it shall return the logical instrument number. Note that the numbering used forlogical instruments shall directly correspond to the numbers used in status reporting formultiple instruments; specifically the STATus:QUEStionable:INSTrument <strong>and</strong>STATus:OPERation:INSTrument comm<strong>and</strong>s. By selecting an instrument with either SELector NSELect <strong>and</strong> querying the selected instrument with the other comm<strong>and</strong>, the equivalencebetween the instrument number <strong>and</strong> identifier can be determined. For example, by selectinga logical instrument using the SELect comm<strong>and</strong> with its name identifier <strong>and</strong> then queryingwhich logical instrument is selected with the NSELect comm<strong>and</strong>, the corresponding numericvalue shall be returned.12.6 [:SELect] INSTrument:SELectThis comm<strong>and</strong> selects a path or entire instrument as the default. When a logical instrument isselected, all other logical instruments are unavailable for programming until selected. Ifeither SELect or NSELect comm<strong>and</strong>s are implemented then both of the comm<strong>and</strong>s must beimplemented.Character data names may be predefined by the instrument.At *RST, a device-dependent instrument is selected.12.7 :STATe INSTrument:STATeTurns the selected logical instrument ON or OFF. A logical instrument does not have to beturned OFF before another logical instrument is selected. That is, several logical instrumentsmay be active, while only one may be selected. When an instrument is active, measurementsoccur <strong>and</strong> signals are generated. When inactive, measurements do not occur <strong>and</strong> signals arenot generated. When a logical instrument is selected, yet is inactive, all comm<strong>and</strong>s shall beprocessed so that the logical instrument shall reflect the state changes requested when thelogical instrument is turned on. The exception to this are comm<strong>and</strong>s which would normallycause trigger events in an active logical instrument. Any of these comm<strong>and</strong>s shall cause anexecution error (-200) to be generated.TK026TK0261TK026 2TK026 3TK026 4567891011121314151617181920212223242526INSTrument Subsystem 12-3


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.1212-4 INSTrument Subsystem


1997 SCPI Comm<strong>and</strong> Reference13 MEMory SubsystemThe purpose of the memory subsystem is to manage instrument memory. This specificallyexcludes memory used for mass storage, which is defined in the MMEMory Subsystem.Instrument memory may be used to store several data types (e.g. ASCii, BINary, instrumentSTATe, TRACe or MACRo.) The data types available for a given instrument aredevice-dependent.An instrument may support either fixed or dynamic allocation of instrument memory, 3between the different data types. With fixed allocation a certain amount of memory isdedicated to each of the supported data types. The dedicated memory is unavailable for use 4by any other data type. Alternatively, with dynamic allocation, instrument memory is shared 5between the various data types supported on a dem<strong>and</strong> basis.6KEYWORD PARAMETER FORM NOTESMEMory7:CATalog8[:ALL]? [query only]:ASCii? [query only]9:BINary? [query only]10:MACRo? [query only]:STATe? [query only]11:TABLe? [query only] 1992 HP0512:CLEar 1993 PH076[:NAME] [event; no query] 1993 13 PH076:TABLe [event; no query] 1993 14 PH076:COPY 1993 PH076[:NAME] , [event; no query] 1993 15 PH076:TABLe [event; no query] 1993 16 PH076:DATA , 1994 TK023B:DELete17:ALL [event; no query] 18[:NAME] [event; no query]:EXCHange 1993 19 PH076[:NAME] , [event; no query] 1993 20 PH076:TABLe [event; no query] 1993 PH076:FREE21[:ALL]? [query only]22:ASCii? [query only]:BINary? [query only]23:MACRo? [query only]24:STATe? [query only]:TABLe? [query only] 199225HP05:NSTates? [query only]26:STATe 1994 TK023B:CATalog? [query only] 1994 TK023BMEMory Subsystem 13-112


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:DEFine , 1994:DEFine? 1994:TYPE? [query only]TK023BTK023B13:TABLe 1992 HP058A:CONDition 1993 PH074[:MAGNitude] {,} 1993 PH074:POINts? [query only] 1993 PH074:CURRent 1992 HP058A[:MAGNitude] {,} 1992 HP058A:POINts? [query only] 1992 HP058A:PHASe {,} 1992 HP058A:POINts? 1992 HP058A[query only]:DEFine 1992 HP058A[,]:FREQuency {,} 1992 HP058A:POINts? 1992 HP058A[query only]:LOSS 1992 HP058A[:MAGNitude] {,} 1992 HP058A:POINts? [query only] 1992 HP058A:PHASe {,} 1992 HP058A:POINts? 1992 HP058A[query only]:POWer 1992 HP058A[:MAGNitude] {,} 1992 HP058A:POINts? [query only] 1992 HP058A:RESistance 1992 HP058A[:MAGNitude] {,} 1992 HP058A:POINts? [query only] 1992 HP058A:SELect 1992 HP058A:VOLTage 1992 HP058A[:MAGNitude] {,} 1992 HP058A:POINts? [query only] 1992 HP058A:PHASe {,} 1992 HP058A:POINts? 1992 HP058A[query only]The parameter is used to define a user label, which shall be . This label can then be used by the application in place of the specified data definedhere or in other subsystems. The parameter is sent as , rather thanas a string, because that is the simplest IEEE 488.2 type that meets the requirements. When aname is returned, for example, in response to a CATalog? query, it must be sent as , so that a null string (“”) can indicate that nothing is defined.The MEMory capabilities of an instrument are not part of the instrument state <strong>and</strong> are notaffected by *RST or *RCL. They may survive a power cycle, but this capability is optional.If the instrument implements SYSTem:SECure mode, MEMory:DELete:ALL must beexecuted when SYSTem:SEC OFF is executed.13-2 MEMory Subsystem


Ed ChanEd ChanEd ChanEd ChanHP051997 SCPI Comm<strong>and</strong> Reference13.1 :CATalogMEMory:CATalogThe CATalog queries return information on the current contents <strong>and</strong> state of the instrument’smemory. The returned data shall be in the following form:, {,}The instrument shall return two numeric parameters <strong>and</strong> as many strings as there are items inthe directory list. The first parameter shall indicate the total amount of storage currentlyused, in bytes. The second parameter shall indicate the total amount of storage available, alsoin bytes. Each string parameter returned shall indicate the name, type <strong>and</strong> size of one in thedirectory list, thus:,,The , <strong>and</strong> are all character data. The is the exact name of afile as it appears in the directory list, including an extension if present. The providesthe size of the file in bytes. The is indicated by the name of the major subsystem orone of the following:ASCii — An ASCII text fileBINary — A binary fileMACRo — An instrument macroSTATe — An instrument stateTABLe — A table of dataThe qualified CATalog query for TRACe memory is specified in the TRACe subsystem.13.1.1 [:ALL]?MEMory:CATalog:ALL?If the CATalog query is qualified by the optional ALL node then the query shall return adirectory list <strong>and</strong> memory sizes related to all allocatable items in instrument memory. Notethat this includes all allocatable objects, such as trace, etc.13.1.2 :ASCii?MEMory:CATalog:ASCii?If the CATalog query is qualified by the ASCii node then the query shall return the directorylist related only to ASCii items in instrument memory. The memory usage <strong>and</strong> availabilityparameters shall reflect values that correspond to values for ASCii data. In an instrument thathas dedicated memory for ASCii data types, values reported shall be different from the totalgiven by a CATalog of ALL types.13.1.3 :BINary?MEMory:CATalog:BINary?If the CATalog query is qualified by the BINary node then the query shall return thedirectory list related only to BINary items in instrument memory. The memory usage <strong>and</strong>availability parameters shall reflect values that correspond to values for BINary data. In an1234567891011121314151617181920212223242526MEMory Subsystem 13-3


HP058AHP058A1997 SCPI Comm<strong>and</strong> Reference13instrument that has dedicated memory for BINary data types, values reported shall bedifferent from the total given by a CATalog of ALL types.13.1.4 :MACRo?MEMory:CATalog:MACRo?If the CATalog query is qualified by the MACRo node then the query shall return thedirectory list related only to MACRo items in instrument memory. The memory usage <strong>and</strong>availability parameters shall reflect values that correspond to values for MACRo data. In aninstrument that has dedicated memory for MACRo data types, values reported shall bedifferent from the total given by a CATalog of ALL types.13.1.5 :STATe?MEMory:CATalog:STATe?If the CATalog query is qualified by the STATe node then the query shall return thedirectory list related only to STATe items in instrument memory. The memory usage <strong>and</strong>availability parameters shall reflect values that correspond to values for STATe data. In aninstrument that has dedicated memory for STATe data types, values reported shall bedifferent from the total given by a CATalog of ALL types.13.1.6 :TABLe?MEMory:CATalog:TABLe?If the CATalog query is qualified by the TABLe node then the query shall return thedirectory list related only to TABLe items in instrument memory. The memory usage <strong>and</strong>availability of parameters shall reflect values that correspond to values for TABLe data. Inan instrument that has dedicated memory for TABLe data types, the values reported shall bedifferent from the total given by a CATalog of ALL types.13.2 :CLEar PH076MEMory:CLEarThe comm<strong>and</strong>s from this subsystem remove the data that is stored in instrument memory.This subsystem differs from the DELete subsystem in that CLEar removes the data contentsbut does not affect the memory definitions such as memory type <strong>and</strong> structure, availablespace, <strong>and</strong> the name of the associated instrument memory.13.2.1 [:NAME] PH076MEMory:CLEar:NAMEThis comm<strong>and</strong> is a default node <strong>and</strong> removes all data from the instrument memoryassociated with . The NAMe comm<strong>and</strong> does not affect the related memorydefinitions.This comm<strong>and</strong> is an event with no associated query form <strong>and</strong> *RST condition.13.2.2 :TABLe PH076MEMory:CLEar:TABLeThe CLEar:TABLe comm<strong>and</strong> removes the data values from all element lists in the SELectedTABLe. This comm<strong>and</strong> does not affect the space <strong>and</strong> structure of the table as specified withthe table’s DEFine comm<strong>and</strong>. Executing a POINts? query for any table element after theCLEar:TABLe comm<strong>and</strong>, would return 0.13-4 MEMory Subsystem


1997 SCPI Comm<strong>and</strong> ReferenceThis comm<strong>and</strong> is an event with no associated query form <strong>and</strong> *RST condition.13.3 :COPY PH076MEMory:COPYThe COPY subsystem copies the data from an existing instrument memory item into another,named memory item.113.3.1 [:NAME] , PH076 2MEMory:COPY:NAMEThis comm<strong>and</strong> is a default node that copies the data contents from the memory itemassociated with the specified in the first parameter to a memory item associated 4with the specified by the second parameter.5When the memory item to which data is copied is of a different type, or has an incompatiblestructure, an execution error - 294 (Incompatible type) is generated. When the specified 6destination name does not exist, the device may create a new memory item of the same type 7<strong>and</strong> structure as the source. In that case, the destination name is to be associated with thenew created memory item.8This comm<strong>and</strong> is an event with no associated query form <strong>and</strong> *RST condition.913.3.2 :TABLe 10 PH076MEMory:COPY:TABLeThe COPY:TABLe comm<strong>and</strong> copies the data values of all element lists from the SELectedTABLe to the memory table associated with the specified .When the memory item to which data is copied is of a different type, or has an incompatiblestructure, an execution error -294 (Incompatible type) is generated. When the TABLe namedoes not exist, the device may define a new memeory table with the same structure as theselected table. In that case, the specified TABLe name is associated with the new createdmemory table.This comm<strong>and</strong> is an event with no associated query form <strong>and</strong> *RST condition.13.4 :DATA,MEMory:DATAThe comm<strong>and</strong> form is MEMory:DATA ,. The comm<strong>and</strong> loads intothe memory location . is in 488.2 block format. is character data.The query form is MEMory:DATA? with the response being the associated in block format.MEMory:DATA? response is not affected by the FORMat subsystem.13.5 :DELeteMEMory:DELeteThe DELete comm<strong>and</strong> purges the specified definition from instrument memory <strong>and</strong> makes itavailable for reuse.311121314151617TK023B 18TK023B 1920TK023B 2122TK023B23242526MEMory Subsystem 13-5


1997 SCPI Comm<strong>and</strong> Reference13.5.1 :ALLMEMory:DELete:ALLThe ALL comm<strong>and</strong> removes all memory names, key definitions, <strong>and</strong> data, <strong>and</strong> it returnsmemory to “available.”13.5.2 [:NAME] MEMory:DELete:NAMEThe NAME comm<strong>and</strong> is an optional node <strong>and</strong> deletes the definition associated with .13.6 :EXCHange PH076MEMory:EXCHangeThe EXCHange subsystem allows for swapping the data contents between two memoryitems.13.6.1 [:NAME] , PH076MEMory:EXCHange:NAMEThis comm<strong>and</strong> is a default node which swaps the data contents between the memory itemsassociated with the parameters.When the memory items between which the data is swapped are of different type, or have anincompatible structure, an execution error -294 (Incompatible type) is generated.This comm<strong>and</strong> is an event with no associated query form <strong>and</strong> *RST condition.1313.6.2 :TABLe PH076MEMory:EXCHange:TABLeThis comm<strong>and</strong> swaps the data contents between the SELected TABLe <strong>and</strong> the memory tablethat is associated with the parameter.When the memory item associated with the specified parameter is not a TABLe, orthe tables between which the data is swapped have an incompatible structure, an executionerror -294 (Incompatible type) is generated.This comm<strong>and</strong> is an event with no associated query form <strong>and</strong> *RST condition.13.7 :FREEMEMory:FREEReturns information on the user memory space as follows:,where the returned data for both shall be in format.The qualified FREE query for TRACe only memory usage is specified in the TRACesubsystem.13.7.1 [:ALL]?MEMory:FREE:ALL?If the FREE query is qualified by the optional ALL node then the query shall return memorysizes related to all items in instrument memory.13-6 MEMory Subsystem


HP05HP051997 SCPI Comm<strong>and</strong> Reference13.7.2 :ASCii?MEMory:FREE:ASCii?If the FREE query is qualified by the ASCii node then the memory usage <strong>and</strong> availabilityshall reflect the values that correspond to values for ASCii data. In an instrument that hasdedicated memory for ASCii data types, these values reported shall be different from thetotal given by a FREE query of ALL types.13.7.3 :BINary?MEMory:FREE:BINary?If the FREE query is qualified by the BINary node then the memory usage <strong>and</strong> availabilityshall reflect the values that correspond to values for BINary data. In an instrument that hasdedicated memory for BINary data types, these values reported shall be different from thetotal given by a FREE query of ALL types.13.7.4 :MACRo?MEMory:FREE:MACRo?If the FREE query is qualified by the MACRo node then the memory usage <strong>and</strong> availabilityshall reflect the values that correspond to values for MACRo data. In an instrument that hasdedicated memory for MACRo data types, these values reported shall be different from thetotal given by a FREE query of ALL types.13.7.5 :STATe?MEMory:FREE:STATe?If the FREE query is qualified by the STATe node then the memory usage <strong>and</strong> availabilityshall reflect the values that correspond to values for STATe data. In an instrument that hasdedicated memory for STATe data types, these values reported shall be different from thetotal given by a FREE query of ALL types.13.7.6 :TABLe?MEMory:FREE:TABLe?If the FREE query is qualified by the TABLe node then the memory usage <strong>and</strong> availabilityshall reflect the values that correspond to values for TABLe data. In an instrument that hasdedicated memory for TABLe types, the values reported shall be different from the totalgiven by a FREE query of ALL types.13.8 :NSTates?MEMory:NSTates?The Number of STates query requests that the instrument return the number of *SAV/*RCLstates available in the instrument. The instrument shall return a value which is onegreater than the maximum that can be sent as a parameter to the *SAV <strong>and</strong> *RCL comm<strong>and</strong>s.13.9 :STATeMEMory:STATeCollects comm<strong>and</strong>s relating to memory STATe data.1234567891011121314151617181920212223TK023B24TK023B 2526MEMory Subsystem 13-7


HP058A1997 SCPI Comm<strong>and</strong> Reference13.9.1 :CATalog?MEMory:STATe:CATalog?This query requests a list of defined names in the MEMory:STATe subsystem. Theinstrument returns a list of defined ’s in a comma separated list. Each isreturned in a quoted string. If no names are defined, a single null string is returned. There isno comm<strong>and</strong> form.13.9.2 :DEFine , MEMory:STATe:DEFine:DEfine associates a with a *SAV/*RCL register number where is incharacter data format. is in format.The query form of this comm<strong>and</strong>, MEMory:STATe:DEFine? returns the associated in format.*RST has no effect on this comm<strong>and</strong>.13.10 :TYPE? MEMory:TYPE?The TYPE query requests information about a defined name. The instrument must return astring indicating the subsystem where the name was defined. If the name is not defined, anull string is returned. For example, if VAT3 was previously defined by:ROUTe:MODule:DEFine VAT3,(@20000(0:9))TK023BTK023BTK023BTK023BTK023BTK023B13then the query:MEMory:TYPE? VAT3requests a return of“ROUT:MOD:”13.11 :TABLeMEMory:TABLeThe MEMory:TABLe comm<strong>and</strong> allows the user to DEFine a TABLe <strong>and</strong> to write data to<strong>and</strong> read data from it.13.11.1 :CONDition PH074MEMory:TABLe:CONDition13.11.1.1 [:MAGNitude] {,} PH074MEMory:TABLe:CONDition:MAGNitudeSpecifies the CONDition[:MAGNitude] points of the TABLe. If there are more ’sthan in the associated DEFine statement, execution error -223 (Too much data) will begenerated. This item list is included in the table DEFine comm<strong>and</strong> asCONDition[:MAGNitude]At *RST, the contents of this list is device dependent.13-8 MEMory Subsystem


HP05HP05HP05HP05HP05HP051997 SCPI Comm<strong>and</strong> Reference13.11.1.1.1 :POINts?MEMory:TABLe:CONDition:MAGNituse:POINts?Returns the number of points in the CONDition[:MAGNitude] list of the SELected TABLe.If no CONDition[:MAGNitude] value have been sent, POINts? returns a 0. If no TABLe hasbeen selected, POINts? returns a NAN.13.11.2 :CURRentMEMory:TABLe:CURRent13.11.2.1 [:MAGNitude] {,}MEMory:TABLe:CURRent:MAGNitudeSpecifies the CURRent[:MAGNitude] points of the TABLe. ’s mayinclude current units as listed in the UNIT subsystem. The default unit is specified byUNIT:CURRent. If there are more ’s than in the associated DEFinestatement, execution error -223 (Too much data) will be generated. This item list is includedin the table DEFine comm<strong>and</strong> as CURRent[:MAGNitude].At *RST, the contents of this list item is device dependent.13.11.2.1.1 :POINts?MEMory:TABLe:CURRent:MAGNitude:POINts?Returns the number of points in the CURRent[:MAGNitude] list of the SELected TABLe. Ifno CURRent[:MAGNitude] values have been sent POINts? returns 0. If no TABLe has beenselected, POINts? returns NAN.13.11.2.2 :PHASe {,}MEMory:TABLe:CURRent:PHASeSpecifies the CURRent:PHASe points of the TABLe. ’s may include angleunits as listed in the UNIT subsystem. The default unit is specified by UNIT:ANGLe. Ifthere are more ’s than in the associated DEFine statement, execution error-223 (Too much data) will be generated. This item list is included in the table DEFinecomm<strong>and</strong> as CURRent:PHASe.At *RST, the contents of this list item is device dependent.13.11.2.2.1 :POINts?MEMory:TABLe:CURRent:PHASe:POINts?Returns the number of points in the CURRent:PHASe list of the SELected TABLe. If noCURRent:PHASE values have been sent POINts? returns 0. If no TABLe has been selected,POINts? returns NAN.13.11.3 :DEFine [,]MEMory:TABLe:DEFineThe DEFine subsystem is used to allocate space <strong>and</strong> define the structure of TABLe in theinstrument memory. The of the TABLe is specified by SELect.The string parameter specifies the structure of the TABLe being defined,it contains a comma separated list of the elements. Any item lists under MEMory:TABLe,such as FREQuency or VOLTage:PHASe, may be specified as elements in the table1234567891011121314151617181920212223242526MEMory Subsystem 13-9


HP058AHP058AHP058AHP058AHP058A1997 SCPI Comm<strong>and</strong> Referencestructure. The item lists maybe specified in long or short form, optional nodes if sent shall beaccepted without error. The item lists available <strong>and</strong> the legal combinations of these item listsare device dependent. All lists are empty (0 length) when DEFined.The second parameter, is the size of the TABLe. This is the maximum number of POINts ineach of the lists. Computations based on device dependent internal data formats will be madeto determine the number of bytes. For example, if the TABLe will have two lists <strong>and</strong> theinternal storage requires 8 bytes for a number, then an entry of 10 will allocate 160 bytes. Ifthere is insufficient room, execution error -225 (Out of memory) will be generated. The sizeof the table parameter is optional. The algorithm to allocate memory is device dependentwhen this parameter is omitted.The DEFine query returns both the <strong>and</strong> a numeric value for the size (inpoints) of memory allocated for the table. The elements of the structure string are returned inthe short form, with any optional nodes omitted.13.11.4 :FREQuency {,}MEMory:TABLe:FREQuencySpecifies the FREQuency points of the TABLe. If there are more ’s than inthe associated DEFine statement, execution error -223 (Too much data) will be generated.This item list is included in the table DEFine comm<strong>and</strong> as FREQuency.13At *RST, the contents of this list item is device dependent.13.11.4.1 :POINts?MEMory:TABLe:FREQuency:POINts?Returns the number of points in the FREQuency list of the SELected TABLe. If noFREQuency values have been sent POINts? returns 0. If no TABLe has been selected,POINts? returns NAN.13.11.5 :LOSSMEMory:TABLe:LOSS13.11.5.1 [:MAGNitude] {,}MEMory:TABLe:LOSS:MAGNitudeSpecifies the LOSS[:MAGNitude] points of the TABLe. The default unit is DB. If there aremore ’s than in the associated DEFine statement, execution error -223 (Toomuch data) will be generated. This item list is included in the table DEFine comm<strong>and</strong> asLOSS[:MAGNitude].At *RST, the contents of this list item is device dependent.13.11.5.1.1 :POINts?MEMory:TABLe:LOSS:MAGNitude:POINts?Returns the number of points in the LOSS[:MAGNitude] list of the SELected TABLe. If noLOSS[:MAGNitude] values have been sent POINts? returns 0. If no TABLe has beenselected, POINts? returns NAN.13-10 MEMory Subsystem


HP05HP05HP05HP05HP05HP05HP051997 SCPI Comm<strong>and</strong> Reference13.11.5.2 :PHASe {,}MEMory:TABLe:LOSS:PHASeSpecifies the LOSS:PHASe points of the TABLe. ’s may include angleunits as listed in the UNIT subsystem. The default unit is specified by UNIT:ANGLe. Ifthere are more ’s than in the associated DEFine statement, execution error-223 (Too much data) will be generated. This item list is included in the table DEFinecomm<strong>and</strong> as LOSS:PHASe.At *RST, the contents of this list item is device dependent.13.11.5.2.1 :POINts?MEMory:TABLe:LOSS:PHASe:POINts?Returns the number of points in the LOSS:PHASe list of the SELected TABLe. If noLOSS:PHASE values have been sent POINts? returns 0. If no TABLe has been selected,POINts? returns NAN.13.11.6 :POWerMEMory:TABLe:POWer13.11.6.1 [:MAGNitude] {,}MEMory:TABLe:POWer:MAGNitudeSpecifies the POWer[:MAGNitude] points of the TABLe. ’s may includePOWer units as listed in the UNIT subsystem. The default unit is specified by UNIT:POWer.If there are more ’s than in the associated DEFine statement, executionerror -223 (Too much data) will be generated. This item list is included in the table DEFinecomm<strong>and</strong> as POWer[:MAGNitude].At *RST, the contents of this list item is device dependent.13.11.6.1.1 :POINts?MEMory:TABLe:POWer:MAGNitude:POINts?Returns the number of points in the POWer[:MAGNitude] list of the SELected TABLe. If noPOWer[:MAGNitude] values have been sent POINts? returns 0. If no TABLe has beenselected, POINts? returns NAN.13.11.7 :RESistanceMEMory:TABLe:RESistance13.11.7.1 [:MAGNitude] {,}MEMory:TABLe:RESistance:MAGNitudeSpecifies the RESistance[:MAGNitude] points of the TABLe. If there are more’s than in the associated DEFine statement, execution error -223 (Toomuch data) will be generated. This item list is included in the table DEFine comm<strong>and</strong> asRESistance[:MAGNitude].At *RST, the contents of this list item is device dependent.1234567891011121314151617181920212223242526MEMory Subsystem 13-11


HP058AHP058AHP058AHP058AHP058AHP058AHP058A1997 SCPI Comm<strong>and</strong> Reference13.11.7.1.1 :POINts?MEMory:TABLe:RESistance:MAGNitude:POINts?Returns the number of points in the RESistance[:MAGNitude] list of the SELected TABLe.If no RESistance[:MAGNitude] values have been sent POINts? returns 0. If no TABLe hasbeen selected, POINts? returns NAN.13.11.8 :SELect MEMory:TABLe:SELectSets or queries the name of the TABLe selected. If the TABLe already exists, thenthe existing TABLe shall be selected. If the TABLe does not exist, then the newname shall be selected, but no TABLe shall be defined by this selection. The TABLe is character data.At *RST the select shall be device dependent.1313.11.9 :VOLTageMEMory:TABLe:VOLTage13.11.9.1 [:MAGNitude] {,}MEMory:TABLe:VOLTage:MAGNitudeSpecifies the VOLTage[:MAGNitude] points of the TABLe. ’s mayinclude voltage units as listed in the UNIT subsystem. The default unit is specified byUNIT:VOLTage. If there are more ’s than in the associated DEFinestatement, execution error -223 (Too much data) will be generated. This item list is includedin the table DEFine comm<strong>and</strong> as VOLTage[:MAGNitude].At *RST, the contents of this list item is device dependent.13.11.9.1.1 :POINts?MEMory:TABLe:VOLTage:MAGNitude:POINts?Returns the number of points in the VOLTage[:MAGNitude] list of the SELected TABLe. Ifno VOLTage[:MAGNitude] values have been sent POINts? returns 0. If no TABLe has beenselected, POINts? returns NAN.13.11.9.2 :PHASe {,}MEMory:TABLe:VOLTage:PHASeSpecifies the VOLTage:PHASe points of the TABLe. ’s may include angleunits as listed in the UNIT subsystem. The default unit is specified by UNIT:ANGLe. Ifthere are more ’s than in the associated DEFine statement, execution error-223 (Too much data) will be generated. This item list is included in the table DEFinecomm<strong>and</strong> as VOLTage:PHASe.At *RST, the contents of this list item is device dependent.13.11.9.2.1 :POINts?MEMory:TABLe:VOLTage:PHASe:POINts?Returns the number of points in the VOLTage:PHASe list of the SELected TABLe. If noVOLTage:PHASE values have been sent POINts? returns 0. If no TABLe has been selected,POINts? returns NAN.13-12 MEMory Subsystem


HP01997 SCPI Comm<strong>and</strong> Reference14 MMEMory SubsystemThe Mass MEMory subsystem provides mass storage capabilities for instruments. All massmemory device comm<strong>and</strong>s are contained in the MMEMory subsystem. The mass storagemay be either internal or external to the instrument. If the mass memory device is external,then the instrument must have controller capability on the mass memory device bus.The CLOSe, FEED, NAME, <strong>and</strong> OPEN comm<strong>and</strong>s permit the streaming of data fromanywhere in the data flow into a file; this is particularly useful for saving HCOPy output.2HP063e 3Mass storage media may be formatted in any one of a number of st<strong>and</strong>ard formats.Selecting Mass Memory Devices45When an instrument has multiple attached mass storage devices, the desired mass storage6unit is selected with the mass storage unit specifier . The syntax of the stringis instrument specific. Each instrument’s documentation shall describe the syntax applicable 7to that instrument. For example:8“C:”“:700,2”9“fileserv”Note that some file systems do not make use of the concept.1011File Names12The parameter described in the comm<strong>and</strong>s in this subsystem is a string. Thecontents of the string are dependent on the needs of the format of the mass storage media. In 13particular, the file name may contain characters for specifying subdirectories (that is, \ for 14DOS, / for HFS) <strong>and</strong> the separator for extensions in DOS (that is, period).15The following comm<strong>and</strong>s are provided for mass memory device operations.16KEYWORD PARAMETER FORM NOTESMMEMory17:CATalog? [] [query only]18:CDIRectory []:CLOSe [event; no query] 1993 19 HP063e:COPY,20|,, ,:DATA , 1995 21 TK054:DELete [,] [no query]22:FEED 1993 HP063e:INITialize [[,(LIF|DOS|HFS)23[,]]][no query]24:LOAD:DINTerchange ,[,] [no query]25:TRACe ,[,] [no query] 1992 HP026:MACRo ,[,] [no query]:STATe ,[,] [no query]MMEMory 14-11


1997 SCPI Comm<strong>and</strong> Reference14KEYWORD PARAMETER FORM NOTESHP087:TABLe ,[,] [no query] 1994:TRACe ,[,] [no query]:MSIS[]:MOVE (,) [no query] 1991|(,,,) 1991 HP048:NAME [,] 1993 HP063e:OPEN [event; no query] 1993 HP063e:PACK [no query] 1991 HP037:STORe:DINTerchange ,[,] [no query]:TRACe ,[,] [no query] 1992 HP066:MACRo ,[,] [no query]:STATe ,[,] [no query]:TABLe ,[,] [no query] 1994 HP087:TRACe ,[,] [no query]14.1 :CATalog? []MMEMory:CATalog?The CATalog comm<strong>and</strong> is query-only <strong>and</strong> returns information on the current contents <strong>and</strong>state of the mass storage media. Upon a CATalog? query, the instrument shall read thespecified mass memory device <strong>and</strong> returns its directory information in the following format:, {,}The instrument shall return two numeric parameters <strong>and</strong> as many strings as there are files inthe directory list. The first parameter shall indicate the total amount of storage currently usedin bytes. The second parameter shall indicate the total amount of storage available, also inbytes. The is a string. Each shall indicate the name, type, <strong>and</strong> sizeof one file in the directory list:,,Note that this syntax places some restrictions on the (for example, commas arenot allowed.) The is the exact name of a file as it appears in the directory list,including an extension if present. The provides the size of the file in bytes. The is indicated by one of the following:ASCii — An ASCii text fileBINary — A binary fileSTATe — Instrument (setting) stateTRACe — Trace (display) dataMACRo — An instrument macroFor media which cannot determine the file type from the directory information (i.e. DOS,HFS) this field shall be left blank.14-2 MMEMory


1997 SCPI Comm<strong>and</strong> Reference14.2 :CDIRectory []MMEMory:CDIRectoryChanges the default directory for a mass memory file system. The TK044parameter is a string. The contents of the parameter are dependent on thefile system being accessed. If no parameter is specified, the directory is set to the *RSTvalue.At *RST, this value is set to the root for DOS file systems <strong>and</strong> to a device-dependent value1TK044 2for other file systems such as HFS.14.3 :CLOSeMMEMory:CLOSe3HP063e4The CLOSe event causes the selected file specified in NAME to be closed. An attempt to 5CLOSe a file that was not open shall cause an error -256, (File name not found) to be 6generated.714.4 :COPY ,MMEMory:COPYThe COPY comm<strong>and</strong> copies an existing file to a new file.Two forms of parameters are allowed. The first form has two parameters. In this form, thefirst parameter specifies the source file, <strong>and</strong> the second parameter specifies the destinationfile.The second form has four parameters. In this form, the first <strong>and</strong> third parameter specify thefile_names. The second <strong>and</strong> fourth parameters specify the . The first pair ofparameters specifies the source file. The second pair specifies the destination file. An error isgenerated if the source file doesn’t exist. An error may be generated if the destination filealready exists.This comm<strong>and</strong> defines an event <strong>and</strong> thus has no *RST state or query form.14.5 :DATA , MMEMory:DATA8910111213141516TK05417The comm<strong>and</strong> form is MMEMory:DATA ,. The comm<strong>and</strong> loads into the file . is in 488.2 block format. is string data.The query form is MMEMory:DATA? with the response being the associated in block format.MMEMory:DATA? response is not affected by the FORMat subsystem.1819202114.6 :DELete [,]MMEMory:DELeteThe DELete comm<strong>and</strong> removes a file from the specified mass storage device. The parameter specifies the file_name to be removed.This comm<strong>and</strong> defines an event, <strong>and</strong> it has no *RST condition or query form.2223242526MMEMory 14-3


1997 SCPI Comm<strong>and</strong> Reference14.7 :FEED HP063eMMEMory:FEEDSets or queries the to be used to feed data into the file specified by NAME.New data arriving from always overwrites the contents of the file specifiedby NAME. If the generates new data <strong>and</strong> the file is not OPEN an error -256,(File name not found) shall be generated.At *RST, the value of FEED is device dependent.14.8 :INITialize [[,(LIF|DOS|HFS)[,]]]MMEMory:INITializeThe INITialize comm<strong>and</strong> is used to initialize the specified mass storage media. If the is not specified, the default is used. The default is the selected at *RST, notthe currently selected . The second parameter specifies the type of media to beformatted. The parameter is used to specify the format, interleave, sectorsizes, <strong>and</strong> other media-dependent information. Execution of the comm<strong>and</strong> attempts toinitialize the media. Previous data on the media, if any, is destroyed.This comm<strong>and</strong> is an event <strong>and</strong> does not have a query form or a *RST condition.14.9 :LOAD <strong>and</strong> :STOReMMEMory:LOAD <strong>and</strong> :STOReThe LOAD <strong>and</strong> STORe subsystems transfer information between the mass memory device<strong>and</strong> the instrument’s memory. The LOAD comm<strong>and</strong>s transfer from mass memory device tointernal memory, <strong>and</strong> STORe transfers from internal memory to the mass memory device.14When information is loaded, the instrument uses the file type information to determinewhether the data is in internal (BINary) or transportable (ASCii) form.The parameter is a quoted string <strong>and</strong> the refers to an internal identifierfor the instrument trace or macro.The LOAD <strong>and</strong> STORe comm<strong>and</strong>s do not have query forms.14.9.1 :DINTerchange ,[,]MMEMory:LOAD:DINTerchangeSpecifies that the device transfer DINTerchange formatted data.14.9.1.1 :TRACe ,[,]MMEMory:LOAD:DINTerchange:TRACeThe specified trace or array is loaded from or stored to the mass memory device inDINTerchange format.14.9.2 :MACRo ,[,]MMEMory:LOAD:MACRoThe specified macro is loaded from or stored to the mass memory device.14.9.3 :STATe ,[,]MMEMory:LOAD:STATe14-4 MMEMoryThe specified instrument state is stored or loaded. The parameter refers tothe state number, which corresponds to the numbers found in *SAV <strong>and</strong> *RCL.


HP0HP01997 SCPI Comm<strong>and</strong> Reference14.9.4 :TABLe ,[,]MMEMory:LOAD:TABLeThe MEMory:TABLe specified by is loaded from or stored to the mass memorydevice.14.9.5 :TRACe ,[,]MMEMory:LOAD:TRACeThe specified trace or array is loaded from or stored to the mass memory device.14.10 :MSIS []MMEMory:MSISHP0HP0871234The “Mass Storage IS” comm<strong>and</strong> selects a default mass storage device which is used by all 5MMEMory comm<strong>and</strong>s except INITialize. If the parameter is omitted, the device-dependentsetting for default mass storage device is selected.6At *RST, the value of this parameter is device-dependent.714.11 :MOVE (,)8|(,,,)MMEMory:MOVE9The MOVE comm<strong>and</strong> moves an existing file to another file name.10Two forms of the parameter are allowed. The first form has two parameters. In this form the 11first parameter, , specifies the file to be renamed, <strong>and</strong> the second parameter, 12, specifies the new name of the file.13The move operation is performed on the default mass storage device.14The second form has four parameters. The first two parameters, <strong>and</strong> ,specify the file name <strong>and</strong> storage device of the source file <strong>and</strong> the second two parameters, 15 <strong>and</strong> , specify the new file name <strong>and</strong> new storage device for the 16source file.17Some instruments may not support the moving of a file across mass storage devices <strong>and</strong> thusshall generate error -250, “Mass Storage Error”, when the msus parameters are not the same. 18If the does not exist, the instrument shall generate error -256, “File name not 19found”. If the already exists, the instrument shall generate error -257, “File name 20error”.21This comm<strong>and</strong> is an event-only comm<strong>and</strong> <strong>and</strong> thus has no *RST value, <strong>and</strong> no query form.2214.12 :NAME [,] HP063eMMEMory:NAME23Sets or queries the name of the file specification used by the CLOSe <strong>and</strong> OPEN comm<strong>and</strong>s.24At *RST, the value of this parameter is device dependent.2526MMEMory 14-5


HP0371997 SCPI Comm<strong>and</strong> Reference14.13 :OPEN HP063eMMEMory:OPENThe OPEN event causes the selected file specified in NAME to be opened. An attempt toOPEN a file that is already opened shall cause an error -257, (File name error) to begenerated. If the selected file is non-existent, it is created.14.14 :PACK []MMEMory:PACKThis comm<strong>and</strong> causes the mass storage device to be packed, such that unused memorybetween files is recovered <strong>and</strong> packed together. If an instrument, which supports file packing(ie: implements the MMEM:PACK comm<strong>and</strong>), receives the MMEM:PACK comm<strong>and</strong> butthe current disk format does not support file packing, the instrument shall generate an error-250 (Mass Storage Error). If the is not specified the default is used.This comm<strong>and</strong> defines an event <strong>and</strong> thus has no *RST state or query form.1414-6 MMEMory


1997 SCPI Comm<strong>and</strong> Reference15 OUTPut SubsystemThe OUTPut subsystem controls the characteristics of the source’s output port.A source which is sourcing impedance (programmable load) is allowed to alias thissubsystem as INPut, providing that the OUTPut keyword is also recognized <strong>and</strong> the INPut 1subsystem is not used for its intended purpose within the instrument.2KEYWORD PARAMETER FORM NOTESOUTPut|INPutSee text3:ATTenuation 4:COUPling AC|DC:FILTer5:AUTO | ONCE 1992 RS06:EXTernal 1992 RS0[:STATe] 1992 7RS0:HPASs8:FREQuency 1991 HP0[:STATe] 9:TYPE BESSel | CHEByshev 1992 RS010[:LPASs]:FREQuency 1991 11HP0[:STATe] 12:TYPE BESSel | CHEByshev 1992 RS0:IMPedance 13:LOW FLOat|GROund 1991 HP014:POLarity NORMal | INVerted 1992 HP0:POLarization 1994 RS010a 15:HORizontal [no query] 1994 RS010a 16:VERTical [no query] 1994 RS010a:POSition 1994 RS010a 17[:X] 1994 RS010a 18:ANGLe 1994 RS010a:DIRection UP|DOWN 1994 RS010a 19[:IMMediate] 1994 RS010a 20:LIMit 1994 RS010a:HIGH 1994 RS010a 21:LOW 1994 RS010a 22[:STATe] 1994 RS010a:OFFSet 1994 RS010a23:VELocity 1994 RS010a 24[:DISTance] 1994 RS010a:DIRection UP|DOWN 1994 RS010a25[:IMMediate] 1994 RS010a 26:LIMit 1994 RS010a:HIGH 1994 RS010aOUTPut Subsystem 15-1


1997 SCPI Comm<strong>and</strong> Reference15KEYWORD PARAMETER FORM NOTES:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994:Y 1994:ANGLe 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994[:DISTance] 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994:Z 1994:ANGLe 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994[:DISTance] 1994:DIRection UP|DOWN 1994[:IMMediate] 1994:LIMit 1994:HIGH 1994:LOW 1994[:STATe] 1994:OFFSet 1994:VELocity 1994:PROTection:DELay 15-2 OUTPut SubsystemRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a


RS01997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES[:STATe] :TRIPped?[query only]:CLEar[no query]:ROSCillator 1991 HP01[:STATe] 1991 HP0:TTLTrg2|:ECLTrg 1991 HP03:IMMediate 1991 HP0:LEVel 1991 HP04:POLarity NORMal|INVerted 1994 TK0305:PROTocol SYNChronous|SSYNchronous|ASYNchronous 1991 PH0:WIDTh 1991 PH06[:STATe] :SOURce 7[:STATe] 8:TYPE 1992 RS0915.1 :ATTenuation OUTPut:ATTenuation10Sets the output ATTenuation level. The default units are in the current relative amplitudeunits.This should only be used where the setting is not reflected within the SOURce subsystem.For example, setting the output attenuation to 10 dB will cause the generated signal todecrease in amplitude by 10 dB. However, the power level setting will be unaffected bychanging the output attenuation.At *RST, this value is device-dependent.15.2 :COUPling AC|DCOUTPut:COUPlingControls whether the signal is AC or DC coupled to the output port.At *RST, this value is device-dependent.15.3 :FILTerOUTPut:FILTerThe FILTer function allows filters to be inserted in the path of the signal.15.3.1 :AUTO | ONCEOUTPut:FILTer:AUTOAllows the system to determine the best filter characteristic <strong>and</strong> cutoff frequency. Explicitlyselecting any output filter or output filter characteristic shall set AUTO OFF.At *RST, this value is device dependent.15.3.2 :EXTernalOUTPut:FILTer:EXTernalControls an external, user provided, filter.OUTPut Subsystem 15-311121314151617181920212223242526


RS002RS002HP008RS003HP008RS0031997 SCPI Comm<strong>and</strong> Reference15.3.2.1 [:STATe] OUTPut:FILTer:EXTernal:STATeSelects a user provided filter. When STATe is ON the filter is placed in the signal path.At *RST, this value is OFF.15.3.3 :HPASsOUTPut:FILTer:HPASsControls the high pass filter.15.3.3.1 :FREQuency OUTPut:FILTer:HPASs:FREQuencyDetermines the cutoff frequency of the high pass filter.At *RST, this value is device-dependent.15.3.3.2 [:STATe] OUTPut:FILTer:HPASs:STATeTurns the high pass filter ON <strong>and</strong> OFF.At *RST, this value is device-dependent.15.3.3.3 :TYPE BESSel | CHEByshevOUTPut:FILTer:HPASs:TYPEDetermines the characteristic of the high pass filter.At *RST, this value is device dependent.1515.3.4 [:LPASs]OUTPut:FILTer:LPASsControls the low pass filter.15.3.4.1 :FREQuency OUTPut:FILTer:LPASs:FREQuencyDetermines the cutoff frequency of the low pass filter.At *RST, this value is device-dependent.15.3.4.2 [:STATe] OUTPut:FILTer:LPASs:STATeTurns the low pass filter ON <strong>and</strong> OFF.At *RST, this value is device-dependent.15.3.4.3 :TYPE BESSel | CHEByshevOUTPut:FILTer:LPASs:TYPEDetermines the characteristic of the low pass filter.At *RST, this value is device dependent.15-4 OUTPut Subsystem


HP0HP01997 SCPI Comm<strong>and</strong> Reference15.4 :IMPedance OUTPut:IMPedanceOUTPut source impedance for the signal specified in Ohms.At *RST, this value is device-dependent.15.5 :LOW FLOat|GROundOUTPut:LOWConnects the low signal terminal to ground or allows it to float.This parameter is set to a device-dependent value at *RST.15.6 :POLarity NORMal | INVertedOUTPut:POLaritySets or queries the output polarity. NORMal causes the source block’s signal to appear at theoutput with the same polarity as it was generated. INVerted causes the polarity of the sourceblock’s signal to be reversed when it appears at the output terminals.At *RST, this value is NORMal.15.7 :POLarization OUTPut:POLarizationSets the polarization of the output. The default units are radian.At *RST, this value is device-dependent.15.7.1 :HORizontalOUTPut:POLarization:HORizontalSets the polarization of the output to zero. This comm<strong>and</strong> is an event. Therefore it has noassociated query or meaning at *RST.15.7.2 :VERTicalOUTPut:POLarization:VERTicalSets the polarization of the output to PI/2 radians. This comm<strong>and</strong> is an event. Therefore ithas no associated query or meaning at *RST.15.8 :POSitionOUTPut:POSitionThe characteristics of an incoming signal can be affected by the output’s spatial position <strong>and</strong>orientation relative to the origin. The definition of the origin is application specific. Thissubsystem uses a righth<strong>and</strong> coordinate system <strong>and</strong> has only one origin.In this subsystem only the IMMediate comm<strong>and</strong>s initiate movement.In this subsystem velocity is always positive.15.8.1 [:X]OUTPut:POSition:XControls the settings concerning the X-axis.12345678RS010a 9101112RS010a131415RS010a161718RS010a1920212223RS010a 242526RS010aOUTPut Subsystem 15-5


1997 SCPI Comm<strong>and</strong> Reference1515.8.1.1 :ANGLeOUTPut:POSition:X:ANGLeSpecifies the angle of rotation around the X-axis.15.8.1.1.1 :DIRection UP|DOWNOUTPut:POSition:X:ANGLe:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP15.8.1.1.2 [:IMMediate] OUTPut:POSition:X:ANGLe:IMMediateThis comm<strong>and</strong> indicates that the output is moved to the specified position without waitingfor further comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.15.8.1.1.3 :LIMitOUTPut:POSition:X:ANGLe:LIMitSets the maximum bounds on the physical POSition.15.8.1.1.3.1 :HIGH OUTPut:POSition:X:ANGLe:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the clockwise physical limit.15.8.1.1.3.2 :LOW OUTPut:POSition:X:ANGLe:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the counterclockwise physical limit.15.8.1.1.3.3 :STATe OUTPut:POSition:X:ANGLe:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.15.8.1.1.4 :OFFSet OUTPut:POSition:X:ANGLe:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.15.8.1.1.5 :VELocity OUTPut:POSition:X:ANGLe:VELocityControls the velocity of the angular rotation around the x-axis.At *RST, this value is device dependent.RS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a15-6 OUTPut Subsystem


1997 SCPI Comm<strong>and</strong> Reference15.8.1.2 [:DISTance]OUTPut:POSition:X:DISTanceControls the settings in linear direction of the X-axis.15.8.1.2.1 :DIRection UP|DOWNOUTPut:POSition:X:DISTance:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP15.8.1.2.2 [:IMMediate] OUTPut:POSition:X:DISTance:IMMediateThis comm<strong>and</strong> indicates that the output is moved to the specified position without waitingfor further comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.15.8.1.2.3 :LIMitOUTPut:POSition:X:DISTance:LIMitSets the maximum bounds on the physical POSition.15.8.1.2.3.1 :HIGH OUTPut:POSition:X:DISTance:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the upper physical limit.15.8.1.2.3.2 :LOW OUTPut:POSition:X:DISTance:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the lower physical limit.15.8.1.2.3.3 :STATe OUTPut:POSition:X:DISTance:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.15.8.1.2.4 :OFFSet OUTPut:POSition:X:DISTance:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.15.8.1.2.5 :VELocity OUTPut:POSition:X:DISTance:VELocityControls the velocity of the displacement on the x-axis.At *RST, this value is device dependent.RS010a123RS010a4567RS010a89RS010a111213RS010a141516RS010a171819RS010a 20212223RS010a242526RS010aOUTPut Subsystem 15-7


1997 SCPI Comm<strong>and</strong> Reference1515.8.2 :YOUTPut:POSition:YControls the settings concerning the Y-axis.15.8.2.1 :ANGLeOUTPut:POSition:Y:ANGLeSpecifies the angle of rotation around the Y-axis.15.8.2.1.1 :DIRection UP|DOWNOUTPut:POSition:Y:ANGLe:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP15.8.2.1.2 [:IMMediate] OUTPut:POSition:Y:ANGLe:IMMediateThis comm<strong>and</strong> indicates that the output is moved to the specified position without waitingfor further comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.15.8.2.1.3 :LIMitOUTPut:POSition:Y:ANGLe:LIMitSets the maximum bounds on the physical POSition.15.8.2.1.3.1 :HIGH OUTPut:POSition:Y:ANGLe:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the clockwise physical limit.15.8.2.1.3.2 :LOW OUTPut:POSition:Y:ANGLe:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the counterclockwise physical limit.15.8.2.1.3.3 :STATe OUTPut:POSition:Y:ANGLe:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.15.8.2.1.4 :OFFSet OUTPut:POSition:Y:ANGLe:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.15.8.2.1.5 :VELocity OUTPut:POSition:Y:ANGLe:VELocityControls the velocity of the angular rotation around the y-axis.RS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a15-8 OUTPut Subsystem


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device dependent.15.8.2.2 [:DISTance]OUTPut:POSition:Y:DISTanceControls the settings in linear direction of the Y-axis.15.8.2.2.1 :DIRection UP|DOWNOUTPut:POSition:Y:DISTance:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP15.8.2.2.2 [:IMMediate] OUTPut:POSition:Y:DISTance:IMMediateThis comm<strong>and</strong> indicates that the output is moved to the specified position without waitingfor further comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.15.8.2.2.3 :LIMitOUTPut:POSition:Y:DISTance:LIMitSets the maximum bounds on the physical POSition.15.8.2.2.3.1 :HIGH OUTPut:POSition:Y:DISTance:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the upper physical limit.15.8.2.2.3.2 :LOW OUTPut:POSition:Y:DISTance:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the lower physical limit.15.8.2.2.3.3 :STATe OUTPut:POSition:Y:DISTance:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.15.8.2.2.4 :OFFSet OUTPut:POSition:Y:DISTance:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.15.8.2.2.5 :VELocity OUTPut:POSition:Y:DISTance:VELocityControls the velocity of the displacement on the y-axis.At *RST, this value is device dependent.RS010a1RS010a234RS010a5678RS010a910RS010a 11121314RS010a151617RS010a181920RS010a 21222324RS010a2526OUTPut Subsystem 15-9


1997 SCPI Comm<strong>and</strong> Reference1515.8.3 :ZOUTPut:POSition:ZControls the settings concerning the Z-axis15.8.3.1 :ANGLeOUTPut:POSition:Z:ANGLeSpecifies the angle of rotation around the Z-axis.15.8.3.1.1 :DIRection UP|DOWNOUTPut:POSition:Z:ANGLe:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP15.8.3.1.2 [:IMMediate] OUTPut:POSition:Z:ANGLe:IMMediateThis comm<strong>and</strong> indicates that the output is moved to the specified position without waitingfor further comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.15.8.3.1.3 :LIMitOUTPut:POSition:Z:ANGLe:LIMitSets the maximum bounds on the physical POSition.15.8.3.1.3.1 :HIGH OUTPut:POSition:Z:ANGLe:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the clockwise physical limit.15.8.3.1.3.2 :LOW OUTPut:POSition:Z:ANGLe:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the counterclockwise physical limit.15.8.3.1.3.3 :STATe OUTPut:POSition:Z:ANGLe:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.15.8.3.1.4 :OFFSet OUTPut:POSition:Z:ANGLe:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.15.8.3.1.5 :VELocity OUTPut:POSition:Z:ANGLe:VELocityControls the velocity of the angular rotation around the z-axis.15-10 OUTPut SubsystemRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010aRS010a


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device dependent.15.8.3.2 [:DISTance]OUTPut:POSition:Z:DISTanceControls the settings in linear direction of the Z-axis.15.8.3.2.1 :DIRection UP|DOWNOUTPut:POSition:Z:DISTance:DIRectionControls the direction of the movement when started with INITiate.At *RST, this is set to UP15.8.3.2.2 [:IMMediate] OUTPut:POSition:Z:DISTance:IMMediateThis comm<strong>and</strong> indicates that the output is moved to the specified position without waitingfor further comm<strong>and</strong>s.*RST has no effect on the IMMediate value except that movement shall stop.15.8.3.2.3 :LIMitOUTPut:POSition:Z:DISTance:LIMitSets the maximum bounds on the physical POSition.15.8.3.2.3.1 :HIGH OUTPut:POSition:Z:DISTance:LIMit:HIGHSets the maximum for the POSition.At *RST, this value is set to the upper physical limit.15.8.3.2.3.2 :LOW OUTPut:POSition:Z:DISTance:LIMit:LOWSets the minimum for the POSition.At *RST, this value is set to the lower physical limit.15.8.3.2.3.3 :STATe OUTPut:POSition:Z:DISTance:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.15.8.3.2.4 :OFFSet OUTPut:POSition:Z:DISTance:OFFSetThis defines a single value that is subtracted from the physical POSition.At *RST, this value is device-dependent.15.8.3.2.5 :VELocity OUTPut:POSition:Z:DISTance:VELocityControls the velocity of the displacement on the z-axis.At *RST, this value is device dependent.RS010a1RS010a234RS010a5678RS010a910RS010a 11121314RS010a151617RS010a181920RS010a 21222324RS010a2526OUTPut Subsystem 15-11


HP044HP044HP0231997 SCPI Comm<strong>and</strong> Reference1515.9 :PROTectionOUTPut:PROTectionControls the characteristics of the output protection or foldback circuits.15.9.1 :DELay OUTPut:PROTection:DELayControls the amount of time the protection trip condition must be true before the subsequentprotection is taken (for example, tripping a foldback circuit or reporting an error). The unitsfor the parameter are seconds.At *RST, this value is device-dependent.15.9.2 [:STATe] OUTPut:PROTection:STATeControls whether the output protection circuit is enabled.At *RST, this value is device-dependent.15.9.3 :TRIPped?OUTPut:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped. TRIPpedonly has a query form <strong>and</strong> thus has no associated *RST condition.15.9.4 :CLEarOUTPut:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.15.10 :ROSCillatorOUTPut:ROSCillatorThe ROSCillator subtree controls the output on the ROSCillator OUTPut port.15.10.1 [:STATe] OUTPut:ROSCillator:STATeThe STATe comm<strong>and</strong> selects whether or not the device outputs a signal on its ROSCillatorport. When ON is selected, the device outputs a signal; when OFF, it does not.At *RST, STATe OFF shall be selected.15.11 :TTLTrg|:ECLTrgOUTPut:TTLTrg|:ECLTrgThe TTLTrg <strong>and</strong> ECLTrg subtrees control the driving of the VXI backplane TTL <strong>and</strong> ECLtrigger buses. A numeric suffix is required, indicating the particular line in the bus. Validlines are TTLTrg0 through TTLrg7, <strong>and</strong> ECLTrg0 through ECLTrg5.15.11.1 :IMMediateOUTPut:TTLTrg|:ECLTrg:IMMediateThe IMMediate comm<strong>and</strong> causes a pulse to appear on the specified trigger line, regardless ofthe level.15-12 OUTPut Subsystem


HP0PH01997 SCPI Comm<strong>and</strong> Reference15.11.2 :LEVel OUTPut:TTLTrg|:ECLTrg:LEVelThe LEVel comm<strong>and</strong> sets the selected TTLTrg or ECLTrg line to a logical level 0 or 1. ForTTL, level 0 is 5 volts <strong>and</strong> level 1 is 0 volts. For ECL level 0 is -2 volts <strong>and</strong> level 1 is 0 volts.At *RST, LEVel is set to OFF.15.11.3 :POLarity NORMal|INVertedOUTPut:TTLTrg|:ECLTrg:POLarityThis comm<strong>and</strong> sets <strong>and</strong> queries the polarity of the specified VXI TTL or ECL trigger line.At *RST, the value of this parameter is NORMal.15.11.4 :PROTocol SYNChronous|SSYNchronous|ASYNchronousOUTPut:TTLTrg|:ECLTrg:PROTocolThis comm<strong>and</strong> selects the trigger protocol for the VXI TTLTrg or ECLTrg trigger lines. Theprotocols are specified in the VXIbus System Specification Revision 1.4 under sectionsB.6.2.3 <strong>and</strong> B.6.2.4.SYNChronous selects the synchronous trigger protocol.SSYNchronous selects the semi-synchronous trigger protocol.ASYNchronous selects the asynchronous trigger protocol.At *RST, the SYNChronous protocol is selected for all trigger lines.15.11.5 :WIDTh OUTPut:TTLTrg|:ECLTrg:WIDThSelects width of the pulse being generated by the OUTPut:TTLTrg:IMMediate orOUTPut:ECLTrg:IMMediate comm<strong>and</strong>. The default units are seconds.The *RST value is device dependent.15.11.6 [:STATe] OUTPut:TTLTrg|:ECLTrg:STATeThe STATe comm<strong>and</strong> selects whether or not the VXI module drives the VXI backplanetrigger line. When ON is selected, the module shall drive the trigger line; when OFF, it shallnot.At *RST, STATe OFF shall be selected.15.11.7 :SOURce OUTPut:TTLTrg|:ECLTrg:SOURceControls which signal from the VXI module shall drive the VXI backplane trigger line.Source names are character data, such as INTernal or EXTernal.At *RST, the value of this parameter is device dependent.1TK030 23456HP09378HP093 910 HP09311 HP093121314151617181920212223242526OUTPut Subsystem 15-13


HP066RS0071997 SCPI Comm<strong>and</strong> Reference15.12 [:STATe] OUTPut:STATeThe STATe function controls whether the output terminals are open or closed. When thefunction is OFF, the terminals are at maximum isolation from the signal.At *RST, this function shall be set to OFF.15.13 :TYPE OUTPut:TYPESelects the output characteristic to be used if more than one is available.The following characteristics are currently defined for instruments:BALanced – balanced or differential output.UNBalanced – unbalanced with respect to ground.At *RST the TYPE is device-dependent.1515-14 OUTPut Subsystem


1997 SCPI Comm<strong>and</strong> Reference16 PROGram SubsystemThe purpose of the PROGram subsystem is to provide the administrative features needed togenerate <strong>and</strong> control one or more user-programmed tasks resident in an instrument. Twodistinct methods of accessing a particular program are provided in the PROGramsubysystem. One method employs EXPLicit reference for each comm<strong>and</strong>, allowing access toall programs, but requires the program name to be always specified. The other methodallows a single program to be SELected at a time, <strong>and</strong> the related comm<strong>and</strong>s access only thecurrently selected program. If the EXPLicit method is implemented, then the SELectedmethod shall also be implemented.A *RST received from a remote controller, via the device interface, shall cause all programs 5to be stopped.6A *RST generated by a program running in the device shall cause the same effect as a *RSTreceived from a remote controller, with the exception that the program that generated the 7*RST shall not be forced to stop. It is necessary for a *RST to behave in this manner so that 8a program, when run on either a remote controller or the device, shall have the same effect.9KEYWORD PARAMETER FORM NOTESPROGram10:CATalog?[query only]11[:SELected]:DEFine :DELete[no query]1213[:SELected]:ALL14:EXECute [no query]15:MALLocate |DEFault:NAME 16:NUMBer {,}17:WAIT:STATe (RUN|PAUSe|STOP|CONTinue):STRing {,}199118HP019:EXPLicit:DEFine ,20:DEFine? [query only]21:DELete :EXECute , [no query]22:MALLocate ,(|DEFault)23:NUMBer ,{,}:STATe ,(RUN|PAUSe|STOP|CONTinue)24:STRing ,{,}25:WAIT 1991261234PROGram 16-1


HP0091997 SCPI Comm<strong>and</strong> Reference16.1 :CATalog?PROGram:CATalog?The CATalog query comm<strong>and</strong>s lists all the defined programs. Response is a list ofcomma-separated strings. Each string contains the name of a program. If no programs arecurrently defined, then response is a null string ( “” ).16.2 [:SELected]PROGram:SELectedAll the comm<strong>and</strong>s under this node access only the program that has been selected by theNAME comm<strong>and</strong>.16.2.1 :DEFine PROGram:SELected:DEFineThe DEFine comm<strong>and</strong> is used to create <strong>and</strong> download programs. The DEFine query is usedto upload programs. The program name used for the definition is the currently selectedprogram name.In the DEFine comm<strong>and</strong>, the selected program name shall represent a unique name. That is,to download <strong>and</strong> overwrite an existing program with the same program name, the existingprogram must be DELeted first. If such an attempt is made without deleting first, an “Illegalprogram name” error (-282) shall be generated.The shall be block data. The contents are device-dependent. When overflowoccurs a program error (-28X) shall be generated.In the DEFine query, the selected program shall be returned. The shall beuploaded as definite length arbitary block response data.1616.2.2 :DELetePROGram:SELected:DELeteThe DELete comm<strong>and</strong> deletes downloaded programs.16.2.2.1 [:SELected]PROGram:SELected:DELete:SELectedThis comm<strong>and</strong> causes the selected program to be deleted.16.2.2.2 :ALLPROGram:SELected:DELete:ALLALL is used to specify that all programs in the device are to be deleted. If any of theprograms are in the RUN state, a “Program currently running” error (-284) shall begenerated <strong>and</strong> no programs shall be deleted.16.2.3 :EXECute PROGram:SELected:EXECuteThe EXECute comm<strong>and</strong> executes the in the selected programenvironment. is string data representing any legal program comm<strong>and</strong>.If the string data is not legal, then a “Program syntax error” (-285) shall be generated. Theselected program shall be in either the PAUSed or STOPped state before the EXECute16-2 PROGram:CATalog?


1997 SCPI Comm<strong>and</strong> Referencecomm<strong>and</strong> shall be allowed. If the program is in the RUN state, a “Program currentlyrunning” error (-284) shall be generated.16.2.4 :MALLocate |DEFaultPROGram:SELected:MALLocateThe Memory ALLocate comm<strong>and</strong> is used to reserve memory space in the device for use bythe selected program. If DEFault is specified, then the device shall calculate the amount ofmemory needed. is numerical data which specifies the required memory in bytes.If the required memory is greater than the space available, then a parameter error “Data outof range” (-222) shall be generated.*RST has no effect on the value of MALLocate.16.2.5 :NAME PROGram:SELected:NAMEThe NAME comm<strong>and</strong> defines the name of the program to be selected. If the program name already exists, then that existing program shall be selected. If the programname does not exist, then the new name shall be selected, but no program shall be defined bythis selection. is character data.*RST causes the selected name to become PROG.16.2.6 :NUMBer {,}PROGram:SELected:NUMBerThe NUMBer comm<strong>and</strong> is used to set <strong>and</strong> query the contents of numeric program variables<strong>and</strong> arrays in the currently selected program. The currently selected program must be aDEFined program, otherwise an “Illegal program name” error (-282) shall be generated. Thevariable specified in shall be the name of an existing variable in the selectedprogram, otherwise an “Illegal variable name” error (-283) shall be generated. can be either character data or string data. is a list of comma separated which are used to set . If the specified variable cannot hold allof the specified then a “Parameter not allowed” error ( -108 ) shall begenerated.The query form NUMBer? returns the contents of the variable as a commaseparated list16.2.7 :STATe RUN|PAUSe|STOP|CONTinuePROGram:SELected:STATeThe STATe comm<strong>and</strong> is used to either set the state or query the state of a selected program.The following matrix defines the effect of setting the STATe to the desired value from eachof the possible current states. In certain cases a parameter error “Settings conflict” (-221)shall be generated.The states are described as follows:RUNNING: The program is currently executingPAUSED:The program has reached a break in execution but can be continued.STOPPED: Execution has been terminated.1234567891011121314151617181920212223242526PROGram[:SELected] 16-3


HP0091997 SCPI Comm<strong>and</strong> Referencestaterequestedcurrent state16RUNNING PAUSED STOPPEDRUN error (-221) RUNNING RUNNINGCONT error (-221) RUNNING error (-221)PAUSE PAUSED PAUSED STOPPED16.2.8 :STRing {,}PROGram:SELected:STRingThe STRing comm<strong>and</strong> is used to set <strong>and</strong> query the contents of string program variables <strong>and</strong>arrays in the currently selected program. The currently selected program must be a DEFinedprogram, otherwise an “Illegal program name” error (-282) shall be generated. The variablespecified in shall be the name of an existing variable in the selected program,otherwise an “Illegal variable name” error (-283) shall be generated. can beeither character data or string data. is a list of comma-separated strings which areused to set . If the specified variable cannot hold all of the specified string valuesthen a “Parameter not allowed” error (-108 ) shall be generated. If a string value is too longthen it will be truncated when stored in the programs variable.The query form STRing? returns the contents of the variable as a commaseparated list16.2.9 :WAITPROGram:SELected:WAITThe WAIT comm<strong>and</strong> <strong>and</strong> its query form shall cause no further comm<strong>and</strong>s or queries to beexecuted, until the selected program exits from the RUN state, that is either STOPped orPAUSed. For the query, a 1 is returned in NR1 format at this time, when the program iseither STOPped or PAUSed.16.3 :EXPLicitPROGram:EXPLicitAll the comm<strong>and</strong>s under the EXPLicit node directly reference the desired program by name,thus allowing access to a program without having to change the selected program. The parameter is required for these comm<strong>and</strong>s.16.3.1 :DEFine ,PROGram:EXPLicit:DEFineThe DEFine comm<strong>and</strong> is used to create <strong>and</strong> download programs. The DEFine query is usedto upload programs.In the DEFine comm<strong>and</strong>, the specified program name shall represent a unique name. That is,to download <strong>and</strong> overwrite an existing program with the same program name, the existingprogram must be DELeted first. If such an attempt is made, without deleting first, an “Illegalprogram name” error (-282) shall be generated.16-4 PROGram:EXPLicit


1997 SCPI Comm<strong>and</strong> ReferenceThe shall be block data. The contents are device-dependent. When overflowoccurs a program error (-28X) shall be generated.In the DEFine query, the specified program name shall be the name of an existing program;otherwise an “Illegal program name” error (-282) shall be generated. The shallbe uploaded as definite length arbitary block response data.16.3.2 :DELete PROGram:EXPLicit:DELeteThe delete comm<strong>and</strong> deletes the specified downloaded program.16.3.3 :EXECute ,PROGram:EXPLicit:EXECuteThe EXECute comm<strong>and</strong> executes the in the specified programenvironment. is string data representing any legal program comm<strong>and</strong>.If the string data is not legal, then a “Program syntax error” (-285) shall be generated. Thespecified program shall be in either the PAUSed or STOPped state before the EXECutecomm<strong>and</strong> shall be allowed. If the program is in the RUN state, a “Program currentlyrunning” error (-284) shall be generated.16.3.4 :MALLocate ,(|DEFault)PROGram:EXPLicit:MALLocateThe Memory ALLocate comm<strong>and</strong> is used to reserve memory space in the device for use bythe specified program. The specified program shall be the name of an existing program,otherwise an “Illegal program name” error (-282) shall be generated. If DEFault is specified,then the device shall calculate the amount of memory needed. is numerical datawhich specifies the required memory in bytes. If the required memory is greater than thespace available, then a parameter error “Data out of range” (-222) shall be generated.*RST has no effect on the value of MALLocate.16.3.5 :NUMBer ,{,}PROGram:EXPLicit:NUMBerThe NUMBer comm<strong>and</strong> is used to set <strong>and</strong> query the contents of numeric program variables<strong>and</strong> arrays in the specified program. The specified program must be a DEFined program,otherwise an “Illegal program name” error (-282) shall be generated. The variable specifiedin shall be the name of an existing variable in the specified program, otherwisean “Illegal variable name” error (- 283) shall be generated. can be eithercharacter data or string data. is a list of comma-separated which are used to set . If the specified variable cannot hold all of the specified, then a “Parameter not allowed” error (-108 ) shall be generated.The query form NUMBer? returns the contents of the variable as a commaseparated list16.3.6 :STATe ,(RUN|PAUSe|STOP|CONTinue)PROGram:EXPLicit:STATeThe STATe comm<strong>and</strong> is used to either set the state or query the state of the specifiedprogram. The matrix below defines the effect of setting the STATe to the desired value from1234567891011121314151617181920212223242526PROGram:EXPLicit 16-5


HP0091997 SCPI Comm<strong>and</strong> Referenceeach of the possible current states. In certain cases a parameter error “Settings conflict”(-221) shall be generated.16desiredcurrent statestateRUNNING PAUSED STOPPEDRUN error (-221) RUNNING RUNNINGCONT error (-221) RUNNING error (-221)PAUSE PAUSED PAUSED STOPPEDSTOP STOPPED STOPPED STOPPEDThe states are described as follows:RUNNING: The program is currently executingPAUSED:The program has reached a break in execution but can be continued.STOPPED: Execution has been terminated.16.3.7 :STRing ,{,}PROGram:EXPLicit:STRingThe STRing comm<strong>and</strong> is used to set <strong>and</strong> query the contents of string program variables <strong>and</strong>arrays in the specified program. The specified program must be a DEFined program,otherwise an “Illegal program name” error (-282) shall be generated. The variable specifiedin shall be the name of an existing variable in the specified program, otherwisean “Illegal variable name” error (-283) shall be generated. can be either characterdata or string data. is a list of comma-separated strings which are used to set. If the specified variable cannot hold all of the specified string values, then a“Parameter not allowed” error (-108) shall be generated. If a string value is too long then itwill be truncated when stored in the programs variable.The query form STRing? returns the contents of the variable as a commaseparated list16.3.8 :WAIT PROGram:EXPLicit:WAITThe WAIT comm<strong>and</strong> <strong>and</strong> its query form shall cause no further comm<strong>and</strong>s or queries to beexecuted, until the defined program exits from the RUN state, that is either STOPped orPAUSed. For the query, a 1 is returned in NR1 format at this time, when the program iseither STOPped or PAUSed.16-6 PROGram:EXPLicit


HP01997 SCPI Comm<strong>and</strong> Reference17 ROUTe SubsystemIn the SCPI instrument model, the block where user accessibility to the actual signals occursis called “signal routing.” In some instruments this function may be trivial <strong>and</strong> thuscomm<strong>and</strong>s for this block would not be required. In such cases the ports associated with theINPut or OUTput blocks are available directly to the user, typically on the instrument’s frontpanel. The ROUTe comm<strong>and</strong>s apply equally to instruments whose primary purpose is toprovide signal routing <strong>and</strong> to instruments that provide some routing capability “in front of”the INPut <strong>and</strong>/or OUTput blocks.The ROUTe node may be optional in a particular instrument. This capability is intended forinstruments whose primary function is signal routing. The ROUTe node cannot be optional if 5either SENSe or SOURce is optional, since only one node at a given level may be optional.6KEYWORD PARAMETER FORM NOTES:ROUTe7:CLOSe 1992 HP08:STATe?[query only]:OPEN 1992 9HP0:ALL [event; no query] 1993 10 HP078:SCAN 1992,4 KI002HP0:PATH11:CATalog?[query only]12:DELete:DEFine ,:DEFine? 1314:MODule:CATalog?[query only]:DEFine ,[:NAME] [event; no query]:ALL[event; no query] 151617:DEFine? 18:DELete[:NAME] [event; no query] 19:ALL[event; no query] 20:TERMinals FRONt | REAR | BOTH | NONE 1992 KI003HP017.1 :CLOSe ROUTe:CLOSeThe CLOSe comm<strong>and</strong> allows specific individual channels to be closed or queried. If all thespecified channels cannot be closed, an execution error is reported.For example, suppose a module contains a coaxial multiplexor, <strong>and</strong> only one channel on abank is able to be closed at a time. If a comm<strong>and</strong> tries to close two channels on the samebank, the instrument should report an execution error.1234212223242526ROUTe Subsystem 17-1


HP0621997 SCPI Comm<strong>and</strong> ReferenceCLOSe may be an overlapped comm<strong>and</strong>. The *OPC mechanism may be used to determinewhen switches are actually closed or opened. The sequence in which channels are closed isnot guaranteed.The CLOSe? query allows the condition of individual switches to be queried. The instrumentreturns a 1 or 0 for each channel in the list, in the same order that the list is specified. Aresponse of 1 means the channel is closed <strong>and</strong> a 0 means the channel is open.At *RST, this value is device-dependent.17.1.1 :STATe?ROUTe:CLOSe:STATe?The ROUTe:CLOSe:STATe? query, which has no parameters, returns an IEEE 488.2definite length block which contains a of all the closed switches in the entireinstrument.17.2 :OPEN ROUTe:OPENThe OPEN comm<strong>and</strong> allows specific channels to be opened or queried.OPEN may be an overlapped comm<strong>and</strong>. The *OPC mechanism may be used to determinewhen switches are actually closed or opened. The sequence in which channels are opened isnot guaranteed.The query OPEN? allows the condition of switches to be queried. The instrument returns a 1or 0 for each channel in the list, in the same order that the list is specified. A response of 0means the channel is closed <strong>and</strong> a 1 means the channel is open.At *RST, this value is device-dependent.1717.2.1 :ALL HP078ROUTe:OPEN:ALLThe OPEN:ALL comm<strong>and</strong> opens all the channels.OPEN:ALL may be an overlapped comm<strong>and</strong>. The *OPC mechanism may be used todetermine when switches are actually closed or opened. The sequence in which channels areopened is not guaranteed.17.3 :SCAN ROUTe:SCANThe SCAN comm<strong>and</strong> specifies or queries a list of channels for the instrument to sequencethrough. The instrument will automatically step through the list of channels provided whenthe trigger subsystem device action occurs. The device action is to open the channelpreviously closed, then to close the next channel in the list. Whether this action isbreak-before-make is device-dependent.HP062KI002The INITiate[:IMMediate] comm<strong>and</strong> must be sent in order to initiate scanning.Execution of the SCAN comm<strong>and</strong>, <strong>and</strong> the resulting scan operation, may or may not openany channels which are already closed.17-2 ROUTe Subsystem


1997 SCPI Comm<strong>and</strong> ReferenceIf the parameter contains a , the instrument will exp<strong>and</strong> therange into its individual channels, <strong>and</strong> scan each channel individually. For example,(@1,3:5,9) will be scanned identically to (@1,3,4,5,9).The query, which has no parameter, returns the scan list. The format of the response is anIEEE 488.2 definite length block which contains a . The instrument mayreturn the scan list exactly as it was received, or it may return an equivalent list with paths orranges exp<strong>and</strong>ed.Note: The query form was added in 1994.17.4 :PATHROUTe:PATHThe PATH subsystem controls the binding of elements.17.4.1 :CATalog?ROUTe:PATH:CATalog?The ROUTe:PATH:CATalog? query returns a list of all currently defined .Response is a list of comma-separated strings. Each string contains a . If no elements are currently defined, then response is a null string ("").17.4.2 [:DEFine] ,ROUTe:PATH:DEFineThe ROUTe:PATH:DEFine comm<strong>and</strong> assigns as a user-specified way ofreferring to . This comm<strong>and</strong> allows the user to define a list of relays that canbe opened <strong>and</strong> closed with the use of a .The query form of this comm<strong>and</strong>, “ROUTe:PATH:DEFine? ” returns a blockcontaining the bound to .17.4.3 :DELeteROUTe:PATH:DELete17.4.3.1 [:NAME] ROUTe:PATH:DELete:NAMEThe ROUTe:PATH:DELete[:NAME] comm<strong>and</strong> removes a path name created by a PATHcomm<strong>and</strong>.17.4.3.2 :ALLROUTe:PATH:DELete:ALLThe ROUTe:PATH:DELete:ALL comm<strong>and</strong> deletes all path name bindings, <strong>and</strong> frees allnames created by the PATH comm<strong>and</strong>.17.5 :MODuleROUTe:MODuleThe MODule subsystem controls the assignment of .12345678HP096 91011121314151617181920212223242526ROUTe Subsystem 17-3


1997 SCPI Comm<strong>and</strong> Reference17.5.1 :CATalog?ROUTe:MODule:CATalog?The ROUTe:MODule:CATalog? query returns a list of all currently defined.Response is a list of comma-separated strings. Each string contains a . If no elements are currently defined, then response is a null string ("").HP0961717.5.2 [:DEFine] ,ROUTe:MODule:DEFineName a module as . This comm<strong>and</strong> assigns auser-defined name to a number representing a card address in hardware-dependent form (forexample, a VME address).The query form of this comm<strong>and</strong>, “ROUTe:MODule:DEFine? ” returns an response showing what is bound to .17.5.3 :DELeteROUTe:MODule:DELete17.5.3.1 [:NAME] ROUTe:MODule:DELete:NAMEThe ROUTe:MODule:DELete[:NAME] comm<strong>and</strong> removes a module name created by aMODule comm<strong>and</strong>.17.5.3.2 :ALLROUTe:MODule:DELete:ALLThe ROUTe:MODule:DELete:ALL comm<strong>and</strong> deletes all module name bindings, <strong>and</strong> freesall names created by the MODule comm<strong>and</strong>.17.6 TERMinals FRONt | REAR | BOTH | NONEROUTe:TERMinalsFRONt opens the rear terminals <strong>and</strong> closes the front terminals (break before make). REARopens the front terminals <strong>and</strong> closes the rear terminals (also break before make). BOTHcloses both the front <strong>and</strong> rear terminals in a device-dependent order. NONE opens both thefront <strong>and</strong> rear terminals in a device-dependent order.At *RST, TERM is set to FRONt.KI003HP052KI00317-4 ROUTe Subsystem


1997 SCPI Comm<strong>and</strong> Reference18 SENSe SubsystemThe SENSe setup comm<strong>and</strong>s are divided into several sections. Each section or subsystemdeals with controls that directly affect device-specific settings of the device <strong>and</strong> not thoserelated to the signal-oriented characteristics. These comm<strong>and</strong>s are referenced through theSENSe node.The SENSe node may be optional in a particular device. The reason that the SENSe isoptional is to allow devices which are primarily sensors to accept shorter comm<strong>and</strong>s. TheSENSe node cannot be optional if either SOURce or ROUTe is optional, since only onenode at a given level may be optional. For example, a typical counter may elect to make theSENSe node optional, since the most frequently used comm<strong>and</strong>s would be under the SENSesubsystem. If the counter also contained either source or routing functionality, these wouldbe controlled through their respective nodes; however, the SOURce or ROUTe nodes wouldbe required. An optional node, such as SENSe, implies that the device shall accept <strong>and</strong>process comm<strong>and</strong>s with or without the optional node <strong>and</strong> have the same result. That is, thedevice is required to accept the optional node, if sent, without error.In some instances, a sensor may contain subservient source or sensor functions. In suchcases, the additional subservient functionality shall be placed as SENSe or SOURcesubnodes under the SENSe subsystem. Further, no optional nodes (SENSe, SOURce orROUTe) are permitted if such subservient functionality exists in a device. Otherwiseconflicts in interpreting comm<strong>and</strong>s would occur, for example, between SENSe <strong>and</strong>[SOURce:]SENSe if the SOURce were allowed to be optional.The FREQuency subsystem contains several sets of comm<strong>and</strong>s which have complexcouplings. This includes the swept comm<strong>and</strong>s STARt, STOP, CENTer, <strong>and</strong> SPAN as oneset. Sending any one of a set singly will affect two others of the set. However, if two are sentin a single message unit, then these two should be set to the values specified <strong>and</strong> the othertwo changed. This is in accordance with the style guidelines <strong>and</strong> IEEE 488.2. If anycomm<strong>and</strong> in the set is implemented then all the comm<strong>and</strong>s in the set shall be implemented.If the requested setting is unachievable given the other instrument settings, then an errormust be generated (-221 “Settings conflict”). The device may resolve the conflict in adevice-dependent manner (for example, change STARt, STOP, CENTer, <strong>and</strong>/or SPAN) toresolve the error. Note that when more than one of the four sweep settings are received in thesame program message unit, the sweep will be determined by the last two received.The coupled comm<strong>and</strong>s may define comm<strong>and</strong>s as subnodes which alter these couplings. Thecomm<strong>and</strong> description will define how the couplings are altered. However, any comm<strong>and</strong>which alters couplings must default to the couplings described in this section as the *RSTcouplings.When CENTer or SPAN is changed the following couplings apply:SPAN = SPANCENTer = CENTerSTOP = CENTer + (SPAN/2)STARt = CENTer - (SPAN/2)123456789101112131415161718192021 PH0752223242526SENSe: 18-1


1997 SCPI Comm<strong>and</strong> Reference18When STARt or STOP changed the following couplings apply:STARt = STARt CENTer = (STARt + STOP)/2STOP = STOP SPAN = STOP - STARtThe CURRent, VOLTage <strong>and</strong> POWer subsystems contain several comm<strong>and</strong>s which havecomplex couplings. These comm<strong>and</strong>s exist under RANGe: they are UPPer, LOWer, OFFset,<strong>and</strong> PTPeak. UPPer <strong>and</strong> LOWer are considered as one set, with OFFSet <strong>and</strong> PTPeak asanother set. Sending any one of a set singly shall affect the two values of those comm<strong>and</strong>s inthe other set. However, if two are sent in a single message unit, then these two should be setto the values specified <strong>and</strong> the unspecified two values shall be changed. This is inaccordance with the style guidelines <strong>and</strong> IEEE 488.2. If either OFFSet or PTPeak isimplemented, then all four comm<strong>and</strong>s, UPPer, LOWer, OFFSet, <strong>and</strong> PTPeak shall also beimplemented.When UPPer or LOWer is changed the following couplings apply:UPPer = UPPer OFFSet = (UPPer + LOWer)/2LOWer = LOWer PTPeak = UPPer - LOWerWhen OFFSet or PTPeak is changed the following couplings apply:OFFSet = OFFSet UPPer = OFFSet + (PTPeak/2)PTPeak = PTPeak LOWer = OFFSet - (PTPeak/2)First Level SENSe Keywords[:SENSe]:AM 1991:AVERage 1992 HP054:BANDwidth|:BWIDth:CONDition 1993 PH074:CORRection:CURRent:DETector:FILTer 1991:FM 1991:FREQuency:FUNCtion:LIST:MIXer:PM 1991:POWer:RESistance|:FRESistance:ROSCillator:SSB:SMOothing:SWEep:VOLTage:WINDowRS01118-2 SENSe:


1997 SCPI Comm<strong>and</strong> Reference18.1 AM SubsystemSENSe:AMThe Amplitude Modulation subsystem is used to set up the modulation controls <strong>and</strong>parameters associated with sensing <strong>and</strong> demodulating amplitude modulated signals.KEYWORD PARAMETER FORM NOTES:AM 1991[:DEPTh] 1991:RANGe 1991:AUTO |ONCE 1991[:UPPer] 1991:LOWer 1991:TYPE LINear|LOGarithmic 199418.1.1 [:DEPTh]SENSe:AM:DEPThThis node is used to collect together the depth parameters.18.1.1.1 :RANGeSENSe:AM:DEPTh:RANGeSets the range for the sensor function.18.1.1.1.1 :AUTO | ONCESENSe:AM:DEPTh:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range withoutoverloading. The actual algorithm is device-dependent. Selecting AUTO ONCE will havethe effect of setting AUTO to ON <strong>and</strong> then OFF.At *RST, this value is set to ON.18.1.1.1.2 [:UPPer] SENSe:AM:DEPTh:RANGe:UPPerSpecifies the maximum signal level expected for the sensor input.At *RST, this value is device-dependent.18.1.1.1.3 :LOWer SENSe:AM:DEPTh:RANGe:LOWerSpecifies the smallest signal level expected for the sensor input. This allows setting for thebest dynamic range. This function is coupled to UPPer.At *RST, this value is device-dependent.18.1.2 :TYPE LINear|LOGarithmicSENSe:AM:TYPESENSe:AM:TYPE sets or queries the type of amplitude demodulation technique thedemodulator uses. LINear means the demodulated signal is derived directly from theamplitude of the signal in a linear way. LOGarithmic means the demodulated signal isderived from the amplitude of the signal in a logarithmic way. The amplitude of thedemodulated signal is proportional to the log-value of the amplitude of the signal.RS01112345RS01167891011121314151617181920212223 RS011242526SENSe:AM 18-3


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is set to LINear.1818-4 SENSe:AM


HP0FL0HP0HP01997 SCPI Comm<strong>and</strong> Reference18.2 AVERage SubsystemSENSe:AVERageThe purpose of this subsystem is to control averaging used to improve the measurement. Forexample to improve the accuracy or to acquire maximum/minimum measurements.Analytical post-acquisition statistical functions are controlled within the CALCulate block.The AVERage subsystem combines successive measurements to produce a new composite 1result. The new result has the same number of points <strong>and</strong> control axis as the original 2measurement.3A :COUNt comm<strong>and</strong> is provided to specify the number of measurements to combine. When:COUNT averages are reached, the TerminalCONtrol switch specifies the operation of the 4average subsystem. The TerminalCONtrol switch can be configured to continue replacing 5old values with new values (MOVing), to exponentially weight new measurements(EXPonential), to automatically repeat (REPeat), or to continue adding new measurements in 6the NORMal fashon, as specified by :TYPE.7The average operation differs from CALC:SMOOthing in the fact that AVERage combines 8the jth point of each measurement with the jth point of preceeding measurements, whereas inSMOOthing the jth point is processed with adjacent points (...., j-2, j-1, j, j+1, j+2, ...) of the 9current measurement set.10Note: The notation Xn* indicates the complex conjugate of a number. So:11XX* = MAG 2 (X) = |X| 212 HP081b18.2.1 A typical device action for SENS:AVERage HP01314151617181920212223242526SENSe:AVERage 18-5


HP054HP054HP054HP054HP054HP054HP054HP054Ed Change1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:AVERage 1992:COUNt 1992:AUTO | ONCE 1992[:STATe] 1992:TCONtrol EXPonential | MOVing | NORMal | REPeat 1992:TYPE COMPlex | ENVelope | MAXimum 1992| MINimum | RMS | SCALar 199218.2.2 :COUNt SENSe:AVERage:COUNtSpecifies the number of measurements to combine using the :TYPE setting. After :COUNtmeasurements have been averaged, the operation of the AVERage subsystem is controlledby the setting of the :TCONtrol node.The count for array based results is independent of the number of points in the result array.For example, an instrument which normally provides a measurement result which is a 401point array would specify an average count of two to average two results, not 802.When averaging is ON, some devices may automatically set :COUNt values in the TRIGgersubsystem based on the AVER:COUNt value, such that the TRIGger subsystem providesenough triggers for the average.At *RST, this value is device dependent.1818.2.2.1 :AUTO | ONCESENSe:AVERage:COUNt:AUTOAUTO ON causes the device to select a value for :COUNt which is appropriate for thecurrent measurement. Selecting AUTO ONCE will have the effect of setting AUTO ON <strong>and</strong>then OFF.At *RST, this value is set to OFF.18.2.3 [:STATE] SENSe:AVERage:STATEThe STATe comm<strong>and</strong> is used to turn averaging ON <strong>and</strong> OFF.At *RST, this value is set to OFF.18.2.4 :TCONtrol EXPonential | MOVing | NORMal | REPeatSENSe:AVERage:TCONtrolTerminalCONtrol specifies the action of the AVERage subsystem when more thanAVERage:COUNt measurement results are generated.The parameter has the following meanings:EXPonentialContinue the average with an exponential weighting applied to old values.The additional averages are weighted using:HP081b18-6 SENSe:AVERage


Ed ChanEd ChanHP01997 SCPI Comm<strong>and</strong> ReferenceFor :TYPE SCALar when Xn is real <strong>and</strong> :TYPE COMPlex when Xn is eitherreal or complexAVG n = 1 k X n + k − 1 AVG n − 1kFor :TYPE SCALar when Xn is complexAVG n = 1 k MAG(X n) + k − 1 AVG n − 1kFor :TYPE RMS when Xn is realAVGn = √⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺1k Xn2 + k − 1k AVGn 2− 1For :TYPE RMS when Xn is complexAVGn = √⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺1k XnXn∗ + k − 1k AVGn 2− 1The exponential factor k is equal to the AVERage:COUNt value. Someinstruments may use an approximation to true exponential.Operation with EXPonential :TCON is undefined with a :TYPE setting ofMINimum, MAXimum, or ENVelope.MOVing As new data is added the oldest data is discarded.REPeat Clear average data <strong>and</strong> counter <strong>and</strong> restart the average process.NORMal Additional averages continue to be accumulated according to the :TYPEselection.At *RST, this value is device dependent.18.2.5 :TYPE COMPlex | ENVelope | MAXimum | MINimum | RMS | SCALarSENSe:AVERage:TYPEThis comm<strong>and</strong> selects the type of averaging, as follows:COMPlex The points in the summation are treated as real/imaginary pairs.AVG(n) = 1 nn ∑ X ii = 1ENVelopeIf Xn is realBoth the MIN <strong>and</strong> MAX values are retained.MAXimum AVG(n) = MAX(X1... Xn )MINimum AVG(n) = MIN(X1...Xn)1234567891011121314151617181920212223HP081b242526SENSe:AVERage 18-7


HP0541997 SCPI Comm<strong>and</strong> ReferencenRMS AVG(n) =√⎺⎺⎺ 1n ∑i = 1SCALarIf Xn is complexXi 2The scalar magnitude of each point is averaged.AVG(n) = 1 nn ∑ Xii = 1MAXimum AVG(n) = MAX( MAG(X1)... MAG(Xn) )MINimum AVG(n) = MIN( MAG(X1)...MAG(Xn) )nRMS AVG(n) =√⎺⎺⎺⎺ 1n ∑i = 1SCALarXiXi ∗The scalar magnitude of each point is averaged.AVG(n) = 1 nn ∑ | Xi |i = 1At *RST, this value is device dependent.HP081b1818-8 SENSe:AVERage


1997 SCPI Comm<strong>and</strong> Reference18.3 BANDwidth|BWIDth SubsystemSENSe:BANDwidthThis subsystem controls the characteristics of the filter b<strong>and</strong>width of the instrument.Instruments must accept both forms, if they accept either.KEYWORD PARAMETER FORM NOTES:BANDwidth|:BWIDth[:RESolution] :AUTO |ONCE:RATio :TRACk :VIDeo:AUTO |ONCE:RATio 18.3.1 [:RESolution] SENSe:BANDwidth:RESolutionControls the resolution b<strong>and</strong>width of the instrument. Resolution B<strong>and</strong>width is defined as theb<strong>and</strong>with in Hz of the predetection b<strong>and</strong>pass filtering. This comm<strong>and</strong> has units of Hz.At *RST, the value of this function is device-dependent.18.3.1.1 :AUTO |ONCESENSe:BANDwidth:RESolution:AUTOWhen enabled, the value of resolution b<strong>and</strong>width is coupled to other parameters of themeasurement. The exact coupling equation is machine-dependent.At *RST, this function is set to ON.18.3.1.2 :RATio SENSe:BANDwidth:RESolution:RATioControls the ratio of resolution b<strong>and</strong>width to span when the two are coupled. Coupled isenabled when AUTO is ON. The is RESolution(Hz)/SPAN(Hz).At *RST, the value of this function is instrument-dependent.18.3.1.3 :TRACk SENSe:BANDwidth:RESolution:TRACkThis function allows the resolution b<strong>and</strong>width to dynamically change during a logarithmicfrequency sweep. Logarithmic sweep is enabled via the SENSe:SWEep:SPACing comm<strong>and</strong>.At *RST, the value of this function is ON.18.3.2 :VIDeo SENSe:BANDwidth:VIDeoControls the video filtering, a particular type of post-detection filtering. This has units ofHertz.At *RST, the value of this function is instrument-dependent.1234567891011121314151617181920212223242526SENSe:BANDwidth|BWIDth 18-9


1997 SCPI Comm<strong>and</strong> Reference18.3.2.1 :AUTO |ONCESENSe:BANDwidth:VIDeo:AUTOCouples the value of video b<strong>and</strong>width to instrument-determined values.At *RST, the value of this setting is ON.18.3.2.2 :RATio SENSe:BANDwidth:VIDeo:RATioControls the ratio of video b<strong>and</strong>width to resolution b<strong>and</strong>width when the two are coupled.Coupled is enabled when AUTO is ON. The isVIDeo(Hz)/RESolution(Hz).At *RST, the value of this function is instrument-dependent.1818-10 SENSe:BANDwidth|BWIDth


18.4 CONDition SubsystemSENSe:CONDition1997 SCPI Comm<strong>and</strong> ReferenceThis subsystem controls the electrical characteristics of a sensor that determines the ON orOFF condition of a digital signal.KEYWORD PARAMETER FORM COMMENTS1:CONDition 1993 PH074LEVel | TTL | ECL 1993 PH074 218.4.1 :LEVel | TTL ECLSENSe:CONDition:LEVel3This comm<strong>and</strong> specifies the characteristics that causes the transition between an ON <strong>and</strong>OFF condition of the sensed signal. When the value of the input signal exceeds the specifiedlevel, the condition is qualified as ON or 1 (True) for positive logic type, <strong>and</strong> qualified asOFF or 0 (False) when it is associated with negative types of logic. For positive logic, thecondition is sensed as OFF or 0 (False) when the input value is below the level; for negativelogic this value is qualified as an ON or 1 (True) condition.The default units are the amplitude units associated with the currently sensed signal.At *RST this value is device dependent.4567891011121314151617181920212223242526SENSe:CONDition 18-11


18.5 CORRection SubsystemSENSe:CORRection1997 SCPI Comm<strong>and</strong> ReferenceThe correction subsystem provides for known external losses or gains. In contrast toCALibration, these losses usually are dependent on individual measurement setups.Correction data may be entered <strong>and</strong> stored in several ways. A mechanism is provided toautomatically measure a reference st<strong>and</strong>ard(s) <strong>and</strong> store the resulting “correction set” in atrace. The trace can be selected at any time as the active “correction set”. This trace couldalso be generated by an external device <strong>and</strong> transferred to the instrument over a computerinterface. Comm<strong>and</strong>s are also provided to enter individual losses, gains, offsets, delays, etc.that the instrument should use in correcting the data. An instrument is not required toimplement all of the methods.The comm<strong>and</strong>s in this subsystem are designed to correct for losses, gains, <strong>and</strong> offsets inexternal probes or transducers. For instance, they can be used to inform the sensor that a 10Xprobe has been attached to the instrument. This way, the data <strong>and</strong> measurement results willbe corrected so that they are not 1/10th their actual value. In instruments that automaticallydetect the attachment of a probe, these comm<strong>and</strong>s may not be necessary.KEYWORD PARAMETER FORM COMMENTS:CORRection:COLLect[:ACQuire ] STANdard:METHod TPORt:SAVE:CSET18[:SELect] 1992 HP058A:STATe :EDELay:DISTance :STATe [:TIME] :IMPedance 1993 HP084[:INPut]|:OUTPut 1993 HP084[:MAGNitude] 1993 HP084:STATe 1993 HP084:LOSS|:GAIN|:SLOPe[:INPut]|:OUTPut 1992:AUTO[:MAGNitude]:PHASe:STATe:OFFSet[:MAGNitude]:PHASe:STATeON|OFF18-12 SENSe:CORRection


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM COMMENTS:RVELocity:COAX :MEDium COAX|WAVeguide:STATe :WAVeguide :FCUToff [:STATe] 18.5.1 :COLLectSENSe:CORRection:COLLectDeals with the collection of the correction data. This data is collected directly by the deviceby measurements of st<strong>and</strong>ards.18.5.1.1 [:ACQuire] STANdardSENSe:CORRection:COLLect:ACQuireA measurement will be performed <strong>and</strong> saved as the data for st<strong>and</strong>ard of the chosencorrection method. The number of st<strong>and</strong>ards required to be measured for the correction isdetermined by the method chosen. If a st<strong>and</strong>ard is specified that does not exist in the chosenmethod, then an error is generated <strong>and</strong> no measurement is taken. This measurement will notaffect any of the users settings for regular measurements.For complex corrections, several st<strong>and</strong>ards will be measured <strong>and</strong> then followed by a SAVEcomm<strong>and</strong>. The parameter on the save comm<strong>and</strong> will be the name of the correction set.Thest<strong>and</strong>ards themselves are device-specific.This comm<strong>and</strong> is an event, does not have a *RST value, <strong>and</strong> is not queryable.18.5.1.2 :METHod TPORtSENSe:CORRection:COLLect:METHodSelects the correction method to be used for the correction that is about to be performed. Ifonly one correction method exists in the instrument then this comm<strong>and</strong> is not required.The various settings of the parameters have the following meanings:TPORt Two PortAt *RST, this value is device-dependent.18.5.1.3 :SAVE []SENSe:CORRection:COLLect:SAVECalculates the correction data using the current method selection <strong>and</strong> then saves thecorrection data. If only one correction array exists then it is saved there. Otherwise it is savedin the set specified by . Note that the parameter must be defined<strong>and</strong> exist in the instrument. This comm<strong>and</strong> will not create a trace. Trace definition is done inthe trace subsystem. Note that the correction array may be a single value.Depending on the complexity of the correction method chosen, a calculation may or may notbe performed on the measured arrays to determine the correction data. For example, if thechosen method has only one st<strong>and</strong>ard, then no calculation will be performed.1234567891011121314151617181920212223242526SENSe:CORRection 18-13


HP058AHP058AHP058AHP058A1997 SCPI Comm<strong>and</strong> ReferenceThis comm<strong>and</strong> is an event, does not have a *RST value, <strong>and</strong> is not queryable.18.5.2 :CSETSENSe:CORRection:CSETThe Correction SET subsystem is used to select the active correction set.18.5.2.1 [:SELect] SENSe:CORRection:CSET:SELectSpecifies the active CORRection set. This is the set that is used when CORR:CSET:STATeON is specified. may be either a , or a which must bedefined <strong>and</strong> exist in the instrument. This comm<strong>and</strong> will not create either , or a. Trace definition is done in the TRACe subsystem. Table definition is done inthe MEMory subsystem.If specifies a MEMory:TABLe the various lists must have an equal number ofpoints, or execution error -226 (Lists not same length) will be generated.Those lists in a TABLe which are defined in the CORRection subsystem will be appliedwhen CORRection:STATe is ON. Other items in a TABLe will be ignored withoutgenerating an error. This allows the same TABLe to be shared with other subsystems.At *RST this value is device dependent.18.5.2.2 :STATe SENSe:CORRection:CSET:STATeDetermines whether the correction data defined in the selected set is applied to themeasurement.At *RST, this function is OFF. Off is chosen because all of the correction sets may beempty. The instrument must collect data before correction can be applied.1818.5.3 :EDELaySENSe:CORRection:EDELayThe Electrical DELay is used to compensate for delays in the signal path.This comm<strong>and</strong> is used to correct external factors that the instrument cannot measure ordetect.TIME <strong>and</strong> DISTance are coupled by the equation:TIME= RVELocity*DISTanceRVELocity is not coupled to either TIME or DISTance.18.5.3.1 :DISTance SENSe:CORRection:EDELay:DISTanceThis comm<strong>and</strong> will set the electrical delay with the distance parameter given. The effectivedelay will be computed using this parameter <strong>and</strong> the relative velocity set in the instrument.The units for this comm<strong>and</strong> are meters. A value accepted here will modify the time settingbecause they are the same parameter in different forms. Implementation of this comm<strong>and</strong>requires implementation of CORRection:EDELay[:TIME].18-14 SENSe:CORRection


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, the value of this setting is zero.18.5.3.2 :STATe SENSe:CORRection:EDELay:STATeThis function is used to enable or disable the electrical delay correction.At *RST, this function is set to OFF.18.5.3.3 [:TIME] SENSe:CORRection:EDELay:TIMEThis comm<strong>and</strong> will set the electrical delay with the time parameter given. The units for thiscomm<strong>and</strong> are seconds. A value accepted here will modify the distance setting because theyare the same parameter in different forms.At *RST, the value of this setting is zero.18.5.4 :IMPedanceSENSe:CORRection:IMPedanceThis is the termination impedance provided external to the device.18.5.4.1 [:INPut]|:OUTPutSENSe:CORRection:IMPedance:INPutThe INPut <strong>and</strong> OUTPut nodes are used to reference measurements made at the instrument’sinput <strong>and</strong> output, respectively. Most sensor instruments are only capable of makingmeasurements at its input ports; however, some instruments are capable of makingmeasurements on output ports that are sourcing a signal.18.5.4.1.1 [:MAGNitude] SENSe:CORRection:IMPedance:INPut:MAGNitudeSets the magnitude of the impedance. The default units are OhmsAt *RST, this value is device-dependant.18.5.4.2 :STATe SENSe:CORRection:IMPedance:STATeThe STATe comm<strong>and</strong> is used to enable or disable external IMPedance correction factors.At *RST, this function is set to OFF.18.5.5 :LOSS|:GAIN|:SLOPeSENSe:CORRection:LOSSThese comm<strong>and</strong>s are used either to provide a mechanism to apply simple correction or tocorrect external factors that have not been accounted for in the correction set. Thesecorrection factors are typically applied to measurements made at the device input; however,in cases where measurements can be at the device output a separate set of correction factorsmay be applied.Loss, gain <strong>and</strong> slope effect the measurement values as a multiplier for linear units such asVOLT <strong>and</strong> as additive (or subtractive) value for logarithmic units such as DB.12345678HP084910HP08411121314HP08415161718 HP0841920212223242526SENSe:CORRection 18-15


HP0751997 SCPI Comm<strong>and</strong> Reference:LOSS:GAIN:SLOPeThis comm<strong>and</strong> is used to set the anticipated loss in the system, excluding thosefactors covered by the active correction set. The device then corrects everymeasurement by this factor to compensate for the loss. LOSS is coupled to GAINby the equation LOSS = 1/GAIN when the default unit is linear <strong>and</strong>LOSS=-GAIN when the default unit is logarithmic.This comm<strong>and</strong> is used to set the anticipated gain in the system, excluding thosefactors covered by the active correction set. The device then corrects everymeasurement by this factor to compensate for the gain. GAIN Is coupled to LOSSby the equation GAIN=1/LOSS when the default unit is linear <strong>and</strong> GAIN=-LOSSwhen the default unit is logarithmic.This node defines an increasing or decreasing value that is added to the signal.This correction value is zero at a zero value of the x axis <strong>and</strong> increase ordecreases from there.1818.5.5.1 [:INPut]|:OUTPutSENSe:CORRection:LOSS:INPutThe INPut <strong>and</strong> OUTPut nodes are used to reference measurements made at the instrument’sinput <strong>and</strong> output, respectively. Most sensor instruments are only capable of makingmeasurements at its input ports; however, some instruments are capable of makingmeasurements on output ports that are sourcing a signal.18.5.5.1.1 :AUTO ON|OFFSENSe:CORRection:LOSS:INPut:AUTOWhen AUTO is ON the OUTPut correction values must track those of the INPut.At *RST, AUTO is set to ON.18.5.5.1.2 [:MAGNitude] SENSe:CORRection:LOSS:INPut:MAGNitudeThis is the magnitude value of the correction data for LOSS, GAIN or SLOPe. The unitsassociated with LOSS <strong>and</strong> GAIN are the current relative amplitude unit. The unit associatedwith SLOPe is:/HzAfter a *RST, this value should no longer affect the data being measured. Thus its value isset to zero at *RST.18.5.5.1.3 :PHASe SENSe:CORRection:LOSS:INPut:PHASeThis is the phase value of the correction data for LOSS, GAIN or SLOPe. The unitassociated with SLOPe is current angle units/Hertz. The units associated with LOSS <strong>and</strong>GAIN are current angle units.After a *RST, this value should no longer affect the data being measured. Thus its value isset to zero at *RST.18-16 SENSe:CORRection


1997 SCPI Comm<strong>and</strong> Reference18.5.5.2 :STATe SENSe:CORRection:LOSS:STATeThe STATe comm<strong>and</strong> is used to enable or disable the LOSS, GAIN or SLOPe correctionfactors.At *RST, this function is set to OFF.18.5.6 :OFFSetSENSe:CORRection:OFFSetThis node defines a single value that is added to every point measured by the instrument. Ifthe instrument is a trace-based machine, then this value is added to every point in the trace.If the instrument measures a single value then that value is modified by this setting. Thiscomm<strong>and</strong> shall be used with the currently selected units. It is used to correct external factorsthat the instrument cannot measure or detect.18.5.6.1 [:MAGNitude] SENSe:CORRection:OFFSet:MAGNitudeThis is the magnitude value of the correction offset data.After a *RST, this value should no longer affect the data being measured. Its value is set tozero at *RST.18.5.6.2 :PHASe SENSe:CORRection:OFFSet:PHASeThis is the phase value of the correction offset data. The units associated with this are thecurrently selected angle units.18.5.6.3 :STATe SENSe:CORRection:OFFSet:STATeThis function is used to enable or disable the offset correction.At *RST, this function is set to OFF.After a *RST, this value should no longer affect the data being measured. Its value is set tozero at *RST .18.5.7 :RVELocitySENSe:CORRection:RVELocityThis comm<strong>and</strong> corrects for the relative velocity of the medium of the Device Under Test.This factor will be used in any delay calculation performed in the instrument.This comm<strong>and</strong> is used to correct external factors that the instrument cannot measure ordetect.TIME <strong>and</strong> DISTance are coupled by the equation:TIME= RVELocity*DISTanceRVELocity is not coupled to either TIME or DISTance.1234567891011121314151617181920212223242526SENSe:CORRection 18-17


1997 SCPI Comm<strong>and</strong> Reference1818.5.7.1 :COAX SENSe:CORRection:RVELocity:COAXThis comm<strong>and</strong> sets the relative velocity factor for coaxial lines. The parameter is unitless.At *RST, the value of this setting is one.18.5.7.2 :MEDium COAX|WAVeguideSENSe:CORRection:RVELocity:MEDiumThis comm<strong>and</strong> selects the correction algorithm for the media through which the detectedsignal is transmitted. It will determine the method of calculation for any operation that usesrelative velocity. For example, for COAX a linear phase shift would be computed if a delaywas added, but for WAVeguide (a dispersive medium) a different phase shift is calculated.At *RST, this value is device-dependent.18.5.7.3 :STATe SENSe:CORRection:RVELocity:STATeThis function is used to enable or disable the relative velocity correction.At *RST, this function is set to OFF.18.5.7.4 :WAVeguide SENSe:CORRection:RVELocity:WAVeguideThis comm<strong>and</strong> sets the relative velocity factor for waveguide. The parameter is unitless.At *RST, the value of this setting is one.18.5.7.4.1 :FCUToff SENSe:CORRection:RVELocity:WAVeguide:FCUToffThis comm<strong>and</strong> specifies the frequency cutoff of the waveguide medium. The units are Hertz.At *RST, this value is device-dependent.18.5.8 [:STATe] SENSe:CORRection:STATeDetermines whether the correction data defined in this section is applied to the measurement.At *RST, this function is OFF.18-18 SENSe:CORRection


1997 SCPI Comm<strong>and</strong> Reference18.6 CURRent SubsystemSENSe:CURRentThis subsection controls the current amplitude characteristics of the sensor.KEYWORD PARAMETER FORM NOTES:CURRent:AC|[:DC]:APERture :NPLCycles 1991:ATTenuation :AUTO :PROTection[:LEVel] :STATe:TRIPped?[query only]:CLEar[no query]:RANGe[:UPPer] :LOWer :AUTO |ONCE:DIRection UP|DOWN|EITHer:LLIMit 1996:ULIMit 1996:OFFSet 1991:PTPeak 1991:REFerence :STATe :RESolution :AUTO |ONCE:DETector INTernal | EXTernal 199118.6.1 :AC|[:DC]SENSe:CURRent:ACThis subsystem selects the alternating current or the direct current sensor. The default unitsare amperes.18.6.1.1 :APERture SENSe:CURRent:AC:APERtureSpecifies the acquisition/sampling/gate time for a single measurement point. The parameterhas a unit of seconds.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SENSe:CURRent 18-19


1997 SCPI Comm<strong>and</strong> Reference1818.6.1.2 :NPLCycles SENSe:CURRent:AC:NPLCyclesSpecifies the acquisition/sampling/gate time for a single measurement point in terms of thenumber of power line cycles. The parameter is unitless. If this comm<strong>and</strong> is implemented, theAPERture comm<strong>and</strong> must also be implemented.The value is coupled to APERture by the equation:APERture = NPLCycles/selected line frequencyAt *RST, this value is device-dependent.18.6.1.3 :ATTenuation SENSe:CURRent:AC:ATTenuationSets the ATTenuation level. Note that when setting the level to 10 dB the magnitude of theincoming signal will be decreased by 10 dB. Changing the ATTenuation changes RANGe bythe same amount.Default units are as determined in the UNITS system.18.6.1.3.1 :AUTO SENSe:CURRent:AC:ATTenuation:AUTOCouples the attenuator to RANGe such that maximum dynamic range of the incoming signalis assured without overloading.Programming a specified attenuation sets AUTO OFF.At *RST, AUTO is set to ON.18.6.1.4 :PROTectionSENSe:CURRent:AC:PROTectionControls the protection circuits.18.6.1.4.1 [:LEVel] SENSe:CURRent:AC:PROTection:LEVelThis comm<strong>and</strong> sets the input level at which the input protection circuit will trip.18.6.1.4.2 :STATe SENSe:CURRent:AC:PROTection:STATeControls whether the input protection circuit is enabled.At *RST, this value is set to ON.18.6.1.4.3 :TRIPped?SENSe:CURRent:AC:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped. TRIPpedonly has a query form <strong>and</strong> thus has no associated *RST condition.18.6.1.4.4 :CLEarSENSe:CURRent:AC:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.18-20 SENSe:CURRent


1997 SCPI Comm<strong>and</strong> Reference18.6.1.5 :RANGeSENSe:CURRent:AC:RANGeSets the range for the amplitude sensor function. The RANGe endpoints may be specified interms of the UPPer endpoint <strong>and</strong> the LOWer endpoint, alternatively the midpoint of theRANGe (OFFSet) <strong>and</strong> the span of the RANGe (PTPeak) may be used. A non-symmetricalrange around zero may cause some instruments to introduce an actual offset to the signalentering the SENSe block.18.6.1.5.1 [:UPPer] SENSe:CURRent:AC:RANGe:UPPerSpecifies the most positive signal level expected for the sensor input.At *RST, this value is device-dependent.18.6.1.5.2 :LOWer SENSe:CURRent:AC:RANGe:LOWerSpecifies the most negative signal level expected for the sensor input. This allows setting forthe best dynamic range. This function is coupled to UPPer in a device-dependent manner.At *RST, this value is device-dependent.18.6.1.5.3 :AUTO |ONCESENSe:CURRent:AC:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range withoutoverloading. The actual algorithm is device-dependent.At *RST, AUTO is set to ON.18.6.1.5.3.1 :DIRection UP|DOWN|EITHerSENSe:CURRent:AC:RANGe:AUTO:DIRectionThe DIRection comm<strong>and</strong> defines the manner in which AUTO works. When UP is selected,the instrument shall only change the range automatically to ranges larger than the currentrange, as the input signal dictates. When DOWN is selected, the instrument shall onlychange the range automatically to ranges smaller than the current range, as the input signaldictates. When EITHer is selected the instrument may range in either direction.At *RST, DIRection shall be set to EITHer.18.6.1.5.3.2 :LLIMit SENSe:CURRent:AC:RANGe:AUTO:LLIMitThe Lower LIMit comm<strong>and</strong> sets the smallest range to which the instrument will go whileautoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, LLIMit shall be set to MINimum.18.6.1.5.3.3 :ULIMit SENSe:CURRent:AC:RANGe:AUTO:ULIMitThe Upper LIMit comm<strong>and</strong> sets the largest range to which the instrument will go while1234567891011121314151617181920212223242526SENSe:CURRent 18-21


1997 SCPI Comm<strong>and</strong> Reference18autoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, ULIMit shall be set to MAXimum.18.6.1.5.4 :OFFSet SENSe:CURRent:AC:RANGe:OFFSetOFFSet determines the midpoint of the range.At *RST, this value is device-dependent.18.6.1.5.5 :PTPeak SENSe:CURRent:AC:RANGe:PTPeakPeak To Peak specifies the dynamic range required for the sensor.At *RST, this value is device-dependent.18.6.1.6 :REFerence SENSe:CURRent:AC:REFerenceSets a reference amplitude for sensor instruments. This comm<strong>and</strong> differs in intent from thereference correction in that this is intended to be a measurement offset where a user wishesto reference a measurement to some known value.At *RST, this value is device-dependent, but STATe is set to OFF.18.6.1.6.1 :STATe SENSe:CURRent:AC:REFerence:STATeDetermines whether amplitude is measured in absolute or relative mode. If STATe is ON,then amplitude is referenced to the value set in REFerence.At *RST, this value is set to OFF.18.6.1.7 :RESolution SENSe:CURRent:AC:RESolutionSpecifies the absolute resolution of the measurement. For example, if a measurement of 10Volts is specified with a resolution of .01 Volts, the measurement is returned with aresolution of .01 Volts (that is, 10.00).RANGe is not coupled to RESolution. Setting RANGe shall not cause RESolution tochange. Setting RESolution shall not cause RANGe to change.At *RST, this value is device-dependent.18.6.1.7.1 :AUTO |ONCESENSe:CURRent:AC:RESolution:AUTOAllows the system to determine the best resolution for the other measurement conditions.Explicitly setting a value for :RESolution will turn AUTO OFF.At *RST, this value is set to ON.18-22 SENSe:CURRent


1997 SCPI Comm<strong>and</strong> Reference18.6.2 :DETector INTernal | EXTernalSENSe:CURRent:DETectorThe DETector can be specified as internal or external.At *RST, this value is set to INT.1234567891011121314151617181920212223242526SENSe:CURRent 18-23


1997 SCPI Comm<strong>and</strong> Reference1818.7 DETector SubsystemSENSe:DETectorThis subsystem controls the acquisition of data points, including how to choose points <strong>and</strong>the linear characteristics of the sensor.KEYWORD PARAMETER FORM NOTES:DETector:BANDwidth 1991|:BWIDth 1991[:FUNCtion] GROund|NEGative|POSitive|SAMPle|SIGNal|PAVerage | AAVerage|RMS 1991:AUTO |ONCE:SHAPeLINear|LOGarithmic18.7.1 :BANDwidth | BWIDthSENSe:DETector:BANDwidthThe BANDwidth function controls the b<strong>and</strong>width after an intermediate signal has beenprocessed within the SENSe block. Instruments must accept both forms, if they accept either.18.7.2 [:FUNCtion] SENSe:DETector:FUNCtionSpecifies the detector sampling characteristics. The various settings have the followingmeanings:GROund: The input detector is grounded. Thus no signal is acquired.NEGative: The minimum signal detected during the acquisition of the particularpoint is chosen.POSitive: The maximum signal detected during the acquisition of the particularpoint is chosen.SAMPle: A single arbitrary point detected is chosen.SIGNal: The detector chooses points so that envelope noise is maximized <strong>and</strong>positive signals above some threshold are also maximized.PAVerage: PeakAVerage is the average of the minimum <strong>and</strong> maximumexcursions of the signal. PAV = ( absolute minimum peak + absolute maximumpeak) / 2AAVerage: AbsoluteAVerage averages the absolute values of a sine wave input<strong>and</strong> processes the value to read RMS values.RMS: True Root Mean Square signal detector.At *RST, this value is device-dependent.18-24 SENSe:DETector


1997 SCPI Comm<strong>and</strong> Reference18.7.2.1 :AUTO |ONCESENSe:DETector:FUNCtion:AUTOCouples the detector function to several settings within the instrument. When AUTO ON isselected, the detector type is determined by the system in order to give the “best” quality ofdata.Explicitly selecting a detector will set AUTO OFF.At *RST, this parameter is set to ON.18.7.3 :SHAPe LINear|LOGarithmicSENSe:DETector:SHAPeControls the linearity of the detector. This setting is coupled to DETector:FUNCtion in adevice-dependent manner.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SENSe:DETector 18-25


1997 SCPI Comm<strong>and</strong> Reference18.8 FILTer SubsystemSENSe:FILTerThe FILTer function allows a filter to be inserted after an intermediate signal has beenprocessed within the SENSe block. This FILTer subsystem is not interchangeable with theINPut:FILTer subsystem.KEYWORD PARAMETER FORM NOTES:FILTer 1991[:LPASs] 1991[:STATe] 1991:FREQuency 1991:HPASs 1991[:STATe] 1991:FREQuency 1991:DEMPhasis 1991[:STATe] 1991:TCONstant 1991:CCITt 1991[:STATe] 1991:CMESsage 1991[:STATe] 1991:CCIR 1991[:STATe] 1991:CARM 1991[:STATe] 1991:AWEighting 1991[:STATe] 19911818.8.1 [:LPASs]SENSe:FILTer:LPASsControls the sensor low pass filter.18.8.1.1 [:STATe] SENSe:FILTer:LPASs:STATeTurns the low pass filter on <strong>and</strong> off.At *RST, this value is device-dependent.18.8.1.2 :FREQuency SENSe:FILTer:LPASs:FREQuencyDetermines the cutoff frequency of the low pass filter.At *RST, this value is device-dependent.18.8.2 :HPASsSENSe:FILTer:HPASsControls the sensor high pass filter.18-26 SENSe:FILTer


1997 SCPI Comm<strong>and</strong> Reference18.8.2.1 [:STATe] SENSe:FILTer:HPASs:STATeTurns the high pass filter on <strong>and</strong> off.At *RST, this value is device-dependent.18.8.2.2 :FREQuency SENSe:FILTer:HPASs:FREQuencyDetermines the cutoff frequency of the high pass filter.At *RST, this value is device-dependent.18.8.3 :DEMPhasisSENSe:FILTer:DEMPhasisControls the sensor FM De-EMPhasis filter. De-emphasis filters compensate forpre-emphasis on FM signals.18.8.3.1 [:STATe] SENSe:FILTer:DEMPhasis:STATeTurns the FM de-emphasis filter on <strong>and</strong> off.At *RST, this value is device-dependent.18.8.3.2 :TCONstant SENSe:FILTer:DEMPhasis:TCONstantDetermines the Time CONstant of the FM de-emphasis filter. The default units are inseconds.At *RST, this value is device-dependent.18.8.4 :CCITtSENSe:FILTer:CCITtControls the CCITT sensor filter. This st<strong>and</strong>ard filter is described in “CCITTRecommendation P53". It is a voice b<strong>and</strong>width filter used in radio or telephone applications.18.8.4.1 [:STATe] SENSe:FILTer:CCITt:STATeTurns the CCITT filter on <strong>and</strong> off.At *RST, this value is device-dependent.18.8.5 :CMESsageSENSe:FILTer:CMESsageControls the C-Message sensor filter. This Bell Telephone st<strong>and</strong>ard filter is described in “PerBTSM 41004". It is a voice b<strong>and</strong>width filter used in radio or telephone applications.18.8.5.1 [:STATe] SENSe:FILTer:CMESsage:STATeTurns the C-Message filter on <strong>and</strong> off.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SENSe:FILTer 18-27


1997 SCPI Comm<strong>and</strong> Reference18.8.6 :CCIRSENSe:FILTer:CCIRControls the CCIR weighting sensor filter. This st<strong>and</strong>ard filter is described in “CCIRRecommendation 468-2”. It is a music b<strong>and</strong>width filter used in applications such asbroadcasting <strong>and</strong> FM receivers.18.8.6.1 [:STATe] SENSe:FILTer:CCIR:STATeTurns the CCIR weighting filter on <strong>and</strong> off.At *RST, this value is device-dependent.18.8.7 :CARMSENSe:FILTer:CARMControls the CCIR/ARM weighting sensor filter. This is a st<strong>and</strong>ard music b<strong>and</strong>width filterdescribed in “CCIR Recommendation 468-2” <strong>and</strong> “Dolby Labs Bulletin No. 19/4”.18.8.7.1 [:STATe] SENSe:FILTer:CARM:STATeTurns the CCIR/ARM weighting filter on <strong>and</strong> off.At *RST, this value is device-dependent.18.8.8 :AWEightingSENSe:FILTer:AWEightingControls the “A” weighting sensor filter. This is a human hearing compensation filterdescribed in “IEC Recommendation 179” <strong>and</strong> “ANSI S1.4”.18.8.8.1 [:STATe] SENSe:FILTer:AWEighting:STATeTurns the “A” weighting filter on <strong>and</strong> off.At *RST, this value is device-dependent.1818-28 SENSe:FILTer


1997 SCPI Comm<strong>and</strong> Reference18.9 FM SubsystemSENSe:FMThe Frequency Modulation subsystem is used to set up the modulation controls <strong>and</strong>parameters associated with sensing <strong>and</strong> demodulating frequency modulated signals.KEYWORD PARAMETER FORM NOTES:FM 1991[:DEViation] 1991:RANGE 1991:AUTO |ONCE 1991[:UPPer] 1991:LOWer 199118.9.1 [:DEViation]SENSe:FM:DEViationThis node is used to collect together the deviation parameters.18.9.1.1 :RANGeSENSe:FM:DEViation:RANGeSets the range for the sensor function.18.9.1.1.1 :AUTO | ONCESENSe:FM:DEViation:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range withoutoverloading. The actual algorithm is device-dependent. Selecting AUTO ONCE will havethe effect of setting AUTO to ON <strong>and</strong> then OFF.At *RST, this value is set to ON.18.9.1.1.2 [:UPPer] SENSe:FM:DEViation:RANGe:UPPerSpecifies the maximum signal level expected for the sensor input.At *RST, this value is device-dependent.18.9.1.1.3 :LOWer SENSe:FM:DEViation:RANGe:LOWerSpecifies the smallest signal level expected for the sensor input. This allows setting for thebest dynamic range. This function is coupled to UPPer.At *RST, this value is device-dependent.RS0111234567891011121314151617181920212223242526SENSe:FM 18-29


1997 SCPI Comm<strong>and</strong> Reference1818.10 FREQuency SubsystemSENSe:FREQuencyThe FREQuency subsystem controls the frequency characteristics of the instrument. Twotypes of controls are included in this subsystem. The first is frequency sensor controls, suchas RANGe. The second is frequency sweep controls, such as STARt, or tuning controls suchas CW.Unless otherwise noted, the default unit for all in this subsystem are in Hz.KEYWORD PARAMETER FORM NOTES:FREQuency :APERture :CENTer [:CW|:FIXed] :AFC |ONCE 1994:AUTO |ONCE:MANual :MODECW|FIXed|SWEep|LIST|SOURce:MULTiplier :OFFSet:RANGe[:UPPer] :LOWer :AUTO |ONCE:RESolution :AUTO |ONCE:SPAN:HOLD :LINKCENTer|STARt|STOP:FULL[no query]:STARt:STOP18.10.1 :APERture SENSe:FREQuency:APERtureSpecifies the acquisition/sampling/gate time for a single measurement point. The parameterhas a unit of seconds.At *RST, this value is device-dependent.18.10.2 :CENTer SENSe:FREQuency:CENTerSet the center frequency of the sweep or measurement.At *RST, this function will be set to (MINimum+MAX)/2.RS01218-30 SENSe:FREQuency


1997 SCPI Comm<strong>and</strong> Reference18.10.3 [:CW|:FIXed] SENSe:FREQuency:CWThe Continuous Wave or FIXed node is used to select a frequency of a non-swept signal.This node is optional. An optional node, such as [:CW|:FIXed], implies that the device shallaccept <strong>and</strong> process comm<strong>and</strong>s with or without the optional node <strong>and</strong> have the same result.That is, the device is required to accept the optional node, if sent, without error. A devicemust accept both :CW <strong>and</strong> :FIXed if it implements this node.At *RST, this value is device-dependent.18.10.3.1 :AFC |ONCESENSe:FREQuency:CW:AFCIf AFC is ON the sensor is coupled to the frequency of the signal. The default frequency isdetermined by SENSe:FREQuency[:CW].The actual value of FREQuency[:CW] is adjusted to match the frequency of the signal. Thequery FREQuency[:CW]? returns the adjusted value, not the value sent with the lastFREQuency[:CW] comm<strong>and</strong>.At *RST, this value is set to OFF.18.10.3.2 :AUTO |ONCESENSe:FREQuency:CW:AUTOCouples the CW frequency to center frequency. Explicitly setting FREQuency:CW will setAUTO OFF.At *RST, this value is set to ON.18.10.4 :MANual SENSe:FREQuency:MANualSame as CW except limited by STARt <strong>and</strong> STOP. This comm<strong>and</strong> only affects the frequencyif SENSe:SWEep:MODE MANual <strong>and</strong> SENSe:FREQuency:MODE SWEep are selected. Ifthe sweep limits are changed such that manual frequency would be outside the sweep limits,then the manual frequency will be set to the nearest end point of the sweep.At *RST, this value is device-dependent.18.10.5 :MODE CW|FIXed|SWEep|LIST|SOURceSENSe:FREQuency:MODEDetermines which set of comm<strong>and</strong>s control the frequency. If CW or FIXed is selected, thefrequency is determined by FREQuency:CW. CW <strong>and</strong> FIXed are aliases. Both must beimplemented if either is implemented. If SWEep is selected, the sensor is in the swept mode<strong>and</strong> frequency is determined by FREQuency:STARt, STOP, CENT, SPAN, <strong>and</strong> MAN. IfLIST is selected, the frequencies are determined by LIST:FREQuency.If SOURce is selected, the sensor is coupled to the source. All frequency controls aredetermined by the SOURCe:FREQuency block, except for OFFSet <strong>and</strong> MULTiplier. Thesetwo comm<strong>and</strong>s remain active under SENSe to allow for offset <strong>and</strong> harmonic tracking.At *RST, this value is set to CW.123RS012 4567891011121314151617181920212223242526SENSe:FREQuency 18-31


1997 SCPI Comm<strong>and</strong> Reference1818.10.6 :MULTiplier SENSe:FREQuency:MULTiplierSets a reference multiplier for all other frequency settings in the instrument. All entered <strong>and</strong>displayed frequencies are affected by this comm<strong>and</strong>. The coupling equation is:Entered|Displayed frequency = (Hardware frequency * multiplier) + offset.This comm<strong>and</strong> affects the values of all functions which affect sensing of the signal. Thisincludes such things as CW frequency <strong>and</strong> the sweep frequency controls. It does not affectthings like input filter b<strong>and</strong>widths. It does affect the settings of relative frequency parameterssuch as delta markers or FM deviation. Also note that this comm<strong>and</strong> does not affect thehardware settings of the instrument, but only the entered <strong>and</strong> displayed frequencies.At *RST, this value is set to 1.18.10.7 :OFFSet SENSe:FREQuency:OFFSetSets a reference frequency for all other absolute frequency settings in the instrument. Thiscomm<strong>and</strong> affects the values of all functions which affect sensing of the signal. This includessuch things as CW frequency <strong>and</strong> the sweep frequency controls. It does not affect things likeinput filter b<strong>and</strong>widths. It also does not affect the settings of relative frequency parameterssuch as delta markers or SPAN. Also note that this comm<strong>and</strong> does not affect the hardwaresettings of the instrument, but only the entered <strong>and</strong> displayed frequencies. The couplingequation is:Entered|Displayed frequency = (Hardware frequency * multiplier) + offset.At *RST, this value is set to 0.18.10.8 :RANGeSENSe:FREQuency:RANGeSets the frequency range for the sensor function.18.10.8.1 [:UPPer] SENSe:FREQuency:RANGe:UPPerSpecifies the maximum value expected for the sensor input.At *RST, this value is device-dependent.18.10.8.2 :LOWer SENSe:FREQuency:RANGe:LOWerSpecifies the lowest value expected for sensor input.This function is coupled to UPPer in adevice-dependent manner.At *RST, this value is device-dependent.18.10.8.3 :AUTO |ONCESENSe:FREQuency:RANGe:AUTOSets the RANGe to the value determined by the instrument.At *RST, AUTO is set to ON.18-32 SENSe:FREQuency


1997 SCPI Comm<strong>and</strong> Reference18.10.9 :RESolution SENSe:FREQuency:RESolutionSpecifies the absolute resolution of the frequency measurement. For example, if ameasurement of 10 MHZ is made with a resolution of .01, the measurement is returned witha resolution of .01 Hz (that is, 10000000.00Hz)At *RST, this value is device-dependent.18.10.9.1 :AUTO |ONCESENSe:FREQuency:RESolution:AUTOAllows the system to determine the best resolution for the other measurement conditions.Explicitly selecting a value for FREQuency:RESolution will set AUTO OFF.At *RST, this value is set to ON.18.10.10 :SPAN SENSe:FREQuency:SPANSets the frequency span.At *RST, this function will be set to MAXimum.18.10.10.1 :HOLD SENSe:FREQuency:SPAN:HOLDProvides a mechanism to prevent the SPAN from being changed implicitly by the definedcoupling between STARt, STOP, CENTer <strong>and</strong> SPAN. When HOLD is set to ON, SPANshall only be changed by explicitly sending the SPAN comm<strong>and</strong>.At *RST, this value is set to OFF.18.10.10.2 :LINK CENTer|STARt|STOPSENSe:FREQuency:SPAN:LINKAllows the default couplings for SPAN to be overridden. LINK selects the parameter, eitherCENTer, STARt or STOP, that shall not be changed when SPAN’s value is changed. Forexample, if LINK is set to STARt, then changing SPAN shall cause CENTer <strong>and</strong> STOP, notSTARt, to change.At *RST, this value is set to CENTer, to be compatible with the default definition for thecouplings.18.10.10.3 :FULLSENSe:FREQuency:SPAN:FULLWhen this comm<strong>and</strong> is received, start frequency is set to its minimum value, <strong>and</strong> stopfrequency is set to its maximum value. Center frequency <strong>and</strong> span are set to their coupledvalues.This comm<strong>and</strong> is an event. Therefore it has no associated query, or meaning at *RST.1234567891011121314151617181920212223242526SENSe:FREQuency 18-33


1997 SCPI Comm<strong>and</strong> Reference18.10.11 :STARt SENSe:FREQuency:STARtSets the starting frequency for a sweep or measurement. It also sets one limit of a manualfrequency adjustment. If the instrument does not support negative frequency span, having thestart frequency greater than the stop frequency will cause an error to be generated.At *RST, the parameter will be set to MINimum.18.10.12 :STOP SENSe:FREQuency:STOPSets the stop frequency of a sweep or measurement. It also sets the other limit of a manualsweep adjustment. If the instrument does not support negative frequency span, having thestop frequency less than the start frequency will cause an error to be generated.At *RST, this parameter will be set to MAXimum.1818-34 SENSe:FREQuency


1997 SCPI Comm<strong>and</strong> Reference18.11 FUNCtion & DATA SubsystemSENSe:FUNCtion & DATAThe FUNCtion subsystem selects the (s) to be sensed by the instrument.These functions differ from the signal-oriented MEASure instructions in that a is something that the sensor can be configured to directly detect.The DATA subsystem is used to query data from the SENSe block.KEYWORD PARAMETER FORM NOTES:DATA? [] [query only] 1991:DATA 1995:PREamble? [] [query only] 1994:FUNCtion:CONCurrent 1991:OFF {,} 1991:ALL [no query] 1991:COUNt? [query only] 1991[:ON] {,} 1991:ALL [no query] 1991:COUNt? [query only] 1991:STATe? [query only] 199118.11.1 DATA? []SENSe:DATA?Provides access to the result(s) of the SENSe block. This query retrieves the current SENSeresult(s).The parameter to this query is optional. Instruments that implement thisquery are required to accept the the optional parameter if sent. If a sensorfunction is specified, <strong>and</strong> that function is currently being sensed the result is returned. If thefunction is not being sensed an error -221 (Settings Conflict) shall be generated.If a is not specified, then the result(s) of all functions being sensed arereturned. If CONCurrent is OFF there will be only one FUNCtion result. If CONCurrent isON there will be one or more results, depending on how many functions are currently on.The order of the function results returned by the DATA? query is device-dependent,although the order of these results shall be the same as the order of the functions returned bythe FUNCtion[:ON]? query. If no functions are currently being sensed an error -221(Settings Conflict) shall be generated. The data returned by the DATA? query is affected bythe FORMat subsystem.This comm<strong>and</strong> is query-only <strong>and</strong> therefore has no *RST condition.18.11.1.1 SENSe sIf the SENSor block only emits one data flow, then the is just the string“SENSe”, where is a numeric suffix. However, for the case where the SENSe blockoutputs more than one result, each data result needs to be assigned a unique ,symbolic of the data flow. Since the SENSe:FUNCtion comm<strong>and</strong> is already defined to take a123TK056 4TK032a567891011121314151617181920212223242526SENSe:FUNCtion & DATA 18-35


1997 SCPI Comm<strong>and</strong> Referencewell-defined string as a parameter, these strings are used as part of the. If more than one SENSe block in the instrument outputs the same the SENSe block must also be included in the data h<strong>and</strong>le. The syntax forthe SENSe block is: := “[SENSe:]” | “SENSe[:]”18.11.1.2 :PREamble? []SENSe:DATA:PREamble?PREamble? returns the preamble information supporting the DATA(CURVe(VALues)) butomits the following data:TK056TK032aDIF blocks of waveform, measurement, <strong>and</strong> delta.DIF curve block keywords VALues <strong>and</strong> CSUM <strong>and</strong> their parameters.The DIF difid block must contain the keyword SCOPe with the parameter of PREamble.While the PREamble? query is designed to efficiently transmit data relating directly to thecurve, the various notes <strong>and</strong> identification parameters may be sent if absolutely required.The optional parameter functions the same as it does in SENSe:DATA?.TK032aTK032aTK032a18.11.2 :FUNCtionSENSe:FUNCtionThe FUNCtion subsystem selects the (s) to be sensed by the instrument.For compatibility, instruments that support CONCurrent ON are required to supportCONCurrent OFF mode. This is so some level of compatibility can be maintained withnon-concurrent instruments which expect data results for only one FUNCtion to be returnedby the SENSe:DATA? query.1818.11.2.1 :CONCurrent SENSe:FUNCtion:CONCurrentThe CONCurrent comm<strong>and</strong> indicates whether the SENSor block should be configured toSENSe one function at a time or SENSe more than one function at a time (concurrently).If CONCurrent is OFF, the FUNCtion[:ON] comm<strong>and</strong> acts as a one-of-n switch selecting theindicated function to be the only sensed function. If CONCurrent is ON, the function(s)specified as parameter(s) to the FUNCtion[:ON] comm<strong>and</strong> are turned on, while the state ofother functions are not affected.When CONCurrent is turned OFF, the instrument shall select one function to be turned on,<strong>and</strong> turn off any other functions that were on. The function which is selected to be on shallalways be the same one, even if that function is not currently ON.When CONCurrent is turned ON, the states of individual functions shall not be changed.At *RST the value of CONCurrent is device-dependent. However if an instrumentimplements CONCurrent ON, then it must implement CONCurrent OFF also for purposes ofinstrument compatibility.18-36 SENSe:FUNCtion & DATA


1997 SCPI Comm<strong>and</strong> Reference18.11.2.2 :OFF {,}SENSe:FUNCtion:OFFThe FUNCtion:OFF comm<strong>and</strong> selects the s to be turned off. Thiscomm<strong>and</strong> only needs to be implemented by instruments which allow users to turn OFFindividual functions while leaving others on. The state of any other functions are not affectedby turning the specified functions OFF.The query response of FUNCtion:OFF? shall return a comma separated list of functionswhich are currently OFF, each of which are . If no functionsare OFF, a null string is returned. The query shall return the short form mnemonics <strong>and</strong> shallomit any default nodes in the .At *RST, this value is device-dependent.18.11.2.2.1 :ALLSENSe:FUNCtion:OFF:ALLThis comm<strong>and</strong> turns OFF all of the s which the instrument canconcurrently sense. There is no query for this comm<strong>and</strong>.18.11.2.2.2 :COUNt?SENSe:FUNCtion:OFF:COUNt?This query returns the number of s which are OFF. This comm<strong>and</strong> mustbe implemented if CONCurrent ON <strong>and</strong> FUNCtion:OFF are implemented.This comm<strong>and</strong> is query-only <strong>and</strong> therefore has no *RST condition.18.11.2.3 [:ON] {,}SENSe:FUNCtion:ONThe FUNCtion[:ON] comm<strong>and</strong> selects the (s) to be SENSed by theinstrument. This comm<strong>and</strong> only needs to be implemented by instruments which allow usersto select what functions will be SENSed. The is specified as a quotedstring. For example:FUNCtion “VOLTage:AC”If CONCurrent is OFF, a single is sent as the parameter. This selects thisfunction to be sensed. If more than one function is sent an error -108 (Parameter notallowed) shall be generated.If CONCurrent is ON, a comma separated list of may be sent asparameters. These functions are turned on, while the state of other functions are not affected.The query response of FUNCtion[:ON]? shall return a comma separated list of functionswhich are on, each of which are . If no functions are ON, anull string is returned. The query shall return the short form mnemonics <strong>and</strong> shall omit anydefault nodes in the .For example FUNCtion[:ON]? returns the quoted string “VOLT:AC”.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SENSe:FUNCtion & DATA 18-37


1997 SCPI Comm<strong>and</strong> Reference1818.11.2.3.1 :ALLSENSe:FUNCtion:ON:ALLThis comm<strong>and</strong> turns ON all of the s which the instrument canconcurrently sense. There is no query for this comm<strong>and</strong>.18.11.2.3.2 :COUNt?SENSe:FUNCtion:ON:COUNt?This query returns the number of s which are ON. This comm<strong>and</strong> must beimplemented if CONCurrent ON <strong>and</strong> FUNCtion[:ON] are implemented.This comm<strong>and</strong> is query-only <strong>and</strong> therefore has no *RST condition.18.11.2.4 :STATe? SENSe:FUNCtion:STATe?Returns a Boolean indicating whether the specified is currently ON orOFF. This comm<strong>and</strong> is query only.At *RST, the state of each is device- dependent.18.11.2.5 SENSe:FUNCtionThe FUNCtion subsystem uses the to select the function on which theFUNCtion comm<strong>and</strong>s operate on, has the following syntax: ::=“[{,}] [ON {,}]”The is STRING PROGRAM DATA.The names inside angle brackets () are called productions <strong>and</strong> the commas (,) <strong>and</strong>‘ON’ are literals. White space is defined in section 7.4.1.2 of IEEE 488.2 as one or morewhite space characters.For a sent to an instrument, white space is not allowed inside anyproduction or literal. White space is not allowed between the <strong>and</strong> productions. At least one white space character is required before <strong>and</strong>after the literal ON. At least one white space character is required before the first. White space is permitted, but not required, everywhere else in the. The FUNCtion comm<strong>and</strong>s shall accept the long <strong>and</strong> short forms of mnemonics. Instruments shall accept both upper <strong>and</strong> lowercasecharacters without distinguishing between cases.When a is returned in response to a query, it shall contain no white spaceexcept for a single space before the first <strong>and</strong> single spaces around the literalON if either is present. The mnemonics in the query response shall use short form withdefault nodes omitted. All alpha characters in the response shall be in uppercase. elements are omitted in the query response only if all have been set to theirdefault values. If any element has been set to anything other than its defaultvalue, then all elements are returned in the query response.HP088HP088HP08818-38 SENSe:FUNCtion & DATA


1997 SCPI Comm<strong>and</strong> ReferenceThe is a well-defined hiearchical sensor function indicating the type offunction the sensor will be configured to directly detect.The optional parameters are numeric values indicating which INPut blocksshall be “fed” into the sensor function. The numeric value corresponds to the samenumberedINPut block. Specifying an input block in a sensor function makes an implicitinternal routing connection such that the output of the designated INPut block will flow intothe sensor. If no parameters are specified the instrument defined default dataflow is used.For example, SENSe:FUNCtion “VOLTage:AC 2” would configure the sensor to sense theAC Voltage of the data flowing out of INPut2. The SENSe:FUNCtion? query would thenreturn the quoted string “VOLT:AC 2”.The optional parameter is used when the SENSe block contains userconfigurable selections of subnodes to be used in computation of the SENSe FUNCtion. Forexample if a single SENSe block contained two SWEep subblocks <strong>and</strong> the sensor could useeither SWEep block to measure the AC Voltage of INPut1. Currently SWEep <strong>and</strong> AVERageare the only subnodes which are allowed after the ON keyword.1234567891011121314151617181920212223242526SENSe:FUNCtion & DATA 18-39


1997 SCPI Comm<strong>and</strong> Reference18.11.2.6 199118PRESENTATION LAYER[XNONe:] 1991XTIMe: 1991XFRequency: 1991XPOWer: 1991XVOLtage: 1991XCURrent: 199118.11.2.6.1 [XNONe:]SENSe:FUNCtion “XNONe:”This specifies that the X-axis has no specific units or number of points. No knowledge canbe associated with the X-axis. XNONe is only scalar.18.11.2.6.2 XTIMe:SENSe:FUNCtion “XTIMe:”This specifies that the sensor function results are acquired with respect to time. The X-axis isin units of time.18.11.2.6.3 XFRequency:SENSe:FUNCtion “XFRequency:”This specifies that the sensor function results are acquired with respect to frequency. TheX-axis is in units of frequency.18.11.2.6.4 XPOWer:SENSe:FUNCtion “XPOWer:”This specifies that the sensor function results are acquired with respect to power. The X-axisis in units of power.18.11.2.6.5 XVOLtage:SENSe:FUNCtion “XVOLtage:”This specifies that the sensor function results are acquired with respect to voltage. TheX-axis is in units of voltage.18.11.2.6.6 XCURrent:SENSe:FUNCtion “XCURrent:”This specifies that the sensor function results are acquired with respect to current. TheX-axis is in units of current.18-40 SENSe:FUNCtion & DATA


1997 SCPI Comm<strong>and</strong> Reference18.11.2.7 SENSe:FUNCtionA SENSe:FUNCtion is a well-defined hierarchical sensor functionindicating the type of function the sensor will be configured to directly detect. The comprises the <strong>and</strong> is optionally followed by a:. := [:]Where: is of type with thefollowing values defined: := RATio | SUMWhen the RATio suffix is included, then a ratio between two input blocks shall be selected.When the SUM suffix is included, then the sum of two or more input blocks shall be selected.Excluding the shall cause the sensor function to be selected.For example::SENSe:FUNCtion “FREQuency”Selects frequency sensing.:SENSe:FUNCtion “FREQuency:RATio”Selects a ratio of two frequencies as a function. If the user specifies input blocks after thesensor function, then the first input block specified is the numerator <strong>and</strong> the second inputblock is the denominator.:SENSe:FUNCtion “VOLTage:DC:SUM 1,2"Selects the sum of DC voltages on inputs 1 <strong>and</strong> 2 as a function.TK01812345TK0186TK0187TK018891011121314151617181920212223242526SENSe:FUNCtion & DATA 18-41


PH033HP056HP056HP056HP0561997 SCPI Comm<strong>and</strong> Reference1818.11.2.8 The following is the sensor tree <strong>and</strong> descriptions:FUNCTION DESCRIPTIONAM 1991[:DEPTh] AM Depth 1991:DISTortion AM Distortion 1991:FREQuency AM Frequency 1991:SNDRatio AM Signal, Noise & Distortion Ratio (SINAD) 1991:SNR AM Signal to Noise Ratio 1991:THD AM Total Harmonic Distortion 1991CONDition True/False condition of a signal 1993 PH074CURRent[:DC]DC Current:ACAC CurrentFM 1991[:DEViation] FM Deviation 1991:DISTortion FM Distortion 1991:FREQuency FM Frequency 1991:SNDRatio FM Signal, Noise & Distortion Ratio (SINAD) 1991:SNR FM Signal to Noise Ratio 1991:THD FM Total Harmonic Distortion 1991FREQuency Direct sensing of frequencyFRESistance Four-wire resistance 1991PERiodInverse of frequencyPHASe Direct sensing of phase 1992PM 1991[:DEViation] PM Deviation 1991:DISTortion PM Distortion 1991:FREQuency PM Frequency 1991:SNDRatio PM Signal, Noise & Distortion Ratio (SINAD) 1991:SNR PM Signal to Noise Ratio 1991:THD PM Total Harmonic Distortion 1991POWer:ACAC Power:ACHannel Adjacent Channel Power 1991:LOWer Lower Adjacent Channel Power 1991[:UPPer] Upper Adjacent Channel Power 1991:COHerence 1992:CROSs Cross Product 1992[:DC]DC Power:DISTortion Distortion 1991:PSDensity Power Spectral Density 1992:S11 | S21 | S22 | S12Scattering Parameter Function 1992:SNDRatio Signal, Noise & Distortion Ratio (SINAD) 199118-42 SENSe:FUNCtion & DATA


HP0HP0HP0HP01997 SCPI Comm<strong>and</strong> ReferenceFUNCTION DESCRIPTION:SNR Signal to Noise Ratio 1991:THD Total Harmonic Distortion 1991PULM Pulse Modulation 1994RESistance Two wire resistanceSSB Single Sideb<strong>and</strong> 1994TINTerval Time Interval 1991TOTalize Totalize Events 1991VOLTage:ACAC Voltage:CDFunction Cumulative Density Function 1992[:DC]DC Voltage:HISTogram Histogram 1992:PDFunction Probability Density Function 199218.11.2.8.1 AMSENSe:FUNCtion “AM”Amplitude modulation.18.11.2.8.1.1 [:DEPTh]SENSe:FUNCtion “AM:DEPTh”AM depth.18.11.2.8.1.2 :DISTortionSENSe:FUNCtion “AM:DISTortion”DISTortion is the ratio of noise plus distortion to the signal plus noise plus distortion.18.11.2.8.1.3 :FREQuencySENSe:FUNCtion “AM:FREQuency”AM frequency.18.11.2.8.1.4 :SNDRatioSENSe:FUNCtion “AM:SNDRatio”Signal, Noise <strong>and</strong> Distortion Ratio (SINAD or SNDRatio) is the ratio of the unfiltered signalto the signal with its fundamental removed (ratio of signal plus noise plus distortion to thenoise plus distortion).Signal to Noise Ratio (SNR) = (signal+noise) / noise.18.11.2.8.1.5 :SNRSENSe:FUNCtion “AM:SNR”AM signal to noise ratio.18.11.2.8.1.6 :THDSENSe:FUNCtion “AM:THD”Total Harmonic Distortion (THD) is the ratio of the signal with its fundamental removed tothe unfiltered signal.RS0111RS011234567891011121314151617181920212223242526SENSe:FUNCtion & DATA 18-43


HP0561997 SCPI Comm<strong>and</strong> Reference18.11.2.8.2 CONDitionSENSe:FUNCtion “CONDition”True/False condition of a signal18.11.2.8.3 CURRentSENSe:FUNCtion “CURRent”18.11.2.8.3.1 [:DC]SENSe:FUNCtion “CURRent:DC”DC current.18.11.2.8.3.2 :ACSENSe:FUNCtion “CURRent:AC”AC current.18.11.2.8.4 FMSENSe:FUNCtion “FM”Frequency modulation.18.11.2.8.4.1 :[DEViation]SENSe:FUNCtion “FM:DEViation”FM Deviation.18.11.2.8.4.2 :DISTortionSENSe:FUNCtion “FM:DISTortion”DISTortion is the ratio of noise plus distortion to the signal plus noise plus distortion.18.11.2.8.4.3 :FREQuencySENSe:FUNCtion “FM:FREQuency”FM frequency.1818.11.2.8.4.4 :SNDRatioSENSe:FUNCtion “FM:SNDRatio”Signal, Noise <strong>and</strong> Distortion Ratio (SINAD or SNDRatio) is the ratio of the unfiltered signalto the signal with its fundamental removed (ratio of signal plus noise plus distortion to thenoise plus distortion).Signal to Noise Ratio (SNR) = (signal+noise) / noise.18.11.2.8.4.5 :SNRSENSe:FUNCtion “FM:SNR”FM signal to noise ratio.18.11.2.8.4.6 :THDSENSe:FUNCtion “FM:THD”Total Harmonic Distortion (THD) is the ratio of the signal with its fundamental removed tothe unfiltered signal.18.11.2.8.5 FREQuencySENSe:FUNCtion “FREQuency”Direct sensing of frequency.18-44 SENSe:FUNCtion & DATA


HP01997 SCPI Comm<strong>and</strong> Reference18.11.2.8.6 FRESistanceSENSe:FUNCtion “FRESistance”Four-wire resistance.18.11.2.8.7 PERiodSENSe:FUNCtion “PERiod”Inverse of frequency.1218.11.2.8.8 PHASeSENSe:FUNCtion “PHASe”3PH0Direct sensing of phase.418.11.2.8.9 PM5SENSe:FUNCtion “PM”Pulse modulation.618.11.2.8.9.1 [:DEViation]7SENSe:FUNCtion “PM:DEViation”PM deviation.18.11.2.8.9.2 :DISTortionSENSe:FUNCtion “PM:DISTortion”DISTortion is the ratio of noise plus distortion to the signal plus noise plus distortion.89101118.11.2.8.9.3 :FREQuency12SENSe:FUNCtion “PM:FREQuency”PM Frequency.1318.11.2.8.9.4 :SNDRatio14SENSe:FUNCtion “PM:SNDRatio”Signal, Noise <strong>and</strong> Distortion Ratio (SINAD or SNDRatio) is the ratio of the unfiltered signalto the signal with its fundamental removed (ratio of signal plus noise plus distortion to thenoise plus distortion).Signal to Noise Ratio (SNR) = (signal+noise) / noise.18.11.2.8.9.5 :SNRSENSe:FUNCtion “PM:SNR”PM signal to noise ratio.15161718192018.11.2.8.9.6 :THD21SENSe:FUNCtion “PM:THD”22PM Total Harmonic Distortion (THD) is the ratio of the signal with its fundamental removedto the unfiltered signal.2318.11.2.8.10 POWer24SENSe:FUNCtion “POWer”2526SENSe:FUNCtion & DATA 18-45


HP056HP056HP056HP056HP0561997 SCPI Comm<strong>and</strong> Reference18.11.2.8.10.1 :ACSENSe:FUNCtion “POWer:AC”AC Power.18.11.2.8.10.2 :ACHannelSENSe:FUNCtion “POWer:ACHannel”Adjacent Channel Power measurements involve measuring the power at a specified carrierfor a given b<strong>and</strong>width <strong>and</strong> then ratio it to the power detected at the upper (or lower) adjacentchannel.18.11.2.8.10.2.1 :LOWerSENSe:FUNCtion “POWer:ACHannel:LOWer”Lower Adjacent Channel Power.18.11.2.8.10.2.2 [:UPPer]SENSe:FUNCtion “POWer:ACHannel:UPPer”Upper Adjacent Channel Power.18.11.2.8.10.3 :COHerenceSENSe:FUNCtion “POWer:COHerence”COHerence is the portion of the first spectrum related to the second spectrum. It is a measure of the statistical validity of a frequency responsemeasurement.18.11.2.8.10.4 :CROSsSENSe:FUNCtion “POWer:CROSs”This is the Cross Product of two input_blocks. It is computed by multiplying the complexconjugate of the first by the second .18.11.2.8.10.5 [:DC]SENSe:FUNCtion “POWer:DC”DC Power.1818.11.2.8.10.6 :DISTortionSENSe:FUNCtion “POWer:DISTortion”DISTortion is the ratio of noise plus distortion to the signal plus noise plus distortion.18.11.2.8.10.7 :PSDensitySENSe:FUNCtion “POWer:PSDensity”This is the Power Spectral Density. It is the power spectrum normalized to a 1 Hz b<strong>and</strong>width.18.11.2.8.10.8 :S11|:S12|:S22|:S21SENSe:FUNCtion “POWer:S11"These are the Scattering Parameter Functions.Scattering parameters or S parameters are a tool used in frequency characterization ofdevices to determine how the device modifies signal flow. An S parameter is a ratio of twoenergy values <strong>and</strong> is defined as:18-46 SENSe:FUNCtion & DATA


HP0HP0HP0Something needed he1997 SCPI Comm<strong>and</strong> Referenceenergy emerging from port xS xy =energy entering port ywith all ports other than port Y terminated in a Z0 load.By convention, a devices ports are numbered (1,2,...n). An n port device has n 2 S parameterslabelled Sxy, where {x,y} = {1,2,...,n}.For more information please refer to “Scattering <strong>and</strong> Transmission Coefficients” chapter in“Fields <strong>and</strong> Waves in Communication Electronics”, Ramo, Whinnery <strong>and</strong> Van Duzer.18.11.2.8.10.9 :SNDRatioSENSe:FUNCtion “POWer:SNDRatio”Signal, Noise <strong>and</strong> Distortion Ratio (SINAD or SNDRatio) is the ratio of the unfiltered signalto the signal with its fundamental removed (ratio of signal plus noise plus distortion to thenoise plus distortion).Signal to Noise Ratio (SNR) = (signal+noise) / noise.18.11.2.8.10.10 :SNRSENSe:FUNCtion “POWer:SNR”Signal to Noise Ratio.18.11.2.8.10.11 :THDSENSe:FUNCtion “POWer:THD”Total Harmonic Distortion (THD) is the ratio of the signal with its fundamental removed tothe unfiltered signal.18.11.2.8.11 PULMSENSe:FUNCtion “PULM”Pulse modulation.18.11.2.8.12 RESistanceSENSe:FUNCtion “RESistance”Two wire resistance.18.11.2.8.13 SSBSENSe:FUNCtion “SSB”Single sideb<strong>and</strong> modulation.18.11.2.8.14 TINTervalSENSe:FUNCtion “TINTerval”Time Interval.18.11.2.8.15 TOTalizeSENSe:FUNCtion “TOTalize”Totalize events.18.11.2.8.16 VOLTageSENSe:FUNCtion “VOLTage”12345678910111213RS0111415161718RS0111920212223242526SENSe:FUNCtion & DATA 18-47


HP056HP056HP056HP0561997 SCPI Comm<strong>and</strong> Reference18.11.2.8.16.1 :ACSENSe:FUNCtion “VOLTage:AC”AC Voltage.18.11.2.8.16.2 :CDFunctionSENSe:FUNCtion “VOLTage:CDFunction”The Cumulative Density Function is the integral of a normalized histogram.18.11.2.8.16.3 [:DC]SENSe:FUNCtion “VOLTage:DC”DC Voltage.18.11.2.8.16.4 :HISTogramSENSe:FUNCtion “VOLTage:HISTogram”The histogram measures how the amplitude of the input signal is distributed between it’smaximum <strong>and</strong> minimum values.18.11.2.8.16.5 :PDFunctionSENSe:FUNCtion “VOLTage:PDFunction”The Probability Density Function is computed by normalizing a histogram <strong>and</strong> is a statisticalmeasure of the probablity that a specific level occured.1818-48 SENSe:FUNCtion & DATA


1997 SCPI Comm<strong>and</strong> Reference18.12 LIST SubsystemSENSe:LISTThe list subsystem controls automatic sequencing through associated lists of frequency, <strong>and</strong>dwell time values. The various values are specified in the LIST:FREQuency, LIST:DWELlcomm<strong>and</strong>s. Points in each list correspond to the associated point in all other lists.The LIST subsystem controls a characteristic of the instrument when that subsystem’s modeis set to LIST (for example, FREQuency:MODE LIST).When employing multiple lists, all lists must be of equal length. If they are not of the samelength, an error is generated at sequencing time. An exception is made for the case where theshorter list is of length 1. In this case, the particular list is treated as though it were a list ofequal length, with all values being the same.Lists are not affected by *RST.KEYWORD PARAMETER FORM NOTES:LIST:COUNt:DIRection UP|DOWN:DWELl{,}:POINts?[query only]:FREQuency {,}:POINts?[query only]:SEQuence {,}:AUTO |ONCE:POINts?[query only]18.12.1 :COUNt SENSe:LIST:COUNtControls the number of times the sequence list is scanned when a trigger is received.18.12.2 :DIRection UP|DOWNSENSe:LIST:DIRectionSpecifies the direction that the sequence list is scanned. If UP is selected, the list is scannedfrom the first to the last item in the sequence list. If DOWN is selected, the list is scannedfrom the last item to the first item in the sequence list.18.12.3 :DWELl {,}SENSe:LIST:DWELlSpecifies the dwell time points of the lists. The units are in seconds.This specifies the amount of time spent at each point.18.12.3.1 :POINts?SENSe:LIST:DWELl:POINts?Returns the number of points currently in the DWELl list.1234567891011121314151617181920212223242526SENSe:LIST 18-49


1997 SCPI Comm<strong>and</strong> Reference18.12.4 :FREQuency {,}SENSe:LIST:FREQuencySpecifies the frequency points of the list set. The units are Hz.18.12.4.1 :POINts?SENSe:LIST:FREQuency:POINts?This query returns the number of points currently in the FREQuency list.18.12.5 :SEQuence {,}SENSe:LIST:SEQuenceDefines a sequence for stepping through the list. Individual points may be specified as manytimes as desired in a single sequence. The points specified are indexes into the lists. Forexample, if 3 was selected, the third point in the frequency <strong>and</strong> dwell lists would besequenced.18.12.5.1 :AUTO |ONCESENSe:LIST:SEQuence:AUTOWhen on, the sequence list is set to 1 through N, where N is the longest list.18.12.5.2 :POINts?SENSe:LIST:SEQuence:POINts?This query returns the number of points currently in the SEQuence list.1818-50 SENSe:LIST


1997 SCPI Comm<strong>and</strong> Reference18.13 MIXer SubsystemSENSe:MIXerThis subsystem controls external mixers for tuned receivers. It also provides controls tocompensate for known fixed losses in external mixers.KEYWORD PARAMETER FORM NOTES:MIXer:BIAS:AUTO |ONCE:LIMit:HARMonic :AUTO |ONCE:LOSS:AUTO 199118.13.1 :BIAS SENSe:MIXer:BIASControls the mixer bias.At *RST, this value is device-dependent.18.13.1.1 :AUTO |ONCESENSe:MIXer:BIAS:AUTOAllows the mixer bias to be automatically set by other parameters in the system. Explicitlysetting a value for BIAS shall cause AUTO to be set to OFF.At *RST, this value shall be set to ON.18.13.1.2 :LIMit SENSe:MIXer:BIAS:LIMitControls the maximum mixer bias level which can be set by the BIAS comm<strong>and</strong> or by otherparameters when AUTO is ON.The limits <strong>and</strong> *RST conditions are instrument-dependent.18.13.2 :HARMonic SENSe:MIXer:HARMonicSelects which harmonic of the local oscillator will be used for mixing.At *RST, this value is device-dependent.18.13.2.1 :AUTO |ONCESENSe:MIXer:HARMonic:AUTOWhen AUTO is ON, the harmonic is chosen by the system or instrument, <strong>and</strong> may changeduring the sweep. When OFF, the harmonic is locked to the selected value. Setting a valuefor MIXer:HARMonic sets AUTO to OFF.At *RST, this value is set to ON.1234567891011121314151617181920212223242526SENSe:MIXer 18-51


1997 SCPI Comm<strong>and</strong> Reference18.13.3 :LOSS SENSe:MIXer:LOSSCompensates for losses external to the instrument. This parameter is added to all readings.The unit for this comm<strong>and</strong> is the current relative amplitude unit.At *RST, this value is set to 0.18.13.3.1 :AUTO SENSe:MIXer:LOSS:AUTOSets the LOSS to the value appropriate to the connected external mixer.At *RST, this value is device-dependent.1818-52 SENSe:MIXer


1997 SCPI Comm<strong>and</strong> Reference18.14 PM SubsystemSENSe:PMThe Phase Modulation subsystem is used to set the modulation controls <strong>and</strong> parametersassociated with sensing phase modulated signals.KEYWORD PARAMETER FORM NOTES:PM 1991[:DEViation] 1991:RANGe 1991:AUTO | ONCE 1991[:UPPer] 1991:LOWer 199118.14.1 [:DEViation]SENSe:PM:DEViationThis node is used to collect together the deviation parameters.18.14.1.1 :RANGeSENSe:PM:DEViation:RANGeSets the range for the sensor function.18.14.1.1.1 :AUTO | ONCESENSe:PM:DEViation:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range withoutoverloading. The actual algorithm is device-dependent. Selecting AUTO ONCE will havethe effect of setting AUTO to ON <strong>and</strong> then OFF.At *RST, this value is set to ON.18.14.1.1.2 [:UPPer] SENSe:PM:DEViation:RANGe:UPPerSpecifies the maximum signal level expected for the sensor input.At *RST, this value is device-dependent.18.14.1.1.3 :LOWer SENSe:PM:DEViation:RANGe:LOWerSpecifies the smallest signal level expected for the sensor input. This allows setting for thebest dynamic range. This function is coupled to UPPer.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SENSe:PM 18-53


1997 SCPI Comm<strong>and</strong> Reference1818.15 POWer SubsystemSENSe:POWerThis subsection controls the power amplitude characteristics of the sensor.KEYWORD PARAMETER FORM NOTES:POWer:ACHannel 1991:SPACing 1991:LOWer 1991:AUTO 1991[:UPPer] 1991:AC|[:DC]:APERture :NPLCycles 1991:ATTenuation :AUTO :PROTection[:LEVel] :STATe:TRIPped?[query only]:CLEar[no query]:RANGe[:UPPer] :LOWer :AUTO |ONCE:DIRection UP|DOWN|EITHer:LLIMit 1996:ULIMit 1996:OFFSet 1991:PTPeak 1991:REFerence :STATe :RESolution :AUTO |ONCE:DETector INTernal | EXTernal 199118.15.1 :ACHannelSENSe:POWer:ACHannelAdjacent Channel Power Measurements involve measuring the power at a specified carrierfor a given b<strong>and</strong>width <strong>and</strong> then ratio it to the power detected at the upper (or lower) adjacentchannel.18.15.1.1 :SPACingSENSe:POWer:ACHannel:SPACingControls the channel SPACing which is the distance from the modulated carrier signal to theupper or lower Adjacent Channel.18-54 SENSe:POWer


1997 SCPI Comm<strong>and</strong> Reference18.15.1.1.1 :LOWer SENSe:POWer:ACHannel:SPACing:LOWerControls the channel SPACing to the lower Adjacent Channel.At *RST, this value is device-dependent.18.15.1.1.1.1 :AUTO SENSe:POWer:ACHannel:SPACing:LOWer:AUTOWhen AUTO is ON, the value of LOWer is coupled to the value of UPPER.18.15.1.1.2 [:UPPer] SENSe:POWer:ACHannel:SPACing:UPPerControls the channel SPACing which is the distance from the modulated carrier signal to theupper Adjacent Channel.At *RST, this value is device-dependent.18.15.2 :AC|[:DC]SENSe:POWer:ACThis subsystem selects the alternating current or the direct current sensor. The default unitsare watts.18.15.2.1 :APERture SENSe:POWer:AC:APERtureSpecifies the acquisition/sampling/gate time for a single measurement point. The parameterhas a unit of seconds.At *RST, this value is device-dependent.18.15.2.2 :NPLCycles SENSe:POWer:AC:NPLCyclesSpecifies the acquisition/sampling/gate time for a single measurement point in terms of thenumber of power line cycles. The parameter is unitless. If this comm<strong>and</strong> is implemented, theAPERture comm<strong>and</strong> must also be implemented.The value is coupled to APERture by the equation:APERture = NPLCycles/selected line frequencyAt *RST, this value is device-dependent.18.15.2.3 :ATTenuation SENSe:POWer:AC:ATTenuationSets the ATTenuation level. Note that when setting the level to 10 dB the magnitude of theincoming signal will be decreased by 10 dB. Changing the ATTenuation changes RANGe bythe same amount.Default units are as determined in the UNITS system.1234567891011121314151617181920212223242526SENSe:POWer 18-55


1997 SCPI Comm<strong>and</strong> Reference1818.15.2.3.1 :AUTO SENSe:POWer:AC:ATTenuation:AUTOCouples the attenuator to RANGe such that maximum dynamic range of the incoming signalis assured without overloading.Programming a specified attenuation sets AUTO OFF.At *RST, AUTO is set to ON.18.15.2.4 :PROTectionSENSe:POWer:AC:PROTectionControls the protection circuits.18.15.2.4.1 [:LEVel] SENSe:POWer:AC:PROTection:LEVelThis comm<strong>and</strong> sets the input level at which the input protection circuit will trip.18.15.2.4.2 :STATe SENSe:POWer:AC:PROTection:STATeControls whether the input protection circuit is enabled.At *RST, this value is set to ON.18.15.2.4.3 :TRIPped?SENSe:POWer:AC:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped. TRIPpedonly has a query form <strong>and</strong> thus has no associated *RST condition.18.15.2.4.4 :CLEarSENSe:POWer:AC:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.18.15.2.5 :RANGeSENSe:POWer:AC:RANGeSets the range for the amplitude sensor function. The RANGe endpoints may be specified interms of the UPPer endpoint <strong>and</strong> the LOWer endpoint, alternatively the midpoint of theRANGe (OFFSet) <strong>and</strong> the span of the RANGe (PTPeak) may be used. A non-symmetricalrange around zero may cause some instruments to introduce an actual offset to the signalentering the SENSe block.18.15.2.5.1 [:UPPer] SENSe:POWer:AC:RANGe:UPPerSpecifies the most positive signal level expected for the sensor input.At *RST, this value is device-dependent.18-56 SENSe:POWer


1997 SCPI Comm<strong>and</strong> Reference18.15.2.5.2 :LOWer SENSe:POWer:AC:RANGe:LOWerSpecifies the most negative signal level expected for the sensor input. This allows setting forthe best dynamic range. This function is coupled to UPPer in a device-dependent manner.At *RST, this value is device-dependent.18.15.2.5.3 :AUTO |ONCESENSe:POWer:AC:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range withoutoverloading. The actual algorithm is device-dependent.At *RST, AUTO is set to ON.18.15.2.5.3.1 :DIRection UP|DOWN|EITHerSENSe:POWer:AC:RANGe:AUTO:DIRectionThe DIRection comm<strong>and</strong> defines the manner in which AUTO works. When UP is selected,the instrument shall only change the range automatically to ranges larger than the currentrange, as the input signal dictates. When DOWN is selected, the instrument shall onlychange the range automatically to ranges smaller than the current range, as the input signaldictates. When EITHer is selected the instrument may range in either direction.At *RST, DIRection shall be set to EITHer.18.15.2.5.3.2 :LLIMit SENSe:POWer:AC:RANGe:AUTO:LLIMitThe Lower LIMit comm<strong>and</strong> sets the smallest range to which the instrument will go whileautoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, LLIMit shall be set to MINimum.18.15.2.5.3.3 :ULIMit SENSe:POWer:AC:RANGe:AUTO:ULIMitThe Upper LIMit comm<strong>and</strong> sets the largest range to which the instrument will go whileautoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, ULIMit shall be set to MAXimum.18.15.2.5.4 :OFFSet SENSe:POWer:AC:RANGe:OFFSetOFFSet determines the midpoint of the range.At *RST, this value is device-dependent.18.15.2.5.5 :PTPeak SENSe:POWer:AC:RANGe:PTPeakPeak To Peak specifies the dynamic range required for the sensor.1234567891011121314151617181920212223242526SENSe:POWer 18-57


1997 SCPI Comm<strong>and</strong> Reference18At *RST, this value is device-dependent.18.15.2.6 :REFerence SENSe:POWer:AC:REFerenceSets a reference amplitude for sensor instruments. This comm<strong>and</strong> differs in intent from thereference correction in that this is intended to be a measurement offset where a user wishesto reference a measurement to some known value.At *RST, this value is device-dependent, but STATe is set to OFF.18.15.2.6.1 :STATe SENSe:POWer:AC:REFerence:STATeDetermines whether amplitude is measured in absolute or relative mode. If STATe is ON,then amplitude is referenced to the value set in REFerence.At *RST, this value is set to OFF.18.15.2.7 :RESolution SENSe:POWer:AC:RESolutionSpecifies the absolute resolution of the measurement. For example, if a measurement of 10Volts is specified with a resolution of .01 Volts, the measurement is returned with aresolution of .01 Volts (that is, 10.00).RANGe is not coupled to RESolution. Setting RANGe shall not cause RESolution tochange. Setting RESolution shall not cause RANGe to change.At *RST, this value is device-dependent.18.15.2.7.1 :AUTO |ONCESENSe:POWer:AC:RESolution:AUTOAllows the system to determine the best resolution for the other measurement conditions.Explicitly setting a value for :RESolution will turn AUTO OFF.At *RST, this value is set to ON.18.15.3 :DETector INTernal | EXTernalSENSe:POWer:DETectorThe DETector can be specified as internal or external.At *RST, this value is set to INT.18-58 SENSe:POWer


1997 SCPI Comm<strong>and</strong> Reference18.16 RESistance|FRESistance SubsystemSENSe:RESistanceThis subsection controls the signal characteristics of a resistance sensor. RESistance shouldbe used for a two-wire measurement. FRESistance (four-wire resistance) should be used fora four-wire measurement. The default units are ohms.KEYWORD PARAMETER FORM NOTES:RESistance|:FRESistance 1991:APERture :NPLCycles 1991:OCOMpensated 1991:RANGe[:UPPer] :LOWer :AUTO |ONCE:DIRection UP|DOWN|EITHer:LLIMit 1996:ULIMit 1996:REFerence :STATe :RESolution :AUTO |ONCE18.16.1 :APERture SENSe:RESistance:APERtureSpecifies the acquisition/sampling/gate time for a single measurement point. The parameterhas a unit of seconds.At *RST, this value is device-dependent.18.16.2 :NPLCycles SENSe:RESistance:NPLCyclesSpecifies the acquisition/sampling/gate time for a single measurement point in terms of thenumber of power line cycles. The parameter is unitless. If this comm<strong>and</strong> is implemented, theAPERture comm<strong>and</strong> must also be implemented.The value is coupled to APERture by the equation:APERture = NPLCycles/selected line frequencyAt *RST, this value is device-dependent.18.16.3 :OCOMpensated SENSe:RESistance:OCOMpensatedEnables or disables the offset compensation when measuring resistance. (For example, offsetcompensation first measures the voltage on the input terminals before turning on the currentused to measure resistance.)At *RST, OCOMpensated shall be set to OFF.1234567891011121314151617181920212223242526SENSe:RESistance|FRESistance 18-59


1997 SCPI Comm<strong>and</strong> Reference1818.16.4 :RANGeSENSe:RESistance:RANGeSets the range for the resistance sensor.18.16.4.1 [:UPPer] SENSe:RESistance:RANGe:UPPerSpecifies the maximum resistance expected for the sensor input.At *RST, this value is device-dependent.18.16.4.2 :LOWer SENSe:RESistance:RANGe:LOWerSpecifies the smallest resistance expected for the sensor input. This allows setting for thebest dynamic range. This function is coupled to the UPPer comm<strong>and</strong> in a device-dependentmanner.At *RST, this value is device-dependent.18.16.4.3 :AUTO |ONCESENSe:RESistance:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range without overloading. The actual algorithm is device-dependent.At *RST, AUTO is set to ON.18.16.4.3.1 :DIRection UP|DOWN|EITHerSENSe:RESistance:RANGe:AUTO:DIRectionThe DIRection comm<strong>and</strong> defines the manner in which AUTO works. When UP is selected,the instrument shall only change the range automatically to ranges larger than the currentrange,as the input signal dictates. When DOWN is selected, the instrument shall only changethe range automatically to ranges smaller than the current range, as the input resistancedictates. When EITHer is selected, the instrument may range in either direction.AT *RST, DIRection shall be set to EITHer.18.16.4.3.2 :LLIMit SENSe:RESistance:RANGe:AUTO:LLIMitThe Lower LIMit comm<strong>and</strong> sets the smallest range to which the instrument will go whileautoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, LLIMit shall be set to MINimum.18.16.4.3.3 :ULIMit SENSe:RESistance:RANGe:AUTO:ULIMitThe Upper LIMit comm<strong>and</strong> sets the largest range to which the instrument will go whileautoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.18-60 SENSe:RESistance|FRESistance


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, ULIMit shall be set to MAXimum.18.16.5 :REFerence SENSe:RESistance:REFerenceSets a reference resistance for sensor instruments. This comm<strong>and</strong> differs in intent from thereference correction in that this is intended to be a measurement offset where a user wishesto reference a measurement to some known value.At *RST, this value is device-dependent, but STATe is set to OFF.18.16.5.1 :STATe SENSe:RESistance:REFerence:STATeDetermines whether resistance is measured in absolute or relative mode. If STATe is ON,then resistance is referenced to the value set in REFerence.At *RST, this value is set to OFF.18.16.6 :RESolution SENSe:RESistance:RESolutionSpecifies the absolute resolution of the measurement. For example, if a measurement of 10Ohms is made with a resolution of .01, the measurement is returned with a resolution of .01Ohms (that is, 10.00).At *RST, this value is device-dependent.18.16.6.1 :AUTO |ONCESENSe:RESistance:RESolution:AUTOAllows the system to determine the best resolution for the other measurement conditions.Explicitly setting a value for RESolution will turn AUTO OFF.At *RST, this value is set to ON.1234567891011121314151617181920212223242526SENSe:RESistance|FRESistance 18-61


HP055HP055HP055HP055HP055HP055HP055HP055HP055HP055HP055HP0551997 SCPI Comm<strong>and</strong> Reference18.17 ROSCillator SubsystemSENSe:ROSCillatorThis subsystem controls the frequency reference oscillator.KEYWORD PARAMETER FORM NOTES:ROSCillator[:INTernal] 1992:FREQuency :EXTernal 1992:FREQuency 1992:SOURce INTernal|EXTernal|NONE18|CLK10|CLK100 1991 HP024:AUTO |ONCE18.17.1 [:INTernal]SENSe:ROSCillator:INTernalThis subsystem configures the internal reference oscillator(s).18.17.1.1 :FREQuency SENSe:ROSCillator:INTernal:FREQuencySpecifies the frequency of the internal reference oscillator. The default units are Hz.At *RST, this value is device-dependent.18.17.2 :EXTernalSENSe:ROSCillator:EXTernalThis subsystem configures the external reference oscillator(s).18.17.2.1 :FREQuency SENSe:ROSCillator:EXTernal:FREQuencySpecifies the frequency of the external reference oscillator. The default units are Hz.At *RST, this value is device-dependent.18.17.3 :SOURce INTernal|EXTernal|NONE|CLK10|CLK100SENSe:ROSCillator:SOURceControls the selection of the reference oscillator source. This typically refers to a precision,stabilized time base. The parameter values have the following meanings:INTernal — The reference frequency is derived from an internal precisionoscillator.EXTernal — The reference frequency is derived from an external signal suppliedto the device.NONE — The reference frequency is not derived from any precision oscillator.CLK10 — The reference frequency is derived from VXIbus signal CLK10.CLK100 — The reference frequency is derived from VXIbus signal CLK100.At *RST, this value is device-dependent.18-62 SENSe:ROSCillator


1997 SCPI Comm<strong>and</strong> Reference18.17.3.1 :AUTO |ONCESENSe:ROSCillator:SOURce:AUTOWhen AUTO is ON, the system automatically selects which oscillator will be used by theinstrument.Explicitly selecting a reference oscillator turns AUTO OFF.At *RST, AUTO is set to ON.1234567891011121314151617181920212223242526SENSe:ROSCillator 18-63


FL0051997 SCPI Comm<strong>and</strong> Reference1818.18 SMOothing SubsystemSENSe:SMOothingThis subsystem controls the point-to-point smoothing of the signal. Smoothing differs fromaveraging in that with smoothing, adjacent points of one set of data are averaged, while inaveraging the average is taken over several acquisitions (that is, smoothing is a movingaverage). This subsystem controls smoothing done to compensate for measurement artifacts.Analytical post-acquisition smoothing is controlled with CALCulate:SMOothing.KEYWORD PARAMETER FORM NOTESSMOothing[:STATe] :APERture :POINts18.18.1 [:STATe] SENSe:SMOothing:STATeDetermines whether the smoothing algorithm is enabled.At *RST, this function is set to OFF.18.18.2 :APERture SENSe:SMOothing:APERtureSpecifies the size of the smoothing APERture as a ratio of smoothing window points/tracepoints. POINts is coupled to APERture by the equation:POINts = APERture * SWEep:POINtsFor example, if an APERture of .01 were chosen for a 1000-point sweep, then the smoothingwindow would be 10 points wide.At *RST, this value is device-dependent.18.18.3 :POINts SENSe:SMOothing:POINtsControls the number of points to be included in the running average. POINts is coupled toAPERture by the equation:POINts = APERture * SWEep:POINtsAt *RST, this value is device-dependent.18-64 SENSe:SMOothing


1997 SCPI Comm<strong>and</strong> Reference18.19 SSB SubsystemSENSe:SSBThe single sideb<strong>and</strong> modulation subsystem is used to set up the modulation controls <strong>and</strong>parameters associated with sensing <strong>and</strong> demodulating single sideb<strong>and</strong> modulated signals.18.19.1 :TYPE USB|LSB|A1SENSe:SSB:TYPESENSe:SSB:TYPE sets or queries the type of SSB demodulation technique the demodulatoruses. USB means the demodulator is configured to upper sideb<strong>and</strong> signals. LSB means thedemodulator is configured to lower sideb<strong>and</strong> signals. A1 means the demodulator isconfigured to A1 signals.At *RST, this value is device-dependent.RS011RS011 1234567891011121314151617181920212223242526SENSe:SSB 18-65


1997 SCPI Comm<strong>and</strong> Reference1818.20 SWEep SubsystemSENSe:SWEepThis subsystem controls the timebase <strong>and</strong>/or sweep generator in instruments that acquire dataeither directly or indirectly as a function of time.Examples of instruments that acquire data directly as a function of time (non-sweptinstruments) are digitizers <strong>and</strong> logic analyzers. The X axis has units of time. The presentation layer is :XTIMe.Examples of instruments that acquire data indirectly as a function of time (sweptinstruments) are spectrum analyzers. In this case, the X axis has units of frequency, but thefrequency is swept with relationship to time. The presentation layer is:XFRequency. The parameter to be swept is specified by setting the :MODE node in theassociated subsystem to SWEEP (FREQuency:MODE SWEep).Some comm<strong>and</strong>s in this subsystem are applicable to both swept <strong>and</strong> non-swept instruments.Others may apply to only one of these classes.Comm<strong>and</strong>s in this subsystem may be coupled to those in implementor-defined triggersequences such as TRIGger:SAMPle. The TRIGger sequences can provide additionalflexibility by allowing the user more precise control over the acquisition.The comm<strong>and</strong>s in the :SWEep subsystem specify the timing <strong>and</strong> spacing of the valuesreturned in :DATA?, FETCh?, <strong>and</strong> other measurement queries. The comm<strong>and</strong>s in theTRIGger subsystem specify when actual measurements are acquired. The preciserelationship between the parameters in the two subsystems is device dependent. Forexample, the :SWEep:TINTerval comm<strong>and</strong> specifies the timing period between twosuccessive samples of the SENSe:DATA? response. The TRIGger:SAMPle:TIMercomm<strong>and</strong> specifies the timing period between two acquisition samples that are taken by thetrigger subsystem.The :SWEep subsystem contains several sets of comm<strong>and</strong>s which have complex couplings.These include the comm<strong>and</strong>s :TIME, :POINts, :DWELl, <strong>and</strong> TINTerval. Sending any one ofa set singly will affect others of the set. However, if two are sent in a single programmessage, then these two shall set the values specified <strong>and</strong> the other changed. This is anaccordance with the style guidelines <strong>and</strong> IEEE 488.2. See <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong> section 7.4 foradditional rules.Default units in this subsystem are seconds unless otherwise specified.KEYWORD PARAMETER FORM NOTES:SWEep:COUNt:DIRection UP|DOWN:DWELl:AUTO |ONCE:GENeration STEPped|ANALog:MODEAUTO|MANual:OFFSet 199418-66 SENSe:SWEepACQ02bACQ02bACQ02bACQ02bACQ02bACQ02b MinutesACQ02bACQ02b


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTESACQ02b:POINts 1994:TIME 1994 ACQ02b:OREFerence 1994 ACQ02b:LOCation 1994 ACQ02b1:POINts 1994 ACQ02b:POINts2:REALtime 1993 PH0723[:STATe] 1993 PH072:SPACing LINear|LOGarithmic4:STEP:TIME5:AUTO |ONCE6:LLIMit 7:TINTerval 1994 ACQ02b18.20.1 :COUNt SENSe:SWEep:COUNt89This comm<strong>and</strong> determines the number of sweeps which are initiated or vectors (arrays of ACQ02b10samples, waveforms, etc) which are acquired by a single trigger event.At *RST, this value is set to 1.11ACQ02b18.20.2 :DIRection UP|DOWNSENSe:SWEep:DIRection1213Controls the direction of the sweep. If UP is selected, the sweep is carried out from start to ACQ02b14stop. If DOWN is selected, the sweep is carried out from stop to start. This comm<strong>and</strong> onlyapplies to swept instruments.At *RST, this value is set to UP.15ACQ02b 1618.20.3 :DWELl 17SENSe:SWEep:DWELl18Controls the amount of time spent at each point during a sweep. This comm<strong>and</strong> only applies ACQ02bto swept instruments. Explicitly setting a value for SWEep:DWELl setsSWEep:DWELl:AUTO OFF.1920The following coupling equation applies.ACQ02b21SWEep:TINTerval = SWEep:DWELl + 22Changing DWELl will cause either TINTerval or to change in a device ACQ02bdependent manner. See also introductory comments in the SWEep subsystem.23 is the device dependent time required for the sweep generator to move ACQ02b 24from one point (swept entity) to the next.25Note that DWELl cannot exceed TINTerval. Setting DWELl to a greater value will cause ACQ02b26error -222, “Data out of range” to be generated.At *RST, this value is device-dependent.ACQ02bSENSe:SWEep 18-67


1997 SCPI Comm<strong>and</strong> Reference1818.20.3.1 :AUTO |ONCESENSe:SWEep:DWELl:AUTOWhen ON is selected, the dwell time is calculated internally when SWEep:TINTerval ischanged. Explicitly setting a value for SWEep:DWELl sets SWEep:DWELl:AUTO OFF.At *RST, AUTO is set to ON.18.20.4 :GENeration STEPped|ANALogSENSe:SWEep:GENerationDetermines if the sweep or acquisition is stepped or analog.STEPped: A stepped sweep or acquisition is selected. The number of points is setby the SWEep:POINts comm<strong>and</strong>.ANALog: The sweep or acquisition is controlled by an analog signal.SWEep:POINts is not applicable.At *RST, this value is device-dependent.18.20.5 :MODE AUTO|MANualSENSe:SWEep:MODEDetermines whether the sweep is performed automatically, or if the actual swept entity iscontrolled by the MANual comm<strong>and</strong> in the appropriate subsystem (for example,FREQuency:MANual). This comm<strong>and</strong> only applies to swept instruments.At *RST, this value is set to AUTO.18.20.6 :OFFSetSENSe:SWEep:OFFSetThis subsystem sets the offset between the offset reference point (SWEep:OREFerence) <strong>and</strong>the trigger point.18.20.6.1 :POINts SENSe:SWEep:OFFSet:POINtsSets the offset in terms of points. This value may be positive or negative. A positive valuespecifies that the offset reference point occurs after the trigger point.The following coupling equation applies.SWEep:OFFSet:POINts = SWEep:OFFSet:TIME / SWEep:TINTervalChanging SWEep:OFFSet:POINts will cause SWEep:OFFSet:TIME to change, but notSWEep:TINTerval. See also introductory comments in the SWEep subsystem.At *RST, this value is set to 0.18.20.6.2 :TIME SENSe:SWEep:OFFSet:TIMESets the offset in units of time. This value may be positive or negative. A positive valuespecifies that the offset reference point occurs after the trigger point.The following coupling equation applies.SWEep:OFFSet:POINts = SWEep:OFFSet:TIME / SWEep:TINTerval18-68 SENSe:SWEepACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02bACQ02b


1997 SCPI Comm<strong>and</strong> ReferenceChanging SWEep:OFFSet:TIME will cause SWEep:OFFSet:POINts to change, but notSWEep:TINTerval. See also introductory comments in the SWEep subsystem.At *RST, this value is set to 0.18.20.7 :OREFerenceSENSe:SWEep:OREFerenceThis subsystem sets the location of the offset reference point in the sweep or acquisition. Theoffset reference is used by the SWEep:OFFSet comm<strong>and</strong>s.18.20.7.1 :LOCation SENSe:SWEep:OREFerence:LOCationSets the offset reference by specifying a relative location. SWEep:OREFerence:LOCationaccepts a range of values from 0 to 1. A value of 0 selects the first point of acquisition as thereference. A value of 1 selects the last point.The following coupling equation applies.SWEep:OREFerence:LOCation =(SWEep:OREFerence:POINts - 1) / (SWEep:POINts - 1)Changing SWEep:OREFerence:LOCation will cause SWEep:OREFerence:POINts tochange, but not SWEep:POINts. See also introductory comments in the SWEep subsystem.At *RST, this value is device-dependent.18.20.7.2 :POINts SENSe:SWEep:OREFerence:POINtsSets the offset reference by specifying a number of points. SWEep:OREFerence:POINtsaccepts values from 1 to N, where N is the maximum value of SWEep:POINts. A value of 1selects the first point of acquisition as the reference.The following coupling equation applies.SWEep:OREFerence:LOCation =(SWEep:OREFerence:POINts - 1) / (SWEep:POINts - 1)Changing SWEep:OREFerence:POINts will cause SWEep:OREFerence:LOCation tochange, but not SWEep:POINts. See also introductory comments in the SWEep subsystem.At *RST, this value is device-dependent.18.20.8 :POINts SENSe:SWEep:POINtsSets the number of points in a stepped sweep or acquisition. POINts is ignored whenGENeration is ANALog.The following coupling equations apply.SWEep:TINTerval = SWEep:TIME / (SWEep:POINts - 1)Changing SWEep:POINts will cause either SWEep:TINTerval or SWEep:TIME to changein a device dependent manner. See also introductory comments in the SWEep subsystem.ACQ02bACQ02bACQ02b1ACQ02b 23ACQ02b4ACQ02b 567ACQ02b89ACQ02b1011ACQ02b12ACQ02b13ACQ02b1415ACQ02b 161718ACQ02b19ACQ02b 202122ACQ02b23ACQ02b 2425ACQ02b 26SENSe:SWEep 18-69


1997 SCPI Comm<strong>and</strong> Reference18SWEep:OREFerence:LOCation =(SWEep:OREFerence:POINts - 1) / (SWEep:POINts - 1)Changing SWEep:POINts will cause either SWEep:OREFerence:LOCation orACQ02bSWEep:OREFerence:POINts to change in a device dependent manner. See also introductorycomments in the SWEep subsystem.When SPACing is LINear:ACQ02bSWEep:STEP = :SPAN / (SWEep:POINts - 1)Changing SWEep:POINts will cause SWEep:STEP to change, but notACQ02b:SPAN.When SPACing is LOGarithmic:ACQ02b = (SWEep:POINts-1) / Changing SWEep:POINts will cause to change, but notACQ02b. is calculated internally from:STARt, :STOP, :CENTer, <strong>and</strong> :SPAN. Normally, equals log10(:STOP/:STARt), when :STOP > :STARt. See also introductory comments inthe SWEep subsystem.At *RST, this value is device-dependent.ACQ02b18.20.9 :REALtime PH072SENSe:SWEep:REALtimeInstruments that acquire data directly as function of time, may use several data acquisitionmethods to sense the data points of the sweep.There are techniques where the points in the requested sweep are collected from a number ofsuccessive acquisitions. In this case the result is a reconstruction of the original signal out ofseveral acquisitions; this is not real time.An acquisition is known as real time if no reconstruction is done; that is, the points in theresulting data set are in the order in which they were acquired.18.20.9.1 [:STATe] PH072SENSe:SWEep:REALtime:STATeWhen STATe is ON, the instrument is required to collect data in real time. When STATe isOFF, the instrument is allowed to use reconstruction techniques.At *RST this function is OFF18.20.10 :SPACing LINear|LOGarithmicSENSe:SWEep:SPACingDetermines the time vs. swept entity characteristics of the sweep. The various settings havethe following meanings:LINear: The swept entity is incremented (decremented) by the stepsize until thesweep limit is reached if the sweep generation is stepped. If the sweep is analog,18-70 SENSe:SWEep


1997 SCPI Comm<strong>and</strong> Referenceselecting this parameter specifies a ramp.LOGarithmic: Step size is determined by a logarithmic curve fitted between thestart <strong>and</strong> stop value of the swept entity. Stepping is determined by the number ofsteps function.At *RST, this value is set to LINear.18.20.11 :STEP SENSe:SWEep:STEPControls the swept entity step size for a stepped linear sweep. STEP is ignored whenGENeration is ANALog or when SPACing is LOGarithmic.The following coupling equation applies.SWEep:STEP = :SPAN / (SWEep:POINts - 1)Changing SWEep:STEP will cause SWEep:POINts to change, but not:SPAN. See also introductory comments in the SWEep subsystem.The default units are those of the associated :SPAN comm<strong>and</strong>.At *RST, this value is device-dependent.18.20.12 :TIME SENSe:SWEep:TIMESets the duration of the sweep or acquisition. Note that this does not turn sweeping oracquisition on. Explicitly setting a value for SWEep:TINTerval or SWEep:TIME setsSWEep:TIME:AUTO OFF.The following coupling equation applies.SWEep:TINTerval = SWEep:TIME / (SWEep:POINts - 1)Changing SWEep:TIME will cause SWEep:TINTerval to change, but not SWeep:POINts.See also introductory comments in the SWEep subsystem.At *RST, this value is device-dependent.18.20.12.1 :AUTO |ONCESENSe:SWEep:TIME:AUTOWhen ON is selected, SWEep:TIME <strong>and</strong> SWEep:TINTerval are calculated internally whenrelated settings outside the time domain coupling equations are changed. Explicitly setting avalue for SWEep:TIME or SWEep:TINTerval sets SWEep:TIME:AUTO OFF.This comm<strong>and</strong> only applies to swept instruments, where explicitly setting SWEep:TIME <strong>and</strong>SWEep:TINTerval is the exception. For instance, in a spectrum analyzer, a user normallysets the frequency parameters (FREQuency:SPAN <strong>and</strong> :CENTER) <strong>and</strong> expects theinstrument to calculate the appropriate sweep time <strong>and</strong> interval to produce a reasonableresolution b<strong>and</strong>width. The :AUTO node should not be implemented in non-sweptinstruments that normally expect the user to explicitly set SWEep:TIME orSWEep:TINTerval.At *RST, AUTO is set to ON.1234ACQ02b56ACQ02b 78ACQ02b9ACQ02b1011ACQ02b 121314ACQ02b15ACQ02b 1617ACQ02b1819ACQ02b 202122ACQ02b23242526ACQ02bSENSe:SWEep 18-71


1997 SCPI Comm<strong>and</strong> Reference18.20.12.2 :LLIMit SENSe:SWEep:TIME:LLIMitDefines a lower limit for sweep time. This lower limit restricts the sweep time value seteither explicitly or automatically.At *RST, this value is device-dependent.18.20.13 :TINTerval SENSe:SWEep:TINTervalSets the time interval between points of the sweep or acquisition. Explicitly setting a valuefor SWEep:TINTerval or SWEep:TIME sets SWEep:TIME:AUTO OFF.The following coupling equations apply.ACQ02bACQ02bACQ02bSWEep:TINTerval = SWEep:TIME / (SWEep:POINts - 1)Changing SWEep:TINTerval will cause SWEep:TIME to change, but not SWeep:POINts.See also introductory comments in the SWEep subsystem.ACQ02bSWEep:OFFSet:POINts = SWEep:OFFSet:TIME / SWEep:TINTervalChanging SWEep:TINTerval will cause either SWEep:OFFSet:POINts orSWEep:OFFSet:TIME to change in a device dependent manner. See also introductorycomments in the SWEep subsystem.At *RST, this value is device-dependent.ACQ02bACQ02b1818-72 SENSe:SWEep


HP0HP01997 SCPI Comm<strong>and</strong> Reference18.21 VOLTage SubsystemSENSe:VOLTageThis subsection controls the voltage amplitude characteristics of the sensor.KEYWORD PARAMETER FORM NOTES:VOLTage:AC|[:DC]:APERture :NPLCycles 1991:ATTenuation :AUTO :PROTection[:LEVel] :STATe:TRIPped?[query only]:CLEar[no query]:RANGe[:UPPer] :LOWer :AUTO |ONCE:DIRection UP|DOWN|EITHer:LLIMit 1996:ULIMit 1996:OFFSet 1991,2:PTPeak 1991,2:REFerence :STATe :RESolution :AUTO |ONCE:DETector INTernal | EXTernal 199118.21.1 :AC|[:DC]SENSe:VOLTage:ACThis subsystem selects the alternating current or the direct current sensor. The default unitsare volts.18.21.1.1 :APERture SENSe:VOLTage:AC:APERtureSpecifies the acquisition/sampling/gate time for a single measurement point. The parameterhas a unit of seconds.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SENSe:VOLTage 18-73


1997 SCPI Comm<strong>and</strong> Reference1818.21.1.2 :NPLCycles SENSe:VOLTage:AC:NPLCyclesSpecifies the acquisition/sampling/gate time for a single measurement point in terms of thenumber of power line cycles. The parameter is unitless. If this comm<strong>and</strong> is implemented, theAPERture comm<strong>and</strong> must also be implemented.The value is coupled to APERture by the equation:APERture = NPLCycles/selected line frequencyAt *RST, this value is device-dependent.18.21.1.3 :ATTenuation SENSe:VOLTage:AC:ATTenuationSets the ATTenuation level. Note that when setting the level to 10 dB the magnitude of theincoming signal will be decreased by 10 dB. Changing the ATTenuation changes RANGe bythe same amount.Default units are as determined in the UNITS system.18.21.1.3.1 :AUTO SENSe:VOLTage:AC:ATTenuation:AUTOCouples the attenuator to RANGe such that maximum dynamic range of the incoming signalis assured without overloading.Programming a specified attenuation sets AUTO OFF.At *RST, AUTO is set to ON.18.21.1.4 :PROTectionSENSe:VOLTage:AC:PROTectionControls the protection circuits.18.21.1.4.1 [:LEVel] SENSe:VOLTage:AC:PROTection:LEVelThis comm<strong>and</strong> sets the input level at which the input protection circuit will trip.18.21.1.4.2 :STATe SENSe:VOLTage:AC:PROTection:STATeControls whether the input protection circuit is enabled.At *RST, this value is set to ON.18.21.1.4.3 :TRIPped?SENSe:VOLTage:AC:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped. TRIPpedonly has a query form <strong>and</strong> thus has no associated *RST condition.18.21.1.4.4 :CLEarSENSe:VOLTage:AC:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.18-74 SENSe:VOLTage


1997 SCPI Comm<strong>and</strong> Reference18.21.1.5 :RANGeSENSe:VOLTage:AC:RANGeSets the range for the amplitude sensor function. The RANGe endpoints may be specified interms of the UPPer endpoint <strong>and</strong> the LOWer endpoint, alternatively the midpoint of theRANGe (OFFSet) <strong>and</strong> the span of the RANGe (PTPeak) may be used. A non-symmetricalrange around zero may cause some instruments to introduce an actual offset to the signalentering the SENSe block.18.21.1.5.1 [:UPPer] SENSe:VOLTage:AC:RANGe:UPPerSpecifies the most positive signal level expected for the sensor input.At *RST, this value is device-dependent.18.21.1.5.2 :LOWer SENSe:VOLTage:AC:RANGe:LOWerSpecifies the most negative signal level expected for the sensor input. This allows setting forthe best dynamic range. This function is coupled to UPPer in a device-dependent manner.At *RST, this value is device-dependent.18.21.1.5.3 :AUTO |ONCESENSe:VOLTage:AC:RANGe:AUTOSets the RANGe to the value determined to give the most dynamic range withoutoverloading. The actual algorithm is device-dependent.At *RST, AUTO is set to ON.18.21.1.5.3.1 :DIRection UP|DOWN|EITHerSENSe:VOLTage:AC:RANGe:AUTO:DIRectionThe DIRection comm<strong>and</strong> defines the manner in which AUTO works. When UP is selected,the instrument shall only change the range automatically to ranges larger than the currentrange, as the input signal dictates. When DOWN is selected, the instrument shall onlychange the range automatically to ranges smaller than the current range, as the input signaldictates. When EITHer is selected the instrument may range in either direction.At *RST, DIRection shall be set to EITHer.18.21.1.5.3.2 :LLIMit SENSe:VOLTage:AC:RANGe:AUTO:LLIMitThe Lower LIMit comm<strong>and</strong> sets the smallest range to which the instrument will go whileautoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, LLIMit shall be set to MINimum.18.21.1.5.3.3 :ULIMit SENSe:VOLTage:AC:RANGe:AUTO:ULIMitThe Upper LIMit comm<strong>and</strong> sets the largest range to which the instrument will go while1234567891011121314151617181920212223242526SENSe:VOLTage 18-75


1997 SCPI Comm<strong>and</strong> Reference18autoranging. When AUTO is ON <strong>and</strong> the present RANGe is outside the new limits, theinstrument may change the RANGe to a value inside the limits or wait until the next time theautoranging algorithm is performed.At *RST, ULIMit shall be set to MAXimum.18.21.1.5.4 :OFFSet SENSe:VOLTage:AC:RANGe:OFFSetOFFSet determines the midpoint of the range.At *RST, this value is device-dependent.18.21.1.5.5 :PTPeak SENSe:VOLTage:AC:RANGe:PTPeakPeak To Peak specifies the dynamic range required for the sensor.At *RST, this value is device-dependent.18.21.1.6 :REFerence SENSe:VOLTage:AC:REFerenceSets a reference amplitude for sensor instruments. This comm<strong>and</strong> differs in intent from thereference correction in that this is intended to be a measurement offset where a user wishesto reference a measurement to some known value.At *RST, this value is device-dependent, but STATe is set to OFF.18.21.1.6.1 :STATe SENSe:VOLTage:AC:REFerence:STATeDetermines whether amplitude is measured in absolute or relative mode. If STATe is ON,then amplitude is referenced to the value set in REFerence.At *RST, this value is set to OFF.18.21.1.7 :RESolution SENSe:VOLTage:AC:RESolutionSpecifies the absolute resolution of the measurement. For example, if a measurement of 10Volts is specified with a resolution of .01 Volts, the measurement is returned with aresolution of .01 Volts (that is, 10.00).RANGe is not coupled to RESolution. Setting RANGe shall not cause RESolution tochange. Setting RESolution shall not cause RANGe to change.At *RST, this value is device-dependent.18.21.1.7.1 :AUTO |ONCESENSe:VOLTage:AC:RESolution:AUTOAllows the system to determine the best resolution for the other measurement conditions.Explicitly setting a value for :RESolution will turn AUTO OFF.At *RST, this value is set to ON.18-76 SENSe:VOLTage


1997 SCPI Comm<strong>and</strong> Reference18.21.2 :DETector INTernal | EXTernalSENSe:VOLTage:DETectorThe DETector can be specified as internal or external.At *RST, this value is set to INT.1234567891011121314151617181920212223242526SENSe:VOLTage 18-77


FL0051997 SCPI Comm<strong>and</strong> Reference1818.22 WINDow SubsystemSENSe:WINDowThe window subsystem selects digital signal processing windowing parameters for use byFFT analyzers. Windows are time-domain weighting functions applied to input time recordsto condition the results of a time-domain to frequency-domain transformation. Thissubsystem controls windowing done to compensate for measurement artifacts. Analyticalpost-acquisition windowing is controlled with CALCulate:TRANsform.KEYWORD PARAMETER FORM NOTES:WINDow[:TYPE]RECTangular subsystem|UNIForm|FLATtop subsystem|HAMMing|HANNing|KBESsel|FORCe|EXPonential:KBESsel :EXPonential :FORCe 18.22.1 [:TYPE] RECTangular|UNIForm|FLATtop|HAMMing|HANNing|KBESsel|FORCe|EXPonentialSENSe:WINDow:TYPETYPE allows user selection from among several well-known or st<strong>and</strong>ard window types.Each window has characteristics that make it particularly suitable for certain kinds ofmeasurements.Individual windowing algorithms are defined in “On the Use of Windows for HarmonicAnalysis with the Discrete Fourier Transform,” F. J. Harris, Proc of the IEEE, Vol. 66-1,January 1978, pp 51-83.AT *RST, this value is device-dependent.18.22.1.1 :KBESsel SENSe:WINDow:TYPE:KBESselEnters the exponential decay time constant which characterizes the KBESsel window. Theparameter to this comm<strong>and</strong> has units of seconds.At *RST, this value is device-dependent.18.22.1.2 :EXPonential SENSe:WINDow:TYPE:EXPonentialEnters the exponential decay time constant which characterizes the EXPonential window.The parameter to thids comm<strong>and</strong> has units of seconds.At *RST, this value is device-dependent.18.22.1.3 :FORCe SENSe:WINDow:TYPE:FORCeEnters the time value parameter corresponding to the width of the gated portion of the inputtime record for FORCe windows. The parameter of this comm<strong>and</strong> has units of seconds.At *RST, this value is device-dependent.18-78 SENSe:WINDow


1997 SCPI Comm<strong>and</strong> Reference19 SOURce SubsystemThe SOURce setup comm<strong>and</strong>s are divided into several sections. Each section or subsystemdeals with controls that directly affect device-specific settings of the device, <strong>and</strong> not thoserelated to the signal-oriented characteristics. These comm<strong>and</strong>s are referenced through theSOURCe node.The SOURce node may be optional in a particular device. The reason that the SOURce isoptional is to allow devices which are primarily sources to accept shorter comm<strong>and</strong>s. TheSOURce node cannot be optional if either SENSe or ROUTe is optional, since only one nodeat a given level may be optional. For example, a typical power supply may elect to make theSOURce node optional, since the most frequently used comm<strong>and</strong>s would be under theSOURce subsystem. If the power supply also contained either source or routingfunctionality, these would be controlled through their respective nodes; however, the SENSeor ROUTe nodes would be required. An optional node, such as SOURce, implies that thedevice shall accept <strong>and</strong> process comm<strong>and</strong>s with or without the optional node <strong>and</strong> have thesame result. That is, the device is required to accept the optional node, if sent, without error.In some instances, a source may contain subservient source or sensor functions. In suchcases, the additional subservient functionality shall be placed as SENSe or SOURcesubnodes under the SOURce subsystem. Further, no optional nodes (SENSe, SOURce orROUTe) are permitted if such subservient functionality exists in a device. Otherwiseconflicts in interpreting comm<strong>and</strong>s would occur, for example, between SOURce <strong>and</strong>[SENSe:]SOURce if the SENSe were allowed to be optional.CURRent, POWer, VOLTage, FREQuency, <strong>and</strong> RESistance contain several sets ofcomm<strong>and</strong>s which have complex couplings. This includes the sweep comm<strong>and</strong>s STARt,STOP, CENTer, <strong>and</strong> SPAN as one set, <strong>and</strong> AMPLitude, OFFSet, HIGH, <strong>and</strong> LOW asanother. Sending any one of a set singly will affect two others of the set. However, if two aresent in a single message unit, then these two should be set to the values specified <strong>and</strong> theother two changed. This is in accordance with the style guidelines <strong>and</strong> IEEE 488.2. STARt,STOP, CENTer, <strong>and</strong> SPAN must be implemented as a set. That is, if any one isimplemented, then all must be implemented.If the requested setting is unachievable given the other instrument settings, then an errormust be generated (-211 “settings conflict”). The device may resolve the conflict in adevice-dependent manner (for example, change STARt, STOP, CENTer, <strong>and</strong>/or SPAN) toresolve the error. Note that when more than one of the four sweep settings are received in thesame program message unit, the sweep will be determined by the last two received.The coupled comm<strong>and</strong>s may define comm<strong>and</strong>s as subnodes which alter these couplings. Thecomm<strong>and</strong> description will define how the couplings are altered. However, any comm<strong>and</strong>which alters couplings must default to the couplings described in this section as the *RSTcouplings.When CENTer or SPAN is changed the following couplings apply:SPAN = SPANCENTer = CENTer1234567891011121314151617181920212223242526SOURce: 19-1


1997 SCPI Comm<strong>and</strong> ReferenceSTOP = CENTer + (SPAN/2)STARt = CENTer - (SPAN/2)When STARt or STOP is changed the following couplings apply:STARt = STARtSTOP = STOPCENTer = (STARt + STOP)/2SPAN = STOP - STARtThe couplings above assume linear units in the sweep specified.HIGH, LOW, AMPLitude, <strong>and</strong> OFFSet have the same interactions described above forSTARt, STOP, CENTer, <strong>and</strong> SPAN.When AMPLitude or OFFSet is changed the following couplings apply:OFFSet = OFFSetAMPLitude = AMPLitudeHIGH = OFFSet + (AMPLitude/2)LOW = OFFSet - (AMPLitude/2)When HIGH or LOW is changed the following couplings apply:HIGH = HIGHLOW = LOWOFFSet = (HIGH + LOW)/2AMPLitude = HIGH - LOWFor CURRent, POWer, <strong>and</strong> VOLTage when ATTenuation:AUTO is ON a coupling existsbetween ATTenuation <strong>and</strong> LEVel. This coupling is needed in sources which use anattenuator to extend the dynamic range of the source’s level. Fig 19-1 illustrates this situation.When ATTenuator:AUTO is ON, the full dynamic range of the instrument is available usingthe LEVel comm<strong>and</strong>. The instrument uses an algorithm which adjusts both the the limiteddynamic range signal <strong>and</strong> the attenuator to supply the requested level.HP094HP09419Figure 19-1 ATTenuation - LEVel Coupling ModelWhen ATTenuation:AUTO is OFF, the amount of attenuation is fixed <strong>and</strong> the range ofallowed values for LEVel is reduced. The MINimum <strong>and</strong> MAXimum values for LEVeldepend on the value of ATTenuation.For example, assume an instrument has the block diagram illustrated in Fig 19-2.HP094HP09419-2 SOURce:


1997 SCPI Comm<strong>and</strong> ReferenceFigure 19-2 ATTenuation - LEVel Coupling ExampleSay the output of the amplifier can vary from -5dBm to 10dBm <strong>and</strong> the attenuator can rangefrom 0 to 50dB in steps of 10dB. The source’s level can thus vary from -55dBm to 10dBm.After *RST, POWer:ATTenuation:AUTO is ON allowing POWer:ATTenuation toautomatically change depending on POWer[:LEVel]. The allowable range forPOWer[:LEVel] is from -55dBm (MINimum) to 10dBm (MAXimum). If POWer[:LEVel] isset to -48dBm, POWer:ATTenuation is set to 50dB <strong>and</strong> the power level at the amplifier’soutput is 2dBm. If POWer[:LEVel] is -43dBm, the instrument could be in one of two states:POWer:ATTenuation is -40dB <strong>and</strong> amplifier’s level is -3dBm orPOWer:ATTenuation is -50dB <strong>and</strong> amplifier’s level is 7dBmWhich state is chosen may depend on the previous state of POWer[:LEVe]] <strong>and</strong> thealgorithm employed by the instrument.The user now wants to prevent the attenuator from changing values. POWer:ATTenuation-40 is sent. Receiving a value for POWer:ATTenuation has the side effect of turningPOWer:ATTenuation:AUTO OFF, see 7.4 in <strong>Syntax</strong> & <strong>Style</strong>. Because the attenuator cannotautomatically change, the allowable range for POWer[:LEVel] is limited to the range-45dBm (MINimum) to -30dBm (MAXimum). Trying to program a value outside this rangecauses an Execution Error. The permissable range for POWer[:LEVel] can be changed bysending a new value for POWer:ATTenuation.The actual algorithm employed in the instrument <strong>and</strong> the range of values depend on theunderlying hardware implementation. SCPI does require MAXimum/MINimum querieswhich a user could use to discover how the bounds of the LEVel comm<strong>and</strong> change.1234HP09456HP09478910 HP09411HP0941213HP0941415161718HP0941920212223242526SOURce: 19-3


HP051HP051HP051DTDTHP051HP051HP051HP051HP051HP0511997 SCPI Comm<strong>and</strong> ReferenceFirst Level SOURce Keywords[:SOURce]:AM:COMBine 1994HP051HP086:CORRection 1992 HP067:CURRent:DM:FM:FREQuency:FUNCtion:LIST:MARKer:PHASe:PM:POWer:PULM:PULSe:RESistance:ROSCillator:SWEep:TEMPerature 1993 XSS01c:VOLTageHP0511919-4 SOURce:


19.1 AM SubsystemSOURce:AMThe Amplitude Modulation subsystem is used to set the modulation controls <strong>and</strong> theparameters associated with the modulating signal(s). The keywords to describe the carriersignal exist in other subsystems (such as, FREQuency <strong>and</strong> PHASe).1KEYWORD PARAMETER FORM COMMENTS:AM2:COUPling AC|DC|GROund3[:DEPTh] :EXTernal4:COUPling AC|DC|GROund5:IMPedance :POLarity NORMal|INVerted6:INTernal7:FREQuency :MODE FIXed|LIST 1993 8EM003:POLarity NORMal|INVerted9:SENSitivity :SOURce EXTernal|INTernal{,EXTernal|,INTernal}10:STATe11:TYPE LINear|LOGarithmic|EXPonential 1991 HP019.1.1 :COUPling AC|DC|GROundSOURce:AM:COUPling1997 SCPI Comm<strong>and</strong> ReferenceCOUPling, at this level, is used to set the coupling between the modulator <strong>and</strong> themodulating signal. The modulating signal may be the sum of several signals, either internalor external sources. If COUPling is set to DC, then both AC <strong>and</strong> DC components of thesignal pass. AC coupling passes only the AC component of the signal. The GROundparameter allows Amplitude Modulation to be turned ON without the modulating signalconnected.At *RST, this value is device-dependent.19.1.2 [:DEPTh] SOURce:AM:DEPThSets the modulation DEPTh of an AM signal. The unit for DEPTh is percent (%). Thiscomm<strong>and</strong> is used where the DEPTh can be controlled independently from the modulatingsignal voltage level. Alternately, it is used to set a device capability that can indicate whenthe desired DEPTh has been achieved.At *RST, this value is device-dependent.19.1.3 :EXTernalSOURce:AM:EXTernalThe EXTernal subsystem is used to control the specified external signal source. Wheremultiple external modulation sources are available, the EXTernal keyword may have a121314151617181920212223242526SOURce:AM 19-5


1997 SCPI Comm<strong>and</strong> Reference19numeric suffix signifying the particular external signal source. If no number is given, a 1 isassumed.19.1.3.1 :COUPling AC|DC|GROundSOURce:AM:EXTernal:COUPlingCOUPling, at this level, sets the coupling for only the specified external signal source. IfCOUPling is set to DC, then both AC Modulation <strong>and</strong> DC components of the signal pass.AC coupling passes only the AC component of the signal. The GROund parameter allowsthe specified external source to be turned ON without being connected.At *RST, this value is device-dependent.19.1.3.2 :IMPedance SOURce:AM:EXTernal:IMPedanceSets the impedance of the specified external signal source. The unit for IMPedance is Ohms.At *RST, this value is device-dependent.19.1.3.3 :POLarity NORMal|INVertedSOURce:AM:EXTernal:POLarityPOLarity, at this level, sets the POLarity for only the specified external signal source.POLarity sets the relationship between the polarity of the applied modulation voltage <strong>and</strong> theresulting direction of modulation. The definition of “normal” polarity for AM modulatedsignal is: a positive voltage which causes the modulation envelope or the instantaneouscarrier amplitude to increase.At *RST, this value must be set to NORMal.19.1.4 :INTernalSOURce:AM:INTernalThe INTernal subsystem is used to control the specified internal signal source. Wheremultiple internal modulation sources are available, the INTernal keyword may have anumeric suffix signifying the particular internal signal source. If no number is given, a 1 isassumed.19.1.4.1 :FREQuency SOURce:AM:INTernal:FREQuencySets the frequency of the specified internal signal source. Some instruments may also allowthe internal signal source(s) to be controlled as a subsystem(s). The unit of FREQuency is Hz.At *RST, this value is device-dependent.19.1.5 :MODE EM003SOURce:AM:MODEDetermines which set of comm<strong>and</strong>s currently control the AM subsystem. The settings havethe following meanings:FIXed: Settings of individual comm<strong>and</strong>s are as last set by the user.LIST: Settings of individual comm<strong>and</strong>s are controlled by the LIST subsystem.19-6 SOURce:AM


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST the value is FIXed.19.1.6 :POLarity NORMal|INVertedSOURce:AM:POLarityPOLarity, at this level, is used to set the polarity between the modulator <strong>and</strong> the modulatingsignal. The modulating signal may be the sum of several signals, either internal or externalsources. POLarity sets the relationship between the polarity of the applied modulationvoltage <strong>and</strong> the resulting direction of modulation. The definition of “normal” polarity forAM modulated signal is a positive voltage, causing the modulation envelope or theinstantaneous carrier amplitude to increase.At *RST, this value must be set to NORMal.19.1.7 :SENSitivity SOURce:AM:SENSitivityControls the modulation depth by setting a sensitivity Modulation to the modulation signalvoltage level. The unit for SENSitivity is percent/Volt (%/V).At *RST, this value is device-dependent.19.1.8 :SOURce EXTernal|INTernal{,EXTernal|,INTernal}SOURce:AM:SOURceSelects the source for the modulating signal. It may specify a single source or a number ofsources. The specified sources, in the SOURce comm<strong>and</strong>, are all selected <strong>and</strong> turned on. Anysources from a previous selection that are not part of the current selection list are deselected<strong>and</strong> turned off. If multiple sources are selected <strong>and</strong> the device does not support thecombination requested in the SOURce comm<strong>and</strong>, an execution error -221 will be generated.Where multiple internal modulation sources are available, individual INTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.Where multiple external modulation sources are available, individual EXTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.At *RST, this value is device-dependent.19.1.9 :STATe SOURce:AM:STATeThis comm<strong>and</strong> is used to turn Amplitude Modulation ON or OFF. Turning AM modulationON will not automatically turn OFF any other types of modulation. Turning any or allmodulations types ON or OFF must be done explicitly. Where a type of modulation is active,turning ON another type of modulation will add to the set of active modulations if thatcombination of capabilities are legal in the device; otherwise, an execution error -221 isgenerated, <strong>and</strong> the instrument state is device-dependent.At *RST, this value must be set to OFF.1234567891011121314151617181920212223242526SOURce:AM 19-7


HP043Ed Change1997 SCPI Comm<strong>and</strong> Reference19.1.10 :TYPESOURce:AM:TYPEControls the type of AM shapingLINear – The output voltage is directly proportional to Vmod.LOGarithmic – The output voltage is proportional to log(Vmod).EXPonential – The output voltage is proportional to 10 (Vmod)At *RST the selection will be LINear.1919-8 SOURce:AM


1997 SCPI Comm<strong>and</strong> Reference19.2 COMBine SubsystemSOURce:COMBineThis subsystem is used to combine two or more signals or data streams into one.KEYWORD PARAMETER FORM COMMENTS:COMBine 1994:FEED 199419.2.1 :FEED Sets or queries the data flow into the COMBine block. The number of FEED in a :COMBineblock is device dependent.At *RST, FEED is device dependent.HP086HP086 1HP0862HP086 3HP0864HP086 567891011121314151617181920212223242526SOURce:COMBine 19-9


HP0671997 SCPI Comm<strong>and</strong> Reference19.3 CORRection SubsystemSOURce:CORRectionThe correction subsystem provides for known external losses or gains. In contrast toCALibration, these losses usually are dependent on individual setups.Correction data may be entered <strong>and</strong> stored in several ways. A mechanism is provided toautomatically measure the signal <strong>and</strong> store the resulting “correction set”. This data can beselected at any time as the active “correction set”. The data could also be generated by anexternal device <strong>and</strong> transferred to the instrument over a computer interface. Comm<strong>and</strong>s arealso provided to enter individual losses, gains, offsets, delays, etc. that the instrument shoulduse in correcting its operation. An instrument is not required to implement all of the methods.19KEYWORD PARAMETER FORM COMMENTS:CORRection 1992[:STATe] 1992:COLLect 1992[:ACQuire] 1992:METHod PMETer 1992:SAVE 1992:CSET 1992[:SELEct] 1992:STATe 1992:OFFSet 1992[:MAGNitude] 1992:PHASe 1992:STATe 1992:LOSS|GAIN|SLOPe 1992 HP075:STATe 1992[:OUTPut] 1992[:MAGNitude] 1992:PHASe 1992:EDELay 1992[:TIME] 1992:DISTance 1992:STATe 1992:RVELocity 1992:MEDIum COAX|WAVeguide 1992:COAX 1992:WAVeguide 1992:FCUToff 1992:STATe 199219.3.1 [:STATe] SOURce:CORRection:STATeDetermines whether the correction data defined in this section is applied to the signal.At *RST, this function is OFF.19-10 SOURce:CORRection


1997 SCPI Comm<strong>and</strong> Reference19.3.2 :COLLectSOURce:CORRection:COLLectDeals with the collection of the correction data by the device. Details may be device specific.19.3.2.1 [:ACQUire]SOURce:CORRection:COLLect:ACQUireA signal will be generated, measured, <strong>and</strong> the results saved as data for the chosen correctionmethod.19.3.2.2 :METHod PMETerSOURce:CORRection:COLLect:METHodSelects the correction method to be used for the correction that is about to be performed. Ifonly one correction method exists in the instrument then this comm<strong>and</strong> is not required.The various settings of the parameters have the following meanings:PMETer Use external Power METer to take readings.At *RST, this value is device dependent.19.3.2.3 :SAVE []SOURce:CORRection:COLLect:SAVECalculates the correction data using the current method selection <strong>and</strong> then saves thecorrection data. If only one correction array exists then it is saved there. Otherwise it is savedin the set specified by . may be either a , or a which must be defined <strong>and</strong> existin the instrument. Note this comm<strong>and</strong> will not create either , or a. Trace definition is done in the TRACe subsystem. Table definition is done inthe MEMory subsystem.19.3.3 :CSETSOURce:CORRection:CSETThe Correction SET subsystem is used to select the active correction set.19.3.3.1 [:SELect] SOURce:CORRection:CSET:SELectSpecifies the active correction set. This is the set that is used when CORR:CSET:STAT ONis specified.Note that the parameter is a that must be defined <strong>and</strong> exist in the instrument., or a which must be defined <strong>and</strong> exist in the instrument. Notethis comm<strong>and</strong> will not create either , or a . Trace definition isdone in the TRACe subsystem. Table definition is done in the MEMory subsystem.19.3.3.2 STATe SOURce:CORRection:CSET:STATeDetermines whether the correction data defined in the selected set is applied to the output.At *RST, this function is OFF. OFF is chosen because all of the correction sets may beempty. The instrument may need to be supplied with data before correction can be applied.1234567891011121314151617181920212223242526SOURce:CORRection 19-11


HP0751997 SCPI Comm<strong>and</strong> Reference19HP07519.3.4 :OFFSetSOURce:CORRection:OFFSetThis node defines a single value that is added to the signal supplied by the instrument. Thiscomm<strong>and</strong> shall be used with the currently selected units. Offset effects the signal values asadditive (or subtractive) for linear units such as VOLT.19.3.4.1 [:MAGNitude] SOURce:CORRection:OFFSet:MAGNitudeThis is the magnitude value of the correction offset data. Magnitude is always added linearly,as in volts.At *RST, this value is set to zero.19.3.4.2 :PHASe SOURce:CORRection:OFFSet:PHASeThis is the phase value of the correction offset data. The units associated with this are thecurrently selected angle units.At *RST, this value is set to zero.19.3.4.3 :STATe SOURce:CORRection:OFFSet:STATeThis function is used to enable or disable the offset correction.At *RST, this function is set to OFF.19.3.5 :LOSS|:GAIN|:SLOPe PH075SOURce:CORRection:LOSSThese comm<strong>and</strong>s are used either to provide a mechanism to apply simple correction or tocorrect external factors that have not been accounted for in the correction set.Loss, gain <strong>and</strong> slope affect the signal amplitude as a multiplier for linear units such as VOLT<strong>and</strong> as additive (or subtractive) for logarithmic units such as dB.:LOSS This comm<strong>and</strong> is used to set the anticipated loss in the system, excluding thosefactors covered by the active correction set. The device then adjusts the signal bythis factor to compensate for the loss. Loss is coupled to GAIN by the equationLOSS = 1/GAIN when the default unit is linear <strong>and</strong> LOSS =- GAIN when thedefault unit is logarithmetic.:GAIN This comm<strong>and</strong> is used to set the anticipated gain in the system, excluding thosefactors covered by the active correction set. The device then adjusts the signal bythis factor to compensate for the gain. Gain is coupled to LOSS by the equationGAIN = 1/LOSS when the default unit is linear <strong>and</strong> GAIN =- LOSS when thedefault unit is logarithmetic.:SLOPeThis node defines an increasing or decreasing value that is added to the signal.This correction value is zero at a zero value of the x axis <strong>and</strong> increase or decreasesfrom there.19-12 SOURce:CORRection


1997 SCPI Comm<strong>and</strong> Reference19.3.5.1 :STATe SOURce:CORRection:LOSS:STATeThis function is used to enable or disable the correction for LOSS or GAIN.At *RST, this function is set to OFF.19.3.5.2 [:OUTPut]SOURce:CORRection:LOSS:OUTPutThe OUPut node is used to reference measurements made at the instruments output.19.3.5.2.1 [:MAGNitude] SOURce:CORRection:LOSS:OUTPut:MAGNitudeThis is the magnitude value of the correction for LOSS, GAIN. The units asociated withLOSS <strong>and</strong> GAIN are the current relative amplitude units.At *RST, this value is set to zero.19.3.5.2.2 :PHASe SOURce:CORRection:LOSS:OUTPut:PHASeThis is the phase value of the correction for LOSS or GAIN. The units associated with thisare the currently selected angle units.At *RST, this value is set to zero.19.3.6 :EDELaySOURce:CORRection:EDELayThe Electrical DELay is used to compensate for delays in the signal path.This comm<strong>and</strong> is used to correct external factors that that have not been accounted for in thecorrection set.TIME <strong>and</strong> DISTance are coupled by the equation:TIME = RVELocity*DISTanceRVELocity is not coupled to either TIME or DISTance.19.3.6.1 [:TIME] SOURce:CORRection:EDELay:TIMEThis comm<strong>and</strong> will set the electrical delay with the time parameter given. The units for thiscommad are seconds. A value accepted here will modify the DISTance setting because theyare the same parameter in different forms.At *RST, the value of this setting is zero.19.3.6.2 :DISTance SOURce:CORRection:EDELay:DISTanceThis comm<strong>and</strong> will set the electrical delay with the distance parameter given. The effectivedelay will be computed using this parameter <strong>and</strong> the relative velocity set in the instrument.The units for this comm<strong>and</strong> are meters. A value accepted here will modify the time settingbecause they are the same parameter in different forms. Implementation of this comm<strong>and</strong>requires implementation of CORRection:EDELay[:TIME].1234567891011121314151617181920212223242526SOURce:CORRection 19-13


Ed Change1997 SCPI Comm<strong>and</strong> Reference19At *RST, the value of this setting is zero.19.3.6.3 :STATe SOURce:CORRection:EDELay:STATeThis function is used to enable or disable the correction for electrical delay.At *RST, this function is set to OFF.19.3.7 :RVELocitySOURce:CORRection:RVELocityThis comm<strong>and</strong> corrects for the relative velocity of the medium connecting to the DeviceUnder Test. This factor will be used in any delay corrections performed by the instrument.This comm<strong>and</strong> is used to correct external factors that that have not been accounted for in thecorrection set.TIME <strong>and</strong> DISTance are coupled by the equation:TIME=RVELocity*DISTanceRVELocity is not coupled to either TIME or DISTance.19.3.7.1 :MEDIum COAX|WAVeguideSOURce:CORRection:RVELocity:MEDIumThis comm<strong>and</strong> selects the method of correction for any operation that uses relative velocity.For example, for COAX a linear phase shift will be applied, but for WAVeguide (adispersive medium) a different phase shift is calculated.At *RST, this value is device dependent.19.3.7.2 :COAX SOURce:CORRection:RVELocity:COAXThis comm<strong>and</strong> sets the relative velocity for coaxial transmission lines. The parameter isunitless.At *RST, the value of this setting is one.19.3.7.3 :WAVeguide SOURce:CORRection:RVELocity:WAVeguideThis comm<strong>and</strong> sets the relative velocity factor for waveguide. The parameter is unitless.At *RST, the value of this setting is one.19.3.7.3.1 :FCUToff SOURce:CORRection:RVELocity:WAVeguide:FCUToffThis comm<strong>and</strong> specifies the frequency cutoff of the waveguide medium. The units are Hertz.At *RST, the value of this setting is device dependent19.3.7.4 :STATe SOURce:CORRection:RVELocity:STATeThis function is used to enable or disable the relative velocity correction.19-14 SOURce:CORRection


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, the value of this setting is OFF.1234567891011121314151617181920212223242526SOURce:CORRection 19-15


19.4 CURRent SubsystemSOURce:CURRent1997 SCPI Comm<strong>and</strong> ReferenceThis subsection controls the signal amplitude characteristics of the source.There is only one subsystem for each of the main amplitude characteristics of the signal.Thus, AC voltage <strong>and</strong> DC voltage are both placed under the VOLTage subsystem. A devicewhich implemented both simultaneously would implement them as two separate sources, oneAC <strong>and</strong> one DC.KEYWORD PARAMETER FORM COMMENTS:CURRent:ATTenuation :AUTO |ONCE:ALC[:STATe] :SEARch |ONCE:SOURce INTernal|DIODe|PMETer|MMHead:BANDwidth |:BWIDth:AUTO |ONCE:CENTer [:LEVel][:IMMediate][:AMPLitude] 19:AUTO |ONCE 1991 PH040:OFFSet :HIGH :LOW :TRIGgered[:AMPLitude] :OFFSet :HIGH :LOW HP066:LIMit[:AMPLitude] :OFFSet :HIGH :LOW :STATe :MANual :MODEFIXed|SWEep|LIST:PROTection[:LEVel] :STATe:TRIPped?[query only]19-16 SOURce:CURRent


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM COMMENTS:CLEar[no query]:RANGe :AUTO |ONCE:REFerence :STATe :SLEW:SPAN:HOLD :LINK CENTer|STARt|STOP:FULL[no query]:STARt:STOP19.4.1 :ATTenuation SOURce:CURRent:ATTenuationSets the ATTenuation level. Note that when increasing the level by 10 dB the magnitude ofthe outgoing signal as well as the LEVel will be decreased by 10 dB.Default units are as determined in the UNIT system. This is coupled to LEVel.19.4.1.1 :AUTO SOURce:CURRent:ATTenuation:AUTOCouples the attenuator to LEVel.Programming a specified attenuation sets AUTO OFF.See SOURce subsystem introduction for additional explanation.At *RST, AUTO is set to ON.19.4.2 :ALCSOURce:CURRent:ALCThis subsystem comm<strong>and</strong> controls the automatic leveling control of the source.19.4.2.1 [:STATe] SOURce:CURRent:ALC:STATeControls whether the ALC loop controls the output level.At *RST, this value is device-dependent.19.4.2.2 :SEARch |ONCESOURce:CURRent:ALC:SEARchSEARch enables a form of leveling where the output level is calibrated by momentarilyclosing the leveling loop. Once the correct amount of level adjustment has been determinedto produce the desired output level, the leveling loop is opened.When ON, the search routine will be done anytime the output level requires change (forexample, when LEVel is changed).1234567891011121314HP094151617181920212223242526SOURce:CURRent 19-17


1997 SCPI Comm<strong>and</strong> Reference19Selecting SEARch ONCE will have the effect of setting SEARch to ON <strong>and</strong> then OFF. Amodulator setting is determined by the system which will not be changed until the outputlevel is explicitly reprogrammed.At *RST, this value is set to OFF.19.4.2.3 :SOURce INTernal|DIODe|PMETer|MMHeadSOURce:CURRent:ALC:SOURceSelects the source of the feedback signal for ALC. The parameters have the followingmeanings:INTernal — The ALC feedback signal is measured from a point inside the source.DIODe — The ALC feedback is being fed from an external diode detector.PMETer — The ALC signal is coming from a power meter.MMHead — A millimeter head, with wuilt in leveling, is being used to supply theALC signal.At *RST, this value is INTernal.19.4.2.4 :BANDwidth|:BWIDth SOURce:CURRent:ALC:BANDwidthControls the b<strong>and</strong>width of the ALC feedback signal. This parameter is in units of Hz.At *RST, this value is device-dependent.19.4.2.4.1 :AUTO |ONCESOURce:CURRent:ALC:BANDwidth:AUTOCouples the b<strong>and</strong>width of the ALC feedback signal to instrument-dependent parameters.When AUTO is ON, the best b<strong>and</strong>width is chosen to reflect the current instrument state.Explicitly selecting a value for ALC:BANDwidth sets AUTO OFF.At *RST, this value is set to ON.19.4.3 :CENTer SOURce:CURRent:CENTerSets the center amplitude.At *RST, this value is set to MINimum.19.4.4 [:LEVel]SOURce:CURRent:LEVelThis subsystem is used to control the signal amplitude when the source is operating in acontinuous or FIXed MODE.19.4.4.1 [:IMMediate]SOURce:CURRent:LEVel:IMMediateIndicates that the subsequent specification of a new signal amplitude is to be processed bythe device without waiting for further comm<strong>and</strong>s.19-18 SOURce:CURRent


PH01997 SCPI Comm<strong>and</strong> Reference19.4.4.1.1 [:AMPLitude] SOURce:CURRent:LEVel:IMMediate:AMPLitudeSets the actual magnitude of the unswept output signal in terms of the current operatingunits. The units are set to the default value, or alternately to a different value under the UNITsubsystem. AMPLitude may be used to specify the level for either a time varying ornon-time varying signal.Note the optional nodes exist to enable CURRent to be directly followed by a. This is useful for programming simple devices in a straightforwardmanner.At *RST, the signal being sourced should be set to a “safe” condition. This is generallyachieved by setting the amplitude to its minimum value in conjunction with OUTPut:STATesubsystem.19.4.4.1.1.1 :AUTO |ONCESOURce:CURRent:LEVel:IMMediate:AMPLitude:AUTOIf AUTO ON is selected, the voltage setting will be adjusted automatically when a newcurrent setting (with the existing voltage setting) exceeds the maximum power limit. IfAUTO OFF is selected a new current setting will cause an execution error -221 (Settingsconflict), <strong>and</strong> the instrument state is device dependent when the maximum power limit isexceeded.*RST condition: AUTO OFF19.4.4.1.2 :OFFSet SOURce:CURRent:LEVel:IMMediate:OFFSetSets the non-time varying component of the signal that is added to the time varying signalspecified in AMPLitude, in terms of the current operating units. The units are set to thedefault value, or alternately to a different value under the UNIT subsystem. WhenSOURce:FUNCtion is DC, the effect of the OFFSet is device-dependent.At *RST, the signal being sourced should be set to a “safe” condition. This is generallyachieved by setting the offset to its minimum value in conjunction with OUTPut:STATesubsystem.19.4.4.1.3 :HIGH SOURce:CURRent:LEVel:IMMediate:HIGHSets the more positive peak of a time varying signal. It is used in conjunction with LOW.At *RST, the signal being sourced should be set to a “safe” condition. This is achieved bysetting this to a minimum value in conjunction with OUTPut:STATe subsystem.19.4.4.1.4 :LOW SOURce:CURRent:LEVel:IMMediate:LOWSets the more negative peak of a time varying signal, it is used in conjunction with HIGH.At *RST, the signal being sourced should be set to a “safe” condition. This is achieved bysetting this to a minimum value in conjunction with OUTPut:STATe subsystem.1234567891011121314151617181920212223242526SOURce:CURRent 19-19


1997 SCPI Comm<strong>and</strong> Reference1919.4.4.2 :TRIGgeredSOURce:CURRent:LEVel:TRIGgeredIndicates that subsequent specification of a new signal amplitude is to be transferred to theIMMediate value upon receipt of a trigger signal.At *RST, after the receipt of an ABORt comm<strong>and</strong> or upon being triggered, the value in theTRIGgered subsystem tracks the values in the IMMediate subsystem until a comm<strong>and</strong> in theTRIGgered subsystem is received. The purpose of tracking is so that spurious triggers do notchange the value of LEVel unexpectedly.19.4.4.2.1 [:AMPLitude] SOURce:CURRent:LEVel:TRIGgered:AMPLitudeSets the actual magnitude of the unswept output signal in terms of the current operatingunits. The units are set to the default value, or alternately to a different value under the UNITsubsystem. AMPLitude may be used to specify the level for either a time varying ornon-time varying signal.19.4.4.2.2 :OFFSet SOURce:CURRent:LEVel:TRIGgered:OFFSetSets the non-time varying component of the signal that is added to the time varying signalspecified in AMPLitude. The units are set to the default value, or to a different value underthe UNIT subsystem. When SOURce:FUNCtion is DC, the effect of OFFSet isdevice-dependent.19.4.4.2.3 :HIGH SOURce:CURRent:LEVel:TRIGgered:HIGHThis comm<strong>and</strong> is used to set the more positive peak of a time varying signal. It is used inconjunction with LOW.19.4.4.2.4 :LOW SOURce:CURRent:LEVel:TRIGgered:LOWThis comm<strong>and</strong> is used to set the more negative peak of a time varying signal. It is used inconjunction with HIGH.19.4.5 :LIMitSOURce:CURRent:LIMitSets the maximum bounds on the output value. Setting a larger value will cause the outputlevel to be clamped to the LIMit value.19.4.5.1 [:AMPLitude] SOURce:CURRent:LIMit:AMPLitudeSets the limit on the actual magnitude of the unswept output signal in terms of the currentoperating units. The units are set to the default value, or alternately to a different value underthe UNIT subsystem. AMPLitude may be used to specify the level for either a time varyingor non-time varying signal. OFFSet may only be used with AMPLitude, where AMPLitudeis used to specify a time varying load.19-20 SOURce:CURRent


1997 SCPI Comm<strong>and</strong> ReferenceExplicit reference to the AMPLitude node is optional. Any device that implements thissubsystem must accept <strong>and</strong> process comm<strong>and</strong>s, with or without the AMPLitude node, <strong>and</strong>respond to them in the same way.At *RST, this value is device-dependent.19.4.5.2 :OFFSet SOURce:CURRent:LIMit:OFFSetSets a non-time varying component limit of signal that is added to the time varying signalspecified in AMPLitude. The units are set to the default value, alternately to a different valueunder the UNIT subsystem.At *RST, this value is device-dependent.19.4.5.3 :HIGH SOURce:CURRent:LIMit:HIGHSets the more positive peak limit of a time varying signal, it is used in conjunction withLOW.At *RST, this value is device-dependent.19.4.5.4 :LOW SOURce:CURRent:LIMit:LOWSets the more negative peak limit of a time varying signal, it is used in conjunction withHIGH.At *RST, this value is device-dependent.19.4.5.5 :STATe SOURce:CURRent:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.19.4.6 :MANual SOURce:CURRent:MANualAllows manual adjustment of the amplitude between the sweep limits. The actual amplitudelevel is determined by the parameter only if SWEep:MODE is set to MANual <strong>and</strong> theamplitude MODE is set to SWEep. If the sweep limits are changed such that the manualamplitude value would be outside the limits, the manual amplitude value will be set to thenearest limit.At *RST, this value is device-dependent.19.4.7 :MODE FIXed|SWEep|LISTSOURce:CURRent:MODEDetermines which set of comm<strong>and</strong>s control the amplitude subsystem. If FIXed is selected,the amplitude is determined by the LEVel comm<strong>and</strong> under the appropriate subsystem. IfSWEep is selected, the source is in the swept mode <strong>and</strong> amplitude is determined by STARt,STOP, CENTer, SPAN, <strong>and</strong> MANual comm<strong>and</strong>s under the appropriate subsystem. If LIST is1234567891011121314151617181920212223242526SOURce:CURRent 19-21


1997 SCPI Comm<strong>and</strong> Reference19selected, the amplitude values are determined by the appropriate amplitude list (such asLIST:).At *RST, this value is set to FIXed.19.4.8 :PROTectionSOURce:CURRent:PROTectionControls the protection circuits.19.4.8.1 [:LEVel] SOURce:CURRent:PROTection:LEVelThis comm<strong>and</strong> sets the output level at which the output protection circuit will trip.19.4.8.2 :STATe SOURce:CURRent:PROTection:STATeControls whether the output protection circuit is enabled.At *RST, this value is set to ON.19.4.8.3 :TRIPped?SOURce:CURRent:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped.TRIPped only has a query form <strong>and</strong> thus has no associated *RST condition.19.4.8.4 :CLEarSOURce:CURRent:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.19.4.9 :RANGe SOURce:CURRent:RANGeSets a range for the output amplitude. This comm<strong>and</strong> is very hardware-specific.19.4.9.1 :AUTO |ONCESOURce:CURRent:RANGe:AUTOCouples the RANGe to an instrument-determined value. When AUTO is ON, the best rangeis chosen to reflect the current instrument state.Explicitly selecting a value for RANGe sets AUTO OFF.At *RST, this value is set to ON.19.4.10 :REFerence SOURce:CURRent:REFerenceSets a reference value which, if STATe is ON, allows all amplitude parameters to bequeried/set as relative to the reference value.At *RST, this value is device-dependent.19-22 SOURce:CURRent


HP01997 SCPI Comm<strong>and</strong> Reference19.4.10.1 :STATe SOURce:CURRent:REFerence:STATeDetermines whether amplitude is measured/output in absolute or relative mode. If STATe isON, then amplitude is referenced to the value set in REFerence.At *RST, this value is set to OFF.19.4.11 :SLEW SOURce:CURRent:SLEWSets the slew rate of the output change when a new output level is programmed. The unitsare in (the currently active) amplitude unit/sec.At *RST, this value is device-dependent.19.4.12 :SPAN SOURce:CURRent:SPANSets the amplitude span. If the current amplitude unit is logarithmic (dBm, dBuV, etc), thenthe unit of SPAN is dB. Otherwise SPAN is programmed in the current amplitude unit.At *RST, this value is set to 0.19.4.12.1 :FULLSOURce:CURRent:SPAN:FULLWhen this comm<strong>and</strong> is received, STARt amplitude is set to its minimum value <strong>and</strong> STOPamplitude is set to its maximum value. CENTer amplitude <strong>and</strong> SPAN are set to their coupledvalues.This comm<strong>and</strong> is an event rather than a state. Therefore it has no associated query, ormeaning at *RST.19.4.12.2 :HOLD SOURce:CURRent:SPAN:HOLDProvides a mechanism to prevent the SPAN from being changed implicitly by the definedcoupling between STARt, STOP, CENTer <strong>and</strong> SPAN. When HOLD is set to ON, SPANshall only be changed by explicitly sending the SPAN comm<strong>and</strong>.At *RST, this value is set to OFF.19.4.12.3 :LINK CENTer|STARt|STOPSOURce:CURRent:SPAN:LINKAllows the default couplings for SPAN to be overridden. LINK selects the parameter, eitherCENTer, STARt or STOP, that shall not be changed when SPAN’s value is changed. Forexample, if LINK is set to STARt then changing SPAN shall cause CENTer <strong>and</strong> STOP, notSTARt to change.At *RST, this value is set to CENTer, to be compatible with the default definition for thecouplings.19.4.13 :STARt SOURce:CURRent:STARtSets STARt amplitude.SOURce:CURRent 19-231234567891011121314151617181920212223242526


At *RST, this value is set to MINimum.19.4.14 :STOP SOURce:CURRent:STOPSets STOP amplitude.At *RST, this value is set to MINimum.1997 SCPI Comm<strong>and</strong> Reference1919-24 SOURce:CURRent


1997 SCPI Comm<strong>and</strong> Reference19.5 DM SubsystemSOURce:DMThe Digital Modulation subsystem is used to set the modulation controls <strong>and</strong> the parametersassociated with the modulating signal(s). This modulation embraces a number of digitalmodulation techniques, which are described in the general terms of I <strong>and</strong> Q components. Thekeywords to describe the carrier signal exist in other subsystems (such as, FREQuency <strong>and</strong>PHASe).KEYWORD PARAMETER FORM COMMENTS:DM:FORMat BPSK|PSK2|QPSK|PSK4|PSK8|QAM16|QAM64|QAM256|QAM1024|PRS9|PRS25|PRS49|PRS81:STATe:SOURce EXTernal|PRBS|CALibrate:FILTer[:SOURce] INTernal|EXTernal:ICORrection :QCORrection :IQRatio:STATe [:MAGNitude] :LEAKage:STATe [:MAGNitude] :ANGLe :QUADrature:STATe :ANGLe :COUPling[:ALL] AC|DC|GROund:DATA AC|DC|GROund:CLOCk AC|DC|GROund:THReshold[:ALL] :DATA :CLOCk :DMODe SERial|PARallel:FRAMe:SOURce INTernal|EXTernal:POLarity[:ALL] NORMal|INVerted:INORMal|INVerted:Q NORMal|INVerted:ICLock NORMal|INVerted:QCLock NORMal|INVerted1234567891011121314151617181920212223242526SOURce:DM 19-25


1997 SCPI Comm<strong>and</strong> Reference19KEYWORD PARAMETER FORM COMMENTS:CLOCk:SOURce NONE|EXTernal19.5.1 :FORMat SOURce:DM:FORMatSets the format type to be employed. It is exp<strong>and</strong>able to any PRS, QAM, QPR orPSK. QPSK is an alias for PSK4 <strong>and</strong> BPSK is an alias for PSK2.At *RST, this value is device-dependent.19.5.2 :STATe SOURce:DM:STATeTurns the digital modulation subsystem ON or OFF. Turning digital modulation ON will notautomatically turn OFF any other types of modulation. Turning any or all modulations typesON or OFF must be done explicitly. Where a type of modulation is active, turning ONanother type of modulation will add to the set of active modulations if that combination ofcapabilities are legal in the device. Otherwise, an execution error -221 is generated <strong>and</strong> theinstrument state is left undefined.At *RST, this value must be set to OFF.19.5.3 :SOURce EXTernal|PRBS|CALibrateSOURce:DM:SOURceSets the source of digital modulation data. EXTernal means the digital data comes inexternally. The data can be also generated internally with PRBS (a pseudo-r<strong>and</strong>om bitsequencer). CALibrate is a service feature for calibrating the baseb<strong>and</strong> of the device.At *RST, this value must be set to EXTernal.19.5.4 :FILTerSOURce:DM:FILTerThis subsystem is used to control the I <strong>and</strong> Q filters.19.5.4.1 [:SOURce] INTernal|EXTernalSOURce:DM:FILTer:SOURceThis mnemonic allows a choice between INTernal or EXTernal I <strong>and</strong> Q filters.At *RST, this value must be set to INTernal.19.5.4.2 :ICORrection SOURce:DM:FILTer:ICORrectionThis mnemonic allows the entry of gain information about the EXTernal I filter. This has noeffect on the signal when INTernal filter source is selected.AT *RST, this value must be set to 0.0DB.19.5.4.3 :QCORrection SOURce:DM:FILTer:QCORrectionThis mnemonic allows the entry of gain information about the EXTernal Q filter. This has noeffect on the signal when INTernal filter source is selected.19-26 SOURce:DM


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value must be set to 0.0DB.19.5.5 :IQRatioSOURce:DM:IQRatioThis subsystem controls the gain imbalance between the I <strong>and</strong> Q channels.19.5.5.1 :STATe SOURce:DM:IQRatio:STATeTurns ON <strong>and</strong> OFF the gain imbalance correction.At *RST, this value must be set to OFF.19.5.5.2 [:MAGNitude] SOURce:DM:IQRatio:MAGNitudeSpecifies the correction for the gain imbalance between the I <strong>and</strong> Q channels. This value isequal to I/Q.At *RST, this value must be set to 0.0DB.19.5.6 :LEAKageSOURce:DM:LEAKageCarrier leakage is an offset added to the modulation pattern. Carrier leakage is measured asthe magnitude relative to the full scale of the original signal. Hence a carrier leakagemagnitude of 0dB would mean that the offset in the signal would be 1 full scale. Thissubsystem allows specification of the carrier leakage in angle-magnitude notation.19.5.6.1 :STATe SOURce:DM:LEAKage:STATeThis comm<strong>and</strong> turns carrier leakage ON <strong>and</strong> off.At *RST, this value must be set to OFF.19.5.6.2 [:MAGNitude] SOURce:DM:LEAKage:MAGNitudeSpecifies the magnitude of carrier leakage relative to the full scale of the signal. 0.0dBmeans add 1 full scale of carrier leakage. 40dB would mean add (full scale - 40) amount ofdBm.At *RST, this value is device-dependent.19.5.6.3 :ANGLe SOURce:DM:LEAKage:ANGLeSpecifies the angle of carrier leakage.At *RST, this value is device-dependent.19.5.7 :QUADratureSOURce:DM:QUADratureThis subsystem controls quadrature correction.1234567891011121314151617181920212223242526SOURce:DM 19-27


1997 SCPI Comm<strong>and</strong> Reference1919.5.7.1 :STATe SOURce:DM:QUADrature:STATeTurns ON or OFF the quadrature angle correction.At *RST, this value must be set to OFF.19.5.7.2 :ANGLe SOURce:DM:QUADrature:ANGLeSpecifies the angle of quadrature correction.At *RST, this value must be set to 0.0DEG.19.5.8 :COUPlingSOURce:DM:COUPlingThis subsystem controls the input coupling for the digital modulation inputs.19.5.8.1 [:ALL] AC|DC|GROundSOURce:DM:COUPling:ALLSets the coupling of both the clock <strong>and</strong> data inputs to the instrument. This comm<strong>and</strong> is anevent, <strong>and</strong> therefore does not have an associated *RST condition19.5.8.2 :DATA AC|DC|GROundSOURce:DM:COUPling:DATASets the coupling of the data inputs to the instrument.At *RST, this value is device-dependent.19.5.8.3 :CLOCk AC|DC|GROundSOURce:DM:COUPling:CLOCkSets the coupling of the clock inputs to the instrument.At *RST, this value is device-dependent.19.5.9 :THResholdSOURce:DM:THResholdThis subsystem controls the detector thresholds for the digital modulation inputs.19.5.9.1 [:ALL] SOURce:DM:THReshold:ALLSets the threshold of both the clock <strong>and</strong> data inputs to the instrument.19.5.9.2 :DATA SOURce:DM:THReshold:DATASets the threshold of the data inputs to the instrument.At *RST, this value is device-dependent.19.5.9.3 :CLOCk SOURce:DM:THReshold:CLOCkSets the threshold of the clock inputs to the instrument.At *RST, this value is device-dependent.19-28 SOURce:DM


1997 SCPI Comm<strong>and</strong> Reference19.5.10 :DMODe SERial|PARallelSOURce:DM:DMODeThis comm<strong>and</strong> sets the data transfer mode. SERial means data is transferred serially <strong>and</strong>PARallel means the data is transferred in a parallel fashion.At *RST, this value is device-dependent.19.5.11 :FRAMeSOURce:DM:FRAMeThis subsystem controls the framing for serialized digital modulation.19.5.11.1 :SOURce INTernal|EXTernalSOURce:DM:FRAMe:SOURceSelects the source frame when data is transferred serially. INTernal selects autoframing,while EXTernal selects user-supplied framing.19.5.12 :POLarity [:ALL] NORMal|INVertedSOURce:DM:POLaritySets the polarity of all the clock <strong>and</strong> data inputs to the instrument.19.5.12.1 :I NORMal|INVertedSOURce:DM:POLarity NORMal:ISelects the polarity of data inputs for the I channel. selects which data input where n canbe any number from 0-1 (largest DM format log4). For example, the range for n is 0-4 whenthe most complex mod format allowed is QAM1024.At *RST, all I polarities must be set to NORM.19.5.12.2 :Q NORMal|INVertedSOURce:DM:POLarity NORMal:QSelects the polarity of data inputs for the Q channel. selects which data input where ncan be any number from 0-1 (largest DM format log4). For example, the range for n is 0-4when the most complex mod format allowed is QAM1024.At *RST, all Q polarities must be set to NORM.19.5.12.3 :ICLock NORMal|INVertedSOURce:DM:POLarity NORMal:ICLockSelects the polarity of the I channel clock input.At *RST, ICLock polarity must be set to NORM.19.5.12.4 :QCLock NORMal|INVertedSOURce:DM:POLarity NORMal:QCLockSelects the polarity of the Q channel clock input.At *RST, QCLock polarity must be set to NORM.19.5.13 :CLOCkSOURce:DM:CLOCkThis subsystem controls the clock for digital modulation.1234567891011121314151617181920212223242526SOURce:DM 19-29


1997 SCPI Comm<strong>and</strong> Reference19.5.13.1 :SOURce NONE|INTernal|EXTernalSOURce:DM:CLOCk:SOURceSelects either no clock (asynchronous operation) or external clocking.At *RST, this value is device-dependent.1919-30 SOURce:DM


1997 SCPI Comm<strong>and</strong> Reference19.6 FM SubsystemSOURce:FMThe Frequency Modulation subsystem is used to set the modulation controls <strong>and</strong> theparameters associated with the modulating signal(s). The keywords to describe the carriersignal exist in other subsystems (such as FREQuency <strong>and</strong> PHASe).KEYWORD PARAMETER FORM COMMENTS:FM:COUPling AC|DC|GROund[:DEViation] :EXTernal:COUPling AC|DC|GROund:IMPedance :POLarity NORMal|INVerted:INTernal:FREQuency :MODELOCKed|UNLocked:POLarity NORMal|INVerted:SENSitivity :SOURce EXTernal|INTernal{,EXTernal|,INTernal}:STATe19.6.1 :COUPling AC|DC|GROundSOURce:FM:COUPlingCOUPling at this level is used to set the coupling between the modulator <strong>and</strong> the modulatingsignal. The modulating signal may be the sum of several signals, either as internal or externalsources. If COUPling is set to DC, then both AC <strong>and</strong> DC components of the signal pass. ACcoupling passes only the AC component of the signal. The GROund parameter allows themodulation to be turned ON without the modulating signal connected.At *RST, this value is device-dependent.19.6.2 [:DEViation] SOURce:FM:DEViationSets the modulation DEViation of an FM signal. The unit for DEViation is Hertz (Hz). Thiscomm<strong>and</strong> is used where the DEViation can be controlled independently from the modulatingsignal voltage level. Alternatively, it is used to set a device capability that can indicate whenthe desired DEViation has been achieved.At *RST, this value is device-dependent.19.6.3 :EXTernalSOURce:FMwEXTernalControls the specified external signal source. Where multiple external modulation sourcesare available, the EXTernal keyword may have a numeric suffix signifying the particularexternal signal source. If no number is given, a 1 is assumed.1234567891011121314151617181920212223242526SOURce:FM 19-31


1997 SCPI Comm<strong>and</strong> Reference1919.6.3.1 :COUPling AC|DC|GROundSOURce:FM:EXTernal:COUPlingCOUPling at this level sets the coupling for only the specified external signal source. IfCOUPling is set to DC, then both AC <strong>and</strong> DC Modulation components of the signal pass.AC coupling passes only the AC component of the signal. The GROund parameter allowsthe specified external source to be turned ON without being connected.At *RST, this value is device-dependent.19.6.3.2 :IMPedance SOURce:FM:EXTernal:IMPedanceSets the impedance of the specified external signal source. The units for IMPedance is Ohms.At *RST, this value is device-dependent.19.6.3.3 :POLarity NORMal|INVertedSOURce:FM:EXTernal:POLarityPOLarity at this level sets the POLarity for only the specified external signal source.POLarity sets the relationship between the polarity of the applied modulation voltage <strong>and</strong> theresulting “direction” of modulation. The definition of “normal” polarity for FM modulatedsignal is a positive voltage which causes the instantaneous output frequency to increase.At *RST, this value must be set to NORMal on.19.6.4 :INTernalSOURce:FM:INTernalThe INTernal subsystem is used to control the specified internal signal source. Wheremultiple internal modulation sources are available, the INTernal keyword may have anumeric suffix signifying the particular internal signal source. If no number is given, a 1 isassumed.19.6.4.1 :FREQuency SOURce:FM:INTernal:FREQuencySets the frequency of the specified internal signal source. Some instruments may also allowthe internal signal source(s) to be controlled as a subsystem(s). The unit of FREQuency isHertz (Hz).At *RST, this value is device-dependent.19.6.5 :MODE LOCKed|UNLockedSOURce:FM:MODESets the synthesis mode employed in generating the FM signal. If MODE is set to LOCKedthen a PLL is used, in synthesizing the FM signal, to prevent frequency drift. If UNLockedthe phase locked loop is inactive.At *RST, this value is device-dependent.19-32 SOURce:FM


1997 SCPI Comm<strong>and</strong> Reference19.6.6 :POLarity NORMal|INVertedSOURce:FM:POLarityPOLarity, at this level, is used to set the polarity between the modulator <strong>and</strong> the modulatingsignal. The modulating signal may be the sum of several signals, either as internal or externalsources. POLarity sets the relationship between the polarity of the applied modulationvoltage <strong>and</strong> the resulting “direction” of modulation. The definition of “normal” polarity forFM modulated signal is that a positive voltage causes the instantaneous output frequency toincrease.At *RST, this value must be set to NORMal.19.6.7 :SENSitivity SOURce:FM:SENSitivityControls the modulation deviation by setting a sensitivity Modulation to the modulationsignal voltage level. The unit for SENSitivity is Hertz/Volt (Hz/V).At *RST, this value is device-dependent.19.6.8 :SOURce EXTernal|INTernal{,EXTernal|,INTernal}SOURce:FM:SOURceSelects the source for the modulating signal, <strong>and</strong> it may specify a single source or a numberof sources. The specified sources, in the SOURce comm<strong>and</strong>, are all selected <strong>and</strong> turned on.Any sources from a previous selection that are not in the current selection list are deselected<strong>and</strong> turned off. If multiple sources are selected <strong>and</strong> the device does not support thecombination requested in the SOURce comm<strong>and</strong>, an execution error -221 must be generated.Where multiple internal modulation sources are available, individual INTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.Where multiple external modulation sources are available, individual EXTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.At *RST, this value is device-dependent.19.6.9 :STATe SOURce:FM:STATeTurns frequency modulation ON or OFF. Turning FM ON will not automatically turn OFFany other types of modulation. Turning any or all modulations types ON or OFF must bedone explicitly. Where a type of modulation is active turning ON another type ofmodulation, will add to the set of active modulations if that combination of capabilities arelegal in the device. Otherwise, an execution error -221 is generated, <strong>and</strong> the instrument stateis device-dependent.At *RST, this value must be set to OFF.1234567891011121314151617181920212223242526SOURce:FM 19-33


19.7 FREQuency SubsystemSOURce:FREQuency1997 SCPI Comm<strong>and</strong> ReferenceThe FREQuency subsystem controls the frequency characteristics of the instrument. Twotypes of controls are included in this subsystem. The first is frequency sensor controls, suchas RANGe. The second is frequency sweep controls such as STARt, or tuning controls suchas CW.KEYWORD PARAMETER FORM COMMENTS:FREQuency:CENTer [:CW|:FIXed] :AUTO |ONCE:MANual :MODECW|FIXed|SWEep|LIST|SENSe:MULTiplier :OFFSet:RESolution 1992 RS00119:AUTO | ONCE 1992 RS001:SPAN:FULL[no query]:HOLD :LINK CENTer|STARt|STOP:STARt:STOP19.7.1 :CENTer SOURce:FREQuency:CENTerSets the CENTer frequency.At *RST, this function will be set to (MINimum+MAX)/2.19.7.2 [:CW|:FIXed] SOURce:FREQuency:CWThe Continuous Wave or FIXed node is used to select a frequency of a non-swept signal.This node is optional. An optional node, such as [:CW|:FIXed], implies that the device shallaccept <strong>and</strong> process comm<strong>and</strong>s with or without the optional node <strong>and</strong> have the same result.That is, the device is required to accept the optional node, if sent, without error. A devicemust accept both :CW <strong>and</strong> :FIXed if it implements this node.At *RST, this value is device-dependent.19.7.2.1 :AUTO |ONCESOURce:FREQuency:CW:AUTOCouples the CW frequency to center frequency. Explicitly setting a value forFREQuency:CW sets AUTO OFF.At *RST, this value is set to ON.19-34 SOURce:FREQuency


Ed chan1997 SCPI Comm<strong>and</strong> Reference19.7.3 :MANual SOURce:FREQuency:MANualSame as CW except limited by STARt <strong>and</strong> STOP. Receipt of this comm<strong>and</strong> will only changethe frequency if SWEep:MODE MANual subsystem <strong>and</strong> FREQuency:MODE SWEep isselected. If the sweep limits are changed such that manual frequency would be outside thesweep limits, then the manual frequency will be set to the nearest end point of the sweep.At *RST, FREQuency:MAN is device-dependent.19.7.4 :MODE CW|FIXed|SWEep|LIST|SENSeSOURce:FREQuency:MODEDetermines which set of comm<strong>and</strong>s control the frequency subsystem. The settings have thefollowing meanings:CW|FIXed: The frequency is determined by FREQuency[:CW] orFREQuency[:FIXed]. CW <strong>and</strong> FIXed are aliases. Both must be implemented, ifeither is implemented.SWEep: The source is in the swept mode <strong>and</strong> frequency is determined byFREQuency:STARt, STOP, CENT, SPAN, <strong>and</strong> MAN.LIST: The source is in LIST sequence mode <strong>and</strong> frequency is determined byLIST:FREQuency.SENSe: The source is coupled to the sensor. All frequency controls aredetermined by the SENSe:FREQuency block, except for OFFSet <strong>and</strong> MULTiplier.These two comm<strong>and</strong>s remain active under SOURce to allow for offset <strong>and</strong>harmonic tracking.At *RST, this value is set to CW.19.7.5 :MULTiplier SOURce:FREQuency:MULTiplierSets a reference multiplier for all other frequency settings in the instrument. All entered <strong>and</strong>displayed frequencies are affected by this comm<strong>and</strong>. The coupling equation is:Entered|Displayed frequency = ( Hardware frequency * multiplier ) + offsetThis comm<strong>and</strong> affects the values of all functions which affect generation of the signal. Thisincludes such things as CW frequency <strong>and</strong> the sweep frequency controls. It does not affectthings like input filter b<strong>and</strong>widths. It does affect the settings of relative frequency parameterssuch as delta markers or FM deviation. Also note that this comm<strong>and</strong> does not affect thehardware settings of the instrument, but only the entered <strong>and</strong> displayed frequencies.At *RST, this value is set to 1.19.7.6 :OFFSet SOURce:FREQuency:OFFSetSets a reference frequency for all other absolute frequency settings in the instrument. Thiscomm<strong>and</strong> affects the values of all functions which affect generation of the signal. Thisincludes such things as CW frequency <strong>and</strong> the sweep frequency controls. It does not affect1234567891011121314151617181920212223242526SOURce:FREQuency 19-35


RS001RS0011997 SCPI Comm<strong>and</strong> Referencethings like input filter b<strong>and</strong>widths. It also does not affect the settings of relative frequencyparameters such as delta markers or FM deviation. Also note that this comm<strong>and</strong> does notaffect the hardware settings of the instrument, but only the entered <strong>and</strong> displayedfrequencies. The coupling equation is:Entered|Displayed frequency = ( Hardware frequency * multiplier ) + offsetAt *RST, this value is set to 0.19.7.7 :RESolution SOURce:FREQuency:RESolutionRESolution sets or queries the absolute increment/decrement, at which the frequency of theoutput signal can be changed. The default unit for is Hertz.At *RST, this value is device-dependent.19.7.7.1 AUTO | ONCESOURce:FREQuency:RESolution:AUTOAUTO couples the RESolution to an instrument-determined value. When AUTO is ON, thebest resolution is chosen to reflect the current instrument state.Explicitly selecting a value for RESolution will set AUTO OFF.At *RST, this value is set to ON.19.7.8 :SPAN SOURce:FREQuency:SPANSets the frequency SPAN.At *RST, this function will be set to MAXimum.19.7.8.1 :FULLSOURce:FREQuency:SPAN:FULLWhen this comm<strong>and</strong> is received, STARt frequency is set to its minimum value, <strong>and</strong> STOPfrequency is set to its maximum value. CENTer frequency <strong>and</strong> SPAN are set to their coupledvalues.19This comm<strong>and</strong> is an event, rather than a state. Therefore it has no associated query, ormeaning at *RST.19.7.8.2 :HOLD SOURce:FREQuency:SPAN:HOLDThe HOLD comm<strong>and</strong> provides a mechanism to prevent the SPAN from being changedimplicitly by the defined coupling between STARt, STOP, CENTer, <strong>and</strong> SPAN. WhenHOLD is set to ON, SPAN shall only be changed by explicitly sending the SPAN comm<strong>and</strong>.At *RST, this value is set to OFF.19.7.8.3 :LINK CENTer|STARt|STOPSOURce:FREQuency:SPAN:LINKThis comm<strong>and</strong> allows the default couplings for SPAN to be overridden. LINK selects theparameter, either CENTer subsystem, STARt or STOP, that shall not be changed when19-36 SOURce:FREQuency


1997 SCPI Comm<strong>and</strong> ReferenceSPAN’s value is changed. For example, if LINK is set to STARt then changing SPAN shallcause CENTer <strong>and</strong> STOP, not STARt to change.At *RST, this value is set to CENTer, to be compatible with the default definition for thecouplings.19.7.9 :STARt SOURce:FREQuency:STARtSets the STARting frequency. It also sets the lower limit of a manual sweep adjustment. Ifthe instrument does not support negative frequency spans, having the STARt frequencygreater than the STOP frequency will cause an error to be generated.At *RST, this value will be set to MINimum.19.7.10 :STOP SOURce:FREQuency:STOPSets the STOP frequency. It also sets the upper limit of a manual sweep adjustment. If theinstrument does not support negative frequency spans, having the STOP frequency less thanthe STARt frequency will cause an error to be generated.At *RST, this value will be set to MAXimum.1234567891011121314151617181920212223242526SOURce:FREQuency 19-37


HP022HP022HP022HP0221919.8 FUNCtion SubsystemSOURce:FUNCtion1997 SCPI Comm<strong>and</strong> ReferenceThe function subsystem controls the shape <strong>and</strong> attributes of the output signal. The switchsettings provided by this function are not horizontally compatible <strong>and</strong> represent what thesource can be configured to generate directly.KEYWORD PARAMETER FORM COMMENTS:FUNCtion[:SHAPe] :MODE19.8.1 [:SHAPe] SOURce:FUNCtion:SHAPeSelects the shape of the output signal.At *RST, the value of FUNCtion is device-dependent.The following SOURce functions are available for instruments:DC — An unvarying signal with respect to time.IMPulse — IMPulse is an approximation of a zero width pulsePCHirp — PeriodicCHirp supplies a sine sweep over the current frequency spanwhich periodically repeats.PRNoise — PeriodicR<strong>and</strong>omNoise provides a r<strong>and</strong>omly varying signal withrespect to time which periodically repeats.PULSe — A pulse, or string of pulses is generated.RANDom — provides a r<strong>and</strong>omly varying signal with respect to time.SINusoid — A sinusoidal signal is generated.SQUare — A square wave signal is generated.TRIangle — A triangular wave signal is generated.USER — The USER function allows the user to specify a periodic or arbitrarywaveform definition.19.8.2 :MODE SOURce:FUNCtion:MODEDetermines which signal characteristic is being controlled.At *RST, the value of this function is device-dependent.The function may be set to the following values:VOLTage.CURRent.POWer.19-38 SOURce:FUNCtion


19.9 LIST SubsystemSOURce:LISTThe list subsystem controls automatic sequencing through associated lists of specified signalvalues. It is also used to specify concurrent or simultaneous operation of the specified signalin the associated lists. The various values are specified in the LIST subsystem comm<strong>and</strong>s.The individual points in each of the list configuration comm<strong>and</strong>s are combined to make onesignal configuration.12The LIST subsystem controls a characteristic of the instrument when that subsystem’s mode 3is set to LIST (such as :FREQuency:MODE LIST). Note that is permissible to have onecharacteristic controlled by the list subsystem, <strong>and</strong> the others controlled by a different 4subsystem (such as :FREQuency:MODE LIST or :POWer:MODE SWEep).5When employing multiple lists, all lists must be of the same length. If they are not all of the 6same length, an error is generated at sequencing time. An exception is made for the casewhere the shorter list is of length 1. In this case, the particular list is treated as though it were 7a list of equal length, with all values being the same.Lists are not affected by *RST.89KEYWORD PARAMETER FORM COMMENTS 10:LIST:AM 1993 11EM003[:DEPTh] {,} 1993 12EM003:POINts? [query only] 1993 EM003:APRobe {,} 1993 13 XSS01c:POINts? [query only] 1993 14 XSS01c:CONCurrent {,}:AUTO |ONCE15:POINts?[query only]16:CONTrol 1993 XSS01c:APOWer {,} 1993 17XSS01c:POINts? [query only] 1993 18 XSS01c:BLOWer {,} 1993 XSS01c:POINts? [query only] 1993 19XSS01c:COMPressor {,} 1993 20 XSS01c:POINts? [query only] 1993 XSS01c:COUNt21:CURRent {,}22:POINts?[query only]:DIRection UP|DOWN23:DWELl {,}24:POINts? [query only ]:FREQuency {,}25:POINts?:GENeration1997 SCPI Comm<strong>and</strong> ReferenceDSEQuence|SEQuence|DCONcurrent|CONCurrent[query only]SOURce:LIST 19-3926


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM COMMENTS:POWer{,}:POINts?[query only]:PULM 1993 EM004[:STATe] {,} 1993 EM004:POINts? [query only] 1993 EM004:RESistance {,}:POINts?[query only]:RTIMe {,} 1993 XSS01c:POINts? [query only] 1993 XSS01c:SEQuence {,}:AUTO |ONCE:POINts?[query only]:TEMPerature {,} 1993 XSS01c:POINts? [query only] 1993 XSS01c:VOLTage {,}:POINts? [query only] HP06619.9.1 :AM EM003SOURce:LIST:AMSubsystem for setting up the AM list values.19.9.1.1 :DEPTh {,} EM003SOURce:LIST:AM:DEPThSpecifies the AM DEPTh points of the list.19.9.1.1.1 :POINts? EM003SOURce:LIST:AM:DEPTh:POINTs?Returns the number of points currently in the AM DEPth list.1919.9.2 :APRobe {,} XSS01cSOURce:LIST:APRobeAPRobe selects the specified probe/s to control the temperature.19.9.2.1 :POINts? XSS01cSOURce:LIST:APRobe:POINts?Returns the number of points currently in the APRobe list.19.9.3 :CONCurrent {,}SOURce:LIST:CONCurrentDefines a list which indicated those elements of the signal list which shall be active, whenCONCurrent operation is selected. The points specified are indexes into the lists. Forexample, if 3 <strong>and</strong> 5 were selected, the third <strong>and</strong> fifth points in the signal list would begenerated simultaneously. All entries in the CONCurrent list must be unique; otherwise aparameter error (-220) will be generated. The concurrent list is separate from the other lists<strong>and</strong> is not sorted, nor are the individual points associated with the other arrays except asdescribed above.19-40 SOURce:LIST


1997 SCPI Comm<strong>and</strong> Reference19.9.3.1 :AUTO |ONCESOURce:LIST:CONCurrent:AUTOWhen on, the CONCurrent list is set to 1-N, where N is the longest list.At *RST, AUTO ON is selected.19.9.3.2 :POINts?SOURce:LIST:CONCurrent:POINts?Returns the number of points currently in the CONCurrent list.12319.9.4 :CONTrolSOURce:LIST:CONTrolXSS01c4Allows to turn on/off the devices519.9.4.1 :APOWer {,} XSS01c 6SOURce:LIST:CONTrol:APOWerTurns the APOWer on or off.719.9.4.1.1 :POINts?8XSS01cSOURce:LIST:CONTrol:APOWer:POINts?Returns the number of points currently in the APOWer list.91019.9.4.2 :BLOWer {,} XSS01cSOURce:LIST:CONTrol:BLOWer11Turns the BLOWer on or off.1219.9.4.2.1 :POINTs? 13 XSS01cSOURce:LIST:CONTrol:BLOWer:POINts?Returns the number of points currently in the BLOWer list.1419.9.4.3 :COMPressor {,}15XSS01cSOURce:LIST:CONTrol:COMPressorTurns the COMPressor on or off.161719.9.4.3.1 :POINTs? XSS01c18SOURce:LIST:CONTrol:COMPressor:POINts?Returns the number of points currently in the COMPressor list.1919.9.5 :COUNt SOURce:LIST:COUNtControls the number of times the list is sequenced when a trigger is received.202122At *RST, this value is set to 1.2319.9.6 :CURRent {,}SOURce:LIST:CURRent24Specifies the current points of the lists.19.9.6.1 :POINts?SOURce:LIST:CURRent:POINts?2526Returns the number of points currently in the CURRent list.SOURce:LIST 19-41


1997 SCPI Comm<strong>and</strong> Reference1919.9.7 :DIRection UP|DOWNSOURce:LIST:DIRectionSpecifies the direction that the sequence list is scanned. If UP is selected, the list is scannedfrom the first to the last item in the sequence list. If DOWN is selected, the list is scannedfrom the last item to the first item in the sequence list.At *RST, this value is set to UP.19.9.8 :DWELl {,}SOURce:LIST:DWELlSpecifies the dwell time points of the lists.19.9.8.1 :POINts?SOURce:LIST:DWELl:POINts?Returns the number of points currently in the DWELl list.19.9.9 :FREQuency {,}SOURce:LIST:FREQuencySpecifies the frequency points of the list set.19.9.9.1 :POINts?SOURce:LIST:FREQuency:POINts?Returns the number of points currently in the FREQuency list.Since this is only a query, there is no associated *RST state.19.9.10 :GENeration DSEQuence|SEQuence|DCONcurrent|CONCurrentSOURce:LIST:GENerationThe GENeration comm<strong>and</strong> is used to select how the defined lists are applied in a particularinstrument. An instrument may support one or more of the generation modes. SelectingDefault SEQuence (DSEQuence) causes the instrument to cycle sequentially through thecomplete list in order. When SEQuence is selected, the sequence in which the list is used isspecified by the list given in the SEQuence comm<strong>and</strong>. Selecting Default CONcurrent causesthe device to simultaneously generate all items in the list. When CONCurrent is selected, thelist specified by the CONCurrent comm<strong>and</strong> defines which elements in the list are activesimultaneously.At *RST, GENeration shall be set to DSEQuence.19.9.11 :PULM EM004SOURce:LIST:PULMSubsystem for setting up the PULM list values.19.9.11.1 :STATe {,} EM004SOURce:LIST:PULM:STATeSpecifies the PULM STATe points of the list.19.9.11.1.1 :POINts? EM004SOURce:LIST:PULM:STATe:POINts?Returns the number of points currently in the PULM STATe list.19-42 SOURce:LIST


1997 SCPI Comm<strong>and</strong> Reference19.9.12 :POWer {,}SOURce:LIST:POWerSpecifies the power/amplitude points of the lists.19.9.12.1 :POINts?SOURce:LIST:POWer:POINts?Returns the number of points currently in the POWer list.19.9.13 :RESistance {,}SOURce:LIST:RESistanceSpecifies the resistance points of the lists.123419.9.13.1 :POINts?SOURce:LIST:RESistance:POINts?Returns the number of points currently in the RESistance list.5619.9.14 :RTIMe {,}7XSS01cSOURce:LIST:RTIMeRamp TIMe controls the time required to reach the target temperature.8919.9.14.1 :POINTs? XSS01cSOURce:LIST:RTIMe:POINts?10Returns the number of points currently in the RTIMe list.1119.9.15 :SEQuence {,}SOURce:LIST:SEQuenceDefines a sequence for stepping through the list, when SEQuence operation is selected.Individual points may be specified as many times as desired in a single sequence. The pointsspecified are indexes into the lists. For example, if 3 was selected, the third point in thefrequency, dwell, <strong>and</strong> power/amplitude lists would be sequenced.The sequence list is separate from the other lists <strong>and</strong> is not sorted, nor are the individualpoints associated with the other arrays except as described above.12131415161719.9.15.1 :AUTO |ONCESOURce:LIST:SEQuence:AUTOWhen on, the sequence list is set to 1 through N, where N is the longest list.At *RST, AUTO ON is selected.18192019.9.15.2 :POINts?SOURce:LIST:SEQuence:POINts?Returns the number of points currently in the SEQuence list.21222319.9.16 :TEMPerature {,} XSS01c24SOURce:LIST:TEMPeratureTEMPerature is the target temperature.2519.9.16.1 :POINTs? 26 XSS01cSOURce:LIST:TEMPerature:POINts?Returns the number of points currently in the TEMPerature list.SOURce:LIST 19-43


1997 SCPI Comm<strong>and</strong> Reference19.9.17 :VOLTage {,}SOURce:LIST:VOLTageSpecifies the voltage points of the lists.19.9.17.1 :POINts?SOURce:LIST:VOLTage:POINts?Returns the number of points currently in the VOLT list.1919-44 SOURce:LIST


1997 SCPI Comm<strong>and</strong> Reference19.10 MARKer SubsystemSOURce:MARKerSelects between different markers, <strong>and</strong> adjusts the marker settings. The suffix with MARKerselects the marker with the same number associated with it. If the suffix is omitted, thenmarker #1 is assumed.KEYWORD PARAMETER FORM COMMENTS:MARKer:AMPLitude ON|OFF:AOFF[no query]:FREQuency :MODEFREQuency|POSition|DELTa:POINt:REFerence [:STATe] :TIME19.10.1 :AMPLitude SOURce:MARKer:AMPLitudeControls whether the marker affects the signal. If ON, the signal is modified when themarker frequency equals the output frequency. If OFF, only the marker output port isaffected.At *RST, this value is set to OFF.19.10.2 :AOFFSOURce:MARKer:AOFFTurns OFF all markers. This comm<strong>and</strong> is an event, <strong>and</strong> therefore has no query form. Allmarkers shall be turned OFF at *RST.19.10.3 :FREQuency SOURce:MARKer:FREQuencyControls the absolute frequency of the specified marker when MARKer:MODE isFREQuency. When MARKer:MODE is DELTa, this comm<strong>and</strong> controls relative frequency.At *RST, this value is set to MINimum.19.10.4 :MODE FREQuency|POSition|DELTaSOURce:MARKer:MODEThis comm<strong>and</strong> controls whether the marker is tied to a frequency, referenced to an absolutetrace point (position), or referenced to another marker (delta). If delta is selected,MARKer:REFerence determines which marker the current marker is referenced to.At *RST, this value is FREQuency.19.10.5 :POINt SOURce:MARKer:POINtSets the marker to the specified sweep point.At *RST, this value is set to MINimum.1234567891011121314151617181920212223242526SOURce:MARKer 19-45


1997 SCPI Comm<strong>and</strong> Reference19.10.6 :REFerence SOURce:MARKer:REFerenceMARK:REFerence establishes a reference marker for delta markers.At *RST, this value is device-dependent.19.10.7 [:STATe] SOURce:MARKer:STATeTurns ON <strong>and</strong> OFF the marker specified by the MARKer comm<strong>and</strong> header suffix.At *RST, this value is set to OFF.1919-46 SOURce:MARKer


1997 SCPI Comm<strong>and</strong> Reference19.11 PHASe SubsystemSOURce:PHASeThis subsystem allows control of the phase of the output signal against some reference.KEYWORD PARAMETER FORM COMMENTS:PHASe[:ADJust] :STEP :SOURce INTernal[]|EXTernal[]:REFerence[no query]19.11.1 [:ADJust] SOURce:PHASe:ADJustControls the phase offset value relative to the reference. A negative value for ADJust shallcause the output signal to lag the reference.The parameter has units of radians. The comm<strong>and</strong> shall accept a DEGree suffix.At *RST, this value is 0.19.11.1.1 :STEP SOURce:PHASe:ADJust:STEPControls the step size in radians. The comm<strong>and</strong> shall accept a DEGree suffix.At *RST, this value is device-dependent.19.11.2 :SOURce INTernal|EXTernalSOURce:PHASe:SOURceDetermines whether the reference source is an external signal or if it is the internal signalitself marked at some reference time.At *RST, this setting is device-dependent.19.11.3 :REFerenceSOURce:PHASe:REFerenceThis is an event which sets the current phase to be the reference for future phase adjustments.This function is nonqueryable.1234567891011121314151617181920212223242526SOURce:PHASe 19-47


1997 SCPI Comm<strong>and</strong> Reference1919.12 PM SubsystemSOURce:PMThe Phase Modulation subsystem is used to set the modulation controls <strong>and</strong> the parametersassociated with the modulating signal(s). The keywords to describe the carrier signal exist inother subsystems (such as FREQuency <strong>and</strong> PHASe).KEYWORD PARAMETER FORM COMMENTS:PM[:DEViation] :SENSitivity :MODELOCKed|UNLocked:STATe:SOURce EXTernal|INTernal{,EXTernal|,INTernal}:COUPling AC|DC|GROund:POLarity NORMal|INVerted:INTernal:FREQuency :EXTernal:IMPedance :COUPling AC|DC|GROund:POLarity NORMal|INVerted19.12.1 [:DEViation] SOURce:PM:DEViationSets the modulation DEViation of a PM signal. The unit for DEViation is radians. WherePM:DEViation is implemented, degree units must also be accepted. Radians must always bereturned on a query. This comm<strong>and</strong> is used where the DEViation can be controlledindependently from the modulating signal voltage level. Alternatively, it is used to set adevice capability that can indicate when the desired DEViation has been achieved.At *RST, this value is device-dependent.19.12.2 :SENSitivity SOURce:PM:SENSitivityControls the modulation deviation by setting a sensitivity Modulation to the modulationsignal voltage level. The unit for SENSitivity is radians/Volt (radians/V). WherePM:SENSitivity is implemented, degree/Volt (degree/V) units must also be accepted.Radians/Volt must always be returned on a query.At *RST, this value is device-dependent.19.12.3 :MODE LOCKed|UNLockedSOURce:PM:MODESets the synthesis mode employed in generating the PM signal. If MODE is set to LOCKedthen a PLL is used in synthesizing the PM signal, to prevent frequency drift. If UNLockedthe phase locked loop is inactive.At *RST, this value is device-dependent.19-48 SOURce:PM


1997 SCPI Comm<strong>and</strong> Reference19.12.4 :STATe SOURce:PM:STATeTurns phase modulation ON or OFF. Turning PM ON will not automatically turn OFF anyother types of modulation. Turning any or all modulations types ON or OFF must be doneexplicitly. Where a type of modulation is active, turning ON another type of modulation willadd to the set of active modulations if that combination of capabilities are legal in the device.Otherwise, an execution error -221 is generated <strong>and</strong> the instrument state is left undefined.At *RST, this value must be set to OFF.19.12.5 :SOURce EXTernal|INTernal{,EXTernal|,INTernal}SOURce:PM:SOURceSelects the source for the modulating signal, <strong>and</strong> it may specify a single source or a numberof sources. The specified sources in the SOURce comm<strong>and</strong> are all selected <strong>and</strong> turned on.Any sources from a previous selection that are not part of the current selection list aredeselected <strong>and</strong> turned off. If multiple sources are selected <strong>and</strong> the device does not support thecombination requested in the SOURce comm<strong>and</strong>, an execution error -221 must be generated.Where multiple internal modulation sources are available, individual INTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.Where multiple external modulation sources are available, individual EXTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.At *RST, this value is device-dependent.19.12.6 :COUPling AC|DC|GROundSOURce:PM:COUPlingCOUPling at this level is used to set the coupling between the modulator <strong>and</strong> the modulatingsignal. The modulating signal may be the sum of several signals, either internal or externalsources. If COUPling is set to DC, then both AC <strong>and</strong> DC components of the signal pass. ACcoupling passes only the AC component of the signal. The GROund parameter allows themodulation to be turned ON without the modulating signal connected.At *RST, this value is device-dependent.19.12.7 :POLarity NORMal|INVertedSOURce:PM:POLarityPOLarity, at this level, is used to set the polarity between the modulator <strong>and</strong> the modulatingsignal. The modulating signal may be the sum of several signals, either internal or externalsources. POLarity sets the relationship between the polarity of the applied modulationvoltage <strong>and</strong> the resulting “direction” of modulation. The definition of “normal” polarity forPM modulated signal is that a positive voltage causes the instantaneous output phase toincrease.At *RST, this value must be set to NORMal.1234567891011121314151617181920212223242526SOURce:PM 19-49


1997 SCPI Comm<strong>and</strong> Reference1919.12.8 :INTernalSOURce:PM:INTernalThe INTernal subsystem is used to control the specified internal signal source. Wheremultiple internal modulation sources are available, the INTernal keyword may have anumeric suffix signifying the particular internal signal source. If no number is given, a 1 isassumed.19.12.8.1 :FREQuency SOURce:PM:INTernal:FREQuencySets the frequency of the specified internal signal source. Some instruments may also allowthe internal signal source(s) to be controlled as a subsystem(s). The unit of FREQuency isHertz (Hz).At *RST, this value is device-dependent.19.12.9 :EXTernalSOURce:PM:EXTernalThe EXTernal subsystem is used to control the specified external signal source. Wheremultiple external modulation sources are available, the EXTernal keyword may have anumeric suffix signifying the particular external signal source. If no number is given, a 1 isassumed.19.12.9.1 :IMPedance SOURce:PM:EXTernal:IMPedanceSets the impedance of the specified external signal source. The units for IMPedance is Ohms.At *RST, this value is device-dependent.19.12.9.2 :COUPling AC|DC|GROundSOURce:PM:EXTernal:COUPlingCOUPling, at this level, sets the coupling for only the specified external signal source. IfCOUPling is set to DC, then both AC <strong>and</strong> DC components of the signal pass. AC couplingpasses only the AC component of the signal. The GROund parameter allows the specifiedexternal source to be turned ON without being connected.At *RST, this value is device-dependent.19.12.9.3 :POLarity NORMal|INVertedSOURce:PM:EXTernal:POLarityPOLarity, at this level, sets the POLarity for only the specified external signal source.POLarity sets the relationship between the polarity of the applied modulation voltage <strong>and</strong> theresulting “direction” of modulation. The definition of “normal” polarity for PM modulatedsignal is a positive voltage that causes the instantaneous output phase to increase.At *RST, this value must be set to NORMal.19-50 SOURce:PM


19.13 POWer SubsystemSOURce:POWer1997 SCPI Comm<strong>and</strong> ReferenceThis subsection controls the signal amplitude characteristics of the source.There is only one subsystem for each of the main amplitude characteristics of the signal.Thus, AC voltage <strong>and</strong> DC voltage are both placed under the VOLTage subsystem. A device 1which implemented both simultaneously would implement them as two separate sources, oneAC <strong>and</strong> one DC.2KEYWORD PARAMETER FORM COMMENTS3:POWer4:ATTenuation :AUTO |ONCE5:ALC6[:STATe] :SEARch |ONCE7:SOURce INTernal|DIODe|PMETer|MMHead8:BANDwidth |:BWIDth9:AUTO |ONCE10:CENTer [:LEVel]11[:IMMediate]12[:AMPLitude] :OFFSet 13:HIGH 14:LOW :TRIGgered15[:AMPLitude] 16:OFFSet :HIGH 17:LOW HP018:LIMit[:AMPLitude] 19:OFFSet 20:HIGH :LOW 21:STATe 22:PROTection[:LEVel] :STATe:TRIPped?:MANual :MODEFIXed|SWEep|LIST[query only]23242526:CLEar[no query]SOURce:POWer 19-51


1997 SCPI Comm<strong>and</strong> Reference19KEYWORD PARAMETER FORM COMMENTS:RANGe :AUTO |ONCE:REFerence :STATe :SLEW:SPAN:HOLD :LINK CENTer|STARt|STOP:FULL[no query]:STARt:STOP19.13.1 :ATTenuation SOURce:POWer:ATTenuationSets the ATTenuation level. Note that when increasing the level by 10 dB the magnitude ofthe outgoing signal as well as the LEVel will be decreased by 10 dB.Default units are as determined in the UNIT system. This is coupled to LEVel.19.13.1.1 :AUTO SOURce:POWer:ATTenuation:AUTOCouples the attenuator to LEVel.Programming a specified attenuation sets AUTO OFF.See SOURce subsystem introduction for additional explanation.At *RST, AUTO is set to ON.19.13.2 :ALCSOURce:POWer:ALCThis subsystem comm<strong>and</strong> controls the automatic leveling control of the source.19.13.2.1 [:STATe] SOURce:POWer:ALC:STATeControls whether the ALC loop controls the output level.At *RST, this value is device-dependent.19.13.2.2 :SEARch |ONCESOURce:POWer:ALC:SEARchSEARch enables a form of leveling where the output level is calibrated by momentarilyclosing the leveling loop. Once the correct amount of level adjustment has been determinedto produce the desired output level, the leveling loop is opened.When ON, the search routine will be done anytime the output level requires change (forexample, when LEVel is changed).HP09419-52 SOURce:POWer


1997 SCPI Comm<strong>and</strong> ReferenceSelecting SEARch ONCE will have the effect of setting SEARch to ON <strong>and</strong> then OFF. Amodulator setting is determined by the system which will not be changed until the outputlevel is explicitly reprogrammed.At *RST, this value is set to OFF.19.13.2.3 :SOURce INTernal|DIODe|PMETer|MMHeadSOURce:POWer:ALC:SOURceSelects the source of the feedback signal for ALC. The parameters have the followingmeanings:INTernal — The ALC feedback signal is measured from a point inside the source.DIODe — The ALC feedback is being fed from an external diode detector.PMETer — The ALC signal is coming from a power meter.MMHead — A millimeter head, with built in leveling, is being used to supply theALC signal.At *RST, this value is INTernal.19.13.2.4 :BANDwidth|:BWIDth SOURce:POWer:ALC:BANDwidthControls the b<strong>and</strong>width of the ALC feedback signal. This parameter is in units of Hz.At *RST, this value is device-dependent.19.13.2.4.1 :AUTO |ONCESOURce:POWer:ALC:BANDwidth:AUTOCouples the b<strong>and</strong>width of the ALC feedback signal to instrument-dependent parameters.When AUTO is ON, the best b<strong>and</strong>width is chosen to reflect the current instrument state.Explicitly selecting a value for ALC:BANDwidth sets AUTO OFF.At *RST, this value is set to ON.19.13.3 :CENTer SOURce:POWer:CENTerSets the center amplitude.At *RST, this value is set to MINimum.19.13.4 [:LEVel]SOURce:POWer:LEVelThis subsystem is used to control the signal amplitude when the source is operating in acontinuous or FIXed MODE.19.13.4.1 [:IMMediate]SOURce:POWer:LEVel:IMMediateIndicates that the subsequent specification of a new signal amplitude is to be processed bythe device without waiting for further comm<strong>and</strong>s.1234567891011121314151617181920212223242526SOURce:POWer 19-53


1997 SCPI Comm<strong>and</strong> Reference1919.13.4.1.1 [:AMPLitude] SOURce:POWer:LEVel:IMMediate:AMPLitudeSets the actual magnitude of the unswept output signal in terms of the current operatingunits. The units are set to the default value, or alternately to a different value under the UNITsubsystem. AMPLitude may be used to specify the level for either a time varying ornon-time varying signal.Note the optional nodes exist to enable POWer to be directly followed by a. This is useful for programming simple devices in a straightforwardmanner.At *RST, the signal being sourced should be set to a “safe” condition. This is generallyachieved by setting the amplitude to its minimum value in conjunction with OUTPut:STATesubsystem.19.13.4.1.2 :OFFSet SOURce:POWer:LEVel:IMMediate:OFFSetSets the non-time varying component of the signal that is added to the time varying signalspecified in AMPLitude, in terms of the current operating units. The units are set to thedefault value, or alternately to a different value under the UNIT subsystem. WhenSOURce:FUNCtion is DC, the effect of the OFFSet is device-dependent.At *RST, the signal being sourced should be set to a “safe” condition. This is generallyachieved by setting the offset to its minimum value in conjunction with OUTPut:STATesubsystem.19.13.4.1.3 :HIGH SOURce:POWer:LEVel:IMMediate:HIGHSets the more positive peak of a time varying signal. It is used in conjunction with LOW.At *RST, the signal being sourced should be set to a “safe” condition. This is achieved bysetting this to a minimum value in conjunction with OUTPut:STATe subsystem.19.13.4.1.4 :LOW SOURce:POWer:LEVel:IMMediate:LOWSets the more negative peak of a time varying signal, it is used in conjunction with HIGH.At *RST, the signal being sourced should be set to a “safe” condition. This is achieved bysetting this to a minimum value in conjunction with OUTPut:STATe subsystem.19.13.4.2 :TRIGgeredSOURce:POWer:LEVel:TRIGgeredIndicates that subsequent specification of a new signal amplitude is to be transferred to theIMMediate value upon receipt of a trigger signal.At *RST, after the receipt of an ABORt comm<strong>and</strong> or upon being triggered, the value in theTRIGgered subsystem tracks the values in the IMMediate subsystem until a comm<strong>and</strong> in theTRIGgered subsystem is received. The purpose of tracking is so that spurious triggers do notchange the value of LEVel unexpectedly.19-54 SOURce:POWer


1997 SCPI Comm<strong>and</strong> Reference19.13.4.2.1 [:AMPLitude] SOURce:POWer:LEVel:TRIGgered:AMPLitudeSets the actual magnitude of the unswept output signal in terms of the current operatingunits. The units are set to the default value, or alternately to a different value under the UNITsubsystem. AMPLitude may be used to specify the level for either a time varying ornon-time varying signal.19.13.4.2.2 :OFFSet SOURce:POWer:LEVel:TRIGgered:OFFSetSets the non-time varying component of the signal that is added to the time varying signalspecified in AMPLitude. The units are set to the default value, or to a different value underthe UNIT subsystem. When SOURce:FUNCtion is DC, the effect of OFFSet isdevice-dependent.19.13.4.2.3 :HIGH SOURce:POWer:LEVel:TRIGgered:HIGHThis comm<strong>and</strong> is used to set the more positive peak of a time varying signal. It is used inconjunction with LOW.19.13.4.2.4 :LOW SOURce:POWer:LEVel:TRIGgered:LOWThis comm<strong>and</strong> is used to set the more negative peak of a time varying signal. It is used inconjunction with HIGH.19.13.5 :LIMitSOURce:POWer:LIMitSets the maximum bounds on the output value. Setting a larger value will cause the outputlevel to be clamped to the LIMit value.19.13.5.1 [:AMPLitude] SOURce:POWer:LIMit:AMPLitudeSets the limit on the actual magnitude of the unswept output signal in terms of the currentoperating units. The units are set to the default value, or alternately to a different value underthe UNIT subsystem. AMPLitude may be used to specify the level for either a time varyingor non-time varying signal. OFFSet may only be used with AMPLitude, where AMPLitudeis used to specify a time varying load.Explicit reference to the AMPLitude node is optional. Any device that implements thissubsystem must accept <strong>and</strong> process comm<strong>and</strong>s, with or without the AMPLitude node, <strong>and</strong>respond to them in the same way.At *RST, this value is device-dependent.19.13.5.2 :OFFSet SOURce:POWer:LIMit:OFFSetSets a non-time varying component limit of signal that is added to the time varying signalspecified in AMPLitude. The units are set to the default value, alternately to a different valueunder the UNIT subsystem.1234567891011121314151617181920212223242526SOURce:POWer 19-55


1997 SCPI Comm<strong>and</strong> Reference19At *RST, this value is device-dependent.19.13.5.3 :HIGH SOURce:POWer:LIMit:HIGHSets the more positive peak limit of a time varying signal, it is used in conjunction withLOW.At *RST, this value is device-dependent.19.13.5.4 :LOW SOURce:POWer:LIMit:LOWSets the more negative peak limit of a time varying signal, it is used in conjunction withHIGH.At *RST, this value is device-dependent.19.13.5.5 :STATe SOURce:POWer:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.19.13.6 :MANual SOURce:POWer:MANualAllows manual adjustment of the amplitude between the sweep limits. The actual amplitudelevel is determined by the parameter only if SWEep:MODE is set to MANual <strong>and</strong> theamplitude MODE is set to SWEep. If the sweep limits are changed such that the manualamplitude value would be outside the limits, the manual amplitude value will be set to thenearest limit.At *RST, this value is device-dependent.19.13.7 :MODE FIXed|SWEep|LISTSOURce:POWer:MODEDetermines which set of comm<strong>and</strong>s control the amplitude subsystem. If FIXed is selected,the amplitude is determined by the LEVel comm<strong>and</strong> under the appropriate subsystem. IfSWEep is selected, the source is in the swept mode <strong>and</strong> amplitude is determined by STARt,STOP, CENTer, SPAN, <strong>and</strong> MANual comm<strong>and</strong>s under the appropriate subsystem. If LIST isselected, the amplitude values are determined by the appropriate amplitude list (such asLIST:).At *RST, this value is set to FIXed.19.13.8 :PROTectionSOURce:POWer:PROTectionControls the protection circuits.19.13.8.1 [:LEVel] SOURce:POWer:PROTection:LEVelThis comm<strong>and</strong> sets the output level at which the output protection circuit will trip.19-56 SOURce:POWer


1997 SCPI Comm<strong>and</strong> Reference19.13.8.2 :STATe SOURce:POWer:PROTection:STATeControls whether the output protection circuit is enabled.At *RST, this value is set to ON.19.13.8.3 :TRIPped?SOURce:POWer:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped.TRIPped only has a query form <strong>and</strong> thus has no associated *RST condition.19.13.8.4 :CLEarSOURce:POWer:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.19.13.9 :RANGe SOURce:POWer:RANGeSets a range for the output amplitude. This comm<strong>and</strong> is very hardware-specific.19.13.9.1 :AUTO |ONCESOURce:POWer:RANGe:AUTOCouples the RANGe to an instrument-determined value. When AUTO is ON, the best rangeis chosen to reflect the current instrument state.Explicitly selecting a value for RANGe sets AUTO OFF.At *RST, this value is set to ON.19.13.10 :REFerence SOURce:POWer:REFerenceSets a reference value which, if STATe is ON, allows all amplitude parameters to bequeried/set as relative to the reference value.At *RST, this value is device-dependent.19.13.10.1 :STATe SOURce:POWer:REFerence:STATeDetermines whether amplitude is measured/output in absolute or relative mode. If STATe isON, then amplitude is referenced to the value set in REFerence.At *RST, this value is set to OFF.19.13.11 :SLEW SOURce:POWer:SLEWSets the slew rate of the output change when a new output level is programmed. The unitsare in (the currently active) amplitude unit/sec.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SOURce:POWer 19-57


HP0661997 SCPI Comm<strong>and</strong> Reference19.13.12 :SPAN SOURce:POWer:SPANSets the amplitude span. If the current amplitude unit is logarithmic (dBm, dBuV, etc), thenthe unit of SPAN is dB. Otherwise SPAN is programmed in the current amplitude unit.At *RST, this value is set to 0.19.13.12.1 :HOLD SOURce:POWer:SPAN:HOLDProvides a mechanism to prevent the SPAN from being changed implicitly by the definedcoupling between STARt, STOP, CENTer <strong>and</strong> SPAN. When HOLD is set to ON, SPANshall only be changed by explicitly sending the SPAN comm<strong>and</strong>.At *RST, this value is set to OFF.19.13.12.2 :LINK CENTer|STARt|STOPSOURce:POWer:SPAN:LINKAllows the default couplings for SPAN to be overridden. LINK selects the parameter, eitherCENTer, STARt or STOP, that shall not be changed when SPAN’s value is changed. Forexample, if LINK is set to STARt then changing SPAN shall cause CENTer <strong>and</strong> STOP, notSTARt to change.At *RST, this value is set to CENTer, to be compatible with the default definition for thecouplings.19.13.12.3 :FULLSOURce:POWer:SPAN:FULLWhen this comm<strong>and</strong> is received, STARt amplitude is set to its minimum value <strong>and</strong> STOPamplitude is set to its maximum value. CENTer amplitude <strong>and</strong> SPAN are set to their coupledvalues.This comm<strong>and</strong> is an event rather than a state. Therefore it has no associated query, ormeaning at *RST.1919.13.13 :STARt SOURce:POWer:STARtSets STARt amplitude.At *RST, this value is set to MINimum.19.13.14 :STOP SOURce:POWer:STOPSets STOP amplitude.At *RST, this value is set to MINimum.19-58 SOURce:POWer


19.14 PULse Modulation SubsystemSOURce:PULM1997 SCPI Comm<strong>and</strong> ReferenceThe PULse Modulation subsystem is used to set the modulation controls <strong>and</strong> the parametersassociated with the modulating signal(s). The keywords to describe the carrier signal exist inother subsystems (such as, FREQuency <strong>and</strong> PHASe).1KEYWORD PARAMETER FORM COMMENTS:PULM2:EXTernal3:HYSTeresis :IMPedance 4:LEVel 5:POLarity NORMal|INVerted:INTernal6:FREQuency 7:MODE FIXed|LIST 1993 EM004:POLarity NORMal|INVerted8:SOURce EXTernal|INTernal{,EXTernal|,INTernal}9:STATe1019.14.1 :EXTernalSOURce:PULM:EXTernal11The EXTernal subsystem is used to control the specified external signal source. Wheremultiple external modulation sources are available, the EXTernal keyword may have anumeric suffix signifying the particular external signal source. If no number is given, a 1 isassumed.19.14.1.1 :HYSTeresis SOURce:PULM:EXTernal:HYSTeresisSets, for the specified signal source, how far the signal voltage must rise above (alternatively,fall below) the threshold LEVel before the carrier is turned ON from the OFF state (or turnedOFF from the ON state). The unit for HYSTeresis is Volts.At *RST, this defaults to the TTL preset value.19.14.1.2 :IMPedance SOURce:PULM:EXTernal:IMPedanceSets the impedance of the specified external signal source. The unit for IMPedance is Ohms.At *RST, this value is device-dependent.19.14.1.3 :LEVel SOURce:PULM:EXTernal:LEVelFor the specified signal source, this sets the threshold voltage level used to turn ON thecarrier. The unit for LEVel is Volts.At *RST, this defaults to the TTL preset value.121314151617181920212223242526SOURce:PULse Modulation 19-59


1997 SCPI Comm<strong>and</strong> Reference1919.14.1.4 :POLarity NORMal|INVertedSOURce:PULM:EXTernal:POLarityPOLarity, at this level, sets the POLarity for only the specified external signal source.POLarity sets the relationship between the polarity of the applied modulation voltage <strong>and</strong> theresulting “direction” of modulation. The definition of “normal” polarity for PULSemodulated signal is, a voltage more positive than some threshold (after applying hysteresiseffects) <strong>and</strong> causes the carrier to turn on.At *RST, this value must be set to NORMal.19.14.2 :INTernalSOURce:PULM:INTernalThe INTernal subsystem is used to control the specified internal signal source. Wheremultiple internal modulation sources are available, the INTernal keyword may have anumeric suffix signifying the particular internal signal source. If no number is given, a 1 isassumed.19.14.2.1 :FREQuency SOURce:PULM:INTernal:FREQuencySets the frequency of the specified internal signal source. Some instruments may also allowthe internal signal source(s) to be controlled as a subsystem(s). The unit of FREQuency isHertz (Hz).At *RST, this value is device-dependent.19.14.3 MODE EM004SOURce:PULM:MODEDetermines which set of comm<strong>and</strong>s currently control the PULM subsystem. The settingshave the following meanings:FIXed: Settings of individual comm<strong>and</strong>s are as last set by the user.LIST: Settings of individual comm<strong>and</strong>s are controlled by the LIST subsystem.At *RST the value is FIXed.19.14.4 :POLarity NORMal|INVertedSOURce:PULM:POLarityPOLarity, at this level, is used to set the polarity between the modulator <strong>and</strong> the modulatingsignal. The modulating signal may be the sum of several signals, either internal or externalsources. POLarity sets the relationship between the polarity of the applied modulationvoltage <strong>and</strong> the resulting “direction” of modulation. The definition of “normal” polarity forPULSe modulated signal is a voltage more positive than some threshold (after applyinghysteresis effects) <strong>and</strong> causes the carrier to turn on.At *RST, this value must be set to NORMal.19-60 SOURce:PULse Modulation


1997 SCPI Comm<strong>and</strong> Reference19.14.5 :SOURce EXTernal|INTernal{,EXTernal|,INTernal}SOURce:PULM:SOURceSelects the source for the modulating signal, <strong>and</strong> it may specify a single source or a numberof sources. The specified sources in the SOURce comm<strong>and</strong> are all selected <strong>and</strong> turned on.Any sources from a previous selection are ignored. If multiple sources are selected <strong>and</strong> thedevice does not support the combination requested in the SOURce comm<strong>and</strong>, an executionerror -221 must be generated.Where multiple internal modulation sources are available, individual INTernal sources maybe distinguished by a unique numeric suffix. If no numeric suffix is provided in a comm<strong>and</strong>,a 1 is assumed.Where multiple external modulation sources are available, individual EXTernal sources mustbe distinguished by a unique number suffix. If no number suffix is provided in a comm<strong>and</strong>, a1 must be assumed.At *RST, this value is device-dependent.19.14.6 :STATe SOURce:PULM:STATeTurns Pulse Modulation ON or off. Turning ON PULse Modulation Modulation will notautomatically turn OFF any other types of modulation. Turning any or all modulations typesON or OFF must be done explicitly. Where a type of modulation is active, turning ONanother type of modulation will add to the set of active modulations if that combination ofcapabilities are legal in the device. Otherwise, an execution error -221 is generated <strong>and</strong> theinstrument state is left undefined.At *RST, this value must be set to OFF.1234567891011121314151617181920212223242526SOURce:PULse Modulation 19-61


1997 SCPI Comm<strong>and</strong> Reference1919.15 PULSe SubsystemSOURce:PULSeThis subsystem collects together the comm<strong>and</strong>s used to control pulse generation.KEYWORD PARAMETER FORM COMMENTS:PULSe:PERiod :WIDTh :DCYCle :HOLDWIDTh|DCYCle:DELay:DOUBle[:STATE] :DELay :TRANsition:STATe [:LEADing] :TRAiling :AUTO |ONCE:COUNt:POLarity NORMal|COMPlement|INVerted19.15.1 :PERiod SOURce:PULSe:PERiodSets the period of a pulsed waveform. The fundamental units for PERiod is seconds.At *RST, this value is device-dependent.19.15.2 :WIDTh SOURce:PULSe:WIDThSets the width or duration of the pulse. The fundamental units for WIDTh is seconds.At *RST, this value is device-dependent.19.15.3 :DCYCle SOURce:PULSe:DCYCleSets the duty cycle of a repetitive pulsed waveform. The fundamental units for DCYCle ispercent (%).At *RST, this value is device-dependent.19.15.4 :HOLD WIDTh|DCYCleSOURce:PULSe:HOLDSets, for a pulsed waveform, the parameter to be held constant when the period changes.At *RST, this value is device-dependent.19-62 SOURce:PULSe


1997 SCPI Comm<strong>and</strong> Reference19.15.5 :DELay SOURce:PULSe:DELaySets the time from the start of the period to the first edge of the pulse. The fundamental unitsfor DELay is seconds.At *RST, the value of this parameter is set to either 0 seconds or the nearest specified value.19.15.6 :DOUBleSOURce:PULSe:DOUBleThis subsystem contains the comm<strong>and</strong>s necessary to control the parameters associated withdouble pulse. When a double pulse is enabled, a second pulse which is identical to theprimary pulse is generated at some point during the period of the pulse. This second pulsehas the same characteristics as the first pulse, including width. A side effect is that since asecond pulse has been added, the actual duty cycle of the signal is twice that specified inPULSe:DCYCle. Attempting to enable double pulse mode when the pulse width is greaterthan:(PULSE:PERiod-PULSe:DOUBle:DELay)/2will cause an error -221, “Settings Conflict,” to be generated.19.15.6.1 [:STATE] SOURce:PULSe:DOUBle:STATEThis comm<strong>and</strong> sets the double pulse mode to ON or OFF.At *RST, this parameter is set to OFF.19.15.6.2 :DELay SOURce:PULSe:DOUBle:DELaySets the time from the start of the period to the first edge of the second pulse. Thefundamental units for DELay is seconds.At *RST, this value is device-dependent.19.15.7 :TRANsitionSOURce:PULSe:TRANsitionCollects together the comm<strong>and</strong>s to control the parameters associated with characteristics ofthe leading <strong>and</strong> trailing edges of the pulse.19.15.7.1 :STATe SOURce:PULSe:TRANsition:STATeSets the transition mode to ON or OFF. If STATe is OFF, then the LEADing <strong>and</strong> TRAilingedges must be set to the minimum transition times available in the device. If STATe is ON,then the pulse transition times are specified by values for LEADing <strong>and</strong> TRAiling.At *RST, this parameter is set to OFF.19.15.7.2 [:LEADing] SOURce:PULSe:TRANsition:LEADingThis comm<strong>and</strong> sets the transition time for the LEADing edge. The fundamental units forLEADing is seconds.1234567891011121314151617181920212223242526SOURce:PULSe 19-63


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.19.15.7.3 :TRAiling SOURce:PULSe:TRANsition:TRAilingSets the transition time for the TRAiling edge. The fundamental units for TRAiling isseconds.At *RST, this value device-dependent.19.15.7.3.1 :AUTO |ONCESOURce:PULSe:TRANsition:TRAiling:AUTOCouples the value of TRAiling to LEADing, when AUTO is set to ON.At *RST, this parameter is set to ON.19.15.8 :COUNt SOURce:PULSe:COUNtSets the number of times pulse (or double pulse) must be repeated for a single trigger event.At *RST, the value of this parameter is set to 1.19.15.9 :POLarity NORMal|COMPlement|INVertedSOURce:PULSe:POLaritySets the polarity of the pulse. For NORMal operation the second nominal state is morepositive that the first. COMPlement <strong>and</strong> INVerted are aliases. For either position, the secondnominal transition is more negative than the first.At *RST, this parameter is set to NORMal.1919-64 SOURce:PULSe


1997 SCPI Comm<strong>and</strong> Reference19.16 RESistance SubsystemSOURce:RESistanceThis subsystem controls the characteristics of a resistance source or load.KEYWORD PARAMETER FORM COMMENTS:RESistance[:LEVel][:IMMediate][:AMPLitude] :OFFSet :HIGH :LOW :TRIGgered[:AMPLitude] :OFFSet :HIGH :LOW :LIMit[:AMPLitude] :OFFSet :HIGH :LOW :PROTection[:LEVel] :STATe :TRIPped?[query only]:CLEar[no query]:SLEW:CENTer :SPAN:HOLD :LINK CENTer|STARt|STOP:FULL[no query]:STARt:STOP:MANual :MODEFIXed|SWEep|LIST:REFerence :STATe :RANGe :AUTO |ONCE1234567891011121314151617181920212223242526SOURce:RESistance 19-65


1997 SCPI Comm<strong>and</strong> Reference1919.16.1 [:LEVel]SOURce:RESistance:LEVelThis subsystem is used to control the resistance when the source is operating in a continuousor FIXed MODE. That is, as a constant load.19.16.1.1 [:IMMediate]SOURce:RESistance:LEVel:IMMediateIndicates that the subsequent specification of a new resistance is to be processed by thedevice without waiting for further comm<strong>and</strong>s.19.16.1.1.1 [:AMPLitude] SOURce:RESistance:LEVel:IMMediate:AMPLitudeSets the actual magnitude of the unswept resistance. AMPLitude may be used to specify theresistance level for either a time varying or non-time varying load.At *RST, this value is device-dependent.19.16.1.1.2 :OFFSet SOURce:RESistance:LEVel:IMMediate:OFFSetSets the non-time varying component of the resistance that is added to the time varyingresistance signal specified in AMPLitude.At *RST, this value is device-dependent.19.16.1.1.3 :HIGH SOURce:RESistance:LEVel:IMMediate:HIGHSets the more positive peak of a time varying resistance signal, it is used in conjunction withLOW.At *RST, this value is device-dependent.19.16.1.1.4 :LOW SOURce:RESistance:LEVel:IMMediate:LOWSets the more negative peak of a time varying resistance signal, it is used in conjunction withHIGH.At *RST, this value is device-dependent.19.16.1.2 :TRIGgeredSOURce:RESistance:LEVel:TRIGgeredIndicates that subsequent specification of a new resistance settings are to be transferred to theIMMediate value upon receipt of a trigger signal.At *RST, after the receipt of an ABORt comm<strong>and</strong>, or upon being triggered, the values in theTRIGgered subsystems track the values in the IMMediate subsystem until a comm<strong>and</strong> in theTRIGgered subsystem is received. The purpose of tracking is so that spurious triggers do notchange the value of LEVel unexpectedly.19-66 SOURce:RESistance


1997 SCPI Comm<strong>and</strong> Reference19.16.1.2.1 [:AMPLitude] SOURce:RESistance:LEVel:TRIGgered:AMPLitudeSets the actual magnitude of the unswept output signal. AMPLitude may be used to specifythe resistance level for either a time varying or non-time varying load.19.16.1.2.2 :OFFSet SOURce:RESistance:LEVel:TRIGgered:OFFSetSets the non-time varying component of the resistance that is added to the time varyingresistance signal specified in AMPLitude.19.16.1.2.3 :HIGH SOURce:RESistance:LEVel:TRIGgered:HIGHSets the more positive peak of a time varying resistance signal, <strong>and</strong> it is used in conjunctionwith LOW.19.16.1.2.4 :LOW SOURce:RESistance:LEVel:TRIGgered:LOWSets the more negative peak of a time varying resistance signal, <strong>and</strong> it is used in conjunctionwith HIGH.19.16.2 :LIMitSOURce:RESistance:LIMitSets the bounds on the resistance value. Setting a larger value will cause the resistance to beclamped to the LIMit value.19.16.2.1 [:AMPLitude] SOURce:RESistance:LIMit:AMPLitudeSets the limit on the actual magnitude of the unswept resistance. AMPLitude may be used tospecify the resistance level for either a time varying or non-time varying load. OFFSet mayonly be used with AMPLitude, where AMPLitude is used to specify a time varying load.Explicit reference to the AMPLitude node is optional. Any device that implements thissubsystem shall accept <strong>and</strong> process comm<strong>and</strong>s, with or without the AMPLitude node, <strong>and</strong>respond to them in the same way.At *RST, this value is device-dependent.19.16.2.2 :OFFSet SOURce:RESistance:LIMit:OFFSetSets the limit for the non-time varying component of resistance that is added to the timevarying resistance signal specified in AMPLitude.At *RST, this value is device-dependent.19.16.2.3 :HIGH SOURce:RESistance:LIMit:HIGHSets the more positive peak limit of a time varying resistance signal, it is used in conjunctionwith LOW.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SOURce:RESistance 19-67


1997 SCPI Comm<strong>and</strong> Reference1919.16.2.4 :LOW SOURce:RESistance:LIMit:LOWSets the more negative peak limit of a time varying resistance signal, <strong>and</strong> it is used inconjunction with HIGH.At *RST, this value is device-dependent.19.16.3 :PROTectionSOURce:RESistance:PROTectionControls the resistance protection circuit19.16.3.1 [:LEVel] SOURce:RESistance:PROTection:LEVelSets the output resistance level at which the output protection circuit will trip.19.16.3.2 :STATe SOURce:RESistance:PROTection:STATeControls whether the output protection circuit is enabled.At *RST, this value is set to ON.19.16.3.3 :TRIPped?SOURce:RESistance:PROTection:TRIPped?Returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped. TRIPped only has aquery form <strong>and</strong> thus has no associated *RST condition.19.16.3.4 :CLEarSOURce:RESistance:PROTection:CLEarCauses the protection circuit to be cleared. This comm<strong>and</strong> is an event <strong>and</strong> has no associated*RST condition.19.16.4 :SLEW SOURce:RESistance:SLEWSets the slew rate of the resistance change when a new resistance level is programmed. Theunits are in Ohm/sec.At *RST, this value is device-dependent.19.16.5 :CENTer SOURce:RESistance:CENTerSets the CENTer RESistance. At *RST, this value is set to MINimum.19.16.6 :SPAN SOURce:RESistance:SPANSets the resistance SPAN.At *RST, this value is set to 0.19-68 SOURce:RESistance


1997 SCPI Comm<strong>and</strong> Reference19.16.6.1 :HOLD SOURce:RESistance:SPAN:HOLDProvides a mechanism to prevent the SPAN from being changed implicitly by the definedcoupling between STARt, STOP, CENTer <strong>and</strong> SPAN. When HOLD is set to ON, SPANshall only be changed by explicitly sending the SPAN comm<strong>and</strong>.At *RST, this value is set to OFF.19.16.6.2 :LINK CENTer|STARt|STOPSOURce:RESistance:SPAN:LINKAllows the default couplings for SPAN to be overridden. LINK selects the parameter, eitherCENTer, STARt or STOP, that shall not be changed when SPAN’s value is changed. Forexample, if LINK is set to STARt then changing SPAN shall cause CENTer <strong>and</strong> STOP, notSTARt to change.At *RST, this value is set to CENTer, to be compatible with the default definition for thecouplings.19.16.6.3 :FULLSOURce:RESistance:SPAN:FULLWhen this comm<strong>and</strong> is received, STARt RESistance is set to MINimum, <strong>and</strong> STOPRESistance is set to MAXimum. CENTer RESistance <strong>and</strong> SPAN are set to their coupledvalues.This comm<strong>and</strong> is an event, rather than a state. Therefore it has no associated query, ormeaning at *RST.19.16.7 :STARt SOURce:RESistance:STARtSets STARt resistance.At *RST, this value is set to MINimum.19.16.8 :STOP SOURce:RESistance:STOPSets STOP resistance.At *RST, this value is set to MINimum.19.16.9 :MANual SOURce:RESistance:MANualAllows manual adjustment of the RESistance between the sweep limits. The actualRESistance level is determined by the parameter only if SWEep:MODE is set to MANual<strong>and</strong> RESistance:MODE is set to SWEep. If the sweep limits are changed such that themanual RESistance value would be outside the limits, the manual RESistance value will beset to the nearest limit.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SOURce:RESistance 19-69


1997 SCPI Comm<strong>and</strong> Reference1919.16.10 :MODE FIXed|SWEep|LISTSOURce:RESistance:MODEDetermines which set of comm<strong>and</strong>s control the resistance subsystem. If FIXed is selected,the RESistance is determined by the LEVel comm<strong>and</strong>. If SWEep is selected, the source is inthe swept mode <strong>and</strong> RESistance is determined by STARt, STOP, CENTer, SPAN, <strong>and</strong>MANual comm<strong>and</strong>s. If LIST is selected, the RESistance values are determined byLIST:RESistance.At *RST, this value is set to FIXed.19.16.11 :REFerence SOURce:RESistance:REFerenceSets a reference value which, if STATe is ON, allows all RESistance parameters to bequeried/set as a relative to the reference value.At *RST, this value is device-dependent.19.16.11.1 :STATe SOURce:RESistance:REFerence:STATeDetermines whether RESistance is in absolute or relative mode. If STATe is ON, thenRESistance is referenced to the value set in REFerence.At *RST, this value is set to OFF.19.16.12 :RANGe SOURce:RESistance:RANGeSets a range for the output RESistance.19.16.12.1 :AUTO |ONCESOURce:RESistance:RANGe:AUTOCouples the RANGe to an instrument-determined value. When AUTO POWer <strong>and</strong>VOLTageis ON, the best range is chosen to reflect the current instrument state.Explicitly selecting a value for RANGe sets AUTO OFF.At *RST, this value is set to ON.19-70 SOURce:RESistance


HP0HP0HP0HP0HP0HP0HP0HP0HP0HP019.17 ROSCillator SubsystemSOURce:ROSCillatorThis subsystem controls the reference oscillator.KEYWORD PARAMETER FORM NOTES:ROSCillator[:INTernal] 1992:FREQuency :EXTernal 1992:FREQuency 1992:SOURce INTernal|EXTernal|NONE:AUTO |ONCE19.17.1 [:INTernal]SOURce:ROSCillator:INTernalThis subsystem configures the internal reference oscillator(s).19.17.1.1 :FREQuency SOURce:ROSCillator:INTernal:FREQuencySpecifies the frequency of the internal reference oscillator. The default units are Hz.At *RST, this value is device-dependent.19.17.2 :EXTernalSOURce:ROSCillator:EXTernalThis subsystem configures the external reference oscillator(s).19.17.2.1 :FREQuency SOURce:ROSCillator:EXTernal:FREQuency1997 SCPI Comm<strong>and</strong> ReferenceSpecifies the frequency of the external reference oscillator. The default units are Hz.At *RST, this value is device-dependent.19.17.3 :SOURce INTernal|EXTernal|NONESOURce:ROSCillator:SOURceControls the selection of the reference oscillator source. This typically refers to a precision,stabilized time base. The parameter values have the following meanings:INTernal — The reference frequency is derived from an internal precisionoscillator.EXTernal — The reference frequency is derived from an external signal suppliedto the device.NONE — The reference frequency is not derived from any precision oscillator.At *RST, this value is device-dependent.19.17.3.1 :AUTO |ONCESOURce:ROSCillator:SOURce:AUTOWhen AUTO is ON, the system automatically selects which oscillator will be used by theinstrument.Explicitly selecting a reference oscillator turns AUTO OFF.SOURce:ROSCillator 19-711234567891011121314151617181920212223242526


At *RST, AUTO is set to ON.1997 SCPI Comm<strong>and</strong> Reference1919-72 SOURce:ROSCillator


1997 SCPI Comm<strong>and</strong> Reference19.18 SWEep SubsystemSOURce:SWEepThis subsystem controls the sweep for those instruments which generate signals as a functionof time. Other parameters may also be swept by specifying SWEep as their MODE (forexample, FREQuency:MODE SWEep). Units for this subsystem are seconds unlessotherwise noted.KEYWORD PARAMETER FORM COMMENTS:SWEep:TIME:AUTO |ONCE:LLIMit :DWELl :AUTO |ONCE:DIRection UP|DOWN:MODEAUTO|MANual:SPACing LINear|LOGarithmic:GENeration STEPped|ANALog:STEP:POINts:COUNt19.18.1 :TIME SOURce:SWEep:TIMESets the duration of the sweep. Note that this does not turn sweeping on. Setting this valueautomatically turns TIME:AUTO OFF.19.18.1.1 :AUTO |ONCESOURce:SWEep:TIME:AUTOWhen enabled, the sweep time is calculated internally <strong>and</strong> is dependent on the span of thesweep.At *RST, AUTO ON is selected.19.18.1.2 :LLIMit SOURce:SWEep:TIME:LLIMitDefines a lower limit for sweep time. This lower limit restricts the sweep time value seteither explicitly or automatically.At *RST, LLIMit is set to a device-dependent value.19.18.2 :DWELl SOURce:SWEep:DWELlControls the amount of time spent at each point during a sweep. Note that DWELl cannotexceed TIME/POINts. Trying to set it to a greater value will cause an error to result. Thepoints will not change, but time may be changed as a device-dependent decision.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SOURce:SWEep 19-73


1997 SCPI Comm<strong>and</strong> Reference19.18.2.1 :AUTO |ONCESOURce:SWEep:DWELl:AUTOWhen AUTO ON is selected, the dwell time is coupled to the sweep time <strong>and</strong> number ofpoints. The coupling equation is:DWELl=(TIME/POINts)-(device-dependent stepping time)Setting a value for dwell turns AUTO OFF.At *RST, AUTO is set to ON.19.18.3 :DIRection UP|DOWNSOURce:SWEep:DIRectionControls the direction of the sweep. If UP is selected, the sweep is carried out in ascendingorder, from STARt to STOP. If DOWN is selected, the sweep is carried out in descendingorder, from STOP to STARt.At *RST, the value of this function is UP.19.18.4 :MODE AUTO|MANualSOURce:SWEep:MODESelects the sweep conditions for the sweep. The various conditions are:AUTO: The sweep is controlled by the internal sweep generator.MANual: The sweep is controlled by front panel controls or by the manualcomm<strong>and</strong>, such as, FREQuency:MANual. This setting is valid only if the:MANual capability has been implemented.At *RST, this function is set to AUTO.19.18.5 :SPACing LINear|LOGarithmicSOURce:SWEep:SPACingDetermines the swept entity versus time characteristics of the sweep. The various settingshave the following meanings:19LINear: For stepped sweeps, the swept entity is incremented (decremented) by thestep size until the sweep limit is reached. For analog sweeps, a linear ramp isgenerated.LOGarithmic: For non-linear sweeps, step size is determined by a logarithmiccurve fitted between the start <strong>and</strong> stop frequency. Stepping is determined by theSWEep:POINts. For analog sweeps, a logarithmic ramp is generated.At *RST, this value is set to LINear.19.18.6 :GENeration STEPped|ANALogSOURce:SWEep:GENerationSelects between an analog or stepped sweep.STEPped: A stepped sweep is selected, <strong>and</strong> the points are controlled by theSWEep:POINts <strong>and</strong> SWEep:STEP settings.ANALog: The sweep is controlled by an analog signal.19-74 SOURce:SWEep


HP0HP0HP01997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is device-dependent.19.18.7 :STEP SOURce:SWEep:STEPControls the swept entity step size for a stepped linear sweep. This parameter is not used ifGENeration is ANALog or if SPACing is LOGarithmic.This value is hard coupled to SPAN <strong>and</strong> POINts by the equation:STEP=SPAN/(POINts-1) 1991Changing the value of STEP will change POINts, but not SPAN.The value is instrument-dependent at *RST, but is coupled to the reset value of POINts <strong>and</strong>SPAN.19.18.8 :POINts SOURce:SWEep:POINtsThe number of points in a stepped sweep. This parameter is not used if GENeration isANALog. In a linear sweep, this value is coupled to sweep step by the equation:STEP = SPAN/(POINts-1) 1991If POINts are changed, STEP will also be changed, but not SPAN. In a logarithmic sweep,POINts will determine the number of points/decade of sweep by the equation:POINts/DECADE = (POINts-1)/SPAN (in decades) 1991Note that style rules on resolution do not apply to this comm<strong>and</strong>. If the exact number ofpoints specified is not available, an error is generated, <strong>and</strong> the value remains unchanged.At *RST, this value is set to MAXimum.19.18.9 :COUNt SOURce:SWEep:COUNtThis comm<strong>and</strong> determines the number of sweeps which are enabled by a single trigger event.At *RST, this function is set to 1.1234567891011121314151617181920212223242526SOURce:SWEep 19-75


1997 SCPI Comm<strong>and</strong> Reference19.19 TEMPeratureSubsystem XSS01cSOURce:TEMPeratureThis subsystem controls the temperature of an environmental chamber.KEYWORD PARAMETER FORM COMMENTS:TEMPerature 1993:APRobe 1993:DWELl 1993:LCONstants 1993:DERivative 1993[:GAIN] 1993:INTegral 1993:MODE FIXed|LIST|PROGram 1993:PROTection 1993[:HIGH] 1993:CLEar [no query] 1993[:LEVel] 1993:STATe 1993:TOUT 1993:TRIPped? [query only] 1993:LOW 1993:CLEar [no query] 1993[:LEVel] 1993:STATe 1993:TOUT 1993:TRIPped? [query only] 1993:RTIMe 1993[:SPOint] 19931919.19.1 :APRobe SOURce:TEMPerature:APRobeActive PRobe selects one or more probes to become part of the feedback loop to control thetemperature.A temperature controller can have one or more probes to measure temperature at variousplaces. If more than one probe is active, the signals from the probes are averaged to controlthe temperature.AT *RST which probes are active is device dependent.19.19.2 :DWELl SOURce:TEMPerature:DWELlThe DWELl comm<strong>and</strong> specifies the amount of time the temperature chamber will stay at thetarget temperature. At the end of the DWELl period the temperature will return to theambient temperature. The DWELl time does not include the Ramp TIMe.AT *RST the value is device dependent.19-76 SOURce:TEMPerature


1997 SCPI Comm<strong>and</strong> Reference19.19.3 :LCONstantsSOURce:TEMPerature:LCONstantsA temperature chamber is a closed loop thermal system. The Loop CONstants of such asystem determine its performance. These loop constants are popularly known as pid.The p is the proportional or GAIN control <strong>and</strong> can be imagined as a coarse control. The i isthe integral (lead) compensator <strong>and</strong> d is the derivative (lag) compensator. These twocompensators are additional controls to fine tune the system. The INTegral value improvesthe steady-state error <strong>and</strong> the DERivative value improves the transient response of afeedback control system.For further information on feedback control systems please refer to Vol 1: <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong> -Chapter 2, Tuning a Control Loop Performance19.19.3.1 :DERivative SOURce:TEMPerature:LCONstants:DERivativeThe DERivative, which is also called a lead compensator, is used to improve the transientresponse of the system. The unit for DERivative is (currently selected units) degrees persecond.With both GAIN <strong>and</strong> DERivative are specified, the output (heat/cold) is proportional to theinput signal plus its derivative. This is shown in the figure below using Laplace transformnotation.At *RST the value is device dependent.19.19.3.2 [:GAIN] SOURce:TEMPerature:LCONstants:GAINThe value of :GAIN determines the time required to reach the target temperature. The higherthe value of gain, the sooner the target temperature is achieved. The GAIN is a unitlessquantity.At *RST the value is device dependent.19.19.3.3 :INTegral SOURce:TEMPerature:LCONstants:INTegralThe INTegral, which is also called a lag compensator, is used to minimize the steady-stateerror.When the steady-state error is too large, it is possible to minimize this value by adjusting thevalue of INTegral. The units for INTegral are degree*seconds.1234567891011121314151617181920212223242526SOURce:TEMPerature 19-77


1997 SCPI Comm<strong>and</strong> ReferenceWith both GAIN <strong>and</strong> INTegral are specified, the output (heat/cold) is proportional to theinput signal plus its integral. This is shown in the figure below using Laplace transformnotation.19At *RST the value is device dependent.19.19.4 :MODE FIXed|LIST|PROGramSOURce:TEMPerature:MODEDetermines which set of comm<strong>and</strong>s control the temperature subsystem. If FIXed is selected,the temperature is determined by the SPOint comm<strong>and</strong>. If LIST is selected, the temperaturevalues are determined by the appropriate temperature list (such as LIST:). If PROGram isselected the temperature is controlled by the currently selected program specified underPROGram subsystem.At *RST this value is set to FIXed.19.19.5 :PROTectionSOURce:TEMPerature:PROTectionProtects the temperature chamber as well as the unit under test.19.19.5.1 [:HIGH]SOURce:TEMPerature:PROTection:HIGHThe :HIGH subsystem controls the protection. The high value must be exceeded for theprotection action to be taken.19.19.5.1.1 :CLEarSOURce:TEMPerature:PROTection:HIGH:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.19.19.5.1.2 [:LEVel] SOURce:TEMPerature:PROTection:HIGH:LEVelSpecifies the high temperature trip level. The device will check the current value of thetemperature. If the temperature exceeds the programmed protection level, the chamber willtrip the protection mechanism.At *RST the value is device dependent.19-78 SOURce:TEMPerature


1997 SCPI Comm<strong>and</strong> Reference19.19.5.1.3 :STATe SOURce:TEMPerature:PROTection:HIGH:STATeEnables or disables the protection mechanism.At *RST this value is set to ON.19.19.5.1.4 :TOUT SOURce:TEMPerature:PROTection:HIGH:TOUTSpecifies the time out in the currently specified unit of time. The device will start the timeout counter anytime the difference between the controlled temperature <strong>and</strong> the SetPOint isgreater than a predetermined quantity (for example 2 degrees C). If the temperature has notreached the target value <strong>and</strong> if the time out has occurred the chamber will trip the protectionmechanism.The time out counter will be reset as soon as the temperature has reached the target valuewithin the predetermined tolerance limits.AT *RST the value is device dependent.19.19.5.1.5 :TRIPped?SOURce:TEMPerature:PROTection:HIGH:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped.19.19.5.2 :LOWSOURce:TEMPerature:PROTection:LOWThe :LOW subsystem controls the protection. The temperature must fall below the lowestlevel for the protection action to be taken.19.19.5.2.1 :CLEarSOURce:TEMPerature:PROTection:LOW:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.19.19.5.2.2 [:LEVel] SOURce:TEMPerature:PROTection:LOW:LEVelSpecifies the low temperature trip level. The device will check the current value of thetemperature. If the temperature falls below the programmed protection level, the chamberwill trip the protection mechanism.AT *RST the value is device dependent.19.19.5.2.3 :STATe SOURce:TEMPerature:PROTection:LOW:STATeEnables or disables the protection mechanism.At *RST this value is set to ON.1234567891011121314151617181920212223242526SOURce:TEMPerature 19-79


1997 SCPI Comm<strong>and</strong> Reference19.19.5.2.4 :TOUT SOURce:TEMPerature:PROTection:LOW:TOUTSpecifies the time out in the currently specified unit of time. The device will start the timeout counter anytime the difference between the controlled temperature <strong>and</strong> the SetPOint isgreater than a predetermined quantity (for example 2 degrees C). If the temperature has notreached the target value <strong>and</strong> if the time out has occurred the chamber will trip the protectionmechanism.The time out counter will be reset as soon as the temperature has reached the target valuewithin the predetermined tolerance limits.AT *RST the value is device dependent.19.19.5.2.5 :TRIPped?SOURce:TEMPerature:PROTection:LOW:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped.19.19.6 :RTIMe SOURce:TEMPerature:RTIMeThe Ramp TIMe comm<strong>and</strong> instructs the environmental chamber the amount of time it shouldtake to reach the target temperature.The unit for RTIMe time is based on the currently selected unit.AT *RST the value is device dependent.19.19.7 [:SPOint] SOURce:TEMPerature:SPOintThe SetPOint comm<strong>and</strong> sets the target temperature of the environmental chamber. The unitsare the current temperature units.1919-80 SOURce:TEMPerature


HP019.20 VOLTage SubsystemSOURce:VOLTage1997 SCPI Comm<strong>and</strong> ReferenceThis subsection controls the signal amplitude characteristics of the source.There is only one subsystem for each of the main amplitude characteristics of the signal.Thus, AC voltage <strong>and</strong> DC voltage are both placed under the VOLTage subsystem. A device 1which implemented both simultaneously would implement them as two separate sources, oneAC <strong>and</strong> one DC.2KEYWORD PARAMETER FORM COMMENTS3:VOLTage4:ATTenuation :AUTO |ONCE5:ALC6[:STATe] :SEARch |ONCE7:SOURce INTernal|DIODe|PMETer|MMHead8:BANDwidth |:BWIDth9:AUTO |ONCE10:CENTer [:LEVel]11[:IMMediate]12[:AMPLitude] :AUTO |ONCE 1991 13PH0:OFFSet 14:HIGH :LOW 15:TRIGgered16[:AMPLitude] :OFFSet 17:HIGH 18:LOW :LIMit19[:AMPLitude] 20:OFFSet :HIGH 21:LOW 22:STATe :MANual 23:MODEFIXed|SWEep|LIST24:PROTection[:LEVel] 25:STATe26:TRIPped?[query only]:CLEar[no query]SOURce:VOLTage 19-81


1997 SCPI Comm<strong>and</strong> Reference19KEYWORD PARAMETER FORM COMMENTS:RANGe :AUTO |ONCE:REFerence :STATe :SLEW:SPAN:HOLD :LINK CENTer|STARt|STOP:FULL[no query]:STARt:STOP19.20.1 :ATTenuation SOURce:VOLTage:ATTenuationSets the ATTenuation level. Note that when increasing the level by 10 dB the magnitude ofthe outgoing signal as well as the LEVel will be decreased by 10 dB.Default units are as determined in the UNIT system. This is coupled to LEVel.19.20.1.1 :AUTO SOURce:VOLTage:ATTenuation:AUTOCouples the attenuator to LEVel.Programming a specified attenuation sets AUTO OFF.See SOURce subsystem introduction for additional explanation.At *RST, AUTO is set to ON.19.20.2 :ALCSOURce:VOLTage:ALCThis subsystem comm<strong>and</strong> controls the automatic leveling control of the source.19.20.2.1 [:STATe] SOURce:VOLTage:ALC:STATeControls whether the ALC loop controls the output level.At *RST, this value is device-dependent.19.20.2.2 :SEARch |ONCESOURce:VOLTage:ALC:SEARchSEARch enables a form of leveling where the output level is calibrated by momentarilyclosing the leveling loop. Once the correct amount of level adjustment has been determinedto produce the desired output level, the leveling loop is opened.When ON, the search routine will be done anytime the output level requires change (forexample, when LEVel is changed).HP09419-82 SOURce:VOLTage


1997 SCPI Comm<strong>and</strong> ReferenceSelecting SEARch ONCE will have the effect of setting SEARch to ON <strong>and</strong> then OFF. Amodulator setting is determined by the system which will not be changed until the outputlevel is explicitly reprogrammed.At *RST, this value is set to OFF.19.20.2.3 :SOURce INTernal|DIODe|PMETer|MMHeadSOURce:VOLTage:ALC:SOURceSelects the source of the feedback signal for ALC. The parameters have the followingmeanings:INTernal — The ALC feedback signal is measured from a point inside the source.DIODe — The ALC feedback is being fed from an external diode detector.PMETer — The ALC signal is coming from a power meter.MMHead — A millimeter head, with built in leveling, is being used to supply theALC signal.At *RST, this value is INTernal.19.20.2.4 :BANDwidth|:BWIDth SOURce:VOLTage:ALC:BANDwidthControls the b<strong>and</strong>width of the ALC feedback signal. This parameter is in units of Hz.At *RST, this value is device-dependent.19.20.2.4.1 :AUTO |ONCESOURce:VOLTage:ALC:BANDwidth:AUTOCouples the b<strong>and</strong>width of the ALC feedback signal to instrument-dependent parameters.When AUTO is ON, the best b<strong>and</strong>width is chosen to reflect the current instrument state.Explicitly selecting a value for ALC:BANDwidth sets AUTO OFF.At *RST, this value is set to ON.19.20.3 :CENTer SOURce:VOLTage:CENTerSets the center amplitude.At *RST, this value is set to MINimum.19.20.4 [:LEVel]SOURce:VOLTage:LEVelThis subsystem is used to control the signal amplitude when the source is operating in acontinuous or FIXed MODE.19.20.4.1 [:IMMediate]SOURce:VOLTage:LEVel:IMMediateIndicates that the subsequent specification of a new signal amplitude is to be processed bythe device without waiting for further comm<strong>and</strong>s.1234567891011121314151617181920212223242526SOURce:VOLTage 19-83


PH0401997 SCPI Comm<strong>and</strong> Reference19.20.4.1.1 [:AMPLitude] SOURce:VOLTage:LEVel:IMMediate:AMPLitudeSets the actual magnitude of the unswept output signal in terms of the current operatingunits. The units are set to the default value, or alternately to a different value under the UNITsubsystem. AMPLitude may be used to specify the level for either a time varying ornon-time varying signal.Note the optional nodes exist to enable VOLTage to be directly followed by a. This is useful for programming simple devices in a straightforwardmanner.At *RST, the signal being sourced should be set to a “safe” condition. This is generallyachieved by setting the amplitude to its minimum value in conjunction with OUTPut:STATesubsystem.19.20.4.1.1.1 :AUTO |ONCESOURce:VOLTage:LEVel:IMMediate:AMPLitude:AUTOIf AUTO ON is selected, the current setting will be adjusted automatically when a newvoltage setting (with the existing current setting) exceeds the maximum power limit. IfAUTO OFF is selected a new voltage setting will cause an execution error -221 (Settingsconflict), <strong>and</strong> the instrument state is device dependent when the maximum power limit isexceeded.*RST condition: AUTO OFF19.20.4.1.2 :OFFSet SOURce:VOLTage:LEVel:IMMediate:OFFSetSets the non-time varying component of the signal that is added to the time varying signalspecified in AMPLitude, in terms of the current operating units. The units are set to thedefault value, or alternately to a different value under the UNIT subsystem. WhenSOURce:FUNCtion is DC, the effect of the OFFSet is device-dependent.19At *RST, the signal being sourced should be set to a “safe” condition. This is generallyachieved by setting the offset to its minimum value in conjunction with OUTPut:STATesubsystem.19.20.4.1.3 :HIGH SOURce:VOLTage:LEVel:IMMediate:HIGHSets the more positive peak of a time varying signal. It is used in conjunction with LOW.At *RST, the signal being sourced should be set to a “safe” condition. This is achieved bysetting this to a minimum value in conjunction with OUTPut:STATe subsystem.19.20.4.1.4 :LOW SOURce:VOLTage:LEVel:IMMediate:LOWSets the more negative peak of a time varying signal, it is used in conjunction with HIGH.At *RST, the signal being sourced should be set to a “safe” condition. This is achieved bysetting this to a minimum value in conjunction with OUTPut:STATe subsystem.19-84 SOURce:VOLTage


1997 SCPI Comm<strong>and</strong> Reference19.20.4.2 :TRIGgeredSOURce:VOLTage:LEVel:TRIGgeredIndicates that subsequent specification of a new signal amplitude is to be transferred to theIMMediate value upon receipt of a trigger signal.At *RST, after the receipt of an ABORt comm<strong>and</strong> or upon being triggered, the value in theTRIGgered subsystem tracks the values in the IMMediate subsystem until a comm<strong>and</strong> in theTRIGgered subsystem is received. The purpose of tracking is so that spurious triggers do notchange the value of LEVel unexpectedly.19.20.4.2.1 [:AMPLitude] SOURce:VOLTage:LEVel:TRIGgered:AMPLitudeSets the actual magnitude of the unswept output signal in terms of the current operatingunits. The units are set to the default value, or alternately to a different value under the UNITsubsystem. AMPLitude may be used to specify the level for either a time varying ornon-time varying signal.19.20.4.2.2 :OFFSet SOURce:VOLTage:LEVel:TRIGgered:OFFSetSets the non-time varying component of the signal that is added to the time varying signalspecified in AMPLitude. The units are set to the default value, or to a different value underthe UNIT subsystem. When SOURce:FUNCtion is DC, the effect of OFFSet isdevice-dependent.19.20.4.2.3 :HIGH SOURce:VOLTage:LEVel:TRIGgered:HIGHThis comm<strong>and</strong> is used to set the more positive peak of a time varying signal. It is used inconjunction with LOW.19.20.4.2.4 :LOW SOURce:VOLTage:LEVel:TRIGgered:LOWThis comm<strong>and</strong> is used to set the more negative peak of a time varying signal. It is used inconjunction with HIGH.19.20.5 :LIMitSOURce:VOLTage:LIMitSets the maximum bounds on the output value. Setting a larger value will cause the outputlevel to be clamped to the LIMit value.19.20.5.1 [:AMPLitude] SOURce:VOLTage:LIMit:AMPLitudeSets the limit on the actual magnitude of the unswept output signal in terms of the currentoperating units. The units are set to the default value, or alternately to a different value underthe UNIT subsystem. AMPLitude may be used to specify the level for either a time varyingor non-time varying signal. OFFSet may only be used with AMPLitude, where AMPLitudeis used to specify a time varying load.1234567891011121314151617181920212223242526SOURce:VOLTage 19-85


1997 SCPI Comm<strong>and</strong> Reference19Explicit reference to the AMPLitude node is optional. Any device that implements thissubsystem must accept <strong>and</strong> process comm<strong>and</strong>s, with or without the AMPLitude node, <strong>and</strong>respond to them in the same way.At *RST, this value is device-dependent.19.20.5.2 :OFFSet SOURce:VOLTage:LIMit:OFFSetSets a non-time varying component limit of signal that is added to the time varying signalspecified in AMPLitude. The units are set to the default value, alternately to a different valueunder the UNIT subsystem.At *RST, this value is device-dependent.19.20.5.3 :HIGH SOURce:VOLTage:LIMit:HIGHSets the more positive peak limit of a time varying signal, it is used in conjunction withLOW.At *RST, this value is device-dependent.19.20.5.4 :LOW SOURce:VOLTage:LIMit:LOWSets the more negative peak limit of a time varying signal, it is used in conjunction withHIGH.At *RST, this value is device-dependent.19.20.5.5 :STATe SOURce:VOLTage:LIMit:STATeControls whether the LIMit is enabled.At *RST, this value is set to ON.19.20.6 :MANual SOURce:VOLTage:MANualAllows manual adjustment of the amplitude between the sweep limits. The actual amplitudelevel is determined by the parameter only if SWEep:MODE is set to MANual <strong>and</strong> theamplitude MODE is set to SWEep. If the sweep limits are changed such that the manualamplitude value would be outside the limits, the manual amplitude value will be set to thenearest limit.At *RST, this value is device-dependent.19.20.7 :MODE FIXed|SWEep|LISTSOURce:VOLTage:MODEDetermines which set of comm<strong>and</strong>s control the amplitude subsystem. If FIXed is selected,the amplitude is determined by the LEVel comm<strong>and</strong> under the appropriate subsystem. IfSWEep is selected, the source is in the swept mode <strong>and</strong> amplitude is determined by STARt,STOP, CENTer, SPAN, <strong>and</strong> MANual comm<strong>and</strong>s under the appropriate subsystem. If LIST is19-86 SOURce:VOLTage


1997 SCPI Comm<strong>and</strong> Referenceselected, the amplitude values are determined by the appropriate amplitude list (such asLIST:).At *RST, this value is set to FIXed.19.20.8 :PROTectionSOURce:VOLTage:PROTectionControls the protection circuits.19.20.8.1 [:LEVel] SOURce:VOLTage:PROTection:LEVelThis comm<strong>and</strong> sets the output level at which the output protection circuit will trip.19.20.8.2 :STATe SOURce:VOLTage:PROTection:STATeControls whether the output protection circuit is enabled.At *RST, this value is set to ON.19.20.8.3 :TRIPped?SOURce:VOLTage:PROTection:TRIPped?This query returns a 1 if the protection circuit is tripped <strong>and</strong> a 0 if it is untripped.TRIPped only has a query form <strong>and</strong> thus has no associated *RST condition.19.20.8.4 :CLEarSOURce:VOLTage:PROTection:CLEarCauses the protection circuit to be cleared.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition.19.20.9 :RANGe SOURce:VOLTage:RANGeSets a range for the output amplitude. This comm<strong>and</strong> is very hardware-specific.19.20.9.1 :AUTO |ONCESOURce:VOLTage:RANGe:AUTOCouples the RANGe to an instrument-determined value. When AUTO is ON, the best rangeis chosen to reflect the current instrument state.Explicitly selecting a value for RANGe sets AUTO OFF.At *RST, this value is set to ON.19.20.10 :REFerence SOURce:VOLTage:REFerenceSets a reference value which, if STATe is ON, allows all amplitude parameters to bequeried/set as relative to the reference value.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SOURce:VOLTage 19-87


HP0661997 SCPI Comm<strong>and</strong> Reference19.20.10.1 :STATe SOURce:VOLTage:REFerence:STATeDetermines whether amplitude is measured/output in absolute or relative mode. If STATe isON, then amplitude is referenced to the value set in REFerence.At *RST, this value is set to OFF.19.20.11 :SLEW SOURce:VOLTage:SLEWSets the slew rate of the output change when a new output level is programmed. The unitsare in (the currently active) amplitude unit/sec.At *RST, this value is device-dependent.19.20.12 :SPAN SOURce:VOLTage:SPANSets the amplitude span. If the current amplitude unit is logarithmic (dBm, dBuV, etc), thenthe unit of SPAN is dB. Otherwise SPAN is programmed in the current amplitude unit.At *RST, this value is set to 0.19.20.12.1 :HOLD SOURce:VOLTage:SPAN:HOLDProvides a mechanism to prevent the SPAN from being changed implicitly by the definedcoupling between STARt, STOP, CENTer <strong>and</strong> SPAN. When HOLD is set to ON, SPANshall only be changed by explicitly sending the SPAN comm<strong>and</strong>.At *RST, this value is set to OFF.1919.20.12.2 :LINK CENTer|STARt|STOPSOURce:VOLTage:SPAN:LINKAllows the default couplings for SPAN to be overridden. LINK selects the parameter, eitherCENTer, STARt or STOP, that shall not be changed when SPAN’s value is changed. Forexample, if LINK is set to STARt then changing SPAN shall cause CENTer <strong>and</strong> STOP, notSTARt to change.At *RST, this value is set to CENTer, to be compatible with the default definition for thecouplings.19.20.12.3 :FULLSOURce:VOLTage:SPAN:FULLWhen this comm<strong>and</strong> is received, STARt amplitude is set to its minimum value <strong>and</strong> STOPamplitude is set to its maximum value. CENTer amplitude <strong>and</strong> SPAN are set to their coupledvalues.This comm<strong>and</strong> is an event rather than a state. Therefore it has no associated query, ormeaning at *RST.19.20.13 :STARt SOURce:VOLTage:STARtSets STARt amplitude.19-88 SOURce:VOLTage


1997 SCPI Comm<strong>and</strong> ReferenceAt *RST, this value is set to MINimum.19.20.14 :STOP SOURce:VOLTage:STOPSets STOP amplitude.At *RST, this value is set to MINimum.1234567891011121314151617181920212223242526SOURce:VOLTage 19-89


1997 SCPI Comm<strong>and</strong> Reference1919-90 SOURce:VOLTage


1997 SCPI Comm<strong>and</strong> Reference20 STATus Subsystem TK012This subsystem controls the SCPI-defined status-reporting structures. SCPI defines, inaddition to those in IEEE 488.2, QUEStionable, OPERation, Instrument SUMmary <strong>and</strong>INSTrument registers. These registers conform to the IEEE 488.2 specification <strong>and</strong> eachmay be comprised of a condition register, an event register, an enable register, <strong>and</strong> negative 1<strong>and</strong> positive transition filters. The purpose <strong>and</strong> definition of the SCPI-defined registers is 2described in “<strong>Volume</strong> 1: <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>”.3SCPI also defines an IEEE 488.2 queue for status. The queue provides a human readablerecord of instrument events. The application programmer may individually enable events 4into the queue. STATus:PRESet enables errors <strong>and</strong> disables all other events. If the summary 5of the queue is reported, it shall be reported in bit 2 of the status byte register. A subset oferror/event numbers is defined by SCPI. Additional error/event numbers will be defined at a 6later date.7KEYWORD PARAMETER FORM NOTES8STATus:OPERation9[:EVENt]?[query only]10:CONDition?[query only]:ENABle | 1995 11 TK046:PTRansition | 1995 12 TK046:NTRansition | 1995 TK046:MAP,13:INSTrument[:EVENt]?[query only]:CONDition?[query only]1415:ENABle | 1995 16 TK046:PTRansition | 1995 TK046:NTRansition | 1995 17 TK046:ISUMmary[:EVENt]?[query only]:CONDition?[query only]1819:ENABle 20:QUEStionable:PTRansition[:EVENt]?[query only]:NTRansition:CONDition?[query only]212223:ENABle | 1995 24 TK046:PTRansition | 1995 TK046:NTRansition | 199525TK046:MAP,26:INSTrument 1991 HP0[:EVENt]? [query only] 1991STATus Subsystem 20-1


HP0401997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:CONDition? [query only] 1991 HP040:ENABle 1991,5 TK046HP040 | :PTRansition | 1991,5 TK046HP040:NTRansition | 1991,5 TK046HP040:ISUMmary 1991 HP040[:EVENt]? 1991 HP040[query only]:CONDition? [query only] 1991 HP040:ENABle 1991 HP040:PTRansition 1991 HP040:NTRansition 1991 HP040:VOLTage|:CURRent|:TIMe|:POWer|:TEMPerature|:FREQuency|:PHASe|:MODulation|:CALibration[:EVENt]?[query only]:CONDition?[query only]:ENABle | 1995 TK046:PTRansition | 1995 TK046:NTRansition | 1995 TK046:PRESet[no query]20The status reporting comm<strong>and</strong>s are orthogonal. Status register bits are classified as eitherterminal (reporting a single class of events) or summary (reporting several classes of events).Summary bits have the same register structure behind them. This is called register fan-out.The comm<strong>and</strong>s to access each register are always the same <strong>and</strong> are described below. Thename of each subsystem follows the name of the associated bit in the next higher statusstructure. Therefore, the event register associated with the frequency error bit of thequestionable signal/data register set would be accessed by the comm<strong>and</strong>:STATus:QUEStionable:FREQuency:EVENt?Certain comm<strong>and</strong>s in this subsystem are required to be implemented by all SCPIinstruments. These comm<strong>and</strong>s are described in section 4.2.1 of “<strong>Volume</strong> 1: <strong>Syntax</strong> <strong>and</strong><strong>Style</strong>.”The parameters to the comm<strong>and</strong>s are described as as defined in IEEE 488.2 <strong>and</strong> notas SCPI’s . This means that UP, DOWN, MINimum, <strong>and</strong> MAXimum arenot accepted for these comm<strong>and</strong>s. When a STATus comm<strong>and</strong> is queried, the return formshall always be an value.20-2 STATus Subsystem


HP01997 SCPI Comm<strong>and</strong> ReferenceThe following comm<strong>and</strong>s can be applied to all SCPI registers by prefixing the comm<strong>and</strong>with the node(s) that represent the particular register to be controlled.20.1 [:EVENt]?STATus:OPERation:EVENt?This query returns the contents of the event register associated with the status structuredefined in the comm<strong>and</strong>.The response is (NR1 NUMERIC RESPONSE DATA) (range: 0 through 32767) unlesschanged by the :FORMat:SREGister comm<strong>and</strong>.Note that reading the event register clears it.20.2 :CONDition?STATus:OPERation:CONDition?Returns the contents of the condition register associated with the status structure defined inthe comm<strong>and</strong>. Reading the condition register is nondestructive.The response is (NR1 NUMERIC RESPONSE DATA) (range: 0 through 32767) unlesschanged by the :FORMat:SREGister comm<strong>and</strong>.20.3 :ENABle | STATus:OPERation:ENABleSets the enable mask which allows true conditions in the event register to be reported in thesummary bit. If a bit is 1 in the enable register <strong>and</strong> its associated event bit transitions to true,a positive transition will occur in the associated summary bit.The comm<strong>and</strong> accepts parameter values of either format in the range 0 through 65535(decimal) without error.The query response format is unless changed by the :FORMat:SREGister comm<strong>and</strong>.Note that 32767 is the maximum value returned as the most-significant bit of the registercannot be set true.20.4 :PTRansition | STATus:OPERation:PTRansitionSets the positive transition filter. Setting a bit in the positive transition filter shall cause a 0 to1 transition in the corresponding bit of the associated condition register to cause a 1 to bewritten in the associated bit of the corresponding event register.The comm<strong>and</strong> accepts parameter values of either format in the range 0 through 65535(decimal) without error.The query response format is unless changed by the :FORMat:SREGister comm<strong>and</strong>.Note that 32767 is the maximum value returned as the most-significant bit of the registercannot be set true.12TK04634567TK046 8910111213TK0461415 TK046161718192021 TK0462223 TK046242526STATus Subsystem 20-3


HP066HP0661997 SCPI Comm<strong>and</strong> Reference20.5 :NTRansition | STATus:OPERation:NTRansitionSets the negative transition filter. Setting a bit in the negative transition filter shall cause a 1to 0 transition in the corresponding bit of the associated condition register to cause a 1 to bewritten in the associated bit of the corresponding event register.The comm<strong>and</strong> accepts parameter values of either format in the range 0 through 65535(decimal) without error.The query response format is unless changed by the :FORMat:SREGister comm<strong>and</strong>.Note that 32767 is the maximum value returned as the most-significant bit of the registercannot be set true.TK046TK0462020.6 :MAP ,STATus:OPERation:MAPMaps an error from the list of possible events the instrument can generate into a specified bitin the OPERation or QUEStionable register. The first parameter is the specified bit locationin the OPERation or QUEStionable register. The second parameter is the event number. Forexample, to map event number 678 into bit 9 of the QUEStionable status register, theprogramer would send:STATus:QUEStionable:MAP 9,67820.7 :PRESetSTATus:PRESetThe PRESet comm<strong>and</strong> is an event that configures the SCPI <strong>and</strong> device-dependent status datastructures such that device-dependent events are reported at a higher level through them<strong>and</strong>atory part of the status-reporting mechanism. Device-dependent events are summarizedin the m<strong>and</strong>atory structures. The m<strong>and</strong>atory structure is defined in part by IEEE 488.2;SCPI-required structures compose the rest. The m<strong>and</strong>atory part of the status-reportingmechanism provides a device-independent interface for determining the gross status of adevice.The PRESet comm<strong>and</strong> affects only the enable register, the transition filter registers, <strong>and</strong>queue enabling for the SCPI-m<strong>and</strong>ated <strong>and</strong> device-dependent status data structures. PRESetdoes not affect either the “status byte” or the “st<strong>and</strong>ard event status” as defined by IEEE488.2. PRESet does not clear any of the event registers or any item from the error/eventqueue. The *CLS comm<strong>and</strong> is used to clear all event registers <strong>and</strong> queues in the devicestatus-reporting mechanism.For the device-dependent status data structures, the PRESet comm<strong>and</strong>s shall set the enableregister to all 1’s <strong>and</strong> the transition filter register to a device-dependent value. Thedevice-dependent value shall be either PTR, NTR, or both, such that the device-dependentevent shall be propagated to the structure that summarizes that event. For the SCPIm<strong>and</strong>atory status data structures, the PRESet comm<strong>and</strong> shall set the transition filter registersto recognize only positive transitions <strong>and</strong> set the enable register to 0’s. The PREsetcomm<strong>and</strong> shall also set error/event queue enabling to report only errors.TK012TK01220-4 STATus Subsystem


1997 SCPI Comm<strong>and</strong> ReferenceAn application may select the events that shall cause a service request at the m<strong>and</strong>atory SCPIstatus data structure level, rather than excluding those that are of no interest to theapplication. Further, there is no requirement on the application to set up thedevice-dependent structures for normal device operation.For this concept to be extended to encompass the IEEE 488.2-m<strong>and</strong>ated status datastructures, the following sequence of comm<strong>and</strong>s is required when initializing the device:*CLS – Clears all event status registers <strong>and</strong> queues*SRE 0 – Clears the IEEE 488.2-m<strong>and</strong>ated service request enable register*ESE 0 – Clears the IEEE 488.2-m<strong>and</strong>ated st<strong>and</strong>ard event status enable registerSTATus:PRESet – Presets all other registers <strong>and</strong> queuesThe table below indicates the effects of various comm<strong>and</strong>s upon the status data structures in a device.SCPITransitionFiltersSCPIEnableRegistersSCPIEventRegistersSCPIError/EventQueueEnableSCPIError/EventQueueIEEE 488.2RegistersESE SREIEEE 488.2RegistersSESR STB*RST none none none none none none none*CLS none none clear none clear none clearpower-on preset # preset # clear # preset # clear # clear # clear #STATus:PRESet preset preset none preset none none none# Occurs if the power-on state clear flag is true. Effect changes to none if the power-on state clear flagis false.12TK012345TK01267891011121314151617181920212223242526STATus Subsystem 20-5


1997 SCPI Comm<strong>and</strong> ReferenceThe following table defines the effect of STATus:PRESetRegister Filter/enable PRESet value =OPERationalQUEStionableISUMmaryINSTrumentAll othersENABlePTRNTRENABlePTRNTRENABlePTRNTRENABlePTRNTRENABlePTRNTR0’s1’s0’s0’s1’s0’s0’s1’s0’s1’sdevice-dependent#device-dependent#1’sdevice-dependent#device-dependent## Requires either PTR, NTR, or both to be set.2020-6 STATus Subsystem


1997 SCPI Comm<strong>and</strong> Reference21 SYSTem SubsystemThe SYSTem subsystem collects the functions that are not related to instrumentperformance. Examples include functions for performing general housekeeping <strong>and</strong>functions related to setting global configurations, such as TIME or SECurity.1KEYWORD PARAMETER FORM NOTESSYSTem2:ALTernate 3:STATe :BEEPer4:FREQuency 5[:IMMediate] [[,[,]]]:STATe 6:TIME7:VOLume :CAPability? [query only] 1994 TWV41C 8:COMMunicate9:CENTronics 1993 HP063e:FEED 1993 10 HP063e:GPIB11RDEVice 1993 HP063e:ADDRess [,] 1993 12 HP063e:FEED 1993 13 HP063e[:SELF] 1993 HP063e:ADDRess [,] 1993 14 HP063e:SERial15:CONTrol 1991 HP0:DTR ON|OFF|STANdard|IBFull 1991 16HP0:RTS ON|OFF|STANdard|IBFull|RFR 1991 HP017:FEED 1993 HP063e[:RECeive]18:BAUD 19:THReshold:BITS :PACE XON|ACK|NONE199120HP021:STARt 1991 HP0:STOP 1991 22HP0:PARity:CHECk [:TYPE] EVEN|ODD|ZERO|ONE|NONE2324:SBITs 25:TRANsmit:AUTO 26:BAUD SYSTem 21-1


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:BITS :DELay 1993 TK014:PACE XON|ACK|NONE:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE:SBITs :CPON |ALL [event; no query]:CTYPe? [query only]:DATE,,:ERRor:ALL? [query only] 1996:CODE 1996:ALL? [query only] 1996[:NEXT]? [query only] 1996:COUNT? [query only] 1996[:NEXT]? [query only] 1996:HELP 1992:HEADers? [query only] 1995 HP099bPH002:SYNTax? [query only] 1992 PH002:KEY:CATalog:DEFine ,[,]:DELete:KLOCk:LANGuage :LFRequency 1992 HP05321:AUTO | ONCE 1992 HP053:PASSword 1994 TK024:CDISable [event; no query]1994 TK024[:CENable] [event; no query]1994 TK024:STATe? [query only] 1994 TK024:NEW , [event; no query]1994 TK024:PRESet[event; no query]:SECurity:IMMediate[event; no query]1994 TK025[:STATe] :SET:TIME,,:TZONe[,]:VERSion?21-2 SYSTem


1997 SCPI Comm<strong>and</strong> Reference21.1 :ALTernate SYSTem:ALTernateSelects an alternate instrument state, which is swapped with the current state at the end ofsome specified action. The selects which of the states will be used. Thestates are created with the *SAV comm<strong>and</strong>. The action is generally sweep, list sequencing orsome programmable delay, depending on the device configuration.At *RST, this value is device-dependent.21.1.1 :STATe SYSTem:ALTernate:STATeControls whether the alternate state mode is enabled. While it is ON, the device shall swapthe active state with the one stored in the register specified in ALTernate.At *RST, this parameter is set to OFF.21.2 :BEEPerSYSTem:BEEPerThis subsystem controls the audible beeper of the instrument.21.2.1 :FREQuency SYSTem:BEEPer:FREQuencyPrograms the frequency of audible tones. It also sets the default frequency for the[:IMMediate] comm<strong>and</strong>. The parameter is specified in Hz. The range of valid parameters isinstrument-dependent.At *RST, this value is device-dependent.21.2.2 [:IMMediate][[,[,]]]SYSTem:BEEPer:IMMediateThe receipt of this comm<strong>and</strong> causes an audible tone to be generated by the instrument. Notethat this comm<strong>and</strong> generates an event <strong>and</strong> therefore it has no associated *RST state or queryform.The allowable values of the parameters , <strong>and</strong> areinstrument-dependent. The frequency parameter is specified in Hz. The duration timeparameter is specified in seconds. The volume parameter range is from 0 to 1, with 1indicating the maximum volume that the instrument can produce <strong>and</strong> 0 indicating minimumvolume.21.2.3 :STATe SYSTem:BEEPer:STATeEnables/disables the beeper. When STATe OFF is selected, no instrument condition, exceptthe :SYSTem:BEEPer:IMMediate comm<strong>and</strong>, shall cause an audible beep to be emitted.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526SYSTem:ALTernate 21-3


1997 SCPI Comm<strong>and</strong> Reference21.2.4 :TIME SYSTem:BEEPer:TIMEPrograms the duration of audible tones. It also sets the default duration for the [:IMMediate]comm<strong>and</strong>. The parameter is specified in seconds. The range of valid parameters isinstrument-dependent.At *RST, this value is device-dependent.21.2.5 :VOLume SYSTem:BEEPer:VOLumePrograms the volume of audible tones. It also sets the default volume for the [:IMMediate]comm<strong>and</strong>. The parameter range is from 0 to 1, with 1 indicating the maximum volume thatthe instrument can produce <strong>and</strong> 0 indicating minimum volume. Actual sound pressure levelsgenerated by any particular volume setting are instrument-dependent.At *RST, this value is device-dependent.21.3 :CAPability?SYSTem:CAPability?This query returns an . See the Compliance section in theintroduction to Instrument Class Applications.TWV41CTWV41C21.4 :COMMunicateSYSTem:COMMunicateThe COMMunicate subsystem collects together the configuration of variouscontrol/communication interfaces.21.4.1 :CENTronics HP063eSYSTem:COMMunicate:CENTronicsThe CENTronics subsystem sets the physical configuration of a centronics port.2121.4.1.1 :FEED HP063eSYSTem:COMMunicate:CENTronics:FEEDSets or queries what data is used to FEED the remote device. Data may be streamed to anexternal device without sending it through the HCOPy subsystem, for example by directlyfeeding SENSe or CALCulate data, where no page formatting comm<strong>and</strong>s are needed. Thatis, the SYSTem:COMMunicate subsystem shall not add any page formatting to the outputstream, where this is required HCOPy should be used.At *RST, FEED is device dependent.21.4.2 :GPIBSYSTem:COMMunicate:GPIBThe GPIB subsystem controls the physical configuration of a GPIB (IEEE 488) port.21.4.2.1 :RDEVice HP063eSYSTem:COMMunicate:GPIB:RDEViceThe Remote DEVice subsystem configures how the instrument uses a peripheral device,such as a printer or plotter, connected to a GPIB port.21-4 SYSTem:CAPability?


HP01997 SCPI Comm<strong>and</strong> Reference21.4.2.1.1 :ADDRess [,] HP063eSYSTem:COMMunicate:GPIB:RDEVice:ADDRessSets or queries the bus address of the peripheral device. The first parameter is the primaryaddress <strong>and</strong> the optional second parameter is the secondary address. Changing the addresswith this does not affect the address of the peripheral device. It does affect the address towhich data is sent by the instrument.At *RST, the value of this parameter is device dependent.1221.4.2.1.2 :FEED 3HP063eSYSTem:COMMunicate:GPIB:RDEVice:FEEDSets or queries what data is used to FEED the peripheral device. Data may be streamed to anexternal device without sending it through the HCOPy subsystem, for example by directlyfeeding SENSe or CALCulate data, where no page formatting comm<strong>and</strong>s are needed. Thatis, the SYSTem:COMMunicate subsystem shall not add any page formatting to the outputstream. Where page formatting is required, HCOPy should be used.At *RST, FEED is device dependent.4567821.4.2.2 [:SELF]9HP063eSYSTem:COMMunicate:GPIB[:SELF]The SELF subsystem sets the configuration relating to the GPIB port on the instrument itself.101121.4.2.2.1 :ADDRess [,] HP063eSYSTem:COMMunicate:GPIB[:SELF]:ADDRess12Sets the GPIB address of the instrument. The first parameter is the primary address <strong>and</strong> theoptional second parameter is the secondary address.*RST has no effect on the value of these parameters.21.4.3 :SERialSYSTem:COMMunicate:SERialControls the physical configuration of a serial port, such as RS-232-D, RS-422, or1314151617EIA/TIA-562. Any comm<strong>and</strong> that changes the configuration of the port takes effect18immediately upon receipt of the Program Message Terminator.TK01419*RST has no effect on the value of these parameters.21.4.3.1 :CONTrolSYSTem:COMMunicate:SERial:CONTrol2021Add comm<strong>and</strong> which independently sets the mode in which DTR <strong>and</strong> RTS pacing operate.22Since hardware h<strong>and</strong>shaking can be configured to pertain to either transmit, receive, or both,a CONTrol branch separate from the transmit <strong>and</strong> receive branches was added.2321.4.3.1.1 :DTR ON|OFF|STANdard|IBFull 24 TK014SYSTem:COMMunicate:SERial:CONTrol:DTR25Sets the hardware pacing scheme.TK01426The ON parameter indicates that the DTR line should always be asserted (held in the ONcondition).TK014SYSTem:COMMunicate 21-5


1997 SCPI Comm<strong>and</strong> Reference21The OFF parameter indicates that the DTR line should always be unasserted (held in theOFF condition).When the STANdard option is set for DTR, the DTR line behaves as specified in the EIAst<strong>and</strong>ard RS-232-D section 4.4. As stated in the st<strong>and</strong>ard:“Signals on this circuit are used to control the switching of the DCE to thecommunication channel. The ON condition prepares the DCE to be connected to thecommunication channel <strong>and</strong> maintains the connection established by external means.”A common use of the DTR line that has evolved is that of pacing. The IBFull parameter setsthe DTR line to indicate when the device is ready to receive. When the number of receivedbytes in the input buffer of the device reaches the STOP threshold the device will de-assertthe DTR line. When the number of bytes has been reduced to the STARt threshold, thedevice will assert DTR indicating that it can receive input again. The device will alsomonitor the state of DSR <strong>and</strong> CTS <strong>and</strong> will stop transmission if either of those lines becomesde-asserted.*RST has no effect on the value of this parameter.21.4.3.1.2 :RTS ON|OFF|STANdard|IBFull|RFRSYSTem:COMMunicate:SERial:CONTrol:RTSSets the hardware pacing (h<strong>and</strong>-shaking) scheme.The ON parameter indicates that the RTS line should always be asserted.The OFF parameter indicates that the RTS line should always be unasserted.When the STANdard option is set for RTS, the RTS line behaves as specified in the EIAst<strong>and</strong>ard RS-232-D section 4.4. As stated in the st<strong>and</strong>ard:“This circuit is used to condition the local DCE for data transmission <strong>and</strong> on ahalf-duplex channel, to control the direction of data transmission of the local DCE.”A common use of the RTS line that has evolved is that of pacing. Many high speedasynchronous modems use this line (paired with CTS) as receive/transmit pacing. The IBFullor its alias RFR (Ready For Receiving) parameter sets the RTS line to indicate when thedevice is ready to receive. When the number of received bytes in the input buffer of thedevice reaches the STOP threshold the device will de-assert the RTS line. When the numberof bytes has been reduced to the STARt threshold, the device will assert RTS, indicating thatit can receive input again. The device will also monitor the state of CTS <strong>and</strong> will stoptransmission if that line becomes de-asserted.The IBFull (RFR) mode follows the CCITT Recommendations V.42, Section 7.3.1, “FlowControl across the DTE/DCE interface, Option a) Using Circuit 133 <strong>and</strong> 106.”*RST has no effect on the value of this parameter.TK014TK014TK014TK014TK014TK014TK014TK014TK01421-6 SYSTem:COMMunicate


HP0HP01997 SCPI Comm<strong>and</strong> Reference21.4.3.2 :FEED HP063eSYSTem:COMMunicate:SERial:FEEDSets or queries what data is used to FEED the peripheral device connected to the serial port.Data may be streamed to an external device without sending it through the HCOPysubsystem, for example by directly feeding SENSe or CALCulate data, where no pageformatting comm<strong>and</strong>s are needed. That is, the SYSTem:COMMunicate subsystem shall notadd any page formatting to the output stream, where this is required HCOPy should be used.At *RST, FEED is device dependent.12321.4.3.3 [:RECeive]SYSTem:COMMunicate:SERial:RECeiveThe optional node RECeive is used to affect the parameters associated with reception.4521.4.3.3.1 :BAUD 6SYSTem:COMMunicate:SERial:RECeive:BAUDSets the baud rate.*RST has no effect on the value of this parameter.21.4.3.3.2 :BITS SYSTem:COMMunicate:SERial:RECeive:BITSSets the number of data bits, typically 7 or 8. The value shall be rounded to the nearestinteger.*RST has no effect on the value of this parameter.21.4.3.3.3 :PACE XON|ACK|NONESYSTem:COMMunicate:SERial:RECeive:PACEThis comm<strong>and</strong> sets the software pacing scheme.The XON pacing mode follows the CCITT Recommendations V.42, Section 7.3.1, “Flow78910111213141516Control across the DTE/DCE interface, Option b) Using DC1/DC3 characters (XON/XOFF17functions).”TK01418*RST has no effect on the value of this parameter.21.4.3.3.3.1 :THReshold19SYSTem:COMMunicate:SERial:RECeive:PACE:THReshold20This comm<strong>and</strong> sets the recieve pacing threshold.2121.4.3.3.3.1.1 :STARt SYSTem:COMMunicate:SERial:RECeive:PACE:THReshold:STARt22This comm<strong>and</strong> indicates that when the number of characters in the device’s input buffer goesto or below the indicated amount <strong>and</strong> some form of pacing has been set, the device shouldindicate that it is ready to receive.*RST has no effect on the value of this parameter.23242526SYSTem:COMMunicate 21-7


HP0471997 SCPI Comm<strong>and</strong> Reference21.4.3.3.3.1.2 :STOP SYSTem:COMMunicate:SERial:RECeive:PACE:THReshold:STOPThis comm<strong>and</strong> indicates that when the number of characters in the device’s input buffer goesto or above the indicated amount <strong>and</strong> some form of pacing has been set, the device shouldindicate that it is not ready to receive.*RST has no effect on the value of this parameter.21.4.3.3.4 :PARitySYSTem:COMMunicate:SERial:RECeive:PARityThis subsystem controls the parity of the receiving channel21.4.3.3.4.1 :CHECk SYSTem:COMMunicate:SERial:RECeive:PARity:CHECkWhen CHECk ON is selected, the parity shall be checked in accordance with the selectedPARity:TYPE.When CHECk is OFF, the parity TYPE setting (NONE or “other than NONE”) stilldetermines the expectation of not receiving or receiving a parity bit.*RST has no effect on the value of this parameter.TK014TK01421.4.3.3.4.2 [:TYPE] EVEN|ODD|ZERO|ONE|NONE|IGNoreSYSTem:COMMunicate:SERial:RECeive:PARity:TYPESets the parity scheme that is to be employed for reception.*RST has no effect on the value of this parameter.21.4.3.3.5 :SBITs SYSTem:COMMunicate:SERial:RECeive:SBITsSets the number of stop bits, typically 1, 1.5 or 2 bits.*RST has no effect on the value of this parameter.TK01421.4.3.4 :TRANsmitSYSTem:COMMunicate:SERial:TRANsmitAffects the parameters associated with transmission.2121.4.3.4.1 :AUTO SYSTem:COMMunicate:SERial:TRANsmit:AUTOCouples the TRANsmit parameter values to the RECeive parameter values when AUTO ONis selected.At *RST, AUTO ON is selected.21.4.3.4.2 :BAUD SYSTem:COMMunicate:SERial:TRANsmit:BAUDThis comm<strong>and</strong> sets the baud rate.*RST has no effect on the value of this parameter.21-8 SYSTem:COMMunicate


1997 SCPI Comm<strong>and</strong> Reference21.4.3.4.3 :BITS SYSTem:COMMunicate:SERial:TRANsmit:BITSSets the number of data bits, typically 7 or 8. The value shall be rounded to the nearestinteger.*RST has no effect on the value of this parameter.121.4.3.4.4 :DELay TK014 2SYSTem:COMMunicate:SERial:TRANsmit:DELaySets the minimum delay in seconds that the device must wait after receipt of a ProgramMessage Terminator before issuing a response message. The delay does not apply tosoftware pacing or to other low level protocols.*RST has no effect on the value of this parameter.21.4.3.4.5 :PACE XON|ACK|NONESYSTem:COMMunicate:SERial:TRANsmit:PACESets the software pacing scheme.The XON pacing mode follows the CCITT Recommendations V.42, Section 7.3.1, “Flow3456789Control across the DTE/DCE interface, Option b) Using DC1/DC3 characters (XON/XOFF10functions).”TK01411*RST has no effect on the value of this parameter.21.4.3.4.6 :PARity12SYSTem:COMMunicate:SERial:TRANsmit:PARityThis subsystem controls the parity of the transmitting channel21.4.3.4.6.1 [:TYPE] EVEN|ODD|ZERO|ONE|NONESYSTem:COMMunicate:SERial:TRANsmit:PARity:TYPESets the parity scheme that is to be employed for transmission.*RST has no effect on the value of this parameter.131415161721.4.3.4.7 :SBITs 18SYSTem:COMMunicate:SERial:TRANsmit:SBITs19Sets the number of stop bits, typically 1, 1.5, or 2 bits.TK01420*RST has no effect on the value of this parameter.2121.5 :CPON |ALLSYSTem:CPONCard Power ON resets a card within a cardcage to its power-on state. The parameter caneither be a module number or a user-defined card name. If the parameter is ALL, then alladdressable cards are reset to their power-on state.SYSTem:CPON is an event; no query is allowed.2223242526SYSTem:CPON 21-9


1997 SCPI Comm<strong>and</strong> Reference21.6 :CTYPe? SYSTem:CTYPe?The Card TYPe query identifies a card within a cardcage. The response is identical in formto that defined for the “*IDN?” query in IEEE 488.2.21.7 :DATE ,,SYSTem:DATEAny instrument which has an internal calendar shall implement the following comm<strong>and</strong> toset the calendar::Must be . It is rounded to the nearest integer. Its range is limitedby the capability of the instrument. The year shall be entered as a four-digitnumber, including century <strong>and</strong> millennium information.: Must be . It is rounded to the nearest integer. Its range is 1 to 12inclusive. The number 1 corresponds to the month January, 2 to February, <strong>and</strong> soon.:Must be . It is rounded to the nearest integer. Its range is 1 tonumber of days in the month from the previous parameter. A deviceimplementing this comm<strong>and</strong> shall keep track of the number of days in eachmonth, accounting for leap years through the range of years that it accepts.The response message shall consist of three fields separated by commas:,,:NR1 format. Range is device-dependent.21: NR1 format. Range is 1 to 12.: NR1 format. Range is 1 to 31.This shall not be affected by a *RST comm<strong>and</strong>.21.8 :ERRor SubsystemSYSTem:ERRorThis subsystem collects comm<strong>and</strong>s <strong>and</strong> queries relating to the reading <strong>and</strong> control of theerror/event queue.The error/event queue contains items that include a numerical <strong>and</strong> textual description of theerror or event. Querying for the full queue item (for example, with21-10 SYSTem:CTYPe?


1997 SCPI Comm<strong>and</strong> ReferenceSYSTem:ERRor[:NEXT]?) will return a response with the following syntax:The is a unique integer in the range [-32768, 32767]. All positivenumbers are instrument-dependent. All negative numbers are reserved by the SCPI st<strong>and</strong>ardwith certain st<strong>and</strong>ard error/event codes described in this document. The value, zero, is alsoreserved to indicate that no error or event has occurred.The second parameter of the full response is a quoted string containing an followed by optional text. Each has a unique <strong>and</strong> fixed associated with it.The maximum string length of plus is255 characters. For st<strong>and</strong>ard defined error/event codes, the shallbe sent exactly as indicated in this document including case.The text is optional but may be useful in some instruments toprovide additional information allowing the user to determine the exact error or event <strong>and</strong> itscontext. If used, it is set off from the portion of the string with asemicolon. For example:-131,"Invalid suffix;FREQuency:CENT 2.0E+5 dBuV"21.8.1 The Error/Event QueueAs errors <strong>and</strong> events are detected, they are placed in a queue. This queue is first in, first out.If the queue overflows, the last error/event in the queue is replaced with error-350,"Queue overflow"Any time the queue overflows, the least recent errors/events remain in the queue, <strong>and</strong> themost recent error/event is discarded. The minimum length of the error/event queue is 2, oneposition for the first error/event, <strong>and</strong> one for the “Queue overflow” message. Reading anerror/event from the head of the queue removes that error/event from the queue, <strong>and</strong> opens aposition at the tail of the queue for a new error/event, if one is subsequently detected.When all errors/events have been read from the queue, further error/event queries shallreturn0, “No error”After a STATus:PRESet, the masking shall be changed so that only errors are reported.The error/event queue shall be cleared when any of the following occur (IEEE 488.2, section11.4.3.4):Upon receipt of a *CLS comm<strong>and</strong>.Upon reading the last item from the queue.21.8.2 Error/Event numbersThe system-defined error/event numbers are chosen on an enumerated (“1 of N”) basis. TheSCPI-defined error/event numbers <strong>and</strong> the portions of the fullqueue item are listed here. The first error/event described in each class (for example, -100,12345678910 TK01211121314151617TK01218192021 TK01222232425TK04726SYSTem:ERRor Subsystem 21-11


1997 SCPI Comm<strong>and</strong> Reference21-200, -300, -400) is a “generic” error. In selecting the proper Error/event number to report,more specific error/event codes are preferred, <strong>and</strong> the generic error/event is used only if theothers are inappropriate.Note the organization of the following tables. A “simple-minded” parser might implementonly the XX0 errors, <strong>and</strong> a smarter one might implement all of them. A “smart <strong>and</strong> friendly”parser might use the instrument-dependent part of the error/event message string to point outthe offending part of the comm<strong>and</strong>.21.8.3 No ErrorThis message indicates that the device has no errors or events to report.Error Error Description [description/explanation/examples]Number0 No error[The queue is competely empty. Every error/event in the queue has been read orthe queue was purposely cleared by power-on, *CLS, etc.]21.8.4 ALL?SYSTem:ERRor:ALL? queries the error/event queue for all the unread items <strong>and</strong> removesthem from the queue. The response is a comma separated list of number, string pairs in FIFOorder. If the queue is empty, the response is 0,"No error"Note: If the queue is not empty, the 0,"No error" is not sent.21.8.5 CODE21.8.5.1 ALL?SYSTem:ERRor:CODE:ALL? queries the error/event queue for all the unread items <strong>and</strong>removes them from the queue. The response returns a comma separated list of only theerror/event code numbers in FIFO order. If the queue is empty, the response is 0.Note: If the queue is not empty, the 0 is not sent.21.8.5.2 [NEXT]?SYSTem:ERRor:CODE[:NEXT]? queries the error/event queue for the next item <strong>and</strong>removes it from the queue. The response returns only the error/event code number omittingthe string. Except for the shortened response, the query operates identically toSYSTem:ERRor[:NEXT]?21.8.6 COUNt?SYSTem:ERRor:COUNt? queries the error/event queue for the number of unread items. Aserrors <strong>and</strong> events may occur at any time, more items may be present in the queue at the timeit is actually read.Note: If the queue is empty, the response is 0.21.8.7 [NEXT]?SYSTem:ERRor[:NEXT]? queries the error/event queue for the next item <strong>and</strong> removes itfrom the queue. The response returns the full queue item consisting of an integer <strong>and</strong> a stringas described in the introduction to the SYSTem:ERRor subsystem.21-12 SYSTem:ERRor SubsystemTK012TK012


1997 SCPI Comm<strong>and</strong> ReferenceThis comm<strong>and</strong> is required of all SCPI implementations (See <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, 4.2.1.21.8.8 Comm<strong>and</strong> ErrorAn in the range [ -199 , -100 ] indicates that an IEEE 488.2 syntaxerror has been detected by the instrument’s parser. The occurrence of any error in this classshall cause the comm<strong>and</strong> error bit (bit 5) in the event status register (IEEE 488.2, section11.5.1) to be set. One of the following events has occurred:An IEEE 488.2 syntax error has been detected by the parser. That is, acontroller-to-device message was received which is in violation of the IEEE 488.2st<strong>and</strong>ard. Possible violations include a data element which violates the devicelistening formats or whose type is unacceptable to the device.An unrecognized header was received. Unrecognized headers include incorrectdevice-specific headers <strong>and</strong> incorrect or unimplemented IEEE 488.2 commoncomm<strong>and</strong>s.A Group Execute Trigger (GET) was entered into the input buffer inside of anIEEE 488.2 .Events that generate comm<strong>and</strong> errors shall not generate execution errors, device-specificerrors, or query errors; see the other error definitions in this chapter.Error Error Description [description/explanation/examples]Number-100 Comm<strong>and</strong> error[This is the generic syntax error for devices that cannot detect more specificerrors. This code indicates only that a Comm<strong>and</strong> Error as defined in IEEE 488.2,11.5.1.1.4 has occurred.]-101 Invalid character[A syntactic element contains a character which is invalid for that type; forexample, a header containing an ampers<strong>and</strong>, SETUP&. This error might be usedin place of errors -114, -121, -141, <strong>and</strong> perhaps some others.]-102 <strong>Syntax</strong> error[An unrecognized comm<strong>and</strong> or data type was encountered; for example, a stringwas received when the device does not accept strings.]-103 Invalid separator[The parser was expecting a separator <strong>and</strong> encountered an illegal character; forexample, the semicolon was omitted after a program message unit,*EMC 1:CH1:VOLTS 5.]-104 Data type error[The parser recognized a data element different than one allowed; for example,numeric or string data was expected but block data was encountered.]1234567891011121314151617181920212223242526SYSTem:ERRor Subsystem 21-13


1997 SCPI Comm<strong>and</strong> Reference21-105 GET not allowed[A Group Execute Trigger was received within a program message (see IEEE488.2, 7.7).]-108 Parameter not allowed[More parameters were received than expected for the header; for example, the*EMC common comm<strong>and</strong> only accepts one parameter, so receiving *EMC 0,1 isnot allowed.]-109 Missing parameter[Fewer parameters were recieved than required for the header; for example, the*EMC common comm<strong>and</strong> requires one parameter, so receiving *EMC is notallowed.]-110 Comm<strong>and</strong> header error[An error was detected in the header. This error message should be used when thedevice cannot detect the more specific errors described for errors -111 through-119.]-111 Header separator error[A character which is not a legal header separator was encountered while parsingthe header; for example, no white shace followed the header, thus*GMC"MACRO" is an error.]-112 Program mnemonic too long[The header contains more that twelve characters (see IEEE 488.2, 7.6.1.4.1).]-113 Undefined header[The header is syntactically correct, but it is undefined for this specific device; forexample, *XYZ is not defined for any device.]-114 Header suffix out of range[The value of a numeric suffix attached to a program mnemonic, see <strong>Syntax</strong> <strong>and</strong><strong>Style</strong> section 6.2.5.2, makes the header invalid.]-120 Numeric data error[This error, as well as errors -121 through -129, are generated when parsing a dataelement which apprears to be numeric, including the nondecimal numeric types.This particular error message should be used if the device cannot detect a morespecific error.]-121 Invalid character in number[An invalid character for the data type being parsed was encountered; forexample, an alpha in a decimal numeric or a “9" in octal data.]-123 Exponent too large[The magnitude of the exponent was larger than 32000 (see IEEE 488.2,7.7.2.4.1).]21-14 SYSTem:ERRor Subsystem


1997 SCPI Comm<strong>and</strong> Reference-124 Too many digits[The mantissa of a decimal numeric data element contained more than 255 digitsexcluding leading zeros (see IEEE 488.2, 7.7.2.4.1).]-128 Numeric data not allowed[A legal numeric data element was received, but the device does not accept one inthis position for the header.]-130 Suffix error[This error, as well as errors -131 through -139, are generated when parsing asuffix. This particular error message should be used if the device cannot detect amore specific error.]-131 Invalid suffix[The suffix does not follow the syntax described in IEEE 488.2, 7.7.3.2, or thesuffix is inappropriate for this device.]-134 Suffix too long[The suffix contained more than 12 characters (see IEEE 488.2, 7.7.3.4).]-138 Suffix not allowed[A suffix was encountered after a numeric element which does not allow suffixes.]-140 Character data error[This error, as well as errors -141 through -149, are generated when parsing acharacter data element. This particular error message should be used if the devicecannot detect a more specific error.]-141 Invalid character data[Either the character data element contains an invalid character or the particularelement received is not valid for the header.]-144 Character data too long[The character data element contains more than twelve characters (see IEEE488.2, 7.7.1.4).]-148 Character data not allowed[A legal character data element was encountered where prohibited by the device.]-150 String data error[This error, as well as errors -151 through -159, are generated when parsing astring data element. This particular error message should be used if the devicecannot detect a more specific error.]-151 Invalid string data[A string data element was expected, but was invalid for some reason (see IEEE488.2, 7.7.5.2); for example, an END message was received before the terminalquote character.]1234567891011121314151617181920212223242526SYSTem:ERRor Subsystem 21-15


1997 SCPI Comm<strong>and</strong> Reference21-158 String data not allowed[A string data element was encountered but was not allowed by the device at thispoint in parsing.]-160 Block data error[This error, as well as errors -161 through -169, are generated when parsing ablock data element. This particular error message should be used if the devicecannot detect a more specific error.]-161 Invalid block data[A block data element was expected, but was invalid for some reason (see IEEE488.2, 7.7.6.2); for example, an END message was received before the length wassatisfied.]-168 Block data not allowed[A legal block data element was encountered but was not allowed by the device atthis point in parsing.]-170 Expression error[This error, as well as errors -171 through -179, are generated when parsing anexpression data element. This particular error message should be used if thedevice cannot detect a more specific error.]-171 Invalid expression[The expression data element was invalid (see IEEE 488.2, 7.7.7.2); for example,unmatched parentheses or an illegal character.]-178 Expression data not allowed[A legal expression data was encountered but was not allowed by the device atthis point in parsing.]-180 Macro error[This error, as well as errors -181 through -189, are generated when defining amacro or executing a macro. This particular error message should be used if thedevice cannot detect a more specific error.]-181 Invalid outside macro definition[Indicates that a macro parameter placeholder ($


1997 SCPI Comm<strong>and</strong> Reference21.8.9 Execution ErrorAn in the range [ -299 , -200 ] indicates that an error has beendetected by the instrument’s execution control block. The occurrence of any error in thisclass shall cause the execution error bit (bit 4) in the event status register (IEEE 488.2,section 11.5.1) to be set. One of the following events has occurred:A element following a header was evaluated by the deviceas outside of its legal input range or is otherwise inconsistent with the device’scapabilities.A valid program message could not be properly executed due to some devicecondition.Execution errors shall be reported by the device after rounding <strong>and</strong> expression evaluationoperations have taken place. Rounding a numeric data element, for example, shall not bereported as an execution error. Events that generate execution errors shall not generateComm<strong>and</strong> Errors, device-specific errors, or Query Errors; see the other error definitions inthis section.Error Error String [description/explanation/examples]Number-200 Execution error[This is the generic syntax error for devices that cannot detect more specificerrors. This code indicates only that an Execution Error as defined in IEEE 488.2,11.5.1.1.5 has occurred.]-201 Invalid while in local[Indicates that a comm<strong>and</strong> is not executable while the device is in local due to ahard local control (see IEEE 488.2, 5.6.1.5); for example, a device with a rotaryswitch receives a message which would change the switches state, but the deviceis in local so the message can not be executed.]-202 Settings lost due to rtl[Indicates that a setting associated with a hard local control (see IEEE 488.2,5.6.1.5) was lost when the device changed to LOCS from REMS or to LWLSfrom RWLS.]-203 Comm<strong>and</strong> protected[Indicates that a legal password-protected program comm<strong>and</strong> or query could notbe executed because the comm<strong>and</strong> was disabled.]-210 Trigger error-211 Trigger ignored[Indicates that a GET, *TRG, or triggering signal was received <strong>and</strong> recognized bythe device but was ignored because of device timing considerations; for example,the device was not ready to respond. Note: a DT0 device always ignores GET <strong>and</strong>treats *TRG as a Comm<strong>and</strong> Error.]1234567891011121314151617181920TK024212223242526SYSTem:ERRor Subsystem 21-17


HP058AHP058A1997 SCPI Comm<strong>and</strong> Reference21-212 Arm ignored[Indicates that an arming signal was received <strong>and</strong> recognized by the device butwas ignored.]-213 Init ignored[Indicates that a request for a measurement initiation was ignored as anothermeasurement was already in progress.]-214 Trigger deadlock[Indicates that the trigger source for the initiation of a measurement is set to GET<strong>and</strong> subsequent measurement query is received. The measurement cannot bestarted until a GET is received, but the GET would cause an INTERRUPTEDerror.]-215 Arm deadlock[Indicates that the arm source for the initiation of a measurement is set to GET<strong>and</strong> subsequent measurement query is received. The measurement cannot bestarted until a GET is received, but the GET would cause an INTERRUPTEDerror.]-220 Parameter error[Indicates that a program data element related error occurred. This error messageshould be used when the device cannot detect the more specific errors describedfor errors -221 through -229.]-221 Settings conflict[Indicates that a legal program data element was parsed but could not be executeddue to the current device state (see IEEE 488.2, 6.4.5.3 <strong>and</strong> 11.5.1.1.5.)]-222 Data out of range[Indicates that a legal program data element was parsed but could not be executedbecause the interpreted value was outside the legal range as defined by the device(see IEEE 488.2, 11.5.1.1.5.)]-223 Too much data[Indicates that a legal program data element of block, expression, or string typewas received that contained more data than the device could h<strong>and</strong>le due tomemory or related device-specific requirements.]-224 Illegal parameter value[Used where exact value, from a list of possibles, was expected.]-225 Out of memory. [The device has insufficent memory to perform the requestedoperation.]-226 Lists not same length. [Attempted to use LIST structure having individual LIST’sof unequal lengths.]-230 Data corrupt or stale[Possibly invalid data; new reading started but not completed since last access.]21-18 SYSTem:ERRor Subsystem


1997 SCPI Comm<strong>and</strong> Reference-231 Data questionable[Indicates that measurement accuracy is suspect.]-232 Invalid format[Indicates that a legal program data element was parsed but could not be executedbecause the data format or structure is inappropriate. For example when loadingmemory tables or when sending a SYSTem:SET parameter from an unknowninstrument.]PH07312-233 Invalid version3PH073[Indicates that a legal program data element was parsed but could not be executedbecause the version of the data is incorrect to the device. This particular errorshould be used when file or block data formats are recognized by the instrumentbut cannot be executed for reasons of version incompatibility. For example, a notsupported file version, a not supported instrument version]4567-240 Hardware error[Indicates that a legal program comm<strong>and</strong> or query could not be executed becauseof a hardware problem in the device. Definition of what constitutes a hardwareproblem is completely device-specific. This error message should be used whenthe device cannot detect the more specific errors described for errors -241 through-249.]891011-241 Hardware missing[Indicates that a legal program comm<strong>and</strong> or query could not be executed becauseof missing device hardware; for example, an option was not installed. Definitionof what constitutes missing hardware is completely device-specific.]121314-250 Mass storage error[Indicates that a mass storage error occurred. This error message should be usedwhen the device cannot detect the more specific errors described for errors -251through -259.]151617-251 Missing mass storage[Indicates that a legal program comm<strong>and</strong> or query could not be executed becauseof missing mass storage; for example, an option that was not installed. Definitionof what constitutes missing mass storage is device-specific.]181920-252 Missing media21[Indicates that a legal program comm<strong>and</strong> or query could not be executed because22of a missing media; for example, no disk. The definition of what constitutesmissing media is device-specific.]23-253 Corrupt media24[Indicates that a legal program comm<strong>and</strong> or query could not be executed because25of corrupt media; for example, bad disk or wrong format. The definition of whatconstitutes corrupt media is device-specific.]26SYSTem:ERRor Subsystem 21-19


1997 SCPI Comm<strong>and</strong> Reference21-254 Media full[Indicates that a legal program comm<strong>and</strong> or query could not be executed becausethe media was full; for example, there is no room on the disk. The definition ofwhat constitutes a full media is device-specific.]-255 Directory full[Indicates that a legal program comm<strong>and</strong> or query could not be executed becausethe media directory was full. The definition of what constitutes a full mediadirectory is device-specific.]-256 File name not found[Indicates that a legal program comm<strong>and</strong> or query could not be executed becausethe file name on the device media was not found; for example, an attempt wasmade to read or copy a nonexistent file. The definition of what constitutes a filenot being found is device-specific.]-257 File name error[Indicates that a legal program comm<strong>and</strong> or query could not be executed becausethe file name on the device media was in error; for example, an attempt was madeto copy to a duplicate file name. The definition of what constitutes a file nameerror is device-specific.]-258 Media protected[Indicates that a legal program comm<strong>and</strong> or query could not be executed becausethe media was protected; for example, the write-protect tab on a disk was present.The definition of what constitutes protected media is device-specific.]-260 Expression error[Indicates that a expression program data element related error occurred. Thiserror message should be used when the device cannot detect the more specificerrors described for errors -261 through -269.]-261 Math error in expression[Indicates that a syntactically legal expression program data element could not beexecuted due to a math error; for example, a divide-by-zero was attempted. Thedefinition of math error is device-specific.]-270 Macro error[Indicates that a macro-related execution error occurred. This error messageshould be used when the device cannot detect the more specific errors describedfor errors -271 through -279.]-271 Macro syntax error[Indicates that that a syntactically legal macro program data sequence, accordingto IEEE 488.2, 10.7.2, could not be executed due to a syntax error within themacro definition (see IEEE 488.2, 10.7.6.3.)]21-20 SYSTem:ERRor Subsystem


1997 SCPI Comm<strong>and</strong> Reference-272 Macro execution error[Indicates that a syntactically legal macro program data sequence could not beexecuted due to some error in the macro definition (see IEEE 488.2, 10.7.6.3.)]-273 Illegal macro label[Indicates that the macro label defined in the *DMC comm<strong>and</strong> was a legal stringsyntax, but could not be accepted by the device (see IEEE 488.2, 10.7.3 <strong>and</strong>10.7.6.2); for example, the label was too long, the same as a common comm<strong>and</strong>header, or contained invalid header syntax.]-274 Macro parameter error[Indicates that the macro definition improperly used a macro parameterplaceholder (see IEEE 488.2, 10.7.3).]-275 Macro definition too long[Indicates that a syntactically legal macro program data sequence could not beexecuted because the string or block contents were too long for the device toh<strong>and</strong>le (see IEEE 488.2, 10.7.6.1).]-276 Macro recursion error[Indicates that a syntactically legal macro program data sequence could not beexecuted because the device found it to be recursive (see IEEE 488.2, 10.7.6.6).]-277 Macro redefinition not allowed[Indicates that a syntactically legal macro label in the *DMC comm<strong>and</strong> could notbe executed because the macro label was already defined (see IEEE 488.2,10.7.6.4).]-278 Macro header not found[Indicates that a syntactically legal macro label in the *GMC? query could not beexecuted because the header was not previously defined.]-280 Program error[Indicates that a downloaded program-related execution error occurred. This errormessage should be used when the device cannot detect the more specific errorsdescribed for errors -281 through -289. A downloaded program is used to addalgorithmic capability to a device. The syntax used in the program <strong>and</strong> themechanism for downloading a program is device-specific.]-281 Cannot create program[Indicates that an attempt to create a program was unsuccessful. A reason for thefailure might include not enough memory.]-282 Illegal program name[The name used to reference a program was invalid; for example, redefining anexisting program, deleting a nonexistent program, or in general, referencing anonexistent program.]-283 Illegal variable name[An attempt was made to reference a nonexistent variable in a program.]1234567891011121314151617181920212223242526SYSTem:ERRor Subsystem 21-21


1997 SCPI Comm<strong>and</strong> Reference-284 Program currently running[Certain operations dealing with programs may be illegal while the program isrunning; for example, deleting a running program might not be possible.]-285 Program syntax error[Indicates that a syntax error appears in a downloaded program. The syntax usedwhen parsing the downloaded program is device-specific.]-286 Program runtime error-290 Memory use error[Indicates that a user request has directly or indirectly caused an error related tomemory or s, this is not the same as “bad” memory.]-291 Out of memoryHP079-292 Referenced name does not existHP079-293 Referenced name already existsHP079-294 Incompatible type[Indicates that the type or structure of a memory item is inadequate]PH0762121.8.10 Device-Specific ErrorAn in the range [ -399 , -300 ] or [ 1 , 32767 ] indicates that theinstrument has detected an error which is not a comm<strong>and</strong> error, a query error, or anexecution error; some device operations did not properly complete, possibly due to anabnormal hardware or firmware condition. These codes are also used for self-test responseerrors. The occurrence of any error in this class should cause the device-specific error bit (bit3) in the event status register (IEEE 488.2, section 11.5.1) to be set. The meaning of positiveerror codes is device-dependent <strong>and</strong> may be enumerated or bit mapped; the string for positive error codes is not defined by SCPI <strong>and</strong> available to the device designer.Note that the string is not optional; if the designer does not wish to implement a string for aparticular error, the null string should be sent (for example, 42,""). The occurrence of anyerror in this class should cause the device-specific error bit (bit 3) in the event status register(IEEE 488.2, section 11.5.1) to be set. Events that generate device-specific errors shall notgenerate comm<strong>and</strong> errors, execution errors, or query errors; see the other error definitions inthis section.Error Error String [description/explanation/examples]Number-300 Device-specific error[This is the generic device-dependent error for devices that cannot detect morespecific errors. This code indicates only that a Device-Dependent Error as definedin IEEE 488.2, 11.5.1.1.6 has occurred.]21-22 SYSTem:ERRor Subsystem


1997 SCPI Comm<strong>and</strong> Reference-310 System error-311[Indicates that some error, termed “system error” by the device, has occurred.This code is device-dependent.]Memory errorHP098[Indicates some physical fault in the device’s memory, such as parity error.] 1-312 PUD memory lost[Indicates that the protected user data saved by the *PUD comm<strong>and</strong> has been lost.]23-313 Calibration memory lost[Indicates that nonvolatile calibration data used by the *CAL? comm<strong>and</strong> has beenlost.]45-314 Save/recall memory lost[Indicates that the nonvolatile data saved by the *SAV? comm<strong>and</strong> has been lost.]67-315 Configuration memory lost[Indicates that nonvolatile configuration data saved by the device has been lost.The meaning of this error is device-specific.]89-320 Storage fault10 HP098[Indicates that the firmware detected a fault when using data storage. This error isnot an indication of physical damage or failure of any mass storage element.]11-321 Out of memory12HP098+Edit[An internal operation needed more memory than was available.]13-330 Self-test failed14-340 Calibration failed15 TK051-350 Queue overflow[A specific code entered into the queue in lieu of the code that caused the error.This code indicates that there is no room in the queue <strong>and</strong> an error occurred butwas not recorded.]161718-360 Communication error19 TK014[This is the generic communication error for devices that cannot detect the morespecific errors described for errors -361 through -363.]20-361 Parity error in program message21TK014[Parity bit not correct when data received for example, on a serial port.] 22-362 Framing error in program message23 TK014[A stop bit was not detected when data was received for example, on a serial port24(for example, a baud rate mismatch).]25-363 Input buffer overrunHP079[Software or hardware input buffer on serial port overflows with data caused by 26improper or nonexistent pacing.]SYSTem:ERRor Subsystem 21-23


1997 SCPI Comm<strong>and</strong> Reference2121.8.11 Query ErrorAn in the range [ -499 , -400 ] indicates that the output queue controlof the instrument has detected a problem with the message exchange protocol described inIEEE 488.2, chapter 6. The occurrence of any error in this class shall cause the query errorbit (bit 2) in the event status register (IEEE 488.2, section 11.5.1) to be set. These errorscorrespond to message exchange protocol errors described in IEEE 488.2, section 6.5. Oneof the following is true:An attempt is being made to read data from the output queue when no output iseither present or pending;Data in the output queue has been lost.Events that generate query errors shall not generate comm<strong>and</strong> errors, execution errors, ordevice-specific errors; see the other error definitions in this section.Error Error String [description/explanation/examples]Number-400 Query error[This is the generic query error for devices that cannot detect more specific errors.This code indicates only that a Query Error as defined in IEEE 488.2, 11.5.1.1.7<strong>and</strong> 6.3 has occurred.]-410 Query INTERRUPTED[Indicates that a condition causing an INTERRUPTED Query error occurred (seeIEEE 488.2, 6.3.2.3); for example, a query followed by DAB or GET before aresponse was completely sent.]-420 Query UNTERMINATED[Indicates that a condition causing an UNTERMINATED Query error occurred(see IEEE 488.2, 6.3.2.2); for example, the device was addressed to talk <strong>and</strong> anincomplete program message was received.]-430 Query DEADLOCKED[Indicates that a condition causing an DEADLOCKED Query error occurred (seeIEEE 488.2, 6.3.1.7); for example, both input buffer <strong>and</strong> output buffer are full <strong>and</strong>the device cannot continue.]-440 Query UNTERMINATED after indefinite response[Indicates that a query was received in the same program message after an queryrequesting an indefinite response was executed (see IEEE 488.2, 6.5.7.5).]21.8.12 Power On EventAn in the range [-599:-500] is used when the instrument wishes toreport a 488.2 power on event to the event/error queue. This event occurs when theinstrument detects an off to on transition in its power supply. This event also sets the poweron bit, (bit 7) of the St<strong>and</strong>ard Event Status Register. See IEEE 488.2, section 11.5.1.TK047TK04721-24 SYSTem:ERRor Subsystem


1997 SCPI Comm<strong>and</strong> ReferenceEvent Event String [description/explanation/examples]Number-500 Power on[The instrument has detected an off to on transition in its power supply.]21.8.13 User Request EventAn in the range [-699:-600] is used when the instrument wishes toreport a 488.2 user request event. This event occurs when the instrument detects theactivation of a user request local control. This event also sets the user request bit (bit 6) ofthe St<strong>and</strong>ard Event Status Register. See IEEE 488.2, section 11.5.1.Event Event String [description/explanation/examples]Number-600 User request[The instrument has detected the activation of a user request local control]21.8.14 Request Control EventAn in the range [-799:-700] is used when the instrument wishes toreport a 488.2 request control event to the error/event queue. This event occurs when theinstrument requests to become the active IEEE 488.1 controller-in-charge. This event alsosets request control bit (bit 1) of the St<strong>and</strong>ard Event Status Register. See IEEE 488.2,section 11.5.1.Event Event String [description/explanation/examples]Number-700 Request control[The instrument requested to become the active IEEE 488.1 controller-in-charge]TK047 1TK0472345678910111213141516171819 TK047TK04720212223242526SYSTem:ERRor Subsystem 21-25


PH0021997 SCPI Comm<strong>and</strong> Reference21.8.15 Operation Complete EventTK047An in the range [-899:-800] is used when the instrument wishes toreport a 488.2 operation complete event to the error/event queue. This event occurs wheninstrument’s synchronization protocol, having been enabled by an *OPC comm<strong>and</strong>,completes all selected pending operations. This protocol is described in IEEE 488.2, section12.5.2. This event also sets the operation complete bit (bit 0) of the St<strong>and</strong>ard Event StatusRegister. See IEEE 488.2, section 11.5.1. Note: *OPC? does not set bit 0 nor does it enterany event in the error/event queue.Event Event String [description/explanation/examples]Number-800 Operation complete[The instrument has completed all selected pending operations in accordance withthe IEEE 488.2, 12.5.2 synchronization protocol]21.9 :HELPSYSTem:HELPTK04721The HELP subsystem contains the instrument’s help utilities that are provided to theprogrammer.21-26 SYSTem:HELP


1997 SCPI Comm<strong>and</strong> Reference21.9.1 :HEADers?SYSTem:HELP:HEADers?The HEADers? query shall return all SCPI comm<strong>and</strong>s <strong>and</strong> queries <strong>and</strong> IEEE 488.2 commoncomm<strong>and</strong>s <strong>and</strong> common queries implemented by the instrument. The response shall be a element, see IEEE488.2 section 8.7.9. The full path for every comm<strong>and</strong> <strong>and</strong> query shall be returned separatedby linefeeds. The syntax of the response is defined as:The <strong>and</strong> sequence of follow the rules in IEEE 488.2, Section 8.7.9.An is defined as:It shall contain all the nodes from the root. The contains thenode in st<strong>and</strong>ard SCPI format. The shortform shall use uppercase characters while theadditional characters for the longform shall be in lowercase characters. Default nodes shallbe surrounded by square brackets ([]).The entire shall have an indication of the header type, using a .A node which has a numeric suffix, described in <strong>Volume</strong> 1, section 6.2.5, is indicated byincluding a .A is defined as:where:nothing indicates no suffix is allowed indicates list of suffixes allowed(s) indicates this specific suffix is allowed{?:?} indicates range of suffixes is unknown, orcan’t tell if suffix is allowedNumbers between the curly braces shall indicate valid values for the numeric suffix. Forexample, {1:4} means the values one through four may be appended to that node. If theinstrument cannot determine the legal values for the numeric suffix, it may use the specialform, {?:?}, to show that a numeric suffix may be allowed even though the range isunknown. The use of a is especially useful with a large number of suffixes.For headers which accept only a small number of numeric suffixes, specific values arepreferred.A is defined as:If the instrument is unable to determine if the header is an event, query only, or acomm<strong>and</strong>/query pair, it shall append /unknown/ to the header. Otherwise, a normalcomm<strong>and</strong>/query pair shall have nothing additional following the path, a query only headershall have ?/qonly/ appended, <strong>and</strong> a comm<strong>and</strong> which is an event with no query form shallhave /nquery/ appended.HP099bHP099b1234HP099b 5HP099b 6HP099b 789HP099b 1011HP099b1213HP099b1415161718HP099b1920212223HP099b24HP099b2526SYSTem:HELP 21-27


PH002PH0021997 SCPI Comm<strong>and</strong> ReferenceA is defined as:A contains only upper case letters.Headers may appear in any order.The response shall not include any macro labels. The *LMC? common query is used toreturn macro labels.For example, an instrument which implemented the required comm<strong>and</strong>s listed in <strong>Syntax</strong> &<strong>Style</strong>, <strong>Volume</strong> 1 section 4.2.1, this query, <strong>and</strong> the required IEEE 488.2 common comm<strong>and</strong>s<strong>and</strong> queries might return:HP099bHP099bHP099bHP099bHP099b21#3425:SYSTem:ERRor?/qonly/:SYSTem:HELP:HEADers?/qonly/:SYSTem:VERSion?/qonly/:STATus:OPERation[:EVENt]?/qonly/:STATus:OPERation:CONDition?/qonly/:STATus:OPERation:ENABle:STATus:QUEStionable[:EVENt]?/qonly/:STATus:QUEStionable:CONDition?/qonly/:STATus:QUEStionable:ENABle:STATus:PRESet/nquery/*IDN?/qonly/*RST/nquery/*TST?/qonly/*OPC/nquery/*OPC?/qonly/*WAI/nquery/*CLS/nquery/*ESE*ESR?/qonly/*SRE*STB?/qonly/*RST shall have no direct effect on the response to this query, but changing the instrumentstate may change the list of valid comm<strong>and</strong>s <strong>and</strong> queries.21.9.2 :SYNTax? SYSTem:HELP:SYNTax?The SYNTax? query causes the device to return a string containing the syntax specificationof the comm<strong>and</strong> associated with the . The parameter is a string containing any implemented comm<strong>and</strong> or query header that starts fromthe root. Default nodes <strong>and</strong> suffixes may appear in the parameter.Numeric suffixes may be explicitly specified in the . Only the header<strong>and</strong> parameter syntax of the specified is returned. If no numeric suffixHP099b+EditTK04221-28 SYSTem:HELP


PH0PH002, JP ChanPH01997 SCPI Comm<strong>and</strong> Referenceis specified, default 1 is assumed. In that case, devices that implement a numeric suffix shallshow the suffix 1 as an optional element in their response.The part of the returned string that reflects the syntax of the parameter part of the comm<strong>and</strong>is be separated from the header syntax part by one or more ASCII space characters (decimal32). The parameter part shall contain all required <strong>and</strong> allowed parameters. Parameternotation shall conform to notations of the Comm<strong>and</strong> Tables, being used throughout<strong>Volume</strong> 2 <strong>and</strong> specified in chapter 5.1 of <strong>Volume</strong> 1. Optionality is reflected by placing theoptional items in between square brackets. Optional nodes are reflected in the same way.The Long Form shall be used to represent mnemonics in the response to the :SYNTax?query. The letter case notation habit, as specified in chapter 5.1 of “<strong>Volume</strong> 1: <strong>Syntax</strong> <strong>and</strong><strong>Style</strong>,” shall be used for mnemonics to differentiate between Long- <strong>and</strong> Short form.Any that is not a valid comm<strong>and</strong> header being recognized by thedevice, shall cause the device to return a null string (""). E.g. if the contains only a part of the header, contains an illegal numeric suffix, etc.For example, if the comm<strong>and</strong> tree were[:ALPHa]:BETA[:GAMMa]:DELTa ON|OFF|TRIGgerwhere the indicates a range of suffix values is accepted for ALPHa <strong>and</strong> DELTa only.Then SYSTem:HELP:SYNTax? “:BETA:GAMMA:DELTA” will return“[ALPHa[1]]:BETA[:GAMMa]:DELTa[1] ON|OFF|TRIGger”SYNTax? is a query only <strong>and</strong> therefore does not have an associated *RST value.21.10 :KEY SYSTem:KEYThe KEY node is a limited implementation of the naming conventions subsystem describedin “<strong>Volume</strong> 1: <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>”. The limitation is that keys can only be referred tonumerically, <strong>and</strong> the numbers allowed by a particular instrument (key codes) are fixed.The KEY? query returns the key code for the last key pressed. Instruments may implement aqueue of keys (possibly of length 1) <strong>and</strong> return a value of -1 to indicate an empty queue. Thequeue is emptied at *RST.If the KEY comm<strong>and</strong> is sent with a parameter, that simulates the pressing of that key. Thekeycode determined by the parameter is entirely device-dependent but must match thecorresponding parameter returned for the query form. The KEY comm<strong>and</strong> may or may notput an entry into the KEY? queue.The queue of keys is cleared by *RST.12345678TK0429TK042101112TK04213TK04214 TK042TK042+Edit 151617181920212223242526SYSTem:KEY 21-29


1997 SCPI Comm<strong>and</strong> Reference21.10.1 :CATalogSYSTem:KEY:CATalogThis query returns a list of the defined keys in the subsystem. The response is a commaseparated list of NR1 elements corresponding to each key that has been defined.21.10.2 :DEFine ,[,]SYSTem:KEY:DEFineThe DEFine comm<strong>and</strong> shall redefine a key on the instrument’s keyboard so that pressing thekey will execute a particular function. The first parameter is the key code for the key to beremapped, <strong>and</strong> the second parameter contains the comm<strong>and</strong> sequence to be executed. Theoptional third parameter is a key label for the redefined key.The particular keycodes are device-dependent.The softkey label parameter is optional, but it must be accepted by the implementation. Ifsoftkeys are not implemented, the third parameter should be ignored.The comm<strong>and</strong> sequence is a block containing any sequence of SCPI comm<strong>and</strong>s.Implementations have the option of limiting this block to contain a single comm<strong>and</strong>. It isdevice-dependent when the block has its syntax checked.The query form of the comm<strong>and</strong> returns a list of all redefined keys in the form:,,. If the key is unlabeled, the third parameter shall be an emptystring.Key definitions are not affected by *RST.21.10.3 :DELete SYSTem:KEY:DELeteThe DELete comm<strong>and</strong> removes the definition of the key referred to by setby a previous DEFine comm<strong>and</strong>. The key may return to its default definition, if any.2121.11 :KLOCk SYSTem:KLOCkThis comm<strong>and</strong> locks the local controls of an instrument. This includes any front panel,keyboard, or other local interfaces. The SYSTem:KLOCk setting does not affect the 488.1Remote/Local state, if implemented.This value cannot be reset to OFF, unless SYSTem:SECurity:STATe is OFF.If SYSTem:SECurity:STATe is OFF, the KLOCk value is set to OFF at *RST. IfSYSTem:SECurity:STATe is ON, *RST has no effect.21.12 :LANGuage SYSTem:LANGuageThe receipt of this comm<strong>and</strong> shall cause the instrument to perform a language switch toanother language. The contents of the string are device dependent, however, the followingcontents are suggested:TK017aTK017aTK017a21-30 SYSTem:KLOCk


HP0HP0HP0HP0HP01997 SCPI Comm<strong>and</strong> ReferenceCOMPatibility — The language is a backwards compatible set for the product line.CIIL — Selects the CIIL language of the instrument.All devices which implement alternate languages shall also implement this comm<strong>and</strong>. Aninstrument which is currently executing SCPI will not leave SCPI to enter an alternatelanguage under any other conditions, except possibly power-on. There is no querycorresponding to this comm<strong>and</strong>.21.13 :LFRequencySYSTem:LFRequencyThe numeric value is used as the reference frequency. If the instrument is capable of usingonly discrete reference values (e.g. 50 or 60 Hz), it will use the specified value to select thenearest valid setting.*RST does not affect this setting.21.13.1 :AUTO | ONCESYSTem:LFRequency:AUTOIf AUTO ONCE is specified, the instrument will measure the line frequency internally <strong>and</strong>use the result (or the nearest valid setting, if necessary) as its reference. After themeasurement is complete, this setting reverts to OFF. If AUTO ON is specified, theinstrument will continuously monitor the line frequency (through repetitive measurements,phase locking, etc.).Behavior at power-on is device-dependent; an instrument capable of measuring the linefrequency may choose to do so when power is applied. Other options are (1) to preserve thevalue last specified with LFRequency, (2) to choose a default setting, or (3) to use hardcontrols to determine the setting.*RST does not affect this setting.21.14 :PASSwordSYSTem:PASSwordThis subsystem provides for the enabling, disabling, <strong>and</strong> changing of passwords to controlaccess to selected SCPI comm<strong>and</strong>s <strong>and</strong> queries. The instrument’s documentation shallindicate which comm<strong>and</strong>s are under the control of SYSTem:PASSword.Password protection shall be locally defeatable. The device shall have a local means to:reset the password to the default value, “DEFAULT”.enable all protected comm<strong>and</strong>s.The means of protection for this local resetting <strong>and</strong> enabling is entirely device dependent.The device shall report error -203, (comm<strong>and</strong> protected), if a password-protected comm<strong>and</strong>is received that is currently disabled.Neither the current password nor comm<strong>and</strong> protection state shall be affected by *RST.1234567891011121314151617 TK02418 TK0241920TK02421TK0242223TK02424TK0242526 TK024SYSTem:LFRequency 21-31


1997 SCPI Comm<strong>and</strong> Reference21.14.1 :CDISable SYSTem:PASSword:CDISableSending :CDISable (Comm<strong>and</strong> DISable) disables protected comm<strong>and</strong>s. The data is of type string <strong>and</strong> the password is case sensitive. There is no query form.Sending an invalid password generates error -221, (settings conflict).21.14.2 [:CENable] SYSTem:PASSword:CENableSending :CENable (Comm<strong>and</strong> ENable) enables protected comm<strong>and</strong>s to function. The data is of type string <strong>and</strong> the password is case sensitive. There is no query form.Sending an invalid password generates error -221, (settings conflict).21.14.2.1 :STATe?SYSTem:PASSword:CENable:STATe?STATe? returns a 0 if password protected comm<strong>and</strong>s are disabled <strong>and</strong> a 1 if they areenabled. There is no comm<strong>and</strong> form.21.14.3 :NEW ,SYSTem:PASSword:NEWThis comm<strong>and</strong> changes the password from the default or current value to the new value.Both parameters are strings. The must be correct for the comm<strong>and</strong> toexecute. Password strings are case sensitive. There is no query form.Sending an invalid current password generates error -221, (settings conflict).TK024TK024TK024TK024TK024TK024TK024TK024TK024TK024TK0242121.15 :PRESetSYSTem:PRESetSets the device to the same state as the front-panel reset key. This comm<strong>and</strong> is similar to the*RST comm<strong>and</strong>, but differs in that it duplicates the action of the front panel reset key.Normally this state will be optimized for front panel operation of the device instead of busoperation.Other PRESet states may be accessed with this instruction by using a numeric suffix. Forinstance, PRESet2 could provide a high speed configuration.The state of the device after PRESet is not defined by SCPI. There is no query correspondingto this comm<strong>and</strong>.21.16 :SECuritySYSTem:SECurityControls the security of the instrument.21.16.1 :IMMediateSYSTem:SECurity:IMMediateThis comm<strong>and</strong> is an event which immediately destroys all measurement data <strong>and</strong> instrumentsettings. Current settings are initialized to their *RST values. All macros, user variables, <strong>and</strong>*SAV/*RCL registers are initialized. Critical calibration constants are retained.TK025TK025TK02521-32 SYSTem:PRESet


PH0PH0PH0PH01997 SCPI Comm<strong>and</strong> ReferenceThis comm<strong>and</strong> can be under control of the SYSTem:PASSword subsystem. The device shallreport error -203, (comm<strong>and</strong> protected), if SECurity:IMMediate is received while passwordprotected.This commm<strong>and</strong> is an event, <strong>and</strong> therefore has no *RST value associated with it.21.16.2 [:STATe] SYSTem:SECurity:STATeSTATe controls the security mode of the instrument. For example, when in secure mode, anydisplay annunciators which have been disabled cannot be reenabled without destroyingcertain stored information.The value is not affected by *RST or *RCL.When this value changes from ON to OFF, everything except possibly some CALibrationdata must be initialized or destroyed. For example, the following shall be initialized:Instrument state (perform *RST).All macros (perform *PMC).All user variables.21.17 :SET SYSTem:SETAll state registers (perform *SAV into all registers after *RST).Sets the instrument to the complete or partial state determined by the contents of theparameter. The form <strong>and</strong> contents of the block data is device-dependent.This comm<strong>and</strong> shall be required for instruments that return a block of binary settings inresponse to the *LRN? query.Instruments that implement the *LRN? query <strong>and</strong> return a block of binary settings asresponse to *LRN?, shall implement also the SYSTem:SET comm<strong>and</strong>. In this case theresponse format of *LRN? shall contain SYST:SET .Note that IEEE 488.2 requires the response to *LRN? to be a legal program message. Sincethe SYSTem:SET comm<strong>and</strong> is the SCPI comm<strong>and</strong> which programs the instrument settingsby binary block data, this must be the response to the *LRN? query when it returns this dataformat.The implementation of the SYSTem:SET comm<strong>and</strong> is optional if the *LRN? query responseare the SCPI comm<strong>and</strong>s that are normally used for programming the instruments.The query form of this comm<strong>and</strong> will return a definite block data element which contains theinstrument’s current state. The SET comm<strong>and</strong> may be implemented without the associatedquery.TK025TK02512TK02534567891011121314151617181920212223242526SYSTem:SET 21-33


PH0041997 SCPI Comm<strong>and</strong> Reference21.18 :TIME ,,SYSTem:TIMEAny instrument which has an internal clock shall implement this comm<strong>and</strong> to set the clock.The three parameters for this comm<strong>and</strong> are::::Must be . It is always rounded to the nearest integer. Itsrange is 0 to 23 inclusive. All instruments implementing the TIME functionshall report <strong>and</strong> accept hour information in 24 hour format.Must be . It is always rounded to the nearest integer. Itsrange is 0 to 59 inclusive.Must be . It is rounded to the resolution of the clock. Itsrange is 0 to 60. 60 is allowed since rounding may cause a number greaterthan 59.5 to be rounded to 60. When this element is rounded to 60 it shall beset to 0 <strong>and</strong> the minute value incremented. Any other carries shall be rippledthrough the date.The query response message shall consist of three fields separated by commas:,,The three fields will contain the following information:: NR1 format ranging from 0 to 23.: NR1 format ranging from 0 to 59.:NR1 or NR2 format. If the resolution of the clock is no better than seconds,an NR1 format shall be used. If the resolution is better than seconds, an NR2format shall be used. Range is 0 to 59.999999...This setting shall not be affected by a *RST comm<strong>and</strong>.21.19 :TZONe [,]SYSTem:TZONeAn instrument which has an internal clock <strong>and</strong> can keep track of the time zone shallimplement this comm<strong>and</strong> to set the time zone.21The fields have the following meanings:: Must be a . The value shall be rounded to the nearestinteger. Range -12 to +12.:Must be a . The value shall be rounded to the nearestinteger. Range -59 to 59.When each field is subtracted from the value of the TIME comm<strong>and</strong>, the result is the correctuniversal coordinated time (also known as UCT, Zulu, Greenwich Mean Time).The default value of is zero.21-34 SYSTem:TIME


1997 SCPI Comm<strong>and</strong> ReferenceThis shall not be changed by the receipt of a *RST.21.20 :VERSion?SYSTem:VERSion?This query returns an formatted numeric value corresponding to the SCPI versionnumber for which the instrument complies. The response shall have the form YYYY.V wherethe Ys represent the year-version (i.e. 1990) <strong>and</strong> the V represents an approved revisionnumber for that year. If no approved revisions are claimed, then this extension shall be 0.An instrument known to claim SCPI compatibility that does not respond to the VERSionquery shall be assumed to conform to version 1990.0.This query shall be implemented by all instruments claiming conformance to a SCPI versiongreater than 1990.0.VERSion? is a query only <strong>and</strong> therefore does not have an associated *RST state.1234567891011121314151617181920212223242526SYSTem:VERSion? 21-35


1997 SCPI Comm<strong>and</strong> Reference2121-36 SYSTem:VERSion?


1997 SCPI Comm<strong>and</strong> Reference22 TEST SubsystemThe TEST subsystem provides a section to extend st<strong>and</strong>ard instrument self-test proceduresbeyond the IEEE 488.2 *TST comm<strong>and</strong>.1234567891011121314151617181920212223242526TEST Subsystem 22-1


1997 SCPI Comm<strong>and</strong> Reference2222-2 TEST Subsystem


TWIR01TWIR01TWIR011997 SCPI Comm<strong>and</strong> Reference23 TRACe | DATATWIR01A TRACe or a DATA area is a named entity stored in instrument memory. TRACe | DATAareas may also be used to store other types of data, such as constant arrays for use in tracearithmetic or corrections, or displayed waveforms. Alternatively, TRACe | DATA areas maybe used for equivalent scalar (single point) purposes.1Certain TRACe format <strong>and</strong> capabilities are the focus of other emerging st<strong>and</strong>ards. To 2prevent diluting the effect of SCPI or any other st<strong>and</strong>ards related to the manipulation of 3TRACes, SCPI has left such capability undefined at this time with the view to adopting anindustry st<strong>and</strong>ard when one becomes available. The undefined capabilities include the 4following:5Trace math operations for specifying arithmetic relationships between traces, 6including the use of user-defined constants <strong>and</strong> functions.7Trace activation <strong>and</strong> routing for specifying the destination for measurementresults.8KEYWORD PARAMETER FORM NOTES9TRACe|DATA 1991 TWIR0110:CATalog?[query only]:COPY , [event; no query] 1991,2 11[:DATA](|)12,(|| 1993 DIF01({,}))13:LINE,,,14, 1992 WV:PREamble? [query only] 1994 TK032a 15:VALue ,, 1992 WV16:DEFine[,(|)]17:DELete18[:NAME] [event; no query]:ALL[event; no query] 19:FEED ,(|NONE) 1991 TWIR0120:CONTrol ,(ALWays|OCONdition|NEXT|NEVer) 1991 TWIR01:OCONdition , 1991 21TWIR01:FREE?[query only]22:POINts [,] 1993 PH075:AUTO ,(|ONCE) [event; no query] 2324Many TRACe subsystem comm<strong>and</strong>s are of the following general form:TRACe:COMM<strong>and</strong> , 25The is (IEEE 488.2, section 7.7.1). 26There is no difference between uppercase <strong>and</strong> lowercase letters used in . ThereTRACe | DATA 23-1


TWIR01p21TWIR01p211997 SCPI Comm<strong>and</strong> Reference23is no short form abbreviation for . The destination trace is always the firstparameter in the list. The parameter may be an existing ,or a block, or expression which is evaluated as trace data.*RST has no effect on this subsystem.23.1 :CATalog?TRACe:CATalog?The CATalog? query returns a comma-separated list of strings which contains the names ofall traces. If there are no defined, a single empty string is returned. Someinstruments may have one or more intrinsic, permanent . These traces must belisted along with any user-named traces.23.2 :COPY , ( | )TRACe:COPYThe COPY comm<strong>and</strong> set the data values in the destination trace, from internal data stores inthe instrument. There is no query form of this comm<strong>and</strong>, it is an event only.If the data source is a , the data is copied into the destination trace. Forexample, COPY REF,TRACE1 will copy the data currently in TRACE1 into the tracenamed REF.If the data source is a , the data shall be copied directly from the data poolspecified. For example, COPY REF, “CALCulate1” will copy the data emitted by theCALCulate1 block. When the data is copied depends on the type of memory associated withthe data flow. If the memory is transient, as described in section 2.7.5, then the data shall becopied when data becomes available, for example when a new acquistion takes place. If thememory is static the data shall be copied immediately, as there is memory that always hassome value in it associated with the specified , typically the result from anearlier acquistion.23.3 [:DATA] ,(||({,}))TRACe:DATAThe DATA comm<strong>and</strong> sets the data values in the destination trace, from information providedby the controller. If the data source is a block of data, then the block is directly loaded intothe destination trace. In this case the data source is block data, the data format is determinedby the FORMat Subsystem. Note that the data source may also be a Data Interchange Formatexpression.If the data source is a single , every element of the destination trace is set tothe constant value represented by the evaluation of . For example, DATAREF,0.22361 sets all points in the REF trace to 0.22361. If a is sent foreach of the points in the allocated , then the s are mappedinto the . If an insufficient number of s are sent, that is lessthan the allocated points, then the result is device dependent. If too many sare sent the device shall generate error -223 (too much data), <strong>and</strong> the result shall be devicedependent.DIF01DIF0123-2 TRACe | DATA:CATalog?


WVWV1997 SCPI Comm<strong>and</strong> ReferenceThe DATA? query returns the data values for , according to theformat determined by comm<strong>and</strong>s in the FORMat subsystem.Note: All parentheses in the syntax for this comm<strong>and</strong> are used for grouping purposes only.23.3.1 :LINE ,,,,TRACe:DATA:LINEThe LINE comm<strong>and</strong> is an event which defines a line segment (a series of points) within theboundaries of the trace whose name is specified by . The first determines the index of the starting point in the trace. The second is the value of the trace at the starting point. The third <strong>and</strong> fourth parameters set the end of the line segment index <strong>and</strong> value. A line segmentis drawn connecting the start point <strong>and</strong> end point, inclusive. This comm<strong>and</strong> has no queryform. The index of the first point in a trace is 1.23.3.2 :PREamble? TRACe:DATA:PREamble?PREamble? returns the preamble information supporting the DATA(CURVe(VALues)) butomits the following data:DIF blocks of waveform, measurement, <strong>and</strong> delta.DIF curve block keywords VALues <strong>and</strong> CSUM <strong>and</strong> their parameters.The DIF difid block must contain the keyword SCOPe with the parameter of PREamble.While the PREamble? query is designed to efficiently transmit data relating directly to thecurve, the various notes <strong>and</strong> identification parameters may be sent if absolutely required.The parameter functions the same as it does in TRACe:DATA?.23.3.3 :VALue ,,TRACe:DATA:VALueThe VALue comm<strong>and</strong> sets or queries the value of an individual point in a trace. The first is the index of the addressed point in the trace defined by .The second is the value to be set for the point. The index of the first pointin a trace is 1.The VALue? , query returns the data value of the trace at the indexed point.23.4 :DEFine [,(|)]TRACe:DEFineThe DEFine comm<strong>and</strong> allocates <strong>and</strong> initializes a new trace. The first parameter is, <strong>and</strong> it specifies the new . If the second parameter isa , a new trace is allocated with the specified number of data elements. Thetrace shall be initialized to instrument-specified default values. If the second parameter is thename of an existing trace, the new trace becomes a copy of the existing trace in all respects,including size <strong>and</strong> contents. The data in the existing trace is not affected. When the secondDIF0112345678TK032a 910TK032a1112TK032a13TK032a1415TK032a1617181920212223242526TRACe | DATA:DEFine 23-3


HP070HP070HP070TWIR01p22HP0701997 SCPI Comm<strong>and</strong> Referenceparameter is omitted, the new trace shall have an instrument-specified default size <strong>and</strong> initialvalue.Limits on the number of named traces are instrument-specific.23.5 :DELeteTRACe:DELeteThe DELete comm<strong>and</strong>s allow the user to dissociate from trace memory.Instrument intrinsic cannot be deleted. There is no query form for the DELetecomm<strong>and</strong>s.23.5.1 [:NAME] TRACe:DELete:NAMEThe NAME comm<strong>and</strong> dissociates a user-created from its trace memory. TheNAME node is optional in a program message. That is, an instrument is required to acceptboth forms of this comm<strong>and</strong>. If the instrument supports dynamic trace memory allocation,then the memory allocated for is freed.2323.5.2 :ALLTRACe:DELete:ALLThe ALL comm<strong>and</strong> dissociates all user-created from their trace memoryunits. If the instrument supports dynamic trace memory allocation, then all memory allocatedfor user-created traces is freed.23.6 :FEED , ( | NONE )TRACe:FEEDSets or queries which data flow is fed into the specified TRACe|DATA memory. The firstparameter specifies the name of the TRACe|DATA memory. The second parameter (usedonly in the comm<strong>and</strong> form) selects the data flow to be fed into the memory.A is the name of a point in the data flow described by the Instrument Model(found at the beginning of this volume). By setting the to a null string (“”),no data shall be fed into the specified TRACe|DATA memory. When a TRACe|DATAmemory is created with the DEFine comm<strong>and</strong>, the FEED for that memoryshall be set to null (“”).The query form of this comm<strong>and</strong> requires that a valid shall be specified. If theTRACe|DATA memory specified in does not exist then an error -224, “Illegalparameter value” shall be generated. The query shall return a string that represents the selected. If no feed is selected, then the query shall return a null string (“”).At *RST, FEED shall be set to NONE.23.6.1 :CONTrol , ALWays | OCONdition | NEXT | NEVerTRACe:FEED:CONTrolSets or queries how often the specified TRACe | DATA area accepts new data. This controlhas no effect if the FEED is set to null (“”). The first parameter specifies theTRACe | DATA area, the second parameter selects how often new data shall be accepted.23-4 TRACe | DATA:DELete


TWIR011997 SCPI Comm<strong>and</strong> ReferenceBy selecting ALWays, whenever new data is available it shall be fed into the specifiedTRACe | DATA area. On CONdition defines that data shall be gated by the OCONditioncomm<strong>and</strong>. NEXT is a one-shot feed, it always waits for new data, such as an new acquistion,<strong>and</strong> ignores any existing data. Once NEXT has completed its feed of data, CONTrol revertsto NEVer. NEVer shall cause no data to be fed.At *RST, CONTrol is set to a device dependent value.23.6.2 :OCONdition , TRACe:FEED:OCONditionThe On CONdition comm<strong>and</strong> sets or queries the condition used to gate data flow into thespecified TRACe | DATA area. The first parameter specifies the TRACe | DATA area. Thesecond parameter is EXPRESSION PROGRAM DATA, which defines the condition, whichwhen evaluated to be True shall allow data to be fed through. The production is of the general form:‘(’ ‘)’ or‘(’ ‘)’The productions <strong>and</strong> , the oper<strong>and</strong> string <strong>and</strong> the equivalenceoperator respectively, shall be defined later.23.7 :FREE?TRACe:FREE?The FREE? query returns the amount of user memory space available for traces, in thefollowing form:, where the returned data for both shall be in format.23.8 :POINts [,]TRACe:POINtsThe POINts comm<strong>and</strong> sets the number of measurement data points available in the specifiedtrace memory. The first parameter specifies the name of the trace to resize. The optionalsecond parameter specifies the number of data points which the mustaccommodate. If this parameter is omitted, an instrument specific default value will be used.If more than one is associated with each trace data point (as would be thecase with a trace consisting of real <strong>and</strong> imaginary pairs), then the second parameter specifiesthe number of N-tuples in the trace.The query POINts? returns the number of measurement data points in thespecified trace. Note that each data point may have several numeric data items associatedwith it.23.8.1 :AUTO ,(|ONCE)TRACe:POINts:AUTOThe AUTO comm<strong>and</strong> turns trace autosizing ON/OFF. When it is enabled, will automatically be resize as necessary to accommodate any new data block assigned to it.In this mode of operation, changes in measurement setup will not require adjustments to the1234567891011121314151617181920212223242526TRACe | DATA:FREE? 23-5


1997 SCPI Comm<strong>and</strong> Referencesize of defined traces. If POINts:AUTO , ONCE is specified, <strong>and</strong> the tracesizing occurs once (on the next measurement). Limits on trace sizes are instrument-specific.2323-6 TRACe | DATA:POINts


1997 SCPI Comm<strong>and</strong> Reference24 TRIGger SubsystemThe trigger subsystem is used to synchronize device action(s) with events. A device actionmight be the acquisition of a measurement or the application of a stimulus. The triggersubsystem consists of the exp<strong>and</strong>ed capability model which is capable of describing verycomplex device trigger systems. It also makes provision, through the ARM-TRIGger model,for simple descriptions of less complicated trigger systems. These two models are consistent<strong>and</strong> compatible with each other. The ARM-TRIGger model represents a subset of thecapability available in the exp<strong>and</strong>ed capability model.The figures in this section that represent the trigger model adhere to the followingnomenclature. A box identifies a state of a transition diagram <strong>and</strong> is referred to as a layer. Asequence is a set of vertically connected layers. A solid line defines flow of control betweenstates. A dashed line defines how an event is propagated to other parts of the trigger model<strong>and</strong> the instrument. Events generated by control flowing from one part of the trigger modelto another part are called “sequence events.”24.1 ARM-TRIGger ModelThe ARM-TRIGger model represents a level of capability that is often found in a device <strong>and</strong>is shown in figure 24-1. The ARM-TRIGger model shows two independent levels of eventdetection, one in each of the ARM <strong>and</strong> the TRIGger layers. For a given device the modelFigure 24-1 ARM-TRIGger Model123ACQ01B 4567891011121314151617181920212223242526TRIGger Subsystem ARM-TRIGger Model 24-1


1997 SCPI Comm<strong>and</strong> Referencemay be simplified further by the omission of the ARM layer <strong>and</strong> any inappropriatecomm<strong>and</strong>s for that device.24.2 Model LayersThe following figures detail each of the various types of layers that may exist in a sequence.Each layer is shown with a dotted line, which is used to divide the upward <strong>and</strong> downwardtraverses through the layer. The different traverses are referenced in describing the operationof each layer.24.2.1 IDLE StateOn receipt of either *RST or ABORt, the trigger subsystem shall enter the IDLE state.Receiving the IEEE 488.2 dcas message may also cause a transition to IDLE. Devices whichcannot process comm<strong>and</strong>s when not in IDLE must enter IDLE when dcas is received to meetthe IEEE 488.2 requirements for device clear. The downward traverse from IDLE state,“trigger system initiated,” is affected by either the INITiate[:IMMediate] comm<strong>and</strong> or bysetting INITiate:CONTinuous to ON.Figure 24-2 IDLE State24If the INITiate comm<strong>and</strong>s are implemented as overlapped, exiting the IDLE state shall causethe pending operation flag (as defined by IEEE 488.2) associated with the initiated action tobe set true. Entering the IDLE state shall cause the pending operation flag to be set false.24.2.2 InitiatedOnce the trigger sequence is initiated from the IDLE state, control passes through theINITiated state, shown in Fig 24-3, immediately making the downward traverse to thehighest ARM:LAYer state. The upward traverse is dependent on the setting of CONTinuous.If CONTinuous is set to OFF then the upward transition to the IDLE state shall be made.Otherwise, the downward traverse to the highest ARM:LAYer state shall be made, so thatthe trigger sequence remains initiated. If the sequence does not contain any ARM layers, thedownward transition goes to a TRIGger state.KI005ACQ01B24-2 TRIGger Subsystem Model Layers


1997 SCPI Comm<strong>and</strong> ReferenceThe INITiated state is necessary to avoid having the pending operation flag change stateevery time the entire trigger sequence is completed when CONTinuous is ON. On exit fromthe INITiated state, in both directions, a “sequence event” is generated. These events may beused to start actions in the trigger subsystem or actions in other parts of the instrument.Fig 24-3 shows the names of these events. An instrument shall implement the initiated stateeven if it implements the INITiate comm<strong>and</strong>s as sequential.Figure 24-3 INITiated State24.2.3 Event Detection LayerThe ARM <strong>and</strong> TRIGger layers are both event detection layers with the TRIGger layer beingsubservient to the ARM layer. Each layer provides one level of event detection.The downward traverse through an event detection layer depends on the sourced event beingdetected the specified number of times. Typically, the first event detected after entering theevent detection layer is all that is required to proceed. However, a particular number ofoccurrences of the same event may be specified using ECOunt; for example, wait for thetenth positive edge of a signal. The downward traverse is also subject to a time delay if one isspecified.Two comm<strong>and</strong>s override the normal process of the downward traverse. The layer namefollowed by :IMMediate causes the event detection <strong>and</strong> the subsequent delay to be bypassed.The layer name followed by :SIGNal causes the device to proceed as though a single eventhad occurred.On exit from the ARM or TRIGger state, in either direction, a “sequence event” is generated.These events may be used to start actions in the trigger subsystem or in other parts of theinstrument. An action may not be associated with every “sequence event.”ACQ01B,KI005123456789101112131415161718192021222324ACQ01B 2526TRIGger Subsystem Model Layers 24-3


1997 SCPI Comm<strong>and</strong> ReferenceThe upward traverse is dependent upon the event detector being satisfied <strong>and</strong> the value ofCOUNt for the given layer. The event detector in the upward traverse is used to detect whenan action started by the exit from this layer on the downward traverse has completed. Thisevent detector has no comm<strong>and</strong>s associated with it, <strong>and</strong> it is only included in the model toprevent the trigger system from looping around until the “device action” associated with thegiven layer has completed.When COUNt is greater than one, all of the subservient layers are cycled repeatedly COUNttimes. For example, to make five measurements, each qualified by the same combination ofARM <strong>and</strong> TRIGger events, the COUNt in the ARM layer should be set to 5. Each time theARM layer is entered from below, the flow is redirected to follow the downward traverse.After the fifth cycle, when COUNt is satisfied, the upward traverse to the initiated state ismade.ACQ01B24Figure 24-4 Event Detection Layer24.3 Sequence Event UseIn the ARM-TRIGger model shown in Fig 24-1, the “sequence event” generated by theTRIGger layer is shown starting a “device action.” The “device action” is dependent on thesettings of the SENSe or SOURce subsystems, for example by the FUNCtion selected. Thesettings of the SENSe <strong>and</strong> SOURce subsystems are in general device dependent <strong>and</strong>24-4 TRIGger Subsystem Sequence Event UseACQ01B


1997 SCPI Comm<strong>and</strong> Referencetherefore, the “device action” tied to a “sequence event” is also device dependent. Forexample, in one instrument the event may be used to generate a signal <strong>and</strong> in anotherinstrument it may be used to make a measurement.Further, the completion of a device action itself is device dependent. For example, the deviceaction could be defined as executing a complete sweep, or it could be defined as initiating asweep. These device actions would signal their completion at different times <strong>and</strong>consequently, would permit the upward transistion through the layer at different times.Where an instrument permits control of the characteristics of a device action, the comm<strong>and</strong>sfor that control shall appear in the subsystem employing the event. In the earlier example, acomm<strong>and</strong> to differentiate between initiating a sweep <strong>and</strong> executing a complete sweep wouldexist with the comm<strong>and</strong>s that control the other characteristics of the sweep.The name of a “sequence event” reflects where it was generated. Its form is“(INITiate|TRIGger)([:SEQuence[1]]|:SEQuence|:)([:DOWN]|:UP)”or“ARM([:SEQuence[1]]|:SEQuence|:)([:LAYer[1]]|:LAYer)([:DOWN]|:UP)”Note: Parentheses used here are for grouping <strong>and</strong> not literals. The syntax of a sequence eventis the same as the syntax of the instrument-control header.It includes the direction of traverse, the layer, <strong>and</strong> the sequence. The use of defaults,however, allows some short aliases. “ARM” is equivalent to“ARM:SEQuence1:LAYer1:DOWN”.24.4 Exp<strong>and</strong>ed Capability Trigger ModelFig 24-5 is an example of an exp<strong>and</strong>ed capability trigger model. An instrument couldimplement a more extensive or simpler trigger system. The purpose of the figure is toillustrate concepts. A picture of all possible configurations is not possible.The exp<strong>and</strong>ed capability trigger model exp<strong>and</strong>s upon the ARM-TRIGger model to meetmore complex needs through additional “Event Detection Layers” as shown in Fig 24-4.These additional layers give extra levels of event detection which provide more qualificationto a particular action, or establish more “sequence events” to synchronize many actionswithin an instrument. Any number of “Event Detection Layers” may be included asadditional ARM layers, as shown in Fig 24-5. A single trigger layer still exists in theexp<strong>and</strong>ed capability model.Multiple sequences may exist in the exp<strong>and</strong>ed capability model to describe concurrentlyoperating trigger conditions, also shown in Fig 24-5. Any number of sequences arepermitted. Sequences may have the same or a different number of layers. Some of thesequences may have aliases. These aliases are used where the sequence is performing ast<strong>and</strong>ard trigger operation. Multiple sequences may be synchronized by linking “sequenceevents” of one sequence to the event detector of another sequence. Some of the st<strong>and</strong>ardsequences interact in a pre-defined manner which saves creating unnecessary links <strong>and</strong>complicating the model for the st<strong>and</strong>ard sequences.ACQ01B12345ACQ01B 67891011ACQ01B121314ACQ01B 1516ACQ01B 1718192021ACQ01B 2223242526TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger Model 24-5


1997 SCPI Comm<strong>and</strong> ReferenceAn IDLE state is shown with each sequence. The comm<strong>and</strong>s *RST <strong>and</strong> ABORt place allsequences immediately in their IDLE states. A device clear shall put the sequences to theirIDLE states if the device is unable to parse another comm<strong>and</strong> without aborting the triggersubsystem (non-overlapped operation). Not aborting the initiated sequences is preferable ifthe parser can be cleared by a device clear so it can process a comm<strong>and</strong>.ACQ01BFigure 24-5 Exp<strong>and</strong>ed Capability Trigger Model2424.4.1 LAYer NomenclatureEach state in the trigger subsystem is made unique by its position determined by its row <strong>and</strong>column. In the trigger subsystem each column is called a SEQuence. The rows are labelled ina different manner to maintain compatibility with the ARM-TRIGger model. The lowest rowis called the TRIGger layer. The next one up in called the first ARM layer. The third layerfrom the bottom is called the second ARM layer.The for a particular state is determined from its SEQuence, whether it is anARM or a TRIGger layer, <strong>and</strong> finally the LAYer number if it is an ARM layer. In Figure24-5, the layer in the lower left most position is TRIGger[:SEQuence[1]]. Because it is inSEQuence1, SEQuence is optional <strong>and</strong> may be omitted . For this layer, TRIGger issufficient, <strong>and</strong> is the name used in the ARM-TRIGger model. SEQuence[1] also has the aliasSTARt. This layer’s name is also TRIGger:STARt.The SEQuence number increases from left to right, <strong>and</strong> other SEQuences may have aliasesas well. The layer to the right of TRIGger:SEQuence1 is TRIGger:SEQuence2, which mayalso have the sequence alias TRIGger:STOP. The layer above TRIGger:STARt isARM[:SEQuence[1]][:LAYer[1]], which may be abbreviated to just ARM as LAYer1, as24-6 TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger ModelACQ01BACQ01BACQ01B


1997 SCPI Comm<strong>and</strong> Referencewell as SEQuence1, is the default. The next layer up is ARM[:SEQuence[1]]:LAYer2. TheLAYer number increases from the lowest ARM layer to the top.The “sequence event” names reflects the <strong>and</strong> whether it occurred on the up ordownward traverse. Thus, the event used in the ARM-TRIGger model to start the “deviceaction” is TRIGger[:SEQuence[1]][:DOWN]. The events related to the INITiated state areINITiated[:DOWN] <strong>and</strong> INITiated:UP.24.4.2 St<strong>and</strong>ard SEQuencesSCPI describes the behavior of SEQuences which have specific names. An instrument is notrequired to implement any of these sequences, but any sequence given one of these namesshall behave as described.STARtThe STARt sequence exists to provide pre-qualification to a “device action.”This sequence shall leave IDLE when an INITiate:IMMediate:ALL orINITiate:CONTinuous:ALL ON is given. If the STARt is implemented thenit shall exist as an alias to SEQuence[1].STOP The STOP sequence allows the user to force the currently initiatedsequences to IDLE on a particular event or series of events. All SEQuencesshall go to IDLE upon “INITiated:STOP:UP”.The STOP sequence shall not leave IDLE when an INITiate:IMMediate:ALL orINITiate:CONTinuous:ALL ON is given, but shall leave IDLE upon“INITiate:STARt:DOWN”. This means that STOP is subservient to STARt in the way theSTOP sequence leaves IDLE. All sequences, however, are subservient to STOP because thesequence event from STOP affects all other sequences.For those instruments that implement STARt as an alias for SEQuence[1], or implementSTARt as an alias for SEQuence[1] <strong>and</strong> STOP as an alias for SEQuence2, the ARM <strong>and</strong>TRIGger SEQuence:DEFine comm<strong>and</strong> <strong>and</strong> query are not required. Those instruments thatemploy a different mapping, whether the mapping is fixed or user definable, or use otheraliases shall implement the DEFine comm<strong>and</strong> <strong>and</strong> query for all sequences that exist.24.4.3 Subservient SequencesWhen an event from one sequence controls the initiation of another sequence, the secondsequence is subservient to the first. The “device action” of a sequence initiates anothersequence.An instrument may implement any number of sequences depending on its needs <strong>and</strong>capabilities. The names for the sequences should reflect the application of an instrument.Naming sequences requires implementing the SEQuence:DEFine comm<strong>and</strong>.Each subservient sequence has IDLE <strong>and</strong> INITiated states like other sequences. TheINITitated state of a subservient sequence does not, however, check the setting ofINITiate:CONTinuous. It merely exits out the top. This state is included so the event,INITiate:SEQuence:UP, is available for all sequences. The IDLE state of a subservientsequence does not check either the setting of INITiate:CONTinuous or for the arrival ofACQ01B123ACQ01B45ACQ01B678ACQ01B910ACQ01B 11121314ACQ01B15161718ACQ01B 192021ACQ01B2223HP097242526TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger Model 24-7


1997 SCPI Comm<strong>and</strong> ReferenceINITiate[:IMMediate]. It does, however, check for an event from a connected sequence asshown in Figure 24-6.Figure 24-6 Subservient Sequences24Fig 24-6 illustrates how several sequences could be organized in a subservient manner. Anactual instrument would probably have more or fewer than four. It might also use differentsequence names for the same device actions being controlled.VECTorSVECtorSAMPleIn this example, the VECTor sequence is used to control the pacing of wholevectors such as when generating or acquiring a waveform. Multiple VECTorsequences could exist, each distinguished by a numeric suffix. SeveralVECTor sequences would be used for multiple nested sweeps to generate asurface. For example, sweeping the power level at each point in a frequencysweep. The controls of the VECTor sequence often are coupled to either theSENSe:SWEep or SOURce:SWEep subsystems. Changing SWEep:DWEll<strong>and</strong> SWEep:TIMe might change TIMer <strong>and</strong> DELay values.This Sub VECtor sequence is used to control the pacing of collections ofsamples used to create a VECTor. Sub VECtors are useful in acquistioninstruments where whole vectors are averaged. The settings in such a casewould be coupled to the SENSe:AVERage subsystem.The SAMPle sequence is used to control the pacing of each sample. ASAMPle is a single point in the SVECtor.ACQ01BACQ01BACQ01BACQ01B24-8 TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger Model


1997 SCPI Comm<strong>and</strong> ReferenceSSAMpleThe Sub SAMple sequence is used to control the pacing of steps needed tocreate a sample. Sub SAMple is used where a SAMPle point is composed ofmore than one acquistion on generation point.SSAMple is subservient to SAMPle; SSAMple exits IDLE upon TRIGger:SAMPle:DOWN.The upward event detector in TRIGger:SAMPle is linked to INITiated:SSAMple:UP.Similarly, SAMPle is subservient to SVECtor <strong>and</strong> SVECtor is subservient to VECTor.Further, VECTor is subservient to VECTor2. This relationship is shown is Fig 24-6. Thenames <strong>and</strong> number of subservient sequences may vary between instruments, but the structureis the same.ACQ01BACQ01B1234567891011121314151617181920212223242526TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger Model 24-9


TEK0071997 SCPI Comm<strong>and</strong> Reference◆◆The keywords ABORt, ARM, INITiate, <strong>and</strong> TRIGger are at the root level in the comm<strong>and</strong>hierarchy. They are grouped here because of their close functional relationships.◆◆KEYWORD PARAMETER FORM NOTESABORt [no query] 1991ARM 1991 TEK007[:SEQuence] 1994 ACQ01B:DEFine 1994 ACQ01B:MGRules 1994 TK028A[:LAYer]:COUNt :COUPling AC|DC:DELay :AUTO |ONCE:ECL[no query]:ECOunt :FILTer 1991 TWOS03:HPASs 1991 TWOS03FREQuency 1991 TWOS03[:STATe] 1991 TWOS03[:LPASs] 1991 TWOS03FREQuency 1991 TWOS03[:STATe] 1991 TWOS03:HYSTeresis [:IMMediate][no query]:LEVel :AUTO | ONCE 1994TK03624:LINK TWIR01p24:PROTocol 1994 HP093:VXI SYNChronous|SSYNchronous|ASYNchronous 1994 HP093:SIGNal[no query]TK035:SLOPe POSitive|NEGative|EITHer:SOURce AINTernal|BUS|ECLTrg|EXTernal|HOLD 1995 TK040|IMMediate|INTernal|LINE|LINK|MANual|OUTPut|TIMer|TTLTrg:TIMer :TTL[no query]:TYPE EDGE | VIDeo 1994:VIDeo 1994:FIELd 1994[:NUMBer] 1994:SELect ODD | EVEN | ALL | NUMBer 1994:FORMat 1994:LPFRame 1994:LINE 1994,5TK035TK035TK035TK035TK035TK035TK035TK035 TK04524-10 TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger Model


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTESTK045[:NUMBer] 1995:SELect ALL | NUMBer 1995 TK045:SSIGnal 1994 TK035[:POLarity] POSitive | NEGative 1994 TK0351INITiate 1991 TEK0:CONTinuous 2[:ALL] 1994 ACQ01B3:NAME , 1994 ACQ01B:SEQuence 1994 ACQ01BTEK04[:IMMediate][no query]5[:ALL] [no query] 1994 ACQ01B:NAME [no query] 1994 ACQ01B 6:SEQuence [no query] 1994 ACQ01B7:POFLag INCLude | EXCLude 1995 TK038TRIGger 1991 TEK08[:SEQuence] 1994 ACQ01B9:ATRigger 1994 TK027[:STATe] 1994 10 TK027:COUNt :COUPling AC|DC11:DEFine 1994 ACQ01B 12:MGRules 1994 TK028A13:DELay :AUTO |ONCE14:ECL[no query]:ECOunt :FILTer 19911516TWOS:HPASs 1991 TWOS17:FREQuency 1991 TWOS[:STATe] 1991 18TWOS[:LPASs] 1991 TWOS19:FREQuency 1991 TWOS[:STATe] 1991 20TWOS:HOLDoff 1994 TK02121:HYSTeresis [:IMMediate][no query]22:LEVel 23:AUTO | ONCE 1994 TK036:LINK TWIR0124:PROTocol 1994 HP093:VXI SYNChronous|SSYNchronous|ASYNchronous 1994 25 HP093:SIGNal[no query]:SLOPe POSitive|NEGative|EITHer26TRIGger Subsystem Exp<strong>and</strong>ed Capability Trigger Model 24-11


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:SOURce AINTernal|BUS|ECLTrg|EXTernal|HOLD 1995|IMMediate|INTernal|LINE|LINK|MANual|OUTPut|TIMer|TTLTrg:TIMer :TTL[no query]:TYPE EDGE | VIDeo 1994:VIDeo 1994:FIELd 1994[:NUMBer] 1994:SELect ODD | EVEN | ALL | NUMBer 1994:FORMat 1994:LPFRame 1994:LINE 1994,5[:NUMBer] 1995:SELect ALL | NUMBer 1995:SSIGnal 1994[:POLarity] POSitive | NEGative 1994TK040TK035TK035TK035TK035TK035TK035TK035TK035 TK045TK045TK045TK035TK0352424.5 ABORtABORt24.6 ARMARMThe ABORt comm<strong>and</strong> resets the trigger system <strong>and</strong> places all trigger sequences in the IDLEstate. Any actions related to the trigger system that are in progress, such as a sweep oracquiring a measurement, shall also be aborted as quickly as possible. The ABORt comm<strong>and</strong>shall not be considered complete until all trigger sequences are in the IDLE state. Theexecution of an ABORt comm<strong>and</strong> shall set false the pending operation flags that were set bythe initiation of the trigger system.This comm<strong>and</strong> is an event <strong>and</strong> has no associated *RST condition or query form.The purpose of the ARM subsystem is to qualify a single event or a sequence of eventsbefore enabling the TRIGger. The ARM subsystem for a given sequence may be omitted ifTRIGger does not require additional qualification by other events.24.6.1 [:SEQuence]ARM:SEQuenceSEQuence is used in the exp<strong>and</strong>ed capability model to identify a particular sequence oflayers in the trigger system. A , see 24.4.2, may also be used here.24.6.1.1 :DEFine ARM:SEQuence:DEFineSets or queries the SEQuence alias. This comm<strong>and</strong> is required where aliases are employed<strong>and</strong> they do not correspond to the st<strong>and</strong>ard mapping. The numeric suffix on SEQuencecorresponds to the sequence number to which the alias is to be applied.24-12 TRIGger Subsystem ABORtACQ01BACQ01B


1997 SCPI Comm<strong>and</strong> ReferenceThis comm<strong>and</strong> is an alias to TRIGger:SEQuence:DEFine. Changing the value ofARM:SEQuence:DEFine changes the value of TRIGger:SEQuence:DEFine to the samevalue.The is character data.The effect of is modified by DEFine:MGRules as follows:Regardless of the state or presence of DEFine:MGRules, there is no differencebetween uppercase <strong>and</strong> lowercase letters used in .If the comm<strong>and</strong> DEFine:MGRules is absent or set to OFF, thefull as written is the only form allowed.For example, if the were SAMPLE1, then SAMPLE1 is theonly alias accepted.If the comm<strong>and</strong> DEFine:MGRules is present <strong>and</strong> set to ON, the is interpreted as []where all the contiguous trailing digits form the . Mnemonicgeneration rules as described in <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, Section 6.2.1. shall apply to the <strong>and</strong> the .For example, if the were defined as VECTOR or VECTOR1,then VECT, VECT1, VECTOR, <strong>and</strong> VECTOR1 would all be acceptable aliases.If the is identical to a keyword under ARM or TRIGger subsystem, thedevice shall report execution error -224. For example ARM:SEQuence2:DEFine FILTERwill cause an error. This comm<strong>and</strong> shall accept any other valid character program data for.The query returns a string which contains the , so that a null string canindicate that nothing is defined.If the comm<strong>and</strong> DEFine:MGRules is present <strong>and</strong> set to ON, the returned will follow the upper/lower case convention described in <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, section 5.1,Interpreting Comm<strong>and</strong> Tables. An omitted or a of 1will be represented as [1].For example, if is VECTOR1 then the response is “VECTor[1]”; if it isDELAYED2, the response is “DELayed2”; if it is SAMPLE, the response is “SAMPle[1]”.By executing this comm<strong>and</strong> the previously defined name is overwritten.*RST has no effect on the defined name.24.6.1.1.1 MGRules ARM:SEQuence:DEFine:MGRulesThis comm<strong>and</strong> sets or queries the state of MGRules, Mnemonic Generation Rules.At *RST, the value of this parameter is OFF.ACQ01BTK028A1TK028A2TK028A3TK028A 4567TK028A8910111213ACQ01B141516ACQ01B17TK028A 181920TK028A 2122ACQ01B23ACQ01B2425TK028A 26TK028ATRIGger Subsystem ARM 24-13


FL0031997 SCPI Comm<strong>and</strong> Reference24.6.1.2 [:LAYer]ARM:SEQuence:LAYerLAYer is used in the exp<strong>and</strong>ed capability model to identify a particular ARM LAYer in thetrigger system.2424.6.1.2.1 :COUNt ARM:SEQuence:LAYer:COUNtCOUNt controls the path of the trigger system in the upward traverse of the event detectionlayer, shown in figure 24-4, “Event Detection Layer.” The trigger system is directed either tothe next layer up or to loop back through the downward traverse. Moving to the next layer upoccurs when the number of times that the trigger system has passed through the downwardtraverse (given by the value of loop_ctr) is equal to the specified COUNt. In the simple case,COUNt has the value 1, a single downward traverse through the layer occurs, followed bythe actions dictated by subservient layers, <strong>and</strong> finally a single upward traverse to next layerup. COUnt shall be set to a value of 1 or greater.At *RST, this value is set to 1.24.6.1.2.2 :COUPling AC|DCARM:SEQuence:LAYer:COUPlingCOUPling only has effect if the source for the event detector is an analog electrical signal,such as INTernal, LINE, or EXTernal. It selects AC or DC coupling for the SOURced signal.DC coupling allows the signal’s AC <strong>and</strong> DC components to pass. AC coupling passes onlythe signal’s AC component.At *RST, this value is device-dependent.24.6.1.2.3 :DELay ARM:SEQuence:LAYer:DELayDELay sets the time duration between the recognition of an event(s) <strong>and</strong> the downward exitof the specified layer. DELay must be either zero or a positive value. An attempt to set it to anegative value shall cause an error -222 to be generated.At *RST, this value is set to 0 or the smallest available positive value. The units for DELayare seconds.24.6.1.2.3.1 :AUTO |ONCEARM:SEQuence:LAYer:DELay:AUTOThis comm<strong>and</strong> is used for sensor devices with internal settling delays. If ON, the delay is setto the minimum necessary to ensure that a valid measurement can be acquired. This valuemay be coupled to other instrument settings such as function, range, resolution, <strong>and</strong> inputb<strong>and</strong>width.At *RST, AUTO is set ON.24-14 TRIGger Subsystem ARM


TWOSTWOSTWOSTWOSTWOSTWOSTWOS1997 SCPI Comm<strong>and</strong> Reference24.6.1.2.4 :ECLARM:SEQuence:LAYer:ECLThis comm<strong>and</strong> is an event which presets LEVel, HYSTeresis, COUPling, <strong>and</strong> DELay tovalues appropriate for a ECL signal. This comm<strong>and</strong> cannot be queried.24.6.1.2.5 :ECOunt ARM:SEQuence:LAYer:ECOuntECOunt specifies a particular number of occurrences of the same event that must berecognized. For example where it is necessary to wait for the tenth positive edge of a signal,ECOunt must be set to 10. ECOunt must be a positive value of 1 or greater. An attempt to setit differently shall cause an error -222 to be generated.At *RST, this value is set to 1.24.6.1.2.6 :FILTerARM:SEQuence:LAYer:FILTerThis function allows a filter to be inserted between the source switch <strong>and</strong> event detector.FILTer only has effect if :SOURce is an analog switch such as INTernal, EXTernal, or LINE.24.6.1.2.6.1 :HPASsARM:SEQuence:LAYer:FILTer:HPASsControls the high pass filter.24.6.1.2.6.1.1 :FREQuency ARM:SEQuence:LAYer:FILTer:HPASs:FREQuencyDetermines the cutoff frequency of the high pass filter. Default units are Hertz.At *RST, this value is device-dependent.24.6.1.2.6.1.2 [:STATe] ARM:SEQuence:LAYer:FILTer:HPASs:STATeTurns the high pass filter ON or OFF.At *RST, this value is device-dependent.24.6.1.2.6.2 [:LPASs]ARM:SEQuence:LAYer:FILTer:LPASsControls the low pass filter.24.6.1.2.6.2.1 :FREQuency ARM:SEQuence:LAYer:FILTer:LPASs:FREQuencyDetermines the cutoff frequency of the low pass filter. Default units are Hertz.At *RST, this value is device-dependent.24.6.1.2.6.2.2 [:STATe] ARM:SEQuence:LAYer:FILTer:LPASs:STATeTurns the low pass filter ON or OFF.At *RST, this value is device-dependent.1234567891011121314151617181920212223242526TRIGger Subsystem ARM 24-15


TWOS031997 SCPI Comm<strong>and</strong> Reference2424.6.1.2.7 :HYSTeresis ARM:SEQuence:LAYer:HYSTeresisHYSTeresis is a qualifier of LEVel. It sets how far a signal must fall below LEVel before arising edge can again be detected, <strong>and</strong> how far a signal must rise above LEVel before afalling edge can again be detected. Its function is to eliminate false events caused by signalnoise. Units for the parameter default to the current amplitude units.In instruments that have only two discrete values for hysteresis (such as Noise Rejection On<strong>and</strong> Noise Rejection Off), the device designer should pick two numeric values thatapproximate the actual hystereis settings. The :HYSTeresis comm<strong>and</strong> has no :STATefunction because confusion would occur when turning hysteresis off. This might imply to auser that the actual hysteresis had been set to 0. This is rarely the case in instruments thathave only two states.At *RST, this value is device-dependent.24.6.1.2.8 [:IMMediate]ARM:SEQuence:LAYer:IMMediateThis comm<strong>and</strong> provides a onetime override of the normal process of the downward traverseof the event detection layer. This comm<strong>and</strong> shall cause the immediate exit of the specifiedevent detection layer if the trigger system is in the specified layer when the IMMediate isreceived. Otherwise, the IMMediate comm<strong>and</strong> shall be ignored <strong>and</strong> an error -212 shall begenerated.The actual event detection <strong>and</strong> delay shall be skipped; however, normal processing of theloop_ctr as shown in figure 24-4, “Event Detection Layer” shall occur. This comm<strong>and</strong> has noeffect on any other settings in this subsystem.This comm<strong>and</strong> is an event <strong>and</strong> has no *RST condition <strong>and</strong> cannot be queried.24.6.1.2.9 :LEVel ARM:SEQuence:LAYer:LEVelLEVel qualifies the characteristic of the selected SOURce signal that generates an event.LEVel only has effect if the source for the event detector is an analog electrical signal, suchas INTernal, LINE, or EXTernal. Units for the parameter default to the current amplitudeunit.At *RST, this value is instrument-dependent.24.6.1.2.9.1 :AUTO | ONCEARM:SEQuence:LAYer:LEVel:AUTOWhen AUTO is ON, the device dynamically selects the best arm level based on adevice-dependent algorithm applied to the arm signal.When AUTO is OFF, the arm LEVel sets the arm level.Setting AUTO to ONCE turns AUTO ON, adjusts the arm level once <strong>and</strong> then resets AUTOto OFF.TK036TK036TK036TK03624-16 TRIGger Subsystem ARM


TWIR01 JP ChaHP01997 SCPI Comm<strong>and</strong> ReferenceSetting the arm LEVel turns AUTO OFF.At *RST, the value of this parameter is OFF.24.6.1.2.10 :LINK ARM:SEQuence:LAYer:LINKSets or queries the internal event that is LINKed to the event detector in the ARM layer.Internal events occur throughout all of the Instrument Model, a particular implementationwill dictate which events are available to this LINK comm<strong>and</strong>. The isSTRING PROGRAM DATA <strong>and</strong> it is defined further in the Instrument Model, Chapter 2.An Example of events that are commonly used, are the events that occur when a particularlayer is exited, these h<strong>and</strong>les are of the form:“ARM[:SEQuence[:LAYer]]” or “TRIGger[:SEQuence]”Other common examples include completion of a process in a block or an instrument statetransition.At *RST, this value is device-dependent.24.6.1.2.11 PROTocolARM:SEQuence:LAYer:PROTocolThis subsystem controls the protocol used with the selected source.24.6.1.2.11.1 VXI SYNChronous|SSYNchronous|ASYNchronousARM:SEQuence:LAYer:PROTocol:VXIThis comm<strong>and</strong> selects the trigger protocol for the VXI TTLTrg or ECLTrg trigger line whenused as the arm source. The protocols are specified in the VXI Bus System Specificationunder sections B.6.2.3 <strong>and</strong> B.6.2.4.SYNChronous selects the synchronous trigger protocol.SSYNchronous selects the semi-synchronous trigger protocol.ASYNchronous selects the asynchronous trigger protocol.At *RST, the SYNChronous protocol is selected.24.6.1.2.12 :SIGNalARM:SEQuence:LAYer:SIGNalThis comm<strong>and</strong> provides a one-time override of the normal process of the downward traversethrough the event detector in figure 24-4, “Event Detection Layer.” This comm<strong>and</strong> shallcause the immediate exit of the event detector block in the specified event detection layer ifthe trigger system is waiting for the event specified by the SOURce comm<strong>and</strong>. Otherwise,the SIGNal comm<strong>and</strong> shall be ignored <strong>and</strong> an error -212 shall be generated.Only the event detector block is bypassed. Normal processing of the delay <strong>and</strong> the event_ctras shown in figure 24-4, “Event Detection Layer,” shall occur. This comm<strong>and</strong> has no effecton any other settings in this subsystem.TK036TK03612345678910 HP09311 HP09312 HP09313HP093141516 HP09317 HP09318 HP09319 HP09320212223242526TRIGger Subsystem ARM 24-17


1997 SCPI Comm<strong>and</strong> Reference24This comm<strong>and</strong> defines an event, <strong>and</strong> as such does not have an associated query form or*RST condition.24.6.1.2.13 :SLOPe POSitive|NEGative|EITHerARM:SEQuence:LAYer:SLOPeSLOPe qualifies whether the event occurs on the rising edge, falling edge, or either edge ofthe signal.At *RST, this value is set to POS.24.6.1.2.14 :SOURce ARM:SEQuence:LAYer:SOURceThis comm<strong>and</strong> selects the source for the event detector. Only one source may be specified ata time for a given event detector. The various sources are:AINTernal — The triggering source is selected automatically by the instrumentfrom internal algorithms to best match the current operating mode. An AutomaticINTernal event is derived from measurement functions <strong>and</strong>/or sensor capabilitiesin the signal conditioning block.BUS — The source is signal specific to the control interface. For IEEE 488.1, thegroup execute trigger, GET, would satisfy this condition. In VXI the word serialcomm<strong>and</strong> TRIGger performs this function. The event detector is also satisfied,independent of the interface, when a *TRG comm<strong>and</strong> is received. Note thatneither GET nor *TRG can be sent without having an effect on the messageexchange protocol described in IEEE 488.2.ECLTrg — The signal source is the specified VXI P2 or P3 backplane ECLTrgTRIGGER line. Valid lines are ECLTrg0 <strong>and</strong> ECLTrg1 on P2, <strong>and</strong> ECLTrg2through ECLTrg5 on P3.EXTernal — An external signal jack is selected as the source. If no suffix isspecified, EXTernal1 is assumed.HOLD — The event detection is disabled. However, the IMMediate comm<strong>and</strong>shall override HOLD.IMMediate — No waiting for an event occurs.INTernal — An internal channel is selected as the source. An INTernal event isderived from a measurement function <strong>and</strong>/or sensor capability in the signalconditioning block. If no suffix is specified, INTernal1 is assumed.LINE — The source signal is determined from the AC line voltage.LINK — The source for the event detector is specified by the LINK comm<strong>and</strong>.MANual — The signal is user-generated, such as by pressing a front panel key.OUTPut — The signal source is taken from an output channel. If no channel isspecified, OUTPut1 is assumed.TK040TWV41C24-18 TRIGger Subsystem ARM


1997 SCPI Comm<strong>and</strong> ReferenceTIMer — The source signal comes from a periodic timer. The period of the timeris specified by the TIMer comm<strong>and</strong>.TTLTrg — The signal source is the specified VXI P2 backplane TTLTrgTRIGGER line. Valid lines are TTLTrg0 through TTLTrg7.At *RST, IMMediate shall be selected as the SOURce. This value was chosen so thatdevices that do not implement any ARM layers (<strong>and</strong> hence the controls for the ARM layer)behave at *RST in the same manner as devices that do.24.6.1.2.15 :TIMer ARM:SEQuence:LAYer:TIMerTIMer sets the period of an internal periodic signal source. Its value affects the triggersystem only when it is selected as the SOURce for the event detector. TIMer must be apositive value. An attempt to set it differently shall cause an error -222 to be generated. Thesynchronization of the timer’s period is device-dependent.At *RST, this value is device-dependent value. The default units for this value is seconds.24.6.1.2.16 :TTLARM:SEQuence:LAYer:TTLThis comm<strong>and</strong> is an event which presets LEVel, HYSTeresis, COUPling, <strong>and</strong> DELay tovalues appropriate for a TTL signal. This comm<strong>and</strong> cannot be queried.24.6.1.2.17 :TYPE EDGE | VIDeoARM:SEQuence:LAYer:TYPESets or queries the type of triggering.At *RST, the value of this parameter is EDGE.24.6.1.2.18 :VIDeoARM:SEQuence:LAYer:VIDeoThis subsystem controls parameters necessary to trigger on video signals.24.6.1.2.18.1 :FIELdARM:SEQuence:LAYer:VIDeo:FIELdThis subsystem selects the video field to trigger on.24.6.1.2.18.1.1 [:NUMBer] ARM:SEQuence:LAYer:VIDeo:FIELd:NUMBerNUMBer sets or queries the field number to trigger on if FIELd:SELect is set to NUMBer.At *RST, the value of this parameter is 1.24.6.1.2.18.1.2 :SELect ODD | EVEN | ALL | NUMBerARM:SEQuence:LAYer:VIDeo:FIELd:SELectSELect sets or queries the video field selection method to be used. Four character dataparameters are defined as follows:123456789101112TK03513TK03514TK03515TK0351617 TK03518 TK03519TK03520TK0352122 TK03523 TK03524 TK03525TK03526TRIGger Subsystem ARM 24-19


1997 SCPI Comm<strong>and</strong> Reference24ODD selects odd-numbered fields to trigger on.EVEN selects even-numbered fields to trigger on.ALL triggers on all fields regardless of number.NUMBer triggers on the field number specified by NUMBer.At *RST, the value of this parameter is ALL.24.6.1.2.18.2 :FORMatARM:SEQuence:LAYer:VIDeo:FORMatFORMat controls parameters that allow the video trigger system to respond to signals fromst<strong>and</strong>ard video formats.24.6.1.2.18.2.1 :LPFRame ARM:SEQuence:LAYer:VIDeo:FORMat:LPFRameLPFRame, Lines Per FRame, sets or queries the lines per frame associated with the signalformatting st<strong>and</strong>ard being used.For example, A signal following NTSC would selects 525 lines per frame while a PALsignal would select 625 lines per frame.At *RST, the value of this parameter is device dependent.24.6.1.2.18.3 :LINEARM:SEQuence:LAYer:VIDeo:LINEThis subsystem selects a particular line in the field to arm on.24.6.1.2.18.3.1 [:NUMBer] ARM:SEQuence:LAYer:VIDeo:LINE:NUMBerNUMBer sets or queries the line number to arm on if LINE:SELect is set to NUMBer.Setting the NUMBer value has no effect on the value of the SELect parameter.At *RST, the value of this parameter is device dependent.24.6.1.2.18.3.2 :SELect ALL | NUMBerARM:SEQuence:LAYer:VIDeo:LINE:SELectSELect sets or queries the video line selection method to be used. Two character dataparameters are defined as follows:ALL — arms on all lines regardless of number.NUMBer — arms on the line number specified by NUMBer.At *RST, the value of this parameter is ALL.24.6.1.2.18.4 :SSIGnalARM:SEQuence:LAYer:VIDeo:SSIGnalSSIGnal, Synchronizing SIGnal, controls parameters relating to the video synchronizingsignal.TK035TK035TK035TK035TK035TK035TK035TK035TK035TK035TK035TK045TK045TK045TK045TK045TK045TK045TK045TK045TK045TK035TK03524-20 TRIGger Subsystem ARM


1997 SCPI Comm<strong>and</strong> Reference24.6.1.2.18.4.1 :POLarity POSitive | NEGativeARM:SEQuence:LAYer:VIDeo:SSIGnal:POLarity24.7 INITiateINITiateSSIGnal:POLarity, sets or queries sync pulse triggering polarity.At *RST, the value of this parameter is NEGative.The INITiate subsystem is used to control the initiation of the trigger subsystem. It initiatesall trigger sequences as a group except those sequences that are defined otherwise by eitherthe st<strong>and</strong>ard or in the instrument documentation.Instruments which implement the INITiate comm<strong>and</strong> as overlapped can continue parsing <strong>and</strong>executing subsequent comm<strong>and</strong>s <strong>and</strong> queries while initiated. Instruments which implementthe INITiate comm<strong>and</strong>s as sequential cannot execute subsequent comm<strong>and</strong>s <strong>and</strong> queries untilthe trigger model has returned to the IDLE state.For this reason, devices which implement the INITiate comm<strong>and</strong>s as sequential shall enterIDLE when the IEEE 488.2 dcas message is received. They shall also execute the nextmessage unit received after the dcas before leaving IDLE (if INITiate:CONTinuous is ON).dcas followed by *RST or dcas followed by INIT:CONT OFF shall always stop the triggermodel in the IDLE state.There are advantages to implementing the INITiate comm<strong>and</strong>s as overlapped.The instrument designer decides whether or not a device clear aborts the triggermodel.The instrument can continue parsing <strong>and</strong> executing comm<strong>and</strong>s <strong>and</strong> queries whilethe trigger model is initiated (for example, FETCh? to get the readings which arebeing triggered in a meter).The disadvantage to implementing any comm<strong>and</strong>s as overlapped, including the INITiatecomm<strong>and</strong>s, is that it adds complexity to the implementation of the IEEE 488.2 commoncomm<strong>and</strong>s *OPC, *WAI <strong>and</strong> *OPC?24.7.1 :CONTinuous INITiate:CONTinuousThe CONTinuous comm<strong>and</strong> is used to select whether the trigger system is continuouslyinitiated or not. With CONTinuous set to OFF, the trigger system shall remain in the IDLEstate until CONTinuous is set to ON or INITiate:IMMediate is received. Once CONTinuousis set to ON, the trigger system shall be initiated <strong>and</strong> shall exit the IDLE state. On completionof each trigger cycle, with CONTinuous ON, the trigger system shall immediatelycommence another trigger cycle without entering the IDLE state.When INITiate:CONTinuous is set to OFF, the current trigger cycle shall be completedbefore entering the IDLE state. The return to IDLE shall also occur as the result of anABORt or *RST comm<strong>and</strong>.TK035TK035TK03512ACQ01B 345KI005678KI0059101112 KI00513 KI0051415 KI0051617 KI0051819TK038202122232425 KI00526TRIGger Subsystem INITiate 24-21


1997 SCPI Comm<strong>and</strong> Reference24With the trigger system set to cycle continuously, the ABORt comm<strong>and</strong> shall force thetrigger system to the IDLE state; however, the value of INITiate:CONTinuous is unaffected.If CONTinuous was set to ON prior to receiving ABORt, it shall remain ON <strong>and</strong> the triggersystem shall immediately exit the IDLE state.This subsystem does not apply to sequences that are initiated by the INITiate:ALL comm<strong>and</strong>.24.7.1.1 [:ALL] INITiate:CONTinuous:ALLSets or queries whether or not all sequences are continuously initiated.At *RST, this value is set to OFF.24.7.1.2 :NAME ,INITiate:CONTinuous:NAMESets or queries whether or not the SEQuence with the alias specified by iscontinously initiated. The is character program data. See 24.4.2 forst<strong>and</strong>ard sequence names.The is a required parameter of the query form, the query form returns Oor 1.At *RST, this value is set to OFF.24.7.1.3 :SEQuence INITiate:CONTinuous:SEQuenceSets or queries whether or not the specified SEQuence is continously initiated. The numericsuffix on SEQuence corresponds to the sequence number. If NAME is implemented, thiscomm<strong>and</strong> shall also be implemented.At *RST, this value is set to OFF.24.7.2 [:IMMediate]INITiate:IMMediateThese comm<strong>and</strong>s shall cause all sequences to exit the IDLE state; they are initiated. TheIMMediate comm<strong>and</strong> shall cause the trigger system to initiate <strong>and</strong> complete one full triggercycle, returning to IDLE on completion. If the device is not in IDLE or ifINITiate:CONTinuous is set to ON, an IMMediate comm<strong>and</strong> shall have no effect on thetrigger system <strong>and</strong> an error -213 shall be generated.INITiate[:IMMediate] is an event <strong>and</strong> cannot be queried as there is no state associated with it.24.7.2.1 [:ALL]INITiate:IMMediate:ALLThis comm<strong>and</strong> causes all SEQuences to be INITiated, except those defined to behaveotherwise.ACQ01BACQ01BACQ01BACQ01BACQ01BACQ01BACQ01BACQ01BACQ01BACQ01B24-22 TRIGger Subsystem INITiate


1997 SCPI Comm<strong>and</strong> Reference24.7.2.2 :NAME INITiate:IMMediate:NAMEThis comm<strong>and</strong> causes the SEQuence with the alias specified by to beINITiated. The is character program data. See 24.4.2 for st<strong>and</strong>ardsequence names.24.7.2.3 :SEQuenceINITiate:IMMediate:SEQuenceThis comm<strong>and</strong> causes the specified SEQuence to be INITiated. The numeric suffix onSEQuence corresponds to the sequence number. If NAME is implemented, this comm<strong>and</strong>shall also be implemented.24.7.3 :POFLag INCLude | EXCLudeINITiate:POFLagPOFLag, Pending Operation Flag, allows the Pending-Operation flag associated with theinitiation of a trigger sequence to be included or excluded from the No-Operation-Pendingflag set.Setting POFLag to EXCLude means the No-Operation-Pending flag set is independent of thestate of the trigger subsystem. Moving from the INITiated to IDLE trigger states <strong>and</strong> viceversa has no effect on the NOP flag in this state.Setting POFLag to INCLude means the No-Operation-Pending flag set includes the triggersubsystem’s Pending-Operation flag which goes true when the trigger subsystem moves fromIDLE to INITiated state <strong>and</strong> returns to false when IDLE is re-entered.24.8 TRIGgerTRIGgerAt *RST, the value of this parameter is INCLude.The purpose of the TRIGger subsystem is to qualify a single event before enabling thetriggered sequence operation, such as enabling a sweep, starting a measurement, or changingthe state of the device.24.8.1 [:SEQuence]TRIGger:SEQuenceSEQuence is used in the exp<strong>and</strong>ed capability model to identify a particular sequence oflayers in the trigger system. A , see 24.4.2, may also be used here.24.8.1.1 :ATRiggerTRIGger:SEQuence:ATRiggerATRigger, Auto TRigger, controls an event detector timer that causes control flow to exit theevent detector if a valid trigger does not appear within a preset time period. The auto triggertimer is started upon entering the TRIGger layer, <strong>and</strong> after the control flow leaves the eventdetector. The precise timing of the timer is device dependent. See Figure 24-4.ACQ01B12ACQ01B 345TK0386TK038 789TK0381011TK038121314 TK038151617181920ACQ01B2122 TK02723TK027242526TRIGger Subsystem TRIGger 24-23


1997 SCPI Comm<strong>and</strong> Reference2424.8.1.1.1 [:STATe] TRIGger:SEQuence:ATRigger:STATeSTATe sets <strong>and</strong> queries the state of the auto trigger function. STATe ON enables thefunction <strong>and</strong> STATe OFF disables it.At *RST, the value of this parameter is OFF.24.8.1.2 :COUNt TRIGger:SEQuence:COUNtCOUNt controls the path of the trigger system in the upward traverse of the event detectionlayer, shown in figure 24-4, “Event Detection Layer.” The trigger system is directed either tothe next layer up or to loop back through the downward traverse. Moving to the next layer upoccurs when the number of times that the trigger system has passed through the downwardtraverse (given by the value of loop_ctr) is equal to the specified COUNt. In the simple case,COUNt has the value 1, a single downward traverse through the layer occurs, followed bythe actions dictated by subservient layers <strong>and</strong> finally a single upward traverse to next layerup. COUnt shall be set to a value of 1 or greater.At *RST, this value is set to 1.24.8.1.3 :COUPling AC|DCTRIGger:SEQuence:COUPlingCOUPling only has effect if the source for the event detector is an analog electrical signal,such as INTernal, LINE, or EXTernal. It selects AC or DC coupling for the SOURced signal.DC coupling allows the signal’s AC <strong>and</strong> DC components to pass. AC coupling passes onlythe signal’s AC component.At *RST, this value is device-dependent.24.8.1.4 : DEFine TRIGger:SEQuence:DEFineSets or queries the SEQuence alias. This comm<strong>and</strong> is required where aliases are employed<strong>and</strong> they do not correspond to the st<strong>and</strong>ard mapping. The numeric suffix on SEQuencecorresponds the sequence number to which the alias is to be applied.This comm<strong>and</strong> is an alias to ARM:SEQuence:LAYer:DEFine. Changing the value ofTRIGger:SEQuence:DEFine changes the value of ARM:SEQuence:DEFine to the samevalue.The is character data.The effect of is modified by DEFine:MGRules as follows:Regardless of the state or presence of DEFine:MGRules, there is no differencebetween uppercase <strong>and</strong> lowercase letters used in .If the comm<strong>and</strong> DEFine:MGRules is absent or set to OFF, thefull as written is the only form allowed.TK027TK027TK027ACQ01BACQ01BTK028ATK028ATK028ATK028A24-24 TRIGger Subsystem TRIGger


1997 SCPI Comm<strong>and</strong> ReferenceFor example, if the were SAMPLE1, then SAMPLE1 is theonly alias accepted.If the comm<strong>and</strong> DEFine:MGRules is present <strong>and</strong> set to ON, the is interpreted as []where all the contiguous trailing digits form the . Mnemonicgeneration rules as described in <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, Section 6.2.1. shall apply to the <strong>and</strong> the .For example, if the were defined as VECTOR or VECTOR1,then VECT, VECT1, VECTOR, <strong>and</strong> VECTOR1 would all be acceptable aliases.If the is identical to a keyword under ARM or TRIGger subsystem, thedevice shall report execution error -224. For example ARM:SEQuence2:DEFine FILTERwill cause an error. This comm<strong>and</strong> shall accept any other valid character program data for.The query returns a string which contains the , so that a null string canindicate that nothing is defined.If the comm<strong>and</strong> DEFine:MGRules is present <strong>and</strong> set to ON, the returned will follow the upper/lower case convention described in <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>, section 5.1,Interpreting Comm<strong>and</strong> Tables. An omitted or a of 1will be represented as [1].For example, if is VECTOR1 then the response is “VECTor[1]”; if it isDELAYED2, the response is “DELayed2”; if it is SAMPLE, the response is “SAMPle[1]”.By executing this comm<strong>and</strong> the previously defined name is overwritten.*RST has no effect on the defined name.24.8.1.4.1 MGRules TRIGger:SEQuence:DEFine:MGRulesThis comm<strong>and</strong> sets or queries the state of MGRules, Mnemonic Generation Rules.At *RST, the value of this parameter is OFF.24.8.1.5 :DELay TRIGger:SEQuence:DELayDELay sets the time duration between the recognition of an event(s) <strong>and</strong> the downward exitof the specified layer. DELay must be either zero or a positive value. An attempt to set it to anegative value shall cause an error -222 to be generated.At *RST, this value is set to 0 or the smallest available positive value. The value has units ofseconds.TK028A12345ACQ01B678ACQ01B9TK028A 101112TK028A 1314ACQ01B15ACQ01B1617TK028A 18TK028A 1920212223242526TRIGger Subsystem TRIGger 24-25


TWOS03TWOS03TWOS03TWOS03TWOS031997 SCPI Comm<strong>and</strong> Reference2424.8.1.5.1 :AUTO |ONCETRIGger:SEQuence:DELay:AUTOThis comm<strong>and</strong> is used for sensor devices with internal settling delays. If ON, the delay is setto the minimum necessary to ensure that a valid measurement can be acquired. This valuemay be coupled to other instrument settings such as function, range, resolution, <strong>and</strong> inputb<strong>and</strong>width.At *RST, AUTO is set ON.24.8.1.6 :ECLTRIGger:SEQuence:ECLThis comm<strong>and</strong> is an event which presets LEVel, HYSTeresis, COUPling, <strong>and</strong> DELay tovalues appropriate for a ECL signal. This comm<strong>and</strong> cannot be queried.24.8.1.7 :ECOunt TRIGger:SEQuence:ECOuntECOunt specifies a particular number of occurrences of the same event that must berecognized. For example, where it is necessary to wait for the tenth positive edge of a signal,ECOunt must be set to 10. ECOunt must be a positive value of 1 or greater. An attempt to setit differently shall cause an error -222 to be generated.At *RST, this value is set to 1.24.8.1.8 :FILTerTRIGger:SEQuence:FILTerThis function allows a filter to be inserted between the source switch <strong>and</strong> event detector.FILTer only has effect if :SOURce is an analog switch such as INTernal, EXTernal, or LINE.24.8.1.8.1 :HPASsTRIGger:SEQuence:FILTer:HPASsControls the high pass filter.24.8.1.8.1.1 :FREQuency TRIGger:SEQuence:FILTer:HPASs:FREQuencyDetermines the cutoff frequency of the high pass filter. Default units are Hertz.At *RST, this value is device-dependent.24.8.1.8.1.2 [:STATe] TRIGger:SEQuence:FILTer:HPASs:STATeTurns the high pass filter ON or OFF.At *RST, this value is device-dependent.24.8.1.8.2 [:LPASs]TRIGger:SEQuence:FILTer:LPASsControls the low pass filter.24-26 TRIGger Subsystem TRIGger


TWOSTWOSTWOS1997 SCPI Comm<strong>and</strong> Reference24.8.1.8.2.1 :FREQuency TRIGger:SEQuence:FILTer:LPASs:FREQuencyDetermines the cutoff frequency of the low pass filter. Default units are Hertz.At *RST, this value is device-dependent.24.8.1.8.2.2 [:STATe] TRIGger:SEQuence:FILTer:LPASs:STATeTurns the low pass filter ON or OFF.At *RST, this value is device-dependent.24.8.1.9 :HOLDoff TRIGger:SEQuence:HOLDoffHOLDoff controls the time during which the event detector is inhibited from acting on anynew trigger. The exact point in the trigger model at which the trigger holdoff timer is startedis device dependent, but it shall be after the event detector on the downward traverse <strong>and</strong>before the event detector on the upward traverse. See Figure 24-4.The range of the parameter is zero to one, where one is maximum holdoff <strong>and</strong> zero isminimum.At *RST, the value of the parameter is zero.24.8.1.10 :HYSTeresis TRIGger:SEQuence:HYSTeresisHYSTeresis is a qualifier of LEVel. It sets how far a signal must fall below LEVel before arising edge can again be detected, <strong>and</strong> how far a signal must rise above LEVel before afalling edge can again be detected. Its function is to eliminate false events caused by signalnoise. Units for the parameter default to the current amplitude units.In instruments that have only two discrete values for hysteresis (such as Noise Rejection On<strong>and</strong> Noise Rejection Off), the device designer should pick two numeric values thatapproximate the actual hystereis settings. The :HYSTeresis comm<strong>and</strong> has no :STATefunction because confusion would occur when turning hysteresis off. This might imply to auser that the actual hysteresis had been set to 0. This is rarely the case in instruments thathave only two states.At *RST, this value is device-dependent.24.8.1.11 [:IMMediate]TRIGger:SEQuence:IMMediateThis comm<strong>and</strong> exists to provide a one-time override of the normal process of the downwardtraverse of the event detection layer. This comm<strong>and</strong> shall cause the immediate exit of thespecified event detection layer if the trigger system is in the specified layer when theIMMediate is received. Otherwise, the IMMediate comm<strong>and</strong> shall be ignored <strong>and</strong> an error-211 shall be generated.123456TK021789TK0211011 TK021121314151617181920212223242526TRIGger Subsystem TRIGger 24-27


TWIR01p24 JP Change1997 SCPI Comm<strong>and</strong> Reference24The actual event detection <strong>and</strong> delay shall be skipped; however, normal processing of theloop_ctr as shown in figure 24-4, “Event Detection Layer,” shall occur. This comm<strong>and</strong> hasno effect on any other settings in this subsystem.This comm<strong>and</strong> is an event, has no *RST condition, <strong>and</strong> cannot be queried.24.8.1.12 :LEVel TRIGger:SEQuence:LEVelLEVel qualifies the characteristic of the selected SOURce signal that generates an event.LEVel only has effect if the source for the event detector is an analog electrical signal, suchas INTernal, LINE, or EXTernal. Units for the parameter default to the current amplitudeunit.At *RST, this value is instrument-dependent.24.8.1.12.1 :AUTO | ONCETRIGger:SEQuence:LEVel:AUTOWhen AUTO is ON, the device dynamically selects the best trigger level based on adevice-dependent algorithm applied to the trigger signal.When AUTO is OFF, the trigger LEVel sets the trigger level.Setting AUTO to ONCE turns AUTO ON, adjusts the trigger level once <strong>and</strong> then resetsAUTO to OFF.Setting the trigger LEVel turns AUTO OFF.At *RST, the value of this parameter is OFF.24.8.1.13 :LINK TRIGger:SEQuence:LINKSets or queries the internal event that is LINKed to the event detector in the TRIGger layer.Internal events occur throughout all of the Instrument Model, a particular implementationwill dictate which events are available to this LINK comm<strong>and</strong>. The isSTRING PROGRAM DATA <strong>and</strong> it is defined further in the Instrument Model, Chapter 2.An Example of events that are commonly used, are the events that occur when a particularlayer is exited, these h<strong>and</strong>les are of the form:“ARM[:SEQuence[:LAYer]]” or “TRIGger[:SEQuence]”Other common examples include completion of a process in a block or an instrument statetransition.At *RST, this value is device-dependent.24.8.1.14 :PROTocolTRIGger:SEQuence:PROTocolThis subsystem controls the protocol used with the selected source.TK036TK036TK036TK036TK036TK036HP066HP093HP09324-28 TRIGger Subsystem TRIGger


1997 SCPI Comm<strong>and</strong> Reference24.8.1.14.1 :VXI SYNChronous|SSYNchronous|ASYNchronousTRIGger:SEQuence:PROTocol:VXIThis comm<strong>and</strong> selects the trigger protocol for the VXI TTLTrg or ECLTrg trigger line whenused as the trigger source. The protocols are specified in the VXI Bus System Specificationunder sections B.6.2.3 <strong>and</strong> B.6.2.4.SYNChronous selects the synchronous trigger protocol.SSYNchronous selects the semi-synchronous trigger protocol.ASYNchronous selects the asynchronous trigger protocol.At *RST, the SYNChronous protocol is selected.24.8.1.15 :SIGNalTRIGger:SEQuence:SIGNalThis comm<strong>and</strong> provides a one-time override of the normal process of the downward traversethrough the event detector in figure 24-4, “Event Detection Layer.” This comm<strong>and</strong> shallcause the immediate exit of the event detector block in the specified event detection layer ifthe trigger system is waiting for the event specified by the SOURce comm<strong>and</strong>. Otherwise,the SIGNal comm<strong>and</strong> shall be ignored <strong>and</strong> an error -211 shall be generated.Only the event detector block is bypassed. Normal processing of the delay <strong>and</strong> the event_ctras shown in figure 24-4, “Event Detection Layer,” shall occur. This comm<strong>and</strong> has no effecton any other settings in this subsystem.This comm<strong>and</strong> defines an event, <strong>and</strong> as such does not have an associated query form or*RST condition.24.8.1.16 :SLOPe POSitive|NEGative|EITHerTRIGger:SEQuence:SLOPeSLOPe qualifies whether the event occurs on the rising edge, falling edge, or either edge ofthe signal.At *RST, this value is set to POS.24.8.1.17 :SOURce TRIGger:SEQuence:SOURceThis comm<strong>and</strong> selects the source for the event detector. Only one source may be specified inthe parameter at a time for a given event detector. The various sources are:AINTernal — The triggering source is selected automatically by the instrumentfrom internal algorithms to best match the current operating mode. An AutomaticINTernal event is derived from measurement functions <strong>and</strong>/or sensor capabilitiesin the signal conditioning block.BUS — The source is signal specific to the control interface. For IEEE 488.1 thegroup execute trigger, GET, would satisfy this condition. In VXI the word serialcomm<strong>and</strong> TRIGger performs this function. The event detector is also satisfied,independent of the interface, when a *TRG comm<strong>and</strong> is received. Note thatHP093HP0931HP093 2HP093 3HP093 4HP093 5678910111213141516171819202122 TK0402324TWV41C 2526TRIGger Subsystem TRIGger 24-29


1997 SCPI Comm<strong>and</strong> Reference24neither GET nor *TRG can be sent without having an effect on the messageexchange protocol described in IEEE 488.2.ECLTrg — The signal source is the specified VXI P2 or P3 backplane ECLTrgTRIGGER line. Valid lines are ECLTrg0 <strong>and</strong> ECLTrg1 on P2, <strong>and</strong> ECLTrg2through ECLTrg5 on P3.EXTernal — An external signal jack is selected as the source. If no suffix isspecified, EXTernal1 is assumed.HOLD — The event detection is disabled. However, the IMMediate comm<strong>and</strong>shall override HOLD.IMMediate — No waiting for an event occurs.INTernal — An internal channel is selected as the source. An INTernal event isderived from a measurement function <strong>and</strong>/or sensor capability in the signalconditioning block. If no suffix is specified, INTernal1 is assumed.LINE — The source signal is determined from the AC line voltage.LINK — The source for the event detector is specified by the LINK comm<strong>and</strong>.MANual — The signal is user-generated, such as by pressing a front panel key.OUTPut — The signal source is taken from an output channel. If no channel isspecified, OUTPut1 is assumed.TIMer — The source signal comes from a periodic timer. The period of the timeris specified by the TIMer comm<strong>and</strong>.TTLTrg — The signal source is the specified VXI P2 backplane TTLTrgTRIGGER line. Valid lines are TTLTrg0 through TTLTrg7.At *RST, IMMediate shall be selected as the SOURce.24.8.1.18 :TIMer TRIGger:SEQuence:TIMerTIMer sets the period of an internal periodic signal source. Its value affects the triggersystem only when it is selected as the SOURce for the event detector. TIMer must be apositive value. An attempt to set it differently shall cause an error -222 to be generated. Thesynchronization of the timer’s period is device-dependent.At *RST, this value is set to a device-dependent value.24.8.1.19 :TTLTRIGger:SEQuence:TTLThis comm<strong>and</strong> is an event which presets LEVel, HYSTeresis, COUPling, <strong>and</strong> DELay tovalues appropriate for a TTL signal. This comm<strong>and</strong> cannot be queried.24-30 TRIGger Subsystem TRIGger


1997 SCPI Comm<strong>and</strong> Reference24.8.1.20 :TYPE EDGE | VIDeoTRIGger:SEQuence:TYPESets or queries the type of triggering.At *RST, the value of this parameter is EDGE.24.8.1.21 :VIDeoTRIGger:SEQuence:VIDeoThis subsystem controls parameters necessary to trigger on video signals.24.8.1.21.1 :FIELdTRIGger:SEQuence:VIDeo:FIELdThis subsystem selects the video field to trigger on.24.8.1.21.1.1 [:NUMBer] TRIGger:SEQuence:VIDeo:FIELd:NUMBerNUMBer sets or queries the field number to trigger on if FIELd:SELect is set to NUMBer.At *RST, the value of this parameter is 1.24.8.1.21.1.2 :SELect ODD | EVEN | ALL | NUMBerTRIGger:SEQuence:VIDeo:FIELd:SELectSELect sets or queries the video field selection method to be used. Four character dataparameters are defined as follows:ODD selects odd-numbered fields to trigger on.EVEN selects even-numbered fields to trigger on.ALL triggers on all fields regardless of number.NUMBer triggers on the field number specified by NUMBer.At *RST, the value of this parameter is ALL.24.8.1.21.2 :FORMatTRIGger:SEQuence:VIDeo:FORMatFORMat controls parameters that allow the video trigger system to respond to signals fromst<strong>and</strong>ard video formats.24.8.1.21.2.1 :LPFRame TRIGger:SEQuence:VIDeo:FORMat:LPFRameLPFRame, Lines Per FRame, sets or queries the lines per frame associated with the signalformatting st<strong>and</strong>ard being used.For example, A signal following NTSC would selects 525 lines per frame while a PALsignal would select 625 lines per frame.At *RST, the value of this parameter is device dependent.TK035TK035TK0351TK0352TK035 3TK035 45TK0356TK0357TK035 8TK035 910 TK03511TK0351213 TK03514 TK03515 TK03516 TK03517 TK03518 TK035Edit19TK0352021TK03522Edit23 TK03524TK0352526 TK035TRIGger Subsystem TRIGger 24-31


1997 SCPI Comm<strong>and</strong> Reference24.8.1.21.3 :LINETRIGger:SEQuence:VIDeo:LINEThis subsystem selects a particular line in the field to trigger on.24.8.1.21.3.1 [:NUMBer] TRIGger:SEQuence:VIDeo:LINE:NUMBerNUMBer sets or queries the line number to trigger on if LINE:SELect is set to NUMBer.Setting the NUMBer value has no effect on the value of the SELect parameter.At *RST, the value of this parameter is device dependent.24.8.1.21.3.2 :SELect ALL | NUMBerTRIGger:SEQuence:VIDeo:LINE:SELectSELect sets or queries the video line selection method to be used. Two character dataparameters are defined as follows:ALL — triggers on all lines regardless of number.NUMBer — triggers on the line number specified by NUMBer.At *RST, the value of this parameter is ALL.24.8.1.21.4 :SSIGnalTRIGger:SEQuence:VIDeo:SSIGnalSSIGnal, Synchronizing SIGnal, controls parameters relating to the video synchronizingsignal.24.8.1.21.4.1 :POLarity POSitive | NEGativeTRIGger:SEQuence:VIDeo:SSIGnal:POLaritySSIGnal:POLarity, sets or queries sync pulse triggering polarity.At *RST, the value of this parameter is NEGative.TK045TK045TK045TK045TK045TK045TK045TK045TK045TK045TK035TK035TK035TK035TK0352424-32 TRIGger Subsystem TRIGger


1997 SCPI Comm<strong>and</strong> Reference25 UNIT SubsystemDefault units are defined, where applicable, for each SCPI comm<strong>and</strong>. The UNIT subsystemprovides a mechanism to change the default values. The units selected apply to thedesignated comm<strong>and</strong> parameters for both comm<strong>and</strong> <strong>and</strong> response.The UNIT comm<strong>and</strong> at the root level has a global effect on the selected units. The UNITcomm<strong>and</strong> may also be applied to lower levels in the SCPI comm<strong>and</strong> hierarchy to have alocalized effect. When the UNIT comm<strong>and</strong> is applied to a node, then all the nodes below thenode to which the unit comm<strong>and</strong> was applied shall be affected by the localized UNITcomm<strong>and</strong>. There is no restriction on the number of levels to which UNIT may be applied. Inthis way the more global units are overridden by the more local units. Units may also beoverridden temporarily by attaching the desired unit as a suffix to the appropriate parameterin the comm<strong>and</strong>, if the instrument supports that unit.For example, to program a source with units of Volts, the comm<strong>and</strong> UNIT:VOLTage VOLTwould be used. To program only the modulator of that same source in dBuVs, the additionalcomm<strong>and</strong> [SOURce:]MODulation:UNIT DBUV would be required.The UNIT comm<strong>and</strong> cannot be applied to either SENSe, SOURce or ROUTe nodes, sincethe UNIT comm<strong>and</strong> at these nodes <strong>and</strong> at the root cannot be unambiguously recognized.This condition arises from the ability to have one of SENSe, SOURce or ROUTe nodesoptional.KEYWORD PARAMETER FORM NOTES B:UNIT14:ANGLe DEG|RAD15:CURRent :POWer16:TEMPerature C|CEL|F|FAR|K17:TIME HOUR|MINute|SECond 1993 XSS01c:VOLTage 181925.1 :ANGLe DEG|RAD20UNIT:ANGLe21Specifies the fundamental unit of angle.22At *RST, the default unit is RAD.2325.2 :CURRent, :POWer, <strong>and</strong> :VOLTageUNIT:CURRentSelects a default unit for comm<strong>and</strong>s which program absolute amplitude. The default unitmay be overridden when programming a function by explicitly sending a suffix. The defaultunit may also be overridden if a unit comm<strong>and</strong> exists at a lower tree level. Query values of242526comm<strong>and</strong>s which program in amplitude units shall be returned in the current amplitude unitUNIT:ANGLe 25-112345678910111213


1997 SCPI Comm<strong>and</strong> Referenceunless overridden by a unit comm<strong>and</strong> at a tree level closer to the comm<strong>and</strong> itself (such asPOWer:UNIT).The possible values are:Linear power: W (Watt)Linear voltage: V (Volt)Linear current: A (Ampere)Logarithmic power: DBM, DB[IEEE suffix multiplier]W (such as DBUW)Logarithmic voltage: DB[IEEE suffix multiplier]V (such as DBUV)Logarithmic current: DB[IEEE suffix multiplier]A (such as DBA)An instrument must accept all values in any class if it accepts any value in that class.However, the decision to accept a class is device-dependent. A device which acceptslogarithmic units must also accept the comparable linear unit. This means thatUNIT:VOLTage WATT is permissible if it makes sense for the instrument. It is also impliedthat an impedance is specified for the signal when converting between different fundamentalquantities.At *RST, this value is device-dependent. However, the following restrictions apply. TheUNIT subsystem must be implemented if a device chooses any value other than thefundamental unit for either the VOLTage, POWer, or CURRent subsystem , or if itimplements logarithmic units.25.3 :TEMPerature C|CEL|F|FAR|KUNIT:TEMPeratureSpecifies the fundamental unit of temperature as degrees Celsius, Fahrenheit, or Kelvin. Theform FAR <strong>and</strong> CEL, defined by IEEE 488.2, shall be accepted for Fahrenheit <strong>and</strong> Celsiusrespectively, <strong>and</strong> these shall be the preferred forms that are returned for a query.At *RST, this value is device-dependent.25.4 :TIME HOUR|MINute|SECond XSS01cUNIT:TIMESpecifies the fundamental unit of time.At *RST, this value is SECond.2525-2 UNIT:TEMPerature


1997 SCPI Comm<strong>and</strong> Reference26 VXI SubsystemThe VXI subsystem contains comm<strong>and</strong>s that control the administration functions associatedwith operating a VXI-based system. This section will track the work of the VXI consortium.This section describes ASCII comm<strong>and</strong>s which are issued to the system from an externalhost. The exact internal destination device <strong>and</strong> routing methods to that device are systemspecific. These comm<strong>and</strong>s are used for access to system configuration information, <strong>and</strong> forcommon capabilities. The terminology used in this section is patterned after IEEE 488.2.The following comm<strong>and</strong>s are the st<strong>and</strong>ard set of VXIbus system comm<strong>and</strong>s which areASCII encoded. If a device implements one or more of these comm<strong>and</strong>s, the syntax of thissection shall be used. The response syntax shall also follow this section.The COMMON ASCII SYSTEM COMMANDS are organized into subsystems. If a deviceimplements a required comm<strong>and</strong> in a subsystem then it shall implement all the requiredcomm<strong>and</strong>s in the subsystem. If a device implements an optional comm<strong>and</strong> in a subsystemthen it shall implement all the required comm<strong>and</strong>s in the subsystem. If a device implements acomm<strong>and</strong> from any subsystem then it shall also implement the VXI:SELect comm<strong>and</strong>.KEYWORD PARAMETER FORM NOTESVXI:CONFigure:DNUMber?[query only]:HIERarchy? [query only] 1992:ALL? [query only] 1992:VERBose? [query only] 1992:ALL? [query only] 1992:INFormation? [query only] 1992:ALL? [query only] 1992:VERBose? [query only] 1992:ALL? [query only] 1992:LADDress? [query only] 1992:NUMber? [query only] 1992:REGister 1992:READ? | [query only] 1992:VERBose? | [query only] 1992:WRITe (|), [no query] 1992:RESet? [query only] 1992:VERBose? [query only] 1992:SELect 1992:WSProtocol 1992:COMM<strong>and</strong> 1992[:ANY] [no query] 1992:AHILine , [no query] 1992:AILine , [no query] 19921234567891011121314151617181920212223242526VXI 26-1


1997 SCPI Comm<strong>and</strong> Reference26KEYWORD PARAMETER FORM NOTES:AMControl [no query] 1992:ANO [no query] 1992:BAVailable , [no query] 1992:BNO [no query] 1992:BRQ [no query] 1992:CEVent , [no query] 1992:CLR [no query] 1992:CLOCk [no query] 1992:CRESponse [no query] 1992:ENO [no query] 1992:GDEVice [no query] 1992:ICOMm<strong>and</strong>er [no query] 1992:RDEVice [no query] 1992:RHANdlers [no query] 1992:RHLine [no query] 1992:RILine [no query] 1992:RINTerrupter [no query] 1992:RMODid [no query] 1992:RPERror [no query] 1992:RPRotocol [no query] 1992:RSTB [no query] 1992:RSARea [no query] 1992:SLModid , [no query] 1992:SLOCk [no query] 1992:SUModid , [no query] 1992:TRIGger [no query] 1992:MESSage 1992:RECeive? | [query only] 1992:SEND [,(END|NEND)] [no query] 1992:QUERy 1992[:ANY?] [query only] 1992:AHILine? , [query only] 1992:AILine? , [query only] 1992:AMControl? [query only] 1992:ANO? [query only] 1992:BNO? [query only] 1992:BRQ? [query only] 1992:CEVent? , [query only] 1992:CRESponse? [query only] 1992:ENO? [query only] 1992:RDEVice? [query only] 1992:RHANdlers? [query only] 1992:RHLine? [query only] 1992:RILine? [query only] 199226-2 VXI


1997 SCPI Comm<strong>and</strong> ReferenceKEYWORD PARAMETER FORM NOTES:RINTerrupter? [query only] 1992:RMODid? [query only] 1992:RPERror? [query only] 1992:RPRotocol? [query only] 1992:RSTB? [query only] 1992:RSARea? [query only] 1992:SLModid? , [query only] 1992:SUModid? , [query only] 1992:RESPonse? [query only] 199226.1 :CONFigureVXI:CONFigureProvides the necessary comm<strong>and</strong>s to query the configuration of a VXI system.26.1.1 :DNUMber?VXI:CONFigure:DNUMber?This query returns the number of devices in the system, in format.The range of this integer numeric value is 1 to 256 inclusive.26.1.2 :HIERarchy?VXI:CONFigure:HIERarchy?This comm<strong>and</strong> returns current hierarchy configuration information about the selected logicaladdress. The individual fields of the response are comma separated. If the information aboutthe selected logical address is not available from the destination device, (that is, therequested device is not in the servant area of the destination device), then error -224,"Parameter error" will be set <strong>and</strong> no response data will be sent. This is a requiredconfiguration comm<strong>and</strong>. The output fields are defined as follows:Logical address: a , between -1 <strong>and</strong> 255 inclusive. A -1 indicates that thedevice has no logical address.comm<strong>and</strong>er’s logical address: a , between -1 <strong>and</strong> 255 inclusive. -1indicates that this device has no comm<strong>and</strong>er or the comm<strong>and</strong>er is unknown.Interrupt H<strong>and</strong>lers: a comma separated list of 7 , between 0 <strong>and</strong> 7inclusive. Interrupt lines 1-7 are mapped to the individual return values. 0 is usedto indicate that the particular interrupt h<strong>and</strong>ler is not configured. A set of returnvalues of 0,0,0,5,2,0,6 would indicate that the device is configured as follows:h<strong>and</strong>ler 4 is configured to h<strong>and</strong>le interrupts on line 5h<strong>and</strong>ler 5 is configured to h<strong>and</strong>le interrupts on line 2h<strong>and</strong>ler 7 is configured to h<strong>and</strong>le interrupts on line 6h<strong>and</strong>lers 1,2,3,6 are not configuredInterrupters: a comma separated list of 7 , between 0 <strong>and</strong> 7 inclusive.Interrupt lines 1-7 are mapped to the individual return values. 0 is used to indicatethat the particular interrupter is not configured. A set of return values of0,0,0,5,2,0,6 would indicate that the device is configured as follows:1234567891011121314151617181920212223242526VXI 26-3


1997 SCPI Comm<strong>and</strong> Referenceinterrupter 4 is configured to interrupt on line 5interrupter 5 is configured to interrupt on line 2interrupter 7 is configured to interrupt on line 6interrupters 1,2,3,6 are not configuredPass/Failed: a which contains the pass/fail status of the specified deviceencoded as follows:FAIL=0 IFAIL=1 PASS=2 READY=3manufacturer specific comment: This up to 80 character quoted string containsmanufacturer specific data. It is sent with a 488.2 string response data format.26.1.2.1 :ALL?VXI:CONFigure:HIERarchy?:ALL?When issued to a resource manager, configuration information about about all logicaladdresses. If the comm<strong>and</strong> is received by a device which is not the resource manager, itreturns the current hierarchy configuration information about the destination device followedby all of its immediate servants. The information is returned in the order specified inVXI:CONFigure:LADDress?. (the information about multiple logical addresses will besemi-colon separated <strong>and</strong> follow the IEEE 488.2 response message format). The individualfields of the output are comma separated. This is an optional configuration comm<strong>and</strong>.26.1.2.2 :VERBose?VXI:CONFigure:HIERarchy?:VERBose?This comm<strong>and</strong> has the same functionality as VXI:CONFigure:HIERarchy?. However itreturns a quoted string indicating the device information for the selected This comm<strong>and</strong> isintended to allow for a human readable form of the response toVXI:CONFigure:HIERarchy?. The format of this string is manufacturer specific. This is anoptional configuration comm<strong>and</strong>.26.1.2.2.1 :ALL?VXI:CONFigure:HIERarchy?:VERBose?:ALL?This comm<strong>and</strong> has the same functionality as VXI:CONFigure:HIERarchy:ALL?. However itreturns a semi- colon separated sequence of strings indicating the device information for alldevices. The format of this string is manufacturer specific. This comm<strong>and</strong> is intended toallow for a human readable form of the response to VXI:CONFigure:HIERarchy:ALL?. Thisis an optional configuration comm<strong>and</strong>.2626.1.3 :INFormation?VXI:CONFigure:INFormation?This comm<strong>and</strong> returns the static information about the selected logical address. Theindividual fields of the response are comma separated. If the information about the selectedlogical address is not available from the destination device, (that is, the requested device isnot in the servant area of the destination device), then error -224, "Parameter error" will beset <strong>and</strong> no response data will be sent. This is a required configuration comm<strong>and</strong>. Thecomm<strong>and</strong> returns the following values:logical address: a between -1 <strong>and</strong> 255 inclusive. A -1 indicates that the26-4 VXI


1997 SCPI Comm<strong>and</strong> Referencedevice has no logical address.manufacturer id: a , between -1 <strong>and</strong> 4095 inclusive. -1 indicates that thedevice has no manufacturer id.model code: a , between -1 <strong>and</strong> 65535 inclusive. -1 indicates that thedevice has no model codedevice class: a , between 0 <strong>and</strong> 5 inclusive. Each value corresponds the thedevice’s classification as follows:0: VXIbus memory device.1: VXIbus extended device.2: VXIbus message based device.3: VXIbus register based device.4: Hybrid device.5: Non-VXIbus device.address space: a , between 0 <strong>and</strong> 15 inclusive, which is the sum of thebinary weighted codes of the address space(s) occupied by the device. Thefollowing values are defined:1: The device has A16 registers.2: The device has A24 registers.4: The device has A32 registers.8: The device has A64 registers.A16 memory offset: the base address for any A16 registers (other than theVXIbus defined registers) which are present on the device. This is a in therange of -1 to 65535. -1 is used to indicate that the device has no A16 memory.A24 memory offset: the base address for any A24 registers which are present onthe device. This is a in the range of -1 to 16777215. -1 is used to indicatethat the device has no A24 memory.A32 memory offset: the base address for any A32 registers which are present onthe device. This is a value> in the range of -1 to 4294967295. -1 is used toindicate that the device has no A32 memory.A16 memory size: the number of bytes reserved for any A16 registers (other thanthe VXIbus defined registers) which are present on the device. This is a inthe range of -1 to 65535. -1 is used to indicate that the device has no A16 memory.A24 memory size: the number of bytes reserved for any A24 registers which arepresent on the device. This is a in the range of -1 to 16777215. -1 is usedto indicate that the device has no A24 memory.A32 memory size: the number of bytes reserved for any A32 registers which arepresent on the device. This is a in the range of -1 to 4294967295. -1 isused to indicate that the device has no A32 memory.Slot number: a , between -1 <strong>and</strong> the number of slots which exist in the1234567891011121314151617181920212223242526VXI 26-5


1997 SCPI Comm<strong>and</strong> Reference26cage. -1 indicates that the slot which contains this device is unknown.Slot 0’s logical address: a , between -1 <strong>and</strong> 255 inclusive. -1 indicates thatSlot 0 device associated with this device is unknown.subclass: a representing the contents of the subclass register. -1 indicatesthat the subclass register is not defined for this device.attribute: a representing the contents of the attribute register. -1 indicatesthat the attribute register is not defined for this device.manufacturer specific comment: This up to 80 character quoted string containsmanufacturer specific data. It is sent with a 488.2 string response data format.26.1.3.1 :ALL?VXI:CONFigure:INFormation?:ALL?When issued to a resource manager, this comm<strong>and</strong> returns the static information about alllogical addresses. If the comm<strong>and</strong> is received by a device which is not the resource manager,it returns the static information about the destination device followed by all of its immediateservants. The information is returned in the order specified in the response toVXI:CONFigure:LADDress?. (The information about multiple logical addresses will besemi-colon separated <strong>and</strong> follow the IEEE 488.2 response message format). The individualfields of the output are comma separated. This is an optional configuration comm<strong>and</strong>.26.1.3.2 :VERBose?VXI:CONFigure:INFormation?:VERBose?This comm<strong>and</strong> has the same functionality as VXI:CONFigure:INFormation?. However itreturns a quoted string indicating the device information for the selected device. The formatof this string is manufacturer specific. This comm<strong>and</strong> is intended to allow for a humanreadable form of the response to VXI:CONFigure:INFormation?. This is an optionalconfiguration comm<strong>and</strong>.26.1.3.3 :ALL?VXI:CONFigure:INFormation?:ALL?This comm<strong>and</strong> has the same functionality as VXI:CONFigure:INFormation:ALL?. Howeverit returns a semi-colon separated sequence of quoted strings indicating the deviceinformation for all devices. The format of each string is manufacturer specific. Thiscomm<strong>and</strong> is intended to allow for a human readable form of the response toVXI:CONFigure:INFormation:ALL?. The format of this string is manufacturer specific.This is an optional configuration comm<strong>and</strong>.26.1.4 :LADDress?VXI:CONFigure:LADDress?When issued to a resource manager, the Logical ADDress comm<strong>and</strong> returns a commaseparated list of which are the logical addresses of the devices in the system. Each will be an integer in the range of 0 to 255 inclusive. The logical address of thedevice which is responding to the comm<strong>and</strong> will be the first item in the list. If the comm<strong>and</strong>is received by a device other than the resource manager, then the response to the comm<strong>and</strong>will contain the logical address of the destination device followed by a list of the devices26-6 VXI


1997 SCPI Comm<strong>and</strong> Referencewhich are immediate servants to the destination device. This is a required configurationcomm<strong>and</strong>.26.1.5 :NUMBer?VXI:CONFigure:NUMBer?When issued to a resource manager, this comm<strong>and</strong> returns a which is the number ofdevices in the system. If the comm<strong>and</strong> is received by a device which is not the resourcemanager, then the response to the comm<strong>and</strong> will contain the number of devices which areimmediate servants to the destination device including the destination device. For example, acomm<strong>and</strong>er with 3 servants would return a value of 4, or a resource manager for a system of4 devices would return a value of 5. The range of this is 1 to 256 inclusive. This is arequired configuration comm<strong>and</strong>.26.2 REGisterVXI:REGisterThe node collects together the comm<strong>and</strong>s that interact with the VXI registers.26.2.1 :READ? VXI:REGister:READ?This comm<strong>and</strong> returns the contents of the specified 16 bit register at the selected logicaladdress as a . This is a required register access comm<strong>and</strong>. The register is specified asthe byte address of the desired register or as optionally the register name. It has values of alleven numbers from 0 to 62 inclusive (as a ) or the following (optional)words:A24Low: A24 Pointer Low register (18)A24High: A24 Pointer High register (16)A32Low: A32 Pointer Low register (22)A32High: A32 Pointer High register (20)ATTRibute: Attribute register (8)DHIGh: Data High register (12)DLOW: Data Low register (14)DTYPe: Device Type register (2)ICONtrol: Interrupt Control register (28)ID: ID register (0)ISTatus: Interrupt Status register (26)MODid: MODID register (8)OFFSet: Offset register (6)PROTocol: PROTocol register (8)1234567891011121314151617181920212223242526RESPonse: RESPonse register (10)VXI 26-7


1997 SCPI Comm<strong>and</strong> ReferenceSNLow: Serial Number Low register (12)SNHigh: Serial Number High register (10)STATus: Status register (4)SUBClass: Subclass register (30)VNUMber: Version Number register (14)26.2.1.1 :VERBose? VXI:REGister:READ?:VERBose?This comm<strong>and</strong> has the same functionality as VXI:REGister:READ?. However it returns aquoted string indicating the register contents for the selected device. The format of this stringis manufacturer specific. This comm<strong>and</strong> is intended to allow for a human readable form ofthe response to VXI:REG:READ? which could include additional decoding of bits inspecific registers. This is an optional register access comm<strong>and</strong>.26.2.2 :WRITe ( | ), VXI:REGister:WRITeThis comm<strong>and</strong> writes data to the specified register on the selected logical address. This is arequired register access comm<strong>and</strong>. The Data is a 16 bit value specified as a in the range of -32768 to 32767. The register is specified as the byte address of the desiredregister or as optionally the register name. It has values of all even numbers from 0 to 62inclusive (expressed as a ) or the following (optional) words:CONTrol: Control register (4)DEXTended: Data Extended register (10)DHIGh: Data High register (12)DLOW: Data Low register (14)ICONtrol: Interrupt Control register (28)MODid: MODID register (8)LADDress: Logical Address register (0)OFFSet: Offset register (6)26SIGNal: Signal register (8)26.3 :RESet?VXI:RESet?This comm<strong>and</strong> resets the selected logical address. SYSFAIL generation is inhibited whilethe device is in the self test state. The comm<strong>and</strong> waits for five seconds or until the selecteddevice has indicated passed (whichever occurs first). If the device passes its self test, thenSYSFAIL generation will be re-enabled. If the device fails its self test, then SYSFAILgeneration will remain inhibited. The return value from this comm<strong>and</strong> is the state of theselected device after it has been reset. The comm<strong>and</strong> returns an which is encoded as26-8 VXI


1997 SCPI Comm<strong>and</strong> Referencefollows: FAIL=0, PASS=2, READY=3. The state of the A24/A32 enable bit is not altered bythis comm<strong>and</strong>. This is a required register access comm<strong>and</strong>.26.3.1 :VERBose?VXI:RESet?:VERBose?This comm<strong>and</strong> has the same functionality as VXI:RESet?. However it returns a quoted stringindicating the state of the specified device. The format of this string is manufacturer specific.This is an optional register access comm<strong>and</strong>.26.4 :SELect VXI:SELectThis comm<strong>and</strong> specifies the logical address which is to be used by all subsequent comm<strong>and</strong>sin the VXI subsystem. Logical_address is specified as a in the range of 0to 255. The query form returns the logical address as a the value of -1 is reserved toindicate that no logical address has been selected. The *RST default value forlogical_address is that no logical address is selected. All other comm<strong>and</strong>s which require alogical_address to be selected will respond with an error -221, "Settings conflict" if nological address is selected.26.5 :WSPRotocolVXI:WSPRotocolThis node collects together all the comm<strong>and</strong>s associated with the word serial protocol.26.5.1 :COMM<strong>and</strong>26.5.1.1 [:ANY] VXI:WSPRotocol:COMM<strong>and</strong>:ANYThis comm<strong>and</strong> sends the specified word serial comm<strong>and</strong> to the selected logical address. Thedata field is a or a non-decimal value which specifies the comm<strong>and</strong> to besent. The response of a word serial query which is sent with this comm<strong>and</strong> can be read withthe VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is a required Word Serial Supportcomm<strong>and</strong>.26.5.1.2 :AHLine ,VXI:WSPRotocol:COMM<strong>and</strong>:AHLineThis comm<strong>and</strong> sends an Assign H<strong>and</strong>ler Line comm<strong>and</strong> to the selected logical address. Theh<strong>and</strong>_id field has a value in the range of 1 to 7 inclusive, <strong>and</strong> line_number field has a valuein the range of 0 to 7 inclusive. They are both specified with s or asnon-decimal values. The response to this comm<strong>and</strong> can be read with theVXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.3 :AILine ,VXI:WSPRotocol:COMM<strong>and</strong>:AILineThis comm<strong>and</strong> sends an Assign Interrupter Line comm<strong>and</strong> to the selected logical address.The int_id field has a value in the range of 1 to 7 inclusive, <strong>and</strong> line_number field has avalue in the range of 0 to 7 inclusive. They are both specified with numeric_ values or asnon-decimal values. The response to this comm<strong>and</strong> can be read with theVXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.1234567891011121314151617181920212223242526VXI 26-9


1997 SCPI Comm<strong>and</strong> Reference2626.5.1.4 :AMControl VXI:WSPRotocol:COMM<strong>and</strong>:AMControlThis comm<strong>and</strong> sends an Asynchronous Mode Control comm<strong>and</strong> to the selected logicaladdress. The response mask field has a value in the range of 0 to 15 inclusive, <strong>and</strong> is definedin VXI rev. 1.3. It is specified with a or as a non-decimal value. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.5 :ANOVXI:WSPRotocol:COMM<strong>and</strong>:ANOThis comm<strong>and</strong> sends an Abort Normal Operation comm<strong>and</strong> to the selected logical address.The response to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse?comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.6 :BAVailable ,VXI:WSPRotocol:COMM<strong>and</strong>:BAVailableThis comm<strong>and</strong> sends a Byte Available comm<strong>and</strong> to the selected logical address. TheBoolean field selects whether the END bit is set in the comm<strong>and</strong>. The byte field has a valuein the range of 0 to 255 inclusive. It is specified with a or as a non-decimalvalue. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.7 :BNO VXI:WSPRotocol:COMM<strong>and</strong>:BNOThis comm<strong>and</strong> sends an Begin Normal Operation comm<strong>and</strong> to the selected logical address.The Boolean field selects whether the Top_level bit is set in the comm<strong>and</strong>. The response tothis comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is anoptional Word Serial Support comm<strong>and</strong>.26.5.1.8 :BRQVXI:WSPRotocol:COMM<strong>and</strong>:BRQThis comm<strong>and</strong> sends an Byte Request comm<strong>and</strong> to the selected logical address. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.9 :CEVent ,VXI:WSPRotocol:COMM<strong>and</strong>:CEVentThis comm<strong>and</strong> sends a Control Event comm<strong>and</strong> to the selected logical address. The Booleanfield selects whether the Enable bit is set in the comm<strong>and</strong>. The event_number field has avalue in the range of 0 to 127 inclusive. It is specified with a or as anon-decimal value. The response to this comm<strong>and</strong> can be read with theVXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.10 :CLRVXI:WSPRotocol:COMM<strong>and</strong>:CLRThis comm<strong>and</strong> sends an Clear comm<strong>and</strong> to the selected logical address. This is an optionalWord Serial Support comm<strong>and</strong>.26-10 VXI


1997 SCPI Comm<strong>and</strong> Reference26.5.1.11 :CLOCkVXI:WSPRotocol:COMM<strong>and</strong>:CLOCkThis comm<strong>and</strong> sends an Clear Lock comm<strong>and</strong> to the selected logical address. This is anoptional Word Serial Support comm<strong>and</strong>.26.5.1.12 :CRESponse VXI:WSPRotocol:COMM<strong>and</strong>:CRESponseThis comm<strong>and</strong> sends a Control Response comm<strong>and</strong> to the selected logical address. Theresponse_mask field has a value in the range of 0 to 127 inclusive, <strong>and</strong> is defined in VXI rev.1.3. It is specified with a or as a non-decimal value. The response to thiscomm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optionalWord Serial Support comm<strong>and</strong>.26.5.1.13 :ENOVXI:WSPRotocol:COMM<strong>and</strong>:ENOThis comm<strong>and</strong> sends an End Normal Operation comm<strong>and</strong> to the selected logical address.The response to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse?comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.14 :GDEVice VXI:WSPRotocol:COMM<strong>and</strong>:GDEViceThis comm<strong>and</strong> sends a Grant Device comm<strong>and</strong> to the selected logical address. Thelogical_address field has a value in the range of 0 to 255 inclusive. It is specified with a or as a non-decimal value. This is an optional Word Serial Supportcomm<strong>and</strong>.26.5.1.15 :ICOMm<strong>and</strong>er VXI:WSPRotocol:COMM<strong>and</strong>:ICOMm<strong>and</strong>erThis comm<strong>and</strong> sends a Identify Comm<strong>and</strong>er comm<strong>and</strong> to the selected logical address. Thelogical_address field has a value in the range of 0 to 255 inclusive. It is specified with a or as a non-decimal value. This is an optional Word Serial Supportcomm<strong>and</strong>.26.5.1.16 :RDEVice VXI:WSPRotocol:COMM<strong>and</strong>:RDEViceThis comm<strong>and</strong> sends a Release Device comm<strong>and</strong> to the selected logical address. Thelogical_address field has a value in the range of 0 to 255 inclusive. It is specified with a or as a non-decimal value. The response to this comm<strong>and</strong> can be read withthe VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Supportcomm<strong>and</strong>.26.5.1.17 :RHANdlersVXI:WSPRotocol:COMM<strong>and</strong>:RHANdlersThis comm<strong>and</strong> sends a Read H<strong>and</strong>lers comm<strong>and</strong> to the selected logical address. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.1234567891011121314151617181920212223242526VXI 26-11


1997 SCPI Comm<strong>and</strong> Reference2626.5.1.18 :RHLine VXI:WSPRotocol:COMM<strong>and</strong>:RHLineThis comm<strong>and</strong> sends a Read H<strong>and</strong>ler Line comm<strong>and</strong> to the selected logical address. Theh<strong>and</strong>_id field has a value in the range of 1 to 7 inclusive. It is specified with a or as a non-decimal value. The response to this comm<strong>and</strong> can be read withthe VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Supportcomm<strong>and</strong>.26.5.1.19 :RILine VXI:WSPRotocol:COMM<strong>and</strong>:RILineThis comm<strong>and</strong> sends a Read Interrupter Line comm<strong>and</strong> to the selected logical address. Theint_id field has a value in the range of 1 to 7 inclusive. It is specified with a or as a non-decimal value. The response to this comm<strong>and</strong> can be read withthe VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Supportcomm<strong>and</strong>.26.5.1.20 :RINTerrupterVXI:WSPRotocol:COMM<strong>and</strong>:RINTerrupterThis comm<strong>and</strong> sends a Read Interrupters comm<strong>and</strong> to the selected logical address. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.21 :RMODidVXI:WSPRotocol:COMM<strong>and</strong>:RMODidThis comm<strong>and</strong> sends a Read MODid comm<strong>and</strong> to the selected logical address. The responseto this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is anoptional Word Serial Support comm<strong>and</strong>.26.5.1.22 :RPERrorVXI:WSPRotocol:COMM<strong>and</strong>:RPERrorThis comm<strong>and</strong> sends a Read Protocol Error comm<strong>and</strong> to the selected logical address. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.23 :RPRotocolVXI:WSPRotocol:COMM<strong>and</strong>:RPRotocolThis comm<strong>and</strong> sends a Read Protocol comm<strong>and</strong> to the selected logical address. The responseto this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is anoptional Word Serial Support comm<strong>and</strong>.26.5.1.24 :RSTBVXI:WSPRotocol:COMM<strong>and</strong>:RSTBThis comm<strong>and</strong> sends a Read Status Byte comm<strong>and</strong> to the selected logical address. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.26-12 VXI


1997 SCPI Comm<strong>and</strong> Reference26.5.1.25 :RSAReaVXI:WSPRotocol:COMM<strong>and</strong>:RSAReaThis comm<strong>and</strong> sends a Read Servant Area comm<strong>and</strong> to the selected logical address. Theresponse to this comm<strong>and</strong> can be read with the VXI:WSPRotocol:RESPonse? comm<strong>and</strong>.This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.26 :SLModid ,VXI:WSPRotocol:COMM<strong>and</strong>:SLModidThis comm<strong>and</strong> sends a Set Lower MODid comm<strong>and</strong> to the selected logical address. TheBoolean field selects whether the Enable bit is set in the comm<strong>and</strong>. The MODID 6-0 fieldhas a value in the range of 0 to 127 inclusive. It is specified with a or as anon-decimal value. The response to this comm<strong>and</strong> can be read with theVXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.27 :SLOCkVXI:WSPRotocol:COMM<strong>and</strong>:SLOCkThis comm<strong>and</strong> sends a Set Lock comm<strong>and</strong> to the selected logical address. This is an optionalWord Serial Support comm<strong>and</strong>.26.5.1.28 :SUModid ,VXI:WSPRotocol:COMM<strong>and</strong>:SUModidThis comm<strong>and</strong> sends a Set Upper MODid comm<strong>and</strong> to the selected logical address. TheBoolean field selects whether the Enable bit is set in the comm<strong>and</strong>. The MODID 12-7 fieldhas a value in the range of 0 to 63 inclusive. It is specified with a or as anon-decimal value. The response to this comm<strong>and</strong> can be read with theVXI:WSPRotocol:RESPonse? comm<strong>and</strong>. This is an optional Word Serial Support comm<strong>and</strong>.26.5.1.29 :TRIGgerVXI:WSPRotocol:COMM<strong>and</strong>:TRIGgerThis comm<strong>and</strong> sends a Trigger comm<strong>and</strong> to the selected logical address. This is an optionalWord Serial Support comm<strong>and</strong>.26.5.2 :MESSageVXI:WSPRotocol:MESSageThis node collects together all the messages (as defined by VXI) of the word serial protocol.26.5.2.1 :RECeive? |VXI:WSPRotocol:MESSage:RECeive?This comm<strong>and</strong> receives a message from the selected logical address using both the wordserial protocol <strong>and</strong> the byte transfer protocol. The comm<strong>and</strong> will always terminate on theEnd bit being set. Additional termination options are on a specified number of bytes (count),or on a match to a particular terminator, (that is, LF, CRLF, END). The response is returnedas a string. This is a required Word Serial Support comm<strong>and</strong>.26.5.2.2 :SEND [,(END|NEND)]VXI:WSPRotocol:MESSage:SENDThis comm<strong>and</strong> sends the specified message string to the selected logical address. The stringis sent using the word serial protocol with the byte transfer protocol. The last byte of the1234567891011121314151617181920212223242526VXI 26-13


1997 SCPI Comm<strong>and</strong> Reference26string is sent with the End bit set unless NEND is specified. This is a required Word SerialSupport comm<strong>and</strong>.26.5.3 :QUERyVXI:WSPRotocol:QUERyThis node collects together all the queries (as defined by VXI) of the word serial protocol.26.5.3.1 [:ANY]? VXI:WSPRotocol:QUERy:ANY?This comm<strong>and</strong> sends the specified word serial query to the selected logical address. The datafield is a or a non-decimal value which specifies the query to be sent. Thereturned value is the response to the word serial query <strong>and</strong> is a . This comm<strong>and</strong> obeysthe byte transfer protocol. This is a required Word Serial Support comm<strong>and</strong>.26.5.3.2 :AHLine? ,VXI:WSPRotocol:QUERy:AHLine?This comm<strong>and</strong> sends an Assign H<strong>and</strong>ler Line comm<strong>and</strong> to the selected logical address. Theh<strong>and</strong>_id field has a value in the range of 1 to 7 inclusive, <strong>and</strong> line_number field has a valuein the range of 0 to 7 inclusive. They are both specified with s or asnon-decimal values. The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a .This is an optional Word Serial Support comm<strong>and</strong>.26.5.3.3 :AILine? ,VXI:WSPRotocol:QUERy:AILine?This comm<strong>and</strong> sends an Assign Interrupter Line comm<strong>and</strong> to the selected logical address.The int_id field has a value in the range of 1 to 7 inclusive, <strong>and</strong> line_number field has avalue in the range of 0 to 7 inclusive. They are both specified with s or asnon-decimal values. The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a .This is an optional Word Serial Support comm<strong>and</strong>.26.5.3.4 :AMControl? VXI:WSPRotocol:QUERy:AMControl?This comm<strong>and</strong> sends an Asynchronous Mode Control comm<strong>and</strong> to the selected logicaladdress. The response_mask field has a value in the range of 0 to 15 inclusive, <strong>and</strong> is definedin VXI rev. 1.3. It is specified with a or as a non-decimal value. Thereturned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional WordSerial Support comm<strong>and</strong>.26.5.3.5 :ANO?VXI:WSPRotocol:QUERy:ANO?This comm<strong>and</strong> sends an Abort Normal Operation comm<strong>and</strong> to the selected logical address.The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optionalWord Serial Support comm<strong>and</strong>.26.5.3.6 :BNO? VXI:WSPRotocol:QUERy:BNO?This comm<strong>and</strong> sends an Begin Normal Operation comm<strong>and</strong> to the selected logical address.The Boolean field selects whether the Top_level bit is set in the comm<strong>and</strong>. The returned26-14 VXI


1997 SCPI Comm<strong>and</strong> Referencevalue is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional Word SerialSupport comm<strong>and</strong>.26.5.3.7 :BRQ?VXI:WSPRotocol:QUERy:BRQ?This comm<strong>and</strong> sends an Byte Request comm<strong>and</strong> to the selected logical address. The returnedvalue is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional Word SerialSupport comm<strong>and</strong>.26.5.3.8 :CEVent? ,VXI:WSPRotocol:QUERy:CEVent?This comm<strong>and</strong> sends a Control Event comm<strong>and</strong> to the selected logical address. The Booleanfield selects whether the Enable bit is set in the comm<strong>and</strong>. The event_number field has avalue in the range of 0 to 127 inclusive. It is specified with a or as anon-decimal value. The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . Thisis an optional Word Serial Support comm<strong>and</strong>.26.5.3.9 :CRESponse? VXI:WSPRotocol:QUERy:CRESponse?This comm<strong>and</strong> sends a Control Response comm<strong>and</strong> to the selected logical address. Theresponse_mask field has a value in the range of 0 to 127 inclusive, <strong>and</strong> is defined in VXI rev.1.3. It is specified with a numeric_value or as a non-decimal value. The returned value is theresponse to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional Word Serial Supportcomm<strong>and</strong>.26.5.3.10 :ENO?VXI:WSPRotocol:QUERy:ENO?This comm<strong>and</strong> sends an End Normal Operation comm<strong>and</strong> to the selected logical address.The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optionalWord Serial Support comm<strong>and</strong>.26.5.3.11 :RDEVice? VXI:WSPRotocol:QUERy:RDEVice?This comm<strong>and</strong> sends a Release Device comm<strong>and</strong> to the selected logical address. Thelogical_address field has a value in the range of 0 to 255 inclusive. It is specified with a or as a non-decimal value. The returned value is the response to thecomm<strong>and</strong> <strong>and</strong> is a . This is an optional Word Serial Support comm<strong>and</strong>.26.5.3.12 :RHANdlers?VXI:WSPRotocol:QUERy:RHANdlers?This comm<strong>and</strong> sends a Read H<strong>and</strong>lers comm<strong>and</strong> to the selected logical address. Thereturned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional WordSerial Support comm<strong>and</strong>.26.5.3.13 :RHLine? VXI:WSPRotocol:QUERy:RHLine?This comm<strong>and</strong> sends a Read H<strong>and</strong>ler Line comm<strong>and</strong> to the selected logical address. Theh<strong>and</strong>_id field has a value in the range of 1 to 7 inclusive. It is specified with a1234567891011121314151617181920212223242526VXI 26-15


1997 SCPI Comm<strong>and</strong> Reference26 or as a non-decimal value. The returned value is the response to thecomm<strong>and</strong> <strong>and</strong> is a . This is an optional Word Serial Support comm<strong>and</strong>.26.5.3.14 :RILine? VXI:WSPRotocol:QUERy:RILine?This comm<strong>and</strong> sends a Read Interrupter Line comm<strong>and</strong> to the selected logical address. Theint_id field has a value in the range of 1 to 7 inclusive. It is specified with a or as a non-decimal value. The returned value is the response to thecomm<strong>and</strong> <strong>and</strong> is a . This is an optional Word Serial Support comm<strong>and</strong>.26.5.3.15 :RINTerrupter?VXI:WSPRotocol:QUERy:RINTerrupter?This comm<strong>and</strong> sends a Read Interrupters comm<strong>and</strong> to the selected logical address. Thereturned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional WordSerial Support comm<strong>and</strong>.26.5.3.16 :RMODid?VXI:WSPRotocol:QUERy:RMODid?This comm<strong>and</strong> sends a Read MODid comm<strong>and</strong> to the selected logical address. The returnedvalue is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional Word SerialSupport comm<strong>and</strong>.26.5.3.17 :RPERror?VXI:WSPRotocol:QUERy:RPERror?This comm<strong>and</strong> sends a Read Protocol Error comm<strong>and</strong> to the selected logical address. Thereturned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional WordSerial Support comm<strong>and</strong>.26.5.3.18 :RPRotocol?VXI:WSPRotocol:QUERy:RPRotocol?This comm<strong>and</strong> sends a Read Protocol comm<strong>and</strong> to the selected logical address. The returnedvalue is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional Word SerialSupport comm<strong>and</strong>.26.5.3.19 :RSTB?VXI:WSPRotocol:QUERy:RSTB?This comm<strong>and</strong> sends a Read Status Byte comm<strong>and</strong> to the selected logical address. Thereturned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional WordSerial Support comm<strong>and</strong>.26.5.3.20 :RSARea?VXI:WSPRotocol:QUERy:RSARea?This comm<strong>and</strong> sends a Read Servant Area comm<strong>and</strong> to the selected logical address. Thereturned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . This is an optional WordSerial Support comm<strong>and</strong>.26-16 VXI


1997 SCPI Comm<strong>and</strong> Reference26.5.3.21 :SLModid? ,VXI:WSPRotocol:QUERy:SLModid?This comm<strong>and</strong> sends a Set Lower MODid comm<strong>and</strong> to the selected logical address. TheBoolean field selects whether the Enable bit is set in the comm<strong>and</strong>. The MODID 6-0 fieldhas a value in the range of 0 to 127 inclusive. It is specified with a or as anon-decimal value. The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . Thisis an optional Word Serial Support comm<strong>and</strong>.26.5.3.22 :SUModid? ,VXI:WSPRotocol:QUERy:SUModid?This comm<strong>and</strong> sends a Set Upper MODid comm<strong>and</strong> to the selected logical address. TheBoolean field selects whether the Enable bit is set in the comm<strong>and</strong>. The MODID 12-7 fieldhas a value in the range of 0 to 63 inclusive. It is specified with a or as anon-decimal value. The returned value is the response to the comm<strong>and</strong> <strong>and</strong> is a . Thisis an optional Word Serial Support comm<strong>and</strong>.26.5.4 :RESPonse?VXI:WSPRotocol:RESPonse?This comm<strong>and</strong> returns one word of data from the data low register on the selected logicaladdress. This comm<strong>and</strong> obeys the Byte transfer protocol. The data is returned as a .This is a required Word Serial Support comm<strong>and</strong>.1234567891011121314151617181920212223242526VXI 26-17


1997 SCPI Comm<strong>and</strong> Reference2626-18 VXI


IndexAABORt 2-5HCOPy 10-4TRIGger Subsystem 24-12:ACINPut:BIAS:CURRent 11-4INPut:BIAS:VOLTage 11-4MEASure 3-9SENSe:CURRent 18-19SENSe:POWer 18-55SENSe:VOLTage 18-73:ACHannelSENSe:POWer 18-54:ACQUireSOURce:CORRection:COLLect 19-11:ACQuire STANdardSENSe:CORRection:COLLect 18-13:ADDRessSYSTem:COMMunicate:GPIB 21-5SYSTem:COMMunicate:GPIB:RDEVice 21-5:ADJustSOURce:PHASe 19-47:AFCSENSe 18-31:AHLineVXI:WSPRotocol:COMM<strong>and</strong> 26-9:AHLine?VXI:WSPRotocol:QUERy 26-14:AILineVXI:WSPRotocol:COMM<strong>and</strong> 26-9:AILine?VXI:WSPRotocol:QUERy 26-14:ALCSOURce:CURRent 19-17SOURce:POWer 19-52SOURce:VOLTage 19-82:ALLCALCulate:MATH:EXPRession:DELete 4-22CALibration 5-1DISPlay:ANNotation 8-4HCOPy:ITEM 10-8MEMory:DELete 13-6PROGram:SELected:DELete 16-2ROUTe:MODule:DELete 17-4ROUTe:OPEN 17-2ROUTe:PATH:DELete 17-3SENSe:FUNCtion:OFF 18-37SENSe:FUNCtion:ON 18-38SOURce:DM:THReshold 19-28TRACe | DATA:DELete 23-4TRIGger Subsystem:INITiate:CONTinuous 24-22TRIGger Subsystem:INITiate:IMMediate 24-22:ALL ACSOURce:DM:COUPling 19-28:ALL DCSOURce:DM:COUPling 19-28:ALL GROundSOURce:DM:COUPling 19-28:ALL?CALibration 5-1MEMory:CATalog 13-3MEMory:FREE 13-6VXI:CONFigure:HIERarchy? 26-4VXI:CONFigure:HIERarchy?:VERBose? 26-4VXI:CONFigure:INFormation? 26-6:ALTernateSYSTem 21-3AMSENSe:FUNCtion 18-43SOURce 19-5 - 19-8SOURce:LIST 19-40AM SubsystemSENSe 18-3 - 18-4SOURce 19-5 - 19-8:AMControlVXI:WSPRotocol:COMM<strong>and</strong> 26-10:AMControl?VXI:WSPRotocol:QUERy 26-14Amorphous SENSe ModelInstrument Model:Internal Routing 2-8:AMPLitudeDISPlay:ANNotation 8-4MEASure 3-11SOURce:CURRent:LEVel:IMMediate 19-19SOURce:CURRent:LEVel:TRIGgered 19-20SOURce:CURRent:LIMit 19-20SOURce:MARKer 19-45SOURce:POWer:LEVel:IMMediate 19-54SOURce:POWer:LEVel:TRIGgered 19-55SOURce:POWer:LIMit 19-55SOURce:RESistance:LEVel:IMMediate 19-66SOURce:RESistance:LEVel:TRIGgered 19-67SOURce:RESistance:LIMit 19-67Index - 1


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:VOLTage:LEVel:IMMediate 19-84SOURce:VOLTage:LEVel:TRIGgered 19-85SOURce:VOLTage:LIMit 19-85:ANGLeINPut:POSition:X 11-8INPut:POSition:Y 11-10INPut:POSition:Z 11-12OUTPut:POSition:X 15-6OUTPut:POSition:Y 15-8OUTPut:POSition:Z 15-10SOURce:DM:LEAKage 19-27SOURce:DM:QUADrature 19-28UNIT 25-1:ANNotationDISPlay 8-4HCOPy:ITEM 10-8:ANOVXI:WSPRotocol:COMM<strong>and</strong> 26-10:ANO?VXI:WSPRotocol:QUERy 26-14:ANYVXI:WSPRotocol:COMM<strong>and</strong> 26-9:ANY?VXI:WSPRotocol:QUERy 26-14:AOFFSOURce:MARKer 19-45:APERtureCALCulate:GDAPerture 4-17CALCulate:SMOothing 4-23SENSe:CURRent:AC|:DC 18-19SENSe:FREQuency 18-30SENSe:POWer:AC|:DC 18-55SENSe:RESistance 18-59SENSe:SMOothing 18-64SENSe:VOLTage:AC|:DC 18-73:APOWerCONTrol 6-1 - 6-2SOURce:LIST:CONTrol 19-41:APRobeSOURce:LIST 19-40ARM 2-5TRIGger Subsystem 24-12 - 24-20:ARM-TRIGger ModelTRIGger Subsystem 24-1:ARRayMEASure 3-7ASCii 9-1, 9-3:ASCii?MEMory:CATalog 13-3MEMory:FREE 13-7:ATRiggerTRIGger Subsystem:TRIGger:SEQuence 24-23:ATTenuationOUTPut Subsystem 15-3:ATTenuationINPut 11-3SENSe:CURRent:AC|:DC 18-20SENSe:POWer:AC|:DC 18-55SENSe:VOLTage:AC|:DC 18-74SOURce:CURRent 19-17SOURce:POWer 19-52SOURce:VOLTage 19-82:ATTRibutesDISPlay:WINDow:TEXT 8-9:AUTOCALCulate 4-7, 4-12, 4-14, 4-18, 4-21,4-25 - 4-26, 4-28, 4-31CALibration 5-1 - 5-2DISPlay 8-11 - 8-12, 8-14 - 8-15HCOPy 10-13INPut:ATTenuation 11-3INPut:GAIN 11-6OUTPut:FILTer 15-3SENSe 18-3, 18-6, 18-9 - 18-10, 18-16,18-20 - 18-22, 18-25, 18-29, 18-31 - 18-33,18-50 - 18-53, 18-55 - 18-58, 18-60 - 18-61,18-63, 18-68, 18-71, 18-74 - 18-76SENSe:ROSCillator:SOURce INTernal 19-71SOURce 19-17 - 19-19, 19-22, 19-34, 19-36,19-41, 19-43, 19-52 - 19-53, 19-57, 19-64,19-70, 19-73 - 19-74, 19-82 - 19-84, 19-87SYSTem 21-8, 21-31TRACe | DATA 23-5TRIGger Subsystem:ARM:SEQuence:LAYer:DELay 24-14TRIGger Subsystem:ARM:SEQuence:LAYer:LEVel 24-16TRIGger Subsystem:TRIGger:SEQuence:DELay 24-26TRIGger Subsystem:TRIGger:SEQuence:LEVel 24-28:AVERage SubsystemCALCulate 4-6 - 4-8SENSe 18-5 - 18-8:AWEightingINPut:FILTer 11-5SENSe:FILTer 18-28:AXISDISPlay:WINDow:TRACe:GRATicule 8-11B:BACKgroundDISPlay:WINDow 8-6Index - 2


1997 SCPI Comm<strong>and</strong> Reference:BANDwidthSOURce:POWer:ALC 19-53:BANDwidthSENSe:DETector 18-24SOURce:CURRent:ALC 19-18SOURce:VOLTage:ALC 19-83BANDwidth SubsystemSENSe 18-9 - 18-10:BAUDSYSTem:COMM:SERial:RECeive 21-7SYSTem:COMM:SERial:TRANsmit 21-8:BAVailableVXI:WSPRotocol:COMM<strong>and</strong> 26-10:BEEPerSYSTem 21-3:BIASINPut 11-3SENSe:MIXer 18-51BINary 9-2 - 9-3:BINary?MEMory:CATalog 13-3MEMory:FREE 13-7:BITSSYSTem:COMM:SERial:RECeive 21-7SYSTem:COMM:SERial:TRANsmit 21-9:BLOWerCONTrol 6-1SOURce:LIST:CONTrol 19-41:BNOVXI:WSPRotocol:COMM<strong>and</strong> 26-10:BNO?VXI:WSPRotocol:QUERy 26-14:BORDerFORMat 9-1:BOTTomDISPlay:WINDow:TRACe:Y:SCALe 8-14:BRIGhtnessDISPlay 8-4:BRQVXI:WSPRotocol:COMM<strong>and</strong> 26-10:BRQ?VXI:WSPRotocol:QUERy 26-15:BURSt:MEASure:FREQuency 3-9BWIDthSENSe:DETector 18-24SOURce:CURRent:ALC 19-18SOURce:POWer:ALC 19-53SOURce:VOLTage:ALC 19-83:BWIDth SubsystemSENSe 18-9 - 18-10CCALCulateInstrument Model:Measurement Function 2-4Instrument Model:Signal Generation 2-5CALCulate Subsystem 4-1 - 4-32CALibration Subsystem 5-1 - 5-2:CAPability?SYSTem 21-4:CARMSENSe:FILTer 18-28:CATalogCALCulate:MATH:EXPRession 4-21MEMory 13-3SYSTem:KEY 21-30:CATalog?MMEMory 14-2PROGram 16-2ROUTe:MODule 17-4ROUTe:PATH 17-3TRACe | DATA 23-2:CCIRSENSe:FILTer 18-28:CCITtSENSe:FILTer 18-27:CDFunctionSENSe:FUNCtion:VOLTage 18-48:CDIRectoryMMEMory 14-3:CENTerCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:TRANsform:DISTance 4-28CALCulate:TRANsform:FREQuency 4-30CALCulate:TRANsform:TIME 4-26DISPlay:WINDow:TRACe:X:SCALe 8-12SENSe:FREQuency 18-30SOURce:CURRent 19-18SOURce:FREQuency 19-34SOURce:POWer 19-53SOURce:RESistance 19-68SOURce:VOLTage 19-83:CENTronicsSYSTem:COMMunicate 21-4:CEVentVXI:WSPRotocol:COMM<strong>and</strong> 26-10:CEVent?VXI:WSPRotocol:QUERy 26-15:CHECkSYSTem:COMM:SERial:RECeive 21-8:CLEarCALCulate:AVERage 4-6Index - 3


1997 SCPI Comm<strong>and</strong> ReferenceCALCulate:LIMit 4-21DISPlay:WINDow:GRAPhics 8-7DISPlay:WINDow:TEXT 8-9MEMory 13-4OUTPut:PROTection 15-12SENSe:CURRent:AC|:DC:PROTection 18-20SENSe:POWer:AC|:DC:PROTection 18-56SENSe:VOLTage:AC|:DC:PROTection 18-74SOURce:CURRent:PROTection 19-22SOURce:POWer:PROTection 19-57SOURce:RESistance:PROTection 19-68SOURce:VOLTage:PROTection 19-87:CLIMitsCALCulate 4-9:CLOCkSOURce:DM 19-29SOURce:DM:THReshold 19-28VXI:WSPRotocol:COMM<strong>and</strong> 26-11:CLOCk ACSOURce:DM:COUPling 19-28:CLOCk DCSOURce:DM:COUPling 19-28:CLOCk GROundSOURce:DM:COUPling 19-28Cloned ModelsInstrument Model:Internal Routing 2-7:CLOSeMMEMory 14-3ROUTe 17-1:CLRVXI:WSPRotocol:COMM<strong>and</strong> 26-10:CMAPDISPlay 8-4HCOPy:DEVice 10-5:CMESsageSENSe:FILTer 18-27:COAXSENSe:CORRection:RVELocity 18-18SOURce:CORRection:RVELocity 19-14:COHerenceSENSe:FUNCtion:POWer 18-46:COLLectSENSe:CORRection 18-13SOURce:CORRection 19-11:COLorDISPlay:CMAP 8-4DISPlay:WINDow:BACKground 8-6DISPlay:WINDow:GRAPhics 8-7DISPlay:WINDow:TEXT 8-9DISPlay:WINDow:TRACe 8-10HCOPy:DEVice 10-6HCOPy:DEVice:CMAP 10-5HCOPy:ITEM:ANNotation 10-8HCOPy:ITEM:LABel 10-9HCOPy:ITEM:MENU 10-10HCOPy:ITEM:TDSTamp 10-11HCOPy:ITEM:WINDow:TEXT 10-12HCOPy:ITEM:WINDow:TRACe 10-12HCOPy:ITEM:WINDow:TRACe:GRATicule 10-12COMBine SubsystemSOURce 19-9:COMM<strong>and</strong>VXI:WSPRotocol 26-9:Comm<strong>and</strong> ErrorSYSTem:ERRor? 21-13:COMMunicateSYSTem 21-4 - 21-8:COMPressorCONTrol 6-1SOURce:LIST:CONTrol 19-41:CONCurrentSENSe:FUNCtion 18-36SOURce:LIST 19-40:CONDitionMEMory:TABLe 13-8SENSe:FUNCtion 18-44CONDition SubsystemSENSe 18-11:CONDition?STATus 20-3CONFigureMeasurement Instructions 3-2VXI 26-3:CONTinuousTRIGger Subsystem:INITiate 24-21:CONTrastDISPlay 8-5:CONTrolCALCulate:LIMit 4-19SOURce:LIST 19-41SYSTem:COMM:SERial 21-5:CONTrol , ALWaysTRACe | DATA:FEED 23-4:CONTrol NEVerTRACe | DATA:FEED 23-4:CONTrol NEXTTRACe | DATA:FEED 23-4:CONTrol OCONditionTRACe | DATA:FEED 23-4CONTrol Subsystem 6-1 - 6-2:COPYMEMory 13-5MMEMory 14-3Index - 4


1997 SCPI Comm<strong>and</strong> ReferenceTRACe | DATA 23-2CORRection SubsystemSENSe 18-12 - 18-18SOURce 19-10 - 19-15:COUNtCALCulate:AVERage 4-7CALCulate:TRANsform:HISTogram 4-24SENSe:AVERage 18-6SENSe:LIST 18-49SENSe:SWEep 18-67SOURce:LIST 19-41SOURce:PULSe 19-64SOURce:SWEep 19-75TRIGger Subsystem:ARM:SEQuence:LAYer 24-14TRIGger Subsystem:TRIGger:SEQuence 24-24:COUNt?SENSe:FUNCtion:OFF 18-37SENSe:FUNCtion:ON 18-38:COUPleINSTrument 12-2:COUPlingOUTPut Subsystem 15-3SOURce:DM 19-28:COUPling ACINPut 11-4SOURce:AM 19-5SOURce:AM:EXTernal 19-6SOURce:FM 19-31SOURce:FM:EXTernal 19-32SOURce:PM 19-49SOURce:PM:EXTernal 19-50TRIGger Subsystem:ARM:SEQuence:LAYer 24-14TRIGger Subsystem:TRIGger:SEQuence 24-24:COUPling DCINPut 11-4SOURce:AM 19-5SOURce:AM:EXTernal 19-6SOURce:FM 19-31SOURce:FM:EXTernal 19-32SOURce:PM 19-49SOURce:PM:EXTernal 19-50TRIGger Subsystem:ARM:SEQuence:LAYer 24-14TRIGger Subsystem:TRIGger:SEQuence 24-24:COUPling GROundINPut 11-4SOURce:AM 19-5SOURce:AM:EXTernal 19-6SOURce:FM 19-31SOURce:FM:EXTernal 19-32SOURce:PM 19-49SOURce:PM:EXTernal 19-50:CPOintDISPlay:WINDow:TRACe:R:SCALe 8-15:CPONSYSTem 21-9:CREFerenceCALCulate:FORMat:UPHase 4-17:CRESponseVXI:WSPRotocol:COMM<strong>and</strong> 26-11:CRESponse?VXI:WSPRotocol:QUERy 26-15:CROSsSENSe:FUNCtion:POWer 18-46:CSETSENSe:CORRection 18-14SOURce:CORRection 19-11:CSIZeDISPlay:WINDow:GRAPhics 8-7DISPlay:WINDow:TEXT 8-10:CTYPe?SYSTem 21-10:CURRent:MEASure 3-8INPut:BIAS 11-3MEMory:TABLe 13-9SENSe:FUNCtion 18-44SOURce 19-16 - 19-24SOURce:LIST 19-41CURRent SubsystemSENSe 18-19 - 18-23SOURce 19-16 - 19-24:CURRent, :POWer, <strong>and</strong> :VOLTageUNIT 25-1:CUTHCOPy:ITEM 10-8:CWSENSe:FREQuency 18-31SOURce:FREQuency 19-34D:DATA 23-1 - 23-6CALCulate:LIMit:CONTrol 4-19CALCulate:LIMit:LOWer 4-20CALCulate:LIMit:UPPer 4-19CALibration 5-1DISPlay:WINDow:TEXT 8-10FORMat 9-1HCOPy:ITEM:TDSTamp 10-11MEMory 13-5MMEMory 14-3Index - 5


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:DM:THReshold 19-28TRACe | DATA 23-2:DATA ACSOURce:DM:COUPling 19-28Data <strong>and</strong> Control FlowInstrument Model:Internal Routing 2-6:DATA DCSOURce:DM:COUPling 19-28:DATA GROundSOURce:DM:COUPling 19-28DATA SubsystemSENSe 18-35 - 18-48:DATA?CALCulate 4-10CALCulate:CLIMits:FLIMits 4-9CALCulate:LIMit:REPort 4-20HCOPy 10-4HCOPy:ITEM:ALL 10-8HCOPy:ITEM:CUT 10-9HCOPy:ITEM:FFEEd 10-9HCOPy:ITEM:LABel 10-10HCOPy:ITEM:MENU 10-10HCOPy:ITEM:WINDow 10-11HCOPy:ITEM:WINDow:TEXT 10-12HCOPy:ITEM:WINDow:TRACe 10-12HCOPy:ITEM:WINDow:TRACe:GRATicule 10-12HCOPy:SDUMp 10-15SENSe:FUNCtion & DATA 18-35:DATESYSTem 21-10:DCINPut:BIAS:CURRent 11-4INPut:BIAS:VOLTage 11-4MEASure 3-9SENSe:CURRent 18-19SENSe:POWer 18-55SENSe:VOLTage 18-73:DCYCle:MEASure 3-14SOURce:PULSe 19-62:DEFaultDISPlay:CMAP 8-4HCOPy:DEVice:CMAP 10-6PROGram:SELected 16-3:DEFineCALCulate:MATH:EXPRession 4-22MEMory Subsystem:TABLe 13-9PROGram:EXPLicit 16-4PROGram:SELected 16-2ROUTe:MODule 17-4ROUTe:PATH 17-3SYSTem:KEY 21-30TRACe | DATA 23-3TRIGger Subsystem:ARM:SEQuence 24-12TRIGger Subsystem:TRIGger:SEQuence 24-24:DELayOUTPut:PROTection 15-12SOURce:PULSe 19-63SOURce:PULSe:DOUBle 19-63SYSTem:COMMunicate:SERial:TRANsmit 21-9TRIGger Subsystem:ARM:SEQuence:LAYer 24-14TRIGger Subsystem:TRIGger:SEQuence 24-25:DELeteCALCulate:MATH:EXPRession 4-22MEMory 13-5MMEMory 14-3PROGram:EXPLicit 16-5PROGram:SELected 16-2ROUTe:MODule 17-4ROUTe:PATH 17-3SYSTem:KEY 21-30TRACe | DATA 23-4:DEMPhasisSENSe:FILTer 18-27:DEPThSENSe:AM 18-3SOURce:AM 19-5SOURce:LIST:AM 19-40:DERivativeCALCulate 4-10DESTination 2-3DESTination?HCOPy 10-4:DETector EXTernalSENSe:CURRent 18-23SENSe:POWer 18-58SENSe:VOLTage 18-77:DETector INTernalSENSe:CURRent 18-23SENSe:POWer 18-58SENSe:VOLTage 18-77DETector SubsystemSENSe 18-24 - 18-25:DEViationSENSe:FM 18-29SENSe:PM 18-53SOURce:FM 19-31SOURce:PM 19-48:DEViceHCOPy 10-5 - 10-6:Device-Specific ErrorSYSTem:ERRor? 21-22Index - 6


1997 SCPI Comm<strong>and</strong> ReferenceDIAGnostic Subsystem 7-1 - 7-2Digital Modulation SubsystemSOURce 19-25 - 19-30:DIMensionsHCOPy:PAGE 10-13:DINTerchangeFORMat 9-2MMEMory:LOAD <strong>and</strong> :STORe 14-4:DIRection DOWNINPut:POSition:X:ANGLe 11-8INPut:POSition:X:DISTance 11-9INPut:POSition:Y:ANGLe 11-10INPut:POSition:Y:DISTance 11-11INPut:POSition:Z:ANGLe 11-12INPut:POSition:Z:DISTance 11-13OUTPut:POSition:X:ANGLe 15-6OUTPut:POSition:X:DISTance 15-7OUTPut:POSition:Y:ANGLe 15-8OUTPut:POSition:Y:DISTance 15-9OUTPut:POSition:Z:ANGLe 15-10OUTPut:POSition:Z:DISTance 15-11SENSe:CURRent:AC|:DC 18-21SENSe:LIST 18-49SENSe:POWer:AC|:DC:RANGe:AUTO 18-57SENSe:RESistance:RANGe:AUTO 18-60SENSe:SWEep 18-67SENSe:VOLTage:AC|:DC 18-75SOURce:LIST 19-42SOURce:SWEep 19-74:DIRection EITHerSENSe:CURRent:AC|:DC 18-21SENSe:POWer:AC|:DC:RANGe:AUTO 18-57SENSe:RESistance:RANGe:AUTO 18-60SENSe:VOLTage:AC|:DC 18-75:DIRection UPINPut:POSition:X:ANGLe 11-8INPut:POSition:X:DISTance 11-9INPut:POSition:Y:ANGLe 11-10INPut:POSition:Y:DISTance 11-11INPut:POSition:Z:ANGLe 11-12INPut:POSition:Z:DISTance 11-13OUTPut:POSition:X:ANGLe 15-6OUTPut:POSition:X:DISTance 15-7OUTPut:POSition:Y:ANGLe 15-8OUTPut:POSition:Y:DISTance 15-9OUTPut:POSition:Z:ANGLe 15-10OUTPut:POSition:Z:DISTance 15-11SENSe:CURRent:AC|:DC 18-21SENSe:LIST 18-49SENSe:POWer:AC|:DC:RANGe:AUTO 18-57SENSe:RESistance:RANGe:AUTO 18-60SENSe:SWEep 18-67SENSe:VOLTage:AC|:DC 18-75SOURce:LIST 19-42SOURce:SWEep 19-74DISPlay Subsystem 8-1 - 8-16:DISTanceCALCulate:TRANsform 4-27INPut:POSition:X 11-9INPut:POSition:Y 11-11INPut:POSition:Z 11-13OUTPut:POSition:X 15-7OUTPut:POSition:Y 15-9OUTPut:POSition:Z 15-11SENSe:CORRection:EDELay 18-14SOURce:CORRection:EDELay 19-13:DISTortionSENSe:FUNCtion:POWer 18-43 - 18-46DMSOURce 19-25 - 19-30DM SubsystemSOURce 19-25 - 19-30:DMODe PARallelSOURce:DM 19-29:DMODe SERialSOURce:DM 19-29:DNUMber?VXI:CONFigure 26-3:DOUBleSOURce:PULSe 19-63:DRAWDISPlay:WINDow:GRAPhics 8-8:DTR IBFullSYSTem:COMM:SERial:CONTrol 21-5:DTR OFFSYSTem:COMM:SERial:CONTrol 21-5:DTR ONSYSTem:COMM:SERial:CONTrol 21-5:DTR STANdardSYSTem:COMM:SERial:CONTrol 21-5:DWELlSENSe:LIST 18-49SENSe:SWEep 18-67SOURce:LIST 19-42SOURce:SWEep 19-73E:ECLTRIGger Subsystem:ARM:SEQuence:LAYer 24-15TRIGger Subsystem:TRIGger:SEQuence 24-26:ECLTrgOUTPut Subsystem 15-12Index - 7


1997 SCPI Comm<strong>and</strong> Reference:ECOuntTRIGger Subsystem:ARM:SEQuence:LAYer 24-15TRIGger Subsystem:TRIGger:SEQuence 24-26:EDELaySENSe:CORRection 18-14SOURce:CORRection 19-13:ENABleDISPlay 8-5STATus 20-3:ENOVXI:WSPRotocol:COMM<strong>and</strong> 26-11:ENO?VXI:WSPRotocol:QUERy 26-15:Error/Event numbersSYSTem:ERRor? 21-11:The Error/Event QueueSYSTem:ERRor? 21-11:ERRor?SYSTem 21-10 - 21-25:Error/Event numbersSYSTem:ERRor? 21-11:EVENt?STATus 20-3Instrument Model:Internal Routing 2-14:EXCHangeMEMory 13-6:EXECutePROGram:EXPLicit 16-5PROGram:SELected 16-2:Execution ErrorSYSTem:ERRor? 21-17:Exp<strong>and</strong>ed Capability Trigger ModelTRIGger Subsystem 24-5 - 24-11:EXPLicitPROGram 16-4 - 16-6EXPonentialCALCulate:AVERage:TCONtrol 4-7CALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-27SENSe:WINDow:TYPE 18-78:EXPRessionCALCulate:MATH 4-21:EXTernalOUTPut:FILTer 15-3SENSe:ROSCillator 18-62, 19-71SOURce:AM 19-5SOURce:FM 19-31FSOURce:PM 19-50SOURce:PULM 19-59:FAIL?CALCulate:CLIMits 4-9CALCulate:LIMit 4-20:FALLMEASure 3-13:FCOunt?CALCulate:LIMit 4-20:FCUToffSENSe:CORRection:RVELocity 18-18SOURce:CORRection:RVELocity 19-14FEEDCALCulate 4-10DISPlay:WINDow:TEXT 8-10DISPlay:WINDow:TRACe 8-10HCOPy 10-7Instrument Model:Internal Routing 2-9MMEMory 14-4SYSTem:COMM:SERial 21-7SYSTem:COMMunicate:CENTronics 21-4SYSTem:COMMunicate:GPIB:RDEVice 21-5TRACe | DATA 23-4FEED ExceptionsInstrument Model:Internal Routing:Lamina <strong>and</strong> Cloned Models 2-8FEEDs from CALCulate Sub-BlocksInstrument Model:Internal Routing 2-12FETChMeasurement Instructions 3-3:FFEedHCOPy:ITEM 10-9:FIELdTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo 24-19TRIGger Subsystem:TRIGger:SEQuence:VIDeo 24-31:FILTerCALCulate 4-11 - 4-14INPut 11-5OUTPut Subsystem 15-3SOURce:DM 19-26TRIGger Subsystem:ARM:SEQuence:LAYer 24-15TRIGger Subsystem:TRIGger:SEQuence 24-26FILTer SubsystemSENSe 18-26 - 18-28:FIXedSENSe:FREQuency 18-31Index - 8


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:FREQuency 19-34:FLIMitsCALCulate:CLIMits 4-9FMSENSe:FUNCtion 18-44FM SubsystemSENSe 18-29SOURce 19-31 - 19-33:FORCeCALCulate:FILTer:GATE:FREQuency 4-15CALCulate:FILTer:GATE:TIME 4-13CALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-27SENSe:WINDow:TYPE 18-78FORMatCALCulate 4-15 - 4-16Instrument Model 2-5SOURce:DM 19-26TRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo 24-20TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd 24-31FORMat Subsystem 9-1 - 9-4:FRAMeDISPlay:WINDow:TRACe:GRATicule 8-11SOURce:DM 19-29:FREEMEMory 13-6:FREE?TRACe | DATA 23-5:FREQuency:MEASure 3-9CALCulate:FILTer:GATE 4-13CALCulate:TRANsform 4-29DISPlay:ANNotation 8-4INPut:FILTer:HPASs 11-5INPut:FILTer:LPASs 11-5MEMory Subsystem:TABLe 13-10OUTPut:FILTer:HPASs 15-4OUTPut:FILTer:LPASs 15-4SENSe:FILTer:HPASs 18-27SENSe:FILTer:LPASs 18-26SENSe:FUNCtion 18-44SENSe:LIST 18-50SENSe:ROSCillator:EXTernal 18-62, 19-71SENSe:ROSCillator:INTernal 18-62, 19-71SOURce:AM:INTernal 19-6SOURce:FM:INTernal 19-32SOURce:LIST 19-42SOURce:MARKer 19-45SOURce:PM:INTernal 19-50SOURce:PULM:INTernal 19-60SYSTem:BEEPer 21-3TRIGger Subsystem:ARM:SEQuence:LAYer:FILTer:HPASs 24-15TRIGger Subsystem:ARM:SEQuence:LAYer:FILTer:LPASs 24-15TRIGger Subsystem:TRIGger:SEQuence:FILTer:HPASs 24-26TRIGger Subsystem:TRIGger:SEQuence:FILTer:LPASs 24-27FREQuency SubsystemSENSe 18-30 - 18-34SOURce 19-34 - 19-37:FRESistance:MEASure 3-8SENSe:FUNCtion 18-45FRESistance SubsystemSENSe 18-59 - 18-61:FTIMeMEASure 3-13:FULLSENSe:FREQuency:SPAN 18-33SOURce:CURRent:SPAN 19-23SOURce:FREQuency:SPAN 19-36SOURce:POWer:SPAN 19-58SOURce:RESistance:SPAN 19-69SOURce:VOLTage:SPAN 19-88Measurement Instructions 3-5SENSe 18-36SENSe:DETector 18-24FUNCtion & DATA SubsystemSENSe 18-35 - 18-48FUNCtion SubsystemSOURce 19-38:SENSe:FUNCtion 18-41Fundamental Measurement LayerMEASure 3-7G:GAININPut 11-6SENSe:CORRection 18-15SOURce:CORRection 19-12:GATECALCulate:FILTer 4-11:GDAPertureCALCulate 4-17:GDEViceVXI:WSPRotocol:COMM<strong>and</strong> 26-11Index - 9


1997 SCPI Comm<strong>and</strong> Reference:GENeration ANALogSENSe:SWEep 18-68SOURce:SWEep 19-74:GENeration CONCurrentSOURce:LIST 19-42:GENeration DCONcurrentSOURce:LIST 19-42:GENeration DSEQuenceSOURce:LIST 19-42:GENeration SEQuenceSOURce:LIST 19-42:GENeration STEPpedSENSe:SWEep 18-68SOURce:SWEep 19-74:GEOMetryDISPlay:WINDow 8-6:GPIBSYSTem:COMMunicate 21-4:GRAPhicsDISPlay:WINDow 8-7:GRATiculeDISPlay:WINDow:TRACe 8-11HCOPy:ITEM:WINDow:TRACe 10-12:GRIDDISPlay:WINDow:TRACe:GRATicule 8-11:GUARdINPut 11-6H:HARMonicSENSe:MIXer 18-51HCOPy Subsystem 10-1 - 10-16:HEADers?SYSTem:HELP 21-27:HELPSYSTem 21-26 - 21-28HEXadecimal 9-2 - 9-3:HIERarchy?VXI:CONFigure 26-3:HIGHINPut:POSition:X:ANGLe:LIMit 11-8INPut:POSition:X:DISTance:LIMit 11-9INPut:POSition:Y:ANGLe:LIMit 11-10INPut:POSition:Y:DISTance:LIMit 11-11INPut:POSition:Z:ANGLe:LIMit 11-12INPut:POSition:Z:DISTance:LIMit 11-13MEASure 3-12OUTPut:POSition:X:ANGLe:LIMit 15-6OUTPut:POSition:X:DISTance:LIMit 15-7OUTPut:POSition:Y:ANGLe:LIMit 15-8OUTPut:POSition:Y:DISTance:LIMit 15-9OUTPut:POSition:Z:ANGLe:LIMit 15-10OUTPut:POSition:Z:DISTance:LIMit 15-11SOURce:CURRent:LEVel:IMMediate 19-19SOURce:CURRent:LEVel:TRIGgered 19-20SOURce:CURRent:LIMit 19-21SOURce:POWer:LEVel:IMMediate 19-54SOURce:POWer:LEVel:TRIGgered 19-55SOURce:POWer:LIMit 19-56SOURce:RESistance:LEVel:IMMediate 19-66SOURce:RESistance:LEVel:TRIGgered 19-67SOURce:RESistance:LIMit 19-67SOURce:VOLTage:LEVel:IMMediate 19-84SOURce:VOLTage:LEVel:TRIGgered 19-85SOURce:VOLTage:LIMit 19-86:HISTogramCALCulate:TRANsform 4-24SENSe:FUNCtion:VOLTage 18-48:HOLDSENSe:FREQuency:SPAN 18-33SOURce:CURRent:SPAN 19-23SOURce:FREQuency:SPAN 19-36SOURce:POWer:SPAN 19-58SOURce:RESistance:SPAN 19-69SOURce:VOLTage:SPAN 19-88:HOLD DCYCleSOURce:PULSe 19-62:HOLD WIDThSOURce:PULSe 19-62:HOLDoffTRIGger Subsystem:TRIGger:SEQuence 24-27:HORizontalINPut:POLarization 11-7OUTPut:POLarization 15-5:HPASsINPut:FILTer 11-5OUTPut:FILTer 15-4SENSe:FILTer 18-26TRIGger Subsystem:ARM:SEQuence:LAYer:FILTer 24-15TRIGger Subsystem:TRIGger:SEQuence:FILTer 24-26:HPGLDISPlay:WINDow:GRAPhics 8-8:HSLDISPlay:CMAP:COLor 8-5HCOPy:DEVice:CMAP:COLor 10-5:HYSTeresisSOURce:PULM:EXTernal 19-59TRIGger Subsystem:ARM:SEQuence:LAYer 24-16TRIGger Subsystem:TRIGger:SEQuence 24-27Index - 10


1997 SCPI Comm<strong>and</strong> ReferenceI:I INVertedSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:I NORMalSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:ICLock INVertedSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:ICLock NORMalSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:ICOMm<strong>and</strong>erVXI:WSPRotocol:COMM<strong>and</strong> 26-11:ICORrectionSOURce:DM:FILTer 19-26:IDLE StateTRIGger Subsystem:Model Layers 24-2:IDRawDISPlay:WINDow:GRAPhics 8-8:IMMediateCALCulate 4-18CALCulate:LIMit:CLEar 4-21HCOPy 10-7 - 10-13, 10-15INPut:POSition:X:ANGLe 11-8INPut:POSition:X:DISTance 11-9INPut:POSition:Y:ANGLe 11-10INPut:POSition:Y:DISTance 11-11INPut:POSition:Z:ANGLe 11-12INPut:POSition:Z:DISTance 11-13OUTPut:POSition:X:ANGLe 15-6OUTPut:POSition:X:DISTance 15-7OUTPut:POSition:Y:ANGLe 15-8OUTPut:POSition:Y:DISTance 15-9OUTPut:POSition:Z:ANGLe 15-10OUTPut:POSition:Z:DISTance 15-11OUTPut:TTLTrg|:ECLTrg 15-12SOURce:CURRent:LEVel 19-18SOURce:POWer:LEVel 19-53SOURce:RESistance:LEVel 19-66SOURce:VOLTage:LEVel 19-83SYSTem:BEEPer 21-3TRIGger Subsystem:ARM:SEQuence:LAYer 24-16TRIGger Subsystem:INITiate 24-22TRIGger Subsystem:TRIGger:SEQuence 24-27:IMOVeDISPlay:WINDow:GRAPhics 8-8:IMPedanceINPut 11-6OUTPut Subsystem 15-5SENSe:CORRection 18-15SOURce:AM:EXTernal 19-6SOURce:FM:EXTernal 19-32SOURce:PM:EXTernal 19-50SOURce:PULM:EXTernal 19-59:INFormation?VXI:CONFigure 26-4:INITializeMMEMory 14-4INITiate 2-5TRIGger Subsystem 24-21 - 24-22:InitiatedTRIGger Subsystem:Model Layers 24-2INPut 11-1 - 11-14Instrument Model:Measurement Function 2-3SENSe:CORRection:IMPedance 18-15SENSe:CORRection:LOSS 18-16Instrument Model 2-1 - 2-14INSTrument Subsystem 12-1 - 12-4INTeger 9-2:INTegralCALCulate 4-18:INTernalSENSe:ROSCillator 18-62, 19-71SOURce:AM 19-6SOURce:FM 19-32SOURce:PM 19-50SOURce:PULM 19-60Internal RoutingInstrument Model 2-5 - 2-14:INTerpolateCALCulate:LIMit 4-21Introduction 1-1 - 1-2:IQRatioSOURce:DM 19-27:ITEMHCOPy 10-7 - 10-12K:KBESselCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-27SENSe:WINDow:TYPE 18-78:KEYDISPlay:MENU 8-6SYSTem 21-29Index - 11


1997 SCPI Comm<strong>and</strong> Reference:KLOCkSYSTem 21-30L:LABelDISPlay:WINDow:GRAPhics 8-8DISPlay:WINDow:TRACe:R 8-15DISPlay:WINDow:TRACe:X 8-12DISPlay:WINDow:TRACe:Y 8-13HCOPy:ITEM 10-9:LADDress?VXI:CONFigure 26-6Lamina <strong>and</strong> Cloned ModelsInstrument Model:Internal Routing 2-7:LANGuageHCOPy:DEVice 10-6SYSTem 21-30:LAYerTRIGger Subsystem:ARM:SEQuence 24-14:LAYer NomenclatureTRIGger Subsystem:Exp<strong>and</strong>ed Capability Trigger Model 24-6:LDIRectionDISPlay:WINDow:GRAPhics 8-8:LEADingSOURce:PULSe:TRANsition 19-63:LEAKageSOURce:DM 19-27:LEFTDISPlay:WINDow:TRACe:X:SCALe 8-12:LENGthHCOPy:PAGE 10-14:LEVelOUTPut:TTLTrg|:ECLTrg 15-13SENSe:CONDition 18-11SENSe:CURRent:AC|:DC:PROTection 18-20SENSe:POWer:AC|:DC:PROTection 18-56SENSe:VOLTage:AC|:DC:PROTection 18-74SOURce:CURRent 19-18SOURce:CURRent:PROTection 19-22SOURce:POWer 19-53SOURce:POWer:PROTection 19-56SOURce:PULM:EXTernal 19-59SOURce:RESistance 19-66SOURce:RESistance:PROTection 19-68SOURce:VOLTage 19-83SOURce:VOLTage:PROTection 19-87TRIGger Subsystem:ARM:SEQuence:LAYer 24-16TRIGger Subsystem:TRIGger:SEQuence 24-28:LFRequencySYSTem 21-31:LIMitCALCulate 4-18 - 4-20INPut:POSition:X:ANGLe 11-8INPut:POSition:X:DISTance 11-9INPut:POSition:Y:ANGLe 11-10INPut:POSition:Y:DISTance 11-11INPut:POSition:Z:ANGLe 11-12INPut:POSition:Z:DISTance 11-13OUTPut:POSition:X:ANGLe 15-6OUTPut:POSition:X:DISTance 15-7OUTPut:POSition:Y:ANGLe 15-8OUTPut:POSition:Y:DISTance 15-9OUTPut:POSition:Z:ANGLe 15-10OUTPut:POSition:Z:DISTance 15-11SENSe:MIXer:BIAS 18-51SOURce:CURRent 19-20SOURce:POWer 19-55SOURce:RESistance 19-67SOURce:VOLTage 19-85:LINETRACe | DATA:DATA 23-3TRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo 24-20TRIGger Subsystem:TRIGger:SEQuence:VIDeo 24-32:LINKTRIGger Subsystem:ARM:SEQuence:LAYer 24-17TRIGger Subsystem:TRIGger:SEQuence 24-28:LINK CENTerDISPlay:WINDow:TRACe:X:SCALe:PDIV 8-13SENSe:FREQuency:SPAN 18-33SOURce:CURRent:SPAN 19-23SOURce:FREQuency:SPAN 19-36SOURce:POWer:SPAN 19-58SOURce:RESistance:SPAN 19-69SOURce:VOLTage:SPAN 19-88:LINK LEFTDISPlay:WINDow:TRACe:X:SCALe:PDIV 8-13:LINK RIGHtDISPlay:WINDow:TRACe:X:SCALe:PDIV 8-13:LINK STARtSENSe:FREQuency:SPAN 18-33SOURce:CURRent:SPAN 19-23SOURce:FREQuency:SPAN 19-36SOURce:POWer:SPAN 19-58SOURce:RESistance:SPAN 19-69SOURce:VOLTage:SPAN 19-88:LINK STOPSENSe:FREQuency:SPAN 18-33Index - 12


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:CURRent:SPAN 19-23SOURce:FREQuency:SPAN 19-36SOURce:POWer:SPAN 19-58SOURce:RESistance:SPAN 19-69SOURce:VOLTage:SPAN 19-88LIST SubsystemSENSe 18-49 - 18-50SOURce 19-39 - 19-44LLSee also IDELete:LLEFtDISPlay:WINDow:GEOMetry 8-7HCOPy:PAGE:DIMensions 10-14:LLIMitSENSe:SWEep:TIME 18-72SOURce:SWEep:TIME 19-73:LOADMMEMory 14-4:LOCateDISPlay:WINDow:TEXT 8-10:LOSSMEMory:TABLe 13-10SENSe:CORRection 18-15SENSe:MIXer 18-52SOURce:CORRection 19-12:LOWINPut 11-6INPut:POSition:X:ANGLe:LIMit 11-8INPut:POSition:X:DISTance:LIMit 11-9INPut:POSition:Y:ANGLe:LIMit 11-10INPut:POSition:Y:DISTance:LIMit 11-11INPut:POSition:Z:ANGLe:LIMit 11-12INPut:POSition:Z:DISTance:LIMit 11-13MEASure 3-12OUTPut Subsystem 15-5OUTPut:POSition:X:ANGLe:LIMit 15-6OUTPut:POSition:X:DISTance:LIMit 15-7OUTPut:POSition:Y:ANGLe:LIMit 15-8OUTPut:POSition:Y:DISTance:LIMit 15-9OUTPut:POSition:Z:ANGLe:LIMit 15-10OUTPut:POSition:Z:DISTance:LIMit 15-11SOURce:CURRent:LEVel:IMMediate 19-19SOURce:CURRent:LEVel:TRIGgered 19-20SOURce:CURRent:LIMit 19-21SOURce:POWer:LEVel:IMMediate 19-54SOURce:POWer:LEVel:TRIGgered 19-55SOURce:POWer:LIMit 19-56SOURce:RESistance:LEVel:IMMediate 19-66SOURce:RESistance:LEVel:TRIGgered 19-67SOURce:RESistance:LIMit 19-68SOURce:VOLTage:LEVel:IMMediate 19-84SOURce:VOLTage:LEVel:TRIGgered 19-85SOURce:VOLTage:LIMit 19-86:LOWerCALCulate:LIMit 4-20SENSe:AM:DEPTh:RANGe 18-3SENSe:CURRent:AC|:DC:RANGe 18-21SENSe:FM:DEViation:RANGe 18-29SENSe:FREQuency:RANGe 18-32SENSe:PM:DEViation:RANGe 18-53SENSe:POWer:AC|:DC:RANGe 18-57SENSe:POWer:ACHannel:SPACing 18-55SENSe:RESistance:RANGe 18-60SENSe:VOLTage:AC|:DC:RANGe 18-75:LPASsINPut:FILTer 11-5OUTPut:FILTer 15-4SENSe:FILTer 18-26TRIGger Subsystem:ARM:SEQuence:LAYer:FILTer 24-15TRIGger Subsystem:TRIGger:SEQuence:FILTer 24-26:LPFRameTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:FORMat 24-20TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd:FORMat 24-31:LTYPeDISPlay:WINDow:GRAPhics 8-8HCOPy:ITEM:WINDow:TRACe 10-13M:MACRoMMEMory:LOAD <strong>and</strong> :STORe 14-4:MACRo?MEMory:CATalog 13-4MEMory:FREE 13-7:MAGNitudeMEMory:TABLe:CONDition 13-8SENSe:CORRection:LOSS:INPut 18-16SENSe:CORRection:OFFSet 18-17SOURce:CORRection:LOSS:OUTPut 19-13SOURce:CORRection:OFFSet 19-12SOURce:DM:IQRatio 19-27SOURce:DM:LEAKage 19-27:MAGNitudeMEMory:TABLe:CURRent 13-9MEMory:TABLe:LOSS 13-10MEMory:TABLe:POWer 13-11MEMory:TABLe:RESistance 13-11MEMory:TABLe:VOLTage 13-12:MALLocatePROGram:EXPLicit 16-5Index - 13


1997 SCPI Comm<strong>and</strong> ReferencePROGram:SELected 16-3:MANualSENSe:FREQuency 18-31SOURce:CURRent 19-21SOURce:FREQuency 19-35SOURce:POWer 19-56SOURce:RESistance 19-69SOURce:VOLTage 19-86:MAPSTATus 20-4MARKer SubsystemSOURce 19-45 - 19-46:MATHCALCulate 4-21 - 4-22:MAXimumMEASure 3-14MEASureMeasurement Instructions 3-5Measurement FunctionInstrument Model 2-3Measurement Function Layer 3-9Measurement Instructions 3-1 - 3-14:MEDium COAXSENSe:CORRection:RVELocity 18-18SOURce:CORRection:RVELocity 19-14:MEDium WAVeguideSENSe:CORRection:RVELocity 18-18SOURce:CORRection:RVELocity 19-14MEMoryInstrument Model 2-5Memory Associated with Data FlowInstrument Model:Internal Routing 2-12MEMory Subsystem 13-1 - 13-12:MENUDISPlay 8-6HCOPy:ITEM 10-10:MESSageVXI:WSPRotocol 26-13:METHod PMETerSOURce:CORRection:COLLect 19-11:METHod TPORtSENSe:CORRection:COLLect 18-13:MGRulesTRIGger Subsystem:ARM:SEQuence:DEFine 24-13TRIGger Subsystem:TRIGger:SEQuence:DEFine 24-25:MINimumMEASure 3-14MIXer SubsystemSENSe 18-51 - 18-52MMEMory Subsystem 14-1 - 14-6:MODEHCOPy:DEVice 10-7SOURce:AM 19-6SOURce:FUNCtion 19-38SOURce:PULM 19-60:MODE AUTOSENSe:SWEep 18-68SOURce:SWEep 19-74:MODE CWSENSe:FREQuency 18-31SOURce:FREQuency 19-35:MODE DELTaSOURce:MARKer 19-45:MODE FIXedSENSe:FREQuency 18-31SOURce:CURRent 19-21SOURce:FREQuency 19-35SOURce:POWer 19-56SOURce:RESistance 19-70SOURce:VOLTage 19-86:MODE FREQuencySOURce:MARKer 19-45:MODE LISTSENSe:FREQuency 18-31SOURce:CURRent 19-21SOURce:FREQuency 19-35SOURce:POWer 19-56SOURce:RESistance 19-70SOURce:VOLTage 19-86:MODE LOCKedSOURce:FM 19-32SOURce:PM 19-48:MODE MANualSENSe:SWEep 18-68SOURce:SWEep 19-74:MODE POSitionSOURce:MARKer 19-45:MODE SENSeSOURce:FREQuency 19-35:MODE SOURceSENSe:FREQuency 18-31:MODE SWEepSENSe:FREQuency 18-31SOURce:CURRent 19-21SOURce:FREQuency 19-35SOURce:POWer 19-56SOURce:RESistance 19-70SOURce:VOLTage 19-86:MODE UNLockedSOURce:FM 19-32SOURce:PM 19-48Index - 14


1997 SCPI Comm<strong>and</strong> Reference:Model LayersTRIGger Subsystem 24-2 - 24-3:MODuleROUTe 17-3:MOVEDISPlay:WINDow:GRAPhics 8-9MMEMory 14-5MOVingCALCulate:AVERage:TCONtrol 4-7:MSISMMEMory 14-5:MULTiplierSENSe:FREQuency 18-32SOURce:FREQuency 19-35N:NAMECALCulate:MATH:EXPRession 4-22DISPlay:MENU 8-6MEMory:CLEar 13-4MEMory:COPY 13-5MEMory:DELete 13-6MEMory:EXCHange 13-6MMEMory 14-5PROGram:SELected 16-3ROUTe:MODule:DELete 17-4ROUTe:PATH:DELete 17-3TRACe | DATA:DELete 23-4TRIGger Subsystem:INITiate:CONTinuous 24-22TRIGger Subsystem:INITiate:IMMediate 24-23:NDUTycycleMEASure 3-14:No ErrorSYSTem:ERRor? 21-12NORMalCALCulate:AVERage:TCONtrol 4-7notationX n* 4-1:NPLCyclesSENSe:CURRent:AC|:DC 18-20SENSe:POWer:AC|:DC 18-55SENSe:RESistance 18-59SENSe:VOLTage:AC|:DC 18-74:NSELectINSTrument 12-3:NSTates?MEMory 13-7:NTRansitionSTATus 20-4:NUMBerPROGram:EXPLicit 16-5PROGram:SELected 16-3TRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:FIELd 24-19TRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:LINE 24-20TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd 24-31TRIGger Subsystem:TRIGger:SEQuence:VIDeo:LINE 24-32:NUMBer?VXI:CONFigure 26-7Numeric SuffixesInstrument Model:Internal Routing 2-7:NWIDthMEASure 3-14O:OCOMpensatedSENSe:RESistance 18-59:OCONdition ,TRACe | DATA:FEED 23-5OCTal 9-2 - 9-3:OEDGeDISPlay:WINDow:TRACe:R:SCALe 8-16:OFFSENSe:FUNCtion 18-37:OFFSetINPut 11-7:OFFSetINPut:POSition:X:ANGLe 11-8INPut:POSition:X:DISTance 11-9INPut:POSition:Y:ANGLe 11-10INPut:POSition:Y:DISTance 11-11INPut:POSition:Z:ANGLe 11-12INPut:POSition:Z:DISTance 11-13OUTPut:POSition:X:ANGLe 15-6OUTPut:POSition:X:DISTance 15-7OUTPut:POSition:Y:ANGLe 15-8OUTPut:POSition:Y:DISTance 15-9OUTPut:POSition:Z:ANGLe 15-10OUTPut:POSition:Z:DISTance 15-11SENSe:CORRection 18-17SENSe:CURRent:AC|:DC:RANGe 18-22SENSe:FREQuency 18-32SENSe:POWer:AC|:DC:RANGe 18-57SENSe:VOLTage:AC|:DC:RANGe 18-76SOURce:CORRection 19-12SOURce:CURRent:LEVel:IMMediate 19-19SOURce:CURRent:LEVel:TRIGgered 19-20SOURce:CURRent:LIMit 19-21SOURce:FREQuency 19-35Index - 15


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:POWer:LEVel:IMMediate 19-54SOURce:POWer:LEVel:TRIGgered 19-55SOURce:POWer:LIMit 19-55SOURce:RESistance:LEVel:IMMediate 19-66SOURce:RESistance:LEVel:TRIGgered 19-67SOURce:RESistance:LIMit 19-67SOURce:VOLTage:LEVel:IMMediate 19-84SOURce:VOLTage:LEVel:TRIGgered 19-85SOURce:VOLTage:LIMit 19-86:ONSENSe:FUNCtion 18-37ONCECALCulate 4-7, 4-12, 4-14, 4-21, 4-26, 4-28, 4-31CALibration 5-2DISPlay 8-11 - 8-12, 8-14 - 8-15INPut:ATTenuation 11-3INPut:GAIN 11-6OUTPut:FILTer 15-3SENSe 18-3, 18-6, 18-9 - 18-10, 18-21 - 18-22,18-25, 18-29, 18-31 - 18-33, 18-50 - 18-51,18-53, 18-57 - 18-58, 18-60 - 18-61, 18-63,18-68, 18-71, 18-75 - 18-76SENSe:ROSCillator:SOURce INTernal 19-71SOURce 19-17 - 19-19, 19-22, 19-34, 19-36,19-41, 19-43, 19-52 - 19-53, 19-57, 19-64,19-70, 19-73 - 19-74, 19-82 - 19-84, 19-87SYSTem 21-31TRACe | DATA 23-5TRIGger Subsystem:ARM:SEQuence:LAYer:DELay 24-14TRIGger Subsystem:ARM:SEQuence:LAYer:LEVel 24-16TRIGger Subsystem:TRIGger:SEQuence:DELay 24-26TRIGger Subsystem:TRIGger:SEQuence:LEVel 24-28:OPENMMEMory 14-6ROUTe 17-2Operation Complete EventSYSTem:ERRor? 21-26:ORDinateCALCulate:TRANsform:HISTogram 4-24:ORIentationHCOPy:PAGE 10-14Other SubsystemsInstrument Model:Internal Routing 2-9OUTPutInstrument Model:Signal Generation 2-4SENSe:CORRection:IMPedance 18-15SENSe:CORRection:LOSS 18-16SOURce:CORRection:LOSS 19-13OUTPut Subsystem 15-1 - 15-14:OVERshootMEASure:FALL 3-13MEASure:RISE 3-12P:PACE ACKSYSTem:COMM:SERial:RECeive 21-7SYSTem:COMM:SERial:TRANsmit 21-9:PACE NONESYSTem:COMM:SERial:RECeive 21-7SYSTem:COMM:SERial:TRANsmit 21-9:PACE XONSYSTem:COMM:SERial:RECeive 21-7SYSTem:COMM:SERial:TRANsmit 21-9:PACKMMEMory 14-6PACKed 9-2:PAGEDISPlay:WINDow:TEXT 8-10HCOPy 10-13 - 10-14:PARitySYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:PATHCALCulate 4-31 - 4-32ROUTe 17-3:PCLDISPlay:WINDow:GRAPhics 8-8:PDFunctionSENSe:FUNCtion:VOLTage 18-48:PDIVisionDISPlay:WINDow:TRACe:X:SCALe 8-13DISPlay:WINDow:TRACe:Y:SCALe 8-14:PDUTycycle:MEASure 3-14:PERiod:MEASure 3-10SENSe:FUNCtion 18-45SOURce:PULSe 19-62:PERSistenceDISPlay:WINDow:TRACe 8-11:PHASe:MEASure 3-10MEMory Subsystem:TABLe:CURRent 13-9MEMory Subsystem:TABLe:LOSS 13-11MEMory Subsystem:TABLe:VOLTage 13-12SENSe:CORRection:LOSS:INPut|:OUTPut 18-16SENSe:CORRection:OFFSet 18-17SENSe:FUNCtion 18-45SOURce:CORRection:LOSS:OUTPut 19-13Index - 16


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:CORRection:OFFSet 19-12PHASe SubsystemSOURce 19-47PMSENSe:FUNCtion 18-45PM SubsystemSENSe 18-53SOURce 19-48 - 19-50:POFLagTRIGger Subsystem:INITiate 24-23:POINtSOURce:MARKer 19-45:POINtsCALCulate 4-10CALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:SMOothing 4-23CALCulate:TRANsform:DISTance 4-28CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:HISTogram 4-24CALCulate:TRANsform:TIME 4-26SENSe:SMOothing 18-64SENSe:SWEep 18-69SOURce:SWEep 19-75TRACe | DATA 23-5 - 23-6:POINts?CALCulate:CLIMits:FLIMits 4-9CALCulate:LIMit:CONTrol 4-19CALCulate:LIMit:LOWer 4-20CALCulate:LIMit:REPort 4-21CALCulate:LIMit:UPPer 4-20MEMory:TABLe:CONDition:MAGNitude 13-9MEMory:TABLe:CURRent:MAGNitude 13-9MEMory:TABLe:CURRent:PHASe 13-9MEMory:TABLe:FREQuency 13-10MEMory:TABLe:LOSS:MAGNitude 13-10MEMory:TABLe:LOSS:PHASe 13-11MEMory:TABLe:POWer:MAGNitude 13-11MEMory:TABLe:RESistance:MAGNitude 13-12MEMory:TABLe:VOLTage:MAGNitude 13-12MEMory:TABLe:VOLTage:PHASe 13-12SENSe:LIST:DWELl 18-49SENSe:LIST:FREQuency 18-50SENSe:LIST:SEQuence 18-50SOURce:LIST:APRobe 19-40SOURce:LIST:CONCurrent 19-41SOURce:LIST:CONTrol:APOWer 19-41SOURce:LIST:CONTrol:BLOWer 19-41SOURce:LIST:CONTrol:COMPressor 19-41SOURce:LIST:CURRent 19-41SOURce:LIST:DEPTh:AM 19-40SOURce:LIST:DWELl 19-42SOURce:LIST:FREQuency 19-42SOURce:LIST:POWer 19-43SOURce:LIST:PULM:STATe 19-42SOURce:LIST:RESistance 19-43SOURce:LIST:RTIMe 19-43SOURce:LIST:SEQuence 19-43SOURce:LIST:TEMPerature 19-43SOURce:LIST:VOLTage 19-44:POLarityINPut 11-7OUTPut Subsystem 15-5:POLarity :ALL NORMalSOURce:DM 19-29:POLarity COMPlementSOURce:PULSe 19-64:POLarity INVertedOUTPut:TTLTrg|:ECLTrg 15-13SOURce:AM 19-7SOURce:AM:EXTernal 19-6SOURce:DM 19-29SOURce:FM 19-33SOURce:FM:EXTernal 19-32SOURce:PM 19-49SOURce:PM:EXTernal 19-50SOURce:PULM 19-60SOURce:PULM:EXTernal 19-60SOURce:PULSe 19-64:POLarity NEGativeTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:SSIGnal 24-21TRIGger Subsystem:TRIGger:SEQuence:VIDeo:SSIGnal 24-32:POLarity NORMalOUTPut:TTLTrg|:ECLTrg 15-13SOURce:AM 19-7SOURce:AM:EXTernal 19-6SOURce:FM 19-33SOURce:FM:EXTernal 19-32SOURce:PM 19-49SOURce:PM:EXTernal 19-50SOURce:PULM:EXTernal 19-60SOURce:PULSe 19-64SOURce:PULse Modulation 19-60:POLarity POSitiveTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:SSIGnal 24-21TRIGger Subsystem:TRIGger:SEQuence:VIDeo:SSIGnal 24-32:POLarizationINPut 11-7OUTPut Subsystem 15-5Index - 17


1997 SCPI Comm<strong>and</strong> Reference:POSitionOUTPut Subsystem 15-5:POSitionINPut 11-7 - 11-13:POWer:MEASure 3-8MEMory:TABLe 13-11SENSe:FUNCtion 18-45SOURce:LIST 19-43UNIT 25-1Power On EventSYSTem:ERRor? 21-24POWer SubsystemSENSe 18-54 - 18-58SOURce 19-51 - 19-58:PREFerenceCALCulate:FORMat:UPHase 4-17Presentation LayerMeasurement Instructions 3-7:SENSe:FUNCtion 18-40:PRESetSTATus 20-4SYSTem 21-32:PREShootMEASure:FALL 3-13MEASure:RISE 3-12:PRF:MEASure:FREQuency 3-10PROGram Subsystem 16-1 - 16-6:PROTectionOUTPut Subsystem 15-12SENSe:CURRent:AC|:DC 18-20SENSe:POWer:AC|:DC 18-56SENSe:VOLTage:AC|:DC 18-74SOURce:CURRent 19-22SOURce:POWer 19-56SOURce:RESistance 19-68SOURce:VOLTage 19-87:PROTocolTRIGger Subsystem:ARM:SEQuence:LAYer 24-17TRIGger Subsystem:TRIGger:SEQuence 24-28:PROTocol ASYNchronousOUTPut:TTLTrg|:ECLTrg 15-13:PROTocol SSYNchronousOUTPut:TTLTrg|:ECLTrg 15-13:PROTocol SYNChronousOUTPut:TTLTrg|:ECLTrg 15-13:PSDensitySENSe:FUNCtion:POWer 18-46:PTPeakMEASure 3-14SENSe:CURRent:AC|:DC:RANGe 18-22SENSe:POWer:AC|:DC:RANGe 18-57SENSe:VOLTage:AC|:DC:RANGe 18-76:PTRansitionSTATus 20-3:PULMSOURce:LIST 19-42PULse Modulation SubsystemSOURce 19-59 - 19-61PULSe SubsystemSOURce 19-62 - 19-64:PWIDthMEASure 3-13Q:Q INVertedSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:Q NRMalSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:QCLock INVertedSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:QCLock NORMalSOURce:DM:POLarity:ALL NORMal|INVerted 19-29:QCORrectionSOURce:DM:FILTer 19-26:QUADrantHCOPy:PAGE:DIMensions 10-14:QUADratureSOURce:DM 19-27:QUERyVXI:WSPRotocol 26-14:Query ErrorSYSTem:ERRor? 21-24Querying the Data FlowInstrument Model:Internal Routing 2-14R:RDISPlay:WINDow:TRACe 8-15:RANGeCALCulate:TRANsform:HISTogram 4-24SENSe:AM:DEPTh 18-3SENSe:CURRent:AC|:DC 18-21SENSe:FM:DEViation 18-29Index - 18


1997 SCPI Comm<strong>and</strong> ReferenceSENSe:FREQuency 18-32SENSe:PM:DEViation 18-53SENSe:POWer:AC|:DC 18-56SENSe:RESistance 18-60SENSe:VOLTage:AC|:DC 18-75SOURce:CURRent 19-22SOURce:POWer 19-57SOURce:RESistance 19-70SOURce:VOLTage 19-87:RATioSENSe:BANDwidth|BWIDth:RESolution 18-9SENSe:BANDwidth|BWIDth:VIDeo 18-10:RDEViceSYSTem:COMMunicate:GPIB 21-4VXI:WSPRotocol:COMM<strong>and</strong> 26-11:RDEVice?VXI:WSPRotocol:QUERy 26-15READMeasurement Instructions 3-4:READ?VXI:REGister 26-7REAL 9-2:REALtimeSENSe:SWEep 18-70:RECeiveSYSTem:COMM:SERial 21-7:RECeive?VXI:WSPRotocol:MESSage 26-13:REFerenceSENSe:CURRent:AC|:DC 18-22SENSe:POWer:AC|:DC 18-58SENSe:RESistance 18-61SENSe:VOLTage:AC|:DC 18-76SOURce:CURRent 19-22SOURce:MARKer 19-46SOURce:PHASe 19-47SOURce:POWer 19-57SOURce:RESistance 19-70SOURce:VOLTage 19-87:REGisterVXI 26-7REPeatCALCulate:AVERage:TCONtrol 4-7:REPortCALCulate:LIMit 4-20Request Control EventSYSTem:ERRor? 21-25:RequirementsIntroduction 1-1:RESet?VXI 26-8:RESistance:MEASure 3-8MEMory:TABLe 13-11SENSe:FUNCtion 18-47SOURce:LIST 19-43RESistance SubsystemSENSe 18-59 - 18-61SOURce 19-65 - 19-70:RESolutionHCOPy:DEVice 10-7SENSe:BANDwidth|BWIDth 18-9SENSe:CURRent:AC|:DC 18-22SENSe:FREQuency 18-33SENSe:POWer:AC|:DC 18-58SENSe:RESistance 18-61SENSe:VOLTage:AC|:DC 18-76SOURce:FREQuency 19-36:RESPonse?VXI:WSPRotocol 26-17:RGBDISPlay:CMAP:COLor 8-5HCOPy:DEVice:CMAP:COLor 10-5:RHANdlersVXI:WSPRotocol:COMM<strong>and</strong> 26-11:RHANdlers?VXI:WSPRotocol:QUERy 26-15:RHLineVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RHLine?VXI:WSPRotocol:QUERy 26-15:RIGHtDISPlay:WINDow:TRACe:X:SCALe 8-13:RILineVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RILine?VXI:WSPRotocol:QUERy 26-16:RINTerrupterVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RINTerrupter?VXI:WSPRotocol:QUERy 26-16:RISEMEASure 3-12:RLEVelDISPlay:WINDow:TRACe:Y:SCALe 8-14:RLINeDISPlay:WINDow:TRACe:Y 8-13:RMODidVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RMODid?VXI:WSPRotocol:QUERy 26-16:ROSCillatorOUTPut Subsystem 15-12Index - 19


1997 SCPI Comm<strong>and</strong> ReferenceROSCillator SubsystemSENSe 18-62 - 18-63SOURce 19-71 - 19-72ROUTe Subsystem 17-1 - 17-4:RPERrorVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RPERror?VXI:WSPRotocol:QUERy 26-16:RPOSitionDISPlay:WINDow:TRACe:Y:SCALe 8-15:RPRotocolVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RPRotocol?VXI:WSPRotocol:QUERy 26-16:RSAReaVXI:WSPRotocol:COMM<strong>and</strong> 26-13:RSARea?VXI:WSPRotocol:QUERy 26-16:RSTBVXI:WSPRotocol:COMM<strong>and</strong> 26-12:RSTB?VXI:WSPRotocol:QUERy 26-16:RTIMeMEASure 3-12SOURce:LIST 19-43:RTS IBFullSYSTem:COMM:SERial:CONTrol 21-6:RTS OFFSYSTem:COMM:SERial:CONTrol 21-6:RTS ONSYSTem:COMM:SERial:CONTrol 21-6:RTS RFRSYSTem:COMM:SERial:CONTrol 21-6:RTS STANdardSYSTem:COMM:SERial:CONTrol 21-6:RVELocitySENSe:CORRection 18-17SOURce:CORRection 19-14S:S11SENSe:FUNCtion:POWer 18-46:S12SENSe:FUNCtion:POWer 18-46:S21SENSe:FUNCtion:POWer 18-46:S22SENSe:FUNCtion:POWer 18-46:SAVESENSe:CORRection:COLLect 18-13SOURce:CORRection:COLLect 19-11SBSee SENSe:FUNCtion:SBITsSYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:SCALarMEASure 3-7:SCALeDISPlay:WINDow:TRACe:R 8-15DISPlay:WINDow:TRACe:X 8-12DISPlay:WINDow:TRACe:Y 8-13HCOPy:PAGE 10-14:SCANROUTe 17-2:SDUMpHCOPy 10-15 - 10-16:SEARchSOURce:CURRent:ALC 19-17SOURce:POWer:ALC 19-52SOURce:VOLTage:ALC 19-82:SECuritySYSTem 21-32:SELectINSTrument 12-3MEMory:TABLe 13-12SENSe:CORRection:CSET 18-14SOURce:CORRection:CSET 19-11TRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:LINE 24-20TRIGger Subsystem:TRIGger:SEQuence:VIDeo:LINE 24-32VXI 26-9:SELect ALLTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:FIELd 24-19TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd 24-31:SELect EVENTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:FIELd 24-19TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd 24-31:SELect NUMBerTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:FIELd 24-19TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd 24-31:SELect ODDTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo:FIELd 24-19TRIGger Subsystem:TRIGger:SEQuence:VIDeo:FIELd 24-31Index - 20


1997 SCPI Comm<strong>and</strong> Reference:SELectedCALCulate:MATH:EXPRession:DELete 4-22PROGram 16-2 - 16-3PROGram:SELected:DELete 16-2:SELFSYSTem:COMMunicate:GPIB 21-5:SENDVXI:WSPRotocol:MESSage 26-13SENSeInstrument Model:Measurement Function 2-4SENSe:DATA? 18-35SENSe Subsystem 18-1 - 18-78:SENSitivitySOURce:AM 19-7SOURce:FM 19-33SOURce:PM 19-48Sensor Function SelectionInstrument Model:Internal Routing 2-9:SENSe:FUNCtion 18-38:SEQuenceSENSe:LIST 18-50SOURce:LIST 19-43TRIGger Subsystem:ARM 24-12TRIGger Subsystem:INITiate:CONTinuous 24-22TRIGger Subsystem:INITiate:IMMediate 24-23TRIGger Subsystem:TRIGger 24-23:Sequence Event UseTRIGger Subsystem 24-4:SERialSYSTem:COMMunicate 21-5:SETSYSTem 21-33:SHAPeSOURce:FUNCtion 19-38:SHAPe LINearSENSe:DETector 18-25:SHAPe LOGarithmicSENSe:DETector 18-25:SIGNalTRIGger Subsystem:ARM:SEQuence:LAYer 24-17TRIGger Subsystem:TRIGger:SEQuence 24-29Signal GenerationInstrument Model 2-4Signal RoutingInstrument Model 2-2Simple MeasurementsMeasurement Function Layer 3-9:SIZEDISPlay:WINDow:GEOMetry 8-7HCOPy:PAGE 10-15:SLEWSOURce:CURRent 19-23SOURce:POWer 19-57SOURce:RESistance 19-68SOURce:VOLTage 19-88:SLModidVXI:WSPRotocol:COMM<strong>and</strong> 26-13:SLModid?VXI:WSPRotocol:QUERy 26-17:SLOCkVXI:WSPRotocol:COMM<strong>and</strong> 26-13:SLOPeSENSe:CORRection 18-15SOURce:CORRection 19-12:SLOPe EITHerTRIGger Subsystem:ARM:SEQuence:LAYer 24-18TRIGger Subsystem:TRIGger:SEQuence 24-29:SLOPe NEGativeTRIGger Subsystem:ARM:SEQuence:LAYer 24-18TRIGger Subsystem:TRIGger:SEQuence 24-29:SLOPe POSitiveTRIGger Subsystem:ARM:SEQuence:LAYer 24-18TRIGger Subsystem:TRIGger:SEQuence 24-29:SMOothingCALCulate 4-23SMOothing SubsystemSENSe 18-64:SNDRatioSENSe:FUNCtion & DATA:FUNCtion:POWer 18-43 - 18-45, 18-47SOURceCALibration 5-2Instrument Model:Signal Generation 2-5OUTPut:TTLTrg|:ECLTrg 15-13TRIGger Subsystem:ARM:SEQuence:LAYer 24-18TRIGger Subsystem:TRIGger:SEQuence 24-29:SOURce ,INTernalSOURce:FM 19-33SOURce:PM 19-49SOURce:PULM 19-61:SOURce CALibrateSOURce:DM 19-26:SOURce CLK10SENSe:ROSCillator 18-62, 19-71:SOURce CLK100SENSe:ROSCillator 18-62, 19-71:SOURce DIODeSOURce:CURRent:ALC 19-18Index - 21


1997 SCPI Comm<strong>and</strong> ReferenceSOURce:POWer:ALC 19-53SOURce:VOLTage:ALC 19-83:SOURce EXTernalSENSe:ROSCillator 18-62, 19-71SOURce:AM 19-7SOURce:DM 19-26SOURce:DM:CLOCk 19-30SOURce:DM:FILTer 19-26SOURce:DM:FRAMe 19-29SOURce:FM 19-33SOURce:PHASe 19-47SOURce:PM 19-49SOURce:PULM 19-61:SOURce INTernalSENSe:ROSCillator 18-62, 19-71SOURce:AM 19-7SOURce:CURRent:ALC 19-18SOURce:DM:CLOCk 19-30SOURce:DM:FILTer 19-26SOURce:DM:FRAMe 19-29SOURce:PHASe 19-47SOURce:POWer:ALC 19-53SOURce:VOLTage:ALC 19-83:SOURce INTernal,EXTernalSOURce:FM 19-33SOURce:PM 19-49SOURce:PULM 19-61:SOURce MMHeadSOURce:CURRent:ALC 19-18SOURce:POWer:ALC 19-53SOURce:VOLTage:ALC 19-83:SOURce NONESENSe:ROSCillator 18-62, 19-71SOURce:DM:CLOCk 19-30:SOURce PMETerSOURce:CURRent:ALC 19-18SOURce:POWer:ALC 19-53SOURce:VOLTage:ALC 19-83:SOURce PRBSSOURce:DM 19-26SOURce Subsystem 19-1 - 19-90:SPACingSENSe:POWer:ACHannel 18-54:SPACing LINearDISPlay:WINDow:TRACe:R 8-16DISPlay:WINDow:TRACe:Y 8-15SENSe:SWEep 18-70SOURce:SWEep 19-74:SPACing LOGarithmicDISPlay:WINDow:TRACe:R 8-16DISPlay:WINDow:TRACe:Y 8-15SENSe:SWEep 18-70SOURce:SWEep 19-74:SPANCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:GDAPerture 4-17CALCulate:TRANsform:DISTance 4-28CALCulate:TRANsform:FREQuency 4-30CALCulate:TRANsform:TIME 4-26SENSe:FREQuency 18-33SOURce:CURRent 19-23SOURce:FREQuency 19-36SOURce:POWer 19-58SOURce:RESistance 19-68SOURce:VOLTage 19-88:SPEedHCOPy:DEVice 10-7:SREGisterFORMat 9-3 - 9-4SSB SubsystemSENSe 18-65:SSIGnalTRIGger Subsystem:ARM:SEQuence:LAYer:VIDeo 24-20TRIGger Subsystem:TRIGger:SEQuence:VIDeo 24-32:St<strong>and</strong>ard SEQuencesTRIGger Subsystem:Exp<strong>and</strong>ed Capability Trigger Model 24-7:STARtCALCulate:FILTer:GATE:FREQuency 4-13CALCulate:FILTer:GATE:TIME 4-11CALCulate:TRANsform:DISTance 4-28CALCulate:TRANsform:FREQuency 4-30CALCulate:TRANsform:TIME 4-25SENSe:FREQuency 18-34SOURce:CURRent 19-23SOURce:FREQuency 19-37SOURce:POWer 19-58SOURce:RESistance 19-69SOURce:VOLTage 19-88SYSTem:COMM:SERial:RECeive 21-7:STATeCALCulate 4-7, 4-10 - 4-11, 4-18 - 4-20, 4-23,4-25, 4-27, 4-29CALibration 5-2CONTrol 6-1DISPlay 8-6, 8-9 - 8-11HCOPy 10-8 - 10-13INPut 11-14INPut:ATTenuation 11-3INPut:BIAS 11-4INPut:FILTer:AWEighting 11-5Index - 22


1997 SCPI Comm<strong>and</strong> ReferenceINPut:FILTer:HPASs 11-5INPut:FILTer:LPASs 11-5INPut:GAIN 11-6INPut:OFFSet 11-7INPut:POSition:X:ANGLe:LIMit 11-8INPut:POSition:X:DISTance:LIMit 11-9INPut:POSition:Y:ANGLe:LIMit 11-10INPut:POSition:Y:DISTance:LIMit 11-11INPut:POSition:Z:ANGLe:LIMit 11-12INPut:POSition:Z:DISTance:LIMit 11-13INSTrument 12-3MEMory 13-7MMEMory 14-4OUTPut Subsystem 15-14OUTPut:FILTer:EXTernal 15-4OUTPut:FILTer:HPASs 15-4OUTPut:FILTer:LPASs 15-4OUTPut:POSition:X:ANGLe:LIMit 15-6OUTPut:POSition:X:DISTance:LIMit 15-7OUTPut:POSition:Y:ANGLe:LIMit 15-8OUTPut:POSition:Y:DISTance:LIMit 15-9OUTPut:POSition:Z:ANGLe:LIMit 15-10OUTPut:POSition:Z:DISTance:LIMit 15-11OUTPut:PROTection 15-12OUTPut:ROSCillator 15-12OUTPut:TTLTrg|:ECLTrg 15-13PROGram 16-3, 16-5SENSe 18-6, 18-14 - 18-15, 18-17 - 18-18,18-20, 18-22, 18-26 - 18-28, 18-56, 18-58,18-61, 18-64, 18-70, 18-74, 18-76SOURce 19-7, 19-10 - 19-14, 19-17,19-21 - 19-23, 19-26 - 19-28, 19-33, 19-42,19-46, 19-49, 19-52, 19-56 - 19-57, 19-61,19-63, 19-68, 19-70, 19-82, 19-86 - 19-88CALCulate 4-13SYSTem 21-3, 21-33TRIGger Subsystem:ARM:SEQuence:LAYer:FILTer:HPASs 24-15TRIGger Subsystem:ARM:SEQuence:LAYer:FILTer:LPASs 24-15TRIGger Subsystem:TRIGger:SEQuence:ATRigger 24-24TRIGger Subsystem:TRIGger:SEQuence:FILTer:HPASs 24-26TRIGger Subsystem:TRIGger:SEQuence:FILTer:LPASs 24-27:STATe?MEMory 13-4, 13-7ROUTe 17-2SENSe 18-38STATus Subsystem 20-1 - 20-6:STEPSENSe:SWEep 18-71SOURce:PHASe:ADJust 19-47SOURce:SWEep 19-75:STIMulus IMPulseCALCulate:TRANsform:DISTance 4-27CALCulate:TRANsform:FREQuency 4-30CALCulate:TRANsform:TIME 4-25:STIMulus STEPCALCulate:TRANsform:DISTance 4-27CALCulate:TRANsform:FREQuency 4-30CALCulate:TRANsform:TIME 4-25:STOPCALCulate:FILTer:GATE:FREQuency 4-13CALCulate:FILTer:GATE:TIME 4-11CALCulate:TRANsform:DISTance 4-28CALCulate:TRANsform:FREQuency 4-30CALCulate:TRANsform:TIME 4-26SENSe:FREQuency 18-34SOURce:CURRent 19-24SOURce:FREQuency 19-37SOURce:POWer 19-58SOURce:RESistance 19-69SOURce:VOLTage 19-89SYSTem:COMM:SERial:RECeive 21-8:STOReMMEMory 14-4:STRingPROGram:EXPLicit 16-6PROGram:SELected 16-4:Subservient SequencesTRIGger Subsystem:Exp<strong>and</strong>ed Capability Trigger Model 24-7:SUModidVXI:WSPRotocol:COMM<strong>and</strong> 26-13:SUModid?VXI:WSPRotocol:QUERy 26-17SWEep SubsystemSENSe 18-66 - 18-72SOURce:SYNTax?SYSTem:HELP 21-28SYSTem Subsystem 21-1 - 21-35T:TABLeMEMory 13-8MEMory:CLEar 13-4MEMory:COPY 13-5MEMory:EXCHange 13-6Index - 23


1997 SCPI Comm<strong>and</strong> Reference:TABLe?MEMory:CATalog 13-4MEMory:FREE 13-7:TCONstantSENSe:FILTer:DEMPhasis 18-27:TCONtrol EXPonentialCALCulate:AVERage 4-7SENSe:AVERage 18-6:TCONtrol MOVingCALCulate:AVERage 4-7SENSe:AVERage 18-6:TCONtrol NORMalCALCulate:AVERage 4-7SENSe:AVERage 18-6:TCONtrol REPeatCALCulate:AVERage 4-7SENSe:AVERage 18-6:TDSTampHCOPy:ITEM 10-11:TEMPeratureSOURce 19-76 - 19-80SOURce:LIST 19-43UNIT 25-2:TERMinalsROUTe 17-4TEST Subsystem 22-1 - 22-2:TEXTDISPlay:WINDow 8-9HCOPy:ITEM:LABel 10-10HCOPy:ITEM:WINDow 10-11:THDSENSe:FUNCtion:POWer 18-43 - 18-45, 18-47:THResholdSOURce:DM 19-28SYSTem:COMM:SERial:RECeive 21-7:TIMeCALCulate:FILTer:GATE 4-11CALCulate:TRANsform 4-25MEASure:FALL 3-13MEASure:RISE 3-12SENSe:CORRection:EDELay 18-15SENSe:SWEep 18-71SOURce:CORRection:EDELay 19-13SOURce:SWEep 19-73SYSTem 21-34SYSTem:BEEPer 21-4UNIT 25-2Time Domain Waveform Measurements 3-10:TIMerTRIGger Subsystem:ARM:SEQuence:LAYer 24-19TRIGger Subsystem:TRIGger:SEQuence 24-30TINTervalSENSe:FUNCtion 18-47:TMAXimumMEASure 3-14:TMINimumMEASure 3-14:TOPDISPlay:WINDow:TRACe:Y:SCALe 8-15TOTalizeSENSe:FUNCtion 18-47:TRACe 23-1 - 23-6DISPlay:WINDow 8-10HCOPy:ITEM:WINDow 10-12MMEMory:LOAD <strong>and</strong> :STORe 14-5MMEMory:LOAD <strong>and</strong> :STORe:DINTerchange 14-4:TRACkSENSe:BANDwidth|BWIDth:RESolution 18-9:TRAilingSOURce:PULSe:TRANsition 19-64:TRANsformCALCulate 4-23 - 4-30:TRANsitionSOURce:PULSe 19-63:TRANsmitSYSTem:COMM:SERial 21-8TRIGger 2-5Instrument Model 2-5TRIGger Subsystem 24-23 - 24-32VXI:WSPRotocol:COMM<strong>and</strong> 26-13TRIGger Subsystem 24-1 - 24-32:TRIGgeredSOURce:CURRent:LEVel 19-20SOURce:POWer:LEVel 19-54SOURce:RESistance:LEVel 19-66SOURce:VOLTage:LEVel 19-85:TRIPped?OUTPut:PROTection 15-12SENSe:CURRent:AC|:DC:PROTection 18-20SENSe:POWer:AC|:DC:PROTection 18-56SENSe:VOLTage:AC|:DC:PROTection 18-74SOURce:CURRent:PROTection 19-22SOURce:POWer:PROTection 19-57SOURce:RESistance:PROTection 19-68SOURce:VOLTage:PROTection 19-87:TTLTRIGger Subsystem:ARM:SEQuence:LAYer 24-19TRIGger Subsystem:TRIGger:SEQuence 24-30:TTLTrgOUTPut Subsystem 15-12Index - 24


1997 SCPI Comm<strong>and</strong> Reference:TYPECALCulate 4-18INPut 11-14OUTPut Subsystem 15-14SENSe:AM 18-3SOURce:AM 19-8:TYPE BESSelOUTPut:FILTer:HPASs 15-4OUTPut:FILTer:LPASs 15-4:TYPE BPASsCALCulate:FILTer:GATE:FREQuency 4-13CALCulate:FILTer:GATE:TIME 4-11CALCulate:TRANsform:DISTance 4-27CALCulate:TRANsform:FREQuency 4-29CALCulate:TRANsform:TIME 4-25:TYPE CHEByshevOUTPut:FILTer:HPASs 15-4OUTPut:FILTer:LPASs 15-4:TYPE COMPlexCALCulate:AVERage 4-8SENSe:AVERage 18-7:TYPE CURRentINPut:BIAS 11-4:TYPE EDGETRIGger Subsystem:ARM:SEQuence:LAYer 24-19TRIGger Subsystem:TRIGger:SEQuence 24-31:TYPE ENVelopeCALCulate:AVERage 4-8SENSe:AVERage 18-7:TYPE EVENSYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:TYPE FLATtopSENSe:WINDow 18-78:TYPE HAMMingSENSe:WINDow 18-78:TYPE HANNingSENSe:WINDow 18-78:TYPE IGNoreSYSTem:COMM:SERial:RECeive 21-8:TYPE LPASsCALCulate:TRANsform:DISTance 4-27CALCulate:TRANsform:FREQuency 4-29CALCulate:TRANsform:TIME 4-25:TYPE MAXimumCALCulate:AVERage 4-8SENSe:AVERage 18-7:TYPE MINimumCALCulate:AVERage 4-8SENSe:AVERage 18-7:TYPE NONESYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:TYPE NOTChCALCulate:FILTer:GATE:FREQuency 4-13CALCulate:FILTer:GATE:TIME 4-11:TYPE ODDSYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:TYPE ONESYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:TYPE RECTangularSENSe:WINDow 18-78:TYPE RMSCALCulate:AVERage 4-8SENSe:AVERage 18-7:TYPE SCALarCALCulate:AVERage 4-8SENSe:AVERage 18-7:TYPE UNIFormSENSe:WINDow 18-78:TYPE VIDeoTRIGger Subsystem:ARM:SEQuence:LAYer 24-19TRIGger Subsystem:TRIGger:SEQuence 24-31:TYPE VOLTageINPut:BIAS 11-4:TYPE ZEROSYSTem:COMM:SERial:RECeive 21-8SYSTem:COMM:SERial:TRANsmit 21-9:TYPE?MEMory 13-8:TZONeSYSTem 21-34UUINTeger 9-2:UNITHCOPy:DEVice:RESolution 10-7HCOPy:DEVice:SPEed 10-7HCOPy:PAGE 10-15UNIT Subsystem 25-1 - 25-2:UPHaseCALCulate:FORMat 4-16:UPPerCALCulate:LIMit 4-19SENSe:AM:DEPTh:RANGe 18-3SENSe:CURRent:AC|:DC:RANGe 18-21SENSe:FM:DEViation:RANGe 18-29SENSe:FREQuency:RANGe 18-32Index - 25


1997 SCPI Comm<strong>and</strong> ReferenceSENSe:PM:DEViation:RANGe 18-53SENSe:POWer:AC|:DC:RANGe 18-56SENSe:POWer:ACHannel:SPACing 18-55SENSe:RESistance:RANGe 18-60SENSe:VOLTage:AC|:DC:RANGe 18-75:URIGhtDISPlay:WINDow:GEOMetry 8-7HCOPy:PAGE:DIMensions 10-14User Request EventSYSTem:ERRor? 21-25V:VALueCALibration 5-2TRACe | DATA:DATA 23-3:VELocityINPut:POSition:X:ANGLe 11-9INPut:POSition:X:DISTance 11-10INPut:POSition:Y:ANGLe 11-11INPut:POSition:Y:DISTance 11-12INPut:POSition:Z:ANGLe 11-13INPut:POSition:Z:DISTance 11-14OUTPut:POSition:X:ANGLe 15-6OUTPut:POSition:X:DISTance 15-7OUTPut:POSition:Y:ANGLe 15-8OUTPut:POSition:Y:DISTance 15-9OUTPut:POSition:Z:ANGLe 15-10OUTPut:POSition:Z:DISTance 15-11:VERBose?VXI:CONFigure:HIERarchy? 26-4VXI:CONFigure:INFormation? 26-6VXI:REGister:READ? 26-8VXI:RESet? 26-9:VERSion?SYSTem 21-35:VERTicalINPut:POLarization 11-7OUTPut:POLarization 15-5:VIDeoSENSe:BANDwidth|BWIDth 18-9TRIGger Subsystem:ARM:SEQuence:LAYer 24-19TRIGger Subsystem:TRIGger:SEQuence 24-31:VOLTage:MEASure 3-8INPut:BIAS 11-4MEMory:TABLe 13-12SENSe:FUNCtion 18-47SOURce:LIST 19-44UNIT 25-1VOLTage SubsystemSENSe 18-73 - 18-77SOURce 19-81 - 19-90:VOLumeSYSTem:BEEPer 21-4:VXI ASYNchronousTRIGger Subsystem:ARM:SEQuence:LAYer:PROTocol 24-17TRIGger Subsystem:TRIGger:SEQuence:PROTocol 24-29:VXI SSYNchronousTRIGger Subsystem:ARM:SEQuence:LAYer:PROTocol 24-17TRIGger Subsystem:TRIGger:SEQuence:PROTocol 24-29VXI Subsystem 26-1 - 26-18:VXI SYNChronousTRIGger Subsystem:ARM:SEQuence:LAYer:PROTocol 24-17TRIGger Subsystem:TRIGger:SEQuence:PROTocol 24-29W:WAITPROGram:EXPLicit 16-6PROGram:SELected 16-4:WAVeguideSENSe:CORRection:RVELocity 18-18SOURce:CORRection:RVELocity 19-14:WIDThHCOPy:PAGE 10-15OUTPut:TTLTrg|:ECLTrg 15-13SOURce:PULSe 19-62:WINDowDISPlay 8-6 - 8-16HCOPy:ITEM 10-11:WINDow FLATtopCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-26:WINDow HAMMingCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-26:WINDow RECTangularCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12Index - 26


1997 SCPI Comm<strong>and</strong> ReferenceCALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-26WINDow SubsystemSENSe 18-78:WINDow UNIFormCALCulate:FILTer:GATE:FREQuency 4-14CALCulate:FILTer:GATE:TIME 4-12CALCulate:TRANsform:DISTance 4-29CALCulate:TRANsform:FREQuency 4-31CALCulate:TRANsform:TIME 4-26:WRITeVXI:REGister 26-8:WSPRotocolVXI 26-9X:XDISPlay:WINDow:TRACe 8-12INPut:POSition 11-8OUTPut:POSition 15-5:XCURrentSENSe:FUNCtion: 18-40:XFRequencySENSe:FUNCtion: 18-40:XNONeSENSe:FUNCtion: 18-40:XPOWerSENSe:FUNCtion: 18-40:XTIMeSENSe:FUNCtion: 18-40:XVOLtageSENSe:FUNCtion: 18-40Y:YZDISPlay:WINDow:TRACe 8-13INPut:POSition 11-10OUTPut:POSition 15-8:ZINPut:POSition 11-12OUTPut:POSition 15-10:ZEROCALibration 5-2Index - 27


St<strong>and</strong>ardComm<strong>and</strong>s forProgrammableInstruments(SCPI)<strong>Volume</strong> 3: Data Interchange FormatVERSION 1997.0May, 1997Printed in U.S.A.


NOTICE, STATEMENT of INTENT<strong>and</strong>AUTHORIZATION TO COPY© Copyright 1997 SCPI ConsortiumThis document defines the St<strong>and</strong>ard-Comm<strong>and</strong>s-for-Programmable-Instruments (SCPI) Consortium’sSCPI st<strong>and</strong>ard. Although the Consortium hereby expressly disclaims any <strong>and</strong> all warranties whatsoeverregarding the SCPI st<strong>and</strong>ard, the Consortium has published this document with the intent that the SCPIst<strong>and</strong>ard will be seriously considered <strong>and</strong> adopted, in whole, by the test <strong>and</strong> measurement marketplace.Consistent with that intent, permission is hereby granted by the Consortium to make copies of thisentire document as a whole, PROVIDED THAT this NOTICE, STATEMENT of INTENT <strong>and</strong>AUTHORIZATION TO COPY shall prominently appear on each such whole copy. Further consistentwith that intent, permission is hereby granted by the consortium to make copies of portions of thisdocument, absent this NOTICE, STATEMENT of INTENT <strong>and</strong> AUTHORIZATION TO COPY,PROVIDED THAT each such portion-copies shall only be used in a manner which is consistent withthe purposes of implementing, promoting, disseminating, or enhancing (as opposed to deviating from)the SCPI st<strong>and</strong>ard as herein defined, such as the inclusion of such a portion-copy in an instrument (orinstrument-related) product manual which implements SCPI (as defined herein) or in use for design ofsuch an instrument (or instrument related) product. However, under no circumstances may copies ofthis document, or any portion of this document, be made solely for purposes of sale of the copy orcopies.For information, contact:Fred Bode, Executive DirectorSCPI Consortium8380 Hercules Drive, Suite P3La Mesa, CA 91942Phone: (619) 697-8790FAX: (619) 697-5955CompuServe Number: 76516,254fbode@vxinl.comii


Table of ContentsChapter 1 Introduction1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11.2 Defined Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21.3 Implicit <strong>and</strong> Explicit Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Chapter 2 <strong>Style</strong>Chapter 3 <strong>Syntax</strong>3.1 Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13.2 White Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13.3 Blocks, Block Modifiers, <strong>and</strong> Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.4 Value Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.4.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.4.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.4.10 Enumerated Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4Chapter 4 Grammar4.1 Grammar Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.1 Non-terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.2 Pseudo-terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.3 Meta-symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1.4 Terminal Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.2 Grammar Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.3 Required Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64.4 Required Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64.5 Unrecognized Keywords <strong>and</strong> Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6Chapter 5 Data Format Extensions5.1 Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15.2 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15.3 Extension Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1iii


Chapter 6 Block Descriptions1997 SCPI Data Interchange Format6.1 Top Level Block Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.2 DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.2.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.2.2 DELTa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.2.2.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.2.2.2 DIMension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.2.2.1 SCALe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.2.2.2 OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.2.2.3 SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.2.3 DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.2.4 TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.3 CURVe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.3.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.3.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.3.3 CTYPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.3.4 VALues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56.2.3.5 CSUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56.2.4 WAVeform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56.2.4.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-86.2.4.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-86.2.4.3 TRACe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-86.2.4.4 HLMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-86.2.4.5 HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-86.2.4.6 LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96.2.4.7 REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96.2.4.7.1 HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96.2.4.7.2 LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96.2.4.7.3 MID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96.2.4.7.4 METHod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96.2.4.8 AMPLitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106.2.4.9 PWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106.2.4.10 NWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106.2.4.11 PERiod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106.2.4.12 FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106.2.4.13 PDUTycycle | DCYCle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.14 NDUTycycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.15 RISE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.15.1 TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.15.2 OVERshoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.15.3 PREShoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.16 FALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116.2.4.16.1 TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.2.4.16.2 OVERshoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12iv


1997 SCPI Data Interchange Format6.2.4.16.3 PREShoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.2.4.17 MAXimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.2.4.18 MINimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.2.4.19 TMAXimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.2.4.20 TMINimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.2.4.21 MEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136.2.4.22 RMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136.2.4.23 SDEViation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136.2.4.24 PTPeak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136.2.4.25 CYCLe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136.2.4.25.1 COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136.2.4.25.2 MEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-146.2.4.25.3 RMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-146.2.4.25.4 SDEViation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-146.2.5 MEASurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-146.2.5.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-156.2.5.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-156.2.5.3 UNITs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-156.2.5.4 TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-156.2.5.5 TRACe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-166.2.5.6 LOCation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-166.2.5.6.1 LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-166.2.5.6.2 INDex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-166.2.5.7 VALues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-166.2.6 DATA Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-176.3 DIMension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-176.3.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-186.3.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-186.3.3 TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-186.3.4 SCALe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-196.3.5 OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-196.3.6 SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-196.3.7 UNITs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-206.3.8 ENCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-206.3.9 DIMension Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-206.4 ENCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-216.4.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-216.4.2 FORMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-226.4.3 NVALue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-236.4.4 ORANge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-236.4.5 URANge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-236.4.6 HRANge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-236.4.7 LRANge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-246.4.8 RESolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-246.4.9 ENCode Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-24v


1997 SCPI Data Interchange Format6.5 IDENtify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-246.5.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-256.5.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-256.5.3 TECHnician . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-256.5.4 PROJect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-266.5.5 DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-266.5.6 TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-266.5.7 UUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-266.5.7.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-266.5.7.2 ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.7.3 DESign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.8 TEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.8.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.8.2 SERies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.8.3 NUMBer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.9 HISTory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-276.5.10 IDENtify Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-286.6 ORDer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-286.6.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-286.6.2 BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-286.6.3 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-296.7 REMark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-316.7.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-326.7.2 REMark Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-326.8 DIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-326.8.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-326.8.2 VERSion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-326.8.3 SCOPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-336.8.4 DIF Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-336.9 TRACe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-336.9.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346.9.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346.9.3 SYMMetry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346.9.4 INDependent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346.9.4.1 LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-356.9.4.2 STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-356.9.4.3 STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-356.9.5 DEPendent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-356.9.5.1 LABel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-356.9.6 TRACe Block Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-366.10 VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-366.10.1 NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-376.10.2 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-376.10.3 ENVelope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-376.10.3.1 UPPer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-38vi


1997 SCPI Data Interchange Format6.10.3.2 LOWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.3.3 FUNCtion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.4 RCOMPlex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.4.1 REAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.4.2 IMAGinary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.5 PCOMplex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.5.1 MAGNitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-386.10.5.2 PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-396.10.6 VIEW BLOCK EXAMPLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-39Chapter 7 Data Format Examplevii


1997 SCPI Data Interchange Formatviii


1997 SCPI Data Interchange Format1 IntroductionThe data interchange format described in this section lets software packages <strong>and</strong> instrumentsshare waveform <strong>and</strong> other data. It is designed to be flexible <strong>and</strong> extensible, <strong>and</strong> canaccommodate a wide range of data structures <strong>and</strong> formats. In addition to describing the dataitself, the data interchange format provides information regarding the data environment,structure, <strong>and</strong> other related specifications. Only a minimum of information about the data isactually required but a wide range of information can be associated with the data. Complexdata dimensioned sets <strong>and</strong> simpler data are equally representable using the block structure ofthis data format.Because this data format is hierarchically structured, it can be subordinate to other structures.It is suitable as a file format <strong>and</strong> its encoding formats allow it to be easily transmitted acrossIEEE 488.1/488.2, RS-232, SCSI, IEEE 802, <strong>and</strong> various other transmission media <strong>and</strong>protocols.The syntax of the data interchange format is compatible with IEEE 488.2 syntax. With minormodifications, an IEEE 488.2 parser, or at least its lexical analyzer, can also analyze thesyntax of this format. While the format imposes its own rules within IEEE 488.2expressions, these rules conform to the IEEE 488.2 restrictions for expressions.1.1 OverviewThe data interchange format is block-structured. A data set generally consists of severaldescription blocks <strong>and</strong> a data block. A block contains keywords <strong>and</strong> subordinate blocks.Within a block or sub-block are keywords with values that define characteristics of the dataor the environment in which it was acquired. Many blocks accept a modifier label value <strong>and</strong>it is required for some blocks. A block modifier allows multiples of the same block type tobe distinguished from one another.Each block addresses a different aspect of data description. The DATA block contains thedata. The IDENtify block describes the manner <strong>and</strong> environment in which the data wasobtained. The DIMension <strong>and</strong> ENCode blocks describe how the data is physicallyrepresented <strong>and</strong> logically organized. The TRACe <strong>and</strong> VIEW blocks provide semanticinformation about the data. A REMark block contains textual comments regarding the data.Finally, the DIF block identifies the block as a <strong>and</strong> describes the version ofSCPI used.This data interchange format focuses on data as an abstraction of instrument- oralgorithm-generated data. The method of data acquisition or creation is h<strong>and</strong>led asdescriptive information that is not required for proper interpretation of the data. Informationabout the encoding, structure, scaling, range, etc., of the data is independent of the source ofthe data.For example, instrument-dependent settings <strong>and</strong> characteristics such as sample rate aretranslated into acquisition independent parameters such as RESolution.12345678910111213141516DIF01171819202122Introduction 1-1


1997 SCPI Data Interchange Format11.2 Defined BlocksThe Data Interchange Format consists of the following major blocks:DIF identifies the expression as a <strong>and</strong> contains the version ofthe st<strong>and</strong>ard used to create the data set.REMark contains general comments in human-readable text regarding the data.IDENtify names the data set <strong>and</strong> describes the environment in which it wasgenerated. Environment description includes project name, test number <strong>and</strong> series,date <strong>and</strong> time, <strong>and</strong> source.ENCode specifies the encoding format for data in the DATA <strong>and</strong> ENCodeblocks. Also covered are signal values for underflow, overflow <strong>and</strong> no value, aswell as the range <strong>and</strong> resolution of the data.DIMension specifies the structure <strong>and</strong> format of data in the DATA block.Provision is made for data scaling, offset, naming, <strong>and</strong> units specification.ORDer specifies ordering of the data elements in the DATA(CURVe) block foreach dimension.TRACe logically groups dimensions as functions, surfaces, sets, etc. TRACeblocks provide semantic information about the data <strong>and</strong> are used to build VIEWblocks. They also provide a convenient <strong>and</strong> powerful mechanism for subsettingdata.VIEW provides a second level of semantic information about the data. VIEWdescribes logical relationships among traces defined in the TRACe block such asenvelope traces.DATA contains the actual data. Different subordinate blocks describedimensioned data, waveform parameter measurements, <strong>and</strong> point values.1.3 Implicit <strong>and</strong> Explicit DimensionsThere are many ways to describe the structure <strong>and</strong> order of dimensioned data, <strong>and</strong> not allterms are well defined or understood. The data interchange format treats all CURVe data ascoordinates in n-dimensional space. If a coordinate is actually present in the data, itsdimension is said to be explicit. If the coordinate value of a dimension is not present as adata value, but is instead derived from the location of other coordinate values, the dimensionis said to be implicit.Suppose you mark off an evenly spaced grid on the floor of a room, <strong>and</strong> then makemeasurements of temperature <strong>and</strong> humidity at some (varying) height above the floor. As youmake these measurements, you write down the temperature <strong>and</strong> humidity measurements <strong>and</strong>the location (X, Y, <strong>and</strong> Z positions relative to one corner of the room). The result is 5-tuple.You must write each set of measurements in a consistent order (such as X, Y, Z,temperature, <strong>and</strong> humidity), but you may write the sets of measurements in any order.DIF01DIF011-2 Introduction


1997 SCPI Data Interchange FormatA 5-tuple may be viewed, as this format does, as a point in a 5-dimensional space. All fivedimensions are explicit, meaning that for each dimension, you have explicitly written downits coordinate.Now suppose you make the measurements according to some consistent pattern. You startwith the first grid line <strong>and</strong> make the measurements sequentially at each Y point along the Xgrid line. You then make the measurements along the second X grid line, <strong>and</strong> so on, until thelast grid line is completed.If you keep track of the order in which the measurements were made, you only need to writedown two measurements: temperature <strong>and</strong> humidity. The other three measurements (Xlocation, Y location, <strong>and</strong> height) are derivable from the order of the data. The data is still5-dimensional, but three of the dimensions are implicit <strong>and</strong> two are explicit.Simple waveforms acquired from instruments like oscilloscopes (when clocked internally)commonly consist of a time series of voltage (vertical axis) measurements. For thetime-voltage space, only the voltage value or coordinate is provided by the oscilloscope; thetime (horizontal axis) is derived from the order of the data, an initial starting time, <strong>and</strong> ascale factor. The voltage dimension is explicit <strong>and</strong> the time dimension is implicit.This format classifies all dimensions as implicit or explicit. The order of the data, which isessential to the correct derivation of implicit dimension coordinates or values, is strictlydefined by the ORDer block or its default values.12345678910111213141516171819202122Introduction 1-3


1997 SCPI Data Interchange Format11-4 Introduction


1997 SCPI Data Interchange Format2 <strong>Style</strong>The data interchange format uses, for the most part, st<strong>and</strong>ard IEEE 488.2 syntactic elementsalong with the nested parentheses which together comprise an Expression type parameter(“<strong>Volume</strong> 1: <strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>,” Section 8).The format also uses the concept of “friendly” listening <strong>and</strong> “precise” talking followed byIEEE 488.2. There are some differences, which are clarified in 3 of this section.Keywords may take single or multiple values. If a keyword takes multiple values, all valuesshall be of the same type.A few keywords have default values. If the keyword is omitted, the default value prevails.These values are specified in the block descriptions in 6 of this section.An invalid set reports either a Comm<strong>and</strong> Error or an Execution Error as described in“<strong>Volume</strong> 2: Comm<strong>and</strong> Reference,” 21.8.3 <strong>and</strong> 21.8.4. While uppercase characters arespecified, lowercase characters may be accepted without error if interpretation of the data setis unambiguous.It is not required that a data format parser accept all values of an enumerated set (3.4.10 ofthis volume). An error may be generated on receipt of an unimplemented value.12345TK053a67TK053a 8910111213141516171819202122<strong>Style</strong> 2-1


1997 SCPI Data Interchange Format22-2 <strong>Style</strong>


1997 SCPI Data Interchange Format3 <strong>Syntax</strong>The data format is block-structured. Each hierarchical level is introduced by a block name,with its subordinate elements enclosed in parentheses. A block may have a modifier <strong>and</strong> maycontain subordinate blocks <strong>and</strong> keyword units, or both. Keyword units consist of a keywordfollowed by one or more values. If a keyword has more than one value, the values areseparated by commas.The following example shows a simple data set. It is formatted so that all blocks <strong>and</strong>keywords are indented to show their hierarchical relationship.(DIF (VERSion 1993.0)IDENtify (NAME “Data Format Example”TEST (NUMBer “7D4", ”2.4"))ENCode (HRANge 75LRANge 25)DIMension=X (TYPE IMPLicitSCALe 0.01SIZE 7UNITs “S”)DIMension=Y (TYPE EXPLicitSCALe 0.02OFFSet 0.1UNITs “V”)DATA (CURVe (VALues 49.0, 48.0, 50.2, 61.3, 68.5, 38.6, 48.0)))The data interchange format overall is formatted as an IEEE 488.2 element. Within this element, the various blocks, modifiers, keywords,<strong>and</strong> value types are composed of syntactic elements that, for the most part, are identical tothe corresponding types specified in IEEE 488.2 or a subset of them.3.1 Character SetAll syntactic elements except contain only 7-bit ASCII-formatted (ANSIX3.4-1977) data with the high-order eighth bit always set to zero.3.2 White SpaceWhite space consists of the ASCII space character, 32 decimal. A space is used along withthe parentheses, comma, <strong>and</strong> equal sign to separate syntactic elements.1234TK053a56789101112131415DIF0116171819202122DIF01<strong>Syntax</strong> 3-1


1997 SCPI Data Interchange Format3When an instrument accepts data, redundant white space may appear without semantic effectanywhere except within: block names, block modifiers, keywords, <strong>and</strong> all value types.Note that the characters constituting white space may be a part of the semantic content of <strong>and</strong> value types.When an instrument sends data, redundant white space is not allowed.3.3 Blocks, Block Modifiers, <strong>and</strong> KeywordsWhen an instrument accepts data, block names, block modifiers, <strong>and</strong> keywords conform tothe IEEE 488.2 syntax. Abbreviated short forms <strong>and</strong>any specified aliases shall be accepted.When an instrument sends data, the IEEE 488.2 syntax is used. If a long <strong>and</strong> short form element is specified, the short form shall be sent.As the data format is hierarchically organized, mnemonic generation rules for compoundheaders apply. See “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>’” 2.2.1. Specific syntactic restrictions on the use ofblocks, block modifiers, <strong>and</strong> keywords are covered in 4 of this section.3.4 Value TypesThe grammar employs the following value types.3.4.1 The value type is used to specify zero, positive <strong>and</strong> negative numeric values.When an instrument accepts data, follows one of the following two IEEE 488.2program data formats:, orContrary to IEEE 488.2, values with embedded white spaces do not have to beaccepted.When an instrument sends data, follows one of the following six response dataformats:,,,,, or3.4.2 The value type is used to specify positive numeric values greater than zero.Other than this restriction, the value type is identical to .DIF053-2 <strong>Syntax</strong>


1997 SCPI Data Interchange Format3.4.3 The value type is used to specify positive numeric values equal to or greaterthan zero. Other than this restriction, the value type is identical to .3.4.4 DIF06The value type is used to specify zero, positive <strong>and</strong> negative integer numeric values.An instrument shall accept any value, rounding as necessary to obtain an integervalue. When an instrument sends data, follows the IEEE 488.2 format.123Note that rounding may result in an invalid integer value.43.4.5 DIF06The value type is used to specify positive integer numeric values greater than zero. 5Other than this restriction, the value type is identical to .3.4.6 6DIF06The value type is used to specify positive numeric values equal to or greater thanzero. Other than this restriction, the value type is identical to .73.4.7 The value type is used to specify 8-bit, 16-bit, 32-bit, or 64-bit significant data. is only allowed for use with the DATA(CURVe(VALues)) keyword.The FORMat keyword from the applicable ENCode block determines the interpretation ofthe data values. Bytes are grouped according to the number of bits required. For example,bytes are grouped by four’s <strong>and</strong> interpreted as a 32-bit integer for INT32.When an instrument accepts data, values shall follow the format of IEEE 488.2 format with the restriction that only definitelength blocks are accepted.When an instrument sends data, values shall follow the format of IEEE 488.2 format.8910111213143.4.8 15DIF04The is used to represent quoted strings.When an instrument accepts data, data conforms to IEEE 488.2 syntax.When an instrument sends data, data conforms to IEEE 488.2 syntax.1617183.4.9 The value type is used to represent short, unquoted string labels for block modifier<strong>and</strong> keyword values.When an instrument accepts data, follows the IEEE 488.2 syntax.19202122<strong>Syntax</strong> 3-3


1997 SCPI Data Interchange Format3When an instrument sends data, follows the IEEE 488.2 syntax. A has no short form.3.4.10 Enumerated SetSome keywords specify a value from an completely enumerated set of values.When an instrument accepts data, an enumerated set member follows the IEEE 488.2 syntax. If specified, acceptance of long <strong>and</strong> shortform as well as aliases is required.When an instrument sends data, an enumerated set member follows the IEEE 488.2 syntax. If both a long <strong>and</strong> short form element arespecified, only the short form shall be sent.It is not required that a data format parser accept all values of an enumerated set. An errormay be generated on receipt of an unimplemented value. See 2 of this section.Mnemonic generation rules for character data apply. See “<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>,” 2.2.1.DIF053-4 <strong>Syntax</strong>


1997 SCPI Data Interchange Format4 GrammarThis chapter specifies the grammar of the data format. This grammar describes the contentsof a that represents a Data Interchange Format.4.1 Grammar NotationThe grammar notation consists of the non-terminal symbols, pseudo-terminal symbols,meta-symbols, <strong>and</strong> terminal symbols defined below.124.1.1 Non-terminalsNon-terminals are represented as all lowercase words.34.1.2 Pseudo-terminalsPseudo-terminals st<strong>and</strong> for any from a set of terminal symbols (value types) as described in3.4 of this section <strong>and</strong> are represented as words bracketed between < <strong>and</strong> >.454.1.3 Meta-symbolsIn the following table, “.” represents an arbitrary string of terminals <strong>and</strong> non-terminals. Themeta-symbols for the grammar are ->, {, }, *, +, [, ], <strong>and</strong> |.They have the following meanings:-> Separates the left <strong>and</strong> right h<strong>and</strong> sides of a production{ . }* The enclosed item occurs zero or more times.678910{ . }+ The enclosed item occurs one or more times.11[ . ] The enclosed item occurs zero or one times.12{ . | . | . } One <strong>and</strong> only one of the two or more enclosed items separated by | occurs.134.1.4 Terminal SymbolsTerminal symbols are represented in mixed uppercase <strong>and</strong> lowercase to indicate long <strong>and</strong>short form (“<strong>Syntax</strong> <strong>and</strong> <strong>Style</strong>,” 1).4.2 Grammar Descriptiondif ->difid[remark][identify][encode]{dimension}+[order]{trace}*{view}*{data}+Grammar 4-11415DIF0116TK053a1718192021DIF01,0322


1997 SCPI Data Interchange Format4difid ->remark ->DIF([NOTEVERSion[SCOPe)REMark([NOTE)identify -> IDENtify ([NOTE[NAME[TECHnician[PROJect[DATE)[TIME[UUT([NAME[ID[DESign)][TEST([NAME[SERies[NUMBer)][HISTory]PREamble | FULL] {,}*]]] {,}*]],,[,,,]],,[,,,]]] {,}*] {,}*]]] {,}*] {,}*]TK032ADIF01,03DIF03DIF06DIF06encode -> ENCode ([NOTE[FORMat[NVALue[ORANge[URANge[HRANge[LRANge]{ IFP32 | IFP64| INT8 | INT16 | INT32 | INT64| SFP32 | SFP64| SINT16 | SINT32 | SINT64| SUINT16 | SUINT32 | SUINT64| UINT8 | UINT16 | UINT32 | UINT64 }]]]]]]TK0554-2 Grammar


1997 SCPI Data Interchange Format)[RESolution]dimension -> DIMension = ([NOTE][NAME]TYPE{IMPLicit | EXPLicit}[SCALe][OFFSet ][SIZE]UNITs[encode])order -> ORDer ([NOTE[BY)trace ->TRACe = ([NOTE[NAME[SYMMetry{INDependent(LABel[STARt[STOP)}*{DEPendent(LABel)}*)view -> VIEW = ([NOTE[NAME{ENVelope(UPPerLOWer[FUNCtion)}*)]{TUPLe | DIMension}]]]]]]]]]DIF0312345DIF0367DIF0389101112131415DIF0316171819202122Grammar 4-3


4data ->1997 SCPI Data Interchange FormatDATA [= ]([NOTE][delta][curve]{waveform}*{measurement}*)delta -> DELTa ([NOTE]{DIMension = ([SCALe ][OFFSet ][SIZE ])}+[DATE,,[,,,]][TIME,,[,,,]])curve -> CURVe ([NOTE ][NAME ][CTYPe {SUM8| CRC16| CCITT | SUM16}][VALues { | }[,{ | }]*][CSUM ])NOTE: The presence of VALues is conditional on the DIF(SCOPe) keyword; refer to theRequired Blocks, section 4.3.DIF03DIF03DIF06DIF03TK032ATK032A4-4 Grammar


1997 SCPI Data Interchange FormatDIF03waveform -> WAVeform[= ]([NOTE][NAME][TRACe][LOW][REFerence()][AMPLitude ][PDUTycycle| DCYCle ][NDUTycycle ][RISE([PREShoot ])][FALL([TIME ])][MAXimum ][HLMethod[HIGH[MID[PWIDth[PERiod[TIME[OVERshoot[MINimum]]]]]]]][HIGH[LOW[METHod[NWIDth[FREQuency[OVERshoot[PREShoot[TMAXimum]]]]]]]]123456789101112131415[TMINimum ]16[MEAN][RMS]17[SDEViation ][PTPeak ]18[CYCLe([COUNt ]19[SDEViation ])][MEAN ][RMS ]2021) DIF03Grammar 4-522


1997 SCPI Data Interchange Format4measurement ->MEASurement [= ]([NOTE ][NAME ][UNITs ][TYPE ][TRACe ]{LOCation (LABel INDex )}*[VALues {,}*])4.3 Required BlocksNote that a data set shall contain a DIF block <strong>and</strong> at least one DIMension <strong>and</strong> one DATAblock.All TRACe blocks referenced by keywords in the VIEW <strong>and</strong> DATA blocks shall be present.All DIMension blocks referenced by LABel keywords in the TRACe block shall be present.If the DIF(SCOPe) keyword is not present or is set to FULL, any CURVe block shall containa VALues keyword <strong>and</strong> parameters. If DIF(SCOPe) is present <strong>and</strong> set to PREamble,VALues keywords <strong>and</strong> parameters shall be omitted from all CURVe blocks.4.4 Required OrderWhen an instrument accepts data, certain blocks shall be sent in the following order:DIFENCodeDIMensionTRACeVIEWDATAIn addition, the ORDer must appear before the DATA block. The REMark <strong>and</strong> IDENtifyblocks may appear anywhere after the DIF block.Within the DATA block, the DELTa sub-block shall precede all other sub-blocks.Within a block, individual keywords may also be accepted in any order with the exceptionthat the CTYPe keyword must come before the VALues keyword.When an instrument sends data, the block <strong>and</strong> keyword order specified in the grammar isrequired.DIF01TK032aDIF01DIF014.5 Unrecognized Keywords <strong>and</strong> Blocks DIF03A listener is not required to interpret all keywords <strong>and</strong> blocks present in a data set, but onlythose required for the type of data of interest. For example, all listeners must interpret mostkeywords <strong>and</strong> sub-blocks in the DIF, DIMension, ENCode, <strong>and</strong> ORDer blocks since4-6 Grammar


1997 SCPI Data Interchange Formatinformation contained in these blocks is required for the correct interpretation of data in theDATA block. Exceptions are keywords such as NOTE, RESolution, HRANge, etc. Otherkeywords <strong>and</strong> blocks may or may not be of interest to a listener. For example, a listener thatseeks only WAVeform data will ignore CURVe data, <strong>and</strong> vice versa.This is consistent with the philosophy that different listeners may accept the same data setbut use it for different purposes. In addition, the data format provides an extensionmechanism that is designed to allow older listeners to accept newer data sets that maycontain new keywords <strong>and</strong> sub-blocks. See 5 of this section for further details on extensionmechanisms.Therefore, listeners must be able to ignore unrecognized (but syntactically correct) keywords<strong>and</strong> blocks. The extent, if any, to which a listener notifies a user that an unrecognizedkeyword or block was encountered; <strong>and</strong>, the extent, if any, of required user action isimplementation dependent.Note that a block name is always followed by an open parenthesis; or, an equal sign,modifier, <strong>and</strong> open parenthesis sequence. This following structure may be ignored bysearching forward to the matching closing parenthesis. A keyword is always followed by oneor more comma separated values.12345678910111213141516171819202122Grammar 4-7


1997 SCPI Data Interchange Format44-8 Grammar


HP01997 SCPI Data Interchange Format5 Data Format ExtensionsThis format may be extended <strong>and</strong> enhanced with one of the following two methods.5.1 ExtensionsKeywords, blocks (sub-blocks) may be created to accomodate information that is nototherwise provided for by existing keywords or blocks. This method of extension can bedone without conflict because parsers ignore unknown keywords <strong>and</strong> blocks. Name aliasesmay be specifed for the new keywords or blocks. However, the use of aliases is stronglydiscouraged <strong>and</strong> should only be provided if there is widespread industry usage of more thanone name.5.2 EnhancementsA second method of extension involves replacing an existing keyword with a sub-block ofthe same name. This method is used when the semantic information represented by anexisting keyword is insufficient. The replacement sub-block shall include a keyword thatrepresents the exact same semantic information (including the same value type <strong>and</strong> range) ofthe original keyword. This keyword is distinguished from all other keywords in the newsub-block by appending an underscore to it. No alias names may be added for the newsub-block.A parser which was implemented before the extension was made recognizes this specialkeyword by the presence of the underscore <strong>and</strong> then takes the value associated with thisflagged keyword <strong>and</strong> assigns it to the old keyword. The remainder of the sub-block isdiscarded.5.3 Extension ExampleSuppose sometime in the future a need for a sub-block under RANGe is recognized. In thisversion the syntax for RANGe is:RANGe The extended syntax might appear as:RANGe (HIGH_ [LOW ][OVER ])A newer implementation would underst<strong>and</strong> the meaning for all three values under RANGe.An older parser takes the values associated with the flagged keyword in the sub-block, in thiscase, HIGH_, <strong>and</strong> uses its value as the value for RANGe. Since the older parser has no needfor the LOW <strong>and</strong> OVER values, they are discarded.Data Format Extensions 5-112345678910111213141516171819202122


1997 SCPI Data Interchange Format5This extension can be continued. At some even later date, more sub-blocks are needed. Thesyntax might now become:RANGe (HIGH_ (EXPected_ )[ALLowed)LOW (EXPected_[ALLowed)OVER (EXPected_[ALLowed)]]]The original parser could still successfully determine which value to associate with the oldkeyword RANGe <strong>and</strong> safely discard the rest. Both the intermediate <strong>and</strong> newest parsers canh<strong>and</strong>le this syntax without conflict.5-2 Data Format Extensions


1997 SCPI Data Interchange Format6 Block DescriptionsThis chapter details all of the block descriptions for the data interface format.6.1 Top Level Block Organization DIF01The entire data set is composed of the following sequence of m<strong>and</strong>atory <strong>and</strong> optional blocks. 1dif ->difidTK053a 2[remark][identify]3[encode]{dimension}+4[order]{trace}*5{view}*{data}+6A data set is built from the blocks described in 6.2 through 6.10 of this section.TK053a 76.2 DATA 8DIF03A DATA block contains the data of primary interest. It may contain dimensioned data suchas DATA(CURVe), or specific sets of data (WAVeform, etc.). At least one DATA block isrequired, <strong>and</strong> multiple DATA blocks are allowed. A DATA block is defined as:data -> DATA [= ](910DIF03[NOTE ][delta][curve]{waveform}*{measurement}*)11121314 is optional <strong>and</strong> allows for the unique identification of the DATA block; no twoDATA blocks may have the same value within a data set.The subordinate blocks within a particular DATA block are assumed to be related. That is, ifCURVe <strong>and</strong> WAVeform measurements are present in the same DATA block, theWAVeform measurements are assumed to have been derived from the CURVe data. If thatis not the case, different DATA blocks should be used for the CURVe <strong>and</strong> WAVeformmeasurements.15161718Block Descriptions 6-119202122


1997 SCPI Data Interchange Format66.2.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Humidity was 45%”6.2.2 DELTa DIF03A DELta sub-block provides for sequences of closely related data. When a data set containsmultiple occurrences of DATA blocks, the DELta block differentiates the characteristics ofeach of the DATA blocks. Note that the DELta block is limited to redefining descriptiveinformation, encoding information, <strong>and</strong> dimension size, such as SCALe, DATE, <strong>and</strong>OFFSet. A DELta block cannot change the organization of the data, such as the number ofdimensions or the data ordering.The values specified in a DELta block override those specified at a higher hierarchical level.For example, the value for SCALe in the DATA(DELta(DIMension)) block overrides thevalue for SCALe in the higher level DIMension block, but only for data within the DATAblock that contains the DELta block. If there are multiple DATA blocks with subordinateDELta blocks, the DELta blocks have no effect on each other; that is, they each individuallyspecify a modification of the same (higher level) IDENtify, DIMension, or ENCode block.The DELta sub-block may occur only once <strong>and</strong>, if present, shall be the first block in theDATA block. The DELta sub-block is defined as:DIF03delta -> DELTa([NOTE]{DIMension = ([SCALe ][OFFSet ][SIZE ])}+[DATE,,[,,,]]DIF06[TIME,,[,,,]]DIF06)6.2.2.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Sequence 43”6-2 Block Descriptions


1997 SCPI Data Interchange Format6.2.2.2 DIMensionThe DIMension sub-block is a limited subset of the higher level DIMension block (see 6.3 inthis section). The modifier is required <strong>and</strong> is restricted to a value defined by the of a DIMension block at the same hierarchical level as the DATA block.6.2.2.2.1 SCALe 1DIF03This is the scale value for the dimension specified by the DIMension sub-block .Value type is . SCALe may occur only once. See SCALe in 6.3 in this section foradditional definition <strong>and</strong> restrictions.23Example: SCALe 1E-26.2.2.2.2 OFFSetThis is the offset value for the dimension specified by the DIMension sub-block .Value type is . OFFSet may occur only once. See OFFSet in 6.3 in this sectionfor additional definition <strong>and</strong> restrictions.Example: OFFSet 6.0E-145676.2.2.2.3 SIZE 8DIF03The size value for the dimension specified by the DIMension sub-block .Value type is . SIZE may occur only once. See SIZE in 6.3 in this section foradditional definition <strong>and</strong> restrictions.910Example: SIZE 2048116.2.2.3 DATE DIF03This is the date of data creation or acquisition.12DIF06This keyword takes a set of three comma separated value types to specify the datecorresponding to year, month, <strong>and</strong> day.13DIF06The years parameter is type . It always includes century <strong>and</strong> millennium information. 14DIF06The months parameter is type . Its range is 0 to 12.15DIF06The days parameter is type . Its range is 0 to 31 (depending on the month).If two sets of values are specified, they define an inclusive range of dates.16DIF06Example: DATE 1990,01,01,1992,10,11 indicates a range of dates from January 1, 1990through October 11, 1992.DIF061718DIF066.2.2.4 TIME 19DIF03This is the time of data creation or acquisition.DIF06This keyword takes a set of three comma separated value types to specify the time 20corresponding to hour, minute, <strong>and</strong> second.The hours parameter is type . Its range is 0 to 23. This parameter is alwaysexpressed in 24 hour format.Block Descriptions 6-321DIF0622


61997 SCPI Data Interchange FormatThe minutes parameter is type . Its range is 0 to 59.The seconds parameter is type . Its range is 0 to 60 for instruments receivingdata <strong>and</strong> 0 to 59.999... for instruments sending data.If two sets of values are specified, they define an inclusive range of time.Example: TIME 9,0,59.095,13,1,0 indicates a range of time from 59.095 seconds after 9 AMto one minute after 1 PM.6.2.3 CURVeCurve data is dimensioned. Values may be organized as n-tuples or by dimension. This isdetermined by the ORDer block or, in its absence, the defaults for the BY keyword in theORDer block.Only one occurrence of CURVe is allowed in a DATA block. The CURVe block is definedas:curve -> CURVe([NOTE ][NAME ][CTYPe {SUM8| CRC16| CCITT | SUM16}][VALues { | }[,{ | }]*][CSUM ])DIF06DIF06DIF06DIF06DIF06DIF03TK032aThe presence of VALues is conditional on the DIF(SCOPe) keyword; refer to the Required TK032aBlocks, section 4.3.6.2.3.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Data taken with low line voltage”6.2.3.2 NAME DIF03This is an arbitrary name or description of the curve.Value type is . It is recommended that the string length be 32 characters or less.NAME may occur only once <strong>and</strong> only one value is allowed.Example: NAME “DS1C”6.2.3.3 CTYPe DIF03This indicates the checksum type or the absence of a checksum.CTYPe takes a specified enumerated set of values. CTYPe may occur only once <strong>and</strong> requiresone <strong>and</strong> only one of the following enumerated set values:6-4 Block Descriptions


1997 SCPI Data Interchange FormatCRC1616-bit cyclic redundancy check code. x 16 + x 15 +x 2 + 1. (default)CCITT 16-bit cyclic redundancy check code. x 16 + x 12 +x 5 + 1.SUM8 8-bit longitudinal redundancy check code (8 bit sum). x 8 + 1.(SUM8 is provided for compatibility <strong>and</strong> its use is discouraged).SUM16 16-bit longitudinal redundancy check code (16 bit sum). x 16 + 1.NONEindicates there is no checksum.See “IEEE Micro”, Vol 8, No 4, August 1988, pp 62-76.Note that CTYPe must preceed the VALues keyword.Example: CTYPe SUM86.2.3.4 VALuesThis specifies the data values.Value type is or . Multiple values are allowed.VALues shall occur exactly once if the DIF(SCOPe) keyword is not present or is set toFULL. If DIF(SCOPe) is present <strong>and</strong> set to PREamble, VALues shall be omitted.The physical format of each value is determined by the FORMat keyword of the ENCodeblock that applies. If the dimension has a subordinate ENCode block, the subordinateENCode block prevails; otherwise the ENCode block at the same hierarchical level as theDIMension blocks prevails.Example: VALues 1.2, 3.3, 4.5, 2.7, 0.45TK032a 6TK032a7TK053a 86.2.3.5 CSUM 11DIF03This indicates the checksum for DATA(CURVe(VALues)) dataValue type is .The checksum is computed according to the rules specified by CTYPe. If data is formatted in value type, the checksum is computed using the 8-bit ASCII decimal equivalentof each character of the number. This includes all signs, decimal points, <strong>and</strong> exponentcharacters but not white space.CSUM may occur only once <strong>and</strong> takes only one value.1213141516Example: CSUM 276.2.4 WAVeformThis block describes waveform parameter measurements of a two dimensional waveform.The descriptions assume a single-valued function of time in which the independentdimension is the time dimension. However, the actual units are specified in the DIMension171819block <strong>and</strong> it is possible to represent other quantities which are not functions of time.Multiple occurrences of WAVeform are allowed. The WAVeform block is defined as:2021DIF0322Block Descriptions 6-51234910


1997 SCPI Data Interchange Format6waveform ->WAVeform[= ]([NOTE][NAME][TRACe][HLMethod ][HIGH][LOW][REFerence([HIGH ][LOW ][MID ][METHod ])][AMPLitude ][PWIDth ][NWIDth ][PERiod ][FREQuency ][PDUTycycle| DCYCle ][NDUTycycle ][RISE([TIME ][OVERshoot ][PREShoot ])][FALL([TIME ][OVERshoot ][PREShoot ])][MAXimum ][MINimum ][TMAXimum ][TMINimum ][MEAN][RMS][SDEViation ][PTPeak ][CYCLe([COUNt ][MEAN ][RMS ][SDEViation ])])6-6 Block Descriptions


1997 SCPI Data Interchange FormatIn the absence of a TRACe block, the following rules are used to determine the independent<strong>and</strong> dependent dimensions:1. The independent dimension is the first implicit dimension or, if no implicitdimensions are present, then the first explicit dimension2. The dependent dimension is the first explicit dimension if there is at least oneimplicit dimension. Otherwise it is the second explicit dimension.The block modifier value is optional <strong>and</strong> allows for the unique identification of theWAVeform block. No two WAVeform blocks may have the same within the sameDATA block.If WAVeform measurements are found together with a CURVe block in a DATA block,they are considered to be derived from or related to the CURVe data (or a subset of it).However, the exact relationship of waveform measurements to the data can be determinedonly if the TRACe keyword is present.It is permissible for a data set to contain waveform measurements without a DATA(CURVe)block, but DIMension blocks for the independent <strong>and</strong> dependent dimensions shall still bespecified.Waveform measurements derived from DATA block data are considered to have beenderived from the data after SCALe <strong>and</strong> OFFSet (specified in the DIMension block) havebeen applied. WAVeform measurements are derived from DIMension block units.Note that this st<strong>and</strong>ard requires the syntax for WAVeform data to be correct, but makes noclaim for the correctness or consistency of the data values. Keywords in the WAVeformblock are representative of terms generally used in the industry. Keyword descriptions aregeneral <strong>and</strong>, except where specifically provided (such as for HLMethod), no requirement forspecific calculation methods are claimed.The definitions for functions <strong>and</strong> settings within the waveform block are illustrated with thefollowing figure:Figure 6-1 Waveform Terminology12345678910111213141516171819202122Block Descriptions 6-7


1997 SCPI Data Interchange Format66.2.4.1 NOTE DIF03This is arbitrary text. Text should be human-readable.Value type is . Only one occurrence of the NOTE keyword is allowed <strong>and</strong> one valueis allowed.Example: NOTE “500 ps Reference Waveform”6.2.4.2 NAME DIF03This is an arbitrary name of the waveform measurement. Typically, NAME is moredescriptive than the WAVeform block modifier value <strong>and</strong> it does not have to beunique.Value type is . It is recommended that the string length be 32 characters or less.NAME may occur only once <strong>and</strong> only one value is allowed.Example: NAME “Frame bit”6.2.4.3 TRACe DIF03This is the TRACe from which the waveform parameters were extracted. TRACe allows asub-set of the data to be referenced.Value type is . Only values defined by a TRACe block modifier value areallowed.Only one occurrence of TRACe is allowed <strong>and</strong> only one value is allowed. The TRACereferenced shall be two-dimensional.Example: TRACe Y26.2.4.4 HLMethodThis notes the method used to determine the HIGH <strong>and</strong> LOW magnitudes.For IEEE 181 methods, HIGH becomes the more positve (less negative) <strong>and</strong> LOW becomesthe more negative (less positive) of the Top Magnitude <strong>and</strong> Base Magnitude values asdefined by IEEE 194, sections 3.2.1 <strong>and</strong> 3.2.2.Value type is . It is recommended that the string length be 32 characters or less. Thefollowing values are predefined:UNKNOWNUnknown or Unspecified. Default.MEAN Mean of Density Algorithm (IEEE 181, section 4.3.1.1)MODE Mode of Density Algorithm (IEEE 181, section 4.3.1.2)PEAK Peak Magnitude (IEEE 181, section 4.3.1.4)ABSOLUTEAbsolute, user-specified levelsExample: HLMethod “MEAN”6.2.4.5 HIGHIndicates the high magnitude.Value type is . Value is required if keyword is present. HIGH may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the dependent dimension (signal value).6-8 Block Descriptions


1997 SCPI Data Interchange FormatExample: HIGH 4.26.2.4.6 LOWThis is the low magnitude.Value type is . Value is required if keyword is present. LOW may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the dependent dimension (signal value).Example: LOW -0.216.2.4.7 REFerenceThe REFerence sub-block contains reference level information used to calculate otherparameters in the WAVeform block.6.2.4.7.1 HIGHIndicates the high or upper reference level for measurement of rise <strong>and</strong> fall time.Value type is . Value is required if keyword is present. HIGH may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the dependent dimension (signal value).Example: HIGH 4.812345676.2.4.7.2 LOWThis is the low or lower reference level for measurement of rise <strong>and</strong> fall time.Value type is . Value is required if keyword is present. LOW may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the dependent dimension (signal value).Example: LOW 0.38910116.2.4.7.3 MIDThis is the mid reference level for measurement of width, duty cycle, <strong>and</strong> period.Value type is . Value is required if keyword is present. MID may occur only once1213<strong>and</strong> only one value is allowed. Units are of the dependent dimension (signal value).Example: MID 3.3146.2.4.7.4 METHodThis is the reference method. Notes the method used to determine HIGH, LOW, <strong>and</strong> MIDREFerence level values.Value type is . It is recommended that the string length be 32 characters or less. Thefollowing values are predefined:151617UNKNOWNUnknown or unspecified (default).18RELATIVEReference levels are set according to percentages of amplitude 19given by:20high_percentage= (WAVeform(REFerence(HIGH))−WAVeform(LOW))∗100WAVeform(AMPLitude)21Block Descriptions 6-922


1997 SCPI Data Interchange Formatlow_percentage= (WAVeform(REFerence(LOW))−WAVeform(LOW))∗100WAVeform(AMPLitude)mid_percentage= (WAVeform(REFerence(MID))−WAVeform(LOW))∗100WAVeform(AMPLitude)ABSOLUTEReference levels set in absolute signal value units.6Example: METHod “RELATIVE”6.2.4.8 AMPLitudeWaveform amplitude. HIGH minus LOW.Value type is . Value is required if keyword is present. AMPLitude may occuronly once <strong>and</strong> only one value is allowed. Units are of the dependent dimension (signal value).Example: AMPLitude 4.036.2.4.9 PWIDthIndicates positive width. Duration from a positive mid-reference crossing followed by atleast one high-reference crossing to the following negative mid-reference crossing.Value type is . Value is required if keyword is present. PWIDth may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the independent dimension (time).Example: PWIDth 2.6E-76.2.4.10 NWIDthIndicates negative width. Duration from a negative mid-reference crossing followed by atleast one low-reference crossing to the following positive mid-reference crossing.Value type is . Value is required if keyword is present. NWIDth may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the independent dimension (time).Example: NWIDth 2.5E-76.2.4.11 PERiodThis is the repetition period. Duration from a mid-reference crossing (whether positive ornegative) followed by at least one high-reference crossing <strong>and</strong> at least one low-referencecrossing to the following mid-reference crossing in the same direction as the firstmid-reference crossing.Value type is . Value is required if keyword is present. PERiod may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the independent dimension (time).Example: PERiod l.602E-66.2.4.12 FREQuencyThis is the frequency. FREQuency is the reciprocal of PERiod.Value type is . Value is required if keyword is present. FREQuency may occuronly once <strong>and</strong> only one value is allowed. Units are the reciprocal of the PERiod units.6-10 Block Descriptions


1997 SCPI Data Interchange FormatExample: FREQuency l.87222E+96.2.4.13 PDUTycycle | DCYCleIndicates the positive dutycycle. Ratio of PWIDth to PERiod.Value type is . Value is required if keyword is present. PDUTycycle may occuronly once <strong>and</strong> only one value is allowed. Units are dimensionless.Example: PDUTycycle .486.2.4.14 NDUTycycleIndicates the negative dutycycle. Ratio of NWIDth to PERiod.Value type is . Value is required if keyword is present. NDUTycycle may occuronly once <strong>and</strong> only one value is allowed. Units are dimensionless.Example: NDUTycycle .526.2.4.15 RISEThis sub-block deals with the first rising transition of the waveform where rising is definedas increasing data values.6.2.4.15.1 TIMEThis is the rise time (positive going transition). The first time interval during which theinstantaneous amplitude of a waveform increases from the low reference point, REF (LOW),to the high reference point, REF (HIGH).Value type is . Value is required if keyword is present. TIME may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the independent dimension (time).6.2.4.15.2 OVERshootThis is the rising edge overshoot. The difference between the HIGH level <strong>and</strong> the positivepeak signal value to which the waveform initially rises expressed as a percentage of thewaveform amplitude.Value type is . OVERshoot may occur only once <strong>and</strong> only one value is allowed.Example: OVERshoot 20.56.2.4.15.3 PREShootThis is the rising edge preshoot. The difference between the LOW level <strong>and</strong> the negativepeak signal value to which the waveform initially falls expressed as a percentage of thewaveform amplitude.Value type is . PREShoot may occur only once <strong>and</strong> only one value is allowed.Example: PREShoot 1.26.2.4.16 FALLThis sub-block deals with the first falling transition of the waveform where falling is definedas decreasing data values.12345678910111213141516171819202122Block Descriptions 6-11


1997 SCPI Data Interchange Format66.2.4.16.1 TIMEIndicates the fall time (negative going transition). The first time interval during which theinstantaneous amplitude of a waveform decreases from the high reference point, REF(HIGH), to the low reference point, REF (LOW).Value type is . Value is required if keyword is present. TIME may occur onlyonce <strong>and</strong> only one value is allowed. Units are of the independent dimension (time).6.2.4.16.2 OVERshootThis is the falling edge overshoot. The difference between the LOW level <strong>and</strong> the negativepeak signal value to which the waveform initially falls expressed as a percentage of thewaveform amplitude.Value type is . OVERshoot may occur only once <strong>and</strong> only one value is allowed.Example: OVERshoot 12.626.2.4.16.3 PREShootThis is the falling edge preshoot. The difference between the HIGH level <strong>and</strong> the positivepeak signal value to which the waveform initially rises expressed as a percentage of thewaveform amplitude.Value type is . PREShoot may occur only once <strong>and</strong> only one value is allowed.Example: PREShoot 4.36.2.4.17 MAXimumThis is the maximum value of the entire waveform as specified by TRACe.Value type is . MAXimum may occur only once <strong>and</strong> only one value is allowed.Units are of the dependent dimension (signal value).Example: MAXimum 4.59036.2.4.18 MINimumThis is the minimum value of the entire waveform as specified by TRACe.Value type is . MINimum may occur only once <strong>and</strong> only one value is allowed.Units are of the dependent dimension (signal value).Example: MINimum -0.126.2.4.19 TMAXimumThis indicates the time of the first MAXimum value in the waveform as specified byTRACe.Value type is . TMAXimum may occur only once <strong>and</strong> only one value is allowed.Units are of the independent dimension (time).Example: TMAXimum 9.516.2.4.20 TMINimumThis indicates the time of the first MINimum value in the waveform as specified by TRACe.6-12 Block Descriptions


1997 SCPI Data Interchange FormatValue type is . TMINimum may occur only once <strong>and</strong> only one value is allowed.Units are of the independent dimension (time).Example: TMINinum 3.8766.2.4.21 MEANThis is the arithmetic mean. Mean value of the entire waveform as specified by TRACe.Value type is . MEAN may occur only once <strong>and</strong> only one value is allowed. Unitsare of the dependent dimension (signal value).Example: MEAN 2.0256.2.4.22 RMSThis is the root mean square. Root mean square value of the entire waveform as specified byTRACe.Value type is . RMS may occur only once <strong>and</strong> only one value is allowed. Unitsare of the dependent dimension (signal value).Example: RMS 12.36.2.4.23 SDEViationThis is the st<strong>and</strong>ard deviation. The st<strong>and</strong>ard deviation of the entire waveform as specified byTRACe.Value type is . SDEV may occur only once <strong>and</strong> only one value is allowed.Units are of the dependent dimension (signal value).Example: SDEVeviation 45.686.2.4.24 PTPeakThis is the waveform Peak-to-peak value. Peak-to-peak value of the entire waveform asspecified by TRACe. PTPeak is equivalent to the MAXimum minus the MINimum values.Value type is . PTPeak may occur only once <strong>and</strong> only one value is allowed.Units are of the dependent dimension (signal value).Example: PTPeak 4.56.2.4.25 CYCLeThe CYCLe sub-block specifies parameters dealing with a specified number of completecycles in the waveform as specified by the COUNt field.6.2.4.25.1 COUNtThis is the the cycle count representing the number of cycles used for MEAN, RMS, <strong>and</strong>SDEViation in the CYCLe sub-block. Cycle count evaluates to an integer representing thenumber of cycles over which the CYCLe parameters apply. Default value for COUNt is 1.If one complete cycle is not present, <strong>and</strong> COUNt is specified then the value should be zero.In this case, any related CYCLe parameters are meaningless.Value type is . COUNt may occur only once <strong>and</strong> only one value is allowed.12345678910111213141516171819202122Block Descriptions 6-13


1997 SCPI Data Interchange Format6Example: COUNt 106.2.4.25.2 MEANThis is the cycle arithmetic mean. This indicates the mean value of the waveform asspecified by COUNt.Value type is . MEAN may occur only once <strong>and</strong> only one value is allowed. Unitsare of the dependent dimension (signal value).Example: MEAN 2.0256.2.4.25.3 RMSThis is the cycle root mean square. It indicates the root mean square value of the waveformas specified by COUNt.Value type is . RMS may occur only once <strong>and</strong> only one value is allowed. Unitsare of the dependent dimension (signal value).Example: RMS 12.36.2.4.25.4 SDEViationThis is the cycle st<strong>and</strong>ard deviation. This indicates the st<strong>and</strong>ard deviation of the entirewaveform as specified by COUNt.Value type is . SDEV may occur only once <strong>and</strong> only one value is allowed.Units are of the dependent dimension (signal value).Example: SDEViation 45.686.2.5 MEASurement DIF03This is the measurement of one or more specified data points. This block contains data thatdoes not fit in other sub-blocks of the DATA block. A MEASurement block may occurmultiple times, but is not required.The MEASurement sub-block is defined as:DIF03measurement -> MEASurement [= ]([NOTE ][NAME ][UNITs ][TYPE ][TRACe ]{LOCation (LABel INDex )}*[VALues {,}*])6-14 Block Descriptions


1997 SCPI Data Interchange FormatThe block modifier value is optional <strong>and</strong> allows for the unique identification of theMEASurement sub-block. As all values are unique, no two MEASurementsub-blocks may have the same within the same DATA block.The TRACe keyword allows association of the measurement or point with an arbitrarysubset of DATA(CURVe) data.Measurements derived from DATA block data are considered to have been derived from thedata after SCALe <strong>and</strong> OFFSet (specified in the DIMension block) have been applied.126.2.5.1 NOTE 3DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “This data is retest of test 14”4566.2.5.2 NAME DIF03This is an arbitrary name of the measurement or point. NAME is typically more descriptive 7than the MEASurement block modifier <strong>and</strong> it does not have to be unique.Value type is . It is recommended that the string length be 32 characters or less.NAME may occur only once <strong>and</strong> only one value is allowed.Example: NAME “Trigger pattern 4”89106.2.5.3 UNITs DIF03This indicates units, such as Volts, Amps, Hz, etc without multipliers.11Value type is . It is recommended that the string length be 32 characters or less.These units may differ from those specified in other DIMension blocks since the valuesrepresented herein may be derived or ancillary values.Recommended units are those specified by IEEE 488.2 , thenull string, <strong>and</strong> UNKNOWN. The null string implies that the data has no dimensional units<strong>and</strong> UNKNOWN indicates that the units are unknown.12131415DIF02If the TRACe keyword is present, the UNITs value may differ from that of the trace. Onlyone occurrence of UNITs is allowed <strong>and</strong> only one value is allowed. If omitted, the units areas specified in the DIMension block.1617Example: UNITs A6.2.5.4 TYPE18DIF03This indicates the type of measurement or point.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of TYPE is allowed <strong>and</strong> only one value is allowed.The one defined type is:UNKNOWN Unknown (default)19202122Block Descriptions 6-15


1997 SCPI Data Interchange Format6Example: TYPE “UNKNOWN”6.2.5.5 TRACe DIF03This is the trace associated with the point(s). TRACe allows a sub-set of the data to bereferenced.Value type is . Only values defined by the TRACe block modifier value areallowed. Only one occurrence of TRACe is allowed <strong>and</strong> only one value is allowed. If thiskeyword is present, it determines which dimensions shall be included in the LOCationsub-block for MEASurement.Example: TRACe ADDR6.2.5.6 LOCationThis specifies the label <strong>and</strong> index for one independent dimension. This sub-block is optional<strong>and</strong> may occur multiple times. There shall be a LOCation sub-block with a label value foreach independent dimension present, or if a TRACe keyword is specified, then for eachindependent dimension in the specified trace.6.2.5.6.1 LABelThis is the label of the independent dimension.Value type is . Only values previously defined by a DIMension block modifier value are allowed <strong>and</strong> the dimension shall be implicit. LABel is required <strong>and</strong> mayoccur only once. Only one value is allowed.Example: LABel A16.2.5.6.2 INDexThis specifies the index for the point.Value type is . INDex is required <strong>and</strong> only one occurrence of INDex is allowed.Example: INDex 2746.2.5.7 VALuesThis indicates the data value(s).Value type is . VALues is optional <strong>and</strong> may occur only once. Multiple values areallowed.Example: VALues 25.3, 93.76-16 Block Descriptions


1997 SCPI Data Interchange Format6.2.6 DATA Block ExampleDATA (NOTE “File 1A-23”DELTa (DIMension=Y(SCALe 0.1OFFSet 12.3SIZE 4096)DATE 1988,9,2TIME 23,3,0.25)CURVe (NAME “”CTYPe CRC16VALue 23.2,14.5,16.02,12.0CSUM 45)WAVeform (NAME “19th Pulse”TRACe ZHLMethod “MODE”AMPLitude 3.902PWIDth 2.6E-7PDUTycycle 32.4RISE (TIME 2.8E-8)FALL (TIME 2.703E-8)REFerence (HIGH 5.85E-5LOW 5.14E-5MID 5.32E-5)RMS 6.4PTPeak 12.5)))6.3 DIMensionEach DIMension block describes one dimension of DATA(CURVe) data. A dimension maybe either explicit, in which case values are present in the DATA(CURVe) block, or implicit,in which case the values are not present, but are instead generated by a function. See 1.3 inthis section. The order in which dimensions appear determines the data ordering in theDATA block.The DIMension <strong>and</strong> ORDer blocks describe the logical structure <strong>and</strong> organization of data inthe DATA(CURVe) block. The ENCode block describes the physical representation orencoding of the data. The ORDer block describes the ordering of the dimensional dataelements in the DATA(CURVe) block. Together they provide the sufficient <strong>and</strong> necessaryinformation for correct extraction of the data.12345678910111213141516171819202122Block Descriptions 6-17


1997 SCPI Data Interchange Format6Whether a dimension is to be considered an independent or dependent dimension isdetermined by the TRACe block. In the absence of a TRACe block, the following simplerule is applied: if one or more implicit dimensions are present, they are considered to beindependent, <strong>and</strong> all explicit dimensions are considered to be dependent.A DIMension block is required for each dimension of the data (implicit <strong>and</strong> explicit). TheDIMension block is defined as:dimension -> DIMension = ([NOTE ][NAME ]TYPE {IMPLicit | EXPLicit}[SCALe ][OFFSet ][SIZE ]UNITs [encode])DIF03Each dimension is uniquely distinguished by its required block modifier value. Notwo DIMension blocks may have the same value. Dimension labels should be keptshort, yet meaningful.6.3.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “DS1C at test point 12”6.3.2 NAME DIF03This is an arbitrary name or description of the dimension. NAME is typically moredescriptive than the dimension block label.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of NAME is allowed <strong>and</strong> only one value is allowed.Example: NAME “DS1C Voltage/Amplitude”6.3.3 TYPE DIF03This indicates if the dimension is implicit or explicit.TYPE takes a specified enumerated set of values. TYPE is required, may occur only once,<strong>and</strong> takes one of the two following enumerated set values:IMPLicitEXPLicitExample: TYPE EXPL6-18 Block DescriptionsValues for this dimension are not in DATA(CURVe),but are derived from a linear function, y = mx + b.Values for this dimension are present in DATA(CURVe).TK053aDIF03DIF03


1997 SCPI Data Interchange Format6.3.4 SCALe DIF03Scaling factor to be applied to the dimension’s values in DATA(CURVe(VALues)).Value type is . Default value is 1.0. Only one occurrence of SCALe is allowed<strong>and</strong> only one value is allowed. The SCALe value may be overridden byDATA(DELTa(DIMension(SCALe))).SCALe is always applied to DATA(CURVe) data, but not to any other data, such asDATA(WAVeform).For implicit dimensions:X’ = (SCALe * i) + OFFSet i = 1 to SIZEFor explicit dimensions:X’ = (SCALe * X) + OFFSetwhere X is a value from DATA(CURVe(VALues)). Also see Section 5.6, ORDer.123456Example: SCALe 0.5E-276.3.5 OFFSet DIF03Offset factor to be applied to the dimension’s values in DATA(CURVe(VALues)).Value type is . Default value is zero. Only one occurrence of OFFSet is allowed<strong>and</strong> only one value is allowed. The OFFSet value may be overridden byDATA(DELTa(DIMension(OFFSet))).OFFSet is always applied to DATA(CURVe) data, but not to any other data, such asDATA(WAVeform).For implicit dimensions:X’ = (SCALe * i) + OFFSet i = 1 to SIZEFor explicit dimensions:X’ = (SCALe * X) + OFFSetX is a value from DATA(CURVe(VALues)).Example: OFFSet -1.0E-2891011121314156.3.6 SIZE 16DIF03This is the number of points or values in the dimension.Value is type . Only one occurrence of SIZE is allowed <strong>and</strong> only one value isallowed. The SIZE value may be overridden by DATA(DELTa(DIMension(SIZE))).The following two invariants hold:1. All explicit dimensions must have the same SIZE value.2. The product of the SIZE values of the implicit dimensionsmust equal the SIZE value of any explicit dimension.If SIZE is not specified for a dimension, it is assumed to be consistent with the aboveinvariants. It is an error if there is insufficient information to determine a dimension’s SIZE.For example, SIZE cannot be determined if two or more implicit dimensions do not specify a171819202122Block Descriptions 6-19


1997 SCPI Data Interchange Format6SIZE, nor can it be determined if two or more explicit dimensions specify different SIZEvalues.It is strongly recommended that SIZE be specified for all dimensions whenever possible.Example: SIZE 5126.3.7 UNITs DIF03This indicates units, such as Volts, Amps, Hz, etc. Multipliers are not allowed.Value type is . It is recommended that the string length be 32 characters or less.Recommended units are those specified by IEEE 488.2 , thenull string, <strong>and</strong> UNKNOWN. The null string implies that the data has no dimensional units<strong>and</strong> UNKNOWN indicates that the units are unknown or unspecified. UNITs is required <strong>and</strong>only one occurrence of UNITs is allowed.DIF02Example: UNITs “V”6.3.8 ENCodeAn ENCode sub-block may appear subordinate to a DIMension block. TheDIMension(ENCode) block keywords <strong>and</strong> sub-blocks are the same as the major ENCodeblock described in 6.4 in this section. They define data resolution, special range values, <strong>and</strong>encoding format for value type data.The scope of a DIMension(ENCode) block includes only the DATA(CURVe) block <strong>and</strong> theDIMension(ENCode) block itself. The scope of the major ENCode block includes all othervalues in the DATA block.Each keyword specified in a DIMension(ENCode) block overrides the correspondingkeyword in the major ENCode block,but only for the values in the DATA(CURVe) block forthe specific dimension.Only one ENCode block can be specified subordinate to a DIMension block. It is notrequired.6.3.9 DIMension Block ExampleDIM=X (NOTE “Procedure 12.8”NAME “DS3”TYPE EXPLicitUNITs “S”SCALe 1.0OFFSet 0.0SIZE 1024ENCode (NOTE “This ENCode block affects only X dimension values in theDATA(CURVe) block”FORMat INT16NVALue -327686-20 Block Descriptions


1997 SCPI Data Interchange FormatORANge 32767URANge -32767HRANge 32766LRANge -32766RESolution 1))6.4 ENCodeThe ENCode block addresses data resolution, special range values, <strong>and</strong> encoding format value type data.The scope of an ENCode block is determined by its hierarchical level in the data formatstructure. If the ENCode block is at the same level as DIMension blocks, it applies globallyto all data in the DATA blocks. A global encoding specification can, however, be overriddenon a dimension-by-dimension basis with an ENCode block that is subordinate to the12345particular dimension. A keyword specification at the higher level rules unless explicitlysuperceded by the same keyword at the subordinate level.Only one ENCode block can be specified at the same hierarchical level as DIMensionblocks, <strong>and</strong> only one ENCode block can be specified subordinate to a DIMension block.The ENCode block is not required at any hierarchical level. However, the specification ofHRANge <strong>and</strong> LRANge for all explicit dimensions is strongly recommended. The ENCodeblock is defined as:6789encode -> ENCode (10 TK055| INT8 | INT16 | INT32 | INT64| SFP32 | SFP64| SINT16 | SINT32 | SINT64| SUINT16 | SUINT32 | SUINT64| UINT8 | UINT16 | UINT32 | UINT64 }][NVALue ][RESolution ])[NOTE[ORANge[HRANge]]][FORMat[URANge[LRANge{ IFP32 | IFP64]]11121314151617If no ENCode block is specified, the default values for each keyword prevail. The ENCodeblock sub-blocks <strong>and</strong> keywords are:18196.4.1 NOTE DIF03This is arbitrary text. Value type is . Text should be human-readable. Only one 20occurrence of the NOTE keyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Not-a-number <strong>and</strong> plus <strong>and</strong> minus infinity do not follow the IEEE 488.2recommendation”2122Block Descriptions 6-21


1997 SCPI Data Interchange Format66.4.2 FORMatThis is the data encoding format for CURVe(VALue) data. value type is introducedby a pound sign followed by one or more decimal digit characters. See section 3.4.5. ASCIIrepresentation uses comma separated data.Specifying a block FORMat does not require that the values in DATA block be formatted as value type. Values may always be specified as .If the ENCode block is subordinate to a DIMension block, then FORMat applies only tovalues in DATA(CURVe(VALues)) for the particular dimension.FORMat takes a specified enumerated set of values. Only one occurrence of FORMat isallowed <strong>and</strong> only one of the following enumerated set values is allowed:ASCii Comma-separated dataIFP32 IEEE floating point, 32 bits.IFP64 IEEE floating point, 64 bits.INT8 IEEE 8-bit signed integer (default).INT16 IEEE 16-bit signed integer.INT32 IEEE 32-bit signed integer.INT64 IEEE 64-bit signed integer.SFP32 IEEE swapped floating point, 32 bits.SFP64 IEEE swapped floating point, 64 bits.SINT16 Swapped IEEE 16-bit signed integer.SINT32 Swapped IEEE 32-bit signed integer.SINT64 Swapped IEEE 64-bit signed integer.SUINT16 Swapped IEEE 16-bit unsigned integer.SUINT32 Swapped IEEE 32-bit unsigned integer.SUINT64 Swapped IEEE 64-bit unsigned integer.UINT8 IEEE 8-bit unsigned integer.UINT16 IEEE 16-bit unsigned integerUINT16.UINT32 IEEE 32-bit unsigned integerUINT32.UINT64 IEEE 64-bit unsigned integerUINT64.All signed integers are two’s complement. IEEE formats are defined by IEEE 488.2 BinaryInteger <strong>and</strong> Binary Unsigned Integer codes. “Swapped” means that the byte order (from lowto high address) is from least significant to most significant byte.For example, to transfer #H1234 as an INT16 (16-bit integer) across a byte orientedtransmission medium, transfer the first byte as 12 (hex) <strong>and</strong> the second byte as 34 (hex). Totransfer #H1234 as an SINT16 (swapped 16-bit integer), transfer the first byte as 34 (hex)<strong>and</strong> the second byte as 12 (hex).Similarly, to transfer #H12345678 as an INT32 (32-bit integer), transfer the bytes in theorder: 12 (hex), 34 (hex), 56 (hex), <strong>and</strong> 78 (hex). To transfer #H12345678 as an SINT32TK055TK055TK055TK055TK055TK055TK055TK055TK055TK055TK0556-22 Block Descriptions


1997 SCPI Data Interchange Format(32-bit swapped integer), transfer the bytes in the order: 78 (hex), 56 (hex), 34 (hex), <strong>and</strong>12 (hex).Example: FORMat INT166.4.3 NVALueThis is the numeric value (before application of SCALe <strong>and</strong> OFFSet) that is to be treated asimplying “not a number” or “no value recorded” for values in the DATA block.12Value type is . Only one occurrence of NVALue is allowed <strong>and</strong> only one value isallowed. If NVALue is not present, no not-a-number value is defined for integer formats. ForIEEE floating point formats, no NVALue is ever specified. In this case, NVALue is asdefined by IEEE 754 for not-a-number. For ASCII, the default value is 9.91E+37.Example: NVALue 99996.4.4 ORANgeThis indicates the numeric value (before application of SCALe <strong>and</strong> OFFSet) that is to betreated as over range for values in the DATA block.Value type is . Only one occurrence of ORANge is allowed <strong>and</strong> only one value isallowed. If ORANge is not present, no over range value is defined for integer formats. ForIEEE floating point formats, no ORANge is ever specified. In this case, ORANGe is asdefined by IEEE 754 for plus infinity. For ASCII, the default value is 9.9E+37.Example: ORANge #H7FFF6.4.5 URANgeThis is the numeric value (before application of SCALe <strong>and</strong> OFFSet) that is to be treated asunder range for values in the DATA block.Value type is . Only one occurrence of URANge is allowed <strong>and</strong> only one value isallowed. If URANge is not present, no under range value is defined for integer formats. ForIEEE floating point formats, no URANge is ever specified. In this case, URANGe is asdefined by IEEE 754 for negative infinity. For ASCII, the default value is -9.9E+37.Example: URANge -3276734567891011121314156.4.6 HRANge 16DIF03This is the greatest signed value (before application of SCALe <strong>and</strong> OFFSet) that may bepresent in the DATA(CURVe(VALUE)).Value type is . Only one occurrence of HRANge is allowed <strong>and</strong> only one value isallowed. The value specified shall be at least as great as the greatest value present in the databut may be greater.NVALue, ORANge, <strong>and</strong> URANge values are not considered when determining range. Unitsare the measurement curve units after SCALe <strong>and</strong> OFFSet are applied to the data.Example: HRANge 327661718192021Block Descriptions 6-2322


1997 SCPI Data Interchange Format66.4.7 LRANgeThis is the least value (before application of SCALe <strong>and</strong> OFFSet) that may be present inDATA(CURVe(VALUE)).Value type is . Only one occurrence of LRANge is allowed <strong>and</strong> only one value isallowed. The value specified shall be at least as small as the least value present in the databut may be less.NVALue, ORANge, <strong>and</strong> URANge values are not considered when determining range. Unitsare the measurement curve units after SCALe <strong>and</strong> OFFSet are applied to the data.Example: LRANge -327666.4.8 RESolutionThis is the minimum resolution of data values present in the DATA block.Value type is . Only one occurrence of RESolution is allowed <strong>and</strong> only onevalue is allowed.Units are the measurement curve units after SCALe <strong>and</strong> OFFSet are applied to the data.Example: RESolution 16.4.9 ENCode Block ExampleENCode (NOTE “Acquisition resolution was 10 bits”FORMat INT16NVALue -32768ORANge 32767URANge -32767HRANge 32766LRANge -32766RESolution 1)6.5 IDENtifyThis is the IDENtify block contains fields uniquely identifying the data <strong>and</strong> describing theenvironment in which it was created or acquired. The precise definitions for the contents ofall text string values in the IDENtify block is left to the creator of the data set. However, thegeneral category shall be followed.The IDENtify block may occur only once, but is not required. The IDENtify block is definedas:6-24 Block Descriptions


1997 SCPI Data Interchange Formatidentify -> IDENtify ([NOTE[NAME[TECHnician[PROJect[DATE)[TIME[UUT([NAME[ID[DESign)][TEST([NAME[SERies[NUMBer)][HISTory]] {,}*]],,[,,,]],,[,,,]]] {,}*] {,}*]]] {,}*] {,}*]DIF031DIF062DIF0636.5.1 NOTE 10DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “24 AWG may have been out of calibration”1112136.5.2 NAME DIF03This is the user-defined name identifying the data set. NAME is typically more descriptive 14than the block modifier.Value type is . It is recommended that the string length be 32 characters or less.This field is optional. Only one occurrence of the NAME keyword is allowed. Only one1516value is allowed.Example: NAME “Spectral Power Test”176.5.3 TECHnicianThis identifies the technician(s) involved in the generation or modification of the data.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of the TECHnician keyword is allowed. Multiple values, up to 7, areallowed.Example: TECHnician “John H. Doe”1819202122Block Descriptions 6-25456789


DIF06DIF061997 SCPI Data Interchange Format66.5.4 PROJectThis is the name of project, job, task, etc.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of PROJect is allowed <strong>and</strong> only one value is allowed.Example: PROJect “S27A408”6.5.5 DATE DIF03This is the date of data creation or acquisition.This keyword takes a set of three comma separated value types to specify the datecorresponding to year, month, <strong>and</strong> day.The years parameter is type . It always includes century <strong>and</strong> millennium information.DIF06DIF06The months parameter is type . Its range is 0 to 12.DIF06The days parameter is type . Its range is 0 to 31 (depending on the month).DIF06If two sets of values are specified, they define an inclusive range of dates.DIF06Example: DATE 1776,07,04 indicates the 4th of July, 1776DIF066.5.6 TIME DIF03This is the time of data creation or acquisition.DIF03,06This keyword takes a set of three comma separated value types to specify the timecorresponding to hour, minute, <strong>and</strong> second.The hours parameter is type . Its range is 0 to 23. This parameter is alwaysexpressed in 24 hour format.The minutes parameter is type . Its range is 0 to 59.The seconds parameter is type . Its range is 0 to 60 for instruments receivingdata <strong>and</strong> 0 to 59.999... for instruments sending data.If two sets of values are specified, they define an inclusive range of time.Example: TIME 23,59,59 indicates one second before midnight.6.5.7 UUTThis is a description of the “unit under test”. This block may occur only once.DIF06DIF06DIF06DIF06DIF066.5.7.1 NAME DIF03This is the name or type of unit under test. NAME is similar in use to ID, except that it istypically more descriptive <strong>and</strong> only one value is allowed.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of the NAME keyword is allowed <strong>and</strong> only one value is allowed.Example: NAME “Model 29AP402”6-26 Block Descriptions


1997 SCPI Data Interchange Format6.5.7.2 IDThis is the identification of the unit under test.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of the ID keyword is allowed. Multiple values, up to 7, per keyword areallowed.1Example: ID “AA32303”,“B7”26.5.7.3 DESignThis identifies the design specification.3Value type is . It is recommended that the string length be 32 characters or less. 4Only one occurrence of the DESign keyword is allowed. Multiple values, up to 7, areallowed.5Example: DESign “2W32 Rev 3C”66.5.8 TESTThis is the test description. This block may occur only once.76.5.8.1 NAME 8DIF03This is the test series name.Value type is . It is recommended that the string length be 32 characters or less. 9Only one occurrence of the NAME keyword is allowed <strong>and</strong> only one value is allowed.10Example: NAME “DC Parametrics”116.5.8.2 SERiesThis is the number or id of test series.12Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of SERies is allowed <strong>and</strong> only one value is allowed.13Example: SERies “24B208”146.5.8.3 NUMBer15This is the number or id of particular test.Value type is . It is recommended that the string length be 32 characters or less. 16Only one occurrence of the NUMBer keyword is allowed. Multiple values, up to 7, are17allowed.Example: NUMBer “A3”,“B6”,“B7”186.5.9 HISTory19This is the derivation history of the data set, such as names of tests, instruments, instrumentsystems, <strong>and</strong> software packages.20Value type is . It is recommended that the string length be 32 characters or less.21Only one occurrence of the HISTory keyword is allowed. Multiple values, up to 7, areallowed <strong>and</strong> imply an ordering from oldest to most recent.22Block Descriptions 6-27


1997 SCPI Data Interchange FormatExample: HISTory “T24.WFM”, “CCITT DS3 Template”6.5.10 IDENtify Block Example6IDENtify (NOTE “This IDENtify block example contains examples of all keywords”NAME “”TECHnician “Matt Wilson”PROJect “Acorn”DATE 1988,9,2TIME 23,3,0.25UUT (NAME “Ironman”ID “007”DESign “Rev D”)TEST (NAME “Cal Menu”SERies “3A”NUMBer “5”)HISTory “Tinman”, “Strawman”)6.6 ORDerThe ORDer block defines the physical layout of data within the DATA(CURVe) block. Datamay be ordered as n-tuples, in which the data for each explicit dimension is “inter-mixed”.This is also called row order. Data may also be ordered by dimension. When ordered bydimension, all data for each dimension is grouped consecutively, with all data for onedimension followed by all data for the next dimension. This is also called column order.When more than one implicit dimension exists, the first implicit dimension index alwaysincrements the slowest <strong>and</strong> the last implicit dimension index always increments the fastest.The ORDer block may occur only once, but is not required. If omitted, the default values forits keywords prevail. The ORDer block is defined as:order -> ORDer ([NOTE[BY)]{TUPLe | DIMension}]TK052DIF036.6.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Most important first”6.6.2 BYThis indicates if the ordering is by tuple or dimension.6-28 Block Descriptions


1997 SCPI Data Interchange FormatBY takes a specified enumerated set of values. BY may occur only once, <strong>and</strong> takes one ofthe two following enumerated set values:TUPLeData values are organized by n-tuple (default).DIMensionData values are organized by dimension.6.6.3 ExamplesSuppose the sample measurements in the following example were made according to thescenario of 1.3 of this section. The data has five dimensions. Assume also that the fiveDIMension blocks have label values corresponding to the headings in as shown below.Sample MeasurementsX Y Z Temp Hum5 1 8.1 18.1 615 2 9.2 20.2 627 1 6.3 16.3 637 2 3.4 16.4 649 1 8.5 18.5 659 2 3.6 16.6 66Example 1:If all values are present in the data, the five DIMension blocks will have TYPE EXPLicit(see 6.3 in this section). If no ORDer block is present, the data will be ordered:HUM, TEMP, X, Y, Z, HUM, TEMP, X, Y, Z ...That is, the data is ordered by 5-tuple <strong>and</strong> by column order of occurrence within a 5-tuple.Note that the rows may appear in any order since there are no implicit dimensions.The DIMension <strong>and</strong> DATA blocks for this example are:DIMension=HUM (TYPE EXPLicitSIZE 6UNITs “PCT”ENCode (HRANge 60LRANge 66))DIMension=TEMP (TYPE EXPLicitSIZE 6UNITs “CEL”ENCode (HRANge 25LRANge 15))DIMension=X (TYPE EXPLicitSIZE 6DIF0312345678910111213141516171819202122Block Descriptions 6-29


1997 SCPI Data Interchange Format6UNITs “M”ENCode (HRANge 9LRANge 5))DIMension=Y (TYPE EXPLicitSIZE 6UNITs “M”ENCode (HRANge 2LRANge 1))DIMension=Z (TYPE EXPLicitSIZE 6UNITs “M”ENCode (HRANge 10LRANge 0))DATA (CURVe (VALues 61, 18.1, 5, 1, 8.1,64, 16.4, 7, 2, 3.4,65, 18.5, 9, 1, 8.5,66, 16.6, 9, 2, 3.6,62, 20.2, 5, 2, 9.2,63, 16.3, 7, 1, 6.3))Example 2:If the coordinate values for the X <strong>and</strong> Y dimensions are omitted from the data, thesedimensions are implicit (TYPE is IMPLicit).The X <strong>and</strong> Y dimensions are easily derived by linear functions:x = 2m + 3y = nwhere m <strong>and</strong> n are indices related to the ordering of the values for Z, TEMP, <strong>and</strong> HUM.The DIMension <strong>and</strong> DATA blocks for this example are:DIMension=TEMP (TYPE EXPLicitSIZE 6UNITs “CEL”ENCode (HRANge 25LRANge 15))DIMension=X(TYPE IMPLicitSIZE 3TK0526-30 Block Descriptions


HP01997 SCPI Data Interchange FormatUNITs “M”SCALe 2OFFSet 3)DIMension=Y(TYPE IMPLicitSIZE 2UNITs “M”)DIMension=Z (TYPE EXPLicitSIZE 6UNITs “M”ENCode (HRANge 10LRANge 0))DIMension=HUM (TYPE EXPLicitSIZE 6UNITs “PCT”ENCode (HRANge 60LRANge 66))DATA (CURVe (VALues 18.1, 8.1, 61,20.2, 9.2, 62,16.3, 6.3, 63,16.4, 3.4, 64,18.5, 8.5, 65,16.6, 3.6, 66))Note that the humidity DIMension now appears last <strong>and</strong> that DATA values in the DATAblock are therefore in a different order. The reordering of the X <strong>and</strong> Y DIMension blocksaffects only the default determination of the independent <strong>and</strong> dependent dimensions (seechapter 6.3). In this second example, the presence of implicit dimensions forces a requiredrow order on the VALUes values.6.7 REMarkThis block is for information not fitting elsewhere.The REMark block may occur only once, but is not required. The REMark block is definedas:remark ->REMark([NOTE) {,}*]12345678910111213TK0533a 1415161718DIF0319202122Block Descriptions 6-31


1997 SCPI Data Interchange Format6.7.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed. Multiple values are allowed <strong>and</strong> no ordering is implied.Example: NOTE “The REMark block is the appropriate place for observations <strong>and</strong>annotations about the data, its acquisition, creation, or modification. In general, its a place tostuff technical information.”6.7.2 REMark Block ExampleREMark (NOTE “A remarkable data structure”)66.8 DIFThe DIF block is the first block in a dif data set. It uniquely defines the expression data asbeing a dif data set with the beginning DIF character sequence. The DIF block providesversion information to assist the parser in determining compatibility. It further defines thescope of the data set.The DIF block may occur only once <strong>and</strong> is required. The DIF block is defined as:difid ->DIF([NOTEVERSion[SCOPe)]PREamble | FULL]TK053aDIF01,03TK032A6.8.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “First Version”6.8.2 VERSionThe DIF(VERSion) number exactly tracks the SCPI SYSTem:VERSion number (Comm<strong>and</strong>Reference, 21.20) <strong>and</strong> correlates changes <strong>and</strong> extensions in the DIF volume with the rest ofSCPI.Note: The DIF(VERSion) keyword was new in 1994.0 <strong>and</strong> was created as a part of aone-time major restructuring <strong>and</strong> simplification of DIF. DIF parsers designed prior to 1994will not be compatible with 1994.0 <strong>and</strong> following versions.Value type is . Only one value is allowed. Only one occurrence of VERSion isallowed.Note that while version numbers increase in value in time sequence, lesser version numberswill not necessarily be guaranteed to be fully compatible.TK053a6-32 Block Descriptions


1997 SCPI Data Interchange FormatExample: VERSion 1993.06.8.3 SCOPeThis indicates the scope of the DIF block.SCOPe takes a specified enumerated set of values. SCOPe may occur only once <strong>and</strong> takesone of the two following enumerated set values:TK032ATK032ATK032A1When SCOPe is set to PREamble, the DIF block omits the following data:TK032A 2dif blocks of waveform, measurement, <strong>and</strong> delta.TK032A3dif curve block keywords VALues <strong>and</strong> CSUM <strong>and</strong> their parameters.TK032A4The various notes <strong>and</strong> identification parameters may be sent if absolutely required.TK032AWhen SCOPe is set to FULL, a complete dif data set as described in Section 4.3 is present(default).TK053a 56Example: SCOPe PREambleTK032A76.8.4 DIF Block Example DIF01DIF (8DIF01NOTE “Third revision of st<strong>and</strong>ard”DIF01VERSion 1993.0)9DIF016.9 TRACe 10DIF03TRACe blocks describe logical relationships among all or some of the dimensions. Theymay define functions, curves, surfaces, or arbitrary sets or data groupings. They also provide 11a convenient means of describing subsets of the data. The windowing effect of the TRACeblocks may, for example, be used to make two-dimensional “cuts” throughthree-dimensional data. Other blocks, such as the VIEW block, build on TRACe blocks.TRACe block information is built from DIMension blocks; VIEW blocks are built fromTRACe block information.If no TRACe block is present, the independence or dependence of a dimension is determinedby rules described in 6.3 in this section.12131415The TRACe block is optional <strong>and</strong> multiple TRACe blocks are allowed. The TRACe block is DIF0316defined as:trace -> TRACe = ([SYMMetry ]{INDependent([STOP ])}*{DEPendent([NOTELABel][NAME[STARt]]171819202122Block Descriptions 6-33


1997 SCPI Data Interchange Format)LABel)}*6The TRACe block modifier value is required. It provides for the uniqueidentification of the TRACe block. As for the entire data set are unique, no twoTRACe blocks may have the same .Explicit <strong>and</strong> implicit, as applied to dimensions, are distinguished from independent <strong>and</strong>dependent as follows. Implicit <strong>and</strong> explicit are concerned with how the data is physicallyrepresented <strong>and</strong> structured. Independent <strong>and</strong> dependent relate to how a dimension isinterpreted.6.9.1 NOTE DIF03This is arbitrary text.Value type is . Text should be human-readable. Only one occurrence of the NOTEkeyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Values generated pursuant to 12A34D”6.9.2 NAME DIF03This is an arbitrary name or description of the trace.Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of NAME is allowed <strong>and</strong> only one value is allowed.Example: NAME “Gain”6.9.3 SYMMetryThis specifies the type of symmetry on a per dimension basis. Only one occurrence ofSYMMetry is allowed.Value type is . It is recommended that the string length be 32 characters or less. Thefollowing values are predefined:UNKNOWNSymmetry is unknown. (default)NONENo symmetry.PEVEN Positive <strong>and</strong> even symmetry.NEVEN Negative <strong>and</strong> even symmetry.PODDPositive <strong>and</strong> odd symmetry.NODDNegative <strong>and</strong> odd symmetry.Example: SYMMetry “UNKNOWN”6.9.4 INDependentThis identifies one independent dimension that constitutes the trace. If independence <strong>and</strong>dependence are not meaningful, the trace should be defined using the INDependent block.This sub-block may occur multiple times.6-34 Block Descriptions


1997 SCPI Data Interchange FormatSTARt <strong>and</strong> STOP parameters represent integer values referring to indexes on implicitdimensions <strong>and</strong> therefore apply only to implicit dimensions6.9.4.1 LABelThis is the label of the independent dimension.Value is of type . Only values defined by the DIMension block label are allowed.LABel is required <strong>and</strong> may occur only once. Only one value is allowed.12Example: LABel X6.9.4.2 STARt3DIF03This specifies the starting index (inclusive).Value is of type . Only one occurrence of STARt is allowed <strong>and</strong> only one value isallowed. This keyword may be present only if the dimension is implicit.If STARt is omitted, then the default value is 1. If the index value is greater than thedimension’s SIZE value (from the applicable DIMension or DATA(DELTa(DIMension))block), then an error is reported.Example: STARt 12456786.9.4.3 STOP DIF03This specifies the ending index (inclusive).9Value is of type . Only one occurrence of STOP is allowed <strong>and</strong> only one value isallowed. This keyword may be present only if the dimension is implicit.If STOP is omitted then SIZE is used. If the index value is greater than the dimension’s SIZEvalue (from the applicable DIMension or DATA(DELTa(DIMension)) block), then an erroris reported.If the stopping index value is less than the starting index value then an error is reported.Example: STOP 9826.9.5 DEPendentThis identifies a dependent dimension that constitutes the trace. This sub-block may occurmultiple times.6.9.5.1 LABelThis is the label of the dependent dimension.Value is of type . Only values defined by the DIMension block label are allowed.LABel is required <strong>and</strong> may occur only once. Only one value is allowed.Example: LABel Y1011121314151617181920Block Descriptions 6-352122


1997 SCPI Data Interchange Format66.9.6 TRACe Block ExampleTRACe=TEMP (NOTE “Missing values were interpolated”NAME “Transient acceleration”SYMMetry “UNKNOWN”INDependent (LABel XSTARt 1STOP 10)INDependent (LAB YSTARt 100STOP 200)INDependent (LABel ZSTARt 2STOP 4)DEPendent (LABel A))DIF026.10 VIEW DIF03VIEW blocks provide semantic information about the data in DATA(CURVe). With aVIEW block, one can show relationships between <strong>and</strong> among subsets of the data as definedby TRACe blocks. For example, a complex waveform or surface can be easily defined, ascan a waveform <strong>and</strong> its upper <strong>and</strong> lower envelopes.The VIEW block builds on traces described in a TRACe block. A trace commonly defines asimple function, but the data format allows for the definition of sets, surfaces <strong>and</strong> othercomplex functions.For example, a time varying envelope might be described by three DIMension blocks. Thetwo explicit dimensions define the two Y-axis values for the upper <strong>and</strong> lower components ofthe envelope. The implicit dimension defines the common X-axis. While the organizationalstructure of the data is defined by the DIMension <strong>and</strong> ORDer blocks, its meaning isdetermined by a VIEW block. It is the view block that identifies which dimension is theupper envelope <strong>and</strong> which is the lower.Alternatively, the same data could be viewed as a complex waveform. The DIMensionblocks would be the same, but a VIEW block would identify which dimension is the realcomponent <strong>and</strong> which is the complex component.The VIEW block is optional <strong>and</strong> multiple VIEW blocks are allowed. The VIEW block isdefined as:DIF036-36 Block Descriptions


1997 SCPI Data Interchange Formatview -> VIEW = ([NOTE[NAME{ENVelope(UPPerLOWer[FUNCtion)}*{RCOMplex(REALIMAGinary)}{PCOMplex(MAGNitudePHASe)})]]]HP091The modifier label is required. It provides for the unique identification of the VIEW block.8As all elements are unique, no two VIEW blocks may have the same label.A VIEW block takes the following sub-blocks. Except for NAME <strong>and</strong> NOTE, only one type 9of the other sub-blocks may be present:106.10.1 NOTE DIF03This is arbitrary text.11Value type is . Text should be human-readable. Only one occurrence of the NOTE12keyword is allowed <strong>and</strong> only one value is allowed.Example: NOTE “Template defines the max <strong>and</strong> min values for calibrating mil spec 1397654-D”146.10.2 NAME DIF03This is the name of the view. NAME is typically more descriptive than the VIEW block 15label <strong>and</strong> does not need to be unique.16Value type is . It is recommended that the string length be 32 characters or less.Only one occurrence of NAME is allowed <strong>and</strong> only one value is allowed.17Example: NAME “97654-D”186.10.3 ENVelopeThis identifies which two traces constitute the envelope for a third in DATA(CURVe) data. 19Multiple occurrences of ENVelope are allowed.20Block Descriptions 6-3712345672122


1997 SCPI Data Interchange Format66.10.3.1 UPPerThis specifies the name of the upper envelope trace.Value type is <strong>and</strong> is restricted to a value defined by a TRACe block modifier value. Only one occurrence of UPPer is allowed <strong>and</strong> only one value is allowed.Example: UPPer YH6.10.3.2 LOWerThis specifies the name of the lower envelope trace.Value type is <strong>and</strong> is restricted to a value defined by a TRACe block modifier value. Only one occurrence of LOWer is allowed <strong>and</strong> only one value is allowed.Example: LOWer YL6.10.3.3 FUNCtionThis specifies the set of data being enveloped.Value type is <strong>and</strong> is restricted to a value defined by a TRACe block . Onlyone occurrence of FUNCtion is allowed <strong>and</strong> only one value is allowed.Example: FUNCtion Y6.10.4 RCOMPlexThis identifies which two TRACes constitute a rectangular complex waveform. RCOMPlexmay only occur once.6.10.4.1 REALThis specifies the name of the real trace.Value is of type . Only values defined by the TRACe block are allowed. REAL isrequired <strong>and</strong> may occur only once. Only one value is allowed.Example: REAL S11REAL6.10.4.2 IMAGinaryThis specifies the name of the imaginary trace.Value is of type . Only values defined by the TRACe block are allowed. IMAGinaryis required <strong>and</strong> may occur only once. Only one value is allowed.Example: IMAGinary S11IMAG6.10.5 PCOMplexThis identifies the which two TRACes constitute a polar complex waveform. PCOMplexmay only occur once.6.10.5.1 MAGNitudeThis specifies the name of the magnitude trace.Value is of type . Only values defined by the TRACe block are allowed.MAGNitude is required <strong>and</strong> may occur only once. Only one value is allowed.HP091HP091HP091HP091HP091HP091HP091HP091HP091HP091HP091HP091HP091HP091HP0916-38 Block Descriptions


1997 SCPI Data Interchange FormatExample: REAL S11MAG6.10.5.2 PHASeThis specifies the name of the phase trace.Value is of type . Only values defined by the TRACe block are allowed. PHASe isrequired <strong>and</strong> may occur only once. Only one value is allowed.Example: PHASe S11PHASE6.10.6 VIEW BLOCK EXAMPLEVIEW=T3_J4 (NOTE “Mil spec 97654-D replaces 54679-D”NAME “Mil spec 97654-D”ENV (UPPer YHLOWer YL))HP091HP091HP091HP0911HP091 2345678910111213141516171819202122Block Descriptions 6-39


1997 SCPI Data Interchange Format66-40 Block Descriptions


1997 SCPI Data Interchange Format7 Data Format ExampleThe following data set exemplifies the use of several related blocks in the data interchangeformat. The example below is shown encapsulated in parentheses; that is, as a.( DIF (VERsion 1993.0)IDENtify (DATE 1993,4,23TIME 16,4,14.23)ENCode (FORMat INT8HRANge 127LRANge -128)DIMension=YH (TYPE EXPLicitSCALe 2.000000E-002OFFSet -3.500000E-001SIZE 512UNITs "V")DIMension=YL (TYPE EXPLicitSCALe 2.000000E-002OFFSet -3.500000E-001SIZE 512UNITs "V")DIMension=X (TYPE IMPLicitSCALe 2.000000E-005OFFSet -1.024000E-002SIZE 512UNITs "s")TRACe=H (INDependent(LABel X)DEPendent(LABel YH))TRACe=L (INDependent(LABel X)DEPendent (LABel YL))VIEW=ENV1 (ENVelope (UPPer HLOWer L))1DIF0123DIF06DIF0645678910111213141516171819202122Data Format Example 7-1


1997 SCPI Data Interchange Format7DATA (CURVe (VALue #41024{1024 8-bit significant bytes of data goes here}CSUM 139))WAVeform (TRACe HRISE (TIME 1.04E-003)FALL (TIME 0.86E-003)))In this example, we have a data set that follows the 1993.0 version of SCPI <strong>and</strong> is dated atabout 4 PM on April 23rd, 1993. The data is encoded as 8-bit signed integers ranging from-128 to 127 <strong>and</strong> is presented as a sequence of 512 byte pairs representing two voltage signallevels (YH <strong>and</strong> YL). The raw bit values must be multiplied by .02 with .35 subtracted toyield the measured value in Volts. The first data pair occurred at a measured time (X) of (20- 10,240 microseconds) or -10.22 milliseconds. Subsequent data pairs were recorded at 20microsecond intervals.Two traces (H <strong>and</strong> L) are specified with YH <strong>and</strong> YL voltage levels as the dependentvariables <strong>and</strong> time as the independent variable. The traces can be viewed as envelope-typedata <strong>and</strong> referred to as ENV1. The data itself is formatted in IEEE 488.2 block format (1024bytes long) <strong>and</strong> its integrity can be verified by computing a 16-bit cyclic redundancy check<strong>and</strong> comparing the results to the stated (CSUM) value of 139.Finally, the rise <strong>and</strong> fall times of the H trace have been computed <strong>and</strong> recorded in the dataset as 1.04 milliseconds <strong>and</strong> 0.86 milliseconds.DIF01,06HP0727-2 Data Format Example


IndexAAMPLitude 6-10Bblock 3-3definition 3-2unrecognized 4-6block modifier 3-2BY 6-28CCCITT 6-5character set 3-1COUNt 6-13CRC16 6-5CSUM 6-5CTYPe 6-4CURVe 6-4CYCle block 6-13DDATA block 6-1data formatexample 7-1extension 5-1overview 1-1Data Interchange Format 1-2DATEDELTa block 6-3, 6-26DELTa block 6-2DEPendent 6-35DESign 6-27DIF block 6-32 1-1dimension 6-29explicit 1-2implicit 1-2DIMension block 6-3, 6-17EENCode block 6-21DIMension block 6-20enumerated setdefinition 3-4errors 2-1ENVelope 6-37EXPLicit 6-18FFALL block 6-11FREQuency 6-10FUNCtion 6-38Ggrammarnotation 4-1required blocks 4-6required order 4-6unrecognized blocks 4-6unrecognized keywords 4-6HHIGHREFerence block 6-9WAVeform block 6-8HISTory 6-27HLMethod 6-8HRANge 6-23IID 6-27IDENtify block 6-24IFP32 6-22IFP64 6-22IMPlicit 6-18INDependent 6-34INDex 6-16INT16 6-22INT32 6-22INT64 6-22INT8 6-22Index - 1


1997 SCPI Data Interchange FormatKkeyworddefault values 2-1definition 3-2errors 2-1multiple values 2-1unrecognized 4-6L 3-3DEPendent block 6-35INDependent block 6-35LOCation block 6-16LOCation block 6-16LOWREFerence block 6-9WAVeform block 6-9LOWer 6-38LRANge 6-24MMAXimum 6-12MEANCYCLe block 6-14WAVeform block 6-13MEAsurement block 6-14METHod 6-9MID 6-9MINimum 6-12NNAMECURVe block 6-4DIMension block 6-18IDENtify block 6-25MEASurement block 6-15TEST block 6-27TRACe block 6-34UUT block 6-26VIEW block 6-37WAVeform block 6-8NDUTycycle 6-11NOTECURVe block 6-4DATA block 6-2DELTa block 6-2DIF block 6-32DIMension block 6-18ENCode block 6-21IDENtify block 6-25MEASurement block 6-15ORDer block 6-28REMark block 6-32TRACe block 6-34VIEW block 6-37WAVeform block 6-8NUMBer 6-27 3-2—3-3 3-2 3-3NVALue 6-23NWIDth 6-10OOFFSetDIMension block 6-3, 6-19ORANge 6-23ORDer block 6-28OVERshootFALL block 6-12RISE block 6-11PPDUTycycle 6-11PERiod 6-10PREShootFALL block 6-12RISE block 6-11PROJect 6-26PTPeak 6-13PWIDth 6-10RREFerence block 6-9REMark block 6-31RESolution 6-24RISE block 6-11RMSCYCLe block 6-14WAVeform block 6-13SSCALeDIMension block 6-3, 6-19Scope 6-33SDEViationIndex - 2


1997 SCPI Data Interchange FormatCYCLe block 6-14WAVeform block 6-13SERies 6-27SFP32 6-22SFP64 6-22SINT16 6-22SINT32 6-22SINT64 6-22SIZEDIMension block 6-3, 6-19STARt 6-35STOP 6-35 3-3SUINT16 6-22SUINT32 6-22SUINT64 6-22SUM16 6-5SUM8 6-5SYMMetry 6-34syntaxblock 3-2block modifier 3-2character set 3-1keyword 3-2overview 3-1value types 3-2white space 3-1TTECHnician 6-25TEST block 6-27TIMEDELTa block 6-3, 6-26FALL block 6-12RISE block 6-11TMAXimum 6-12TMINimum 6-12TRACeMEASurement block 6-16WAVeform block 6-8TRACe block 6-33TUPle 6-29TYPEDIMension block 6-18MEASurement block 6-15MEASurement block 6-15UPPer 6-38URANge 6-23UUT block 6-26Vvalue type 3-3 3-2 3-3 3-3 3-3 3-3 3-3 3-2 3-3enumerated set 3-4VALuesCURVe block 6-5MEASurement block 6-16VERSion 6-32VIEW block 6-36WWAVeform block 6-5white space 3-1UUINT8 6-22UNITsDIMension block 6-20Index - 3


St<strong>and</strong>ardComm<strong>and</strong>s forProgrammableInstruments(SCPI)<strong>Volume</strong> 4: Instrument ClassesVERSION 1997.0May, 1997Printed in U.S.A.


NOTICE, STATEMENT of INTENT<strong>and</strong>AUTHORIZATION TO COPY© Copyright 1997 SCPI ConsortiumThis document defines the St<strong>and</strong>ard-Comm<strong>and</strong>s-for-Programmable-Instruments (SCPI) Consortium’sSCPI st<strong>and</strong>ard. Although the Consortium hereby expressly disclaims any <strong>and</strong> all warranties whatsoeverregarding the SCPI st<strong>and</strong>ard, the Consortium has published this document with the intent that the SCPIst<strong>and</strong>ard will be seriously considered <strong>and</strong> adopted, in whole, by the test <strong>and</strong> measurement marketplace.Consistent with that intent, permission is hereby granted by the Consortium to make copies of thisentire document as a whole, PROVIDED THAT this NOTICE, STATEMENT of INTENT <strong>and</strong>AUTHORIZATION TO COPY shall prominently appear on each such whole copy. Further consistentwith that intent, permission is hereby granted by the consortium to make copies of portions of thisdocument, absent this NOTICE, STATEMENT of INTENT <strong>and</strong> AUTHORIZATION TO COPY,PROVIDED THAT each such portion-copies shall only be used in a manner which is consistent withthe purposes of implementing, promoting, disseminating, or enhancing (as opposed to deviating from)the SCPI st<strong>and</strong>ard as herein defined, such as the inclusion of such a portion-copy in an instrument (orinstrument-related) product manual which implements SCPI (as defined herein) or in use for design ofsuch an instrument (or instrument related) product. However, under no circumstances may copies ofthis document, or any portion of this document, be made solely for purposes of sale of the copy orcopies.For information, contact:Fred Bode, Executive DirectorSCPI Consortium8380 Hercules Drive, Suite P3La Mesa, CA 91942Phone: (619) 697-8790FAX: (619) 697-5955CompuServe Number: 76516,254fbode@vxinl.comii


Table of ContentsChapter 1 Introduction1.3.1 Guiding Designers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11.3.2 Achieving Consistency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21.4.1 <strong>Syntax</strong> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21.4.2 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Chapter 2 Digital Meters2.1.1 Base Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32.1.1.1 Effects of MEASure Query <strong>and</strong> CONFigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32.1.1.2 The parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.1.1.3 The parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.1.2 Base Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.1.2.1 FORMat Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.1.2.2 SENSe subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.1.2.3 TRIGger subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.1.3 Base Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.1.3.1 QUEStionable Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.1.3.2 OPERation Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52.2.1 Extended Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.1.1 ETRIGGER Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.1.2 ETRIGGER Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.1.2.1 TRIGger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.1.3 ETRIGGER Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.2 Multiple Terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.2.1 TERMINALS Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.2.2 TERMINALS Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.2.2.1 ROUTe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.2.3 TERMINALS Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.3 Offset Compensation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62.2.3.1 OCOMPENSATED Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72.2.3.2 OCOMPENSATED Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72.2.3.2.1 SENSe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72.2.3.3 OCOMPENSATED Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72.3.1 DC Voltmeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.1.1 Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.1.2 SENSe Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.2 AC RMS Voltmeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.2.1 Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.2.2 SENSe Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.3 Ohmmeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8iii


1997 SCPI Instrument Classes2.3.3.1 SENSe Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.3.2 4-wire Ohmmeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.3.3 SENSe Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.4 DC Ammeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82.3.4.1 Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.3.4.2 SENSe Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.3.5 AC RMS Ammeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.3.5.1 Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.3.5.2 SENSe Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-92.4.1 Simple Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-102.4.2 Time Critical Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-102.4.3 Multiple Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10Chapter 3 Digitizers3.1 Base Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.1.1 Base Measurement Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.1.2 Base Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.1.2.1 Input functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.1.2.2 SENSe amplitude functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.1.2.3 SENSE timebase functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.1.2.4 SENSe One-of-N Function Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.1.2.5 Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43.1.2.6 Trigger functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43.1.3 Base Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43.1.3.1 QUEStionable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-53.1.3.2 OPERation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-53.2 Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5Chapter 4 Power Supplies4.1.1 Base Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.2 Base Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.2.1 Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.2.2 SOURce subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.3 Base Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34.1.3.1 QUEStionable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34.1.3.2 OPERation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34.2.1 Measurement capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.1.1 MEASURE Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.1.2 MEASURE Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.1.3 MEASURE Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.2 Multiple supplies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.2.1 MULTIPLE Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.2.2 MULTIPLE Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2.2.3 MULTIPLE Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5iv


1997 SCPI Instrument Classes4.2.3 Triggering Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2.3.1 TRIGGER Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2.3.2 TRIGGER Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54.2.3.3 TRIGGER Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64.3.1 Simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.3.2 Time Critical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.3.3 Level Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.3.4 Multiple Supplies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8Chapter 5 RF & Microwave Sources5.1.1 Base Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.1.2 Base Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.1.2.1 SOURce subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.1.2.2 OUTPut Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35.1.2.3 UNIT Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35.1.3 Base Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35.1.3.1 QUEStionable Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35.1.3.2 OPERation Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35.2.1 Amplitude Modulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.1.1 AM Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.1.2 AM Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.1.3 AM Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.2 Frequency Modulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.2.1 FM Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.2.2 FM Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45.2.2.3 Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.3 Pulse Modulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.3.1 PULM Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.3.2 PULM Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.3.3 PULM Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.4 Analog Frequency Sweeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.4.1 FASWEEP Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.4.2 FASWEEP Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55.2.4.3 FASWEEP Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-65.2.5 Stepped Frequency Sweeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-65.2.5.1 FSSWEEP Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-65.2.5.2 FSSWEEP Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-65.2.5.3 FSSWEEP Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-75.2.6 Analog Power Sweeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-75.2.6.1 PASWEEP Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-75.2.6.2 PASWEEP Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-75.2.6.3 PASWEEP Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-85.2.7 Stepped Power Sweeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-85.2.7.1 PSSWEEP Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8v


1997 SCPI Instrument Classes5.2.7.2 PSSWEEP Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-85.2.7.3 PSSWEEP Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.8 Frequency List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.8.1 FLIST Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.8.2 FLIST Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.8.3 FLIST Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.9 Marker Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.9.1 MARKER Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.9.2 MARKER Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95.2.9.3 MARKER Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-105.2.10 Trigger Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-105.2.10.1 TRIGGER Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-105.2.10.2 TRIGGER Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-105.2.10.3 TRIGGER Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-115.2.11 Reference Oscillator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-115.2.11.1 REFERENCE Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-115.2.11.2 REFERENCE Device Oriented Comm<strong>and</strong>s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-115.2.11.3 REFERENCE Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-115.3.1 Simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-125.3.2 Modulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-125.3.3 Analog Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-125.3.4 Triggered Analog Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-135.3.5 Sweep with Marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-135.3.6 Reference oscillator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13Chapter 6 Signal Switchers6.1.1 Base Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.1.2 Base Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.1.2.1 ROUTe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.1.3 Base Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.2.1 Scanning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.1.1 SCAN Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.1.2 SCAN Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.1.2.1 ROUTe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.1.2.2 TRIGger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36.2.1.3 SCAN Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.2 Extended Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.2.1 ETRIGGER Measurement Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.2.2 ETRIGGER Device-oriented Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.2.2.1 TRIGger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.2.2.3 ETRIGGER Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46.3.1 Making <strong>and</strong> Breaking Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56.3.2 Programmed Connection Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5vi


1997 SCPI Instrument Classes1 IntroductionThis volume defines the SCPI comm<strong>and</strong>s <strong>and</strong> behavior needed to implement functionalitysets associated with common classes of instruments. Each chapter covers a particularinstrument class. A class could be, for example, a power supply, voltmeter, or switcher. Eachchapter st<strong>and</strong>s by itself so a designer may focus on only the chapters that apply to aparticular design.1.1 ScopeThis volume covers the major classes of electronic instruments supported by the comm<strong>and</strong>s<strong>and</strong> behaviors as defined in SCPI <strong>Volume</strong>s 1 through 3. This volume does not extend SCPIwith unsupported or contradictory comm<strong>and</strong>s or behaviors.As new applications for SCPI are explored, additional chapters will be added.1.2 Definition of TermsFunctionality - an aspect of instrument operation which is described by SCPI comm<strong>and</strong>s <strong>and</strong>their associated behavior.Functionality setA grouping of functionality which shall be implemented as a whole.Instrument classA generally recognized type of instrument, for example switcher, power supply,or voltmeter.Base functionalityThat functionality set required in an instrument of a given class.Additional functionalityOne or more functionality sets defined for an instrument class beyond the basefunctionality.1.3 PurposeThis volume is designed to further the overall SCPI goal of reducing ATE programdevelopment time by:Reducing the ATE product development time by guiding designers in the usage ofSCPI from the more familiar, instrument class point of view.Achieving a higher degree of consistency among implementations of the sameinstrument class.1.3.1 Guiding DesignersThe Comm<strong>and</strong> Reference <strong>Volume</strong> describes comm<strong>and</strong>s that cover a wide variety ofinstrument classes <strong>and</strong> technologies. Picking comm<strong>and</strong>s from this alphabetically sorted listappropriate for a particular instrument can be daunting.1234567891011121314151617181920212223242526Introduction 1-1


1997 SCPI Instrument Classes1This volume uses terms familiar to the designer to help relate SCPI to previous designexperiences. <strong>Volume</strong> 4 provides a translation from the SCPI Comm<strong>and</strong> Referencevocabulary to the vocabulary common to an instrument class.The Comm<strong>and</strong> Reference purposely presents certain subsystems in broad terms. Forexample, triggering is a function used in almost all instruments, but in slightly differentways. This volume provides further guidance to designers on how to apply certainsubsystems, like TRIGger, to a particular instrument class.1.3.2 Achieving ConsistencyBecause SCPI covers many instrument classes, it cannot require all instruments toimplement all comm<strong>and</strong>s. It can, however, define an instrument base functionality byspecifying a relatively small set of comm<strong>and</strong>s <strong>and</strong> behaviors. A programmer can depend on alevel of consistency among SCPI instruments of the same class.By staying within the base functionality, a programmer can avoid all Comm<strong>and</strong> Errors.Execution errors are still possible. For example, this volume cannot specify ranges. The programmer, however, can use the required MIN/MAXqueries to establish range limits. Specific required values are shown where the parametertype is .Additional functionality may be defined for some instrument classes. None of thesefunctionality sets are required, but if any set is implemented it shall be implemented in itsentirety.1.4 Instrument ClassificationEach chapter defines base functionality for an instrument class. This base functionality isdesignated with a keyword using SCPI program mnemonic rules. Keywords are also definedfor additional functionality. An ongoing goal of the this volume is to further classifyadditional functionality for each instrument class.An instrument is classified using one or more base functionality keywords along withoptional additional functionality keywords. This combination of keywords is an. Some instruments implement the SYSTem:CAPability? query,whose response is its .1.4.1 <strong>Syntax</strong>The syntax of is defined as:1-2 Introduction


1997 SCPI Instrument Classes is a base functionality keyword as defined in one of the instrument chapters. is defined as: is defined as: is an additional functionality keyword defined in the same instrument chapterwhich defines the associated .Both <strong>and</strong> use the mnemonic generation rules described in<strong>Syntax</strong> & <strong>Style</strong>, 6.2.1 when constructing the keywords. The keywords have no short form,but may have a numeric suffix. Only <strong>and</strong> elements defined inthis volume may appear in the response to SYSTem:CAPability?.The is either ‘&’ (ASCII hexadecimal 26) or ‘|’ (ASCII hexadecimal 7C).The ‘&’ operator connects functionalities which may be active concurrently. The ‘|’ operatorindicates that a choice of functionality must be made.The operators used in the preceding syntax definitions follow the rules of the following theprecedence rules in Table 1-1.1234567891011121314151617181920212223242526Introduction 1-3


1997 SCPI Instrument Classes1OperatorAssociativity() left to rightWITHright to left&left to right| left to rightTable 1-1Precedence <strong>and</strong> Order of Evaluationof Operators1.4.2 ExamplesThe simplest describes an instrument with just one basefunctionality. A power supply with no additional functionality might have an of:(PSUPPLY)A simple digital multi-meter might contain several base functionalites, so its could be:(DCVOLTMETER|ACVOLTMETER|OHMMETER)The operator, |, indicates that only one of the base functionalities is available at a time.A more sophisticated DMM could have an like:(DCVOLTMETER WITH(ETRIGGER&TERMINALS)|ACVOLTMETERWITH(ETRIGGER&TERMINALS) |DCAMMETERWITH(ETRIGGER&TERMINALS)|ACAMMETER WITH(ETRIGGER&TERMINALS)|OHMMETER WITH(ETRIGGER&TERMINALS&OCOMPENSATED) |FOHMMETERWITH(ETRIGGER&TERMINALS&OCOMPENSATED))Within the , the operator, &, indicates all the additional functionalities areavailable simultaneously.An instrument may contain multiple base functionalities that are used at the same time. Thebase functionalities may even be described in different chapters of this volume. A scanningvoltmeter could be described with:(DCVOLTMETER&SWITCHER WITH SCAN)1.5 ComplianceAn instrument that complies with SCPI even though it has less than base functionality for itsinstrument class is still a SCPI instrument, <strong>and</strong> may be claimed by its manufacturer as such.However, the manufacturer may not use to describe its instrumentunless it meets the requirements of <strong>Volume</strong> 4.1-4 Introduction


1997 SCPI Instrument ClassesAny product which uses an to describes its capabilities <strong>and</strong> whoseresponse to SYSTem:VERSion? is greater than or equal to 1994.0 shall also implementSYSTem:CAPability?Note that every instrument will likely have functionality not covered by this volume. Thedesigner must still follow the requirements in other volumes when implementing SCPI forthose functionalities.1.6 Chapter OrganizationChapters are nominally organized into sections as follows, where x is the chapter number:x.1 Base Functionalityx.1.1Base Measurement Instructions (as applies)x.1.2Base Device-oriented Functionsx.1.3Base Status Reportingx.2 Additional Functionality (as applies)x.3 Programming ExamplesSome instrument classes naturally divide into major sub-classes. For example, meters fallinto sub-classes of voltmeter, ammeter, ohmmeter, <strong>and</strong> others. In this situation, separatechapters or other variation on chapter organization may be used.1234567891011121314151617181920212223242526Introduction 1-5


1997 SCPI Instrument Classes11-6 Introduction


1997 SCPI Instrument Classes2 Digital MetersA digital meter is a basic measuring instrument. It typically measures a single value at onepoint in time. This type of instrument is so general that it is first described generically.Attributes specific to a particular type of meter are described in their own subsections.All SCPI compliant products implement the comm<strong>and</strong>s listed in <strong>Syntax</strong> & <strong>Style</strong>, 4.2.Figure 2-1 shows an instrument model for a meter. It is derived from Comm<strong>and</strong> Reference,chapter 2. It is essentially the same as Figure 2-1 in Comm<strong>and</strong> Reference with various partsgray or dashed. The bold boxes <strong>and</strong> lines, solid <strong>and</strong> dashed, are described in this chapter. TheFORMat <strong>and</strong> ROUTe blocks are shown with dashed lines because many meters use theirdefault settings. *RST sets FORMat[:READings][:DATA] to ASCii <strong>and</strong>ROUTe:TERMinals to FRONt. The gray boxes are not described here. While a meter mayhave MEMory, its functionaily is optional <strong>and</strong> thus not described.Figure 2-1 Simplified Model for a Programmable MeterFigure 2-2 shows how the “Measurement Function” block in Figure 2-1 is exp<strong>and</strong>ed in ameter. It is the same as Figure 2-4 in Comm<strong>and</strong> Reference with some dashed <strong>and</strong> gray boxes.The CALCulate block is dashed because after *RST this block has no effect on the data.This chapter does not describe any CALCulate functions. The MEMory block is graybecause while a meter may contain this function, this chapter does not address it.A designer would never implement a generic meter, but would rather build one of thespecific types. Table 1 lists the various classes of meters considered in this chapter alongwith the quantity they measure. A is associated with each class of meter. Thecontents of the shown in the table are used in the actual comm<strong>and</strong>s.Some meters contain several instrument classes. A Digital Multi-Meter might contain a DCvoltmeter, an AC voltmeter, a DC ammeter, an AC ammeter, an ohmmeter, <strong>and</strong> a 4-wire1234567891011121314151617181920212223242526Digital Meters 2-1


1997 SCPI Instrument Classes2Figure 2-2 Exp<strong>and</strong>ed Measurement Function Modelohmmeter. The SENSe:FUNCtion comm<strong>and</strong>s switch the instrument among its implementedclasses. The TRIGger subsystem comm<strong>and</strong>s only appear once in the instrument <strong>and</strong> areshared by all the meters. Such a meter would not have TRIG1 for the DC voltmeter, TRIG2for the AC voltmeter, etc.Base FunctionalityKeywordCommon UsageNameMeasured QuantityDCVOLTMETER DC Voltmeter DC Volts VOLTage[:DC]ACVOLTMETER AC RMS Voltmeter RMS Volts VOLTage:ACDCAMMETER DC Ammeter DC Amperes CURRent[:DC]ACAMMETER AC RMS Ammeter RMS Amperes CURRent:ACOHMMETER Ohmmeter Ohms RESistanceFOHMMETER 4-wire Ohmmeter Ohms FRESistanceTABLE 1. Instrument Classes for Meters2-2 Digital Meters


1997 SCPI Instrument Classes2.1 Base FunctionalityThis section describes the functionality all meters implement.2.1.1 Base Measurement InstructionsSince the basic function of a meter is to measure some quantity, it underst<strong>and</strong>s themeasurement instructions in Comm<strong>and</strong> Reference, 3. A meter shall implement thesecomm<strong>and</strong>s with the appropriate substitution for .KEYWORD PARAMETERSCONFigure[:SCALar]: [[,]]CONFigure?FETCh[:SCALar][:]? [[,]]READ[:SCALar][:]? [[,]]MEASure[:SCALar]:? [[,]]The syntax of these comm<strong>and</strong>s is found in chapter 3 of the Comm<strong>and</strong> Reference. Metersmay accept parentheses <strong>and</strong> as described by the full syntax.The response from *RST;MEAS:? is a single , , or because *RST sets FORMat to ASCII, TRIGger:COUNt to 1, <strong>and</strong> ARM:COUNt to 1.READ? <strong>and</strong> FETCh? shall return a containingTRIGger:COUNt times ARM:COUNt numbers corresponding to that many measurements.If ARM:COUNt is not implemented, its value is one. The timing of measurements iscontrolled by the other settings in the TRIGger subsystem.The comm<strong>and</strong> sequence MEAS:?;FETCH? shall return two identical elements separated by a semicolon.2.1.1.1 Effects of MEASure Query <strong>and</strong> CONFigureMEASure query <strong>and</strong> CONFigure shall set:SENSe:FUNCtion[:ON] to “[XNONe:]”INITiate:CONTinuous to OFFTRIGger[:SEQuence]:SOURce to IMMediateTRIGger[:SEQuence]:COUNt to 1TRIGger[:SEQuence]:DELay to MINimumFor meters that implement additional functionality ETRIGGER (see 2.2.1), MEASure query<strong>and</strong> CONFigure shall set:1234567891011121314151617181920212223242526Digital Meters 2-3


1997 SCPI Instrument Classes2ARM[:SEQuence][:LAYer]:SOURce to IMMediateARM[:SEQuence][:LAYer]:COUNt to 1For meters that implement additional functionality TERMINALS (see 2.2.2), MEASurequery <strong>and</strong> CONFigure shall set:ROUTe:TERMinalsunaffectedNote: Additional instrument settings may need to be changed to support the execution of thehigh-level measurement instruction. These settings are under the control of comm<strong>and</strong>s notdescribed in this chapter <strong>and</strong> thus are not defined here.2.1.1.2 The parameterIf is present <strong>and</strong> its value is not DEFault,SENSe::RANGe[:UPPer] shall be set to the legal value equal to or just largerthan . SENSe::RANGe:AUTO shall be set OFF.If is not present or its value is DEFault,SENSe::RANGe:AUTO shall be set ON <strong>and</strong> the instrument shall autorange tothe best possible range for the measurement.2.1.1.3 The parameterIf is present <strong>and</strong> its value is not DEFault, SENSe::RESolution shallbe set to the legal value equal to or just less than .If is not present or its value is DEFault, SENSe::RESolution shallbe set to a legal value that gives a reasonably accurate result without taking excessively long.2.1.2 Base Device-oriented Functions2.1.2.1 FORMat SubsystemThis subsystem is not required. A meter shall implement the FORMat[:READings][:DATA]ASCii <strong>and</strong> FORMat[:READings]:DINTerchange OFF settings. Note: These are the *RSTvalues, so the comm<strong>and</strong>s are not required.2.1.2.2 SENSe subsystemAny meter shall sense a selected function <strong>and</strong> control the range <strong>and</strong> resolution of the sensor.The ability to autorange is required. The ability to turn on multiple simultaneously is not required.A meter shall implement these SENSe comm<strong>and</strong>s with the appropriate substitution for.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995SENSe:FUNCtion[:ON] “[XNONe:]” 18.11.2.3::RANGe[:UPPer] :AUTO :RESolution 2-4 Digital Meters


1997 SCPI Instrument Classes2.1.2.3 TRIGger subsystemThe primary purpose of the TRIGger subsystem is to control when measurements are made.The default timing is generally to take a measurement as soon as possible.A meter shall implement these TRIGger comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate 24.7[:IMMediate] 24.7.2[:ALL] 24.7.2.1 1995ABORt 24.5TRIGger 24.8[:SEQuence] 24.8.1:COUNt 24.8.1.2:DELay 24.8.1.5:SOURce BUS | IMMediate | EXTernal | ... 24.8.1.17Requiring BUS as a legal parameter to TRIGger:SOURce has the side effect of requiringDT1 capability in an IEEE 488.2 device. It also means the meter implements the *TRGcommon comm<strong>and</strong>.A VXIbus device with a trigger function is required to implement the Trigger comm<strong>and</strong>.When TRIGger:SOURce is set BUS, a VXIbus meter shall use the Trigger comm<strong>and</strong> as theTRIGger source.2.1.3 Base Status Reporting<strong>Syntax</strong> & <strong>Style</strong>, chapter 9 describes the status reporting structure used in all SCPIinstruments. Comm<strong>and</strong> Reference, chapter 20 defines the comm<strong>and</strong>s which control the statusreporting structure.2.1.3.1 QUEStionable StatusWhen a meter is measuring DC volts or AC volts, the meter shall set bit 0, VOLTage, in theQUEStionable status structure when the meter suspects the voltage is of questionableaccuracy. When a meter is measuring DC current or AC current, the meter shall set bit 1,CURRent, in the QUEStionable status structure when the meter suspects the current is ofquestionable accuracy. When a meter is measuring ohms, the meter shall set either bit 0,VOLTage, or bit 1, CURRent when the meter suspects either is of questionable accuracy.2.1.3.2 OPERation StatusWhile the meter is performing one of the operations listed in the OPERation status structure,that bit shall be set in the condition register. Every meter shall report at least RANGing, bit2, MEASuring, bit 4, <strong>and</strong> Waiting for TRIG, bit 5.12Edit312-4-94 letter4567891011121314151617181920212223242526Digital Meters 2-5


1997 SCPI Instrument Classes22.2 Additional functionality2.2.1 Extended TriggerThe for extended trigger is ETRIGGER.Meters with extended trigger functionality provide two layer triggering where a separateevent must occur before the TRIGger layer is entered. The comm<strong>and</strong>s under ARM are usedto provide this functionality rather than another SEQuence.2.2.1.1 ETRIGGER Measurement InstructionsETRIGGER adds no Measurement Instructions.2.2.1.2 ETRIGGER Device-oriented Functions2.2.1.2.1 TRIGger SubsystemKEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995ARM[:SEQuence][:LAYer]:SOURce {BUS | IMMediate | ... } 24.6.1.2.142.2.1.3 ETRIGGER Status ReportingBit 6 (Waiting for ARM) in the OPERation Status Register is used to indicate the status ofthe trigger model.2.2.2 Multiple TerminalsThe for multiple terminals is TERMINALS.A meter generally has only a single input, though some meters may be able switch the inputbetween front <strong>and</strong> rear terminals. These meters have the TERMINALS additionalfunctionality.2.2.2.1 TERMINALS Measurement InstructionsTERMINALS adds no Measurement Instructions.2.2.2.2 TERMINALS Device-oriented Functions2.2.2.2.1 ROUTe SubsystemA meter which can select between front <strong>and</strong> rear terminals shall implementKEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995ROUTe:TERMinals FRONt | REAR 17.62.2.2.3 TERMINALS Status ReportingTERMINALS adds no Status Reporting requirements.2.2.3 Offset CompensationThe for offset compensation is OCOMPENSATED.2-6 Digital Meters


1997 SCPI Instrument ClassesAn ohmmeter or 4-wire ohmmeter may be unable to measure resistance when residualvoltages are present. An ohmmeter or 4-wire ohmmeter which can compensate for residualvoltages when measuring resistance has the OCOMPENSATED additional functionality.2.2.3.1 OCOMPENSATED Measurement InstructionsOCOMPENSATED adds no measurement instructions.MEASure:RESistance? <strong>and</strong> CONFigure:RESistance shall setSENse:RESistance:OCOMpensated to OFF. MEASure:FRESistance? <strong>and</strong>CONFigure:FRESistance shall set SENse:FRESistance:OCOMpensated to OFF.2.2.3.2 OCOMPENSATED Device-oriented Functions2.2.3.2.1 SENSe SubsystemAn ohmmeter or 4-wire ohmmeter which can compensate for residual voltages shallimplement:KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995SENSe:RESistance| :FRESistance:OCOMpensated 18.16.32.2.3.3 OCOMPENSATED Status ReportingOCOMPENSATED adds no Status Reporting requirements.1234567891011121314151617181920212223242526Digital Meters 2-7


1997 SCPI Instrument Classes22.3 Various Meter ClassesThis section provides additional information <strong>and</strong> rules of behavior for specific meter classes.2.3.1 DC VoltmeterDC voltmeters measure the average voltage level of the signal across their inputs.2.3.1.1 RangeDC voltmeters shall measure negative as well as positive voltages symmetrically about zero.SENSe:RANGe[:UPPer] determines how far from zero measurements can be made. TheMINimum <strong>and</strong> MAXimum values for SENSe:RANGe[:UPPer] shall be positive. Since therange is symmetric about zero, SENSe:RANGe:LOWer is not needed, but if implemented itsvalue shall be coupled to UPPer by the equation:LOWer = -UPPer.2.3.1.2 SENSe Comm<strong>and</strong>sSENSe:VOLTage[:DC] comm<strong>and</strong>s are found in Comm<strong>and</strong> Reference, 18.20.2.3.2 AC RMS VoltmeterAC RMS voltmeters measure the root mean square of the voltage level across their inputs.2.3.2.1 RangeSince the RMS of any signal is non-negative, the MINimum <strong>and</strong> MAXimum values forSENSe:RANGe[:UPPer] shall be positive. SENSe:RANGe:LOWer is not needed.2.3.2.2 SENSe Comm<strong>and</strong>sSENSe:VOLTage:AC comm<strong>and</strong>s are found in Comm<strong>and</strong> Reference 1994, 18.21.2.3.3 OhmmeterOhmmeters measure the resistance across their input terminals.Typically, a DC current is sourced <strong>and</strong> the DC voltage is measured. Resistance is calculatedby dividing the current into the voltage.2.3.3.1 SENSe Comm<strong>and</strong>sSENSe:RESistance comm<strong>and</strong>s are found in Comm<strong>and</strong> Reference 1994, 18.16.2.3.3.2 4-wire Ohmmeter4-wire ohmmeters measure the resistance across two of their input terminals with theassistance of two additional wires.Typically, a DC current is sourced through one set of wires <strong>and</strong> the DC voltage is measuredacross the other set. As with a 2-wire ohms measurement, resistance is calculated by dividingthe current into the voltage.2.3.3.3 SENSe Comm<strong>and</strong>sSENSe:FRESistance comm<strong>and</strong>s are found in Comm<strong>and</strong> Reference 1994, 18.16.2.3.4 DC AmmeterDC ammeters measure the average value of the current through their inputs.2-8 Digital Meters


1997 SCPI Instrument Classes2.3.4.1 RangeDC ammeters shall follow the same constraints on RANGe as DC voltmeters.2.3.4.2 SENSe Comm<strong>and</strong>sSENSe:CURRent[:DC] comm<strong>and</strong>s are found in Comm<strong>and</strong> Reference 1994, 18.6.2.3.5 AC RMS AmmeterAC RMS ammeters measure the root mean square of the current through their inputs.2.3.5.1 RangeAC RMS ammeters shall follow the same constraints on RANGe as AC voltmeters.2.3.5.2 SENSe Comm<strong>and</strong>sSENSe:CURRent:AC comm<strong>and</strong>s are found in Comm<strong>and</strong> Reference 1994, 18.6.1234567891011121314151617181920212223242526Digital Meters 2-9


1997 SCPI Instrument Classes22.4 Programming ExamplesThis section discusses how a user might program a meter for certain applications. Theexamples assume the meter is a DC voltmeter, but a meter of any type could have been used.2.4.1 Simple MeasurementIn an application where the user wants to make a simple measurement with no specialconsideration for signal conditioning or timing, the MEASure query is an excellent choice.An example might be checking if a power supply voltage is at a proper level. The instrumentmight receive the following query to make a voltage measurement:MEASure:VOLTage:DC?The instrument autoranges to the best range <strong>and</strong> makes the measurement with a reasonableresolution. A single value is returned as soon as possible. The instrument does not wait forany other triggers.Another user might send:MEASure:VOLTage:DC? 5,.05A voltmeter that has 1, 10, <strong>and</strong> 100 volt ranges would be in the 10 volt range. Anothervoltmeter with 3, 30, <strong>and</strong> 300 volt ranges would use the 30 volt range. Resolution wouldprobably get set to 10 mv corresponding to 3 1/2 digits. Again the measurement is made assoon as possible.This same measurement could be made using low level comm<strong>and</strong>s.*RSTSENSe:FUNCtion “VOLTage:DC”;VOLTage:RANGe 5V;RESolution .05VINITiate;FETCh?Note that *RST sets all TRIGger subsystem SOURce to IMMediate <strong>and</strong> COUNt to 1.2.4.2 Time Critical MeasurementTo use an external triggering signal, the user cannot use MEASure query because MEASurequery sets TRIGger:SOURce to IMMediate. Instead, CONFigure <strong>and</strong> READ? with TRIGgercomm<strong>and</strong>s between them is the proper choice. The sequence:CONFigure:VOLTage:DC 5V,.05VTRIGger:SOURce EXTernalREAD?sets up the SENSe functions easily. The single TRIGger comm<strong>and</strong> modifies the triggeringsubsystem just enough to do the job. The READ query initiates a measurement which waitsfor the external trigger before returning the result.2.4.3 Multiple MeasurementsThe overhead of sending comm<strong>and</strong>s may prevent taking measurements made close togetherin time using a separate MEASure query or READ? for each measurement. The instrumentcould, however, buffer the readings. The sequence:2-10 Digital Meters


1997 SCPI Instrument ClassesCONFigure:VOLTage:DC 5V,.05VTRIGger:SOURce EXTernal;COUNt 10READ?returns ten separate measurements taken when ten external triggers occur. A defensiveprogrammer would then send SYSTem:ERRor? <strong>and</strong> check for error -210, “Trigger error” or-211, “Trigger ignored” to see if there were any problems with the triggering.1234567891011121314151617181920212223242526Digital Meters 2-11


1997 SCPI Instrument Classes22-12 Digital Meters


1997 SCPI Instrument Classes3 DigitizersA digitizer is an instrument designed primarily to measure time-swept voltage waveforms.Because a digitizer is primarily a sensing device, the SENSe root node is optional.All SCPI compliant products implement the comm<strong>and</strong>s listed in <strong>Syntax</strong> & <strong>Style</strong>, 4.2.Figure 2-1 shows an instrument model for a digitizer. It is derived from Comm<strong>and</strong>Reference, chapter 2. It is essentially the same as Figure 2-1 in Comm<strong>and</strong> Reference withvarious parts gray or dashed. The bold boxes <strong>and</strong> lines, solid <strong>and</strong> dashed, are described inthis chapter. The ROUTe block are shown with dashed lines because many digitizers usetheir default settings.The gray boxes are not described here. While a digitizer may have MEMory, its functionailyis optional <strong>and</strong> thus not described.Figure 3-1 Simplified Model of a DigitizerFigure 2-2 shows how the “Measurement Function” block in Figure 2-1 is exp<strong>and</strong>ed in adigitizer. It is the same as Figure 2-4 in Comm<strong>and</strong> Reference with some dashed <strong>and</strong> grayboxes. The CALCulate block is dashed because after *RST this block has no effect on thedata. This chapter does not describe any CALCulate functions. The MEMory block is graybecause while a digitizer may contain this function, this chapter does not address it.1234567891011121314151617181920212223242526Digitizers 3-1


1997 SCPI Instrument Classes3Figure 3-2 Exp<strong>and</strong>ed Measurement Function Model3.1 Base FunctionalityThis section describes the functionality all digitizers implement.The for a digitizer is DIGITIZER.Digitizer inputs are typically called channels. These are generally numbered 1, 2, 3, ... orlettered A, B, C, .... Several SCPI comm<strong>and</strong>s in this section use numeric suffixes on headerkeywords or parameters. The intention is that these suffixes unify operations that apply tothe associated channel.Two-channel capability is shown in the examples to illustrate this concept. A single channeldigitizer may be implemented by omitting the comm<strong>and</strong> <strong>and</strong> or parameter options with thenumeric suffix 2. More than two channels may be implemented by extending the numericsuffix.3.1.1 Base Measurement InstructionThe base functionality for a digitizer requires no measurement instructions (MEASure,CONFigure, READ, FETCh).3.1.2 Base Device-oriented FunctionsThe base functionality for digitizers shall contain the comm<strong>and</strong>s described in this section.3.1.2.1 Input functionsKEYWORD PARAMETERS Comm<strong>and</strong> Ref, 1995INPut[1]|INPut2:COUPling AC | DC | GND 11.3This comm<strong>and</strong> controls the coupling characteristics of the input to the amplifier.At *RST, the coupling for digitizers shall be DC.3-2 Digitizers


1997 SCPI Instrument ClassesAs previously mentioned, INPut1 is associated with the first input channel, <strong>and</strong> so on.3.1.2.2 SENSe amplitude functionsKEYWORD PARAMETERS Comm<strong>and</strong> Ref, 1995[SENSe]:VOLTage[1]|:VOLTage2[:DC]:RANGe:LOWer 18.21.1.5.2:OFFSet 18.21.1.5.4:PTPeak 18.21.1.5.5[:UPPer] 18.21.1.5.1VOLTage1 is associated with INPut1, VOLTage2 is associated with INPut2, <strong>and</strong> so on.The PTPeak comm<strong>and</strong> sets the amplifier gain of the specified channel.The OFFSet comm<strong>and</strong> sets the voltage offset of the amplifier, the midpoint of the PTPeakrange. Measurement results remain constant when offset is added.UPPer <strong>and</strong> LOWer, also expressed in volts, are coupled to OFFSet <strong>and</strong> PTPeak as describedin the introduction to Comm<strong>and</strong> Reference, chapter 18.3.1.2.3 SENSE timebase functionsKEYWORD PARAMETERS Comm<strong>and</strong> Ref, 1995[SENSe]:SWEep:POINts 18.20.8:TIME 18.20.12:TINTerval 18.20.13POINts controls the record length of the acquisition.TIME is the full time span of the acquisition.TINTerval controls the time interval between points.NOTE that if the number of sweep points <strong>and</strong> <strong>and</strong> the time interval are changed then thesweep time will change as well.At *RST, a digitizer shall set its SWEep parameters to a known, device-specified value.3.1.2.4 SENSe One-of-N Function ControlDigitizers shall implement the following comm<strong>and</strong>s that allow the selection of the activechannel using [SENSe:]FUNCtion.1234567891011121314151617181920212223242526Digitizers 3-3


1997 SCPI Instrument Classes3KEYWORD PARAMETERS Comm<strong>and</strong> Ref, 1995[SENSe]:DATA? [] 18.11.1:FUNCtion:CONCurrent 18.11.2.1:OFF 18.11.2.2[:ON] 18.11.2.3:STATe? 18.11.2.4Where <strong>and</strong> for channel 1 shall be specified as"XTIMe:VOLTage[:DC] 1" <strong>and</strong> so on.[SENSe]:DATA? shall return data for the channel specified in the query parameter or shallreturn data for the active channel(s).3.1.2.5 FormattingKEYWORD PARAMETERS Comm<strong>and</strong> Ref, 1995:FORMat[:DATA] [, ] 9.2The parameter ASCii <strong>and</strong> the zero shall be supported.At *RST, the :FORMat type shall be ASCii,0.3.1.2.6 Trigger functionsKEYWORD PARAMETERS Comm<strong>and</strong> Ref, 1995INITitiate[:IMMediate] 24.7.2[:ALL] 24.7.2.1ABORt 24.5TRIGger[:SEQuence[1]]:COUPling AC | DC 24.8.1.3:LEVel 24.8.1.12:SLOPe POSitive | NEGative | EITher 24.8.1.16:SOURce INTernal[1] | ... 24.8.1.17Triggering sourced from channel 1 shall be specified as INTernal1 <strong>and</strong> so on.At *RST, SOURce shall be set to INTernal1, COUPling shall be set to DC, SLOPe shall beset to POSitive, <strong>and</strong> LEVel shall be set to a known, device-specified value.3.1.3 Base Status ReportingAll SCPI digitizers shall implement the status reporting structure described in <strong>Syntax</strong> &<strong>Style</strong>, Status Reporting. Comm<strong>and</strong> Reference, STATus Subsystem defines the comm<strong>and</strong>swhich shall be used to control the status reporting structure.3-4 Digitizers


1997 SCPI Instrument Classes3.1.3.1 QUEStionableThe base functionality of a digitizer adds no requirements for this register.3.1.3.2 OPERationAt a minimum, the digitizer shall report Waiting for TRIG, bit 5.3.2 Programming ExampleThe following set of comm<strong>and</strong>s sets up the digitizer to acquire a waveform on channel 1 forAC coupling, 10 peak to peak signal with a sample recorded every microsecond. The triggersource is channel 1 <strong>and</strong> is DC coupled, looking for a positive slope transition of 100millivolts. After setting up the digitizer the trigger system is initiated <strong>and</strong> the resultantcaptured waveform is returned to the controller in ASCII format.Longform version:*RSTINPut:COUPling ACSENSe:VOLTage:DC:RANGE:PTPeak 10 VSENSe:SWEep:TINTerval 1E-6 SSENSe:FUNCtion:CONCurrent OFFSENSe:FUNCtion:ON "XTIMe:VOLTage:DC 1"TRIGger:SEQuence1:LEVel 0.1VINITiate:IMMediate:ALLSENSe:DATA?Shortform version:*RSTINP:COUP ACVOLT:RANG:PTP 10SWE:TINT 1E-6 SFUNC:CONC 0;ON "XTIM:VOLT 1"TRIG:LEV 0.1INITDATA?1234567891011121314151617181920212223242526Digitizers 3-5


1997 SCPI Instrument Classes33-6 Digitizers


1997 SCPI Instrument Classes4 Power SuppliesA power supply is a basic sourcing instrument. It typically supplies a constant voltage orcurrent at significant power levels to energize an electrical circuit. Because a power supply isprimarily a source, the SOURce root node is optional.All SCPI compliant products implement the comm<strong>and</strong>s listed in <strong>Syntax</strong> & <strong>Style</strong> section 4.2.Figure 4-1 shows an instrument model for a power supply. It is derived from Comm<strong>and</strong>Reference, Chapter 2. It is essentially the same as Figure 2-1 in Comm<strong>and</strong> Reference withvarious parts shaded or dashed. The shaded boxes are not described here. While a powersupply may have a MEMory subsystem, its operation is not described. The TRIGger block isdashed because not all power supplies have that functionality. While a power supplycontains FORMat <strong>and</strong> Signal Routing functionality, their behaviors generally follow the*RST setting. These blocks are not described so they are dashed.Figure 4-1 Simplified Model for a Power SupplyFigure 4-2 shows how the “Signal Generation” block in Figure 4-1 is exp<strong>and</strong>ed in a powersupply. It is the same as Figure 2-5 in Comm<strong>and</strong> Reference with some shaded <strong>and</strong> dashedboxes. The MEMory block is shaded because while a power supply may contain thisfunction, this chapter does not address it. The CALCulate block is dashed <strong>and</strong> its behaviornot described. It behaves according to the *RST value.1234567891011121314151617181920212223242526Power Supplies 4-1


1997 SCPI Instrument Classes4Figure 4-2 Exp<strong>and</strong>ed Signal Generation Model4.1 Base FunctionalityThis section describes the base functionality for power supplies.The for a DC power supply is DCPSUPPLY.4.1.1 Base Measurement InstructionsThe base functionality for a power supply contains no measurement instructions.4.1.2 Base Device-oriented Functions4.1.2.1 OutputsA power supply shall have at least one output which can be turned on <strong>and</strong> off. This OUTPutsubsystem comm<strong>and</strong> shall be implemented.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995OUTPut[:STATe] 15.12As stated in Comm<strong>and</strong> Reference, *RST sets the output state to off.4.1.2.2 SOURce subsystemA power supply shall provide control of voltage <strong>and</strong> current by implementing thesecomm<strong>and</strong>s.4-2 Power Supplies


1997 SCPI Instrument ClassesKEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[SOURce]:CURRent[:LEVel][:IMMediate][:AMPLitude] 19.4.4.1.1:VOLTage[:LEVel][:IMMediate][:AMPLitude] 19.20.4.1.1A power supply can operate in one of two modes: voltage source or current source. Themode of operation depends on the load connected to it. When a power supply is operating asa voltage source, the :VOLTage comm<strong>and</strong> sets the output voltage <strong>and</strong> the :CURRentcomm<strong>and</strong> sets the current limit. When a power supply is operating as a current source, the:VOLTage comm<strong>and</strong> sets the voltage limit <strong>and</strong> the :CURRent comm<strong>and</strong> sets the outputcurrent.If the :CURRent <strong>and</strong> :VOLTage commm<strong>and</strong>s are implemented as overlapped comm<strong>and</strong>s, theassociated Pending-Operation flags shall be reported in the No-Operation-Pending flag. Theoperation started by the :CURRent comm<strong>and</strong> completes when the output current has reachedthe programmed current value or when the voltage limit has been reached. Likewise, theoperation started by the :VOLTage comm<strong>and</strong> completes when the output voltage hasreached the programmed voltage value or the current limit has been reached.At *RST a power supply is required to set the voltage <strong>and</strong> current to “safe” conditions. Thisis generally achieved by setting them to their values closest to zero.4.1.3 Base Status ReportingAll SCPI power supplies shall implement the status reporting structure described in <strong>Syntax</strong>& <strong>Style</strong>, Status Reporting. Comm<strong>and</strong> Reference, STATus Subsystem defines the comm<strong>and</strong>swhich shall be used to control the status reporting structure.4.1.3.1 QUEStionableFor a power supply, the bits of interest in the QUEStionable status structure are VOLTage<strong>and</strong> CURRent. When a power supply is operating as a voltage source, bit 1 (CURRent) shallbe set. When a power supply is operating as a current source, bit 0 (VOLTage) shall be set.When the output is unregulated, both bits shall be set (for example, while the output ischanging to a new programmed value).4.1.3.2 OPERationThe base functionality of a power supply adds no requirements for this register.1234567891011121314151617181920212223242526Power Supplies 4-3


1997 SCPI Instrument Classes44.2 Additional FunctionalityThis section describes additional functionality for power supplies.4.2.1 Measurement capabilityWhile the basic function of a power supply is to source voltage <strong>and</strong> current, this additionalfunctionality provides for the measurement of the actual voltage <strong>and</strong> current delivered to theload.The for measurement capability is MEASURE.4.2.1.1 MEASURE Measurement InstructionsThe following MEASure:? queries shall be implemented.KEYWORD PARAMETER FORMMEASure[:SCALar]:VOLTage[:DC]? [[,]]:CURRent[:DC]? [[,]]These queries read the actual voltage <strong>and</strong> or current at the power supply’s output. Theycontrol a sensing function that is completely separate from the power supply itself.Executing these queries shall have no effect on the power supply’s settings. Thisfunctionality further require no additional Measurement Instruction comm<strong>and</strong>s <strong>and</strong> has nointeraction with the power supply’s triggering system, if implemented.The <strong>and</strong> parameters are included solely for compatibilitywith the Comm<strong>and</strong> Reference. While parameters shall be accepted for syntacticcompatibility, they are not required by MEASURE <strong>and</strong> may be ignored by the device.4.2.1.2 MEASURE Device-oriented FunctionsMEASURE adds no device-oriented functions.4.2.1.3 MEASURE Status ReportingMEASURE adds no Status Reporting requirements.4.2.2 Multiple suppliesA power supply may contain multiple independent power supplies.The for multiple supplies is MULTIPLE.4.2.2.1 MULTIPLE Measurement InstructionsMULTIPLE adds no measurement instructions.4.2.2.2 MULTIPLE Device-oriented FunctionsAn instrument which contains multiple power supplies shall use the INSTrument:NSELect<strong>and</strong> INSTrument[:SELect] comm<strong>and</strong>s to switch among them.4-4 Power Supplies


1997 SCPI Instrument ClassesKEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995:INSTrument:NSELect 12.5[:SELect] 12.6Valid values of the shall range from 1 to the number of power supplies.4.2.2.3 MULTIPLE Status ReportingSection 9.5 of <strong>Syntax</strong> & <strong>Style</strong> describes the implications of multiple instruments on thestatus reporting model. The INSTrument Summary bits in the QUEStionable <strong>and</strong> OPERationregisters shall be used to summarize the status from all logical instruments. The followingSTATus subsystem comm<strong>and</strong>s are required.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995STATus 20:OPERation:INSTrument:CONDition?:ENABle [:EVENt]?:ISUMmary:CONDition?:ENABle [:EVENt]?:QUEStionable:INSTrument:CONDition?:ENABle [:EVENt]?:ISUMmary:CONDition?:ENABle [:EVENt]?4.2.3 Triggering CapabilitySome power supplies are able to change their voltage <strong>and</strong> current based on the arrival of acomm<strong>and</strong> or external signal. Trigger comm<strong>and</strong>s, used in conjunction with source comm<strong>and</strong>s,control when the output changes.The for trigger capability is TRIGGER.4.2.3.1 TRIGGER Measurement InstructionsTRIGGER adds no measurement instructions.4.2.3.2 TRIGGER Device-oriented FunctionsPower supplies which have TRIGGER additional functionality shall implement thefollowing SOURce <strong>and</strong> TRIGger comm<strong>and</strong>s.1234567891011121314151617181920212223242526Power Supplies 4-5


1997 SCPI Instrument Classes4KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate 24.7Edit:CONTinuous 24.7.1[:IMMediate] 24.7.2[:ALL] 24.7.2.1 1995 12-4-94 letter[SOURce]:CURRent[:LEVel]:TRIGgered[:AMPLitude] 19.4.4.2.1:VOLTage[:LEVel]:TRIGgered[:AMPLitude] 19.20.4.2.1TRIGger 24.8[:SEQuence] 24.8.1[:IMMediate] 24.8.1.11:SOURce {BUS | EXTernal | ...} 24.8.1.17The trigger comm<strong>and</strong>s associated with the TRIGGER additional functionality shall have nointeraction with the MEASURE additional functionality.Requiring BUS as a parameter to TRIGger:SOURce has the side effect of requiring DT1capability in an IEEE 488.1 device. It also means the power supply implements the *TRGcommon comm<strong>and</strong>.A VXIbus device with a trigger function is required to implement the Trigger comm<strong>and</strong>.When TRIGger:SOURce is set to BUS, a VXIbus power supply uses the Trigger comm<strong>and</strong>as the TRIGger source.When TRIGger:SOURce is set to IMMediate, an INITiate commm<strong>and</strong> immediately transfersthe TRIGgered[:AMPLitude] value to [:IMMediate][:AMPLitude].4.2.3.3 TRIGGER Status ReportingBit 5 (Waiting for TRIG) in the OPERation Status Register shall be used to indicate thestatus of the trigger model.4-6 Power Supplies


1997 SCPI Instrument Classes4.3 Programming ExamplesThis section discusses how a user might program a power supply for certain applications.4.3.1 SimpleTo use a power supply as a constant voltage supply the programmer could send:or*RSTSOURce:VOLTage:LEVel:IMMediate:AMPLitude 5VSOURce:CURRent:LEVel:IMMediate:AMPLitude MAXimumOUTPut:STATe ON*RST;VOLT 5V;CURR MAX;OUTP ON4.3.2 Time CriticalWith a power supply containing the TRIGGER additional functionality, an application couldchange the voltage at a specific time by sending:or*RSTSOURce:CURRent:LEVel:IMMediate:AMPLitude MAXimumOUTPut:STATe ONTRIGger:SEQuence:SOURce EXTernalSOURce:VOLTage:LEVel:IMMediate:AMPLitude 7.2VSOURce:VOLTage:LEVel:TRIGgered:AMPLitude 9.6VINITiate:IMMediate*RST;CURR MAX;OUTP ON;TRIG:SOUR EXTVOLT:IMM 7.2V;TRIG 9.6VINITThe power supply sources 7.2 volts immediately <strong>and</strong> waits for a signal on the externaltrigger. When the trigger event occurs, the output voltage changes to 9.6 volts.4.3.3 Level VerificationWith a power supply containing the MEASURE additional functionality, an applicationcould verify the level by sending:or*RSTOUTPut:STATe ONSOURce:CURRent:LEVel:IMMediate:AMPLitude MAXimumSOURce:VOLTage:LEVel:IMMediate:AMPLitude 7.2V*OPC?*RSTOUTP ON;CURR MAX;VOLT 7.2;*OPC?The application reads the ‘1’ returned by the supply when it completes the operation ofchanging the level.1234567891011121314151617181920212223242526Power Supplies 4-7


1997 SCPI Instrument Classes4Now the actual voltage <strong>and</strong> current supplied to the load are measured with:or:MEASure:VOLTage:DC?;:MEASure:CURRent:DC?MEAS:VOLT?;CURR?The supply returns the measured voltage <strong>and</strong> current, which the application can thencompare with expected results.4.3.4 Multiple SuppliesA device containing two power supplies sets supply #1 to 5 Volts <strong>and</strong> supply #2 to -5 voltswith the following comm<strong>and</strong>s:or*RSTINSTrument:NSELect 1SOURce:VOLTage:LEVel:IMMediate:AMPLitude 5VOUTPut:STATe ONINSTrument:NSELect 2SOURce:VOLTage:LEVel:IMMediate:AMPLitude -5VOUTPut:STATe ON*RSTINST:NSEL 1;VOLT 5;OUTP ONINST:NSEL 2;VOLT -5;OUTP ONTo check that both supplies are acting as voltage sources <strong>and</strong> are not current limited, theQUEStionable Condition Register is queried using :STATus:QUEStionable:CONDition?If bit 0 is 0 <strong>and</strong> bit 1 is 1, both supplies are in the voltage source mode.To check each supplies separately, the application subsequently reads the regulation statuswith these comm<strong>and</strong>s sent in the same program message:orSTATus:QUEStionable:INSTrument:ISUMmary1:CONDition?;:STATus:QUEStionable:INSTrument:ISUMmary2:CONDition?STAT:QUES:INST:ISUM1:COND?;:STAT:QUES:INST:ISUM2:COND?A possible response would be 2;3 indicating the CURRent bit but not the VOLTage bit hasbeen set on supply #1 (current limited, voltage regulated) <strong>and</strong> both bits set on supply #2(unregulated).4-8 Power Supplies


1997 SCPI Instrument Classes5 RF & Microwave SourcesRF sources <strong>and</strong> microwave sources are basic sourcing instruments. They typically generate asingle sinusoidal signal at one frequency <strong>and</strong> at constant output level. The frequency istypically in the range from above 10 MHz up to several GHz. Their output impedance isnormally 50 Ohms <strong>and</strong> matched impedance is assumed. The output level is specified aspower into a matched load rather than as voltage. Signal generators with modulation <strong>and</strong>sweepers are also covered by this chapter. Their special attributes are described as additionalfunctionalities.Excluded from this chapter are optical sources, function generators, arbitrary waveformgenerators, pulse generators <strong>and</strong> data pattern generators.All SCPI compliant products implement the comm<strong>and</strong>s listed in <strong>Syntax</strong> & <strong>Style</strong> section 4.2.Figure 5-1 shows an instrument model for RF & microwave sources. It is derived fromComm<strong>and</strong> Reference, chapter 2. It is essentially the same as Figure 2-1 in Comm<strong>and</strong>Reference with various parts shaded or dashed. The bold boxes <strong>and</strong> lines, solid <strong>and</strong> dashedare described in this chapter.The FORMat <strong>and</strong> ROUTe blocks are shown with dashed lines because many RF &microwave sources use their default settings. *RST sets FORMat[:DATA] to ASCii <strong>and</strong>ROUTe:TERMinals to FRONt. The shaded boxes are not described here.Figure 5-1 Simplified Model of an RF & Microwave SourceFigure 5-2 shows how the “Signal Generation” block in Figure 5-1 is exp<strong>and</strong>ed in RF &microwave sources. It is the same as Figure 2-5 in Comm<strong>and</strong> Reference with some dashed<strong>and</strong> shaded boxes. The CALCulate block is dashed because after *RST this block has noeffect on the data. This chapter does not describe any CALCulate functions. The MEMoryblock is shaded because while RF & microwave sources may contain this function, thischapter does not address it.1234567891011121314151617181920212223242526RF & Microwave Sources 5-1


1997 SCPI Instrument Classes5Figure 5-2 Exp<strong>and</strong>ed Signal Generation Model5.1 Base FunctionalityThis section describes the base functionality for RF & microwave signal sources.The for RF & microwave sources is RFSOURCE.5.1.1 Base Measurement InstructionsThe base functionality for RF & microwave sources contains no measurement instructions.5.1.2 Base Device-oriented Functions5.1.2.1 SOURce subsystemRF & microwave sources shall provide control of its output frequency <strong>and</strong> level byimplementing these comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[SOURce]:FREQuency[:CW|:FIXed] 19.7.2:POWer:ALC 19.13.2[:STATe] 19.13.2.1[:LEVel] 19.13.4[:IMMediate] 19.13.4.1[:AMPLitude] 19.13.4.1.1If the :FREQuency <strong>and</strong> :POWer comm<strong>and</strong>s are implemented as overlapped comm<strong>and</strong>s, theassociated Pending-Operation flags shall be reported in the No-Operation-Pending flag. Theoperation started by the :FREQuency comm<strong>and</strong> completes when the frequency has reached5-2 RF & Microwave Sources


1997 SCPI Instrument Classesthe programmed frequency value. Likewise, the operation started by the :POWer comm<strong>and</strong>completes when the output level has reached the programmed power value.At *RST a RF & microwave source should be set to a “safe” condition. This is generallyachieved by setting the amplitude to its minimum value in conjunction with *RST settingOUTPut:STATe to OFF.5.1.2.2 OUTPut SubsystemRF & microwave sources that have at least one output which can be turned on <strong>and</strong> off <strong>and</strong>shall implement the following comm<strong>and</strong>.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995OUTPut[:STATe] 15.12As stated in Comm<strong>and</strong> Reference, *RST sets the output state to off.5.1.2.3 UNIT SubsystemRF & microwave sources shall provide control of its UNITs for the output power byimplementing this comm<strong>and</strong>.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995UNIT:POWer W|V|DBM|DBW|... 25.2At *RST, this value shall be set to DBM.5.1.3 Base Status ReportingAll SCPI RF & microwave sources shall implement the status reporting structure describedin <strong>Syntax</strong> & <strong>Style</strong>, Status Reporting. Comm<strong>and</strong> Reference, STATus Subsystem defines thecomm<strong>and</strong>s which shall be used to control the status reporting structure.5.1.3.1 QUEStionable StatusRF & microwave sources shall set bit 3 (POWer) or bit 5 (FREQuency) in the QUEStionableStatus Register when the RF & microwave source suspects the power or the frequency is ofquestionable accuracy.5.1.3.2 OPERation StatusThe base functionality of a RF & microwave source adds no requirements to the OPERationStatus register.1234567891011121314151617181920212223242526RF & Microwave Sources 5-3


1997 SCPI Instrument Classes55.2 Additional functionalityThe basic function of a RF & microwave source is to generate a signal at fixed frequency<strong>and</strong> power. Typical signal generators <strong>and</strong> typical sweepers may include additionalfunctionality as modulation, sweep of frequency or power, marker <strong>and</strong> trigger function <strong>and</strong>selection of the reference oscillator. This section describes this additional functionality forRF & microwave sources.5.2.1 Amplitude ModulationThis additional functionality provides amplitude modulation of the RF output signaldelivered to the load either by an internally generated modulation signal or by an externalsignal input.The for amplitude modulation is AM.5.2.1.1 AM Measurement InstructionsAM adds no Measurement Instructions.5.2.1.2 AM Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the AM additional functionality shall provide controlof amplitude modulation by implementing the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[SOURce]:AM[:DEPTh] 19.1.2:EXTernal 19.1.3:COUPling AC|DC|... 19.1.3.1:INTernal 19.1.4:FREQuency 19.1.4.1:SOURce EXTernal|INTernal 19.1.8:STATe 19.1.95.2.1.3 AM Status ReportingWhen the RF & microwave source suspects the additional function AM is of questionableaccuracy, bit 7 (MODulation) shall be set in the QUEStionable Status Register.5.2.2 Frequency ModulationThis additional functionality provides frequency modulation of the RF output signaldelivered to the load either by an internally generated modulation signal or by an externalsignal input.The for frequency modulation is FM.5.2.2.1 FM Measurement InstructionsFM adds no Measurement Instructions.5.2.2.2 FM Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the FM additional functionality shall provide controlof frequency modulation by implementing the following comm<strong>and</strong>s.5-4 RF & Microwave Sources


1997 SCPI Instrument ClassesKEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[SOURce]:FM[:DEViation] 19.6.2:EXTernal 19.6.3:COUPling AC|DC|... 19.6.3.1:INTernal 19.6.4:FREQuency 19.6.4.1:SOURce EXTernal|INTernal 19.6.8:STATe 19.6.95.2.2.3 Status ReportingWhen the RF & microwave source suspects the additional function FM is of questionableaccuracy, bit 7 (MODulation) shall be set in the QUEStionable Status Register.5.2.3 Pulse ModulationThis additional functionality provides pulse modulation of the RF output signal delivered tothe load by an external modulation signal.The for pulse modulation is PULM.5.2.3.1 PULM Measurement InstructionsPULM adds no Measurement Instructions.5.2.3.2 PULM Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the PULM additional functionality shall providecontrol of pulse modulation by implementing the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[SOURce]:PULM:POLarity NORMal|INVerted 19.14.4:STATe 19.14.65.2.3.3 PULM Status ReportingWhen the RF & microwave source suspects the additional functionality PULM is ofquestionable accuracy, bit 7 (MODulation) shall be set in the QUEStionable Status Register.5.2.4 Analog Frequency SweepingRF & microwave sources may provide control of analog frequency sweep functions.The for analog frequency sweeping is FASWEEP.5.2.4.1 FASWEEP Measurement InstructionsFASWEEP adds no Measurement Instructions.5.2.4.2 FASWEEP Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the FASWEEP additional functionality shall providecontrol of frequency sweep by implementing the following comm<strong>and</strong>s.1234567891011121314151617181920212223242526RF & Microwave Sources 5-5


1997 SCPI Instrument Classes5KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate:CONTinuous 24.7.1[:ALL] 24.7.1.1[SOURce]:FREQuency:MODE CW|FIXed|SWEep|... 19.7.4:STARt 19.7.9:STOP 19.7.10:CENTer 19.7.1:SPAN 19.7.8:SWEep:TIME 19.18.1:AUTO |ONCE 19.18.1.1See the beginning of the Comm<strong>and</strong> Refernce, SOURce chapter for a description of thecoupling among STARt, STOP, CENTer & SPAN.Typically a RF & microwave source has just one single SWEEP source for frequency <strong>and</strong>power sweep. The setting of sweep parameters are then coupled <strong>and</strong> identical. If there ismore than one sweep source they can be distinguished by use of a numeric suffix.When the mode is changed from CW to SWEep, the instrument is not sweeping untilINITiate:CONTinuous is set to ON.5.2.4.3 FASWEEP Status ReportingIf the additional function Analog Frequency Sweep is implemented <strong>and</strong> the RF & microwavesource is performing this operation, bit 3 (SWEeping) shall be set in the OPERation StatusRegister.5.2.5 Stepped Frequency SweepingRF & microwave sources may provide control of stepped frequency sweep functions.The for stepped frequency sweeping is FSSWEEP.5.2.5.1 FSSWEEP Measurement InstructionsFSSWEEP adds no Measurement Instructions.5.2.5.2 FSSWEEP Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the FSSWEEP additional functionality shall providecontrol of frequency sweep by implementing the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate:CONTinuous 24.7.1[:ALL] 24.7.1.1[SOURce]:FREQuency:MODE CW|FIXed|SWEep|... 19.7.45-6 RF & Microwave SourcesBodeBode


1997 SCPI Instrument Classes:STARt 19.7.9:STOP 19.7.10:CENTer 19.7.1:SPAN 19.7.8:SWEep:DWELl 19.18.2:STEP 19.18.7See the beginning of the Comm<strong>and</strong> Reference, SOURce chapter for a description of thecoupling among STARt, STOP, CENTer & SPAN.Typically a RF & microwave source has just one single SWEEP source for frequency <strong>and</strong>power sweep. The setting of sweep parameters are then coupled <strong>and</strong> identical. If there ismore than one sweep source they can be distinguished by use of a numeric suffix.When the mode is changed from CW to SWEep, the instrument is not sweeping untilINITiate:CONTinuous is set to ON.5.2.5.3 FSSWEEP Status ReportingIf the additional function Stepped Frequency Sweep is implemented <strong>and</strong> the RF &microwave source is performing this operation, bit 3 (SWEeping) shall be set in theOPERation Status Register.5.2.6 Analog Power SweepingRF & microwave sources may provide control of analog power sweep functions.The for analog power sweeping is PASWEEP.5.2.6.1 PASWEEP Measurement InstructionsPASWEEP adds no Measurement Instructions.5.2.6.2 PASWEEP Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the PASWEEP additional functionality shall providecontrol of analog power sweep by implementing the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate:CONTinuous 24.7.1[:ALL] 24.7.1.1[SOURce]:POWer:MODE FIXed|SWEep 19.13.7:STARt 19.13.13:STOP 19.13.14:CENTer 19.13.3:SPAN 19.13.12:SWEep:TIME 19.18.1:AUTO |ONCE 19.18.1.11234567891011121314151617181920Bode212223242526RF & Microwave Sources 5-7


1997 SCPI Instrument Classes5See the beginning of the Comm<strong>and</strong> Reference, SOURce chapter for a description of thecoupling among STARt, STOP, CENTer & SPAN.Typically a RF & microwave source has just one single SWEEP source for frequency <strong>and</strong>power sweep. The setting of sweep parameters are then coupled <strong>and</strong> identical. If there ismore than one sweep source they can be distinguished by use of a numeric suffix.When the mode is changed from CW to SWEep, the instrument is not sweeping untilINITiate:CONTinuous is set to ON.5.2.6.3 PASWEEP Status ReportingIf the additional function Analog Power Sweep is implemented <strong>and</strong> the RF & microwavesource is performing this operation, bit 3 (SWEeping) shall be set in the OPERation StatusRegister.5.2.7 Stepped Power SweepingRF & microwave sources may provide control of stepped power sweep functions.The for stepped power sweeping is PSSWEEP.5.2.7.1 PSSWEEP Measurement InstructionsPSSWEEP adds no Measurement Instructions.5.2.7.2 PSSWEEP Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the PSSWEEP additional functionality shall providecontrol of stepped power sweep by implementing the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate:CONTinuous 24.7.1[:ALL] 24.7.1.1[SOURce]:POWer:MODE FIXed|SWEep 19.13.7:STARt 19.13.13:STOP 19.13.14:CENTer 19.13.3:SPAN 19.13.12:SWEep:DWELl 19.18.2:STEP 19.18.7See the beginning of the Comm<strong>and</strong> Reference, SOURce chapter for a description of thecoupling among STARt, STOP, CENTer & SPAN.Typically a RF & microwave source has just one single SWEEP source for frequency <strong>and</strong>power sweep. The setting of sweep parameters are then coupled <strong>and</strong> identical. If there ismore than one sweep source they can be distinguished by use of a numeric suffix.Bode5-8 RF & Microwave Sources


1997 SCPI Instrument ClassesWhen the mode is changed from CW to SWEep, the instrument is not sweeping untilINITiate:CONTinuous is set to ON.5.2.7.3 PSSWEEP Status ReportingIf the additional function Stepped Power Sweep is implemented <strong>and</strong> the signal generator isperforming this operation, bit 3 (SWEeping) shall be set in the OPERation Status Register.5.2.8 Frequency ListRF & microwave sources may provide control of additional frequency sweep functions by afrequency list containing the sequence of frequencies to be stepped through.The for frequency lists is FLIST.5.2.8.1 FLIST Measurement InstructionsFLIST adds no Measurement Instructions.5.2.8.2 FLIST Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the FLIST additional functionality shall providecontrol of frequency list by implementing the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate:CONTinuous 24.7.1[:ALL] 24.7.1.1[SOURce]:FREQuency:MODE CW|FIXed|LIST|... 19.7.4:LIST:DWELl 19.9.8:POINts? query only 19.9.8.1:FREQuency {,} 19.9.9:POINts? query only 19.9.9.1This functionality only requires one parameter for DWELl, however the instrument mayaccept more than one.5.2.8.3 FLIST Status ReportingFLIST adds no requirement for status reporting.5.2.9 Marker FunctionRF & microwave sources may provide control of marker functions.The for marker function is MARKER.5.2.9.1 MARKER Measurement InstructionsMARKER adds no Measurement Instructions.5.2.9.2 MARKER Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the MARKER additional functionality shall providecontrol of markers by implementing the following comm<strong>and</strong>s.1234567891011Bode121314151617181920212223242526RF & Microwave Sources 5-9


1997 SCPI Instrument Classes5KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[SOURce]:MARKer:AOFF 19.10.2:FREQuency 19.10.3[:STATe] 19.10.7RF & microwave sources may have more than one Marker. In this case a numeric suffixshall be used to distinguish between the different markers.5.2.9.3 MARKER Status ReportingMARKER adds no requirement for status reporting.5.2.10 Trigger FunctionRF & microwave sources uses the TRIGger Subsystem to control the start of the sweep orlist function if the frequency <strong>and</strong>/or the amplitude is swept. When a trigger is received, theRF & microwave source starts <strong>and</strong> completes a sweep or list sequence <strong>and</strong> then waits for thenext trigger event.The for trigger function is TRIGGER.5.2.10.1 TRIGGER Measurement InstructionsTRIGGER adds no Measurement Instructions.5.2.10.2 TRIGGER Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the TRIGGER additional functionality shallimplement the following trigger comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995INITiate:CONTinuous 24.7.1[:ALL] 24.7.1.1[:IMMediate] 24.7.2[:ALL] 24.7.2.1ABORt 24.5TRIGger[:SEQuence][:IMMediate] 24.8.1.11:SOURce BUS | IMMediate | ... † 24.8.1.17† In addition to the TRIGger:SOURce parameters listed, a RF & microwave source withFSSWEEP, PSSWEEP or FLIST shall implement an external trigger, such as EXTernal,ECLTrg or TTLTrg.BodeBode5-10 RF & Microwave Sources


1997 SCPI Instrument ClassesRequiring BUS as a legal parameter to TRIGger:SOURce has the side effect of requiringDT1 capability in a 488.1 device. It also means the RF & microwave source implements the*TRG common comm<strong>and</strong>.A VXIbus device with a trigger function is required to implement the Trigger comm<strong>and</strong>.When TRIGger:SOURce is set BUS, a VXIbus RF & microwave source shall use theTrigger comm<strong>and</strong> as the TRIGger source.5.2.10.3 TRIGGER Status ReportingIf the additional function TRIGGER is implemented <strong>and</strong> the RF & microwave source isperforming this operation, bit 5 (Waiting for TRIGger) shall be set in the OPERation StatusRegister.5.2.11 Reference OscillatorRF & microwave sources may have the functionality to select which reference oscillator is inuse <strong>and</strong> to define the frequency of the external reference oscillator.The for reference oscillator function is REFERENCE.5.2.11.1 REFERENCE Measurement InstructionsREFERENCE adds no Measurement Instructions.5.2.11.2 REFERENCE Device Oriented Comm<strong>and</strong>sRF & microwave sources which have the additional functionality to select the referenceoscillator shall implement the following comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[:SOURce]:ROSCillator:EXTernal 19.17.2:FREQuency 19.17.2.1:SOURce INTernal|EXTernal 19.17.35.2.11.3 REFERENCE Status ReportingRF & microwave sources shall set bit 5 (FREQuency) in the QUEStionable Status Registerwhen there is no appropriate reference signal available <strong>and</strong> the RF & microwave sourcesuspects the output frequency is of questionable accuracy.1234567891011121314151617181920212223242526RF & Microwave Sources 5-11


1997 SCPI Instrument Classes55.3 Programming ExamplesThis section discusses how a user might program RF & microwave sources for certainapplications.5.3.1 SimpleTo use RF & microwave sources as a simple signal source for fixed frequency <strong>and</strong> outputlevel the programmer could send:or*RSTSOURce:CW:FREQuency 123.45 MHZSOURce:POWer:LEVel:IMMediate:AMPLitude -27 DBMOUTput:STATe ON*RSTFREQ 123.45MHZ;POW -27DBM;OUTP ON5.3.2 ModulationTo use a RF & microwave source having the functionality to generate a frequencymodulated signal by use of the internal modulation source the programmer could send:or*RSTSOURce:CW:FREquency 89.5 MHZSOURce:FM:DEViation 200 KHZSOURce:FM:SOURce INTernalSOURce:FM:INTernal:FREQuency 1 KHZSOURce:POWer:LEVel:IMMediate:AMPLitude 100 UWOUTPut:STATe ON*RSTFREQ 89.5MHZFM 200KHZ;FM:SOUR INT;INT:FREQ 1KHZPOW 100UW;OUTP ON5.3.3 Analog SweepTo use a RF & microwave source having the functionality to sweep the frequency withsetting of start/stop frequency <strong>and</strong> sweep time the programmer could send:or*RSTSOURce:FREQuency:MODE SWEepSOURce:FREQuency:STARt 100 MHZSOURce:FREQuency:STOP 200 MHZSOURce:SWEep:TIME 100 MSSOURce:POWer:LEVel:IMMediate:AMPLitude -27 DBMOUTPut:STATe ONINITiate:CONTinuous ON5-12 RF & Microwave Sources


1997 SCPI Instrument Classes*RSTFREQ:MODE SWEFREQ:STAR 100MHZ;STOP 200MHZSWE:TIME 100MSPOW -27 DBM;OUTP ONINIT:CONT ON5.3.4 Triggered Analog SweepTo use a RF & microwave source as a analog sweeper in triggered single sweep mode theprogrammer could send:or*RSTSOURce:FREQuency:MODE SWEepSOURce:FREQuency:STARt 100 MHZSOURce:FREQuency:STOP 200 MHZSOURce:SWEep:TIME 100 MSSOURce:POWer:LEVel:IMMediate:AMPLitude -27 DBMOUTPut:STATe ONTRIGger:SOURce EXTernalINITiate:IMMediate*RSTFREQ:MODE SWEFREQ:STAR 100MHZ;STOP 200MHZSWE:TIME 100MSPOW -27 DBM;OUTP ONTRIG:SOUR EXTINITNote: The SOURCE:SWEEP:COUNT <strong>and</strong> SOURCE:LIST:COUNT are set to 1 after *RSTi.e. the sweeper will perform single sweep function after occurrence of an external triggersignal <strong>and</strong> then waits for the next trigger event.5.3.5 Sweep with MarkerTo use a sweeper with setting of two markers the programmer could add the followingcomm<strong>and</strong>s to example 5.3.3:orSOURce:MARKer1:FREQuency 125 MHZSOURce:MARKer2:FREQuency 170 MHZMARK1:FREQ 125MHZ;MARK2:FREQ 170MHZ5.3.6 Reference oscillatorTo use a RF & microwave source with its output frequency derived from an externalreference frequency the programmer could send:1234567891011121314151617181920212223242526RF & Microwave Sources 5-13


1997 SCPI Instrument Classesor*RSTSOURce:ROSCillator:EXTernal 10 MHZSOURce:CW:FREQuency 2355.5 MHZSOURce:POWer:LEVel:IMMediate:AMPLitude -6 DBMOUTPut:STATe ON*RSTROSC:EXT 10MHZFREQ 2355.5MHZ;POW -6DBM;OUTP ON55-14 RF & Microwave Sources


1997 SCPI Instrument Classes6 Signal SwitchersA signal switcher is a basic signal routing instrument. In its most basic form, it can make <strong>and</strong>break signal connections. These signal connections are usually referred to as channels.Making a connection is closing a channel, <strong>and</strong> breaking a signal is opening a channel. Moreadvanced signal switchers can be programmed with sequence lists of channels to close inresponse to trigger events. Because a signal switcher is primarily a signal router, the ROUTeroot node is optional.Figure 6-1 shows an instrument model for a signal switcher. It is derived from Comm<strong>and</strong>Reference, chapter 2. It is essentially the same as Figure 2-1 in Comm<strong>and</strong> Reference withvarious parts gray or dashed. The bold boxes <strong>and</strong> lines, solid <strong>and</strong> dashed, are described inthis chapter.All SCPI compliant products implement the comm<strong>and</strong>s listed in <strong>Syntax</strong> & <strong>Style</strong> section 4.2.Figure 6-1Simplified Model for a Progammable Signal Switcher1234567891011121314151617181920212223242526Signal Switchers 6-1


1997 SCPI Instrument Classes66.1 Base FunctionalityThe for a signal switcher is SWITCHER.6.1.1 Base Measurement InstructionsSince a signal switcher has no measuring capability, it has no measurement instructions.6.1.2 Base Device-oriented Functions6.1.2.1 ROUTe SubsystemA signal switcher can at least make <strong>and</strong> break signal connections by closing <strong>and</strong> openingchannels.The following comm<strong>and</strong>s shall be implemented.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[ROUTe]:CLOSe 17.1:STATe? 17.1.1:OPEN 17.2:ALL 17.2.1If the :CLOSe <strong>and</strong> :OPEN commm<strong>and</strong>s are implemented as overlapped comm<strong>and</strong>s, theassociated Pending-Operation flags shall be reported in the No-Operation-Pending flag.6.1.3 Base Status ReportingAll SCPI signal switchers shall implement the status reporting structure described in <strong>Syntax</strong>& <strong>Style</strong>, Status Reporting. Comm<strong>and</strong> Reference, STATus Subsystem defines the comm<strong>and</strong>swhich shall be used to control the status reporting structure.The base functionality of a switcher adds no additional status reporting requirements.6-2 Signal Switchers


6.2 Additional Functionality1997 SCPI Instrument Classes6.2.1 ScanningThe for scanning is SCAN.Signal switchers which implement the SCAN additional functionality can be programmedwith a list of channels to “scan”. Each time the signal switcher recognizes a trigger event, itopens the previously closed channel <strong>and</strong> closes the next channel in the list.6.2.1.1 SCAN Measurement InstructionsSCAN adds no measurement instructions.6.2.1.2 SCAN Device-oriented Functions6.2.1.2.1 ROUTe SubsystemA signal switcher which has the SCAN additional functionality shall implement thefollowing comm<strong>and</strong>.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995[ROUTe]:SCAN 17.3Note: The following paragraph is intended to provide guidance to designers of signalswitchers. It is not intended to impose further design requirements.The appropriate interaction between the SCAN comm<strong>and</strong> <strong>and</strong> the CLOSe <strong>and</strong> OPENcomm<strong>and</strong>s depends upon the intended application of the signal switcher. In some instances itis advantageous to be able to close a set of channels using the CLOSe comm<strong>and</strong> (e.g. toconnect sourcing instruments to the device under test), then scan through a different set ofchannels (e.g. to make measurements on various nodes in the device under test) withoutopening those channels which were closed by the CLOSe comm<strong>and</strong>. In other instances it isdesirable that the start of the scan operation first opens any channels which are alreadyclosed.6.2.1.2.2 TRIGger SubsystemA signal switcher which has the SCAN additional functionality shall implement thefollowing trigger comm<strong>and</strong>s.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995ABORt 24.5INITiate:CONTinuous 24.7.1[:IMMediate] 24.7.2[:ALL] 24.7.2.1 1995TRIGger[:SEQuence]:COUNt 24.8.1.2:SOURce BUS | IMMediate | ... † 24.8.1.1712345678910111213141516171819202122Edit2312-4-94 24letter2526Signal Switchers 6-3


1997 SCPI Instrument Classes6† In addition to the TRIGger:SOURce parameters listed, a signal switcher with SCAN shallimplement an external trigger, such as EXTernal, ECLTrg or TTLTrg.Requiring BUS as a legal parameter to TRIGger:SOURce has the side effect of requiringDT1 capability in a 488.1 device. It also means the signal switcher implements the *TRGcommon comm<strong>and</strong>.A VXIbus device with a trigger function is required to implement the Trigger comm<strong>and</strong>.When TRIGger:SOURce is set BUS, a VXIbus switcher shall use the Trigger comm<strong>and</strong> asthe TRIGger source.6.2.1.3 SCAN Status ReportingBit 5 (Waiting for TRIG) in the OPERation Status Register shall be used to indicate thestatus of the trigger model.6.2.2 Extended TriggerThe for extended trigger is ETRIGGER. This is subservient toSCAN.Some signal switchers which have SCAN functionality (<strong>and</strong> so have TRIGger comm<strong>and</strong>s)provide two layer triggering where a separate event must occur before the TRIGger layer isentered.6.2.2.1 ETRIGGER Measurement InstructionsETRIGGER adds no Measurement Instructions.6.2.2.2 ETRIGGER Device-oriented Functions6.2.2.2.1 TRIGger SubsystemThe following ARM comm<strong>and</strong> shall be used to provide the ETRIGGER functionality.KEYWORD PARAMETER FORM Comm<strong>and</strong> Reference 1995ARM[:SEQuence][:LAYer]:SOURce {BUS | IMMediate | ... } 24.6.1.2.146.2.2.3 ETRIGGER Status ReportingBit 6 (Waiting for ARM) in the OPERation Status Register shall be used to indicate thestatus of the trigger model.6-4 Signal Switchers


1997 SCPI Instrument Classes6.3 Programming ExamplesThis section discusses how a user might program a signal switcher for certain applications.The examples assume the signal switcher contains a single switch module which is a10-channel multiplexer which permits any combination of the 10 channels to be closedsimultaneously.6.3.1 Making <strong>and</strong> Breaking ConnectionsTo close signal channel #3:orROUTe:CLOSe (@3)CLOS (@3)To query whether channel #3 is closed:orROUTe:CLOSe? (@3)CLOS? (@3)6.3.2 Programmed Connection SequencesA signal switcher which can be programmed with a sequence of connections can improvethe throughput of test systems by reducing the communication required between the systemcontroller <strong>and</strong> the test instruments. For example, the output of the 10-channel multiplexerwhich has SCAN functionality, <strong>and</strong> includes EXTernal as a valid parameter forTRIGger:SOURce, is connected to the inputs of a DMM. The “meter complete” signal fromthe DMM is connected to the external trigger input of the signal switcher. To configure thissystem to measure on all 10 channels, use this sequence of comm<strong>and</strong>s to the signal switcher:or*RSTTRIGger:SEQuence:COUNt 9;SOURce EXTernalROUTe:SCAN (@2,3,4,5,6,7,8,9,10);CLOSe (@1)INITiate:IMMediate*RSTTRIG:COUN 9;SOUR EXTSCAN (@2:10);CLOS (@1)INITThe *RST comm<strong>and</strong> sets INITiate:CONTinuous to OFF <strong>and</strong> puts the trigger model in IDLE.After sending the INITiate:IMMediate comm<strong>and</strong>, the system controller triggers the DMM.When the meter is finished measuring, its “meter complete” signal activate the signalswitcher’s external trigger input, causing it to close channel 2. Now the system controllertriggers the DMM again, <strong>and</strong> so on. When the signal switcher has finished processing the 9thtrigger (closing channel 10) it returns to the trigger model IDLE layer.1234567891011121314151617181920212223242526Signal Switchers 6-5


1997 SCPI Instrument Classes66-6 Signal Switchers

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!