added a README

This commit is contained in:
Dominik Moritz Roth 2020-11-23 19:21:16 +01:00
parent 093120b281
commit deef747f2f
2 changed files with 19 additions and 4 deletions

2
.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
__pycache__
*.pyc

View File

@ -1,6 +1,19 @@
### This Repo contains very uggly code, that may be disturbing to some readers. Reader discretion is adwised. #### This Repo contains very uggly code, that may be disturbing to some readers. Reader discretion is adwised.
# asmTron # asmTron
It is a compiler / emulator for a 12-bit cpu (4-bit opcodes, 8-bit adresses), that I started building in Minecraft. asmTron is a compiler / emulator for a 12-bit cpu (4-bit opcodes, 8-bit adresses), that I started building in Minecraft.
I never finished the Minecraft-Build, but this emulator is fully functional and even has integrated debugging capabilities. I never finished the Minecraft-Build, but this emulator is fully functional and even has integrated debugging capabilities.
Also: This programm is optimized for a very specific terminal-size and a global variable has to be changed to switch between Windows / Linux compatability. This programm is optimized for a very specific terminal-size and a global variable has to be changed to switch between Windows / Linux compatability.
### asm.py
The emulator / debugger...
### compiler.py / compiler_beta.py
This compiler compiles from 'tronScript' to a binary save-state of the emulator. It has been designed with the main priority of being as easy as possible to compile. Usability was ~~maybe~~ impacted by this decisio.
I forget, what the difference between normal and beta is...
### mima.py
A variation of asm.py to emulate a MiMa (minimal machine).
### asmCust.py
Does not work (I think...)