Data, Volatile, Subsystem Syntax | Agilent Technologies E1441A

DATA

DATA

Subsystem

Syntax

DATA VOLATILE, <value>,<value>, . . .

DATA:DAC VOLATILE, <binary block> <value>,<value>, . . .

DATA

:ATTRibute:AVERage? [<arb name>] :ATTRibute:CFACtor? [<arb name>] :ATTRibute:POINts? [<arb name>] :ATTRibute:PTPeak? [<arb name>] :CATalog?

:COPY <destination arb name> [,VOLATILE] :DELete <arb name>

:DELete:ALL

:NVOLatile:CATalog?

:NVOLatile:FREE?

VOLATILE

DATA VOLATILE, <value>, <value>,. . . is used to download floating-pointvalues between -1and +1 into volatile memory. You can download between 8 and 16,000 points per waveform.

Comments • The values -1 and +1 correspond to the peak values of the waveform.

For example, if you set the amplitude to 10 Vpp, “-1” corresponds to -5 volts and “+1” corresponds to +5 volts.

•The maximum amplitude will be limited if the data points do not span the full range of the output DAC (Digital-to-Analog Converter). For example, the built-in “SINC” waveform does not use the full range of values between ±1 and therefore its maximum amplitude is 6.084 Vpp (into 50 ohms).

•Downloading floating-point values (using DATA VOLATILE) is slower than downloading binary values (using DATA:DAC VOLATILE) but is more convenient when using trigonometric functions which return values between -1 and +1.

•The DATA VOLATILE command overwrites the previous waveform in VOLATILE memory (no error is generated). Use the DATA:COPY command to copy the waveform to non-volatile memory.

•Up to four user-defined waveforms can be stored in non-volatile memory. Use the DATA:DEL command to delete the waveform in VOLATILE memory or any of the four user-defined waveforms in non-volatile memory. Use the DATA:CAT? command to list all waveforms currently stored in volatile and non-volatile memory (and the built-in waveforms).

•After downloading the waveform data to memory, use the FUNC:USER command to choose the active waveform and the FUNC:SHAP USER command to output it.

Chapter 3

Agilent E1441A SCPI Command Reference 77

Image 77

Agilent Technologies E1441A user service Data, Volatile, Subsystem Syntax

Contents

Where to Find it - Online and Printed Information User/Service and SCPI Programming ManualE1441-90003 Agilent E1441APage Edition ContentsChapter Chapter Appendix A ChapterAppendix B Appendix C Performance Verification Tests 6 Contents DURATION OF WARRANTY: 1 year AGILENT TECHNOLOGIES WARRANTY STATEMENTCertification U.S. Government Restricted Rights Documentation History Safety SymbolsTrademarks WARNINGS DECLARATION OF CONFORMITY SafetyMeasurement Product Generation Unit Conforms with the following European Directives Notes Notes Notes Agilent E1441A Module SetupFunction/Arbitrary Waveform Generator Chapter Chapter Setting the Module Address SwitchFigure 1-1.Setting the Logical Address Interrupt Priority Installing into the Mainframe Faceplate Indicators Faceplate Indicators and ConnectorsOption 001 Phase-Lock10 MHz Reference Terminals Standard Input/Output Terminals Initial Operation Chapter Agilent E1441A Application Information Output ConfigurationFunctional Capabilities Chapter Valid Function/ Modulation Modes FUNCtion:SHAPe SIN|SQU|TRI|RAMP|NOIS|USER|DC TableTable Chapter FREQuency <frequency>|MINimum|MAXimum Table22 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 AM Carrier Waveform Shape Amplitude Modulation AM Amplitude Modulating Waveform Frequency Amplitude Modulating Waveform ShapeAmplitude Modulation Depth FREQuency <frequency>|MINimum|MAXimum Amplitude Modulating Source Frequency Modulation FM FM Carrier Frequency FM Carrier Waveform Shape Chapter FM Peak Frequency Deviation32 Agilent E1441A Application Information •“Burst Modes” on page “Burst Phase” 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 Burst Trigger Source For Counted Burst Mode Gated Burst Mode INTernal IMMediateEXTernal TTLTRG<n> Minimum Frequency Number of Arb PointsMaximum Frequency Carrier Frequency Burst Count Use the following command to set the burst rate Use the following command to set the burst countBM:NCYCles <# cycles>|INFinity|MINimum|MAXimum BM:INTernal:RATE <frequency>|MINimum|MAXimum •“FSK Carrier Frequency” on page Frequency-Shift Keying FSK Modulation•“FSK “Hop” Frequency” on page •“FSK Rate” on page •“FSK Hop Source” on page Use the following command to set the FSK rate Use the following command to set the frequencyFREQuency <frequency>|MINimum|MAXimum FSKey:FREQuency <frequency>|MINimum|MAXimum External Hop Source Internal Hop Source42 Agilent E1441A Application Information Chapter •“Sweep Start and Stop Frequencies” on page Sweep Start and Stop Frequencies•“Sweep Time” on page •“Sweep Mode” on page •“Sweep Trigger Source” on page Internal Source Sweep Trigger Source External Sources Figure 2-9.Frequency Sweep with Internal Trigger Sweep Trigger Signal TRIG:SOUR INT shownTRIGger:SOURce IMMediate|EXTernal|TTLTRG<0-7>|BUS Chapter Creating Arbitrary Waveforms Arbitrary Waveforms Creating and Storing an Arbitrary Waveform Figure Waveforms48 Agilent E1441A Application Information Chapter APPL:SIN 10E+6, Phase-Lock Capabilities OptPHAS:ADJ 90DEG requires Option To Phase Lock Multiple Function GeneratorsFigure 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 External Triggering Including TTLTRG lines Internal TriggeringTrig / FSK / Burst Input Terminal” on page Software BUS Triggering Figure Ext Trig / FSK / Burst Input Terminal54 Agilent E1441A Application Information Chapter System-RelatedOperations SCPI Language Version Query Firmware Revision Query Reset State Power-OnandFeature Power-Onand Reset State CLanguage Programs Compiling and Linking a C Application Program ExamplesProgram 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 Chapter 62 Agilent E1441A Application Information Chapter end of main Error handling functionAgilent E1441A Application Information close the device session */ viClosefuncgen Chapter 64 Agilent E1441A Application Information Chapter Agilent E1441A SCPI Command ReferenceCommand Index by Function Chapter Modulation Commands66 Agilent E1441A SCPI Command Reference Arbitrary Waveform Commands Sweep CommandsTrigger Commands Agilent E1441A SCPI Command Reference Calibration Commands System-RelatedCommandsStatus Reporting Commands 68 Agilent E1441A SCPI Command Reference Option 001 Phase-LockCommands The IEEE-488.2Common CommandsAgilent E1441A SCPI Command Reference Chapter Common Command Format Command FundamentalsSCPI Command Format Abbreviated Commands Parameters Linking CommandsImplied Commands Command Guides SCPI Command Reference CALibration? CALibrationCOUNt? Subsystem Syntax Parameters SECure:CODESECure:STATe SETup? SETupSECure:STATe? STRing VALue STRing?VALue? Parameters Subsystem Syntax DATAVOLATILE DAC VOLATILE Downloading a Binary Block of Data ATTRibute:AVERage?ATTRibute CFACtor? ATTRibute PTPeak? ATTRibute:POINts?80 Agilent E1441A SCPI Command Reference Chapter COPY CATalog?Agilent E1441A SCPI Command Reference Chapter DELete NVOLatile:FREE? DEL:ALLNVOLatile:CATalog? BORDer FORMatBORDer? •Related Commands STATe:DELete MEMorySTATe:RECall:AUTO •Related Commands: *RCL, *SAV Comments • Returned Value: 0 or STATe:RECall:AUTO? LOAD OUTPutLOAD? Parameters SYNC? SYNCTRIGger:IMMediate TRIGger:STATe Agilent E1441A SCPI Command Reference TTLTrg<n>:STATe?enable TTLTRG2 line to source a trigger enable TTLTRG7 line to source a trigger ADJust PHASeSubsystem Syntax PHASe Only valid with Option UNLock:ERRor:STATe ADJust?UNLock:ERRor:STATe? REFerence 92 Agilent E1441A SCPI Command Reference SOURceSubsystem Syntax Chapter AM:DEPTh Amplitude Modulation AM CommandsParameters •*RST Condition: 100% AM:INTernal:FUNCtion AM:DEPTh?AM:INTernal:FUNCtion? AM:INTernal:FREQuency AM:STATe AM:SOURce?AM:STATe? •*RST Condition: BOTH Syntax APPLy CommandsAPPLy Command Parameters in the waveform see below Chapter 98 Agilent E1441A SCPI Command Reference ±10 Vdc into an open circuit APPLy NOISe APPLy:DCAPPLy:RAMP APPLy:SINusoid APPLy:TRIangle APPLy:SQUareAPPLy:USER APPLy? BM:NCYCles BURST MODULATION COMMANDSBM NCYCles? BurstCount BM:PHASe? BM:PHASeBM:INTernal:RATE Parameters BM:INTernal:RATE? FM COMMANDSBM:SOURce BM:SOURce? FM:DEViation? FM:DEViationFM:INTernal:FREQuency Parameters FM:INTernal:FUNCtion FM:INTernal:FREQuency?FM:INTernal:FUNCtion? FM:STATe FREQuency:STARt FREQuency?Agilent E1441A SCPI Command Reference Parameters FREQuency:STARt? Frequency-ShiftKeying FSK CommandsFREQuency:STOP FREQuency:STOP? FSKey FREQuency? FSKey:FREQuencyFSKey INTernal RATE FSKey:INTernal:RATE? FSKey:SOURce? Selecting an Arbitrary WaveformFSKey:STATe FSKey:STATe? FUNCtion:SHAPe FUNCtion:USER?Agilent E1441A SCPI Command Reference Chapter PULSe:DCYCle FUNCtion:SHAPe?112 Agilent E1441A SCPI Command Reference Parameters SWEep:SPACing PULSe:DCYCle?SWEep:SPACing? SWEep:TIME SWEep:STATe? SWEep:STATeVOLTage 114 Agilent E1441A SCPI Command Reference VOLTage:OFFSet VOLTage?Agilent E1441A SCPI Command Reference Parameters VOLTage:UNIT? VOLTage:OFFSet?VOLTage:UNIT STATus PRESetQUEStionable :CONDition? QUEStionable :EVENt? QUEStionable :ENABle? QUEStionable :ENABle Chapter Agilent E1441A SCPI Command ReferenceFigure SYSTem ERRor?VERSion? Subsystem Syntax SLOPe TRIGgerSLOPe? SOURce the *TRG IEEE-488.2common command Related Commands *RST Condition TRIG SOUR IMM SOURce? Command IEEE 488.2Common CommandReference124 Agilent E1441A SCPI Command Reference Category ESR? ESE?Comments • Coupled command: No •Related Commands: STATus:PRESet OPC? IDN?OPT? option Comments • Coupled command: No •Coupled command: No PSC?Comments • Coupled command: No •*RST Condition: none Comments • Coupled command: No •Coupled command: NoPower-OnCondition no bits are enabled Parameters STB? SRE?TST? Comments • Coupled command: No Feature Agilent E1441A Power-Onand Reset StatePower-Onand Reset State 130 Agilent E1441A SCPI Command Reference Chapter SCPI Command Quick ReferenceAgilent E1441A SCPI Command Reference Chapter 132 Agilent E1441A SCPI Command Reference Chapter Agilent E1441A SCPI Command ReferenceSOURce Chapter 134 Agilent E1441A SCPI Command Reference Appendix A Agilent E1441A SpecificationsSinewave Spectral Purity Frequency Characteristics Output Characteristics 1,5 Amplitude into 50Ω:2 Signal Characteristics Square waveResolution Triangle, Ramp, Arb Modulation CharacteristicsFrequency Sweep Faceplate Inputs5 Arb Download Times System Characteristics Configuration TimesCooling/Slot Operating Environment Phase Offset Option 001 Specifications Timebase AccuracyFaceplate Output: Ref Out terminal Trigger Appendix A 140 Agilent E1441A Specifications Execution Errors Agilent E1441A Error MessagesAppendix B 102 Syntax error 109 Missing parameter 108 Parameter not allowed112 Program mnemonic too long 113 Undefined header 151 Invalid string data 170to -178 Expression errors158 String data not allowed 161 Invalid block data 221 Settings conflict; offset has been adjusted 221 Settings conflict; frequency has been adjusted 222 Data out of range; amplitude 222 Data out of range222 Data out of range; frequency 222 Data out of range; offset 550Command not allowed in local 350 Too many errors580Phase-lockedloop is unlocked 440 Query UNTERMINATED after indefinite response Calibration Errors Self-TestErrors590I/O processor reset 601Trigger test failed 701Cal security disabled by jumper 702Cal secured 707Cal signal measurement out of range703Invalid secure code 704Secure code too long 850Cal setup invalid Arbitrary Waveform Errors851Negative offset gain cal required CAL:SETup 852Flatness DAC gain cal required CAL:SETup 785Specified arb waveform does not exist 783Arb waveform name too long786Cannot delete a built-inarb waveform 788Cannot copy to VOLATILE arb waveform 580Phase-lockedloop is unlocked Option 001 Phase-LockErrors Appendix B 152 Agilent E1441A Error Messages Direct Digital Synthesis Agilent E1441A Function Generator TutorialAppendix C Figure C-3 Figure C-2154 Agilent E1441A Function Generator Tutorial Appendix C Agilent E1441A Function Generator Tutorial Signal ImperfectionsAppendix C Figure C-4 Output Amplitude ControlFigure C-5 156 Agilent E1441A Function Generator Tutorial Attributes of AC Signals Floating Signal GeneratorsAppendix C Agilent E1441A Function Generator Tutorial 1 + D ⋅ Am 〈 t〉 ⋅ sin2π ⋅ Fc ⋅ T Modulation158 Agilent E1441A Function Generator Tutorial Appendix C Agilent E1441A Function Generator Tutorial Appendix CFor wideband FM Start Frequency + Stop Frequency Appendix C Deviation = Hop Frequency – Carrier Frequency160 Agilent E1441A Function Generator Tutorial for AM Table C-1624for FM Appendix C Points P = C/S / Fs = Fs = 1 / 9 x 200 ∝s = 555.555 kHzy = mX + b 162 Agilent E1441A Function Generator Tutorial Appendix D Service Procedures Automated Verification and Calibration Procedures Agilent Technologies Calibration ServicesClosed-CaseElectronic Calibration Calibration Interval Test Considerations Recommended Test Equipment Performance Verification Tests Performance Verification Tests Frequency VerificationQuick Performance Check DC Function Offset Verification Function Gain and Linearity Verification168 Service Procedures Table D-4.DC Function Offset Verification Service Procedures AC Amplitude VerificationTable D-5.AC Amplitude Verification High Z Appendix D Appendix D 170 Service ProceduresTable D-6.AC Amplitude Verification 50 Ohms Service Procedures Amplitude Flatness VerificationTable D-7.Amplitude Flatness Verification Appendix D Square Wave Duty Cycle Verification AM Modulation Depth VerificationOptional Performance Verification Tests Service Procedures Distortion VerificationTable D-10.Distortion Verification Appendix D To unsecure for calibration Calibration Security CodeTo re-secure To change security code Unsecuring the Function Generator Calibration Message Calibration Count Calibration Example General Calibration/Adjustment Procedure Aborting a Calibration in Progress Frequency and Burst Rate Adjustment Function Gain and Linearity Adjustment AC Amplitude Adjustment High-Z Modulation Adjustment Table D-15.50 Ohm Adjustment Setup AC Amplitude Adjustment 50 Ohms182 Service Procedures Appendix D Table D-16.AC Amplitude 50 Ohms Adjustment Setups 7.Repeat steps 4, 5 and 6 for SETUP 35 throughService Procedures 8.Perform the “AC Amplitude Verification” on page DC Output Adjustment AC Amplitude Flatness Adjustment Duty Cycle Adjustment 1 kHz to 100 kHz Appendix D Table D-22.AC Flatness Adjustment SetupsService Procedures Table D-23.System Error Messages Error MessagesTable D-24. Self-TestError Messages 188 Service Procedures Appendix D Table D-25.Calibration Error MessagesService Procedures Test Limits Measurement Uncertainty Performance Test RecordTest Accuracy Ratio TAR MaximumValue – ExpectedReading Appendix D Test Equipment Used Description Appendix DModel No Trace No Agilent E1441A Function Gain and Linearity Agilent E1441A Frequency AccuracyAgilent E1441A DC Function Offset Appendix D Appendix D Agilent E1441A AC Amplitude High Z Appendix D Agilent E1441A AC Amplitude 50 Ohms Appendix D Agilent E1441A Amplitude FlatnessAgilent E1441A AM Modulation Agilent E1441A Square Wave Duty Cycle Optional Performance Verification TestsAgilent E1441A Distortion Appendix D Appendix D Index Symbols CODE, STATe, CATalog?, FREE?, AVERage?, CFACtor?, POINts?, PTPeak?,ALL, IDN?, 124, OPC, 124, 126 *OPC? FM, 32, FSK, 41,ERRor STATe, STATe?, DELete, RST, 124, DEPTh, DEPTh?, INTernal FREQuency, FUNCtion, SRE?, 124,STB?, 124, WAI, 124, Vpp, 25, Vrms, 25,