Show HN: JPDB, GDB for Your Waveforms

Summary

JPDB: GDB for waveforms JPDB is a GDB inspired debugger for debugging pre-silicon CPUs. you can step through code, add breakpoints, and look at waveform values as you do. pretty neat ! Example Usage to get started a waveform a python mapping file, that translates signals in the waveform the elf file that is being executed in the waveform jpdb test_data/ibex/sim.fst --mapping-path test_data/ibex/signal_get.py --elf test_data/ibex/hello_test.elf requirements your system python must be 3.10 or newer, otherwise jpdb might bark at you and not work if you want to use any of the surfer features, you should have surfer installed and on $PATH. WCP support is required for surfer integration installation jpdb can be installed via cargo cargo install --git https://github.com/1024bees/dang jpdb the releases page on github mapping file The mapping file for JPDB is the translation layer that makes signals understandable for JPDB's internal gdb server stub. the mapping file MUST contain a function named get_gdb_signals that returns a python dict . The returned python dictionary MUST contain the following keys: pc: signal for the current retired pc x0-x31: signals for each architectural general purpose register an example mapping file is below pc = wave . get_signal_from_path ( "TOP.ibex_simple_system.u_top.u_ibex_top.u_ibex_core.wb_stage_i.pc_wb_o" ) gprs = { f"x { i } " : wave . get_signal_from_path ( f"TOP.ibex_simple_system.u_top.u_ibex_top.gen_regfile_ff.register_file_i.rf_reg.[ { i } ]" ). sliced ( 0 , 31 ) for i in range ( 32 ) } rv = { "pc" : pc , ** gprs } return rv To just verify that the mapping file is well formed, you can execute jpdb test_data/ibex/sim.fst --mapping-path test_data/ibex/signal_get.py --verify-only although this will happen when you launch jpdb normally FAQ does JPDB support superscalar CPUs? not yet, but if you give me a wave dump of a superscalar CPU, i will add support and thank you kindly what instruction sets are supported? only RV32G, but if you ha...