/BUAA-CO-Killer

为北航计算机组成原理设计的CPU测试程序自动生成器

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

BUAA CO Killer

作者已停止维护，该仓库仅供参考

如果在测试CPU时使用了该项目生成的测试数据，建议向助教主动说明

为北航六系计算机组成原理课设编写的CPU测试程序自动生成器

作者的课设进度：P8通过

环境依赖：

  • Python 3.5/3.6/3.7

安装与运行

注意版本已更新，与先前版本启动方式不同

目前已知问题：

  • 在Py3.5的安装路径中如果含有中文等特殊字符会安装失败，如果遇到这个问题直接运行coklr脚本即可。其他版本的Python很可能也存在这个问题
# Download
git clone https://github.com/Mistariano/BUAA-CO-Killer.git
cd BUAA-CO-Killer

# Install
python setup.py install

# Check installation & show helps
coklr -h
# Run with default settings
coklr <output_dir>

# Generate 100 asm files, with 1023 instructions in each of them
coklr <output_dir> --n_case 100 --k_instr 1023

# Generate test cases for P5(on MIPS-LITE)
coklr <output_dir> --instr_set lite

# Generate test cases for P6(on MIPS-C3)
coklr <output_dir> --instr_set c3

支持指令

加*表示未完成

  1. LB
  2. LBU
  3. LH
  4. LHU
  5. LW
  6. SB
  7. SH
  8. SW
  9. ADD
  10. ADDU
  11. SUB
  12. SUBU
  13. MULT
  14. MULTU
  15. DIV
  16. DIVU
  17. SLL
  18. SRL
  19. SRA
  20. SLLV
  21. SRLV
  22. SRAV
  23. AND
  24. OR
  25. XOR
  26. NOR
  27. ADDI
  28. ADDIU
  29. ANDI
  30. ORI
  31. XORI
  32. LUI
  33. SLTI
  34. SLTIU
  35. SLT
  36. SLTU
  37. BEQ
  38. BNE
  39. BLEZ
  40. BGTZ
  41. BLTZ
  42. BGEZ
  43. J
  44. JAL
  45. JR
  46. JALR
  47. MFHI
  48. MFLO
  49. MTHI
  50. MTLO
  51. MFC0
  52. MTC0
  53. ERET

编写自己的测试脚本

  1. 自定义模板：继承Template并重载get_initial_compilable_instances
  2. 自定义Task：
    1. from co_killer.task import Task
    2. 实例化一个Task，并使用add_template_class将模板类挂载入Task
  3. 运行：调用Task对象的run方法

示例：自定义模板并定义自己的Task

from co_killer.task import ASMGenerateTask
from co_killer.compilable import ExcHandlerTemplate, Template
from co_killer.builtin.instructions import *


class MyExcHandlerTemplate(ExcHandlerTemplate):
    def get_initial_compilable_instances(self):
        instr_seq = [
            # add your instructions here
            ADDI(rs=0, rt=0, imm=0),
            NOP(),
        ]
        return instr_seq


class MyASMTextTemplate(Template):
    def get_initial_compilable_instances(self):
        instr_seq = [
            # add your instructions here
            ORI(),
            ORI(),
            ORI(),
            ORI(),
        ]
        return instr_seq


def get_task():
    task = ASMGenerateTask(output_dir='output',
                repeat_time=5,
                builtin_exc_handler=None,
                name='my_task'
                )

    task.add_handler_template_class(template_cls=MyExcHandlerTemplate)
    task.add_template_class(template_cls=MyASMTextTemplate)
    return task


def main():
    task = get_task()
    task.run()


if __name__ == '__main__':
    main()

注意，当不给ORI或其他内建指令指定参数时，将会使用安全的随机值

上述代码生成5个测试文件，其中一个内容如下：

.ktext 0x4180:
# 0x4180
addi $22 $16 -5569
# 0x4184
nop
.text:

# 0x3000
ori $19 $16 0xd311
# 0x3004
ori $26 $5 0x245d
# 0x3008
ori $24 $19 0x6b15
# 0x300c
ori $4 $7 0x52bf

tail_loop_0:
# 0x3010
j tail_loop_0
# 0x3014
nop

自动化测试：多进程、调度器及任务队列

stay tuned

Contribution

已停止维护

软件许可协议

GNU GPL v3