VSA_89600_Source

Description: Agilent 89600 Vector Signal Analyzer
Library: Instruments
Class: TSDFVSA_89600_Source
Derived From: VSA_89600_1_Source

Parameters

Name	Description	Default	Unit	Type	Range
VSATitle	Text for VSA title bar	Simulation source		string
ControlSimulation	Control simulation: NO, YES	NO		enum
OutputType	Output port type: Timed, Frequency, Demod Errors, Complex Scalar, Float Scalar, Integer Scalar	Timed		enum
Pause	Pause for VSA setup: NO, YES	YES		enum
VSATrace	VSA trace that will supply data: A, B, C, D	A		enum
RepeatData	VSA hardware measurement control: Repeat, Reacquire, Single pass	Repeat		enum
TStep	Simulation time step	0	sec	real
SetupFile	Name of setup file to recall into VSA			filename
RecordingFile	Name of recording file to recall into VSA			filename
SetupUse	VSA setup file recall control: Always, Once, No	Always		enum
AutoCapture	Capture VSA input data at start-up: NO, YES	NO		enum
DefaultHardware	Use VSA default hardware configuration: NO, YES	NO		enum
FrequencySpan	If non-zero, set the frequency span.: Unchanged	Unchanged	Hz	real enum	[0, ∞)
SetCenterFrequency	Controls the CenterFrequency parameter.: NO, YES	NO		enum
CenterFrequency	If the parameter SetCenterFrequency is set to YES, set the center frequency.	0	Hz	real	(-∞, ∞)
Range	If non-zero and RecordingFile not set, set the range.: Unchanged	Unchanged	V	real enum	[0, ∞)
RecordingLength	If non-zero and RecordingFile not set, this parameter set the recording length.: Unchanged	Unchanged	sec	real enum	[0, ∞)

Pin Outputs

Pin	Name	Description	Signal Type
1	out	Measurement data	anytype
2	gap	VSA input data gap signal	int

Notes/Equations

Note This component is for use on Win32 platforms only.

1. The VSA_89600 models provide a dynamic link to integrate the 89600 series VSA software with ADS.
   Before using this model, the VSA_89600 software must be installed. The VSA 89600 software can be downloaded from http://www.agilent.com/find/89600.
   For 89600 analyzer reference information, example measurements, or a getting started video, access Help or choose Start > Programs > Agilent 89600 VSA > Help.
2. The VSA_89600_Source model transfers measurement data from the 89600 Vector Signal Analyzer. The model outputs different amounts and types of data depending on OutputType, as described in note 5. Measurements can be acquired from any 89600 trace and are transferred in raw (unformatted) state.
3. The VSATitle parameter sets the title in the 89600 window title bar.
4. The ControlSimulation parameter determines how the model acts inside the simulation. When ControlSimulation = YES, the model keeps the simulation running during the first pass through the data. If your sinks are set to not control the simulation, these automatically collect all data from the model. When ControlSimulation = NO, the model produces data ad infinitum. You must set your sink to control the simulation, then set the Start and Stop parameters to appropriate values.
5. The OutputType parameter establishes the configuration of the model's output data port.

   Important The data type of the 89600 trace selected by VSATrace (note 7) must be compatible with the output type.

   Timed - Timed data is output at the 89600 center frequency and timestep (refer to TStep in note 9). The data can be complex or baseband, depending on the 89600 zoom state. Requires time domain measurements from the 89600. Example 89600 trace data type: Main Time.
   Frequency - Spectrum data is output as pairs of complex numbers. The first number is the real frequency (the imaginary part is zero), and the second number is the complex voltage at that frequency. You can connect a Distributor2 to the VSA_89600_Source data port to separate the signal. Requires frequency domain measurements from the 89600. Example 89600 trace data type: Spectrum.
   Demod Errors - Demodulation error data is output as sets of floating-point (real) values. The number of values and required 89600 configuration vary with demod type. See note 21.
   Complex Scalar - Complex numbers are output. If the 89600 measurement data is real-valued, the imaginary part of the output values is zero. Example 89600 trace data type: "Error Vector Time" in Digital Demod mode.
   Float Scalar - Floating point numbers are output. Requires real-valued 89600 measurement data. Example 89600 trace data type: "IQ Mag Error" in Digital Demod mode.
   Integer Scalar - Integer numbers are output. Requires real-valued 89600 measurement data. Useful for sourcing demodulation symbols when the 89600 trace data type is Syms/Errs.
6. The Pause parameter controls the 89600 start-up sequence. When Pause is set to YES, the simulation displays a message dialog and pause before acquiring measurement data from the 89600. Then you can configure the 89600 before pressing the OK button to proceed.
7. The VSATrace parameter specifies which 89600 trace provides measurement data.
8. The RepeatData parameter controls the transfer of data from the 89600 during hardware-based measurement. When RepeatData = Single pass, the model supplies data from a single measurement. The Repeat option acquires a single measurement and repetitively sources it into the simulation. Reacquire repeatedly acquires and sources new measurements. Note that in the Repeat and Reacquire modes time-based data is not continuous across measurements.
   When 89600 input is from a recording the RepeatData setting is ignored. Refer to note 20 for information on operation with recordings.
9. The TStep parameter can be used to specify a target timestep when sourcing timed data. The model trys to adjust the 89600's span to achieve the requested step size. If the 89600 cannot be set to the required span, a warning message is output to the status window.
10. The SetupFile parameter can be used to recall automatically a VSA setup file during simulation start-up. The VSA measurement setup file, SetupFile, is saved from the VSA application file menu, File > Save > Save Setup. To avoid the need to supply an absolute file name on the schematic, save the setup file in the project data directory. Note that the VSA does not default to saving in this directory the first time. To refine an existing SetupFile, you can modify the VSA application while simulating and then save the setup file before restarting the simulation. If Pause is set to YES, the setup file is loaded before the Pause dialog is displayed.
11. The RecordingFile parameter can be used to recall automatically a recording into the 89600 during simulation start-up. If Pause is set to YES, the recording file is loaded before the Pause dialog is displayed.
12. The SetupUse parameter specifies when an 89600 setup file (specified in the SetupFile parameter) is recalled. Options are:
    Always - Recall setup file on every simulation run.
    Once - Recall setup file only when 89600 is started.
    No - Do not recall setup file.
13. The AutoCapture parameter can be set to YES to have the 89600 automatically initiate a capture recording of hardware input data at the beginning of a simulation. When the capture is complete, the model begins sourcing the recorded data. Time-based measurements is continuous (note 20). Recording length can be controlled via an 89600 setup file.
14. The DefaultHardware parameter can be set to YES to have the 89600 automatically select an appropriate hardware configuration. Otherwise, the 89600 uses previous hardware settings. Note that when a source 89600 reuses the same running 89600 instance that was used by a sink 89600 (VSA_89600_1_Sink, VSA_89600_2_Sink, or VSA_89600_Sink), it can be left set up with Stream input hardware. This problem can be solved via the RestoreHW parameter of the sink component.
15. Each 89600 measurement produces a block of data points, which are pipelined to the simulation. As a result, simulation plots typically lag 89600 traces. The number of points in a block varies with 89600 measurement type and configuration. For reference, the block size is output to the status window during startup. This value can be useful when configuring other components (for example, plot persistence and update size). Also, any change in block size during simulation is logged in the status window.
16. The units associated with transferred 89600 data are output to the status window during startup. Unless otherwise indicated, values are peak units.
17. To avoid transfer of overlapped measurement data, the 89600's maximum overlap for averaging off is set to zero when a simulation starts.
18. If the model detects a change to one of the following 89600 settings while sourcing data, the model disconnects from the 89600.
    • Input data source
    • Demodulator configuration
    • Data type of the trace supplying measurements (VSATrace)
    • Sweep mode
    • Center frequency (for timed output)
    • Timestep size (for timed output)
      The recommended practice is to use the Pause and/or SetupFile options to preconfigure the 89600.
19. When a simulation that contains an active VSA_89600_Source component starts, it attaches to a running 89600 whose title begins with the component's instance name. If no such 89600 instance is found, a new 89600 is created, and its title is set to the associated component's instance name and VSATitle text.
20. When 89600 input is from a recording the model steps through the recording, transferring all measurements. 89600 recording playback properties can be used to control start/stop points and looping. In this mode time-based data are continuous, with the exception of wrapped values when a playback loop occurs.
21. Demodulation Error/Summary information is available by configuring the trace data. For details on results available, refer to the 89600 help index topic symbol table and look for the demodulation format of interest. The demod formats available depend on 89600 licensing (For example, Digital Demod requires option AYA, and cdma2000 requires option B7.)
    The error summary data and the numbering for each demodulation format are documented in tables in the 89600 help documentation (look in the index under demod errors and ADS). Note that some demodulation formats include several of these tables. The table values are output in a fixed sequence, which can be different from the order seen on the 89600 display. The number of output error values depends on the configuration.
    The easiest way to get an individual error value is to place a DownSample component in series with the VSA89600Source output. For example, consider the list of Digital Demod error items. The DownSample Factor parameter would be set to the number of error values (21). To select EVM, the Phase parameter would be set to 20 (EVM position in the list subtracted from 21).

    Note When OutputType is Integer Scalar and trace data is configured to one of the above types (Syms/Errs, for example), the module sources demodulation symbols.

22. The gap output port emits a 1 when there is a discontinuity in 89600 input data. Otherwise it emits 0. A TkBreak component with Condition parameter set to "$input(1) > 0" can be used to trigger control actions based on this signal. The data rate of the gap port is the same as that of the out port.
23. Some uncommon simulation errors can orphan the hpeesofsim.exe process when an 89600 is active. If this occurs, additional simulation runs start a new hpeesofsim process and other errors can result. If you encounter such a problem, select the ADS Simulate > Stop and Release Simulator command, then use the Windows Task Manager's End Process command to end any remaining hpeesofsim processes.
24. Multiple VSA_89600_Source components can be active in a simulation.
25. When both VSA_89600_Source and VSA_89600_Sink components are present in a design, configuring the VSA_89600_Sink for 0% time record overlap minimizes the effect of gaps in source data.
26. The VSA_89600_Source component can be used with a PSA E444xA/89601A combination. The VSA89600 software runs on a PC connected to the E444xA, via LAN or GPIB, and provides hardware control, modulation analysis, and complete results displays. The controls and display of the E4406A are disabled while operating with the 89601A software.
    For more information, refer to the Agilent PSA website http://www.agilent.com/find/psa.
    Special options required for use of the Performance Spectrum Analyzers E444xA and the VSA89600 software are described in these product notes:
    • Product Note 5988-5015EN; available at the website http://cp.literature.agilent.com/litweb/pdf/5988-5015EN.pdf.
    • Product Note 5988-4094EN; available at the website http://cp.literature.agilent.com/litweb/pdf/5988-4094EN.pdf.
27. The VSA_89600_Source component can be used with a VSA E4406A/89601A combination. The VSA89600 software runs on a PC connected to the E4406A, via LAN or GPIB, and provides hardware control, modulation analysis, and complete results displays. The controls and display of the E4406A are disabled while operating with the 89601A software.
    For more information, refer to the Agilent VSA E4406A website http://www.agilent.com/find/vsa.
    Special options required for use of the Vector Signal Analyzer E4406A and the VSA89600 software are described in Product Note 5988-2906EN, which is available at the website http://cp.literature.agilent.com/litweb/pdf/5988-2906EN.pdf.
28. The VSA_89600_Source component can be used with an ESA/89601A combination. The VSA89600 software runs on a PC connected to the ESA, via GPIB, and provides hardware control, modulation analysis, and complete results displays. The controls and display of the ESA are disabled while operating with the 89601A software.
    For more information, refer to the Agilent ESA website http://www.agilent.com/find/esa.
    Special options required for use of the ESA and the VSA89600 software are described in Product Note 5988-4097EN, which is available at the website http://cp.literature.agilent.com/litweb/pdf/5988-4097EN.pdf.
29. The VSA_89600_Source component can be used with an Infiniium oscilloscope/89601A combination. The VSA89600 software runs on a PC connected to the Infiniium scope, via LAN or GPIB, and provides hardware control, modulation analysis, and complete results displays. The controls and display of the scope are disabled while operating with the 89601A software.
    Special options required for use of the Infiniium scope and the VSA89600 software are described in this product note:
    http://cp.literature.agilent.com/litweb/pdf/5988-4096EN.pdf.
30. The VSA_89600_Source component does not handle averaged measurements as a special case; each 89600 analyzer trace update is output to the simulation. The default 89600 analyzer average setup has Fast Average disabled, so the traces are updated each time new measurement results are added to the average, starting with the first measurement.
    To force only the final, fully averaged result to be output to the simulation, select MeasSetup > Average on the 89600 analyzer and check both the Fast Average and the Same as Count check boxes. This prevents the analyzer from updating the screen until the selected number of measurements have been averaged together.
31. To access example designs that use this model, from the ADS Main window, choose File > Example Project > Instruments > VSA89600_demos_prj.