Files
dumb8/README.md
2024-10-19 21:25:45 +02:00

61 lines
1.2 KiB
Markdown

# Dumb8-CPU
Continuing my exploration of the lower-level world...
This project is the implementation of a CPU in a high-level language, C. It aims to have a reduced (minimalist) instruction set and still be Turing complete.
## How to test
You can run a test program like that. I'll try making a developer's manual so one can make its own programs using the custom assembly here.
```
make
./a.out program.asm
```
## Technical specifications
- 8-bit processing unit
- RISC (reduced instruction set computer)
- 4 general purpose registers (labeled R0 to R3)
- 1 input port, 1 output port (via getchar and putchar)
- Turing-completeness: bitwise and arithmetic operations
## Instruction set reference (for programmers)
```
; Move register RY to register RX
MOV RX, RY
; Arithmetic addition and substraction stored in RX
ADD RX, RY
SUB RX, RY
; Bitwise operations stored in RX
OR RX, RY
AND RX, RY
XOR RX, RY
; Output RX to screen
OUT RX
; Input RX from keyboard
IN RX
; Jump to memory offset ADDR (decimal)
JMP ADDR
; Jump to memory offset ADDR (decimal) if equal flag is set by previous comparison
JEQ ADDR
; Compare RX and RY, sets equal flag if true
CMP RX, RY
; No operation; does nothing
NOP
; Halts the processing unit
HLT
```