Table of Contents Previous Chapter Chapter 13: er - Event Receiver

Chapter 13: er - Event Receiver

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.

ER Records

The er record type is used to select the options of a specific event receiver card. In order to properly configure it, you should first be familiar with its operating modes. This is specified in the document "Event System" by Frank Lenksus.

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   GBLCHOICE  Yes  0        Yes     Yes     No         Yes  
TAXI   LONG       No   0        Yes     No      Yes        No   
LTAX   LONG       No   0        Yes     No      No         No   
TRG0   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
TRG1   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
TRG2   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
TRG3   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
TRG4   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
TRG5   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
TRG6   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP0   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP1   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP2   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP3   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP4   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP5   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP6   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP7   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP8   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTP9   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTPA   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTPB   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTPC   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTPD   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL0   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL1   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL2   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL3   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL4   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL5   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
OTL6   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
DGCM   LONG       No   0        Yes     No      No         No   
DG0E   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
DG0D   USHORT     Yes  0        Yes     Yes     No         Yes  
DG0W   USHORT     Yes  0        Yes     Yes     No         Yes  
DG1E   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
DG1D   USHORT     Yes  0        Yes     Yes     No         Yes  
DG1W   USHORT     Yes  0        Yes     Yes     No         Yes  
DG2E   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
DG2D   USHORT     Yes  0        Yes     Yes     No         Yes  
DG2W   USHORT     Yes  0        Yes     Yes     No         Yes  
DG3E   RECCHOICE  Yes  0        Yes     Yes     No         Yes  
DG3D   USHORT     Yes  0        Yes     Yes     No         Yes  
DG3W   USHORT     Yes  0        Yes     Yes     No         Yes  
--------------------------------------------------------------

3. Field Descriptions

---------------------------------------------------------------------------------------
Name  Summary              Description                                                   
---------------------------------------------------------------------------------------
OUT   Output Link          Used to specify which event receiver board is represented     
                           by this record.                                               
ENAB  Master Enable        Master card enable. No events will be received if the card    
                           is disabled.                                                  
TAXI  Taxi Violation Flag  Set to a non-zero value if there is a taxi violation on the   
                           event receiver board.                                         
LTAX  Last Taxi Violation                                                                
TRGn  Trigger Enable       (n=0-6) Trigger event enables. Setting these allows the       
                           corresponding bit to be set on the event receiver.            
OTPn  One Time Pulse       (n=0-D) Setting these allows the corresponding bit to be      
      Enable               set in the event receiver.                                    
OTLn  Output Level         (n=0-6) Output level enables. Setting these allows the        
      Enable               corresponding bit to be set in the event receiver.            
DGCM  Delay Generator                                                                    
      Change Mask                                                                        
DGnE  Delay Generator      (n=1-3) Programmable pulse delay enables.                     
      Enable                                                                             
DGnD  Delay Generator      (n=1-3) Delay value used for the programmable pulse           
      Delay Value          delay outputs. These values must be expressed in 10-mHz       
                           clock periods and has no other selectable resolution.         
DGnW  Delay generator      (n=1-3) Width of the programmable pulse. These values         
      Width Value          must be expressed in 10-mHz clock periods.                    
VAL   Value Field          Not used.                                                     
---------------------------------------------------------------------------------------

4. Record Processing

It is intended that er 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 operating modes of the event receiver and, as such, are processed if and when a value in it is altered by a put operation. 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