Control tab (Source dialog)

Selecting Source > Control opens the Source dialog Control tab. The Source Control tab provides all the controls and parameters required for VSA integrated control and operation of an external source.

You must first select a Source Configuration to enable the Source Control tab controls and parameters.

Connect - Connects (or Disconnects) the Source Configuration.

Source Channel - Some of the parameters in the tab are channelized, meaning each channel may have a different assigned value. Selecting an individual Source Channel will populate channelized parameters in the tab with the assigned values for just that channel. Selecting All will populate channelized parametervalues when all of the component carriers have the same assigned value. If one or more component carriers have differing values, "multiple values" will appear in the parameter's field.

Channelized parameters will display a drop-down icon to the right of the parameter. The color of the icon indicates the following:

You can also use the drop-down menu to change the tab's selected Source Channel (or all channels), which functions the same way as Source Channel.

RF Frequency - Specifies the source carrier frequency for the selected Source Channel.

Frequency Step - Specifies the incremental frequency step size for the keyboard arrow keys and mouse wheel. This setting applies to all channels.

Amplitude - Specifies the source signal output power level for the selected Source Channel.

RF on - When selected (true), sets the source "RF Radio Frequency: A generic term for radio-based technologies, operating between the Low Frequency range (30k Hz) and the Extra High Frequency range (300 GHz). ON" parameter to ON, which turns on the source's RF output for the selected Source Channel.

Modulation on - When selected (true), sets the source "Modulation ON" parameter to ON, which applies modulation to the carrier signal for the selected Source Channel.

Download Waveform

Waveform Adjustment - Selects how the waveform will be adjusted when the waveform does not meet the source’s waveform length requirements. The available Waveform Adjustment choices depend on the model of source and its installed options.

Hover your mouse over the Waveform Adjustment drop-down box to see a pop up that displays the source length requirements, which includes the minimum waveform length and length quantum number.

Extend with Zeros - The ARB waveform is extended with zeros to meet the minimum waveform length (in points) and the waveform length quantum (length in points must be a multiple of the quantum) requirements. Note: this option does not ensure periodicity when the source is in Continuous playback.

VSA versions prior to VSA 2024 Update 2.0 used truncation to trim the waveform to meet the source's length quantum requirement (multiple of some number of samples). Truncation is no longer used because Extend with Zeros satisfies source requirements with no risk of data loss.

Ensure Periodicity - The ARB waveform is repeated, if necessary, to meet the minimum waveform length (in points) and the waveform length quantum (length in points must be a multiple of the quantum) requirements. This will ensure periodicity of the waveform in Continuous playback. For sources that support event/trigger out, there will be at least a trigger at the beginning of the repeated waveform, but not necessarily at each repetition. Note that for sources that don't support hardware-based repetition, this can increase the amount of data transferred to the source (affecting download speed and memory usage on the source).

Ensure Periodicity and Event Out - Same as Ensure Periodicity except that, for sources that support event/trigger out, there will be a trigger at each repetition of the waveform (if repetition needed).

Last Downloaded File - Displays the name of the last waveform file that was downloaded to the source. The Last Downloaded File field is updated whenever a new waveform file is downloaded to the source.

Download Current Recording - Opens the Select dialog that is used to configure and download the current VSA measurement recording for ARB Source playback. See See "Using Source Download and Recording".

Select dialog options:

At measurement span

Selected  - The recording data in the current measurement span is downloaded instead of the entire recording span.

Cleared  - The recording data is downloaded at the span when the recording was made.

Between playback start/stop times

Selected  - Downloads only the data between the playback start and stop times. See Specifying the Start/Stop region.

Playback "Start Time" and "Stop Time", see Playback Tab (Recording).

Cleared- Downloads the entire recording.

When the recording is downloaded into the source, the center frequency is specified by the RF Frequency parameter (Source > Control tab), not the current VSA measurement center.

Download File - Use Download File to select and download a VSA recorded signal file (VSA MATLAB ".mat" format) to an ARB Source for signal playback. See Source Signal Playback.

Each channel of a multi-channel waveform will be mapped to a different source channel if the mapping is 1:1. If a single-channel waveform is downloaded and multiple channels are enabled, the same waveform will be played on all enabled channels.

The order of the channels in the Channels tab is the same way channels will be ordered in the downloaded waveform.

Waveform Trigger parameters are used to control triggering of downloaded waveforms.

The VSA software always uses Continuous trigger mode with sources that support Continuous and Single trigger modes.

Trigger controls are not displayed in the GUI when VSA does not support triggering for the source, or the source does not have trigger capabilities. See the Source Requirements topic for sources that support triggering.

Trigger Type

Immediate – (Default) Waveform play starts as soon as a waveform is loaded and enabled.

Software– Waveform play starts when the Software Trigger button is clicked.

Global Trigger – Waveform play starts when the Global Trigger source trigger is asserted. Global Trigger starts repeatable, phase coherent waveform play. See the Source Requirements topic for sources that support Global Trigger.

Global Trigger Type

Immediate – (Default) Phase coherent waveform playback starts as soon as a waveform is loaded and enabled.

Software – Phase coherent waveform play starts when the Software Trigger button is clicked.

Trigger Action – Selects the action that is initiated by the trigger.

Run – Waveform play starts when trigger is received. Subsequent triggers are ignored.

Reset and Run – Waveform play starts when trigger is received. Subsequent trigger while waveform is playing will reset play to the start of the waveform. This mode is not supported for GlobalTrigger trigger type.

Software Trigger – Initiates a software trigger when the Trigger Type is set to Software.

Using Source Download and Recording

Using "Current" and "From File"

There are two Download Recording options: Download Current Recording and Download File:

Max Download File Size: The data block size to be downloaded to a source must be < 250 Mpts.

You will receive an ERROR message when the download a recording data size exceeds the source maximum memory size, see Reducing Download Recording Size.

Using "Download File..."

The Download File... option is used to browse, recall, and load a saved signal recording file for download and playback. This option allows you to save a measurement signal recording and recall it at a later time for detailed signal analysis. This feature also allows you to share a common signal recording file with multiple co-workers running the VSA software.

Using "Download Current Recording"

The Download Current Recording option opens the Select dialog and is used to configure and download the current VSA measurement signal recording for playback. You do not need to download the entire signal recording for playback. For example, you may only want to do further signal analysis on a specific region (time interval) of the measurement recording.

Specifying the Start/Stop region

There are two methods for defining the recording download region (time interval) within the current measurement recording:

  1. You can use the Recording Playback "Start Time" and "Stop Time" parameters to specify the recording download playback region.
  2. You can open and use the recording Player (Window &gt; Player) to specify the download playback region. The graphical user interface makes it easy to visually identify the playback region of interest within the measurement recording.

Reducing Download Recording File Size

When you are downloading using the Download Current Recording option, zooming in on a subset of the recording span and selecting “At measurement span” will reduce both the sample rate and the amount of data downloaded (by the ratio of the current measurement span to the span of the recording). Selecting “Between playback start/stop times” will reduce the amount of data downloaded but will not affect the sample rate.

 

See Also

Source Menu

Source Channels tab

Connecting to a Source

Using Source Signal Playback

Using MATLAB Simulated Signals

Source Overview