Merge pull request #117 from riscv/multicore_debug
[riscv-isa-sim.git] / 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 class encapsulates the processors and memory in a RISC-V machine.
19 class sim_t : public htif_t
20 {
21 public:
22 sim_t(const char* isa, size_t _nprocs, bool halted, reg_t start_pc,
23 std::vector<std::pair<reg_t, mem_t*>> mems,
24 const std::vector<std::string>& args);
25 ~sim_t();
26
27 // run the simulation to completion
28 int run();
29 void set_debug(bool value);
30 void set_log(bool value);
31 void set_histogram(bool value);
32 void set_procs_debug(bool value);
33 void set_remote_bitbang(remote_bitbang_t* remote_bitbang) {
34 this->remote_bitbang = remote_bitbang;
35 }
36 const char* get_dts() { if (dts.empty()) reset(); return dts.c_str(); }
37 processor_t* get_core(size_t i) { return procs.at(i); }
38 unsigned nprocs() const { return procs.size(); }
39
40 debug_module_t debug_module;
41
42 private:
43 std::vector<std::pair<reg_t, mem_t*>> mems;
44 mmu_t* debug_mmu; // debug port into main memory
45 std::vector<processor_t*> procs;
46 reg_t start_pc;
47 std::string dts;
48 std::unique_ptr<rom_device_t> boot_rom;
49 std::unique_ptr<clint_t> clint;
50 bus_t bus;
51
52 processor_t* get_core(const std::string& i);
53 void step(size_t n); // step through simulation
54 static const size_t INTERLEAVE = 5000;
55 static const size_t INSNS_PER_RTC_TICK = 100; // 10 MHz clock for 1 BIPS core
56 static const size_t CPU_HZ = 1000000000; // 1GHz CPU
57 size_t current_step;
58 size_t current_proc;
59 bool debug;
60 bool log;
61 bool histogram_enabled; // provide a histogram of PCs
62 remote_bitbang_t* remote_bitbang;
63
64 // memory-mapped I/O routines
65 char* addr_to_mem(reg_t addr);
66 bool mmio_load(reg_t addr, size_t len, uint8_t* bytes);
67 bool mmio_store(reg_t addr, size_t len, const uint8_t* bytes);
68 void make_dtb();
69
70 // presents a prompt for introspection into the simulation
71 void interactive();
72
73 // functions that help implement interactive()
74 void interactive_help(const std::string& cmd, const std::vector<std::string>& args);
75 void interactive_quit(const std::string& cmd, const std::vector<std::string>& args);
76 void interactive_run(const std::string& cmd, const std::vector<std::string>& args, bool noisy);
77 void interactive_run_noisy(const std::string& cmd, const std::vector<std::string>& args);
78 void interactive_run_silent(const std::string& cmd, const std::vector<std::string>& args);
79 void interactive_reg(const std::string& cmd, const std::vector<std::string>& args);
80 void interactive_freg(const std::string& cmd, const std::vector<std::string>& args);
81 void interactive_fregs(const std::string& cmd, const std::vector<std::string>& args);
82 void interactive_fregd(const std::string& cmd, const std::vector<std::string>& args);
83 void interactive_pc(const std::string& cmd, const std::vector<std::string>& args);
84 void interactive_mem(const std::string& cmd, const std::vector<std::string>& args);
85 void interactive_str(const std::string& cmd, const std::vector<std::string>& args);
86 void interactive_until(const std::string& cmd, const std::vector<std::string>& args);
87 reg_t get_reg(const std::vector<std::string>& args);
88 freg_t get_freg(const std::vector<std::string>& args);
89 reg_t get_mem(const std::vector<std::string>& args);
90 reg_t get_pc(const std::vector<std::string>& args);
91
92 friend class processor_t;
93 friend class mmu_t;
94
95 // htif
96 friend void sim_thread_main(void*);
97 void main();
98
99 context_t* host;
100 context_t target;
101 void reset();
102 void idle();
103 void read_chunk(addr_t taddr, size_t len, void* dst);
104 void write_chunk(addr_t taddr, size_t len, const void* src);
105 size_t chunk_align() { return 8; }
106 size_t chunk_max_size() { return 8; }
107 };
108
109 extern volatile bool ctrlc_pressed;
110
111 #endif