Determines whether the device sources the power its output configuration requires or a specific wattage you request; determines whether NI-DCPower proactively checks that this sourcing power is within the maximum per-channel and overall sourcing power of the device.

Syntax

NIDCPOWER_ATTR_POWER_ALLOCATION_MODE

Numeric Value

Data Type

Access

Applies To

1150207

ViInt32

Read/Write

Channels

Remarks


When this attribute configures NI-DCPower to perform a sourcing power check, a device is not permitted to source power in excess of its maximum per-channel or overall sourcing power. If the check determines an output configuration or power request would require the device to do so, NI-DCPower returns an error.

When this attribute does not configure NI-DCPower to perform a sourcing power check, a device complies with requests to source power in excess of its maximum per-channel or overall sourcing power and may shut down to prevent damage.

Note

NI-DCPower uses the terms "source" and "output". However, while sinking with electronic loads and SMUs these correspond to "sinking" and "input", respectively.

Note

This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices. Devices that do not support this attribute behave as if this attribute were set to NIDCPOWER_VAL_POWER_ALLOCATION_MODE_DISABLED.

Defined Values:

Name

Value

Description

NIDCPOWER_VAL_POWER_ALLOCATION_MODE_DISABLED

1058 (0x422)

The device attempts to source, on each active channel, the power that the present source configuration requires; NI-DCPower does not perform a sourcing power check. If the required power is greater than the maximum sourcing power, the device attempts to source the required amount and may shut down to prevent damage.

NIDCPOWER_VAL_POWER_ALLOCATION_MODE_AUTOMATIC

1059 (0x423)

The device attempts to source, on each active channel, the power that the present source configuration requires; NI-DCPower performs a sourcing power check. If the required power is greater than the maximum sourcing power, the device does not exceed the maximum power, and NI-DCPower returns an error.

NIDCPOWER_VAL_POWER_ALLOCATION_MODE_MANUAL

1060 (0x424)

The device attempts to source, on each active channel, the power you request with the NIDCPOWER_ATTR_REQUESTED_POWER_ALLOCATION attribute; NI-DCPower performs a sourcing power check. If the requested power is either less than the required power for the present source configuration or greater than the maximum sourcing power, the device does not exceed the requested or allowed power, respectively, and NI-DCPower returns an error.

Default Value: Refer to Supported Attributes by Device for the default value by device.