niDCPower_ConfigureOutputResistance

NI DC Power Supplies and SMUs Help (NI-DCPower)

Edition Date: January 2018

Part Number: 370736U-01

View Product Info

DOWNLOAD (Windows Only)


NI-DCPower (English | Japanese)

ViStatus niDCPower_ConfigureOutputResistance(ViSession vi, ViConstString channelName, ViReal64 resistance);

Purpose

Configures the output resistance that the device attempts to generate for the specified channel or channels. The channel must be enabled for the specified output resistance to take effect.

Refer to the niDCPower_ConfigureOutputEnabled function for more information about enabling the output channel.

For NI PXIe-4141/4143/4145 devices, output resistance is only supported if the output function of the channel is set to NIDCPOWER_VAL_DC_VOLTAGE using the niDCPower_ConfigureOutputFunction function.

For PXIe-4135, NI PXIe-4137, and NI PXIe-4139 devices, output resistance is supported if the output function of the channel is set to NIDCPOWER_VAL_DC_CURRENT or NIDCPOWER_VAL_DC_VOLTAGE using the niDCPower_ConfigureOutputFunction function.

The device actively regulates the current and voltage to reach the specified output resistance, although in DC Voltage output mode, the voltage at the output experiences a "virtual drop" that is proportional to its current. In DC Current output mode, the output experiences a "virtual leakage current" that is proportional to the output voltage.

Note Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithChannels function.
channelName ViConstString Specifies the output channel(s) to which this configuration value applies. Specify multiple channels by using a channel list or a channel range. A channel list is a comma (,) separated sequence of channel names (for example, 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 (for example, 0-2 specifies channels 0, 1, and 2). In the Running state, multiple output channel configurations are performed sequentially based on the order specified in this parameter.
resistance ViReal64 Specifies the output resistance, in ohms, for the specified channel. Refer to the NI PXIe-4141 Programmable Output Resistance, NI PXIe-4143 Programmable Output Resistance, NI PXIe-4145 Programmable Output Resistance,or NI PXIe-4154 Programmable Output Resistance topic in the NI DC Power Supplies and SMUs Help for more information about configuring output resistance.

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.

WAS THIS ARTICLE HELPFUL?

Not Helpful