Configure Operation

Waveforms Tab

The Waveforms tab contains a list control of defined waveforms. Use the Add and Remove buttons to add new waveforms and remove existing waveforms from the list.

• Preserve Existing Waveforms —When you enable this option, the step adds to or modifies any existing waveforms previously configured. When you disable this option, the step deletes all previously configured waveforms before configuring the specified waveform in the list.

The Waveforms tab for the Configure operation also contains the following waveform-specific options:

• Name —The name of the arbitrary waveform.
• Source —Selects the source of the arbitrary waveform. The waveform source can be a valid ASCII or binary file format, or a waveform returned from an expression TestStand evaluates. The Filename setting specifies the relative or absolute file path. The Data Source setting specifies the expression TestStand evaluates.

  Supported Value	Description
  Use Data Source	The arbitrary waveform source as an expression TestStand evaluates.
  2-Byte Integer	The arbitrary waveform source as a file with 2-byte integer data.
  4-Byte Integer	The arbitrary waveform source as a file with 4-byte integer data.
  ASCII File	The arbitrary waveform source as a file with delimited ASCII data.

• Data Source —The expression TestStand evaluates when the Source setting is Use Data Source. When TestStand evaluates the expression at run time, the expression must return an array of number. When the expression specifies a variable or property name, click Load to import data from a file into the variable or property. Click Clear to set the specified array property to empty. Click View to display the data in the array property in a graph.

  The default value for the Data Source setting is Step.Configuration.Waveforms , which is an array of waveforms. Each element of the array represents the data for the waveforms specified in the list control.

• Filename —The source file for the arbitrary waveform when the Source setting is a file. Files can be ASCII files with values that a variety of characters including, but not limited to, the carriage return, comma, and semicolon delimit. Additionally, files can be 2-byte or 4-byte integer binary files. Valid binary files contain a different entry every x bytes, where x is 2- or 4-byte depending on the file. Nothing except space explicitly delimits these binary files. For instance, if you had a 4-byte integer file containing five points, the data may appear as follows:

  Address	Value
  0x0000	0x00000001
  0x0004	0x00000002
  0x0008	0x00000003
  0x000C	0x00000004
  0x0010	0x00000005

• Auto Normalize Mode —Specifies how to normalize an arbitrary waveform, if at all. Normalizing a waveform transforms the waveform so the normalized points are between the values -1 and 1 . If the offset is removed, the values of the normalized points span the interval -1 to 1 .

  Supported Value	Description
  No Auto Normalize (0)	No automatic normalization of waveform data.
  Normalize (1)	Automatic normalization of waveform data to be between -1 and 1.
  Normalize And Remove	Automatic normalization of Offset (2) waveform data, which forces data points to span the interval -1 to 1.