NI DIGITAL PATTERN DRIVER Conditional Jump Trigger Functions - ni/grpc-device GitHub Wiki

Conditional Jump Trigger Functions

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.

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