You have only those rights provided for such Software and Documentation by the applicable FAR or DFARS clause or the Agilent standard software agreement for the product involved. U2000 Series Programming Guide...
To prevent electrical shock, do not remove covers. For continued protection against fire hazard, replace the line fuse(s) only with fuses of the same type and rating (for example, normal blow, time delay, etc.). The use of other fuses or material is prohibited. U2000 Series Programming Guide...
Agilent Technologies, Inc. assumes no liability for the customer’s failure to comply with these requirements. BEFORE CONNECTING THE POWER SENSOR TO OTHER INSTRUMENTS...
SCPI version. TRIGger Subsystem Chapter 9 explains how the TRIGger command subsystem is used to synchronize device actions with events. U2000 Series Programming Guide...
Page 7
Watts and % (linear), or dBm and dB (logarithmic). IEEE 488.2 Command Reference Chapter 11 explains how the SERVice command subsystem is used to obtain and set information useful for servicing the power sensor. U2000 Series Programming Guide...
List of Figures List of Figures Figure 1-1 Frequency Dependent Offset Tables 18 Figure 1-2 Typical averaged readings on U2000 Series USB power sensors 25 Figure 1-3 Averaging Range Hysteresis 25 Figure 1-4 Limits Checking Results 28 Figure 1-5 How Measurement are Calculated 35...
Page 10
Commands and events affecting Status Register 224 Table 10-1 DEFault: Power Sensor Presets 258 Table 12-1 Measurement Display UNIT Block Window 292 Table 13-1 *ESE Mapping 298 Table 13-2 *ESR? Mapping 300 Table 13-3 *SRE Mapping 307 Table 13-4 *STB? Mapping 309 U2000 Series Programming Guide...
Page 11
List of Tables 1 Power Sensor Remote Operation Introduction Configuring the Remote Interface • Interface Selection • USB Configuration Zeroing and Calibrating the U2000 Series USB Power Sensors • Zeroing • Calibration Making Measurement • Using MEASure? • Using the CONFigure Command •...
Page 12
• Using a Comma (,) • Using Whitespace • Using “?” Commands • Using “*” Commands • Syntax Conventions • Syntax Diagram Conventions • SCPI Data Types • Input Message Terminators SCPI Compliance Information Summary of Commands U2000 Series Programming Guide...
Page 18
Contents xviii U2000 Series Programming Guide...
Page 19
Agilent U2000 Series USB Power Sensors Programming Guide Power Sensor Remote Operation Introduction Configuring the Remote Interface • Interface Selection • USB Configuration Zeroing and Calibrating the U2000 Series USB Power Sensors • Zeroing • Calibration Making Measurement • Using MEASure? •...
Page 20
• Syntax Diagram Conventions • SCPI Data Types • Input Message Terminators SCPI Compliance Information Summary of Commands This chapter describes the parameters that configure the power sensor and helps you determine settings to optimize performance. U2000 Series Programming Guide...
It contains the following sections: • “Configuring the Remote Interface” on page 4. • “Zeroing and Calibrating the U2000 Series USB Power Sensors” on page 5. • “Making Measurement” on page 7. •...
For more information on configuring the USB remote interface connectivity, refer to the N O T E Agilent Technologies USB/LAN/GPIB Interfaces Connectivity Guide. If you have installed the IO Libraries Suite, you can access the Connectivity Guide via the Agilent IO Libraries Control icon.
With internal zeroing of U2000 Series USB power sensors, there is no need to disconnect the sensor or power- off the device- under- test (DUT). The U2000 Series does not require 50 MHz reference signal calibration, thus allowing factory calibration for ensuring measurement accuracy.
Page 24
CALibration[1][:ALL]? query except that no number is returned to indicate the outcome of the sequence. You can examine the Questionable Status Register or the error queue to discover if the sequence has passed or failed. Refer to “Status Reporting” page 36 for further information. U2000 Series Programming Guide...
As shown in Table 1- states in the power sensor. It may be likely that you do not want to preset these states. Refer to “Using the Lower Level Commands” on page 15 for further information. U2000 Series Programming Guide...
The following commands show the simplest method of making measurements. Using MEAS1? results in the current window measurement. current window MEAS1? Example 2 - Specifying the Source List Parameter The MEASure command has three optional parameters, an expected power U2000 Series Programming Guide...
Page 27
W or %, and 0.01 dB if the suffix is dB or dBm. Refer to Chapter “MEASurement Commands”on page 65, for further details on the resolution parameter. The expected power and source list parameters are defaulted in the example. The expected power value remains unchanged at its current U2000 Series Programming Guide...
FETCh? can be used to display the measurement results in a number of different formats without taking fresh data for each measurement. CONFigure Examples The following program segments show how to use the commands READ?, U2000 Series Programming Guide...
Page 29
Although the READ? and FETCh? queries have three optional parameters it is not necessary to define them as shown in these examples. If they are defined they must be identical to those defined in the CONFigure command otherwise U2000 Series Programming Guide...
Page 30
The following example uses the expected value parameter to specify a value of –50 dBm. This selects the power sensor’s lower range (refer to “Range” page 26 for details of the range breaks). The resolution parameter is defaulted, leaving it at its current setting. U2000 Series Programming Guide...
Page 31
INITiate and FETCh? commands. For example, in the above program segment some fine tuning can be carried out by setting the filter length to 1024 and the trigger delay off. 1 ABOR1 2 CONF1 -50,DEF,(@1) 3 SENS1:AVER:COUN 1024 U2000 Series Programming Guide...
Page 32
Some fine tuning of the above program segment can be carried out for example, by setting the trigger delay off. The following program segment assumes that it is being measured in the measurement. 1 ABOR1 2 CONF1 DEF,3 3 TRIG1:DEL:AUTO OFF 4 READ1? U2000 Series Programming Guide...
The advantage of using the lower level commands over the CONFigure command is that they give you more precise control of the power sensor. As the CONFigure command presets various states in the shown in Table 1- 1 U2000 Series Programming Guide...
Page 34
The following example sets the expected power value to –50 dBm and the resolution setting to 3 using the lower level commands. ABOR1 Aborts current measurement CALC1:MATH:EXPR Displays current measurement "(SENS1)" SENS1:POW:AC:RANG -50 Sets lower range INIT1 Causes a measurement FETC1? Retrieves the current measurement U2000 Series Programming Guide...
5 Specify the frequency of the signal you want to measure. The required offset is automatically set by the power sensor from the frequency dependent offset table. 6 Make the measurement. Figure 1- 1 illustrates how frequency dependent offset tables operate. U2000 Series Programming Guide...
TABLE SELECTED FREQ OFFSET FREQ OFFSET Frequency dependent Frequency of the signal you want offset used to make to measure Measurement. Calculated by the Power Sensor using linear interpolation. FREQ OFFSET Figure 1-1 Frequency Dependent Offset Tables U2000 Series Programming Guide...
Offset 2 " " Frequency n Offset n 4 If required, rename the frequency dependent offset table using: MEMory:TABLe:MOVE <string>,<string>. The first <string> parameter identifies the existing table name, and the second identifies the new table name. U2000 Series Programming Guide...
Page 38
• <string>,<type>,<size> The <string>, <type> and <size> are all character data. The <type> is always TABL. The <size> is displayed in bytes. For example, a sample of the response may look like: 560,8020,“Offset_1,TABL,220”,”Offset_2,TABL,340” ..U2000 Series Programming Guide...
Page 39
If you need to modify the frequency and offset factor data stored in a frequency dependent offset table you need to resend the complete data lists. If you have retained the original data in a program, edit the program and resend the data. U2000 Series Programming Guide...
The power sensor automatically sets the offset factor. Use either the INITiate, FETCh? or the READ? query to initiate the measurement as shown in the following program segments: INITiate Example ABORt1 CONFigure1:POWer:AC DEF,1,(@1) SENS1:CORR:CSET2:SEL "Offset1" SENS1:CORR:CSET2:STAT ON SENS1:FREQuency 500KHZ INITiate1:IMMediate FETCh1? U2000 Series Programming Guide...
Page 41
To find out the value of the offset being used by the power sensor to make a measurement, use the query command: [SENSe[1]]:CORRection:GAIN4|FDOFfset[:INPut][MAGNITUDE]? The response may be an interpolated value. U2000 Series Programming Guide...
The number of readings averaged together depends on the resolution and the power level currently being measured. Figure 1- 3 illustrates part of the power sensor dynamic range hysteresis. U2000 Series Programming Guide...
Power Sensor Remote Operation Figure 1-2 Typical averaged readings on U2000 Series USB power sensors Range Hysteresis 9.5 dB 10.5 dB Minimum Sensor Power Minimum Sensor Power + 10 dB Figure 1-3 Averaging Range Hysteresis U2000 Series Programming Guide...
• 0, the sensor’s lower range is selected. • 1, the sensor’s upper range is selected. For detailed on the range limits of U2000 Series USB power sensors, refer to the U2000 Series USB Power Sensors Operating and Service Guide.
If you enter an offset value the state is automatically enabled. However it can be enabled and disabled using either the [SENSe[1]]:CORRection:GAIN2:STATe. To enter a LOSS value, you can enter a negative value in the command N O T E [SENSe[1]]:CORRection:GAIN2[:INPut][:MAGNitude]<numeric_value>. U2000 Series Programming Guide...
–150.00 dBm to +230.00 dBm. The default upper limit is +90.00 dBm and the default lower limit is –90.00 dBm. Amplitude Fail +10 dBm +4 dBm Fail Frequency Figure 1-4 Limits Checking Results U2000 Series Programming Guide...
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. CALCulate[1]:LIMit:FCOunt? Returns the total number of limit failures, in this case 2. U2000 Series Programming Guide...
Page 48
Power Sensor Remote Operation If TRIGger:DELay:AUTO is set to ON, then the number of failures returned by N O T E CALCulate[1]:LIMit:FCOunt? is affected by the current filter settings. U2000 Series Programming Guide...
In NORMal and DOUBle modes, full instrument functionality is available. In FAST mode averaging, limits are disabled. Refer to “Specifications” in the U2000 Series USB Power Sensors Operating and Service Guide to see the influence of these speed settings on the accuracy and noise performance of the power sensor.
Page 50
With trigger with delay enabled, the measurement speed can be calculated roughly using the following equation: readings/sec = speed (as set by [SENSe[1]]:MRATe)/ filter length U2000 Series Programming Guide...
Trigger Count To get the fastest measurement speed TRIG:COUNT must be set to return multiple measurements for each FETCh command. For average only measurements a count of 4 is required, however, 10 is recommended. U2000 Series Programming Guide...
The latter can be reduced using the FORMat REAL command to return results in binary format. The former is a combination of two factors: • the hardware platform being used • the programming environment being used U2000 Series Programming Guide...
MEAS? :AVER[1] :FREQ :POW :SPEed READ? :CORR:CFAC :POW:AC:RANG FETC? :CORR:CSET :CORR:GAIN2 :POW:AC:RANG:AUTO CONF :DET:FUNC TRIGger Figure 1-5 How Measurement are Calculated The MEASure commands in this figure can be replaced with the FETCh? and READ? commands. U2000 Series Programming Guide...
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. U2000 Series Programming Guide...
It remains set until the event register is cleared; either when you read the register or when you send the *CLS (clear status) command. Event registers are read- only. U2000 Series Programming Guide...
A small binary table shows the state of the chosen bit in each status register at the selected times T1 to T5. 0 0 0 0 0 0 Condition marks when event register is read Figure 1-7 Typical Status Register Bit Changes U2000 Series Programming Guide...
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. U2000 Series Programming Guide...
Power Sensor Remote Operation Device Status Error/Event Queue Condition Event Enable Questionable Status Condition Event Enable Status Byte Output Queue RQS/MSS *STB? *SRE Standard Event Event Enable *ESR *ESE Operation Status Condition Event Enable Figure 1-8 Status System U2000 Series Programming Guide...
“enabled” in enable register). 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. U2000 Series Programming Guide...
A query error occurred, refer to error numbers 410 to 440 in the “Error Message List” in Chapter SYSTem Subsystem. Device Error A device error occurred, refer to error numbers 310 to 350 in the “Error Message List” in Chapter SYSTem Subsystem. U2000 Series Programming Guide...
Page 61
You must write a value using the STATus:QUEStionable:ENABle command to set the enable register mask. The questionable status model is shown in the pullout at the end of this chapter. The following bits in these registers are used by the power sensor. U2000 Series Programming Guide...
This is a summary bit for the Questionable POWer Register. Summary • SET: Error –230, “Data corrupt or stale” • CLEARED: When no errors are detected by the power sensor during a measurement covering the causes given for it to set. U2000 Series Programming Guide...
Table 1-7 Bit Definitions - Operation Status Bit Number Decimal Definition Weight CALibrating Summary 1 - 3 Not used MEASuring Summary Waiting for TRIGger Summary 6 - 9 Not used 1024 SENSe Summary 2048 Lower Limit Fail Summary U2000 Series Programming Guide...
This is a summary bit for the Lower Limit Fail Register. Fail • SET: If a measurement is made and lower limit test fails. • CLEARED: If a measurement is made and the lower limit test is not enabled or the test is enabled and passes. U2000 Series Programming Guide...
Table 1-9 Bit Definitions - Device Status Register Decimal Definition Number Weight Not used Not used Not used Power sensor error Not used Not used Not used 16384 Not used The condition bits are set and cleared under the following conditions: U2000 Series Programming Guide...
Table 1-10 Bit change conditions for Device Status Register Meaning EVENts Causing Bit Changes Number Power sensor • SET: If the power sensor non-volatile memory has failed or error other hardwares have failed. • CLEARED: In every other condition. U2000 Series Programming Guide...
• Send the *STB? (status byte query) command to poll the register. This command does not clear the status byte summary register. Examples This example program uses the *OPC? command to determine when the power sensor has finished calibrating. CAL:AUTO ONCE *OPC? MEAS:POW:AC? U2000 Series Programming Guide...
How to Save and Recall a Configuration Power sensor configurations are saved and recalled with the following commands: *SAV <NRf> *RCL <NRf> The range of values for <NRf> in the above commands is 1 to 10. U2000 Series Programming Guide...
• The power sensor’s input and output buffers are cleared. • The power sensor is prepared to accept a new command string. For interfaces the that do not support a low-level device clear, use the ABORt command. N O T E U2000 Series Programming Guide...
When a colon is the first character of a command keyword, it indicates that the next command mnemonic is a root- level command. When a colon is inserted between two command mnemonics, the colon moves the path down one level U2000 Series Programming Guide...
Only query commands (commands that end with a “?”) instruct the instrument to send a response message. Queries return either measured values or internal instrument settings. U2000 Series Programming Guide...
• Bars (|) can be read as “or” and are used to separate alternative parameter options. Syntax Diagram Conventions • Solid lines represent the recommended path. • Ovals enclose command mnemonics. The command mnemonic must be entered exactly as shown. U2000 Series Programming Guide...
Throughout this document <character_data> 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: <upper-case alpha> <upper-case alpha> <digit> Figure 1-10 Format of <character_data> U2000 Series Programming Guide...
Page 74
Throughout this document <non-decimal numeric> 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 examples, #HA2F, #ha4e, #Q62, #q15, #B01011. U2000 Series Programming Guide...
Figure 1-11 Format of <non-decimal numeric> Refer to section 7.7.4.1 of IEEE 488.2 for further details. <NRf> Definition Throughout this document <NRf> is used to denote a flexible numeric representation. For example: +200; –56; +9.9E36. Refer to section 7.7.2.1 of U2000 Series Programming Guide...
<NR2> Definition Throughout this document <NR2> numeric response data is defined as: digit digit Figure 1-13 Format of <NR2> For example: • 12.3 • +1.2345 • –0.123 Refer to section 8.7.3 of IEEE 488.2 for further details. U2000 Series Programming Guide...
Throughout this document the decimal numeric element is abbreviated to <numeric_value>. For example, <NRf>, MINimum, MAXimum, DEFault or Not A Number (NAN). <string> Definition Throughout this document <string> is used to represent 7- bit ASCII characters. U2000 Series Programming Guide...
The format is defined as: Program Data <inserted > <non-single quote char> " " <inserted > " " <non-double quote char> Response Data " " <inserted > " " <non-double quote char> Figure 1-15 Format of <string> U2000 Series Programming Guide...
<newline> character. A <carriage return> followed by a <newline> is also accepted. Many programming languages allow you to specify a message terminator character or EOI state to be automatically sent with each bus transaction. Message termination always sets the current path back to the root- level. U2000 Series Programming Guide...
1999.0 version of the SCPI standard. However, these commands are designed with the SCPI format in mind and they follow all of the syntax rules of the standard. MEMory:CLEar[:NAME] MEMory:TABLe:SELect MEMory:STATe:DEFine MEMory:TABLe:GAIN[:MAGNitude] MEMory:TABLe:GAIN:POINts? MEMory:TABLe:MOVE [SENSe[1]]:AVERage:SDETect [SENSe[1]]:CORRection:FDOFfset [SENSe[1]]:MRATe [SENSe[1]]:POWer:AC:RANGe SERVice:SENSor[1]:CDATE? SERVice:SENSor[1]:CPLace? SERVice:SENSor[1]:SNUMber? SERVice:SENSor[1]:TYPE? U2000 Series Programming Guide...
For detail of each SCPI (Standard Commands for Programmable Instruments) command available to program the power sensor, refer to later chapters for more details on each command. All the commands listed also have queries unless otherwise stated in the “Notes” column. U2000 Series Programming Guide...
Page 82
Power Sensor Remote Operation U2000 Series Programming Guide...
Page 83
Agilent U2000 Series USB Power Sensors Programming Guide MEASurement Commands MEASurement Commands CONFigure[1]? CONFigure [1] Commands CONFigure[1][:SCALar][:POWer:AC] [<expected_value>[,<resolution>[,<source list>]]] FETCh[1]? FETCh[1][:SCALar][:POWer:AC]? [<expected_value>[,<resolution>[,<source list>]]] READ[1] Commands READ[1][:SCALar][:POWer:AC]? [<expected_value>[,<resolution>[,<source list>]]] MEASure[1] Commands MEASure[1][:SCALar][:POWer:AC]? [<expected_value>[,<resolution>[,<source list>]]] This chapter explains how to use the MEASure group of instructions to acquire data using a set of high level instructions.
11, “TRIGger Subsystem,” on page 261. The CONFigure, FETCh?, READ? and MEASure? commands all have a numeric suffix which refers to a specific window/measurement. Figure 2- 1 shown an example of the configuration returned result windows. U2000 Series Programming Guide...
If you are making a ratio or difference measurement the <resolution> parameters are applied to both. Source List The <source list> parameter is used to define: • What channels the measurements will be made on, for a dual U2000 Series Programming Guide...
The configuration is returned as a quoted string in the following format: “<function> <expected_value>,<resolution>,<source list>” <expected_value> returns the expected value sent by the last CONFigure command or +20 dBm by default. Example CONF1? This command queries the configuration of the current window/measurement. U2000 Series Programming Guide...
• 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 U2000 Series USB power sensors is set to (@1). U2000 Series Programming Guide...
When TRIG:SOUR is set to BUS or HOLD, sets the power sensor to make the measurement immediately a trigger is received. TRIGger:DELay:AUTO ON Enables automatic delay before making the measurement. [SENSe[1]]:AVERage:COUNt:AUTO Enables automatic filter length selection. [SENSe[1]]:AVERage:STATe ON Enables averaging. U2000 Series Programming Guide...
The units of measurement are dBm and W. The default units are defined by UNIT:POWer. resolution A numeric value for the resolution. If 1 to 4 unspecified the current resolution setting is 1.0, 0.1, 0.01, 0.001 used. U2000 Series Programming Guide...
Page 91
When the measurement result is logarithmic 1 to 4 represents of 1, 0.1, 0.01 and 0.001 respectively. Example CONF1:POW:AC DEF,2,(@1) This command configures the current window/measurement to measure the power of the sensor, using the current sensor range and a resolution setting of 2. U2000 Series Programming Guide...
- when the trigger level differs greatly from the signal level for example - this can give the impression that the power sensor has hung. To unlock the power sensor and adjust trigger settings, an execute clear (*CLS) must be performed. U2000 Series Programming Guide...
DEF or a numeric value. If a value is (for the expected power level) entered it should correspond to that set by CONFigure otherwise an error occurs. The units of measurement are dBm and W. The default units are defined by UNIT:POWer. U2000 Series Programming Guide...
• If the expected_value and resolution parameters are not the same as the current expected value and resolution setting on the current window, error –221, “Settings conflict” occurs. U2000 Series Programming Guide...
The format of the result is set by FORM[:READ][:DATA]. Refer to Chapter 5, “FORMat Subsystem,” on page 119 for further information. • The READ? query is equivalent to: ABORt INITiate FETCh? ABORt1 INITiate1 FETCh1? U2000 Series Programming Guide...
The expected power level parameter can be 60 dBm to +20 dBm set to DEF or a numeric value. If a value is (for the expected power level) entered it should correspond to that set by CONFigure otherwise an error occurs. U2000 Series Programming Guide...
Page 97
• If TRIGger:SOURce is set to BUS or HOLD, error –214, “Trigger deadlock” occurs. • If the expected value and resolution parameters are not the same as the current expected value and resolution settings on the current window, error –221, “Settings conflict” occurs. U2000 Series Programming Guide...
The format of the result is set by FORM[:READ][:DATA]. Refer to Chapter 5, “FORMat Subsystem,” on page 119 for further information. MEASure? is a compound command which is equivalent to: • The MEASure? query is equivalent to: ABORt CONFigure READ? ABORt1 CONFigure1 READ1? U2000 Series Programming Guide...
The units of measurement are dBm and W. power level) The default units are defined by UNIT:POWer. resolution A numeric value for the resolution. If 1 to 4 unspecified the current resolution setting is 1.0, 0.1, 0.01, 0.001 used. U2000 Series Programming Guide...
Page 100
When the measurement result is logarithmic 1 to 4 represents of 1, 0.1, 0.01 and 0.001 respectively. Example MEAS1:POW:AC? This command queries the current -70DBM,1,(@1) window/measurement of the sensor, using an expected power level of - 70 dBm and a resolution setting of 1. U2000 Series Programming Guide...
Page 101
Agilent U2000 Series USB Power Sensors Programming Guide CALCulate Subsystem CALCulate Subsystem CALCulate[1]:FEED[1]<string> CALCulate[1]:LIMit Commands CALCulate[1]:LIMit:CLEar:AUTo <boolean>|ONCE CALCulate[1]:LIMit:CLEar[:IMMediate] CALCulate[1]:LIMit:FAIL? CALCulate[1]:LIMit:FCOunt? CALCulate[1]:LIMit:LOWer[:DATA] <numeric_value> CALCulate[1]:LIMit:UPPer[:DATA] <numeric_value> CALCulate[1]:LIMit:STATe <boolean> CALCulate[1]:MATH Commands CALCulate[1]:MATH[:EXPRession] <string> CALCulate[1]:MATH[:EXPRession]:CATalog? This chapter explains how the CALCulate subsystem is used to perform post acquisition data processing.
CALC:MATH:EXPR command has been used to specify which measurement the feed is taken from. Under certain circumstances the measurement mode is changed by the CALC:MATH:EXPR command. Refer to “CALCulate[1]:MATH[:EXPRession] <string>” on page 104 for further information. Syntax Space string :FEED U2000 Series Programming Guide...
Page 105
1. The measurement from which the feed is taken is determined by CALC:MATH:EXPR.. Reset Condition On reset, the feed is set to :POW:AVER. Query CALCulate[1]:FEED[1]? The query returns the current value of the string. U2000 Series Programming Guide...
CALCulate Subsystem Query Example CALC1:FEED1? This command queries the current setting of the CALC block on FEED1 of the current window/measurement. U2000 Series Programming Guide...
• Set upper and lower level limits • Query if there has been a failure • Count the number of failures • Clear the counter The following commands are detailed in this section: CALCulate[1]:LIMit:CLEar:AUTo <boolean> CALCulate[1]:LIMit:CLEar[IMMediate] CALCulate[1]:LIMit:FAIL? CALCulate[1]:LIMit:FCOunt? CALCulate[1]:LIMit:LOWer[:DATA] CALCulate[1]:LIMit:UPPer[:DATA] CALCulate[1]:LIMit:STATe <boolean> U2000 Series Programming Guide...
SyntaxExample Space 0|OFF CALC :CLE :AUTO :LIM 1|ON ONCE CALC1:LIM:CLE:AUTO 1 This command switches on automatic clearing of the FCO for the current window/measurement. Reset Condition On reset, measurement is set to ON. U2000 Series Programming Guide...
Page 109
In the case where limit failures are cleared once, when a query occurs a 1 is entered into the output buffer if no measurement is initiated. If a measurement is initiated then 0 is entered. Query Example CALC1:LIM:CLE:AUTO? This command queries when the FCO is cleared for the current window/measurement. U2000 Series Programming Guide...
This command immediately clears the FCO (fail counter) of any limit failures for the current window. The FCO is used to determine the results returned by the CALCulate[1]:LIMit:FAIL? query. Syntax :IMM :LIM :CLE CALC Example CALC1:LIM:CLE:IMM This command clears the FCO for the current window/measurement. U2000 Series Programming Guide...
• 0 is returned when no limit failures have occurred Syntax CALC :LIM :FAIL Example CALC1:LIM:FAIL? This command queries if there have been any limit failures on the current window/measurement. Reset Condition On reset, the buffer is set to zero for the current window measurements. U2000 Series Programming Guide...
• measured using MEASure? • read using READ? • initiated using: INITiate[:IMMediate] or, • • INITiate:CONTinuous ON The maximum number of errors is 2 –1. If more than 2 –1 errors are detected the counter returns to zero. U2000 Series Programming Guide...
Page 113
CALCulate Subsystem Syntax :LIM :FCO CALC Example CALC1:LIM:FCO? This command queries the number of limit failures on the current window/measurement. Reset Condition On reset, the counter is set to zero for the current window/measurement. U2000 Series Programming Guide...
A numeric value for the lower test limit: –150 to +230 dBm or –180 to +200 dB DEF: the default is –90.00 dBm or • –90 db MIN: –150 dBm or –180 dB • MAX: +230 dBm or +200 dB • U2000 Series Programming Guide...
Page 115
The query returns the current setting of the lower limit or the values associated with MIN and MAX for the current window. Query Example CALC1:LIM:LOW:DATA? This command queries the lower limit set for the current window /measurement. U2000 Series Programming Guide...
UNIT:POWer. When the measured power is greater than the value specified in CALCulate[1]:LIMit:UPPer[:DATA], CALCulate[1]:LIMit:FAIL? reports a fail. When the measured level is less than or equal to the limit, a fail is not reported. Syntax Space numeric_value :UPP :DATA :LIM CALC Space U2000 Series Programming Guide...
Page 117
= 5 dBm W = 5 W dB = 5 dB % = 5 % Reset Condition On reset, the measurement is set to +90.00 dBm or +90 dB. Query CALCulate[1]:LIMit:UPPer[:DATA]? [MIN|MAX] U2000 Series Programming Guide...
Page 118
CALC1:LIM:UPP:DATA? This command queries the setting of the upper limit for the current window/measurement. The query returns the current setting of the upper limit or the values associated with MIN and MAX for the current window/measurement. U2000 Series Programming Guide...
The query enters 1 or 0 into the output buffer indicating the status of the limits testing feature for the current window/measurement. • 1 is returned when limits testing is enabled • 0 is returned when limits testing is disabled U2000 Series Programming Guide...
Page 120
CALC1:LIM:STAT? This command queries whether the limit checking function for the current window/measurement is on or off. Error Message If CALCulate[1]:LIMit:STATe is set to ON while [SENSe[1]]:MRATe is set to FAST, error –221, “Settings Conflict” occurs. U2000 Series Programming Guide...
CALCulate Subsystem CALCulate[1]:MATH Commands These commands define and carry out the following mathematical transformations on SENSe data: • Single measurement The following commands are detailed in this section: CALCulate[1]:MATH[:EXPRession] <string> CALCulate[1]:MATH[:EXPRession]:CATalog? U2000 Series Programming Guide...
:MATH :EXPR CALC Parameters Item Description/Default Range of Values string A single string value detailing the measurement “(SENS1)” type: The default is SENS1. • Quotes are mandatory. Either single or double quotes may be used. U2000 Series Programming Guide...
Page 123
This command queries the current setting of the math expression on the current window/measurement. Error Messages • For single measurement, if <string> is not set to “(SENS1)” while [SENSe[1]]:MRATe is set to FAST, error –221, “Settings Conflict” occurs. U2000 Series Programming Guide...
This query lists all the defined expressions. The response is a list of comma separated strings. Each string contains an expression. • For single measurement the string is: “(SENS1)” Syntax :CAT :MATH :EXPR CALC Example CALC1:MATH:CAT? This command lists all the defined math expressions. U2000 Series Programming Guide...
Page 125
Agilent U2000 Series USB Power Sensors Programming Guide CALibration Subsystem CALibration Subsystem CALibration[1][:ALL] CALibration[1][:ALL]? CALibration[1]:AUTO [ONCE|ON|OFF|0|1] CALibration:ZERO:AUTO [ONCE|ON|OFF|0|1] CALibration[1]:ZERO:TYPE <EXTernal|INTernal> This chapter explains how the CALibration command subsystem is used to zero and calibrate the power sensor. Agilent Technologies...
1 Zeroing the power sensor (CALibration:ZERO:AUTO ONCE or CALibration:AUTO ONCE). Syntax :ALL Example CAL1:ALL This command causes the power sensor to perform a zeroing sequence. Error Messages • If zeroing was not carried out successfully the error –231, “Data Questionable; ZERO ERROR” occurs. U2000 Series Programming Guide...
If the result is: • 0, the zeroing has passed • 1, the zeroing has failed Syntax :ALL Query Example CAL1:ALL? This command causes the power sensor to perform a zeroing sequence and return a result. U2000 Series Programming Guide...
Page 129
CALibration Subsystem Error Messages • If zeroing was not carried out successfully the error –231, “Data Questionable; ZERO ERROR” occurs. U2000 Series Programming Guide...
The 0|OFF parameter is only required for the query response and is ignored in the command. This command performs the same function as CALibration:ZERO:AUTO N O T E [ONCE|ON|OFF|0|1]. Syntax Space 0|OFF :AUTO 1|ON ONCE Example CAL1:AUTO ONCE This command causes the power sensor to perform a zeroing. U2000 Series Programming Guide...
Page 131
On reset, automatic calibration is enabled. Query CALibration[1]:AUTO? The query always returns a value of 0 when the event is successful. Error Messages • If the zeroing was not carried out successfully the error –231, “Data Questionable; CAL ERROR” occurs. U2000 Series Programming Guide...
This command performs the same function as CALibration[1]:AUTO N O T E [ONCE|ON|OFF|0|1]. Syntax Space :AUTO :ZERO 0|OFF 1|OFF ONCE Example CAL1:ZERO:AUTO ONCE This command causes the power sensor to perform a zeroing routine. Reset Condition On reset, automatic zeroing is enabled. U2000 Series Programming Guide...
Page 133
CALibration Subsystem Query CALibration[1]:ZERO:AUTO? The query always returns a value of 0 when the event is successful. Error Messages • If zeroing was not carried out successfully the error –231, “Data Questionable; ZERO ERROR” occurs. U2000 Series Programming Guide...
This command is used to configure the power sensor either for enternal zeroing or internal zeroing. Syntax :TYPE :ZERO Space Example CAL:ZERO:TYPE EXT This command changes the type of zeroing to external. Reset Condition On reset, the zeroing type will not be affected. U2000 Series Programming Guide...
Page 135
This command queries the type of zeroing for the sensor . Error Messages • This command is able to configure zeroing type to “EXT” and “INT” only. The error –231, “Invalid character type” occurs for any other values. U2000 Series Programming Guide...
Page 136
CALibration Subsystem U2000 Series Programming Guide...
Page 137
Agilent U2000 Series USB Power Sensors Programming Guide FORMat Subsystem FORMat Subsystem FORMat[:READings]:BORDer <character_data> FORMat[:READings][:DATA] <character_data> This chapter explains how the FORMat subsystem is used to set a data format for transferring numeric information. Agilent Technologies...
Page 138
This data format is used only for response data by commands that are affected by the FORMat subsystem. The queries affected are: • FETCh? • READ? • MEASure? Keyword Parameter Form Notes Page FORMat [:READings] :BORDer <character_data> page 121 [:DATA] <character_data> page 123 U2000 Series Programming Guide...
Range of Values NORMal character_data Byte order of binary data transfer: SWAPped NORMal • SWAPped • Example FORM:BORD SWAP This command sets the byte order to swapped. Reset Condition On reset, this value is set to NORMal. U2000 Series Programming Guide...
Page 140
FORMat Subsystem Query FORMat[:READings]:BORDer? The query returns the current setting of the byte order. The format of the response is NORMalor SWAPped.. Query Example FORM:BORD? This command queries the current byte order setting. U2000 Series Programming Guide...
FORMat data formatting is not affected by TRACe subsystem data formatting. N O T E Syntax character_data Space :READ :DATA FORM Parameters Item Description/Default Range of Values ASCii character_data Data format for transferring data: REAL • ASCii • REAL U2000 Series Programming Guide...
Page 142
This command sets the format to REAL. Reset Condition On reset, the format is set to ASCii. Query FORMat[:READings][:DATA]? The query returns the current setting of format: either ASCii or REAL. Query Example FORM? This command queries the current format setting. U2000 Series Programming Guide...
MEMory:CATalog Commands These commands are used to query information on the current contents of a power sensor’s: • Frequency dependent offset tables • Save/recall registers The following commands are detailed in this section: MEMory:CATalog[:ALL]? MEMory:CATalog:STATe? MEMory:CATalog:TABLe? U2000 Series Programming Guide...
A sample of a response may look like the following: 1178,26230,"DEFAULT,TABL,14","TABLE1,TABL,116", "TABLE2,TABL,74",..."State0,STAT,1619", "State1,STAT,1619","State2,STAT,1619" ... There are also ten frequency dependent offset tables named CUSTOM_A through CUSTOM_J which do not contain any data when the power sensor is shipped from the factory. U2000 Series Programming Guide...
Page 148
MEMory Subsystem Syntax :CAT :ALL Example MEM:CAT? This command queries the list of tables and save/recall registers. U2000 Series Programming Guide...
<size> indicates the size of the save/recall register in bytes. • For example, a sample of a response may look like: 0,16190,"State0,STAT,0","State1,STAT,0" ..Syntax :CAT :STAT Example MEM:CAT:STAT? This command queries the list of save/recall registers. U2000 Series Programming Guide...
For example, a sample of a response may look like: 1178,10040,"DEFAULT,TABL,14","TABLE1,TABL,116", "TABLE2,TABL,74","TABLE3,TABL,62"... There are also ten frequency dependent offset tables named CUSTOM_A through CUSTOM_J which do not contain any data when the power sensor is shipped from the factory. U2000 Series Programming Guide...
Page 151
MEMory Subsystem Syntax :CAT :TABL Example MEM:CAT:TABL? This command queries the list of stored tables. U2000 Series Programming Guide...
This subsystem removes the data contents but does not affect the name of the associated table or save/recall register. The following commands are detailed in this section: MEMory:CLEar:[NAME] <character_data> MEMory:CLEar:TABLe The contents cleared using these commands are non-recoverable. N O T E U2000 Series Programming Guide...
For frequency dependent offset tables, this command is an alternative form of the MEMory:CLEar:TABLE command, the only difference being the method in which the table is selected. The contents cleared using this command are non-recoverable. N O T E U2000 Series Programming Guide...
Page 154
Example MEM:CLE "TABLE5" This command clears the contents of frequency dependent offset table, TABLE5. Error Messages If the table or save/recall register name does not exist, error –224, “Illegal parameter value” occurs. U2000 Series Programming Guide...
The contents cleared using this command are non-recoverable. N O T E Syntax :CLE :TABL Example MEM:CLE:TABL This command clears the contents of the currently selected table. Error Message If no table is selected, error –221, “Settings conflict” occurs. U2000 Series Programming Guide...
MEMory:FREE Commands These commands are used to return information on the amount of free memory space available for frequency dependent offset tables and save/recall registers. The following commands are described in this section: MEMory:FREE[:ALL]? MEMory:FREE:STATe? MEMory:FREE:TABLe? U2000 Series Programming Guide...
This query returns the amount of memory free for frequency dependent offset tables, and save/recall registers. The format of the response is: <bytes_available>,<bytes_in_use> Syntax :FREE :ALL Example MEM:FREE? This command queries the amount of free memory in total. U2000 Series Programming Guide...
MEMory Subsystem MEMory:FREE:STATe? This query returns the amount of memory free for save/recall registers. The format of the response is: <bytes_available>,<bytes_in_use> Syntax :FREE :STAT Example MEM:FREE:STAT? This command queries the amount of free memory for save/recall registers. U2000 Series Programming Guide...
MEMory:FREE:TABLe? This query returns the amount of memory free for frequency dependent offset tables. The format of the response is: <bytes_available>,<bytes_in_use> Syntax :FREE :TABL Example MEM:FREE:TABL? This command queries the amount of free memory for tables. U2000 Series Programming Guide...
This query returns the number of registers that are available for save/recall. As there are ten registers this query always returns ten. Syntax :NST Example MEM:NST? This command queries the number of registers available for save/recall. U2000 Series Programming Guide...
MEMory Subsystem MEMory:STATe Commands These commands are used to query and define register names. The following commands are described in this section: MEMory:STATe:CATalog? MEMory:STATe:DEFine U2000 Series Programming Guide...
MEMory Subsystem 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: <string>,<string>,..,<string> Syntax :STAT :CAT Example MEM:STAT:CAT? This command queries the register names. U2000 Series Programming Guide...
_ (underscore) numeric_value A numeric value (<NRf>) for the register 0 to 9 number. Example MEM:STAT:DEF "SETUP1",4 This command names register 4 SETUP1. Query MEMory:STATe:DEFine? <string> The query returns the register number for the given register name. U2000 Series Programming Guide...
Page 164
• 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 with the same name already exists, error –257, “File name error” occurs (command only). U2000 Series Programming Guide...
These commands are used to define a frequency dependent offset table, and to write to and read data from it. The following commands are described in this section: MEMory:TABLe:FREQuency <numeric_value>{,<numeric_value>} MEMory:TABLe:FREQuency:POINts? MEMory:TABLe:GAIN[:MAGNitude] <numeric_value>{,<numeric_value>} MEMory:TABLe:GAIN[:MAGNitude]:POINts? MEMory:TABLe:MOVE <character_data>,<character_data> MEMory:TABLe:SELect <character_data> U2000 Series Programming Guide...
Depending on available memory, the power sensor is capable of storing 10 frequency dependent offset tables, each containing 80 points. U2000 Series Programming Guide...
Page 167
A numeric value for the frequency. The 1 kHz to 1000.0 GHz default units are Hz. The following measurement units can be used: kHz (10 MHz (10 GHz (10 All frequencies are truncated to a multiple of 1 kHz. U2000 Series Programming Guide...
Page 168
–221, “Settings conflict” occurs. • If a frequency is set which is outside of the allowed frequency range, error –222, “Data out of range” occurs. U2000 Series Programming Guide...
The response format is <NRf>. If no frequency values have been set, this command returns 0. If no table is selected, this command returns NAN. Syntax :TABL :POIN :FREQ Example MEM:TABL:FREQ:POIN? This command queries the number of frequency points in the current table. U2000 Series Programming Guide...
Entries in the frequency lists correspond as shown in Table 6- 2 with entries in the offset factor lists. Table 6-2 Frequency and Offset Factor List Frequency Offset Frequency 1 Offset 1 " " Frequency 80 Offset 80 U2000 Series Programming Guide...
Page 171
This command enters a reference offset MEM:TABL:GAIN 97,99.5,97.4 factor of 97 %, 99.5 % and 97.4 % into the sensor frequency dependent offset table. Query MEMory:TABLe:GAIN[:MAGNitude]? The query returns a list of offset points for the currently selected table. U2000 Series Programming Guide...
Page 172
• If a table is not specified using the MEMory:TABLe:SELect command, the data cannot be entered and error –221, “Settings conflict” occurs. • If any of the offset factors are outside of the allowed range, error –222, “Data out of range” occurs. U2000 Series Programming Guide...
If no values have been set, 0 is returned. If no table is selected, NAN is returned. Syntax :GAIN :TABL :MAGN :POIN Example MEM:TABL:GAIN:POIN? This command queries the number of offset points in the current table. U2000 Series Programming Guide...
(lowercase) 0 - 9 _ (underscore) Example MEM:TABL:MOVE This command renames a table named "tab1","tab1a" tab1 to tab1a. Error Messages • If either table name is invalid, error –224, “Illegal parameter value” occurs. U2000 Series Programming Guide...
Page 175
• If the first parameter does not match an existing table name, error –256, “File name not found” occurs. • If the second parameter matches an existing table name or save/recall register, error –257, “File name error” occurs. U2000 Series Programming Guide...
12 characters can be used. a to z (lowercase) 0 - 9 _ (underscore) Example MEM:TABL:SEL "Sensor1" This command selects a frequency dependent offset table named “Sensor1”. Query MEMory:TABLe:SELect? The query returns the name of the currently selected table. U2000 Series Programming Guide...
These commands control the measurement averaging which is used to improve measurement accuracy. They combine successive measurements to produce a new composite result. The following commands are detailed in this section: SENSe[1]:AVERage:COUNt <numeric_value> SENSe[1]:AVERage:COUNt:AUTO <boolean> SENSe[1]:AVERage:SDETect <boolean> SENSe[1]:AVERage[:STATe] <boolean> U2000 Series Programming Guide...
(SENSe[1]:AVERage:COUNt <numeric_value>) is useful in applications requiring either high resolution or fast settling times, where signal variations rather than measurement noise need filtering, or when approximate results are needed quickly. Syntax Space SENS :COUN numeric_value AVER Space U2000 Series Programming Guide...
Page 182
On reset, the filter length is set to four. Query AVERage:COUNt? [MIN|MAX] The query returns the current setting of the filter length or the values associated with MIN and MAX. The format of the response is <NR1>. U2000 Series Programming Guide...
Page 183
If a filter length value is entered using SENSe[1]:AVERage:COUNt while SENSe[1]:MRATe is set to FAST, the error –221, “Settings Conflict” occurs. However, the filter length value is set but the SENSe[1]:AVERage:STATe command is not automatically set ON. U2000 Series Programming Guide...
Figure 7-1 Example of Averaged Readings If SENSe[1]:AVERage:COUNt:AUTO is set to OFF, the filter length is set by the SENSe[1]:AVERage:COUNt command. Using the SENSe[1]:AVERage:COUNt command disables automatic averaging. Auto averaging is enabled by the MEASure:POWer:AC? and CONFigure:POWer:AC? commands. U2000 Series Programming Guide...
Page 185
Syntax Space SENS :COUN :AUTO AVER 0|OFF 1|ON ONCE Example AVER:COUN:AUTO OFF This command disables automatic filter length selection for power sensor. Reset Condition On reset, automatic averaging is enabled. U2000 Series Programming Guide...
Page 186
Error Messages If SENSe[1]:AVERage:COUNt:AUTO is set to ON while SENSe[1]:MRATe is set to FAST, the error –221, “Settings Conflict” occurs. However, automatic averaging is enabled but the SENSe[1]:AVERage:STATe command is not automatically set ON. U2000 Series Programming Guide...
ON). With certain pulsing signals step detect may operate on the pulses, preventing the final N O T E average being completed and making the results unstable. Under these conditions SDET should be set to OFF. U2000 Series Programming Guide...
Page 188
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. U2000 Series Programming Guide...
On reset, averaging is OFF. Query SENSe[1]:AVERage[:STATe]? The query enters a 1 or 0 into the output buffer indicating the status of averaging. • 1 is returned when averaging is enabled • 0 is returned when averaging is disabled U2000 Series Programming Guide...
Page 190
SENSe Subsystem Query Example SENS:AVER? This command queries whether averaging is on or off for power sensor. Error Messages If SENSe[1]:AVERage:STATe is set to ON while SENSe[1]: is set to 200, the error –221, “Settings Conflict” occurs. U2000 Series Programming Guide...
SENSe Subsystem SENSe[1]:CORRection:CSET[2]Commands These commands are used to select the active sensor frequency dependent offset table. The following commands are detailed in this section: SENSe[1]:CORRection:CSET[2][:SELect] <string> SENSe[1]:CORRection:CSET[2]:STATe <boolean> U2000 Series Programming Guide...
Syntax string SENS CORR :CSET2 Space :SEL Parameters Item Description/Default Range of Values string String data representing a sensor Any existing table name frequency dependent offset table name. (Existing table names can be listed using MEMory:CATalog:TABle?). U2000 Series Programming Guide...
Page 193
When a frequency dependent offset table is selected, the power sensorpower sensor verifies that the number of offset points defined is equal to the number of frequency points defined. If this is not the case, error –226, “Lists not the same length” occurs. U2000 Series Programming Guide...
Reset Condition On reset, the sensor frequency dependent offset table are not affected. Query SENSe[1]:CORRection:CSET[2]:STATe? The query returns a 1 or 0 into the output buffer indicating whether a table is U2000 Series Programming Guide...
Page 195
Error Messages If you attempt to set this command to ON and no table has been selected using SENSe[1]:CORRection:CSET[2]:[SELect] then error –221, “Settings conflict” occurs and SENSe[1]:CORRection:CSET[2]:STATe remains OFF. U2000 Series Programming Guide...
Entering a value using this command automatically turns the [SENSe[1]]:CORRection:DCYCle|GAIN3:STATe command to ON. Syntax SENS :INP CORR :DCYC :MAGN :GAIN3 Space numeric_value Space U2000 Series Programming Guide...
Page 197
This command sets a duty cycle of 90%. Reset Condition On reset, the duty cycle is set to 1% (DEF). Query [SENSe[1]]:CORRection:DCYCle|GAIN3[:INPut][:MAGNitude]? [MIN|MAX] The query returns the current setting of the duty cycle or the values associated with MIN and MAX. U2000 Series Programming Guide...
Page 198
• If a duty cycle value is entered using [SENSe[1]]:CORRection:DCYCle:GAIN3 while [SENSe[1]]:CORRection:SPEed is set to 200, the error –221, “Settings Conflict” occurs. However, the duty cycle value is set but the [SENSe[1]]:CORRection:DCYCle:GAIN3:STATe command is nto automatically set ON. U2000 Series Programming Guide...
This command enables the pulse measurement feature. Reset Condition On reset, the pulse power measurement feature is disabled. Query [SENSe[1]]:CORRection:DCYCle|GAIN3:STATe? The query enters a 1 or 0 into the output buffer indicating the status of the pulse power measurement feature. U2000 Series Programming Guide...
Page 200
Query Example This command queries whether the pulse CORR:GAIN3:STAT? measurement feature is on or off. Error Messages • If [SENSe[1]]:CORRection:DCYCle:STATus is set to ON while [SENSe[1]]:SPEed is set to 200, the error –221, “Settings Conflict” occurs. U2000 Series Programming Guide...
This command is used to return the frequency dependent offset currently being applied. Syntax SENS :GAIN4 CORR :INP :MAG :FDOFfset Example CORR:GAIN4? This command queries the current frequency dependent offset being applied to current measurement. Reset Condition On reset, the frequency dependent offset is not affected. U2000 Series Programming Guide...
SENSe Subsystem [SENSe[1]]:CORRection:GAIN2 Commands These commands provide a simple correction to a measurement for an external gain/loss. The following commands are detailed in this section: [SENSe[1]]:CORRection:GAIN2:STATe <boolean> [SENSe[1]]:CORRection:GAIN2[:INPut][:MAGNitude] <numeric_value> U2000 Series Programming Guide...
The query enters 1 or 0 into the output buffer indicating the status of the channel offsets. • 1 is returned if a channel offset is enabled • 0 is returned if a channel offset is disabled U2000 Series Programming Guide...
Page 204
SENSe Subsystem Query Example CORR:GAIN2:STAT? This command queries whether or not there is a channel offset applied. Error Messages If [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe is set to ON while [SENSe[1]]|SENSe2: is set to 200, the error –221, “Settings Conflict” occurs. U2000 Series Programming Guide...
The power sensor then corrects every measurement by this factor to compensate for the gain/loss. Entering a value for GAIN2 using this command automatically turns the [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe command to ON. Syntax SENS :INP CORR :GAIN2 :MAGN SENS2 Space numeric_value Space U2000 Series Programming Guide...
Page 206
This command sets a channel offset of 50 dB. Reset Condition On reset, GAIN2 is set to 0.00 dB. Query [SENSe[1]]|SENSe2:CORRection:GAIN2[:INPut][:MAGNitude]? [MIN|MAX] The query returns the current setting of the channel offset or the values associated with MIN and MAX. U2000 Series Programming Guide...
Page 207
• If a loss/gain correction value is entered using [SENSe[1]]|SENSe2:CORRection:GAIN2[:INPut][:MAGNitude] while [SENSe[1]]|SENSe2: is set to 200, the error –221, “Settings Conflict” occurs. However, the correction value is set but the [SENSe[1]]|SENSe2:CORRection:GAIN2:STATe command is not automatically set ON. U2000 Series Programming Guide...
SENSe Subsystem SENSe[1]:DETector:FUNCtion <character_data> This command sets the measurement mode for U2000 Series USB power sensors. Syntax Space SENS FUNC character_data Parameters Item Description/Default Range of Values character_data Defines the measurement mode: AVERage AVERage: sets the sensor to average •...
Page 209
This command sets the sensor to Average mode. Reset Condition On reset, the mode is set to AVERage. Query SENSe[1]:DETector:FUNCtion? The query returns the current sensor mode setting. Query Example SENS:DET:FUNC? This command queries the current sensor mode setting. U2000 Series Programming Guide...
This command is used to enter a frequency. The appropriate frequency dependent offset corrections are applied for the frequency selected, dependant on the frequency dependent offset data stored in the sensor’s non- volatile memory. Syntax Space numeric_value SENS FREQ :FIX Space U2000 Series Programming Guide...
Page 211
The following measurement units can be used: • Hz • kHz (10 • MHz (10 • GHz (10 Example FREQ 500kHz This command enters a sesnor frequency of 500 kHz. Reset Condition On reset, the frequency is set to 50 MHz (DEF). U2000 Series Programming Guide...
Page 212
SENSe[1]: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. Query Example SENS1:FREQ? This command queries the sensor frequency setting. U2000 Series Programming Guide...
“(SENSe1)” This change only occurs on the measurement specified in the SENSe:MRATe command. When the sensor is changed from FAST to NORMal or DOUBle, the settings that were in place when FAST was entered are restored. U2000 Series Programming Guide...
Page 214
The default is NORMal. When a channel is set to NORMal or DOUBle, TRIG:COUNt is set automatically to 1. Example MRAT DOUBle This command sets the sensor to 40 readings/second. Reset Condition On reset, the is set to NORMal. U2000 Series Programming Guide...
Page 215
The query returns the current setting, either NORMal, DOUBle or FAST. Query Example MRAT? This command queries the current sensor setting. Error Messages • If <character_data> is not set to NORMal, DOUBle or FAST, error –224 “Illegal parameter value” occurs. U2000 Series Programming Guide...
This command sets the power sensor to it’s lower range. Reset Condition On reset, the upper range is selected. Query SENSe[1]:POWer:AC:RANGe? The query enters a 1 or 0 into the output buffer indicating the status of the power sensor’s range. U2000 Series Programming Guide...
Page 217
Error Messages This command is used with the U2000 Series USB power sensors. If one is not connected the error –241, “Hardware missing” occurs. For U2000 Series USB power sensors, the auto ranging feature will be disabled when N O T E trigger modes are selected.
SENSe[1]:POWer:AC:RANGe:AUTO is ON. If the power sensor is not making measurements then autoranging only occurs when the power sensor is triggered. For U2000 Series USB power sensors, only HIGH and LOW ranges are available in Triggered N O T E modes.
Page 219
This command queries whether auto ranging is on or off. Error Messages • If this command is set to ON when U2000 Series USB Power Sensor is in Triggered modes, the error - 221, “Setting conflicts” occurs. U2000 Series Programming Guide...
Example SENS1:TEMP? This command returns the current sensor temperature. Reset Condition On reset, this parameter is not affected. Error Messages • If a U2000 Series USB Power Sensor is not connected, error –241, “Hardware missing” occurs. U2000 Series Programming Guide...
Page 221
Agilent U2000 Series USB Power Sensors Programming Guide STATus Subsystem STATus Subsystem Status Register Set Commands Device Status Register Sets Operation Register Sets STATus:OPERation STATus:OPERation:CALibrating[:SUMMary] STATus:OPERation:LLFail[:SUMMary] STATus:OPERation:MEASuring[:SUMMary] STATus:OPERation:SENSe[:SUMMary] STATus:OPERation:TRIGger[:SUMMary] STATus:OPERation:ULFail[:SUMMary] STATus:PRESet Questionable Register Sets STATus:QUEStionable STATus:QUEStionable:CALibration[:SUMMary] STATus:QUEStionable:POWer[:SUMMary] This chapter explains how the STATus command subsystem enables you to examine the status of the power sensor by monitoring the “Device Status...
The contents of the status registers are examined using the following status register set commands: :CONDition? :ENABle <NRf>|<non-decimal numeric> [:EVENt?] :NTRansition <NRf>|<non-decimal numeric> :PTRansition <NRf>|<non-decimal numeric> Each of these can be used to examine any of the following eleven status registers: U2000 Series Programming Guide...
Page 223
• To use the :CONDition? command to examine the STATus:DEVice register: STATus:DEVice:CONDition? • To use the :NTRansition command to examine the STATus:OPERation:SENSe[:SUMMary] register: STATus:OPERation:SENSe[:SUMMary]:NTRansition This chapter describes the status register set commands and the status registers which they are used to examine. U2000 Series Programming Guide...
Condition Register of the SCPI Register Set you require to control. The format of the return is <NR1> in the range of 0 to 32767 (2 –1). The contents of the Condition Register remain unchanged after it is read. Syntax :COND U2000 Series Programming Guide...
Page 225
The parameter value, when rounded to an integer and expressed in base 2 has its first 15 bits written into the Enable Register of the SCPI Register Set concerned. The last bit (bit 15) is always set to 0. Syntax space :ENAB non-decimal numeric U2000 Series Programming Guide...
Page 226
The parameter value, when rounded to an integer and expressed in base 2 has its 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. U2000 Series Programming Guide...
Page 227
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. U2000 Series Programming Guide...
Page 228
The query returns a 15 bit decimal- weighted number representing the contents of the Positive Transition Register of the SCPI register set being queried. The format of the return is <NR1> in the range of 0 to 32767 (2 –1). U2000 Series Programming Guide...
16384 Not used Bit 15 always 0 The power sensor error bits (3) are set to: • 1, if the U2000 Series USB power sensor’s non- volatile memory has failed. • 0, for every other condition. U2000 Series Programming Guide...
The following command descriptions detail the SCPI register you require to control but do not detail the Register Set commands. The seven Operation Register Sets are: STATUS:OPERation STATus:OPERation:CALibrating[:SUMMary] STATus:OPERation:LLFail[:SUMMary] STATus:OPERation:MEASuring[:SUMMary] STATus:OPERation:SENSe[:SUMMary] STATus:OPERation:TRIGger[:SUMMary] STATus:OPERation:ULFail[:SUMMary] Further information on these register sets is provided on the following pages. U2000 Series Programming Guide...
MEASuring Summary Waiting for TRIGger Summary 6 - 9 Not used 1024 SENSe Summary 2048 Lower Limit Fail Summary 4096 Upper Limit Fail Summary 13 to 15 Not used (bit 15 always 0) Syntax :OPER STAT U2000 Series Programming Guide...
ONCE) and at the beginning of calibration (CALibration:AUTO ONCE). Also for the compound command/query CALibration[:ALL]?, this bit is set at the beginning of the calibration sequence. These bits are cleared at the end of zeroing or calibration. Syntax :SUMM :OPER :CAL STAT U2000 Series Programming Guide...
The appropriate bits are set if a channel lower limit test fails or a window lower limit test fails. These bits are cleared if a measurement is made and the test is enabled and passes. Syntax :LLF :SUMM STAT :OPER U2000 Series Programming Guide...
Not used Current window MEASuring Status Not used 3-15 Not used These bits are set when the power sensor is taking a measurement. These bits are cleared when the measurement is finished. Syntax :MEAS :SUMM STAT :OPER U2000 Series Programming Guide...
These bits are set when the power sensor is reading data from the power sensor non- volatile memory. These bits are cleared when the power sensor is not reading data from the power sensor non- volatile memory. Syntax :SENS :SUMM :OPER STAT U2000 Series Programming Guide...
The following bits in these registers are used by the power sensor: Bit Number Decimal Definition Weight Not used Current window TRIGger Status Not used 3-15 Not used Syntax :SUMM :OPER :TRIG STAT U2000 Series Programming Guide...
The appropriate bits are set if a channel upper limit test fails or a window upper limit test fails. These bits are cleared if a measurement is made and the test is enabled and passes. Syntax :ULF :SUMM STAT :OPER U2000 Series Programming Guide...
Bit 15 is always 0. Syntax STAT :PRES Register Filter/Enable PRESet Value OPERational ENABle all zeros all ones all zeros QUEStionable ENABle all zeros all ones all zeros All Others ENABle all ones all ones all zeros U2000 Series Programming Guide...
“Status Register Set Commands” on page 226. The following command descriptions detail the SCPI register you require to control but do not detail the register set commands. The three questionable register sets are: STATus:QUEStionable STATus:QUEStionable:CALibration[:SUMMary] STATus:QUEStionable:POWer[:SUMMary] U2000 Series Programming Guide...
Bit 3 is set by the logical OR outputs of the STATus:QUEStionable:POWer:SUMMary register set. Bit 8 is set by the logical OR outputs of the STATus:QUEStionable:CALibration:SUMMary register set. Bit 9 is set if power- on self- test fails, and cleared if it passes. Syntax STAT :QUES U2000 Series Programming Guide...
The following bits in these registers are used by the power sensor: Decimal Definition Number Weight Not used Summary of current window CALibration Not used 3-15 Not used Syntax :CAL :SUMM STAT :QUES U2000 Series Programming Guide...
• Error –231, “Data questionable;Input Overload” This bit is cleared when no errors or events are detected by the power sensor during a measurement covering the causes given for it to set. Syntax :POW :SUMM STAT :QUES U2000 Series Programming Guide...
Page 243
STATus Subsystem U2000 Series Programming Guide...
Page 244
STATus Subsystem U2000 Series Programming Guide...
Agilent U2000 Series USB Power Sensors Programming Guide SERVice Subsystem SERVice Subsystem SERVice:BIST:TRIGger:LEVel:STATe? SERVice:OPTion <character_data> SERVice:SENSor[1]:CDATe? SERVice:SENSor[1]:CDUEdate <“date”> SERVice:SENSor[1]:CPLace <“place”> SERVice:SENSor[1]:FREQuency:MAXimum? SERVice:SENSor[1]:FREQuency:MINimum? SERVice:SENSor[1]:POWer:AVERage:MAXimum? SERVice:SENSor[1]:POWer:USABle:MAXimum? SERVice:SENSor[1]:POWer:USABle:MINimum? SERVice:SENSor[1]:RADC? SERVice:SENSor[1]:SNUMber <“serial_number”> SERVice:SENSor[1]:TNUMber <“tracking_number”> SERVice:SENSor[1]:TYPE? SERVice:SNUMber <character_data> SERVice:VERSion:PROCessor <character_data> SERVice:VERSion:SYSTem <character_data> This chapter explains how the SERVice command subsystem is used to obtain and set information useful for servicing the power sensor.
This command queries trigger level. • 1 is returned when the external trigger- in is high. • 0 is returned when the external trigger- in is low. Syntax :STATe :BIST :TRIG :LEVel SERV Example SERV:BIST:TRIG:LEV:STAT? This command queries trigger level. U2000 Series Programming Guide...
0 - 9 _ (underscore) Example SERV:OPT “003” This command loads the power sensor memory with 003 indicating that the unit is a rear panel option. Query SERVice:OPTion? The query returns the current option string. U2000 Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:CDATe? This query returns the calibration date in U2000 Series USB power sensors. Calibration date information is stored in the sensor’s non- volatile memory. Syntax SERV :SENS :CDAT Example SERV:SENS1:CDATe? This query returns the calibration date of the U2000 Series USB Power Sensor.
U2000 Series USB Power Sensor as 21st September 2006. Query SERVice:SENSor[1]:CDUEdate? This query returns the calibration due date in U2000 Series USB power sensors. Calibration due date information is stored in the sensor’s non- volatile memory. Query Example...
U2000 Series USB power sensor as Agilent Penang. Query SERVice:SENSor[1]:CPLace? This query returns the calibration place in U2000 Series USB power sensors. Calibration place information is stored in the sensor’s non- volatile memory. Query example SERV:SENS1:CPL? This query returns the place of calibration of the U2000 Series USB Power Sensor.
Page 253
SERVice Subsystem If calibration date is not pre-programmed, “NONE” string is returned. N O T E U2000 Series Programming Guide...
SERVice:SENSor[1]:FREQuency:MAXimum? This query returns the maximum frequency that can be measured in MHz unit by the currently connected sensor. It is applicable to U2000 Series USB power sensors only. Maximum frequency information is stored in the sensor’s non- volatile memory.
U2000 Series USB Power Sensor currently. Error Messages • If the U2000 Series USB Power Sensor currently connected does not contain the necessary information in non- volatile memory, error –241 “Hardware missing” occurs. U2000 Series Programming Guide...
U2000 Series USB Power Sensor. Error Messages • If the U2000 Series USB Power Sensor currently connected does not contain the necessary information in non- volatile memory, error –241 “Hardware missing” occurs. U2000 Series Programming Guide...
U2000 Series USB Power Sensor. Error Messages • If the U2000 Series USB Power Sensor currently connected does not contain the necessary information in non- volatile memory, error –241 “Hardware missing” occurs. U2000 Series Programming Guide...
U2000 Series USB Power Sensor. Error Messages • If the U2000 Series USB Power Sensor currently connected does not contain the necessary information in non- volatile memory, error –241 “Hardware missing” occurs. U2000 Series Programming Guide...
This query returns a new raw uncorrected measurement for the sensor. Returned raw measurement is in float type unit. N O T E Error Messages • If INIT:CONT is set to ON, error –221 “Settings Conflict” occurs. U2000 Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:SNUMber <“serial_number”> This command is used to enter the serial number of U2000 Series USB power sensors. Syntax SERV :SENS Space “serial_number” :SNUM Example SERV:SENS1:SNUM MY12345678 This command enters the serial number and the changes of serial number will take effect after power recycle.
SERVice Subsystem SERVice:SENSor[1]:TNUMber <“tracking_number”> This command is used to enter the tracking number of U2000 Series USB power sensors. Syntax SERV :SENS Space “tracking_number” :TNUM Example SERV:SENS1:TNUM This command enters the tracking “PEN12345” number of PEN12345. Query SERVice:SENSor[1]:TNUMber? This query returns the tracking number for U2000 Series USB power sensors.
30 characters can be used. 0 - 9 Example SERV:SNUM GB12345678 This command loads the power sensor with the serial number GB12345678. Query SERVice:SNUMber? The query returns the power sensor serial number in the form GB12345678 or US12345678. U2000 Series Programming Guide...
(lowercase) be used. 0 - 9 _ (underscore) Example SERV:VERS:PROC “C” This command loads the power sensor with processor board revision version C. Query SERVice:VERSion:PROCessor? The query returns the current processor board revision version. U2000 Series Programming Guide...
Page 265
SERVice Subsystem If processor board revision is not pre-programmed,”NONE” string is returned. N O T E U2000 Series Programming Guide...
This command loads the power sensor with system version number 1. Query SERVice:VERSion:SYSTem? The query returns the current power sensor system version number. If system version number is not pre-programmed,”NONE” string is returned. N O T E U2000 Series Programming Guide...
Agilent U2000 Series USB Power Sensors Programming Guide SYSTem Subsystem SYSTem Subsystem SYSTem:ERRor? SYSTem:HELP:HEADers? SYSTem:PRESet <character_data> SYSTem:VERSion? This chapter explains how to use the SYSTem command subsystem to return error numbers and messages from the power sensor, preset the power sensor, and query the SCPI version.
• Return error numbers and messages from the power sensor • Preset the power sensor • Query the SCPI version Keyword Parameter Form Notes Page SYSTem :ERRor page 249 :HELP :HEADers? [query only] page 256 :PRESet page 257 :VERSion? [query only] page 260 U2000 Series Programming Guide...
SYST :ERR Query Example SYST:ERR? This command queries the system error. Error queue messages have the following format: Error Error Error “ Description “ Description Number Error Queue Message For example, –330, “Self- test Failed;Battery Fault”. U2000 Series Programming Guide...
Page 270
On reset, the error queue is unaffected. Error Messages • If the error queue overflows, the last error is replaced with –350, “Queue overflow”. No additional errors are accepted by the queue until space becomes available. U2000 Series Programming Guide...
Page 271
If you are using the short form of the command, remember that it may contain up to four letters. For example, TRIG:SOUR IMM. U2000 Series Programming Guide...
Page 272
Invalid block data A block data element was expected but was invalid for some reason. For example, *DDT #15FET. The 5 in the string indicates that 5 characters should follow, whereas in this example there are only 3. U2000 Series Programming Guide...
Page 273
A numeric parameter value is outside the valid range for the command. For example, SENS:FREQ 2KHZ. –224 Illegal parameter value A discrete parameter was received which was not a valid choice for the command. You may have used an invalid parameter choice. For example, TRIG:SOUR EXT. U2000 Series Programming Guide...
Page 274
–310 System error;Sensor non-volatile memory Read Failed - critical data not found or unreadable This indicates a failure with your U2000 Series USB power sensors. Refer to your power sensor manual for details on returning it for repair. –321 Out of memory The power sensor required more memory than was available to run an internal operation.
Page 275
A command was received which generates too much data to fit in the output buffer and the input buffer is also full. Command execution continues but data is lost. –440 Query UNTERMINATED after indefinite response The *IDN? command must be the last query command within a command string. U2000 Series Programming Guide...
The MS byte is transmitted first. Each complete block is terminated by a line feed. Commands are listed in alphabetical order. Syntax :HELP :HEAD SYST Example SYST:HELP:HEAD? This command returns the SCPI commands supported by the instrument. U2000 Series Programming Guide...
Range of Values character_data A communications format which determines DEFault the preset values. Example SYST:PRES DEF This command presets the power sensor with default values. The same default values are set when the parameter is omitted. U2000 Series Programming Guide...
[SENSe[1]]:CORR:CSET[2][:SEL] not affected Selected frequency dependent offset table [SENSe[1]]:CORR:CSET[2]:STAT not affected Sensor frequency dependent offset disabled [SENSe[1]]:CORR:FDOF|GAIN4[:INP][: not affected Return frequency dependent offset MAGN] [SENSe[1]]:CORR:GAIN2:STAT Channel offset disabled [SENSe[1]]:CORR:GAIN2:STAT 0.0 dB Enter channel offset value [:INPut][:MAGNitude] U2000 Series Programming Guide...
Page 279
Disable trace capture TRAC[1]:UNIT Trace units TRIG[1]:DEL:AUTO Insert settling time delay TRIG[:SEQ]:SLOP Trigger event recognized on rising edge TRIG[:SEQ[1]]:COUN Trigger events for measurement cycle TRIG[:SEQ[1]]:DEL:AUTO Enable settling time delay TRIG[:SEQ[1]]:SOUR Trigger source set up UNIT:POW Power units U2000 Series Programming Guide...
This query returns the version of SCPI used in the power sensor. 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 sensor. U2000 Series Programming Guide...
Page 283
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 current measurement immediately goes into the wait for trigger state. Syntax ABOR Example ABOR This command places the sensor in the idle state. U2000 Series Programming Guide...
The following commands are described in this section: INITiate[1]:CONTinuous <boolean> INITiate[1][:IMMediate] INITiate:CONTinuous:ALL <boolean> INITiate:CONTinuous:SEQuence[1] <boolean> INITiate[:IMMediate]:ALL INITiate[:IMMediate]:SEQuence[1] U2000 Series Programming Guide...
• ON, the trigger system is initiated and exits the idle state. On completion of each trigger cycle, the trigger system immediately commences another trigger cycle without entering the idle state. This command performs the same function as INITiate:CONTinuous:SEQuence[1] N O T E <boolean>. Syntax Space INIT :CONT 0|OFF 1|ON U2000 Series Programming Guide...
Page 286
• 1 is returned when there is continuous triggering • 0 is returned when there is only a single trigger Query Example INIT:CONT? This command queries whether the sensor is set for single or continuous triggering. U2000 Series Programming Guide...
INIT :IMM Example INIT1:IMM This command places the sensor in the wait for trigger state. Error Messages If the power sensor is not in the idle state or INITiate:CONTinuous is ON, error –213, “INIT ignored” occurs. U2000 Series Programming Guide...
INIT:CONT:ALL ON This command sets all trigger sequences to be continuously initiated. Reset Condition On reset (*RST), this command is set to OFF. On preset (SYSTem:PRESet) and instrument power- up, INITiate:CONTinuous is set to ON. Query INITiate:CONTinuous:ALL? U2000 Series Programming Guide...
Page 289
• 1 is returned when trigger sequences are set to be continuous • 0 is returned when trigger sequences are not set to be continuous Query Example INIT:CONT:ALL? This command queries whether the sensor is in a wait for trigger state. U2000 Series Programming Guide...
This command performs the same functions as INITiate[1]:CONTinuous N O T E <boolean>. Syntax INIT Space :CONT :SEQ 0|OFF 1|ON Example INIT:CONT:SEQ1 ON This command places the sensor in a wait for trigger state. U2000 Series Programming Guide...
Page 291
• 1 is returned when there is continuous triggering • 0 is returned when there is only a single trigger Query Example INIT1:CONT:SEQ? This command queries whether the sensor is set for single or continuous triggering. U2000 Series Programming Guide...
This command initiates all trigger sequences. Syntax :IMM :ALL INIT Example INIT:IMM:ALL This command initiates all trigger sequences. Error Messages If the power sensor is not in the idle state or INITiate:CONTinuous is ON, error –213, “INIT ignored” occurs. U2000 Series Programming Guide...
:IMM :SEQ Example INIT:IMM:SEQ1 This command places the sensor in the wait for trigger state. Error Messages If the power sensor is not in the “idle” state or INITiate:CONTinuous is ON, error –213, “INIT ignored” occurs. U2000 Series Programming Guide...
TRIGger Subsystem TRIGger Commands TRIGger commands control the behavior of the trigger system. The following commands are described in this section: TRIGger[1]:DELay:AUTO <boolean> TRIGger[1]:SOURce BUS|EXTernal|IMMediate|HOLD TRIGger[1][:IMMediate] TRIGger:[SEQuence]:SLOPe <character_data> TRIGger:SEQuence[1]:COUNt <numeric_value> TRIGger:SEQuence[1]:DELay:AUTO <boolean> TRIGger:SEQuence[1]:IMMediate TRIGger:SEQuence[1]:SOURce BUS|EXTernal|IMMediate|HOLD U2000 Series Programming Guide...
In cases of large power changes, the delay may not be sufficient for complete settling. Accurate readings can be assured by taking two successive measurements for comparison. • OFF, the power sensor makes the measurement immediately a trigger is received. Syntax Space :AUTO :DEL 0|OFF TRIG 1|ON U2000 Series Programming Guide...
Page 296
On reset, TRIGger:DELay:AUTO is set to ON. 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 U2000 Series Programming Guide...
N O T E Syntax TRIG :IMM Example TRIG This command causes a sensor trigger to occur immediately. Error Messages If the power sensor is not in the wait for trigger state, then TRIGger:IMMediate causes error –211, “Trigger ignored”. U2000 Series Programming Guide...
This command has been included for compatibility purposes. It has the same purpose as N O T E TRIGger[:SEQuence[1]]:SOURce BUS|EXTernal|HOLD|IMMediate which should be used in preference. Syntax Space TRIG :SOUR HOLD U2000 Series Programming Guide...
Page 299
The READ? or MEASure commands should not be used if the trigger source is set to HOLD. Example TRIG:SOUR IMM This command configures the sensor for immediate triggering. Reset Condition On reset, the trigger source is set to IMMediate. U2000 Series Programming Guide...
Page 300
• If the source is changed to EXT and SENS:MRATe has a value of FAST, error –221 “Settings Conflict” occurs. • If the source is changed to EXT and SENS:DET:FUNC is set to AVERage, error –221 “Settings Conflict” occurs. U2000 Series Programming Guide...
POSitive: a trigger event is recognized on • the rising edge of a signal. NEGative: a trigger event is recognized on • the falling edge of a signal. Reset Condition On reset the value is set to POSitive. U2000 Series Programming Guide...
Page 302
TRIGger Subsystem Query TRIGger[:SEQuence]:SLOPe? The query returns the current value of <character_data>. Query Example TRIG:SEQ:SLOP? This command queries the current value of <character_data> for the sensor. U2000 Series Programming Guide...
• TRIGger:SOURce set to IMMediate or HOLD. Syntax numeric_value TRIG :SEQ :COUN Space Parameters Item Description/Default Range of Values numeric_value The number of triggered events for the 1 to 50 measurement cycle. DEF: the default value is 1 • U2000 Series Programming Guide...
Page 304
The query returns the current setting of trigger events for the sensor. Query Example TRIG:SEQ1:COUN? This command queries the number of triggered events for the sensor measurement cycle. Error Messages If COUNt >1 when [SENSe[1]]:MRATe <character_data> is set to NORMal or DOUBle, error –221, “Settings Conflict” occurs. U2000 Series Programming Guide...
• OFF, no settling- time delay is inserted and the power sensor makes the measurement immediately a trigger is received. • ONCE, a settling- time delay is inserted before taking the requested measurement, for one measurement only. Syntax TRIG :SEQ Space :DEL :AUTO 0|OFF 1|ON ONCE U2000 Series Programming Guide...
Page 306
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 Query Example TRIG:SEQ1:DEL:AUTO? This command queries the settling- time delay of the sensor. U2000 Series Programming Guide...
In other words, the instrument stops waiting for a trigger and takes a measurement ignoring any delay set by TRIG:DELay. Syntax TRIG :SEQ :IMM Example TRIG:SEQ:IMM This command initiates a measurement on the sensor. U2000 Series Programming Guide...
This command only selects the trigger source. Use the INITiate command to place the power sensor in the wait for trigger state. This command has the same purpose as TRIGger[1]:SOURce N O T E BUS|EXTernal|HOLD|IMMediate. Syntax :SEQ Space TRIG :SOUR HOLD U2000 Series Programming Guide...
Page 309
The MEASure and CONFigure commands automatically set the trigger source to IMMediate. The READ? or MEASure commands should not be used if the trigger source is set to HOLD. Example TRIG:SOUR IMM This command configures the sensor for immediate triggering. U2000 Series Programming Guide...
Page 310
• If the source is changed to EXT and [SENSe[1]]:MRATe has a value of FAST, error –221 “Settings Conflict” occurs. • If the source is changed to EXT and [SENSe[1]]:DET:FUNC is set to AVERage, error –221 “Settings Conflict” occurs. U2000 Series Programming Guide...
Agilent U2000 Series USB Power Sensors Programming Guide UNIT Subsystem UNIT Subsystem UNIT[1]:POWer <amplitude_unit> This chapter explains how the UNIT command subsystem is used to set the power sensor measurement units to Watts and % (linear), or dBm and dB (logarithmic).
The following commands are described in this section: Keyword Parameter Form Notes Page UNIT[1] :POWer <amplitude unit> page 293 The UNIT:POWer command is as follows: • If UNIT:POWer is set to dBm. • If UNIT:POWer is set to W. U2000 Series Programming Guide...
The power suffix set by UNIT:POWer is used for any command which accepts a numeric value in more than one unit For single measurement: • UNIT1:POWer sets the power measurement units for the current window/measurement. Syntax Space amplitude_unit :POW UNIT U2000 Series Programming Guide...
Page 314
On reset, all windows/measurements are set to DBM. Query UNIT[1]:POWer? The query returns the current setting of the power measurement units. Query Example UNIT1:POW? This command queries which measurement units are being used on the current window/measurement. U2000 Series Programming Guide...
Page 315
Agilent U2000 Series USB Power Sensors Programming Guide IEEE 488.2 Command Reference SCPI Compliance Information *CLS *ESE <NRf> *ESR? *IDN? *OPC *OPT? *RCL <NRf> *RST *SAV <NRf> *SRE <NRf> *STB? *TRG *TST? *WAI USBTMC/USB488 Universal Commands This chapter contains information about the IEEE 488.2 Common Commands that the power sensor supports.
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. Syntax *CLS U2000 Series Programming Guide...
Table 13- 1 shows the contents of this register. Table 13-1 *ESE Mapping Weight Meaning Operation Complete Request Control (not used) Query Error Device Dependent Error Execution Error Command Error Not used Power On Syntax Space *ESE U2000 Series Programming Guide...
Page 319
A value used to set the Standard Event Status 0 - 255 Enable Register. Query *ESE? The query returns the current contents of the Standard Event Status Enable Register. The format of the return is <NR1> in the range of 0 to 255. U2000 Series Programming Guide...
The format of the return is <NR1> in the range of 0 to 255. Table 13- 2 shows the contents of this register. Table 13-2 *ESR? Mapping Weight Meaning Operation Complete Not used Query Error Device Dependent Error Execution Error Command Error Not used Power On Syntax *ESR U2000 Series Programming Guide...
The *IDN? query allows the power sensor to identify itself. The string returned Agilent Technologies,U200XA,<serial number>,A.XX.YY where: • <serial number> uniquely identifies each power sensor. • represents the firmware revision with XX and YY representing the major and minor revisions respectively. Syntax *IDN U2000 Series Programming Guide...
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. U2000 Series Programming Guide...
IEEE 488.2 Command Reference *OPT? The *OPT? query reports the options installed in the power sensor and returns: • " " empty string for a standard instrument. Syntax *OPT U2000 Series Programming Guide...
*RCL Parameters Type Description/Default Range of Values The number of the register to be recalled. 1 - 10 Error Message • If the register does not contain a saved state, error –224, “Illegal parameter value” occurs. U2000 Series Programming Guide...
IEEE 488.2 Command Reference *RST The *RST (ReSeT) command places the power sensor in a known state. Refer on page 257 for information on reset “SYSTem:PRESet <character_data>” values. Syntax *RST U2000 Series Programming Guide...
The *SAV <NRf> (SAVe) command stores the current state of the power sensor in the specified register. Syntax Space *SAV Parameters Item Description/Default Range of Values The number of the register that the current state of 1 - 10 the power sensor is to be saved to. U2000 Series Programming Guide...
Refer to the pullout at the end of Chapter 10 for further information. Table 13-3 *SRE Mapping Weight Meaning Not used Not used Device Dependent QUEStionable Status Summary Message Available Event Status Bit Not used OPERation Status Summary Syntax Space *SRE U2000 Series Programming Guide...
Page 328
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 <NR1> in the ranges of 0 to 63 or 128 to 191 (that is, bit 6 is always 0). U2000 Series Programming Guide...
0 - power sensor not requesting service 1 - there is at least one reason for requesting service Operation Status Summary 0 - No OPERation status conditions have occurred 1 - An OPERation status condition has occurred U2000 Series Programming Guide...
Syntax *TRG Error Message • If TRIGger:SOURce is not set to BUS, error –211, “Trigger ignored” occurs. • If the power sensor is not in the wait- for- trigger state, error –211, “Trigger ignored” occurs. U2000 Series Programming Guide...
The *TST? (TeST) query causes the power sensor to perform the self test. The test takes approximately 40 seconds. The result of the test is placed in the output queue. • 0 is returned if the test passes • 1 if the test fails Syntax *TST U2000 Series Programming Guide...
The *WAI (WAIt) command causes the power sensor 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. Syntax *WAI U2000 Series Programming Guide...
• All pending operations are halted, that is, *OPC? and *WAI. • The parser (the software that interprets the programming codes) is reset and now expects to receive the first character of a programming code. • The output buffer is cleared. U2000 Series Programming Guide...