IVXIBUSSTATUS(3)
HP-UX
NAME
ivxibusststus − obtains VXIbus status information.
SYNOPSIS
#include <sicl.h>
int ivxibusstatus(INST id, int request, int *result);
DESCRIPTION
ivxibusstatus obtains status information about the VXI interface.
This routine will take one of the following values passed in the request parameter and return the answer in the *result parameter.
value meaning
I_VXI_BUS_TRIGGER This will return a bit mask specifying which trigger lines are currently being driven active by some VXI device. This bitmask matches the I_TRIG_TTL*, I_TRIG_EXT*, and I_TRIG_ECL* flags defined in ixtrig(3).
I_VXI_BUS_LADDR This will return in *result the logical address of this device.
I_VXI_BUS_SERVANT_AREA
This will return in *result the servant area size of this device.
I_VXI_BUS_NORMOP This will return in *result a (1) if in normal operation and a (0) otherwise.
I_VXI_BUS_CMDR_LADDR
This will return in *result the logical address of this device’s commander or (-1) if no commander is present (either because this is a top level commander, or normal operation hasn’t been established yet).
I_VXI_BUS_MAN_ID This will return in *result the manufacturer ID of this device.
I_VXI_BUS_MODEL_ID
This will return in *result the model ID of this device.
I_VXI_BUS_PROTOCOL
This will return in *result the value of this device’s protocol register.
I_VXI_BUS_XPROT This will return in *result the value that this device will use to respond to a Read Protocol word-serial command.
I_VXI_BUS_SHM_SIZE This will return in *result the size of VXI memory available on this device. For A24 memory, this value is in 256 byte pages. For A32 memory, this value is in 64K byte pages. The *result should be interpreted as an unsigned integer for this command.
I_VXI_BUS_SHM_ADDR_SPACE
This will return in *result either 24 or 32, depending on whether the device’s VXI memory is located in the A24 or A32 address space respectively.
I_VXI_BUS_SHM_PAGE
This will return in *result the location of the device’s VXI memory. For A24 memory, this value is in 256K byte pages. For A32 memory, this value is in 64K byte pages. The *result should be interpreted as an unsigned integer for this command. This status call is only valid after normal operation has been established.
I_VXI_BUS_VXIMXI This will return in *result a (0) if this device is a VXI device and a (1) if it is a MXI device.
I_VXI_BUS_TRIGSUPP Returns a bit mask of all the fully supported VXI trigger lines that this interface supports. This bit mask is comprised of the logical OR of the I_TRIG_* values supported on this interface.
id is an INST identifier of an iopen VXI device file obtained from an iopen(3) call. This routine only works with interface sessions.
RETURN VALUE
ivxibusstatus returns (0) if successful, or a non-zero error code if an error was encountered.
ERRORS
ivxibusstatus 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_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
ivxibusstatus was developed by HP.
Hewlett-Packard Company — May 05, 1994