import random
import binascii
+
MSTATUS_UIE = 0x00000001
MSTATUS_SIE = 0x00000002
MSTATUS_HIE = 0x00000004
MSTATUS32_SD = 0x80000000
MSTATUS64_SD = 0x8000000000000000
-def gdb():
+def gdb(
+ target=None,
+ port=None,
+ binary=None
+ ):
+
+ gdb = None
if parsed.gdb:
- return testlib.Gdb(parsed.gdb)
+ gdb = testlib.Gdb(parsed.gdb)
else:
- return testlib.Gdb()
+ gdb = testlib.Gdb()
+
+ if (binary):
+ gdb.command("file %s" % self.binary)
+ if (target):
+ gdb.command("set arch riscv:rv%d" % target.xlen)
+ gdb.command("set remotetimeout %d" % target.timeout_sec)
+ if (port):
+ gdb.command("target extended-remote localhost:%d" % port)
+
+ return gdb
+
def ihex_line(address, record_type, data):
assert len(data) < 128
line = ":%02X%04X%02X" % (len(data), address, record_type)
class SimpleRegisterTest(DeleteServer):
def setUp(self):
self.server = target.server()
- self.gdb = gdb()
- # For now gdb has to be told what the architecture is when it's not
- # given an ELF file.
- self.gdb.command("set arch riscv:rv%d" % target.xlen)
-
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port)
# 0x13 is nop
self.gdb.command("p *((int*) 0x%x)=0x13" % target.ram)
class SimpleMemoryTest(DeleteServer):
def setUp(self):
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("set arch riscv:rv%d" % target.xlen)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port)
def access_test(self, size, data_type):
self.assertEqual(self.gdb.p("sizeof(%s)" % data_type),
class InstantHaltTest(DeleteServer):
def setUp(self):
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("set arch riscv:rv%d" % target.xlen)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
-
+ self.gdb = gdb(target, self.server.port)
+
def test_instant_halt(self):
self.assertEqual(target.reset_vector, self.gdb.p("$pc"))
# mcycle and minstret have no defined reset value.
self.binary = target.compile("programs/debug.c", "programs/checksum.c",
"programs/tiny-malloc.c", "-DDEFINE_MALLOC", "-DDEFINE_FREE")
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("file %s" % self.binary)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port, self.binary)
self.gdb.load()
self.gdb.b("_exit")
def setUp(self):
self.binary = target.compile("programs/step.S")
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("file %s" % self.binary)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port, self.binary)
self.gdb.load()
self.gdb.b("main")
self.gdb.c()
def setUp(self):
self.binary = target.compile("programs/regs.S")
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("file %s" % self.binary)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port, self.binary)
self.gdb.load()
self.gdb.b("main")
self.gdb.b("handle_trap")
self.binary = target.compile(download_c.name, "programs/checksum.c")
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("file %s" % self.binary)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
-
+ self.gdb = gdb(target, self.server.port, self.binary)
+
def test_download(self):
output = self.gdb.load()
self.gdb.command("b _exit")
def setUp(self):
self.binary = target.compile("programs/mprv.S")
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("file %s" % self.binary)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port, self.binary)
self.gdb.load()
def test_mprv(self):
def setUp(self):
self.binary = target.compile("programs/priv.S")
self.server = target.server()
- self.gdb = gdb()
- self.gdb.command("file %s" % self.binary)
- self.gdb.command("target extended-remote localhost:%d" % self.server.port)
+ self.gdb = gdb(target, self.server.port, self.binary)
self.gdb.load()
misa = self.gdb.p("$misa")
class Target(object):
directory = None
-
+ timeout_sec = 2
+
def server(self):
raise NotImplementedError
return testlib.Openocd(cmd=parsed.cmd,
config="targets/%s/openocd.cfg" % self.name)
+class FreedomE300SimTarget(Target):
+ name = "freedom-e300-sim"
+ xlen = 32
+ timeout_sec = 240
+ ram = 0x80000000
+ ram_size = 256 * 1024 * 1024
+ instruction_hardware_breakpoint_count = 2
+
+ def server(self):
+ sim = testlib.VcsSim(simv=parsed.run, debug=False)
+ openocd = testlib.Openocd(cmd=parsed.cmd,
+ config="targets/%s/openocd.cfg" % self.name,
+ otherProcess = sim)
+ time.sleep(20)
+ return openocd
+
+class FreedomU500Target(Target):
+ name = "freedom-u500"
+ xlen = 64
+ ram = 0x80000000
+ ram_size = 16 * 1024
+ instruction_hardware_breakpoint_count = 2
+
+ def server(self):
+ return testlib.Openocd(cmd=parsed.cmd,
+ config="targets/%s/openocd.cfg" % self.name)
+
+class FreedomU500SimTarget(Target):
+ name = "freedom-u500-sim"
+ xlen = 64
+ timeout_sec = 240
+ ram = 0x80000000
+ ram_size = 256 * 1024 * 1024
+ instruction_hardware_breakpoint_count = 2
+
+ def server(self):
+ sim = testlib.VcsSim(simv=parsed.run, debug=False)
+ openocd = testlib.Openocd(cmd=parsed.cmd,
+ config="targets/%s/openocd.cfg" % self.name,
+ otherProcess = sim)
+ time.sleep(20)
+ return openocd
+
targets = [
Spike32Target,
Spike64Target,
- FreedomE300Target
- ]
+ FreedomE300Target,
+ FreedomU500Target,
+ FreedomE300SimTarget,
+ FreedomU500SimTarget]
def main():
parser = argparse.ArgumentParser(
epilog="""
Example command line from the real world:
- Run all RegsTest cases against a MicroSemi m2gl_m2s board, with custom openocd command:
- ./gdbserver.py --m2gl_m2s --cmd "$HOME/SiFive/openocd/src/openocd -s $HOME/SiFive/openocd/tcl -d" -- -vf RegsTest
+ Run all RegsTest cases against a physical FPGA, with custom openocd command:
+ ./gdbserver.py --freedom-e-300 --cmd "$HOME/SiFive/openocd/src/openocd -s $HOME/SiFive/openocd/tcl -d" -- -vf RegsTest
""")
group = parser.add_mutually_exclusive_group(required=True)
for t in targets:
group.add_argument("--%s" % t.name, action="store_const", const=t,
dest="target")
+ parser.add_argument("--run",
+ help="The command to use to start the actual target (e.g. simulation)")
parser.add_argument("--cmd",
help="The command to use to start the debug server.")
parser.add_argument("--gdb",
# TROUBLESHOOTING TIPS
# If a particular test fails, run just that one test, eg.:
-# ./tests/gdbserver.py MprvTest.test_mprv
+# ./gdbserver.py MprvTest.test_mprv
# Then inspect gdb.log and spike.log to see what happened in more detail.
if __name__ == '__main__':
import tempfile
import testlib
import unittest
+import time
# Note that gdb comes with its own testsuite. I was unable to figure out how to
# run that testsuite against the spike simulator.
def wait(self, *args, **kwargs):
return self.process.wait(*args, **kwargs)
+class VcsSim(object):
+ def __init__(self, simv=None, debug=False):
+ if simv:
+ cmd = shlex.split(simv)
+ else:
+ cmd = ["simv"]
+ cmd += ["+jtag_vpi_enable"]
+ if debug:
+ cmd[0] = cmd[0] + "-debug"
+ cmd += ["+vcdplusfile=output/gdbserver.vpd"]
+ logfile = open("simv.log", "w")
+ logfile.write("+ %s\n" % " ".join(cmd))
+ logfile.flush()
+ listenfile = open("simv.log", "r")
+ listenfile.seek(0,2)
+ self.process = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=logfile,
+ stderr=logfile)
+ done = False
+ while (not done):
+ line = listenfile.readline()
+ if (not line):
+ time.sleep(1)
+ if ("Listening on port 5555" in line):
+ done = True
+
+ def __del__(self):
+ try:
+ self.process.kill()
+ self.process.wait()
+ except OSError:
+ pass
+
+
class Openocd(object):
- def __init__(self, cmd=None, config=None, debug=False):
+ def __init__(self, cmd=None, config=None, debug=False, otherProcess=None):
+
+ # keep handles to other processes -- don't let them be
+ # garbage collected yet.
+
+ self.otherProcess = otherProcess
if cmd:
cmd = shlex.split(cmd)
else: