IVXITRIGROUTE(3)
HP-UX
NAME
ivxitrigroute − routes vxi trigger facilities.
SYNOPSIS
#include <sicl.h>
int ivxitrigroute(
INST id,
unsigned long in_which,
unsigned long out_which
);
DESCRIPTION
ivxitrigroute routes the VXI trigger lines, clocks, and panel connectors.
id is an INST identifier of an iopen VXI device file obtained from an iopen(3) call. This routine only works on interface sessions.
The in_which and out_which parameters have the same possible values as the ixtrig routine. In addition, the following values can be used with the in_which parameter:
I_TRIG_CLK0
I_TRIG_CLK1
I_TRIG_CLK2
The I_TRIG_CLK* refer to clocks internal to the controller (for example, a system clock, or an implementation specific clocking mechanism).
This function routes the in_which lines to the out_which lines. Any line set in the in_which parameter will be routed to all lines in the out_which parameter.
If a trigger line specified in in_which has already been routed, the old route is lost and the new route (to out_which) is used in its place.
If out_which is zero (0), then all routing for the trigger lines specified in in_which is canceled.
NOTE: The primary use for ivxitrigroute is to route external trigger lines to internal trigger lines. You must see your hardware guide to see if a particular routing combination is supported.
RETURN VALUE
ivxitrigroute returns (0) for success and a non-zero error code otherwise.
ERRORS
ivxitrigroute fails under the following circumstances, and sets the return value to one of the following:
[I_ERR_BADID] id does not refer to an open INST, or a valid VXI INST id.
[I_ERR_IO] remote device generated a word-serial error (see above).
[I_ERR_PARAM] parameter contains an invalid value.
[I_ERR_BADADDR] id refers to a device that is not present, or is not a message-based device.
[I_ERR_TIMEOUT] A timeout occured.
SEE ALSO
AUTHOR
ivxitrigroute was developed by HP.
Hewlett-Packard Company — September 29, 1999