1 // See LICENSE for license details.
8 #include "debug_module.h"
9 #include <fesvr/htif.h>
10 #include <fesvr/context.h>
16 class remote_bitbang_t
;
18 // this is the interface to the simulator used by the processors and memory
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;
29 // this class encapsulates the processors and memory in a RISC-V machine.
30 class sim_t
: public htif_t
, public simif_t
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
);
39 // run the simulation to completion
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
;
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(); }
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
;
58 std::unique_ptr
<rom_device_t
> boot_rom
;
59 std::unique_ptr
<clint_t
> clint
;
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
71 bool histogram_enabled
; // provide a histogram of PCs
72 remote_bitbang_t
* remote_bitbang
;
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
);
80 // presents a prompt for introspection into the simulation
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
);
102 friend class processor_t
;
104 friend class debug_module_t
;
107 friend void sim_thread_main(void*);
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; }
120 // Initialize this after procs, because in debug_module_t::reset() we
121 // enumerate processors, which segfaults if procs hasn't been initialized
123 debug_module_t debug_module
;
126 extern volatile bool ctrlc_pressed
;