#include <fe4event.h>

Inheritance diagram for FE4event:

Public Member Functions

FE4event (hw4::SubrackAuger *s)
void read (int page, unsigned long *data)
void read (int page, int start, unsigned long *data)
void readMultiplicity (int page, unsigned short *data)
void readMultiplicity (int page, int start, unsigned short *data)
void readSltPage (int pageStartOffset, unsigned long *data)
void readMultiplicityPage (int pageStartOffset, unsigned long *data)
int getActualPage ()
int getNextPage ()
virtual int getNumFreePages ()
virtual int getOldestPage ()
bool isInUse (int page)
void isInUse (unsigned long *status)
virtual bool isPageReady ()
virtual void resetPages ()
void setPageFree (int page)
void setPageInUse (int page)
unsigned long getTimeStampHigh (int page)
unsigned long getTimeStampLow (int page)
void getTimeStamp (int page, unsigned long *sec, int *subSec1, int *subSec2, int *imgAddr, int *evtAddr, int *trigger=0)
void getTimeStamp (int page, FE4timeStamp *timeStamp)
unsigned long getLastTriggerTimeStampLow (int page)
int getTriggerSource ()
void setTriggerSource (int source)
void enableNeighborTrig ()
void disableNeighborTrig ()
bool isEnabledNeighborTrig ()
void forceTrigger ()
void enableLeftNeighborTrig ()
void enableRightNeighborTrig ()
void disableLeftNeigborTrig ()
void disableRightNeighborTrig ()
bool isEnabledLeftNeigborTrig ()
bool isEnabledRightNeighborTrig ()
int getNextPageDelay ()
void setNextPageDelay (int delay)
int getCoincidenceTime ()
void setCoincidenceTime (int time)
int getLengthOfBoxcar (int col=0, int fpga=1)
int waitForNextPage ()
void disableNextPage ()
void enableNextPage ()
bool isEnabledNextPage ()
void waitForPageErr ()
void disablePageErr ()
void enablePageErr ()
bool isEnabledPageErr ()

Private Attributes

hw4::SubrackAuger * s

Detailed Description

The class collects all functions to handle the events detected by the second level trigger logic.

Basic for the access to the event data (and also to the image data) is the organization in 32 pages, numbered from 1 to 32. There is always one page in use at the same time

called the actual page. The other pages are filled with former events or are free. If an event is detected the page pointer switches to the next free page. To keep the system running it is important to free the filled pages from the application layer.

The trigger logic is separated from the generation of the next page signal. Both signals can be driven by several possible sources. The sources are described at getTriggerSource and getNextPageSource.

When the next page signal occurs two time stamps are available: The time the next page was generated and the time the last trigger was detected. The time of the trigger that finally caused the next page signal can easily be calculated from the next page time stamp and the delay between trigger and next page.

Todo:: Extend the getTimeStamp function to return also the address of the first and last trigger.

Definition at line 56 of file fe4event.h.

Constructor & Destructor Documentation

FE4event::FE4event ( hw4::SubrackAuger * s )

Member Function Documentation

void FE4event::disableLeftNeigborTrig ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::disableNeighborTrig ( ) [virtual]

Disables the second level trigger signals from the neighbor crates to cause a next page if one of neighbor crate detects a trigger.

Reimplemented from FEbaseEvent.

void FE4event::disableNextPage ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::disablePageErr ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::disableRightNeighborTrig ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::enableLeftNeighborTrig ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::enableNeighborTrig ( ) [virtual]

Enables the second level trigger signals from the neighbor crates to cause a next page if one the neighbor crate detects a trigger.

Reimplemented from FEbaseEvent.

void FE4event::enableNextPage ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::enablePageErr ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::enableRightNeighborTrig ( ) [virtual]

Reimplemented from FEbaseEvent.

void FE4event::forceTrigger ( ) [virtual]

Generate a software trigger signal.

The trigger will also be generated, if the trigger source software is not selected!

Reimplemented from FEbaseEvent.

int FE4event::getActualPage ( ) [virtual]

Get the index of the actual page.

Returns:: 1-64

Reimplemented from FEbaseEvent.

int FE4event::getCoincidenceTime ( ) [virtual]

Get the coincidence time of the Flt trigger signal.

Within this time two Flt trigger will be consider as belonging to one event.

Returns:: The coincidence time in multiples of 50ns (?-tb-) (3 bit value, 0 ... 7)

Reimplemented from FEbaseEvent.

unsigned long FE4event::getLastTriggerTimeStampLow ( int page ) [virtual]

Get the lower long word of the last trigger before the time stamp.

Reimplemented from FEbaseEvent.

int FE4event::getLengthOfBoxcar	(	int	col = `0`,
		int	fpga = `1`
	)		`[virtual]`

Length of the BOXCAR-Sum in that is used to smooth the ADC values before making the trigger decision in units of 100ns.

For col=0 the setting of the first found FLT is returned.

For V4 the parameter fpga is ignored.

Reimplemented from FEbaseEvent.

int FE4event::getNextPage ( ) [virtual]

Get the index of the page to which the system will proceed after the NxPg signal.

Here out of the free pages that one with the lowest page number is choosen.

Returns:: 1-64

Reimplemented from FEbaseEvent.

int FE4event::getNextPageDelay ( ) [virtual]

To avoid the generation of more than one next page from one trigger it is possible to specify a delay between both signals.

The delay can be specified from 0 to 102.3us (11bit value, 1 digit = 50ns (?-tb-)).

Returns:: The delay in multiples of 50ns (?-tb-) (0-2047).

Reimplemented from FEbaseEvent.

virtual int FE4event::getNumFreePages ( ) [virtual]

Return the number of currently free pages.

Reimplemented from FEbaseEvent.

virtual int FE4event::getOldestPage ( ) [virtual]

Return the page number (1..64) of the oldest page, 0 if no page filled.

Reimplemented from FEbaseEvent.

void FE4event::getTimeStamp	(	int	page,
		unsigned long *	sec,
		int *	subSec1,
		int *	subSec2,
		int *	imgAddr,
		int *	evtAddr,
		int *	trigger = `0`
	)		`[virtual]`

Get the time stamp of a page.

In addition the relativ address of the oldest time bin is returned.

Parameters:

page	Page number
sec	GPS seconds [s]
subSec1	subseconds 0..9999 [100us]
subSec2	subseconds 0..1999 [50ns]
imgAddr	relative address of the oldest time bin in the image memory
evtAddr	relative address of the oldest time bin in the event memory
trigger	origin of the trigger.

Todo:: Check the relation between times and address pointer in the hardware with Sascha or Matthias Balzer. Check also mirror.exe!

Reimplemented from FEbaseEvent.

void FE4event::getTimeStamp	(	int	page,
		FE4timeStamp *	timeStamp
	)

Get the time stamp of the page.

The class FE4TimeStamp provides all functions to decode the information collected in the time stamps.

unsigned long FE4event::getTimeStampHigh ( int page ) [virtual]

Get the higher long word of the time stamp of the next page signal.

Reimplemented from FEbaseEvent.

unsigned long FE4event::getTimeStampLow ( int page ) [virtual]

Get the lower long word of the time stamp the next page signal.

Reimplemented from FEbaseEvent.

int FE4event::getTriggerSource ( ) [virtual]

There are four possible sources for the generation of a second level trigger signal: The normal one - a matching pattern is detected, a second level trigger at one of the neighbor crates, the external trigger or a software trigger.

To select an arbitrary combination of these choises use the defined bitfields:

SLT_TRIGGER_SW software trigger,
SLT_TRIGGER_LEFT left neighbor
SLT_TRIGGER_RIGHT right neighbor,
SLT_TRIGGER_INT internal source,
SLT_TRIGGER_EXT external trigger,

Example: To select internal and left trigger use the folloing command.

      setTriggerSource(SLT_TRIGGER_INT | SLT_TRIGGER_LEFT);

Returns:: The possible trigger sources.

Reimplemented from FEbaseEvent.

bool FE4event::isEnabledLeftNeigborTrig ( ) [virtual]

Reimplemented from FEbaseEvent.

bool FE4event::isEnabledNeighborTrig ( ) [virtual]

Check whether the second level trigger signal from at least one of the neighbor crates is allowed to cause a trigger also for this crate.

Reimplemented from FEbaseEvent.

bool FE4event::isEnabledNextPage ( ) [virtual]

Reimplemented from FEbaseEvent.

bool FE4event::isEnabledPageErr ( ) [virtual]

Reimplemented from FEbaseEvent.

bool FE4event::isEnabledRightNeighborTrig ( ) [virtual]

Reimplemented from FEbaseEvent.

bool FE4event::isInUse ( int page ) [virtual]

Check the state of the specified page.

Returns:: false page is free, true page contains event data.

Reimplemented from FEbaseEvent.

void FE4event::isInUse ( unsigned long * status ) [virtual]

Check the states of all pages.

Returns two long word with the state of all pages. The bits 0-31 correspond with the pages 1-32 and 33-64. Where the values 0 mark a free page and 1 indicates a page with event data.

Parameters:

status Page status, status[0] Low Status bits for the pages 1-32, status[1] Status bits for the pages 33-64.

Reimplemented from FEbaseEvent.

virtual bool FE4event::isPageReady ( ) [virtual]

Return true, if there is any page filled (ready).

Reimplemented from FEbaseEvent.

void FE4event::read	(	int	page,
		unsigned long *	data
	)		`[virtual]`

Read the pixel data of the specified page.

The pixel data of each page is organized in a two dimensional array of 2000 element: In every cycle of 100ns the pixel data of two consecutive columns is read. After 10x100ns = 1us the algorithm starts again with the first column couple. The data can be described by the two dimensional array data[time][col], but there is an constant time displacement depending on the column number. The time span recorded for the 20 columns is 100x1us = 100us.

Each long word contains the pixel information obtained from the first level trigger and the corresponding pattern detected by second level trigger.

Bit 31-25 Number of the pattern (SLT)
Bit 24 ---
Bit 23 External trigger
Bit 22 Parity Error
Bit 21-0 Pixel information (FLT)

Reimplemented from FEbaseEvent.

void FE4event::read	(	int	page,
		int	start,
		unsigned long *	data
	)		`[virtual]`

Read trigger data.

Parameters:

page	Page number 1..64
start	0..1999
data	Array with the returned data

Reimplemented from FEbaseEvent.

void FE4event::readMultiplicity	(	int	page,
		unsigned short *	data
	)

Read the multiplicity of the trigger for an event.

The multiplicity of 0..440 (9bit) is given every 100ns. The complete multiplicity for the event consists of 1000 values.

Note: Not implemented !

void FE4event::readMultiplicity	(	int	page,
		int	start,
		unsigned short *	data
	)

Read the multiplicity.

Parameters:

page	Page number 1..64
start	0..999
data	Array with the returned data

Note: Not implemented !

void FE4event::readMultiplicityPage	(	int	pageStartOffset,
		unsigned long *	data
	)		`[virtual]`

Read the MultiplicityPage (new for V4; see SLT docu).

The multiplicity page provides the projection and the multiplicity information of a event. STILL UNDER DEVELOPMENT! -tb-

Parameters:

pageStartOffset	0..999 ; (this should be the value of the event status register)
data	Array with the returned data

Reimplemented from FEbaseEvent.

void FE4event::readSltPage	(	int	pageStartOffset,
		unsigned long *	data
	)		`[virtual]`

Read the SLT page (new for V4; see SLT docu).

The SLT page provides the extended pixel trigger data, the pattern number and the global trigger flag of a event. (Be sure to enable the pixel trigger bus and to set the SLT Control register Run bit to Run mode (not test mode)!!) Check the page management ("automatic" is recommended). One timeslot is 100 ns. STILL UNDER DEVELOPMENT! -tb-

Parameters:

pageStartOffset	0..1999 ; (this should be the value of the event status register)
data	Array with the returned data. You can use a 2d array (example: unsigned long someData[100][20]; ... readSltPage(pageStartOffset,&someData[0][0]);).

Reimplemented from FEbaseEvent.

virtual void FE4event::resetPages ( ) [virtual]

Clear all pages.

Reimplemented from FEbaseEvent.

void FE4event::setCoincidenceTime ( int time ) [virtual]

Set the coincidence time (multiples of 100ns).

(3 bit value, 0<= time <=7)

Reimplemented from FEbaseEvent.

void FE4event::setNextPageDelay ( int delay ) [virtual]

Set the delay between trigger and next page signal in multiples of 50ns.

Reimplemented from FEbaseEvent.

void FE4event::setPageFree ( int page ) [virtual]

Mark the specified page as free.

In V4 'page' is not needed (ignored). Always the oldest page is released

Reimplemented from FEbaseEvent.

void FE4event::setPageInUse ( int page ) [virtual]

Mark the specified page as used.

Be aware that there will be no next page signal for this page. To manipulate the page index the inhibit signal is set for some time - this will interfere the normal mode of operation.

Reimplemented from FEbaseEvent.

void FE4event::setTriggerSource ( int source ) [virtual]

Set the trigger source as described with getTriggerSource().

Reimplemented from FEbaseEvent.

int FE4event::waitForNextPage ( ) [virtual]

Blocks the execution until a next page signal occurs.

Returns:: The number of the page active before the next page signal was generated (1-64).

Reimplemented from FEbaseEvent.

void FE4event::waitForPageErr ( ) [virtual]

If the page management switches to the last page it will generate a page error.

At this time the system is still running, but another next page signal will stop the system (inhibit).

Reimplemented from FEbaseEvent.

Member Data Documentation

hw4::SubrackAuger* FE4event::s [private]

Definition at line 375 of file fe4event.h.

The documentation for this class was generated from the following file:

/home/kopmann/git-mirror/fdhwlib/fdhwlib/FE/fe4event.h