ASC.h File Reference

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

#include <EMP/LSD_sdi.h>

Classes
struct	_ASC_handlerConstructCfg
	Defines the configuration parameters for the Construct routine. More...
Typedefs
typedef struct _EBF_gem	EBF_gem
typedef struct _EDR_acd	EDR_acd
typedef struct _ASC	ASC
typedef struct _ASC_counters	ASC_counters
	Typedef for struct ASC_counters.
typedef struct _ASC_stats	ASC_stats
	Typedef for struct _ASC_stats.
typedef struct _EDS_DB_HandlerConstructServices	EDS_DB_HandlerConstructServices
typedef struct _ASC_handlerConstructCfg	ASC_handlerConstructCfg
	Typedef for struct _ASC_handlerConstructCfg.
Functions
void	ASC_clear (ASC_counters *counters)
	Clears the specified statistics counters.
int	ASC_accumulate (ASC_counters *counters, const unsigned int *edata, int esize)
const EDS_DB_HandlerConstructServices *	ASC_constructServicesGet (ASC_handlerConstructCfg *cfg)
	Routine called by LPA (via EMP_DB) to get constructionr info for ASC.
ASC_counters *	ASC_locateCounters (ASC *asc)
ASC_stats *	ASC_locateStats (ASC *asc)
void	ASC_getStats (ASC *asc, ASC_stats *stats)
void	ASC_clearStats (ASC *asc)
void	ASC_showStats (ASC *asc)
unsigned int	ASC_statsSizeof (void)
void	ASC_statsSub (ASC_stats *result, const ASC_stats *stats, const ASC_stats *base)
void	ASC_accumulateU (ASC_counters *counters, const EBF_gem *gem, const EDR_acd *acd)
	Accumulates the proper pattern words for each ACD hit.
const unsigned int *	ASC_aem_locate (const unsigned int *edata, int esize)
	Locates AEM contribution in an event.

---

Detailed Description

ACD Software Rate Counters, interface file.

Author:

JJRussell - russell@slac.stanford.edu

    CVS $Id: ASC.h,v 1.7 2011/03/26 20:07:42 russell Exp $

SYNOPSIS

Defines the the interface for controlling the ACD software rate counters

---

Typedef Documentation

ASC_counters

Typedef for struct ASC_counters.

Note:

See the documentation of the enum _ASC_SUMMARY for an explanation of the summary statistics block.

---

Function Documentation

void ASC_accumulateU	(	ASC_counters *	counters,
		const EBF_gem *	gem,
		const EDR_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(), 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, _ASC_counters::gec, _ASC_cnts::lists, and _ASC_counters::summary.

Referenced by AscEdsProcess().

const unsigned int * ASC_aem_locate	(	const unsigned int *	edata,
		int	esize
	)

Locates AEM contribution in an event.

Return values:

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

Parameters:

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

References locate_aem().

Referenced by set_aem().

ASC_clear

(

ASC_counters *

counters

)

Clears the specified statistics counters.

Parameters:

counters

The statistics counters to be cleared

Warning:

Currently this is a NON-interlocked operation.

References clear().

Referenced by initMsg(), and output().

const EDS_DB_HandlerConstructServices* ASC_constructServicesGet

(

ASC_handlerConstructCfg *

cfg

)

Routine called by LPA (via EMP_DB) to get constructionr info for ASC.

Returns:

Pointer to EDS_DB_HandlerConstructServices structure

Parameters:

cfg

The handler construction configuration

References AscEdsConstruct(), and AscEdsSizeof().