Single ECON-D event packet. More...

#include <ECONDEventPacket.h>

Collaboration diagram for pflib::packing::ECONDEventPacket:

Public Member Functions
	ECONDEventPacket (std::size_t n_links)
	Construct an event packet with the number of eRx "links".

int	adc_cm0 (int i_link) const
	get ADC readout from common mode 0 of input link

int	adc_cm1 (int i_link) const
	get ADC readout from common mode 1 of input link

Sample	channel (int i_link, int i_ch) const
	get channel Sample from a link

Sample	calib (int i_link) const
	get calib Sample from a link half

void	from (std::span< uint32_t > data)
	parse into the packet from the passed data span

Public Attributes
std::array< bool, 4 >	corruption
	storage of corruption bits

std::vector< DAQLinkFrame >	links
	storage of unpacked link data

Private Member Functions
std::size_t	unpack_link_subpacket (std::span< uint32_t > data, DAQLinkFrame &link, bool passthrough)
	Unpack a eRx ("link") subpacket from the ECOND event into a DAQLinkFrame.

Private Attributes
mutable::pflib::logging::logger	the_log_ {::pflib::logging::get("decoding")}
	handle to logging source

Detailed Description

Single ECON-D event packet.

The ECON-D is the CONcentrator mezzanine for the Data path and it has many different configuration modes. The two most important to us for decoding are

"Pass Through" mode - all 37 sample words are copied from the link, the link headers from the ROC are overwritten by ECOND link headers
"Regular" mode - the ECOND event format is written which can include zero-suppression of multiple varieties including full eliminating channels that are empty

The ECOND_Formatter emulates the ECON-D re-formatting of the HGCROC event packets into the ECON-D event packet. This unpacking is done separately from this formatter so that it can be applied to data actually extracted from an ECON-D.

Member Function Documentation

◆ from()

void pflib::packing::ECONDEventPacket::from ( std::span< uint32_t > data )

parse into the packet from the passed data span

This function is what implements the format describe in the ECOND specification.

See also: MultiSampleECONDEventPacket for wrapping this function with more unpacking to handle the extra headers and trailers that are added by software emulation or hardware.

◆ unpack_link_subpacket()

std::size_t pflib::packing::ECONDEventPacket::unpack_link_subpacket	(	std::span< uint32_t >	data,
		DAQLinkFrame &	link,
		bool	passthrough )

private

Unpack a eRx ("link") subpacket from the ECOND event into a DAQLinkFrame.

Note: We overload the zero'th corruption bit for DAQLinkFrame to mean that any of the three Stat bits are bad (not 1).

Parameters

[in]	data	subpacket data to unpack
[out]	link	DAQLinkFrame to update with unpacked data @paran[in] passthrough whether the ECOND is in pass through mode or not

Returns: std::size_t length of data in 32b words that was unpacked

Member Data Documentation

◆ corruption

std::array<bool, 4> pflib::packing::ECONDEventPacket::corruption

storage of corruption bits

Index	Description
0	9b header marker is not the ECOND spec or common CMS config
1	stored length does not equal packet length
2	8b header CRC mismatch
3	32b sub-packet CRC mismatch

◆ links

std::vector<DAQLinkFrame> pflib::packing::ECONDEventPacket::links

storage of unpacked link data

This is very space in-efficient since we store zero words for any channel or measurement that was zero suppressed. This won't be a problem for the smaller-scale testbeam prototypes, but could be a memory issue when we get to the full LDMX detector with its almost 100k channels.

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

include/pflib/packing/ECONDEventPacket.h
src/pflib/packing/ECONDEventPacket.cxx

Public Member Functions

Public Attributes

Private Member Functions