aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: a6384cde197bada853e860a6e52dc78c22e0062a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# MicSim

Hi! Welcome to MicSim project repo. MicSim is a Mic-1 architecture simulator written in python. It is specially design for studying purpose. 

### How it works ?
It is simple, you have to:
 1. Clone the repo
 2. Execute micsim.py
 3. Enjoy !

### I want to know more about it....
All the architecture components are located in _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

### 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.