https://github.com/abdullahimtiazyousafzai/assembly-language-simulator

A GUI simulator/interpreter for custom assembly language, written in python/tkinter
https://github.com/abdullahimtiazyousafzai/assembly-language-simulator

assembly assembly-language computer-organization computer-organization-and-design custom-assembly-language op-codes python registers simulator

Last synced: about 1 month ago
JSON representation

A GUI simulator/interpreter for custom assembly language, written in python/tkinter

• Host: GitHub
• URL: https://github.com/abdullahimtiazyousafzai/assembly-language-simulator
• Owner: abdullahimtiazyousafzai
• License: mit
• Created: 2024-04-21T21:31:19.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2024-05-17T20:58:39.000Z (6 months ago)
• Last Synced: 2024-10-12T20:42:37.937Z (about 1 month ago)
• Topics: assembly, assembly-language, computer-organization, computer-organization-and-design, custom-assembly-language, op-codes, python, registers, simulator
• Language: Python
• Homepage:
• Size: 10.7 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Assembly Language Simulator

This project is a simple assembly code simulator built with Python and Tkinter. It allows you to load assembly code from a file, run it, and see the results in a GUI.

## Features

- Load assembly code from a file

- Run the loaded code

- Step through the code one line at a time

- View the state of the CPU registers and RAM

- View the output of the code

## Instruction Set

The simulator supports the following instructions:

- LOM: Load the data from the memory address into the ACC register. Format: `LOM 
`

- OUT: Output the value in the ACC register. Format: `OUT`

- STO: Store the data from the ACC register to the memory address. Format: `STO 
`

- ADD: Add the data from the memory address to the ACC register. Format: `ADD 
`

- SUB: Subtract the data from the ACC register. Format: `SUB 
`

- MUL: Multiply the ACC register by the data from the memory address. Format: `MUL 
`

- INR: Increment the register specified by the AR register. Format: `INR`

- INP: Load the value from the INPR register into the ACC register. Format: `INP`

- AND: Perform a bitwise AND operation on the ACC register and the data from the memory address. Format: `AND 
`

- OR: Perform a bitwise OR operation on the ACC register and the data from the memory address. Format: `OR 
`

- XOR: Perform a bitwise XOR operation on the ACC register and the data from the memory address. Format: `XOR 
`

- NOT: Perform a bitwise NOT operation on the ACC register. Format: `NOT`

- JUM: Jump to the memory address specified by the AR register. Format: `JUM 
`

- JUZ: Jump to the memory address specified by the AR register if the ACC register is zero. Format: `JUZ 
`

- FIN: Finish the program execution. Format: `FIN`


In the above formats, `
` represents the memory address to be used by the instruction.


## Registers

The simulator uses the following registers:

- ACC: Accumulator register

- PC: Program counter

- IR: Instruction register

- DR: Data register

- CTR: Counter register

- OUTR: Output register

- AR: Address register

- INPR: Input register

## Usage

1. Clone the repository to your local machine.

2. Run `simulator.exe` from `dist/`to start the simulator or run the `simulator.py` file in any python supported IDE (ensure both the `simulator.py` and `interpreter.py` are in the same project).

3. Click the "Load Code File" button to load assembly code from a file.

4. Click the "Run" button to run the loaded code.

5. Click the "Step" button to step through the code one line at a time.

## Dependencies

- Python 3.10

- Tkinter

## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.