CM SStudioFileRead

CM_SStudioFileRead

Description: Time domain signal generator with signalstudio encrypted file based data
Library: Instruments
Class: TSDFCM_SStudioFileRead

Parameters

Name	Description	Default	Unit	Type	Range
FileName	input file name	esg.wfm		filename
ROut	resistance	DefaultROut	Ohm	real	[0, ∞)
RTemp	physical temperature, in degrees C	DefaultRTemp	Celsius	real	[-273.15, ∞)
TStep	simulation time step: Derived from source data, Derived from output pin	Derived from source data	sec	real enum	{-1} or [0, ∞)
ControlSimulation	control simulation: NO, YES	NO		enum
SegmentLength	if non-zero, truncate or zero pad source data to this length	0	sec	real	[0, ∞)
RepeatData	control operation at the end of source data: Single pass, Repeat	Single pass		enum
InterpolationType	interpolation technique to use: Lagrange, Sample and hold, Linear	Lagrange		enum
InterpolationOrder	number of points to use if Lagrange interpolation is set	4		int	[2, ∞)

Pin Outputs

Pin	Name	Description	Signal Type
1	output		timed

Notes/Equations

The CM_SStudioFileRead component is used to generate timed data output evaluated using IQ data from a Signal Studio waveform (.wfm) file. This type of file can be created by:

Using the CM_ESG_E4438C_Sink or CM_PSG_E8267C_Sink components (see DownloadMode parameter) or

Using the next generation Signal Studio personalities.

Note
There are two Signal Studio file reader components in ADS Ptolemy. Use CM_SStudioFileRead for the latest versions of Signal Studio (or if unsure) and SStudioFileRead for older versions. The documentation for SStudioFileRead lists the specific personalities and versions supported by the obsolete component.

Signal Studio is an Agilent product that consists of a suite of PC-based software tools used to create waveforms for popular communication formats. Signal Studio has an intuitive, easy-to-use Graphical User Interface to set various signal parameters for flexible waveform generation.
Agilent's Signal Studio software can be downloaded from the Signal Studio website at http://www.agilent.com/find/signalstudio. The Signal Studio models with different Personalities and Product Model Numbers listed in Signal Studio Personalities Compatible with this Component support exporting the generated waveform signal into an encrypted-binary file, a wfm file. This component reads a wfm file and outputs the simulation signal to test your designs. In the simulation, this model also checks the waveform personality and pulls the corresponding ADS license as shown in Signal Studio Personalities Compatible with this Component.

Signal Studio Personality	E4438C ESG Compatible Signal Studio Model Number	E8267D PSG Compatible Signal Studio Model Number	N5182A MXG Compatible Signal Studio Model Number	ADS Wireless Library License Pulled
3GPP W-CDMA with HSDPA/HSUPA	N7600A	N7600A	N7600B	WCDMA3G
IS-95, cdma2000�, 1xEV-DO, 1xEVDO	N/A	N/A	N7601B	CDMA1xEV
GSM and EDGE	N/A	N/A	N7602B	EDGE
TD-SCDMA	N7612B	N/A	N7612B	TDSCDMA
802.16-2004	N7613A	N7613A	N7613A	WLAN_Fixed
802.16 OFDMA	N7615A	N/A	N7615B	WLAN_Mobile
802.11 WLAN	N7617A	N7617A	N7617B	WLAN
DVB	N7623A	N7623A	N/A	DTV
1XEV-DO	E4438C-404	N/A	N/A	CDMA1xEV
Bluetooth	E4438C-406	N/A	N/A	WLAN
3GPP LTE	N7624B	N7624B	N/A	LTE

Some of the Signal Studio models are not shown in Signal Studio Personalities Compatible with this Component above. These models typically apply to one of the following cases:

Some Signal Studio models; such as T-DMB and Pulse Building, do not support exporting wfm files to ADS.
Embedded software models that only work with ESG hardware, and there is no capability to export wfm files to ADS.
To export the data to Advanced Design System from one of these applications, choose File > Export Waveform Data from Signal Studio.

FileName specifies the encrypted binary wfm file from which the signal is to be read. The default location for the wfm file is the data directory of the current ADS project.
For more information on setting ROut, RTemp and TStep parameters, refer to the Timed Sources Introduction. Additionally, this component supports a TStep value of −1 that automatically sets TStep to the sampling period specified in the wfm file.
If ControlSimulation = YES and RepeatData = Single pass, the simulation runs until the last data from the datafile is read.
The InterpolationType and InterpolationOrder parameters are used only when TStep and the datafile sampling period are not equal.

Note
The following note is applicable only when the datafile used was created by using the write_to_datafile option of the CM_ESG_E4438C_Sink component. This sink normalizes the signal to the {−1, 1} range. In order to enable the recovery of the signal voltage level, the scaling factor used for normalization (abs(max(I,Q))) is embedded in the header of the datafile. When this file is used with the CM_SStudioFileRead component, the embedded scaling factor value is used to restore the signal to its original level.

Note
This model is supported on 32-bit platforms including Windows, Linux and Sun. If this model is used on HP-UX 11.11, sometimes the following error will be generated,

This Signal Studio file XXXXX.wfm was created using an unsupported Signal Studio option.

In this case, switch to a Windows, Linux or Sun platform.

Note
Problem with WFM files generated with some newer Signal Studio products: Typically, the WFM file generated by the Signal Studio product includes the value of signal waveform carrier frequency. However, it has been noted that some newer Signal Studio products do not include information on the signal waveform carrier frequency in the WFM file.

For these WFM files, the CM SStudioFileRead presumes that the carrier frequency is zero and ignores the imaginary part of the real/imaginary waveform data pairs.

The work around for this WFM file case is to connect the CM SStudioFileRead output to a CxToRect component. Only then, can both the real and imaginary parts of the CM_SStudioFileRead component be visible at the output of the CxToRect component. Further, one must connect the outputs of the CxToRect component to a QAM_Mod component to place these I and Q waveforms on an RF carrier. Only then, would such an RF signal contain both the real and imaginary parts of the complex envelope waveform in the WFM file and be usable with other ADS Ptolemy components that require an RF complex envelope signal at their inputs.

If the user is unsure if the WFM file includes the signal waveform carrier frequency, then the user is advised to first test the WFM file output without and with this work around. If the waveform without the work around contains only a real waveform and use with the work around shows real and imaginary waveforms, then one knows that the WFM file did not include the signal waveform carrier frequency and the work around should be used.