niScope_ExportSignal

NI High-Speed Digitizers Help (NI-SCOPE)

Edition Date: January 2017

Part Number: 370592AB-01

View Product Info

DOWNLOAD (Windows Only)


NI-SCOPE (English | Japanese)

C Function Prototype

ViStatus niScope_ExportSignal (ViSession vi, ViInt32 signal, ViConstString signalIdentifier, ViConstString outputTerminal);

Purpose

Note  This function replaces niScope_ConfigureTriggerOutput.

Configures the digitizer to generate a signal that other devices can detect when configured for digital triggering or sharing clocks. The signal parameter specifies what condition causes the digitizer to generate the signal. The outputTerminal parameter specifies where to send the signal on the hardware (such as a PFI connector or RTSI line).

In cases where multiple instances of a particular signal exist, use the signalIdentifier input to specify which instance to control. For normal signals, only one instance exists and you should leave this parameter set to the empty string. You can call this function multiple times and set each available line to a different signal.

To unprogram a specific line on device, call this function with the signal you no longer want to export and set outputTerminal to NISCOPE_VAL_NONE.

Related topics:

Parameters

Input
Name Type Description
vi ViSession The instrument handle you obtain from niScope_init that identifies a particular instrument session.
signal ViInt32 Signal (clock, trigger, or event) to export.

Defined Values

NISCOPE_VAL_REF_TRIGGER(1)Generate a pulse when detecting the Stop/Reference trigger.
NISCOPE_VAL_START_TRIGGER (2)Generate a pulse when detecting a Start trigger.
NISCOPE_VAL_END_OF_ACQUISITION_EVENT(3)Generate a pulse when the acquisition finishes.
NISCOPE_VAL_END_OF_RECORD_EVENT (4)Generate a pulse at the end of the record.
NISCOPE_VAL_ADVANCE_TRIGGER (5)Generate a pulse when detecting an Advance trigger.
NISCOPE_VAL_READY_FOR_ADVANCE_EVENT (6)Asserts when the digitizer is ready to advance to the next record.
NISCOPE_VAL_READY_FOR_START_EVENT (7)Asserts when the digitizer is initiated and ready to accept a Start trigger and begin sampling.
NISCOPE_VAL_READY_FOR_REF_EVENT (10)Asserts when the digitizer is ready to accept a Reference trigger.
NISCOPE_VAL_REF_CLOCK (100) Export the Reference clock for the digitizer to the specified terminal.
NISCOPE_VAL_SAMPLE_CLOCK (101)Export the Sample clock for the digitizer to the specified terminal.
NISCOPE_VAL_5V_OUT (13)Exports a 5 V power supply.
signalIdentifier ViConstString Describes the signal being exported.
outputTerminal ViConstString Identifies the hardware signal line on which the digital pulse is generated.

Defined Values

NISCOPE_VAL_RTSI_0 ("VAL_RTSI_0")
NISCOPE_VAL_RTSI_1("VAL_RTSI_1")
NISCOPE_VAL_RTSI_2("VAL_RTSI_2")
NISCOPE_VAL_RTSI_3 ("VAL_RTSI_3")
NISCOPE_VAL_RTSI_4("VAL_RTSI_4")
NISCOPE_VAL_RTSI_5 ("VAL_RTSI_5")
NISCOPE_VAL_RTSI_6("VAL_RTSI_6")
NISCOPE_VAL_RTSI_7("VAL_RTSI_7")
NISCOPE_VAL_PXI_STAR("VAL_PXI_STAR")
NISCOPE_VAL_PFI_0("VAL_PFI_0")
NISCOPE_VAL_PFI_1("VAL_PFI_1")
NISCOPE_VAL_PFI_2("VAL_PFI_2")
NISCOPE_VAL_CLK_OUT("VAL_CLK_OUT")

Return Value

Name Type Description
Status ViStatus Reports the status of this operation. To obtain a text description of the status code, call niScope_GetErrorMessage. To obtain additional information concerning the error condition, use niScope_GetError and niScope_ClearError. The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

WAS THIS ARTICLE HELPFUL?

Not Helpful