DAPHNEFrame.hpp

Go to the documentation of this file.

 
#ifndef FDDETDATAFORMATS_INCLUDE_FDDETDATAFORMATS_DAPHNEFRAME_HPP_
#define FDDETDATAFORMATS_INCLUDE_FDDETDATAFORMATS_DAPHNEFRAME_HPP_
 
#include "Utils.hpp"
 
#include "detdataformats/DAQHeader.hpp"
#include <algorithm> // For std::min
#include <cassert>   // For assert()
#include <cstdint>   // For uint32_t etc
#include <cstdio>
#include <cstdlib>
#include <stdexcept> // For std::out_of_range
 
namespace dunedaq::fddetdataformats {
 
// NOLINTBEGIN(build/unsigned)
 
class DAPHNEFrame
{
public:
  // The definition of the format is in terms of 32-bit words
  using word_t = uint32_t;
 
  // Dataframe format version
  static constexpr uint8_t version = 2;
 
  static constexpr int s_bits_per_adc = 14;
  static constexpr int s_bits_per_word = 8 * sizeof(word_t);
  static constexpr int s_num_adcs = 1024;
  static constexpr int s_num_adc_words = s_num_adcs * s_bits_per_adc / s_bits_per_word;
 
  struct Header
  {
    word_t channel : 6, algorithm_id : 4, reserved_1 : 5, r1 : 1, trigger_sample_value : 16;
    word_t threshold : 16, baseline : 16;
    word_t get_baseline() { return baseline; }
  };
  static_assert(sizeof(Header) == 8);
 
  struct PeakDescriptorData
  {
 
    // Word 1: peak 0 odd
    // Declared in reverse order (LSB first) so that:
    //   - num_subpeaks_0 occupies bits [3:0]
    //   - reserved_0 occupies bits [7:4]
    //   - adc_integral_0 occupies bits [30:8]
    //   - found_0 occupies bit [31]
    word_t num_subpeaks_0 : 4;  // Num_SubPeaks [3:0]
    word_t reserved_0 : 4;      // Reserved      [7:4]
    word_t adc_integral_0 : 23; // ADC_Integral [30:8]
    word_t found_0 : 1;         // Found       [31]
 
    // Word 2: peak 0 even
    // Declared (LSB first) so that:
    //   - adc_max_0 occupies bits [13:0]
    //   - sample_max_0 occupies bits [22:14]
    //   - samples_over_baseline_0 occupies bits [31:23]
    word_t adc_max_0 : 14;              // ADC Max         [13:0]
    word_t sample_max_0 : 9;            // Time_Peak        [22:14]
    word_t samples_over_baseline_0 : 9; // Time_Over_Baseline [31:23]
 
    // Word 3: peak 1 odd
    word_t num_subpeaks_1 : 4;  // Num_SubPeaks [3:0]
    word_t reserved_1 : 4;      // Reserved      [7:4]
    word_t adc_integral_1 : 23; // ADC_Integral [30:8]
    word_t found_1 : 1;         // Found       [31]
 
    // Word 4: peak 1 even
    word_t adc_max_1 : 14;              // ADC Max         [13:0]
    word_t sample_max_1 : 9;            // Time_Peak        [22:14]
    word_t samples_over_baseline_1 : 9; // Time_Over_Baseline [31:23]
 
    // Word 5: peak 2 odd
    word_t num_subpeaks_2 : 4;  // Num_SubPeaks [3:0]
    word_t reserved_2 : 4;      // Reserved      [7:4]
    word_t adc_integral_2 : 23; // ADC_Integral [30:8]
    word_t found_2 : 1;         // Found       [31]
 
    // Word 6: peak 2 even
    word_t adc_max_2 : 14;              // ADC Max         [13:0]
    word_t sample_max_2 : 9;            // Time_Peak        [22:14]
    word_t samples_over_baseline_2 : 9; // Time_Over_Baseline [31:23]
 
    // Word 7: peak 3 odd
    word_t num_subpeaks_3 : 4;  // Num_SubPeaks [3:0]
    word_t reserved_3 : 4;      // Reserved      [7:4]
    word_t adc_integral_3 : 23; // ADC_Integral [30:8]
    word_t found_3 : 1;         // Found       [31]
 
    // Word 8: peak 3 even
    word_t adc_max_3 : 14;              // ADC Max         [13:0]
    word_t sample_max_3 : 9;            // Time_Peak        [22:14]
    word_t samples_over_baseline_3 : 9; // Time_Over_Baseline [31:23]
 
    // Word 9: peak 4 odd
    word_t num_subpeaks_4 : 4;  // Num_SubPeaks [3:0]
    word_t reserved_4 : 4;      // Reserved      [7:4]
    word_t adc_integral_4 : 23; // ADC_Integral [30:8]
    word_t found_4 : 1;         // Found       [31]
 
    // Word 10: peak 4 even
    word_t adc_max_4 : 14;              // ADC Max         [13:0]
    word_t sample_max_4 : 9;            // Time_Peak        [22:14]
    word_t samples_over_baseline_4 : 9; // Time_Over_Baseline [31:23]
 
    // Word 11: Time_Start fields for indices 0,1,2 and Reserved
    // Declared in LSB-first order:
    //   - samples_start_2 occupies bits [11:2]
    //   - samples_start_1 occupies bits [21:12]
    //   - samples_start_0 occupies bits [31:22]
    //   - reserved_5 occupies bits [1:0]
    word_t samples_start_2 : 10; // Time_Start(2) [11:2]
    word_t samples_start_1 : 10; // Time_Start(1) [21:12]
    word_t samples_start_0 : 10; // Time_Start(0) [31:22]
    word_t reserved_5 : 2;       // Reserved         [1:0]
 
    // Word 12: Time_Start fields for indices 3,4 and Reserved
    // Declared in LSB-first order:
    //   - reserved_6 occupies bits [11:0]
    //   - samples_start_4 occupies bits [21:12]
    //   - samples_start_3 occupies bits [31:22]
    word_t reserved_6 : 12;      // Reserved         [11:0]
    word_t samples_start_4 : 10; // Time_Start(4) [21:12]
    word_t samples_start_3 : 10; // Time_Start(3) [31:22]
 
    // Word 13: Trailer word (all 32 bits), typically 0xFFFFFFFF.
    word_t trailer;
 
    static const uint8_t max_peaks = 5;

    bool is_found(int idx) const;

    void set_found(uint8_t val, int idx);

    uint32_t get_adc_integral(int idx) const;

    void set_adc_integral(uint32_t val, int idx);

    uint8_t get_num_subpeaks(int idx) const;

    void set_num_subpeaks(uint8_t val, int idx);

    uint16_t get_samples_over_baseline(int idx) const;
 
    // @brief Set the Time_Over_Baseline value for a specific peak.
    void set_samples_over_baseline(uint16_t val, int idx);

    uint16_t get_sample_max(int idx) const;

    void set_sample_max(uint16_t val, int idx);

    uint16_t get_adc_max(int idx) const;

    void set_adc_max(uint16_t val, int idx);

 
    uint16_t get_sample_start(int idx) const;

    void set_sample_start(uint16_t val, int idx);
 
    // ===============================================================
    // Helper: Reinterpret Trailer as an array of word_t
    // ===============================================================
    const word_t* as_words() const
    {
      return reinterpret_cast<const word_t*>(this); // NOLINT
    }
    word_t* as_words()
    {
      return reinterpret_cast<word_t*>(this); // NOLINT
    }
  };
  static_assert(sizeof(PeakDescriptorData) == 13 * sizeof(uint32_t));
 
  detdataformats::DAQHeader daq_header;
  Header header;
  word_t adc_words[s_num_adc_words]; // NOLINT
  PeakDescriptorData peaks_data;

  uint16_t get_adc(int i) const;

  void set_adc(int i, uint16_t val);
 
  uint8_t get_channel() const { return header.channel; }
  void set_channel(uint8_t val) { header.channel = val & 0x3Fu; }

  uint64_t get_timestamp() const { return daq_header.get_timestamp(); }
};
static_assert(sizeof(DAPHNEFrame) == sizeof(detdataformats::DAQHeader) + sizeof(DAPHNEFrame::Header) +
                                       sizeof(DAPHNEFrame::word_t) * DAPHNEFrame::s_num_adc_words +
                                       sizeof(DAPHNEFrame::PeakDescriptorData));
 
static_assert(std::endian::native == std::endian::little,
              "The DAPHNEFrame bitfield layout assumes little-endian architecture");
static_assert(std::is_trivially_copyable_v<DAPHNEFrame>,
              "DAPHNEFrame isn't trivially copyable and can't be safely std::memcpy'd");
static_assert(std::is_standard_layout_v<DAPHNEFrame>,
              "DAPHNEFrame isn't standard layout; reinterpret_cast and offsetof can't safely be used with it");
 
} // namespace dunedaq::fddetdataformats
 
#include "detail/DAPHNEFrame.hxx"
 
// NOLINTEND(build/unsigned)
 
#endif // FDDETDATAFORMATS_INCLUDE_FDDETDATAFORMATS_DAPHNEFRAME_HPP_