NIDCPOWER_ATTR_CURRENT_LEVEL_RANGE

NI-DCPower Function Reference

NIDCPOWER_ATTR_CURRENT_LEVEL_RANGE

Specific Attribute

Data
type
Access Applies to Coercion High-Level Functions
ViReal64 R/W Channel Yes niDCPower_ConfigureCurrentLevelRange

Description

Specifies the current level range, in amps, for the specified channel(s). The range defines the valid value to which the current level can be set. Use the NIDCPOWER_ATTR_CURRENT_LEVEL_AUTORANGE attribute to enable automatic selection of the current level range.

The NIDCPOWER_ATTR_CURRENT_LEVEL_RANGE attribute is applicable only if the NIDCPOWER_ATTR_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

The channel must be enabled for the specified current level range to take effect. Refer to the NIDCPOWER_ATTR_OUTPUT_ENABLED attribute for more information about enabling the output channel.

Valid Values:

NI PXI-4110

ChannelCurrent Level RangeCurrent Level
01 A+0.01 to +1 A
120 mA+0.20 to +20 mA
1 A+0.01 to +1 A
220 mA-0.20 to -20 mA
1 A-0.01 to -1 A

NI PXI-4130

ChannelCurrent Level RangeCurrent Level
01 A+0.02 to +1 A
1200 μA +4 to +200 μA and -4 to -200 μA
2 mA+0.04 to +2 mA and -0.04 to -2 mA
20 mA+0.40 to +20 mA and -0.40 to -20 mA
200 mA+4 to +200 mA and -4 to -200 mA
2 A+0.04 to +2 A and -0.04 to -2 A
Note Note   If a range other than what is listed in the preceding table is selected, it will be coerced to the next-highest range. For example, requesting the 100 mA current level range on Channel 1 on the NI-PXI 4130 coerces the current level to the 200 mA current level range. Refer to the Ranges topic in the NI DC Power Supplies and SMUs Help for more information about coercion.