Table of Contents Previous Chapter Chapter 14: erevent - Event Receiver Event

Chapter 14: erevent - Event Receiver Event

Advanced Photon Source
Argonne National Laboratory

1. Introduction

The support for the global event system has been designed to allow an application developer to control the APS event generator and receiver boards. This is done by the use of four new record types: eg, egevent, er, erevent. These records are customized and are only supported by the device support modules for the APS event generator and receiver boards.

For more detailed information on the APS event generator and receiver records refer to Chapter 11 on page 69.

EREVENT Records

The erevent records are used to specify what bits are to be set in the event receiver mapping RAM. The use of these bits depend on the which outputs are enabled on the event receiver card (specified in the er record.) Additionally, this record type is used to select the VME interrupt and time-latch option.

2. Field Summary

--------------------------------------------------------------
Field  Type       DCT  Initial  Access  Modify  Rec Proc   PP   
                                                Monitor         
--------------------------------------------------------------
VAL    CHAR       No   0        Yes     No      Yes        No   
OUT    OUTLINK    Yes  0        No      No      No         No   
ENAB   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
ENM    LONG       Yes  0        Yes     Yes     No         Yes  
LENM   LONG       No   0        Yes     No      No         Yes  
LOUT   LONG       No   0        Yes     No      No         Yes  
OUT0   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT1   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT2   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT3   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT4   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT5   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT6   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT7   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT8   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUT9   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUTA   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUTB   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUTC   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OUTD   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
VME    RECCHOICE  Yes  0        Yes     Yes     No         Yes  
--------------------------------------------------------------

3. Field Descriptions

-------------------------------------------------------------------------------------
Name  Summary              Description                                                 
-------------------------------------------------------------------------------------
OUT   Output Link          Specifies the card containing the mapping RAM to be         
                           programmed.                                                 
ENAB  Event Enable         Enables the operation of this record. If this is set to     
                           `Disabled', then the values in the record are ignored.      
ENM   Event Number         The event number to be described. This indicates the        
                           position in the mapping RAM that is to be programmed.       
LENM  Last Event Number                                                                
LOUT  Last Output Enable                                                               
      Mask                                                                             
OUTn  Output Enable        (n=0-D) May be set to `Enable' or `Disable' in order        
                           to set or clear the corresponding bit in the mapping RAM.   
                           The meanings of these bits depend on what outputs are       
                           enabled on the event receiver board (selected in the        
                           related er record) and are described in the document        
                           "Event System" by Frank Lenksus.                            
VME   VME Interrupt        May be set to `Enable' or `Disable' in order to select a    
      Enable               VME interrupt upon the occurrence of event ENM. The         
                           time is automatically latched when the VME interrupt is     
                           generated.                                                  
VAL   Value Field          Not used.                                                   
-------------------------------------------------------------------------------------

4. Record Processing

It is intended that erevent records be set to passive processing only. They are not altered by the device support code in response to being processed. Their purpose is only to specify the desired actions to be performed upon receipt of a specific event code. To start things going, however, they should have their `process at init' flag set to YES.

5. Device Support

The device support for the event receiver may be used by er, erevent and event record types.

In order to configure the event receiver device support, a call must be made to set the address for each of the event receiver cards present in the IOC. This configuration call is as follows:

  ErConfigure(<card>, <A16 board address>, <IRQ Vector>, <IRQ Level>)
Where <card> is the card to be configured, <A16 board address> is the 16-bit address of the board in A16 space, <IRQ Vector> is the vector number to use when generating VME interrupts, and <IRQ Level> is the VME backplane.
Table of Contents Next Chapter