IviACPwrBase Capability Group

IVI Driver Help

Edition Date: August 2011

Part Number: 370430H-01

»View Product Info
Download Help (Windows Only)

The IviDCPwrBase capability group supports the most basic DC power supply capabilities. You can specify the voltage level, current limit, frequency, and control the operation of the output relay/contactor.

This document uses the following terms to describe the output of the power source: voltage level, frequency, phase angle, waveform, current limit, DC voltage level and impedance. Refer to the IviACPwr Terminology topic for more information on these terms.

User-Specified Settings

Current limit—Sets the maximum allowable current the AC power source will deliver. Configure the current limit with the IVIACPWR_ATTR_CURRENT_LIMIT attribute.

Frequency—The frequency of the output AC voltage waveform of the AC power source. Configure the frequency with the IVIACPWR_ATTR_FREQUENCY attribute.

Frequency range—Specifies the output frequency range. AC power sources may support multiple frequency ranges. Configure the frequency range with the IVIACPWR_ATTR_FREQUENCY_RANGE attribute.

Output enabled—Enables/Disables the output contactor/relay of the AC power source. Configure the output enable with the IVIACPWR_ATTR_OUTPUT_ENABLED attribute.

Voltage level—The RMS AC output voltage of the AC power source. Configure the voltage level with the IVIACPWR_ATTR_VOLTAGE_LEVEL attribute.

Voltage Range—Specifies the output voltage range. AC power sources may support multiple voltage ranges to allow greater output voltage or current. Configure the voltage range with the IVIACPWR_ATTR_VOLTAGE_RANGE attribute.

Waveform—The waveform the power source uses to generate the output voltage. Configure the waveform with the IVIACPWR_ATTR_WAVEFORM attribute.

User-Queriable Settings

Frequency range capabilities—Returns the minimum and maximum frequency supported by a particular frequency range.

Number of frequency ranges—Returns the number of supported frequency ranges.

Number of phases—Returns the number of physical output phases.

Number of voltage ranges—Returns the number of supported voltage ranges.

Voltage range capabilities—Returns the minimum and maximum voltages supported by a particular voltage range.

Power Source Voltage and Current Scenarios

The signal that the power source produces depends on the values of the voltage level and current limit that you supply, and the impedance of the load to which the power source is attached. Therefore, the power source might not produce the exact voltage or current that you configure. The following figure shows the possible output scenarios.

At Point 1, the AC power source output has reached the voltage level before it reached the current limit. This is an example of the AC power source operating in the constant voltage mode. The voltage level is defined by the IVIACPWR_ATTR_VOLTAGE_LEVEL attribute.

At Point 2, the AC power source output has reached the current limit before it reached the voltage level. This is an example of the AC power source operating in the constant current mode. The current limit is defined by the CIVIACPWR_ATTR_CURRENT_LIMIT attribute.

At Point 3, the AC power source output is below the under voltage protection limit. If under voltage protection is enabled, the power source disables the output. This mode is controlled by the IviACPwrVoltageProtection Extension Group.

At Point 4, the AC power source output exceeds the over voltage protection limit. If over voltage protection is enabled, the power source disables the output. This mode is controlled by the IviACPwrVoltageProtection Extension Group.

At Point 5, the AC power source output exceeds the current protection threshold. If current protection is enabled and the AC power source output current has reached or exceeds the current protection threshold for the time specified by the current protection delay, the AC power source disables the output. This mode is controlled by the IviACPwrCurrentProtection Extension Group.

IviACPwrBase Functions

IviACPwr_ConfigureCurrentLimit

IviACPwr_ConfigureOutputEnabled

IviACPwr_ConfigureVoltageLevel

IviACPwr_ConfigureVoltageRange

IviACPwr_ConfigureFrequency

IviACPwr_ConfigureFrequencyRange

IviACPwr_ConfigureWaveform

IviACPwr_QueryVoltageCapabilities

IviACPwr_QueryFrequencyRangeCapabilities

IviACPwr_GetOutputPhaseName

IviACPwrBase Attributes

IVIACPWR_ATTR_CURRENT_LIMIT

IVIACPWR_ATTR_FREQUENCY

IVIACPWR_ATTR_NUM_PHASES

IVIACPWR_ATTR_OUTPUT_ENABLED

IVIACPWR_ATTR_VOLTAGE_LEVEL

IVIACPWR_ATTR_WAVEFORM

IVIACPWR_ATTR_NUM_VOLTAGE_RANGES

IVIACPWR_ATTR_VOLTAGE_RANGE

IVIACPWR_ATTR_NUM_FREQUENCY_RANGES

IVIACPWR_ATTR_FREQUENCY_RANGE

IVIACPWR_ATTR_OUTPUT_PHASE_COUNT

Related Topics

IVI Inherent Functions

IVI Inherent Attributes

IviACPwrBase Behavior Model

WAS THIS ARTICLE HELPFUL?

Not Helpful