SCPI Command Reference
Agilent Technologies
N5181A/82A MXG Signal Generators
This guide applies to the followin g sign al generator models:
N5181A MXG Analog Signal Generator
N5182A MXG Vector Signal Generator
Due to our continuing efforts to improve our products through firmware and hardware revisions, signal generator design and
operation may vary f ro m des cr i ptions in this guide. We recommend tha t y ou use the latest revision of this guide to ensure
you have up-to-date product information. Compare the print date of this guide (see bottom of page) with the latest revision,
which can be downloaded from the following website:
http://www.agilent.com/find/mxg
Manufacturing Part Number: N5180- 90004
Printed in USA
September 2006
© Copyright 2006 Agilent Technologies, Inc.
Notice
The material contained in this document is provided “as is”, and is subject to being changed, without
notice, in future editions.
Further, to the maximum extent permitted by applicable law, Agilent disclaims all warranties, either
express or implied with regard to this manual and to any of the Agilent products to which it
pertains, including but not limited to the implied warranties of merchantability and fitness for a
particular purpose. Agilent shall not be liable for errors or for incidental or consequential damages in
connection with the furnishing, use, or performance of this document or any of the Agilent products
to which it pertains. Should Agilent have a written contract with the User and should any of the
contract terms conflict with these terms, the contract terms shall control.
Questions or Comments about our Documentation?
We welcome any questions or comments you may have about our documentation. Please send us an
E- mail at sources_manuals@am.exch.agilent.com.
ii
Contents
1SCPI Basics
Command Reference Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
SCPI Command Listings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Key and Data Field Cross Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Supported Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
SCPI Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Common Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Command Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Command Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Command Parameters and Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Program Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
File Name Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
File Types and Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
MSUS (Mass Storage Unit Specifier) Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Quote Usage with SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Binary, Decimal, Hexadecimal, and Octal Formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2 Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
:FLATness:INITialize:FSTep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
:FLATness:LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
:FLATness:PAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
:FLATness:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
:FLATness:PRESet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
:FLATness:STEP:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
:FLATness:STEP:STARt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
:FLATness:STEP:STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
:FLATness:STORe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Digital Modulation Subsystem—N5182A ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
:BURSt:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
:DM:CORRection:OPTimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
:DM:EXTernal:ALC:BANDwidth|BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
:DM:EXTernal:POLarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
:DM:IQADjustment:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
:DM:IQADjustment:EXTernal:COFFset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
:DM:IQADjustment:EXTernal:DIOFfset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
:DM:IQADjustment:EXTernal:DQOFfset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
:DM:IQADjustment:EXTernal:IOFFset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
:DM:IQADjustment:IOFFset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference iii
Contents
:DM:IQADjustment:QOFFset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
:DM:IQADjustment:EXTernal:QOFFset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
:DM:IQADjustment:EXTernal:QSKew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
:DM:IQADjustment:GAIN[1]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
:DM:IQADjustment:QSKew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
:DM:IQADjustment:SKEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
:DM:IQADjustment[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
:DM:POLarity[:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
:DM:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
:DM:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Frequency Subsystem ([:SOURce]). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
:FREQuency:CENTer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
:FREQuency:CHANnels:BAND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
:FREQuency:CHANnels:NUMBer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
:FREQuency:CHANnels[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
:FREQuency:FIXed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
:FREQuency:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
:FREQuency:MULTiplier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
:FREQuency:OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
:FREQuency:OFFSet:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
:FREQuency:REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
:FREQuency:REFerence:SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
:FREQuency:REFerence:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
:FREQuency:SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
:FREQuency:STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
:FREQuency:STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
:FREQuency[:CW] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
:PHASe:REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
:PHASe[:ADJust] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
:ROSCillator:BANDwidth:EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
:ROSCillator:FREQuency:EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
:ROSCillator:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
:ROSCillator:SOURce:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
List/Sweep Subsystem ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
:LIST:DIRection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
:LIST:DWELl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
:LIST:DWELl:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
:LIST:DWELl:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
:LIST:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
:LIST:FREQuency:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
:LIST:MANual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Agilent N5181A/82A MXG Signal Generators SCPI Command Referenceiv
Contents
:LIST:MODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
:LIST:POWer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
:LIST:POWer:POINts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
:LIST:RETRace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
:LIST:TRIGger:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
:LIST:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
:LIST:TYPE:LIST:INITialize:FSTep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
:LIST:TYPE:LIST:INITialize:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
:LIST:WAVeform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
:LIST:WAVeform:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
:SWEep:DWELl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
:SWEep:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
:SWEep:SPACing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Power Subsystem ([:SOURce]:POWer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
:ALC:LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
:ALC:SEARch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
:ALC:SEARch:REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
:ALC:SEARch:SPAN:START . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
:ALC:SEARch:SPAN:STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
:ALC:SEARch:SPAN:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
:ALC:SEARch:SPAN[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
:ALC[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
:ATTenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
:ATTenuation:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
:ATTenuation:BYPass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
:PROTection:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
:REFerence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
:REFerence:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
:STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
:STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
[:LEVel][:IMMediate]:OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
[:LEVel][:IMMediate][:AMPLitude]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Tsweep Subsystem ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
:TSWeep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3 System Commands
Calibration Subsystem (:CALibration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
:DCFM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
:IQ:DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
:IQ:DEFault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference v
Contents
:IQ:FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
:IQ:STARt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
:IQ:STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
:IQ:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
:IQ:[:USER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Communication Subsystem (:SYSTem:COMMunicate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
:GPIB:ADDRess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
:GTLocal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
:LAN:CONFig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
:LAN:DOMain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
:LAN:DNS:DYNamic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
:LAN:DNS:OVERride . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
:LAN:DNS[:SERVer]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
:LAN:GATeway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
:LAN:HOSTname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
:LAN:IDENtify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
:LAN:IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
:LAN:KEEP:TIMeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
:LAN:KEEP[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
:LAN:MONitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
:LAN:NBIos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
:LAN:SUBNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Diagnostic Subsystem (:DIAGnostic[:CPU]:INFOrmation) . . . . . . . . . . . . . . . . . . . . . . . . . . 68
:CCOunt:ATTenuator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
:CCOunt:PON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
:CCOunt:PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
:DISPlay:OTIMe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
:LICense:AUXiliary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
:LICense:WAVeform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
:OPTions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
:OPTions:DETail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
:OTIMe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
:REVision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
:SDATe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
:WLICence[:VALue] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Display Subsystem (:DISPlay) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
:ANNotation:AMPLitude:UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
:ANNotation:CLOCk:DATE:FORMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
:ANNotation:CLOCk[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
:BRIGhtness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
:CAPTure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Agilent N5181A/82A MXG Signal Generators SCPI Command Referencevi
Contents
:CMAP:DEFaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
:CONTrast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
:REMote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
[:WINDow][:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
IEEE 488.2 Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
*CLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
*ESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
*ESE?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
*ESR?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
*IDN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
*OPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
*OPC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
*OPT?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
*PSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
*PSC?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
*RCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
*RST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
*SAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
*SRE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
*SRE?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
*STB?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
*TRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
*TST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
*WAI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Memory Subsystem (:MEMory) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
:CATalog:BINary? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
:CATalog:LIST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
:CATalog:SEQ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
:CATalog:STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
:CATalog:UFLT? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
:CATalog[:ALL]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
:COPY[:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
:DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
:DATA:APPend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
:DELete:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
:DELete:BINary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
:DELete:LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
:DELete:SEQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
:DELete:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
:DELete:UFLT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
:DELete[:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference vii
Contents
:FREE[:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
:LOAD:LIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
:MOVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
:SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
:STATe:COMMent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
:STORe:LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
:CATalog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
:COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
:DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
:DELete:NVWFm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
:DELete:WFM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
:DELete[:NAME] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
:HEADer:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
:HEADer:DESCription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
:LOAD:LIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
:MOVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
:STORe:LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Output Subsystem (:OUTPut) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
:BLANking:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
:BLANking:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
:MODulation[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
:PROTection[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Route Subsystem (:ROUTe) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
[:CONNector]:SOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
[:CONNector]:TOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Status Subsystem (:STATus). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
:OPERation:CONDition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
:OPERation:ENABle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
:OPERation:NTRansition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
:OPERation:PTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
:OPERation:SUPPress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
:OPERation[:EVENt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
:QUEStionable:CALibration:CONDition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
:QUEStionable:CALibration:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
:QUEStionable:CALibration:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
:QUEStionable:CALibration:PTRansition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
:QUEStionable:CALibration[:EVENt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
:QUEStionable:CONDition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
:QUEStionable:ENABle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Agilent N5181A/82A MXG Signal Generators SCPI Command Referenceviii
Contents
:QUEStionable:FREQuency:CONDition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
:QUEStionable:FREQuency:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
:QUEStionable:FREQuency:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
:QUEStionable:FREQuency:PTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
:QUEStionable:FREQuency[:EVENt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
:QUEStionable:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
:QUEStionable:POWer:CONDition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
:QUEStionable:POWer:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
:QUEStionable:POWer:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
:QUEStionable:POWer:PTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
:QUEStionable:POWer[:EVENt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
:QUEStionable:PTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
:QUEStionable[:EVENt]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
System Subsystem (:SYSTem) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
:CAPability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
:DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
:ERRor:CODE[:NEXt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
:ERRor[:NEXt] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
:ERRor:SCPI[:SYNTax] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
:FILesystem:SAFemode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
:FILesystem:STORage:EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
:FILesystem:STORage:EXTernal:PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
:FILesystem:STORage:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
:FILesystem:STORage:TYPE:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
:IDN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
:LANGuage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
:LICense:INSTall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
:LICense:EXTernal:LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
:LICense:LIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
:LICense:REMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
:PDOWn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
:PON:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
:PRESet:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
:PRESet:LANGuage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
:PRESet:PERSistent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
:PRESet:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
:PRESet:USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
:PRESet[:USER]:SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
:SECurity:DISPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
:SECurity:ERASeall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference ix
Contents
:SECurity:LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
:SECurity:LEVel:STATe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
:SECurity:OVERwrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
:SECurity:SANitize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
:SSAVer:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
:SSAVer:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
:SSAVer:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
:TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
:VERSion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Unit Subsystem (:UNIT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
:POWer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Trigger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
:ABORt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
:INITiate:CONTinuous[:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
:INITiate[:IMMediate][:ALL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
:TRIGger:OUTPut:POLarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
:TRIGger[:SEQuence]:SLOPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
:TRIGger[:SEQuence]:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
:TRIGger[:SEQuence]:TIMer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
:TRIGger[:SEQuence][:IMMediate]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
4 Analog Mod ulation Com m a nds
Amplitude Modulation Subsystem–Option UNT ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . 120
:AM:EXTernal:COUPling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
:AM:INTernal:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
:AM:INTernal:FREQuency:STEP[:INCRement] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
:AM:INTernal:FUNCtion:SHAPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
:AM:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
:AM:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
:AM:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
:AM[:DEPTh]:EXPonential. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
:AM[:DEPTh]:STEP[:INCRement] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
:AM[:DEPTh][:LINear] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Frequency Modulation Subsystem–Option UNT ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . 124
:FM:EXTernal:COUPling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
:FM:INTernal:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
:FM:INTernal:FREQuency:STEP[:INCRement]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
:FM:INTernal:FUNCtion:SHAPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
:FM:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
:FM:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
:FM[:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Agilent N5181A/82A MXG Signal Generators SCPI Command Referencex
Contents
:FM[:DEViation]:STEP[:INCRement] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Phase Modulation Subsystem–Option UNT ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . . . . 127
:PM:BANDwidth|BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
:PM:EXTernal:COUPling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
:PM:INTernal:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
:PM:INTernal:FREQuency:STEP[:INCRement] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
:PM:INTernal:FUNCtion:SHAPe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
:PM:SOURce. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
:PM:STATe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
:PM[:DEViation] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
:PM[:DEViation]:STEP[:INCRement]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Pulse Modulation Subsystem–Option UNU and UNW([:SOURce]) . . . . . . . . . . . . . . . . . . . . 131
:PULM:EXTernal:POLarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
:PULM:INTernal[1]:DELay:STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
:PULM:INTernal[1]:DELay[1]|2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
:PULM:INTernal[1]:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
:PULM:INTernal[1]:FREQuency:STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
:PULM:INTernal[1]:PERiod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
:PULM:INTernal[1]:PERiod:STEP[:INCRement] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
:PULM:INTernal[1]:PWIDth:STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
:PULM:INTernal[1]:PWIDth[1]|2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
:PULM:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
:PULM:Source:INTernal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
:PULM:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
5 Component Test Digital Commands
All Subsystem–Option 651/652/654 ([:SOURce]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
:RADio:ALL:OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
AWGN Real-Time Subsystem–Option 403 ([:SOURce]:RADio:AWGN:RT) . . . . . . . . . . . . . . . . 139
:BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
:IQ:MODulation:ATTen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
:IQ:MODulation:ATTen:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Dual ARB Subsystem–Option 651/652/654 ([:SOURce]:RADio[1]:ARB) . . . . . . . . . . . . . . . . . 141
:BASEband:FREQuency:OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
:CLIPping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
:GENerate:SINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
:HEADer:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
:HEADER:NOISe:RMS[:OVERride] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
:HEADer:RMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
:HEADer:SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference xi
Contents
:IQ:MODulation:ATTen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
:IQ:MODulation:ATTen:AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
:MARKer:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
:MARKer:CLEar:ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
:MARKer:ROTate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
:MARKer[:SET]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
:MDEStination:ALCHold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
:MDEStination:PULSe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
:MPOLarity:MARKer1|2|3|4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
:NOISe:BANDwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
:NOISe:CBWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
:NOISe:CN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
:NOISe[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
:RETRigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
:RSCaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
:SCALing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
:SCLock:RATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
:SEQuence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
:TRIGger:TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
:TRIGger:TYPE:CONTinuous[:TYPE] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
:TRIGger:TYPE:GATE:ACTive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
:TRIGger:TYPE:SADVance[:TYPE] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
:TRIGger[:SOURce] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
:TRIGger[SOURce]:EXTernal:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
:TRIGger[:SOURce]:EXTernal:DELay:STATe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
:TRIGger[:SOURce]:EXTernal:SLOPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
:TRIGger[:SOURce]:EXTernal[:SOURce] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
:WAVeform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
:WAVeform:NHEAders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
LARB Subsystem–Option 651/652/654 ([:SOURce]:RADio:LARB) . . . . . . . . . . . . . . . . . . . . 164
[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
6 SCPI Compatibility
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Changing the Signal Generator Identification String . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
:SYSTem:IDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Functional N5181A/82A SCPI Commands While in a Compatible Language Mode. . . . . . . . . 168
:PRESet:LANGuage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
:SYSTem:LANGuage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
:SYSTem:ERRor[:NEXT] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Agilent N5181A/82A MXG Signal Generators SCPI Command Referencexii
Contents
E44xxB Compatible Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
E4428C/38C Compatible Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
8648A/B/C/D Compatible Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Selecting the Programming Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8656B, 8657A/B/D/J Programming Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Programming Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Command Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference xiii
Contents
Agilent N5181A/82A MXG Signal Generators SCPI Command Referencexiv
Documentation Overview
Installation Guide
User’s Guide
Programming Guide
SCPI Reference
• Safety Information
• Receiving the Instrument
• Environmental & Electrical Requirements
• Basic Setup
• Accessories
• Operation Verification
• Regulatory Information
• Instrument Overview
• Front Panel Operation
• Security
• Basic Troubleshooting
• Remote Operation
• Status Registers
• Creating & Downloading Files
• SCPI Basics
• Command Descriptions
• Programming Command Compatibility
Service Guide
• Troubleshooting
• Assembly Replacement
• Replaceable Parts
• Post-Repair Procedures
• Safety and Regulator y Information
Key H el p
a
• Key function description
• Related SCPI commands
a.Press the Help hardkey, and then the key for which you wish help.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference x v
xvi Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
1 SCPI Basics
This chapter describes how SCPI information is organized and presented in this guide. An overview
of the SCPI language is also provided. This chapter contains the following major sections:
• “Command Reference Information” on page 2
• “SCPI Basics” on page 3
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 1
SCPI Basics
Command Reference Information
Command Reference Information
SCPI Command Listings
The Table of Contents lists the Standard Commands for Programmable Instruments (SCPI) without
the parameters. The SCPI subsystem name will generally have the first part of the command in
parenthesis that is repeated in all commands within the subsystem. The title(s) beneath the
subsystem name is the remaining command syntax. The following example demonstrates this listing:
Communication Subsystem (:SYSTem:COMMunicate)
:LAN:IP
:LAN:SUBNet
The following examples show the complete commands from the above Table of Contents listing:
:SYSTem:COMMunicate:LAN:IP
:SYSTem:COMMunicate:LAN:SUBNet
Key and Data Field Cross Re ference
The index is set up so applicable key and data field names can be cross-referenced to the
appropriate SCPI command. There are two headings in the index where the key and data field names
can be found:
• individual softkey, hardkey, or data field name (i.e. To look up the communication subsystem topic
on Default Gateway softkey refer to Default Gateway softkey.)
• subsystem name (i.e. To look for the Default Gateway softkey (in the Communication Subsystem),
refer to the heading labeled: “communication subsystem keys”.)
Supported Field
Within each command section, the “Supported” heading describes which signal generator
configurations are supported by the SCPI command. When “All Models” is shown next to this
heading, all signal generator configurations are supported by the SCPI command. When “All with
Option xxx” is shown next to this heading, only the stated option(s) is supported.
2 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
SCPI Basics
This section describes the general use of the SCPI language for the Agilent MXG. It is not intended to
teach you everything about the SCPI language; the SCPI Consortium or IEEE can provide that level of
detailed information. For a list of the specific commands available for the signal generator, refer to
the table of contents.
For additional information, refer to the following publications:
• IEEE Standard 488.1- 2003, IEEE Standard For Higher Performance Protocol for the Standard
Digital Interface for Programmable Instrumentation. New York, NY, 2003.
• IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and Command Commands
for Use with ANSI/IEEE Standard 488.1- 1987. New York, NY, 1998.
Common Terms
The following terms are used throughout the remainder of this section:
Command A command is an instruction in SCPI consisting of mnemonics (keywords),
Controller A controller is any device used to control the signal generator, for example a
Event Command Some commands are events and cannot be queried. An event has no
Program Message A program message is a combination of one or more properly formatted
Query A query is a special type of command used to instruct the signal generator to
Response Message A response message is a collection of data in specific SCPI formats sent from the
parameters (arguments), and punctuation. You combine commands to form
messages that control instruments.
computer or another instrument.
corresponding setting; it initiates an action at a particular time.
commands. Program messages are sent by the controller to the signal generator.
make response data available to the controller. A query ends with a question
mark. Generally you can query any command value that you set.
signal generator to the controller. Response messages tell the controller about the
internal state of the signal generator.
Command Syntax
A typical command is made up of keywords prefixed with colons (:). The keywords are followed by
parameters. The following is an example syntax statement:
[:SOURce]:PULM:INTernal[1]:FREQuency <frequency>|MAXimum|MINimum|UP|DOWN
In the example above, the :INTernal[1] portion of the command immediately follows the :PULM
portion with no separating space. The portion following the :INTernal[1],
MAXimum|MINimum|UP|DOWN, are the parameters (argument for the command statement). There is a
separating space (white space) between the command and its parameter.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 3
SCPI Basics
SCPI Basics
Additional conventions in syntax statements are shown in Table 1- 1 and Table 1- 2.
Table 1-1 Special Characters in Command Syntax
Characters Meaning Example
| A vertical stroke between keywords or parameters
indicates alterative choices. For parameters, the effect
of the command varies depending on the choice.
[ ] Square brackets indicate that the enclosed keywords or
parameters are optional when composing the command.
These implied keywords or parameters will be executed
even if they are omitted.
< > Angle brackets around a word (or words) indicate they
are not to be used literally in the command. They
represent the needed item.
{ } Braces indicate that parameters can optionally be used
in the command once, several times, or not at all.
Table 1-2 Command Syntax
Characters, Keywords, and Syntax Example
[:SOURce]:AM:
MOD DEEP|NORMal
DEEP or NORMal are the choices.
[:SOURce]:FREQuency[:CW]?
SOURce and CW are optional items.
[:SOURce]:FREQuency:
STARt <value><unit>
In this command, the words <value>
and <unit> should be replaced by
the actual frequency and unit.
:FREQuency:STARt 2.5GHz
[:SOURce]:LIST:
POWer <value>{,<value>}
a single power listing:
LIST:POWer 5
a series of power listings:
LIST:POWer 5,10,15,20
Upper- case lettering indicates the minimum set of characters
required to execute the command. But, each mode of the
command must be in either short form or the complete long
form (no in between). Example:
Correct:
:FREQ
:FREQuency
Incorrect:
:FREQuenc
4 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
[:SOURce]:FREQuency[:CW]?,
FREQ is the minimum requirement.
Table 1-2 Command Syntax
Characters, Keywords, and Syntax Example
SCPI Basics
SCPI Basics
Lower- case lettering indicates the portion of the command that
is optional; it can either be included with the upper- case portion
of the command or omitted. This is the flexible format principle
called forgiving listening. Refer to “Command Parameters and
Responses” on page 7 for more information.
When a colon is placed between two command mnemonics, it
moves the current path down one level in the command tree.
Refer to “Command Tree” on page 6 more information on
command paths.
If a command requires more than one parameter, you must
separate adjacent parameters using a comma. Parameters are not
part of the command path, so commas do not affect the path
level.
A semicolon separates two commands in the same program
message without changing the current path.
White space characters, such as <tab> and <space>, are
generally ignored as long as they do not occur within or between
keywords.
However, you must use white space to separate the command
from the parameter, but this does not affect the current path.
:FREQuency
Either :FREQ, :FREQuency, or :FREQUENCY
is correct.
:TRIGger:OUTPut:POLarity?
TRIGger is the root level keyword for this
command.
[:SOURce]:LIST:
DWELl <value>{,<value>}
:FREQ 2.5GHz;:POW 10dBm
:FREQ uency or :POWer :LEVel are not
allowed.
A <space> between :LEVel and 6.2 is
mandatory.
:POWer:LEVel 6.2
Command Types
Commands can be separated into two groups: common commands and subsystem commands. Figure
1- 1, shows the separation of the two command groups.
Common commands are used to manage status registers, synchronization, and data storage and are
defined by IEEE 488.2. They are easy to recognize because they all begin with an asterisk. For
example *IDN?, *OPC, and *RST are common commands. Common commands are not part of any
subsystem and the signal generator interprets them in the same way, regardless of the current path
setting.
Subsystem commands are distinguished by the colon (:). The colon is used at the beginning of a
command statement and between keywords, as in :FREQuency[:CW?]. Each command subsystem is a
set of commands that roughly correspond to a functional block inside the signal generator. For
example, the power subsystem (:POWer) contains commands for power generation, while the status
subsystem (:STATus) contains commands for controlling status registers.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 5
SCPI Basics
SCPI Basics
Figure 1-1 Command Types
Command Tree
Most programming tasks involve subsystem commands. SCPI uses a structure for subsystem
commands similar to the file systems on most computers. In SCPI, this command structure is called
a command tree and is shown in Figure 1- 2.
Figure 1-2 Simplified Command Tree
The command closest to the top is the root command, or simply “the root.” Notice that you must
follow a particular path to reach lower level commands. In the following example, :POWer represents
AA, :ALC represents BB, :SOURce represents GG. The complete command path is
:POWer:ALC:SOURce? (:AA:BB:GG).
Paths Through the Command Tree
To access commands from different paths in the command tree, you must understand how the signal
generator interprets commands. The parser, a part of the signal generator firmware, decodes each
message sent to the signal generator. The parser breaks up the message into component commands
using a set of rules to determine the command tree path used. The parser keeps track of the current
6 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
path (the level in the command tree) and where it expects to find the next command statement. This
is important because the same keyword may appear in different paths. The particular path is
determined by the keyword(s) in the command statement.
A message terminator, such as a <new line> character, sets the current path to the root. Many
programming languages have output statements that automatically send message terminators.
NOTE The current path is set to the root after the line- power is cycled or when *RST is sent.
Command Parameters and Responses
SCPI defines different data formats for use in program and response messages. It does this to
accommodate the principle of forgiving listening and precise talking. For more information on
program data types refer to IEEE 488.2.
Forgiving listening means the command and parameter formats are flexible.
For example, with the :FREQuency:REFerence:STATe ON|OFF|1|0 command, the signal generator
accepts :FREQuency:REFerence:STATe ON, :FREQuency:REFerence:STATe 1, :FREQ:REF:STAT ON,
:FREQ:REF:STAT 1 to turn on the frequency reference mode.
Each parameter type has one or more corresponding response data types. A setting that you program
using a numeric parameter returns either real or integer response data when queried. Response data
(data returned to the controller) is more concise and restricted, and is called precise talking.
Precise talking means that the response format for a particular query is always the same.
For example, if you query the power state (:POWer:ALC:STATe?) when it is on, the response is
always 1, regardless of whether you previously sent :POWer:ALC:STATe 1 or :POWer:ALC:STATe ON.
Table 1-3 shows the response for a given parameter type.
Table 1-3 Parameter and Response Types
Parameter Types Response Data Types
Numeric Real, Int eger
Extended Numeric Real, Integer
Discrete Discrete
Boolean Numeric Boolean
String String
Definite Block
a. (i .e. text, bina r y, disc r ete, real, integer, etc.-).
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 7
Arbitrary byte data
a
SCPI Basics
SCPI Basics
Numeric Parameters
Numeric parameters are used in both common and subsystem commands. They accept all commonly
used decimal representations of numbers including optional signs, decimal points, and scientific
notation.
If a signal generator setting is programmed with a numeric parameter which can only assume a finite
value, it automatically rounds any entered parameter which is greater or less than the finite value.
For example, if a signal generator has a programmable output impedance of 50 or 75 ohms, and you
specified 76.1 for the output impedance, the value is rounded to 75. The following are examples of
numeric parameters:
100 no decimal point required
100. fractional digits optional
−1.23 leading signs allowed
4.56E<space>3 space allowed after the E in exponential
−7.8 9E −001 use either E or e in exponential
+256 leading + allowed
.5 digits left of decimal point optional
Extended Numeric Par ameters
Most subsystems use extended numeric parameters to specify physical quantities. Extended numeric
parameters accept all numeric parameter values and other special values as well.
The following are examples of extended numeric parameters:
100 any simple numeric value
1.2GHz GHz can be used for exponential (E009)
200MHz MHz can be used for exponential (E006)
−100mV negative 100 millivolts
10DEG 10 degrees
Extended numeric parameters also include the following special parameters:
DEFault resets the parameter to its default value
UP increments the parameter
DOWN decrements the parameter
MINimum sets the parameter to the smallest possible value
MAXimum sets the parameter to the largest possible value
8 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Discrete Parameters
Discrete parameters use mnemonics to represent each valid setting. They have a long and a short
form, just like command mnemonics. You can mix upper and lower case letters for discrete
parameters.
The following examples of discrete parameters are used with the command
:TRIGger[:SEQuence]:SOURce BUS|IMMediate|EXTernal.
BUS GPIB, LAN, or USB triggering
IMMediate immediate trigger (free run)
EXTernal external triggering
Although discrete parameters look like command keywords, do not confuse the two. In particular, be
sure to use colons and spaces properly. Use a colon to separate command mnemonics from each
other and a space to separate parameters from command mnemonics.
The following are examples of discrete parameters in commands:
TRIGger:SOURce BUS
TRIGger:SOURce IMMe diate
TRIGger:SOURce EXTe rnal
Boolean Parameters
Boolean parameters represent a single binary condition that is either true or false. The two- state
boolean parameter has four arguments. The following list shows the arguments for the two- state
boolean parameter:
ON boolean true, upper/lower case allowed
OFF boolean false, upper/lower case allowed
1boolean true
0 boolean false
String Par ameters
String parameters allow ASCII strings to be sent as parameters. Single or double quotes are used as
delimiters.
The following are examples of string parameters:
'This is valid'
"This is also valid"
'SO IS THIS'
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 9
SCPI Basics
SCPI Basics
Real Response Data
Real response data represent decimal numbers in either fixed decimal or scientific notation. Most
high- level programming languages that support signal generator input/output (I/O) handle either
decimal or scientific notation transparently.
The following are examples of real response data:
+4.000000E+010, −9.990000E+002
−9.990000E+002
+4.0000000000000E+010
+1
0
Integer Response Data
Integer response data are decimal representations of integer values including optional signs. Most
status register related queries return integer response data.
The following are examples of integer response data:
0 signs are optional
+100 leading + allowed
−100 leading − allowed
256 never any decimal point
Discrete Response Data
Discrete response data are similar to discrete parameters. The main difference is that discrete
response data only returns the short form of a particular mnemonic, in all upper case letters.
The following are examples of discrete response data:
IMM
EXT
INT
NEG
Numeric Boolean Response Data
Boolean response data returns a binary numeric value of one or zero.
String Response Data
String response data are similar to string parameters. The main difference is that string response
data returns double quotes, rather than single quotes. Embedded double quotes may be present in
10 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
string response data. Embedded quotes appear as two adjacent double quotes with no characters
between them.
The following are examples of string response data:
"This is a string"
"one double qu ote i nside br acket s: [" "]"
"Hello!"
Program Messages
The following commands will be used to demonstrate the creation of program messages:
[:SOURce]:FREQuency:STARt [:SOURce]:FREQuency:STOP
[:SOURce]:FREQuency[:CW] [:SOURce]:POWer[:LEVel]:OFFSet
Example 1
:FREQuency:STARt 500MHz;STOP 1000MHz
This program message is correct and will not cause errors; STARt and STOP are at the same path
level. It is equivalent to sending the following message:
FREQuency:STARt 500MHz;FREQuency:STOP 1000MHz
Example 2
:POWer 10DBM;:OFFSet 5DB
This program message will result in an error. The message makes use of the default
POWer[:LEVel] node (root command). When using a default node, there is no change to the current
path position. Since there is no command OFFSet at the root level, an error results.
The following example shows the correct syntax for this program message:
:POWer 10DBM;:POWer:OFFSet 5DB
Example 3
:POWer:OFFSet 5DB;POWer 10DBM
This program message results in a command error. The path is dropped one level at each colon. The
first half of the message drops the command path to the lower level command OFFSet; POWer does
not exist at this level.
The POWer 10DBM command is missing the leading colon and when sent, it causes confusion because
the signal generator cannot find POWer at the POWer:OFFSet level. By adding the leading colon, the
current path is reset to the root. The following shows the correct program message:
:POWer:OFFSet 5DB;:POWer 10DBM
Example 4
FREQ 500MHz;POW 4DBM
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 11
SCPI Basics
SCPI Basics
In this example, the keyword short form is used. The program message is correct because it utilizes
the default nodes of :FREQ[:CW] and :POW[:LEVel]. Since default nodes do not affect the current
path, it is not necessary to use a leading colon before FREQ or POW.
File Name Variables
File name variables designate a data file and file path. File name variables are used in the SCPI
command syntax whenever files are accessed. The name of the file is always required, but the file
path can sometimes be optional or be designated using different formats. The following table shows
these different file path formats:
Format File Name Variable Example
Format 1 "<file name>" "Test_Data"
Format 2 "<file name@msus>"
Format 3 "<msus:file name>" "SEQ:Test_Data"
Format 4 "</user/directory/file name>" "/USER/SEQ/Test_Data"
a.Included for backward s compatibility. Not a recommended syntax.
"Test_Data@SEQ"
a
Formats 2–4 offer programming flexibility and are equivalent. Format 1 can only be used with SCPI
commands that imply the path name as part of the command syntax. Typically, SCPI load commands
that access user-data files do not need to have a file path designated.
See Table 1-4 on page 14 for information on file types and directories.
NOTE The maximum length for a file name is 23 characters, excluding the file path.
Example Using Format 1
:CORR:FLAT:LOAD "FLAT_DATA"
The preceding example loads user- flatness data from a file called FLAT_DATA located in the USERFLAT
directory. No file path is needed as the command syntax implies the directory where the file is
located.
Example Using Format 2
:MEM:COPY "IQ_DATA@NVWFM","Test_DATA@WFM1"
The preceding example copies a file named IQ_DATA located in the WAVEFORM directory to a file
named Test_DATA in volatile waveform memory (WFM1).
Example Using Format 3
:MEM:COPY "NVWFM:IQ_DATA","WFM1:Test_DATA"
The preceding example copies a file named IQ_DATA located in the WAVEFORM directory to a file
named Test_DATA in volatile waveform memory (WFM1).
12 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Example Using Format 4
:MEM:COPY "/USER/WAVEFORM/IQ_DATA","/USER/BBG1/WAVEFORM/IQ_DATA"
The preceding example copies a file named IQ_DATA located in the WAVEFORM directory to a file
named IQ_DATA in volatile waveform memory (WFM1).
The following examples show commands, with different formats, that can be used to download a
waveform file named Test_Data into the signal generator’s volatile waveform memory (WFM1):
Command Syntax Format 3
:MEMory:DATA "WFM1:Test_Data",#ABC
Command Syntax Format 4
:MEMory:DATA "/USER/BBG1/WAVEFORM/Test_Data",#ABC
These commands are equivalent. The data block, #ABC, is described as follows:
# This character indicates the beginning of the data block
A Number of digits in the byte count B
B Byte count in C
C Wavefo r m d a t a
Refer to “:DATA” on page 81 and the Programming Guide for more information on data blocks and
downloading waveform data.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 13
SCPI Basics
SCPI Basics
File Types and Directory Structure
The signal generator uses a computer directory model structure for file storage. The top level
directory is called the USER directory. All other directories are subdirectories located under the
USER directory. Each subdirectory is dedicated to the type of data stored. For example, the BIN
directory is used to store binary data whereas the MARKERS directory is used to store marker data.
NOTE When external memory is used, the files on the external memory are stored in a single
directory (i.e. USER/). Each file has an extension (i.e. .waveform, .list, .markers, .state, etc.- ).
The SCPI commands use the paths shown in Table 1- 4 on page 14 and the associated
examples. But when viewed, the external memory, will not display these directories. Instead
the file extensions will be displayed. For more information on the external memory
capability refer to the Programming Guide and to the Users Guide.
The following table lists signal generator the subdirectories and file paths where file types are stored.
Table1-4 File Types and Directory Structures
File System File Type File Path MSUS Path
a
BINARY
HDR1 - volatile arbitrary waveform header file
LIST - sweep list file LIST /USER/LIST LIST:
MKR1 - volatile arbitrar y waveform marker file
NVHDR - non- volatile arbitrary waveform
header file
NVMKR - non- volatile arbitrary waveform
marker file
NVWFM - non- volatile arbitrary waveform file
SEQ - ARB sequence file
STATE STAT /USER/STATE STATE:
a
a
a
BIN /USER/BIN BINARY:
a
HDR1 /USER/BBG1/HEADER HDR1:
a
MKR1 /USER/BBG1/MARKERS MKR1:
NVHDR /USER/HEADER NVHDR:
NVMKR /USER/MARKERS NVMKR:
a
NVWFM /USER/WAVEFORM NVWFM:
SEQ /USER/SEQ SEQ:
USERFLAT - user- f latness file UFLT /USER/USERFLAT USERFLAT:
WFM1 - volatile
waveform file
a
WFM1 /USER/BBG1/WAVEFORM WFM1:
a.This feature does not apply to the N5181A.
14 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
MSUS (Mass Storage Unit Specifier) Variable
The variable "<msus>" enables a command to be file type specific when working with user files.
Some commands use it as the only command parameter, while others can use it in conjunction with
a file name when a command is not file type specific. When used with a file name, it is similar to
Format 2 in the File Name Variables section on page 12. The difference is the file type specifier
(msus) occupies its own variable and is not part of the file name syntax.
The following examples illustrate the usage of the variable "<msus>" when it is the only command
parameter:
Command Syntax with the msus variable
:MMEMory:CATalog? "<msus>"
Command Syntax with the file system
:MMEMory:CATalog? "LIST:"
The variable "<msus>" is replaced with "LIST:". When the command is executed, the output displays
only the files from the List file system.The following examples illustrate the usage of the variable
"<file name>" with the variable "<msus>":
Command Syntax with the file name and msus variables
:MMEMory:DELete[:NAME] "<file name>",["<msus>"]
Command Syntax with the file name and file system
:MMEMory:DELete:NAME "LIST_1","LIST:"
The command from the above example cannot discern which file system LIST_1 belongs to without a
file system specifier and will not work without it. When the command is properly executed, LIST_1 is
deleted from the List file system.
The following example shows the same command, but using Format 2 from the File Name Variables
section on page 12:
:MMEMory:DELete:NAME "LIST_1@LIST"
When a file name is a parameter for a command that is not file system specific, either format ("<file
name>","<msus>" or "<file name@msus>") will work.
Refer to Table 1- 4 on page 14 for a listing of the file systems and types.
Quote Usage with SCPI Commands
As a general rule, programming languages require that SCPI commands be enclosed in double quotes
as shown in the following example:
":FM:EXTernal:IMPedance 600"
However when a string is the parameter for a SCPI command, additional quotes or other delimiters
may be required to identify the string. Your programming language may use two sets of double
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 15
SCPI Basics
SCPI Basics
quotes, one set of single quotes, or back slashes with quotes to signify the string parameter. The
following examples illustrate these different formats:
"MEMory:LOAD:LIST ""myfile""" used in BASIC programming languages
"MEMory:LOAD:LIST \"myfile\"" used in C, C++, Java, and PERL
"MEMory:LOAD:LIST 'myfile'" accepted by most programming languages
Consult your programming language reference manual to determine the correct format.
16 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Binary, De cimal, Hexadecimal, and Octal Formats
Command values may be entered using a binary, decimal, hexadecimal, or octal format. When the
binary, hexadecimal, or octal format is used, their values must be preceded with the proper identifier.
The decimal format (default format) requires no identifier and the signal generator assumes this
format when a numeric value is entered without one. The following list shows the identifiers for the
formats that require them:
• #B identifies the number as a binary numeric value (base- 2).
• #H identifies the number as a hexadecimal alphanumeric value (base- 16).
• #Q identifies the number as a octal alphanumeric value (base- 8).
The following are examples of SCPI command values and identifiers for the decimal value 45:
#B101101 binary equivalent
#H2D hexadecimal equivalent
#Q55 octal equivalent
The following example sets the RF output power to 10 dBm (or the equivalent value for the currently
selected power unit, such as DBUV or DBUVEMF) using the hexadecimal value 000A:
:POW #H000A
A unit of measure, such as dBm or mV, will not work with the values when using a format other than
decimal.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 17
SCPI Basics
SCPI Basics
18 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
2 Basic Function Commands
This chapter provides SCPI descriptions for subsystems dedicated to signal generator operations
common to most Agilent MXG Signal Generators. This chapter contains the following major sections:
• “Correction Subsystem ([:SOURce]:CORRection)” on page 20
• “Digital Modulation Subsystem—N5182A ([:SOURce])” on page 24
• “Frequency Subsystem ([:SOURce])” on page 32
• “List/Sweep Subsystem ([:SOURce])” on page 42
• “Power Subsystem ([:SOURce]:POWer)” on page 50
• “Tsweep Subsystem ([:SOURce])” on page 58
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 19
Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection)
Correction Subsystem ([:SOURce]:CORRection)
:FLATness:INITialize:FSTep
Supported All Models
CAUTION The current flatness data will be overwritten once this command is executed. If needed,
save the current data. Refer to “:FLATness:STORe” on page 23 for storing user flatness
files.
[:SOURce]:CORRection:FLATness:INITialize:FSTep
This command replaces the loaded user flatness data with the settings from the current step array
data points.
You can load only one user flatness file at a time.
The maximum number of user flatness points is 1,601. When copying the step array settings over to
a user flatness file, ensure that the number of points in the step array do not exceed the maximum
user flatness points.
Key Entr y Load Cal Array From Step Array
:FLATness:LOAD
Supported All Models
[:SOURce]:CORRection:FLATness:LOAD "<file name>"
This command loads a user- flatness correction file. The "<file name>" variable is the name of the file
located in the Catalog of USERFLAT Files. The directory path is implied in the command and need
not be specified in the variable name. For more information on file name syntax, refer to “File Name
Var i ables” o n page 12.
Key Entr y Load From Selected File
20 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Correction Subsystem ([:SOURce]:CORRection)
Basic Function Commands
:FLATness:PAIR
Supported All Models
[:SOURce]:CORRection:FLATness:PAIR <freq.>[<freq suffix>],
<corr.>[<corr suffix>]
This command sets a frequency and amplitude correction pair.
The maximum number of points that can be entered is 1601. Option 501 is specific to the N5181A.
<corr.> This variable is the power correction.
Range Frequency Standard
b
Option 501
Option 503: 100kHz–3GHz –110 to 18 dB <–144 to 16 dB
Option 506: 100kHz–6GHz –110 to 18 dB <–144 to 4 dB
a.Settable, but specified to –127 dBm with Option 1EQ
b.Option 501 is only available on the N5181A.
: 100kHz–1GHz
–110 to 18 dB <–144 to 18 dB
Option 1EQ
a
Key Entr y Configure Cal Array
:FLATness:POINts
Supported All Models
[:SOURce]:CORRection:FLATness:POINts?
This query returns the number of points in the user- flatness correction file.
:FLATness:PRESet
Supported All Models
CAUTION The current correction data will be overwritten once this command is executed. Save the
[:SOURce]:CORRection:FLATness:PRESet
This command presets the user-flatness correction to a factory- defined setting that consists of one
point.
Key Entr y Preset List
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 21
current data if needed. Refer to
“:FLATness:STORe” on page 23 for storing user- flatness files.
Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection)
:FLATness:STEP:POINts
Supported All Models
[:SOURce]:CORRection:FLATness:STEP:POINts <points> |MAXimum|MINimum|DEFault|
[:SOURce]:CORRection:FLATness:STEP:POINts?[MAXimum|MINimum]
This command is used to define the number of points in the user flatness calibration step array. See
also, “:FLATness:STEP:STARt” on page 22 and “:FLATness:STEP:STOP” on page 22.
Key Entr y # Points 2
:FLATness:STEP:STARt
Supported All Models
[:SOURce]:CORRection:FLATness:STEP:STARt <freq><unit> |MAXimum|MINimum|DEFault|
[:SOURce]:CORRection:FLATness:STEP:STARt? [MAXimum|MINimum]
This command sets the start frequency for the user flatness calibration step array. See also,
“:FLATness:STEP:POINts” on page 22 and “:FLATness:STEP:STOP” on page 22.
*RST Option 501: +1.0000000000000E+09
Option 503: +3.0000000000000E+09
Option 506: +6.0000000000000E+09
Range Option 501: 100kHz–1GHz
Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Freq Start
Remarks Options 501 is specific to the N5181A.
:FLATness:STEP:STOP
Supported All Models
[:SOURce]:CORRection:FLATness:STEP:STOP <freq><unit> |MAXimum|MINimum|DEFault|
[:SOURce]:CORRection:FLATness:STEP:STOP? [MAXimum|MINimum]
This command sets the stop frequency for the user flatness calibration step array. See also,
“:FLATness:STEP:POINts” on page 22 and “:FLATness:STEP:STARt” on page 22.
*RST Option 501: +1.0000000000000E+09
Option 503: +3.0000000000000E+09
Option 506: +6.0000000000000E+09
Range Option 501: 100kHz–1GHz
Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Freq Stop
Remarks Options 501 is specific to the N5181A.
22 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Correction Subsystem ([:SOURce]:CORRection)
Basic Function Commands
:FLATness:STORe
Supported All Models
[:SOURce]:CORRection:FLATness:STORe "<file name>"
This command stores the current user-flatness correction data to a file named by the
:CORRection:FLATness:STORe command. The directory path is implied in the command and need not
be specified in the "<file name>" variable.
Key Entr y Store To File
Remarks For information on file name syntax, refer to “File Name Variables” on page 12.
[:STATe]
Supported All Models
[:SOURce]:CORRection[:STATe] ON|OFF|1|0
[:SOURce]:CORRection[:STATe]?
This command enables or disables the user-flatness corrections.
*RST 0
Key Entr y Flatness Off On
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 23
Basic Function Commands
Digital Modulation Subsystem—N5182A ([:SOURce])
Digital Modulation Subsystem—N5182A ([:SOURce])
:BURSt:STATe
Supported N5182A
[:SOURce]:BURSt:STATe ON|OFF|1|0
[:SOURce]:BURSt:STATe?
This command enables or disables the burst envelope function.
*RST 0
Key Entr y Burst Envelope Off On
:DM:CORRection:OPTimization
Supported N5182A
[:SOURce]:DM:CORRection:OPTimization RFOut|EXTernal
[:SOURce]:DM:CORRection:OPTimization?
This command enables the internal optimized path to accommodate I/Q signals.
EXT This choice enables the Baseband Generator to external I/Q output path, applies
correction terms, and provides a calibrated signal at the IQ output. When the
I/Q Output is selected, the RF signals at the RF Output are uncalibrated.
RFO This choice enables the Baseband Generator to RF output path, applies correction
*RST RFO
Key Entr y I/Q Correction Optimized Path
terms, and provides a calibrated signal at the RF output. When the RF Output is
selected, the I/Q signals at the I/Q Output are uncalibrated.
:DM:EXTernal:ALC:BANDwidth|BWIDth
Supported N5182A
NOTE Refer to the Programming Compatibility Guide for information on this command. This
24 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
command was replaced by the “:ALC:BANDwidth|BWIDth” command shown in Chapter 6.
Digital Modulation Subsystem—N5182A ([:SOURce])
Basic Function Commands
:DM:EXTernal:POLarity
Supported N5182A
[:SOURce]:DM:EXTernal:POLarity NORMal|INVert
[:SOURce]:DM:EXTernal:POLarity?
This command sets the phase polarity for the I/Q signal.
NORMal This choice selects normal phase polarity for the I and Q signals.
INVert This choice flips the I and Q signals by routing the I signal to the Q input of the
*RST NORM
Key Entr y Int Phase Polarity Norm al Invert
I/Q modulator and the Q signal to the I input.
:DM:IQADjustment:DELay
Supported N5182A
[:SOURce]:DM:IQADjustment:DELay <value><unit>
[:SOURce]:DM:IQADjustment:DELay?
This command enables you to change the absolute phase of both I and Q with respect to triggers and
markers. A positive value delays I and Q. This value affects both the external I/Q out signals and the
baseband signal modulated on the RF output. This adjustment cannot be used with constant envelope
modulation and does not affect external I/Q inputs.
The variable <value> is expressed in seconds.
*RST +0.00000000E+000
Range −400 νσ το 400 νσ
Key Entr y I/Q Delay
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:EXTernal:COFFset
Supported N5182A
[:SOURce]:DM:IQADjustment:EXTernal:COFFset <value>
[:SOURce]:DM:IQADjustment:EXTernal:COFFset?
This command sets the common mode offset voltage for both the in-phase (I) and quadrature- phase
(Q) signals going to the rear panel I and Q output connectors.
The variable <value> is expressed in units of volts (mV–V).
*RST +0.00000000E+000
Range ∠2.5 to 2.5V
Key Entr y Common Mode I/Q Offset
Remarks This command is effective only if the state of the I/Q adjustment function is set to
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 25
Basic Function Commands
Digital Modulation Subsystem—N5182A ([:SOURce])
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:EXTernal:DIOFfset
Supported N5182A
[:SOURce]:DM:IQADjustment:EXTernal:DIOFfset <value>
[:SOURce]:DM:IQADjustment:EXTernal:DIOFfset?
This command sets the differential offset voltage for an in- phase (I) signal routed to the I output
connectors.
The variable <value> is expressed in units of volts (mV–V).
*RST +0.00000000E+000
Range −25mV to 25mV
Key Entr y Diff. Mode I Offset
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:EXTernal:DQOFfset
Supported N5182A
[:SOURce]:DM:IQADjustment:EXTernal:DQOFfset <value>
[:SOURce]:DM:IQADjustment:EXTernal:DQOFfset?
This command sets the differential offset voltage for a quadrature- phase (Q) signal routed to the Q
output connectors.
*RST +0.00000000E+000
Range −25mV to 25mV
Key Entr y Diff. Mode Q Offset
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:EXTernal:IOFFset
Supported E4438C
[:SOURce]:DM:IQADjustment:EXTernal:IOFFset <value>
[:SOURce]:DM:IQADjustment:EXTernal:IOFFset?
This command sets the offset voltage for a signal applied to the 600 ohm I input connector.
The variable <value> is expressed in units of volts (mV–V).
*RST +0.00000000E+000
Key Entr y External Input I Offset
Range −100 mV to 100 mV
26 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Digital Modulation Subsystem—N5182A ([:SOURce])
Basic Function Commands
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:IOFFset
Supported N5182A
[:SOURce]:DM:IQADjustment:IOFFset <value><unit>
[:SOURce]:DM:IQADjustment:IOFFset?
This command adjusts the I channel offset value.
When using this command to minimize the LO feedthrough signal, optimum performance is achieved
when the command is sent after all other I/Q path commands are executed, such as those that
change the internal phase polarity or adjust the modulator attenuator. If other adjustments are made
after minimizing is performed, the LO feedthrough signal may increase.
The variable <value> is expressed in units of percent with a minimum resolution of 0.025.
*RST +0.00000000E+000
Range −20.000 to 20.000
Key Entr y I Offset
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:QOFFset
Supported N5182A
[:SOURce]:DM:IQADjustment:QOFFset
[:SOURce]:DM:IQADjustment:QOFFset?
This command adjusts the Q channel offset value.
When using this command to minimize the LO feedthrough signal, optimum performance is achieved
when the command is sent after all other I/Q path commands are executed, such as those that
change the internal phase polarity or adjust the modulator attenuator. If other adjustments are made
after minimizing is performed, the LO feedthrough signal may increase.
The variable <value> is expressed in units of percent with a minimum resolution of 0.025.
*RST +0.00000000E+000
Range −20.000 to 20.000
Key Entr y Q Offset
Remarks This command is effective only if the state of the I/Q adjustment function is set to
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 27
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
Basic Function Commands
Digital Modulation Subsystem—N5182A ([:SOURce])
:DM:IQADjustment:EXTernal:QOFFset
Supported E4438C
[:SOURce]:DM:IQADjustment:EXTernal:QOFFset <value>
[:SOURce]:DM:IQADjustment:EXTernal:QOFFset?
This command sets the offset voltage for a signal applied to the 600 ohm Q input connector.
The variable <value> is expressed in units of volts (mV–V).
*RST +0.00000000E+000
Range −100 mV to 100 mV
Key Entr y External Input Q Offset
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:EXTernal:QSKew
Supported N5182A
[:SOURce]:DM:IQADjustment:EXTernal:QSKew <value>
[:SOURce]:DM:IQADjustment:EXTernal:QSKew?
CAUTION This Q phase angle adjustment is uncalibrated.
This command adjusts the phase angle (quadrature skew) between the I and Q vectors by increasing
or decreasing the Q phase angle. This command adjusts the signals externally input to the signal
generator’s front panel Q input connector. For more information on this connector, refer to the User’s
Guide.
The <value> variable is expressed in degrees with a minimum resolution of 0.1.
If the signal generator is operating at frequencies greater than 3.3 GHz, quadrature skew settings
greater than ±5 degrees will not be within specifications.
Positive skew increases the angle from 90 degrees while negative skew decreases the angle from
90 degrees. When the quadrature skew is zero, the phase angle between the I and Q vectors is 90
degrees.
This command is effective only if the state of the I/Q adjustment function is set to ON. Refer to
“:DM:IQADjustment[:STATe]” on page 30.
Example
:DM:IQAD:EXT:QSK 4.5
The preceding example increases the phase angle by 4.5 degrees.
*RST +0.00000000E+000
Range −200 to +200
Key Entr y Quadrature Angle Adjustment
28 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Digital Modulation Subsystem—N5182A ([:SOURce])
Basic Function Commands
:DM:IQADjustment:GAIN[1]
Supported N5182A
[:SOURce]:DM:IQADjustment:GAIN[1] <value><unit>
[:SOURce]:DM:IQADjustment:GAIN[1]?
This command sets the gain for the I signal relative to the Q signal.
The variable <value> is expressed in units of decibels (dB).
*RST +0.00000000E+000
Range −1 to 1
Key Entr y I/Q Gain Balance
Remarks This command is effective only if the state of the I/Q adjustment function is set to
ON. Refer to “:DM:IQADjustment[:STATe]” on page 30.
:DM:IQADjustment:QSKew
Supported N5182A
[:SOURce]:DM:IQADjustment:QSKew <value>
[:SOURce]:DM:IQADjustment:QSKew?
This command adjusts the phase angle (quadrature skew) between the I and Q vectors by increasing
or decreasing the Q phase angle.
The <value> variable is expressed in degrees with a minimum resolution of 0.1.
If the signal generator is operating at frequencies greater than 3.3 GHz, quadrature skew settings
greater than ±5 degrees will not be within specifications.
Positive skew increases the angle from 90 degrees while negative skew decreases the angle from
90 degrees. When the quadrature skew is zero, the phase angle between the I and Q vectors is 90
degrees.
This command is effective only if the state of the I/Q adjustment function is set to ON. Refer to
“:DM:IQADjustment[:STATe]” on page 30.
Example
:DM:IQAD:QSK 4.5
The preceding example increases the phase angle by 4.5 degrees.
*RST +0.00000000E+000
Range −1E1 to +1E1
Key Entr y Quadrature Angle Adjustment
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 29
Basic Function Commands
Digital Modulation Subsystem—N5182A ([:SOURce])
:DM:IQADjustment:SKEW
Supported N5182A
[:SOURce]:DM:IQADjustment:SKEW <value>
[:SOURce]:DM:IQADjustment:SKEW?
This command changes the I/Q skew which is a time delay difference between the I and Q signals.
Equal and opposite skew is applied to both I and Q and affects the RF Output and I/Q output paths
simultaneously. A positive value delays the I signal relative to the Q signal, and a negative value
delays the Q signal relative to the I signal.
Example
:DM:IQAD:SKEW 5E–9
The preceding example sets the time delay difference between the I and Q signals to 5 nanoseconds.
*RST +0.00000000E+000
Range −800ns to +800ns
Key Entr y I/Q Skew
:DM:IQADjustment[:STATe]
Supported N5182A
[:SOURce]:DM:IQADjustment[:STATe] ON|OFF|1|0
[:SOURce]:DM:IQADjustment[:STATe]?
This command enables or disables the I/Q adjustments.
Example
:DM:IQAD 1
The preceding example enables I/Q adjustments.
*RST 0
Key Entr y I/Q Adjustments Off On
:DM:POLarity[:ALL]
Supported N5182A
[:SOURce]:DM:POLarity[:ALL] NORMal|INVert
[:SOURce]:DM:POLarity?
This command sets the digital modulation phase polarity.
This softkey is found under the I/Q menu.
NORMal This choice selects normal phase polarity for the I and Q signals.
INVert This choice inverts the Q channel signal.
*RST NORM
Key Entr y Int Phase Polarity Norm al Invert
30 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Digital Modulation Subsystem—N5182A ([:SOURce])
Basic Function Commands
:DM:SOURce
Supported N5182A
[:SOURce]:DM:SOURce EXTernal|INTernal|SUM
[:SOURce]:DM:SOURce?
This command selects the I/Q modulator source.
This softkey is found under the I/Q menu.
EXTernal This choice selects a 50 ohm impedance for the I and Q input connectors and
routes the applied signals to the I/Q modulator.
INTernal This choice selects the internal baseband generator as the source for the I/Q
modulator and requires Option 651/652/654.
Sum This choice selects the internal baseband generator and combines that signal with
an external source and routes the applied signals to the I/Q modulator and
requires Option 651/652/654.
*RST INT
Key Entry External Internal Sum
:DM:STATe
Supported N5182A
[:SOURce]:DM:STATe ON|OFF|1|0
[:SOURce]:DM:STATe?
This command enables or disables the I/Q modulator.
The I/Q modulator is enabled whenever a digital format is turned on.
The I/Q annunciator will be shown on the signal generator display whenever the I/Q modulator is
on.
ON (1) This choice enables the internal I/Q modulator.
OFF (0) This choice disables the internal I/Q modulator. You can turn off the I/Q
modulation with this choice even though a digital modulation format is enabled.
With this configuration, the RF output signal will not be modulated, but the I/Q
signals may be present at the rear panel I and Q outputs depending on the rear
panel output selection.
*RST 0
Key Entr y I/Q Off On
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 31
Basic Function Commands
Frequency Subsystem ([:SOURce])
Frequency Subsystem ([:SOURce])
:FREQuency:CENTer
Supported All Models
[:SOURce]:FREQuency:CENTer <num>[<freq_suffix>]|UP|DOWN
[:SOURce]:FREQuency:CENTer? [MAXimum|MINimum]
This command sets the center frequency for a step sweep. The center frequency symmetrically divides
the selected frequency span and is coupled to the start and stop frequency settings. The frequency
range and reset values are dependent on the signal generator model and option number.
The query returns the start and stop frequencies if the optional MAXimum or MINimum are used.
*RST
a.Option 501 is available only on the N5181A.
a
Range
a.Settable, but not specified to 100 Hz.
Option 501
Option 503: +3.0000000000000E+9
Option 506: +6.0000000000000E+9
Option 501: 250 kHz–1 GHz
Option 503: 250 kHz–3 GHz
Option 506: 250 kHz–6 GHz
Example
:FREQ:CENT .5 GHz
The preceding example sets the center frequency for a sweep to .5 GHz.
Key Entr y Freq Center
a
:+1.0000000000000E+9
:FREQuency:CHANnels:BAND
Supported All Models
[:SOURce]:FREQuency:CHANnels:BAND NBASe|NMOBile|BPGSm|MPGSm|BEGSm|MEGSm|
BRGSm|MRGSm|BDCS|MDCS|BPCS|MPCS|B450|GM450|B480|M480|B850|M850|B8|M8|B15|M15|B390|B42
0|B460|B915|M380|M410|M450|M870|PHS|DECT
[:SOURce]:FREQuency:CHANnels:BAND?
This command sets the frequency of the signal generator by specifying a frequency channel band. The
frequency channel state must be enabled for this command to work. See
“:FREQuency:CHANnels[:STATe]” on page 35.
Table 2-1 Frequency Channel Bands
SCPI Paramet er Frequency Channel Band
Selected
NBASe Standard Base NADC
NMOBile Standard Mobile NADC
BPGSm P- Gsm 900 Base GSM
MPGSm P- Gsm 900 Mobile GSM
BEGSm E- Gsm 900 Base GSM
32 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Standard
Table 2-1 Frequency Channel Bands
Basic Function Commands
Frequency Subsystem ([:SOURce])
SCPI Paramet er Frequency Channel Band
Selected
MEGSm E- Gsm 900 Mobile GSM
BRGSm R- Gsm 900 Base GSM
MRGSm R- Gsm 900 Mobile GSM
BDCS DCS 1800 Base GSM
MDCS DCS 1800 Mobile GSM
BPCS PCS 1900 Base GSM
MPCS PCS 1900 Mobile GSM
B450 Gsm 450 Base GSM
GM450 Gsm 450 Mobile GSM
B480 Gsm 480 Base GSM
M480 Gsm 480 Mobile GSM
B850 Gsm 850 Base GSM
M850 Gsm 850 Mobile GSM
B8 800MHz Base PDC
M8 800MHz Mobile PDC
B15 1500MHz Base PDC
M15 1500MHz Mobile PDC
B390 Base 390- 400 TETRA
B420 Base 420- 430 TETRA
B460 Base 460- 470 TETRA
B915 Base 915- 921 TETRA
M380 Mobile 380- 390 TETRA
M410 Mobile 410- 420 TETRA
M450 Mobile 450- 460 TETRA
M870 Mobile 870- 876 TETRA
PHS Standard PHS PHS
DECT Standard DECT DECT
Standard
Example
:FREQ:CHAN:BAND DECT
The preceding example sets the frequency band to standard DECT.
*RST BPGS
Key E nt ry P-GSM Base E-GSM Base R-GSM Base DCS Base
PCS Base GSM 450 Base GSM 480 Base GSM 850
NADC Base 800MHz Base 1500MHz Base
Tetra Base 390/400 Tetra Base 420/430 Tetra Base 460/470
Tetra Base 915/921 PHS Standard DECT Standard
P-GSM Mobile E-GSM Mobile R-GSM Mobile DCS Mobile
Base
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 33
Basic Function Commands
Frequency Subsystem ([:SOURce])
PCS Mobile GSM 450 Mobile GSM 480 Mobile GSM 850 Mobile
NADC Mobile 800MHz Mobile 1500MHz Mobile
Tetra Mobile 380/390 Tetra Mobile 410/420 Tetra Mobile 450/460
Tetra Mobile 870/876
:FREQuency:CHANnels:NUMBer
Supported All Models
[:SOURce]:FREQuency:CHANnels:NUMBer <number>
[:SOURce]:FREQuency:CHANnels:NUMBer?
This command sets the frequency of the signal generator by specifying a channel number of a given
frequency band.
The channel band and channel state must be enabled for this command to work. Refer to
“:FREQuency:CHANnels[:STATe]” on page 35.
Example
:FREQ:CHAN:NUMB 24
The preceding example sets the channel number to 24 for the current band.
*RST +1
Range P- GSM Base/Mobile: 1–24
E- GSM and R- GSM Base/Mobile: 1–1023
DCS Base/Mobile: 512–885
PCS Base/Mobile: 512–900
GSM- 450 Base/Mobile: 259–293
GSM- 480 Base/Mobile: 306–340
GSM- 850 Base/Mobile: 128–251
NADC Base/Mobile: 1–1023
800MHz Base/Mobile: 0–640
1500MHz Base/Mobile: 0–960
TETRA 380/390 Mobile: 3600–4000
TETRA 390/4000 Base: 3600–4000
TETRA 410/420 Mobile: 800–1200
TETRA 420/430 Base: 800–1200
TETRA 460/470: 2400 through 2800 2400–2800
TETRA 870/876 Mobile: 600–640
TETRA 915/921 Base: 600–940
34 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Basic Function Commands
Frequency Subsystem ([:SOURce])
PHS Standard: 1–255
DECT Standard: 0–9
Key Entr y Channel Number
:FREQuency:CHANnels[:STATe]
Supported All Models
[:SOURce]:FREQuency:CHANnels[:STATe] ON|OFF|1|0
[:SOURce]:FREQuency:CHANnels[:STATe]?
This command enables or disables the frequency channel and band selection. The signal generator
frequency will be set to the channel frequency when the state is on. To set frequency channel bands
refer to “:FREQuency:CHANnels:BAND” on page 32.
Example
:FREQ:CHAN ON
The preceding example turns on the frequency channel.
*RST 0
Key Entr y Freq Channels Off On
:FREQuency:FIXed
Supported All Models
[:SOURce]:FREQuency:FIXed <value><unit>
[:SOURce]:FREQuency:FIXed?
This command sets the signal generator output frequency.
*RST Option 501:+1.0000000000000E+09
Option 503: +3.0000000000000E+09
Option 506: +6.0000000000000E+09
Range Option 501: 100kHz–1GHz
Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Remarks A frequency change may affect the current output power. Refer to
“[:LEVel][:IMMediate][:AMPLitude]” on page 57 for the correct specified frequency
and amplitude settings. To set the frequency mode refer to “:FREQuency:MODE”
on page 36. Option 501 is specific to the N5181A.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 35
Basic Function Commands
Frequency Subsystem ([:SOURce])
:FREQuency:MODE
Supported All Models
[:SOURce]:FREQuency:MODE CW|FIXed|LIST
[:SOURce]:FREQuency:MODE?
This command sets the frequency mode of the signal generator to CW or swept.
CW and FIXed These choices are synonymous with one another and stops a frequency sweep,
LIST This choice selects the swept frequency mode. If sweep triggering is set to
allowing the Agilent MXG to operate at a set frequency. Refer to
“:FREQuency[:CW]” on page 39 for setting the frequency in the CW mode and to
“:FREQuency:FIXed” on page 35 for setting the frequency in the FIXed mode.
immediate along with continuous sweep mode, executing the command starts the
LIST or STEP frequency sweep.
NOTE To perform a frequency and amplitude sweep, you must also select LIST as the power mode.
*RST CW
Key Entr y Freq Freq Off
See “:MODE” on page 54 for selecting the list mode for an amplitude sweep.
:FREQuency:MULTiplier
Supported All Models
[:SOURce]:FREQuency:MULTiplier <value>
[:SOURce]:FREQuency:MULTiplier?
This command sets the multiplier for the signal generator carrier frequency. This displayed frequency
equals the actual frequency times the multiplier.
*RST +1.00000000E+000
Range Negative Values: –1000 to –.001 Positive Values: .001–1000
Key Entr y Freq Multiplier
Remarks For any multiplier other than one, the MULT indicator is shown in the frequency
area of the display.
:FREQuency:OFFSet
Supported All Models
[:SOURce]:FREQuency:OFFSet <value><unit>
[:SOURce]:FREQuency:OFFSet?
This command sets the frequency offset.
The query of this command returns a value equal to the original output frequency times the
multiplier value, plus the frequency offset value. This displayed frequency equals the actual frequency
times the multiplier.
36 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Basic Function Commands
Frequency Subsystem ([:SOURce])
When an offset has been entered, the OFFS indicator is turned on in the frequency area of the
display.
The frequency offset state is turned on when any non- zero value is entered; entering zero will turn
it off. Refer to :FREQuency:OFFSet:STATe for setting the offset state independent of entering offset
values.
*RST +0.0000000000000E+00
Range −200GHz to 200GHz
Key Entr y Freq Offset
:FREQuency:OFFSet:STATe
Supported All Models
[:SOURce]:FREQuency:OFFSet:STATe ON|OFF|1|0
[:SOURce]:FREQuency:OFFSet:STATe?
This command enables or disables the offset frequency.
*RST 0
Key Entr y Freq Offset
Remarks Entering OFF (0) will set the frequency offset to 0 Hz.
:FREQuency:REFerence
Supported All Models
[:SOURce]:FREQuency:REFerence <value><unit>
[:SOURce]:FREQuency:REFerence?
This command sets the output reference frequency.
*RST +0.0000000000000E+00
Range Option 501: 0Hz–1GHz
Option 503: 0Hz–3GHz
Option 506: 0Hz–6GHz
Key Entr y Freq Ref S e t
Remarks Option 501 is specific to the N5181A.
:FREQuency:REFerence:SET
Supported All Models
[:SOURce]:FREQuency:REFerence:Set
This command sets the current CW output frequency, along with any offset, as a 0 hertz reference
value.
*RST +0.0000000000000E+00
Key Entr y Freq Ref S e t
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 37
Basic Function Commands
Frequency Subsystem ([:SOURce])
:FREQuency:REFerence:STATe
Supported All Models
[:SOURce]:FREQuency:REFerence:STATe ON|OFF|1|0
[:SOURce]:FREQuency:REFerence:STATe?
This command enables or disables the frequency reference mode.
When the frequency reference mode is on, subsequent frequency parameters are set relative to the
reference value.
*RST 0
Key Entr y Freq Ref Off On
:FREQuency:SPAN
Supported All Models
[:SOURce]:FREQuency:SPAN <num>[<freq_suffix>]|UP|DOWN
[:SOURce]:FREQuency:SPAN? [MAXimum|MINimum]
This command sets the length of the frequency range for a step sweep. Span setting is symmetrically
divided by the selected center frequency and is coupled to the start and stop frequency settings. The
span range is dependent on the signal generator model and option number.
Example
:FREQ:SPAN 100MHz
The preceding example sets the frequency span to 100 megahertz.
*RST +0.0000000000000E+00
Key Entr y Freq Span
:FREQuency:STARt
Supported All Models
[:SOURce]:FREQuency:STARt <value><unit>
[:SOURce]:FREQuency:STARt?
This command sets the first frequency point in a step sweep.
*RST Option 501: +1.0000000000000E+09
Option 503: +3.0000000000000E+09
Option 506: +6.0000000000000E+09
Range Option 501: 100kHz–1GHz
Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Freq Start
Remarks Option 501 is specific to the N5181A.
38 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Basic Function Commands
Frequency Subsystem ([:SOURce])
:FREQuency:STOP
Supported All Models
[:SOURce]:FREQuency:STOP <value><unit>
[:SOURce]:FREQuency:STOP?
This command sets the last frequency point in a step sweep.
*RST Option 501: +1.0000000000000E+09
Option 503: +3.0000000000000E+09
Option 506: +6.0000000000000E+09
Range Option 501: 100kHz–1GHz
Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Freq Stop
Remarks Option 501 is specific to the N5181A.
:FREQuency[:CW]
Supported All Models
[:SOURce]:FREQuency[:CW] <value><unit>
[:SOURce]:FREQuency[:CW]?
This command sets the signal generator output frequency for the CW frequency mode.
*RST Option 501: +1.0000000000000E+09
Option 503: +3.0000000000000E+09
Option 506: +6.0000000000000E+09
Range Option 501: 100kHz–1GHz
Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Freq
Remarks To set the frequency mode to CW, refer to “:FREQuency:MODE” on page 36.
Option 501 is specific to the N5181A.
:PHASe:REFerence
Supported All Models
[:SOURce]:PHASe:REFerence
This command sets the current output phase as a zero reference.
Subsequent phase adjustments are set relative to the new reference.
Key Entr y Phase Ref Set
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 39
Basic Function Commands
Frequency Subsystem ([:SOURce])
:PHASe[:ADJust]
Supported All Models
[:SOURce]:PHASe[:ADJust] <value><unit>
[:SOURce]:PHASe[:ADJust]?
This command adjusts the phase of the modulating signal.
The query will only return values in radians.
*RST +0.00000000E+000
Range Radians: –3.14 to 3.14RAD Degrees: –180 to 179DEG
Key Entr y Adjust Phase
:ROSCillator:BANDwidth:EXTernal
Supported All Models
[:SOURce]:ROSCillator:BANDwidth:EXTernal
<value>[<units>]|NARRow|WIDE|MINimum|MAXimum|
[:SOURce]:ROSCillator:BANDwidth:EXTernal? |MINimum|MAXimum|
This command selects the external frequency bandwidth as the source for the measurement.
For values greater than 9.5 Hz, 73 Hz is used.
*RST +9.50000000E+000
Range .5 or 73 Hz
Key Entr y Ref Oscillator Ext Bandwidth
:ROSCillator:FREQuency:EXTernal
Supported All Models
[:SOURce]:ROSCillator:FREQuency:EXTernal <value>
[:SOURce]:ROSCillator:FREQuency:EXTernal?
This command makes External Ref Frequency the active function. The value that you enter sets the
frequency of the external reference oscillator.
*RST +1.0000000000000E+07 Hz
Range +1.0000000000000E+06 to +5.0000000000000E+07 Hz
Key Entr y Ref Oscillator Ext Freq
Remarks If the entered frequency does not match the frequency of the entered reference,
40 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
an unlocked condition will occur and an error message will appear.
Basic Function Commands
Frequency Subsystem ([:SOURce])
:ROSCillator:SOURce
Supported All Models
[:SOURce]:ROSCillator:SOURce?
This command queries the current reference oscillator source: INT (internal) or EXT (external).
:ROSCillator:SOURce:AUTO
Supported All Models
[:SOURce]:ROSCillator:SOURce:AUTO ON|OFF|1|0
[:SOURce]:ROSCillator:SOURce:AUTO?
This command enables or disables the ability of the signal generator to automatically select between
the internal and an external reference oscillator.
ON (1) This choice enables the signal generator to detect when a valid reference signal is
OFF (0) This choice selects the internal reference oscillator and disables the switching
*RST 1
Key Entr y Ref Oscillator Source Auto Off On
present at the 10 MHz IN connector and automatically switches from internal to
external frequency reference.
capability between the internal and an external frequency reference.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 41
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
List/Sweep Subsystem ([:SOURce])
A complete sweep setup requires commands from other subsystems. Table 2- 2 shows the function
and location of these other commands.
Table 2-2 Location of Commands from the other Subsystems
Sweep Type Function Command Location Key Entry under
List and Step Start/stop frequency sweep “:FREQuency:MODE” on page 36 Freq Off On
Start/stop amplitude sweep “:MODE” on page 54 Amptd Off On
Start/stop frequency and
amplitude sweep
Enables or Disables the
waveform sweep
Set up and control sweep
triggering
List Load a list sweep file “:LOAD:LIST” on page 88 and
Store list sweep data to a file “:STORe:LIST” on page 85 and
Selects the waveform for the
current waveform sequence
Step Start frequency sweep “:FREQuency:STARt” on page 38 Freq Start
Store list sweep data to a file “:STORe:LIST” on page 85 and
Start amplitude sweep “:STARt” on page 55 Amptd Start
a
b
“:MODE” on page 54
“:FREQuency:MODE” on page 36
“[:STATe]” on page 164 Waveform Off On
“Trigger Subsystem” on page 115 See the “Trigger
page 88
page 85
“:LIST:WAVeform” on page 48 no softkey
page 85
Sweep/List key
Freq & Amptd
Off On
Subsystem”
Load From Selected
File
Store To File
Store To File
Stop amplitude sweep “:STOP” on page 56 Amptd Stop
a.Execute both commands to start or stop a frequency and amplitude sweep.
b.For point to point triggering, see “:L IS T :TRIGger:SOURce” on page 46.
42 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Basic Function Commands
List/Sweep Subsyst em ([:S O URce])
:LIST:DIRection
Supported All Models
[:SOURce]:LIST:DIRection UP|DOWN
[:SOURce]:LIST:DIRection?
This command sets the direction of a list or step sweep.
UP This choice enables a sweep in an ascending order:
• first to last point for a list sweep
• start to stop for a step sweep
DOWN This choice reverses the direction of the sweep.
*RST UP
Key Entr y Sweep Direction Down Up
:LIST:DWELl
Supported All Models
[:SOURce]:LIST:DWELl <value>{,<value>}
[:SOURce]:LIST:DWELl?
This command sets the dwell time for the current list sweep points.
Dwell time is used when IMMediate is the trigger source. Refer to “:LIST:TRIGger:SOURce” on page 46
for the trigger setting.
The dwell time is the amount of time the sweep is guaranteed to pause after setting the frequency
and/or power for the current point.
The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
The variable <value> is expressed in units of seconds with a 0.001 resolution.
NOTE The dwell time (<value>) does not begin until the signal generator has settled for the current
Range 0.0001–100
frequency and/or amplitude change.
:LIST:DWELl:POINts
Supported All Models
[:SOURce]:LIST:DWELl:POINts?
This command queries the signal generator for the number of dwell points in the current list sweep
file.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 43
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
:LIST:DWELl:TYPE
Supported All Models
[:SOURce]:LIST:DWELl:TYPE LIST|STEP
[:SOURce]:LIST:DWELl:TYPE?
This command toggles the dwell time for the list sweep points between the values defined in the list
sweep and the value for the step sweep.
LIST This choice selects the dwell times from the list sweep. Refer to “:LIST:DWELl” on
page 43 for setting the list dwell points.
STEP This choice selects the dwell time from the step sweep. Refer to “:SWEep:DWELl”
on page 48 for setting the step dwell.
*RST LIST
Key Entr y Dwell Type List Step
:LIST:FREQuency
Supported All Models
[:SOURce]:LIST:FREQuency <value>{,<value>}
[:SOURce]:LIST:FREQuency?
This command sets the frequency values for the current list sweep points.
The maximum number of list sweep points is 1,601.
The variable <value> is expressed in units of Hertz.
The setting enabled by this command is not affected by signal generator power-on, preset, or *RST.
Option 501 is specific to the N5181A.
Range Option 501: 1.0E3–1E9
Option 503: 1.0E3–3E9
Option 506: 1.0E3–6E9
:LIST:FREQuency:POINts
Supported All Models
[:SOURce]:LIST:FREQuency:POINts?
This command queries the current list sweep file for the number of frequency points.
44 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Basic Function Commands
List/Sweep Subsyst em ([:S O URce])
:LIST:MANual
Supported All Models
[:SOURce]:LIST:MANual <value>|UP|DOWN
[:SOURce]:LIST:MANual?
This command sets a list or step sweep point as the current sweep point controlling the frequency
and power output.
If list or step mode is controlling frequency or power, or both, then the indexed point in the
respective list(s) will be used.
Entering a value with this command will have no effect, unless MANual is the selected mode. Refer
to “:LIST:MODE” on page 45 for setting the proper mode.
If the point selected is beyond the length of the longest enabled list, then the point will be set to the
maximum possible point, and an error will be generated.
Range List Sweep: 1–1601 Step Sweep: 2- 65535
Key Entr y Manual Point
:LIST:MODE
Supported All Models
[:SOURce]:LIST:MODE AUTO|MANual
[:SOURce]:LIST:MODE?
This command sets the operating mode for the current list or step sweep.
AUTO This choice enables the selected sweep type to perform a sweep of all points.
MANual This choice enables you to select a single sweep point. The selected point controls
*RST AUTO
Key Entr y Manual Mode Off On
the frequency and/or amplitude according to the sweep type. Refer to
“:LIST:MANual” on page 45 for selecting a sweep point.
:LIST:POWer
Supported All Models
[:SOURce]:LIST:POWer <value>{,<value>}
[:SOURce]:LIST:POWer?
This command sets the amplitude for the current list sweep points.
The maximum number of list sweep points is 1,601.
Range Refer to “[:LEVel][:IMMediate][:AMPLitude]” on page 57 for output power ranges.
Remarks The setting enabled by this command is not affected by signal generator power-on,
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 45
preset, or *RST.
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
:LIST:POWer:POINts
Supported All Models
[:SOURce]:LIST:POWer:POINts?
This command queries the number of power points in the current list sweep file.
:LIST:RETRace
Supported All Models
[:SOURce]:LIST:RETRace ON|OFF|1|0
[:SOURce]:LIST:RETRace?
This command configures the sweep to retrace to the first sweep point, or stop at the last sweep
point upon completion of each sweep.
On (1) The sweep retraces to the first sweep point.
Off (0) The sweep stays at the last sweep point of the completed sweep and stays there
*RST 1
Key Entr y Sweep Retrace Off On
until sweep is initiated and triggered again. When sweep is initiated and triggered
again the sweep point moves to the first point of the sweep.
:LIST:TRIGger:SOURce
Supported All Models
[:SOURce]:LIST:TRIGger:SOURce BUS|IMMediate|EXTernal|KEY|TIMer|MANual
[:SOURce]:LIST:TRIGger:SOURce?
This command sets the point trigger source for a list or step sweep event.
To set the sweep trigger, see “:TRIGger[:SEQuence]:SOURce” on page 116.
BUS This choice enables GPIB triggering using the *TRG or GET command, or
LAN and USB triggering using the *TRG command.
IMMediate This choice enables immediate triggering of the sweep event.
EXTernal This choice enables the triggering of a sweep event by an externally applied signal
Trigger KEY This choice enables triggering by pressing the front-panel Trigger hardkey.
TIMer This choice enables the trigger timer.
Example
:LIST:TRIG:SOUR BUS
The preceding example sets the trigger source to the instrument BUS.
*RST IMM
Key E nt ry Bus Free Run Ext Trigger Key Timer Trigger
46 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
at the TRIGGER IN connector.
Basic Function Commands
List/Sweep Subsyst em ([:S O URce])
:LIST:TYPE
Supported All Models
[:SOURce]:LIST:TYPE LIST|STEP
[:SOURce]:LIST:TYPE?
This command toggles between the two types of sweep.
LIST This type of sweep has arbitrary frequencies and amplitudes.
STEP This type of sweep has equally spaced frequencies and amplitudes.
*RST STEP
Key Entr y Sweep Type List Step
:LIST:TYPE:LIST:INITialize:FSTep
Supported All Models
CAUTION The current list sweep data will be overwritten once this command is executed. If
[:SOURce]:LIST:TYPE:LIST:INITialize:FSTep
This command replaces the loaded list sweep data with the settings from the current step sweep data
points.
You can load only one sweep list at a time.
The maximum number of list sweep points is 1,601. When copying the step sweep settings over to a
list sweep, ensure that the number of points in the step sweep do not exceed the maximum list
sweep points.
Key Entr y Load List From Step Sweep
needed, save the current data. Refer to “:STORe:LIST” on page 85 for storing list sweep
files.
:LIST:TYPE:LIST:INITialize:PRESet
Supported All Models
CAUTION The current list sweep data will be overwritten once this command is executed. If
needed, save the current data. Refer to “:STORe:LIST” on page 85 for storing list sweep
files.
[:SOURce]:LIST:TYPE:LIST:INITialize:PRESet
This command replaces the current list sweep data with a factory- defined file consisting of one point
at a frequency, amplitude, and dwell time.
Key Entr y Preset List
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 47
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
:LIST:WAVeform
Supported N5182A
CAUTION The current list sweep data will be overwritten once this command is executed. If
[:SOURce]:LIST:WAVeform <name>{,<name>}
[:SOURce]:LISt:WAVeform?
This command sets the waveform values for the current list waveform sequence.
Example
:LIST:WAV "WFM1:RAMP_TEST_WFM","WFM1:SINE_TEST_WFM"
The preceding example loads the waveforms RAMP_TEST_WFM and SINE_TEST_WFM into the waveform
section of the List Table.
Remarks The setting enabled by this command is not affected by signal generator power-on,
needed, save the current data. Refer to “:STORe:LIST” on page 85 for storing list sweep
files.
preset, or *RST.
:LIST:WAVeform:POINts
Supported N5182A
[:SOURce]:LIST:WAVeform:POINts?
This query returns the number of waveform points in the current list sweep file.
:SWEep:DWELl
Supported All Models
[:SOURce]:SWEep:DWELl <value>
[:SOURce]:SWEep:DWELl?
This command enables you to set the dwell time for a step sweep.
The variable <value> is expressed in units of seconds with a 0.001 resolution.
The dwell time is the amount of time the sweep is guaranteed to pause after setting the frequency
and/or power for the current point.
NOTE The dwell time (<value>) does not begin until the signal generator has settled for the current
*RST +2.00000000E−003
Range 0.0001–100
Key Entr y Step Dwell
48 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
frequency and/or amplitude change.
Basic Function Commands
List/Sweep Subsyst em ([:S O URce])
Remarks Dwell time is used when the trigger source is set to IMMediate. Refer to
“:LIST:TRIGger:SOURce” on page 46 for the trigger setting.
:SWEep:POINts
Supported All Models
[:SOURce]:SWEep:POINts <value>
[:SOURce]:SWEep:POINts?
This command defines the number of step sweep points.
*RST 101
Range 2–65535
Key Entr y # Points
:SWEep:SPACing
Supported All Models
[:SOURce]:SWEep:SPACing LINear|LOGarithmic
[:SOURce]:SWEep:SPACing?
This command enables the signal generator linear or logrithmic sweep modes. These commands
require the signal generator to be in step mode.
These commands require the signal generator to be in step mode.
The instrument uses the specified start frequency, stop frequency, and number of points for both
linear and log measurements.
*RST LIN
Key Entr y Step Spacing LIN LOG
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 49
Basic Function Commands
Power Subsys t e m ([:SOURce]:P OWer)
Power Subsystem ([:SOURce]:POWer)
:ALC:LEVel
Supported All Models
[:SOURce]:POWer:ALC:LEVel <value><unit>
[:SOURce]:POWer:ALC:LEVel?
This command sets the automatic leveling control (ALC) level. Use this command after setting the
attenuation auto mode to On. Refer to “:ATTenuation:AUTO” on page 53 for setting the attenuation
auto mode.
The ALC is used to maintain the signal generator’s output power level by compensating for power
fluctuations due to drift, band changes, or load variations. After you set the ALC level, the signal
generator’s output power is monitored and corrected so that the power level setting is maintained.
Example
:POW:ALC:LEV 10DB
The preceding example sets the ALC to 10 dB.
*RST +1.00000000E+000
Range -20 to 20
Key Entr y Set ALC Level
:ALC:SEARch
Supported All Models
[:SOURce]:POWer:ALC:SEARch ON|1|ONCE
[:SOURce]:POWer:ALC:SEARch?
This command enables or disables the internal power search calibration. A power search is
recommended for pulse-modulated signals with pulse widths less than one microsecond.
ON (1) This choice executes the power search automatically with each change in RF
ONCE This choice executes a single power search of the current RF output signal.
*RST 1
Key Entry Do Power Search
Remarks Use this command when the ALC state is set to OFF (0). Refer to “:ALC[:STATe]”
frequency or power.
on page 52 for setting the ALC state.
:ALC:SEARch:REFerence
Supported All Models
[:SOURce]:POWer:ALC:SEARch:REFerence FIXed|MODulated
[:SOURce]:POWer:ALC:SEARch:REFerence?
This command sets either fixed or modulated modes of power search.
50 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Power Subsys t em ([:SOURce] :POWer)
FIXed This choice uses a 0.5 volt reference.
MODulated This choice uses the RMS value of the current I/Q modulation.
*RST FIX
Key Entry Power Search Reference Fixed Mod
Basic Function Commands
:ALC:SEARch:SPAN:START
Supported All Models
[:SOURce]:POWer:ALC:SEARch:SPAN:START <value><units>
[:SOURce]:POWer:ALC:SEARch:SPAN:START?
This command sets the start frequency for a span power search over a user specified range.
The start frequency has no default value. The start frequency value will be the last value set before
powering off the instrument.
Key Entr y Start Frequency
:ALC:SEARch:SPAN:STOP
Supported All Models
[:SOURce]:POWer:ALC:SEARch:SPAN:STOP <value><units>
[:SOURce]:POWer:ALC:SEARch:SPAN:STOP?
This command sets the stop frequency for a span power search over a user specified range.
The stop frequency has no default value. The stop frequency value will be the last value set before
powering off the instrument.
Key Entr y Stop Frequency
:ALC:SEARch:SPAN:TYPE
Supported All Models
[:SOURce]:POWer:ALC:SEARch:SPAN:TYPE FULL|USER
[:SOURce]:POWer:ALC:SEARch:SPAN:TYPE?
This command enables you to select the frequency range for a span power search. You can specify
the range (USER) or you can select the full range (FULL) of the signal generator.
Key Entr y Span Type User Full
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 51
Basic Function Commands
Power Subsys t e m ([:SOURce]:P OWer)
:ALC:SEARch:SPAN[:STATe]
Supported All Models
[:SOURce]:POWer:ALC:SEARch:SPAN[:STATe] ON|OFF|1|0
[:SOURce]:POWer:ALC:SEARch:SPAN[:STATe]?
This command enables (1) or disables (0) the span mode, allowing you to perform power searches
over a selected range of frequencies. The power search corrections are then stored and used
whenever the signal generator is tuned within the selected range.
:ALC[:STATe]
Supported All Models
[:SOURce]:POWer:ALC[:STATe] ON|OFF|1|0
[:SOURce]:POWer:ALC[:STATe]?
This command enables or disables the automatic leveling control (ALC) circuit.
*RST 1
Key Entr y ALC Off On
Remarks The purpose of the ALC circuit is to hold output power at a desired level by
adjusting the signal generator’s power circuits to compensate for power drift.
Power drift occurs over time and changes in temperature. Refer to the
N5181A/82A Agilent MXG Signal Generators User’s Guide for more information on
the ALC.
:ATTenuation
Supported All Models
[:SOURce]:POWer:ATTenuation <value><unit>
[:SOURce]:POWer:ATTenuation?
This command sets the signal generator’s attenuator level. Before setting the attenuator level, set the
“:ATTenuation:AUTO” function to Off which will disable ALC control.
In normal operation the attenuator level is selected by the signal generator’s automatic loop control
(ALC) which maintains the output power by adjusting internal circuits to compensate for any power
fluctuations due to drift, band changes, or load variations. In some applications, such as fast pulse
modulation, the ALC may not respond quickly enough to compensate for the pulse rise times. In this
case you can set the attenuator and override any ALC adjustments.
The output power is the ALC level minus the attenuator setting. The attenuator is set in increments
of 5 dB.
Example
:POW:ATT 10DB
The preceding example sets the attenuator to 10 dB.
*RST +115
Range 0 to 115 dB
52 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Power Subsys t em ([:SOURce] :POWer)
Key Entr y Set Atten
Basic Function Commands
:ATTenuation:AUTO
Supported All Models
[:SOURce]:POWer:ATTenuation:AUTO ON|OFF|1|0
[:SOURce]:POWer:ATTenuation:AUTO?
This command sets the state of the attenuator auto mode function.
ON (1) This selection allows the signal generator’s automatic level control (ALC) to adjust
OFF (0) This choice allows for a user- selected attenuator setting that is not affected by the
*RST 1
Key Entr y Atten Hold Off On
Remarks Refer to the “:ALC:LEVel” on page 50.
the attenuator so that a specified RF power level, at the Agilent MXG’s RF output
connector, is maintained.
signal generator’s ALC circuitry.
The OFF (0) selection can be used to eliminate power discontinuity normally
associated with attenuator switching during power adjustments.
:ATTenuation:BYPass
Supported All Models
[:SOURce]:POWer:ATTenuation:BYPass ON|OFF|1|0
[:SOURce]:POWer:ATTenuation:BYPass?
This command enables or disables the attenuator bypass setting. The attenuator hold mode must be
enabled to use this command.
ON (1) This selection allows the signal generator’s automatic level control (ALC) to adjust
OFF (0) This choice allows for a user- selected attenuator setting combined with the ALC
*RST 0
Key Entr y Atten Bypass Off On
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 53
the attenuator hold mode. Output power is controlled solely by the ALC setting.
setting.
Basic Function Commands
Power Subsys t e m ([:SOURce]:P OWer)
:MODE
Supported All Models
[:SOURce]:POWer:MODE FIXed|LIST
[:SOURce]:POWer:MODE?
This command sets the signal generator power mode to fixed or swept.
FIXed This choice stops a power sweep, allowing the signal generator to operate at a
LIST This choice selects the swept power mode. If sweep triggering is set to immediate
NOTE To perform a frequency and amplitude sweep, you must also select LIST as the frequency
mode. See “:FREQuency:MODE” on page 36 for selecting the list mode for a frequency sweep.
*RST FIX
Key Entr y SWEEP AmptdOff On
fixed power level. Refer to “[:LEVel][:IMMediate][:AMPLitude]” on page 57 for
setting the output power level.
along with continuous sweep mode, executing the command starts the LIST or
STEP power sweep.
:PROTection:STATe
Supported All models
[:SOURce]:POWer:PROTection[:STATe] ON|OFF|1|0
[:SOURce]:POWer:PROTection[:STATe]?
This command enables or disables the power search protection function. The power search protection
function sets the attenuator to its maximum level whenever a power search is initiated. This can be
used to protect devices that are sensitive to high average power or high power changes. The trade off
on using the power protection function is decreased attenuator life, as the attenuator will switch to
its maximum setting during a power search.
NOTE Continual or excessive use of the power search protection function can decrease attenuator
ON (1) Causes the attenuator to switch to and hold its maximum level setting during a
OFF (0) Sets the attenuator normal mode. The attenuator is not used during power search.
Example
:POW:PROT ON
The preceding example enables the power inhibit function.
*RST 0
Key Entr y RF During Power Search Normal Minimum
54 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
life.
power search.
Power Subsys t em ([:SOURce] :POWer)
Basic Function Commands
:REFerence
Supported All Models
[:SOURce]:POWer:REFerence <value><unit>
[:SOURce]:POWer:REFerence?
This command sets the power level for the signal generator RF output reference.
The RF output power is referenced to the value entered in this command.
*RST +0.00000000E+000
Range -400 to 300dBm
Key Entr y Amptd Ref Set
:REFerence:STATe
Supported All Models
[:SOURce]:POWer:REFerence:STATe ON|OFF|1|0
[:SOURce]:POWer:REFerence:STATe?
This command enables or disables the RF output reference.
Once the reference state is ON, all subsequent output power settings are set relative to the reference
value.
ON(1) This choice will set the power reference state to ON. The unit displayed for
commands, “:ANNotation:AMPLitude:UNIT” on page 71 and “:POWer” on page 114
will be expressed in dB.
OFF(0) This choice will set the power reference state to OFF.
*RST 0
Key Entr y Amptd Ref Off On
Remarks Amplitude offsets can be used with the amplitude reference mode.
:STARt
Supported All Models
[:SOURce]:POWer:STARt <value><unit>
[:SOURce]:POWer:STARt?
This command sets the first amplitude point in a step sweep.
*RST −1.35000000E+002
Range Refer to “[:LEVel][:IMMediate][:AMPLitude]” on page 57 for the output power
Key Entr y Amptd Start
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 55
ranges.
Basic Function Commands
Power Subsys t e m ([:SOURce]:P OWer)
:STOP
Supported All Models
[:SOURce]:POWer:STOP <value><unit>
[:SOURce]:POWer:STOP?
This command sets the last amplitude point in a step sweep.
*RST −1.35000000E+002
Range Refer to “[:LEVel][:IMMediate][:AMPLitude]” on page 57 for the output power
Key Entr y Amptd Stop
ranges.
[:LEVel][:IMMediate]:OFFSet
Supported All Models
[:SOURce]:POWer[:LEVel][:IMMediate]:OFFSet <value><unit>
[:SOURce]:POWer[:LEVel][:IMMediate]:OFFSet?
This command sets the power offset value.
*RST +0.00000000E+000
Range −200 dB to 200 dB
Key Entr y Amptd Offset
Remarks This simulates a power level at a test point beyond the RF OUTPUT connector
without changing the actual RF output power. The offset value only affects the
displayed amplitude setting.
You can enter an amplitude offset any time in either normal operation or
amplitude reference mode.
56 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Power Subsys t em ([:SOURce] :POWer)
Basic Function Commands
[:LEVel][:IMMediate][:AMPLitude]
Supported All Models
[:SOURce]:POWer[:LEVel][:IMMediate][:AMPLitude] <value><unit>
[:SOURce]:POWer[:LEVel][:IMMediate][:AMPLitude]?
This command sets the RF output power.
*RST –1.10000000E+002 (Standard) or −1.44000000E+002 (with Option 1EQ)
Range Frequency N5181A with
<250 kHz−250 GHz−110 to 10 dBm −110 to 10 dBm <−144 to 10 dBm
>250 kHz−1 GHz −110 to 18 dBm −110 to 18 dBm <−144 to 18 dBm
>1−3 GHz −110 to 16 dBm −110 to 16 dBm <−144 to 16 dBm
>3−4 GHz −110 to 16 dBm −110 to 16 dBm <−144 to 16 dBm
>4−6 GHz −110 to 4 dBm −110 to 4 dBm <−144 to 4 dBm
a.Settable, but specified to –127 dBm with Option 1EQ.
Option 501, 503 and 506
Key Entr y Amplitude
Remarks The ranges for this command are specified values from the data sheet.
N5182A with
Option 503 and Option 506
N5181A/82A
with Option 1EQ
a
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 57
Basic Function Commands
Tsweep Subsystem ([:S OU Rce])
Tsweep Subsystem ([:SOURce])
:TSWeep
Supported All Models
[:SOURce]:TSWeep
This command aborts the current sweep, then either arms or arms and starts a single list, depending
on the trigger type.
The command performs the following:
• arms a single sweep when BUS, EXTernal, or Trigger KEY is the trigger source selection
• arms and starts a single sweep when IMMediate is the trigger source selection
Key Entr y Single Sweep
58 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
3 System Commands
This chapter provides SCPI descriptions for subsystems dedicated to peripheral signal generator
operations common to all Agilent MXG models. This chapter contains the following major sections:
• “Calibration Subsystem (:CALibration)” on page 60
• “Communication Subsystem (:SYSTem:COMMunicate)” on page 63
• “Diagnostic Subsystem (:DIAGnostic[:CPU]:INFOrmation)” on page 68
• “Display Subsystem (:DISPlay)” on page 71
• “IEEE 488.2 Common Commands” on page 74
• “Memory Subsystem (:MEMory)” on page 79
• “Output Subsystem (:OUTPut)” on page 89
• “Route Subsystem (:ROUTe)” on page 91
• “Status Subsystem (:STATus)” on page 92
• “System Subsystem (:SYSTem)” on page 100
• “Trigger Subsystem” on page 115
• “Unit Subsystem (:UNIT)” on page 114
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 59
System Commands
Calibration Subsystem (:CALibration)
Calibration Subsystem (:CALibration)
:DCFM
Supported All
:CALibration:DCFM
This command initiates a DCFM or DCΦM calibration depending on the currently active modulation.
This calibration eliminates any dc or modulation offset of the carrier signal.
NOTE If the calibration is performed with a dc signal applied, any deviation provided by the dc
Key Entr y DCFM/DCFM Cal
Remarks Use this calibration for externally applied signals. While the calibration can also
signal will be removed and the new zero reference point will be at the applied dc level. The
calibration will have to be performed again when the dc signal is disconnected to reset the
carrier signal to the correct zero reference.
be performed for internally generated signals, dc offset is not a normal
characteristic for them.
:IQ:DC
Supported N5182A
:CALibration:IQ:DC
This command performs a one to two second adjustment that is not traceable to a standard. However,
it will minimize errors associated with IQ gain, quadrature, and offset voltages. This adjustment
minimizes errors for the current signal generator setting and at a single frequency. The DC
adjustment is volatile and must be repeated with each signal generator setting change. This command
can be sent while the RF On/Off is set to Off and the adjustment will still be valid when the RF is
enabled. IQ must be on to perform this adjustment.
The I/Q DC adjustment is dependent upon a number of instrument settings. If any of the instrument
settings change, the adjustment will become invalid. The dependent instrument settings are:
•RF frequency
• I/Q attenuation level
• Baseband generator settings
• I/Q polarity settings
• Baseband filter settings
• Path settings (Internal I/Q Mux Path 1 or Path 2)
• I/Q calibration (the I/Q DC calibration will be invalidated if any other I/Q calibration is executed
or if the Revert to Factory Default key is pressed)
• Temperature (±5 degrees)
The following instrument states will not invalidate the I/Q DC calibration:
60 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Calibration Subsystem (:CALibration)
• Power level changes
•I/Q Impairments
Key Entr y Execute Cal (with Calibration Type User Full set to DC)
System Commands
:IQ:DEFault
Supported N5182A
:CALibration:IQ:DEFault
This command will restore the original factory calibration data for the internal I/Q modulator.
Key Entr y Revert to Default Cal Setting s
:IQ:FULL
Supported N5182A
:CALibration:IQ:FULL
This command performs an adjustment to the I/Q offset, gain and quadrature for the full-frequency
range (regardless of the start and stop frequency settings) and stores the results in the signal
generator’s firmware.
Key Entr y Execute Cal (with Calibration Type User Full set to Full)
Remarks Start and stop frequencies will default to the full frequency range of the signal
generator.
:IQ:STARt
Supported N5182A
:CALibration:IQ:STARt <value><unit>
:CALibration:IQ:STARt?
This command sets the start frequency and automatically sets the calibration type to User for an I/Q
calibration.
The start frequency must be less than the current value of the stop frequency.
Range Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Start Frequency
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 61
System Commands
Calibration Subsystem (:CALibration)
:IQ:STOP
Supported N5182A
:CALibration:IQ:STOP <value><unit>
:CALibration:IQ:STOP?
This command sets the stop frequency and automatically sets the calibration type to User for an I/Q
calibration.
The stop frequency must be greater than the current value of the start frequency.
Range Option 503: 100kHz–3GHz
Option 506: 100kHz–6GHz
Key Entr y Stop Frequency
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
:IQ:TYPE
Supported N5182A
:CALibration:IQ:TYPE DC|USER|FULL
:CALibration:IQ:TYPE?
This command sets the IQ calibration type.
Key Entr y Calibration Type DC User Full
*RST DC
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
:IQ:[:USER]
Supported N5182A
:CALibration:IQ[:USER]
This command performs a IQ calibration according to the IQ calibration type. For information on
selecting the type of IQ calibration, refer to “:IQ:TYPE” on page 62.
Key Entr y Execute Cal
62 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Communication Subsystem (:SYSTem:COMMunicate)
Communication Subsystem (:SYSTem:COMMunicate)
System Commands
NOTE The settings enabled by the LAN commands are not affected by signal generator power-on,
preset, or *RST.
:GPIB:ADDRess
Supported All
:SYSTem:COMMunicate:GPIB:ADDRess <number>
:SYSTem:COMMunicate:GPIB:ADDRess?
This command sets the signal generator’s GPIB address.
Range 0–30
Key Entr y GPIB Address
:GTLocal
Supported All
:SYSTem:COMMunicate:GTLocal
This command sets the signal generator to local mode which enables front panel operation.
Key Entr y Local
:LAN:CONFig
Supported All Models
:SYSTem:COMMunicate:LAN:CONFig DHCP|MANual|AUTO
:SYSTem:COMMunicate:LAN:CONFig?
NOTE The SCPI query for the LAN setup returns the last power on state setting, which may or may
This command sets the signal generator’s internet protocol (IP) address.
MANual The user assigns an IP address to the signal generator.
DHCP The network assigns an IP address to the signal generator.
AUTO The network assigns an IP address to the signal generator with a fallback to
Example
:SYST:COMM:LAN:CONF DHCP
The preceding example sets up the signal generator LAN configuration to use a DHCP IP address.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 63
not be the currently displayed setting.
Auto- IP if DHCP fails. If both DHCP and Auto- IP fail, manual configuration will
be used.
System Commands
Communication Subsystem (:SYSTem:COMMunicate)
Key Entr y LAN Config
Remarks The SCPI query returns the current setting, not the saved setting.
:LAN:DOMain
Supported All
:SYSTem:COMMunicate:LAN:DOMain <string>
:SYSTem:COMMunicate:LAN:DOMain?
This command defines the domain name of the signal generator’s DNS server.
This entry defines the DNS server for the signal generator LAN connection.
Key Entr y Domain Name
Remarks The SCPI query returns the current setting, not the saved setting.
:LAN:DNS:DYNamic
Supported All
:SYSTem:COMMunicate:LAN:DNS:DYNamic ON|OFF|1|0
:SYSTem:COMMunicate:LAN:DNS:DYNamic?
This command turns dynamic Domain Name System (DNS) on/off.
Key Entr y Dynamic DNS Naming Off On
Remarks The SCPI query returns the current setting, not the saved setting.
:LAN:DNS:OVERride
Supported All
:SYSTem:COMMunicate:LAN:DNS:OVERride ON|OFF|1|0
:SYSTem:COMMunicate:LAN:DNS:OVERride?
This command enables you to override the DNS server that is returned by the DHCP server. The LAN
configuration type must be set to Auto or DHCP to use this feature.
Key Entr y DNS Server Override Off On
Remarks The SCPI query returns the current setting, not the saved setting.
If DNS Service Override is set to On, the DNS server setting defined with the DNS
Server softkey is used.
If DNS Service Override is set to Off, the setting returned by the DHCP Server is
used.
:LAN:DNS[:SERVer]
Supported All
:SYSTem:COMMunicate:LAN:DNS[:SERVer] <ipstring>
This command defines the IP address of the signal generator DNS server.
64 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Communication Subsystem (:SYSTem:COMMunicate)
This entry defines the DNS server for the signal generator LAN connection.
Key Entr y DNS Server
Remarks The SCPI query returns the current setting, not the saved setting.
System Commands
:LAN:GATeway
Supported All
:SYSTem:COMMunicate:LAN:GATeway "<ipstring>"
:SYSTem:COMMunicate:LAN:GATeway?
This command sets the gateway for local area network (LAN) access to the signal generator from
outside the current sub- network.
Key Entr y Default Gateway
Remarks Using an empty string restricts access to the signal generator to local hosts on the
LAN.
The SCPI query returns the current setting, not the saved setting.
:LAN:HOSTname
Supported All
:SYSTem:COMMunicate:LAN:HOSTname "<string>"
:SYSTem:COMMunicate:LAN:HOSTname?
This command sets the signal generator’s local area network (LAN) connection hostname.
Key Entr y Hostname
Remarks The SCPI query returns the current setting, not the saved setting.
:LAN:IDENtify
Supported All
:SYSTem:COMMunicate:LAN:IDENtify ON|OFF|1|0
This command controls the LAN identify feature.
ON(1) The command enables device identification by displaying the full- screen message
"Identify: <IP Address>" on the signal generator's front panel; the LAN Status
indicator will also show "IDENTIFY". For more information, refer to the
Programming Guide.
OFF(0) This command disables device identification by clearing the message on the signal
generator's front panel and returning the LAN Status indicator to display the
current network state. For more information, refer to the Programming Guide.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 65
System Commands
Communication Subsystem (:SYSTem:COMMunicate)
:LAN:IP
Supported All
:SYSTem:COMMunicate:LAN:IP "<ipstring>"
:SYSTem:COMMunicate:LAN:IP?
This command sets the signal generator’s local area network (LAN) internet protocol (IP) address for
your IP network connection.
Key Entr y IP Address
:LAN:KEEP:TIMeout
Supported All
:SYSTem:COMMunicate:LAN:KEEP:TIMeout <value>
:SYSTem:COMMunicate:LAN:KEEP:TIMeout?
This command sets the length of time for the TCP Keep Alive setting.
Range 0 sec to 3600 sec
Key Entr y TCP Keep Alive Timeout
:LAN:KEEP[:STATe]
Supported All
:SYSTem:COMMunicate:LAN:KEEP[:STATe] ON|OFF|1|0
:SYSTem:COMMunicate:LAN:KEEP[:STATe]?
This command enables or disables the TCP Keep Alive feature.
Key Entr y TCP Keep Alive Off On
:LAN:MONitor
Supported All
:SYSTem:COMMunicate:LAN:MONitor ON|OFF|1|0
:SYSTem:COMMunicate:LAN:MONitor?
This command enables or disables the LAN connection monitoring.
Key Entr y Connection Monitoring Off On
:LAN:NBIos
Supported All
:SYSTem:COMMunicate:LAN:NBIos ON|OFF|1|0
:SYSTem:COMMunicate:LAN:NBIos?
This command enables or disables the RFC NETBIOS naming feature.
66 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Communication Subsystem (:SYSTem:COMMunicate)
System Commands
Key Entr y RFC NETBIOS Naming Off On
:LAN:SUBNet
Supported All
:SYSTem:COMMunicate:LAN:SUBNet "<ipstring>"
:SYSTem:COMMunicate:LAN:SUBNet?
This command sets the signal generator’s local area network (LAN) subnet mask address for your
internet protocol (IP) network connection.
NOTE An error will occur if the IP address, Gateway, and subnet mask have conflicting settings.
Key Entr y Subnet Mask
Remarks The SCPI query returns the current setting, not the saved setting.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 67
System Commands
Diagnostic Subsystem (:DIAGnostic[:CPU]:INFOrmation)
Diagnostic Subsystem (:DIAGnostic[:CPU]:INFOrmation)
:CCOunt:ATTenuator
Supported All
:DIAGnostic[:CPU]:INFormation:CCOunt:ATTenuator?
This query returns the cumulative number of times that the attenuator has been switched.
Key Entr y Diagnostic Info
:CCOunt:PON
Supported All
:DIAGnostic[:CPU]:INFormation:CCOunt:PON?
This query returns the cumulative number of times the signal generator has been powered-on.
Key Entr y Diagnostic Info
:CCOunt:PROTection
Supported All
:DIAGnostic[:CPU]:INFormation:CCOunt:PROTection?
This query returns the cumulative number of times the reverse power protection has been cycled.
Key Entr y Diagnostic Info
:DISPlay:OTIMe
Supported All Models
:DIAGnostic[:CPU]:INFormation:DISPlay:OTIMe?
This query returns the cumulative number of hours the display has been on.
Key Entr y Diagnostic Info
:LICense:AUXiliary
Supported All Models
:DIAGnostic[:CPU]:INFormation:LICense:AUXiliary?
This query returns a list of licenses for software applications associated with the signal generator
that have the software license file installed on the PC, as opposed to a license key installed on the
signal generator. However this query does not return demo licenses for Arb-based applications.
Key Entr y Auxiliary Software Options
68 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Diagnostic Subsystem (:DIAGnostic[:CPU]:INFOrmation)
System Commands
Remarks If you use the signal generator with a PC that has a copy of a software
application for which a license shows with this query, the software automatically
accesses and installs the license on the PC.
To access Arb-based demo software licenses, see :LICense:WAVeform. To view
option numbers for software applications that use license keys, see “:OPTions” on
page 69.
:LICense:WAVeform
Supported All Models
:DIAGnostic[:CPU]:INFormation:LICense:WAVeform?
This query returns a list of Arb-based licenses (including demo) for software applications associated
with the signal generator that have the software license file installed on the PC, as opposed to a
license key installed on the signal generator. These waveform licenses are created by the software
application in a license file on the PC. Refer to “:WLICence[:VALue]” on page 70 for more
information.
The response format is a series of comma-separated entries enclosed in quotation marks. The first
field is the waveform type number and the second is a text description of the license.
Key Entr y Wavef orm Licenses
Remarks If a license appears in this list, this means that you can transfer waveform files,
created with the associated Arb- based software application to another signal
generator if the other signal generator has the same license. For more information,
refer to the command, “:LICense:AUXiliary” on page 68.
For a list of option numbers for software applications that use license keys, see
“:OPTions”.
:OPTions
Supported All Models
:DIAGnostic[:CPU]:INFormation:OPTions?
This query returns a comma- separated list of internally installed signal generator options.
Key Entr y Instrument Options
:OPTions:DETail
Supported All Models
:DIAgnostic[:CPU]:INFormation:OPTions:DETail?
This query returns the options that are installed along with the option revision and DSP version if
applicable.
Key Entr y Options Info
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 69
System Commands
Diagnostic Subsystem (:DIAGnostic[:CPU]:INFOrmation)
:OTIMe
Supported All Models
:DIAGnostic[:CPU]:INFormation:OTIMe?
This query returns the cumulative number of hours that the signal generator has been on.
Key Entr y Diagnostic Info
:REVision
Supported All Models
:DIAGnostic[:CPU]:INFormation:REVision?
This query returns the CPU bootstrap read only memory (boot ROM) revision date. In addition, the
query returns the revision, creation date, and creation time of the main firmware.
Key Entr y Diagnostic Info
:SDATe
Supported All Models
:DIAGnostic[:CPU]:INFormation:SDATe?
This query returns the date and time of the firmware revision.
Key Entr y Diagnostic Info
:WLICence[:VALue]
Supported N5182A with Option 651/652/654
:DIAGnostic[:CPU]:INFormation:WLIcense[:VALue]? <type_num>
This query returns the number of seconds remaining on the waveform license for the type of
waveform designated by the <type_num> variable number. The type variable number is obtained using
the :LICense:WAVeform command shown on page 69. Zero is returned for non- existent and expired
licenses. The value 2^32 - 1 (4,294,967,295) is returned for licenses that do not expire.
70 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Display Subsystem (:DISPlay)
System Commands
Display Subsystem (:DISPlay)
:ANNotation:AMPLitude:UNIT
Supported All Models
:DISPlay:ANNotation:AMPLitude:UNIT DBM|DBUV|DBUVEMF|V|VEMF|DB
:DISPlay:ANNotation:AMPLitude:UNIT?
This command sets the displayed front panel amplitude units.
If the amplitude reference state is set to on, the query returns units expressed in dB. Setting any
other unit will cause a setting conflict error stating that the amplitude reference state must be set to
off. Refer to, “:REFerence:STATe” on page 55 for more information.
*RST DBM
:ANNotation:CLOCk:DATE:FORMat
Supported All Models
:DISPlay:ANNotation:CLOCk:DATE:FORMat MDY|DMY
:DISPlay:ANNotation:CLOCk:DATE:FORMat?
This command enables the selection of the date format. The choices are month- day- year (MDY) or
day- month- year (DMY) format.
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
:ANNotation:CLOCk[:STATe]
Supported All Models
:DISPlay:ANNotation:CLOCk[:STATe] ON|OFF|1|0
:DISPlay:ANNotation:CLOCk[:STATe]?
This command enables or disables the digital clock view in the lower right side of the front panel
display.
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
:BRIGhtness
Supported All Models
:DISPlay:BRIGhtness <value>
:DISPlay:BRIGhtness?
This command sets the display brightness (intensity). The brightness can be set to the minimum level
(0.02), maximum level (1), or in between by using fractional numeric values (0.03–0.99).
Range 0.02–1
Key Entr y Brightness
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 71
System Commands
Display Subsystem (:DISPl ay )
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
:CAPTure
Supported All Models
:DISPlay:CAPTure
This event command enables the user to capture the current display and store it in the signal
generator’s memory.
Remarks The display capture is stored as DISPLAY.BMP in the Binary file system. This file
is overwritten with each subsequent display capture. The file can be down- loaded
in the following manner:
1. Log on to the signal generator using ftp.
2. Change (cd) to the BIN directory.
3. Retrieve the file by using the get command or by using the :MEM:DATA query
on page 81.
:CMAP:DEFaults
Supported All Models
:DISPlay:CMAP:DEFault [<palette:{BRIGht}|DARK|MONOchrome>]
This command selects the color palette for the instrument display.
Key E nt ry Br ight Color Dark Color Monochrome
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
:CONTrast
Supported All Models
:DISPlay:CONTrast <value>
:DISPlay:CONTrast?
This command sets the contrast of the LCD display. The contrast can be set to the maximum level
(1), minimum level (0), or in between by using fractional numeric values (0.001–0.999).
Range 0–1
Key Entr y Display contrast hardkeys are located below the display.
Remarks The setting enabled by this command is not affected by signal generator power-on,
preset, or *RST.
72 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Display Subsystem (:DISPlay)
System Commands
:REMote
Supported All Models
:DISPlay:REMote ON|OFF|1|0
:DISPlay:REMote?
This command enables or disables the display updating when the signal generator is remotely
controlled.
ON (1) This choice updates the signal generator display (Text Area) so you can see the
OFF (0) This choice turns off the display (Text Area) updating while further optimizing the
Key Entr y Update in Remote Off On
Remarks The setting enabled by this command is not affected by signal generator preset or
settings as the commands are executed, however, this will degrade the signal
generator speed. Frequency Area, Amplitude Area, and status LEDs continue to
update. For more information on the front panel display description, refer to the
User’s Guide.
signal generator for speed. No Text Area updates occur but the Frequency Area,
Amplitude Area, and status LEDs continue to update. For more information on the
front panel display description, refer to the User’s Guide.
*RST. However, cycling the signal generator power will reset it to zero.
[:WINDow][:STATe]
Supported All Models
:DISPlay[:WINDow][:STATe] ON|OFF|1|0
:DISPlay[:WINDow][:STATe]?
This command is used to either blank out (OFF or 0) the display screen or turn it on (ON or 1).
Remarks *RST and presetting the signal generator or cycling the power will turn the display
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 73
on.
System Commands
IEEE 488.2 Common Commands
IEEE 488.2 Common Commands
*CLS
Supported All Models
*CLS
The Clear Status (CLS) command clears the status byte by emptying the error queue and clearing all
the event registers including the Data Questionable Event Register, the Standard Event Status
Register, the Standard Operation Status Register and any other registers that are summarized in the
status byte.
*ESE
Supported All Models
*ESE <data>
The Standard Event Status Enable (ESE) command sets the Standard Event Status Enable Register.
The variable <data> represents the sum of the bits that will be enabled.
Range 0–255
Remarks The setting enabled by this command is not affected by signal generator preset or
*RST. However, cycling the signal generator power will reset this register to zero.
Refer to the Programming Guide for more information.
*ESE?
Supported All Models
*ESE?
The Standard Event Status Enable (ESE) query returns the value of the Standard Event Status
Enable Register.
Remarks Refer to the Programming Guide for more information.
74 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
*ESR?
Supported All Models
IEEE 488.2 Common Commands
System Commands
CAUTION This is a destructive read. The data in the register is latched until it is queried. Once
*ESR?
The Standard Event Status Register (ESR) query returns the value of the Standard Event Status
Register.
Remarks Refer to the Programming Guide for more information.
queried, the data is cleared.
*IDN?
Supported All Models
*IDN?
The Identification (IDN) query outputs an identifying string. The response will show the following
information:
<company name>, <model number>, <serial number>, <firmware revision>
Key Entr y Diagnostic Info
Remarks The identification information can be modified. Refer to :SYST:IDN on page 103
for more information.
*OPC
Supported All Models
*OPC
The Operation Complete (OPC) command sets bit 0 in the Standard Event Status Register when all
pending operations have finished.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 75
System Commands
IEEE 488.2 Common Commands
*OPC?
Supported All Models
*OPC?
The Operation Complete (OPC) query returns the ASCII character 1 in the Standard Event Status
Register when all pending operations have finished.
This query stops any new commands from being processed until the current processing is complete.
*OPT?
Supported All Models
*OPT?
The options (OPT) query returns a comma- separated list of all of the instrument options currently
installed on the signal generator.
Key Entr y Instrument Options
*PSC
Supported
*PSC ON|OFF|1|0
The Power-On Status Clear (PSC) command controls the automatic power- on clearing of the Service
Request Enable Register, the Standard Event Status Enable Register, and device- specific event enable
registers.
ON (1) This choice enables the power- on clearing of the listed registers.
OFF (0) This choice disables the clearing of the listed registers and they retain their status
Remarks The setting enabled by this command is not affected by signal generator power-on,
when a power- on condition occurs.
preset, or *RST.
*PSC?
Supported All Models
*PSC?
The Power-On Status Clear (PSC) query returns the flag setting as enabled by the *PSC command.
*RCL
Supported All Models
*RCL <reg>,<seq>
The Recall (RCL) command recalls the state from the specified memory register <reg> of the specified
sequence <seq>.
Range Registers: 0–99 Sequences: 0–9
76 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
IEEE 488.2 Common Commands
Key E nt ry RECALL Reg Select Seq:
System Commands
*RST
Supported All Models
*RST
The Reset (RST) command resets most signal generator functions to factory-defined conditions.
Remarks Each command shows the *RST value if the setting is affected.
The settings enabled by this command is not affected by a signal generator
power- on, preset, or *RST.
*RST uses the factory preset state which is better for automated testing, for
example sweep mode is set to single.
For a comparison of the SCPI preset commands, refer to Table 3- 1, “Preset SCPI
Commands Overview,” on page 106.
*SAV
Supported All Models
*SAV <reg>,<seq>
The Save (SAV) command saves signal generator settings to the specified memory register <reg> of
the specified sequence <seq>.
Range Registers: 0–99 Sequences: 0–9
Key E nt ry Save Reg Save Seq[n] Reg[nn]
Remarks The save function does not save all signal generator settings. Refer to the
N5181A/82A Agilent MXG Signal Generators User’s Guide for more information
on the save function. Refer to “*RCL” on page 76 for information on recalling
saved signal generator settings.
*SRE
Supported All Models
*SRE <data>
The Service Request Enable (SRE) command sets the value of the Service Request Enable Register.
The variable <data> is the decimal sum of the bits that will be enabled. Bit 6 (value 64) is ignored
and cannot be set by this command.
Range 0–255
Remarks Refer to the Programming Guide for more information.
Entering values from 64 to 127 is equivalent to entering values from 0 to 63.
The setting enabled by this command is not affected by signal generator preset or
*RST. However, cycling the signal generator power will reset it to zero.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 77
System Commands
IEEE 488.2 Common Commands
*SRE?
Supported All Models
*SRE?
The Service Request Enable (SRE) query returns the value of the Service Request Enable Register.
Range 0–63 or 128–191
Remarks Refer to the Programming Guide for more information.
*STB?
Supported All Models
*STB?
The Read Status Byte (STB) query returns the value of the status byte including the master summary
status (MSS) bit.
Range 0–255
Remarks Refer to the Programming Guide for more information.
*TRG
Supported All Models
*TRG
The Trigger (TRG) command triggers the device if BUS is the selected trigger source, otherwise, *TRG
is ignored.
*TST?
Supported All Models
*TST?
The Self- Test (TST) query initiates the internal self- test and returns one of the following results:
0 This shows that all tests passed.
1 This shows that one or more tests failed.
Key Entr y Run Complete Self Test
*WAI
Supported All Models
*WAI
The Wait-to- Continue (WAI) command causes the signal generator to wait until all pending
commands are completed, before executing any other commands.
78 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Memory Subsystem (:MEMory)
System Commands
Memory Subsystem (:MEMory)
:CATalog:BINary?
Supported N5182A with Option 651/652/654
:MEMory:CATalog:BINary?
This query outputs a list of the binary files. The return data will be in the following form:
<mem used>,<mem free>{,"<file listing>"}
The signal generator will return the two memory usage parameters and as many file listings as there
are files in the directory list. Each file listing parameter will be in the following form:
"<file name>,<file type>,<file size>"
Example Output
1818624,519962624,"GEN_FILE11,BIN,5"
Key Entr y Binary
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
:CATalog:LIST?
Supported All Models
:MEMory:CATalog:LIST?
This query outputs a list of the list sweep files. The return data will be in the following form:
<mem used>,<mem free>{,"<file listing>"}
The signal generator will return the two memory usage parameters and as many file listings as there
are files in the directory list. Each file listing parameter will be in the following form:
"<file name>,<file type>,<file size>"
Example Output
1818624,519962624,"LAST,LIST,122","LIST10,LIST,69"
Key Entr y List
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
:CATalog:SEQ?
Supported N5182A with Option 651/652/654
:MEMory:CATalog:SEQ?
This query outputs a list of the arbitrary waveform sequence files. The return data will be in the
following form:
<mem used>,<mem free>{,"<file listing>"}
The signal generator will return the two memory usage parameters and as many file listings as there
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 79
System Commands
Memory Subsystem (:ME Mory)
are files in the directory list. Each file listing parameter will be in the following form:
"<file name>,<file type>,<file size>"
Example Output
1818624,519962624,"SEQ1_TEST,SEQ,206","SEQ_TEST,SEQ,169"
Key Entr y SEQ
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
:CATalog:STATe?
Supported All Models
:MEMory:CATalog:STATe?
This query outputs a list of the state files. The return data will be in the following form:
<mem used>,<mem free>{,"<file listing>"}
The signal generator will return the two memory usage parameters and as many file listings as there
are files in the directory list. Each file listing parameter will be in the following form:
"<file name,file type,file size>"
Example Output
1818624,519962624,"0_00,STAT,641"
Key Entr y State
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
The :MEM:CAT:STAT command requires the use of registry number and sequence
number variables. The ranges are 0- 99 for <reg_num> and 0- 9 for <seq_num>.
:CATalog:UFLT?
Supported All Models
:MEMory:CATalog:UFLT?
This query outputs a list of the user- flatness correction files. The return data will be in the following
form:
<mem used>,<mem free>{,"<file listing>"}
The signal generator will return the two memory usage parameters and as many file listings as there
are files in the directory list. Each file listing parameter will be in the following form:
"<file name,file type,file size>"
Example Output
1818624,519962624,"FLAT_1,UFLT,16","LAST,UFLT,16"”
Key Entr y User Flatness
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
80 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Memory Subsystem (:MEMory)
System Commands
:CATalog[:ALL]?
Supported All Models
:MEMory:CATalog[:ALL]?
This query outputs a list of all the files in the memory subsystem. However it does not include files
stored on the Option 651/652/654 baseband generator. The return data will be in the following form:
<mem used>,<mem free>{,"<file listing>"}
The signal generator will return the two memory usage parameters and as many file listings as there
are files in the memory subsystem. Each file listing parameter will be in the following form:
"<file name,file type,file size>"
Example Output
1818624,519962624,0_00@STATE,STAT,641","0_01@STATE,STAT,669","A@NVHDR,NVHDR,132","A@N
VMKR,NVMKR,0","A@NVWFM,NVWFM,9","COPY12@STATE,STAT,669","FLAT_1@USERFLAT,UFLT,16","GE
N_FILE11@BINARY,BIN,5","LAST@LIST,LIST,122","LAST@USERFLAT,UFLT,16","PERSISTENT@STATE
,STAT,1056",SEQ1_TEST@SEQ,SEQ,206
Key Entr y All
Remarks Refer to the Table 1- 4 on page 14 for a listing of the file types and the table on
page 15 for information on the "<file name>" syntax.
:COPY[:NAME]
Supported All Models
:MEMory:COPY[:NAME] "<file name>","<file name>"
This command makes a duplicate of the requested file.
Key Entr y Copy File
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
When copying a waveform file from volatile to non- volatile memory, the marker
file and file header, associated with the waveform file, will automatically be copied
at the same time.
:DATA
Supported All Models
:MEMory:DATA "<file_name>",<data_block>
:MEMory:DATA? "<file_name>"
This command loads data into signal generator memory using the <data_block> parameter and saves
the data to a file designated by the "<file_name>" variable. The query returns the file contents of the
file as a datablock.
A waveform file must be located in volatile waveform memory (WFM1) before it can be played by the
signal generator’s dual ARB player.
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 81
System Commands
Memory Subsystem (:ME Mory)
For downloads directly into volatile waveform memory use the path "WFM1:<file_name>". For
downloads to non-volatile waveform memory, use the path "NVWFM:<file_name>".
"<file_name>" This variable names the destination file, including the directory path.
<data_block> This parameter represents the data and file length parameters. The data in the file
is represented by the <data_block> variable.
Refer to the Programming Guide for more information on programming the status registers.
Example
:MEM:DATA "NVWFM:IQ_Data",#210Qaz37pY9oL
The preceding example downloads 10 bytes of data to a file, IQ_Data, in the signal generator’s
non- volatile memory. The table shown below describes the command parameters.
"NVWFM:IQ_Data"
•
• #210Qaz37pY9oL
# This character indicates the beginning of the data block
2 Number of digits in the byte count
10 Byte count
Qaz37pY9oL 10 bytes of data
IQ_Data is the file name. The director y path is not needed. The
path "/USER/WAVEFORM/" is implied.
Data block
NOTE The data, Qaz37pY9oL, in the above command are not valid and are shown for example
purposes only. Typically, ascii characters representing data are unprintable.
Remarks See “File Name Variables” on page 12 for information on the file name syntax.
:DATA:APPend
Supported All Models
:APPend "<file_name>",<data_block>
This commands appends data to an existing file stored in signal generator memory.
"<file_name>" This variable names the destination file and directory path.
<data_block> This parameter represents the data and file length parameters. The data in the file
is represented by the <data_block> variable. The file length parameters are used
by the signal generator for allocating memory.
Refer to the Programming Guide for more information on downloading and using files.
Example
:MEM:DATA:APPend "NVWFM:IQ_Data",#14Y9oL
The preceding example downloads and appends the data, Y9oL, to an existing file named IQ_Data
82 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
stored in the signal generator’s non-volatile memory (NVWFM).
Memory Subsystem (:MEMory)
System Commands
"NVWFM:IQ_Data"
•
• #14Y9oL
# This character indicates the beginning of the data block
1 Number of digits in the byte count
4 Byte count
Y9oL 4 bytes of data
IQ_Data the file name. The directory path is not needed. The path
"/USER/WAVEFORM/" is implied.
Data block
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
:DELete:ALL
Supported All Models
CAUTION Using this command deletes all non- volatile user files including binary, list, state, and
flatness correction files, and any saved setups which use the front panel table editor.
However, this does not include files stored on the Option 651/652/654 ARB generator.
You cannot recover the files after executing this command.
:MEMory:DELete:ALL
This command clears the file system of all non- volatile user files.
Key Entr y Delete All Files
:DELete:BINary
Supported N5182A with Option 651/652/654
:MEMory:DELete:BINary
This command deletes all binary files.
Key Entr y Delete All Binary Files
:DELete:LIST
Supported All Models
:MEMory:DELete:LIST
This command deletes all List files.
Key Entr y Delete All List Files
:DELete:SEQ
Supported N5182A with Option 651/652/654
Agilent N5181A/82A MXG Signal Generators SCPI Command Reference 83
System Commands
Memory Subsystem (:ME Mory)
:MEMory:DELete:SEQ
This command deletes all sequence files.
Key Entr y Delete All Sequence Files
:DELete:STATe
Supported All Models
:MEMory:DELete:STATe
This command deletes all state files.
Key Entr y Delete All Models State Files
:DELete:UFLT
Supported All Models
:MEMory:DELete:UFLT
This command deletes all user-flatness correction files.
Key Entr y Delete All UFLT Files
:DELete[:NAME]
Supported All Models
:MEMory:DELete[:NAME] "<file name>"
This command clears the user file system of "<file name>".
Key Entr y Delete File
Remarks Refer to “File Name Variables” on page 12 for information on the file name syntax.
When deleting a waveform (WFM1) file from memory, the marker file and file
header, associated with the waveform file, will also be deleted.
:FREE[:ALL]
Supported All Models
:MEMory:FREE[:ALL]?
This command returns the number of bytes left in the non- volatile user file system.
Key Entr y All
:LOAD:LIST
Supported All Models
:MEMory:LOAD:LIST "<file name>"
84 Agilent N5181A/82A MXG Signal Generators SCPI Command Reference
Loading...