SOURce, Subsystem Syntax, Chapter | Agilent Technologies E1441A

[SOURce:]

The SOURce subsystem commands allow you the flexibility to change individual parameters when programming the function generator. These are the instrument’s low-level commands.

Subsystem Syntax

[SOURce:]

AM:DEPTh <depth in percent>MINimumMAXimum AM:DEPTh? [MINimumMAXimum]

AM:INTernal:FUNCtion SINusoidSQUareTRIangleRAMPNOISeUSER AM:INTernal:FUNCtion?

AM:INTernal:FREQuency <frequency>MINimumMAXimum AM:INTernal:FREQuency?

AM:SOURce BOTHEXTernal AM:SOURce?

AM:STATe OFFON AM:STATe?

APPLy:DC [<frequency DEFault>[,<amplitude DEFault>[,<offset>]]] APPLy:NOISe [<frequency DEFault>[,<amplitude DEFault>[,<offset>]]] APPLy:RAMP [<frequency>[,<amplitude>[,<offset>]]] APPLy:SINusoid [<frequency>[,<amplitude>[,<offset>]]] APPLy:SQUare [<frequency>[,<amplitude>[,<offset>]]] APPLy:TRIangle [<frequency>[,<amplitude>[,<offset>]]] APPLy:USER [<frequency>[,<amplitude>[,<offset>]]]

APPLy?

BM:NCYCles <number of cycles>MINimumMAXimum

BM:NCYCles? [MINimumMAXimum]

BM:PHASe <degrees>MINimumMAXimum

BM:PHASe? [MINimumMAXimum]

BM:INTernal:RATE <frequency>MINimumMAXimum

BM:INTernal:RATE? [MINimumMAXimum]

BM:SOURce INTernalEXTernal

BM:SOURce?

BM:STATe OFFON

BM:STATe?

FM:DEViation <peak deviation in Hz>MINimumMAXimum FM:DEViation? [MINimumMAXimum]

FM:FUNCtion SINusoidSQUareTRIangleRAMPNOISeUSER FM:FUNCtion?

FM:INTernal:FREQuency <frequency>MINimumMAXimum FM:INTernal:FREQuency? [MINimumMAXimum] FM:STATe OFFON

FM:STATe?

FREQuency <frequency> MINimum MAXimum

FREQuency? [ MINimum MAXimum ]

FREQuency:STARt	<frequency> MINimum MAXimum
FREQuency:STARt? [ MINimum MAXimum ]
FREQuency:STOP	<frequency> MINimum MAXimum
FREQuency:STOP? [ MINimum MAXimum ]
FSKey:FREQuency	<frequency> MINimum MAXimum

FSKey:FREQuency? [ MINimum MAXimum ] FSKey:INTernal:RATE <rate in Hz> MINimum MAXimum FSKey:INTernal:RATE? [ MINimum MAXimum ] FSKey:SOURce INTernal EXTernal

92 Agilent E1441A SCPI Command Reference

Chapter 3

Image 92

Agilent Technologies user service SOURce, Subsystem Syntax, Agilent E1441A SCPI Command Reference, Chapter

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 Chapter Setting the Module Address SwitchFigure 1-1.Setting the Logical Address 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 Chapter FM Peak Frequency Deviation32 Agilent E1441A Application Information “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 requires Option To Phase Lock Using the Counted Burst ModeSend these commands to both function generators Trigger Source Choices Triggering the Function GeneratorTrigger Slope 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 iferr != VI_SUCCESS err_handlerfuncgen, err ChapterAgilent E1441A Application Information Chapter AM Modulation and Instrument State Storage60 Agilent E1441A Application Information Agilent E1441A Application Information Arbitrary Waveform ExampleChapter 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 Chapter Agilent E1441A SCPI Command ReferenceCommand Index by Function Chapter Modulation Commands66 Agilent E1441A SCPI Command Reference 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 Parameters Linking CommandsImplied Commands SCPI Command Reference Command Guides CALibration CALibration?COUNt? Subsystem Syntax Parameters SECure:CODESECure:STATe SETup SETup?SECure:STATe? STRing STRing? VALueVALue? Parameters Subsystem Syntax DATAVOLATILE DAC VOLATILE Downloading a Binary Block of Data ATTRibute:AVERage?ATTRibute CFACtor? ATTRibute:POINts? ATTRibute PTPeak?80 Agilent E1441A SCPI Command Reference Chapter CATalog? COPYAgilent E1441A SCPI Command Reference Chapter DELete NVOLatile:FREE? DEL:ALLNVOLatile:CATalog? 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 Syntax APPLy CommandsAPPLy Command Parameters 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:UNIT? VOLTage:OFFSet?VOLTage:UNIT PRESet STATusQUEStionable :CONDition? QUEStionable :EVENt? QUEStionable :ENABle QUEStionable :ENABle? Chapter Agilent E1441A SCPI Command ReferenceFigure 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 Chapter SCPI Command Quick ReferenceAgilent E1441A SCPI Command Reference 132 Agilent E1441A SCPI Command Reference Chapter Chapter Agilent E1441A SCPI Command ReferenceSOURce 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 Direct Digital Synthesis Agilent E1441A Function Generator TutorialAppendix C Figure C-2 Figure C-3154 Agilent E1441A Function Generator Tutorial Appendix C Agilent E1441A Function Generator Tutorial Signal ImperfectionsAppendix C 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 Appendix C Deviation = Hop Frequency – Carrier Frequency160 Agilent E1441A Function Generator Tutorial 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 Performance Verification Tests Frequency VerificationQuick Performance Check 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 Appendix D 170 Service ProceduresTable D-6.AC Amplitude Verification 50 Ohms Amplitude Flatness Verification Service ProceduresTable D-7.Amplitude Flatness Verification Appendix D Square Wave Duty Cycle Verification AM Modulation Depth VerificationOptional Performance Verification Tests 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 Appendix D Table D-22.AC Flatness Adjustment SetupsService Procedures Error Messages Table D-23.System Error MessagesTable D-24. Self-TestError Messages 188 Service Procedures Appendix D Table D-25.Calibration Error MessagesService Procedures 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 Appendix D Agilent E1441A Amplitude FlatnessAgilent E1441A AM Modulation Optional Performance Verification Tests Agilent E1441A Square Wave Duty CycleAgilent E1441A Distortion Appendix D Appendix D Symbols Index CODE, STATe, CATalog?, FREE?, AVERage?, CFACtor?, POINts?, PTPeak?,ALL, IDN?, 124, FM, 32, FSK, 41, OPC, 124, 126 *OPC?ERRor STATe, STATe?, DELete, RST, 124, DEPTh, DEPTh?, INTernal FREQuency, FUNCtion, SRE?, 124,STB?, 124, Vpp, 25, Vrms, 25, WAI, 124,