diff options
| author | Loic GUEGAN <loic.guegan@yahoo.fr> | 2018-09-03 13:29:20 +0200 |
|---|---|---|
| committer | Loic GUEGAN <loic.guegan@yahoo.fr> | 2018-09-03 13:29:20 +0200 |
| commit | 35b34979dad36299723c5279def446e3f07a3ca3 (patch) | |
| tree | ae63fb2141b0c6ebe765151f7c2341136dd524a4 | |
| parent | 170d8906b9880f94bb3d6def66a5fe4040b3576e (diff) | |
Update README
| -rw-r--r-- | MicSim/ram.txt | 4 | ||||
| -rw-r--r-- | README.md | 55 |
2 files changed, 44 insertions, 15 deletions
diff --git a/MicSim/ram.txt b/MicSim/ram.txt index 2707f4a..c47f112 100644 --- a/MicSim/ram.txt +++ b/MicSim/ram.txt @@ -1,5 +1,5 @@ BIPUSH -9 +12 BIPUSH -8 +5 IADD @@ -1,6 +1,6 @@ # MicSim -Hi! Welcome to MicSim project repo. MicSim is a Mic-1 architecture simulator written in python. It is specially design for studying purpose. +Hi! Welcome to MicSim project repository. MicSim is a Mic-1 architecture simulator written in python. It is specially designed for studying purpose. ### How it works ? It is simple, you have to: @@ -9,18 +9,47 @@ It is simple, you have to: 3. Enjoy ! ### I want to know more about it.... -Source code is located in _MicSim_ folder. All the components used for the Mic-1 architecture are -located in _MicSim/components_ folder: - - **ijvm.py** Contains standard IJVM constant - - **microprogram.py** Contains IJVM implementation that use Mic-1 architecture - - **caretaker.py** Hold all the Mic-1 architecture components (registers, ram etc..) - - **ram.py** Contains a simple RAM implementation +Source code is located in `MicSim/` directory. All the components used for the Mic-1 architecture are located in `MicSim/components/` directory: + - `ijvm.py` Contains standard IJVM constant + - `microprogram.py` Contains IJVM implementation that use Mic-1 architecture + - `caretaker.py` Hold all the Mic-1 architecture components (registers, ram etc..) + - `ram.py` Contains a simple RAM implementation ### How to load code in memory ? -Simply by editing **ram.txt**. Each line corresponding to a byte entry starting from address 0x0 to whatever to $+\infty$ . Each line can be an IJVM _opcode_ or a random byte. Here is an example of how to add two number: +Simply by editing `ram.txt`. Each line corresponding to a byte entry starting from address 0x0 to whatever. Each line can be an **IJVM opcode** or a random **byte**. Here is an example of how to add two numbers: + + + +> BIPUSH<br /> +> 12<br /> +> BIPUSH<br /> +> 5<br /> +> IADD<br /> + +Kind of output: + + ---------- Ram Before Execution ---------- + 0 : 0x10 (16) + 1 : 0xc (12) + 2 : 0x10 (16) + 3 : 0x5 (5) + 4 : 0x60 (96) + ------------------------------------------ + ---------- Ram After Execution ---------- + 0 : 0x10 (16) + 1 : 0xc (12) + 2 : 0x10 (16) + 3 : 0x5 (5) + 4 : 0x60 (96) + 4099 : 0x0 (0) + 4098 : 0x0 (0) + 4097 : 0x0 (0) + 4096 : 0x11 (17) + 4103 : 0x0 (0) + 4102 : 0x0 (0) + 4101 : 0x0 (0) + 4100 : 0x5 (5) + ----------------------------------------- + + -> BIPUSH<br /> -> 12<br /> -> BIPUSH<br /> -> 5<br /> -> IADD<br /> |