Simple RISC Assembler

A Python-based assembler for the Simple RISC instruction set architecture with a modern GUI interface.

Features

• Modern graphical user interface with syntax highlighting
• Real-time assembly and error reporting
• Multiple output formats (binary and hexadecimal)
• Support for labels and comments
• Comprehensive error checking and validation

Installation

Prerequisites

Ensure you have Python 3.6+ installed on your system.

Install Required Dependencies

Run the following command to install the required Python libraries:

pip install tkinter

Usage

Running the GUI Application

Execute the following command in your terminal or command prompt:

python GUI.py

GUI Features

• Create a new file
• Open an existing assembly file
• Save the current file
• Assemble the code

File Structure

The repository consists of the following key files:

• GUI.py - Implements the graphical user interface using Tkinter.
• final.py - Contains the assembler logic for parsing and converting S-RISC-21 assembly into binary/hexadecimal.

Assembly Language Syntax

Comments

• Single-line comments start with @ or #
• Multi-line comments are enclosed in /* */

Labels

• Must start with a letter or underscore
• Can contain letters, numbers, and underscores
• End with a colon (:)

Example:

loop:
    add r1, r2, r3

Registers

• General-purpose registers: r0 to r15
• Special registers: sp (stack pointer), ra (return address)

Instructions

Register Format (3-address ALU instructions):

add rd, rs1, rs2
sub rd, rs1, rs2
mul rd, rs1, rs2
div rd, rs1, rs2
mod rd, rs1, rs2
and rd, rs1, rs2
or rd, rs1, rs2
lsl rd, rs1, rs2
lsr rd, rs1, rs2
asr rd, rs1, rs2

Two-Address Instructions:

cmp rs1, rs2
not rd, rs1
mov rd, imm

Branch Instructions:

nop
ret
beq label
bgt label
b label
call label

Memory Operations:

ld rd, imm[rs1]
st rs2, imm[rs1]

Immediate Values

• Signed immediate range: -32768 to 32767
• Unsigned immediate range: 0 to 65535
• Memory offset range: -32768 to 32767

Error Handling

The assembler provides detailed error messages for:

• Invalid register numbers
• Out-of-range immediate values
• Invalid memory offsets
• Undefined labels
• Syntax errors
• Invalid instruction formats

Output Formats

Binary Output:

• Shows memory address and 32-bit binary instruction
• Format: address: binary_instruction

Hexadecimal Output:

• Shows assembled instructions in hexadecimal format
• One instruction per line

Step-by-Step Guide to Running the Assembler

1. Clone this repository:

   git clone <repository_url>
   cd <repository_directory>

2. Install dependencies:

   pip install tkinter

3. Run the GUI interface:

   python GUI.py

4. Write your assembly code in the editor.
5. Click Assemble to generate the binary and hexadecimal output.
6. View the assembled output in the provided tabs.

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.