02_Computer-Architecture-I

Assembly-Character-Identifier

College project made with Assembly RISC-V to identify a character in a specific image, based on RGB and Hue.
Graded 19/20 overall (20/20 for the code, with the deduction due to the report).

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Results

About the project

Final project done in the Computer Architecture I class, during the 1st year of the computer science degree.

With it I was able to improve my knowledge with:

• C programming language
• Linux terminal
• Assembly RISC-V
• Image properties (RGB, Hue, ...)

Getting started

Prerequisites

1. Linux system (for the Makefile)
2. ImageMagick package
3. RARS assembler and runtime system for RISC-V,

Installation (ImageMagick)

# Choose the needed one:

sudo apt-get install imagemagick # ubuntu
sudo yum install ImageMagick     # centOS / REHL
sudo dnf install ImageMagick     # Fedora
sudo pacman -S imagemagick       # Arch Linux

Usage

After pulling the code, you can execute in two ways:

(1.1) RISC-V

1. Open the folder containing the RARS file and execute it with the command below:

java -Xmx8g -XX:+UseParallelGC -jar rars1_6.jar # for the 1_6 version!

2. Open assembly.asm with RARS
3. Save, compile and run the code

(1.2) C code

In Linux, open the containing folder and enter "make" in the terminal

(2.) Interface

It should appear:

• a question in the terminal asking for the character to select in the image
• a new image file with a small yellow cross made in the head of the chosen character

Results

Starting image

Results (each choosing a different character from the 3 available)