DigitalSourceWaveforms.CreateParallel Method (String, String, SourceDataMapping)
- Updated2023-11-24
- 2 minute(s) read
DigitalSourceWaveformsCreateParallel Method (String, String, SourceDataMapping)
Creates source waveform settings used to source parallel data using a comma-delimited string of pins or channels.
Namespace: NationalInstruments.ModularInstruments.NIDigital
Assembly: NationalInstruments.ModularInstruments.NIDigital.Fx40 (in NationalInstruments.ModularInstruments.NIDigital.Fx40.dll) Version: 2021
Syntax
public void CreateParallel( string pinSetString, string waveformName, SourceDataMapping dataMapping )
Public Sub CreateParallel ( pinSetString As String, waveformName As String, dataMapping As SourceDataMapping )
Parameters
- pinSetString
- Type: SystemString
The set of pins or channels for which to create the waveform. The pins or channels represented by the pinSetString must match the source pins in the pattern that references the waveform. The pin order in the pin set string determines the bit positions of the data written using one of the write waveform methods on the DigitalSourceWaveforms object. - waveformName
- Type: SystemString
The name of the waveform to use in the pattern file. Waveform names must be unique. Use this waveformName with the source_start opcode in your pattern. - dataMapping
- Type: NationalInstruments.ModularInstruments.NIDigitalSourceDataMapping
Specifies whether the waveform is broadcast to all sites or a unique waveform is sourced per site.
Exceptions
| Exception | Condition |
|---|---|
| IviCDriverException | The NI-Digital Pattern Driver returned an error. |
| SelectorNameException | The value for pinSetString contains a pin or pin group name not loaded in the pin map. |
| ArgumentException | The value for waveformName is an empty string or contains an invalid character. |
| OutOfRangeException | The value for dataMapping is invalid.The number of waveforms in source memory exceeds maximum number of waveforms allowed. |
Remarks
The number of waveforms is limited to 512.
You cannot reconfigure settings after waveforms are created.
For more information, refer to Opcodes and Source Waveform Configurations in the Digital Pattern Help.