VSA_89600_Sink

Description: Agilent 89600 Vector Signal Analyzer
Library: Instruments
Class: TSDFVSA_89600_Sink

Parameters

Name	Description	Default	Unit	Type
VSATitle	Text for VSA title bar	Simulation output		string
TStep	Simulation time step; use a value of 0 for time step synchronization with other network timed signals	0	sec	real
SamplesPerSymbol	Digital demodulation samples per symbol; NOT to be confused with VSA points per symbol	0.0		real
SetupFile	Name of measurement setup file to recall			filename
RestoreHW	YES to restore VSA hardware selection at end of simulation; NO to not: NO, YES	NO		enum
Start	Sample number to start measuring	DefaultNumericStart		int
Stop	Sample number to stop measuring	DefaultNumericStop		int
TclTkMode	YES enables Tcl/Tk mode (continuous simulation); NO disables: NO, YES	NO		enum
RecordMode	YES enables VSA 89600 Recording mode; NO disables; Stop must be > Start, TclTkMode = NO: NO, YES	NO		enum
SetFreqProp	Set VSA 89600 frequency properties (center, span, zoom): NO, YES	YES		enum

Pin Inputs

Pin	Name	Description	Signal Type
1	input		multiple anytype

Notes/Equations

Note This item 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_Sink models provide a stream interface where you can input digitized waveforms directly from ADS to 89600-series VSA software without using the 89600-series hardware. The full functionality of the 89600 analyzer is available to analyze and display the ADS signal.
3. For continuous measurements, set Stop to −1, TclTKMode to YES, and RecordMode to NO. (For continuous measurements, the components VSA_89600_1_Sink and VSA_89600_2_Sink are configured correctly and can be easier to use.)
4. An input can be float (real), complex, or timed; timed can be BaseBand or ComplexEnv.
5. The default TimeStep is 1 second unless the TStep parameter is set >0. If TimeStep is available from the input, TimeStep is used instead. Then, this is used to set the sample rate of the VSA analyzer to 1/TimeStep. This places an upper limit on the analyzer frequency span.
6. The analyzer can be configured to create complex data from two float (real) inputs with a VSA_89600_2_Sink component by bringing the analyzer up first and configuring it in the I+jQ mode (Input > Channels > I+jQ). The simulation then leaves this mode undisturbed.
7. The analyzer re-zooms data when its measurement center frequency is set different from that of the simulation. Also, the frequency span can be reduced in the same way. Refer to note 19.
8. When the analyzer is in a demodulation mode at the beginning of a simulation and has two float (real) inputs, the analyzer is set to I+jQ mode.
9. The SamplesPerSymbol parameter provides a convenient way to set the analyzer's Symbol Rate. This is different from the analyzer's Points/Symbol parameter, which adjusts the analyzer's interpolation of demodulated data. SamplesPerSymbol takes precedence over the Symbol Rate in the setup file, if a SetupFile is specified.
10. The analyzer's digital demodulation algorithm limits the analyzer's span to a maximum of 15.625 times the Symbol Rate. This, plus the analyzer's maximum decimation rate, places a lower limit on the Symbol Rate.
11. 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's 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.
12. Triggering is not available in the 89600 when the input is from a simulation.
13. Except when the VSA_89600_Sink RecordMode = YES, TclTkMode = NO, and 0 ≤ Start < Stop, the you must ensure the simulation generates enough points to fill the 89600 Record buffer when operating the 89600 in the Record mode.
14. When in Record (Time Capture) mode, the 89600 Record buffer needs additional settling points under some conditions, such as when the span is reduced.
15. In Record mode, if necessary, you can stop or pause the simulation in order to give the 89600 priority to run in playback mode after the capture.
16. Unless a setup file is specified, the VSA application begins the simulation with its previous setup, with a few modifications dictated by the simulation. This setting enables for continuity of the VSA setup between simulations. RestoreHW = YES can interfere with this (refer to note 18). This continuity means that the initial VSA application setup can be important when a setup file is not specified. This includes the Hardware Setup. Starting a simulation in a known state, such as a preset state, can resolve some VSA initialization problems. The VSA can be preset in various ways under File > Preset on the VSA application. The Simulate Hardware selection under Hardware > Utilities can be a useful starting point.
17. If RestoreHW = NO (default), the VSA application remains in its Stream hardware setup at the end of a simulation. It can be returned to using other VSA hardware setups through the Hardware > Utilities menu on the VSA application.
18. If RestoreHW = YES, the hardware setup is saved at the beginning of the simulation and then restored at the end of the simulation. Since some measurement setups change when the hardware setup changes, this setting can interfere with the continuity between simulations as described in Note 17. In general, setting RestoreHW to NO or specifying SetupFile can have the least problems.
    One need for RestoreHW = YES is when changing between simulations where a VSA with the same Instance Name is used as a source in one simulation and a sink in another and the VSA instance is not closed between the simulations. In this case, the sink VSA restores the source hardware setting at the end of the simulation. Otherwise, the VSA is left configured with Stream hardware and does not function correctly as a source. The same problem arises if you would like to alternate between using the same running VSA instance as a sink in a simulation and then would like to make hardware based measurements.
19. Multiple VSA_89600_Sink-type components can be active in a simulation and you can configure each one independently (For ADS versions earlier than 1.5, only one VSA_89600_Sink component can be active in a simulation.)
20. In some simulation contexts you can add a shunt resistor to the simulation inputs of a VSA_89600_Sink-type component. VSA_89600_Sink-type components do not have an R _IN parameter, so the simulator can assume that R _IN is infinite without a shunt resistor in the simulation.
21. When a simulation that contains an active VSA_89600_Sink 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.
22. If SetFreqProp = NO, the VSA's measurement center frequency, span, and zoom mode are left unchanged (except that these are loaded from a setup file, if SetupFile is specified). If these are different from the simulation center (carrier) frequency, span (sample rate), or zoom (complex) mode, then the display on the VSA can be quite different from expected. If SetFreqProp = YES, the VSA's measurement center frequency, span, and zoom parameters is set to those of the simulation, overriding those in the setup file, if specified.
23. To access example designs that use this model, from the ADS Main window, choose File > Example Project > Instruments > VSA89600_demos_prj.