今天早上早些时候,在我的Planet Python源中,我读到了一篇有趣的文章"开发CARDIAC:纸板计算机(Developing upwards: CARDIAC: The Cardboard Computer)",它是关于名为Cardiac的纸板计算机的.我的一些追随者和读者应该知道,我有一个名为简单CPU(simple-cpu)的项目,过去的数月我一直工作于此,并且已经发布了源代码.我真的应该给这个项目提供一个合适的许可证,这样,其他人可能更感兴趣,并在他们自己的项目中使用.不管怎样,但愿在这发布之后,我可以完成这件事.
在读完了这篇文章以及它链接的页面后,我受到了一些启发,决定为它编写我自己的模拟器,因为我有编写字节码引擎的经验.我计划着跟随这篇文章继续往前,先写一篇关于汇编器的文章,接下来是关于编译器的文章.这样,通过这些文章,你基本上可以学到,如何用Python为Cardiac创建编译工具集. 在简单CPU(simple-cpu)项目中,我已经编写了一个完整的可工作的汇编器.在内置的游戏中,已经有了可工作的编译器的最初步骤.我也选择Cardiac作为一个验证机器是因为它绝对的简单.不需要复杂的记忆,每个操作码只接受单一的参数,所以它是绝好的学习工具.此外,所有的数据参数都是相同的,不需要检测程序是需要一个寄存器,字符串或者还是内存地址.实际上,只有一个寄存器,累加器.因此,让我们开始吧!我们将基于类来创建,这样包含范围.如果你想尝试的话,你可以简单通过子类来增加新的操作码.首先,我们将集中于初始化例程.这个CPU非常简单,所以我们只需要初始化下面的内容: CPU寄存器, 操作码, 内存空间, 读卡器/输入, 和 打印/tty/输出.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
class Cardiac( object ):
""" This class is the cardiac "CPU". """
def __init__( self ):
self .init_cpu()
self .reset()
self .init_mem()
self .init_reader()
self .init_output()
def reset( self ):
""" This method resets the CPU's registers to their defaults. """
self .pc = 0 #: Program Counter
self .ir = 0 #: Instruction Register
self .acc = 0 #: Accumulator
self .running = False #: Are we running?
def init_cpu( self ):
""" This fancy method will automatically build a list of our opcodes into a hash. This enables us to build a typical case/select system in Python and also keeps things more DRY. We could have also used the getattr during the process() method before, and wrapped it around a try/except block, but that looks a bit messy. This keeps things clean and simple with a nice one-to-one call-map. """
self .__opcodes = {}
classes = [ self .__class__] #: This holds all the classes and base classes.
while classes:
cls = classes.pop() # Pop the classes stack and being
if cls .__bases__: # Does this class have any base classes?
classes = classes + list ( cls .__bases__)
for name in dir ( cls ): # Lets iterate through the names.
if name[: 7 ] = = 'opcode_' : # We only want opcodes here.
try :
opcode = int (name[ 7 :])
except ValueError:
raise NameError( 'Opcodes must be numeric, invalid opcode: %s' % name[ 7 :])
self .__opcodes.update({opcode: getattr ( self , 'opcode_%s' % opcode)})
def init_mem( self ):
""" This method resets the Cardiac's memory space to all blank strings, as per Cardiac specs. """
self .mem = ['' for i in range ( 0 , 100 )]
self .mem[ 0 ] = '001' #: The Cardiac bootstrap operation.
def init_reader( self ):
""" This method initializes the input reader. """
self .reader = [] #: This variable can be accessed after initializing the class to provide input data.
def init_output( self ):
""" This method initializes the output deck/paper/printer/teletype/etc... """
self .output = []
|
但愿我写的注释能让你们看明白代码的各部分功能. 也许你已经发现这段代码处理指令集的方法(method)跟 simple-cpu 项目有所不同. 由于它能让开发者根据自己的需求轻松的扩展类库, 我打算在后续的项目中继续使用这种处理方式. 随着我对各部分功能原理的深入理解, 项目也在不断的发展变化. 其实吧, 做这样一个项目真的能让人学到不少东西. 对于精通计算机的人来说 , CPU 的工作原理啦, 指令集是怎么处理的啦, 都不是问题啦 . 关键是, 能够按照自己的想法去实现这样一个 CPU 仿真器, 真的很好玩. 根据自己想象中的样子, 亲手打造出这样一台仿真器, 然后看着它屁颠屁颠的运行着, 那叫一个有成就感.
接下来, 我们讲下工具函数(utility functions), 这些函数在很多地方都会用到, 而且允许在子类(subclasses)中重写:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
def read_deck( self , fname):
""" 将指令读到 reader 中. """
self .reader = [s.rstrip( '\n' ) for s in open (fname, 'r' ).readlines()]
self .reader.reverse()
def fetch( self ):
""" 根据指令指针(program pointer) 从内存中读出指令, 然后将指令指针加1. """
self .ir = int ( self .mem[ self .pc])
self .pc + = 1
def get_memint( self , data):
""" 由于我们是以字符串形式(*string* based)保存内存数据的, 要仿真 Cardiac, 就要将字符串转化成整数. 如果是其他存储形式的内存, 如 mmap, 可以根据需要重写本函数. """
return int ( self .mem[data])
def pad( self , data, length = 3 ):
""" 本函数的功能是像 Cardiac 那样, 在数字的前面补0. """
orig = int (data)
padding = '0' * length
data = '%s%s' % (padding, abs (data))
if orig < 0 :
return '-' + data[ - length:]
return data[ - length:]
|
本文后面我会另外给大家一段能结合 Mixin classes 使用的代码, 灵活性(pluggable)更强些. 最后就剩下这个处理指令集的方法了:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
def process( self ):
""" 本函数只处理一条指令. 默认情况下, 从循环代码(running loop)中调用, 你也可以自己写代码, 以单步调试的方式调用它, 或者使用 time.sleep() 降低执行的速度. 如果想用 TK/GTK/Qt/curses 做的前端界面(frontend), 在另外一个线程中操作, 也可以调用本函数. """
self .fetch()
opcode, data = int (math.floor( self .ir / 100 )), self .ir % 100
self .__opcodes[opcode](data)
def opcode_0( self , data):
""" 输入指令 """
self .mem[data] = self .reader.pop()
def opcode_1( self , data):
""" 清除指令 """
self .acc = self .get_memint(data)
def opcode_2( self , data):
""" 加法指令 """
self .acc + = self .get_memint(data)
def opcode_3( self , data):
""" 测试累加器内容指令 """
if self .acc < 0 :
self .pc = data
def opcode_4( self , data):
""" 位移指令 """
x,y = int (math.floor(data / 10 )), int (data % 10 )
for i in range ( 0 ,x):
self .acc = ( self .acc * 10 ) % 10000
for i in range ( 0 ,y):
self .acc = int (math.floor( self .acc / 10 ))
def opcode_5( self , data):
""" 输出指令 """
self .output.append( self .mem[data])
def opcode_6( self , data):
""" 存储指令 """
self .mem[data] = self .pad( self .acc)
def opcode_7( self , data):
""" 减法指令 """
self .acc - = self .get_memint(data)
def opcode_8( self , data):
""" 无条件跳转指令 """
self .pc = data
def opcode_9( self , data):
""" 终止, 复位指令 """
self .reset()
def run( self , pc = None ):
""" 这段代码一直执行到遇到 终止/复位 指令为止. """
if pc:
self .pc = pc
self .running = True
while self .running:
self .process()
print "Output:\n%s" % '\n' .join( self .output)
self .init_output() if __name__ = = '__main__' :
c = Cardiac()
c.read_deck( 'deck1.txt' )
try :
c.run()
except :
print "IR: %s\nPC: %s\nOutput: %s\n" % (c.ir, c.pc, '\n' .join(c.output))
raise
|
这段是上面提到的, 能在 Mixin 中使用的代码, 我重构过后, 代码如下 :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
class Memory( object ):
""" 本类实现仿真器的虚拟内存空间的各种功能 """
def init_mem( self ):
""" 用空白字符串清除 Cardiac 系统内存中的所有数据 """
self .mem = ['' for i in range ( 0 , 100 )]
self .mem[ 0 ] = '001' #: 启动 Cardiac 系统.
def get_memint( self , data):
""" 由于我们是以字符串形式(*string* based)保存内存数据的, 要仿真 Cardiac, 就要将字符串转化成整数. 如果是其他存储形式的内存, 如 mmap, 可以根据需要重写本函数. """
return int ( self .mem[data])
def pad( self , data, length = 3 ):
""" 在数字前面补0 """
orig = int (data)
padding = '0' * length
data = '%s%s' % (padding, abs (data))
if orig < 0 :
return '-' + data[ - length:]
return data[ - length:]
class IO( object ):
""" 本类实现仿真器的 I/O 功能. To enable alternate methods of input and output, swap this. """
def init_reader( self ):
""" 初始化 reader. """
self .reader = [] #: 此变量在类初始化后, 可以用来读取输入的数据.
def init_output( self ):
""" 初始化诸如: deck/paper/printer/teletype/ 之类的输出功能... """
self .output = []
def read_deck( self , fname):
""" 将指令读到 reader 中. """
self .reader = [s.rstrip( '\n' ) for s in open (fname, 'r' ).readlines()]
self .reader.reverse()
def format_output( self ):
""" 格式化虚拟 I/O 设备的输出(output) """
return '\n' .join( self .output)
def get_input( self ):
""" 获取 IO 的输入(input), 也就是说用 reader 读取数据, 代替原来的 raw_input() . """
try :
return self .reader.pop()
except IndexError:
# 如果 reader 遇到文件结束标志(EOF) 就用 raw_input() 代替 reader.
return raw_input ( 'INP: ' )[: 3 ]
def stdout( self , data):
self .output.append(data)
class CPU( object ):
""" 本类模拟 cardiac CPU. """
def __init__( self ):
self .init_cpu()
self .reset()
try :
self .init_mem()
except AttributeError:
raise NotImplementedError( 'You need to Mixin a memory-enabled class.' )
try :
self .init_reader()
self .init_output()
except AttributeError:
raise NotImplementedError( 'You need to Mixin a IO-enabled class.' )
def reset( self ):
""" 用默认值重置 CPU 的寄存器 """
self .pc = 0 #: 指令指针
self .ir = 0 #: 指令寄存器
self .acc = 0 #: 累加器
self .running = False #: 仿真器的运行状态?
def init_cpu( self ):
""" 本函数自动在哈希表中创建指令集. 这样我们就可以使用 case/select 方式调用指令, 同时保持代码简洁. 当然, 在 process() 中使用 getattr 然后用 try/except 捕捉异常也是可以的, 但是代码看起来就没那么简洁了. """
self .__opcodes = {}
classes = [ self .__class__] #: 获取全部类, 包含基类.
while classes:
cls = classes.pop() # 把堆栈中的类弹出来
if cls .__bases__: # 判断有没有基类
classes = classes + list ( cls .__bases__)
for name in dir ( cls ): # 遍历名称.
if name[: 7 ] = = 'opcode_' : # 只需要把指令读出来即可 try:
opcode = int (name[ 7 :])
except ValueError:
raise NameError( 'Opcodes must be numeric, invalid opcode: %s' % name[ 7 :])
self .__opcodes.update({opcode: getattr ( self , 'opcode_%s' % opcode)})
def fetch( self ):
""" 根据指令指针(program pointer) 从内存中读取指令, 然后指令指针加 1. """
self .ir = self .get_memint( self .pc)
self .pc + = 1
def process( self ):
""" 处理当前指令, 只处理一条. 默认情况下是在循环代码中调用(running loop), 也可以自己写代码, 以单步调试方式调用, 或者利用 time.sleep() 降低执行速度. 在 TK/GTK/Qt/curses 做的界面的线程中调用本函数也是可以的. """
self .fetch()
opcode, data = int (math.floor( self .ir / 100 )), self .ir % 100
self .__opcodes[opcode](data)
def opcode_0( self , data):
""" 输入指令 """
self .mem[data] = self .get_input()
def opcode_1( self , data):
""" 清除累加器指令 """
self .acc = self .get_memint(data)
def opcode_2( self , data):
""" 加法指令 """
self .acc + = self .get_memint(data)
def opcode_3( self , data):
""" 测试累加器内容指令 """
if self .acc < 0 :
self .pc = data
def opcode_4( self , data):
""" 位移指令 """
x,y = int (math.floor(data / 10 )), int (data % 10 )
for i in range ( 0 ,x):
self .acc = ( self .acc * 10 ) % 10000
for i in range ( 0 ,y):
self .acc = int (math.floor( self .acc / 10 ))
def opcode_5( self , data):
""" 输出指令 """
self .stdout( self .mem[data])
def opcode_6( self , data):
""" 存储指令 """
self .mem[data] = self .pad( self .acc)
def opcode_7( self , data):
""" 减法指令 """
self .acc - = self .get_memint(data)
def opcode_8( self , data):
""" 无条件跳转指令 """
self .pc = data
def opcode_9( self , data):
""" 停止/复位指令"""
self .reset()
def run( self , pc = None ):
""" 这段代码会一直运行, 直到遇到 halt/reset 指令才停止. """
if pc:
self .pc = pc
self .running = True
while self .running:
self .process()
print "Output:\n%s" % self .format_output()
self .init_output()
class Cardiac(CPU, Memory, IO):
passif __name__ = = '__main__' :
c = Cardiac()
c.read_deck( 'deck1.txt' )
try :
c.run()
except :
print "IR: %s\nPC: %s\nOutput: %s\n" % (c.ir, c.pc, c.format_output())
raise
|
大家可以从 Developing Upwards: CARDIAC: The Cardboard Computer 中找到本文使用的 deck1.txt .
希望本文能启发大家, 怎么去设计基于类的模块, 插拔性强(pluggable)的 Paython 代码, 以及如何开发 CPU 仿真器. 至于本文 CPU 用到的汇编编译器(assembler) , 会在下一篇文章中教大家.
这段是上面提到的, 能在 Mixin 中使用的代码, 我重构过后, 代码如下 :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
class Memory( object ):
""" 本类实现仿真器的虚拟内存空间的各种功能 """
def init_mem( self ):
""" 用空白字符串清除 Cardiac 系统内存中的所有数据 """
self .mem = ['' for i in range ( 0 , 100 )]
self .mem[ 0 ] = '001' #: 启动 Cardiac 系统.
def get_memint( self , data):
""" 由于我们是以字符串形式(*string* based)保存内存数据的, 要仿真 Cardiac, 就要将字符串转化成整数. 如果是其他存储形式的内存, 如 mmap, 可以根据需要重写本函数. """
return int ( self .mem[data])
def pad( self , data, length = 3 ):
""" 在数字前面补0 """
orig = int (data)
padding = '0' * length
data = '%s%s' % (padding, abs (data))
if orig < 0 :
return '-' + data[ - length:]
return data[ - length:]
class IO( object ):
""" 本类实现仿真器的 I/O 功能. To enable alternate methods of input and output, swap this. """
def init_reader( self ):
""" 初始化 reader. """
self .reader = [] #: 此变量在类初始化后, 可以用来读取输入的数据.
def init_output( self ):
""" 初始化诸如: deck/paper/printer/teletype/ 之类的输出功能... """
self .output = []
def read_deck( self , fname):
""" 将指令读到 reader 中. """
self .reader = [s.rstrip( '\n' ) for s in open (fname, 'r' ).readlines()]
self .reader.reverse()
def format_output( self ):
""" 格式化虚拟 I/O 设备的输出(output) """
return '\n' .join( self .output)
def get_input( self ):
""" 获取 IO 的输入(input), 也就是说用 reader 读取数据, 代替原来的 raw_input() . """
try :
return self .reader.pop()
except IndexError:
# 如果 reader 遇到文件结束标志(EOF) 就用 raw_input() 代替 reader.
return raw_input ( 'INP: ' )[: 3 ]
def stdout( self , data):
self .output.append(data)
class CPU( object ):
""" 本类模拟 cardiac CPU. """
def __init__( self ):
self .init_cpu()
self .reset()
try :
self .init_mem()
except AttributeError:
raise NotImplementedError( 'You need to Mixin a memory-enabled class.' )
try :
self .init_reader()
self .init_output()
except AttributeError:
raise NotImplementedError( 'You need to Mixin a IO-enabled class.' )
def reset( self ):
""" 用默认值重置 CPU 的寄存器 """
self .pc = 0 #: 指令指针
self .ir = 0 #: 指令寄存器
self .acc = 0 #: 累加器
self .running = False #: 仿真器的运行状态?
def init_cpu( self ):
""" 本函数自动在哈希表中创建指令集. 这样我们就可以使用 case/select 方式调用指令, 同时保持代码简洁. 当然, 在 process() 中使用 getattr 然后用 try/except 捕捉异常也是可以的, 但是代码看起来就没那么简洁了. """
self .__opcodes = {}
classes = [ self .__class__] #: 获取全部类, 包含基类.
while classes:
cls = classes.pop() # 把堆栈中的类弹出来
if cls .__bases__: # 判断有没有基类
classes = classes + list ( cls .__bases__)
for name in dir ( cls ): # 遍历名称.
if name[: 7 ] = = 'opcode_' : # 只需要把指令读出来即可 try:
opcode = int (name[ 7 :])
except ValueError:
raise NameError( 'Opcodes must be numeric, invalid opcode: %s' % name[ 7 :])
self .__opcodes.update({opcode: getattr ( self , 'opcode_%s' % opcode)})
def fetch( self ):
""" 根据指令指针(program pointer) 从内存中读取指令, 然后指令指针加 1. """
self .ir = self .get_memint( self .pc)
self .pc + = 1
def process( self ):
""" 处理当前指令, 只处理一条. 默认情况下是在循环代码中调用(running loop), 也可以自己写代码, 以单步调试方式调用, 或者利用 time.sleep() 降低执行速度. 在 TK/GTK/Qt/curses 做的界面的线程中调用本函数也是可以的. """
self .fetch()
opcode, data = int (math.floor( self .ir / 100 )), self .ir % 100
self .__opcodes[opcode](data)
def opcode_0( self , data):
""" 输入指令 """
self .mem[data] = self .get_input()
def opcode_1( self , data):
""" 清除累加器指令 """
self .acc = self .get_memint(data)
def opcode_2( self , data):
""" 加法指令 """
self .acc + = self .get_memint(data)
def opcode_3( self , data):
""" 测试累加器内容指令 """
if self .acc < 0 :
self .pc = data
def opcode_4( self , data):
""" 位移指令 """
x,y = int (math.floor(data / 10 )), int (data % 10 )
for i in range ( 0 ,x):
self .acc = ( self .acc * 10 ) % 10000
for i in range ( 0 ,y):
self .acc = int (math.floor( self .acc / 10 ))
def opcode_5( self , data):
""" 输出指令 """
self .stdout( self .mem[data])
def opcode_6( self , data):
""" 存储指令 """
self .mem[data] = self .pad( self .acc)
def opcode_7( self , data):
""" 减法指令 """
self .acc - = self .get_memint(data)
def opcode_8( self , data):
""" 无条件跳转指令 """
self .pc = data
def opcode_9( self , data):
""" 停止/复位指令"""
self .reset()
def run( self , pc = None ):
""" 这段代码会一直运行, 直到遇到 halt/reset 指令才停止. """
if pc:
self .pc = pc
self .running = True
while self .running:
self .process()
print "Output:\n%s" % self .format_output()
self .init_output()
class Cardiac(CPU, Memory, IO):
passif __name__ = = '__main__' :
c = Cardiac()
c.read_deck( 'deck1.txt' )
try :
c.run()
except :
print "IR: %s\nPC: %s\nOutput: %s\n" % (c.ir, c.pc, c.format_output())
raise
|
大家可以从Developing Upwards: CARDIAC: The Cardboard Computer 中找到本文使用的 deck1.txt 的代码, 我用的是 从 1 计数到 10 的那个例子 .