Agilent Technologies E1437A User Manual page 89

E1437A User's Guide
VXI plug&play Programming Reference
hpe1437_interrupt_setup
hpe1437_interrupt_setup sets both interrupt parameters. This description also
includes information on the following functions which query the interrupt
parameters individually:
hpe1437_interrupt_mask_get gets the interrupt event mask
hpe1437_interrupt_priority_get gets the VME interrupt line
VXIplug&play Syntax
#include "hpe1437.h"
ViStatus hpe1437_interrupt_setup(ViSession id, ViInt16 intrNum, ViInt16 priority,
ViInt16 mask);
ViStatus hpe1437_interrupt_mask_get(ViSession id, ViInt16 intrNum, ViPInt16
maskPtr);
ViStatus hpe1437_interrupt_priority_get(ViSession id, ViInt16 intrNum, ViPInt16
priorityPtr);
Description
An E1437 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.
hpe1437_interrupt_setup sets the interrupt mask, priority and which of the two
interrupt generators on the E1437 is to be used. The remaining hpe1437_interrupt_
functions query the mask and priority individually:
Parameters
id is the VXI instrument session pointer returned by the hpe1437_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. This mask is created by
ORing together the bits defined in bits 8 through 15 of the status register. The mask
parameter format is 0xMM00 where MM represents the maskable upper 8 bits. The
lower 8 bits cannot be used for generating interrupts, and therefore must be set to zero
in this function call.
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 and priorityPtr contain the current value of the either the interrupt mask or
priority parameter.
Comments
The mask is cleared during the interrupt acknowledge cycle. Therefore, the command
must be sent again or restored with hpe1437_interrupt_restore in order to generate
further interrupts.
Example
The program interupt.exe described in Example Programs provides an example of
how to use interrupts correctly.
Reset Values
priority
4-42
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
0