niRFSA_ExportSignal
- Updated2024-05-08
- 3 minute(s) read
niRFSA_ExportSignal
ViStatus niRFSA_ExportSignal(ViSession vi, ViInt32 signal, ViConstString signalIdentifier, ViConstString outputTerminal);
Purpose
Routes signals (triggers, clocks, and events) to the specified output terminal.
If you export a signal with this function and commit the session, the signal is routed to the output terminal you specify. If you then reconfigure the signal to have a different output terminal, the previous output terminal is tri-stated when the session is next committed. If you set the outputTerminal parameter to NIRFSA_VAL_DO_NOT_EXPORT and commit, the previous output terminal is tristated.
Any signals, except for those exported over PXI trigger lines, that are exported within a session persist after the session closes to prevent signal glitches between sessions. PXI trigger lines are always set to tristate when a session is closed. If you wish to have the output terminal tristated when the session closes, change the outputTerminal for the exported signal to NIRFSA_VAL_DO_NOT_EXPORT, and commit the session again before closing it.
You can also tristate all PFI lines by setting the resetDevice parameter in the niRFSA_init function to VI_TRUE or by using the niRFSA_reset function.
Supported Devices: PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5694, PXIe-5820/5830/5831/5832/5840/5841/5842
Parameters
| Input | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||
| vi | ViSession | Identifies your instrument session. vi is obtained from the niRFSA_init or niRFSA_InitWithOptions function. | ||||||||||||||||||||||||||||||||||||||||||||||||
| signal | ViInt32 | Specifies the type of signal to route.
| ||||||||||||||||||||||||||||||||||||||||||||||||
| signalIdentifier | ViConstString | Specifies the user-defined signal to route. Specify the signal you have implemented using FPGA extensions. | ||||||||||||||||||||||||||||||||||||||||||||||||
| outputTerminal | ViConstString | Specifies the terminal where the signal will be exported. You can also choose not to export any signal. For the PXIe-5841 with PXIe-5655, the signal is exported to the terminal on the PXIe-5841.
|
||||||||||||||||||||||||||||||||||||||||||||||||
Return Value
| Name | Type | Description | ||||||||
| status | ViStatus | 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 NI-RFSA function to determine if an error has occurred. To obtain a text description of the status code and additional information about the error condition, call the niRFSA_GetError function. To clear the error information from NI-RFSA, call the niRFSA_ClearError function. The general meaning of the status code is as follows:
|
||||||||