CM_BB_StudioStreamWrite

Description: Baseband Studio for Streaming file writer
Library: Instruments
Class: SDFCM_BB_StudioStreamWrite
Derived From: CM_BinaryArbWrite

Parameters

Name	Description	Default	Type
Start	sample number to start waveform recording	DefaultNumericStart	int
Stop	sample number to stop waveform recording	DefaultNumericStop	int
FileName	Output baseband studio file name	file.bin	filename
ControlSimulation	control simulation: NO, YES	YES	enum
AutoScaling	scale input data to fit dynamic range of ESG DAC: NO, YES	YES	enum

Pin Inputs

Pin	Name	Description	Signal Type
1	input		complex
2	inputmarkers		multiple complex

Notes/Equations

1. Baseband Studio for waveform streaming is an Agilent product that contains elements of PC hardware and software that, when coupled with an Agilent PSG or ESG vector signal generator and a PC, provides a deep memory signal source needed for thorough testing early in the development process.
   The CM_BB_StudioStreamWrite component can be used to create a signal compatible with the Baseband Studio product. In addition, the CM_BB_StudioStreamRead and CM_BB_StudioStreamWrite components can be used to save and playback long I/Q sequences within ADS.
   The file generated by this sink can be transferred to a PC configured for use with Baseband Studio; and, the I/Q waveform data from the file can be played using the Baseband studio for streaming UI directly on the ESG/PSG internal baseband generator DACs in a continuous fashion. This results in long, unique test signals, up to hours in length directly from the ESG/PSG analog I/Q and RF output ports.
   
2. The component has two inputs: an input pin for complex I/Q data and an optional complex bus input pin to enable marker bits to be embedded in the file. To avoid creating marker bits, leave the marker input pin disconnected. Up to two complex inputs can be connected to the marker input pin. For every point in the waveform, up to four marker bits can be generated based on whether the corresponding input is >1 or 0. The marker bits are embedded into each I/Q data point in the file like this:
   Zero connections to marker input - Data format: 0 Markers; 16 Bit I,Q
   One connection to marker input - Data format: 2 Markers; 15 Bit I,Q
   Two connections to marker input - Data Format: 4 Markers; 14 Bit I,Q
   For example, to enable event markers 1 and 4 for the first 10 points of the waveform, generate two complex signals A and B that take the values (1 + j0) and (0 + j1) respectively for the first 10 points in the simulation and revert to (0 + j0) for the rest of the simulation. Use the BusMerge2 component to merge signals A and B and connect the output of BusMerge2 to the marker bus input pin.

   Note The Baseband Studio file format contains only data values as 16-bit integers with optional markers embedded in each data value. It does not contain any header information such as Amplitude, Frequency, and SampleClk. If required, these instrument settings must be controlled from the instrument's front panel or by using appropriate SCPI commands.

3. The AutoScaling parameter specifies whether input scaling is to be performed. When AutoScaling = YES, the input I/Q data is scaled to the range {−1, 1}, and the scaling factor is displayed towards the end of the simulation. To perform scaling, data is cached in a temporary file, which can require significantly more disk space. When AutoScaling = NO, no scaling is performed on the input data; however, data outside the range {−1, 1} is clipped to −1 or 1.
4. If ControlSimulation = YES, the simulation runs from Start to Stop − Start + 1.