xref: /gem5/ext/drampower/src/libdrampower/LibDRAMPower.h

/*
 * Copyright (c) 2012-2014, TU Delft
 * Copyright (c) 2012-2014, TU Eindhoven
 * Copyright (c) 2012-2014, TU Kaiserslautern
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 * 1. Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 *
 * 3. Neither the name of the copyright holder nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * Authors: Matthias Jung, Omar Naji
 *
 */

#ifndef LIB_DRAM_POWER_H
#define LIB_DRAM_POWER_H

#include <stdint.h>
#include <vector>

#include "CommandAnalysis.h"
#include "MemoryPowerModel.h"
#include "MemCommand.h"

class libDRAMPower {
 public:
  libDRAMPower(const Data::MemorySpecification& memSpec, bool includeIoAndTermination);
  ~libDRAMPower();

  void doCommand(Data::MemCommand::cmds type,
                 int                    bank,
                 int64_t                timestamp);

  void updateCounters(bool lastUpdate);

  void clearState();

  void calcEnergy();

  const Data::MemoryPowerModel::Energy& getEnergy() const;
  const Data::MemoryPowerModel::Power& getPower() const;

  // list of all commands
  std::vector<Data::MemCommand> cmdList;
 private:
  Data::MemorySpecification memSpec;
 public:
  Data::CommandAnalysis counters;
 private:
  bool includeIoAndTermination;
  // Object of MemoryPowerModel which contains the results
  // Energies(pJ) stored in energy, Powers(mW) stored in power. Number of
  // each command stored in timings.
  Data::MemoryPowerModel mpm;
};

#endif // ifndef LIB_DRAM_POWER_H