action.skip

TriggerRecordHeaderData v3

This document describes the format of the TriggerRecordHeaderData struct, version 3. It should not be updated, but rather kept as a historic record of the data format for this version.

TriggerRecordHeaderData Description

A version 3 TriggerRecordHeaderData consists of 14 32-bit words:

  1. Marker (0x33334444)

  2. Version (0x00000002)

  3. Trigger Number (upper 32 bits)

  4. Trigger Number (lower 32 bits)

  5. Trigger timestamp (upper 32 bits)

  6. Trigger timestamp (lower 32 bits)

  7. Number of Requested Components (upper 32 bits)

  8. Number of Requested Components (lower 32 bits)

  9. Run number

  10. Error bits

  11. Trigger type (upper 16 bits) / Sequence number (lower 16 bits)

  12. Max sequence number (upper 16 bits) / Padding (lower 16 bits)

  13. SourceID version 2 Version (upper 16 bits) / Subsystem (lower 16 bits)

  14. SourceID version 2 Element ID

C++ code for TriggerRecordHeaderData

using run_number_t = uint32_t; 
using trigger_number_t = uint64_t; 
using timestamp_t = uint64_t;
using trigger_type_t = uint16_t; 
using sequence_number_t = uint16_t;

struct TriggerRecordHeaderData
{

  static constexpr uint32_t s_trigger_record_header_marker = 0x33334444;
  static constexpr uint32_t s_trigger_record_header_version = 3;
  static constexpr uint64_t s_invalid_number_components = std::numeric_limits<uint64_t>::max();
  static constexpr uint32_t s_default_error_bits = 0;

  uint32_t trigger_record_header_marker = s_trigger_record_header_marker;
  uint32_t version = s_trigger_record_header_version;
  trigger_number_t trigger_number{ TypeDefaults::s_invalid_trigger_number };
  timestamp_t trigger_timestamp{ TypeDefaults::s_invalid_timestamp };
  uint64_t num_requested_components{ s_invalid_number_components };
  run_number_t run_number{ TypeDefaults::s_invalid_run_number };
  uint32_t error_bits{ s_default_error_bits };
  trigger_type_t trigger_type{ TypeDefaults::s_invalid_trigger_type };
  sequence_number_t sequence_number{ TypeDefaults::s_invalid_sequence_number };
  sequence_number_t max_sequence_number{ TypeDefaults::s_invalid_sequence_number };
  uint16_t unused { 0xFFFF};
  SourceID element_id;
};

Notes

A TriggerRecordHeaderData instance is a flat array consisting of a TriggerRecordHeaderData instance followed immediately by zero or more ComponentRequest instances. For TriggerRecordHeaderData version 1, these are assumed to be ComponentRequest version 0 (unversioned).

Last git commit to the markdown source of this page:

Author: John Freeman

Date: Mon Jul 11 15:35:15 2022 -0500

If you see a problem with the documentation on this page, please file an Issue at https://github.com/DUNE-DAQ/daqdataformats/issues