Skip to content

NI DCPOWER Event Attributes

Jump to bottom
ni-siray edited this page Apr 21, 2021 · 10 revisions

Event Attributes

NIDCPOWER_ATTR_SOURCE_COMPLETE_EVENT_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150043 ViString R/W Channel None niDCPower_ExportSignalWithChannels

Description

Specifies the output terminal for exporting the Source Complete event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Specify the output terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_SOURCE_COMPLETE_EVENT_PULSE_POLARITY

Specific Attribute

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

Description

Specifies the behavior of the Source Complete event.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

|NIDCPOWER_VAL_ACTIVE_HIGH (1018)|A high pulse occurs when the event is generated. The exported signal is low level both before and after the event is generated

|NIDCPOWER_VAL_ACTIVE_LOW (1019)|A low pulse occurs when the event is generated. The exported signal is high level both before and after the event is generated.| Default Value: NIDCPOWER_VAL_ACTIVE_HIGH

NIDCPOWER_ATTR_SOURCE_COMPLETE_EVENT_PULSE_WIDTH

Specific Attribute

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

Description

Specifies the width of the Source Complete event, in seconds.

The minimum event pulse width value for PXI devices is 150 ns, and the minimum event pulse width value for PXI Express devices is 250 ns.

The maximum event pulse width value for all devices is 1.6 microseconds.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Valid Values: 1.5e-7 to 1.6e-6 seconds

Default Value: The default value for PXI Express devices is 250 ns.

NIDCPOWER_ATTR_MEASURE_COMPLETE_EVENT_OUTPUT_TERMINAL

Specific Attribute

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

Description

Specifies the output terminal for exporting the Measure Complete event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Specify the output terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_MEASURE_COMPLETE_EVENT_DELAY

Specific Attribute

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

Description

Specifies the amount of time to delay the generation of the Measure Complete event, in seconds.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Valid Values: 1.5e-7 to 1.6e-6 seconds

**Default Value:**The PXI-4132, PXIe-4135/4136/4137/4138/4139, and PXIe-4140/4141/4142/4143/4144/4145/4154 support values from 0 seconds to 167 seconds. The PXIe-4147 supports values from 0 seconds to 26.5 seconds. The PXIe-4162/4163 support values from 0 seconds to 23 seconds.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_MEASURE_COMPLETE_EVENT_PULSE_POLARITY

Specific Attribute

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

Description

Specifies the behavior of the Measure Complete event.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

NIDCPOWER_VAL_ACTIVE_HIGH (1018) A high pulse occurs when the event is generated. The exported signal is low level both before and after the event is generated.
NIDCPOWER_VAL_ACTIVE_LOW (1019) A low pulse occurs when the event is generated. The exported signal is high level both before and after the event is generated.
Default Value: NIDCPOWER_VAL_ACTIVE_HIGH

NIDCPOWER_ATTR_MEASURE_COMPLETE_EVENT_PULSE_WIDTH

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150045 ViReal64 R/W Channel Yes N/A

Description

Specifies the width of the Measure Complete event, in seconds.

The minimum event pulse width value for PXI devices is 150 ns, and the minimum event pulse width value for PXI Express devices is 250 ns.

The maximum event pulse width value for all devices is 1.6 microseconds.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Valid Values: 1.5e-7 to 1.6e-6

Default Value: The default value for PXI Express devices is 250 ns.

NIDCPOWER_ATTR_SEQUENCE_ITERATION_COMPLETE_EVENT_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150040 ViString R/W Channel None niDCPower_ExportSignalWithChannels

Description

Specifies the output terminal for exporting the Sequence Iteration Complete event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Specify the output terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_SEQUENCE_ITERATION_COMPLETE_EVENT_PULSE_POLARITY

Specific Attribute

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

Description

Specifies the behavior of the Sequence Iteration Complete event.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

NIDCPOWER_VAL_ACTIVE_HIGH (1018) A high pulse occurs when the event is generated. The exported signal is low level both before and after the event is generated.
NIDCPOWER_VAL_ACTIVE_LOW (1019) A low pulse occurs when the event is generated. The exported signal is high level both before and after the event is generated.
Default Value: NIDCPOWER_VAL_ACTIVE_HIGH

NIDCPOWER_ATTR_SEQUENCE_ITERATION_COMPLETE_EVENT_PULSE_WIDTH

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150039 ViReal64 R/W Channel Yes N/A

Description

Specifies the width of the Sequence Iteration Complete event, in seconds.

The minimum event pulse width value for PXI devices is 150 ns, and the minimum event pulse width value for PXI Express devices is 250 ns.

The maximum event pulse width value for all devices is 1.6 microseconds.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Valid Values: 1.5e-7 to 1.6e-6 seconds

Default Value: The default value for PXI Express devices is 250 ns.

NIDCPOWER_ATTR_SEQUENCE_ENGINE_DONE_EVENT_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150050 ViString R/W Channel None niDCPower_ExportSignalWithChannels

Description

Specifies the output terminal for exporting the Sequence Engine Done Complete event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Specify the output terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_SEQUENCE_ENGINE_DONE_EVENT_PULSE_POLARITY

Specific Attribute

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

Description

Specifies the behavior of the Sequence Engine Done event.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

NIDCPOWER_VAL_ACTIVE_HIGH (1018) A high pulse occurs when the event is generated. The exported signal is low level both before and after the event is generated.
NIDCPOWER_VAL_ACTIVE_LOW (1019) A low pulse occurs when the event is generated. The exported signal is high level both before and after the event is generated.
Default Value: NIDCPOWER_VAL_ACTIVE_HIGH

NIDCPOWER_ATTR_SEQUENCE_ENGINE_DONE_EVENT_PULSE_WIDTH

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150049 ViReal64 R/W Channel Yes N/A

Description

Specifies the width of the Sequence Engine Done event, in seconds.

The minimum event pulse width value for PXI devices is 150 ns, and the minimum event pulse width value for PXI Express devices is 250 ns.

The maximum event pulse width value for all devices is 1.6 microseconds.

Note This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Valid Values: 1.5e-7 to 1.5e-6 seconds

Default Value: The default value for PXI Express devices is 250 ns.

NIDCPOWER_ATTR_PULSE_COMPLETE_EVENT_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150099 ViString R/W Channel None niDCPower_ExportSignal

Description

Specifies the output terminal for exporting the Pulse Complete event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Specify the output terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_PULSE_COMPLETE_EVENT_PULSE_POLARITY

Specific Attribute

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

Description

Specifies the behavior of the Pulse Complete event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

NIDCPOWER_VAL_ACTIVE_HIGH (1018) A high pulse occurs when the event is generated. The exported signal is low level both before and after the event is generated.
NIDCPOWER_VAL_ACTIVE_LOW (1019) A low pulse occurs when the event is generated. The exported signal is high level both before and after the event is generated.
Default Value: NIDCPOWER_VAL_ACTIVE_HIGH

NIDCPOWER_ATTR_PULSE_COMPLETE_EVENT_PULSE_WIDTH

Specific Attribute

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

Description

Specifies the width of the Pulse Complete event, in seconds.

The minimum event pulse width value for PXI Express devices is 250 ns.

The maximum event pulse width value for PXI Express devices is 1.6 microseconds.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_READY_FOR_PULSE_TRIGGER_EVENT_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150102 ViString R/W Channel None niDCPower_ExportSignalWithChannels

Description

Specifies the output terminal for exporting the Ready For Pulse Trigger event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Specify the output terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_READY_FOR_PULSE_TRIGGER_EVENT_PULSE_POLARITY

Specific Attribute

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

Description

Specifies the behavior of the Ready For Pulse Trigger event.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

NIDCPOWER_VAL_ACTIVE_HIGH (1018) A high pulse occurs when the event is generated. The exported signal is low level both before and after the event is generated.
NIDCPOWER_VAL_ACTIVE_LOW (1019) A low pulse occurs when the event is generated. The exported signal is high level both before and after the event is generated.
Default Value: NIDCPOWER_VAL_ACTIVE_HIGH

NIDCPOWER_ATTR_READY_FOR_PULSE_TRIGGER_EVENT_PULSE_WIDTH

Specific Attribute

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

Description

Specifies the width of the Ready For Pulse Trigger event, in seconds.

The minimum event pulse width value for PXI Express devices is 250 ns.

The maximum event pulse width value for all devices is 1.6 microseconds.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Default Value: The default value for PXI Express devices is 250 ns.

Note  To specify a channel name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTR_POWER_SOURCE

Specific Attribute

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

Description

For sessions initialized with deprecated initialize functions, this attribute specifies the power source to use. NI-DCPower switches the power source used by the device to the specified value.

This attribute is not supported in sessions initialized with the niDCPower_InitializeWithIndependentChannels function.

Defined Values:

NIDCPOWER_VAL_INTERNAL (1003) Uses the PXI chassis power source.
NIDCPOWER_VAL_AUXILIARY (1004) Uses the auxiliary power source connected to the device. Only the NI 4110 and NI 4130 support this value.
NIDCPOWER_VAL_AUTOMATIC (1005) Uses the auxiliary power source if it is available; otherwise uses the PXI chassis power source.
Default Value: NIDCPOWER_VAL_AUTOMATIC

Note  Automatic selection is not persistent and occurs only at the time this attribute is set to NIDCPOWER_VAL_AUTOMATIC. However, if the session is in the Committed or Uncommitted state when you set this attribute, the power source selection only occurs after you call the niDCPower_InitiateWithChannels function for all channels in the session

Related Topics:

NI PXI-4110 Internal and Auxiliary Power

NI PXI-4130 Internal and Auxiliary Power

NIDCPOWER_ATTR_POWER_SOURCE_IN_USE

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150001 ViInt32 RO Session None None

Description

Indicates whether the device is using the internal or auxiliary power source to generate power.

Note  This attribute is not supported in sessions initialized with independent channels

Defined Values:

NIDCPOWER_VAL_INTERNAL (1003) Uses the PXI chassis power source.
NIDCPOWER_VAL_AUXILIARY (1004) Uses the auxiliary power source connected to the device. Only the NI PXI-4110, NI PXIe-4112, NI PXIe-4113, and NI PXI-4130 support this value. This is the only supported value for the NI PXIe-4112 and NI PXIe-4113.
Related Topics:

NI PXI-4110 Internal and Auxiliary Power

NI PXI-4130 Internal and Auxiliary Power

NIDCPOWER_ATTR_AUXILIARY_POWER_SOURCE_AVAILABLE

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150002 ViBoolean RO Session None None

Description

Indicates whether an auxiliary power source is connected to the device.

Note  This attribute is not supported in sessions initialized with independent channels

A value of VI_FALSE may indicate that the auxiliary input fuse has blown. Refer to the Detecting Internal/Auxiliary Power topic in the NI DC Power Supplies and SMUs Help for more information about internal and auxiliary power.

Note  This attribute does not necessarily indicate if the device is using the auxiliary power source to generate power. Use the NIDCPOWER_ATTR_POWER_SOURCE_IN_USE attribute to retrieve this information

Related Topics:

NI PXI-4110 Internal and Auxiliary Power

NI PXI-4130 Internal and Auxiliary Power

NIDCPOWER_ATTR_SELF_CALIBRATION_PERSISTENCE

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150073 ViInt32 R/W Instrument None N/A

Description

Specifies whether the values calculated during self-calibration should be written to hardware to be used until the next self-calibration or only used until the niDCPower_ResetDevice function is called or the machine is powered down.

This attribute affects the behavior of the niDCPower_CalSelfCalibrate function. When set to NIDCPOWER_VAL_KEEP_IN_MEMORY, the values calculated by the niDCPower_CalSelfCalibrate function are used in the existing session, as well as in all further sessions until you call the niDCPower_ResetDevice function or restart the machine. When you set this property to NIDCPOWER_VAL_WRITE_TO_EEPROM, the values calculated by the niDCPower_CalSelfCalibrate function are written to hardware and used in the existing session and in all subsequent sessions until another call to the niDCPower_CalSelfCalibrate function is made.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify an instrument name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Defined Values:

NIDCPOWER_VAL_KEEP_IN_MEMORY (1045) Keep new self-calibration values in memory only.
NIDCPOWER_VAL_WRITE_TO_EEPROM (1046) Write new self-calibration values to hardware. Refer to your device documentation for more information about the implications of frequent writes to the EEPROM.
Default Value: NIDCPOWER_VAL_KEEP_IN_MEMORY

NIDCPOWER_ATTR_INTERLOCK_INPUT_OPEN

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150105 ViBoolean RO Instrument None N/A

Description

Indicates whether the safety interlock input is open.

Defined Values:

VI_FALSE (0) Safety interlock input is closed.
VI_TRUE (1) Safety interlock input is open.

Note  This attribute is not supported by all devices. Refer to Supported Attributes by Device for information about supported devices

Note  To specify an instrument name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

Related Topics:

Safety Interlock

Connecting the Safety Interlock

Table of Contents

Home

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally