niDCPower_ConfigureCurrentLimit

NI-DCPower Function Reference

niDCPower_ConfigureCurrentLimit

ViStatus niDCPower_ConfigureCurrentLimit (ViSession vi, ViConstString channelName, ViInt32 behavior, ViReal64 limit);

Purpose

Configures the current limit for the specified channel(s). The channel must be enabled for the specified current limit to take effect. Refer to the niDCPower_ConfigureOutputEnabled function for more information about enabling the output channel.

The current limit is the current that the output should not exceed when generating the desired voltage level. The current limit setting is applicable only if the channel is set to the NIDCPOWER_VAL_DC_VOLTAGE output function using the niDCPower_ConfigureOutputFunction function.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_init or niDCPower_InitWithOptions function.
channelName ViConstString Specifies to which output channel(s) to apply this configuration value. You can specify multiple channels by using a channel list or a channel range. A channel list is a comma (,) separated sequence of channel names (e.g. 0,2 specifies channels 0 and 2). A channel range is a lower bound channel followed by a hyphen (-) or colon (:) followed by an upper bound channel (e.g. 0-2 specifies channels 0, 1, and 2). In Immediate mode, multiple output channel configurations are performed sequentially based on the order specified in this parameter.
behavior ViInt32 Specifies how the output should behave when the current limit is reached.

Defined Values:
NIDCPOWER_VAL_CURRENT_REGULATEControls output current so that it does not exceed the current limit. Power continues to generate even if the current limit is reached.
limit ViReal64 Specifies the current limit, in amps, on the specified channel(s).

Valid Values:
The valid values for this parameter are defined by the current limit range that is configured using the niDCPower_ConfigureCurrentLimitRange function.

Return Value

Name Type Description
StatusViStatusReports the status of this operation. To obtain a text description of the status code, call the niDCPower_error_message function. To obtain additional information concerning the error condition, call the niDCPower_GetError function.