krolyxon
/
8bit-cpu-emulator
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8 bit cpu emulator with custom ISA
21 Commits 1 Branch 0 Tags 59 KiB
Rust 100%
Go to file
krolxon 4667df1425 update README.md 2026-01-08 19:06:11 +05:30
examples add CALL, RET 2026-01-08 19:02:18 +05:30
src add CALL, RET 2026-01-08 19:02:18 +05:30
.gitignore initial commit 2026-01-04 18:39:25 +05:30
Cargo.lock use clap for arguement parsing 2026-01-04 23:54:56 +05:30
Cargo.toml use clap for arguement parsing 2026-01-04 23:54:56 +05:30
LICENSE add LICENSE 2026-01-05 12:17:04 +05:30
README.md update README.md 2026-01-08 19:06:11 +05:30

README.md

8-Bit CPU Emulator

CPU Architecture

  • Word Size
    • Data Width: 8 bits
    • Address width: 16 bits
    • Address space: 64 KB (0x0000-0xFFFF)

Supported Instructions

Instruction Syntax
MOV mov dest, src OR mov reg, imm
ADD add r1, r2 OR add reg, imm
SUB sub r1, r2 OR sub reg, imm
JMP jmp addr OR jmp addr
JZ jz addr OR jz addr
JNZ jnz addr OR jnz addr
CMP cmp r1, r2 OR cmp reg, imp
MUL mul r1, r2
DIV div r1, r2
CALL call <label>
HLT (Halt) hlt

Registers

Register Size Description
A 8-bit General
B 8-bit General
C 8-bit General
D 8-bit General
PC 16-bit Program Counter
SP 16-bit Stack pointer

Flags

Flag Description
Z Zero Flag
C Carry/Borrow

Usage

cargo run -- --f <examples/filename.asc>

Todo

  • Assembler
    • Lexer/Tokenizer
    • Add label support (supporting JMP/JZ/JNZ)
  • Add instructions
    • CMP
    • MUL
    • DIV
    • CALL
    • RET
  • Error handling
  • Build Debugger