1#*************************************************************************************** 2# Copyright (c) 2024 Beijing Institute of Open Source Chip (BOSC) 3# Copyright (c) 2020-2024 Institute of Computing Technology, Chinese Academy of Sciences 4# Copyright (c) 2020-2021 Peng Cheng Laboratory 5# 6# XiangShan is licensed under Mulan PSL v2. 7# You can use this software according to the terms and conditions of the Mulan PSL v2. 8# You may obtain a copy of Mulan PSL v2 at: 9# http://license.coscl.org.cn/MulanPSL2 10# 11# THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, 12# EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, 13# MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. 14# 15# See the Mulan PSL v2 for more details. 16#*************************************************************************************** 17 18# Simple version of xiangshan python wrapper 19 20import argparse 21import json 22import os 23import random 24import signal 25import subprocess 26import sys 27import time 28import shlex 29import psutil 30 31 32def load_all_gcpt(gcpt_path, json_path): 33 all_gcpt = [] 34 with open(json_path) as f: 35 data = json.load(f) 36 for benchspec in data: 37 for point in data[benchspec]: 38 weight = data[benchspec][point] 39 gcpt = os.path.join(gcpt_path, "_".join([benchspec, point, weight])) 40 bin_dir = os.path.join(gcpt, "0") 41 bin_file = list(os.listdir(bin_dir)) 42 assert(len(bin_file) == 1) 43 bin_path = os.path.join(bin_dir, bin_file[0]) 44 assert(os.path.isfile(bin_path)) 45 all_gcpt.append(bin_path) 46 return all_gcpt 47 48class XSArgs(object): 49 script_path = os.path.realpath(__file__) 50 # default path to the repositories 51 noop_home = os.path.join(os.path.dirname(script_path), "..") 52 nemu_home = os.path.join(noop_home, "../NEMU") 53 am_home = os.path.join(noop_home, "../nexus-am") 54 dramsim3_home = os.path.join(noop_home, "../DRAMsim3") 55 rvtest_home = os.path.join(noop_home, "../riscv-tests") 56 default_wave_home = os.path.join(noop_home, "build") 57 wave_home = default_wave_home 58 59 def __init__(self, args): 60 # all path environment variables that should be set 61 all_path = [ 62 # (python argument, environment variable, default, target function) 63 (None, "NOOP_HOME", self.noop_home, self.set_noop_home), 64 (args.nemu, "NEMU_HOME", self.nemu_home, self.set_nemu_home), 65 (args.am, "AM_HOME", self.am_home, self.set_am_home), 66 (args.dramsim3, "DRAMSIM3_HOME", self.dramsim3_home, self.set_dramsim3_home), 67 (args.rvtest, "RVTEST_HOME", self.rvtest_home, self.set_rvtest_home), 68 ] 69 for (arg_in, env, default, set_func) in all_path: 70 set_func(self.__extract_path(arg_in, env, default)) 71 # Chisel arguments 72 self.enable_log = args.enable_log 73 self.num_cores = args.num_cores 74 # Makefile arguments 75 self.threads = args.threads 76 self.with_dramsim3 = 1 if args.with_dramsim3 else None 77 self.is_release = 1 if args.release else None 78 self.is_spike = "Spike" if args.spike else None 79 self.trace = 1 if args.trace or not args.disable_fork and not args.trace_fst else None 80 self.trace_fst = "fst" if args.trace_fst else None 81 self.config = args.config 82 self.emu_optimize = args.emu_optimize 83 self.xprop = 1 if args.xprop else None 84 self.with_chiseldb = 0 if args.no_db else None 85 # emu arguments 86 self.max_instr = args.max_instr 87 self.ram_size = args.ram_size 88 self.seed = random.randint(0, 9999) 89 self.numa = args.numa 90 self.diff = args.diff 91 if args.spike and "nemu" in args.diff: 92 self.diff = self.diff.replace("nemu-interpreter", "spike") 93 self.fork = not args.disable_fork 94 self.disable_diff = args.no_diff 95 self.disable_db = args.no_db 96 self.gcpt_restore_bin = args.gcpt_restore_bin 97 self.pgo = args.pgo 98 self.pgo_max_cycle = args.pgo_max_cycle 99 self.pgo_emu_args = args.pgo_emu_args 100 self.llvm_profdata = args.llvm_profdata 101 # wave dump path 102 if args.wave_dump is not None: 103 self.set_wave_home(args.wave_dump) 104 else: 105 self.set_wave_home(self.default_wave_home) 106 107 def get_env_variables(self): 108 all_env = { 109 "NOOP_HOME" : self.noop_home, 110 "NEMU_HOME" : self.nemu_home, 111 "WAVE_HOME" : self.wave_home, 112 "AM_HOME" : self.am_home, 113 "DRAMSIM3_HOME": self.dramsim3_home, 114 "MODULEPATH": "/usr/share/Modules/modulefiles:/etc/modulefiles" 115 } 116 return all_env 117 118 def get_chisel_args(self, prefix=None): 119 chisel_args = [ 120 (self.enable_log, "enable-log") 121 ] 122 args = map(lambda x: x[1], filter(lambda arg: arg[0], chisel_args)) 123 if prefix is not None: 124 args = map(lambda x: prefix + x, args) 125 return args 126 127 def get_makefile_args(self): 128 makefile_args = [ 129 (self.threads, "EMU_THREADS"), 130 (self.with_dramsim3, "WITH_DRAMSIM3"), 131 (self.is_release, "RELEASE"), 132 (self.is_spike, "REF"), 133 (self.trace, "EMU_TRACE"), 134 (self.trace_fst, "EMU_TRACE"), 135 (self.config, "CONFIG"), 136 (self.num_cores, "NUM_CORES"), 137 (self.emu_optimize, "EMU_OPTIMIZE"), 138 (self.xprop, "ENABLE_XPROP"), 139 (self.with_chiseldb, "WITH_CHISELDB"), 140 (self.pgo, "PGO_WORKLOAD"), 141 (self.pgo_max_cycle, "PGO_MAX_CYCLE"), 142 (self.pgo_emu_args, "PGO_EMU_ARGS"), 143 (self.llvm_profdata, "LLVM_PROFDATA"), 144 ] 145 args = filter(lambda arg: arg[0] is not None, makefile_args) 146 args = [(shlex.quote(str(arg[0])), arg[1]) for arg in args] # shell escape 147 return args 148 149 def get_emu_args(self): 150 emu_args = [ 151 (self.max_instr, "max-instr"), 152 (self.diff, "diff"), 153 (self.seed, "seed"), 154 (self.ram_size, "ram-size"), 155 ] 156 args = filter(lambda arg: arg[0] is not None, emu_args) 157 return args 158 159 def show(self): 160 print("Extra environment variables:") 161 env = self.get_env_variables() 162 for env_name in env: 163 print(f"{env_name}: {env[env_name]}") 164 print() 165 print("Chisel arguments:") 166 print(" ".join(self.get_chisel_args())) 167 print() 168 print("Makefile arguments:") 169 for val, name in self.get_makefile_args(): 170 print(f"{name}={val}") 171 print() 172 print("emu arguments:") 173 for val, name in self.get_emu_args(): 174 print(f"--{name} {val}") 175 print() 176 177 def __extract_path(self, path, env=None, default=None): 178 if path is None and env is not None: 179 path = os.getenv(env) 180 if path is None and default is not None: 181 path = default 182 path = os.path.realpath(path) 183 return path 184 185 def set_noop_home(self, path): 186 self.noop_home = path 187 188 def set_nemu_home(self, path): 189 self.nemu_home = path 190 191 def set_am_home(self, path): 192 self.am_home = path 193 194 def set_dramsim3_home(self, path): 195 self.dramsim3_home = path 196 197 def set_rvtest_home(self, path): 198 self.rvtest_home = path 199 200 def set_wave_home(self, path): 201 print(f"set wave home to {path}") 202 self.wave_home = path 203 204# XiangShan environment 205class XiangShan(object): 206 def __init__(self, args): 207 self.args = XSArgs(args) 208 self.timeout = args.timeout 209 210 def show(self): 211 self.args.show() 212 213 def make_clean(self): 214 print("Clean up CI workspace") 215 self.show() 216 return_code = self.__exec_cmd(f'make -C $NOOP_HOME clean') 217 return return_code 218 219 def generate_verilog(self): 220 print("Generating XiangShan verilog with the following configurations:") 221 self.show() 222 sim_args = " ".join(self.args.get_chisel_args(prefix="--")) 223 make_args = " ".join(map(lambda arg: f"{arg[1]}={arg[0]}", self.args.get_makefile_args())) 224 return_code = self.__exec_cmd(f'make -C $NOOP_HOME verilog SIM_ARGS="{sim_args}" {make_args}') 225 return return_code 226 227 def generate_sim_verilog(self): 228 print("Generating XiangShan sim-verilog with the following configurations:") 229 self.show() 230 sim_args = " ".join(self.args.get_chisel_args(prefix="--")) 231 make_args = " ".join(map(lambda arg: f"{arg[1]}={arg[0]}", self.args.get_makefile_args())) 232 return_code = self.__exec_cmd(f'make -C $NOOP_HOME sim-verilog SIM_ARGS="{sim_args}" {make_args}') 233 return return_code 234 235 def build_emu(self): 236 print("Building XiangShan emu with the following configurations:") 237 self.show() 238 sim_args = " ".join(self.args.get_chisel_args(prefix="--")) 239 make_args = " ".join(map(lambda arg: f"{arg[1]}={arg[0]}", self.args.get_makefile_args())) 240 return_code = self.__exec_cmd(f'make -C $NOOP_HOME emu -j200 SIM_ARGS="{sim_args}" {make_args}') 241 return return_code 242 243 def build_simv(self): 244 print("Building XiangShan simv with the following configurations") 245 self.show() 246 make_args = " ".join(map(lambda arg: f"{arg[1]}={arg[0]}", self.args.get_makefile_args())) 247 # TODO: make the following commands grouped as unseen scripts 248 return_code = self.__exec_cmd(f'\ 249 eval `/usr/bin/modulecmd zsh load license`;\ 250 eval `/usr/bin/modulecmd zsh load synopsys/vcs/Q-2020.03-SP2`;\ 251 eval `/usr/bin/modulecmd zsh load synopsys/verdi/S-2021.09-SP1`;\ 252 VERDI_HOME=/nfs/tools/synopsys/verdi/S-2021.09-SP1 \ 253 make -C $NOOP_HOME simv {make_args} CONSIDER_FSDB=1') # set CONSIDER_FSDB for compatibility 254 return return_code 255 256 def run_emu(self, workload): 257 print("Running XiangShan emu with the following configurations:") 258 self.show() 259 emu_args = " ".join(map(lambda arg: f"--{arg[1]} {arg[0]}", self.args.get_emu_args())) 260 print("workload:", workload) 261 numa_args = "" 262 if self.args.numa: 263 numa_info = get_free_cores(self.args.threads) 264 numa_args = f"numactl -m {numa_info[0]} -C {numa_info[1]}-{numa_info[2]}" 265 fork_args = "--enable-fork" if self.args.fork else "" 266 diff_args = "--no-diff" if self.args.disable_diff else "" 267 chiseldb_args = "--dump-db" if not self.args.disable_db else "" 268 gcpt_restore_args = f"-r {self.args.gcpt_restore_bin}" if len(self.args.gcpt_restore_bin) != 0 else "" 269 return_code = self.__exec_cmd(f'ulimit -s {32 * 1024}; {numa_args} $NOOP_HOME/build/emu -i {workload} {emu_args} {fork_args} {diff_args} {chiseldb_args} {gcpt_restore_args}') 270 return return_code 271 272 def run_simv(self, workload): 273 print("Running XiangShan simv with the following configurations:") 274 self.show() 275 diff_args = "$NOOP_HOME/"+ args.diff 276 assert_args = "-assert finish_maxfail=30 -assert global_finish_maxfail=10000" 277 return_code = self.__exec_cmd(f'cd $NOOP_HOME/build && ./simv +workload={workload} +diff={diff_args} +dump-wave=fsdb {assert_args} | tee simv.log') 278 with open(f"{self.args.noop_home}/build/simv.log") as f: 279 content = f.read() 280 if "Offending" in content or "HIT GOOD TRAP" not in content: 281 return 1 282 return return_code 283 284 def run(self, args): 285 if args.ci is not None: 286 return self.run_ci(args.ci) 287 if args.ci_vcs is not None: 288 return self.run_ci_vcs(args.ci_vcs) 289 actions = [ 290 (args.generate, lambda _ : self.generate_verilog()), 291 (args.vcs_gen, lambda _ : self.generate_sim_verilog()), 292 (args.build, lambda _ : self.build_emu()), 293 (args.vcs_build, lambda _ : self.build_simv()), 294 (args.workload, lambda args: self.run_emu(args.workload)), 295 (args.clean, lambda _ : self.make_clean()) 296 ] 297 valid_actions = map(lambda act: act[1], filter(lambda act: act[0], actions)) 298 for i, action in enumerate(valid_actions): 299 print(f"Action {i}:") 300 ret = action(args) 301 if ret: 302 return ret 303 return 0 304 305 def __exec_cmd(self, cmd): 306 env = dict(os.environ) 307 env.update(self.args.get_env_variables()) 308 print("subprocess call cmd:", cmd) 309 start = time.time() 310 proc = subprocess.Popen(cmd, shell=True, env=env, preexec_fn=os.setsid) 311 try: 312 return_code = proc.wait(self.timeout) 313 end = time.time() 314 print(f"Elapsed time: {end - start} seconds") 315 return return_code 316 except (KeyboardInterrupt, subprocess.TimeoutExpired): 317 os.killpg(os.getpgid(proc.pid), signal.SIGINT) 318 print(f"KeyboardInterrupt or TimeoutExpired.") 319 return 0 320 321 def __get_ci_cputest(self, name=None): 322 base_dir = os.path.join(self.args.am_home, "tests/cputest/build") 323 cputest = os.listdir(base_dir) 324 cputest = filter(lambda x: x.endswith(".bin"), cputest) 325 cputest = map(lambda x: os.path.join(base_dir, x), cputest) 326 return cputest 327 328 def __get_ci_rvtest(self, name=None): 329 base_dir = os.path.join(self.args.rvtest_home, "isa/build") 330 riscv_tests = os.listdir(base_dir) 331 riscv_tests = filter(lambda x: x.endswith(".bin"), riscv_tests) 332 all_rv_tests = ["rv64ui", "rv64um", "rv64ua", "rv64uf", "rv64ud"] 333 riscv_tests = filter(lambda x: x[:6] in all_rv_tests, riscv_tests) 334 riscv_tests = map(lambda x: os.path.join(base_dir, x), riscv_tests) 335 return riscv_tests 336 337 def __get_ci_misc(self, name=None): 338 base_dir = "/nfs/home/share/ci-workloads" 339 workloads = [ 340 "bitmanip/bitMisc.bin", 341 "crypto/crypto-riscv64-noop.bin", 342 "coremark_rv64gc_o2/coremark-riscv64-xs.bin", 343 "coremark_rv64gc_o3/coremark-riscv64-xs.bin", 344 "coremark_rv64gcb_o3/coremark-riscv64-xs.bin", 345 "ext_intr/amtest-riscv64-xs.bin", 346 "cache-alias/aliastest-riscv64-xs.bin", 347 "Svinval/rv64mi-p-svinval.bin", 348 "pmp/pmp.riscv.bin", 349 "pmp/pmp-am/amtest-riscv64-xs.bin", 350 "pmp/hugepage-pmp-atom/amtest-riscv64-xs.bin", 351 "asid/asid.bin", 352 "isa_misc/xret_clear_mprv.bin", 353 "isa_misc/satp_ppn.bin", 354 "cache-management/softprefetchtest-riscv64-xs.bin" 355 ] 356 misc_tests = map(lambda x: os.path.join(base_dir, x), workloads) 357 return misc_tests 358 359 def __get_ci_rvvbench(self, name=None): 360 base_dir = "/nfs/home/share/ci-workloads" 361 workloads = [ 362 "rvv-bench/poly1305.bin", 363 "rvv-bench/mergelines.bin" 364 ] 365 rvvbench = map(lambda x: os.path.join(base_dir, x), workloads) 366 return rvvbench 367 368 def __get_ci_rvvtest(self, name=None): 369 base_dir = "/nfs/home/share/ci-workloads/V-extension-tests" 370 workloads = [ 371 "rvv-test/vluxei32.v-0.bin", 372 "rvv-test/vlsseg4e32.v-0.bin", 373 "rvv-test/vlseg4e32.v-0.bin", 374 "rvv-test/vsetvl-0.bin", 375 "rvv-test/vsetivli-0.bin", 376 "rvv-test/vsuxei32.v-0.bin", 377 "rvv-test/vse16.v-0.bin", 378 "rvv-test/vsse16.v-1.bin", 379 "rvv-test/vlse32.v-0.bin", 380 "rvv-test/vsetvli-0.bin", 381 "rvv-test/vle16.v-0.bin", 382 "rvv-test/vle32.v-0.bin", 383 "rvv-test/vfsgnj.vv-0.bin", 384 "rvv-test/vfadd.vf-0.bin", 385 "rvv-test/vfsub.vf-0.bin", 386 "rvv-test/vslide1down.vx-0.bin" 387 ] 388 rvv_test = map(lambda x: os.path.join(base_dir, x), workloads) 389 return rvv_test 390 391 def __get_ci_mc(self, name=None): 392 base_dir = "/nfs/home/share/ci-workloads" 393 workloads = [ 394 "dualcoretest/ldvio-riscv64-xs.bin" 395 ] 396 mc_tests = map(lambda x: os.path.join(base_dir, x), workloads) 397 return mc_tests 398 399 def __get_ci_nodiff(self, name=None): 400 base_dir = "/nfs/home/share/ci-workloads" 401 workloads = [ 402 "cache-management/cacheoptest-riscv64-xs.bin" 403 ] 404 tests = map(lambda x: os.path.join(base_dir, x), workloads) 405 return tests 406 407 def __am_apps_path(self, bench): 408 filename = f"{bench}-riscv64-noop.bin" 409 return [os.path.join(self.args.am_home, "apps", bench, "build", filename)] 410 411 def __get_ci_workloads(self, name): 412 workloads = { 413 "linux-hello": "bbl.bin", 414 "linux-hello-smp": "bbl.bin", 415 "linux-hello-opensbi": "fw_payload.bin", 416 "linux-hello-smp-opensbi": "fw_payload.bin", 417 "linux-hello-new": "bbl.bin", 418 "linux-hello-smp-new": "bbl.bin", 419 "linux-hello-smp-newcsr": "bbl.bin", 420 "povray": "_700480000000_.gz", 421 "mcf": "_17520000000_.gz", 422 "xalancbmk": "_266100000000_.gz", 423 "gcc": "_39720000000_.gz", 424 "namd": "_434640000000_.gz", 425 "milc": "_103620000000_.gz", 426 "lbm": "_140840000000_.gz", 427 "gromacs": "_275480000000_.gz", 428 "wrf": "_1916220000000_.gz", 429 "astar": "_122060000000_.gz" 430 } 431 if name in workloads: 432 return [os.path.join("/nfs/home/share/ci-workloads", name, workloads[name])] 433 # select a random SPEC checkpoint 434 assert(name == "random") 435 all_cpt = [ 436 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gcb_o2_20m/take_cpt", 437 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gcb_o3_20m/take_cpt", 438 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gc_o2_20m/take_cpt", 439 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gc_o2_50m/take_cpt", 440 "/nfs-nvme/home/share/checkpoints_profiles/spec17_rv64gcb_o2_20m/take_cpt", 441 "/nfs-nvme/home/share/checkpoints_profiles/spec17_rv64gcb_o3_20m/take_cpt", 442 "/nfs-nvme/home/share/checkpoints_profiles/spec17_rv64gc_o2_50m/take_cpt", 443 "/nfs-nvme/home/share/checkpoints_profiles/spec17_speed_rv64gcb_o3_20m/take_cpt" 444 ] 445 all_json = [ 446 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gcb_o2_20m/json/simpoint_summary.json", 447 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gcb_o3_20m/simpoint_summary.json", 448 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gc_o2_20m/simpoint_summary.json", 449 "/nfs-nvme/home/share/checkpoints_profiles/spec06_rv64gc_o2_50m/simpoint_summary.json", 450 "/nfs-nvme/home/share/checkpoints_profiles/spec17_rv64gcb_o2_20m/simpoint_summary.json", 451 "/nfs-nvme/home/share/checkpoints_profiles/spec17_rv64gcb_o3_20m/simpoint_summary.json", 452 "/nfs-nvme/home/share/checkpoints_profiles/spec17_rv64gc_o2_50m/simpoint_summary.json", 453 "/nfs-nvme/home/share/checkpoints_profiles/spec17_speed_rv64gcb_o3_20m/simpoint_summary.json" 454 ] 455 assert(len(all_cpt) == len(all_json)) 456 cpt_path, json_path = random.choice(list(zip(all_cpt, all_json))) 457 all_gcpt = load_all_gcpt(cpt_path, json_path) 458 return [random.choice(all_gcpt)] 459 460 def run_ci(self, test): 461 all_tests = { 462 "cputest": self.__get_ci_cputest, 463 "riscv-tests": self.__get_ci_rvtest, 464 "misc-tests": self.__get_ci_misc, 465 "mc-tests": self.__get_ci_mc, 466 "nodiff-tests": self.__get_ci_nodiff, 467 "microbench": self.__am_apps_path, 468 "coremark": self.__am_apps_path, 469 "rvv-bench": self.__get_ci_rvvbench, 470 "rvv-test": self.__get_ci_rvvtest 471 } 472 for target in all_tests.get(test, self.__get_ci_workloads)(test): 473 print(target) 474 ret = self.run_emu(target) 475 if ret: 476 if self.args.default_wave_home != self.args.wave_home: 477 print("copy wave file to " + self.args.wave_home) 478 self.__exec_cmd(f"cp $NOOP_HOME/build/*.vcd $WAVE_HOME") 479 self.__exec_cmd(f"cp $NOOP_HOME/build/emu $WAVE_HOME") 480 self.__exec_cmd(f"cp $NOOP_HOME/build/rtl/SimTop.v $WAVE_HOME") 481 self.__exec_cmd(f"cp $NOOP_HOME/build/*.db $WAVE_HOME") 482 return ret 483 return 0 484 485 def run_ci_vcs(self, test): 486 all_tests = { 487 "cputest": self.__get_ci_cputest, 488 "riscv-tests": self.__get_ci_rvtest, 489 "misc-tests": self.__get_ci_misc, 490 "mc-tests": self.__get_ci_mc, 491 "nodiff-tests": self.__get_ci_nodiff, 492 "microbench": self.__am_apps_path, 493 "coremark": self.__am_apps_path, 494 "rvv-bench": self.__get_ci_rvvbench, 495 "rvv-test": self.__get_ci_rvvtest 496 } 497 for target in all_tests.get(test, self.__get_ci_workloads)(test): 498 print(target) 499 ret = self.run_simv(target) 500 if ret: 501 if self.args.default_wave_home != self.args.wave_home: 502 print("copy wave file to " + self.args.wave_home) 503 self.__exec_cmd(f"cp $NOOP_HOME/build/*.fsdb $WAVE_HOME") 504 self.__exec_cmd(f"cp $NOOP_HOME/build/simv $WAVE_HOME") 505 self.__exec_cmd(f"cp $NOOP_HOME/build/rtl/SimTop.v $WAVE_HOME") 506 self.__exec_cmd(f"cp $NOOP_HOME/build/*.db $WAVE_HOME") 507 return ret 508 return 0 509 510def get_free_cores(n): 511 while True: 512 # To avoid potential conflicts, we allow CI to use SMT. 513 num_logical_core = psutil.cpu_count(logical=False) 514 core_usage = psutil.cpu_percent(interval=1, percpu=True) 515 num_window = num_logical_core // n 516 for i in range(num_window): 517 window_usage = core_usage[i * n : i * n + n] 518 if sum(window_usage) < 30 * n and True not in map(lambda x: x > 90, window_usage): 519 return (((i * n) % 128)// 64, i * n, i * n + n - 1) 520 print(f"No free {n} cores found. CPU usage: {core_usage}\n") 521 522if __name__ == "__main__": 523 parser = argparse.ArgumentParser(description='Python wrapper for XiangShan') 524 parser.add_argument('workload', nargs='?', type=str, default="", 525 help='input workload file in binary format') 526 # actions 527 parser.add_argument('--build', action='store_true', help='build XS emu') 528 parser.add_argument('--generate', action='store_true', help='generate XS verilog') 529 parser.add_argument('--vcs-gen', action='store_true', help='generate XS sim verilog for vcs') 530 parser.add_argument('--vcs-build', action='store_true', help='build XS simv') 531 parser.add_argument('--ci', nargs='?', type=str, const="", help='run CI tests') 532 parser.add_argument('--ci-vcs', nargs='?', type=str, const="", help='run CI tests on simv') 533 parser.add_argument('--clean', action='store_true', help='clean up XiangShan CI workspace') 534 parser.add_argument('--timeout', nargs='?', type=int, default=None, help='timeout (in seconds)') 535 # environment variables 536 parser.add_argument('--nemu', nargs='?', type=str, help='path to nemu') 537 parser.add_argument('--am', nargs='?', type=str, help='path to nexus-am') 538 parser.add_argument('--dramsim3', nargs='?', type=str, help='path to dramsim3') 539 parser.add_argument('--rvtest', nargs='?', type=str, help='path to riscv-tests') 540 parser.add_argument('--wave-dump', nargs='?', type=str , help='path to dump wave') 541 # chisel arguments 542 parser.add_argument('--enable-log', action='store_true', help='enable log') 543 parser.add_argument('--num-cores', type=int, help='number of cores') 544 # makefile arguments 545 parser.add_argument('--release', action='store_true', help='enable release') 546 parser.add_argument('--spike', action='store_true', help='enable spike diff') 547 parser.add_argument('--with-dramsim3', action='store_true', help='enable dramsim3') 548 parser.add_argument('--threads', nargs='?', type=int, help='number of emu threads') 549 parser.add_argument('--trace', action='store_true', help='enable vcd waveform') 550 parser.add_argument('--trace-fst', action='store_true', help='enable fst waveform') 551 parser.add_argument('--config', nargs='?', type=str, help='config') 552 parser.add_argument('--emu-optimize', nargs='?', type=str, help='verilator optimization letter') 553 parser.add_argument('--xprop', action='store_true', help='enable xprop for vcs') 554 # emu arguments 555 parser.add_argument('--numa', action='store_true', help='use numactl') 556 parser.add_argument('--diff', nargs='?', default="./ready-to-run/riscv64-nemu-interpreter-so", type=str, help='nemu so') 557 parser.add_argument('--max-instr', nargs='?', type=int, help='max instr') 558 parser.add_argument('--disable-fork', action='store_true', help='disable lightSSS') 559 parser.add_argument('--no-diff', action='store_true', help='disable difftest') 560 parser.add_argument('--ram-size', nargs='?', type=str, help='manually set simulation memory size (8GB by default)') 561 parser.add_argument('--gcpt-restore-bin', type=str, default="", help="specify the bin used to restore from gcpt") 562 # both makefile and emu arguments 563 parser.add_argument('--no-db', action='store_true', help='disable chiseldb dump') 564 parser.add_argument('--pgo', nargs='?', type=str, help='workload for pgo (null to disable pgo)') 565 parser.add_argument('--pgo-max-cycle', nargs='?', default=400000, type=int, help='maximun cycle to train pgo') 566 parser.add_argument('--pgo-emu-args', nargs='?', default='--no-diff', type=str, help='emu arguments for pgo') 567 parser.add_argument('--llvm-profdata', nargs='?', type=str, help='corresponding llvm-profdata command of clang to compile emu, do not set with GCC') 568 569 args = parser.parse_args() 570 571 xs = XiangShan(args) 572 ret = xs.run(args) 573 574 sys.exit(ret) 575