NI DCPOWER Current Attributes - ni/grpc-device GitHub Wiki

Current Attributes

NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150009 ViReal64 R/W Channel None niDCPower_ConfigureCurrentLevel

Description

Specifies the current level, in amps, that the device attempts to generate on the specified channel(s).

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

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

Valid Values: The valid values for this attribute are defined by the values to which the NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_RANGE attribute is set.

Related Topics:

Constant Current Mode

NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_RANGE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150011 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_ATTRIBUTE_CURRENT_LEVEL_AUTORANGE attribute to enable automatic selection of the current level range.

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

Note  The channel must be enabled for the specified current level range to take effect. Refer to the NIDCPOWER_ATTRIBUTE_OUTPUT_ENABLED attribute for more information about enabling the output channel. For valid ranges, refer to the ranges topic for your device in the NI DC Power Supplies and SMUs Help.

Related Topics:

Ranges

NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_AUTORANGE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150017 ViInt32 R/W Channel None None

Description

Specifies whether NI-DCPower automatically selects the current level range based on the desired current level for the specified channel(s).

If you set this attribute to NIDCPOWER_VAL_ON, NI-DCPower ignores any changes you make to the NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_RANGE attribute. If you change the NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_AUTORANGE attribute from NIDCPOWER_VAL_ON to NIDCPOWER_VAL_OFF, NI-DCPower retains the last value the NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_RANGE attribute was set to (or the default value if the attribute was never set) and uses that value as the current level range.

Query the NIDCPOWER_ATTRIBUTE_CURRENT_LEVEL_RANGE attribute by using the niDCPower_GetAttributeViInt32 function for information about which range NI-DCPower automatically selects.

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

Defined Values:

NIDCPOWER_VAL_OFF (0) NI-DCPower does not automatically select the current level range.
NIDCPOWER_VAL_ON (1) NI-DCPower automatically selects the current level range.
Default Value:

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

Related Topics:

Ranges

NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150010 ViReal64 R/W Channel None niDCPower_ConfigureVoltageLimit

Description

Specifies the voltage limit, in volts, that the output cannot exceed when generating the desired current level on the specified channels.

The limit is specified as a positive value, but symmetric positive and negative limits are enforced simultaneously.

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT and the NIDCPOWER_ATTRIBUTE_COMPLIANCE_LIMIT_SYMMETRY attribute is set to NIDCPOWER_VAL_SYMMETRIC.

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

Valid Values: The valid values for this attribute are defined by the values to which the NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE attribute is set.

Related Topics:

Compliance

NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_HIGH

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150185 ViReal64 R/W Channel None None

Description

Specifies the maximum voltage, in volts, that the output can produce when generating the desired current on the specified channel(s).

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_COMPLIANCE_LIMIT_SYMMETRY attribute is set to NIDCPOWER_VAL_ASYMMETRIC and the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

You must also specify NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_LOW to complete the asymmetric range.

Note  The channel must be enabled and the output relay must be connected for the specified limit to take effect. Refer to the NIDCPOWER_ATTRIBUTE_OUTPUT_ENABLED attribute and the NIDCPOWER_ATTRIBUTE_OUTPUT_CONNECTED attribute for more information about enabling the output channel and connecting the output relay respectively.

Note  Refer to Supported Attributes by Device for information about supported devices.

Valid Values: 1% of NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE, NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE

  • The range bounded by the limit high and limit low must include zero.

Note  The limit may be extended beyond the selected limit range if the NIDCPOWER_ATTRIBUTE_OVERRANGING_ENABLED attribute is set to VI_TRUE.| | :- | :- | Default Value: Refer to Supported Attributes by Device for the default value by device.

Related Topics:

Ranges

Changing Ranges

Overranging

NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_LOW

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150186 ViReal64 R/W Channel None None

Description

Specifies the minimum voltage, in volts, that the output can produce when generating the desired current on the specified channel(s).

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_COMPLIANCE_LIMIT_SYMMETRY attribute is set to NIDCPOWER_VAL_ASYMMETRIC and the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

You must also specify NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_HIGH to complete the asymmetric range.

Note  The channel must be enabled and the output relay must be connected for the specified limit to take effect. Refer to the NIDCPOWER_ATTRIBUTE_OUTPUT_ENABLED attribute and the NIDCPOWER_ATTRIBUTE_OUTPUT_CONNECTED attribute for more information about enabling the output channel and connecting the output relay respectively.

Note  Refer to Supported Attributes by Device for information about supported devices.

Valid Values: -NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE, -1% of NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE

  • The range bounded by the limit high and limit low must include zero.

Note  The limit may be extended beyond the selected limit range if the NIDCPOWER_ATTRIBUTE_OVERRANGING_ENABLED attribute is set to VI_TRUE.| | :- | :- | Default Value: Refer to Supported Attributes by Device for the default value by device.

Related Topics:

Ranges

Changing Ranges

Overranging

NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150012 ViReal64 R/W Channel Yes niDCPower_ConfigureVoltageLimitRange

Description

Specifies the voltage limit range, in volts, for the specified channel(s).

The range defines the valid values to which the voltage limit can be set. Use the NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_AUTORANGE attribute to enable automatic selection of the voltage limit range.

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

Note  The channel must be enabled for the specified voltage limit range to take effect. Refer to the NIDCPOWER_ATTRIBUTE_OUTPUT_ENABLED attribute for more information about enabling the output channel. For valid ranges, refer to the Ranges topic for your device in the NI DC Power Supplies and SMUs Help.

Related Topics:

Ranges

NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_AUTORANGE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High-Level Functions
1150018 ViInt32 R/W Channel None None

Description

Specifies whether NI-DCPower automatically selects the voltage limit range based on the desired voltage limit for the specified channel(s).

If this attribute is set to NIDCPOWER_VAL_ON, NI-DCPower ignores any changes you make to the NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE attribute. If you change the NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_AUTORANGE attribute from NIDCPOWER_VAL_ON to NIDCPOWER_VAL_OFF, NI-DCPower retains the last value the NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE attribute was set to (or the default value if the attribute was never set) and uses that value as the voltage limit range.

Query the NIDCPOWER_ATTRIBUTE_VOLTAGE_LIMIT_RANGE attribute by using the niDCPower_GetAttributeViInt32 function to find out which range NI-DCPower automatically selects.

This attribute is applicable only if the NIDCPOWER_ATTRIBUTE_OUTPUT_FUNCTION attribute is set to NIDCPOWER_VAL_DC_CURRENT.

Defined Values:

NIDCPOWER_VAL_OFF (0) NI-DCPower does not automatically select the voltage limit range.
NIDCPOWER_VAL_ON (1) NI-DCPower automatically selects the voltage limit range.

Default Value:

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

Related Topics:

Ranges

⚠️ **GitHub.com Fallback** ⚠️