Real Time

Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description Go to description

Envelope Tracking Control

The Envelope Tracking Control window (shown below) is accessed from the software's Tools menu. Click the image for descriptions of the various functions.

File

Open Settings

Opens an envelope tracking saved settings (.ets) file. Opening an .ets file configures the envelope tracking parameters for use with the currently selected hardware.

Save Settings

Saves the envelope tracking system parameter settings to an *.ets file. Settings files do not include the hardware configuration information, such as LAN or GPIB settings for specific instruments listed in the Hardware node.

The *.ets file stores only the envelope signal generator’s address and configuration. The RF signal generator address and hardware configuration information will not be stored. Settings stored in the *.ets file are also saved in the *.scp/.scpx. files. Neither *.ets or *.scp/.scpx stores RF signal generator settings. You can save all settings, including RF signal generator settings in Quick Setup.

Export Envelope Data

Exports the envelope data to a .csv file type.

Close

Closes the Envelope Tracking Control window and returns you to the Signal Studio window.

Control

Generate

Generates a combined envelope and I/Q waveform. The orange background color of this button indicates that the waveform needs to be generated to include any changes you made to waveform parameters. Once the waveform is generated (or regenerated), the button will return to the normal gray background color.

Download

Generates and downloads I/Q waveform and envelope data to the I/Q signal and waveform generators. If the IQ waveform was previously generated, only the envelope data is updated. When generating and updating, output states are turned off for both the RF and the envelope signal generators. After downloading, the On the Fly indicator (connected) turns on. The orange background color of this button indicates that the most recently generated waveform has not yet been downloaded to the instruments. Once the waveform is downloaded, the button will return to the normal gray background color.

Regenerate and Download

Regenerates and downloads I/Q waveform and envelope data to the I/Q signal and waveform generators, even if the IQ waveform was previously generated and downloaded. This is useful in cases where signal generator settings were manually changed on the instrument's front panel, as it forces the connected signal generator to synchronize with the software's current settings.

Trigger to the Envelope SG

This button only appears when the RF signal generator is set as the timing master. It sends an ABORT command to the arbitrary waveform generator (AWG), resetting the trigger state. This allows the AWG to receive the trigger and resynchronize with the RF signal generator.

System

Check Connection

Verifies the connection with the arbitrary waveform generator (AWG).

System Configuration...

This opens the ClosedSystem Configuration window. Clicking one of the two available configurations, followed by OK, determines which source is the timing master, supplying the trigger and 10 MHz reference. The diagram also shows the BNC cable connections for each configuration. The selected timing master configuration appears on the right side of the status bar, located at the bottom of the Envelope Tracking Control window.

Log

Clear Log

Clears the message log in the lower left corner of the Envelope Tracking Control window.

Message Log

This area displays messages during generate and download process.

Parameter and Graph View

This area displays parameters (many are configurable) or graphs, depending on which block of the Envelope Control window is active.

On-the-Fly

Indicates that the On-the-Fly feature is active, enabling real-time parameter updating. If a parameter value is changed, the instrument immediately updates. This feature becomes active after the waveform is generated and downloaded to the instrument. Only then can the state be toggled between Idle and Connected.

Indicates that the On-the-Fly feature is inactive. Click to test the connection and to make the feature active.

The On-the-Fly feature does not synchronize the instruments. To fully synchronize the instruments, click the Generate and Download button.

Shaping Table Manager

Clicking the ClosedShaping Table Manager block enables you to create and edit shaping tables for the current power amplifier.

Toolbar

Buttons Description
Opens opens a envelope tracking (.csv) file.
Saves the parameters configured in the Envelope Tracking software to a .csv file.
Adds a new table row to the current Envelope Adjust. If "On the fly" is active, the results can be seen in the CCDF graph.
Deletes the currently selected table or formula.

Name

Click to change a Table or a Formula name.

Type

Indicates Table or Formula for the envelope tracking values.

Comment

Optional entry for the Table or Formula description.

RF Voltage

Click to change the value in dB input into the PA.

The units on each column are linear voltage. RF Voltage is the I/Q signal (input) and EV Voltage is the envelope signal (output). If the RF voltage value is out of the table range, the nearest table edge value is used for the converted value.

EV Voltage

Click to change the value in dB output from the PA.

RF Voltage is the I/Q signal (input) and EV Voltage is the envelope signal (output).

CCDF Graph

The CCDF graph contains the PA's input vs. output power values.

|X| and Transformation

The Closed|X| and Transformation block enables you to configure and generate the envelope based on the I/Q waveform.

The envelope value of each waveform point is calculated as:

Then oversampling is applied, according to the over sample ratio you select.

Click to generate the envelope data after you have set the envelope generation parameters.

Envelope Generation

Envelope Tracking Source

Selects the envelope's data source. This parameter is set automatically by the software to either I/Q Waveform or to Constant Value.

When this parameter is set to Constant Value, the envelope tracking is off and the PA is in normal operation using a constant DC bias voltage. This setting can be used for comparison purposes by manually turning off Envelope Adjust.

Oversampling ratio for the Envelope Data

Range: 1 to 32

Default: 3

Enter an integer value to set the oversampling ratio for the envelope data.

Envelope Adjust

Choice: On | Off

Default: On

Enables envelope adjust. If Off, then no adjustment is applied to the envelope waveform.

Conversion Input Type

Choice: Absolute RF Output Voltage | Normalized RF Output Voltage

Default: Absolute RF Output Voltage

Absolute RF Output Voltage

Use RF output voltage value as conversion table x-axis value. If RF output amplitude is changed, converted data may be changed.

Normalized RF Output Voltage

Use normalized power value of IQ waveform data as conversation table x-axis value. Value range is 0 – 1, so that the 0 – 1 range of x-axis are always used for the conversion. RF output amplitude does not affect the conversion.

Override Absolute RF Output Voltage

Apply fixed value (not linked to RF output voltage). The fixed value is set in the Power for transformation input parameter, which appears after you make this selection.

Power for transformation input

Range: –130 dBm to 40 dBm

Default: 10 dBm

This value is used for the rms power level of RF signal for transformation input instead of RF output voltage from RF signal generator amplitude. This parameter appears only when the Conversion Input Type is set to Override Absolute RF Output Voltage.

Pre Conversion Filter

Range: 1 MHz to 200 MHz

Default: 200 MHz

This filter is applied before conversion begins.

The filter cut off range is calculated by:

minimum sampling clock/100

maximum sampling clock/2

If the filter cut off frequency is out of range, the filter is not applied.

Graph

The envelope graph displays the first 100 points of the waveform. Increase the oversampling ratio for the envelope as needed to improve the quality of the envelope.

Envelope Signal Generator

The ClosedEnvelope Signal Generator block controls the arbitrary waveform generator (33521/22A or 33521/22B). With the On-The-Fly feature activated, changes to parameter values are immediately transmitted to the RF Signal Generator.

Send Parameters

This button sends the Envelope Signal Generator configuration parameters to the arbitrary waveform generator.

Check Connection

Verifies the connection with the arbitrary waveform generator (AWG).

Address

Enables connectivity through GPIB, LAN, or USB input connector to trigger an ET waveform. Select the connection type from the drop-down menu, then enter the appropriate address in the adjacent fields.

Arbitrary Waveform Generator

For all the parameters described in this section, you can also refer to the Keysight 33500 Series Operating and Service Guide.

Sampling Clock

Range: 1 μSa/s to 250 MSa/s

Default: 40 kSa/s

Sets the sample rate for the arbitrary waveform.

This parameter is coupled to the arbitrary waveform filter command. When the arbitrary waveform filter is set to OFF, then the sampling clock is limited to 62.5 MSa/s. FUNCtion:ARBitrary:FILTer is OFF.

Example of setting the sample rate to 10 kSa/s:

FUNC:ARB:SRAT 1e4

Example of Typical Return:

+1.000000000000000E+04

33521/22B:

[SOURce[1|2]:]FUNCtion:ARBitrary:SRATe <sample_rate>|MINimum|MAXimum

[SOURce[1|2]:]FUNCtion:ARBitrary:SRATe? MINimum|MAXimum

Arb Filename

Choices: See MMEMory:LOAD:DATA[1|2], for valid <filename> formats.

Selects an arbitrary waveform (.arb/.barb) or sequence (.seq) that has previously been loaded into volatile memory for the channel specified with MMEMory:LOAD:DATA[1|2] or DATA:ARBitrary. Several waveforms can be in volatile memory simultaneously.

Example of setting an arbitrary waveform in memory on channel 2 :

FUNC:ARB "INT:\MyArb103.arb"

Example of a typical return:

"INT:\MyArb103.arb"

Example of loading an arbitrary waveform from the internal drive into volatile memory. Then select and play the waveform.

:MMEM:LOAD:DATA "INT:\BUILTIN\Sinc.arb"

:FUNCtion:ARBitrary "INT:\BUILTIN\Sinc.arb"

:FUNCtion ARB

33521/22B:

[SOURce[1|2]:]FUNCtion:ARBitrary <filename>

[SOURce[1|2]:]FUNCtion:ARBitrary?

Trigger Delay

Range: 0 to 1000 s (resolution of 4 ns)

Default: 0

Sets trigger delay, (time from assertion of trigger to occurrence of triggered event).

Example of setting channel 1 trigger delay to 105 ms:

TRIG:DEL 105e-3

Example of Typical Return:

+1.050000000000000E-01

33521/22A and 33521/22B:

TRIGger[1|2]:DELay <seconds|MINimum|MAXimum>

TRIGger[1|2]:DELay?

Trigger Slope

Choices: Positive | Negative

Default: Positive (rising edge)

Specifies polarity of trigger signal on rear-panel Trig In connector for any externally-triggered mode.

Example setting trigger slope to falling edge:

:TRIG:SLOP NEG

33521/22A and 33521/22B:

TRIGger[1|2]:SLOPe POSitive|NEGative

TRIGger[1|2]:SLOPe?

Output Voltage

Range: 1 mVpp to 10 Vpp into 50 Ω

Default: 100 mVpp

Sets output amplitude.

Typical Return:

+5.0000000000000E+00

Set output amplitude to 5 Vpp:

VOLT 5 Vpp

Use VOLTage:UNIT to specify output units for all subsequent commands.

You cannot specify output amplitude in dBm if output termination is set to high impedance. The units are automatically converted to Vpp.

[SOURce[1|2]:]VOLTage {<amplitude>|MINimum|MAXimum}

[SOURce[1|2]:]VOLTage? [{MINimum|MAXimum}]

Output Voltage Offset

Range: ± 5 VDC into 50 Ω

Default: 0

Sets DC offset voltage.

Typical Return

+1.0000000000000E-01

Set offset voltage to 100 mV:

VOLT:OFFS 100 mV

[SOURce[1|2]:]VOLTage:OFFSet {<offset>|MINimum|MAXimum}

[SOURce[1|2]:]VOLTage:OFFSet? [{MINimum|MAXimum}]

Output Voltage High Limit

Same description as Output Voltage Low Limit (see below)

Output Voltage Low Limit

Range: ±5 VDC into 50 Ω, as long as HIGH is at least 1 mV greater than LOW.

Defaults: HIGH +50 mV, LOW -50 mV

Sets the high and low limits for output voltage.

Example of setting voltage limit high to 5.0V:

VOLT:LIMIT:HIGH 5.0

Example of Typical Return:

+5.0000000000000E+00

33521/22A and 33521/22B:

[SOURce[1|2]:]VOLTage:LIMit:HIGH <voltage>|MAXimum|MINimum

[SOURce[1|2]:]VOLTage:LIMit:HIGH? MAXimum|MINimum

[SOURce[1|2]:]VOLTage:LIMit:LOW <voltage>|MAXimum|MINimum

[SOURce[1|2]:]VOLTage:LIMit:LOW?

Output Voltage Limit State

Choices: On | Off

Default: Off

Enables or disables output amplitude voltage limits.

Example of setting and enabling ±2.5 V output limits on channel 1:

VOLT:LIM:HIGH 2.5

VOLT:LIM:LOW -2.5

VOLT:LIM:STAT ON

Example of typical return:

0 (OFF) or 1 (ON)

33521/22A and 33521/22B:

[SOURce[1|2]:]VOLTage:LIMit:STATe ON|1|OFF|0

[SOURce[1|2]:]VOLTage:LIMit:STATe?

Output Load

Choices: 50 | INF

Default: 50

Sets expected output termination. Should equal the load impedance attached to the output.

The specified value is used for amplitude, offset, and high/low level settings.

Output State

Choices: On | Off

Default: Off or On

Enables or disables the front-panel output connector.

Example of typical return for an enabled output connector for channel 1:

OUTP ON

33521/22A and 33521/22B:

OUTPut[1|2] ON|1|OFF|0

OUTPut[1|2]?

Dual Operation State (33522A and 33522B only)

Choices: On | Off | Inverted

Causes channels 1 and 2 of a two-channel instrument to output the same signal, or an inverted polarity signal.

This parameter is hidden, if the target waveform signal generator is a single channel model.

Example of typical return:

ON, OFF, or INV

Example of setting channel 2 output signal identical to so that of channel 1:

TRACk ON

33521/22A and 33521/22B:

[SOURce[1|2]:]TRACk ON|OFF|INVerted

I/Q Waveform

The ClosedI/Q Waveform block is read-only, so parameters are not editable here. If you need to change some of the I/Q waveform parameters, close the Envelope Tracking Control window and make the changes in the main software window.

Generate

Generates a combined envelope and I/Q waveform. This performs the same function as the Generate button on the ET control window's tool bar.

I/Q Waveform

These parameters are not editable within the Envelope Tracking Control window. To edit the I/Q Waveform block's parameters, close out the Envelope Tracking Control window and click on the node in the tree view that contains the parameter you'd like to edit. Otherwise, the current parameter settings are retained.

Waveform Name

Sets the Waveform filename. This parameter is not editable within the Envelope Tracking software.To edit this parameter, close the Envelope Tracking Control window and make any edits in the Signal Studio software.

The Waveform Name parameter is editable in the Waveform Setup node.

Waveform Length

Sets the Waveform Length. This parameter is not editable within the Envelope Tracking software.To edit this parameter, close the Envelope Tracking Control window and make any edits in the Signal Studio software.

The Waveform Length value is not directly editable. To edit the Waveform Length (Total Sample Points), click on the Oversampling Ratio parameter. The Waveform Length (Total Sample Points) is automatically determined based on the oversampling ratio. Using a larger oversampling ratio results in a more completely filtered image, but also uses more waveform memory by increasing the number of waveform points. Refer to the Carrier n node, for your 3GPP release version of carrier.

Waveform Sampling Rate

Sets the Waveform Sampling Rate. This parameter is not editable within the Envelope Tracking software.To edit this parameter, close the Envelope Tracking Control window and make any edits in the Signal Studio software.

Waveform Sampling Rate is a sampling rate without Oversampling Ratio (OSR) which is set by the Carrier n node's Base Sampling Rate parameter. Refer to the Carrier n node's Base Sampling Rate parameter for a more complete description.

I/Q LUT

The ClosedI/Q LUT block provides quick and convenient access to digital pre-distortion (DPD) control and lookup table (LUT).

RF Signal Generator

The ClosedRF Signal Generator block is editable and represents the Signal Studio's instrument node.For the list of parameters and descriptions, refer to the instrument node.

DUT

The ClosedDUT block allows you to set envelope timing alignment and map envelope voltage levels into the DUT. All parameter adjustments happen in real time while the On-The-Fly feature is enabled.

Envelope - RF

Timing Alignment

Adjusts the timing between RF signal generator and Envelope signal generator.

This parameter will distribute to Trigger delay (RF Signal Generator) and IQ_DELAY (RF Signal Generator).

SYNC signal of Envelope SG is source of trigger for the RF signal generator.

Delay value = trigger delay (RF SG) + IQ_DELAY (RF SG).

For Negative delay value, add one waveform length timing to the delay value.

Step

This step number used for increment/decrement the timing adjusts value by using mouse wheel or up/down control. Step can be changed.

Envelope Voltage Mapping

This section describes individual parameters. For more information, see ETPS Input Voltage Mapping.

Transformed High

This is the high voltage value of the shaping table and will be converted to the Mapped High value.

Transformed Low

This is the low voltage value of the shaping table and will be converted to the Mapped Low value.

Ref

Check this box to override the automatic calculated reference level with the current value, which you can edit. This value is the swing center of the envelope and and Vcm point (with offset). If the box is not checked, the transformed reference value is calculated as follows:

Transformed High – Transformed Low)/2

Mapped High

This is the high peak-voltage value (positive swing) of the envelope waveform data input to the envelope tracking power supply (ETPS), converted from the Transformed High value.

Mapped Low

This is the low peak-voltage value (negative swing) of the envelope waveform data input to the envelope tracking power supply (ETPS), converted from the Transformed Low value.

Vpp

This read-only field shows the peak-to-peak mapped voltage value, calculated as follows:

Vpp = Mapped High voltage – Mapped Low voltage

Vcm

This is the common-mode voltage and is mapped to the center of the envelope waveform swing (peak-to-peak amplitude). This value also includes any offset value applied.

RF Signal Generator

RF SG Output

Check this box to turn on the RF signal generator output.

RF Amplitude

Sets the RF power of the RF signal generator.

Transformation Input Type

Absolute RF Output

Use RF output voltage value as conversion table x-axis value. If RF output amplitude is changed, converted data may be changed.

Normalized RF Output

Use normalized power value of IQ waveform data as conversation table x-axis value. Value range is 0 – 1, so that the 0 – 1 range of x-axis are always used for the conversion. RF output amplitude does not affect the conversion.

Override Absolute RF

Apply fixed value (not linked to RF output voltage). Enter the fixed value in the field directly below this button.

Envelope Signal Generator

Envelope SG Output

Check this box to turn on the envelope signal generator output.

Override

Check this box to override the envelope signal generator output voltage and offset. If overridden, the amplitude and offset values are not automatically calculated from mapped Vpp and Vcm.

Amplitude

See Output Voltage.

Offset

See Output Voltage Offset.

ETPS Gain Adjust

Adjusts the output voltage in dB.

For example, if set to –6 dB, the output voltage will be one half.