Specifications

ManualsBrandsAgilent Technologies ManualsCamera Accessories34401A

Agilent Technologies Part no. E4418-90029

December, 1998

Programming Guide

Agilent Technologies

E4418B/E4419B Power Meters

prog.book Page i Thursday, June 7, 2001 2:55 PM

Summary of content (482 pages)

PAGE 1
prog.book Page i Thursday, June 7, 2001 2:55 PM Programming Guide Agilent Technologies E4418B/E4419B Power Meters Agilent Technologies Part no.
PAGE 2
prog.book Page ii Thursday, June 7, 2001 2:55 PM © Copyright 1998 Agilent Technologies All rights reserved. Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under the copyright laws. Printed in the UK.
PAGE 3
prog.book Page iii Thursday, June 7, 2001 2:55 PM Legal Information Legal Information Notice Information contained in this document is subject to change without notice. Agilent Technologies makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.
PAGE 4
prog.book Page iv Thursday, June 7, 2001 2:55 PM Legal Information Limitation of Warranty The foregoing warranty shall not apply to defects resulting from improper or inadequate maintenance by Buyer, Buyer-supplied software or interfacing, unauthorized modification or misuse, operation outside of the environmental specifications for the product, or improper site preparation or maintenance. NO OTHER WARRANTY IS EXPRESSED OR IMPLIED.
PAGE 5
prog.book Page v Thursday, June 7, 2001 2:55 PM Equipment Operation Equipment Operation Warnings and Cautions This guide uses warnings and cautions to denote hazards. WARNING A warning calls attention to a procedure, practice or the like, which, if not correctly performed or adhered to, could result in injury or the loss of life. Do not proceed beyond a warning until the indicated conditions are fully understood and met.
PAGE 6
prog.book Page vi Thursday, June 7, 2001 2:55 PM General Safety Considerations General Safety Considerations WARNING Before this instrument is switched on, make sure it has been properly grounded through the protective conductor of the ac power cable to a socket outlet provided with protective earth contact. Any interruption of the protective (grounding) conductor, inside or outside the instrument, or disconnection of the protective earth terminal can result in personal injury.
PAGE 7
prog.book Page vii Thursday, June 7, 2001 2:55 PM General Safety Considerations IEC 1010-1 Compliance This instrument has been designed and tested in accordance with IEC Publication 1010-1 +A1:1992 Safety Requirements for Electrical Equipment for Measurement, Control and Laboratory Use and has been supplied in a safe condition. The instruction documentation contains information and warnings which must be followed by the user to ensure safe operation and to maintain the instrument in a safe condition.
PAGE 8
prog.book Page viii Thursday, June 7, 2001 2:55 PM About this Guide About this Guide Chapter 1: Power Meter Remote Operation This chapter describes the parameters which configure the power meter and helps you determine settings to optimize performance. Chapter 2: MEASurement Instructions This chapter explains how to use the MEASure group of instructions to acquire data using a set of high level instructions.
PAGE 9
prog.book Page ix Thursday, June 7, 2001 2:55 PM About this Guide Chapter 9: SENSe Subsystem This chapter explains how the SENSe command subsystem directly affects device specific settings used to make measurements. Chapter 10: STATus Subsystem This chapter explains how the STATus command subsystem enables you to examine the status of the power meter by monitoring the “Device Status Register”, “Operation Status Register” and the “Questionable Status Register”.
PAGE 10
prog.
PAGE 11
prog.book Page 1 Thursday, June 7, 2001 2:55 PM Table of Contents Page Legal Information ........................................................................ iii Notice ..................................................................................... iii Certification ........................................................................... iii Warranty................................................................................ iii Limitation of Warranty ......................................
PAGE 12
prog.book Page 2 Thursday, June 7, 2001 2:55 PM Enabling the Sensor Calibration Table System ................... 1-38 Making the Measurement...................................................... 1-39 Using Frequency Dependent Offset Tables ................................. 1-40 Overview ................................................................................. 1-40 Editing Frequency Dependent Offset Tables........................ 1-42 Selecting a Frequency Dependent Offset Table....................
PAGE 13
prog.book Page 3 Thursday, June 7, 2001 2:55 PM Example Program ................................................................... 1-91 Using Device Clear to Halt Measurements ................................. 1-92 An Introduction to the SCPI Language ....................................... 1-93 Syntax Conventions................................................................ 1-95 SCPI Data Types .................................................................... 1-95 Input Message Terminators..........
PAGE 14
prog.book Page 4 Thursday, June 7, 2001 2:55 PM [[,[,]]] ...................... 2-24 FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] ...................... 2-27 FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] ...................... 2-29 FETCh[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] ......................
PAGE 15
prog.book Page 5 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem........................................................................ 3-1 CALCulate Subsystem.................................................................. 3-2 The CALCulate[1|2]:GAIN Node ................................................ 3-4 CALCulate[1|2]:GAIN[:MAGNitude] ............ 3-5 CALCulate[1|2]:GAIN:STATe .................................. 3-7 CALCulate[1|2]:LIMit Node ..............................
PAGE 16
prog.book Page 6 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem............................................................................. 5-1 DISPlay Subsystem ...................................................................... 5-2 DISPlay:CONTrast ......................................... 5-3 DISPlay:ENABle ........................................................ 5-5 DISPlay[:WINDow[1|2]] Node.....................................................
PAGE 17
prog.book Page 7 Thursday, June 7, 2001 2:55 PM MEMory:TABLe:GAIN[:MAGNitude]:POINts? .......................... 7-28 MEMory:TABLe:MOVE , ................................. 7-29 MEMory:TABLe:SELect ................................................ 7-30 OUTput Subsystem ............................................................................. 8-1 OUTPut Subsystem ...................................................................... 8-2 OUTPut:ROSCillator[:STATe] ........
PAGE 18
prog.book Page 8 Thursday, June 7, 2001 2:55 PM |ONCE......................................................................... 9-40 [SENSe[1]]|SENSe2:LIMit:CLEar[:IMMediate] ........................ 9-42 [SENSe[1]]|SENSe2:LIMit:FAIL? .............................................. 9-43 [SENSe[1]]|SENSe2:LIMit:FCOunt?.......................................... 9-44 [SENSe[1]]|SENSe2:LIMit:LOWer[:DATA] ..........................................................................
PAGE 19
prog.book Page 9 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem........................................................................... 11-1 SYSTem Subsystem .................................................................... 11-2 SYSTem:COMMunicate:GPIB[:SELF]:ADDRess ......................................................................... 11-3 SYStem:COMMunicate:Serial Node .......................................... 11-4 SYSTem:COMMunicate:SERial:CONTrol :DTR ON|OFF|IBFull ..........
PAGE 20
prog.book Page 10 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem .......................................................................... 12-1 TRIGger Subsystem.................................................................... 12-2 ABORt[1|2] ................................................................................. 12-3 INITiate Node ............................................................................. 12-4 INITiate[1|2]:CONTinuous .....................................
PAGE 21
prog.book Page 11 Thursday, June 7, 2001 2:55 PM *ESE ................................................................................ 15-10 *ESR?........................................................................................... 15-11 *IDN? ........................................................................................... 15-12 *OPC ............................................................................................ 15-13 *OPT? ...............................................
PAGE 22
prog.
PAGE 23
prog.book Page 13 Thursday, June 7, 2001 2:55 PM List of Figures Page 1-1 1-2 1-3 1-4 1-5 1-6 1-7 1-8 1-9 1-10 1-11 1-12 3-1 9-1 Sensor Calibration Tables ......................................................... 1-31 Frequency Dependent Offset Tables......................................... 1-41 Averaged Readings .................................................................... 1-49 Averaging Range Hysteresis ..................................................... 1-49 Limits Checking Application.......
PAGE 24
prog.
PAGE 25
prog.book Page 15 Thursday, June 7, 2001 2:55 PM List of Tables Page 1-1 1-2 1-3 1-4 1-5 1-6 3-1 3-2 5-1 5-2 10-1 11-1 15-1 15-2 15-3 15-4 15-5 15-6 HP 437B Command Summary.................................................. 1-6 HP 438A Command Summary................................................. 1-9 MEASure? and CONFigure Preset States ............................... 1-14 Range of Values for Window Limits ......................................... 1-55 Bit Definitions - Status Byte Register ............
PAGE 26
prog.
PAGE 27
prog.
PAGE 28
prog.book Page 2 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Introduction Introduction This chapter describes the parameters which configure the power meter and help you determine settings to optimize performance. It contains the following sections: “Configuring the Remote Interface”, on page 1-3. “Zeroing and Calibrating the Power Meter”, on page 1-11. “Making Measurements”, on page 1-14. “Using Sensor Calibration Tables”, on page 1-30.
PAGE 29
prog.book Page 3 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Configuring the Remote Interface Configuring the Remote Interface This section describes how to configure the GP-IB, RS232 and RS422 remote interfaces. Interface Selection You can choose to control the power meter remotely using either the GP-IB, RS232 or RS422 standard interfaces. For information on selecting the remote interface manually from the front panel, refer to the Agilent Technologies E4418B/E4419B User’s Guides.
PAGE 30
prog.book Page 4 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Configuring the Remote Interface RS232/RS422 Configuration The RS232/RS422 serial port on the rear panel is a nine pin D-type connector configured as a DTE (Data Terminal Equipment). For pin-out information and cable length restrictions refer to the Agilent Technologies E4418A/E4419B User’s Guides.
PAGE 31
prog.book Page 5 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Configuring the Remote Interface To select the interface language from the remote interface use the: • SYSTem:LANGuage command. To query the interface language from the remote interface use the: • SYSTem:LANGuage? query. Table 1-1 details all the HP 437B commands that the Agilent E4418B supports and their function, and Table 1-2 details all the HP 438A commands that the Agilent E4419B supports and their function.
PAGE 32
prog.
PAGE 33
prog.
PAGE 34
prog.
PAGE 35
prog.
PAGE 36
prog.
PAGE 37
prog.book Page 11 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Zeroing and Calibrating the Power Meter Zeroing and Calibrating the Power Meter This section describes how to zero and calibrate the power meter. The calibration and zeroing commands are overlapped commands refer to “Using the Operation Complete Commands”, on page 1-89 to determine when the commands are complete.
PAGE 38
prog.book Page 12 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Zeroing and Calibrating the Power Meter automatically. Offset, relative and duty cycle settings are ignored during calibration. The command used to calibrate the power meter is: CALibration[1|2]:AUTO ONCE The command assumes that the power sensor is connected to a 1 mW reference signal.
PAGE 39
prog.book Page 13 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Zeroing and Calibrating the Power Meter Setting the Reference Calibration Factor All the Agilent 8480 series power sensors require you to set the reference calibration factor. The reference calibration factor can be set by: • entering the value into the power meter using the CALibrate[1|2]:RCFactor command. • selecting and enabling the sensor calibration table.
PAGE 40
prog.book Page 14 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Making Measurements The MEASure? and CONFigure commands provide the most straight-forward method to program the power meter for measurements. You can select the measurement’s expected power level, resolution and with the Agilent E4419B the measurement type (that is single channel, difference or ratio measurements) all in one command.
PAGE 41
prog.book Page 15 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Using MEASure? The simplest way to program the power meter for measurements is by using the MEASure? query. However, this command does not offer much flexibility. When you execute the command, the power meter selects the best settings for the requested configuration and immediately performs the measurement.
PAGE 42
prog.book Page 16 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 2 - Specifying the Source List Parameter The MEASure command has three optional parameters, an expected power value, a resolution and a source list. These parameters must be entered in the specified order. If parameters are omitted, they will default from the right. The parameter DEFault is used as a place holder.
PAGE 43
prog.book Page 17 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 4 - Specifying the Resolution Parameter The previous examples detailed the use of the expected value and source list parameters. The resolution parameter is used to set the resolution of the specified window. This parameter does not affect the resolution of the GP-IB data, however it does affect the auto averaging setting (refer to Figure 1-3 on page 1-49).
PAGE 44
prog.book Page 18 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 6 - Making a Ratio Measurement The following command can only be carried out on the Agilent E4419B. It queries the upper window to make a ratio measurement of channel A/B . The expected power and resolution parameters are defaulted, leaving them at their current settings.
PAGE 45
prog.
PAGE 46
prog.book Page 20 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Using the CONFigure Command When you execute this command, the power meter presets the best settings for the requested configuration (like the MEASure? query). However, the measurement is not automatically started and you can change measurement parameters before making measurements. This allows you to incrementally change the power meter’s configuration from the preset conditions.
PAGE 47
prog.book Page 21 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 1 - The Simplest Method The following program segments show the simplest method of querying the upper and lower window’s measurement results respectively.
PAGE 48
prog.book Page 22 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 2 - Specifying the Source List Parameter The CONFigure and READ? commands have three optional parameters, an expected power value, a resolution and a source list. These parameters must be entered in the specified order. If parameters are omitted, they will default from the right. The parameter DEFault is used as a place holder.
PAGE 49
prog.book Page 23 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 3 - Specifying the Expected Power Parameter The previous example details the three optional parameters which can be used with the CONFigure and READ? commands. The first optional parameter is used to enter an expected power value. Entering this parameter is only relevant if you are using an Agilent E-series power sensor.
PAGE 50
prog.book Page 24 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Using INITiate and FETCh? ABOR2 Aborts channel B CONF1 -50,DEF,(@2) Configures the upperwindow to make a channel B measurement using an expected power of -50 dBm and the current resolution setting. INIT2 Causes channel B to make a measurement. FETC1? Retrieves the upper window’s measurement.
PAGE 51
prog.book Page 25 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 4 - Specifying the Resolution Parameter The previous examples detailed the use of the expected value and source list parameters. The resolution parameter is used to set the resolution of the specified window. This parameter does not affect the resolution of the GP-IB data, however it does affect the auto averaging setting (refer to Figure 1-3 on page 1-49).
PAGE 52
prog.book Page 26 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements The following program segment assumes that channel A is currently being measured on the upper window. ABOR1 Aborts channel A. CONF1 DEF,3 Configures the upper window to make a measurement using the current setting of the expected power and source list and a resolution setting of 3. INIT1 Causes channel A to make a measurement. FETC1? Retrieves the upper window’s measurement.
PAGE 53
prog.book Page 27 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 5 - Making a Difference Measurement The following program segment can be carried out on the Agilent E4419B. It queries the lower window to make a difference measurement of channel A - channel B. The expected power level and resolution parameters are defaulted, leaving them at their current settings.
PAGE 54
prog.book Page 28 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Example 6 - Making a Ratio Measurement The following program segment can be carried out on the Agilent E4419B. It queries the lower window to make a ratio measurement of channel A/B. The expected power level and resolution parameters are defaulted, leaving them at their current settings. Some fine tuning of the measurement is carried out by setting the averaging.
PAGE 55
prog.book Page 29 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Making Measurements Using the Lower Level Commands An alternative method of making measurements is to use the lower level commands to set up the expected range and resolution.
PAGE 56
prog.book Page 30 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Using Sensor Calibration Tables This section applies to all Agilent 8480 series power sensors. It does not apply to the Agilent E-series power sensors. The Agilent E-series power sensors have their sensor calibration tables stored in EEPROM which allows frequency and calibration factor data to be downloaded by the power meter automatically.
PAGE 57
prog.book Page 31 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Figure 1-1 illustrates how sensor calibration tables operate. Figure 1-1: Sensor Calibration Tables TABLE 1 TABLE 20 TABLE N RCF RCF FREQ 1 CFAC 1 FREQ 1 FREQ 2 . . . . . . . . . . CFAC 2 . . . . . . . . . . FREQ 2 . . . . . . . . . . FREQ 80 CFAC 80 FREQ 80 RCF FREQ 1 CFAC 1 CFAC 2 . . . . . . . . . . FREQ 2 . . . . . . . . . . CFAC 2 . . . . . . . . . .
PAGE 58
prog.book Page 32 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables To use sensor calibration tables you: 1. Edit a sensor calibration table if necessary. 2. Select the sensor calibration table. 3. Enable the sensor calibration table. 4. Zero and calibrate the power meter. The reference calibration factor used during the calibration is automatically set by the power meter from the sensor calibration table. 5.
PAGE 59
prog.book Page 33 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Editing Sensor Calibration Tables It is not possible to create any additional sensor calibration tables. However, the 20 existing ones can be edited using the MEMory subsystem. To do this: 1. Select one of the existing tables using: MEMory:TABle:SELect . For information on naming sensor calibration tables see “Naming Sensor Calibration Tables”, on page 1-36.
PAGE 60
prog.book Page 34 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Note The legal frequency suffix multipliers are any of the IEEE suffix multipliers, for example, KHZ, MHZ and GHZ. If no units are specified the power meter assumes the data is Hz. PCT is the only legal unit for calibration factors and can be omitted. The frequency and calibration data must be within range. Refer to the individual commands in Chapter 4 for their specified ranges.
PAGE 61
prog.book Page 35 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Each string parameter returned indicates the name, type and size of a stored sensor calibration table: • ,, The , and are all character data. The is always TABL. The is displayed in bytes. For example, a sample of the response may look like: 560,8020,“Sensor_1,TABL,220”,”Sensor_2,TABL,340” ....
PAGE 62
prog.book Page 36 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Naming Sensor Calibration Tables To rename a sensor calibration table use: MEMory:TABLe:MOVE , The first parameter identifies the existing table name, and the second identifies the new table name. The following rules apply to sensor calibration table names: a) The sensor calibration table must consist of no more than 12 characters.
PAGE 63
prog.book Page 37 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Reviewing Table Data To review the data stored in a sensor calibration table, use the following commands: • MEMory:TABLe:SELect "Sense1" Select the sensor calibration table named “Sense1”. • MEMory:TABLe:SELect? Query command which returns the name of the currently selected table. • MEMory:TABLe:FREQuency:POINTs? Query command which returns the number of stored frequency points.
PAGE 64
prog.book Page 38 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Selecting a Sensor Calibration Table After you have created the sensor calibration table, you can select it using the following command: [SENSe[1]]|SENSe2:CORRection:CSET1[:SELect] When the table is selected, the power meter verifies the number of calibration factor points defined in the sensor calibration table is one parameter greater than the number of frequency points.
PAGE 65
prog.book Page 39 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Sensor Calibration Tables Making the Measurement To make the power measurement, set the power meter for the frequency of the signal you want to measure. The power meter automatically sets the calibration factor.
PAGE 66
prog.book Page 40 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables Using Frequency Dependent Offset Tables This section describes how to use frequency dependent offset tables. Frequency dependent offset tables give you the ability to compensate for frequency effects in your test setup. Overview If the [SENSe[1]]|SENSe2:CORRection:CSET2:STATe command is OFF, the frequency dependent offset tables are not used.
PAGE 67
prog.book Page 41 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables Figure 1-2 illustrates how frequency dependent offset tables operate. Figure 1-2: Frequency Dependent Offset Tables TABLE 1 TABLE N TABLE 10 FREQ 1 OFFSET 1 FREQ 1 OFFSET 1 FREQ OFFSET 1 1 FREQ 2 . . . . . . . . . . OFFSET 2 . . . . . . . . . . FREQ 2 . . . . . . . . . . OFFSET 2 . . . . . . . . . . FREQ 2 . . . . . . . . . . FREQ OFFSET 80 80 FREQ OFFSET 80 80 OFFSET 2 . .
PAGE 68
prog.book Page 42 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables Editing Frequency Dependent Offset Tables It is not possible to create any additional frequency dependent offset tables. However, the 10 existing ones can be edited using the MEMory subsystem. To do this: 1. Select one of the existing tables using: MEMory:TABle:SELect .
PAGE 69
prog.book Page 43 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables Note The legal frequency suffix multipliers are any of the IEEE suffix multipliers, for example, KHZ, MHZ and GHZ. If no units are specified the power meter assumes the data is Hz. PCT is the only legal unit for offset factors and can be omitted. The frequency and offset data must be within range. Refer to the individual commands in Chapter 4 for their specified ranges.
PAGE 70
prog.book Page 44 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables Each string parameter returned indicates the name, type and size of a stored frequency dependent offset table: • ,, The , and are all character data. The is always TABL. The is displayed in bytes. For example, a sample of the response may look like: 560,8020,“Offset_1,TABL,220”,”Offset_2,TABL,340” ....
PAGE 71
prog.book Page 45 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables • MEMory:TABLe:GAIN[:MAGNitude]:POINTs? Query command which returns the number of offset factor points stored in the frequency dependent offset table. • MEMory:TABLe:GAIN[:MAGNitude]? Query command which returns the offset factors stored in the frequency dependent offset table.
PAGE 72
prog.book Page 46 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Frequency Dependent Offset Tables Making the Measurement To make the power measurement, set the power meter for the frequency of the signal you want to measure. The power meter automatically sets the calibration factor.
PAGE 73
prog.book Page 47 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting the Range, Resolution and Averaging Setting the Range, Resolution and Averaging This section provides an overview of setting the range, resolution and averaging. For more detailed information about these features refer to the individual commands in Chapter 9. Range The power meter has no internal ranges which can be set. The only ranges that can be set are those of the Agilent E-series power sensors.
PAGE 74
prog.book Page 48 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting the Range, Resolution and Averaging Resolution You can set the window’s resolution using the following command: DISPlay[:WINDow[1|2]]:RESolution There are four levels of resolution available (1 through 4). When the measurement suffix is W or % this parameter represents the number of significant digits. When the measurement suffix is dB or dBM, 1 through 4 represents 1, 0.1, 0.01, and 0.
PAGE 75
prog.book Page 49 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting the Range, Resolution and Averaging Figure 1-3: Averaged Readings 1 Resolution Setting 2 3 4 10 dB 8 8 128 128 10 dB 1 1 16 256 10 dB 1 1 2 32 10 dB 1 1 1 16 1 1 1 8 Number of Averages Power Sensor Dynamic Range Minimum Sensor Power Maximum Sensor Power Figure 1-4 illustrates part of the power sensor dynamic range hysteresis.
PAGE 76
prog.book Page 50 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting the Range, Resolution and Averaging Filter Length You specify the filter length using the following command: [SENSe[1]]|SENSe2:AVERage:COUNt The range of values for the filter length is 1 to 1024. Specifying this command disables automatic filter length selection. Increasing the value of the filter length reduces measurement noise. However, the time to take the measurement is increased.
PAGE 77
prog.book Page 51 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Offsets Setting Offsets Channel Offsets The power meter can be configured to compensate for signal loss or gain in your test setup (for example, to compensate for the loss of a 10 dB attenuator). You use the SENSe command subsystem to configure the power meter. Gain and loss correction are a coupled system.
PAGE 78
prog.book Page 52 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Offsets Example The following example program, in HP Basic, details how to use the channel and display offsets on an Agilent E4419B making a channel A/B ratio measurement.
PAGE 79
prog.book Page 53 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Measurement Limits Setting Measurement Limits You can configure the power meter to detect when a measurement is outwith a predefined upper and/or lower limit value. There are two types of measurement limits you can set: Note • Channel Limits - are applied to the input channel and are for power measurements only.
PAGE 80
prog.book Page 54 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Measurement Limits Figure 1-6: Limits Checking Results Amplitude Fail o +10 dBm o o o o o +4 dBm o Fail Frequency In this application a swept frequency signal is applied to the input of the Device Under Test. The power meter measures the output power. The limits have been set at +4 dBm and +10 dBm. A fail occurs each time the output power is outside these limits.
PAGE 81
prog.book Page 55 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Measurement Limits 190 ENTER @Power;B 200 PRINT A,B 210 END Setting Window Limits The power meter can be configured to verify the current measurement in either window against predefined upper and/or lower limit values. The range of values that can be set for the upper and lower limits and the default values depends on the measurement units in the currently selected window - see Table 1-4.
PAGE 82
prog.book Page 56 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Measurement Limits CALCulate[1|2]:LIMit:FAIL? and the CALCulate[1|2]:LIMit:FCOunt? for window limits. 2. Use the STATus command subsystem. Using SENSe and CALCulate Using SENSe to check the channel limit failures in Figure 1-6 would return the following results: SENSe:LIMit:FAIL? Returns 1 if there has been 1 or more limit failures or 0 if there have been no limit failures. In this case 1 is returned.
PAGE 83
prog.book Page 57 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Setting Measurement Limits Example The following program segment shows how to use TTL output 1 to indicate when a measurement is outside the range -30 dBm to -10 dBm. It is assumed that the measurement has already been set up in the upper window (window 1). CALC1:LIM:LOW -30 Sets the lower limit for the upper window to -30 dBm. CALC1:LIM:UPP -10 Sets the upper limit for the upper window to -10 dBm.
PAGE 84
prog.book Page 58 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Measuring Pulsed Signals Measuring Pulsed Signals The power meter can be used to measure the power of a pulsed signal. The measurement result is a mathematical representation of the pulse power rather than an actual measurement. The power meter measures the average power of the pulsed input signal and then divides the measurement result by the duty cycle value to obtain the pulse power reading.
PAGE 85
prog.book Page 59 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Measuring Pulsed Signals 10 !Create I/O path name 20 ASSIGN @Power TO 713 30 !Clear the Power Meter’s Interface 40 CLEAR @Power 50 !Set the Power Meter to a known state 60 OUTPUT @Power;"*RST" 70 !Configure the Power Meter to make the measurement 80 OUTPUT @Power;"CONF:POW:AC 20DBM,2,(@1)" 90 !Set the reference calibration factor for the sensor 100 OUTPUT @Power;"CAL:RCF 98.
PAGE 86
prog.book Page 60 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Measuring Pulsed Signals Note Pulse power averages out any aberrations in the pulse such as overshooting or ringing. For this reason it is called pulse power and not peak power or peak pulse power. In order to ensure accurate pulse power readings, the input signal must be pulsed with a rectangular pulse. Other pulse shapes (such as triangle, chirp or Gaussian) will cause erroneous results.
PAGE 87
prog.book Page 61 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Triggering the Power Meter Triggering the Power Meter Triggering is a feature that is only available via remote programming of the power meter. The power meter has two modes of operation, standby mode and free run mode. During local operation the power meter is always in free run mode. During remote operation the power meter can operate in either free run mode or standby mode and can be switched between modes at any time.
PAGE 88
prog.book Page 62 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Triggering the Power Meter Triggering the power meter from the remote interface is a process that offers triggering flexibility. The process is: 1. Specify the source from which the power meter will accept the trigger. The trigger source specifies which event causes the trigger system to travel through the event detection state. See “Event Detection State”, on page 1-64 for details. 2.
PAGE 89
prog.
PAGE 90
prog.book Page 64 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Triggering the Power Meter Initiate State If the trigger system is on the downward path, it travels directly through the initiate state without any restrictions. If the trigger system is on the upward path, and INIT iate:CONTinuous is ON, it exits downwards to the event detection state. If the trigger system is on the upward path and INITiate:CONTinuous is OFF, it exits upwards to the idle state.
PAGE 91
prog.book Page 65 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Triggering the Power Meter Trigger Delay The power meter has the ability to insert a delay between receiving a trigger and making the measurement. The delay is automatically calculated by the power meter and depends on the current filter length. The delay ensures that the analog circuitry and the digital filters in the power meter have settled. It does not allow time for power sensor delay.
PAGE 92
prog.book Page 66 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Getting the Best Speed Performance Getting the Best Speed Performance This section discusses the factors that influence the speed of operation (number of readings/sec) of an Agilent E4418B/E4419B power meter. The following factors are those which have the greatest effect upon measurement speed (in no particular order): • The selected speed i.e. 20, 40 or 200 readings/sec.
PAGE 93
prog.book Page 67 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Getting the Best Speed Performance Free run A channel is in free run whenINITiate:CONTinuous is set to ON and TRIGger:SOURce is set to IMMediate.
PAGE 94
prog.book Page 68 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Getting the Best Speed Performance For example, with a filter length of 4 and SENS:SPE set to 20, approximately 5 readings/sec will be calculated by the power meter. In general, free run mode will provide the best speed performance from the power meter (especially in 200 readings/sec mode). Output Format The power meter has two output formats for measurement results: ASCii and REAL.
PAGE 95
prog.book Page 69 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Getting the Best Speed Performance • the hardware platform being used. • the programming environment being used. Note that it is unlikely that 200 readings/sec can be achieved when: • you are using a 700 series HPUX workstation. • you are using a low end PC. • you are using a graphical programming environment (such as HP VEE).
PAGE 96
prog.book Page 70 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation How Measurements are Calculated How Measurements are Calculated Figure 1-9 details how measurements are calculated. It shows the order in which the various power meter functions are implemented in the measurement calculation.
PAGE 97
prog.book Page 71 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Status Reporting Status reporting is used to monitor the power meter to determine when events have occurred. Status reporting is accomplished by configuring and reading status registers.
PAGE 98
prog.book Page 72 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting The General Status Register Model The generalized status register model shown in Figure 1-10 is the building block of the SCPI status system. This model consists of a condition register, a transition filter, an event register and an enable register. A set of these registers is called a status group.
PAGE 99
prog.book Page 73 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Enable Register The enable register specifies the bits in the event register that can generate a summary bit. The instrument logically ANDs corresponding bits in the event and enable registers and ORs all the resulting bits to obtain a summary bit. Enable registers are read-write. Querying an enable register does not affect it.
PAGE 100
prog.book Page 74 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting How to Use Registers There are two methods you can use to access the information in status groups: • the polling method, or • the service request (SRQ) method. Use the polling method when: • your language/development environment does not support SRQ interrupts. • you want to write a simple, single purpose program and do not want to add the complexity of setting an SRQ handler.
PAGE 101
prog.book Page 75 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting The Condition Polling Method In this polling method, the power meter has a passive role. It only informs the controller that conditions have changed when the controller asks. When you monitor a condition with the polling method, you must: 1. Determine which register contains the bit that monitors the condition. 2. Send the unique GP-IB query that reads that register. 3.
PAGE 102
prog.book Page 76 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting The SRQ Method When a bit of the Status Register is set and has been enabled to assert SRQ (*SRE command), the power meter sets the GP-IB SRQ line true. This interrupt can be used to interrupt your program to suspend its current operation and find out what service the power meter requires. (Refer to your computer and language manuals for information on how to program the computer to respond to the interrupt).
PAGE 103
prog.book Page 77 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 ! Configure the device status register so that a sensor ! connect or disconnect on channel A will cause an SRQ.
PAGE 104
prog.book Page 78 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 ! Set upper limit to 2dBm and configure the operation status ! so that an over limit condition will cause an SRQ.
PAGE 105
prog.book Page 79 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Status Register The Status System in the power meter is shown in Figure 1-12. The Operation Status and Questionable Status groups are 16 bits wide, while the Status Byte and Standard Event groups are 8 bits wide. In all 16-bit groups, the most significant bit (bit 15) is not used and is always set to 0.
PAGE 106
prog.book Page 80 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting The Status Byte The status byte summary register reports conditions from other status registers. Query data waiting in the power meter’s output buffer is immediately reported through the “message available” bit (bit 4). Clearing an event register clears the corresponding bits in the status byte summary register.
PAGE 107
prog.book Page 81 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Particular bits in the status byte register are cleared when: • The standard event, Questionable status, operation status and device status are queried. • The error/event queue becomes empty. • The output queue becomes empty. The status byte enable register (SRE, service request enable) is cleared when you: • cycle the instrument power. • execute a *SRE 0 command.
PAGE 108
prog.book Page 82 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Table 1-6: Bit Definitions - Standard Event Register Bit Number Decimal Value 0 1 Operation Complete All overlapped commands following an *OPC command have been completed. 1 2 Not Used. (Always set to 0.) 2 4 Query Error A query error occurred, refer to error numbers 410 to 440 in the User’s Guide. 3 8 Device Error A device error occurred, refer to error numbers 310 to 350 in the User’s Guide.
PAGE 109
prog.book Page 83 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Questionable Status Register The questionable status register provides information about the quality of the power meter’s measurement results. Any or all of these conditions can be reported in the questionable data summary bit through the enable register. You must write a value using the STATus:QUEStionable:ENABle command to set the enable register mask.
PAGE 110
prog.book Page 84 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting The condition bits are set and cleared under the following conditions: Bit Number Meaning EVENts Causing Bit Changes 3 POWer Summary This is a summary bit for the Questionable POWer Register.
PAGE 111
prog.book Page 85 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Operation Status The Operation Status group monitors conditions in the power meter’s measurement process. The Operation status model is shown in the pullout at the end of this chapter.
PAGE 112
prog.book Page 86 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Bit Number Meaning EVENts Causing Bit Changes 4 MEASuring This is a summary bit for the Operation MEASuring Register. SET: When the power meter is taking a measurement. CLEARED: When the measurement is finished. 5 Waiting for TRIGger This is a summary bit for the Operation TRIGger Register. SET: When the power meter enters the “wait for trigger” state. Refer to Figure 1-8.
PAGE 113
prog.book Page 87 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Device Status Register The device status register set contains bits which give device dependent information.
PAGE 114
prog.book Page 88 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting The condition bits are set and cleared under the following conditions: Bit Number 1 Meaning EVENts Causing Bit Changes Channel A sensor connected SET: When a power sensor is connected to the Channel A input. CLEARED: When no power sensor is connected to the Channel A input. 2 Channel B sensor connected SET: When a power sensor is connected to the Channel B input.
PAGE 115
prog.book Page 89 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Using the Operation Complete Commands The *OPC? and *OPC commands allow you to maintain synchronization between the computer and the power meter. The *OPC? query command places an ASCII character 1 into the power meter’s output queue when all pending power meter commands are complete.
PAGE 116
prog.book Page 90 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Status Reporting Examples This example program uses the *OPC? command to determine when the power meter has finished calibrating. CAL:AUTO ONCE *OPC? MEAS:POW:AC? This example program, in HP Basic, uses the *OPC command and serial poll to determine when the power meter has finished calibrating.
PAGE 117
prog.book Page 91 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Saving and Recalling Power Meter Configurations Saving and Recalling Power Meter Configurations To reduce repeated programming, up to ten power meter configurations can be stored in the power meter’s non-volatile memory. The error list, GP-IB address, programming language, sensor calibration table data, zeroing and calibration information are not stored.
PAGE 118
prog.book Page 92 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Using Device Clear to Halt Measurements Using Device Clear to Halt Measurements Device clear is an IEEE-488 low-level bus message which can be used to halt measurements in progress. Different programming languages and IEEE-488 interface cards provide access to this capability through their own unique commands.
PAGE 119
prog.book Page 93 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language An Introduction to the SCPI Language Standard Commands for Programmable Instruments (SCPI) defines how you communicate with an instrument from a bus controller. The SCPI language uses a hierarchical structure similar to the file systems used by many bus controllers.
PAGE 120
prog.book Page 94 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Using a Semicolon (;) Use a semicolon to separate two commands within the same command string. The semicolon does not change the present path specified. For example, the following two statements are equivalent. Note that in the first statement the first colon is optional but the third is compulsory.
PAGE 121
prog.book Page 95 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Syntax Conventions Throughout this guide, the following conventions are used for SCPI command syntax. • Square brackets ([]) indicate optional keywords or parameters. • Braces ({}) enclose one or more parameters that may be included zero or more times. • Triangle brackets (<>) indicate that you must substitute a value for the enclosed parameter.
PAGE 122
prog.book Page 96 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Definition Throughout this chapter is used to represent character data, that is, A - Z, a - z, 0 - 9 and _ (underscore). For example: START and R6_5F. The format is defined as: Definition Not a number (NAN) is represented as 9.91 E37. Not a number is defined in IEEE 754.
PAGE 123
prog.book Page 97 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Throughout this chapter is used to represent numeric information in bases other than ten (that is, hexadecimal, octal and binary). The following syntax diagram shows the standard for these three data structures. For example, #HA2F, #ha4e, #Q62, #q15, #B01011.
PAGE 124
prog.book Page 98 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Definition Throughout this chapter is used to denote a flexible numeric representation. For example: +200; -56; +9.9E36. Refer to section 7.7.2.1 of IEEE 488.2 for further details. Definition Throughout this chapter numeric response data is defined as: + digit For example: • 146 • +146 • -12345 Refer to section 8.7.2 of IEEE 488.2 for further details.
PAGE 125
prog.book Page 99 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Definition Throughout this chapter numeric response data is defined as: + digit digit + E digit For example: • 1.23E+6 • 123.4E-54 • -1234.567E+90. Refer to section 8.7.4 of IEEE 488.2 for further details. Definition Throughout this chapter the decimal numeric element is abbreviated to .
PAGE 126
prog.book Page 100 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Definition Throughout this chapter is used to represent 7-bit ASCII characters.
PAGE 127
prog.book Page 101 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation An Introduction to the SCPI Language Input Message Terminators Program messages sent to a SCPI instrument must terminate with a character. The IEEE.488 EOI (end or identify) signal is interpreted as a character and may also be used to terminate a message in place of the character. A followed by a is also accepted.
PAGE 128
prog.book Page 102 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Quick Reference Quick Reference Note This Guide details the commands available for both the Agilent E4418B and the Agilent E4419B power meters. As the Agilent E4418B is a single channel power meter only channel A can be selected. Where instances of channel selection are detailed in this chapter they are only relevant for the Agilent E4419B.
PAGE 129
prog.
PAGE 130
prog.
PAGE 131
prog.
PAGE 132
prog.
PAGE 133
prog.
PAGE 134
prog.book Page 108 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation Quick Reference STATus Subsystem As the status reporting commands are orthogonal, the same commands apply to all the registers.
PAGE 135
prog.
PAGE 136
prog.
PAGE 137
prog.book Page 111 Thursday, June 7, 2001 2:55 PM Power Meter Remote Operation SCPI Compliance Information SCPI Compliance Information The power meter complies with the rules and regulations of the present version of SCPI (Standard Commands for Programmable Instruments). You can determine the SCPI version with which the power meter’s is in compliance by sending the SYSTem:VERSion? command from the remote interface. The following commands are device-specific to the Agilent E4418B/E4419B.
PAGE 138
prog.
PAGE 139
prog.
PAGE 140
prog.book Page 2 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASurement Instructions MEASurement Instructions The purpose of the MEASure group of instructions is to acquire data using a set of high level instructions. The MEASure group of commands are structured to allow you to trade off interchangeability with fine control of the measurement process. MEASure? provides a complete capability where the power meter is configured, a measurement taken, and results returned in one operation.
PAGE 141
prog.book Page 3 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASurement Instructions The Optional Parameters All the MEASure commands have three optional parameters, an expected power value, a resolution and a source list. Entering an parameter is only relevant if you are using an Agilent E-series power sensor. With Agilent 8480 series power sensors entering a value has no effect on the power meter.
PAGE 142
prog.
PAGE 143
prog.
PAGE 144
prog.book Page 6 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2]? CONFigure[1|2]? This query returns the present configuration of the specified window. Syntax CONF 1 ? 2 The string returned depends on the setting of the CALCulate:MATH and CALCulate:RELative:STATe commands.
PAGE 145
prog.book Page 7 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2]? Example This command queries the current configuration of the lower window. CONF2? Reset Condition On reset, • the command function is set to :POWer:AC. • the expected power level is set to +20 dBm. • the resolution is set to 3. • the source list ■ on the Agilent E4418B is set to channel A on both windows. ■ on the Agilent E4419B is set to channel A on the upper window and channel B on the lower window.
PAGE 146
prog.book Page 8 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2] Commands CONFigure[1|2] Commands The CONFigure commands are used on the specified window to set, • the expected power level value of the measurement. • the resolution of the window. • the channel(s) on which the measurement is to be made. The CONFigure commands do not make the power measurement after setting the configuration. Use READ?, or alternatively use INITiate followed by a FETCh? to make the measurement.
PAGE 147
prog.book Page 9 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC] [[,[,]]] CONFigure[1|2][:SCALar][:POWer:AC] [[,[,]]] This command is used on the specified window, to set: • the expected power level value of the measurement. • the resolution of the window. • the channel on which the measurement is to be made.
PAGE 148
prog.book Page 10 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC] [[,[,]]] Parameters Refer to “The Optional Parameters”, on page 2-3 for additional details on the parameters in this command. Item Description/Default Range of Values expected_value (for the expected power level) A numeric value for the expected power level. The units of measurement are dBm and W. The default units are defined by UNIT:POWer.
PAGE 149
prog.book Page 11 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:RELative [[,[,]]] CONFigure[1|2][:SCALar][:POWer:AC]:RELative [[,[,]]] This command is used to set the measurement function, range and resolution of the specified window. It sets the measurement function to single channel with relative mode on.
PAGE 150
prog.book Page 12 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:RELative [[,[,]]] Item Description/Default Range of Values source list This is the channel on which the command is implemented. If unspecified the current window setup is used. However, on the Agilent E4419B, if the window shows a ratio or difference measurement, the upper window defaults to channel A and the lower window to channel B.
PAGE 151
prog.book Page 13 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:DIFFerence [[,[,]]] CONFigure[1|2][:SCALar][:POWer:AC]:DIFFerence [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command is used to set the measurement function and resolution of the specified window. It sets the measurement function to difference with relative mode off.
PAGE 152
prog.book Page 14 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:DIFFerence [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the difference is calculated. If unspecified and the current window setup is a difference measurement then this difference setup is used, otherwise it defaults to channel A-B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 153
prog.book Page 15 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative [[,[,]]] CONFigure[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command is used to set the measurement function, range and resolution of the specified window.
PAGE 154
prog.book Page 16 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the difference is calculated. If unspecified and the current window setup is a difference measurement then this difference setup is used, otherwise it defaults to channel A-B. (@1),(@2) (@2),(@1) 1.
PAGE 155
prog.book Page 17 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:RATio [[,[,]]] CONFigure[1|2][:SCALar][:POWer:AC]:RATio [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command is used to set the measurement function, range and resolution of the specified window. It sets the measurement function to ratio with relative mode off.
PAGE 156
prog.book Page 18 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:RATio [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the ratio is calculated. If unspecified and the current window setup is a ratio measurement then this ratio setup is used, otherwise it defaults to channel A/B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 157
prog.book Page 19 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:RATio:RELative [[,[,]]] CONFigure[1|2][:SCALar][:POWer:AC]:RATio:RELative [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command is used to set the measurement function, range and resolution of the specified window. It sets the measurement function to ratio with relative mode on.
PAGE 158
prog.book Page 20 Thursday, June 7, 2001 2:55 PM MEASurement Instructions CONFigure[1|2][:SCALar][:POWer:AC]:RATio:RELative [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the ratio is calculated. If unspecified and the current window setup is a ratio measurement then this ratio setup is used, otherwise it defaults to channel A/B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 159
prog.book Page 21 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2] Queries FETCh[1|2] Queries The FETCh? queries set the specified window’s measurement function to either single channel, difference or ratio measurements with relative mode either off or on. They then recalculate the measurement and place the result on the bus. The format of the return is , for example, -6.98970004E-001. The query returns a measurement result whenever it is valid.
PAGE 160
prog.book Page 22 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]? [[,[,]]] FETCh[1|2][:SCALar][:POWer:AC]? [[,[,]]] This command sets the specified window’s measurement function to single channel with relative mode off, recalculates the measurement and places the result on the bus. The result is a power based measurement and is expressed in the units defined by UNIT[1|2]:POWer.
PAGE 161
prog.book Page 23 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]? [[,[,]]] Item Description/Default Range of Values source list This is the channel on which the command is implemented. If unspecified the current window setup is used. However, on the Agilent E4419B, if the window shows a ratio or difference measurement, the upper window defaults to channel A and the lower window to channel B.
PAGE 162
prog.book Page 24 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] FETCh[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] This command sets the specified window’s measurement function to single channel with relative mode on, recalculates the measurement and places the results on the bus.
PAGE 163
prog.book Page 25 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs. 1 to 4 2 source list This is the channel on which the command is implemented.
PAGE 164
prog.book Page 26 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] Error Messages If the last measurement is not valid error -230, “Data corrupt or stale” occurs. A measurement is valid after it has been initiated. It becomes invalid when either a reset occurs or any measurement parameter, for example frequency, is changed.
PAGE 165
prog.book Page 27 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command sets the specified window’s measurement function to power difference with relative mode off, recalculates the measurement and places the results on the bus.
PAGE 166
prog.book Page 28 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the difference is calculated. If unspecified and the current window setup is a difference measurement then this difference setup is used, otherwise it defaults to channel A-B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 167
prog.book Page 29 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 168
prog.book Page 30 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the difference is calculated. If unspecified and the current window setup is a difference measurement then this difference setup is used, otherwise it defaults to channel A-B. (@1),(@2) (@2),(@1) 1.
PAGE 169
prog.book Page 31 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] FETCh[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command sets the specified window’s measurement function to power ratio with relative mode off, recalculates the measurement and places the results on the bus.
PAGE 170
prog.book Page 32 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the ratio is calculated. If unspecified and the current window setup is a ratio measurement then this ratio setup is used, otherwise it defaults to channel A/B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 171
prog.book Page 33 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] FETCh[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] This command is only relevant for the Agilent E4419B power meter. This command sets the specified window’s measurement function to power ratio with relative mode on, recalculates the measurement and places the results on the bus.
PAGE 172
prog.book Page 34 Thursday, June 7, 2001 2:55 PM MEASurement Instructions FETCh[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the ratio is calculated. If unspecified and the current window setup is a ratio measurement then this ratio setup is used, otherwise it defaults to channel A/B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 173
prog.book Page 35 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2] Commands READ[1|2] Commands The READ? commands are most commonly used with the CONFigure command to cause a new power measurement to be taken and the result returned to the output buffer. The format of the return is , for example, -6.98970004E-001.
PAGE 174
prog.book Page 36 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]? [[,[,]]] READ[1|2][:SCALar][:POWer:AC]? [[,[,]]] This command sets the specified window’s measurement function to single channel with relative mode off, aborts then initiates the specified channel, calculates the measurement result and places the result on the bus.
PAGE 175
prog.book Page 37 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs. 1 to 4 2 source list This is the channel on which the command is implemented.
PAGE 176
prog.book Page 38 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] READ[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] This command sets the specified window’s measurement function to single channel with relative mode on, aborts then initiates the specified channel, calculates the measurement result and places the result on the bus.
PAGE 177
prog.book Page 39 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs. 1 to 4 2 source list This is the channel on which the command is implemented.
PAGE 178
prog.book Page 40 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] Error Messages INITiate:CONTinuous must be set to OFF, otherwise error -213, “INIT ignored” occurs. If TRIGger:SOURce is set to BUS or HOLD, error -214, “Trigger deadlock” occurs.
PAGE 179
prog.book Page 41 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] READ[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 180
prog.book Page 42 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs.
PAGE 181
prog.book Page 43 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] READ[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 182
prog.book Page 44 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs.
PAGE 183
prog.book Page 45 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] READ[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 184
prog.book Page 46 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs.
PAGE 185
prog.book Page 47 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] READ[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 186
prog.book Page 48 Thursday, June 7, 2001 2:55 PM MEASurement Instructions READ[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] Item Description/Default Range of Values resolution A numeric value for the resolution. If it is unspecified the current resolution setting is used. If a value is entered it should correspond to the current resolution setting otherwise an error occurs.
PAGE 187
prog.book Page 49 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2] Commands MEASure[1|2] Commands The MEASure? commands configure the power meter to perform a power measurement with the given measurement function, relative mode setting, range and resolution then makes the measurement. The format of the return is , for example, -6.98970004E-001.
PAGE 188
prog.book Page 50 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]? [[,[,]]] MEASure[1|2][:SCALar][:POWer:AC]? [[,[,]]] This command sets the specified window’s measurement function to single channel with relative mode off, aborts, configures the window then initiates channel A or B, calculates the measurement result and places the result on the bus.
PAGE 189
prog.book Page 51 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]? [[,[,]]] Item Description/Default Range of Values source list This is the channel on which the command is implemented. If unspecified the current window setup is used. However, on the Agilent E4419B, if the window shows a ratio or difference measurement, the upper window defaults to channel A and the lower window to channel B.
PAGE 190
prog.book Page 52 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] MEASure[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] This command sets the specified window’s measurement function to single channel with relative mode on, aborts, configures then initiates the specified channel, calculates the measurement result and places the result on the bus.
PAGE 191
prog.book Page 53 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:RELative? [[,[,]]] Item Description/Default Range of Values source list This is the channel on which the command is implemented. If unspecified the current window setup is used. However, on the Agilent E4419B, if the window shows a ratio or difference measurement, the upper window defaults to channel A and the lower window to channel B.
PAGE 192
prog.book Page 54 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] MEASure[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 193
prog.book Page 55 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:DIFFerence? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the difference is calculated. If unspecified and the current window setup is a difference measurement then this difference setup is used, otherwise it defaults to channel A-B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 194
prog.book Page 56 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] MEASure[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 195
prog.book Page 57 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:DIFFerence:RELative? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the difference is calculated. If unspecified and the current window setup is a difference measurement then this difference setup is used, otherwise it defaults to channel A-B. (@1),(@2) (@2),(@1) 1.
PAGE 196
prog.book Page 58 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] MEASure[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 197
prog.book Page 59 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:RATio? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the ratio is calculated. If unspecified and the current window setup is a ratio measurement then this ratio setup is used, otherwise it defaults to channel A/B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 198
prog.book Page 60 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] MEASure[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] This command is only relevant for the Agilent E4419B power meter.
PAGE 199
prog.book Page 61 Thursday, June 7, 2001 2:55 PM MEASurement Instructions MEASure[1|2][:SCALar][:POWer:AC]:RATio:RELative? [[,[,]]] Item Description/Default Range of Values source list This channel list specifies between which channels the ratio is calculated. If unspecified and the current window setup is a ratio measurement then this ratio setup is used, otherwise it defaults to channel A/B. (@1),(@2) (@2),(@1) 1. The mnemonic DEF means DEFault.
PAGE 200
prog.
PAGE 201
prog.
PAGE 202
prog.book Page 2 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate Subsystem CALCulate Subsystem The CALCulate subsystem exists to perform post acquisition data processing. Functions in the SENSe subsystem are related to data acquisition, while the CALCulate subsystem operates on the data acquired by a SENSe function.
PAGE 203
prog.
PAGE 204
prog.book Page 4 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem The CALCulate[1|2]:GAIN Node The CALCulate[1|2]:GAIN Node This node is used to enter and enable a display offset on the specified window. The display offset is applied to the measurement signal after any math calculation.
PAGE 205
prog.book Page 5 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:GAIN[:MAGNitude] CALCulate[1|2]:GAIN[:MAGNitude] This command is used to enter a value for the display offset on the specified window. The display offset is applied to the measurement signal after any math calculation. Entering a value using this command automatically turns the CALCulate[1|2]:GAIN:STATe command to ON.
PAGE 206
prog.book Page 6 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:GAIN[:MAGNitude] Query CALCulate[1|2]:GAIN[:MAGNitude]? [MIN|MAX] The query returns the current setting of the display offset or the value associated with MIN and MAX. Query Example CALC1:GAIN? This command queries the current setting of the display offset on the upper window.
PAGE 207
prog.book Page 7 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:GAIN:STATe CALCulate[1|2]:GAIN:STATe This command is used on the specified window to enable and disable the display offset set by the CALCulate[1|2]:GAIN[:MAGNitude] command. Syntax CALC 1 :GAIN Space :STAT 2 0|OFF 1|ON ? Example CALC2:GAIN:STAT 1 This command enables the display offset set for the lower window. Reset Condition On reset, the gain is disabled.
PAGE 208
prog.book Page 8 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit Node CALCulate[1|2]:LIMit Node This node allows you to set the limits, on both the upper and lower windows, which determine when a TTL logic level will be output on the rear panel TTL Input/Output connector (pins 3 upper window and pin 4 lower window).
PAGE 209
prog.book Page 9 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:CLEar:AUTO |ONCE CALCulate[1|2]:LIMit:CLEar:AUTO |ONCE This command is used to control when the FCO (fail counter) is cleared of any limit failures. The FCO is used to determine the results returned by the CALCulate[1|2]:LIMit:FAIL? query. If ON is specified, the FCO is set to 0 each time a measurement: • is initiated using INITiate[:IMMediate]. • is initiated using INITiate:CONTinuous ON.
PAGE 210
prog.book Page 10 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:CLEar:AUTO |ONCE Query CALCulate[1|2]:LIMit:CLEar:AUTO? The query command enters a 1 or 0 into the output buffer indicating whether limit failures are cleared automatically when a new measurement is initiated on the specified window. • 1 is entered into the output buffer when limit failures are cleared automatically when a new measurement is initiated.
PAGE 211
prog.book Page 11 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:Limit:CLEar[:IMMediate] CALCulate[1|2]:Limit:CLEar[:IMMediate] This command is used to immediately clear the FCO (fail counter) of any limit failures for the specified window. The FCO is used to determine the results returned by the CALCulate[1|2]:LIMit:FAIL? query Syntax CALC 1 :LIM :CLE :IMM 2 Example CALC2:LIM:CLE:IMM This command clears the FCO for the lower window.
PAGE 212
prog.book Page 12 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]LIMit:FAIL? CALCulate[1|2]LIMit:FAIL? This query enters a 1 or 0 into the output buffer indicating whether there have been any limit failures for the specified window. A limit failure is defined as CALC[1|2]:LIMit:FCO? being non-zero. The FCO (fail counter) can be zeroed using the CALC[1|2]:LIMit:CLEar command. • 1 is returned when one or more limit failures have occurred.
PAGE 213
prog.book Page 13 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:FCOunt? CALCulate[1|2]:LIMit:FCOunt? This query is used to return the total number of limit failures for the specified window. If the appropriate STATe commands are set to ON, each time a measurement is initiated on the specified window and the measurement result is outside the limits, the counter is incremented by one. If the measured value is equal to a limit, this is a limit pass.
PAGE 214
prog.book Page 14 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:FCOunt? Syntax CALC 1 :LIM :FCO ? 2 Example CALC1:LIM:FCO? This command queries the number of limit failures on the upper window.
PAGE 215
prog.book Page 15 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:LOWer[:DATA] CALCulate[1|2]:LIMit:LOWer[:DATA] This command is used to enter a value for the lower test limit for the specified window used in the CALCulate[1|2]:LIMit:FAIL? test. The units used are dependent on the current setting of UNIT:POWer and CALCulate:RELative:STATe as shown in Table 3-1.
PAGE 216
prog.book Page 16 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:LOWer[:DATA] Parameters Item Description/Default Range of Values numeric_value A numeric value. The default value, DEF, is -90.00 dBm or -90 db. The value for MIN is -150 dBm or -180 dB. The value for MAX is +230 dBm or +200 dB. -150 to +230 dBm or -180 to +200 dB DEF MIN MAX Example CALC2:LIM:LOW:DATA 0.
PAGE 217
prog.book Page 17 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:STATe CALCulate[1|2]:LIMit:STATe This command is used to enable and disable the test limits for the specified window. Syntax CALC 1 :LIM :STAT Space 2 0|OFF 1|ON ? Example CALC2:LIM:STAT 1 This command enables the limit checking function for the lower window. Reset Condition On reset, limit checking is disabled.
PAGE 218
prog.book Page 18 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:STATe Error Message If CALCulate[1|2}:LIMit:STATe is set to ON while [SENSe[1]]|SENSe2:SPEed is set to 200, the error -221, “Settings Conflict” occurs.
PAGE 219
prog.book Page 19 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:UPPer[:DATA] CALCulate[1|2]:LIMit:UPPer[:DATA] This command is used to enter a value for the upper test limit for the specified window used in the CALCulate[1|2]:LIMit:FAIL? test. The units used are dependent on the current setting of UNIT:POWer and CALCulate:RELative:STATe as shown in Table 3-2.
PAGE 220
prog.book Page 20 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:LIMit:UPPer[:DATA] Parameters Item Description/Default Range of Values numeric_value A numeric value. The default value, DEF, is +90.00 dBm or +90 dB. The value for MIN is -150 dBm or -180 db. The value for MAX is +230 dBm or +200 dB.
PAGE 221
prog.book Page 21 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem The CALCulate[1|2]:MATH Node The CALCulate[1|2]:MATH Node This node is a generic SCPI calculate sub-block which can be specified to define and carry out mathematical transformation on SENSe data. In the power meter a windows math block is used to set whether the window is measuring in single channel, difference or ratio modes.
PAGE 222
prog.book Page 22 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:MATH[:EXPRession] CALCulate[1|2]:MATH[:EXPRession] This command is used to set the specified window to a single channel, difference or ratio measurement. Syntax CALC 1 :MATH :EXPR Space string 2 ? Item Description/Default Range of Values string A single string value detailing the measurement type. For the Agilent E4418B the default is SENS1.
PAGE 223
prog.book Page 23 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:MATH[:EXPRession] Query CALCulate[1|2]:MATH[:EXPRession]? The query returns the current math measurement setting on the specified window. Query Example CALC1:MATH? This command queries the current setting of the math expression on the upper window.
PAGE 224
prog.book Page 24 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:MATH[:EXPRession]:CATalog? CALCulate[1|2]:MATH[:EXPRession]:CATalog? This query lists all the defined expressions. The response is a list of comma separated strings. Each string contains an expression.
PAGE 225
prog.book Page 25 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem The CALCulate[1|2]:RELative Node The CALCulate[1|2]:RELative Node This node contains commands which allow you to compare the measurement signal to a reference value. Within the CALCulate block the relative value is applied to the measurement signal after any math calculations and display offsets have been applied.
PAGE 226
prog.book Page 26 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:RELative[:MAGNitude]:AUTO |ONCE CALCulate[1|2]:RELative[:MAGNitude]:AUTO |ONCE This command is used to set the reference value to be used in the relative measurement. Within the CALCulate block the relative value is applied to the measurement signal after any math calculations and display offsets have been applied.
PAGE 227
prog.book Page 27 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:RELative[:MAGNitude]:AUTO |ONCE Query CALCulate[1|2]:RELative[:MAGNitude]:AUTO? The query always returns OFF. Error Message If CALCulate:RELative[:MAGNitude]:AUTO is set to ONCE while SENSe:SPEed is set to 200, the error -221, “Settings Conflict” occurs. If this command is set to ON the error -224, “Illegal parameter value” occurs.
PAGE 228
prog.book Page 28 Thursday, June 7, 2001 2:55 PM CALCulate Subsystem CALCulate[1|2]:RELative:STATe CALCulate[1|2]:RELative:STATe This command is used to enable and disable relative mode. If the command is: • disabled, the measurement signal remains unchanged. • enabled, the current relative value set by CALCulate:RELative:MAGnitude:AUTO is applied to the measurement signal.
PAGE 229
prog.
PAGE 230
prog.book Page 2 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration Subsystem CALibration Subsystem The CALibration command subsystem is used to zero and calibrate the power meter. It is also used to set the reference calibration factor for the power sensor which is being used. The numeric suffix of the CALibration program mnemonic in the CALibration commands refers to a channel, that is CALibration1 and CALibration2 represent channel A and channel B respectively.
PAGE 231
prog.book Page 3 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2][:ALL] CALibration[1|2][:ALL] Note This command is identical to CALibration[1|2][:ALL]?, however, unlike the query it does not provide a response to indicate whether the calibration has been successful or not. This command causes the power meter to perform a calibration sequence on the specified channel. The command assumes that the power sensor is connected to the POWER REF output.
PAGE 232
prog.book Page 4 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2][:ALL] Error Message If the calibration was not carried out successfully the error -231, “Data Questionable; CAL ERROR” occurs. If you are using the Agilent E4419B the error message specifies on which channel the calibration failed. If zeroing was not carried out successfully the error -231, “Data Questionable; ZERO ERROR” occurs.
PAGE 233
prog.book Page 5 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2][:ALL]? CALibration[1|2][:ALL]? Note This query is identical to CALibration[1|2][:ALL], however, unlike the command, this query provides a response to indicate whether the calibration has been successful or not. This query causes the power meter to perform a calibration sequence on the specified channel. The query assumes that the power sensor is connected to the POWER REF output.
PAGE 234
prog.book Page 6 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2][:ALL]? Query Example CAL1:ALL? This command causes the power meter to perform a calibration sequence on channel A and return a result. Error Message If the calibration was not carried out successfully the error -231, “Data Questionable; CAL ERROR” occurs. If you are using the Agilent E4419B the error message specifies on which channel the calibration failed.
PAGE 235
prog.book Page 7 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:AUTO |ONCE CALibration[1|2]:AUTO |ONCE This command is used to calibrate the specified channel when ONCE is selected. The command assumes that the power sensor is connected to a 1 mW reference signal. The 0|OFF parameter is only required for the query response and is ignored in the command. If 1|ON is selected, it causes the error -224, “Illegal parameter value” to occur.
PAGE 236
prog.book Page 8 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:AUTO |ONCE Query CALibration[1|2]:AUTO? The query always returns a value of 0. Error Message If the calibration was not carried out successfully the error -231, “Data Questionable; CAL ERROR” occurs. If you are using the Agilent E4419B the error message specifies on which channel the calibration failed. If this command is set to ON the error -224, “Illegal parameter value” occurs.
PAGE 237
prog.book Page 9 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:ECONtrol:STATe CALibration[1|2]:ECONtrol:STATe This command is used to enable and disable the rear panel TTL zero/cal inputs. The TTL inputs provide an external means to initiate ZERO and CAL cycles. Syntax CAL 1 :ECON :STAT Space 2 0|OFF 1|ON ? Example CAL1:ECON:STAT 1 This command enables the rear panel TTL inputs.
PAGE 238
prog.book Page 10 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:RCALibration CALibration[1|2]:RCALibration This command enables and disables the zero/cal lockout facility. With the lockout facility enabled the power meter is prevented from making measurements until the sensor connected has been zeroed and calibrated. Syntax CAL 1 :RCAL Space 2 0|OFF 1|ON ? Example CAL1:RCAL 1 This command enables the zero /cal lockout facility on channel A.
PAGE 239
prog.book Page 11 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:RCALibration Error Message When CAL[1|2]:RCAL is ON and the sensor currently connected to the appropriate channel (A or B) has not been zeroed and calibrated, then any SCPI command which would normally return a measurement result (for example, FETC?, READ?, MEAS? etc) will not return a result but will generate the error -230, “Data corrupt or stale; Please zero and Cal.
PAGE 240
prog.book Page 12 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:RCFactor CALibration[1|2]:RCFactor This command is used with Agilent 8480 series power sensors to set the reference calibration factor of the specified channel. Reference calibration factors can also be set using sensor calibration tables. The power meter uses the most recently set reference calibration factor.
PAGE 241
prog.book Page 13 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:RCFactor Query CALibration[1|2]:RCFactor? [MIN|MAX] The query returns the current setting of the reference calibration factor or the values associated with MIN and MAX. Query Example CAL2:RCF? This command queries the reference calibration factor of channel B. Error Message If this command is used when an Agilent E-series power sensor is connected the error -241, “Hardware missing” occurs.
PAGE 242
prog.book Page 14 Thursday, June 7, 2001 2:55 PM CALibration Subsystem CALibration[1|2]:ZERO:AUTO |ONCE CALibration[1|2]:ZERO:AUTO |ONCE This command causes the power meter to perform its zeroing routine on the specified channel when ONCE is selected. Zeroing takes approximately 10 seconds. This adjusts the power meter for a zero power reading with no power supplied to the power sensor. The 0|OFF parameter is only required for the query response and is ignored in the command.
PAGE 243
prog.
PAGE 244
prog.book Page 2 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay Subsystem DISPlay Subsystem The DISPlay subsystem is used to control the selection and presentation of the windows used on the power meter’s display.
PAGE 245
prog.book Page 3 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay:CONTrast DISPlay:CONTrast This command is used to control the display contrast. A contrast of: • 0, represents a minimum contrast. • 1, represents a maximum contrast. When the supply power is cycled off then on the contrast sets to the factory default for that particular power meter.
PAGE 246
prog.book Page 4 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay:CONTrast Query DISPlay:CONTrast? [MIN|MAX] The query returns the current setting of the contrast or the values associated with MIN and MAX. The response format is . Query Example DISP:CONT? 5-4 This command queries the current contrast setting.
PAGE 247
prog.book Page 5 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay:ENABle DISPlay:ENABle This command is used to enable and disable the display. At power-up the display is always enabled. Syntax DISP :ENAB Space 0|OFF 1|ON ? Example DISP:ENAB 0 This command disables the display. Reset Condition On reset, the display is enabled. Query DISPlay:ENABle? The query returns a 1 or 0 into the output buffer. • 1 is returned when the display is enabled.
PAGE 248
prog.book Page 6 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]] Node DISPlay[:WINDow[1|2]] Node This node is used to control various characteristics of the display windows. The numeric suffix of the WINDow program mnemonic in the DISPlay commands refers to a window, that is WINDow1 and WINDow2 represent the upper and lower windows respectively.
PAGE 249
prog.book Page 7 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:FORMat DISPlay[:WINDow[1|2]]:FORMat This command is used to select the format, either analog or digital, of the selected window. Syntax DISP :WIND 1 :FORM Space character_data 2 DEF ? Parameters Item Description/Default Range of Values character_data Character data for the window format.
PAGE 250
prog.book Page 8 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:FORMat Query Example DISP:FORM? 5-8 This command queries the current format of the upper window.
PAGE 251
prog.book Page 9 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:METer Node DISPlay[:WINDow[1|2]]:METer Node This command node is used to control the upper and lower scale limits of the analog meter.
PAGE 252
prog.book Page 10 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:METer:LOWer DISPlay[:WINDow[1|2]]:METer:LOWer This command is used to set the analog meter lower scale limit. The units used are dependent on the current setting of UNIT:POWer and CALCulate:RELative:STATe as shown in Table 5-1.
PAGE 253
prog.book Page 11 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:METer:LOWer Example DISP:WIND2:MET:LOW 10 This command sets the lower window’s analog meter lower scale limit. Reset Condition On reset, the lower scale limit is set to -70 dBm (DEF). Query DISPlay[:WINDow[1|2]]:METer:LOWer? [MIN|MAX] The query returns the current setting of the analog meter’s lower scale limit or the value associated with MIN and MAX. The format of the response is .
PAGE 254
prog.book Page 12 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:METer:UPPer DISPlay[:WINDow[1|2]]:METer:UPPer This command is used to set the analog meter upper scale limit. The units used are dependent on the current setting of UNIT:POWer and CALCulate:RELative:STATe as shown in Table 5-1.
PAGE 255
prog.book Page 13 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:METer:UPPer Example DISP:WIND2:MET:UPP 20 This command sets the lower window’s analog meter upper scale limit. Reset Condition On reset, the upper scale limit is set to 20 dBm (DEF). Query DISPlay[:WINDow[1|2]]:METer:UPPer? [MIN|MAX] The query returns the current setting of the analog meter’s upper scale limit or the value associated with MIN and MAX. The format of the response is .
PAGE 256
prog.book Page 14 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:RESolution DISPlay[:WINDow[1|2]]:RESolution This command is used to set the resolution of the measurement result in the selected window. When the measurement result is linear this parameter represents the number of significant digits. When the measurement result is logarithmic 1 through 4 represents a resolution of 1, 0.1, 0.01, and 0.001 respectively.
PAGE 257
prog.book Page 15 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:RESolution Example DISP:WIND2:RES 4 This command sets the lower window’s resolution to 4 significant digits if the measurement result is linear or 0.001 if the measurement result is logarithmic. Reset Condition On reset, the resolution is set to 3 (DEF).
PAGE 258
prog.book Page 16 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]]:SELect DISPlay[:WINDow[1|2]]:SELect This command is used to determine which window is currently selected. Syntax DISP :WIND 1 :SEL ? 2 Example This command selects the lower window. DISP:WIND2:SEL Reset Condition On reset, the upper window is selected. Query DISPlay[:WINDow[1|2]]:SELect? The query enters a 1 or 0 into the output buffer indicating whether the window specified is currently selected.
PAGE 259
prog.book Page 17 Thursday, June 7, 2001 2:55 PM DISPlay Subsystem DISPlay[:WINDow[1|2]][:STATe] DISPlay[:WINDow[1|2]][:STATe] This command is used to enable and disable the selected window, therefore allowing you to toggle between single and dual measurement window’s on the display. Only one window can be disabled at any one time. If you disable the only remaining window then the other window is automatically enabled and becomes the currently active window.
PAGE 260
prog.
PAGE 261
prog.
PAGE 262
prog.book Page 2 Thursday, June 7, 2001 2:55 PM FORMat Subsystem FORMat Subsystem FORMat Subsystem The FORMat subsystem sets a data format for transferring numeric information. This data format is used only for response data by those commands that are specifically designated to be affected by the FORMat subsystem. For the Agilent E4419B the same FORMat is used on both channels.
PAGE 263
prog.book Page 3 Thursday, June 7, 2001 2:55 PM FORMat Subsystem FORMat[:READings]:BORDer NORMal|SWAPped FORMat[:READings]:BORDer NORMal|SWAPped This command is used to control whether the binary data is transferred in normal or swapped Byte ORDer. It is only used when FORMat[:READings][:DATA] is set to REAL. Syntax FORM :READ Space :BORD NORM SWAP ? Example FORM:BORD SWAP This command sets the byte order to swapped. Reset Condition On reset, this value is set to NORMal.
PAGE 264
prog.book Page 4 Thursday, June 7, 2001 2:55 PM FORMat Subsystem FORMat[:READings][:DATA] FORMat[:READings][:DATA] This command is used to set the data format to either ASCii or REAL. Syntax FORM :READ Space :DATA Type ? Parameters Item Description/Default Range of Values Type Character data (not string). ASCii REAL Example This command sets the format to real. FORM REAL Reset Condition On reset, the format is set to ASCii.
PAGE 265
prog.
PAGE 266
prog.book Page 2 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory Subsystem MEMory Subsystem The MEMory command subsystem is used to edit and review sensor calibration tables, frequency dependent offset tables and save/recall registersj. This facility can be used to store sensor calibration tables for the Agilent 8480 series power sensors, and frequency dependent offset tables which compensate for your test setup. The tables remain stored in the power meter’s memory during power down.
PAGE 267
prog.book Page 3 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CATalog Node MEMory:CATalog Node This node is used to query information on the current contents of the power meter’s sensor calibration tables, frequency dependent offset tables and save/recall registers.
PAGE 268
prog.book Page 4 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CATalog[:ALL]? MEMory:CATalog[:ALL]? This command is used to list the stored sensor calibration tables, frequency dependent offset tables and save/recall registers. The power meter returns the data in the form of two numeric parameters and as many strings as there are stored tables and save/recall registers.
PAGE 269
prog.book Page 5 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CATalog[:ALL]? The power meter is shipped with a set of predefined sensor calibration tables. The data in these sensor calibration tables is based on statistical averages for a range of Agilent Technologies power sensors. These tables can be altered. The predefined data is listed in your User’s Guide.
PAGE 270
prog.book Page 6 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CATalog:STATe? MEMory:CATalog:STATe? This command is used to list the save/recall registers. The power meter returns the data in the form of two numeric parameters and as many strings as there are save/recall registers. ,{,} • The first numeric parameter indicates the amount of memory, in bytes, used for the storage of registers.
PAGE 271
prog.book Page 7 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CATalog:TABLe? MEMory:CATalog:TABLe? This command is used to list the stored sensor calibration and frequency dependent offset tables. The power meter returns the data in the form of two numeric parameters and as many strings as there are stored tables. ,{,} • The first numeric parameter indicates the amount of memory, in bytes, used for the storage of tables.
PAGE 272
prog.book Page 8 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CATalog:TABLe? The power meter is shipped with a set of predefined sensor calibration tables. The data in these sensor calibration tables is based on statistical averages for a range of Hewlett-Packard power sensors. These tables can be altered. The predefined data is listed in your User’s Guide.
PAGE 273
prog.book Page 9 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CLEar Node MEMory:CLEar Node This node is used to remove the contents stored in the sensor calibration tables, frequency dependent offset tables and save/recall registers. This subsystem removes the data contents but does not affect the name of the associated table or save/recall register.
PAGE 274
prog.book Page 10 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CLEar[:NAME] MEMory:CLEar[:NAME] This command is used to clear the contents of a given sensor calibration table, frequency dependent offset table, or save/recall register. Although the table remains, a MEMory:TABLe:FREQuency|GAIN:POINts? query returns a 0 as there are no contents in the table.
PAGE 275
prog.book Page 11 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:CLEar:TABLe MEMory:CLEar:TABLe This command is used to clear the contents of the table currently selected using MEMory:TABLe:SELect. Although the table remains, a MEMory:TABLe:FREQuency|GAIN:POINts? query returns a 0 as there are no contents in the table. This command is an alternative form of the MEMory:CLEar[:NAME] command, the only difference being the method in which the table is selected.
PAGE 276
prog.book Page 12 Thursday, June 7, 2001 2:55 PM MEMory Subsystem The MEMory:FREE Node The MEMory:FREE Node This node is used to return information on the amount of free memory space available for sensor calibration tables, frequency dependent offset tables, and save/recall registers.
PAGE 277
prog.book Page 13 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:FREE[:ALL]? MEMory:FREE[:ALL]? This query returns the amount of memory free for sensor calibration tables, frequency dependent offset tables, and save/recall registers. The format of the response is: , Syntax MEM :FREE :ALL ? Example MEM:FREE? This command queries the amount of free memory in total.
PAGE 278
prog.book Page 14 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:FREE:STATe? MEMory:FREE:STATe? This query returns the amount of memory free for save/recall registers. The format of the response is: , Syntax MEM :FREE :STAT ? Example MEM:FREE:STAT? 7-14 This command queries the amount of free memory for save/recall registers.
PAGE 279
prog.book Page 15 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:FREE:TABLe? MEMory:FREE:TABLe? This query returns the amount of memory free for sensor calibration tables and frequency dependent offset tables. The format of the response is: , Syntax MEM :FREE :TABL ? Example MEM:FREE:TABL? This command queries the amount of free memory for tables.
PAGE 280
prog.book Page 16 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:NSTates? MEMory:NSTates? This query returns the number of registers that are available for save/recall. As there are ten registers this query always returns ten. Syntax MEM :NST ? Example MEM:NST? 7-16 This command queries the number of registers available for save/recall.
PAGE 281
prog.book Page 17 Thursday, June 7, 2001 2:55 PM MEMory Subsystem The MEMory:STATe Node The MEMory:STATe Node This node is used to query and define register names.
PAGE 282
prog.book Page 18 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:STATe:CATalog? MEMory:STATe:CATalog? This query returns a list of the save/recall register names in ascending order of register number. The format of the response is: ,,....., Syntax MEM :STAT :CAT ? Example MEM:STAT:CAT? 7-18 This command queries the register names.
PAGE 283
prog.book Page 19 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:STATe:DEFine , MEMory:STATe:DEFine , This command is used to associate a name with a save/recall register number. Syntax MEM :STAT :DEF Space , string ? Space numeric_value string Parameters Item Description/Default Range of Values string A string detailing the register name. A maximum of 12 characters can be used.
PAGE 284
prog.book Page 20 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:STATe:DEFine , Error Messages If the register number is out of range, error -222, “Data out of range” occurs. If the name is invalid, error -224, “Illegal parameter value” occurs. If a register or sensor calibration table with the same name already exists, error -257, “File name error” occurs (command only).
PAGE 285
prog.book Page 21 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe Node MEMory:TABLe Node This node is used to define a sensor calibration table, or a frequency dependent offset table, and to write to and read data from it.
PAGE 286
prog.book Page 22 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:FREQuency {,} MEMory:TABLe:FREQuency {,} This command is used to enter frequency data into the current selected table. Any previous frequency list is cleared before the new frequencies are stored. The frequencies must be entered in ascending order. Entries in the frequency lists correspond as shown with entries in the calibration/offset factor lists.
PAGE 287
prog.book Page 23 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:FREQuency {,} Parameters Item Description/Default Range of Values numeric_value A numeric value for the frequency. The default units are Hz. 1 kHz to 999.9 GHz1, 2 1. The following measurement units can be used: • Hz • kHz (103) • MHz (106) • GHz (109) 2. All frequencies are truncated to a multiple of 1 kHz.
PAGE 288
prog.book Page 24 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:FREQuency {,} Error Messages If more than 80 frequencies are in the list, error -108, “Parameter not allowed” occurs. If the frequencies are not entered in ascending order, error -220, “Parameter error;Frequency list must be in ascending order” occurs.
PAGE 289
prog.book Page 25 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:FREQuency:POINts? MEMory:TABLe:FREQuency:POINts? This query returns the number of frequency points for the table currently selected. The response format is . If no frequency values have been set, this command returns 0. If no table is selected, this command returns NAN. Syntax MEM :TABL :FREQ :POIN ? Example MEM:TABL:FREQ:POIN? This command queries the number of frequency points in the current table.
PAGE 290
prog.book Page 26 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:GAIN[:MAGNitude] {,} MEMory:TABLe:GAIN[:MAGNitude] {,} This command is used to enter calibration factors into the sensor calibration table, or offsets into the frequency dependent offset table, currently selected using MEMory:TABLe:SELect. Any previous calibration factor list, or offset list is cleared before the new calibration factors/offsets are stored.
PAGE 291
prog.book Page 27 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:GAIN[:MAGNitude] {,} Parameters Item Description/Default Range of Values numeric_value A numeric value for the calibration/offset factors. The units are PCT. 1.0 to 150.0 Example MEM:TABL:SEL "Sensor_1" MEM:TABL:GAIN 97,99.5,97.4 This command enters a reference calibration factor of 97% and calibration factors of 99.5% and 97.4% into the sensor calibration table.
PAGE 292
prog.book Page 28 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:GAIN[:MAGNitude]:POINts? MEMory:TABLe:GAIN[:MAGNitude]:POINts? This query is used to return the number of calibration factor/offset points for the currently selected table. If the currently selected table is a sensor calibration table, the reference calibration factor will be included If no values have been set, 0 is returned. If no table is selected, NAN is returned.
PAGE 293
prog.book Page 29 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:MOVE , MEMory:TABLe:MOVE , This command is used to rename a sensor calibration table or a frequency dependent offset table. Syntax MEM :TABL :MOVE Space string , string Parameters Item Description/Default Range of Values string (1st parameter) A string containing the existing table name. existing table name string (2nd parameter) A string detailing the new table name.
PAGE 294
prog.book Page 30 Thursday, June 7, 2001 2:55 PM MEMory Subsystem MEMory:TABLe:SELect MEMory:TABLe:SELect This command is used to activate either a sensor calibration table, or a frequency dependent offset table. A table must be activated before any operation can be performed on it. Syntax MEM :TABL :SEL Space string ? Parameters Item Description/Default Range of Values string A string detailing the table name. A maximum of 12 characters can be used.
PAGE 295
prog.
PAGE 296
prog.book Page 2 Thursday, June 7, 2001 2:55 PM OUTput Subsystem OUTPut Subsystem OUTPut Subsystem The OUTPut command subsystem is used to switch on and off the POWER REF output and control the rear panel TTL outputs. The.TTL Outputs can be used to determine when a predefined limit in either, or both, windows has been exceeded.
PAGE 297
prog.book Page 3 Thursday, June 7, 2001 2:55 PM OUTput Subsystem OUTPut:ROSCillator[:STATe] OUTPut:ROSCillator[:STATe] This command is used to switch on and off the POWER REF output Syntax OUTP :ROSC :STAT Space 0|OFF 1|ON ? Example OUTP:ROSC:STAT 1 This command switches on the POWER REF output. Reset Condition On reset, the POWER REF output is switched off.
PAGE 298
prog.book Page 4 Thursday, June 7, 2001 2:55 PM OUTput Subsystem OUTPut:TTL[1|2]:ACTive HIGH|LOW OUTPut:TTL[1|2]:ACTive HIGH|LOW This command controls whether a window limits fail drives the rear panel TTL Output HIGH or LOW. Output 1 is always connected to the upper window and Output 2 is always connected to the lower window. Syntax OUTP :TTL 1 :ACT Space 2 HIGH LOW ? Example OUTP:TTL1:ACT HIGH This command sets TTL output 1 HIGH whenever there is a limits fail in the upper window.
PAGE 299
prog.book Page 5 Thursday, June 7, 2001 2:55 PM OUTput Subsystem OUTPut:TTL[1|2]:FEED OUTPut:TTL[1|2]:FEED This command controls whether an asserted rear panel TTL Output indicates a failure in the upper, lower or either limit for the chosen window. TTL Output 1 is always connected to the upper window and TTL Output 2 is always connected to the lower window.
PAGE 300
prog.book Page 6 Thursday, June 7, 2001 2:55 PM OUTput Subsystem OUTPut:TTL[1|2]:FEED Example OUTP:TTL1:FEED “CALC1:LIM:UPP” This command asserts TTL Output 1 whenever there is an upper limit fail in the upper window. Reset Condition On reset, the TTL output will represent an upper limit fail.
PAGE 301
prog.book Page 7 Thursday, June 7, 2001 2:55 PM OUTput Subsystem OUTPut:TTL[1|2]:STATe OUTPut:TTL[1|2]:STATe This command is used to enable and disable the the rear panel Upper and Lower window TTL Outputs. When enabled, the TTL Outputs can be used to determine when a predefined limit is exceeded. Syntax OUTP :TTL 1 :STAT Space 2 0|OFF 1|ON ? Example OUTP:TTL1:STAT 1 This command enables the rear panel upper window TTL output.
PAGE 302
prog.
PAGE 303
prog.
PAGE 304
prog.book Page 2 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe] Subsystem [SENSe] Subsystem The SENSe command subsystem directly affects device specific settings used to make measurements. The SENSe node is optional since this is the primary function of the power meter. The high level command CONFigure uses the SENSe commands to prepare the power meter for making measurements.
PAGE 305
prog.
PAGE 306
prog.book Page 4 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage Node [SENSe[1]]|SENSe2:AVERage Node This node controls averaging which is used to improve the measurement accuracy. The AVERage subsystem combines successive measurements to produce a new composite result.
PAGE 307
prog.book Page 5 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:COUNt [SENSe[1]]|SENSe2:AVERage:COUNt This command is used to enter a value for the filter length. If [SENSe[1]]|SENSe2:AVERage:COUNt:AUTO is set to ON then entering a value for the filter length automatically sets it to OFF. Increasing the value of filter length increases measurement accuracy but also increases the time taken to make a power measurement.
PAGE 308
prog.book Page 6 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:COUNt Parameters Item Description/Default Range of Values numeric_value A numeric value defining the filter length. The default value, DEF, is 4. The value for MIN is 1. The value for MAX is 1024. 1 to 1024 DEF MIN MAX Example This command enters a filter length of 400 for channel A. AVER:COUN 400 Reset Condition On reset, the filter length is set to 4.
PAGE 309
prog.book Page 7 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:COUNt:AUTO |ONCE [SENSe[1]]|SENSe2:AVERage:COUNt:AUTO |ONCE This command is used to enable and disable automatic averaging. ONCE has no affect on the power meter. When the auto filter mode is enabled, the power meter automatically sets the number of readings averaged together to satisfy the averaging requirements for most power measurements.
PAGE 310
prog.book Page 8 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:COUNt:AUTO |ONCE For most applications, automatic filter length selection ([SENSe[1]]|SENSe2:AVERage:COUNt:AUTO ON) is the best mode of operation. However, manual filter length selection ([SENSe[1]]|SENSe2:AVERage:COUNt ) is useful in applications requiring either high resolution or fast settling times.
PAGE 311
prog.book Page 9 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:COUNt:AUTO |ONCE Error Message If [SENSe[1]]|SENSe2:AVERage:COUNt:AUTO is set to ON while [SENSe[1]]|SENSe2:SPEed is set to 200, the error -221, “Settings Conflict” occurs. However, automatic averaging is enabled but the [SENSe[1]]|SENSe2:AVERage:STATe command is not automatically set ON.
PAGE 312
prog.book Page 10 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:SDETect [SENSe[1]]|SENSe2:AVERage:SDETect In AUTO filter mode, the average of the last four values entered into the filter is compared to the average of the entire filter. If the difference between the two averages is greater than 12.5%, the digital filter is cleared. The filter then starts storing new measurements.
PAGE 313
prog.book Page 11 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage:SDETect Query [SENSe[1]]|SENSe2:AVERage:SDETect? The query enters a 1 or 0 into the output buffer indicating the status of step detection. • 1 is returned when step detection is enabled. • 0 is returned when step detection is disabled. Query Example SENS:AVER:SDET? This command queries whether step detection is on or off.
PAGE 314
prog.book Page 12 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:AVERage[:STATe] [SENSe[1]]|SENSe2:AVERage[:STATe] This command is used to enable and disable averaging. Syntax SENS 1 : AVER :STAT Space 0|OFF 1|ON SENS2 ? Example AVER 1 This command enables averaging on channel A. Reset Condition On reset, averaging is enabled. Query [SENSe[1]]|SENSe2:AVERage[:STATe]? The query enters a 1 or 0 into the output buffer indicating the status of averaging.
PAGE 315
prog.book Page 13 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection Node [SENSe[1]]|SENSe2:CORRection Node This node provides for known external losses or gains. These are used to enter duty cycle values, calibration factors and other external gains and losses.
PAGE 316
prog.book Page 14 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2 Node [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2 Node This node is used to select the active sensor calibration table and the active frequency dependent offset table. Note If any of the CSET1 commands are used when an Agilent E-series power sensor is connected, the error -241, “Hardware missing” occurs.
PAGE 317
prog.book Page 15 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2[:SELect] [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2[:SELect] This command enters the name of the sensor calibration table or frequency dependent offset table which is to be used. The CSET1 command selects the sensor calibration table and the CSET2 command selects the frequency dependent offset table.
PAGE 318
prog.book Page 16 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2[:SELect] Query [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2:[SELect]? The name of the selected table is returned as a quoted string. If no table is selected an empty string is returned. Query Example CORR:CSET1? This command queries the sensor calibration table currently used for channel A. Error Messages If is not valid, error -224, “Illegal parameter value” occurs.
PAGE 319
prog.book Page 17 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2:STATe [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2:STATe This command is used to enable and disable the use of the currently active sensor calibration (CSET1) or frequency dependent offset (CSET2) table.
PAGE 320
prog.book Page 18 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CSET[1]|CSET2:STATe Query Example SENS2:CORR:CSET1:STAT? This command queries whether there is currently an active sensor calibration table for channel B.
PAGE 321
prog.book Page 19 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3 Node [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3 Node This command node controls the pulse power measurement feature of the power meter. The commands associated with this node are: [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3[:INPut] [:MAGNitude] [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3:STATe Note You can use either DCYCLe or GAIN3 in these commands, both do the same.
PAGE 322
prog.book Page 20 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3[:INPut][:MAGNitude] [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3[:INPut][:MAGNitude] This command is used to set the duty cycle for the pulse power measurement feature of the power meter. Pulse power measurements average out any aberrations in the pulse such as overshoot or ringing.
PAGE 323
prog.book Page 21 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3[:INPut][:MAGNitude] Syntax SENS 1 : CORR :DCYC :INP :MAGN :GAIN3 SENS2 Space numeric_value DEF MIN MAX ? Space MIN MAX Parameters Item Description/Default Range of Values numeric_value A numeric value for the duty cycle. The default value, DEF, is 1%. The value for MIN is 0.001%. The value for MAX is 99.999%. The units are PCT, and are optional. 0.001 to 99.
PAGE 324
prog.book Page 22 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3[:INPut][:MAGNitude] Query Example CORR:GAIN3? This command queries the current setting of the duty cycle for channel A. Error Messages If a duty cycle value is entered using [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3 while [SENSe[1]]|SENSe2:SPEed is set to 200, the error -221, “Settings Conflict” occurs.
PAGE 325
prog.book Page 23 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3:STATe [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3:STATe This command is used to enable and disable the pulse power measurement feature. The [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3 command should be used to enter the duty cycle of the signal you want to measure.
PAGE 326
prog.book Page 24 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:DCYCle|GAIN3:STATe Query Example CORR:GAIN3:STAT? This command queries whether the pulse measurement feature is on or off. Error Messages If [SENSe[1]]|SENSe2:CORRection:DCYCle:STATus is set to ON while [SENSe[1]]|SENSe2:SPEed is set to 200, the error -221, “Settings Conflict” occurs.
PAGE 327
prog.book Page 25 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:GAIN[1|2] Node [SENSe[1]]|SENSe2:CORRection:GAIN[1|2] Node This node is used to provide a simple correction to the measurement. It is possible to apply two corrections, one for the calibration factor (CFACtor|GAIN1) and one for any other channel offset (GAIN2).
PAGE 328
prog.book Page 26 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CFACtor|GAIN[1|2][:INPut][:MAGNitude] [SENSe[1]]|SENSe2:CORRection:CFACtor|GAIN[1|2][:INPut][:MAGNitude] This command is used to enter a value for gain correction. The power meter corrects every measurement by this factor to compensate for the gain. There are two gains which can be set: • CFACtor|GAIN1 is used to enter a gain correction value for the calibration factor.
PAGE 329
prog.book Page 27 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CFACtor|GAIN[1|2][:INPut][:MAGNitude] Syntax SENS 1 : CORR :GAIN :INP 1 :MAGN 2 SENS2 :CFAC Space numeric_value DEF MIN MAX ? Space MIN MAX Parameters Item Description/Default Range of Values numeric_value (for CFACtor and GAIN1) A numeric value. The default value, DEF, is 100%. The value for MIN is 1%. The value for MAX is 150%.
PAGE 330
prog.book Page 28 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:CFACtor|GAIN[1|2][:INPut][:MAGNitude] Query [SENSe[1]]|SENSe2:CORRection:CFACtor|GAIN[1|2][:INPut][:MAGNitude]? [MIN|MAX] The query returns the current setting of the gain correction or the values associated with MIN and MAX.
PAGE 331
prog.book Page 29 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe This command is used to enable and disable a channel offset for the power meter setup. Since GAIN2 and LOSS2 form a coupled system, the command is identical to [SENSe[1]]|SENSe2:CORRection:LOSS2:STATe. The [SENSe[1]]|SENSe2:CORRection:GAIN2 command should be used to enter the gain value.
PAGE 332
prog.book Page 30 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe Error Message If [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe is set to ON while [SENSe[1]]|SENSe2:SPEed is set to 200, the error -221, “Settings Conflict” occurs.
PAGE 333
prog.book Page 31 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:FDOFfset|GAIN4[:INPut][:MAGNitude]? [SENSe[1]]|SENSe2:CORRection:FDOFfset|GAIN4[:INPut][:MAGNitude]? This command is used to return the frequency dependent offset currently being applied. Syntax SENS 1 : CORR :GAIN4 :INP :MAG ? :FDOFfset SENS2 Example CORR:GAIN4? This command queries the current frequency dependent offset being applied to channel A.
PAGE 334
prog.book Page 32 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:LOSS2 Node [SENSe[1]]|SENSe2:CORRection:LOSS2 Node This node is used to provide a simple correction to the measurement for an external loss. Loss and gain correction are a coupled system. This means that a loss set by [SENSe[1]]|SENSe2:CORRection:LOSS2 is represented in [SENSe[1]]|SENSe2:CORRection:GAIN2? command.
PAGE 335
prog.book Page 33 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:LOSS2[:INPut][:MAGNitude] [SENSe[1]]|SENSe2:CORRection:LOSS2[:INPut][:MAGNitude] This command is used to enter a channel offset value for the power meter setup, for example cable loss. The power meter then corrects every measurement by this factor to compensate for the loss.
PAGE 336
prog.book Page 34 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:LOSS2[:INPut][:MAGNitude] Example This command sets a channel offset of 50 dB for channel A. CORR:LOSS2 50 Reset Condition On reset, LOSS2 is set to 0.00 dB. Query [SENSe[1]]|SENSe2:CORRection:LOSS2[:INPut][:MAGNitude]? [MIN|MAX] The query returns the current setting of the channel offset or the values associated with MIN and MAX.
PAGE 337
prog.book Page 35 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:LOSS2:STATe [SENSe[1]]|SENSe2:CORRection:LOSS2:STATe This command is used to enable and disable a loss correction for the power meter setup, for example cable loss. Since LOSS2 and GAIN2 form a coupled system, the command is identical to [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe. The [SENSe[1]]|SENSe2:CORRection:LOSS2 command should be used to enter the loss value.
PAGE 338
prog.book Page 36 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:CORRection:LOSS2:STATe Error Message If [SENSe[1]]|SENSe2:CORRection:LOSS2:STATe is set to ON while [SENSe[1]]|SENSe2:SPEed is set to 200, the error -221, “Settings Conflict” occurs.
PAGE 339
prog.book Page 37 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:FREQuency[:CW|:FIXed] [SENSe[1]]|SENSe2:FREQuency[:CW|:FIXed] This command is used to enter a frequency. If the frequency does not correspond directly to a frequency in the sensor calibration table, the power meter calculates the calibration factor using linear interpolation.
PAGE 340
prog.book Page 38 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:FREQuency[:CW|:FIXed] Example FREQ 500kHz This command enters a channel A frequency of 500 kHz. Reset Condition On reset, the frequency is set to 50 MHz (DEF). Query [SENSe[1]]|SENSe2:FREQuency[:CW|:FIXed]? [MIN|MAX] The query returns the current frequency setting or the values associated with MIN and MAX. The units in which the results are returned are Hz.
PAGE 341
prog.book Page 39 Thursday, June 7, 2001 2:55 PM SENSe Subsystem The [SENSe[1]]|SENSe2:LIMit:CLEar Node The [SENSe[1]]|SENSe2:LIMit:CLEar Node This node contains the commands that are used to clear any limit failures.
PAGE 342
prog.book Page 40 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:CLEar:AUTO |ONCE [SENSe[1]]|SENSe2:LIMit:CLEar:AUTO |ONCE This command is used to control when the FCO (fail counter) is cleared of any limit failures. The FCO is used to determine the results returned by the [SENSe[1]]|SENSe2:LIMit:FAIL? query. If ON is specified, the FCO is set to 0 each time a measurement: • is initiated using INITiate[:IMMediate]. • is initiated using INITiate:CONTinuous ON.
PAGE 343
prog.book Page 41 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:CLEar:AUTO |ONCE Query [SENSe[1]]|SENSe2:LIMit:CLEar:AUTO? The query command enters a 1 or 0 into the output buffer indicating whether limit failures are cleared automatically when a new measurement is initiated on the specified channel. • 1 is entered into the output buffer when limit failures are cleared automatically when a new measurement is initiated.
PAGE 344
prog.book Page 42 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:CLEar[:IMMediate] [SENSe[1]]|SENSe2:LIMit:CLEar[:IMMediate] This command is used to immediately clear the FCO (fail counter) of any limit failures for the specified channel. The FCO is used to determine the results returned by the [SENSe[1]]|SENSe2:LIMit:FAIL? query. Syntax SENS 1 : LIM :CLE :IMM SENS2 Example SENS2:LIM:CLE:IMM 9-42 This command clears the FCO for channel B.
PAGE 345
prog.book Page 43 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:FAIL? [SENSe[1]]|SENSe2:LIMit:FAIL? This query enters a 1 or 0 into the output buffer indicating whether there have been any limit failures for the specified channel. A limit failure is defined as [SENSe[1]]|SENSe2:LIMit:FCO? being non-zero. The FCO (fail counter) can be zeroed using the [SENSe[1]]|SENSe2:LIMit:CLEar command. • 1 is returned when one or more limit failures have occurred.
PAGE 346
prog.book Page 44 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:FCOunt? [SENSe[1]]|SENSe2:LIMit:FCOunt? This query is used to return the total number of limit failures for the specified channel. If the appropriate STATe commands are set to ON, each time a measurement is initiated on the specified channel and the measurement result is outside the limits, the counter is incremented by one. If the measured value is equal to a limit, this is a limit pass.
PAGE 347
prog.book Page 45 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:FCOunt? Syntax SENS 1 : LIM :FCO ? SENS2 Example SENS1:LIM:FCO? This command queries the number of limit failures on channel A. Reset Condition On reset, the counter is set to zero on both channels.
PAGE 348
prog.book Page 46 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:LOWer[:DATA] [SENSe[1]]|SENSe2:LIMit:LOWer[:DATA] This command is used to enter a value for the lower test limit for the specified channel used in the [SENSe[1]]|SENSe2:LIMit:FAIL? test. The value is entered in dBm. When the measured power is less than the value specified in [SENSe[1]]|SENSe2:LIMit:LOWer:DATA, [SENSe[1]]|SENSe2:LIMit:FAIL? reports a fail.
PAGE 349
prog.book Page 47 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:LOWer[:DATA] Reset Condition On reset, both channels are set to -90.00 dBm (DEF). Query [SENSe[1]]|SENSe2:LIMit:LOWer[:DATA]? [MIN|MAX] The query returns the current setting of the lower limit or the values associated with MIN and MAX for the specified channel. Query Example SENS2:LIM:LOW:DATA? This command queries the lower limit set for channel B.
PAGE 350
prog.book Page 48 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:STATe [SENSe[1]]|SENSe2:LIMit:STATe This command is used to enable and disable the test limits for the specified channel. Syntax SENS 1 : LIM :STAT Space 0|OFF 1|ON SENS2 ? Example This command enables the limit checking function for channel B. SENS2:LIM:STAT 1 Reset Condition On reset, limit checking is disabled.
PAGE 351
prog.book Page 49 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:UPPer[:DATA] [SENSe[1]]|SENSe2:LIMit:UPPer[:DATA] This command is used to enter a value for the upper test limit for the specified channel used in the [SENSe[1]]|SENSe2:LIMit:FAIL? test. The value is entered in dBm. When the measured power is greater than the value specified in [SENSe[1]]|SENSe2:LIMit:UPPer:DATA, [SENSe[1]]|SENSe2:LIMit:FAIL? reports a fail.
PAGE 352
prog.book Page 50 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:LIMit:UPPer[:DATA] Query [SENSe[1]]|SENSe2:LIMit:UPPer[:DATA]? [MIN|MAX] The query returns the current setting of the upper limit or the values associated with MIN and MAX for the specified channel. Query Example SENS2:LIM:UPP:DATA? 9-50 This command queries the setting of the upper limit for channel B.
PAGE 353
prog.book Page 51 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:POWer:AC:RANGe [SENSe[1]]|SENSe2:POWer:AC:RANGe This command is used with the Agilent E-series power sensors to select one of two power ranges. • If 0 is selected, the power sensor’s lower range is selected. • If 1 is selected, the power sensor’s upper range is selected. Setting a range with this command automatically switches [SENSe[1]]|SENSe2:POWer:AC:RANGe:AUTO to OFF.
PAGE 354
prog.book Page 52 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:POWer:AC:RANGe:AUTO [SENSe[1]]|SENSe2:POWer:AC:RANGe:AUTO This command is used with the Agilent E-series power sensors to enable and disable autoranging. When autoranging is ON, the power meter selects the best measuring range for the measurement. When autoranging is set to OFF, the power meter remains in the currently set range. The [SENSe[1]]|SENSe2:POWer:AC:RANGe command disables autoranging.
PAGE 355
prog.book Page 53 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:POWer:AC:RANGe:AUTO Query Example POW:AC:RANG:AUTO? This command queries whether auto ranging is on or off. Error Message If this command is set to OFF when there is not an Agilent E-series power sensor connected, the error, -241, “Hardware missing” occurs.
PAGE 356
prog.book Page 54 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:SPEed [SENSe[1]]|SENSe2:SPEed This command is used to select the measurement speed on the selected channel. The speeds available are 20, 40 and 200 readings/second. Refer to “Getting the Best Speed Performance”, on page 1-66 for further information. When a channel is set to 200 readings/second the following couplings occur.
PAGE 357
prog.book Page 55 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:SPEed Parameters Item Description/Default Range of Values numeric_value A numeric value for the measurement speed. The default is 20. 20 40 200 Example SPE 40 This command sets the channel A speed to 40 readings/second. Reset Condition On reset, the speed is set to 20 readings/second. Query [SENSe[1]]|SENSe2:SPEed? The query returns the current speed setting, either 20, 40 or 200.
PAGE 358
prog.book Page 56 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:V2P ATYPe|DTYPe [SENSe[1]]|SENSe2:V2P ATYPe|DTYPe This command is used to select the type of linearity correction that will be applied to the channel sensors being used. For most 8480 series sensors the correct (A type or D type) linearity correction table is automatically selected. However, for the V8486A and W8486A sensors the automatic selection must be overriden and the D type (diode) correction selected.
PAGE 359
prog.book Page 57 Thursday, June 7, 2001 2:55 PM SENSe Subsystem [SENSe[1]]|SENSe2:V2P ATYPe|DTYPe Error Message If no sensor is connected or the sensor is not an A type, the error -241, “Hardware missing” occurs.
PAGE 360
prog.
PAGE 361
prog.
PAGE 362
prog.book Page 2 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus Subsystem STATus Subsystem The STATus command subsystem enables you to examine the status of the power meter by monitoring the “Device Status Register”, “Operation Status Register” and the “Questionable Status Register”. Table 10-1 summarizes the effects of various commands and events on the status data structures in the power meter.
PAGE 363
prog.book Page 3 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus Subsystem As the status reporting commands are orthogonal, the same commands apply to all the registers.
PAGE 364
prog.book Page 4 Thursday, June 7, 2001 2:55 PM STATus Subsystem Status Register Set Commands Status Register Set Commands The following descriptions detail the five commands which can be applied to all the SCPI registers. These commands should be prefixed with the node or nodes that represent the SCPI Register Set you require to control. For example, to use the :ENABle command on the STATus:QUEStionable register use STATus:QUEStionable:ENABle.
PAGE 365
prog.book Page 5 Thursday, June 7, 2001 2:55 PM STATus Subsystem Status Register Set Commands :ENABle | This command is used to set the Enable Register of the particular SCPI Register Set you require to control. The parameter value, when rounded to an integer and expressed in base 2 has it’s first 15 bits written into the Enable Register of the SCPI Register Set concerned. The last bit (bit 15) is always set to 0.
PAGE 366
prog.book Page 6 Thursday, June 7, 2001 2:55 PM STATus Subsystem Status Register Set Commands :NTRansition | This command is used to set the Negative Transition Register of the SCPI Register Set you require to control. The parameter value, when rounded to an integer and expressed in base 2 has it’s first 15 bits written into the Negative Transition Register of the SCPI Register Set concerned. The last bit (bit 15) is always set to 0.
PAGE 367
prog.book Page 7 Thursday, June 7, 2001 2:55 PM STATus Subsystem Status Register Set Commands :PTRansition | This command is used to set the Positive Transition Register of the SCPI Register Set you require to control. The first 15 bits of the input parameter are written into the Positive Transition Register of the SCPI Register Set concerned. The last bit (bit 15) is always set to 0.
PAGE 368
prog.book Page 8 Thursday, June 7, 2001 2:55 PM STATus Subsystem Device Status Register Sets Device Status Register Sets The following registers contain information which give device status information.The contents of the individual registers of these register sets may be accessed by appending the commands listed in “Status Register Set Commands”. The following command descriptions detail the SCPI register you require to control but do not detail the Register Set commands.
PAGE 369
prog.book Page 9 Thursday, June 7, 2001 2:55 PM STATus Subsystem Device Status Register Sets The Channel A and B sensor connected bits (bits 1 and 2), when queried with the STATus:DEVice:CONDition? query are set to: • 1, when a power sensor is connected. • 0, when no power sensor is connected.
PAGE 370
prog.book Page 10 Thursday, June 7, 2001 2:55 PM STATus Subsystem Operation Register Sets Operation Register Sets The following registers contain information which is part of the power meters normal operation. The contents of the individual registers of these register sets may be accessed by appending the commands listed in “Status Register Set Commands”. The following command descriptions detail the SCPI register you require to control but do not detail the Register Set commands.
PAGE 371
prog.book Page 11 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation STATus:OPERation The operation status register set contains conditions which are a part of the operation of the power meter as a whole.
PAGE 372
prog.book Page 12 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation:CALibrating[:SUMMary] STATus:OPERation:CALibrating[:SUMMary] The operation status calibrating summary register set contains information on the calibrating status of the power meter.
PAGE 373
prog.book Page 13 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation:LLFail[:SUMMary] STATus:OPERation:LLFail[:SUMMary] The operation status lower limit fail summary register set contains information on the lower limit fail status of the power meter.
PAGE 374
prog.book Page 14 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation:MEASuring[:SUMMary] STATus:OPERation:MEASuring[:SUMMary] The operation status measuring summary register set contains information on the measuring status of the power meter.
PAGE 375
prog.book Page 15 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation:SENSe[:SUMMary] STATus:OPERation:SENSe[:SUMMary] The operation status sense summary register set contains information on the status of the power sensors.
PAGE 376
prog.book Page 16 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation:TRIGger[:SUMMary] STATus:OPERation:TRIGger[:SUMMary] The operation status trigger summary register set contains information on the trigger status of the power meter.
PAGE 377
prog.book Page 17 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:OPERation:ULFail[:SUMMary] STATus:OPERation:ULFail[:SUMMary] The operation status upper limit fail summary register set contains information on the upper limit fail status of the power meter.
PAGE 378
prog.book Page 18 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:PRESet STATus:PRESet PRESet sets a number of the status registers to their preset values as shown below - all other registers are unaffected. Bit 15 is always 0.
PAGE 379
prog.book Page 19 Thursday, June 7, 2001 2:55 PM STATus Subsystem Questionable Register Sets Questionable Register Sets The Questionable Register Sets contain information which gives an indication of the quality of the data produced by the power meter. The contents of the individual registers in these register sets may be accessed by appending the commands listed in “Status Register Set Commands”.
PAGE 380
prog.book Page 20 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:QUEStionable STATus:QUEStionable The questionable register set contains bits which give an indication of the quality of various aspects of signals processed by the power meter as a whole.
PAGE 381
prog.book Page 21 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:QUEStionable:CALibration[:SUMMary] STATus:QUEStionable:CALibration[:SUMMary] The questionable calibration summary register set contains bits which give an indication of the quality of the data produced by the power meter due to its calibration status.
PAGE 382
prog.book Page 22 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:QUEStionable:POWer[:SUMMary] STATus:QUEStionable:POWer[:SUMMary] The questionable power summary register set contain bits which give an indication of the quality of the power data being acquired by the power meter.
PAGE 383
prog.book Page 23 Thursday, June 7, 2001 2:55 PM STATus Subsystem STATus:QUEStionable:POWer[:SUMMary] Bit 5 is set when the following condition occurs: • Channel A requires zeroing Bis 6 is set when the following condition occurs (Agilent E4419B only): • Channel B requires zeroing These bits are cleared when no errors or events are detected by the power meter during a measurement covering the causes given for it to set.
PAGE 384
prog.
PAGE 385
prog.
PAGE 386
prog.book Page 2 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem Subsystem SYSTem Subsystem The SYStem command subsystem is used to return error numbers and messages from the power meter, preset the power meter, select the remote interface type (GPIB, RS232 or RS422), set the GPIB address, set the command language and query the SCPI version.
PAGE 387
prog.book Page 3 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:GPIB[:SELF]:ADDRess SYSTem:COMMunicate:GPIB[:SELF]:ADDRess This command sets the GPIB address of the power meter. Syntax SYST :COMM :GPIB :SELF :ADDR Space numeric_value DEF MIN MAX ? Space MIN MAX Parameters Item Description/Default Range of Values numeric_value A numeric value for the address. The default value, DEF, is 13. The value for MIN is 0. The value for MAX is 30.
PAGE 388
prog.book Page 4 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYStem:COMMunicate:Serial Node SYStem:COMMunicate:Serial Node This node controls the settings for the RS232/RS422 serial interface.
PAGE 389
prog.book Page 5 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:CONTrol:DTR ON|OFF|IBFull SYSTem:COMMunicate:SERial:CONTrol:DTR ON|OFF|IBFull This command is used to set the serial interface (RS232) DTR signal line either high always (ON) or low always (OFF).
PAGE 390
prog.book Page 6 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:CONTrol:RTS ON|OFF|IBFull SYSTem:COMMunicate:SERial:CONTrol:RTS ON|OFF|IBFull This command is used to set the serial interface (RS232 or RS422) RTS signal line either high always (ON) or low always (OFF).
PAGE 391
prog.book Page 7 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:BAUD SYSTem:COMMunicate:SERial[:RECeive]:BAUD This command sets the baud rate for both the receiver and the transmitter. The baud rate for the receiver and transmitter are tied together and can either be set by this command or the equivalent transmitter command :TRANsmit:BAUD.
PAGE 392
prog.book Page 8 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:BAUD Query SYSTem:COMMunicate:SERial[:RECeive]:BAUD? MIN|MAX The query returns the current setting of the receive/transmit baud rate or the values associated with MIN and MAX. Query Example SYST:COMM:SER:REC:BAUD? This command queries the setting of the receive/transmit baud rate.
PAGE 393
prog.book Page 9 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:BITs SYSTem:COMMunicate:SERial[:RECeive]:BITs This command sets the word length for both the receiver and the transmitter. The word length for the receiver and transmitter are tied together and can either be set by this command or the equivalent transmitter command :TRANsmit:BITs.
PAGE 394
prog.book Page 10 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:BITs Query Example SYST:COMM:SER:REC:BIT? This command queries the setting of the receive/transmit word length. Error Message If the word length is not in the range of values shown in the parameter table, then the error message -224, “Illegal parameter value” will occur.
PAGE 395
prog.book Page 11 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:PACE XON|NONE SYSTem:COMMunicate:SERial[:RECeive]:PACE XON|NONE This command enables (XON) and disables (NONE) an Xon/Xoff software handshake for the receiver. When enabled, an Xon control character is transmitted when the receiver is ready to accept data and an Xoff control character is transmitted when the receiver is unable to receive further data (not ready for data).
PAGE 396
prog.book Page 12 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE SYSTem:COMMunicate:SERial[:RECeive]:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE This command decides what type of parity checking (if any) will take place on received data and also decides what parity (if any) will be included with transmitted data. The following choices are available and can be set using either this command or the equivalent TRANsmit:PARity[:TYPE] command.
PAGE 397
prog.book Page 13 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE Syntax SYST :COMM :SER :REC :PAR :TYPE Space EVEN ODD ZERO ONE NONE ? Example SYST:COMM:SER:REC:PAR ODD This command sets the transmitter to include an odd parity bit in the transmitted data and the receiver to check for odd parity in the received data. Reset Condition On reset, the parity setting is unaffected.
PAGE 398
prog.book Page 14 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial[:RECeive]:SBITs SYSTem:COMMunicate:SERial[:RECeive]:SBITs This command sets the number of stop bits expected by the receiver on received data and the number of stop bits included by the transmitter in transmitted data.
PAGE 399
prog.book Page 15 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:AUTO? SYSTem:COMMunicate:SERial:TRANsmit:AUTO? This query always returns a 1 confirming that the transmitter parameter settings for baud rate, word length, stop bits and parity are coupled to the receiver values.
PAGE 400
prog.book Page 16 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:BAUD SYSTem:COMMunicate:SERial:TRANsmit:BAUD This command sets the baud rate for both the transmitter and the receiver. The baud rate for the transmitter and receiver are tied together and can either be set by this command or the equivalent receiver command [RECeive]:BAUD.
PAGE 401
prog.book Page 17 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:BAUD Query SYSTem:COMMunicate:SERial:TRANsmit:BAUD? MIN|MAX The query returns the current setting of the transmit/receive baud rate or the values associated with MIN and MAX. Query Example SYST:COMM:SER:TRAN:BAUD? This command queries the setting of the transmit/ receive baud rate.
PAGE 402
prog.book Page 18 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:BITs SYSTem:COMMunicate:SERial:TRANsmit:BITs This command sets the word length for both the transmitter and the receiver. The word length for the transmitter and receiver are tied together and can either be set by this command or the equivalent receiver command [:RECeiver]:BITs.
PAGE 403
prog.book Page 19 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:ECHO ON|OFF SYSTem:COMMunicate:SERial:TRANsmit:ECHO ON|OFF This command allows the power meter to be controlled by a dumb terminal that may require its transmitted characters to be echoed. If ON is specified, data received by the receiver is transmitted back to the sender (echo on). If OFF is specified, data received by the receiver is not transmitted back to the sender (echo off).
PAGE 404
prog.book Page 20 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:ECHO ON|OFF Query Example SYST:COMM:SER:TRAN:ECHO? 11-20 This command queries whether or not the power meter has been set to return received data back to the sender.
PAGE 405
prog.book Page 21 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:PACE XON|NONE SYSTem:COMMunicate:SERial:TRANsmit:PACE XON|NONE This command enables (XON) and disables (NONE) an Xon/Xoff software handshake for the transmitter. When enabled, if an Xoff control character is detected by the receiver, the transmitter will not transmit further characters until an Xon control character is detected by the receiver.
PAGE 406
prog.book Page 22 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE SYSTem:COMMunicate:SERial:TRANsmit:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE This command decides what type of parity checking (if any) will take place on received data and also decides what parity (if any) will be included with transmitted data. The following choices are available and can be set using either this command or the equivalent [:RECeive]:PARity[:TYPE] command.
PAGE 407
prog.book Page 23 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:PARity[:TYPE] EVEN|ODD|ZERO|ONE|NONE Syntax SYST :COMM :SER :TRAN :PAR :TYPE Space EVEN ODD ZERO ONE NONE ? Example SYST:COMM:SER:TRAN:PAR ODD This command sets the transmitter to include an odd parity bit in the transmitted data and the receiver to check for odd parity in the received data. Reset Condition On reset, the parity selection is unaffected.
PAGE 408
prog.book Page 24 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:SBITs SYSTem:COMMunicate:SERial:TRANsmit:SBITs This command sets the number of stop bits expected by the receiver on received data and the number of stop bits included by the transmitter in transmitted data.
PAGE 409
prog.book Page 25 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:COMMunicate:SERial:TRANsmit:SBITs Query Example SYST:COMM:SER:TRAN:SBIT? This command queries the setting of the receive/transmit stop bits.
PAGE 410
prog.book Page 26 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:ERRor? SYSTem:ERRor? This query returns error numbers and messages from the power meter’s error queue. When an error is generated by the power meter, it stores an error number and corresponding message in the error queue. One error is removed from the error queue each time the SYSTem:ERRor? command is executed. The errors are cleared in the order of first-in first-out, that is, the oldest errors are cleared first.
PAGE 411
prog.book Page 27 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:LANGuage SYSTem:LANGuage This command is used to change the remote programming language accepted by the power meter from SCPI to the HP 437B programming language. To return to using the SCPI programming language when in the HP 437B mode use the SYST:LANG SCPI command. After sending the command to change language wait 100 ms before sending any other commands.
PAGE 412
prog.book Page 28 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYStem:LOCal SYStem:LOCal This command unlocks the front panel keypad and enables the power meter to be controlled locally from the front panel. The power meter display status reporting line will show “LCL”. Syntax SYST :LOC Example SYST:LOC This command unlocks the power meter front panel keypad and enables local front panel control.
PAGE 413
prog.book Page 29 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:PRESet SYSTem:PRESet This command is used to preset the power meter. The result of this command is similar to the *RST command. Refer to Table 11-1 for more information about the preset configuration. All settings apply to both *RST and to SYSTem:PREset unless stated otherwise. Note Syntax SYST :PRES Example This command presets the power meter.
PAGE 414
prog.
PAGE 415
prog.
PAGE 416
prog.book Page 32 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:REMote SYSTem:REMote This command locks out all the front panel keypad except the Local key. The power meter display status reporting line will show “RMT”. Local front panel operation of the power meter is inhibited but can be enabled by pressing the Local key. Syntax SYST :REM Example SYST:REM This command locks the power meter front panel keypad (except the Local key).
PAGE 417
prog.book Page 33 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:RINTerface GPIB|RS232|RS422 SYSTem:RINTerface GPIB|RS232|RS422 This command allows the remote control interface to be selected from GPIB, RS232, and RS422. Syntax SYST :RINT Space GPIB RS232 RS422 ? Example SYST:RINT RS232 This command sets the power meter remote control interface to RS232. Query SYSTem:RINTerface? The query returns the current setting of the remote control interface (GPIB, RS232, or RS422)..
PAGE 418
prog.book Page 34 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:RWLock SYSTem:RWLock This command locks out the front panel keypad - including the front panel Local key. The power meter display status reporting line will show “RMT’. In this state the power meter cannot be returned to manual control from the front panel. Syntax SYST :RWL Example SYST:RWL This command locks the power meter front panel keypad including the Local key.
PAGE 419
prog.book Page 35 Thursday, June 7, 2001 2:55 PM SYSTem Subsystem SYSTem:VERSion? SYSTem:VERSion? This query returns the version of SCPI used in the power meter. The response is in the form of XXXX.Y, where XXXX is the year and Y is the version number. Syntax SYST :VERS ? Example SYST:VERS? This command queries which version of SCPI is used in the power meter.
PAGE 420
prog.
PAGE 421
prog.
PAGE 422
prog.book Page 2 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger Subsystem TRIGger Subsystem The TRIGger subsystem is used to synchronize device actions with events. The TRIGger subsystem includes the ABORt, INITiate and TRIGger commands. These are all at the root level in the command hierarchy but they are grouped here because of their close functional relationship.
PAGE 423
prog.book Page 3 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem ABORt[1|2] ABORt[1|2] The ABORt command removes the specified channel from the “wait-for-trigger” state and places it in the “idle” state. It does not affect any other settings of the trigger system. When the INITiate command is sent, the trigger system responds as it did before ABORt was executed. If INITiate:CONTinuous is ON, then after ABORt the specified channel immediately goes into the “wait-for-trigger” state.
PAGE 424
prog.book Page 4 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem INITiate Node INITiate Node This command node allows you to place the power meter in the “wait-for-trigger” state. The INITiate commands are overlapped, that is, the power meter can continue parsing and executing subsequent commands while initiated. Refer to IEEE 488.2, section 12 for further details.
PAGE 425
prog.book Page 5 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem INITiate[1|2]:CONTinuous INITiate[1|2]:CONTinuous This command is used to set the power meter for either a single trigger cycle or continuous trigger cycles. A trigger cycle means that the power meter exits the “wait-for-trigger” state and starts a measurement. When entering local mode, INITiate:CONTinuous is set to ON.
PAGE 426
prog.book Page 6 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem INITiate[1|2]:CONTinuous Query Example INIT2:CONT? 12-6 This command queries whether channel B is set for single or continuous triggering.
PAGE 427
prog.book Page 7 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem INITiate[1|2][:IMMediate] INITiate[1|2][:IMMediate] This command is used to place the power meter in the “wait-for-trigger” state. When a trigger is received, the measurement is taken and the result placed in the power meter memory. If TRIGger:SOURce is set to IMMediate the measurement begins as soon as INITiate:IMMediate is executed. Use FETCh? to transfer a measurement from memory to the output buffer.
PAGE 428
prog.book Page 8 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger Node TRIGger Node This node controls the behavior of the trigger system.
PAGE 429
prog.book Page 9 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger[1|2]:DELay:AUTO TRIGger[1|2]:DELay:AUTO This command is used to determine whether or not there is a settling-time delay before a measurement is made. When this command is set to: • ON, the power meter inserts a settling-time delay before taking the requested measurement. This settling time allows the internal digital filter to be updated with new values to produce valid, accurate measurement results.
PAGE 430
prog.book Page 10 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger[1|2]:DELay:AUTO Query TRIGger:DELay:AUTO? The query enters a 1 or 0 into the output buffer indicating the status of TRIGger:DELay:AUTO. • 1 is returned when it is ON. • 0 is returned when it is OFF.
PAGE 431
prog.book Page 11 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger[1|2][:IMMediate] TRIGger[1|2][:IMMediate] This command causes a trigger to occur immediately, provided the specified channel is in the “wait-for-trigger” state. When this command is executed, the measurement result is stored in the power meter’s memory. Use FETCh? to place the measurement result in the output buffer. TRIGger[1|2]:DELay:AUTO is ignored if TRIGger[1|2][:IMMediate] is set to ON.
PAGE 432
prog.book Page 12 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger[1|2]:SOURce BUS|IMMediate|HOLD TRIGger[1|2]:SOURce BUS|IMMediate|HOLD This command configures the trigger system to respond to the specified source. This command only selects the trigger source. You should use the INITiate command to place the power meter in the “wait-for-trigger” state.
PAGE 433
prog.book Page 13 Thursday, June 7, 2001 2:55 PM TRIGger Subsystem TRIGger[1|2]:SOURce BUS|IMMediate|HOLD Example TRIG:SOUR IMM This command configures channel A for immediate triggering. Reset Condition On reset, the trigger source is set to IMMediate. Query TRIGger:SOURce? The query returns the current trigger source, either IMM, BUS or HOLD. Query Example TRIG:SOUR? This command queries channel A’s trigger source.
PAGE 434
prog.
PAGE 435
prog.
PAGE 436
prog.book Page 2 Thursday, June 7, 2001 2:55 PM UNIT Subsystem UNIT Subsystem UNIT Subsystem The UNIT command subsystem is used to set the power meter measurement units to Watts and % (linear) or dBm and dB (logarithmic). The numeric suffix of the UNIT program mnemonic in the UNIT commands refers to a window, that is UNIT1 and UNIT2 represent the upper and lower windows respectively.
PAGE 437
prog.book Page 3 Thursday, June 7, 2001 2:55 PM UNIT Subsystem UNIT[1|2]:POWer UNIT[1|2]:POWer This command is used to set the selected window’s measurement units. For any command which accepts a numeric value in more than one unit and the power suffix is omitted then the units set by UNIT:POWer are used. For the Agilent E4418B: • UNIT1:POWer sets the power measurement units for the upper window.
PAGE 438
prog.book Page 4 Thursday, June 7, 2001 2:55 PM UNIT Subsystem UNIT[1|2]:POWer Parameters Item Description/Default Range of Values amplitude_unit The measurement unit. The default unit is dBm. W DBM Example UNIT1:POW DBM This command sets the measurement units for the upper window and the default units for any relevant SENSe1 command to dBm. Reset Condition On reset, both channels are set to dBm.
PAGE 439
prog.book Page 5 Thursday, June 7, 2001 2:55 PM UNIT Subsystem UNIT[1|2]:POWer Query UNIT[1|2]:POWer? The query returns the current setting of the measurement units. Query Example UNIT2:POW? This command queries which measurement units are being used on the lower window. In addition, for the Agilent E4419B this command also queries the default units for any relevant SENSe2 command.
PAGE 440
prog.book Page 6 Thursday, June 7, 2001 2:55 PM UNIT Subsystem UNIT[1|2]:POWer:RATio UNIT[1|2]:POWer:RATio This command is used on the Agilent E4419B to set the default units used when inputting and outputting power ratio data. • UNIT1:POWer:RATio sets the ratio measurement units for the upper window. In addition, it also sets the ratio suffix for any SENSe1 command that requires but omits the ratio suffix.
PAGE 441
prog.book Page 7 Thursday, June 7, 2001 2:55 PM UNIT Subsystem UNIT[1|2]:POWer:RATio Query UNIT[1|2]:POWer:RATio? The query returns the current setting of the ratio measurement units. Query Example UNIT2:POW:RAT? This command queries which ratio measurement units are being used on the lower window. It also queries the default units for any relevant SENSe2 command. Error Message If this command is used with an Agilent E4418B, error -113, “Undefined header” occurs.
PAGE 442
prog.
PAGE 443
prog.
PAGE 444
prog.book Page 2 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice Subsystem SERVice Subsystem The SERVice command subsystem is used to load and obtain information such as the instrument serial numberfrom the power on the current sensor(s) being used.
PAGE 445
prog.book Page 3 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:OPTion SERVice:OPTion This command loads the power meter memory with the options fitted. The query form of the command can be used to determine which options are fitted to the unit. Syntax SERV :OPT Space string ? Parameters Item Description/Default Range of Values string A string detailing the option number in a commas-seperated list. A maximum of 30 characters can be used.
PAGE 446
prog.book Page 4 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:SENSor[1|2]:CDATE? SERVice:SENSor[1|2]:CDATE? This query is used to return the date of calibration stored in EEPROM on E-series sensors only. Syntax SERV :SENS 1 :CDATE ? 2 Example SERV:SENS2:CDATE? This query returns the calibration date of the E-series sensor connected to channel B.
PAGE 447
prog.book Page 5 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:SENSor[1|2]:CPLace? SERVice:SENSor[1|2]:CPLace? This query is used to return the place of calibration stored in EEPROM on E-series sensors only. Syntax SERV :SENS 1 :CPL ? 2 Example SERV:SENS2:CPL? This query returns the place of calibration of the E-series sensor connected to channel B. Error Message If an Agilent E-series power sensor is not connected, the error -241 “Hardware missing” occurs.
PAGE 448
prog.book Page 6 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:SENSor[1|2]:SNUMber? SERVice:SENSor[1|2]:SNUMber? This query is used to return the serial number stored in EEPROM on E-series sensors only. Syntax SERV :SENS 1 :SNUM ? 2 Example SERV:SENS2:SNUM? This query returns the serial number of the E-series sensor connected to channel B. Error Message If an Agilent E-series power sensor is not connected, the error -241 “Hardware missing” occurs.
PAGE 449
prog.book Page 7 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:SENSor[1|2]:TYPE? SERVice:SENSor[1|2]:TYPE? This query is used to identify the sensor type connected to the power meter input channel(s). For Agilent 8480 series sensors, either “A”, “B”, “D”, or “H” is returned.
PAGE 450
prog.book Page 8 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:SNUMber SERVice:SNUMber This command is used to load the power meter with a serial number in the form GB12345678 or US12345678. Syntax SERV :SNUM Space alpha_numeric ? Parameters Item Description/Default Range of Values alpha_numeric An alpha_numeric detailing the power meter serial number in the form GB12345678 or US12345678. A maximum of 30 characters can be used.
PAGE 451
prog.book Page 9 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:VERSion:PROCessor SERVice:VERSion:PROCessor This command loads the power meter with the processor board revision version. Syntax SERV :VERS :PROC Space string ? Parameters Item Description/Default Range of Values string A string detailing the processor board revision version . A maximum of 20 characters can be used.
PAGE 452
prog.book Page 10 Thursday, June 7, 2001 2:55 PM SERVice Subsystem SERVice:VERSion:SYSTem SERVice:VERSion:SYSTem This command loads the power meter with the system version number. Syntax SERV :VERS :SYST Space string ? Parameters Item Description/Default Range of Values string A string detailing the system version number. A maximum of 20 characters can be used.
PAGE 453
prog.book Page 1 Thursday, June 7, 2001 2:55 PM 15 IEEE488.
PAGE 454
prog.book Page 2 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference IEEE-488 Compliance Information IEEE-488 Compliance Information This chapter contains information about the IEEE 488.2 Common (*) Commands that the power meter supports. It also describes the universal command statements which form the nucleus of GP-IB programming; they are understood by all instruments in the network.
PAGE 455
prog.book Page 3 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference Universal Commands Universal Commands DCL The DCL (Device Clear) command causes all GP-IB instruments, or addressed instruments, to assume a cleared condition. The definition of device clear is unique for each instrument. For the power meter: • All pending operations are halted, that is, *OPC? and *WAI.
PAGE 456
prog.book Page 4 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference Universal Commands LLO The LLO (Local Lock Out) command can be used to disable the front panel local key. With this key disabled, only the controller (or a hard reset by the line power switch) can restore local control. PPC When addressed to listen, the PPC (Parallel Poll Configure) command will cause the power meter to be configured according to the parallel poll enable secondary command which should follow this command.
PAGE 457
prog.book Page 5 Thursday, June 7, 2001 2:55 PM IEEE488.
PAGE 458
prog.book Page 6 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference Universal Commands SPD The SPD (Serial Poll Disable) command terminates the serial poll mode for the power meter and returns it to its normal talker state where device dependent data is returned rather than the status byte. SPE The SPE (Serial Poll Enable) command establishes the serial poll mode for the power meter.
PAGE 459
prog.book Page 7 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *CLS *CLS The *CLS (CLear Status) command clears the status data structures. The SCPI registers (Questionable Status, Operation Status and all the other SCPI registers), the Standard Event Status Register, the Status Byte, and the Error/Event Queue are all cleared.
PAGE 460
prog.book Page 8 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *DDT | *DDT | The *DDT (Define Device Trigger) command determines the power meter’s response to a GET (Group Execute Trigger) message or *TRG common command. This command effectively turns GET and *TRG into queries, with the measured power being returned.
PAGE 461
prog.book Page 9 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *DDT | Query *DDT? The query returns the action which is performed on receipt of a GET or *TRG. This is returned as a value which is in the form of #nN as described on page 15-8. Error Message If an invalid parameter is received error -224, “Illegal parameter value” occurs.
PAGE 462
prog.book Page 10 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *ESE *ESE The *ESE (Event Status Enable) command sets the Standard Event Status Enable Register. This register contains a mask value for the bits to be enabled in the Standard Event Status Register. A 1 in the Enable Register enables the corresponding bit in the Status Register, a 0 disables the bit.
PAGE 463
prog.book Page 11 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *ESR? *ESR? The *ESR? query returns the contents of the Standard Event Status Register then clears it. The format of the return is in the range of 0 to 255. Table 15-4 shows the contents of this register.
PAGE 464
prog.book Page 12 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *IDN? *IDN? The *IDN? query allows the power meter to identify itself. The string returned will be either: HEWLETT-PACKARD,E4418B,,A1.XX.YY HEWLETT-PACKARD,E4419B,,A2.XX.YY HEWLETT-PACKARD,437B,,2.0 where: • uniquely identifies each power meter. • A1.XX.YY and A2.XX.YY represents the firmware revision with XX and YY representing the major and minor revisions respectively.
PAGE 465
prog.book Page 13 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *OPC *OPC The *OPC (OPeration Complete) command causes the power meter to set the operation complete bit in the Standard Event Status Register when all pending device operations have completed. Syntax *OPC ? Query *OPC? The query places an ASCII 1 in the output queue when all pending device operations have completed.
PAGE 466
prog.book Page 14 Thursday, June 7, 2001 2:55 PM IEEE488.
PAGE 467
prog.book Page 15 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *RCL *RCL The *RCL (ReCaLl) command restores the state of the power meter from the specified save/recall register. An instrument setup must have been stored previously in the specified register. Syntax *RCL Space NRf Parameters Type Description/Default Range of Values NRf The number of the register to be recalled.
PAGE 468
prog.book Page 16 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *RST *RST The *RST (ReSeT) command places the power meter in a known state. The power meter is reset to the state shown in Table 11-1 on page 11-29.
PAGE 469
prog.book Page 17 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *SAV *SAV The *SAV (SAVe) command stores the current state of the power meter in the specified register. Syntax *SAV Space NRf Parameters Item Description/Default NRf The number of the register that the current state of the power meter is to be saved to.
PAGE 470
prog.book Page 18 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *SRE *SRE The *SRE command sets the Service Request Enable register bits. This register contains a mask value for the bits to be enabled in the Status Byte Register. A 1 in the Enable Register enables the corresponding bit in the Status Byte Register; a 0 disables the bit.
PAGE 471
prog.book Page 19 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *SRE Query *SRE? The query returns the contents of bits 0 to 5 and bit 7 of the Service Request Enable Register. The format of the return is in the ranges of 0 to 63 or 128 to 191 (that is, bit 6 is always 0).
PAGE 472
prog.book Page 20 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *STB? *STB? The *STB? (STatus Byte) query returns bit 0 to 5 and bit 7 of the power meter’s status byte and returns the Master Summary Status (MSS) as bit 6. The MSS is the inclusive OR of the bitwise combination (excluding bit 6) of the Status Byte and the Service Request Enable registers. The format of the return is in the ranges of 0 to 255. Table 15-6 shows the contents of this register.
PAGE 473
prog.book Page 21 Thursday, June 7, 2001 2:55 PM IEEE488.
PAGE 474
prog.book Page 22 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *TRG *TRG The *TRG (TRiGger) command triggers all channels that are in the “wait-for-trigger” state. It has the same effect as Group Execute Trigger (GET). Using the *DDT command may change the function of the *TRG command. Syntax *TRG Error Message If TRIGger:SOURce is not set to BUS then error -211, “Trigger ignored” occurs. If the power meter is not in the “wait-for-trigger” state then error -211, “Trigger ignored” occurs.
PAGE 475
prog.book Page 23 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *TST? *TST? The *TST? (TeST) query causes the power meter to perform the GP-IB self test which takes approximately 30 seconds. The GP-IB self test consists of the following tests: • ROM checksum • RAM • Battery • Display Assembly • Calibrator • Measurement Assembly • Communications Assembly (Implicit) The result of the test is placed in the output queue. • 0 is returned if the test passes. • 1 if the test fails.
PAGE 476
prog.book Page 24 Thursday, June 7, 2001 2:55 PM IEEE488.2 Command Reference *WAI *WAI The *WAI (WAIt) command causes the power meter to wait until either: • all pending operations are complete, • the device clear command is received, • power is cycled, before executing any subsequent commands or queries.
PAGE 477
prog.
PAGE 478
prog.
PAGE 479
prog.
PAGE 480
prog.
PAGE 481
prog.
PAGE 482
prog.