riscv/sim.h

   1 // See LICENSE for license details.
   2
   3 #ifndef _RISCV_SIM_H
   4 #define _RISCV_SIM_H
   5
   6 #include "processor.h"
   7 #include "devices.h"
   8 #include "debug_module.h"
   9 #include <fesvr/htif.h>
  10 #include <fesvr/context.h>
  11 #include <vector>
  12 #include <string>
  13 #include <memory>
  14
  15 class mmu_t;
  16 class remote_bitbang_t;
  17
  18 // this is the interface to the simulator used by the processors and memory
  19 class simif_t
  20 {
  21 public:
  22   // should return NULL for MMIO addresses
  23   virtual char* addr_to_mem(reg_t addr) = 0;
  24   // used for MMIO addresses
  25   virtual bool mmio_load(reg_t addr, size_t len, uint8_t* bytes) = 0;
  26   virtual bool mmio_store(reg_t addr, size_t len, const uint8_t* bytes) = 0;
  27 };
  28
  29 // this class encapsulates the processors and memory in a RISC-V machine.
  30 class sim_t : public htif_t, public simif_t
  31 {
  32 public:
  33   sim_t(const char* isa, size_t _nprocs,  bool halted, reg_t start_pc,
  34         std::vector<std::pair<reg_t, mem_t*>> mems,
  35         const std::vector<std::string>& args, const std::vector<int> hartids,
  36         unsigned progsize, unsigned max_bus_master_bits, bool require_authentication);
  37   ~sim_t();
  38
  39   // run the simulation to completion
  40   int run();
  41   void set_debug(bool value);
  42   void set_log(bool value);
  43   void set_histogram(bool value);
  44   void set_procs_debug(bool value);
  45   void set_remote_bitbang(remote_bitbang_t* remote_bitbang) {
  46     this->remote_bitbang = remote_bitbang;
  47   }
  48   const char* get_dts() { if (dts.empty()) reset(); return dts.c_str(); }
  49   processor_t* get_core(size_t i) { return procs.at(i); }
  50   unsigned nprocs() const { return procs.size(); }
  51
  52 private:
  53   std::vector<std::pair<reg_t, mem_t*>> mems;
  54   mmu_t* debug_mmu;  // debug port into main memory
  55   std::vector<processor_t*> procs;
  56   reg_t start_pc;
  57   std::string dts;
  58   std::unique_ptr<rom_device_t> boot_rom;
  59   std::unique_ptr<clint_t> clint;
  60   bus_t bus;
  61
  62   processor_t* get_core(const std::string& i);
  63   void step(size_t n); // step through simulation
  64   static const size_t INTERLEAVE = 5000;
  65   static const size_t INSNS_PER_RTC_TICK = 100; // 10 MHz clock for 1 BIPS core
  66   static const size_t CPU_HZ = 1000000000; // 1GHz CPU
  67   size_t current_step;
  68   size_t current_proc;
  69   bool debug;
  70   bool log;
  71   bool histogram_enabled; // provide a histogram of PCs
  72   remote_bitbang_t* remote_bitbang;
  73
  74   // memory-mapped I/O routines
  75   char* addr_to_mem(reg_t addr);
  76   bool mmio_load(reg_t addr, size_t len, uint8_t* bytes);
  77   bool mmio_store(reg_t addr, size_t len, const uint8_t* bytes);
  78   void make_dtb();
  79
  80   // presents a prompt for introspection into the simulation
  81   void interactive();
  82
  83   // functions that help implement interactive()
  84   void interactive_help(const std::string& cmd, const std::vector<std::string>& args);
  85   void interactive_quit(const std::string& cmd, const std::vector<std::string>& args);
  86   void interactive_run(const std::string& cmd, const std::vector<std::string>& args, bool noisy);
  87   void interactive_run_noisy(const std::string& cmd, const std::vector<std::string>& args);
  88   void interactive_run_silent(const std::string& cmd, const std::vector<std::string>& args);
  89   void interactive_reg(const std::string& cmd, const std::vector<std::string>& args);
  90   void interactive_freg(const std::string& cmd, const std::vector<std::string>& args);
  91   void interactive_fregs(const std::string& cmd, const std::vector<std::string>& args);
  92   void interactive_fregd(const std::string& cmd, const std::vector<std::string>& args);
  93   void interactive_pc(const std::string& cmd, const std::vector<std::string>& args);
  94   void interactive_mem(const std::string& cmd, const std::vector<std::string>& args);
  95   void interactive_str(const std::string& cmd, const std::vector<std::string>& args);
  96   void interactive_until(const std::string& cmd, const std::vector<std::string>& args);
  97   reg_t get_reg(const std::vector<std::string>& args);
  98   freg_t get_freg(const std::vector<std::string>& args);
  99   reg_t get_mem(const std::vector<std::string>& args);
 100   reg_t get_pc(const std::vector<std::string>& args);
 101
 102   friend class processor_t;
 103   friend class mmu_t;
 104   friend class debug_module_t;
 105
 106   // htif
 107   friend void sim_thread_main(void*);
 108   void main();
 109
 110   context_t* host;
 111   context_t target;
 112   void reset();
 113   void idle();
 114   void read_chunk(addr_t taddr, size_t len, void* dst);
 115   void write_chunk(addr_t taddr, size_t len, const void* src);
 116   size_t chunk_align() { return 8; }
 117   size_t chunk_max_size() { return 8; }
 118
 119 public:
 120   // Initialize this after procs, because in debug_module_t::reset() we
 121   // enumerate processors, which segfaults if procs hasn't been initialized
 122   // yet.
 123   debug_module_t debug_module;
 124 };
 125
 126 extern volatile bool ctrlc_pressed;
 127
 128 #endif