ALGOSUP - 2023-2024 - Project 3 - Virtual Processor - Team 3

Team Members

Photo	Name	Role	GitHub/LinkedIn
	MARLIER Thibaud	Project Manager	GitHub | LinkedIn
	CLEMENT Quentin	Program Manager	GitHub | LinkedIn
	FERNANDEZ Aurélien	Technical Leader	GitHub | LinkedIn
	ARCHIMBAUD Malo	Software Engineer	GitHub | LinkedIn
	KAKAL Mathis	Software Engineer	GitHub | LinkedIn
	LEMOINE Arthur	Quality Assurance	GitHub | LinkedIn

Overview

This project is an ALGOSUP project, driven by the students. This project aims to create a Virtual Processor along with an Assembly language to run instructions on it. Moreover, we have to develop a built-in debugger. All of that, using plain and portable C language (only standard libraries are allowed).

What Is ALGORISK

ALGORISK is our processor, it stands for ALGOSUP RISK, the risk refers to RISC V from which we got inspired to create our processor.

What Is ALGORASM

ALGORASM is our assembly language, it stands for ALGORISK assembly. The files written in ALGORASM are either text files or .gras files, which means gorisk assembly.

Processing a text file written in ALGORASM or a .gras file will create a new file named as the previous one but with the .grml extension.

How To Install

Firstly, you'll need to install GCC (if not done yet): Download GCC now !
Follow the instructions to download gcc on the website.

• Then, check out our latest release: Latest release here
• Download the source code. You'll find everything you need, documentation, code, etc... Feel free to familiarize yourself with the files.
• And voila! You're all set for a fresh start with ALGORASM and ALGORISK.

Visual Studio Code Extension

By following the link down below, you'll get redirected to the necessary Visual Studio Code Extension for ALGORISK, this is a set of tools for you, from snippets to syntax highlighting.
You'll find everything you need to code with our Assembly.
Link to the extension

How To Use

To code in ALGORASM feel free to check the documentation here: Instruction Set Manual

To use our virtual processor you can choose between 3 different commands:

./main.exe gorasm [your file name].txt

Your file should contain ALGORISK assembly, else it may return an error.

This command will assemble the ALGORISK assembly into a .grml file, containing the binary of your program.

./main.exe goproc [your file name].grml

This command will execute the binary of a .grml file.

./main.exe gorisk [your file name].txt

This command executes the two previous commands into one.

License

This project is under the MIT License

Copyright (c) 2024 ALGOSUP