mirror of
https://github.com/lloeki/python-dcpu_16.git
synced 2025-12-06 09:54:39 +01:00
33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
# What is this?
|
|
|
|
A DCPU-16 implementation in Python. See [the spec](http://0x10c.com/doc/dcpu-16.txt).
|
|
|
|
# But what's the goal of this? There's another one already!
|
|
|
|
Well, what's wrong with taking another stab at it? Besides, I personnally felt it was too C-ish, and not pythonic enough (whatever that means). I wanted to revive whatever low-level (admittedly limited) ASM knowledge I had (from 6800/68000) and sharpen my Python-fu. The spirit of the thing is to be educative for everyone (including me).
|
|
|
|
# How do I use this?
|
|
|
|
It's meant to be used interactively via the Python REPL as well as programmatically. I might implement a specific ASM REPL at some point.
|
|
|
|
An example of a Python REPL session:
|
|
|
|
>>> from dcpu_16 import CPU
|
|
>>> c = CPU(debug=True)
|
|
>>> c.load_m() # loads demo program
|
|
>>> c.step() # step by one instruction
|
|
<< SET
|
|
<< c.r[0x0]
|
|
<< c.m[0x0001]
|
|
<< A=0030 B=0000 C=0000 X=0000 Y=0000 Z=0000 I=0000 J=0000 PC=0002 SP=0000 O=0000
|
|
>>> c.pc = 0xA # jump to 'loopy thing'
|
|
>>> c.step()
|
|
<< SET
|
|
<< c.r[0x6]
|
|
<< 0x000A
|
|
<< A=0030 B=0000 C=0000 X=0000 Y=0000 Z=0000 I=000A J=0000 PC=000B SP=0000 O=0000
|
|
>>> c.reset() # reset CPU
|
|
>>> c.clear() # clear memory
|
|
>>> c.dump_r() # get CPU register state as string
|
|
'A=0000 B=0000 C=0000 X=0000 Y=0000 Z=0000 I=0000 J=0000 PC=0000 SP=0000 O=0000'
|
|
|