Skip to content

Latest commit

 

History

History
59 lines (47 loc) · 2.46 KB

TriggerRecordHeaderDataV3.md

File metadata and controls

59 lines (47 loc) · 2.46 KB

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).