2.1 Code Structure

 

The Sili-Farm sees all data being transmitted over the Silicon VMEtaxi fibre optic ring. These data already have their BOS bank structure. The following banks may be present:

• SDAQ: SiDAQ Header bank
• SIRS: Run Start Record
• SIFE: Silicon Front End data
• SICD: Silicon Calibration data
• additional banks with trigger data coming from the readout of the BST pad detectors

An incoming event is directed to a free buffer in the RAID memory by the FIC. The RAID then processes the data and fills histograms. For this purpose, the code running on the RAID boards has been split into two levels:

1. the main task dealing with the initialization of the board and the handling of run starts and -stops with the functions (names are pretty self-explaining):
   • RAIDinit()
   • WaitForRun()
   • RAIDrun()
   • DoEndRun()
   • RAIDanal( ...)
2. the user task consisting of three functions:
   • AnalInit() - called from WaitForRun when run has started
   • AnalEvent() - called from RaidAnal on every event
   • AnalTerm() - called from DoEndRun when run terminates

   These three functions are freely programmable to do whatever you like with the data.

Additional information (all you need...) is delivered by means of a global structure AnalRecord with the following entries:

• EventNumber
• RunNumber
• DAQmode
• Sysmode
• RunParams - a structure containing:
  • SiDAQSpec - parameter block with SiDAQ system settings
  • SiBitPat[4] - mask of modules in readout
  • 14 words to be set from the Macintosh (see Sec. 3) and to be used as program steering options
• thisBuf - which buffer is being processed
• freeBytes - free space for anything
• freeAddress - Start of free memory
• *PedAddress - Address of local pedestals
• *SigmaAddress - Address of local Sigmas
• *HitsOutBuf - Address of o/p hit buffer
• debugFlag
• *EventPtr - Event Address
• *SDAQPtr - Header Bank
• *SIRSPtr - Run-Start Record
• *SIFEPtr[kMaxCrates] - Front-End Data
• *SICDPtr[kMaxCrates] - Calibration data
• *BILLPtr - BILL Banks

The AnalRecord is filled by the main task: you can just use it.