4.1 Constants

4.1.1 Package types

group packettypes

Packet types supported by different cronologic boards.

Used for crono_packet::type.

Defines

CRONO_PACKET_TYPE_8_BIT_SIGNED
CRONO_PACKET_TYPE_16_BIT_SIGNED
CRONO_PACKET_TYPE_32_BIT_SIGNED
CRONO_PACKET_TYPE_64_BIT_SIGNED
CRONO_PACKET_TYPE_8_BIT_UNSIGNED
CRONO_PACKET_TYPE_16_BIT_UNSIGNED
CRONO_PACKET_TYPE_32_BIT_UNSIGNED
CRONO_PACKET_TYPE_64_BIT_UNSIGNED
CRONO_PACKET_TYPE_TDC_DATA
CRONO_PACKET_TYPE_AVRG_DATA
CRONO_PACKET_TYPE_TIMESTAMP_ONLY
CRONO_PACKET_TYPE_END_OF_BUFFER
CRONO_PACKET_TYPE_TRIGGER_PATTERN

4.1.2 ADC package error flags

group packetflags

Errors concering the data of a packet or its processing.

Used for crono_packet::flags.

Defines

CRONO_PACKET_FLAG_SHORTENED

Packet was truncated because internal FIFO was full.

This means that less than the requested number of samples have been written.

CRONO_PACKET_FLAG_PACKETS_LOST

Lost triggers preceeded this packet due to insufficient DMA buffers.

The DMA controller has discarded packets due to the full host buffer.

CRONO_PACKET_FLAG_OVERFLOW

The packet contains ADC sample overflows.

CRONO_PACKET_FLAG_TRIGGER_MISSED

Lost triggers preceeded this packet due to insufficient buffers.

The trigger unit has discarded packets due to a full FIFO.

CRONO_PACKET_FLAG_DMA_FIFO_FULL

The internal DMA FIFO was full.

Triggers only got lost if a subsequent package has crono_packet::flags with a bit weight CRONO_PACKET_FLAG_TRIGGER_MISSED set.

CRONO_PACKET_FLAG_HOST_BUFFER_FULL

The host buffer was full.

Triggers only got lost if a subsequent package has crono_packet::flags with a bit weight CRONO_PACKET_FLAG_TRIGGER_MISSED set.

CRONO_PACKET_FLAG_TDC_NO_EDGE

The packet from a TDC does not contain valid data.

Hence, the timestamp is not corrected. No valid edge was found for the TDC.

4.1.3 TDC package error flags

group tdcpacketflags

Flags of a TDC packet reporting error conditions.

Used for crono_packet::flags.

Defines

NDIGO6G12_TDC_PACKET_FLAG_RESERVED
NDIGO6G12_TDC_PACKET_FLAG_CONTAINS_DATA

Packet contains at least one TDC event.

NDIGO6G12_TDC_PACKET_FLAG_LOST

At least one packet was lost due to full FIFO.

NDIGO6G12_TDC_PACKET_FLAG_SHORTENED

The trigger unit has shortend the current packet due to full FIFO.

NDIGO6G12_TDC_PACKET_FLAG_DMA_FIFO_FULL

The DMA FIFO was full.

Trigger only got lost if a subsequent package has crono_packet::flags with a bit weight NDIGO6G12_TDC_PACKET_FLAG_LOST set.

NDIGO6G12_TDC_PACKET_FLAG_HOST_BUFFER_FULL

The host buffer was full.

Trigger only got lost if a subsequent package has crono_packet::flags with a bit weight NDIGO6G12_TDC_PACKET_FLAG_LOST set.

4.1.4 TDC hit flags

group tdchitflags

Flags of TDC-hit error conditions.

Defines

NDIGO6G12_TDC_HIT_FLAG_LOST

At least one preceding event was lost due to full FIFO.

NDIGO6G12_TDC_HIT_FLAG_ROLLOVER_LOST

Rollover has been lost due to full FIFO.

Results in a fatal error.

NDIGO6G12_TDC_HIT_FLAG_VALID

Timestamp is a valid TDC event.

NDIGO6G12_TDC_HIT_FLAG_GROUP_TIME_ROLLOVER

Timestamp is a rollover marker.

Add ndigo6g12_param_info::tdc_rollover_period to all subsequent timestamps in the packet.

NDIGO6G12_TDC_HIT_ERROR_MASK

TDC hit flag mask for error reporting.

NDIGO6G12_TDC_HIT_TYPE_MASK

TDC hit flags mask for timestamp type.

NDIGO6G12_TDC_PADDING_DATA_CHANNEL

TDC hit channel number for padding-data.

Padding-data can be ignored. Does not contain any usefull information. Padding-data has NDIGO6G12_TDC_HIT_FLAG_GROUP_TIME_ROLLOVER and NDIGO6G12_TDC_HIT_FLAG_VALID always cleared.

NDIGO6G12_TDC_ROLLOVER_CHANNEL

TDC hit channel number for rollover marker.

Rollover marker has NDIGO6G12_TDC_HIT_FLAG_GROUP_TIME_ROLLOVER always set.