IviDCPwr Query Output State
IviDCPwr Base Capability Group
This VI returns whether the power supply is in a particular output state. Details
 |
instrument handle The instrument handle that you obtain from the IviDCPwr Initialize or IviDCPwr Initialize With Options VI. |
 |
channel name ("CHANNEL 1") 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. Default Value: CHANNEL 1 |
 |
output state (Constant Voltage) Pass the output state for which you want to query. Defined Values: IVIDCPWR_VAL_OUTPUT_CONSTANT_VOLTAGE—Constant Voltage State IVIDCPWR_VAL_OUTPUT_CONSTANT_CURRENT—Constant Current State IVIDCPWR_VAL_OUTPUT_UNREGULATED—Unregulated State IVIDCPWR_VAL_OUTPUT_OVER_VOLTAGE—Overvoltage State IVIDCPWR_VAL_OUTPUT_OVER_CURRENT—Overcurrent State Default Value: IVIDCPWR_VAL_OUTPUT_CONSTANT_VOLTAGE |
 |
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |
 |
instrument handle out The instrument handle that you obtain from the IviDCPwr Initialize or IviDCPwr Initialize With Options VI. |
 |
in state This parameter returns TRUE if the power supply is currently in the state you specify with the OutputState parameter, and FALSE if it is not. |
 |
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |
IviDCPwr Query Output State Details
A constant voltage condition occurs when the output voltage is equal to the value of the IviDCPwr Voltage Level property and the current is less than or equal to the value of the IviDCPwrCurrent Limit property.
A constant current condition occurs when the output current is equal to the value of the IviDCPwr Current Limit property and the IviDCPwr Current Limit Behavior property is set to IVIDCPWR_VAL_CURRENT_REGULATE.
An unregulated condition occurs when the output voltage is less than the value of the IviDCPwr Voltage Level property and the current is less than the value of the IviDCPwr Current Limit property.
An overvoltage condition occurs when the output voltage is equal to or greater than the value of the IviDCPwr OVP Limit property and the IviDCPwr OVP Enabled property is set to TRUE.
An over-current condition occurs when the output current is equal to or greater than the value of the IviDCPwr Current Limit property and the IviDCPwr Current Limit Behavior property is set to IVIDCPWR_VAL_CURRENT_TRIP.
When either an overvoltage condition or an over-current condition occurs, the power supply's output protection disables the output. If the power supply is in an overvoltage or over-current state, it does not produce power until the output protection is reset. The IviDCPwr Reset Output Protection VI resets the output protection. Once the output protection is reset, the power supply resumes generating a power signal.