Assembler/README.md
2023-04-04 23:40:32 +02:00

22 lines
1.3 KiB
Markdown
Executable file

# Assembler
### CLI application written in C
The assembler converts the written assembly into a memory image for the EIPA processor. This memory image then contains the instructions in as machiene code which is readable by the EIPA processor
It is basically made up of 4 building blocks:
### 1. lexer
The lexer takes the file with the written assembly and converts it into the individual components (tokens). It also takes into account if, for example, there are multiple spaces between the parts of the instruction, so that the other parts of the assembler do not have to worry about that. It converts e.g. the line
`INP 31 ; A comment`
into the parts `|INP|, |31|, |end of instruction|`.
### 2. error analyzer
The error analyzer takes the tokens from the lexer, and checks e.g. if the address of an instruction is too large, if an instruction that needs an address has one, if there are any typos, etc. If it finds an error, it aborts the program.
### 3. target code generator
The target code generator converts the tokens from the lexer, after checking them for errors, into machine code readable by the EIPA processor.
### 4. image saver
The image saver stores the generated machine code in an EIPA memory image, which can then be loaded into memory by the processor and executed.
The design of the expected assembly code is described in ``design.txt``.