EBF_match.c File Reference

Utilities that manages the expected values of EBW and ESW contributor words. This works at the contributor header level. It does not look at the data within a contributor. More...

#include <EDS/EBF_match.h>
#include <EBF_matchPvt.h>
#include <EDS/EBF_cid.h>
#include <EDS/EBF_ebw.h>
#include <PBI/FFS.ih>
#include <string.h>

Functions
int	EBF_matchSet (unsigned int latp_node, unsigned int dgn_ids, unsigned int cids, const signed char order[32])
	Sets the values of the expected readout parameters.
Variables
EBF_matchDb	EBF_MatchDb
	Holds the information that can be used to get the expected values for the ESW and EBW.

---

Detailed Description

Utilities that manages the expected values of EBW and ESW contributor words. This works at the contributor header level. It does not look at the data within a contributor.

Author:

JJRussell - russell@slac.stanford.edu

    CVS $Id: EBF_match.c,v 1.5 2011/03/25 22:16:56 russell Exp $

---

Function Documentation

int EBF_matchSet	(	unsigned int	latp_node,
		unsigned int	dgn_ids,
		unsigned int	cids,
		const signed char	order[32]
	)

Sets the values of the expected readout parameters.

Return values:

	-1	latp_node address is invalid
	-2	The list of contributors (cids) either stored away or the one being added, contains references to cids that are not mentioned in the order array.

Parameters:

	latp_node	This must be a number between 0x20 and 0x3f, although in the anticipated values are more likely to be limited to 0x20, 0x21, 0x22, 0x23, 0x24, 0x25. The check on the LATp destination field is The top bit must be 1 All LATp destination field of each contributor must be the same The LATp destination field must be either the value supplied or the broadcast address. To effectively neuter this test supply 0x20, the broadcast address.
	dgn_ids	A bit mask representing the set of contributors with the diagnostic bit set. The order is MSb is contributor 0. If specified as EBF_MATCH_SET_K_DGN_IDS_ASIS, the current value will not be modified.
	cids	Bit mask representing the set of contributors. It is considered an error if this decoded set does not exactly match this set. If specified as EBF_MATCH_SET_K_CIDS_ASIS, the current value will not be modified.
	order	An array of 32 giving the readout order. Contributors not present in the set as specified by cids will be ignored. Specifying it in this way allows one to have a standard ordering array that can be pared down if the set of contributors is not the complete set. If specified as EBF_MATCH_ORDER_ASIS, the current value will not be modified.

References _EBF_matchDb::cids, _EBF_matchDb::dgn_ids, EBF_MATCH_M_EBW_EXPECTED, EBF_MATCH_SET_K_CIDS_ASIS, EBF_MATCH_SET_K_DGN_IDS_ASIS, EBF_MATCH_SET_K_LATP_NODE_ASIS, EBF_MATCH_SET_K_ORDER_ASIS, _EBF_matchDb::ebw_static, _EBF_matchDb::lpw_expected, and _EBF_matchDb::order.