pveentjer/Rust-based-ARM-emulator

A bogus CPU emulator written in Rust.

Rust based ARM CPU emulator

About The Project

The primary aim of this project is to implement modern ARM processors in software using Rust.

The goal is to offer insights into how modern processors might work.

This project does not aim to provide a fast implementation; for that, code generation using binary translation would be significantly faster.

Warning

This is a toy project. I want to upgrade my Rust skills and I needed a serious enough challenge to work on. Also, the challenge should initially be without the need for concurrency control so that I get a better understanding of ownership.

CPU features

• Pipelined Execution
• Super Scalar Execution
• Out of Order Execution using Tomasulo's algorithm. So only RAW dependencies are preserved.
• Speculative Execution
• Branch prediction (static only ATM)
• Store Buffer
• Performance monitor although not exposed through model specific registers.

Planned CPU features

• Support for different data types (currently only dword)
• One-way fences like LDAR, STLR, LDAPR.
• Two-way fences like DMB
• Serializing instructions like DSB
• Exclusive access instructions like LDXR, STXR, LDAXR, STLXR
• SMT (aka hyper-threading)
• CMP (aka multicore)
• Working cache (MESI based)
• Write coalescing
• Store buffer out-of-order commit to the cache
• SVE (SIMD)
• NEON (SIMD)

Supported instructions

Arithmetic instructions:

• ADD
• SUB
• MUL
• SDIV
• NEG
• RSB

Bitwise logical instructions:

• AND
• ORR
• EOR
• MVN

Memory access instructions:

• LDR
• STR

Miscellaneous instructions:

• MOV

Synchronization instructions;

• NOP
• DSB

Branch & control instructions:

• CMP
• TST
• TEQ
• B
• BX
• BL
• RET
• CBZ
• CBNZ
• BEQ
• BNE
• BLE
• BLT
• BGE
• BGT

Unofficial instructions

• PRINTR: prints the value of a register.

More instructions will be added over time.

How to run

cargo run -- --file asm/high_ipc.asm --config cpu.yaml