IviDCPwr_ResetOutputProtection

CVI/LabWindows IVI Class Driver

IviDCPwr_ResetOutputProtection

IviDCPwrBase Capability Group

C Function Prototype

ViStatus IviDCPwr_ResetOutputProtection (ViSession vi, ViConstString channelName);

Purpose

This function resets the power supply output protection after an over voltage or over current condition occurs.

An over voltage condition occurs when the output voltage is equal to or greater than the value of the IVIDCPWR_ATTR_OVP_LIMIT attribute and the IVIDCPWR_ATTR_OVP_ENABLED attribute is set to VI_TRUE.

An over current condition occurs when the output current is equal to or greater than the value of the IVIDCPWR_ATTR_CURRENT_LIMIT attribute and the IVIDCPWR_ATTR_CURRENT_LIMIT_BEHAVIOR attribute is set to IVIDCPWR_VAL_CURRENT_TRIP.

When either an over voltage condition or an over current condition occurs, the output protection of the power supply disables the output. After the output protection is reset, the power supply resumes generating a power signal.

You use the IviDCPwr_QueryOutputState function to determine if the power supply is in an over voltage or over current state.

Parameters

Name Type Description
vi ViSession The instrument handle that you obtain from the IviDCPwr_init or IviDCPwr_InitWithOptions functions. The handle identifies a particular IVI session.
channelName ViConstString Pass the virtual channel name that you assign to the instrument in MAX.

Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel through MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names.

Note  You can specify the channel name as a string variable or as a literal enclosed in double quotes.

Return Values