Agilent Technologies E4440A, E4440-90189, E4443A, E4445A, E4446A, E4448A Closing a Session

Chapter 6 553

Programming Fundamentals

Programming in C Using the VTL

Programming Fundamentals

viOpenDefaultRM (&defaultRM);

viOpen (defaultRM, "GPIB0::23::INSTR", VI_NULL,VI_NULL,&vi);

viClose(vi);

viClose (defaultRM);

Closing a Session

The viClose function must be used to close each session. You can close

the specific device session, which will free all data structures that had

been allocated for the session. If you close the default resource manager

session, all sessions opened using that resource manager will be closed.

Since system resources are also used when searching for resources

(viFindRsrc)orwaitingforevents(viWaitOnEvent), the viClose

functionneedstobecalledtofreeupfindlistsandeventcontexts.

Contents

Main Users and Programmers Reference Agilent Technologies PSA Spectrum Analyzers Legal Information 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 Page Page Page Page Page Page Page Book Organization What is in This Book TermsUsedinThisBook Page 2Instrument Functions: A L Page 2.0.1 Ref Level 2.0.2 Attenuation Page 2.0.3 Scale/Div 2.0.4 Scale Type Page 2.0.5 Presel Center 2.0.6 Presel Adjust 2.0.7 Y Axis Units Page 2.0.8 Ref Lvl Offset 2.0.9 Int Preamp 2.0.10 Corrections Page Page Page Page Page Page Page Page 2.0.11 Ext Amp Gain 2.0.12 Atten Step 2.0.13 Max Mixer Lvl Page 2.1 Auto Couple 2.1.1 Auto All 2.1.2 FFT & Sweep Page Page Page 2.1.3 PhNoise Opt 2.1.4 Detector Page 2.1.6 ADC Dither 2.1.7 ADC Ranging Page Page 2.2 BW/Avg 2.2.1 Res BW 2.2.2 Video BW Page 2.2.3 VBW/RBW 2.2.4 Average Page 2.2.5 Avg/VBW Type New avg N1()Oldavg Newdata+ N -------------------------------------------------------------------= New Avg 10 N1()10 10 + N ------------------------------------------------------------------------------ log= Page 2.2.6 Span/RBW Page 2.3 Det/Demod 2.3.1 Detector Page Page Page Page Page Page Page 2.4 Display 2.4.1 Full Screen 2.4.2 Display Line 2.4.3 Display Line Page 2.4.4 Active Fctn Position Page 2.4.5 Limits Page Page Page Page Page Page Chapter 2 115 Instrument Functions: A - L Display Instrument Functions: A - L Page Page Page Page Page Page 2.4.6 Title 2.4.7 Preferences Page 2.4.8 Display Enable (Remote Command Only) Page 2.5 File Page Page 2.5.1 Catalog Page Page Page Page Page 2.5.2 Save Page Page Page Page Page Page 2.5.3 Load Page Page Page 2.5.4 Delete Page Page Page 2.5.5 Copy Page 2.5.6 Rename Page 2.5.7 Create Dir Page 2.5.8 Delete All 2.5.9 Query Trace Data (Remote Command Only) 2.5.10 Move Data to a File (Remote Command Only) Page 2.5.11 Set Data Byte Order (Remote Command Only) 2.5.12 Format Numeric Data (Remote Command Only) Page Page 2.6 FREQUENCY / Channel 2.6.1 Center Freq 2.6.2 Start Freq 2.6.3 Stop Freq 2.6.4 CF Step 2.6.5 Freq Offset 2.6.6 Signal Track Page Page 2.7 Input/Output 2.7.1 Input Port 2.7.2 RF Coupling 2.7.3 Input Z Corr 2.7.4 Trig Input Page Page Page 3.1 Marker Page Page 3.1.1 Select Marker 3.1.2 Normal 3.1.3 Delta 3.1.4 Delta Pair Page Page 3.1.5 Span Pair 3.1.6 Off 3.1.7 Marker Trace 3.1.8 Readout Page Page 3.1.9 Marker Table 3.1.10 Marker All Off Page 3.2 Marker Fctn 3.2.1 Select Marker 3.2.2 Marker Noise Page 3.2.3 Band/Intvl Power 3.2.4 Function Off 3.2.5 Marker Count Page Page 3.3 Marker -> 3.3.1 Mkr->CF 3.3.2 Mkr->CF Step 3.3.3 Mkr->Start Page 3.3.4 Mkr->Stop 3.3.5 Mkr->Span 3.3.6 Mkr->CF 3.3.7 Mkr->Ref Lvl 3.4 Meas Setup (SA with Measurements Off) 3.4.1 Measurement Setup Page 3.5 MODE 3.5.1 Spectrum Analysis 3.5.2 Application Mode Number Selection (Remote command only) Page 3.5.3 Application Mode Catalog Query (Remote command only) 4Instrument Functions: P Z Page 4.1 Peak Search 4.1.1 Next Peak 4.1.2 Next Pk Right 4.1.3 Next Pk Left 4.1.4 Min Search Page 4.1.5 Pk-Pk Search 4.1.6 Mkr->CF 4.1.7 Continuous Pk 4.1.8 N dB Points Page 4.1.9 Search Param Page Page Page Page Page 4.2 Preset 4.2.1 User Preset Page 4.2.2 Mode Preset 4.2.3 Factory Preset 4.2.4 Save User Preset Page 4.3 Print 4.3.1 Abort the Printout (Remote Command Only) Page 4.4 Print Setup 4.4.1 Printer Setup Page 4.4.2 Orientation 4.4.3 Prints/Page 4.4.4 Eject Page 4.4.5 Page Size Page 4.4.6 Color 4.5 Save Page 4.6 SPAN / X Scale 4.6.1 Span 4.6.2 Span Zoom 4.6.3 Full Span 4.6.4 Zero Span 4.6.5 Last Span Page 4.7 SWEEP 4.7.1 Sweep Time 4.7.2 Sweep 4.7.3 Auto Sweep Time 4.7.4 Points Page Page 4.8 System 4.8. 1 4.8.2 Power On/Preset Page Page Page 4.8.3 Time/Date Page Page 4.8.4 Alignments Page Page Page Page Page Page 4.8.5 Config I/O Page Page Page Page Page 4.8.6 Reference Page 4.8.7 Show System 4.8.8 Show Hdwr 4.8.9 Color Palette Page Page 4.8.10 Diagnostics 4.8.11 Restore Sys Defaults Chapter 4 275 Instrument Functions: P - Z System Instrument Functions: P - Z Key P ath: Table 4-2 System Default Settings 4.8.12 Licensing Page Page 4.8.13 Personality 4.8.14 Service 4.8.15 Keyboard Lock (Remote Command Only) 4.8.16 Remote Message 4.8.17 Remote Message Turned Off 4.8.18 Power On Elapsed Time (Remote Command Only) 4.8.19 SCPI Version Query (Remote Command Only) Page 4.9 Trace/View 4.9.1 Query Trace Data (Remote Command Only) 4.9.2 Trace 4.9.3 Clear Write 4.9.4 Max Hold 4.9.5 Min Hold 4.9.6 View 4.9.7 Blank 4.10 Trig 4.10.1 Free Run 4.10.2 Video 4.10.3 Line 4.10.4 Ext Front 4.10.5 Ext Rear 4.10.6 RF Burst (Wideband) 4.10.7 Trig Slope 4.10.8 Trig Delay 4.10.9 Trig Offset (Remote Command Only) Page Page One - Button Measurement Functions Table 5-1 Page 5.1 MEASURE (Spectrum Analysis Mode) 5.1.1 Command Interactions: MEASure, CONFigure, FETCh, INITiate and READ Page Page 5.1.2 Meas Off 5.1.3 Channel Power Page Page 5.1.4 Occupied BW 5.1.5 Adjacent Channel PowerACP Page Page Page 5.1.6 Multi-Carrier Power Page Example: FETC:MCP? or MEA:MCP? or READ:MCP? 5.1.7 Power Stat CCDF n= Pavg V2Z0 () Page Page 5.1.8 Harmonic Distortion Page Page Page Page Example: FETC:BPOW? or MEAS:BPOW? or READ:BPOW? 5.1.10 Intermod (TOI) Example: FETC:TOIN? or MEAS:TOIN? or READ:TOIN? FETC:TOIN:IP3? or MEAS:TOIN:IP3? or READ:TOIN:IP3? 5.1.11 Spurious Emissions 5.1.12 Spectrum Emission Mask Page Page Page Page Page 5.1.13 Current Measurement Query (Remote Command Only) 5.2 Meas Control 5.2.1 Restart 5.2.2 Measure 5.2.3 Pause or Resume 5.2.4 Trigger a Sweep or Measurement (Remote Command Only) 5.2.5 Abort the Sweep or Measurement (Remote Command Only) Page 5.3 Mode Setup (Spectrum Analysis Mode) 5.3.1 Radio Std Page Page Page Page Page Page Page 5.3.2 Radio Std Setup 5.3.3 Retain Params Page 5.3.4 Enable All Measurements 5.3.5 Autorange of Power Setting (Remote command only) Page Page 5.4 Restart Page 5.5 Single Page 5.6 Meas Setup (Adjacent Channel PowerACP) 5.6.1 Avg Number Page 5.6.2 Avg Mode 5.6.3 Chan Integ BW 5.6.4 Offset/Limits Page Page Page Page 5.6.5 Meas Type 5.6.6 Optimize Ref Level 5.6.7 Method Page 5.6.8 Total Pwr Ref 5.6.9 PSD Ref 5.6.10 Limit Test 5.6.11 RRC Filter 5.6.12 Filter Alpha 5.6.13 Noise Correction Page Page 5.7 Trace/View (ACP Measurement) 5.7.1 Spectrum 5.7.2 Bar Graph 5.7.3 Combined 5.7.4 Combined View Units 5.7.5 Trace Page Page 5.8 Meas Setup (Burst Power) 5.8.1 Avg Number 5.8.2 Avg Mode 5.8 .3 5.8. 4 5.8. 5 5.8 . 6 5.8.7 Optimize Ref Level Page 5.9 Trace/View (Burst Power) 5.9.1 RF Envelope 5.9.2 Combined 5.9.3 Trace Page Page 5.10 Meas Setup 5.10.1 Meas BW 5.10.2 Counts 5.10.3 Meas Interval 5.10.4 Optimize Ref Level Page 5.11 Display 5.11.1 Full Screen 5.11.2 Store Ref Trace 5.11.3 Ref Trace 5.11.4 Gaussian Trace 5.11.5 Preferences Page Page 5.12 SPAN X Scale (Complementary Cumulative Distribution FunctionCCDF) 5.12.1 Scale/Div Page 5.13 Marker 5.13.1 Select Marker 5.13.2 Normal 5.13.3 Delta Page 5.13.4 Off 5.13.5 Marker Trace 5.13.6 Marker All Off 5.13.7 Marker X Position 5.13.8 Marker Y Position (Remote Command Only) 5.13.9 Marker Maximum and Minimum (Remote Command Only) Page 5.14 Meas Setup (Channel PowerCHP) 5.14.1 Avg Number 5.14.2 Avg Mode 5.14.3 Integ BW 5.14.4 Chan Pwr Span 5.14.5 Optimize Ref Level 5.14.6 RRC Filter 5.14.7 Filter Alpha Page Page 5.15 Trace/View (Channel Power Measurement) 5.15.1 Spectrum 5.15.2 Combined 5.15.3 Trace Page Page Page 5.16 Meas Setup (Harmonic Distortion) 5.16.1 Avg Number 5.16.2 Avg Mode 5.16.3 Harmonics 5.16.4 ST/Harmonic Page 5.16.5 Range Table (On/Off) 5.16.6 Range Table Page Page Page Page Page 5.16.7 Optimize Ref Level Page 5.17 Trace/View (Harmonics) 5.17.1 Harmonics 5.17.2 Harmonics & THD Page 5.18 Meas Setup (Intermod (TOI)) 5.18.1 Avg Number Page 5.18.2 Avg Mode 5.18.3 TOI Span 5.18.4 Max Mixer Lvl 5.18.5 Optimize Ref Level Page Page 5.19 Meas Setup (Multi-Carrier PowerMCP) 5.19.1 Avg Number 5.19.2 Avg Mode 5.19.3 Carrier Setup Page Page Page Page Page Page Page 5.19.4 Offsets/Limits Page Page 5.19.5 Carrier Result 5.19.6 Optimize Ref Level 5.19.7 Method 5.19.8 Power Ref 5.19.9 Limit Test 5.19.10 RRC Filter 5.19.11 Filter Alpha 5.19.12 Noise Correction Page 5.20 Trace/View (Multi-Carrier Power Measurement) 5.20.1 Spectrum 5.20.2 Combined 5.20.3 Combined View Units 5.20.4 Trace Page Page 5.21 Meas Setup (Occupied BandwidthOBW) 5.21.1 Avg Number 5.21.2 Avg Mode 5.21.3 Max Hold Page 5.21.4 Occ BW % Pwr 5.21.5 OBW Span 5.21.6 x dB 5.21.7 Optimize Ref Level 5.22 Meas Setup (Spectrum Emissions MaskSEM) 5.22.1 Avg Number 5.22.2 Meas Type 5.22.3 Ref Channel Page Page Page 5.22.4 Offset/Limits Chapter 5 463 One-Button Measurement Functions Meas Setup (Spectrum Emissions MaskSEM) One-Button Measurement Functions Table 5-3 Offsets & Limits Defaulted for W-CDMA (3GPP) Mobile Station Measur ements a. Abs Stop issettoCoupleandFail Mask is set to Abs AND Rel. a. set to Rel. T a ble 5-5 Offsets & Limits Defau lte d for 802.1 1b Radio S tandard Page Page Page Page Page Page Page Page Page Page Page 5.22.5 Optimize Ref Level 5.22.6 RRC Filter 5.22.7 Filter Alpha 5.23 Trace/View (Spectrum Emissions Mask) 5.23.1 Abs Pwr & Freq 5.23.2 Rel Pwr & Freq 5.23.3 Integrated Power 5.24 Display (Spectrum Emissions MaskSEM) 5.24.1 Full Screen 5.24.2 Limit Display 5.24.3 Preferences Page 5.25 SPAN X Scale (Spectrum Emissions MaskSEM) 5.25.1 Scale/Div 5.25.2 Ref Value 5.25.3 Ref Position Page 5.26 Marker (Spectrum Emissions MaskSEM) 5.26.1 Select Marker 5.26.2 Normal 5.26.3 Off 5.27 Meas Setup (Spurious Emissions) 5.27.1 Avg Number 5.27.2 Avg Mode 5.27.3 Range Table Page Page Page Page Page Page Page Page Page Page Chapter 5 497 One-Button Measurement Functions Meas Setup (Spurious Emissions) One-Button Measurement Functions 5.27.4 Meas Type Key P at h: State Saved: Saved in instrument state. Factory Preset: Examine Range: Examine|Full 5.27.5 Spur 5.27.6 Ref Level 5.27.7 Fast Spurious Meas Page Page Page SCPI Language Basics Command Keywords and Syntax Creating Valid Commands Special Characters in Commands Parameters in Commands Page Putting Multiple Commands on the Same Line Page Page Improving Measurement Speed Turn off the display updates. Use binary data format instead of ASCII Minimize the number of GPIB transactions. Avoid unnecessary use of *RST. Put ADC Ranging in Bypass for FFT Measurements Minimize DUT/instrument setup changes. Consider using LAN instead of GPIB. Using an Option Mode: Minimize the number of GPIB transactions. Using an Option Mode: Avoid automatic attenuator setting. Using an Option Mode: Optimize your GSM output RF spectrum switching measurement. Using an Option Mode: Avoid using RFBurst trigger for single burst signals. Page Page Table 6-1 GSM Parameters for 1 Slot/Frame Measurement Requirements a. The use of time values is only allowed in firmware versions of A.02.00 and later. Programming Command Compatibility Across Model Numbers and Across Modes Across PSA Modes: Command Subsystem Similarities Page Across PSA Modes: Specific Command Differences Some programming commands operate differently depending on which Mode the analyzer is set to. Using Applications in PSA Series vs. VSA E4406A Basic, cdmaOne, cdma2000, 1xEV-DO, W-CDMA, GSM, EDGE, NADC, and PDC. Page UsingtheLANtoControltheInstrument Using ftp for File Transfers Page This table lists the available user commands. Table 6-2 ftp Commands Using Telnet to Send Commands Page Page Using Socket LAN to Send Commands Using SICL LAN to Control the Instrument Page Page Page Page Using HP/Agilent VEE Over Socket LAN Page Using a Java Applet Over Socket LAN Using a C Program Over Socket LAN General LAN Troubleshooting Page Page Page Page Page Page Page Programming in C Using the 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 Addressing a Session Page Closing a Session Overview of the GPIB Bus GPIB Command Statements Page Page Page Page Status System Commands Page Page Page Common IEEE Commands Calibration Query Clear Status Standard Event Status Enable Standard Event Status Register Query Identification Query Instrument State Query Operation Complete Query Instrument Options Power-On Status Clear Recall Reset Save Service Request Enable Read Status Byte Query Trigger Self Test Query Wait-to-Continue Page Page STATus Subsystem Operation Register Page Preset the Status Byte Questionable Register Page Questionable Calibration Register Questionable Frequency Register Page Questionable Integrity Register Page Questionable Integrity Signal Register Page Questionable Integrity Uncalibrated Register Questionable Power Register Page Questionable Temperature Register 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 Page Page Page 623 9Menu Maps: One-Button Measurement Functions One-Button Measurement Menu Maps Page Meas Control Key Page Mode Setup Key (2 of 2) ACP Measurement: Meas Setup Key ACP Measurement: Trace/View Key Page Burst Power Measurement: Trace/View Key Page CCDF (Power Stat) Measurement: Trace/View Key Page CCDF (Power Stat) Measurement: Span X Scale Key CCDF (Power Stat) Measurement: Marker Key Channel Power Measurement: Meas Setup Key Page Harmonic Distortion Measurement: Meas Setup Key Page Intermod (TOI): Meas Setup Key Multi-Carrier Power Measurement: Meas Setup Key Multi-Carrier Power Measurement: Trace/View Key Page Spectrum Emission Mask Measurement: Meas Setup Key Page Spectrum Emission Mask Measurement: Display Key Page Spectrum Emission Mask Measurement: Marker Key

Agilent Technologies Closing a Session

Models: E4440A E4440-90189 E4443A E4445A E4446A E4448A

Closing a Session