niDCPower_ConfigureVoltageLimitRange

NI-DCPower Function Reference

niDCPower_ConfigureVoltageLimitRange

ViStatus niDCPower_ConfigureVoltageLimitRange (ViSession vi, ViConstString channelName, ViReal64 range);

Purpose

Configures the voltage limit range for the specified channel(s). The configured range defines the valid values the voltage limit can be set to using the niDCPower_ConfigureVoltageLimit function. The voltage limit range setting is applicable only if the channel is set to the NIDCPOWER_VAL_DC_CURRENT output function using the niDCPower_ConfigureOutputFunction function.

Use the NIDCPOWER_ATTR_VOLTAGE_LIMIT_AUTORANGE attribute to enable automatic selection of the voltage limit range.

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.
range ViReal64 Specifies the voltage limit range, in volts, on the specified channel(s).

Valid Values:

NI PXI-4110
ChannelVoltage Limit Range (V)Voltage Limit (V)
060 to +6
1, 2200 to +20

NI PXI-4130
ChannelVoltage Limit Range (V)Voltage Limit (V)
060 to +6
160 to +6
200 to +20
Note Note   If a range other than what is listed in the preceding table is selected, it will be coerced to the next-highest range. For example, requesting the 10 V voltage limit range on Channel 1 on the NI-PXI 4130 coerces the voltage limit range to 20 V. Refer to the Ranges topic in the NI DC Power Supplies and SMUs Help for more information about coercion.

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.