mirror of
				https://github.com/openhwgroup/cvw
				synced 2025-02-11 06:05:49 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			228 lines
		
	
	
		
			7.8 KiB
		
	
	
	
		
			Python
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			228 lines
		
	
	
		
			7.8 KiB
		
	
	
	
		
			Python
		
	
	
		
			Executable File
		
	
	
	
	
| #!/usr/bin/python3
 | |
| ##################################
 | |
| # testgen-LOAD.py
 | |
| #
 | |
| # Jarred Allen <jaallen@g.hmc.edu> 02 February 2021
 | |
| #
 | |
| # Generate directed and random test vectors for RISC-V Design Validation.
 | |
| ##################################
 | |
| 
 | |
| ##################################
 | |
| # libraries
 | |
| ##################################
 | |
| from datetime import datetime
 | |
| from random import randint, seed, getrandbits
 | |
| 
 | |
| ##################################
 | |
| # functions
 | |
| ##################################
 | |
| 
 | |
| def rand_reg():
 | |
|   """Produce a random register (skipping 6 and 31, since they're used for other things)"""
 | |
|   r = randint(1,29)
 | |
|   if r >= 6:
 | |
|     r += 1
 | |
|   return r
 | |
| 
 | |
| def rand_value(width):
 | |
|     """Generate a random value which fits in the given width"""
 | |
|     return randint(0, (1 << width) - 1)
 | |
| 
 | |
| def rand_offset():
 | |
|     """Generate a random offset"""
 | |
|     ret = rand_value(12)
 | |
|     # print("Random offset: %d" % ret)
 | |
|     return ret
 | |
| 
 | |
| def rand_source():
 | |
|     """Generate a random value for the source register, such that the load address is in the test data"""
 | |
|     ret = randint(1 << 12, (1 << 12) + (1 << 10))
 | |
|     # print("Random source: %d" % ret)
 | |
|     return ret
 | |
| 
 | |
| def add_offset_to_source(source, offset):
 | |
|     """Find the address from the given source value and offset"""
 | |
|     if offset & 0x800:
 | |
|         offset -= 0x1000
 | |
|     return source + offset
 | |
| 
 | |
| def insert_into_data(test_data, source, offset, value, width, xlen):
 | |
|     """Insert the given value into the given location of the test data"""
 | |
|     address = add_offset_to_source(source, offset)
 | |
|     # print("Test #%d" % testcase_num)
 | |
|     # print(f"Source: {source}, Offset: {offset}, Value: {value}, Width: {width}, xlen: {xlen}, Addr: {address}")
 | |
|     if address < 0:
 | |
|         return False
 | |
|     word_offset = address % (xlen // 8)
 | |
|     word_address = address - word_offset
 | |
|     if word_address in test_data:
 | |
|         return False
 | |
|     test_data[word_address] = value * (1 << (word_offset*8)) + ((~(((1 << width)-1) << (word_offset*8))) & rand_value(xlen))
 | |
|     # print(f"Word: {hex(test_data[word_address])}")
 | |
|     return True
 | |
| 
 | |
| def align(address, width):
 | |
|     """Align the address to the given width, in bits"""
 | |
|     return address - (address % (width // 8))
 | |
| 
 | |
| testcase_num = 0
 | |
| def generate_case(xlen, instruction, load_register, source_register, source_register_value, offset, expected):
 | |
|     """Produce the specified test case and return it as a pair of strings, where the first is the test case and the second is the output"""
 | |
|     global testcase_num
 | |
|     if xlen == 64:
 | |
|         store = "sd"
 | |
|     elif xlen == 32:
 | |
|         if instruction in ["lwu", "ld"]:
 | |
|             raise Exception("Instruction %s not supported in RV32I" % instruction)
 | |
|         store = "sw"
 | |
|     else:
 | |
|         raise Exception("Unknown xlen value: %s" % xlen)
 | |
|     if offset >= 0x800:
 | |
|         offset -= 0x1000
 | |
|     if widths[instruction] != xlen:
 | |
|         expected = expected % (1 << widths[instruction])
 | |
|         if 'u' not in instruction:
 | |
|             if expected & (1 << (widths[instruction] - 1)):
 | |
|                 expected = (expected + ~((1 << widths[instruction]) - 1)) & ((1 << xlen) - 1)
 | |
|     data = f"""# Testcase {testcase_num}: source {offset}(x{source_register} == {source_register_value}), result: x{load_register} == {expected}
 | |
|     la x31, test_data
 | |
|     lui x{source_register}, {source_register_value // (1 << 12)}
 | |
|     addi x{source_register}, x{source_register}, {source_register_value % (1 << 12)} 
 | |
|     add x{source_register}, x{source_register}, x31
 | |
|     {instruction} x{load_register}, {offset}(x{source_register})
 | |
|     {store} x{load_register}, {(testcase_num*xlen//8) % 0x800}(x6)
 | |
|     RVTEST_IO_ASSERT_GPR_EQ(x8, x{load_register}, {expected})
 | |
| 
 | |
|     """
 | |
|     testcase_num += 1
 | |
|     if testcase_num*xlen//8 % 0x800 == 0:
 | |
|         data += "# Adjust x6 because we're storing too many things\naddi x6, x6, 1024\naddi x6, x6, 1024\n\n"
 | |
|     if xlen == 32:
 | |
|         reference_output = "{:08x}\n".format(expected) 
 | |
|     elif xlen == 64:
 | |
|         reference_output = "{:08x}\n{:08x}\n".format(expected % (1 << 32), expected >> 32) 
 | |
|     return (data, reference_output)
 | |
| 
 | |
| def write_header(outfile):
 | |
|     outfile.write(f"""///////////////////////////////////////////
 | |
| //
 | |
| // WALLY-LOAD
 | |
| //
 | |
| // Author: {author}
 | |
| //
 | |
| // Created {str(datetime.now())}
 | |
| // 
 | |
| """)
 | |
|     outfile.write(open("testgen_header.S", "r").read())
 | |
| 
 | |
| def write_test_data(outfile, test_data, xlen):
 | |
|     # print("Begin writing test data:")
 | |
|     # print("{} entries, from address {} to {}".format(len(test_data), min(test_data.keys()), max(test_data.keys())))
 | |
|     # print(test_data)
 | |
|     outfile.write("""
 | |
|     .align 16
 | |
| test_data:
 | |
|     
 | |
|     """)
 | |
|     if xlen == 32:
 | |
|         data_word = ".word"
 | |
|     elif xlen == 64:
 | |
|         data_word = ".dword"
 | |
|     else:
 | |
|         raise Exception("Unknown xlen: %d" % xlen)
 | |
|     byte_width = xlen // 8
 | |
|     for addr in [0] + sorted(test_data.keys()):
 | |
|         if addr in test_data:
 | |
|             word = f"    {data_word} {hex(test_data[addr] % (1 << xlen))} # test_data+{hex(addr)}\n"
 | |
|         else:
 | |
|             word = ""
 | |
|         try:
 | |
|             fill_len = (min(k for k in test_data.keys() if k > addr) - addr) // byte_width - 1
 | |
|             if word == "":
 | |
|                 fill_len += 1
 | |
|             fill = f"    .fill {fill_len}, {byte_width}, 0x0\n"
 | |
|         except:
 | |
|             fill = ""
 | |
|         case = word+fill
 | |
|         outfile.write(case)
 | |
| 
 | |
| ##################################
 | |
| # main body
 | |
| ##################################
 | |
| 
 | |
| widths = {
 | |
|     "lb": 8,
 | |
|     "lbu": 8,
 | |
|     "lh": 16,
 | |
|     "lhu": 16,
 | |
|     "lw": 32,
 | |
|     "lwu": 32,
 | |
|     "ld": 64,
 | |
| }
 | |
| instructions = [i for i in widths]
 | |
| author = "Jarred Allen"
 | |
| xlens = [32, 64]
 | |
| numrand = 100;
 | |
| 
 | |
| # setup
 | |
| seed(0) # make tests reproducible
 | |
| 
 | |
| for xlen in xlens:
 | |
|     testcase_num = 0
 | |
|     fname = "../../imperas-riscv-tests/riscv-test-suite/rv{}i/src/WALLY-LOAD.S".format(xlen)
 | |
|     refname = "../../imperas-riscv-tests/riscv-test-suite/rv{}i/references/WALLY-LOAD.reference_output".format(xlen)
 | |
|     f = open(fname, "w")
 | |
|     r = open(refname, "w")
 | |
|     write_header(f)
 | |
|     test_data = dict()
 | |
|     corner_values = [0x00, 0xFFFFFFFF, 0x7F, 0x7FFF, 0x7FFFFFFF]
 | |
|     if xlen == 64:
 | |
|         corner_values += [0xFFFFFFFFFFFFFFFF, 0x7FFFFFFFFFFFFFF]
 | |
|     corner_offsets = [0x800, 0x000, 0x7FF]
 | |
|     for instruction in instructions:
 | |
|         print("Running xlen: %d, instruction: %s" % (xlen, instruction))
 | |
|         if xlen == 32:
 | |
|             if instruction in ["lwu", "ld"]:
 | |
|                 continue
 | |
|         for value in corner_values + [rand_value(widths[instruction]) for _ in range(3)]:
 | |
|             value = value % (1 << widths[instruction])
 | |
|             source_reg = rand_source()
 | |
|             for offset in corner_offsets + [rand_offset() for _ in range(3)]:
 | |
|                 offset = align(offset, widths[instruction])
 | |
|                 source_reg = align(source_reg, widths[instruction])
 | |
|                 if insert_into_data(test_data, source_reg, offset, value, widths[instruction], xlen):
 | |
|                     data, output = generate_case(xlen, instruction, rand_reg(), rand_reg(), source_reg, offset, value)
 | |
|                     f.write(data)
 | |
|                     r.write(output)
 | |
|     while testcase_num % 4:
 | |
|         source = rand_source()
 | |
|         offset = rand_offset()
 | |
|         value = rand_value(widths[instruction])
 | |
|         if insert_into_data(test_data, source, offset, value, widths['lb'], xlen):
 | |
|             data, output = generate_case(xlen, 'lb', rand_reg(), rand_reg(), source, offset, value)
 | |
|             f.write(data)
 | |
|             r.write(output)
 | |
|     f.write("""# ---------------------------------------------------------------------------------------------
 | |
| 	
 | |
| 	RVTEST_IO_WRITE_STR(x31, "Test End\\n")
 | |
| 
 | |
| 	# ---------------------------------------------------------------------------------------------
 | |
| 
 | |
| 	RV_COMPLIANCE_HALT
 | |
| 
 | |
| RV_COMPLIANCE_CODE_END
 | |
| 
 | |
| 	.data
 | |
|     # Input data section
 | |
| """)
 | |
|     write_test_data(f, test_data, xlen)
 | |
|     f.write("""# Output data section.
 | |
| RV_COMPLIANCE_DATA_BEGIN
 | |
| 
 | |
| test_1_res:
 | |
| """)
 | |
|     f.write(f".fill {testcase_num}, {xlen//8}, -1\n")
 | |
|     f.write("\nRV_COMPLIANCE_DATA_END\n")
 | |
|     f.close()
 | |
|     r.close()
 |