niDCPower_ConfigureOutputResistance
- Updated2023-04-15
- 2 minute(s) read
ViStatus niDCPower_ConfigureOutputResistance(ViSession vi, ViConstString channelName, ViReal64 resistance);
Purpose
Configures the output resistance that the specified channel(s) attempt to generate. A 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.
Channels actively regulate 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 This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices. |
Depending on the instrument, output resistance is configurable only if you set the output function of the channel using the niDCPower_ConfigureOutputFunction function as follows:
- PXIe-4141, PXIe-4143, PXIe-4145: NIDCPOWER_VAL_DC_VOLTAGE
- PXIe-4135, PXIe-4137, PXIe-4139, PXIe-4147: NIDCPOWER_VAL_DC_CURRENT or NIDCPOWER_VAL_DC_VOLTAGE
Details: Programmable Resistance Range and Merged Channels
Using the NIDCPOWER_ATTR_MERGED_CHANNELS attribute to merge SMU outputs affects the valid output resistance range you can program. Refer to Effect of Merging Channels on Other Functions and Properties for details.
Parameters
| Input | ||
| Name | Type | Description |
| vi | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. |
| channelName | ViConstString | Specifies the channel(s) to use. Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.
If you pass "" for this control, all channels in the session are used. |
| resistance | ViReal64 | Specifies the output resistance, in ohms, for the specified channel(s). For more information about configuring output resistance, refer to the topic on output resistance for your instrument. |
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports 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. |