Agilent Technologies Model A.08.xx Programming Examples System Requirements

Chapter 3 95

ProgrammingExamples

Programming Examples System Requirements

Programming Examples System Requirements

These examples were written for use on an IBM compatible PC configured as

follows:

•Pentium processor

•Windows 951 or Windows NT 4.0 operating system

•C programming language

•National Instruments GPIB interface card (for analyzers with Option A4H)

•National Instruments VISA Transition Libraries (VTL)

•COM1 serial port configured as follows (for analyzers with Option 1AX)

—9600 baud

—8 data bits

—1 stop bit

—no parity bits

—hardware flow control

A HP/Agilent 82341C card may be substituted for the National Instruments GPIB,

and the HP VISA libraries may be substituted for the National Instruments VISA

Transition Libraries. If substitutions are made, the subdirectories for the include

and library files will be different than those listed in the following paragraphs.

Refer to the documentation for your interface card and the VISA libraries for

details.

1. Microsoft is a U.S. registered trademark of Microsoft Corporation.

Contents

Main Programmers Guide Agilent Technologies EMC Series Spectrum Analyzers Notice Safety Informatio n Warr anty LIMITATION OF WARRANTY EXCLUSIVE REMEDIES Where to Find the Latest In formation Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Creating Valid Commands Command Notation Syntax Special Characters in Commands Parameters in Commands Page Page Improving Measurement Speed Turn off the display updates Disable auto alignment Use a fixed IF Gain range Disable the IF/Video/Sweep output ports Select phase noise performance Use binary data format instead of ASCII Minimize the number of GPIB transactions. Avoid unnecessary use of *RST. Minimize DUT/instrument setup changes. Putting Multiple Commands on the Same Line SCPI Termination and Separator Syntax Page Overview of GPIB (Option A4H) GPIB Instrument Nomenclature GPIB Command Statements Page Overview of RS-232 (Option 1AX) Settings for the Serial Interface Handshake and Baud Rate Character Format Parameters Modem Line Handshaking Data Transfer Errors Printer Setup and Operation Equipment Interconnection and Setup Page Testing Printer Operation Page Use Status Registers to Determine the State of Analyzer Events and Conditions What are the Status Registers? Page How Do You Access the Status Registers? Page Using the Service Request (SRQ) Method Generating a Service Request Page Setting and Querying the Status Register 89101112131415 6543210 Details of Bits in All Registers Status Byte Register + Figure 2-4 Status Byte Register Diagram The status byte register contains the following bits: Service Request Enable Register Standard Event Status Register Page Standard Event Status Event Enable Register STATus:OPERation Register Page The STATus:OPERation condition register contains the following bits: Page Page Figure 2-9 Status Questionable Register Diagram + ToStatus Byte Register Bit #3 012345678910111214 1315 Page Questionable Status Event Enable Register Page Questionable Status Power Condition and Event Registers Page Page Questionable Status Frequency Condition and Page Page Page Page Questionable Status Calibration Condition and Questionable Status Integrity Uncalibrated Condition and Page Page Questionable Status Integrity Event Condition and Enable Registers Page Page List of Programming Examples Programming Examples System Requirements C Programming Examples using VTL Typical Example Program Contents Linking to VTL Libraries Compiling and Linking a VTL Program Page Example Program Including the VISA Declarations File Opening a Session Device Sessions Page Addressing a Session Closing a Session Using Marker Peak Search and Peak Excursion Example: Page Page Page Using Marker Delta Mode and Marker Minimum Search Page Page Page Performing Internal Self-alignment Page Page Page Reading Trace Data using ASCII Format (GPIB) Page Page Page Reading Trace Data Using 32-bit Real Format (GPIB) Page Page Page Page Reading Trace Data Using ASCII Format (RS-232) Page Page Page Page Reading Trace Data Using 32-bit Real Format (RS-232) Page Page Page Page Using Limit Lines Page Page Page Page Page Measuring Noise Page Page Page Entering Amplitude Correction Data Page Page Page Status RegisterDetermine When a Measurement is Done Page Page Page Page Page Determine if an Error has Occurred Page Page Page Page Page Measuring Harmonic Distortion (GPIB) Page Page Page Page Page Page Page Measuring Harmonic Distortion (RS-232) Page Page Page Page Page Page Page Making Faster Measurements (multiple measurements) Page Page Page Page Page Page Page Page Functional Index to SCPI Subsection Page Page Page Page SCPI Sections and Subsections Page IEEE Common Commands Calibration Query Clear Status Standard Event Status Enable Standard Event Status Register Query Identification Query Instrument State Query Operation Complete Query Instrument Options Recall Reset Save Service Request Enable Read Status Byte Query Trig ger Self Test Query Wait-to-Continue ABORt Subsystem Abort CALCulate Subsystem NdBpoints NdBresults NdBstate Calculate Correction at Frequency Test Current Trace Data Against all Limit Lines CALCulate:EMI:SLISt Subsection Add Measure to List Add Marker to List Append Signal Data to List Page Page Clear Marks Set Comment for Signals Set Comment for Current Signal Set Comment for Marked Signals Delete Signal Turn Signal List On or Off Retrieve Signal as a String Retrieve Signals in List Mark Selected Signals Position Cursor to Signal List Specify Sort Key Specify Signal List Display Parameters CALCulate:LLINe Subsection Delete All Correction Sets in Memory Control Limit Line Amplitude Interpolation Set Fixed or Relative Limit Lines Set Limit Line X-axis Units Control Limit Line Frequency Interpolation Define Limit Line Values Page Merge Additional Values into the Existing Limit Line Delete Limit Line Display the Limit Line Test the Data Against the Limit Line Set the Margin Size Display the Limit Margin Control Limit Line Testing Select the Type of Limit Line CALCulate:MARKer Subsection Markers All Off on All Traces Continuous Peaking Marker Function Frequency Counter Marker Resolution Frequency Counter Marker Automatic Resolution Frequency Counter Marker Frequency Counter Marker Query Marker Function Marker Peak (Maximum) Search Marker Peak (Maximum) Left Search Marker Next Peak (Maximum) Search Marker Peak (Maximum) Right Search Marker Peak (Minimum) Search Marker Mode Define Peak Excursion Define Peak Search Define Peak Threshold Peak to Peak Delta Markers Set Center Frequency to the Marker Value Set Reference Level to the Marker Value Set Span to the Marker Value Set Start Frequency to the Marker Value Set Center Frequency Step Size to the Marker Value Set Stop Frequency to the Marker Value Marker On/Off Marker Table On/Off Marker to Trace Marker to Trace Auto Continuous Signal Tracking Function Marker X Value Span Markers Center Frequency X Value Marker X Position Span Markers Center Frequency X Position Span Markers Span X Position Delta Pair Markers Start Frequency X Position Delta Pair Markers Stop Frequency X Position Marker X-Axis Readout Span Markers Span X Value Delta Pair Markers Start Frequency X Value Delta Pair Markers Stop Frequency X Value Marker Read Y Value CALCulate:NTData Subsection Normalize the Trace Data CALibration Subsystem Align All Instrument Assemblies Set Auto Align Mode All or Not RF Automatic Alignment Return to the Default Alignment Data Align FM Demodulation Query the Internal or External Frequency Reference Coarse Adjust the Frequency Reference Fine Adjust the Frequency Reference Select the Frequency Corrections Align the RF Circuitry Select the Source State for Calibration Calibrate the Tracking Generator COUPle Subsystem COUPle the Function to Other Settings Page DISPlay Subsystem Display Viewing Angle Date and Time Display Format Date and Time Display Display Annotation Title Data Turn the Entire Display On/Off Turn the Full Screen Display On/Off Window Annotation Trace Graticule Display Trace X-Axis Scale Offset Display Line Amplitude Display Line On/Off IF Gain Auto/Reference Level Auto Ranging Normalized Reference Level Normalized Reference Level Position Trace Y-Axis Amplitude Scaling Trace Y-Axis Frequency Scaling Trace Y-Axis Reference Level Trace Y-Axis Reference Level Offset Vertical Axis Scaling FORMat Subsystem Byte Order Numeric Data format Page HCOPy Subsystem Abort the Print Printer Type Select Report Content Print Report Select a Signal List to Include in a Report Select a Signal List to Include in a Report (Delta) Color Hard Copy Print a Hard Copy Form Feed the Print Item Page Orientation Number of Items Printed on a Page Printed Page Size Select Report Type INITiate Subsystem Continuous or Single Measurements Take New Data Acquisitions Abort Measurement Pause the Measurement Restart the Measurement Resume the Measurement INPut Subsystem Input Port Coupling Clear the Input Overload MEASure Group of Commands Configure Commands Fetch Commands Measure Commands Read Commands Get Measurement Results Read Command Configure for Measuring Frequency Measure at Marker Measure at Marker and Add to List Setting Max/Min On or Off Max/Min View ->Max Measure Peaks Remeasure Current Signal MMEMory Subsystem Catalog the Selected Memory Location Copy a File Move Data to File Delete a File Load a Corrections Table from a File Load a Limit Line from Memory to the Instrument Load an Instrument State from a File Load a Trace From a File to the Instrument Make a Directory Store (Load/Save) a Signal List Delete a Directory Store a Corrections Table to a File Store a Limit Line in a File Store Measurement Results in a File Store a Screen Image in a Graphic File Store an Instrument State in a File Store a Trace in a File OUTPut Subsystem Turn Output On/Off SENSe Subsystem [:SENSe]:AVERage Subsection Clear the Current Average Set the Average Count Turn Averaging On/Off Turn Automatic Averaging On/Off Type of Averaging for Measurements [:SENSe]:BANDwidth Subsection Resolution Bandwidth Resolution Bandwidth Automatic Resolution Bandwidth Mode Video Bandwidth Video Bandwidth Automatic Video to Resolution Bandwidth Ratio Video to Resolution Bandwidth Ratio Mode Select Page Resolution Bandwidth Type [:SENSe]:CORRection Subsection Delete All Corrections Perform Amplitude Correction Set Amplitude Correction Data Merge Additional Values into the Existing Amplitude Correction Data Delete Amplitude Correction Set Amplitude Correction Frequency Interpolation Perform Amplitude Correction Input Impedance Correction External Amplifier Correction [:SENSe]:DEMod Subsection Type of Demodulation FM Deviation Squelch Demodulation Control Demod Time Demod View [:SENSe]:DETector Subsection Automatic Detection Type Selected Page Type of Detection Type of EMI Detector EMI View Range Immediate Unrange [:SENSe]:EMI Subsection Auto Measure Average On or Off Auto Measure Peak On or Off Auto Measure Quasi Peak On or Off Setting the Dwell Time for Peak Setting the Dwell Time for Quasi Peak Setting the Dwell Time for Average Peak Preselector Centering On or Off (E7403A, E7404A, E7405A only) Setting the Dwell Time for Range Auto Measure Margin On or Off [:SENSe]:FREQuency Subsection Center Frequency Center Frequency Step Size Automatic Center Frequency Step Size Frequency Span Full Frequency Span Last Frequency Span Start Frequency Stop Frequency Frequency Synthesis Mode Frequency Synthesis State [:SENSe]:POWer Subsection Enable/Disable QPD X10 Gain Input Attenuation Input Port Attenuator Auto Input Port Power Gain Input Port Maximum Mixer Power Optimize Preselector Frequency Preselector Center [:SENSe]:SWEep Subsection Sweep Points Set Frequency Domain Scale Type Sweep Time Automatic Sweep Time Sweep Time Mode Time Gating Delay (Option 1D6 Only) Time Gate Length (Option 1D6 Only) Time Gate Level (Option 1D6 Only) Time Gate Polarity (Option 1D6 Only) Preset Time Gate (Option 1D6 Only) Control Time Gate (Option 1D6 Only) Time Gate Trigger Type (Option 1D6 Only) SOURce Subsystem Sets the Output Power Offset Correction Source Attenuation Automatic Source Attenuation Sets the Output Power Sets the Source Output Power Mode Set the Source Sweep Power Range Set the Output Power at the Start of the Sweep Set the Output Power to Step Automatically Set the Output Power Step Size Set the Source Sweep Power Range Output Power Tracking Output Power Tracking Peak STATus Subsystem Operation Condition Query Operation Enable Operation Event Query Operation Negative Transition Operation Positive Transition Preset the Status Byte STATus:QUEStionable Subsection Questionable Calibration Condition Questionable Calibration Enable Questionable Calibration Event Query Questionable Calibration Negative Transition Questionable Calibration Positive Transition Questionable Condition Questionable Enable Questionable Event Query Questionable Frequency Condition Questionable Frequency Enable Questionable Frequency Event Query Questionable Frequency Negative Transition Questionable Frequency Positive Transition Questionable Integrity Condition Questionable Integrity Enable Questionable Integrity Event Query Questionable Integrity Negative Transition Questionable Integrity Positive Transition Questionable Integrity Uncalibrated Enable Questionable Integrity Uncalibrated Event Query Questionable Integrity Uncalibrated Negative Transition Questionable Integrity Uncalibrated Positive Transition Questionable Negative Transition Questionable Power Condition Questionable Power Enable Questionable Power Event Query Questionable Power Negative Transition Questionable Power Positive Transition Questionable Positive Transition SYSTem Subsystem GPIB Address Serial Port DTR Setup Serial Port RTS Setup Serial Port Baud Rate Setup Serial Port Receive Pace Setup Serial Port Transmit Pace Setup Hardware Configuration Query Display the Hardware Configuration System Configuration Query Display System Configuration Set Date Error Information Query Locate SCPI Command Errors Host Identification Query License Key Install Application/Option Delete a License Key Query Instrument Options Power On Elapsed Time Power On Time Power On Type Enable IF/Video/Sweep Output Ports Preset Persistent State Reset Preset Type Save User Preset Speaker Control Set Time SCPI Version Query TRACe Subsystem Copy Trace Transfer Trace Data Exchange Traces Trace Math Add Mean Trace Data Query the Signal Peaks Query Number of Peaks Found Peak Sorting Smooth Trace Data Page Number of Points for Smoothing Trace Math Subtract Trace Math Subtract From Display Line Select Trace Display Mode TRIGger Subsystem External Trigger, Line Trigger Delay Value External Trigger, Line Trigger Delay Enable External Trigger Slope Trigger Offset Trigger Source Video Trigger Level Amplitude Video Trigger Level Frequency UNIT Subsystem Select Power Units of Measure