src/mem/ruby/common/Driver.hh

   1
   2 /*
   3  * Copyright (c) 1999-2008 Mark D. Hill and David A. Wood
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions are
   8  * met: redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer;
  10  * redistributions in binary form must reproduce the above copyright
  11  * notice, this list of conditions and the following disclaimer in the
  12  * documentation and/or other materials provided with the distribution;
  13  * neither the name of the copyright holders nor the names of its
  14  * contributors may be used to endorse or promote products derived from
  15  * this software without specific prior written permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  20  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  21  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  27  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28  */
  29
  30 /*
  31  * $Id$
  32  *
  33  * Description:
  34  *
  35  */
  36
  37 #ifndef DRIVER_H
  38 #define DRIVER_H
  39
  40 #include "mem/ruby/common/Global.hh"
  41 #include "mem/ruby/common/Consumer.hh"
  42 #include "mem/ruby/system/NodeID.hh"
  43 #include "mem/ruby/common/Address.hh"
  44
  45
  46 class Driver {
  47 public:
  48   // Constructors
  49   Driver();
  50
  51   // Destructor
  52   virtual ~Driver() = 0;
  53
  54   // Public Methods
  55   virtual void get_network_config() {}
  56   virtual void dmaHitCallback() {};
  57   virtual void hitCallback(int64_t id) = 0; // Called by sequencer
  58   virtual void go() = 0;
  59   virtual integer_t getInstructionCount(int procID) const { return 1; }
  60   virtual integer_t getCycleCount(int procID) const { return 1; }
  61   virtual void addThreadDependency(int procID, int requestor_thread, int conflict_thread) const { assert(0);}
  62   virtual void printDebug(){}  //called by Sequencer
  63
  64   virtual void printStats(ostream& out) const = 0;
  65   virtual void clearStats() = 0;
  66
  67   virtual void printConfig(ostream& out) const = 0;
  68
  69
  70   virtual integer_t readPhysicalMemory(int procID, physical_address_t address,
  71                                        int len ){ ASSERT(0); return 0; }
  72
  73   virtual void writePhysicalMemory( int procID, physical_address_t address,
  74                                     integer_t value, int len ){ ASSERT(0); }
  75
  76 protected:
  77   // accessible by subclasses
  78
  79 private:
  80   // inaccessible by subclasses
  81
  82 };
  83
  84 #endif //DRIVER_H