L1GctLut.h

Go to the documentation of this file.

#ifndef L1GCTLUT_H_
#define L1GCTLUT_H_

#include <iomanip>
#include <sstream>
#include <cstdint>

template <int NAddressBits, int NDataBits>
class L1GctLut {
public:
  static const uint16_t MAX_ADDRESS_BITMASK;
  static const uint16_t MAX_DATA_BITMASK;

  virtual ~L1GctLut();

  friend std::ostream& operator<<(std::ostream& os, const L1GctLut<NAddressBits, NDataBits>& lut) {
    //----------------------------------------------------------------------------------------
    // Define the code here for the friend template function to get around
    // compiler/linker problems when instantiating the template class.
    // See http://www.parashift.com/c++-faq-lite/templates.html#faq-35.16
    static const int maxAddress = L1GctLut<NAddressBits, NDataBits>::MAX_ADDRESS_BITMASK;
    static const int width = L1GctLut<NAddressBits, NDataBits>::printWidth;

    os << lut.printHeader();

    for (int a = 0; a <= maxAddress; a += width) {
      os << lut.printLine(a);
    }
    return os;
    // End of friend function definition
    //----------------------------------------------------------------------------------------
  }

  uint16_t lutValue(const uint16_t lutAddress) const;

  uint16_t operator[](const uint16_t lutAddress) const { return lutValue(lutAddress); }

  template <int KAddressBits, int KDataBits>
  int operator==(const L1GctLut<KAddressBits, KDataBits>& rhsLut) const {
    return equalityCheck(rhsLut);
  }

  template <int KAddressBits, int KDataBits>
  int operator!=(const L1GctLut<KAddressBits, KDataBits>& rhsLut) const {
    return !equalityCheck(rhsLut);
  }

  bool setupOk() { return m_setupOk; }

  void setVerbose() { m_verbose = true; }
  void setTerse() { m_verbose = false; }

protected:
  L1GctLut();

  virtual uint16_t value(const uint16_t lutAddress) const = 0;

  template <int KAddressBits, int KDataBits>
  bool equalityCheck(const L1GctLut<KAddressBits, KDataBits>& c) const;

  bool m_setupOk;
  bool m_verbose;

private:
  // For use by the friend function to print the lut contents
  static const int printWidth;
  std::string printHeader() const;
  std::string printLine(const int add) const;
};

template <int NAddressBits, int NDataBits>
const uint16_t L1GctLut<NAddressBits, NDataBits>::MAX_ADDRESS_BITMASK = (1 << NAddressBits) - 1;
template <int NAddressBits, int NDataBits>
const uint16_t L1GctLut<NAddressBits, NDataBits>::MAX_DATA_BITMASK = (1 << NDataBits) - 1;

template <int NAddressBits, int NDataBits>
const int L1GctLut<NAddressBits, NDataBits>::printWidth = 16;

template <int NAddressBits, int NDataBits>
L1GctLut<NAddressBits, NDataBits>::L1GctLut() : m_setupOk(false) {}

template <int NAddressBits, int NDataBits>
L1GctLut<NAddressBits, NDataBits>::~L1GctLut() {}

template <int NAddressBits, int NDataBits>
uint16_t L1GctLut<NAddressBits, NDataBits>::lutValue(const uint16_t lutAddress) const {
  if (!m_setupOk)
    return (uint16_t)0;
  uint16_t address = (lutAddress & MAX_ADDRESS_BITMASK);
  uint16_t data = (value(address) & MAX_DATA_BITMASK);
  return data;
}

template <int NAddressBits, int NDataBits>
template <int KAddressBits, int KDataBits>
bool L1GctLut<NAddressBits, NDataBits>::equalityCheck(const L1GctLut<KAddressBits, KDataBits>& rhsLut) const {
  if (KAddressBits == NAddressBits && KDataBits == NDataBits) {
    bool match = true;
    for (uint16_t address = 0; address <= MAX_ADDRESS_BITMASK; address++) {
      if (this->lutValue(address) != rhsLut.lutValue(address)) {
        match = false;
        break;
      }
    }
    return match;
  } else {
    return false;
  }
}

template <int NAddressBits, int NDataBits>
std::string L1GctLut<NAddressBits, NDataBits>::printHeader() const {
  std::stringstream ss;
  ss << std::hex << std::showbase;
  ss << std::setw(8) << "|";
  for (int a = 0; ((a < printWidth) && (a <= MAX_ADDRESS_BITMASK)); ++a) {
    ss << std::setw(7) << a;
  }
  ss << std::endl;
  ss << std::setfill('-') << std::setw(8) << "+";
  for (int a = 0; ((a < printWidth) && (a <= MAX_ADDRESS_BITMASK)); ++a) {
    ss << std::setw(7) << "-";
  }
  ss << std::endl;

  return ss.str();
}

template <int NAddressBits, int NDataBits>
std::string L1GctLut<NAddressBits, NDataBits>::printLine(const int add) const {
  std::stringstream ss;
  ss << std::hex << std::showbase;
  int a = add;
  ss << std::setw(7) << a << "|";
  for (int c = 0; ((c < printWidth) && (a <= MAX_ADDRESS_BITMASK)); ++c) {
    uint16_t address = static_cast<uint16_t>(a++);
    ss << std::setw(7) << lutValue(address);
  }
  ss << std::endl;

  return ss.str();
}

#endif /*L1GCTLUT_H_*/