Routes signals (triggers, clocks, and events) to a specified output terminal.

Syntax

ViStatus __stdcall niRFSG_ExportSignal(ViSession vi, ViInt32 signal, ViConstString signalIdentifier, ViConstString outputTerminal)

Remarks

The NI-RFSG device must be in the Configuration state before you call this function.

You can clear a previously routed signal by exporting the signal to "" (empty string).

Supported Devices:PXIe-5644/5645/5646, PXI/PXIe-5650/5651/5652, PXIe-5653/5654/5654 with PXIe-5696, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841/5842/5860

Related Topics

Triggers

Events

PFI Lines

PXI Trigger Lines

Parameters

NameDirectionTypeDescription
vi[in]ViSession

Identifies your instrument session. The ViSession handle is obtained from the niRFSG_Init function or the niRFSG_InitWithOptions function and identifies a particular instrument session.

signal[in]ViInt32

Specifies the type of signal to route.

Defined Values:

Name

Value

Description

NIRFSG_VAL_CONFIGURATION_LIST_STEP_TRIGGER

6 (0x6)

Exports a Configuration List Step Trigger.

NIRFSG_VAL_CONFIGURATION_SETTLED_EVENT

7 (0x7)

Exports a Configuration Settled Event.

NIRFSG_VAL_DONE_EVENT

5 (0x5)

Exports a Done Event.

NIRFSG_VAL_MARKER_EVENT

2 (0x2)

Exports a Marker Event.

NIRFSG_VAL_REF_CLOCK

3 (0x3)

Exports the Reference Clock.

NIRFSG_VAL_SCRIPT_TRIGGER

1 (0x1)

Exports a Script Trigger.

NIRFSG_VAL_START_TRIGGER

0 (0x0)

Exports a Start Trigger.

NIRFSG_VAL_STARTED_EVENT

4 (0x4)

Exports a Started Event.

signalIdentifier[in]ViConstString

Specifies which instance of the selected signal to export. This parameter is useful when you set the signal parameter to NIRFSG_VAL_SCRIPT_TRIGGER or NIRFSG_VAL_MARKER_EVENT. Otherwise, set the signalIdentifier parameter to "" (empty string).

Defined Values:

Constant

Description

NIRFSG_VAL_SCRIPT_TRIGGER0

Specifies Script Trigger 0

NIRFSG_VAL_SCRIPT_TRIGGER1

Specifies Script Trigger 1

NIRFSG_VAL_SCRIPT_TRIGGER2

Specifies Script Trigger 2

NIRFSG_VAL_SCRIPT_TRIGGER3

Specifies Script Trigger 3

NIRFSG_VAL_MARKER_EVENT0

Specifies Marker 0

NIRFSG_VAL_MARKER_EVENT1

Specifies Marker 1

NIRFSG_VAL_MARKER_EVENT2

Specifies Marker 2

NIRFSG_VAL_MARKER_EVENT3

Specifies Marker 3

"" *(empty string)*

None (no signal to export)

outputTerminal[in]ViConstString

Specifies the terminal where the signal is exported.

You can choose not to export any signal. For the PXIe-5841 with PXIe-5655, the signal is exported to the terminal on the PXIe-5841.

Defined Values:

Name

Value

Description

NIRFSG_VAL_DO_NOT_EXPORT_STR

Does not export a signal.

NIRFSG_VAL_REF_OUT_STR

RefOut

Exports a signal to the REF OUT connector.

NIRFSG_VAL_REF_OUT2_STR

RefOut2

Exports a signal to the REF OUT2 connector, if applicable.

NIRFSG_VAL_CLK_OUT_STR

ClkOut

Exports a signal to the CLK OUT connector.

NIRFSG_VAL_PFI0_STR

PFI0

Exports a signal to the PFI 0 terminal.

NIRFSG_VAL_PFI1_STR

PFI1

Exports a signal to the PFI 1 terminal.

NIRFSG_VAL_PFI4_STR

PFI4

Exports a signal to the PFI 4 terminal.

NIRFSG_VAL_PFI5_STR

PFI5

Exports a signal to the PFI 5 terminal.

NIRFSG_VAL_PXI_TRIG0_STR

PXI_Trig0

Exports a signal to the PXI trigger line 0 terminal.

NIRFSG_VAL_PXI_TRIG1_STR

PXI_Trig1

Exports a signal to the PXI trigger line 1 terminal.

NIRFSG_VAL_PXI_TRIG2_STR

PXI_Trig2

Exports a signal to the PXI trigger line 2 terminal.

NIRFSG_VAL_PXI_TRIG3_STR

PXI_Trig3

Exports a signal to the PXI trigger line 3 terminal.

NIRFSG_VAL_PXI_TRIG4_STR

PXI_Trig4

Exports a signal to the PXI trigger line 4 terminal.

NIRFSG_VAL_PXI_TRIG5_STR

PXI_Trig5

Exports a signal to the PXI trigger line 5 terminal.

NIRFSG_VAL_PXI_TRIG6_STR

PXI_Trig6

Exports a signal to the PXI trigger line 6 terminal.

NIRFSG_VAL_PXI_STAR_STR

PXI_Star

Exports a signal to the PXI star trigger line terminal. This value is not valid for the PXIe-5644/5645/5646.

NIRFSG_VAL_PXIE_DSTARC_STR

PXIe_DStarC

Exports a signal to the PXIe DStar C trigger line terminal. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841/5842/5860.

NIRFSG_VAL_TRIG_OUT_STR

TrigOut

Exports a signal to the TRIG IN/OUT terminal.

NIRFSG_VAL_DIO0_STR

DIO/PFI0

PFI 0 on the front panel DIO connector.

NIRFSG_VAL_DIO1_STR

DIO/PFI1

PFI 1 on the front panel DIO connector.

NIRFSG_VAL_DIO2_STR

DIO/PFI2

PFI 2 on the front panel DIO connector.

NIRFSG_VAL_DIO3_STR

DIO/PFI3

PFI 3 on the front panel DIO connector.

NIRFSG_VAL_DIO4_STR

DIO/PFI4

PFI 4 on the front panel DIO connector.

NIRFSG_VAL_DIO5_STR

DIO/PFI5

PFI 5 on the front panel DIO connector.

NIRFSG_VAL_DIO6_STR

DIO/PFI6

PFI 6 on the front panel DIO connector.

NIRFSG_VAL_DIO7_STR

DIO/PFI7

PFI 7 on the front panel DIO connector.

Returns

Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an instrument driver function to determine if an error occurred. To obtain a text description of the error code, call the niRFSG_GetError function. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors