Creates a current input channel or a set of current input channels with the specified parameters for measuring current.

Syntax

Namespace: NationalInstruments.ECUTS.Pulser

public void CreateCurrentInputChannel(string channelNames, double minimumValueInAmperes, double maximumValueInAmperes)

Parameters

NameTypeDescription
channelNamesstring

Specifies the current input channel name(s) to be created.

minimumValueInAmperesdouble

Specifies the minimum value of current in amperes that you expect the channel(s) to measure.

maximumValueInAmperesdouble

Specifies the maximum value of current in amperes that you expect the channel(s) to measure.

Exceptions

TypeDescription
PulserSessionException

Thrown when one of the following error conditions occurs:

  • InvalidChannelName: This method is called when the specified channel name is not in the list of supported channel names.

  • InvalidChannelType: The specified channel is a voltage channel instead of a current channel.

  • InvalidInputLimitValue: The specified minimum or maximum value is not supported, or the specified minimum value is greater than the maximum value.

  • ChannelAlreadyCreated: Attempts to create a channel with a name that has already been created.

  • InvalidOperation: This method is called after configuring the acquisition time with ConfigureAcquisitionTime

  • InvalidOperation: This method is called when the Pulser is still in the Running state."/></li>
    </ul>
    </exception>
    <remarks>
    <para>
    The specified string in <paramref name="channelNames"/> can contain a list or range of the supported input channel names.
    </para>
    To specify a range of channel names, use a colon between two channel numbers or two channel names.<br/>
    Specify a number immediately before and after every colon <c>:</c> in the input string.<br/>
    Or, if a name is specified after the colon, it must be identical to the name specified immediately before the colon.<br/>
    Colons are not allowed within the individual channel name.<br/>
    The following are some of the supported <paramref name="channelNames"/> values:<br/>
    <list type="bullet">
        <item>PULSER CURRENT 0</item>
        <item>PULSER CURRENT INPUT 0:2</item>
        <item>PULSER CURRENT INPUT 0:PULSER CURRENT INPUT 2</item>
    </list>
    Use commas to separate channel names and ranges in a list as follows:<br/>
    PULSER CURRENT 0, PULSER CURRENT INPUT 0:1, PULSER CURRENT INPUT 2
    <para>
    The following channel names are supported:
    </para>
    <list type="bullet">
        <item>PULSER CURRENT 0</item>
        <item>PULSER CURRENT INPUT 0</item>
        <item>PULSER CURRENT INPUT 1</item>
        <item>PULSER CURRENT INPUT 2</item>
    </list>
    <blockquote>
    If different <paramref name="minimumValueInAmperes"/> and/or different <paramref name="maximumValueInAmperes"/> are required
    for each channel, call this method multiple times with the required values.
    </blockquote>
    <blockquote>
    The <paramref name="minimumValueInAmperes"/> and <paramref name="maximumValueInAmperes"/> parameters must be within the supported range. Refer to the documentation of current transducer connected to the channel for the supported range.