Creates the capture waveform settings for serial acquisition using a comma-delimited string of pins or channels.

Syntax

Namespace: NationalInstruments.ModularInstruments.NIDigital

public void CreateSerial(string pinSetString, string waveformName, uint sampleWidth, BitOrder bitOrder)

Remarks

The number of waveforms is limited to 512.

Settings apply across all sites if multiple sites are configured in the pin map. You cannot reconfigure settings after waveforms are created.

Parameters

NameTypeDescription
pinSetStringstring

The set of pins or channels for which to create the waveform.

waveformNamestring

Specifies the waveform name to use. Use the waveformName  with the capture_start opcode in your pattern.

sampleWidthuint

The width in bits of each serial sample. Valid values are between 1 and 32.

bitOrderBitOrder

The order in which to shift the bits. This can be most significant bit first or least significant bit first.

Exceptions

TypeDescription
Ivi.Driver.SelectorNameException

The value for pinSetString  contains a pin or pin group name not loaded in the pin map.

System.InvalidOperationException

The value for pinSetString  contains a system pin.

System.ArgumentException

  1. The value for waveformName  is an empty string or contains an invalid character.

  2. The value for sampleWidth  is invalid.

  3. The value for bitOrder  is invalid.

Ivi.Driver.OutOfRangeException

The number of waveforms in capture memory exceeds the maximum number of waveforms allowed.