ASC_dbg.h File Reference

ACD Software Rate Counters, debug interface file. More...

Functions
int	ASC_acd_sizeof (void)
	Returns the size, in bytes, of the data structure needed to hold an unpacked ACD event.
struct _EBF_gem *	ASC_gem_locate (const unsigned int *edata, int esize)
	Locates GEM contribution in an event.
struct _EBF_aem *	ASC_aem_locate (const unsigned int *edata, int esize)
	Locates ACD contribution in an event.
int	ASC_acd_unpack (struct _ASC_acd *acd, const struct _EBF_aem *aem)
	Unpacks an ACD record from the AEM into a standard structure.
void	ASC_accumulateU (ASC_counters *counters, const struct _EBF_gem *gem, const struct _ASC_acd *alr)
	Accumulates the proper pattern words for each ACD hit.
void	ASC_show (const ASC_counters *counters, unsigned int options)
	Prints the statistics counters.

---

Detailed Description

ACD Software Rate Counters, debug interface file.

Author:

JJRussell - russell@slac.stanford.edu

    CVS $Id: ASC_dbg.h,v 1.1.1.1 2005/12/01 21:55:31 ebacho Exp $

SYNOPSIS

Defines the the interface for controlling the ACD software rate counters, used for testing purposes

---

Function Documentation

void ASC_accumulateU	(	ASC_counters *	counters,
		const struct _EBF_gem *	gem,
		const struct _ASC_acd *	acd
	)

Accumulates the proper pattern words for each ACD hit.

Parameters:

	counters	The statistics counters
	gem	Pointer to the GEM record
	acd	Pointer to an unpacked ACD record

This function is called on the assumption that the GEM record has been located and the ACD data has been both located and successfully unpacked.

References accumulate(), accumulate_cno(), _EBF_gem::acd, ASC_SUMMARY_AEM_ERR__GEM_MISS, ASC_SUMMARY_AEM_ERR__GEM_OKAY, ASC_SUMMARY_AEM_MISS_GEM_MISS, ASC_SUMMARY_AEM_MISS_GEM_OKAY, ASC_SUMMARY_AEM_OKAY_GEM_MISS, ASC_SUMMARY_AEM_OKAY_GEM_OKAY, _ASC_counters::cno, _EBF_gem::condCno, EBF_K_ACD_LIST_CNT, EBF_K_ACD_SIDE_A, EBF_K_ACD_SIDE_B, _ASC_counters::gec, _ASC_acd::hits, _ASC_cnts::lists, _ASC_acd::paccepts, _ASC_acd::status, _ASC_counters::summary, and _EBF_gemAcd::vetoes.

Referenced by ASC_accumulate().

int ASC_acd_sizeof

(

void

)

Returns the size, in bytes, of the data structure needed to hold an unpacked ACD event.

Returns:

The size, in bytes, of the data structure needed to hold an unpacked ACD event

int ASC_acd_unpack	(	struct _ASC_acd *	acd,
		const struct _EBF_aem *	aem
	)

Unpacks an ACD record from the AEM into a standard structure.

Returns:

Status. The only failure is if more than 18 PHAs are found to be present on an given FREE board.

Parameters:

	acd	Pointer to the data structure to receive the unpacked ACD data
	aem	Pointer to the AEM ACD data

References unpack().

const struct _EBF_aem * ASC_aem_locate	(	const unsigned int *	edata,
		int	esize
	)			[read]

Locates ACD contribution in an event.

Return values:

	A	pointer to the GEM contribution.
	NULL	is return if the GEM contribution cannnot be found

Parameters:

	edata	Pointer to the event data structure
	esize	Size, in bytes, of the event

References locate_aem().

Referenced by ASC_accumulate().

const struct _EBF_gem * ASC_gem_locate	(	const unsigned int *	edata,
		int	esize
	)			[read]

Locates GEM contribution in an event.

Return values:

	A	pointer to the GEM contribution.
	NULL	is return if the GEM contribution cannnot be found

Parameters:

	edata	Pointer to the event data structure
	esize	Size, in bytes, of the event

References _SKIP_EHDR, EBF_K_CID_GEM, and LCB_EXTRACT_CID.

Referenced by ASC_accumulate().

void ASC_show	(	const ASC_counters *	counters,
		unsigned int	options
	)

Prints the statistics counters.

Parameters:

	counters	The statistics counters to print
	options	Show options

References _ASC_counters::cno, _ASC_counters::gec, printCno(), printCnts(), printSummary(), and _ASC_counters::summary.