Processor-Design

How to Run

1. Clone the Repository : git clone https://github.com/0xChaitanya/Processor-Design.git

On Windows (Use cmd to view testcases)

1. cd Processor-Design/automatedTesting
2. to run Assembler : src/main.py --windows --no-asm
3. to run Simulator : src/main.py --windows --no-asm

On Mac/Linux

1. cd Processor-Design/automatedTesting
2. to run Assembler : src/main.py --linux --no-asm
3. to run Simulator : src/main.py --linux --no-asm

Test Cases

1. We have simple and hard tests at both the assembler level and the simulator level.

2. The assembler tests and simulator tests are independent of each other.

Input Assembly code files : simpleBin, hardBin, errorGen

3. Assembler test content is present inside: tests/assembly/

The folder bin_s contains the exact machine code file corresponding to the tests inside simpleBin. Similarly for bin_h.

The folder user_bin_s, user_bin_h contains the machine code created by user's Assembler for simpleBin, hardBin respectivly.

4. Simulator test content is present inside: The folder tests/traces/ contains correct expected simulator traces. The folder tests/bin/ contains simultor traces generated by student's simulator.

Code Structure

Processor-Design/
├── automatedTesting/
│   ├── src/
│   └── tests/
│       ├── assembly/
│       │   ├── bin_s/
│       │   ├── errorGen/
│       │   ├── hardBin/
│       │   ├── simpleBin/
│       │   ├── user_bin_h/
│       │   └── user_bin_s/
│       ├── bin/
|       |   └── hard/
│       │   └── simple/
│       ├── traces/
|       |   |── hard/
│       │   ├── simple/
│       └── user_traces/
|           └── hard/
│           └── simple/
|
├── SimpleAssembler/
│   └── Assembler.py
|
├── SimpleSimulator/
│   └── Simulator.py
|
├── CO_Project_2025_Semester2.pdf
└── README.md

Collaborators

  2024155. Bhumik
  2024158. Chaitanya Satsangi
  2024229. Hariom Kumar Bharti
  2024317. Lakshay