viMapTrigger
Purpose
Map the specified trigger source line to the specified destination line.
C Syntax
viStatus viMapTrigger(ViSession vi, ViInt16 trigSrc, ViInt16 trigDest,ViUInt16 mode)
Visual Basic Syntax
viMapTrigger& (ByVal vi&, ByVal trigSrc%, ByVal trigDest%, ByVal mode%)
Resource Classes
GPIB-VXI BACKPLANE, PXI BACKPLANE, VXI BACKPLANE
Parameters
| Name | Direction | Description |
|---|---|---|
|
vi |
IN |
Unique logical identifier to a session. |
|
trigSrc |
IN |
Source line from which to map. Refer to the Description section for actual values. |
|
trigDest |
IN |
Destination line to which to map. Refer to the Description section for actual values. |
|
mode |
IN |
VI_NULL |
Return Values
| Completion Codes | Description |
|---|---|
|
VI_SUCCESS |
Operation completed successfully. |
|
VI_SUCCESS_TRIG_MAPPED |
The path from trigSrc to trigDest is already mapped. |
| Error Codes | Description |
|---|---|
|
VI_ERROR_INV_OBJECT |
The given session reference is invalid. |
|
VI_ERROR_NSUP_OPER |
The given vi does not support this operation. |
|
VI_ERROR_RSRC_LOCKED |
Specified operation could not be performed because the resource identified by vi has been locked for this kind of access. |
|
VI_ERROR_TMO |
Timeout expired before operation completed. |
|
VI_ERROR_INV_MODE |
The value specified by the mode parameter is invalid. |
|
VI_ERROR_LINE_IN_USE |
One of the specified lines (trigSrc or trigDest) is currently in use. |
|
VI_ERROR_INV_LINE |
One of the specified lines (trigSrc or trigDest) is invalid. |
|
VI_ERROR_NSUP_LINE |
One of the specified lines (trigSrc or trigDest) is not supported by this VISA implementation. |
Description
This operation can be used to map one trigger line to another. This operation is valid only on BACKPLANE (mainframe) sessions.
| Value | Action Description |
|---|---|
|
VI_TRIG_TTL0 - VI_TRIG_TTL7 |
Map the specified VXI or PXI TTL trigger line. |
|
VI_TRIG_ECL0 - VI_TRIG_ECL1 |
Map the specified VXI ECL trigger line. |
|
VI_TRIG_PANEL_IN |
Map the controller's front panel trigger input line. |
|
VI_TRIG_PANEL_OUT |
Map the controller's front panel trigger output line. |
If this operation is called multiple times on the same BACKPLANE Resource with the same source trigger line and different destination trigger lines, the result will be that when the source trigger line is asserted, all of the specified destination trigger lines will also be asserted. If this operation is called multiple times on the same BACKPLANE Resource with different source trigger lines and the same destination trigger line, the result will be that when any of the specified source trigger lines is asserted, the destination trigger line will also be asserted.
 |
Note Mapping a trigger line (as either source or destination) multiple times requires special hardware capabilities and is not guaranteed to be implemented. |
Refer to VI_ATTR_PXI_SRC_TRIG_BUS or VI_ATTR_PXI_DEST_TRIG_BUS for information about how to map a trigger between bus segments in a multisegment PXI chassis.
Related Topics