SCPI Command Reference

Command Guides

This section describes the Standard Commands for Programmable Instruments (SCPI) for the Agilent E1441A Function / Arbitrary Waveform Generator. Commands are listed alphabetically by subsystem and also within each subsystem.

Command guides are printed in the top margin of each page. The left guide indicates the first command listed on that page. The right guide indicates the last command listed on that page. If a single command appears on a page, the left and right guides will be the same.

72 Agilent E1441A SCPI Command Reference

Chapter 3

Page 72

Image 72

Agilent Technologies E1441A user service SCPI Command Reference, Command Guides

Contents

User/Service and SCPI Programming Manual Where to Find it - Online and Printed InformationE1441-90003 Agilent E1441APage Contents EditionChapter Chapter Chapter Appendix AAppendix B Appendix C Performance Verification Tests 6 Contents AGILENT TECHNOLOGIES WARRANTY STATEMENT DURATION OF WARRANTY: 1 yearCertification U.S. Government Restricted Rights Safety Symbols Documentation HistoryTrademarks WARNINGS Safety DECLARATION OF CONFORMITYMeasurement Product Generation Unit Conforms with the following European Directives Notes Notes Notes Module Setup Agilent E1441AFunction/Arbitrary Waveform Generator Chapter Setting the Module Address Switch Figure 1-1.Setting the Logical AddressChapter Installing into the Mainframe Interrupt Priority Faceplate Indicators and Connectors Faceplate IndicatorsOption 001 Phase-Lock10 MHz Reference Terminals Standard Input/Output Terminals Initial Operation Chapter Output Configuration Agilent E1441A Application InformationFunctional Capabilities Chapter Valid Function/ Modulation Modes Table FUNCtion:SHAPe SIN|SQU|TRI|RAMP|NOIS|USER|DCTable Chapter Table FREQuency <frequency>|MINimum|MAXimum22 Agilent E1441A Application Information Chapter Parameter Page Use the following command to set the dc offset Use the following command to set the duty cycle sync signal, you can disable the Sync terminal Amplitude Modulation AM AM Carrier Waveform Shape Amplitude Modulating Waveform Shape Amplitude Modulating Waveform FrequencyAmplitude Modulation Depth FREQuency <frequency>|MINimum|MAXimum Frequency Modulation FM Amplitude Modulating Source FM Carrier Waveform Shape FM Carrier Frequency FM Peak Frequency Deviation 32 Agilent E1441A Application InformationChapter “Burst Phase” on page •“Burst Modes” on page“Counted Burst Mode” on page “Gated Burst Mode” on page The command sequence to configure this mode is The command sequence to configure this mode istrigger source 34 Agilent E1441A Application Information Gated Burst Mode Burst Trigger Source For Counted Burst Mode IMMediate INTernalEXTernal TTLTRG<n> Number of Arb Points Minimum FrequencyMaximum Frequency Carrier Frequency Burst Count Use the following command to set the burst count Use the following command to set the burst rateBM:NCYCles <# cycles>|INFinity|MINimum|MAXimum BM:INTernal:RATE <frequency>|MINimum|MAXimum Frequency-Shift Keying FSK Modulation •“FSK Carrier Frequency” on page•“FSK “Hop” Frequency” on page •“FSK Rate” on page •“FSK Hop Source” on page Use the following command to set the frequency Use the following command to set the FSK rateFREQuency <frequency>|MINimum|MAXimum FSKey:FREQuency <frequency>|MINimum|MAXimum Internal Hop Source External Hop Source42 Agilent E1441A Application Information Chapter Sweep Start and Stop Frequencies •“Sweep Start and Stop Frequencies” on page•“Sweep Time” on page •“Sweep Mode” on page •“Sweep Trigger Source” on page Sweep Trigger Source External Sources Internal Source Sweep Trigger Signal TRIG:SOUR INT shown Figure 2-9.Frequency Sweep with Internal TriggerTRIGger:SOURce IMMediate|EXTernal|TTLTRG<0-7>|BUS Chapter Arbitrary Waveforms Creating Arbitrary Waveforms Creating and Storing an Arbitrary Waveform Waveforms Figure48 Agilent E1441A Application Information Chapter Phase-Lock Capabilities Opt APPL:SIN 10E+6,PHAS:ADJ 90DEG To Phase Lock Multiple Function Generators requires OptionFigure 50 Agilent E1441A Application Information To Phase Lock Using the Counted Burst Mode Send these commands to both function generatorsrequires Option Triggering the Function Generator Trigger SlopeTrigger Source Choices Internal Triggering External Triggering Including TTLTRG linesTrig / FSK / Burst Input Terminal” on page Software BUS Triggering Ext Trig / FSK / Burst Input Terminal Figure54 Agilent E1441A Application Information Chapter System-RelatedOperations Firmware Revision Query SCPI Language Version Query Power-Onand Reset StateFeature Power-Onand Reset State Application Program Examples CLanguage Programs Compiling and Linking a CProgram Example Programs Burst Modulation Program Chapter Agilent E1441A Application Informationiferr != VI_SUCCESS err_handlerfuncgen, err AM Modulation and Instrument State Storage 60 Agilent E1441A Application InformationChapter Arbitrary Waveform Example ChapterAgilent E1441A Application Information 62 Agilent E1441A Application Information Chapter end of main Error handling function ChapterAgilent E1441A Application Information close the device session */ viClosefuncgen 64 Agilent E1441A Application Information Chapter Agilent E1441A SCPI Command Reference Command Index by FunctionChapter Modulation Commands 66 Agilent E1441A SCPI Command ReferenceChapter Sweep Commands Arbitrary Waveform CommandsTrigger Commands Agilent E1441A SCPI Command Reference System-RelatedCommands Calibration CommandsStatus Reporting Commands 68 Agilent E1441A SCPI Command Reference The IEEE-488.2Common Commands Option 001 Phase-LockCommandsAgilent E1441A SCPI Command Reference Chapter Command Fundamentals Common Command FormatSCPI Command Format Abbreviated Commands Linking Commands Implied CommandsParameters SCPI Command Reference Command Guides CALibration CALibration?COUNt? Subsystem Syntax SECure:CODE SECure:STATeParameters SETup SETup?SECure:STATe? STRing STRing? VALueVALue? Parameters DATA VOLATILESubsystem Syntax DAC VOLATILE ATTRibute:AVERage? ATTRibute CFACtor?Downloading a Binary Block of Data ATTRibute:POINts? ATTRibute PTPeak?80 Agilent E1441A SCPI Command Reference Chapter CATalog? COPYAgilent E1441A SCPI Command Reference Chapter DELete DEL:ALL NVOLatile:CATalog?NVOLatile:FREE? FORMat BORDerBORDer? •Related Commands MEMory STATe:DELeteSTATe:RECall:AUTO •Related Commands: *RCL, *SAV STATe:RECall:AUTO? Comments • Returned Value: 0 or OUTPut LOADLOAD? Parameters SYNC SYNC?TRIGger:IMMediate TRIGger:STATe TTLTrg<n>:STATe? Agilent E1441A SCPI Command Referenceenable TTLTRG2 line to source a trigger enable TTLTRG7 line to source a trigger PHASe ADJustSubsystem Syntax PHASe Only valid with Option ADJust? UNLock:ERRor:STATeUNLock:ERRor:STATe? REFerence SOURce 92 Agilent E1441A SCPI Command ReferenceSubsystem Syntax Chapter Amplitude Modulation AM Commands AM:DEPThParameters •*RST Condition: 100% AM:DEPTh? AM:INTernal:FUNCtionAM:INTernal:FUNCtion? AM:INTernal:FREQuency AM:SOURce? AM:STATeAM:STATe? •*RST Condition: BOTH APPLy Commands APPLy Command ParametersSyntax in the waveform see below 98 Agilent E1441A SCPI Command Reference Chapter ±10 Vdc into an open circuit APPLy:DC APPLy NOISeAPPLy:RAMP APPLy:SINusoid APPLy:SQUare APPLy:TRIangleAPPLy:USER APPLy? BURST MODULATION COMMANDS BM:NCYClesBM NCYCles? BurstCount BM:PHASe BM:PHASe?BM:INTernal:RATE Parameters FM COMMANDS BM:INTernal:RATE?BM:SOURce BM:SOURce? FM:DEViation FM:DEViation?FM:INTernal:FREQuency Parameters FM:INTernal:FREQuency? FM:INTernal:FUNCtionFM:INTernal:FUNCtion? FM:STATe FREQuency? FREQuency:STARtAgilent E1441A SCPI Command Reference Parameters Frequency-ShiftKeying FSK Commands FREQuency:STARt?FREQuency:STOP FREQuency:STOP? FSKey:FREQuency FSKey FREQuency?FSKey INTernal RATE FSKey:INTernal:RATE? Selecting an Arbitrary Waveform FSKey:SOURce?FSKey:STATe FSKey:STATe? FUNCtion:USER? FUNCtion:SHAPeAgilent E1441A SCPI Command Reference Chapter FUNCtion:SHAPe? PULSe:DCYCle112 Agilent E1441A SCPI Command Reference Parameters PULSe:DCYCle? SWEep:SPACingSWEep:SPACing? SWEep:TIME SWEep:STATe SWEep:STATe?VOLTage 114 Agilent E1441A SCPI Command Reference VOLTage? VOLTage:OFFSetAgilent E1441A SCPI Command Reference Parameters VOLTage:OFFSet? VOLTage:UNITVOLTage:UNIT? PRESet STATusQUEStionable :CONDition? QUEStionable :EVENt? QUEStionable :ENABle QUEStionable :ENABle? Agilent E1441A SCPI Command Reference FigureChapter ERRor? SYSTemVERSion? Subsystem Syntax TRIGger SLOPeSLOPe? SOURce the *TRG IEEE-488.2common command SOURce? Related Commands *RST Condition TRIG SOUR IMM IEEE 488.2Common CommandReference Command124 Agilent E1441A SCPI Command Reference Category ESE? ESR?Comments • Coupled command: No •Related Commands: STATus:PRESet IDN? OPC?OPT? option Comments • Coupled command: No PSC? •Coupled command: NoComments • Coupled command: No •*RST Condition: none •Coupled command: No Comments • Coupled command: NoPower-OnCondition no bits are enabled Parameters SRE? STB?TST? Comments • Coupled command: No Agilent E1441A Power-Onand Reset State FeaturePower-Onand Reset State 130 Agilent E1441A SCPI Command Reference SCPI Command Quick Reference Agilent E1441A SCPI Command ReferenceChapter 132 Agilent E1441A SCPI Command Reference Chapter Agilent E1441A SCPI Command Reference SOURceChapter 134 Agilent E1441A SCPI Command Reference Chapter Agilent E1441A Specifications Appendix ASinewave Spectral Purity Frequency Characteristics Signal Characteristics Square wave Output Characteristics 1,5 Amplitude into 50Ω:2Resolution Triangle, Ramp, Arb Characteristics ModulationFrequency Sweep Faceplate Inputs5 System Characteristics Configuration Times Arb Download TimesCooling/Slot Operating Environment Option 001 Specifications Timebase Accuracy Phase OffsetFaceplate Output: Ref Out terminal Trigger 140 Agilent E1441A Specifications Appendix A Agilent E1441A Error Messages Execution ErrorsAppendix B 102 Syntax error 108 Parameter not allowed 109 Missing parameter112 Program mnemonic too long 113 Undefined header 170to -178 Expression errors 151 Invalid string data158 String data not allowed 161 Invalid block data 221 Settings conflict; frequency has been adjusted 221 Settings conflict; offset has been adjusted 222 Data out of range 222 Data out of range; amplitude222 Data out of range; frequency 222 Data out of range; offset 350 Too many errors 550Command not allowed in local580Phase-lockedloop is unlocked 440 Query UNTERMINATED after indefinite response Self-TestErrors Calibration Errors590I/O processor reset 601Trigger test failed 701Cal security disabled by jumper 707Cal signal measurement out of range 702Cal secured703Invalid secure code 704Secure code too long Arbitrary Waveform Errors 850Cal setup invalid851Negative offset gain cal required CAL:SETup 852Flatness DAC gain cal required CAL:SETup 783Arb waveform name too long 785Specified arb waveform does not exist786Cannot delete a built-inarb waveform 788Cannot copy to VOLATILE arb waveform Option 001 Phase-LockErrors 580Phase-lockedloop is unlocked 152 Agilent E1441A Error Messages Appendix B Agilent E1441A Function Generator Tutorial Appendix CDirect Digital Synthesis Figure C-2 Figure C-3154 Agilent E1441A Function Generator Tutorial Appendix C Signal Imperfections Appendix CAgilent E1441A Function Generator Tutorial Output Amplitude Control Figure C-4Figure C-5 156 Agilent E1441A Function Generator Tutorial Floating Signal Generators Attributes of AC SignalsAppendix C Agilent E1441A Function Generator Tutorial Modulation 1 + D ⋅ Am 〈 t〉 ⋅ sin2π ⋅ Fc ⋅ T158 Agilent E1441A Function Generator Tutorial Appendix C Appendix C Agilent E1441A Function Generator TutorialFor wideband FM Start Frequency + Stop Frequency Deviation = Hop Frequency – Carrier Frequency 160 Agilent E1441A Function Generator TutorialAppendix C Table C-1 for AM624for FM Appendix C Fs = 1 / 9 x 200 ∝s = 555.555 kHz Points P = C/S / Fs =y = mX + b 162 Agilent E1441A Function Generator Tutorial Service Procedures Appendix D Agilent Technologies Calibration Services Automated Verification and Calibration ProceduresClosed-CaseElectronic Calibration Calibration Interval Recommended Test Equipment Test Considerations Performance Verification Tests Frequency Verification Quick Performance CheckPerformance Verification Tests Function Gain and Linearity Verification DC Function Offset Verification168 Service Procedures Table D-4.DC Function Offset Verification AC Amplitude Verification Service ProceduresTable D-5.AC Amplitude Verification High Z Appendix D 170 Service Procedures Table D-6.AC Amplitude Verification 50 OhmsAppendix D Amplitude Flatness Verification Service ProceduresTable D-7.Amplitude Flatness Verification Appendix D AM Modulation Depth Verification Optional Performance Verification TestsSquare Wave Duty Cycle Verification Distortion Verification Service ProceduresTable D-10.Distortion Verification Appendix D Calibration Security Code To unsecure for calibrationTo re-secure To change security code Unsecuring the Function Generator Calibration Count Calibration Message General Calibration/Adjustment Procedure Calibration Example Frequency and Burst Rate Adjustment Aborting a Calibration in Progress Function Gain and Linearity Adjustment AC Amplitude Adjustment High-Z Modulation Adjustment AC Amplitude Adjustment 50 Ohms Table D-15.50 Ohm Adjustment Setup182 Service Procedures Appendix D 7.Repeat steps 4, 5 and 6 for SETUP 35 through Table D-16.AC Amplitude 50 Ohms Adjustment SetupsService Procedures 8.Perform the “AC Amplitude Verification” on page DC Output Adjustment Duty Cycle Adjustment AC Amplitude Flatness Adjustment 1 kHz to 100 kHz Table D-22.AC Flatness Adjustment Setups Service ProceduresAppendix D Error Messages Table D-23.System Error MessagesTable D-24. Self-TestError Messages 188 Service Procedures Table D-25.Calibration Error Messages Service ProceduresAppendix D Performance Test Record Test Limits Measurement UncertaintyTest Accuracy Ratio TAR MaximumValue – ExpectedReading Appendix D Appendix D Test Equipment Used DescriptionModel No Trace No Agilent E1441A Frequency Accuracy Agilent E1441A Function Gain and LinearityAgilent E1441A DC Function Offset Appendix D Agilent E1441A AC Amplitude High Z Appendix D Agilent E1441A AC Amplitude 50 Ohms Appendix D Agilent E1441A Amplitude Flatness Agilent E1441A AM ModulationAppendix D Optional Performance Verification Tests Agilent E1441A Square Wave Duty CycleAgilent E1441A Distortion Appendix D Appendix D Symbols Index CODE, STATe, AVERage?, CFACtor?, POINts?, PTPeak?, ALL,CATalog?, FREE?, IDN?, 124, FM, 32, FSK, 41, OPC, 124, 126 *OPC?ERRor STATe, STATe?, DELete, RST, 124, SRE?, 124, STB?, 124,DEPTh, DEPTh?, INTernal FREQuency, FUNCtion, Vpp, 25, Vrms, 25, WAI, 124,