NIDIGITAL_ATTR_SELECTED_FUNCTION

Download PDF

Updated2023-11-24
2 minute(s) read

Specific Attribute:

Numeric Value	1150004
Datatype	ViInt32
Access	R/W
Applies to	Channel
Coercion	None
High-level Functions	niDigital_SelectFunction

Description:

Specifies whether digital pattern instrument channels are controlled by the pattern sequencer or PPMU, disconnected, or off.

Defined Values:

NIDIGITAL_VAL_DIGITAL (1100)

The pin is connected to the driver, comparator, and active load functions. The PPMU is not sourcing, but can make voltage measurements. The state of the digital pin driver when you change the selected function to Digital is determined by the most recent call to the niDigital_WriteStatic function or the last vector of the most recently executed pattern burst, whichever happened last.

Use the niDigital_WriteStatic function to control the state of the digital pin driver through software. Use the niDigital_BurstPattern function to control the state of the digital pin driver through a pattern. Set the selectDigitalFunction parameter of the niDigital_BurstPattern function to VI_TRUE to automatically switch the selected function of the pins in the pattern burst to NIDIGITAL_VAL_DIGITAL.

NIDIGITAL_VAL_PPMU (1101)

The pin is connected to the PPMU. The driver, comparator, and active load are off while this function is selected.

Call the niDigital_PPMU_Source function to source a voltage or current. The niDigital_PPMU_Source function automatically switches the selected function to the PPMU state and starts sourcing from the PPMU. Changing the selected function to NIDIGITAL_VAL_DISCONNECT, NIDIGITAL_VAL_OFF, or NIDIGITAL_VAL_DIGITAL causes the PPMU to stop sourcing.

If you change the selected function to PPMU using the niDigital_SelectFunction function, the PPMU is initially not sourcing.

Note You can make PPMU voltage measurements using the niDigital_PPMU_Measure function from within any selected function.

NIDIGITAL_VAL_OFF (1102)

The pin is electrically connected, and the PPMU and digital pin driver are off while this function is selected.

NIDIGITAL_VAL_DISCONNECT (1103)

The pin is electrically disconnected from instrument functions. Selecting this function causes the PPMU to stop sourcing prior to disconnecting the pin.

Caution In the Disconnect state, some I/O protection and sensing circuitry remains exposed. Do not subject the instrument to voltage beyond its operating range.

NIDIGITAL_VAL_RIO (1104)

Yields control of the specified pin(s) to LabVIEW FPGA.

Parent topic: NI-Digital Pattern Driver C Function Reference

Related reference

niDigital_BurstPattern

niDigital_PPMU_Source