Agilent Technologies E1439 Network Card User Manual


 
146
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_interrupt_setup
Sets both interrupt parameters. This description also includes information on the following
functions which query the interrupt parameters individually:
age1439_interrupt_mask_get gets the interrupt event mask
age1439_interrupt_priority_get gets the VME interrupt line
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_interrupt_setup(ViSession id,ViInt16intrNum,ViInt16priority,ViInt16
mask);
ViStatus age1439_interrupt_mask_get(ViSession id,ViInt16intrNum,ViPInt16maskPtr);
ViStatus age1439_interrupt_priority_get(ViSession id,ViInt16intrNum,ViPInt16
priorityPtr);
Description
An Agilent E1439 has two independent interrupt generators, each capable of interrupting on one
of the seven VME interrupt lines when a status condition specified by a mask occurs.
age1439_interrupt_setup sets the interrupt mask, priority and which of the two interrupt
generators on the Agilent E1439 is to be used. The remaining age1439_interrupt_ functions
query the mask and priority individually.
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
intrNum is the number of the interrupt generator. The only values accepted are 0 and 1.
mask specifies the mask of events on which to interrupt. VXIbus specifications only allow the 8 most
significant bits in the status register, bits 8 to 15, to be set as interrupts. Because of this, the
desired mask value must be right shifted 8 positions. In the E1439, bits 14 and 15 of the status
register cannot be used to generate interrupts, effectively leaving only 6 bits, 8 through 13, to
generate interrupts.
priority specifies which of the seven VME interrupt lines to use. The only legal values are 0 through 7.
Specifying 0 turns the interrupt off, while 7 is the highest priority.
maskPtr priorityPtr contain the current value of the interrupt mask and priority parameters.
Comments
Interrupt masks are cleared during the interrupt acknowledge cycle. Therefore, the command
must be sent again or restored with “age1439_interrupt_restore” on page 145 in order to generate
further interrupts.
Example
The program interrupt.exe described in the example programs provides an example of how to use
interrupts correctly.