Source Waveform Configurations

Managing Source Waveform Files

1. Select File » New or select the Add Item button on the Project Explorer window toolbar to create a new document.
2. Create a single .tdms file for each individual source waveform you require.
3. Double-select a .tdms file in the Project Explorer window or right-select the file and select Open from the context menu to launch the source waveform configuration document.
   Note The Digital Pattern Editor opens only .tdms waveform files that have the same structure as the waveform files the editor creates.
4. You can also use the NI-Digital API to configure and load source waveforms you create or edit with the source waveform configuration document.

Refer to the Related reference section at the end of this topic for a link to more information about source and capture functionality.

Configuring Waveforms

You must specify values for the following components of the waveform. Options that don't apply dim based on the values you specify.

Waveform Name—Specifies the name of the waveform.

Status—Indicates one of the following states of the waveform:

Not Loaded—The waveform hasn't been loaded on the digital pattern instrument.

Loaded—The waveform has been loaded on the digital pattern instrument.

Out of Sync—The waveform has been loaded on the digital pattern instrument but has been modified since it was loaded.

Waveform Type—Specifies one of the following types of waveforms:

Serial—Specifies that the waveform uses the serial configuration. When you configure the source functionality for serial use, each vector that contains a source opcode serially shifts 1 bit on the pin using the drive from source pin state (D) to indicate what value to drive. Only one pin per vector can source in this mode.

Parallel—Specifies that the waveform uses the parallel configuration. When you configure the source functionality for parallel use, the entire waveform sample is sourced on all specified pins in parallel for each vector that contains a source opcode. Use the drive from source pin state (D) for each pin on each such vector that corresponds to the pins to source.

Sample Format—Specifies one of the following options to display data in decimal (no prefix), hexadecimal (0x prefix), or binary (0b prefix) format.

Sample Width—Specifies the width in bits of each serial sample when you select Serial for the Waveform Type. Valid values are 1 through 32.

Bit Order—Specifies whether to evaluate the most significant bit (MSB) or the least significant bit (LSB) first when sourcing a sample of a serial waveform.

Pins/Pin Groups—Specifies the pins or pin groups configured for the waveform. Use the type-ahead drop-down menu to select valid pins and pin groups.

Data Mapping—Specifies one of the following data mapping options:

Broadcast—Specifies to broadcast the waveform data in the Site 0 column of the Source Data table to all sites.

Site Unique—Specifies to source unique waveform data for each site from the separate corresponding column for each site in the Source Data table. If using a pin with a shared pin connection, the waveform data must be identical for each of the sites that a pin is shared on.

The Source Data tab of the document displays editable source waveform data per site in columns. When you set Data Mapping to Broadcast, only the column for Site 0 is used. You can edit the data directly in the Source Data tab. You can also edit the source waveform file in another application and then select Import Source Data on the toolbar. To update the data to source, select Import From File on the Source Data tab. Use the Number of Sites control or right-select the source data table and select Set Number of Sites to specify the number of sites to use.

Importing Source Waveform Data

To import data to a source waveform, select Import Source Data . You can also select Import From File on the Source Data tab, then select a .csv file of source waveform data. Ensure the file is in decimal, hexadecimal, or binary format to store and load with the waveform configuration.

The following table shows examples of text files and the corresponding Source Data tab.

Table 7. Example Text Files

Text File	Source Data tab
0, 15 1, 14
0x0, 0xF 0x1, 0xE
0b0000, 0b1111 0b0001, 0b1110

Loading Waveforms

The Digital Pattern Editor prompts you to load waveforms on the instrument before bursting a pattern if the pattern directly uses a waveform, including waveforms used in patterns that the pattern jumps to. You can also select Load Waveform on the toolbar or right-select the waveform file in the Project Explorer window and use the context menu to manually load the current waveform on the instrument. You must specify a name and at least one pin for the waveform. You can't load a waveform with the same name as another already loaded waveform. Select the Unload All Patterns and Waveform Configurations button to remove all source and capture waveforms and patterns from the instrument. If you modify and save the waveform, you must unload and reload the waveform for the changes to take effect on the instrument. The Digital Pattern Editor prompts you to reload modified files before bursting a pattern.

When you load a parallel source or capture waveform through the Digital Pattern Editor, the order of pins you specify in the Pins/Pin Groups configuration determines the mapping for the bits in each sample. For example, the left-most bit maps to the left-most pin you specify, and each subsequent bit maps to each subsequent specified pin. For pin groups, the left-most bit maps to the top pin of the pin group, and each subsequent bit maps to the subsequent pin in the pin group.

Keyboard Shortcuts within the Source Waveform Configuration File