niDCPower_CalSelfCalibrate
- Updated2025-10-06
- 2 minute(s) read
Performs a self-calibration upon the specified channel(s).
Syntax
ViStatus _VI_FUNC niDCPower_CalSelfCalibrate(ViSession vi, ViConstString channelName)
Remarks
This function disables the output, performs several internal calculations, and updates calibration values. The updated calibration values are written to the device hardware if the NIDCPOWER_ATTR_SELF_CALIBRATION_PERSISTENCE attribute is set to NIDCPOWER_VAL_WRITE_TO_EEPROM. Refer to the NIDCPOWER_ATTR_SELF_CALIBRATION_PERSISTENCE attribute topic for more information about the settings for this attribute.
For the PXIe-4147 and PXIe-4162/4163, you must specify all channels of the instrument with the channelName input. You cannot self-calibrate a subset of channels for these instruments.
This function calls the niDCPower_ResetWithChannels function, which puts the device configuration into the default state without changing the NIDCPOWER_ATTR_SELF_CALIBRATION_PERSISTENCE attribute.
NI-DCPower uses the terms "source" and "output". However, while sinking with electronic loads and SMUs these correspond to "sinking" and "input", respectively.
This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.
Parameters
| Name | Direction | Type | Description |
|---|---|---|---|
| vi | [in] | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. |
| channelName | [in] | 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. |
Returns
Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:
Value | Meaning |
|---|---|
0 | Success |
Positive Values | Warnings |
Negative Values | Errors |