NI DIGITAL PATTERN DRIVER Conditional Jump Trigger Functions

Conditional Jump Trigger Functions

• niDigital_ConfigureDigitalEdgeConditionalJumpTrigger
• niDigital_ConfigureSoftwareEdgeConditionalJumpTrigger
• niDigital_DisableConditionalJumpTrigger

niDigital_ConfigureDigitalEdgeConditionalJumpTrigger

Configures the conditional jump trigger instance to trigger on an incoming digital edge and routes the specified signal source to the instrument.

C Function Prototype: ViStatus niDigital_ConfigureDigitalEdgeConditionalJumpTrigger (ViSession vi, ViConstString triggerIdentifier, ViConstString source, ViInt32 edge)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
triggerIdentifier	Specifies which instance of the conditional jump trigger you want to override. - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER0 ("conditionalJumpTrigger0") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER1 ("conditionalJumpTrigger1") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER2 ("conditionalJumpTrigger2") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER3 ("conditionalJumpTrigger3")
source	The string identifier for a supported trigger source terminal to route into the instrument for the conditional jump trigger instance. The PXIe-6570/6571 supports triggering through the PXI trigger bus.
edge	Specifies the polarity of the incoming trigger signal that will assert this conditional jump trigger instance. - NIDIGITAL_VAL_RISING_EDGE (1800): Specifies the signal transition from low level to high level. - NIDIGITAL_VAL_FALLING_EDGE (1801): Specifies the signal transition from high level to low level.

Note These defined values for triggerIdentifier are currently not supported for gRPC, instead pass the raw values specified alongside, directly.

Return value: Reports the status of the operation.

niDigital_ConfigureSoftwareEdgeConditionalJumpTrigger

Configures the conditional jump trigger instance to trigger on a software function call. To assert the trigger, use the niDigital_SendSoftwareEdgeTrigger function.

C Function Prototype: ViStatus niDigital_ConfigureSoftwareEdgeConditionalJumpTrigger (ViSession vi, ViConstString triggerIdentifier)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
triggerIdentifier	Specifies which instance of the conditional jump trigger you want to override. - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER0 ("conditionalJumpTrigger0") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER1 ("conditionalJumpTrigger1") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER2 ("conditionalJumpTrigger2") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER3 ("conditionalJumpTrigger3")

Note These defined values are currently not supported for gRPC, instead pass the raw values specified alongside, directly.

Return value: Reports the status of the operation.

niDigital_DisableConditionalJumpTrigger

Disables the conditional jump trigger instance and releases the existing route for the trigger.

C Function Prototype: ViStatus niDigital_DisableConditionalJumpTrigger (ViSession vi, ViConstString triggerIdentifier)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
triggerIdentifier	Specifies which instance of the conditional jump trigger you want to override. - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER0 ("conditionalJumpTrigger0") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER1 ("conditionalJumpTrigger1") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER2 ("conditionalJumpTrigger2") - NIDIGITAL_VAL_CONDITIONAL_JUMP_TRIGGER3 ("conditionalJumpTrigger3")

Note These defined values are currently not supported for gRPC, instead pass the raw values specified alongside, directly.

Return value: Reports the status of the operation.