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

Syntax

Namespace: NationalInstruments.PowerSignalsDaq

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
PowerSignalsDaqException

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 <see cref="ConfigureAcquisitionTime(TimeSpan)"./>

  • InvalidOperation: This method is called when the Power Signals DAQ 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>PWRSIGDAQ1 CURRENT 0</item>
        <item>PWRSIGDAQ1 CURRENT 0:3</item>
        <item>PWRSIGDAQ1 CURRENT 0:PWRSIGDAQ1 CURRENT 3</item>
    </list>
    Use commas to separate channel names and ranges in a list as follows:<br/>
    PWRSIGDAQ1 CURRENT 0, PWRSIGDAQ1 CURRENT 1:2, PWRSIGDAQ1 CURRENT 3
    <para>
    The following channel names are supported:
    </para>
    <list type="bullet">
        <item>HP_PPS1 CURRENT 0</item>
        <item>PWRSIGDAQ1 CURRENT 0</item>
        <item>PWRSIGDAQ1 CURRENT 1</item>
        <item>PWRSIGDAQ1 CURRENT 2</item>
        <item>PWRSIGDAQ1 CURRENT 3</item>
        <item>PWRSIGDAQ1 CURRENT 4</item>
        <item>PWRSIGDAQ1 CURRENT 5</item>
        <item>PWRSIGDAQ1 CURRENT 6</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.