Skip to content

README.md

Latest commit

 

History

History
102 lines (71 loc) · 2.66 KB

README.md

File metadata and controls

102 lines (71 loc) · 2.66 KB
Raw

SPU (software processing unit)

This repository contains an implementation of a simple processor simulation, including an assembler and a disassembler. The processor can execute a set of predefined commands on a stack-based architecture, allowing for mathematical operations and control flow(conditional jumps and function calls/returns).

Assembler

Convertes a higher-level representation of code into bytecode for the processor. Assembles in 2 passes.

Disasm

Translates bytecode back into a human-readable format.

Commands list

  • Registers names: ax, bx, cx, dx, ex, fx, gx, hx

Common

Name Description
hlt halt - end of program
push push value to stack
pop pop value from stack
out pop value from stack and print to ostream
dmp dump info about current state of processor

Jumps

You need to specify label in code or address.

Name Description
jmp jump to specified address of executable file
ja jump if >
jae jump if >=
jb jump if <
jbe jump if <=
je jump if ==
jne jump if !=
call calls method (pushes to stack address of the next command for returning)
ret pops return address from stack and jumps there (end of method)

ja , jae , jb , jbe , je , jne pops two elements from stack and compares the last popped with the first one.

Syntax example

jmp meow:
...
meow:

call func:

func:
...
ret

Maths

These functions pop 1 or 2 elements, make calculations and push result to stack

Name Description
add + operator
sub - operator
mul * operator
div / operator
sqrt 'sqrt' operator
sqr find square
sin 'sin' operator
cos 'cos' operator

Syntax example

push ax          ; push value from rbx register to stack
push 9.87        ; push value 9.87 to stack
jmp label:       ; jump to label named "label"
add              ; pop two elements from stack and push their sum
out;             ; pop element from stack and print

Command line flags

-i <file name> | --input_file <file name>- get code from a file with given name

-o <file name> | --output_file <file name>- print results to a file with given name

-l <file name> | --logger_output <file name>- print logs to a file with given name

-h | --help- print help message with all commands description

Usage

Build

make asm, make proc, make disasm - build separately