Skip to content

Latest commit

 

History

History
146 lines (127 loc) · 4.81 KB

README.md

File metadata and controls

146 lines (127 loc) · 4.81 KB

Soup

A gameboy emulator written in rust

How to run

(Builds not available yet)

cargo run --release ./path/to/file.gb

Keys

Move: Arrows
A: x key
B: z key
Select: Space
Start: Enter

Status

  • Audio not supported (yet)
  • Some cartridges are not yet supported. See "Test status"

Tests status:

Blargg

Test Status
cpu_instr 👍
instr_timing 👍
halt_bug 👍
interrupt_time
mem_timing 👍
mem_timing-2 👍
cgb_sound
dmg_sound
oam_bug

Mooneye Acceptance tests

Test Status
add_sp_e_timing 👍
call_cc_timing 👍
call_cc_timing2 👍
call_timing 👍
call_timing2 👍
di_timing-GS
div_timing 👍
ei_sequence 👍
ei_timing 👍
halt_ime0_ei 👍
halt_ime0_nointr_timing
halt_ime1_timing 👍
halt_ime1_timing2-GS
if_ie_registers 👍
intr_timing 👍
jp_cc_timing 👍
jp_timing 👍
ld_hl_sp_e_timing 👍
oam_dma_restart 👍
oam_dma_start
oam_dma_timing 👍
pop_timing 👍
push_timing 👍
rapid_di_ei 👍
ret_cc_timing 👍
ret_timing 👍
reti_intr_timing 👍
reti_timing 👍
rst_timing 👍
bits/mem_oam 👍
bits/reg_f 👍
bits/unused_hwio-GS
instr/daa 👍
interrupts/ie_push
oam_dma/basic 👍
oam_dma/reg_read 👍
oam_dma/sources-GS
ppu/hblank_ly_scx_timing-GS
ppu/intr_1_2_timing-GS
ppu/intr_2_0_timing
ppu/intr_2_mode0_timing 👍
ppu/intr_2_mode0_timing_sprites
ppu/intr_2_mode3_timing 👍
ppu/intr_2_oam_ok_timing 👍
ppu/lcdon_timing-GS
ppu/lcdon_write_timing-GS
ppu/stat_irq_blocking
ppu/stat_lyc_onoff
ppu/vblank_stat_intr-GS
serial/boot_sclk_align-dmgABCmgb
timer/div_write 👍
timer/rapid_toggle
timer/tim00 👍
timer/tim00_div_trigger 👍
timer/tim01 👍
timer/tim01_div_trigger 👍
timer/tim10 👍
timer/tim10_div_trigger 👍
timer/tim11 👍
timer/tim11_div_trigger 👍
timer/tima_reload 👍
timer/tima_write_reloading 👍
timer/tma_write_reloading 👍

Mooneye Emulator Only tests

Test Status
mbc1/bits_bank1 👍
mbc1/bits_bank2 👍
mbc1/bits_mode 👍
mbc1/bits_ramg 👍
mbc1/multicart_rom_8Mb
mbc1/ram_64kb 👍
mbc1/ram_256kb 👍
mbc1/rom_1Mb 👍
mbc1/rom_2Mb 👍
mbc1/rom_4Mb 👍
mbc1/rom_8Mb 👍
mbc1/rom_16Mb 👍
mbc1/rom_512kb 👍
Test Status
mbc2/bits_ramg 👍
mbc2/bits_romb 👍
mbc2/bits_unused 👍
mbc2/ram 👍
mbc2/rom_1Mb 👍
mbc2/rom_2Mb 👍
mbc2/rom_512kb 👍
Test Status
mbc3 Supported but not tested

Disclaimer

This gameboy emulator was made for academic purposes only. If you're going to use it, please use uncopyrighted or open source games.