Summary of Contents for Keysight Technologies U2040 X-Series
Page 1
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Wide dynamic range power sensors for any modulated signals Programming Guide...
Page 2
FAR 27.401 or DFAR could result in personal injury or death. 227.7103-5 (c), as applicable in any Do not proceed beyond a WARNING technical data. notice until the indicated conditions are fully understood and met. Keysight U2040 X-Series Programming Guide...
Page 17
Using a comma “,” Using whitespace Using “?” commands Using “*” commands Syntax conventions SCPI data types Input message terminators Zeroing and Calibrating the U2040 X-Series Zeroing Calibration Making Measurements Using MEASure? Using the CONFigure command Using the lower-level commands...
Page 18
How to save and recall a configuration Making Measurements on Wireless Communication Standards Starting a preset example This chapter describes the parameters that configure the U2040 X-Series, and helps you determine the settings to optimize performance. Keysight U2040 X-Series Programming Guide...
The USB interface requires no front panel or remote configuration. Before connecting the USB/LAN cable, make sure that the Keysight IO Libraries software is installed on your PC. For further information on connecting and verifying the U2040 X-Series via USB/LAN, refer NOTE to the U2040 X-Series User’s Guide.
For example, the following two statements are equivalent. Note that in the first statement, the first colon is optional but the third is compulsory. SENS:AVER ON;SENS:AVER:COUN 1 SENS:AVER ON;AVER:COUN 1 Keysight U2040 X-Series Programming Guide...
Page 21
IEEE-488 interface standard. The “*” commands are used to control the reset, clear status, identification request, self-test, wait-before-execution, and status operations in the U2040 X-Series. Keysight U2040 X-Series Programming Guide...
Page 22
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. <NAN> definition Not a number (NAN) is represented as 9.91E37. Not a number is defined in IEEE 754. Keysight U2040 X-Series Programming Guide...
Page 23
You can include the quote delimiter as part of the string by typing it twice without any characters in between. Keysight U2040 X-Series Programming Guide...
Page 24
<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. Keysight U2040 X-Series Programming Guide...
The command used to auto-calibrate the U2040 X-Series is: CALibration[1]:AUTO ONCE It is recommended that you zero the U2040 X-Series before calibrating. CALibration[1][:ALL] allows you to perform calibration with a single command. This calibration consists of zeroing the U2040 X-Series.
The advantage of using the lower-level commands over the MEASure? query and CONFigure command is that they give you more precise control of the U2040 X-Series. As shown in Table 1-1, the CONFigure command presets various states in the U2040 X- Series.
Page 27
The parameter DEFault is used as a placeholder. The source list parameter is used to specify a measurement channel. The U2040 X-Series supports only one channel. Therefore, the only valid value is (@1). The expected power and resolution parameters are set to their default values, leaving them at their current settings.
Page 28
Channel A – Channel A. The expected power level and resolution parameters are defaulted, leaving them at their current settings. specifies CALCulate subsystem specifies the channels for the difference measurement MEAS2:POW:AC:DIFF? DEF,DEF,(@1),(@1) Channel A – A Keysight U2040 X-Series Programming Guide...
Page 29
Channel A/A Using the CONFigure command When you execute this command, the U2040 X-Series presets the optimum 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.
Page 30
Causes Channel A to make a measurement. INIT1? Retrieves the CALCulate1 measurement. FETC1? Resets the U2040 X-Series. *RST Configures CALCulate2 — defaults to a Channel A measurement. CONF2 Causes Channel A to make a measurement. INIT1 Retrieves the CALCulate2 measurement. FETC2? Keysight U2040 X-Series Programming Guide...
Page 31
The following example uses the expected value parameter to specify a value of –30 dBm. The resolution parameter is defaulted, leaving it at its current setting. The source list parameter specifies a Channel A measurement. Keysight U2040 X-Series Programming Guide...
Page 32
1024 and the trigger delay off. 1 ABOR1 2 CONF1 -30,DEF,(@1) 3 SENS1:AVER:COUN 1024 4 TRIG1:DEL:AUTO OFF 5 INIT1 6 FETC1? -30,DEF,(@1) Keysight U2040 X-Series Programming Guide...
Page 33
Configures CALCulate1 to make a measurement using the current setting of the expected power and source list and a resolution CONF1 DEF,3 setting of 3. Causes Channel A to make a measurement. INIT1 Retrieves the CALCulate1 measurement. FETC1? DEF,3 Keysight U2040 X-Series Programming Guide...
Page 34
Using INITiate and FETCh? ABOR1 CONF2:POW:AC:DIFF DEF,DEF,(@1),(@1) SENS1:AVER:COUN 1024 TRIG1:DEL:AUTO OFF INIT1:IMM FETC2:POW:AC:DIFF? FETC2:POW:AC:DIFF? DEF,DEF,(@1),(@1) (A second FETCh? query is sent to make a Channel A – Channel A measurement using the current measurement data). Keysight U2040 X-Series Programming Guide...
Page 35
(A second READ? query is sent to make a Channel A/Channel A measurement using fresh measurement data.) Using INITiate and FETCh? ABOR1 CONF2:POW:AC:RAT DEF,DEF,(@1),(@1) SENS1:AVER:COUN 512 INIT1:IMM FETC2:POW:AC:RAT? FETC2:POW:AC:RAT? DEF,DEF,(@1),(@1) (A second FETCh? query is sent to make a Channel A/Channel A measurement using the current measurement data.) Keysight U2040 X-Series Programming Guide...
Page 36
The advantage of using the lower-level commands over the CONFigure command is that they give you more precise control of the U2040 X-Series. As shown in Table 1-1, the CONFigure command presets various states in the U2040 X-Series. It may be likely that you do not want to preset these states.
Note that when selected, frequency-dependent offset correction is IN ADDITION to any correction applied for sensor frequency response. The U2040 X-Series is capable of storing 10 frequency-dependent offset tables of 512 frequency points each.
Page 38
OFFSET 1 FREQ 2 OFFSET 2 Frequency-dependent offset used Frequency of the signal to make measurements. you want to measure Calculated by the sensor using linear interpolation. FREQ 512 OFFSET 512 Figure 1-1 Frequency-dependent offset tables Keysight U2040 X-Series Programming Guide...
Page 39
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. Keysight U2040 X-Series Programming Guide...
Page 40
To list the frequency-dependent offset tables currently stored in the U2040 X-Series, use the following query: MEMory:CATalog:TABLe? The U2040 X-Series returns the data in the form of two numeric parameters and a string list representing all stored tables. <numeric_value>,<numeric_value>{,<string>} The first numeric parameter indicates the amount of memory, in bytes, used for storage of tables.
Page 41
Query which returns the frequencies stored in the frequency-dependent offset table (in Hz). MEMory:TABLe:GAIN[:MAGNitude]:POINts? Query which returns the number of offset factor points stored in the frequency-dependent offset table. MEMory:TABLe:GAIN[:MAGNitude]? Query which returns the offset factors stored in the frequency-dependent offset table. Keysight U2040 X-Series Programming Guide...
Page 42
–221, “Settings conflict” occurs. Making the measurement To make the power measurement, set the U2040 X-Series for the frequency of the signal you want to measure. The U2040 X-Series automatically sets the offset factor. Use either...
Page 43
U2040 X-Series uses the highest or lowest frequency point in the table to set the offset. – To find out the value of the offset being used by the U2040 X-Series to make a measurement, use the [:SENSe[1]:]CORRection:FDOFfset|GAIN4[:INPut][:MAGNitude]? query.
Chapter 16, "SENSe Subsystem". Averaging The U2040 X-Series has a digital filter to average power readings. The number of readings averaged can range from 1 to 1024. This filter is used to reduce noise, to obtain the desired resolution, and to reduce the jitter in the measurement results.
Page 46
– 1, 2, 3, or 4 significant digits respectively if the measurement suffix is W or %. Figure 1-3 Typical averaged readings (continued) Figure 1-4 illustrates part of the U2040 X-Series dynamic range hysteresis. Range hysteresis 8 dB 10 dB...
Setting Offsets Channel offsets The U2040 X-Series 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 U2040 X-Series. Gain and loss corrections are a coupled system.
Page 48
– Clears the U2040 X-Series interface. Send device clear Sets the U2040 X-Series to a known state. *RST Configures the U2040 X-Series to make the CONF:POW:AC:RAT 20DBM,2,(@1),(@1) measurement. Sets the measurement unit to dBm. UNIT:POW DBM Sets the channel offset to –10 dB.
U2040 X-Series Remote Operation Setting Measurement Limits You can configure the U2040 X-Series to detect when a measurement is outside of a predefined upper and/or lower limit value. Limits can be applied to power, ratio, or difference measurements. Setting limits The U2040 X-Series can be configured to verify the power being measured against an upper and/or lower limit value.
Page 50
– Use the CALCulate[1]|2|3|4:LIMit:FAIL? and CALCulate[1]|2|3|4:LIMit:FCOunt? queries for limits. – Use the STATus command subsystem. If TRIGger:DELay:AUTO is set to ON, then the number of failures returned by NOTE CALCulate[1]|2|3|4:LIMit:FCOunt? is affected by the current filter settings. Keysight U2040 X-Series Programming Guide...
The U2040 X-Series has a very flexible triggering system. For simplicity, it can be described as having three modes: – Free Run: When the U2040 X-Series is in the Free Run mode, it continuously takes measurements. A measurement is in free run when INITiate:CONTinuous is set to ON and TRIGger:SOURce is set to IMMediate.
Page 52
U2040 X-Series Remote Operation – Single Shot: When the U2040 X-Series is in the Single Shot mode, it takes a new measurement when a trigger event is detected and then returns to the idle state. A measurement is in single shot when INITiate:CONTinuous is set to OFF. Note that a measurement can take several INT/EXT triggers depending on the filter settings.
Page 53
Units The U2040 X-Series can output results in either linear or log units. The internal units are linear, therefore optimal performance is achieved when the results output are also in linear units (since the overhead of performing a log function is removed).
U2040 X-Series Remote Operation How Measurements are Calculated Figure 1-6 details how measurements are calculated. It shows the order in which the various U2040 X-Series functions are implemented in the measurement calculation. TRACe:DATA? CALCulate[1] :LIM FORMat :FEED Limits UNIT[1] Switch...
Condition register The condition register continuously monitors the hardware and firmware status of the U2040 X-Series. There is no latching or buffering for this register, it is updated in real time. Condition registers are read-only. Keysight U2040 X-Series Programming Guide...
Page 56
A small binary table shows the state of the chosen bit in each status register at the selected times T1 to T5. Condition * marks when event register is read Figure 1-8 Typical status register bit changes Keysight U2040 X-Series Programming Guide...
Page 57
3 Examine the bit to see if the condition has changed. Status registers The Status system in the U2040 X-Series is shown in Figure 1-9. The Operation Status and Questionable Status groups are 16 bits wide, while the Status Byte and Standard Event groups are 8 bits wide.
Page 58
Device Status • • • Condition Event Enable Questionable Status Status Byte Condition Event Enable Output Queue RQS/MSS Standard Event *STB? *SRE Event Enable *ESR *ESE Operation Status Condition Event Enable Figure 1-9 Status system Keysight U2040 X-Series Programming Guide...
The *STB? (status byte query) command is similar to a serial poll except it is processed like any other U2040 X-Series command. *STB? returns the same result as an IEEE-488 serial poll except that the request service bit (bit 6) is not cleared if a serial poll has occurred.
– send a *CLS (clear status) command. – query the event register using the *ESR? (event status register) query. The standard event enable register is cleared when you: – cycle the U2040 X-Series power. – execute a *ESE 0 command. Keysight U2040 X-Series Programming Guide...
The questionable status register provides information about the quality of the U2040 X-Series 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.
U2040 X-Series Remote Operation Operation status The operation status group monitors conditions in the U2040 X-Series measurement process. The following bits in these registers are used by the U2040 X-Series: Table 1-7 Bit definitions - Operation status Bit number Decimal weight...
– CLEARED: If a measurement is made and the upper limit test is not enabled or the test is enabled and passes. Device Status register The device status register set contains bits which give device-dependent information. The following bit in these registers is used by the U2040 X-Series: Table 1-9 Bit definitions - Device status register Bit number...
Page 64
The *OPC? and *OPC commands allow you to maintain synchronization between the computer and the U2040 X-Series. The *OPC? query places an ASCII character 1 into the U2040 X-Series output queue when all pending commands are completed. If your program reads this response before continuing program execution, you can ensure synchronization between one or more instruments and the computer.
U2040 X-Series Remote Operation Saving and Recalling U2040 X-Series Configurations To reduce repeated programming, up to 10 U2040 X-Series configurations can be stored in the U2040 X-Series non-volatile memory. The error list, remote addresses, frequency-dependent offset table data, and zeroing/calibration information are not stored.
– All measurements in progress are aborted. – The U2040 X-Series returns to the trigger “idle state”. – The U2040 X-Series input and output buffers are cleared. – The U2040 X-Series is prepared to accept a new command string. Keysight U2040 X-Series Programming Guide...
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. Keysight U2040 X-Series Programming Guide...
*DDT <arbitrary block program data>|<string program data> *DDT? Description The *DDT (Define Device Trigger) command determines the U2040 X-Series response to the *TRG common command. This command effectively turns *TRG into a query, with the measured power being returned. The query returns the action which is performed on receipt of a *TRG. This is returned as a <definite-length arbitrary block response data>...
Page 72
IEEE-488 Common Commands Error message If an invalid parameter is received, error –224, “Illegal parameter value” occurs. Keysight U2040 X-Series Programming Guide...
Request Control (not used) Query Error Device-Dependent Error Execution Error Command Error User Request Power On Parameter Item Range of values Description/Default value 0 to 255 A value used to set the Standard Event Status Enable Register. Keysight U2040 X-Series Programming Guide...
The format of the return is <NR1> in the range of 0 to 255. Table 2-2 shows the contents of this register. Table 2-2 *ESR? mapping Weight Meaning Operation Complete Request Control (not used) Query Error Device-Dependent Error Execution Error Command Error User Request Power On Keysight U2040 X-Series Programming Guide...
IEEE-488 Common Commands *IDN? Syntax *IDN? Description The *IDN? query allows the U2040 X-Series to identify itself. The string returned is, for example: Keysight Technologies,U2041XA,<serial number>,A1.XX.YY where: – <serial number> uniquely identifies each U2040 X-Series. – A1.XX.YY represents the firmware revision with XX and YY representing the major and minor revisions respectively.
*OPC *OPC? Description The *OPC (OPeration Complete) command causes the U2040 X-Series to set the operation complete bit in the Standard Event Status Register when all pending device operations have completed. The query places an ASCII 1 in the output queue when all pending device operations have completed.
IEEE-488 Common Commands *OPT? Syntax *OPT? Description The *OPT? query reports the options installed in the U2040 X-Series and returns a " " empty string for a standard instrument. Keysight U2040 X-Series Programming Guide...
IEEE-488 Common Commands *RCL Syntax *RCL <NRf> Description The *RCL <NRf> (ReCaLl) command restores the state of the U2040 X-Series from the specified save/recall register. An instrument setup must have been stored previously in the specified register. Parameter Item Range of values...
IEEE-488 Common Commands *RST Syntax *RST Description The *RST (ReSeT) command places the U2040 X-Series in a known state. Refer to “SYSTem:PRESet” on page for information on the reset values. Keysight U2040 X-Series Programming Guide...
IEEE-488 Common Commands *SAV Syntax *SAV <NRf> Description The *SAV <NRf> (SAVe) command stores the current state of the U2040 X-Series in the specified register. Parameter Item Range of values Description/Default value The number of the register that the current state of the U2040 X-Series is to 1 to 10 be saved to.
Event Status Byte Summary Master Status Summary (Request for service) OPERation Status Register Summary Parameter Item Range of values Description/Default value 0 to 255 A value used to set the bits in the Status Byte enable register. Keysight U2040 X-Series Programming Guide...
Table 2-4 *STB? mapping Weight Meaning Not used Device Status Register Summary Error/Event Queue QUEStionable Status Register Summary Message Available Event Status Byte Summary Master Status Summary (Request for service) OPERation Status Register Summary Keysight U2040 X-Series Programming Guide...
Using the *DDT command may change the function of the *TRG command. Error messages – If TRIGger:SOURce is not set to BUS, error –211, “Trigger ignored” occurs. – If the U2040 X-Series is not in the wait-for-trigger state, error –211, “Trigger ignored” occurs. Keysight U2040 X-Series Programming Guide...
Syntax *TST Description The *TST? (TeST) query causes the U2040 X-Series to perform the self-test. The test takes approximately 100 seconds. The result of the test is placed in the output queue. – 0 is returned if the test passes –...
*WAI Syntax *WAI Description The *WAI (WAIt) command causes the U2040 X-Series 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.
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide ABORt Subsystem ABORt[1] This chapter describes the ABORt subsystem command.
ABORt was executed. If INITiate:CONTinuous is ON, then after ABORt, the channel immediately goes into the wait-for-trigger state. Example Places the channel in the idle state. ABOR Keysight U2040 X-Series Programming Guide...
Page 89
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide CALCulate Subsystem CALCulate[1]|2|3|4:FEED[1]|2 CALCulate[1]|2|3|4:GAIN:STATe CALCulate[1]|2|3|4:GAIN[:MAGNitude] CALCulate[1]|2|3|4:LIMit:CLEar:AUTO CALCulate[1]|2|3|4:LIMit:CLEar[:IMMediate] CALCulate[1]|2|3|4:LIMit:FAIL? CALCulate[1]|2|3|4:LIMit:FCOunt? CALCulate[1]|2|3|4:LIMit:LOWer[:DATA] CALCulate[1]|2|3|4:LIMit:STATe CALCulate[1]|2|3|4:LIMit:UPPer[:DATA] CALCulate[1]|2|3|4:MATH [:EXPRession] CALCulate[1]|2|3|4:MATH [:EXPRession]:CATalogue? CALCulate[1]|2|3|4:PHOLd:CLEar CALCulate[1]|2|3|4:RELative:STATe CALCulate[1]|2|3|4:RELative[:MAGNitude]:AUTO This chapter describes the CALCulate subsystem commands.
If ON SWEEP[1]|2|3|4 is not supplied, the gate used is left unchanged. A feed of (empty string) has no effect if specified. "" Example Selects the input for FEED2 of CALC3 CALC3:FEED2 "POW:AVER ON SWEEP2" block to be average power, using gate 2. Keysight U2040 X-Series Programming Guide...
Page 91
– If <string> contains ON SWEEP[1]|2|3|4 and the feed’s TRIG:SOUR is not INT or EXT, error –221, “Settings conflict” occurs. – If CALC:FEED is set to PEAK, MIN, or PTAV when DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
– 0 is returned when the offset is disabled Example Enables the CALCulate2 offset. CALC2:GAIN:STAT 1 Reset condition On reset, the offset is disabled. Error message If CALCulate[1]|2|3|4:GAIN[:MAGNitude] is set to ON while [:SENSe[1]:]MRATe is set to FAST, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Enters a CALCulate2 offset of 20 dB. CALC2:GAIN 20 Reset condition On reset, the offset is set to 0 dB (DEF). Error message If CALCulate[1]|2|3|4:GAIN[:MAGNitude] is set to ON while [:SENSe[1]:]MRATe is set to FAST, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
If a measurement is initiated, then 0 is entered. Example Switches on automatic clearing of the FCO for CALC1:LIM:CLE:AUT 1 CALCulate1. Reset condition On reset, the CALCulate blocks and their measurements are set to ON. Keysight U2040 X-Series Programming Guide...
This command immediately clears the fail counter (FCO) of any limit failures for the specified CALCulate block. The FCO is used to determine the results returned by the CALCulate[1]|2|3|4:LIMit:FAIL? query. Example Clears the FCO for CALCulate2. CALC2:LIM:CLE Keysight U2040 X-Series Programming Guide...
– 0 is returned when no limit failures have occurred Example Queries if there have been any limit failures on CALCulate1. CALC1:LIM:FAIL? Reset condition On reset, the buffer is set to zero for all CALCulate blocks. Keysight U2040 X-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. Keysight U2040 X-Series Programming Guide...
Page 98
CALCulate Subsystem Example Queries the number of limit failures on CALCulate1. CALC1:LIM:FCO? Reset condition On reset, the counter is set to zero for all CALCulate blocks. Keysight U2040 X-Series Programming Guide...
A numeric value for the lower test limit: –180 to +200 dB – DEF: the default is –90 dBm or –120 dB numeric_value – MIN: –150 dBm or –180 dB – MAX: +230 dBm or +200 dB Keysight U2040 X-Series Programming Guide...
Page 100
= 0.1 dBm CALC2:LIM:LOW:DATA 0.1 W = 100 mW dB = 0.1 dB % = 0.1% Reset condition On reset, the lower limit for all CALCulate blocks is set to –90.00 dBm or –120 dB (DEF). Keysight U2040 X-Series Programming Guide...
Enables the limit checking function for CALCulate2. CALC2:LIM:STAT 1 Reset condition On reset, limit checking is disabled. Error message If CALCulate[1|2|3|4]:LIMit:STATe is set to ON while [:SENSe[1]:]MRATe is set to 200, error -221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
A numeric value for the upper test limit: –180 to +200 dB – DEF: the default is 90 dBm or 120 dB numeric_value – MIN: –150 dBm or –180 dB – MAX: +230 dBm or +200 dB Keysight U2040 X-Series Programming Guide...
Page 103
= 5 dBm CALC2:LIM:UPP:DATA 5 W = 5 W dB = 5 dB % = 5% Reset condition On reset, the upper limit for all CALCulate blocks is set to 90.00 dBm or 120 dB (DEF). Keysight U2040 X-Series Programming Guide...
CALC2:MATH "(SENS1/SENS1)" ratio measurement. Reset condition On reset, all CALCulate blocks are set to "(SENS1)". Error message If string is not set to "(SENS1)" while [:SENSe[1]:]MRATe is set to FAST, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Syntax CALCulate[1]|2|3|4:MATH [:EXPRession]:CATalogue? Description This query lists all the defined math expressions in the form of comma-separated strings as follows: "(SENS1)","(SENS1-SENS1)","(SENS1/SENS1)" Each string contains a math expression. Example Lists all the defined math expressions. CALC1:MATH:CAT? Keysight U2040 X-Series Programming Guide...
Clears the peak hold value for CALC2. CALC2:PHOL:CLE Error messages – If TRIG:SOUR is set to INT or EXT, error –221 “Settings conflict” occurs. – If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Disables the relative mode on CALCulate1. CALC1:REL:STAT OFF Reset condition On reset, the relative mode is disabled. Error message If CALCulate:RELative:STATe is set to ON while [:SENSe[1]:]MRATe is set to FAST, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
On reset, the reference value is 0. Error messages – If CALCulate:RELative[:MAGNitude]:AUTO is set to ONCE while [:SENSe[1]:]MRATe is set to FAST, error –221, “Settings conflict” occurs. – If the value is set to ON, error –224, “Illegal parameter value” occurs. Keysight U2040 X-Series Programming Guide...
Page 109
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide CALibration Subsystem CALibration Subsystem CALibration[1]:ZERO:AUTO CALibration[1]:ZERO:TYPe CALibration[1]:ZERO:NORMal:AUTO CALibration[1][:ALL] This chapter describes the CALibration subsystem commands.
CALibration Subsystem CALibration Subsystem The CALibration command subsystem is used to zero and calibrate the U2040 X-Series. The numeric suffix of the CALibration command (CALibration1) refers to Channel A. Zeroing and calibration of the U2040 X-Series is recommended: – When a 5°C change in temperature occurs –...
This command auto-calibrates channel A when enabled. When 1|ON is enabled, auto-calibration is updated every 10 minutes. 0|OFF can be set to disable auto-calibration. The query returns the calibration state. The U2040 X-Series should be zeroed before calibration using the NOTE CALibration:ZERO:AUTO ONCE command. Example...
Description This command causes the U2040 X-Series to perform its auto-zeroing routine when enabled. This adjusts the U2040 X-Series for a zero power reading with or without power supplied to the U2040 X-Series. When 1|ON is enabled, the zero is maintained by a combination of on-the-fly zero measurements and temperature compensation.
CALibration[1]:ZERO:TYPe EXTernal|INTernal CALibration[1]:ZERO:TYPe? Description This command sets the U2040 X-Series to the external or internal zeroing mode. Upon power up, the U2040 X-Series defaults to the internal zeroing mode. This query returns the current zeroing mode of either INT or EXT.
CALibration[1]:ZERO:NORMal:AUTO? Description This command provides a quick way of zeroing the NORMal path of the U2040 X-Series. This command causes the U2040 X-Series to perform its zeroing routine when ONCE is selected. This adjusts the U2040 X-Series for a zero power reading with or without power supplied to the U2040 X-Series.
Syntax CALibration[1][:ALL] CALibration[1][:ALL]? Description This command causes the U2040 X-Series to perform a calibration sequence which consists of: 1 Zeroing the U2040 X-Series (CALibration[1]:ZERO:AUTO ONCE), and 2 Calibrating the U2040 X-Series (CALibration[1]:AUTO ONCE). When the calibration sequence is completed, this query enters 0 or 1 into the output buffer to indicate if the sequence was successful.
Page 116
CALibration Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Page 117
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide CONFigure Subsystem CONFigure[1]|2|3|4[:SCALar][:POWer][:AC] CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence:RELative CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:RATio CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:RATio:RELative CONFigure[1]|2|3|4[:SCALar][:POWer][:AC]:RELative This chapter describes the CONFigure subsystem commands.
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Configures CALCulate1 to measure the power of Channel A, CONF DEF,2,(@1) using the current range and a resolution setting of 2. Keysight U2040 X-Series Programming Guide...
Item Range of values Description/Defaul t value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
Item Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
Page 121
CONFigure Subsystem Example Configures CALCulate1 to make a difference measurement of Channel A – Channel A with relative mode CONF1:DIFF:REL DEF,1,(@1),(@1) on, using the current range and a resolution of 1. Keysight U2040 X-Series Programming Guide...
Item Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
Item Range of values Description/Defaul t value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Configures CALCulate2 to measure the relative power of Channel A, using an expected power CONF2:REL -20DBM,3,(@1) level of –20 dBm and a resolution setting of 3. Keysight U2040 X-Series Programming Guide...
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 is set to Channel A. Keysight U2040 X-Series Programming Guide...
Page 126
CONFigure Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Page 127
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide FETCh Subsystem FETCh[1]|2|3|4[:SCALar][:POWer][:AC]? FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence? FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:DIFFerence:RELative? FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:RATio? FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:RATio:RELative? FETCh[1]|2|3|4[:SCALar][:POWer][:AC]:RELative? This chapter describes the FETCh subsystem commands.
The parameter DEFault is used as a placeholder. Specifying DEF leaves the parameter value unchanged. [b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate2 measurement result. FETC2? Keysight U2040 X-Series Programming Guide...
Page 129
– If the expected value and resolution parameters are not the same as the current expected value and resolution setting on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
The parameter DEFault is used as a placeholder. Specifying DEF leaves the parameter value unchanged. [b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate4 difference measurement. FETC4:DIFF? Keysight U2040 X-Series Programming Guide...
Page 131
– If the expected value and resolution parameters are not the same as the current expected value and resolution settings on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
The parameter DEFault is used as a placeholder. Specifying DEF leaves the parameter value unchanged. [b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Keysight U2040 X-Series Programming Guide...
Page 133
– If the expected value and resolution parameters are not the same as the current expected value and resolution settings on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate2 ratio measurement of Channel A over Channel A, using the current FETC2:RAT? DEF,1,(@1),(@1) range and a resolution of 1. Keysight U2040 X-Series Programming Guide...
Page 135
– If the expected value and resolution parameters are not the same as the current expected value and resolution settings on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
The parameter DEFault is used as a placeholder. Specifying DEF leaves the parameter value unchanged. [b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate1 relative ratio measurement. FETC:RAT:REL? Keysight U2040 X-Series Programming Guide...
Page 137
– If the expected value and resolution parameters are not the same as the current expected value and resolution settings on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate1 relative measurement of Channel A, using the current range and a resolution FETC1:REL? DEF,2,(@1) setting of 2. Keysight U2040 X-Series Programming Guide...
Page 139
– If the expected value and resolution parameters are not the same as the current expected value and resolution settings on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Page 140
FETCh Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Page 141
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide FORMat Subsystem FORMat[:READings]:BORDer FORMat[:READings][:DATA] This chapter describes the FORMat subsystem commands.
The query returns the current setting of the byte order. The format of the response is NORMal or SWAPped. Example Sets the byte order to swapped. FORM:BORD SWAP Reset condition On reset, this value is set to NORMal. Keysight U2040 X-Series Programming Guide...
The query returns the current setting of format: either ASCii or REAL. The FORMat data formatting is not affected by the TRACe subsystem data formatting. NOTE Example Sets the format to REAL. FORM REAL Reset condition On reset, the format is set to ASCii. Keysight U2040 X-Series Programming Guide...
Page 144
FORMat Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Page 145
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide INITiate Subsystem INITiate[1]:CONTinuous INITiate[1]:CONTinuous:ALL INITiate[1]:CONTinuous:SEQuence[1] INITiate[1][:IMMediate] INITiate[1][:IMMediate]:ALL INITiate[1][:IMMediate]:SEQuence[1] This chapter describes the INITiate subsystem commands.
INITiate[1]:CONTinuous ON|OFF|1|0 INITiate[1]:CONTinuous? Description This command sets the U2040 X-Series for either a single trigger cycle or continuous trigger cycles. A trigger cycle means that the U2040 X-Series exits the wait-for-trigger state and starts a measurement. If INITiate:CONTinuous is set to: –...
– 0 is returned when trigger sequences are not set to be continuous Example Sets all trigger sequences to be continuously initiated. INIT:CONT:ALL ON Reset condition On reset (*RST), this command is disabled. On preset (SYSTem:PRESet) and U2040 X-Series power-up, this command is enabled. Keysight U2040 X-Series Programming Guide...
INITiate[1]:CONTinuous:SEQuence[1] ON|OFF|1|0 INITiate[1]:CONTinuous:SEQuence[1]? Description This command sets the U2040 X-Series for either a single trigger cycle or continuous trigger cycles. A trigger cycle means that the U2040 X-Series exits the wait-for-trigger state and starts a measurement. If INITiate:CONTinuous:SEQuence[1] is set to: –...
This command performs the same function as NOTE INITiate[:IMMediate]:SEQuence[1]. Example Places the U2040 X-Series in the wait-for-trigger state. INIT Error message If the U2040 X-Series is not in the idle state or INITiate:CONTinuous is ON, error –213, “INIT ignored” occurs. Keysight U2040 X-Series Programming Guide...
INITiate[1][:IMMediate]:ALL Description This command initiates all trigger sequences. Example Initiates all trigger sequences. INIT:ALL Error message If the U2040 X-Series is not in the idle state or INITiate:CONTinuous is ON, error –213, “INIT ignored” occurs. Keysight U2040 X-Series Programming Guide...
This command sets the U2040 X-Series in the wait-for-trigger state. When a trigger is received, the measurement is taken and the result is placed in the U2040 X-Series memory. If TRIGger:SOURce is set to IMMediate, the measurement begins as soon as INITiate[1][:IMMediate] is executed.
Page 152
INITiate Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide INPut Subsystem INPut:TRIGger:IMPedance This chapter describes the INPut subsystem commands.
– LOW: 50 Ω – HIGH: 100 kΩ (default) The query returns the current trigger input impedance setting. This impedance setting is not cleared each time you cycle the U2040 X-Series power. NOTE Example Sets the trigger input impedance to low (50 Ω).
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide LXI Subsystem LXI:IDENtify[:STATe] This chapter describes the LXI subsystem commands.
The query indicates whether or not the LXI identification is enabled or disabled. – 1 is returned when the LXI identification is enabled – 0 is returned when the LXI identification is disabled Example Enables the LXI identification. LXI:IDEN 1 Keysight U2040 X-Series Programming Guide...
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate2 measurement of Channel A, using an expected power level of –20 dBm and a MEAS2? -20DBM,1,(@1) resolution setting of 1. Keysight U2040 X-Series Programming Guide...
Item Range of values Description/Defaul t value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
Item Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
Item Range of values Description/Defaul t value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
Item Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) 1 to 4 A numeric value for the resolution. If unspecified, the current resolution 1.0, 0.1, 0.01, 0.001...
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate1 relative measurement of Channel A, using an expected power level of MEAS1:REL? -10DBM,2,(@1) –10 dBm and a resolution setting of 2. Keysight U2040 X-Series Programming Guide...
Page 164
MEASure Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
MEMory:CATalog:STATe? Description This query is used to list the save/recall registers. The U2040 X-Series returns the data in the form of two numeric parameters and as many strings as there are save/recall registers. <numeric_value>,<numeric_value>{,<string>} – The first numeric parameter indicates the amount of memory, in bytes, used for the storage of registers.
Description This query is used to list the stored frequency-dependent offset, gamma, and S-parameter tables. The U2040 X-Series returns the data in the form of two numeric parameters and as many strings as there are stored tables. <numeric_value>,<numeric_value>{,<string>} – The first numeric parameter indicates the amount of memory, in bytes, used for the storage of tables.
This query lists the stored frequency-dependent offset, gamma, and S-parameter tables and save/recall registers. The U2040 X-Series returns the data in the form of two numeric parameters and as many strings as there are stored tables and save/recall registers: <numeric_value>,<numeric_value>{,<string>} –...
The contents cleared using this command are non-recoverable. NOTE Example Clears the contents of the currently selected table. MEM:CLE:TABL Error message If no table is selected, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Contains an existing table name or save/recall register. save/recall register. Example Clears the contents of frequency-dependent offset table MEM:CLE "TABLE1" “TABLE1”. Error message If the table or save/recall register name does not exist, error –224, “Illegal parameter value” occurs. Keysight U2040 X-Series Programming Guide...
MEMory Subsystem MEMory:FREE:STATe? Syntax MEMory:FREE:STATe? Description This query returns the amount of memory free for save/recall registers. The format of the response is: <bytes_available>,<bytes_in_use> Example Queries the amount of free memory for save/recall registers. MEM:FREE:STAT? Keysight U2040 X-Series Programming Guide...
Description This query returns the amount of memory free for frequency-dependent offset tables, gamma tables, and S-parameter tables.. The format of the response is: <bytes_available>,<bytes_in_use> Example Queries the amount of free memory for tables. MEM:FREE:TABL? Keysight U2040 X-Series Programming Guide...
This query returns the amount of memory free for frequency-dependent offset tables, gamma tables, S-parameter tables, and save/recall registers The format of the response is: <bytes_available>,<bytes_in_use> Example Queries the amount of free memory in total. MEM:FREE? Keysight U2040 X-Series Programming Guide...
Syntax MEMory:NSTates? Description This query returns the number of registers that are available for save/recall. As there are 10 registers, this query always returns 10. Example Queries the number of registers available for save/recall. MEM:NST? Keysight U2040 X-Series Programming Guide...
Range of values Description/Defaul t value Specifies the table type: FDOFfset – FDOFfset: Frequency-dependent offset character_data SGAMma – SGAMma: Gamma SPARam – SPARam: S-parameter Example Queries the number of available frequency-dependent MEM:NTAB? FDOF offset tables. Keysight U2040 X-Series Programming Guide...
MEMory Subsystem MEMory:STATe:CATalog? Syntax MEMory:STATe:CATalog? Description 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> Example Queries the register names. MEM:STAT:CAT? Keysight U2040 X-Series Programming Guide...
– 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). Keysight U2040 X-Series Programming Guide...
Ensure that the frequency points you use cover the frequency range of the signals that you want to measure. If you measure a signal with a frequency outside the frequency range defined in the table, then the U2040 X-Series uses the highest or lowest point in the table to calculate the value.
Page 179
– If a table has not been specified using the MEMory:TABLe:SELect command, the data cannot be entered into the table and error -221, “Settings conflict” occurs. – If a frequency is sent which is outside of the allowed frequency range, error -222, “Data out of range” occurs. Keysight U2040 X-Series Programming Guide...
<NRf>. If no frequency values have been set, this command returns 0. If no table is selected, this command returns NAN. Example Queries the number of frequency points in the current MEM:TABL:FREQ:POIN? table. Keysight U2040 X-Series Programming Guide...
– 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. Keysight U2040 X-Series Programming Guide...
Description/Default value numeric_value 1.0 to 150.0 A numeric value for the offset factors. The unit is PCT. Example Enters offset factors of 97%, 99.5%, and MEM:TABL:SEL "Table_1" 97.4% into the frequency-dependent offset MEM:TABL:GAIN 97,99.5,97.4 table. Keysight U2040 X-Series Programming Guide...
Page 183
– 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. Keysight U2040 X-Series Programming Guide...
This query is used to return the number of offset points for the currently selected table. If no values have been set, 0 is returned. If no table is selected, NAN is returned. Example Queries the number of offset points in the current table. MEM:TABL:GAIN:POIN? Keysight U2040 X-Series Programming Guide...
Details the new table name. A maximum of 12 characters character_data 0 to 9 can be used. _ (underscore) Example Selects a frequency-dependent offset table named MEM:TABL:SEL "Table1" “Table1”. Error message If the table name is invalid, error –224, “Illegal parameter value” occurs. Keysight U2040 X-Series Programming Guide...
– 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 magnitude or phase values are outside of the allowed range, error –222, “Data out of range” occurs. Keysight U2040 X-Series Programming Guide...
If no magnitude-phase values have been set, this query returns a 0. If no table is selected, this query returns NAN. Example Queries the number of magnitude-phase pairs for the MEM:TABL:SGAM:POIN? currently selected gamma table. Keysight U2040 X-Series Programming Guide...
– 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 magnitude or phase values are outside of the allowed range, error –222, “Data out of range” occurs. Keysight U2040 X-Series Programming Guide...
If no magnitude-phase values have been set, this query returns a 0. If no table is selected, this query returns NAN. Example Queries the number of S11 magnitude-phase pairs MEM:TABL:SPAR:POIN? S11 for the currently selected S-parameter table. Keysight U2040 X-Series Programming Guide...
Page 190
MEMory Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide OUTPut Subsystem OUTPut:TRIGger[1][:STATe] This chapter describes the OUTPut subsystem commands.
On reset, the trigger output signal is disabled. Error message The trigger output signal can be enabled in any trigger source except for the bus trigger source. If the trigger source is set to bus, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
The parameter DEFault is used as a placeholder. Specifying DEF leaves the parameter value unchanged. [b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate2 measurement. READ2:POW:AC? Keysight U2040 X-Series Programming Guide...
Page 195
– 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 specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) A numeric value for the resolution. If it is unspecified, the 1 to 4 current resolution setting is used.
Page 197
– If TRIGger:SOURce is set to BUS or HOLD, error –214, “Trigger deadlock” occurs. – If the resolution parameter is not the same as the current resolution setting on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) A numeric value for the resolution. If it is unspecified, the 1 to 4 current resolution setting is used.
Page 199
– If TRIGger:SOURce is set to BUS or HOLD, error –214, “Trigger deadlock” occurs. – If the resolution parameter is not the same as the current resolution setting on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) A numeric value for the resolution. If it is unspecified, the 1 to 4 current resolution setting is used.
Page 201
– If TRIGger:SOURce is set to BUS or HOLD, error –214, “Trigger deadlock” occurs. – If the resolution parameter is not the same as the current resolution setting on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Range of values Description/Default value expected_value sensor-dependent The U2040 X-Series ignores the numeric value entered in this (for the expected power parameter. Any value entered is treated like DEF. level) A numeric value for the resolution. If it is unspecified, the 1 to 4 current resolution setting is used.
Page 203
– If TRIGger:SOURce is set to BUS or HOLD, error –214, “Trigger deadlock” occurs. – If the resolution parameter is not the same as the current resolution setting on the specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
[b] When SENS:AVER:COUN:AUTO is enabled, the resolution setting affects the number of averages applied. Refer to “Auto-averaging mode” on page for more information. Example Queries the CALCulate1 relative measurement of READ:REL? DEF,1,(@1) Channel A, using the current range and a resolution of 1. Keysight U2040 X-Series Programming Guide...
Page 205
– 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 specified CALCulate block, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Page 206
READ Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Enters a video filter length of 16. AVER2:COUN 16 Reset condition On reset, the filter length is set to 4. Error message If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– 0 is returned when averaging is disabled. Example Enables video averaging. AVER2 1 Reset condition On reset, video averaging is disabled. Error message If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Description/Defaul t value A numeric value defining the filter length. 1 to 1024 – DEF: the default value is 4 numeric_value – MIN: 1 – MAX: 1024 Example Sets the filter length to 400. AVER:COUN 400 Keysight U2040 X-Series Programming Guide...
Page 212
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 to ON. Keysight U2040 X-Series Programming Guide...
The number of readings averaged together depends on the resolution and the power level in which the U2040 X-Series is currently operating. Refer to Figure 1-2 for the typical number of averages for each range and resolution when the U2040 X-Series is in the auto-filter mode and set to the normal speed mode.
Page 214
On reset, automatic averaging is enabled. Error message If [:SENSe[1]:]AVERage:COUNt:AUTO is set to ON while [:SENSe[1]:]MRATe is set to FAST, error –221, “Settings conflict” occurs. However, automatic averaging is enabled but the [:SENSe[1]:]AVERage:STATe command is not automatically set to Keysight U2040 X-Series Programming Guide...
This command resets the average filter. The reset will affect the filtering in the manual and auto averaging mode. Example Resets the average filter. AVER:RES Error message If AVER:RES is set while LIST:STAT is set to ON, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
With certain pulsed signals, step detection may prevent the final average from being NOTE completed and making the results unstable. Under these conditions, SENS:AVER:SDET should be set to OFF. Example Disables step detection. AVER:SDET OFF Reset condition On reset, step detection is enabled. Keysight U2040 X-Series Programming Guide...
– If [:SENSe[1]:]AVERage:STATe is set to ON while [:SENSe[1]:]MRATe is set to FAST, the error -221, “Settings conflict” occurs. – If [:SENSe[1]:]AVERage:STATe is set to ON while LIST:STAT is set to ON, error –221, “Settings conflict;list mode is running” occurs. Keysight U2040 X-Series Programming Guide...
SENSe Subsystem [:SENSe[1]:]BANDwidth|BWIDth:VIDeo Syntax [:SENSe[1]:]BANDwidth|BWIDth:VIDeo HIGH|MEDium|LOW|OFF [:SENSe[1]:]BANDwidth|BWIDth:VIDeo? Description This command sets the bandwidth of the U2040 X-Series. Values for HIGH, MEDium, LOW, and OFF are as shown below: MEDium HIGH 300 kHz 1.5 MHz 5 MHz 5 MHz The query returns the current bandwidth setting.
– 0 is returned when video bandwidth is disabled Example Turns on video bandwidth. BAND:VID:STAT ON Reset condition On reset, video bandwidth is disabled. Error message If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– If BUFF:COUN is set when TRIG:SOUR is not set to EXT, error –221, “Settings conflict. Invalid acquisition mode” occurs. – If BUFF:COUN is set when FREQ:STEP is not set to 0, error –221, “Settings conflict. Frequency sweep enabled. Buffer count overridden” occurs. Keysight U2040 X-Series Programming Guide...
– If BUFF:MTYP is set when TRIG:SOUR is not set to EXT or DET:FUNC is set to AVER, error –221, “Settings conflict. Invalid acquisition mode” occurs. – If the parameter set is an invalid string, error –224, “Illegal parameter value” occurs. Keysight U2040 X-Series Programming Guide...
On reset, the state is not affected. Error message If you attempt to set this command to ON and no table has been selected using [:SENSe[1]:]CORRection:CSET2[:SELect], then error –221, “Settings conflict” occurs and [:SENSe[1]:]CORRection:CSET2:STATe remains OFF. Keysight U2040 X-Series Programming Guide...
[:SENSe[1]:]CORRection:CSET3:STATe remains OFF. – If you set this command to ON and [:SENSe[1]:]CORRection:SGAMma:STATe is currently ON, [:SENSe[1]:]CORRection:SGAMma:STATe will be set to OFF and error –221, “Settings conflict; Single point gamma is being switched off” occurs. Keysight U2040 X-Series Programming Guide...
On reset, the state is not affected. Error message If you attempt to set this command to ON and no table has been selected using [:SENSe[1]:]CORRection:CSET4[:SELect], then error –221, “Settings conflict” occurs and [:SENSe[1]:]CORRection:CSET4:STATe remains OFF. Keysight U2040 X-Series Programming Guide...
MEMory:CATalog:TABLe?.) "DEFAULT": this is the default table name. "DEFAULT" Example Enters the name of the frequency-dependent offset table CORR:CSET2 "PW1" to be used. Reset condition On reset, the selected table is not affected. Keysight U2040 X-Series Programming Guide...
Page 226
– If a table called <string> does not exist, error –256, “File name not found” occurs. – When a frequency-dependent offset table is selected, the U2040 X-Series verifies that the number of offset points defined is equal to the number of frequency points defined.
– If a table called <string> does not exist, error –256, “File name not found” occurs. – When a gamma table is selected, the U2040 X-Series verifies that the number of magnitude-phase offset pairs defined is equal to the number of frequency points defined.
– If a table called <string> does not exist, error –256, “File name not found” occurs. – When an S-parameter table is selected, the U2040 X-Series verifies that the number of magnitude-phase pairs defined for S11, S12, S21, and S22 is equal to the number of frequency points defined.
Enables the pulse power measurement. CORR:DCYC:STAT 1 Reset condition On reset, the pulse power measurement is disabled. Error message If this command is used when SENSe:DET:FUNC is set to NORMal, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
The U2040 X-Series measures the average power in the pulsed input signal and then divides the result by the duty cycle value to obtain a pulse power reading.
Page 231
“Settings conflict” occurs. However, the duty cycle value is set but the SENSe:CORRection:DCYCle|GAIN3:STATe command is not automatically set to – If this command is used when SENSe:DET:FUNC is set to NORMal, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
[:SENSe[1]:]CORRection:FDOFfset|GAIN4[:INPut][:MAGNitude]? Syntax [:SENSe[1]:]CORRection:FDOFfset|GAIN4[:INPut][:MAGNitude]? Description This query is used to return the frequency-dependent offset currently being applied. Example Queries the current frequency-dependent offset being applied. CORR:GAIN4? Reset condition On reset, the frequency-dependent offset is not affected. Keysight U2040 X-Series Programming Guide...
[:SENSe[1]:]CORRection:GAIN2[:INPut]:STATe ON|OFF|1|0 [:SENSe[1]:]CORRection:GAIN2[:INPut]:STATe? Description This command is used to enable/disable a channel offset for the U2040 X-Series setup. The [:SENSe[1]:]CORRection:GAIN2[:INPut][:MAGNitude] command is used to enter the loss/gain value. The query enters 1 or 0 into the output buffer indicating the status of the channel offset.
[:SENSe[1]:]CORRection:GAIN2[:INPut][:MAGNitude] <numeric_value> [:SENSe[1]:]CORRection:GAIN2[:INPut][:MAGNitude]? [MIN|MAX] Description This command is used to enter a channel offset value for the U2040 X-Series setup, for example cable loss. The U2040 X-Series then corrects every measurement by this factor to compensate for the loss/gain. Entering a value for GAIN2 using this command automatically turns the [:SENSe[1]:]CORRection:GAIN2:STATe command to ON.
[:SENSe[1]:]CORRection:LOSS2[:INPut]:STATe ON|OFF|1|0 [:SENSe[1]:]CORRection:LOSS2[:INPut]:STATe? Description This command is used to enable/disable a channel offset for the U2040 X-Series setup. The [:SENSe[1]:]CORRection:LOSS2[:INPut][:MAGNitude] command is used to enter the gain/loss value. The query enters 1 or 0 into the output buffer indicating the status of the channel offset.
[:SENSe[1]:]CORRection:LOSS2[:INPut][:MAGNitude]? [MIN|MAX] Description This command is used to enter a channel offset value for the U2040 X-Series setup, for example system gain or a cable loss. The U2040 X-Series then corrects every measurement by this factor to compensate for the gain/loss.
Description This query returns the source gamma magnitude-phase pair which is currently being used in gamma correction. Example This query returns the source gamma magnitude-phase pair which CORR:SGAM? is currently being used in gamma correction. Keysight U2040 X-Series Programming Guide...
If you set this command to ON and [:SENSe[1]:]CORRection:CSET3:STATe is currently ON, it will set [:SENSe[1]:]CORRection:CSET3:STATe to OFF and error –221, “Settings conflict; Table based gamma is being switched off” will occur. This behavior indicates that both [:SENSe[1]:]CORRection:SGAMma:STATe and [:SENSe[1]:]CORRection:CSET3:STATe are mutually exclusive. Keysight U2040 X-Series Programming Guide...
CORR:SGAM:MAGN 0.5 reflection coefficient at 0.5. Reset condition On reset, the value is not affected. Error message If the input values are outside the acceptable range of values, error –222 “Data out of range” occurs. Keysight U2040 X-Series Programming Guide...
This command sets the phase of the source reflection CORR:SGAM:PHAS 45 coefficient at 45. Reset condition On reset, the value is not affected. Error message If the input values are outside the acceptable range of values, error –222 “Data out of range” occurs. Keysight U2040 X-Series Programming Guide...
Returns the magnitude-phase pair values. For S12, S21 × –5 × – Magnitude: (1.0 to 1.0 – Phase: (–180.0° ≤ p < +180.0°) Example Returns the current magnitude-phase pair values for the S11 CORR:SPAR? S11 S-parameter. Keysight U2040 X-Series Programming Guide...
This is the default measurement mode. [a] Applicable for U2042XA/U2044XA/U2049XA only. Example Sets the normal measurement mode. DET:FUNC NORM Reset condition On reset, the mode is set to AVERage. Keysight U2040 X-Series Programming Guide...
[a] The following measurement units can be used: – Hz – kHz (10 – MHz (10 – GHz (10 Example Enters a frequency of 500 kHz. FREQ 500kHz Reset condition On reset, the frequency is set to 50 MHz (DEF). Keysight U2040 X-Series Programming Guide...
1 kHz to 1000 GHz – DEF: the default value is 50 MHz numeric_value – MIN: 1 kHz – MAX: 1000 GHz The default unit is Hz. Example Enters a start frequency of 500 kHz. FREQ:STAR 500kHz Keysight U2040 X-Series Programming Guide...
Page 245
Reset condition On reset, the start frequency is set to 50 MHz (DEF). Error message If limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. Keysight U2040 X-Series Programming Guide...
1 kHz to 1000 GHz – DEF: the default value is 50 MHz numeric_value – MIN: 1 kHz – MAX: 1000 GHz Units are resolved to 1 kHz. Example Enters a stop frequency of 500 kHz. FREQ:STOP 500kHz Keysight U2040 X-Series Programming Guide...
Page 247
Reset condition On reset, the stop frequency is set to 50 MHz (DEF). Error message If limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. Keysight U2040 X-Series Programming Guide...
1 kHz. When the frequency range is less than the frequency sweep step size, the remaining steps will be repeated with the last frequency point. The query returns the current number of frequency steps. The format of the response is <NR1>. Keysight U2040 X-Series Programming Guide...
Page 249
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If the acquisition mode is in free run, error —221, “Setting conflict. Invalid acquisition mode” occurs. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:FREQ:STAR is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:FREQ:STOP is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. Keysight U2040 X-Series Programming Guide...
– If LIST:MTYP is set to "PEAK", "PTAV", or "MIN" when DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. – If LIST:MTYP is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:POIN is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. Keysight U2040 X-Series Programming Guide...
If LIST:STAT is set to ON when DET:FUNC is set to NORM, NOTE – SENS:SWE[1]|2|3|4:AUTO will be set to OFF. – SENS:TRAC:STAT will be set to OFF. – PST:CCDF:CONT will be set to OFF. – PST:CCDF:SWE:STAT will be set to OFF. Keysight U2040 X-Series Programming Guide...
The default value is 1. Units are resolved to 1. Example Sets the number of slots to 4. LIST:TSC 4 Reset condition On reset, the number of slots is set to 1. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 256
1 s, error –221, “Settings conflict;Capture buffer size too large. Please reduce time slot duration or count.” occurs. – If LIST:TSC is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:TSL:EXCL:OFFS:TIME is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:TSL:EXCL:TIME is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
1 s, error –221, “Settings conflict;Capture buffer size too large. Please reduce time slot duration or count.” occurs. – If LIST:TSL:TIME is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:TSL:TREF1 is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– If the limits of the values are exceeded, error –222, “Data out of range;value clipped to upper (or lower) limit” occurs. – If LIST:TSL:TREF2 is set while a sequence is running, error –221, “Settings conflict;list mode is running” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
CALCulate[1]|2|3|4:MATH:EXPRession "(SENSe1)" [a] This change occurs when setting the U2040 X-Series to FAST. When changing from FAST to NORMal or DOUBle, the settings that were in place when FAST was entered are restored. The query returns the current speed setting of either NORMal, DOUBle, or FAST.
Page 263
Sets the speed to 40 readings/second. MRAT DOUB Reset condition On reset, the speed is set to NORMal. Error message If <character_data> is not set to NORMal, DOUBle, or FAST, error –224, “Illegal parameter value” occurs. Keysight U2040 X-Series Programming Guide...
– If Auto Gate fails, error –221, “Settings conflict;Auto Once failed” occurs. – If this command is set to ON or ONCE while LIST:STAT is set to ON, error –221, “Settings conflict;list mode is enabled” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. – If the combined value of REF1 and REF2 exceeds 99.9%, error –222, “Data out of range” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Error messages – If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. – If SWEep:AUTO is set to ON for the selected gate, error –221, "Settings conflict" occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Error messages – If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. – If SWEep:AUTO is set to ON for the selected gate, error –221, "Settings conflict" occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
<50 μs and the frequency is changed from ≥300 MHz to <300 MHz, the aperture size will automatically be changed to 50 μs. Example Sets the aperture duration to 10 ms. SWE:APER 10E-3 Reset condition On reset, the aperture duration is set to 50 ms. Keysight U2040 X-Series Programming Guide...
Page 269
– If SENS:SWE:APER is set to <50 μs (for ≥300 MHz) and the frequency is then changed to <300 MHz, the aperture duration will automatically be changed to 50 μs with error –221, "Settings conflict;Aperture size too small. Changing to a minimum.". Keysight U2040 X-Series Programming Guide...
Disables automatic selection of the aperture duration. SWE:APER:AUTO OFF Reset condition On reset, automatic selection of the aperture duration is enabled. Error message If this command is enabled when SENS:DET:FUNC is set to NORM, error –221, "Settings conflict" occurs. Keysight U2040 X-Series Programming Guide...
SENSe Subsystem [:SENSe[1]:]TEMPerature? Syntax [:SENSe[1]:]TEMPerature? Description This query returns the U2040 X-Series bulkhead temperature in degree Celsius. Example Returns the current U2040 X-Series bulkhead temperature. TEMP? Reset condition On reset, this parameter is not affected. Keysight U2040 X-Series Programming Guide...
Sets the delay to 0.05 s. TRAC:OFFS:TIME 0.05 Reset condition On reset, the delay is set to 0 s. Error message If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
SENSe Subsystem [:SENSe[1]:]TRACe:TIME Syntax [:SENSe[1]:]TRACe:TIME <numeric_value> [:SENSe[1]:]TRACe:TIME? Description This command sets the duration of the trace for the U2040 X-Series. The query returns the current duration of the trace. Parameter Item Range of values Description/Defaul t value The length of the trace in seconds.
This command sets the unit for the trace. The query returns the current trace unit. Example Sets the trace unit to watts. TRAC:UNIT W Reset condition On reset, the unit is set to dBm. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
– If SENS:TRAC:AUT is set while TRAC:STAT is set to OFF, error –221, “Settings conflict” occurs. – If SENS:TRAC:AUT is set while TRIG:SOUR is set to EXT, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 276
SENSe Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:BIST:CW:ZSET:NUMber? Syntax SERVice:BIST:CW:ZSET:NUMber? Description This query returns the worst case error in the CW zero test invoked by the SERVice:BIST:PEAK[1]:ZSET command. Example Queries the worst case error in the CW zero test. SERV:BIST:CW:ZSET:NUM? Keysight U2040 X-Series Programming Guide...
Device Clear can be used to abort the PEAK linearity test. The "Self-Test Started" operation NOTE status bit can be used to check the status of the test. Example Initiates the PEAK linearity test. SERV:BIST:PEAK:LIN [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:BIST:PEAK[1]:LINearity:PERRor? Syntax SERVice:BIST:PEAK[1]:LINearity:PERRor? Description This query returns the PEAK linearity worst case error. Example Queries the PEAK linearity worst case error. SERV:BIST:PEAK:LIN:PERR? [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
SERVice:BIST:PEAK[1]:ZSET Description This command initiates the zero set and noise test for both peak and CW signals. – Ensure that the U2040 X-Series is not connected to the RF source when performing the NOTE test. – Device Clear can be used to abort the PEAK zero set and noise test. The "Self-Test Started"...
Syntax SERVice:BIST:PEAK[1]:ZSET:NUMber? Description This query returns the worst case error in the PEAK zero test invoked by SERVice:BIST:PEAK[1]:ZSET. Example Queries the worst case error in the PEAK zero test. SERV:BIST:PEAK:ZSET:NUM? [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Syntax SERVice:BIST:RAM:MODE <character_data> SERVice:BIST:RAM:MODE? Description This command sets the mode of the RAM self-test during U2040 X-Series power-on. The result of the RAM self-test will be verified when *TST? is executed. The query returns the current RAM self-test mode. Parameter...
– 1 is returned when the 10 MHz timebase signal is enabled. – 0 is returned when the 10 MHz timebase signal is disabled. Example Disables the 10 MHz timebase signal. SERV:BIST:TBAS:STAT OFF Reset condition On reset, the 10 MHz timebase signal is disabled. Keysight U2040 X-Series Programming Guide...
The format of the default value is “K-” + model number + “-” + last five digits of the instrument serial number: K-U2049XA-XXXXX Example The command presets the LAN hostname to its default value. SERV:LAN:PHOS [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
This command sanitizes the power sensor memory, for example, before you return it to Keysight for repair or calibration, of all data stored in it. The memory data sanitized includes the save/recall states, FDO tables, Gamma tables, and S-Parameter tables. Example Erases the power sensor memory. SERV:SEC:ERAS Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:CDATe? Syntax SERVice:SENSor[1]:CDATe? Description This query returns the calibration date. The calibration date information is stored in the U2040 X-Series EEPROM. Example Returns the calibration date. SERV:SENS:CDAT? Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:CPLace? Syntax SERVice:SENSor[1]:CPLace? Description This query returns the place of calibration. The calibration place information is stored in the U2040 X-Series EEPROM. Example Returns the place of calibration. SERV:SENS:CPL? Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:FREQuency:MAXimum? Syntax SERVice:SENSor[1]:FREQuency:MAXimum? Description This query returns the maximum frequency that can be measured by the U2040 X-Series. Example Returns the maximum frequency that can be SERV:SENS:FREQ:MAX? measured by the U2040 X-Series. Error message If the U2040 X-Series contains an invalid model number programmed into the EEPROM, error –56, “System error.
SERVice Subsystem SERVice:SENSor[1]:FREQuency:MINimum? Syntax SERVice:SENSor[1]:FREQuency:MINimum? Description This query returns the minimum frequency that can be measured by the U2040 X-Series. Example Returns the minimum frequency that can be SERV:SENS:FREQ:MIN? measured by the U2040 X-Series. Error message If the U2040 X-Series contains an invalid model number programmed into the EEPROM, error –56, “System error.
Returns the maximum average power that can be SERV:SENS:POW:AVER:MAX? measured by the U2040 X-Series. Error message If the U2040 X-Series contains an invalid model number programmed into the EEPROM, error –56, “System error. Invalid sensor model number.” occurs. Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:POWer:PEAK:MAXimum? Syntax SERVice:SENSor[1]:POWer:PEAK:MAXimum? Description This query returns the maximum peak power that can be measured by the U2040 X-Series. Example Returns the maximum peak power that can be SERV:SENS:POW:PEAK:MAX? measured by the U2040 X-Series. Error message If the U2040 X-Series contains an invalid model number programmed into the EEPROM, error –56, “System error.
Returns the maximum power that can be accurately SERV:SENS:POW:USAB:MAX? measured by the U2040 X-Series. Error message If the U2040 X-Series contains an invalid model number programmed into the EEPROM, error –56, “System error. Invalid sensor model number.” occurs. Keysight U2040 X-Series Programming Guide...
Returns the minimum power that can be accurately SERV:SENS:POW:USAB:MIN? measured by the U2040 X-Series. Error message If the U2040 X-Series contains an invalid model number programmed into the EEPROM, error –56, “System error. Invalid sensor model number.” occurs. Keysight U2040 X-Series Programming Guide...
This query returns a new raw uncorrected measurement in volts, as a 32-bit signed integer. Example Returns a new raw uncorrected measurement. SERV:SENS:RADC? Error message If INIT:CONT is set to ON, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:SNUMber? Syntax SERVice:SENSor[1]:SNUMber? Description This query returns the U2040 X-Series serial number. The serial number information is stored in the U2040 X-Series EEPROM. Example Returns the U2040 X-Series serial number. SERV:SENS:SNUM? Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SENSor[1]:TYPE? Syntax SERVice:SENSor[1]:TYPE? Description This query identifies the connected sensor type and returns the model number stored in the EEPROM. Example Returns the connected sensor model number. SERV:SENS:TYPE? Keysight U2040 X-Series Programming Guide...
SERVice Subsystem SERVice:SNUMber? Syntax SERVice:SNUMber? Description This query returns the U2040 X-Series serial number. The serial number information is stored in the U2040 X-Series EEPROM. Example Returns the U2040 X-Series serial number. SERV:SNUM? Keysight U2040 X-Series Programming Guide...
Page 299
Keysight U2040 X-Series Wide Dynamic Range 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:CHA STATus:QUEStionable:POWer[:SUMMary]...
– Operation status register – Questionable status register The contents of these and other registers in the U2040 X-Series are determined by one or more status registers. Table 18-1 summarizes the effects of various commands and events on these status...
Page 301
– STATus:OPERation:ULFail[:SUMMary] – STATus:PRESet – STATus:QUEStionable – STATus:QUEStionable:CALibration[:SUMMary] – STATus:QUEStionable:POWer:CHA – STATus:QUEStionable:POWer[:SUMMary] Examples 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 Keysight U2040 X-Series Programming Guide...
15 bits written into the Enable Register of the SCPI Register Set concerned. The last bit (bit 15) is always set to 0. Parameters Item Range of values Description/Default value The value used to set the Enable Register. 0 to 2 –1 non-decimal numeric Keysight U2040 X-Series Programming Guide...
Page 303
Transition Register of the SCPI Register Set concerned. The last bit (bit 15) is always set to Parameters Item Range of values Description/Defaul t value The value used to set the PTR Register. 0 to 2 –1 non-decimal numeric Keysight U2040 X-Series Programming Guide...
Page 304
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). Keysight U2040 X-Series Programming Guide...
The following command descriptions detail the SCPI register you require to control but do not detail the register set commands. The one device status register set is: STATus:DEVice: The following bit in these registers is used by the U2040 X-Series: Bit number Decimal weight Definition...
STATus Subsystem Operation Register Sets The following registers contain information which is part of the U2040 X-Series 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” on page 302.
STATus:OPERation Description The operation status register set contains conditions which are a part of the operation of the U2040 X-Series as a whole. The following bits in these registers are used by the U2040 X-Series: Bit number Decimal weight Definition...
Syntax STATus:OPERation:CALibrating[:SUMMary] Description The operation status calibrating summary register set contains information on the calibrating status of the U2040 X-Series. The following bit in these registers is used by the U2040 X-Series: Bit number Decimal weight Definition Not used CALibrating Status...
STATus:OPERation:LLFail[:SUMMary] Description The operation status lower limit fail summary register set contains information on the lower limit fail status of the U2040 X-Series. The following bits in these registers are used by the U2040 X-Series: Bit number Decimal weight Definition...
Definition Not used MEASuring Status 2 to 15 Not used (bit 15 is always 0) This bit is set when the U2040 X-Series is taking a measurement, and is cleared when the measurement has completed. Keysight U2040 X-Series Programming Guide...
2 to 15 Not used (bit 15 is always 0) This bit is set when the U2040 X-Series is reading data from the EEPROM, and is cleared when the U2040 X-Series is not reading data from the EEPROM. Keysight U2040 X-Series Programming Guide...
2 to 15 Not used (bit 15 is always 0) This bit is set when the U2040 X-Series enters the “wait for trigger” state, and is cleared when the U2040 X-Series enters the “idle” state. Keysight U2040 X-Series Programming Guide...
STATus:OPERation:ULFail[:SUMMary] Description The operation status upper limit fail summary register set contains information on the upper limit fail status of the U2040 X-Series. The following bits in these registers are used by the U2040 X-Series: Bit number Decimal weight Definition...
PRESet value ENABle all zeros OPERational all ones all zeros ENABle all zeros QUEStionable all ones all zeros ENABle all zeros DEVice all ones all zeros ENABle all ones All others all ones all zeros Keysight U2040 X-Series Programming Guide...
The questionable register sets contain information which gives an indication of the quality of the data produced by the U2040 X-Series. The contents of the individual registers in these register sets may be accessed by appending the commands listed in “Status Register Set Commands”...
STATus:QUEStionable Description The questionable register set contains information that indicates the quality of various aspects of signals processed by the U2040 X-Series. The following bits in these registers are used by the U2040 X-Series: Bit number Decimal weight Definition 0 to 2...
Description The questionable calibration summary register set contains information which gives an indication of the quality of the data produced by the U2040 X-Series due to its calibration status. The following bit in these registers is used by the U2040 X-Series:...
– Error –230, "Data corrupt or stale" – Error –231, “Data questionable;Input Overload” This bit is cleared when no errors or events are detected by the U2040 X-Series during a measurement covering the causes given for it to set. Keysight U2040 X-Series Programming Guide...
– Error –231, “Data questionable;CALC3 log error” – Error –231, “Data questionable;CALC4 log error” These bits are cleared when no errors or events are detected by the U2040 X-Series during a measurement covering the causes given for it to set.
Operation Upper Limit Fail Summary STAT:OPER:SENS:SUMM SENSe LLFail Status SENSe ULFail Status CALCulate1 LLFail Status CALCulate1 ULFail Status CALCulate2 LLFail Status CALCulate2 ULFail Status CALCulate3 LLFail Status CALCulate3 ULFail Status CALCulate4 LLFail Status CALCulate4 ULFail Status STAT:OPER:LLF:SUMM STAT:OPER:ULF:SUMM Keysight U2040 X-Series Programming Guide...
Description This command enables the AutoIP protocol to dynamically assign the IP address when connecting to the U2040 X-Series in an isolated (non-site) LAN network (for example, PC to U2040 X-Series). The query enters a 1 or 0 into the output buffer indicating the AutoIP status.
– 1 is returned if DHCP is enabled – 0 is returned if DHCP is disabled Example This command enables the DHCP. SYST:COMM:LAN:DHCP ON Reset condition On reset, DHCP is enabled. [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
SYSTem Subsystem SYSTem:COMMunicate:LAN:ADDRess Syntax SYSTem:COMMunicate:LAN:ADDRess <character_data> SYSTem:COMMunicate:LAN:ADDRess? Description This command sets the LAN (IP) address of the U2040 X-Series. The query returns the current setting of the LAN IP address. Parameter Item Range of values Description/Default value Numeric character values for the address.
SYSTem Subsystem SYSTem:COMMunicate:LAN:DGATeway Syntax SYSTem:COMMunicate:LAN:DGATeway <character_data> SYSTem:COMMunicate:LAN:DGATeway? Description This command sets the LAN IP router/gateway address for the U2040 X-Series. The query returns the current setting of the LAN gateway address. Parameter Item Range of values Description/Defaul t value Numeric character values for the address.
SYSTem Subsystem SYSTem:COMMunicate:LAN:DNAMe Syntax SYSTem:COMMunicate:LAN:DNAMe <character_data> SYSTem:COMMunicate:LAN:DNAMe? Description This command sets the domain name for the U2040 X-Series. The query returns the current setting of the LAN domain name. Parameter Item Range of values Description/Defaul t value character_data Maximum of 16 characters...
SYSTem:COMMunicate:LAN:HNAMe? Description This command sets the host name for the U2040 X-Series. The factory default setting of the host name is in this format: K- + prod uct number + - + suffix five d igits of serial number (K-U2049XA-XXXXX) The query returns the current setting of the LAN host name.
SYSTem Subsystem SYSTem:COMMunicate:LAN:MAC Syntax SYSTem:COMMunicate:LAN:MAC? Description This query returns the LAN MAC address. Example This command queries the current MAC address. SYST:COMM:LAN:MAC? [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
SYSTem Subsystem SYSTem:COMMunicate:LAN:SMASk Syntax SYSTem:COMMunicate:LAN:SMASk <character_data> SYSTem:COMMunicate:LAN:SMASk? Description This command sets the subnet mask of the U2040 X-Series. The query returns the current setting of the LAN subnet mask. Parameter Item Range of values Description/Defaul t value Numeric character values for the address.
SYSTem Subsystem SYSTem:COMMunicate:LAN:RESTart Syntax SYSTem:COMMunicate:LAN:RESTart Description This command restarts the U2040 X-Series network stack; any LAN configuration changes can only take effect after this is performed. Example This command restarts the LAN network with a new SYST:COMM:LAN:REST configuration. [1] Applicable for U2049XA only.
Syntax SYSTem:COMMunicate:LAN:CURRent:ADDRess? Description This query returns the current setting of the IP address in use by the U2040 X-Series. If DHCP or AutoIP is enabled and successful, then one of these IP address modes assigns NOTE the IP address, otherwise it is the static IP address.
If DHCP or AutoIP are enabled and successful, then one of these IP address modes assigns NOTE the LAN IP router/gateway address, otherwise it is the static LAN IP router/gateway address. Example Queries the current setting of the LAN IP SYST:COMM:LAN:CURR:DGAT? router/gateway address. [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
If DHCP or AutoIP is successfully enabled, then one of these IP address modes assigns the NOTE LAN domain name, otherwise it is the static LAN domain name. Example Queries the current setting of the LAN domain SYST:COMM:LAN:CURR:DNAM? name. [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
If DHCP or AutoIP is successfully enabled, then one of these IP address modes assigns the NOTE LAN subnet mask, otherwise it is the static LAN subnet mask. Example Queries the current setting of the LAN subnet SYST:COMM:LAN:CURR:SMAS? mask. [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
LAN setting. Parameter Item Range of values Description/Defaul t value Desired timeout in seconds between 0 seconds (no timeout) to 7200 seconds (2 <numeric_value> 0 s to 7200 s hours) [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 336
SYSTem Subsystem Example This command sets the timeout to 1800 SYST:COMM:LAN:KEEP 1800 seconds (30 minutes). The query returns the timeout currently SYST:COMM:LAN:KEEP? being used. Keysight U2040 X-Series Programming Guide...
This query returns the socket number of control from the SCPI/SOCKET connection. Example Queries the socket number. SYST:COMM:TCP:CONT? Error message If the wrong connection type is used, error -310, “System error” occurs. [1] Applicable for U2049XA only. Keysight U2040 X-Series Programming Guide...
This query returns error numbers and messages from the U2040 X-Series error queue. When an error is generated by the U2040 X-Series, it stores an error number and its corresponding message in the error queue. One error is removed from the error queue each time this query is executed.
Page 339
For example, SENSeAVERageCOUNt 8. Undefined header A command was received that is not valid for the U2040 X-Series. You may have misspelled the –113 command, it may not be a valid command, or you may have the wrong interface selected. If you are using the short form of the command, remember that it may contain up to four letters.
Page 340
Trigger ignored –211 Indicates that *TRG or TRIG:IMM was received and recognized by the U2040 X-Series but was ignored because the U2040 X-Series was not in the wait-for-trigger state. Init ignored Indicates that a request for measurement initiation was ignored as the U2040 X-Series was already initiated.
Page 341
System error;Sensor EEPROM Read Failed - critical data not found or unreadable –310 This indicates a failure with the U2040 X-Series. Refer to the manual for details on returning it for repair. System error;Sensor EEPROM Read Completed OK but optional data block(s) not found or unreadable –310...
Page 342
*RST (reset) command has been executed. Query UNTERMINATED The U2040 X-Series was addressed to talk (that is, to send data over the interface) but a command has –420 not been received which sends data to the output buffer. For example you may have executed a CONFigure command (which does not generate data) and then attempted to read data from the remote interface.
SYSTem:HELP:HEADers? Syntax SYSTem:HELP:HEADers? Description This query returns a list of all SCPI commands supported by the U2040 X-Series. Data is returned in the IEEE-488.2 arbitrary block program data format as shown in Figure 19-1 below. #xyyy..yddd....ddd<LF> The number of data bytes (d)
Syntax SYSTem:PRESet [<character_data>[,<character_data>]] Description This command presets the U2040 X-Series to values appropriate for measuring the communications format (specified by the first <character_data>) based on the measurement mode (specified by the second <character_data>). The U2040 X-Series is preset to default values if no value or the value DEFault is supplied.
Page 345
AVERage – AVERage: sets to the average mode. [a] If this parameter is not specified, the command will preset the U2040 X-Series to values appropriate for measuring the communications format based on the current measurement mode defined by SENS:DET:FUNC. [b] Applicable for U2042XA/U2044XA/U2049XA only.
SYSTem Subsystem Preset values DEFault Table 19-1 shows the U2040 X-Series presets when <character_data> is set to DEFault or omitted. Table 19-1 DEFault: U2040 X-Series presets Command Setting Comment “POW:AVER” Select average measurement type CALC[1]|2|3|4:FEED[1]|2 0.000 dB Calc offset value...
Page 347
SYSTem Subsystem Table 19-1 DEFault: U2040 X-Series presets (continued) Command Setting Comment 0.0 dB Enter channel offset value [SENS[1]:CORR:GAIN2[:INP][:MAGN] AVER Measurement mode [SENS[1]:]DET:FUNC +50.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] List mode [SENS[1]:]LIST:STAT List mode select average AVER [SENS[1]:]LIST:MTYP measurement type NORM...
Delay between recognition of trigger 20 μs TRIG[:SEQ]:DEL event and start of a measurement 428 μs Trigger holdoff TRIG[:SEQ]:HOLD How far a signal must fall/rise before a TRIG[:SEQ]:HYST rising or falling edge can be detected Keysight U2040 X-Series Programming Guide...
— using the internal RF level trigger. The internal level trigger is set to –15 dBm. Trigger level hysteresis is used to prevent the U2040 X-Series re-triggering on the varying power levels within the EDGE burst. Time gating is used to measure the average power and peak-to-average ratio in the useful part of the RF burst.
–15 dBm Power level TRIG[:SEQ]:LEV Trigger event recognized on the rising TRIG[:SEQ]:SLOP edge of a signal Delay between recognition of trigger TRIG[:SEQ]:DEL event and start of a measurement 650 μs Trigger holdoff TRIG[:SEQ]:HOLD Keysight U2040 X-Series Programming Guide...
Time gating is therefore set to 10 ms. Triggering is set to occur continuously internally to the U2040 X-Series. The internal trigger is set to AutoLevel. A reading over the 10 ms period is returned and the reading is then re-initiated for the next 10 ms period.
Time gating is set to 10 ms. Triggering is set to occur continuously internally to the U2040 X-Series. The internal trigger is set to AutoLevel. A reading over the 10 ms period is returned then re-initiated for the next 10 ms period.
Time gating is set to 10 ms. Triggering is set to occur continuously internally to the U2040 X-Series. The internal trigger is set to AutoLevel. A reading over the 10 ms period is returned, then the reading is re-initiated for the next 10 ms period.
TRIG[:SEQ[1]]:SOUR Trigger source setup and acquisition mode continuous triggering INIT:CONT Disable automatic setting of the TRIG[:SEQ]:LEV:AUTO trigger level –15 dBm Automatic power level TRIG[:SEQ]:LEV Trigger event recognized on the rising TRIG[:SEQ]:SLOP edge of a signal Keysight U2040 X-Series Programming Guide...
SYSTem Subsystem MCPa Table 19-18 shows the U2040 X-Series presets when <character_data> is set to MCPa. Table 19-18 MCPa: U2040 X-Series presets Command Setting Comment Frequency +1900.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
Page 372
SYSTem Subsystem RADar Table 19-20 shows the U2040 X-Series presets when <character_data> is set to RADar. Table 19-20 RADar: U2040 X-Series presets Command Setting Comment Frequency +10 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem WL802DOT11A Table 19-22 shows the U2040 X-Series presets when <character_data> is set to WL802DOT11A. Table 19-22 WL802DOT11A: U2040 X-Series presets Command Setting Comment Frequency +5200.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem WL802DOT11B/G Table 19-24 shows the U2040 X-Series presets when <character_data> is set to WL802DOT11B/G. Table 19-24 WL802DOT11B: U2040 X-Series presets Command Setting Comment Frequency +2.400 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem XEVDO Table 19-26 shows the U2040 X-Series presets when <character_data> is set to XEVDO. Table 19-26 XEVDO: U2040 X-Series presets Command Setting Comment Frequency +1900.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem XEVDV Table 19-28 shows the U2040 X-Series presets when <character_data> is set to XEVDV. Table 19-28 XEVDV: U2040 X-Series presets Command Setting Comment Frequency +1900.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem TDSCdma Table 19-30 shows the U2040 X-Series presets when <character_data> is set to TDSCdma. Table 19-30 TDSCdma: U2040 X-Series presets Command Setting Comment Frequency +1900.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem Table 19-32 shows the U2040 X-Series presets when <character_data> is set to DVB. Table 19-32 DVB: U2040 X-Series presets Command Setting Comment Frequency +660.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem HIPERLAN2 Table 19-34 shows the U2040 X-Series presets when <character_data> is set to HIPERLAN2. Table 19-34 HIPERLAN2: U2040 X-Series presets Command Setting Comment Frequency +5200.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem WIMAX Table 19-36 shows the U2040 X-Series presets when <character_data> is set to WIMAX. Table 19-36 WIMAX: U2040 X-Series presets Command Setting Comment Frequency +3.5 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem HSDPA Table 19-38 shows the U2040 X-Series presets when <character_data> is set to HSDPA. Table 19-38 HSDPA: U2040 X-Series presets Command Setting Comment Frequency +1900.000 MHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem Table 19-40 shows the U2040 X-Series presets when <character_data> is set to DME. Table 19-40 DME: U2040 X-Series presets Command Setting Comment Frequency +1.1 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger –2 μs...
SYSTem Subsystem DMEPRT Table 19-42 shows the U2040 X-Series presets when <character_data> is set to DMEPRT. Table 19-42 DMEPRT: U2040 X-Series presets Command Setting Comment Frequency +1.1 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem LTEFDD Table 19-44 shows the U2040 X-Series presets when <character_data> is set to LTEFDD. Table 19-44 LTEFDD: U2040 X-Series presets Command Setting Comment Frequency +2.0 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem LTETDD Table 19-44 shows the U2040 X-Series presets when <character_data> is set to LTETDD. Table 19-46 LTETDD: U2040 X-Series presets Command Setting Comment Frequency +2.0 GHz Frequency setting [SENS[1]:]FREQ[:CW|:FIX] AVERage measurement mode Trigger setup Delay between recognition of trigger...
SYSTem Subsystem SYSTem:SET Syntax SYSTem:SET <arbitrary_block_data> Description This command is used to set the U2040 X-Series state as defined by the data returned by the *LRN? query. Parameter Item Range of values Description/Defaul t value arbitrary_block_data The block data returned by the *LRN query.
Syntax SYSTem:VERSion? Description This query returns the version of SCPI used in the U2040 X-Series. The response is in the form of XXXX.Y, where XXXX is the year and Y is the version number. Example Queries which version of SCPI is used in the U2040 X-Series.
Page 402
SYSTem Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
– If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. – If TRIG:SOUR is not INT or EXT, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
This command is included for compatibility purposes only. It has the same purpose as NOTE [:SENSe[1]:]TRACe:UNIT, which is the preferred command. Example Sets the trace unit to watts. TRAC:UNIT W Reset condition On reset, the unit is set to dBm. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
The MS byte is transmitted first. Each complete block is terminated by a line feed. The TRACe data formatting is not affected by the FORMat subsystem formatting. NOTE [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 407
INIT command for example), TRACe? waits until the trigger takes place before executing. If trigger conditions are not satisfied - when the trigger level differs greatly from the signal level for example - this can give the impression that the U2040 X-Series has stopped responding.
Sets the trace pulse duration measurements to look for TRAC:DEF:DUR:REF 25 the 25% reference levels. Reset condition On reset, the reference level will become 50%, which is the default value (DEF). [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Sets the trace transition measurements to look for TRAC:DEF:TRAN:REF 1,81 the 1% and 81% reference levels. Reset condition On reset, the reference level will be set to 10% and 90% respectively. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Returns the high state power for the trace. TRAC:MEAS:REF? 100 Error message If TRIG:SOUR is not set to INT[1] or EXT, or SENS:DET:FUNC is not set to NORM, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Description/Defaul t value numeric_value –25 to 125% Reference level in percentage Example Returns the time instant for the trace when the power is transitioned through the 25% reference TRAC:MEAS:INST:REF? 25 level. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
Page 417
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns 9.91E37 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns +0.00000000E+000 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns +0.00000000E+000 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
Page 421
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns +0.00000000E+000 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
Page 422
If you attempt to measure a pulse out of the range of the capture, for example, measure the NOTE fifth pulse and there are only four pulses, the U2040 X-Series returns +0.00000000E+000 as the result. [1] Applicable for U2042XA/U2044XA/U2049XA only.
Page 423
The query returns the unit of the tilt (droop) measurement. Example Sets the unit to % for the tilt (droop) measurement. TRAC:MEAS:TILT:UNIT PCT Reset condition On reset, the unit is set to dB. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 424
Sets the delay to 0.05 s. TRAC:OFFS:TIME 0.05 Reset condition On reset, the delay is set to 0 s. Error message If DET:FUNC is set to AVER, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 425
TRACe Subsystem TRACe[1]:TIME Syntax TRACe[1]:TIME <numeric_value> TRACe[1]:TIME? Description This command sets the duration of the trace for the U2040 X-Series. The query returns the current duration of the trace. Parameter Item Range of values Description/Defaul t value The length of the trace in seconds.
Page 426
– If TRAC:AUT is set while TRAC:STAT is set to OFF, error –221, “Settings conflict” occurs. – If TRAC:AUT is set while TRIG:SOUR is set to EXT, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 427
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide TRIGger Subsystem TRIGger[1][:SEQuence[1]]:COUNt TRIGger[1][:SEQuence[1]]:DELay TRIGger[1][:SEQuence[1]]:DELay:AUTO TRIGger[1][:SEQuence[1]]:HOLDoff TRIGger[1][:SEQuence[1]]:HYSTeresis TRIGger[1][:SEQuence[1]][:IMMediate] TRIGger[1][:SEQuence[1]]:LEVel TRIGger[1][:SEQuence[1]]:LEVel:AUTO TRIGger[1][:SEQuence[1]]:QUALifier:TIME TRIGger[1][:SEQuence[1]]:SLOPe TRIGger[1][:SEQuence[1]]:SOURce This chapter describes the TRIGger subsystem commands.
Page 428
The number of triggered events for the measurement cycle. 1 to 200 – DEF: the default value is 1 numeric_value – MIN: 1 – MAX: 200 Example Sets the number of triggered events to 10 for the TRIG:COUN 10 measurement cycle. Keysight U2040 X-Series Programming Guide...
Page 429
TRIGger Subsystem Reset condition On reset, the value is set to 1. Error message If COUNt >1 when [:SENSe[1]:]MRATe is set to NORMal or DOUBle, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Page 430
The query returns the current setting of the trigger delay or the value associated with MIN and MAX. Error message If the trigger source is not set to INT or EXT while setting TRIGger[:SEQuence]:DELay, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Page 431
When this command is set to: – ON, the U2040 X-Series inserts a settling-time delay before taking the requested measurement and for subsequent measurements. This settling time allows the internal digital filter to be updated with new values to produce valid, accurate measurement results.
Page 432
The query returns the current trigger holdoff setting or the value associated with MIN and MAX. Error message If the trigger source is not set to INT or EXT while setting TRIGger[:SEQuence]:HOLDoff, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Page 433
The query returns the current value in dB or the values associated with MIN and MAX. Error message If the trigger source is not set to INT or EXT while setting TRIGger[:SEQuence]:HYSTeresis, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 434
It causes the immediate exit of the event detection layer if the trigger system is in this layer when the command is received. In other words, the U2040 X-Series stops waiting for a trigger and takes a measurement ignoring any delay set by TRIG:DELay.
Page 435
The query returns the current power level setting or the values associated with MIN and MAX. Error message If the trigger source is not set to INT while setting TRIGger[:SEQuence]:LEVel, error –221, “Settings conflict” occurs. [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 436
The query enters a 1 or 0 into the output buffer indicating the status of TRIGger[1][:SEQuence[1]]:LEVel:AUTO. – 1 is returned when it is ON – 0 is returned when it is OFF [1] Applicable for U2042XA/U2044XA/U2049XA only. Keysight U2040 X-Series Programming Guide...
Page 437
– If this command is sent when TRIG:SOUR is not set to EXTernal or INTernal[1], error –221, “Settings conflict” occurs. – If the limits of the values are exceeded, error –222, “Data out of range” occurs. Keysight U2040 X-Series Programming Guide...
Page 438
On reset, the value is set to POSitive. Query TRIGger[1][:SEQuence[1]]:SLOPe? The query returns the current value of <character_data>. Error message If the trigger source is not set to INT or EXT while setting TRIGger[:SEQuence]:SLOPe, error –221, “Settings conflict” occurs. Keysight U2040 X-Series Programming Guide...
Page 439
– BUS: the trigger source is the group execute trigger <GET> bus command, a *TRG common command, or the TRIGger:IMMediate SCPI command. – EXTernal: the trigger source is the external trigger input. – HOLD: triggering is suspended. The only way to trigger the U2040 X-Series is EXTernal to use TRIGger:IMMediate. HOLD source –...
Page 440
TRIGger Subsystem Example Configures the U2040 X-Series for immediate triggering. TRIG:SOUR IMM Reset condition On reset, the trigger source is set to IMMediate. Query TRIGger[1][:SEQuence[1]]:SOURce? The query returns the current trigger source. Error messages – If TRIG:SOUR is not set to EXT while LIST:STAT is set to ON, error –221, “Settings conflict;list mode is enabled”...
Page 441
Keysight U2040 X-Series Wide Dynamic Range Power Sensors Programming Guide UNIT Subsystem UNIT[1]|2|3|4:POWer UNIT[1]|2|3|4:POWer:RATio This chapter describes the UNIT subsystem commands.
Page 442
Sets the power measurement unit of dBm for CALCulate1. UNIT:POW DBM Reset condition On reset, all CALCulate blocks are set to DBM. Query UNIT[1]|2|3|4:POWer? The query returns the current setting of the power measurement unit. Keysight U2040 X-Series Programming Guide...
Page 443
Example Sets the ratio measurement unit of dB for CALCulate1. UNIT:POW:RAT DB Reset condition On reset, the value is set to dB. Query UNIT[1]|2|3|4:POWer:RATio? The query returns the current setting of the ratio measurement unit. Keysight U2040 X-Series Programming Guide...
Page 444
UNIT Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight U2040 X-Series Programming Guide...
Page 445
Example 2: Achieve Measurement Speed of >20000 Readings/s Example 3: Achieve Fast Measurement Speed of 50000 Readings/s Example 4: Capture Every Timeslot in GSM Frames This chapter provides programming sequence examples to remotely control the U2040 X-Series using SCPI commands.
Page 446
Example 1: Two Time Slot GSM Measurement The following command sequence provides the example to perform the two time slot GSM measurement. “=>” indicates the commands that you send to the U2040 X-Series. NOTE Configuration stage // Sets the trigger source to external trigger input.
Page 447
// Sets the measurement mode to normal. => SENS:DET:FUNC NORM // Sets the measurement speed to fast mode. => SENS:MRAT FAST Sets the buffer size of the U2040 X-Series to 100 to store 100 => TRIG:COUN 100 measurement readings. // Fetches the reading.
Page 448
// Sets the trigger source to external trigger input. => TRIG:SOUR EXT // Sets the measurement speed to fast mode. => SENS:MRAT FAST Sets the buffer size of the U2040 X-Series to 100 to store 100 => TRIG:COUN 100 measurement readings. // Disables auto-zeroing.
Page 449
=> SENS:DET:FUNC AVER // Sets the measurement speed to fast mode. => SENS:MRAT FAST Sets the buffer size of the U2040 X-Series to 200 to store 200 => TRIG:COUN 200 measurement readings. Sets the aperture size to 20 μs (and measurement throughput to 50000 =>...
Page 450
=> SENS:AVER:SDET OFF // Sets the measurement speed to fast mode. => SENS:MRAT FAST Sets the buffer size of the U2040 X-Series to 128 to store 128 => TRIG:COUN 128 measurement readings. // Sets the trigger source to external trigger input.
Need help?
Do you have a question about the U2040 X-Series and is the answer not in the manual?
Questions and answers