Page 1
Keysight 8990B Peak Power Analyzer Programming Guide...
Page 2
Declaration of Conformity. and the DFARS and are set forth specifically in writing elsewhere in the WARNING EULA. Keysight shall be under no obligation to update, revise or A WARNING notice denotes a hazard. It otherwise modify the Software. With...
Page 15
23 Programming Examples Example 1: Identifying the 8990B In Use ..... . .548 Example 2: Making Pulse Characterization Measurement ..549 Example 3: Making Delay Measurement .
Page 16
THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 17
Test setup for delay measurement ....552 Figure 23-3 Test setup for droop measurement ....555 Keysight 8990B Programming Guide...
Page 18
THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 19
....56 Table 2-4 Bit definitions: Status Byte register ....58 Table 15-1 Commands and events affecting the status registers . . . Keysight 8990B Programming Guide...
Page 20
THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 21
Keysight 8990B Peak Power Analyzer Programming Guide 8990B Remote Operation Introduction Introduction to the SCPI Language Remote Interface Connections Status Reporting Using the Operation Complete Commands Summary of Commands This chapter provides an overview on programming the 8990B peak power analyzer.
8990B Remote Operation Introduction This chapter contains the following sections which provide the information on configuring the 8990B remotely: – “Introduction to the SCPI Language” on page 23 – “Remote Interface Connections” on page 31 – “Status Reporting” on page 34 –...
(for the specified root-level command) of the command tree. You must separate command mnemonics from each other using a colon. You can omit the leading colon if the command is the first of a new program line. Keysight 8990B Programming Guide...
Page 24
To avoid this, do not send a query without reading the response. When you cannot avoid this situation, send a Device Clear before sending the second query. Keysight 8990B Programming Guide...
Page 25
IEEE-488.2 interface standard. The “*” commands are used to control the reset, clear status, identification request, self-test, wait-before-execution, and status operations in the 8990B. Syntax conventions Throughout this guide, the following conventions are used for SCPI command syntax: –...
Page 26
The format is defined as shown in the following figure. <upper/lower case alpha> <upper/lower case alpha> <digit> Figure 1-2 <character_data> format <NAN> definition Not a number (NAN) is represented as 9.91E37. Not a number is defined in IEEE 754. Keysight 8990B Programming Guide...
Page 27
(that is, hexadecimal, octal, and binary). Examples of non-decimal numeric include #HA2F, #ha4e, #Q62, #q15, and #B01011. Figure 1-3 shows the non-decimal numeric standard data structures. <digit> Figure 1-3 <non-decimal numeric> format Keysight 8990B Programming Guide...
Page 28
– +146 – –12345 <NR2> definition Throughout this document, the <NR2> numeric response data is defined as: digit digit Figure 1-5 <NR2> format The following shows the examples of <NR2>: – 12.3 – +1.2345 – –0.123 Keysight 8990B Programming Guide...
Page 29
G (Giga), MA (Mega), K (kilo), M (milli), U (micro), N (nano), and P (pico). The unit suffixes are not case-sensitive. <string> definition Throughout this document, <string> is used to represent 7-bit ASCII characters. Keysight 8990B Programming Guide...
Page 30
A <carriage return> followed by a <newline> is also accepted. Many programming languages allow you to specify a message terminator character or EOI state to be automatically sent with each bus transaction. Message termination always sets the current path back to the root-level. Keysight 8990B Programming Guide...
Keysight IO Libraries Suite software. If you have installed other I/O software, refer to the documentation that accompanies the software. 1 After the I/O software has been installed on your PC, connect the 8990B to your PC using a Type A-to-Type B USB cable.
Page 32
Keysight IO Libraries Suite software. If you have installed other I/O software, refer to the documentation that accompanies the software. 1 Using a standard LAN patch cable, connect both the PC and the 8990B to LAN outlets. 2 Use the Connection Expert utility of the IO Libraries Suite to add the 8990B and verify the connection.
Page 33
– If the 8990B is not detected automatically on the Connection Expert, you can NOTE manually insert a known IP address of the 8990B to detect it. To obtain this IP address, go to the 8990B front panel display and select Tools > Remote Setup.
8990B Remote Operation Status Reporting Status reporting is used to monitor the 8990B to determine when events have occurred. Status reporting is accomplished by configuring and reading status registers. The 8990B has the following main registers: – Status Byte Register –...
Page 35
Condition register The condition register continuously monitors the hardware and firmware status of the 8990B. There is no latching or buffering for this register; it is updated in real time. Condition registers are read-only. Transition filter The transition filter specifies which type of changes to the bit state in the condition register will set corresponding bits in the event register.
Page 36
Consider Case C, where the positive transition filter is set to 1 and the negative transition filter is set to 0. This configures the 8990B to set the corresponding bit in the event register whenever the condition bit changes from 0 to 1. The enable register is set to 1 to enable the summary bit to be generated each time there is a change in the event register.
Page 37
Consider Case D, where the positive and negative transition filters are set to 1. This configures the 8990B to set the corresponding bit in the event register whenever there are changes to the condition bit. The enable register is set to 0 to disable the summary bit to be generated.
Page 38
8990B Remote Operation Device Status Error/Event Queue Condition Event Enable Questionable Status Condition Event Enable Status Byte Output Queue RQS/MSS *STB? *SRE Standard Event Event Enable *ESR *ESE Operation Status Condition Event Enable Figure 1-10 Status system Keysight 8990B Programming Guide...
Page 39
Status Byte summary register The Status Byte summary register reports conditions from other status registers. Query data waiting in the 8990B output buffer is immediately reported through the “Message Available” bit (bit 4). Clearing an event register clears the corresponding bits in the Status Byte summary register.
Page 40
(status byte query) is similar to a serial poll except that it is processed like any other 8990B command. The *STB? query 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.
Page 41
Questionable Status register The Questionable Status register set provides information on the quality of the 8990B measurement results. Any or all of these conditions can be reported in the questionable data summary bit through the enable register. You must write a value using the STATus:QUEStionable:ENABle command to set the enable register mask.
Page 42
Error –231,“Data questionable;Calibration error in channel 4” CLEARED: When any of the events listed above succeed and no errors are placed on the error queue SET: When the power-on self-test fails Self-test failure CLEARED: When the power-on self-test passes Keysight 8990B Programming Guide...
Page 43
8990B Remote Operation Operation Status register The Operation Status group monitors conditions in the 8990B measurement process. The following bits in this register set are used by the 8990B: Table 1-5 Bit definitions – Operation Status Weight/Decimal Definition value 0 to 6 –...
Page 44
8990B Remote Operation Device Status register The Device Status register contains bits which provide device-dependent information. The following bits in this register are used by the 8990B: Table 1-7 Bit definitions – Device Status register Weight/Decimal value Definition Not used...
*OPC command allow you to maintain synchronization between the PC and the 8990B. The *OPC? query places an ASCII character 1 into the 8990B output queue when all pending 8990B commands have completed. If your program reads this response before continuing program execution, you can ensure synchronization between one or more instruments and the PC.
Page 46
8990B Remote Operation THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 47
Keysight 8990B Peak Power Analyzer Programming Guide IEEE-488 Command Reference SCPI Compliance Information *CLS *ESE <NRf> *ESR? *IDN? *OPC *RST *SRE <NRf> *STB? *TST? *WAI This chapter contains information on the IEEE-488 common commands supported by the 8990B.
(Questionable Status, Operation Status, and all the other SCPI registers), the Standard Event Status register, the Status Byte, and the Error/Event Queue are all cleared. Syntax *CLS Example This command clears the status data structures of the 8990B. *CLS Keysight 8990B Programming Guide...
Bit definitions: Standard Event register Weight/Decimal value Definition Operation complete Not used Query error Device-dependent error Execution error Command error 6 to 7 – Not used Refer to “Standard Event register” on page 40 for more details. Syntax Space *ESE Keysight 8990B Programming Guide...
Page 51
The return format is <NR1> in the range of 0 to 255. Query example Returns the bits currently set in the enable register. *ESE? Keysight 8990B Programming Guide...
Device-dependent error Execution error Command error 6 to 7 – Not used Refer to “Standard Event register” on page 40 for more details. Syntax *ESR Example Returns the bits currently set in the event register. *ESR? Keysight 8990B Programming Guide...
IEEE-488 Command Reference *IDN? The *IDN? query reads the 8990B identification string and returns the string in the following format: Keysight Technologies,8990B,<serial number>,<firmware version> where, – <serial number> uniquely identifies each 8990B, and – <firmware version> represents the current firmware revision of the 8990B.
IEEE-488 Command Reference *OPC The *OPC (OPeration Complete) command sets the “Operation Complete” bit (bit 0) in the Standard Event register when all pending operations have completed. This command is used to synchronize your application with the 8990B. Syntax *OPC Example This command sets the “Operation Complete”...
IEEE-488 Command Reference *RST The *RST (ReSeT) command places the 8990B in a known state. This command also sets the 8990B in the Run mode. Syntax *RST Example This command resets the 8990B to its default settings, and also *RST sets it in the Run mode.
Error/Event queue Questionable Status register summary Message available Standard Event register summary Master Status summary (Request for service) Operation Status register summary Refer to “Status Byte summary register” on page 39 for more details. Syntax Space *SRE Keysight 8990B Programming Guide...
Page 57
The return format is <NR1> in the range of 0 to 255. Query example Returns the bits currently set in the enable register. *SRE? Keysight 8990B Programming Guide...
Standard Event register summary Master Status summary (Request for service) Operation Status register summary Refer to “Status Byte summary register” on page 39 for more details. Syntax *STB Example Returns the bits currently set in the condition register. *STB? Keysight 8990B Programming Guide...
IEEE-488 Command Reference *TST? The *TST? (TeST) query initiates an internal self-test of the 8990B and returns a pass or fail indication where: – 0 is returned if all tests pass, or – 1 is returned if one or more tests fail.
IEEE-488 Command Reference *WAI The *WAI (WAIt) command has no function in the 8990B, but is parsed for compatibility with other instruments. Syntax *WAI Keysight 8990B Programming Guide...
Page 61
Keysight 8990B Peak Power Analyzer Programming Guide Root Commands Overview ACS? ARS? AUToscale AUToscale:UNDO ECS? ETS <character_data> ETSThreshold <character_data> OCS{1|4}? SINGle STOP TRS? This chapter describes the root commands supported by the 8990B.
Root Commands Overview This chapter describes the 8990B root commands which are SCPI commands that are not located under any subsystem. Below lists the root command descriptions: Averaging Completed State page 63 ACS? Arm Event State page 64 ARS? Autoscale...
Root Commands ACS? This query pools the completion status of the 8990B averaging subsystem. – 1 is returned when the average count has reached its maximum. – 0 is returned when the average count has not reached its maximum. Syntax...
8990B. – 1 is returned when the trigger is armed – 0 is returned when the trigger is unarmed Syntax Example Queries the state of the arm trigger event of the 8990B. ARS? Remark Executing this query or *CLS clears the arm trigger event status.
This command autoscales the waveform display. Remarks – This command, when executed, causes the 8990B to adjust and display the waveforms in the optimum condition by evaluating all the input channels. This command will turn off the channel with no waveform found.
Root Commands AUToscale:UNDO This command returns the 8990B to the settings that existed before autoscale was executed. This is useful if you have unintentionally executed autoscale or do not like the settings autoscale has selected and want to return to your previous settings.
Remark Executing this query or *CLS clears the ETS event completed status. This status bit will not be reset when the ETS Operation Completed bit of the Operation Status register is read using the STATus:OPERation[:EVENt]? query. Keysight 8990B Programming Guide...
This command turns off the ETS event. ETS OFF Remarks – Turning on ETS enables the 8990B to capture high-frequency signals with a higher effective sampling rate. – Video bandwidth is turned off when ETS is enabled. – The 10 MHz reference signal input is turned off when ETS is enabled. If ETS is enabled while the 10 MHz input is turned on, error 939, “10 MHz setting is only...
Page 69
Root Commands Reset condition On reset, ETS is set to AUTO. Query ETS? This query returns the current setting of the ETS state. The response format is <NRf>. Query example Queries the current ETS state. ETS? Keysight 8990B Programming Guide...
– ETS5U: Sets ETS threshold to 5 μs. – ETS10U: Sets ETS threshold to 10 μs. Example This command sets the ETS threshold to 500 ns. ETST ETS500N Reset condition On reset, ETS threshold is set to ETS500N. Keysight 8990B Programming Guide...
Page 71
Root Commands Query ETST? This query returns the current setting of the ETS threshold. The response format is <NRf>. Query example Queries the current ETS threshold. ETST? Keysight 8990B Programming Guide...
– This query is only applicable for channels 1 and 4. If a channel other than channel 1 or 4 is specified, the following errors — “–113,“Undefined header;OCS2<Err>” and “–420,”Query UNTERMINATED” — will occur. – This query is only applicable when calibration is invoked via SCPI commands. Keysight 8990B Programming Guide...
Root Commands This command sets the 8990B to start a continuous data acquisition. Syntax Example This command initiates a continuous data acquisition. Remark To exit the continuous acquisition mode, you need to execute the STOP or SINGle command. Keysight 8990B Programming Guide...
Root Commands SINGle This command sets the 8990B to make a single data acquisition when the next trigger event occurs. Syntax SING Example This command initiates a single data acquisition. SINGle Remark The 8990B will stop acquiring data after making the single acquisition.
Root Commands STOP This command sets the 8990B to stop data acquisition. Syntax STOP Example This command stops the data acquisition. STOP Remark To re-initiate data acquisition, you need to execute the RUN or SINGle command. Keysight 8990B Programming Guide...
8990B. – 1 is returned if a trigger event occurs – 0 is returned if there is no trigger event Syntax Example Queries the state of the trigger event of the 8990B. TRS? Remark Executing this query or *CLS clears the trigger event status.
Page 78
ACQuire:DROop:SOURce CHAN{1|4|ALLRF|NONE} ACQuire:INTerpolate <boolean> ACQuire:MODE <character_data> ACQuire:RF:INTerpolate <character_data> ACQuire:RF:INTerpolate:RESolution <character_data> ACQuire:RF:INTerpolate:THReshold <character_data> ACQuire:SYNCres <boolean> ACQuire:ZOOM:OFFSet <numeric_value> ACQuire:ZOOM:SCALe <numeric_value> This chapter explains how the ACQuire command subsystem is used to set the 8990B acquisition mode and parameters. Keysight 8990B Programming Guide...
Space :AVER :STAT 0|OFF 1|ON Example This command enables averaging. ACQ:AVER 1 Remark The last setting of the averaging filter length will be saved with every averaging state change. Reset condition On reset, averaging is disabled. Keysight 8990B Programming Guide...
Page 82
This query enters a 1 or 0 into the output buffer indicating the state of averaging. – 1 is returned when averaging is enabled – 0 is returned when averaging is disabled Query example Queries whether averaging is enabled or disabled. ACQ:AVER? Keysight 8990B Programming Guide...
– If the averaging state is off, it will be turned on when you set the averaging filter length. – If you set a value other than the range specified for the filter length, error –222,“Data out of range” will occur. Keysight 8990B Programming Guide...
Page 84
On reset, the averaging filter length is set to 2. Query ACQuire:AVERage:COUNt? This query returns the current setting of the averaging filter length. The response format is <NR1>. Query example Queries the averaging filter length setting. ACQ:AVER:COUN? Keysight 8990B Programming Guide...
Remark If the averaging state is off, this query returns a value of 0 and error –221, “Settings conflict;Requires averaging to be enabled” will occur. Refer to “ACQuire:AVERage:COUNt <numeric_value>” on page 83 to enable the averaging. Keysight 8990B Programming Guide...
– This query is only applicable in the CCDF acquisition mode. If the acquisition mode is not set to CCDF, error –221,“Settings conflict;Requires CCDF mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” page 132 to set the acquisition mode. Keysight 8990B Programming Guide...
100M to 10G – Default value: 100M – Minimum value: 100M – Maximum value: 10G The value specified will be truncated to a multiple of 100M. Example This command sets the CCDF acquisition length ACQ:CCDF:COUN 500MA to 500M. Keysight 8990B Programming Guide...
Page 88
On reset, the CCDF acquisition length is set to 100M. Query ACQuire:CCDF:COUNt? This query returns the current setting of the CCDF acquisition length. The response format is <NRf>. Query example Queries the CCDF acquisition length setting. ACQ:CCDF:COUN? Keysight 8990B Programming Guide...
– This query is only applicable when the CCDF sweep is set to the free run mode. If the CCDF sweep is not set to free run, error –221,“Settings conflict;Requires CCDF sweep to be in free run mode” will occur. Keysight 8990B Programming Guide...
The value specified will be truncated to a multiple of 10 ns. The range of values above is determined by CCDF trigger duration × CCDF frame and must be ≤ 100 s. Example This command sets the CCDF trigger duration to ACQ:CCDF:DUR 0.01 0.01 s. Keysight 8990B Programming Guide...
Page 91
On reset, the CCDF trigger duration is set to 10 ms. Query ACQuire:CCDF:DURation? This query returns the current setting of the CCDF trigger duration. The response format is <NRf>. Query example Queries the CCDF trigger duration setting. ACQ:CCDF:DUR? Keysight 8990B Programming Guide...
– Minimum value: 1 – Maximum value: 1G The range of values above is determined by CCDF trigger duration × CCDF frame and must be ≤ 100 s. Example This command sets the CCDF frame to 2K. ACQ:CCDF:FRAM 2K Keysight 8990B Programming Guide...
Page 93
Reset condition On reset, the CCDF frame is set to 1. Query ACQuire:CCDF:FRAMe? This query returns the current setting of the CCDF frame. The response format is <NRf>. Query example Queries the CCDF frame setting. ACQ:CCDF:FRAM? Keysight 8990B Programming Guide...
– This query is only applicable when the CCDF sweep is set to the triggered mode. If the CCDF sweep mode is not set to triggered, error –221,“Settings conflict;Requires CCDF sweep to be in triggered mode” will occur. Keysight 8990B Programming Guide...
CCDF, error –221,“Settings conflict;Requires CCDF mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” on page 132 to set the acquisition mode. Reset condition On reset, the CCDF Gaussian trace is turned on. Keysight 8990B Programming Guide...
Page 96
Gaussian trace. – 1 is returned when the trace is turned on – 0 is returned when the trace is turned off Query example Queries whether the CCDF Gaussian trace is turned on ACQ:CCDF:GAUS? or off. Keysight 8990B Programming Guide...
1 or 4, error 700,“Applicable to channel 1 and 4 only” will occur. – This command is only applicable in the CCDF acquisition mode. If the acquisition mode is not set to CCDF, error –221,“Settings conflict;Requires Keysight 8990B Programming Guide...
Page 98
Reset condition On reset, the CCDF marker A source is set to none. Query ACQuire:CCDF:MARKer:ASOUrce? This query returns the current setting of the CCDF marker A source. Query example Queries the CCDF marker A source setting. ACQ:CCDF:MARK:ASOU? Keysight 8990B Programming Guide...
Syntax :MARK Space :CCDF :AXP numeric_value Parameter Item Description/Defaul t numeric_value A numeric value in dB for the X-axis position Example This command sets the X-axis position of CCDF ACQ:CCDF:MARK:AXP 0.1 marker A to 0.1 dB. Keysight 8990B Programming Guide...
Page 100
97 to set the CCDF marker A source. Query ACQuire:CCDF:MARKer:AXPosition? This query returns the current setting of the CCDF marker A X-axis position. The response format is <NRf>. Query example Queries the X-axis position setting of CCDF ACQ:CCDF:MARK:AXP? marker A. Keysight 8990B Programming Guide...
– This query is only applicable when the CCDF marker A source is set. If the source is not set, error –221,“Settings conflict;CCDF marker A source not set” will occur. Refer to “ACQuire:CCDF:MARKer:ASOUrce <character_data>” page 97 to set the CCDF marker A source. Keysight 8990B Programming Guide...
1 or 4, error 700,“Applicable to channel 1 and 4 only” will occur. – This command is only applicable in the CCDF acquisition mode. If the acquisition mode is not set to CCDF, error –221,“Settings conflict;Requires Keysight 8990B Programming Guide...
Page 103
Reset condition On reset, the CCDF marker B source is set to none. Query ACQuire:CCDF:MARKer:BSOUrce? This query returns the current setting of the CCDF marker B source. Query example Queries the CCDF marker B source setting. ACQ:CCDF:MARK:BSOU? Keysight 8990B Programming Guide...
– This command is only applicable when the CCDF marker B source is set. If the source is not set, error –221,“Settings conflict;CCDF marker B source not set” will occur. Refer to “ACQuire:CCDF:MARKer:BSOUrce <character_data>” page 102 to set the CCDF marker B source. Keysight 8990B Programming Guide...
Page 105
ACQuire Subsystem Query ACQuire:CCDF:MARKer:BXPosition? This query returns the current setting of the CCDF marker B X-axis position. The response format is <NRf>. Query example Queries the X-axis position setting of CCDF ACQ:CCDF:MARK:BXP? marker B. Keysight 8990B Programming Guide...
– This query is only applicable when the CCDF marker B source is set. If the source is not set, error –221,“Settings conflict;CCDF marker B source not set” will occur. Refer to “ACQuire:CCDF:MARKer:BSOUrce <character_data>” page 102 to set the CCDF marker B source. Keysight 8990B Programming Guide...
– This query is only applicable in the CCDF acquisition mode. If the acquisition mode is not set to CCDF, error –221,“Settings conflict;Requires CCDF mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” page 132 to set the acquisition mode. Keysight 8990B Programming Guide...
– This query is only applicable in the CCDF acquisition mode. If the acquisition mode is not set to CCDF, error –221,“Settings conflict;Requires CCDF mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” page 132 to set the acquisition mode. Keysight 8990B Programming Guide...
– This query is only applicable when the CCDF source is set. If the source is not set, error –221,“Settings conflict;CCDF source not set” will occur. Refer to “ACQuire:CCDF:SOURce <character_data>” on page 117 to set the CCDF source. Keysight 8990B Programming Guide...
– This query is only applicable when the CCDF source is set. If the source is not set, error –221,“Settings conflict;CCDF source not set” will occur. Refer to “ACQuire:CCDF:SOURce <character_data>” on page 117 to set the CCDF source. Keysight 8990B Programming Guide...
– This command is only applicable when channel 1 or 4 is connected. If the channel trace is not connected, error –221,“Settings conflict;Requires CCDF trace # to be enabled” will occur. Refer to “ACQuire:CCDF:TRACe{1|4}[:STATe] <boolean>” on page 125 to set the CCDF channel trace. Keysight 8990B Programming Guide...
Page 112
– 1 is returned when the trace is turned on – 0 is returned when the trace is turned off Query example Queries whether the CCDF reference trace is turned on ACQ:CCDF:REF? or off. Keysight 8990B Programming Guide...
Sets the reference source as: TRACe1 – TRACe1: Trace from channel 1. TRACe4 – TRACe4: Trace from channel 4. Example This command sets the CCDF trace from ACQ:CCDF:REF:SOUR TRAC1 channel 1 as the reference source. Keysight 8990B Programming Guide...
Page 114
Refer to “ACQuire:CCDF:REFerence[:STATe] <boolean>” on page 111 to set the CCDF reference trace. Query ACQuire:CCDF:REFerence:SOURce? This query returns the current setting of the reference source. Query example Queries the reference source setting. ACQ:CCDF:REF:SOUR? Keysight 8990B Programming Guide...
A numeric value in dB/div for the CCDF trace display scale: 0.5 dB/div to 5 dB/div – Default value: 5 dB/div – Minimum value: 0.5 dB/div – Maximum value: 5 dB/div Example This command sets the CCDF trace display scale ACQ:CCDF:SCAL 0.5 to 0.5 dB/div. Keysight 8990B Programming Guide...
Page 116
On reset, the CCDF trace display scale is set to 5 dB/div. Query ACQuire:CCDF:SCALe? This query returns the current setting of the CCDF trace display scale. The response format is <NRf>. Query example Queries the CCDF trace display scale setting. ACQ:CCDF:SCAL? Keysight 8990B Programming Guide...
Sets the CCDF source as: CHAN1 – CHAN1: Sets the source to channel 1. CHAN4 – CHAN4: Sets the source to channel 4. Example This command sets the CCDF source as ACQ:CCDF:SOUR CHAN1 channel 1. Keysight 8990B Programming Guide...
Page 118
Reset condition On reset, the CCDF source is set to the first channel 1 or 4 available. Query ACQuire:CCDF:SOURce? This query returns the current setting of the CCDF source. Query example Queries the CCDF source setting. ACQ:CCDF:SOUR? Keysight 8990B Programming Guide...
– FREErun: Sets the sweep to the free run mode. This is the default TRIGgered setting. – TRIGgered: Sets the sweep to the triggered mode. Example This command sets the CCDF sweep mode to ACQ:CCDF:SWE FREE free run. Keysight 8990B Programming Guide...
Page 120
132 to set the acquisition mode. Reset condition On reset, the CCDF sweep mode is set to free run. Query ACQuire:CCDF:SWEep? This query returns the current setting of the CCDF sweep mode. Query example Queries the CCDF sweep mode setting. ACQ:CCDF:SWE? Keysight 8990B Programming Guide...
– Power level that contains 0.01% of the power – Power level that contains 0.001% of the power – Power level that contains 0.0001% of the power Syntax :TAB :CCDF Example Queries the CCDF statistical table value. ACQ:CCDF:TAB? Keysight 8990B Programming Guide...
Page 122
– This command is only applicable when the CCDF source is set. If the source is not set, error –221,“Settings conflict;CCDF source not set” will occur. Refer to “ACQuire:CCDF:SOURce <character_data>” on page 117 to set the CCDF source. Keysight 8990B Programming Guide...
Sets the CCDF statistical table source as: CHAN1 – CHAN1: Sets the source to channel 1. CHAN4 – CHAN4: Sets the source to channel 4. Example This command sets the CCDF statistical table ACQ:CCDF:TABLESOUR CHAN1 source as channel 1. Keysight 8990B Programming Guide...
Page 124
On reset, the CCDF source is set to the first channel 1 or 4 available. Query ACQuire:CCDF:TABLESOURce? This query returns the current setting of the CCDF source. Query example Queries the CCDF statistical table source setting. ACQ:CCDF:TABLESOUR? Keysight 8990B Programming Guide...
CCDF, error –221,“Settings conflict;Requires CCDF mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” on page 132 to set the acquisition mode. Reset condition On reset, the CCDF trace from both channels 1 and 4 is turned on. Keysight 8990B Programming Guide...
Page 126
– 1 is returned when the trace is turned on – 0 is returned when the trace is turned off Query example Queries whether the CCDF trace from channel 4 is turned ACQ:CCDF:TRAC4? on or off. Keysight 8990B Programming Guide...
ACQuire Subsystem ACQuire:CCDF:WAVEFOrm <boolean> This command sets and obtains the waveform setting. Syntax :CCDF :WAVEFO 0|OFF 1|ON Example This command turns on the CCDF trace from ACQ:CCDF:WAVEFO 1 channel 1. Keysight 8990B Programming Guide...
– 1 is returned when the droop measurement mode is turned on – 0 is returned when the droop measurement mode is turned off Query example Queries whether the droop measurement mode is turned on ACQ:DRO? or off. Keysight 8990B Programming Guide...
If a channel other than channel 1 or 4 is specified, error 700,“Applicable to channel 1 and 4 only” will occur. Reset condition On reset, the droop measurement source is set to the first channel 1 or 4 available. Keysight 8990B Programming Guide...
Page 130
ACQuire Subsystem Query ACQuire:DROop:SOURce? This query returns the current setting of the droop measurement source. Query example Queries the droop measurement source setting. ACQ:DRO:SOUR? Keysight 8990B Programming Guide...
– 1 is returned when the sin(x)/x interpolation filter is turned on – 0 is returned when the sin(x)/x interpolation filter is turned off Query example Queries whether the sin(x)/x interpolation filter is turned on ACQ:INT? or off. Keysight 8990B Programming Guide...
ACQuire Subsystem ACQuire:MODE <character_data> This command sets the data acquisition mode of the 8990B. Syntax Space character_data :MODE Parameter Item Description/Defaul t Range of values character_data Sets the acquisition mode as: NORMal – NORMal: Sets to the normal acquisition mode. This is the ZOOM default setting.
Page 133
ACQuire Subsystem Reset condition On reset, the acquisition mode is set to normal. Query ACQuire:MODE? This query returns the current setting of the acquisition mode. Query example Queries the acquisition mode setting. ACQ:MODE? Keysight 8990B Programming Guide...
ACQuire:RF:INTerpolate <character_data> This command enables or disables the interpolation algorithm for RF channels. Upon enabling the interpolation, the 8990B will interpolate the acquired data points to the correct resolution as set by the user. This command can only be used when the ETS mode is disabled (refer to “ETS...
– POINT2N: Sets the resolution to 2 points per nanosecond. – POINT5N: Sets the resolution to 5 points per nanosecond. Example Sets the interpolation algorithm resolution to 2 ACQ:RF:INT:RES POINT2N points per nanosecond. Reset condition On reset, the interpolation algorithm resolution is set to POINT1N. Keysight 8990B Programming Guide...
ACQuire:RF:INTerpolate:THReshold <character_data> This command is used to specify the timebase threshold. The interpolation algorithm will start to interpolate trace data acquired by the 8990B when the timebase falls below the specified threshold. This command can only be used when ACQuire:RF:INTerpolate is set to AUTO...
This command can only be used when ACQuire:RF:INTerpolate is set to AUTO NOTE (refer to “” on page 141). Syntax :SYNC 0|OFF 1|ON Example This command enables synchronization. ACQ:SYNC 1 Reset condition On reset, synchronization is disabled. Keysight 8990B Programming Guide...
TIMebase:SCALe <numeric_value>. The <numeric_value>. zoom window can only be offsetted within the range of the graph. Example This command sets the time offset in the zoom ACQ:ZOOM:OFFS 1m mode to 1 ms. Keysight 8990B Programming Guide...
Page 139
Remarks – This command is only applicable in the zoom mode. If this command is sent when the 8990B is not in the zoom mode, error –221,“Settings conflict;Requires zoom mode to be enabled” will occur. – If you set a time offset value which exceeds its minimum or maximum limit, the value will be clipped to its minimum or maximum value respectively.
TIMebase:SCALe The range of values will change according to the graph scale you <numeric_value>. set in TIMebase:SCALe <numeric_value>. Example This command sets the time scale in the zoom ACQ:ZOOM:SCAL 60E–09 mode to 60 ns. Keysight 8990B Programming Guide...
Page 141
Remarks – This command is only applicable in the zoom mode. If this command is sent when the 8990B is not in the zoom mode, error –221,“Settings conflict;Requires zoom mode to be enabled” will occur. – The minimum and maximum values of the zoom time scale are based on the current Normal mode time scale settings.
Page 142
ACQuire Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 143
Keysight 8990B Peak Power Analyzer Programming Guide CALibration Subsystem Overview CALibration[:ALL] CALibration:CALibrate <character_data> CALibration:CALibrate:AUTO <boolean> CALibration:CALibrate:AUTO:INTerval <numeric_value> CALibration:CALibrate:AUTO:NOTify <boolean> CALibration:OUTPut <character_data> CALibration:ZERO <character_data> CALibration:ZEROCAL <character_data> This chapter explains how the CALibration command subsystem is used to perform internal zeroing and calibration on the peak power sensors connected to...
The CALibration command subsystem allows you to set the 8990B to perform internal zeroing and calibration on the peak power sensor. The internal zeroing and calibration process is used to combine the peak power sensor and the 8990B to make accurate power measurements.
CALibration Subsystem CALibration[:ALL] This command sets the 8990B to manually perform zeroing and calibration on both channels 1 and 4. Syntax :ALL Example This command sets the 8990B to perform zeroing and calibration on both channels 1 and 4. Remark If channel 1 or 4 is not connected, error –241,“Hardware missing;...
CALibration Subsystem CALibration:CALibrate <character_data> This command sets the 8990B to manually perform calibration on channel 1 or 4. Syntax Space character_data :CAL Parameter Item Description/Defaul t Range of values character_data Sets the channel calibration as: CHAN1 – CHAN1: Sets channel 1 to calibrate.
– For seamless remote operation when auto calibration is enabled, you are advised to incorporate sufficient timeouts (10 secs) in your test program to avoid errors. Alternatively, the *OPC command can be used for status checking before proceeding to the next command. Keysight 8990B Programming Guide...
Page 148
1 and 4. – 1 is returned when auto calibration is enabled – 0 is returned when auto calibration is disabled Query example Queries whether auto calibration on channels 1 and 4 CAL:CAL:AUTO? is enabled or disabled. Keysight 8990B Programming Guide...
This command sets the auto calibration to run CAL:CAL:AUTO:INT 1 on a 1 min interval. This command rounds up 9.5 to the nearest CAL:CAL:AUTO:INT 9.5 integer, and auto calibration will run on a 10 min interval. Keysight 8990B Programming Guide...
Page 150
This query returns the current setting of the time interval for auto calibration on channels 1 and 4. The response format is <NRf>. Query example Queries the time interval setting for auto CAL:CAL:AUTO:INT? calibration on channels 1 and 4. Keysight 8990B Programming Guide...
– 1 is returned when the auto calibration display notification is enabled – 0 is returned when the auto calibration display notification is disabled Query example Queries whether display notification for auto CAL:CAL:AUTO:NOT? calibration on channels 1 and 4 are enabled or disabled. Keysight 8990B Programming Guide...
This command puts a DC voltage of 2.0 V on the Aux CAL:OUTP DC,2.0 Trig Out connector.. Remark The AC setting sets the Aux Trig Out to be the probe compensation square wave (approximately 750 Hz). Keysight 8990B Programming Guide...
Page 153
CALibration Subsystem Query CALibration:OUTPut? This query returns the current setting of the calibration output. Query example Queries the calibration output setting. CAL:OUTP? Keysight 8990B Programming Guide...
CALibration Subsystem CALibration:ZERO <character_data> This command sets the 8990B to perform zeroing on channel 1 or 4. Syntax Space character_data :ZERO Parameter Item Description/Defaul t Range of values character_data Sets the channel for zeroing as: CHAN1 – CHAN1: Sets channel 1 to zero.
CALibration Subsystem CALibration:ZEROCAL <character_data> This command sets the 8990B to perform zeroing and calibration on channel 1 or 4. Syntax Space :ZEROCAL character_data Parameter Item Description/Defaul t Range of values character_data Sets the channel for zeroing and calibration as: CHAN1 –...
Page 156
CALibration Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
CHANnel Subsystem Overview The CHANnel command subsystem controls the channel settings and vertical (Y-axis) functions of the 8990B. The channel numbers in the following command list refer to: – RF channels (for channels 1 and 4), or – oscilloscope channels (for channels 2 and 3).
– LOW: Sets to the low bandwidth. HIGH – MEDium: Sets to the medium bandwidth. – HIGH: Sets to the high bandwidth. Example This command sets the sensor video bandwidth to CHAN1:BWID HIGH high for channel 1. Keysight 8990B Programming Guide...
Page 160
On reset, the sensor video bandwidth setting is disabled. Query CHANnel{1|4}:BWIDth? This query returns the current setting of the sensor video bandwidth for the specified channel. Query example Queries the sensor video bandwidth setting for channel 1. CHAN1:BWID? Keysight 8990B Programming Guide...
– If no sensor is connected to a particular channel, error –241,“Hardware missing;Unable to turn on channel #;no sensor detected” will occur. Reset condition On reset, the channel display is turned on. Keysight 8990B Programming Guide...
Page 162
– 1 is returned when the channel display is turned on – 0 is returned when the channel display is turned off Query example Queries whether the display is turned on or off for channel 1. CHAN1? Keysight 8990B Programming Guide...
A numeric value in dB for the external loss: –100 dB to 100 dB – Default value: 0 dB – Minimum value: –100 dB – Maximum value: 100 dB Example This command sets the external loss to 1 dB for channel 1. CHAN1:EXTL 1 Keysight 8990B Programming Guide...
Page 164
On reset, the external loss is set to 0 dB. Query CHANnel{1|4}:EXTLoss? This query returns the current setting of the external loss for the specified channel. The response format is <NRf>. Query example Queries the external loss setting for channel 4. CHAN4:EXTL? Keysight 8990B Programming Guide...
–221,“Settings conflict;No FDO table selected” will occur. – This command is only applicable for channels 1 and 4. If a channel other than channel 1 or 4 is specified, error 700,“Applicable to channel 1 and 4 only” will occur. Keysight 8990B Programming Guide...
Page 166
– 1 is returned when the FDO table is enabled – 0 is returned when the FDO table is disabled Query example Queries whether the FDO table is enabled or disabled for CHAN1:FDO? channel 1. Keysight 8990B Programming Guide...
Sets any of the following FDO table names as a string value (“”): – CUSTOM_A – CUSTOM_B – CUSTOM_C – CUSTOM_D – CUSTOM_E – CUSTOM_F – CUSTOM_G – CUSTOM_H – CUSTOM_I – CUSTOM_J Example This command assigns the FDO table CHAN1:FDO:SEL “CUSTOM_A” named “CUSTOM_A” to channel 1. Keysight 8990B Programming Guide...
Page 168
This query returns the current setting of the FDO table for the specified channel as a string value. An empty string "" will be returned if no table has been selected. Query example Queries the FDO table assigned to channel 1. CHAN1:FDO:SEL? Keysight 8990B Programming Guide...
A numeric value in Hz for frequency: 1 kHz to 1000 GHz – Default value: 1 GHz – Minimum value: 1 kHz – Maximum value: 1000 GHz Example This command sets the frequency to 5 kHz for CHAN1:FREQ 5000 channel 1. Keysight 8990B Programming Guide...
Page 170
On reset, the frequency is set to 1 GHz. Query CHANnel{1|4}:FREQuency? This query returns the current setting of the frequency for the specified channel. The response format is <NRf>. Query example Queries the frequency setting for channel 1. CHAN1:FREQ? Keysight 8990B Programming Guide...
– DC: DC coupling, 1 MΩ impedance – DC50: DC coupling, 50 Ω impedance. This is the default setting. Example This command sets the input coupling and CHAN2:INP AC Ω impedance to AC coupling and 1 M respectively for channel 2. Keysight 8990B Programming Guide...
Page 172
On reset, the input coupling and impedance settings are set to DC coupling and 50 Ω impedance respectively. Query CHANnel{2|3}:INPut? This query returns the current settings of the input coupling and impedance for the specified channel. Query example Queries the input coupling and impedance settings for CHAN2:INP? channel 2. Keysight 8990B Programming Guide...
A numeric value in volts per division for the offset: –4 V/div to 4 V/div – Default value: 0 – Minimum value: –4 V/div – Maximum value: 4 V/div Example This command sets the offset to 1.5 V/div for CHAN2:OFFS 1.5 channel 2. Keysight 8990B Programming Guide...
Page 174
On reset, the offset is set to 0. Query CHANnel{2|3}:OFFSet? This query returns the current setting of the offset for the specified channel. The response format is <NRf>. Query example Queries the offset setting for channel 2. CHAN2:OFFS? Keysight 8990B Programming Guide...
2 or 3 is specified, error 701,“Applicable to channel 2 and 3 only” will occur. – If channel 1 or 4 is not connected, error –241,“Hardware missing; Sensor is not found in channel <channel>.” will occur. Keysight 8990B Programming Guide...
2 or 3 is specified, error 701,“Applicable to channel 2 and 3 only” will occur. – If channel 1 or 4 is not connected, error –241,“Hardware missing; Sensor is not found in channel <channel>.” will occur. Keysight 8990B Programming Guide...
–99 dBm to 99 dBm 0 W to 1 W – Default value: 0 – Minimum value: –99 dBm/0 W – Maximum value: 99 dBm/1 W Example This command sets the top reference to 11.75 dBm. CHAN1:REF 11.75 Keysight 8990B Programming Guide...
Page 178
On reset, the channel reference is set to 0. Query CHANnel{1|4}:REFerence? This query returns the current setting of the reference value for the specified channel. The response format is <NRf>. Query example Queries the reference value for channel 4. CHAN4:REF? Keysight 8990B Programming Guide...
– BOTTom: Sets the reference at the bottom of the display. – CENTer: Sets the reference at the center of the display. This is the default setting. Example This command sets the reference position to the top CHAN1:REF:POS TOP of the display for channel 1. Keysight 8990B Programming Guide...
Page 180
On reset, the reference is set to the center of the display. Query CHANnel{1|4}:REFerence:POSition? This query returns the current settings of the reference position for the specified channel. Query example Queries the reference position setting for channel 1. CHAN1:REF:POS? Keysight 8990B Programming Guide...
– DBM: Sets the unit to dBm. This is the default setting for WATT channels 1 and 4. – WATT: Sets the unit to W. (for channels 1 and 4) Example This command sets the channel 1 unit to W. CHAN1:UNIT WATT Keysight 8990B Programming Guide...
Page 182
On reset, the channel unit is set to dBm for channels 1 and 4, and V for channels 2 and 3. Query CHANnel{1|4}:UNIT? This query returns the current setting of the unit as DBM or WATT for the specified channel. Query example Queries the unit for channel 2. CHAN2:UNIT? Keysight 8990B Programming Guide...
– Maximum values: – 100 dB/1 kW per division (for channels 1 and 4) – 1 V per division (for channels 2 and 3) Example This command sets the channel 2 scale to CHAN2:SCAL 0.05 0.05 V/div. Keysight 8990B Programming Guide...
Page 184
2 and 3. Query CHANnel{1|2|3|4}:SCALe? This query returns the current setting of the scale for the specified channel. The response format is <NRf>. Query example Queries the scale setting for channel 4. CHAN4:SCAL? Keysight 8990B Programming Guide...
This query returns the sampling rate for the specified channel. Syntax CHAN :SRAT Example Queries the channel 1 sampling rate. CHAN1:SRAT? Remark The sampling rate is the same for a channel pair (1 and 4 or 2 and 3). Keysight 8990B Programming Guide...
– –1 μs (only applicable when ETS is turned on) – Maximum values: – 1 ms – 1 μs (only applicable when ETS is turned on) Example This command sets the channel time compensation CHAN2:TIMECOMP 1 m to 1 ms for channel 2 Keysight 8990B Programming Guide...
Page 187
Reset condition On reset, the channel time compensation is set to zero. Query CHANnel{1|2|3|4}:TIMECOMP? This query returns the current channel time compensation value. The response format is <NRf>. Query example Queries the channel time compensation. CHAN4:TIMECOMP? Keysight 8990B Programming Guide...
Page 188
CHANnel Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Keysight 8990B Peak Power Analyzer Programming Guide TIMebase Subsystem Overview TIMebase:OFFSet <numeric_value> TIMebase:REFClock <boolean> TIMebase:SCALe <numeric_value> This chapter describes how the TIMebase command subsystem is used to configure the 8990B timebase setup.
– 10 μs (only applicable when ETS is turned on) The range of values will change according to the zoom scale you set in ACQuire:ZOOM:SCALe <numeric_value>. Example This command sets the timebase offset to 0.05 s. TIM:OFFS 0.05 Keysight 8990B Programming Guide...
Page 192
Reset condition On reset, the timebase offset is set to 0. Query TIMebase:OFFSet? This query returns the current setting of the timebase offset. The response format is <NRf>. Query example Queries the timebase offset setting. TIM:OFFS? Keysight 8990B Programming Guide...
– This command is only applicable when the ETS mode is disabled. If you send this command when the ETS mode is enabled, error 940,“Unable to turn on 10 MHz setting when ETS is on” will occur. Reset condition On reset, the 10 MHz reference signal input is turned off. Keysight 8990B Programming Guide...
Page 194
– 1 is returned when the reference signal input is turned on – 0 is returned when the reference signal input is turned off Query example Queries whether the 10 MHz reference signal input is TIM:REFC? turned on or off. Keysight 8990B Programming Guide...
A numeric value in second per division for the scale: 2 ns/div to 100 ms/div – Default value: 1 μs/div – Minimum value: 2 ns/div – Maximum value: 100 ms/div Example This command sets the timebase scale to TIM:SCAL 0.05 0.05 s/div. Keysight 8990B Programming Guide...
Page 196
Reset condition On reset, the timebase scale is set to 1 μs/div. Query TIMebase:SCALe? This query returns the current setting of the timebase scale. The response format is <NRf>. Query example Queries the timebase scale setting. TIM:SCAL? Keysight 8990B Programming Guide...
– POSitive: Sets the slope to positive. This is the default NEGative setting. – NEGative: Sets the slope to negative. Example This command sets the slope to positive for the TRIG:EDGE:SLOP POS edge trigger. Reset condition On reset, the edge trigger slope is set to positive. Keysight 8990B Programming Guide...
Page 200
TRIGger Subsystem Query TRIGger:EDGE:SLOPe? This query returns the current setting of the edge trigger slope. Query example Queries the slope setting for the edge trigger. TRIG:EDGE:SLOP? Keysight 8990B Programming Guide...
A numeric value for the trigger event count: 0 to 16000000 – Default value: 0 – Minimum value: 0 – Maximum value: 16000000 Example This command sets the trigger event count to 10. TRIG:EVEN:COUN 10 Keysight 8990B Programming Guide...
Page 202
Reset condition On reset, the count is set to 0. Query TRIGger:EVENt:COUNt? This query returns the current setting of the trigger event count. The response format is <NRf>. Query example Queries the trigger event count setting. TRIG:EVEN:COUN? Keysight 8990B Programming Guide...
–221,“Settings conflict;Fast trigger is only applicable to trigger source for channel 1 and 4. Fast trigger has been disabled” will occur. – Auto-calibration will be turned off when the fast trigger is enabled. Reset condition On reset, the fast trigger is disabled. Keysight 8990B Programming Guide...
Page 204
This query enters a 1 or 0 into the output buffer indicating the state of the fast trigger. – 1 is returned when the fast trigger is enabled – 0 is returned when the fast trigger is disabled Query example Queries whether the fast trigger is enabled or disabled. TRIG:FAST? Keysight 8990B Programming Guide...
If you set a trigger holdoff value which exceeds its minimum or maximum limit, the value will be clipped to its minimum or maximum value respectively. Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Keysight 8990B Programming Guide...
Page 206
Reset condition On reset, the trigger holdoff is set to 1 μs. Query TRIGger:HOLDoff? This query returns the current setting of the trigger holdoff. The response format is <NRf>. Query example Queries the trigger holdoff setting. TRIG:HOLD? Keysight 8990B Programming Guide...
– If you set a hysteresis level value which exceeds its minimum or maximum limit, the value will be clipped to its minimum or maximum value respectively. Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Keysight 8990B Programming Guide...
Page 208
On reset, the trigger hysteresis level is set to 0 dBm. Query TRIGger:HYSTeresis:LEVel? This query returns the current setting of the trigger hysteresis level. The response format is <NRf>. Query example Queries the trigger hysteresis level setting. TRIG:HYST:LEV? Keysight 8990B Programming Guide...
This command is only applicable for channels 2 and 3. If you send this command for channels other than 2 and 3, error 706,“Applicable to trigger source for channel 2 and 3 only” will occur. Reset condition On reset, the trigger hysteresis mode is set to normal sensitivity. Keysight 8990B Programming Guide...
Page 210
TRIGger Subsystem Query TRIGger:HYSTeresis:MODE? This query returns the current setting of the trigger hysteresis mode. Query example Queries the trigger hysteresis mode setting. TRIG:HYST:MODE? Keysight 8990B Programming Guide...
This command is only applicable for the auxiliary trigger source input. If this command is sent for a trigger source other than auxiliary, error 704,“Applicable to trigger source for auxiliary only” will occur. Reset condition On reset, the impedance is set to 50 Ω. Keysight 8990B Programming Guide...
Page 212
TRIGger Subsystem Query TRIGger:IMPedance? This query returns the current setting of the auxiliary trigger source input impedance. Query example Queries the auxiliary trigger source input impedance TRIG:IMP? setting. Keysight 8990B Programming Guide...
– –40 dBm/100 nW (for channels 1 and 4) – –4 V (for channels 2 and 3) – Maximum value: – 20 dBm/100 mW (for channels 1 and 4) – 4 V (for channels 2 and 3) Keysight 8990B Programming Guide...
Page 214
– The minimum and maximum values of the trigger level are the boundary minimum and maximum values for each channel. These values will change according to the signal determined by the 8990B. – If you set a trigger level value which exceeds its minimum or maximum limit, the value will be clipped to its minimum or maximum value respectively.
Range of values character_data Sets the trigger mode as: EDGE – EDGE: Sets the 8990B to trigger on edge. This is the default setting. EVENt PWIDth – EVENt: Sets the 8990B to trigger on event. – PWIDth: Sets the 8990B to trigger on pulse width.
Page 216
TRIGger Subsystem Remark If the 8990B is set to trigger on event when the ETS mode is enabled, error –221,“Settings conflict;Unable to turn on Trigger on Event while ETS mode is on” will occur. Query TRIGger:MODE? This query returns the current setting of the trigger mode.
This command is only applicable for the channel 1, channel 4, and auxiliary trigger sources only. If this command is sent for a trigger source other than any of these sources, error 702,“Applicable to trigger source for channel 1, 4 and auxiliary only” will occur. Keysight 8990B Programming Guide...
Page 218
– 1 is returned when the output trigger is turned on – 0 is returned when the output trigger is turned off Query example Queries whether the output trigger is turned on or off. TRIG:OUT? Keysight 8990B Programming Guide...
This command sets the pulse width trigger mode TRIG:PWID LESS,0.1 to less at 0.1 s. Reset condition On reset, the pulse width trigger mode is set to MORE and the time is set to 1 μs. Keysight 8990B Programming Guide...
Page 220
The value for time1 must not be more than time2. If time1 > time2, error -222, "Data out of range; T1 value cannot be more than T2" will occur. Query TRIGger:PWIDth? This query returns the current mode of the pulse width trigger. Query example Queries the pulse width trigger mode. TRIG:PWID? Keysight 8990B Programming Guide...
– CHAN4: Sets the source to channel 4. – AUX: Sets the source to auxiliary. Example This command sets the trigger source to channel 1. TRIG:SOUR CHAN1 Reset condition On reset, the trigger source is set to first channel available. Keysight 8990B Programming Guide...
Page 222
TRIGger Subsystem Query TRIGger:SOURce? This query returns the current setting of the trigger source. Query example Queries the trigger source setting. TRIG:SOUR? Keysight 8990B Programming Guide...
– AUTO: Sets to the auto sweep mode. This is the default setting. TRIGgered – TRIGgered: Sets to the triggered sweep mode. Example This command sets the trigger sweep to the auto sweep TRIG:SWE AUTO mode. Keysight 8990B Programming Guide...
Page 224
5E-07 or higher” will occur. Reset condition On reset, the trigger sweep mode is set to auto. Query TRIGger:SWEep? This query returns the current setting of the trigger sweep mode. Query example Queries the trigger sweep mode setting. TRIG:SWE? Keysight 8990B Programming Guide...
Overview The MEASure command subsystem allows you to measure the available waveform parameters of the 8990B and retrieve the measurement results. The channel numbers in the following command list refer to: – RF channels (for channels 1 and 4), or –...
1 or 4 is specified, error 700,“Applicable to channel 1 and 4 only” will occur. – This query is only applicable in the Normal and Zoom mode. If this query is sent in the CCDF mode, error –221,“Settings conflict;Not Applicable to CCDF” will occur. Keysight 8990B Programming Guide...
This query enters a 1 or 0 into the output buffer indicating the state of the measurement histogram. – 1 is returned when the measurement histogram is enabled – 0 is returned when the measurement histogram is disabled Query example Queries whether the measurement histogram is MEAS:HIST? enabled or disabled. Keysight 8990B Programming Guide...
MEASure Subsystem MEASure:DISPlay <character_data>, CHAN{1|2|3|4}, [NORMal|ZOOM|MULTipulse], <Boolean> This command displays the measurement result of the selected measurement type for the specified channel. Syntax Space character_data :DISP CHAN NORM|ZOOM|MULT MEAS 0|OFF 1|ON Keysight 8990B Programming Guide...
Page 232
This command displays the minimum MEAS:DISP MIN, CHAN1, ZOOM, 1 power measurement result for channel 1 in zoom mode. This command displays the minimum MEAS:DISP MIN, CHAN1, MULT, 1 power measurement result for channel 1 in multipulse mode. Keysight 8990B Programming Guide...
Page 233
– 0 is returned when the measurement result of the selected measurement type for the specified channel is not displayed. Query example Queries the minimum power MEAS:DISP? MIN, CHAN1 measurement result display for channel 1 in normal mode. Keysight 8990B Programming Guide...
Page 234
MEASure Subsystem Queries the minimum power MEAS:DISP? MIN, CHAN1, ZOOM measurement result display for channel 1 in zoom mode. Queries the minimum power MEAS:DISP? MIN, CHAN1, MULT measurement result display for channel 1 in multipulse mode. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value. Keysight 8990B Programming Guide...
Page 236
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 238
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 240
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 242
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 244
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 246
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 248
If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. – Peak-to-average measurement for Channel 2 and Channel 3 is obtained using Vpk/Vavg. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 250
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 252
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 254
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 256
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 258
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 260
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
– MAX: Returns the maximum measurement value. MEAN CURRent – MIN: Returns the minimum measurement value. STDev – MEAN: Returns the mean measurement value. – CURRent: Returns the recent measurement value. – STDev: Returns the standard deviation value Keysight 8990B Programming Guide...
Page 262
– The multipulse query is only applicable when the multipulse acquisition is completed in the multipulse mode. If this query is sent when the multipulse acquistion is running, error –221,“Stop multipulse frame acquisition to change the setting” will occur. Keysight 8990B Programming Guide...
A numeric value in % for the pulse duration level: 0 to 100% – Default value: 50% – Minimum value: 0% – Maximum value: 100% Example This command sets the pulse duration level MEAS:THR:PDUR CHAN1,60 to 60% for channel 1. Keysight 8990B Programming Guide...
Page 264
Query MEASure:THReshold:PDURation? CHAN{1|2|3|4} This query returns the current setting of the pulse duration level for the specified channel. The response format is <NRf>. Query example Queries the pulse duration level setting for MEAS:THR:PDUR? CHAN1 channel 1. Keysight 8990B Programming Guide...
– The maximum value for Marker A level and Marker B level is clipped to reference level 2 when the marker source is set to one of the four channels. Syntax Space :THR :REF CHAN numeric_value MEAS Keysight 8990B Programming Guide...
Page 266
–222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Reset condition On reset, the trace reference level is set to 10% for reference level 1, and 90% for reference level 2. Keysight 8990B Programming Guide...
Page 267
MEASure:THReshold:REFlevel{1|2}? CHAN{1|2|3|4} This query returns the current setting of the trace reference level for the specified channel. The response format is <NRf>. Query example Queries the trace reference level 1 setting for MEAS:THR:REF1? CHAN4 channel 4. Keysight 8990B Programming Guide...
A numeric value in % to set the measurement threshold: 0% to 100% – Default value: 0% – Minimum value: 0% – Maximum value: 100% Example This command sets the threshold value to MEAS:THR:VAL CHAN1,60 60% for channel 1. Keysight 8990B Programming Guide...
Page 269
On reset, the pulse duration level is set to 0%. Query MEASure:THReshold:VALue? CHAN{1|2|3|4} This query returns the current setting of the threshold value for the specified channel. The response format is <NRf>. Query example Queries the threshold setting for channel 1. MEAS:THR:VAL? CHAN1 Keysight 8990B Programming Guide...
Range of values numeric_value A numeric value to set the histogram bin threshold: 5 to 20 – Minimum value: 5 – Maximum value: 20 Example This command sets the histogram bin MEAS:THR:HISTBIN 5 threshold value to 5. Keysight 8990B Programming Guide...
Page 271
(5)." or -222,"Data out of range;Value is clipped to maximum (20)." — will occur. Query MEASure:THReshold:HISTBIN? This query returns the current setting of the threshold value for the histogram bin. Query example Queries the threshold setting for the histogram MEAS:THR:HISTBIN? bin. Keysight 8990B Programming Guide...
MEASure Subsystem MEASure:TRACKMEAS <character_data>, CHAN{1|2|3|4},[NORMal|ZOOM], <Boolean> This command tracks the waveform by setting the marker for the chosen measurement on the specified channel. Syntax Space character_data CHAN NORM|ZOOM MEAS :TRACKMEAS 0|OFF 1|ON Keysight 8990B Programming Guide...
Page 273
MEAS:TRACKMEAS MIN, CHAN1, 1 track the minimum power measurement for channel 1 in Normal mode. This command sets a marker to MEAS:TRACKMEAS MIN, CHAN1, ZOOM, 1 track the minimum power measurement for channel 1 in Zoom mode. Keysight 8990B Programming Guide...
Page 274
– If the Zoom command is sent in the Normal mode, error –221,“Settings conflict;Require zoom mode to be enabled” will occur. Query MEASure:TRACKMEAS? This query returns the measurement type and the channel. Query example Returns the measurement type and the MEAS:TRACKMEAS? channel. Keysight 8990B Programming Guide...
Page 275
Keysight 8990B Peak Power Analyzer Programming Guide MULTIPULse Subsystem Overview MULTIPULse:ACQuire:FRAMe MULTIPULse:ACQuire:STATus? MULTIPULse:ACQuire:COUNTer? MULTIPULse:BACKWARD MULTIPULse:HISTOGRAMBIN <numeric_value> MULTIPULse:FORWARD MULTIPULse:FRAMe <numeric_value> MULTIPULse:GOTOFRAME <numeric_value> MULTIPULse:PLAYBACK <character_data> MULTIPULse:SAVE:MEASurement <string>,<character_data> MULTIPULse:TIMEstamp:DATA? MULTIPULse:TIMEstamp:DISPlay <boolean> This chapter describes how the MULTIPULse command subsystem is used to acquire measurement results in the multipulse mode.
This command acquires the frames in the MULTIPUL:ACQ:FRAM multipulse mode. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
Example Queries the multipulse completion status. MULTIPUL:ACQ:STAT? Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to query this data” will occur. Keysight 8990B Programming Guide...
Example Queries the multipulse acquisition number. MULTIPUL:ACQ:COUNT? Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to query this data” will occur. Keysight 8990B Programming Guide...
This command sets the multipulse backward by one MULTIPUL:BACKWARD frame. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
MULTIPUL:HISTOGRAMBIN 7 histogram bin size to 7. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
Page 282
MULTIPULse Subsystem Reset condition On reset, the multipulse histogram bin size is set to 10. Query MULTIPULse:HISTOGRAMBIN? This query returns the current multipulse histogram bin size. Query example Queries the current multipulse histogram bin MULTIPUL:HISTOGRAMBIN? size. Keysight 8990B Programming Guide...
This command sets the multipulse forward by one MULTIPUL:FORWARD frame. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
This command sets the multipulse frame count to 20. MULTIPUL:FRAM 20 Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
Page 285
MULTIPULse Subsystem Reset condition On reset, the multipulse frame count is set to 1. Query MULTIPULse:FRAMe? This query returns the current multipulse frame count. Query example Queries the current multipulse frame count. MULTIPUL:FRAM? Keysight 8990B Programming Guide...
This command displays frame 20 of the MULTIPUL:GOTOFRAME 20 multipulse. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
Page 287
MULTIPULse Subsystem Reset condition On reset, the selected multipulse frame is set to 1. Query MULTIPULse:GOTOFRAME? This query returns the current selected multipulse frame. Query example Queries the current selected multipulse frame. MULTIPUL:GOTOFRAME? Keysight 8990B Programming Guide...
This command starts the multipulse MULTIPUL:PLAYBACK START playback. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
Page 289
MULTIPULse Subsystem Reset condition On reset, the multipulse playback status is set to STOP. Query MULTIPULse:PLAYBACK? This query returns the current multipulse playback status. Query example Queries the current multipulse playback status. MULTIPUL:PLAYBACK? Keysight 8990B Programming Guide...
– The file name can be specified as a full path, for example, “c:\multipulse\xyz”, or only the file name, “xyz”. Any existing file with the same name will be overwritten automatically. – The default file directory is the working directory where the 8990B software resides. – The file extension is .csv.
Page 291
– This command is only applicable for channels 1 and 4 in the multipulse acquisition mode. – If an invalid file name is specified, error –257,“File name error” will occur. This error may also occur due to missing directory. Ensure that the directory exists. Keysight 8990B Programming Guide...
Queries the multipulse time stamp data. MULTIPUL:TIME:DATA? Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to query this data” will occur. Keysight 8990B Programming Guide...
This command displays the multipulse time MULTIPUL:TIME:DISP ON stamp. Remark This command is only applicable in the multipulse mode. If this query is sent in other modes, error –221,“Settings conflict;Required multipulse mode to set this setting.” will occur. Keysight 8990B Programming Guide...
Page 294
– 1 is returned when the multipulse time stamp is enabled. – 0 is returned when the multipulse time stamp is disabled. Query example Queries whether the multipulse time MULTPUL:TIME:DISP? stamp is enabled or disabled. Keysight 8990B Programming Guide...
Sets the marker A slope type as: POSitive – POSitive: Sets the slope to positive. This is the default setting. NEGative – NEGative: Sets the slope to negative. Example This command sets the marker A slope to positive. MARK:ASL POS Keysight 8990B Programming Guide...
Page 298
–222, “Data out of range; Value clipped to maximum (#)” will occur. Reset condition On reset, the marker A slope is set to positive. Query MARKer:ASLope? This query returns the current setting of the marker A slope. Query example Queries the marker A slope setting. MARK:ASL? Keysight 8990B Programming Guide...
Item Description/Defaul t numeric_value A numeric value in second for the X-axis position Example This command sets the X-axis position of marker A to MARK:AXP 0.1 0.1 s. Reset condition On reset, marker A is disabled. Keysight 8990B Programming Guide...
Page 300
MARKer Subsystem Query MARKer:AXPosition? This query returns the current setting of the marker A X-axis position. The response format is <NRf>. Query example Queries the X-axis position setting of marker A. MARK:AXP? Keysight 8990B Programming Guide...
“MARKer:MODE <character_data>” on page 321). Syntax Space numeric_value :AYP MARK Parameter Item Description/Defaul t numeric_value A numeric value for the Y-axis position Example This command sets the Y-axis position of marker A to 0.1. MARK:AYP 0.1 Keysight 8990B Programming Guide...
Page 302
This query returns the current setting of the marker A Y-axis position. The response format is <NRf> in the following units: – dBm/W (for channels 1 and 4) – V (for channels 2 and 3) Query example Queries the Y-axis position setting of marker A. MARK:AYP? Keysight 8990B Programming Guide...
Sets the marker B slope type as: POSitive – POSitive: Sets the slope to positive. This is the default setting. NEGative – NEGative: Sets the slope to negative. Example This command sets the marker B slope to positive. MARK:BSL POS Keysight 8990B Programming Guide...
Page 304
–222, “Data out of range; Value clipped to maximum (#)” will occur. Reset condition On reset, the marker B slope is set to positive. Query MARKer:BSLope? This query returns the current setting of the marker B slope. Query example Queries the marker B slope setting. MARK:BSL? Keysight 8990B Programming Guide...
Item Description/Defaul t numeric_value A numeric value in second for the X-axis position Example This command sets the X-axis position of marker B to MARK:BXP 0.5 0.5 s. Reset condition On reset, marker B is disabled. Keysight 8990B Programming Guide...
Page 306
MARKer Subsystem Query MARKer:BXPosition? This query returns the current setting of the marker B X-axis position. The response format is <NRf>. Query example Queries the X-axis position setting of marker B. MARK:BXP? Keysight 8990B Programming Guide...
“MARKer:MODE <character_data>” on page 321). Syntax Space numeric_value :BYP MARK Parameter Item Description/Defaul t numeric_value A numeric value for the Y-axis position Example This command sets the Y-axis position of marker B to 0.1. MARK:BYP 0.1 Keysight 8990B Programming Guide...
Page 308
This query returns the current setting of the marker B Y-axis position. The response format is <NRf> in the following units: – dBm/W (for channels 1 and 4) – V (for channels 2 and 3) Query example Queries the Y-axis position setting of marker B. MARK:BYP? Keysight 8990B Programming Guide...
– FUNC3: Sets the source to waveform math function 3. FUNC4 – FUNC4: Sets the source to waveform math function 4. [a] These parameters are not applicable when the marker measurement mode is set to DELay or SPACing. Keysight 8990B Programming Guide...
Page 310
B source, error 943, “Markers A and B are positioned on the same waveform” will occur. Reset condition On reset, marker A is disabled. Query MARKer:ASOUrce? This query returns the current setting of the marker A source. Query example Queries the marker A source. MARK:ASOU? Keysight 8990B Programming Guide...
– FUNC3: Sets the source to waveform math function 3. FUNC4 – FUNC4: Sets the source to waveform math function 4. [a] These parameters are not applicable when the marker measurement mode is set to DELay or SPACing. Keysight 8990B Programming Guide...
Page 312
A source, error 943,“Markers A and B are positioned on the same waveform” will occur. Reset condition On reset, marker B is disabled. Query MARKer:BSOUrce? This query returns the current setting of the marker B source. Query example Queries the marker B source. MARK:BSOU? Keysight 8990B Programming Guide...
Reference level 1 to reference level 2 – Default value: 50% – Minimum value: Reference level 1 (refer to “MEASure:THReshold:REFlevel{1|2} CHAN{1|2|3|4},<numeric_value>” on page 265, channel-dependent) – Maximum value: Reference level 2 (refer to “MEASure:THReshold:REFlevel{1|2} CHAN{1|2|3|4},<numeric_value>” on page 265, channel-dependent) Keysight 8990B Programming Guide...
Page 314
On reset, the marker measurement level is set to 50%. Query MARKer:LEVel? This query returns the current setting of the marker measurement level. The response format is <NRf>. Query example Queries the marker measurement level setting. MARK:LEV? Keysight 8990B Programming Guide...
Reference level 1 to reference level 2 – Default value: 50% – Minimum value: Reference level 1 (refer to “MEASure:THReshold:REFlevel{1|2} CHAN{1|2|3|4},<numeric_value>” on page 265) – Maximum value: Reference level 2 (refer to “MEASure:THReshold:REFlevel{1|2} CHAN{1|2|3|4},<numeric_value>” on page 265) Keysight 8990B Programming Guide...
Page 316
On reset, the marker A measurement level is set to 50%. Query MARKer:ALEVel? This query returns the current setting of the marker A measurement level. The response format is <NRf>. Query example Queries the marker A measurement level setting. MARK:ALEV? Keysight 8990B Programming Guide...
Reference level 1 to reference level 2 – Default value: 50% – Minimum value: Reference level 1 (refer to “MEASure:THReshold:REFlevel{1|2} CHAN{1|2|3|4},<numeric_value>” on page 265) – Maximum value: Reference level 2 (refer to “MEASure:THReshold:REFlevel{1|2} CHAN{1|2|3|4},<numeric_value>” on page 265) Keysight 8990B Programming Guide...
Page 318
On reset, the marker B measurement level is set to 50%. Query MARKer:BLEVel? This query returns the current setting of the marker B measurement level. The response format is <NRf>. Query example Queries the marker B measurement level setting. MARK:BLEV? Keysight 8990B Programming Guide...
Query MARKer:AYSEARCH? This query returns a list of float values, which is the X-axis position of the Marker A Y-axis input position. Query example Queries the X-axis position of the marker A Y-axis input MARK:AYSEARCH? position. Keysight 8990B Programming Guide...
Query MARKer:BYSEARCH? This query returns a list of float values, which is the X-axis position of the Marker B Y-axis input position. Query example Queries the X-axis position of the marker B Y-axis input MARK:BYSEARCH? position. Keysight 8990B Programming Guide...
– SPACing: Enables marker spacing measurement between two MEASure pulses. WAVeforms – FLOAt: Enables free float placement of the marker. – MEASure: Enables the tracking of the measurement using markers. – WAVeforms: Enables the tracking of the waveforms using markers. Keysight 8990B Programming Guide...
Page 322
– When the marker measurement mode is set to WAVeforms in CCDF mode, error -221, "Settings conflict; Track Measurement is not allowed in CCDF mode." will occur. – To enable the tracking of waveform measurements using markers, refer to “MEASure:TRACKMEAS <character_data>, CHAN{1|2|3|4},[NORMal|ZOOM], <Boolean>” on page 272. Keysight 8990B Programming Guide...
MARKer Subsystem MARKer:SPACing:PULSe{1|2} <numeric_value> This command sets the marker pulse spacing for spacing measurement. PULSe1 represents the lower pulse spacing while PULSe2 represents the upper pulse spacing. Syntax Space numeric_value MARK :PULS :SPAC Keysight 8990B Programming Guide...
Page 324
– If you set a pulse spacing value which exceeds its minimum or maximum limit, the value will be clipped to its minimum or maximum value respectively. Error –222,“Data out of range; Value clipped to minimum (#)” or –222,“Data out of range; Value clipped to maximum (#)” will occur. Keysight 8990B Programming Guide...
Page 325
On reset, the lower and upper pulse spacings are set to the 1st pulse and 2nd pulse respectively. Query MARKer:SPACing:PULSe{1|2}? This query returns the current setting of the lower or upper marker pulse spacing. The response format is <NR1>. Query example Queries the lower marker pulse spacing. MARK:SPAC:PULS1? Keysight 8990B Programming Guide...
CHAN1 – CHAN1: Sets the source to channel 1. CHAN2 CHAN3 – CHAN2: Sets the source to channel 2. CHAN4 – CHAN3: Sets the source to channel 3. – CHAN4: Sets the source to channel 4. Keysight 8990B Programming Guide...
Page 327
Reset condition On reset, the marker measurement mode is set to OFF. Query MARKer:SPACing:SOURce? This query returns the current setting of the marker source for spacing measurement. Query example Queries the marker source for spacing measurement. MARK:SPAC:SOUR? Keysight 8990B Programming Guide...
MARKer Subsystem MARKer:YAMPRATIO? This query returns the amplitude ratio value. Syntax MARK :YAMPRATIO Example Queries the amplitude ratio value. MARK:YAMPRATIO? Keysight 8990B Programming Guide...
MARKer Subsystem MARKer:XDELta? This query returns the X-axis delta value between the A and B markers. Syntax MARK :XDEL Example Queries the marker X-axis delta value. MARK:XDEL? Keysight 8990B Programming Guide...
MARKer Subsystem MARKer:YDELta? This query returns the Y-axis delta value between the A and B markers. Syntax MARK :YDEL Example Queries the marker Y-axis delta value. MARK:YDEL? Keysight 8990B Programming Guide...
Page 332
FUNCtion Subsystem FUNCtion{1|2|3|4}:SQUare <character_data>[,<numeric_value>] FUNCtion{1|2|3|4}:SQRT <character_data>[,<numeric_value>] FUNCtion{1|2|3|4}:SUBTract <character_data>,<character_data> [,<numeric_value>] FUNCtion{1|2|3|4}:SCALE <numeric_value> FUNCtion{1|2|3|4}:TRACe:DATA? FUNCtion{1|2|3|4}:TRACe:PERCent <boolean> This chapter explains how the FUNCtion command subsystem is used to perform mathematical operations on a pair of channels. Keysight 8990B Programming Guide...
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. Syntax Space :ADD character_data FUNC character_data numeric_value Keysight 8990B Programming Guide...
Page 336
This command is only applicable for channel pair 1 and 4 or 2 and 3. If an invalid channel pair is specified, the resulting unit will be undefined (UDF). For example, dBm + V = UDF. Keysight 8990B Programming Guide...
= 1, 2, 3, or 4 numeric_value A numeric value for the count number Example This command sets the source to CHAN1 and the FUNC1:AVER CHAN1,1 count number to 1 for the averaging operation. Keysight 8990B Programming Guide...
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. Syntax Space :COMM character_data FUNC character_data numeric_value Keysight 8990B Programming Guide...
Page 339
This command sets the source for the common FUNC1:COMM CHAN1,WMEM1 mode operation to channel 1 and waveform memory 1. Remark For the resultant trace that has unit other than dB, W, or V, the unit will be set to UDF (undefined). Keysight 8990B Programming Guide...
– 1 is returned when the function trace is turned on – 0 is returned when the function trace is turned off Query example Queries whether function trace 1 is turned on or off. FUNC1:DISP? Keysight 8990B Programming Guide...
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. Syntax Space :DIV character_data character_data FUNC numeric_value Keysight 8990B Programming Guide...
Page 342
This command is only applicable for channel pair 1 and 4 or 2 and 3. If an invalid channel pair is specified, the resulting unit will be undefined (UDF). For example, dBm + V = UDF. Keysight 8990B Programming Guide...
A numeric value as constant. 100 μ to 10 k – Default: 1 – Minimum: 100 μ – Maximum 10 k Example This command sets the source for the invert FUNC1:INV CHAN1 operation to channel 1. Keysight 8990B Programming Guide...
Page 344
FUNCtion Subsystem Remark For the resultant trace that has unit other than dB, W, or V, the unit will be set to UDF (undefined). Keysight 8990B Programming Guide...
A numeric value as constant. 100 μ to 10 k – Default: 1 – Minimum: 100 μ – Maximum 10 k Example This command sets the source for the magnify FUNC1:MAGN CHAN1 operation to channel 1. Keysight 8990B Programming Guide...
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. Syntax Space :MUL character_data character_data FUNC numeric_value Keysight 8990B Programming Guide...
Page 347
This command sets the source for the multiply FUNC1:MUL CHAN1,WMEM1 operation to channel 1 and waveform memory 1. Remark For the resultant trace that has unit other than dB, W, or V, the unit will be set to UDF (undefined). Keysight 8990B Programming Guide...
Page 349
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. – If the source(s) input is in the log scale, it will be converted to the linear scale to perform the power-added efficiency measurement. Keysight 8990B Programming Guide...
Page 350
[a] CH2MCH3 and CH3MCH2 parameters are only applicable for the IDC source. [b] For VDC and IDC, if the constant is set as a source, the value can be set by replacing the <numeric_data> slot. For PGAIN, the value can be appended after the 5 required parameters. Keysight 8990B Programming Guide...
Page 351
1, IDC to channel 3, IDC constant to 5, and PGAIN to channel 4. FUNC1:PAE CONS,CONS,CHAN4,2,5 This command performs the PAE operation by setting VDC constant to 2, IDC constant to 5, and PGAIN to channel 4. Keysight 8990B Programming Guide...
Page 353
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. If the source(s) input is in the log scale, it will be converted to the linear scale to perform the power-added efficiency measurement. Keysight 8990B Programming Guide...
Page 354
– CONStant numeric_value A numeric value as constant. 100 μ to 10 k – Default: 1 – Minimum: 100 μ – Maximum 10 k [a] CH2MCH3 and CH3MCH2 parameters are only applicable for the IDC source. Keysight 8990B Programming Guide...
Page 355
IDC constant to 6, POUT to channel 1, and PIN to channel 4. This command performs the PAE2 FUNC1:PAE2 operation by setting VDC constant to CONS,CONS,CHAN4,CHAN1,2,3 2, IDCconstant to 3, POUT to channel 4, and PIN to channel 1. Keysight 8990B Programming Guide...
Page 357
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. If the source(s) input is in the log scale, it will be converted to the linear scale to perform the power-added efficiency measurement. Keysight 8990B Programming Guide...
Page 358
[a] CH2MCH3 and CH3MCH2 parameters are only applicable for the IDC source. = (1st character_data) × (1st numeric_value) × (2nd numeric_value) = (2nd character_data) × (3rd numeric_value) × (4th numeric_value) = 3rd character_data = 4th character_data Keysight 8990B Programming Guide...
Page 359
FUNCtion Subsystem Example This command performs the PAE3 FUNC1:PAE3 operation by setting P CHAN3,CHAN2,CHAN1,CHAN4,5,6,7,8 (CHAN3)(5)(6), P (CHAN2)(7)(8), P to channel 1, and P to channel 4. Keysight 8990B Programming Guide...
A numeric value for the reference level For trace unit in W: 0 to 1000 Default: 0 For trace with unit other than W: –1000 to 1000 Example This command sets the function 1 reference level to 10. FUNC1:REF 10 Keysight 8990B Programming Guide...
Page 361
FUNCtion Subsystem Reset condition On reset, the reference level is set to 0. Query FUNCtion{1|2|3|4}:REFerence? This query returns the current reference level. The response format is <NRf>. Query example Queries the reference level for function 1. FUNC1:REF? Keysight 8990B Programming Guide...
– CENTre: Sets the reference type to centre. This is the default setting. Example This command sets the function trace reference FUNC1:REF:POS BOTT type to bottom. Reset condition On reset, the reference type is set to CENTre. Keysight 8990B Programming Guide...
Page 363
FUNCtion Subsystem Query FUNCtion{1|2|3|4}:REFerence:POSition? This query returns the current reference type. Query example Queries the reference type for function 1. FUNC1:REF:POS? Keysight 8990B Programming Guide...
Sets the source as: CHANnel<n> WMEMory<n> – CHANnel<n> CONStant – WMEMory<n> – CONStant where n = 1, 2, 3, or 4 numeric_value This numeric value is an optional parameter [a] This is not applicable for averaging. Keysight 8990B Programming Guide...
Page 365
This command sets the source to CONStant with FUNC1:SOUR1 CONS,5 the value at 5 for the source 1. Query FUNCtion{1|2|3|4}:{SOURce1|SOURce2}? This query returns the current source for the desired source term. Query example Queries the current source for function 1 source 1. FUNC1:SOUR1? Keysight 8990B Programming Guide...
– VDC is voltage supplied, IDC is current supplied, and PGAIN is the power gain for PAE. – <numeric_value> for this command is an optional parameter, which is used for setting VDC, IDC, or PGAIN as CONStant. Syntax Space :VDC character_data numeric_value FUNC :IDC :PGAI Keysight 8990B Programming Guide...
Page 367
This command sets the power gain PGAIN to FUNC1:PGAIN CHAN1 channel 1. Query FUNCtion{1|2|3|4}:{VDC|IDC|PGAIN}? This query returns the current source for the desired source term. Query example Queries the current source for function 1 VDC. FUNC1:VDC? Keysight 8990B Programming Guide...
PAE2, and POUT is the power output for PAE2. – <numeric_value> for this command is an optional parameter, which is used for setting VDC, IDC, PIN, or POUT as CONStant. Syntax Space :VDC character_data numeric_value FUNC :IDC :PIN :POUT Keysight 8990B Programming Guide...
Page 369
This command sets the power input PIN to FUNC1:PIN CHAN1 channel 1. Query FUNCtion{1|2|3|4}:{VDC|IDC|PIN|POUT}? This query returns the current source for the desired source term. Query example Queries the current source for function 1 IDC. FUNC1:IDC? Keysight 8990B Programming Guide...
This command sets the source for the square FUNC1:SQU CHAN1 operation to channel 1. Remark For the resultant trace that has unit other than dB, W, or V, the unit will be set to UDF (undefined). Keysight 8990B Programming Guide...
This command sets the source for the square root FUNC1:SQRT CHAN1 operation to channel 1. Remark For the resultant trace that has unit other than dB, W, or V, the unit will be set to UDF (undefined). Keysight 8990B Programming Guide...
– If the number of trace points is not equal, the waveform math operation will add trace points by using the PCHIP method. Syntax Space :SUBT character_data character_data FUNC numeric_value Keysight 8990B Programming Guide...
Page 373
This command is only applicable for channel pair 1 and 4 or 2 and 3. If an invalid channel pair is specified, the resulting unit will be undefined (UDF). For example, dBm + V = UDF. Keysight 8990B Programming Guide...
– 10 k per division (for other trace unit) – Minimum: – 0.01 dB per division (for trace unit dBm) – 1 n per division (for other trace unit) Example This command sets the function 1 scale to 10/div. FUNC1:SCALE 10 Keysight 8990B Programming Guide...
Page 375
On reset, the scale is set to 1.00 dB/div. Query FUNC{1|2}:SCALe? This query returns the current setting of the scale for the specified function. The response format is <NRf>. Query example Queries the scale setting for function 1. FUNC1:SCAL? Keysight 8990B Programming Guide...
This query returns the current trace data of the specified source. The data is returned as a definite-length binary block of floating point numbers. Syntax :TRAC :DATA FUNC Example Queries the current trace data for function 1. FUNC1:TRAC:DATA? Keysight 8990B Programming Guide...
1|ON Example This command displays the function trace 1 in FUNC1:TRAC:PERC ON percentage. Remark This command is only applicable for the PAE or PAE2 operation. Reset condition On reset, the trace is not displayed in percentage. Keysight 8990B Programming Guide...
Page 378
– 1 is returned when the function trace is set to percentage – 0 is returned when the function trace is not set to percentage Query example Queries whether function trace 1 is set to FUNC1:TRAC:PERC? percentage. Keysight 8990B Programming Guide...
Keysight 8990B Peak Power Analyzer Programming Guide TRACe Subsystem Overview TRACe:DATA? <character_data>[,HRES] TRACe:HRES:DISPlay <boolean> TRACe:HRES {0|1} TRACe:XINCrement? <character_data> TRACe:XSTART? This chapter describes how the TRACe command subsystem is used to acquire the waveform trace data and the duration between consecutive data points.
TRACe Subsystem Overview The TRACe command subsystem is used to obtain the trace data and the duration between consecutive data points of the 8990B. Keyword Parameter form Note Page TRACe [query only] page 381 :DATA? <character_data>[,HRES] page 384 :HRES:DISP <boolean>...
– When the acquisition is stopped or paused, using the [,HRES] parameter is not able to return any trace data. – This command is only applicable for timebase scale below 2 ms. Syntax character_data HRES Space TRAC :DATA Keysight 8990B Programming Guide...
Page 382
– For the CCDF Gaussian source, this query is only applicable when the CCDF Gaussian trace is enabled. If the Gaussian trace is not enabled, error –221,“Settings conflict;Requires CCDF Gaussian trace to be enabled” will occur. Refer to “ACQuire:CCDF:GAUSsian[:STATe] <boolean>” on page 95 to set the CCDF Gaussian trace. Keysight 8990B Programming Guide...
Page 383
– For Channel 2 and Channel 3, the channel vertical offset must be adjusted to ensure that no part of the trace is off-screen. Parts of the trace that is off-screen will be clipped off in the resulting queried trace. Keysight 8990B Programming Guide...
– 0 is returned when the displaying of the high resolution trace on the graph is disabled Query example Queries whether the display of the high resolution trace on TRAC:HRES:DISP? the graph is enabled or disabled. Keysight 8990B Programming Guide...
Page 385
TRACe Subsystem Remarks – This command is only enabled when HRES mode is on. – This command is only applicable for a timebase scale below 2 ms. Keysight 8990B Programming Guide...
TRAC :HRES 0|OFF 1|ON Example Enables high resolution trace on the graph. TRAC:HRES 1 Remarks This command blanks out the display. To enable the display during high resolution trace, use the following command — TRACe:HRES:DISP 1 Keysight 8990B Programming Guide...
CHAN3 – CHAN2: Sets the channel 2 trace. CHAN4 – CHAN3: Sets the channel 3 trace. – CHAN4: Sets the channel 4 trace. Example Queries the duration between consecutive data TRAC:XINC? CHAN1 points for channel 1. Keysight 8990B Programming Guide...
TRACe Subsystem TRACe:XSTART? This query returns the trace X start value. Syntax TRAC :XSTART Example Queries the trace X start value. TRAC:XSTART? Keysight 8990B Programming Guide...
Page 390
LIMIT Subsystem LIMIT:FWAVeform:COUNt? LIMIT:FPOINt:COUNt? <character_data> LIMIT:COMPlete? This chapter describes how the LIMIT command subsystem is used to set the upper and lower limit tests. Keysight 8990B Programming Guide...
– 1 is returned when the upper limit test is enabled – 0 is returned when the upper limit test is disabled Query example Queries whether the upper limit test is enabled or disabled. LIMIT:UP? Keysight 8990B Programming Guide...
– 1 is returned when the lower limit test is enabled – 0 is returned when the lower limit test is disabled Query example Queries whether the lower limit test is enabled or disabled. LIMIT:LOW? Keysight 8990B Programming Guide...
The range of values depends on the limit test source. Example This command sets the upper limit level to 1. LIMIT:UPper:LEVEL 1 Query LIMIT:UPper:LEVEL? This query returns the current level of the upper limit test. The response format is <NRf>. Keysight 8990B Programming Guide...
Page 396
When this command is in use, the following messages — "-992, Limit test setting changed, LIMIT:TYPE is set to LINear and LIMIT:SOURce is set to trigger source." and “-221, Settings conflict;Vertical Tolerance Type for limit test changed to SourceUnit." — will be shown. Keysight 8990B Programming Guide...
The range of values depends on the limit test source. Example This command sets the lower limit level to 1. LIMIT:LOWer:LEVEL 1 Query LIMIT:LOWer:LEVEL? This query returns the current level of the lower limit test. The response format is <NRf>. Keysight 8990B Programming Guide...
Page 398
When this command is in use, the following messages — "-992, Limit test setting changed, LIMIT:TYPE is set to LINear and LIMIT:SOURce is set to trigger source." and “-221, Settings conflict;Vertical Tolerance Type for limit test changed to SourceUnit." — will be shown. Keysight 8990B Programming Guide...
Item Description/Defaul t Range of values character_data Sets the masking type as: AUTomask AUTomask LINear LINear Example This command sets the masking type to LIMIT:TYPE AUT AUTomask. Query LIMIT:TYPE? This query returns the current masking type. Keysight 8990B Programming Guide...
Page 400
LIMIT Subsystem Query example Queries the masking type. LIMIT:TYPE? Reset condition On reset, the masking type is set to AUTomask. Keysight 8990B Programming Guide...
CHANnel<n> WMEMory<n> – CHANnel<n> FUNCtion{1|2|3|4} – WMEMory<n> – FUNCtion{1|2|3|4} where n = 1, 2, 3, or 4 Example This command sets the source to CHAN1. LIMIT:SOUR CHAN1 Query LIMIT:SOUR? This query returns the current masking source. Keysight 8990B Programming Guide...
Page 402
When that happens, the following error will also appear — error -221,”Settings conflict;Channel2 is removed from limit test target.”. Depending on the test target, the channel or channels removed may vary. Reset condition On reset, the masking source is set to NONE. Keysight 8990B Programming Guide...
Sets the vertical tolerance type to: DIVision DIVision SUNIT SUNIT: Source unit PCENT PCENT: Percentage Example This command sets the vertical tolerance type to LIMIT:VTYPE SUNIT SUNIT. Query LIMIT:VTYPE? This query returns the current vertical tolerance type. Keysight 8990B Programming Guide...
Page 404
LIMIT Subsystem Query example Queries the vertical tolerance type. LIMIT:VTYPE? Reset condition On reset, the vertical tolerance type is set to DIVision. Keysight 8990B Programming Guide...
0 W to 1 W (mask source set to channel with Watts as unit) 0 V to 5 V (mask source set to channel with Volts as unit) For the PCENT vertical tolerance type: 0% to 100% Example This command sets the V1 value to 0.3 div. LIMIT:V1 0.3 Keysight 8990B Programming Guide...
Page 406
Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Reset condition On reset, the V1 value is set to 0.2 div. Keysight 8990B Programming Guide...
0 W to 1 W (mask source set to channel with Watts as unit) 0 V to 5 V (mask source set to channel with Volts as unit) For the PCENT vertical tolerance type: 0% to 100% Example This command sets the V2 value to 0.3 div. LIMIT:V2 0.3 Keysight 8990B Programming Guide...
Page 408
Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Reset condition On reset, the V2 value is set to 0.2 div. Keysight 8990B Programming Guide...
This query returns the status of the V1 and V2 values. Query example Queries the status of the V1 and V2 values, whether LIMIT:V2SAMEV1? they are locked or unlocked. Reset condition On reset, the value is set to 1 Keysight 8990B Programming Guide...
This command sets the horizontal tolerance type LIMIT:HTYPE SUNIT to SUNIT. Query LIMIT:HTYPE? This query returns the horizontal tolerance type. Query example Queries the horizontal tolerance type. LIMIT:HTYPE? Reset condition On reset, the vertical tolerance type is set to DIVision. Keysight 8990B Programming Guide...
0 - 4 type: For the DIVision horizontal tolerance type: 0 to 4 For the SUNIT horizontal tolerance type: (0 to 4) × (timebase scale) Example This command sets the H1 value to 0.3 div. LIMIT:H1 0.3 Keysight 8990B Programming Guide...
Page 412
Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Reset condition On reset, the H1 value is set to 0.00 div. Keysight 8990B Programming Guide...
For the SUNIT horizontal tolerance type: (0 to 4) × (timebase scale) Example This command sets the H2 value to 0.3 div. LIMIT:H2 0.3 Reset condition On reset, the H2 value is set to 0.00 div. Keysight 8990B Programming Guide...
Page 414
Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Reset condition On reset, the H2 value is set to 0.00 div. Keysight 8990B Programming Guide...
This query returns the status of the H1 and H2 values. Query example Queries the status of the H1 and H2 values, whether LIMIT:H2SAMEH1? they are locked or unlocked. Reset condition On reset, the value is set to 1 Keysight 8990B Programming Guide...
LIMIT :CREA Example This command creates mask shading on the graph. LIMIT:CREA Remarks – If the LIMIT:CREAte command is used before running the LIMIT:SOURce command, error -994,"Setting conflict;Please assign mask source before create mask” will occur. Keysight 8990B Programming Guide...
LIMIT Subsystem LIMIT:CLEAr This command clears mask shading on the graph. Syntax LIMIT :CLEA Example This command clears mask shading on the graph. LIMIT:CLEA Keysight 8990B Programming Guide...
– When a test target with a unit differing from that of the mask source is inserted, the following error — -221,"Settings conflict;Limit test can be performed only when target unit is the same as mask source unit. Target is not inserted." — will occur. Keysight 8990B Programming Guide...
Range of values character_data Sets the source as: CHANnel<n> WMEMory<n> – CHANnel<n> FUNCtion{1|2|3|4} – WMEMory<n> – FUNCtion{1|2|3|4} where n = 1, 2, 3, or 4 Example This command removes CHAN1 as a test target. LIMIT:TARG:REM CHAN1 Keysight 8990B Programming Guide...
:TARG :LIST Example Returns the current test target or the list of test targets set LIMIT:TARG:LIST? by LIMIT:TARGet:INSert. Remarks If there are no targets to list, error –221,"Settings conflict;No target set for limit test." will occur. Keysight 8990B Programming Guide...
WAVeforms test operation types: 0 - 100k For the DURation test operation type: 0.1 to 60 minutes For the WAVeforms test operation type: 0 to 100k Example This command sets the test operation type to run LIMIT:RUN FOR forever. Keysight 8990B Programming Guide...
Page 422
This query checks if the limit test is set to stop, and if yes, the stop criteria. Query example Queries if the limit test is set to stop, and if yes, the LIMIT:RUN? stop criteria. Reset condition On reset, the test operation type is set to run forever. Keysight 8990B Programming Guide...
– 1 is returned when the stop-on-failure function is enabled – 0 is returned when the stop-on-failure function is disabled Query example Queries whether the stop-on-failure function is enabled or LIMIT:SOF? disabled. Reset condition On reset, the stop-on-failure function is set to OFF. Keysight 8990B Programming Guide...
This query checks if the recording of test failures to a .csv file is enabled. Query example Queries the status of the recording of test failures. LIMIT:RECF? Reset condition On reset, the recording of test failures to a .csv file. is set to OFF. Keysight 8990B Programming Guide...
LIMIT:RECF:PATH "c:\failure\test". c:\failure\test Query LIMIT:RECFailure:PATH? This query returns the file path where the .csv file from the LIMIT:RECFailure command will be saved. Query example LIMIT:RECF:PATH? Returns the file path where the .csv file will be saved. Keysight 8990B Programming Guide...
Description/Defaul t Range of values Sets the source as: CHANnel<n> WMEMory<n> – CHANnel<n> FUNCtion{1|2|3|4} character_data – WMEMory<n> – FUNCtion{1|2|3|4} where n = 1, 2, 3, or 4 Example This command sets the source to CHAN1. LIMIT:RECF:SOUR CHAN1 Keysight 8990B Programming Guide...
LIMIT Subsystem LIMIT:CLRFailure This command clears any failures that are on the graph. Syntax LIMIT :CLRF Example This command clears any failures that are on the LIMIT:CLRF graph. Keysight 8990B Programming Guide...
– If the test target is not set, error –994,"Setting conflict;Please select at least one target to start limit test." will occur. – If the mask source has not been selected, error –994,"Setting conflict;Please create mask before start limit test." will occur. Keysight 8990B Programming Guide...
LIMIT Subsystem LIMIT:STOP This command stops the limit test. Syntax LIMIT :STOP Example This command stops the limit test. LIMIT:STOP Keysight 8990B Programming Guide...
This query returns the number of failure waveforms. Syntax LIMIT :FWAV :COUN Example Returns the number of failure waveforms. LIMIT:FWAV:COUN? Remarks When the test has not started or the failure points have been cleared, this query will return a value of –1 Keysight 8990B Programming Guide...
Range of values character_data Sets the limit test type from which the query is to return the UPper failure points: LOWer UPper LOWer Example This query returns the failure points from the LIMIT:FPOIN:COUN? LOW lower limit test. Keysight 8990B Programming Guide...
– 1 is returned when the limit test is completed or stopped – 0 is returned when the limit test is running Syntax :COMP LIMIT Example Returns the completion status of the limit test. LIMIT:COMP? Keysight 8990B Programming Guide...
Page 433
Questionable Status Register Sets STATus:QUEStionable STATus:QUEStionable:CALibration STATus:QUEStionable:VOLTage Status Block Diagram This chapter explains how the STATus command subsystem enables you to examine the status of the 8990B by monitoring the “Device Status Register”, “Operation Status Register”, and “Questionable Status Register”.
– Device status register – Operation status register – Questionable status register The contents of these and other registers in the 8990B are determined by one or more status registers. The following table summarizes the effects of various commands and events on...
Page 435
(page 440) STATus:DEVice (page 443) STATus:OPERation (page 446) STATus:QUEStionable (page 447) STATus:QUEStionable:CALibration (page 448) STATus:QUEStionable:VOLTage Examples Using the :CONDition? query to examine the STATus:DEVice register: STATus:DEVice:CONDition? Using the :NTRansition command to examine the STATus:QUEStionable:CALibration register: STATus:QUEStionable:CALibration:NTRansition Keysight 8990B Programming Guide...
Condition register of the SCPI register set you require to control. The return format is <NR1> in the range of 0 to 32767 (2 –1). The contents of the Condition register remain unchanged after they are read. Syntax :COND Keysight 8990B Programming Guide...
Page 437
The last bit (bit 15) is always set to 0. Syntax Space :ENAB non-decimal numeric Parameter Item Description Range of values The value used to set the Enable register 0 to 2 –1 non-decimal numeric Keysight 8990B Programming Guide...
Page 438
This query returns a 15-bit decimal-weighted number representing the contents of the Negative Transition register of the SCPI register set being queried. The return format is <NR1> in the range of 0 to 32767 (2 –1). Keysight 8990B Programming Guide...
This query returns a 15-bit decimal-weighted number representing the contents of the Positive Transition register of the SCPI register set being queried. The return format is <NR1> in the range of 0 to 32767 (2 –1). Keysight 8990B Programming Guide...
The following descriptions detail the SCPI register you require to control and some examples on the register set commands. The one device status register set is: STATus:DEVice The following bits in this register are used by the 8990B: Weight/Decimal value Definition Not used...
Page 441
STATus:DEVice:PTRansition. If the corresponding bit in: – STATus:DEVice:NTRansition is 1, then 1 is set when no error is detected. – STATus:DEVice:PTRansition is 1, then 1 is set when an error is detected. Querying STATus:DEVice[:EVENt]? clears the Device Status Event register. NOTE Keysight 8990B Programming Guide...
Operation Status Register Set The STATUS:OPERation register set contains information which is part of the 8990B normal operation. The contents of the individual registers of this register set can be accessed by appending the commands listed in Status Register Set Commands.
STATus Subsystem STATus:OPERation The operation status register set contains conditions which are a part of the 8990B operation as a whole. The following bits in the register set are used by the 8990B: Weight/Decimal value Definition 0 to 6 –...
Bit 15 is always 0. Register Fil ter/Enable PRESet value OPERation ENABle all zeros all ones all zeros QUEStionable ENABle all zeros all ones all zeros All others ENABle all ones all ones all zeros Syntax :PRES STAT Keysight 8990B Programming Guide...
Questionable Status Register Sets The questionable status register sets contain information which gives an indication of the quality of data produced by the 8990B. The contents of the individual registers in these register sets can be accessed by appending the...
STATus Subsystem STATus:QUEStionable The questionable status register set contains bits that indicate the quality of various aspects of signals processed by the 8990B. The following bits in the register set are used by the 8990B: Weight/Decimal value Definition VOLTage summary 1 to 7 –...
STATus Subsystem STATus:QUEStionable:CALibration The questionable status calibration summary register contains bits which give an indication of the quality of data produced by the 8990B due to its calibration status. The following bits in the register are used by the 8990B:...
STATus Subsystem STATus:QUEStionable:VOLTage The questionable status voltage summary register contains bits that indicate the quality of voltage data being acquired by the 8990B. The following bits in the register are used by the 8990B: Weight/Decimal value Definition 0 to 1 –...
Keysight 8990B Peak Power Analyzer Programming Guide DISPlay Subsystem Overview DISPlay:CONNect <boolean> DISPlay:TRACk <boolean> DISPlay:TRACk:MAX <boolean> DISPlay:TRACk:MIN <boolean> DISPlay:CLEar [<character_data>] DISPlay:OUTput? <character_data> This chapter describes how the DISPlay command subsystem is used to configure the 8990B waveform display.
This query enters a 1 or 0 into the output buffer indicating the state of the vectors display mode. – 1 is returned when vectors is turned on – 0 is returned when vectors is turned off Query example Queries whether the vectors display mode is turned on or off. DISP:CONN? Keysight 8990B Programming Guide...
– 1 is returned when the tracking region is enabled – 0 is returned when the tracking region is disabled Query example Queries whether the tracking region for maximum and DISP:TRAC? minimum traces is turned on or off. Keysight 8990B Programming Guide...
– 1 is returned when the maximum tracking line is enabled – 0 is returned when the maximum tracking line is disabled Query example Queries whether the maximum trace tracking line is DISP:TRAC:MAX? enabled or disabled. Keysight 8990B Programming Guide...
– 1 is returned when the minimum tracking line is enabled – 0 is returned when the minimum tracking line is disabled Query example Queries whether the minimum trace tracking line is DISP:TRAC:MIN? enabled or disabled. Keysight 8990B Programming Guide...
This command clears the current screen display. DISP:CLE Remarks – When the 8990B is running in the continuous acquisition mode, this command clears the current waveform and redraws it. – This command also clears the measurement data, marker information, droop measurement data, and waveform averaging if the MEASuretab parameter is not specified.
DISPlay Subsystem DISPlay:OUTput? <character_data> This query performs a screen capture of the current screen display of the 8990B, sends the screen capture across the remote connection in binary format, and exports it as an image file. The data is returned as a definite-length binary block of floating point numbers.
Page 459
– PNG: Sets the export format as PNG. TIFF – TIFF: Sets the export format as TIFF. Example Takes a screen capture, sends it across the remote DISP:OUT? JPEG connection, and exports it as a JPEG file. Keysight 8990B Programming Guide...
Page 460
DISPlay Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 461
Keysight 8990B Peak Power Analyzer Programming Guide XYDISPlay Subsystem Overview XYDISPlay:REFerence:STATe <boolean> XYDISPlay:XSOURce <character_data> XYDISPlay:YSOURce <character_data> This chapter describes how the XYDISPlay command subsystem is used to configure the XY display mode.
XYDISPlay, error –221,“Settings conflict;Requires XY display mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” on page 132 to set the acquisition mode. Reset condition On reset, the XY reference trace is disabled. Keysight 8990B Programming Guide...
Page 464
– 1 is returned when the XY reference trace is enabled. – 0 is returned when the XY reference trace is disabled. Query example Queries whether the XY reference trace is enabled or XYDISP:REF:STAT? disabled. Keysight 8990B Programming Guide...
XY display mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” on page 132 to set the acquisition mode. Reset condition On reset, the X-axis source for the XY Display mode is set to CHAN1. Keysight 8990B Programming Guide...
Page 466
XYDISPlay Subsystem Query XYDISPlay:XSOURce? This query returns the current setting of the X-axis source for the XY Display mode. Query example Queries the XY Display mode X-axis source. XYDISP:XSOUR? Keysight 8990B Programming Guide...
XY display mode to be enabled” will occur. Refer to “ACQuire:MODE <character_data>” on page 132 to set the acquisition mode. Reset condition On reset, the Y-axis source for the XY Display mode is set to CHAN1. Keysight 8990B Programming Guide...
Page 468
XYDISPlay Subsystem Query XYDISPlay:YSOURce? This query returns the current setting of the Y-axis source for the XY Display mode. Query example Queries the XY Display mode Y-axis source. XYDISP:YSOUR? Keysight 8990B Programming Guide...
Page 469
Keysight 8990B Peak Power Analyzer Programming Guide DISK Subsystem Overview DISK:CWD? DISK:LOAD <string>[,<character_data>] DISK:LOAD:MASK <string> DISK:SAVE:IMAGe <string>,<character_data> DISK:SAVE:MASK <string> DISK:SAVE:SETup <string> DISK:SAVE:WAVeforms <string>,<character_data> This chapter explains how the DISK command subsystem is used to save and recall/load instrument setups and waveforms.
Overview The DISK command subsystem allows you to perform file maintenance for the 8990B setups and waveforms. You can choose to save the current display, instrument setup, and channel waveform to a file, or to load any saved setup or waveform from a file.
DISK Subsystem DISK:CWD? This query returns the current working directory of the 8990B software. The directory is returned as a string. Syntax DISK :CWD Example Queries the 8990B current working directory. DISK:CWD? Keysight 8990B Programming Guide...
This is an optional parameter. If no memory slot is specified, NONE will be used. [a] This parameter is only applicable for loading a saved waveform from the specified file into the 8990B memory slot. [b] Memory slot 1 will be assigned when NONE is used.
Page 473
PPA restoring all configurations to default value.” — will occur. – No character data is required when loading CCDF waveform. For example, THE DISK:LOAD “c:\wfmCCDF1.csv” command loads the saved waveform into CCDF. Keysight 8990B Programming Guide...
– The waveform file name can be specified as a full path, for example, “c:\wave\xyz.mst”, or only the file name, “xyz.mst”. – The default file directory is the working directory where the 8990B software resides. Example This command loads the masking...
– The file name can be specified as a full path, for example, “c:\wave\xyz”, or only the file name, “xyz”. Any existing file with the same name will be overwritten automatically. – The default file directory is the working directory where the 8990B software resides. character_data Sets the file format as: –...
– The file name can be specified as a full path, for example, “c:\wave\xyz”, or only the file name, “xyz”. Any existing file with the same name will be overwritten automatically. – The default file directory is the working directory where the 8990B software resides. – The file extension is .mst.
– The file name can be specified as a full path, for example, “c:\wave\xyz”, or only the file name, “xyz”. Any existing file with the same name will be overwritten automatically. – The default file directory is the working directory where the 8990B software resides. – The file extension is .xml.
DISK Subsystem DISK:SAVE:WAVeforms <string>,<character_data> This command saves the current 8990B waveform of the selected channel or memory slot to a .csv file. Syntax Space :SAVE :WAV string character_data DISK Keysight 8990B Programming Guide...
Page 479
– The file name can be specified as a full path, for example, “c:\wave\xyz”, or only the file name, “xyz”. Any existing file with the same name will be overwritten automatically. – The default file directory is the working directory where the 8990B software resides. – The file extension is .csv.
Page 480
– The waveform data and CCDF memory data is recalled from a file with a .csv extension. – If an invalid file name is specified, error –256,“File name not found” will occur. This error may also occur due to missing directory. Ensure that the directory exists. Keysight 8990B Programming Guide...
Page 481
Keysight 8990B Peak Power Analyzer Programming Guide MEMory Subsystem MEMory Subsystem MEMory:TABle:CLEar MEMory:TABle:CLEar:NAME <string> MEMory:TABle:DELete <numeric_value> MEMory:TABle:EDIT <numeric_value>,<numeric_value> MEMory:TABle:FREQuency? MEMory:TABle:INSert <numeric_value>,<numeric_value> MEMory:TABle:LIST? MEMory:TABle:OFFSet? MEMory:TABle:POINts? MEMory:TABle:SELect <string> MEMory:TABle:UNSELect This chapter explains how the MEMory command subsystem is used to configure the frequency-dependent offset (FDO) tables.
MEMory Subsystem The MEMory command subsystem is used to create, edit, and view FDO tables. The 8990B is capable of storing 10 FDO tables of 80 frequency points each. Stored tables remain in the 8990B memory during power down. Keyword...
NOTE Syntax :CLE :TAB Example This command clears the contents of the selected FDO MEM:TAB:CLE table. Remark If no FDO table has been selected when sending this command, error –221,“Settings conflict;No FDO table selected” will occur. Keysight 8990B Programming Guide...
(lowercase) 0 to 9 _ (underscore) Example This command clears the contents of the MEM:TAB:CLE:NAME “CUSTOM_D” “CUSTOM_D” FDO table. Remark If an invalid table name is specified, error –224,“Illegal parameter value” will occur. Keysight 8990B Programming Guide...
FDO table. Remarks – If no FDO table has been selected when sending this command, error –221,“Settings conflict;No FDO table selected” will occur. – If the frequency specified does not exist, error –224,“Illegal parameter value” will occur. Keysight 8990B Programming Guide...
<numeric_value> represents the offset. The frequency value specified will be truncated to a multiple of 1000. Example This command changes the offset to 30% for the MEM:TAB:EDIT 1000,30 1 kHz frequency in the selected FDO table. Keysight 8990B Programming Guide...
Page 487
– The frequency value specified must exist in the selected FDO table. If the frequency value does not exist, error –224,”Illegal parameter value” will occur. – If you set an offset value which exceeds its minimum or maximum limit, error –222,“Data out of range” will occur. Keysight 8990B Programming Guide...
Syntax :TAB :FREQ Example Queries the list of frequency values of the selected FDO MEM:TAB:FREQ? table. Remark If no FDO table has been selected when sending this query, error –221,“Settings conflict;No FDO table selected” will occur. Keysight 8990B Programming Guide...
<numeric_value> represents the offset. The frequency value specified will be truncated to a multiple of 1000. Example This command inserts a 1 kHz frequency with an MEM:TAB:INS 1000,20 offset of 20% for the selected FDO table. Keysight 8990B Programming Guide...
Page 490
– If you set an offset value which exceeds its minimum or maximum limit, error –222,“Data out of range” will occur. – If the selected FDO table has more than 80 frequency points, error 946,”Selected FDO table has reached the limit of 80 frequency points” will occur. Keysight 8990B Programming Guide...
MEMory Subsystem MEMory:TABle:LIST? This query returns a list of all the available FDO tables in the 8990B as a string array. Syntax :TAB :LIST Example Queries the list of all available FDO tables. MEM:TAB:LIST? Keysight 8990B Programming Guide...
Syntax :TAB :OFFS Example Queries the list of offset values of the selected FDO MEM:TAB:OFFS? table. Remark If no FDO table has been selected when sending this query, error –221,“Settings conflict;No FDO table selected” will occur. Keysight 8990B Programming Guide...
494. Syntax :TAB :POIN Example Queries the number of points for the selected FDO MEM:TAB:POIN? table. Remark If no FDO table has been selected when sending this query, error –221,“Settings conflict;No FDO table selected” will occur. Keysight 8990B Programming Guide...
Sets any of the following FDO table names as a string value (“”): – CUSTOM_A – CUSTOM_B – CUSTOM_C – CUSTOM_D – CUSTOM_E – CUSTOM_F – CUSTOM_G – CUSTOM_H – CUSTOM_I – CUSTOM_J Example This command selects an FDO table named MEM:TAB:SEL “CUSTOM_A” “CUSTOM_A”. Keysight 8990B Programming Guide...
Page 495
–224,”Illegal parameter value” will occur. Query MEMory:TABle:SELect? This query returns the name of the currently selected FDO table as a string value. Query example Queries the name of the current FDO table. MEM:TAB:SEL? Keysight 8990B Programming Guide...
MEMory Subsystem MEMory:TABle:UNSELect This command will undo the selection on any currently selected FDO table. Syntax :TABL :UNSEL Example This command deselects any currently MEM:TAB:UNSEL selected FDO table. Keysight 8990B Programming Guide...
Keysight 8990B Peak Power Analyzer Programming Guide WMEMory Subsystem Overview WMEMory{1|2|3|4}:CLEar WMEMory{1|2|3|4}:DISPlay <boolean> WMEMory{1|2|3|4}:OFFSet <numeric_value> WMEMory{1|2|3|4}:SAVE <character_data> WMEMory{1|2|3|4}:SCALe <numeric_value> WMEMory{1|2|3|4}:UNIT? This chapter describes how the WMEMory command subsystem is used to configure the waveforms in the 8990B memory.
The WMEMory command subsystem allows you to configure the display, offset, and scale of the waveform in a 8990B memory slot as well as save a waveform into the selected memory slot. This command subsystem also enables you to clear a waveform memory slot or query the waveform unit of the selected memory slot.
WMEMory Subsystem WMEMory{1|2|3|4}:CLEar This command clears the waveform data of the specified memory slot. Syntax WMEM :CLE Example This command clears the waveform data of memory slot 1. WMEM1:CLE Keysight 8990B Programming Guide...
– 1 is returned when the waveform trace display is turned on – 0 is returned when the waveform trace display is turned off Query example Queries whether the waveform trace display of memory slot WMEM3:DISP? 3 is turned on or off. Keysight 8990B Programming Guide...
– 99 dB/div or 1W/div (for waveforms of channels 1 and 4) – 4 V/div (for waveforms of channels 2 and 3) Example This command sets the waveform offset of memory slot WMEM1:OFFS 0.1 1 to 0.1 dB/div. Keysight 8990B Programming Guide...
Page 502
The response format is <NRf> in the following units: – dB/div or W/div (for waveforms of channels 1 and 4) – V/div (for waveforms of channels 2 and 3). Query example Queries the waveform offset setting of memory slot 4. WMEM4:OFFS? Keysight 8990B Programming Guide...
– WMEM2: Sets to memory slot 2. WMEM4 – WMEM3: Sets to memory slot 3. – WMEM4: Sets to memory slot 4. Example This command saves the channel 2 waveform into WMEM1:SAVE CHAN2 memory slot 1. Keysight 8990B Programming Guide...
Page 504
– If there is no waveform data in the source memory slot, error –221,“Settings conflict;No data in waveform memory slot” occurs. – If a disabled channel is specified as the waveform channel source, error –221,“Settings conflict;Requires channel # to be enabled” occurs. Keysight 8990B Programming Guide...
– 100 dB/div or 1 kW/div (for waveforms of channels 1 and 4) – 1 V/div (for waveforms of channels 2 and 3) Example This command sets the waveform scale of memory slot WMEM1:SCAL 5 1 to 5 dB/div. Keysight 8990B Programming Guide...
Page 506
The response format is <NRf> in the following units: – dB/div or W/div (for waveforms of channels 1 and 4) – V/div (for waveforms of channels 2 and 3). Query example Queries the waveform scale setting of memory slot 2. WMEM2:SCAL? Keysight 8990B Programming Guide...
This query returns the waveform unit of the specified memory slot as DBM, WATT, or VOLT. Syntax WMEM :UNIT Example Queries the waveform unit of memory slot 3. WMEM3:UNIT? Remark If no waveform data exists in the selected memory slot, error –221,“Settings conflict;No data in waveform memory slot” will occur. Keysight 8990B Programming Guide...
Page 508
WMEMory Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Keysight 8990B Peak Power Analyzer Programming Guide SERVice Subsystem Overview SERVice:BIST:TBASe[:STATe] <boolean> SERVice:CSOUrce[:STATe] <boolean> SERVice:CSOUrce:FREQuency <character_data> SERVice:CSOUrce:INTerval <numeric_value> SERVice:SECure:ERASe This chapter describes how the SERVice command subsystem is used to configure the reference check source and perform data secure erase.
SERVice Subsystem Overview The SERVice command subsystem controls the reference check source configuration and secure erase operation of the 8990B. Keyword Parameter form Note Page SERVice :BIST :TBASe page 511 :STATe <boolean> :CSOUrce page 512 [:STATe] <boolean> page 513 :FREQuency <character_data>...
This query enters a 1 or 0 into the output buffer indicating the state of the 10 MHz timebase testing. – 1 is returned when the signal is enabled – 0 is returned when the signal is disabled Query example Queries whether the 10 MHz timebase signal is SERV:BIST:TBAS:STAT? enabled or disabled. Keysight 8990B Programming Guide...
– 1 is returned when the check source is turned on – 0 is returned when the check source is turned off Query example Queries whether the reference check source is turned on SERV:CSOU? or off. Keysight 8990B Programming Guide...
– CS1_05G: Sets the frequency to 1.05 GHz. Example This command sets the reference check source SERV:CSOU:FREQ CS1K frequency to 1 kHz. Reset condition On reset, the reference check source frequency is set to 1 kHz. Keysight 8990B Programming Guide...
Page 514
SERVice Subsystem Query SERVice:CSOUrce:FREQuency? This query returns the current setting of the reference check source frequency. Query example Queries the reference check source frequency setting. SERV:CSOU:FREQ? Keysight 8990B Programming Guide...
Error –222,“Data out of range;Value clipped to minimum (#)” or –222,“Data out of range;Value clipped to maximum (#)” will occur. Reset condition On reset, the reference check source interval is set to 10 min. Keysight 8990B Programming Guide...
Page 516
SERVice Subsystem Query SERVice:CSOUrce:INTerval? This query returns the current setting of the reference check source interval. The response format is <NR1>. Query example Queries the reference check source interval setting. SERV:CSOU:INT? Keysight 8990B Programming Guide...
SERVice Subsystem SERVice:SECure:ERASe This command erases all data stored in the 8990B memory. Syntax :ERAS :SEC SERV Example This command erases the 8990B memory. SERV:SEC:ERAS Remark The memory erase operation will take a few minutes to complete. Keysight 8990B Programming Guide...
Page 518
SERVice Subsystem THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. Keysight 8990B Programming Guide...
Page 519
Overview SYSTem:COMMunicate:LAN:ADDRess <string> SYSTem:COMMunicate:LAN:DGATeway <string> SYSTem:COMMunicate:LAN:DHCPenabled SYSTem:COMMunicate:LAN:HNAMe? SYSTem:COMMunicate:LAN:MAC? SYSTem:COMMunicate:LAN:SMASk <string> SYSTem:COMMunicate:LAN:DNS <string>,<string> SYSTem:DATE <numeric_value>,<numeric_value>,<numeric_value> SYSTem:ERRor[:NEXT]? SYSTem:HELP:HEADers? SYSTem:LOCK <boolean> SYSTem:PRESet SYSTem:TIME <numeric_value>,<numeric_value>,<numeric_value> SYSTem:VERSion? This chapter explains how to use the SYSTem command subsystem to configure the system-related settings of the 8990B.
– Configuring the LAN settings – Setting the system date and time – Returning error numbers and messages from the 8990B – Presetting the 8990B to its default settings – Querying the SCPI commands available in the 8990B –...
SYSTem Subsystem SYSTem:COMMunicate:LAN:ADDRess <string> This command assigns a static IP address for the 8990B. Syntax string SYST :ADDR Space :COMM :LAN Parameter Item Description Range of values string Numeric character values for the address. Up to 15 characters, formatted as 0 to 255 (no embedded spaces) A.B.C.D where each A, B, C, and D = 0 to 255...
SYSTem Subsystem SYSTem:COMMunicate:LAN:DGATeway <string> This command assigns a default gateway address for the 8990B. Syntax string SYST :DGAT Space :COMM :LAN Parameter Item Description Range of values string Numeric character values for the address. Up to 15 characters, formatted as 0 to 255 (no embedded A.B.C.D where each A, B, C, and D = 0 to 255...
This command enables the Dynamic Host Configuration Protocol (DHCP) for the 8990B. When DHCP is enabled, the 8990B will try to obtain an IP address from a DHCP server. If a DHCP server is found, it will assign a dynamic IP address, subnet mask, and default gateway to the 8990B.
SYSTem Subsystem SYSTem:COMMunicate:LAN:HNAMe? This query returns the current setting of the 8990B LAN host name in the string format. Syntax :COMM :LAN :HNAM SYST Example Queries the host name setting. SYST:COMM:LAN:HNAM? Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:COMMunicate:LAN:MAC? This query returns the current setting of the 8990B LAN Media Access Control (MAC) address in the string format. Syntax SYST :COMM :LAN :MAC Example Queries the MAC address setting. SYST:COMM:LAN:MAC? Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:COMMunicate:LAN:SMASk <string> This command assigns a static subnet mask address for the 8990B. Syntax string SYST :SMAS Space :COMM :LAN Parameter Item Description Range of values string Numeric character values for the address. Up to 15 characters, formatted 0 to 255 (no embedded spaces) as A.B.C.D where each A, B, C, and D = 0 to 255...
1.1.1.1 and 2.2.2.2 respectively. Query SYSTem:COMMunicate:LAN:DNS? This query returns the IP addresses of the main and secondary DNS servers of the 8990B. Query example Queries the main and secondary DNS server IP SYST:COMM:LAN:DNS? addresses. Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:DATE <numeric_value>,<numeric_value>,<numeric_value> This command sets the date of the 8990B realtime clock in the year (yyyy), month (mm), and day (dd) format. Syntax Space :DATE numeric_value numeric_value numeric_value SYST Parameter Item Description/Defaul t numeric_value Sets the date as: –...
Page 530
– If the parameter contains suffix, error –138,“Suffix not allowed” will occur. Query SYSTem:DATE? This query returns the current setting of the system date. The response format is <NR1>. Query example Queries the current system date. SYST:DATE? Keysight 8990B Programming Guide...
This query returns the next error number and its corresponding error message from the error queue. When an error is generated by the 8990B, 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 sent.
Page 532
A character that was not a valid header separator was found in the command string – Program mnemonic too long A command header was received which contained more than the maximum 12 characters allowed Example: SYSTemCOMMunicateLANDGATeway “10.0.0.2” Keysight 8990B Programming Guide...
Page 533
Undefined header A command was received that is not valid for the 8990B. You may have misspelled the command, it may not be a valid command, or you may have selected the wrong interface. If you are using the short form of the command, remember that it may contain up to four letters.
Page 534
Invalid block data A block data element was expected but was invalid for some reason – Block data not allowed A legal block data element was encountered but not allowed by the 8990B at this point – Expression error Generic expression error –...
Page 535
The CCDF Gaussian trace is not enabled – Settings conflict;Requires CCDF reference trace to be enabled The CCDF reference trace is not enabled – Settings conflict;CCDF marker # source not set The source of CCDF marker A or B is not set Keysight 8990B Programming Guide...
Page 536
– Settings conflict;Unable to turn on Trigger on Event while ETS mode is on The 8990B is set to trigger on event when the ETS mode is enabled – Settings conflict;Trigger sweep must be in triggered mode while ETS is on. Trigger sweep is set to triggered...
Page 537
The command could not be executed due to a hardware problem – Hardware missing;Unable to turn on channel #;no sensor detected The 8990B is unable to execute the command because no sensor is connected to the respective channel Keysight 8990B Programming Guide...
Page 538
This is the generic device-dependent error for devices that cannot detect more specific errors. This code indicates that only a Device-Dependent Error as defined in the IEEE-488.2, 11.5.1.1.6 has occurred. – System error The 8990B operation has not completed properly, possibly due to an abnormal hardware or firmware condition – Memory error An error was detected in the 8990B memory –...
Page 539
No reference signal detected on the 10 MHz REF IN BNC input There is no reference signal at the 10 MHz REF IN BNC input System is busy, command unterminated The system is busy processing the command Keysight 8990B Programming Guide...
Page 540
Select another FDO table or delete some frequency points Detected channel 1 frequency changed. Power level is questionable. Please zero and cal channel 1. Detected channel 4 frequency changed. Power level is questionable. Please zero and cal channel 4. Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:HELP:HEADers? This query returns the SCPI commands available on the 8990B in the IEEE block format. Each command returned is separated by a new-line character (0x0A). At the end of each command before the new-line character, the following string characters may be present: –...
– 1 is returned when the front panel touch screen is enabled. – 0 is returned when the front panel touch screen is disabled. Query example Queries the status of the front panel touch screen. SYST:LOCK? Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:PRESet This command is used to preset the 8990B to its default settings. Syntax :PRES SYST Example This command presets the 8990B to the default settings. SYST:PRES Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:TIME <numeric_value>,<numeric_value>,<numeric_value> This command sets the 8990B 24-hour realtime clock in the hour (hh), minute (mm), and second (ss) format. Syntax Space :TIME numeric_value numeric_value numeric_value SYST Parameter Item Description/Defaul t numeric_value Sets the time as: – hh: An integer from 0 to 23 representing the hour –...
Page 545
– If the parameter contains suffix, error –138,“Suffix not allowed” will occur. Query SYSTem:TIME? This query returns the current setting of the system time. The response format is <NR1>. Query example Queries the current system time. SYST:TIME? Keysight 8990B Programming Guide...
SYSTem Subsystem SYSTem:VERSion? This query returns the version of SCPI used in the 8990B. The response is in the form of XXXX.Y, where XXXX is the year and Y is the version number. Syntax :VERS SYST Example Queries which version of SCPI is used in the 8990B.
Page 547
Keysight 8990B Peak Power Analyzer Programming Guide Programming Examples Example 1: Identifying the 8990B In Use Example 2: Making Pulse Characterization Measurement Example 3: Making Delay Measurement Example 4: Making Droop Measurement This chapter provides programming sequence examples to remotely control the...
8990B. Refer to “Error list” on page 532 for more information on the error messages. “–>” indicates the commands that you send to the 8990B. NOTE // Queries the instrument identification and checks whether -> *IDN? you are communicating with the right 8990B.
Example 2: Making Pulse Characterization Measurement The following command sequences provide the example to perform the pulse characterization measurement. “–>” indicates the commands that you send to the 8990B. NOTE This measurement example requires the following test setup: 8990B peak power analyzer...
Page 550
-> OUTP:MOD ON //Turns on the RF output power. -> OUTP ON 8990B configuration //Presets the 8990B to its default settings. -> SYST:PRES Waits until the completion of the current command and -> *OPC? then sends 1 to the output buffer.
Page 551
Queries the rise time measurement result for -> MEAS:RISE? CHAN1 channel 1. //Sets the slope to negative for the edge trigger. -> TRIG:EDGE:SLOP NEG Queries the fall time measurement result for -> MEAS:FALL? CHAN1 channel 1. Keysight 8990B Programming Guide...
Programming Examples Example 3: Making Delay Measurement The following command sequences provide the example to measure delay. “–>” indicates the commands that you send to the 8990B. NOTE This measurement example requires the following test setup: E4438C signal generator BNC cable...
Page 553
-> VOLT 1 //Turns on the RF output. -> OUTP ON 8990B configuration //Presets the 8990B to its default settings. -> SYST:PRES Waits until the completion of the current command and -> *OPC? then sends 1 to the output buffer.
Page 554
2. Sets the marker B source for delay measurement to -> MARK:DEL:BSOU CHAN1 channel 1. Wait 3 secs for operation to complete. Queries the X-axis delta value between the A and B -> MARK:XDEL? markers. Keysight 8990B Programming Guide...
Programming Examples Example 4: Making Droop Measurement The following command sequences provide the example to measure droop. “–>” indicates the commands that you send to the 8990B. NOTE This measurement example requires the following test setup: 8990B peak power analyzer...
Page 556
-> OUTP:MOD ON //Turns on the RF output power. -> OUTP ON 8990B configuration //Presets the 8990B to its default settings. -> SYST:PRES Waits until the completion of the current command and -> *OPC? then sends 1 to the output buffer.