68 lines
1.9 KiB
Markdown
68 lines
1.9 KiB
Markdown
# Yet another Chip-8 emulator (yacemu)
|
|
A Chip-8 emulator (interpereter) written in C. Depends on SDL2.
|
|
|
|
[Want to see Yet another yet another Chip-8 emulator? (in Verilog)](https://github.com/nickorlow/yayacemu)
|
|
|
|
### Building & Testing
|
|
|
|
In order to run yacemu, you must have sdl2 and make installed.
|
|
|
|
Once you have the dependencies installed, you can build the emulator with:
|
|
```shell
|
|
make build
|
|
```
|
|
|
|
You can build start the emulator with:
|
|
```shell
|
|
make run ROM_FILE=[PATH_TO_YOUR_ROM]
|
|
```
|
|
|
|
If you would like to run it in turbo mode (faster emulation, useful for testing) then run:
|
|
```shell
|
|
make run-turbo ROM_FILE=[PATH_TO_YOUR_ROM]
|
|
```
|
|
|
|
If you would like to debug with gdb then run:
|
|
```shell
|
|
make debug ROM_FILE=[PATH_TO_YOUR_ROM]
|
|
```
|
|
|
|
If you would like to debug with gdb in turbo mode then run:
|
|
```shell
|
|
make debug-turbo ROM_FILE=[PATH_TO_YOUR_ROM]
|
|
```
|
|
|
|
### Running
|
|
|
|
If you have a binary, you can run it with the following:
|
|
|
|
```shell
|
|
yacemu [PATH_TO_YOUR_ROM]
|
|
```
|
|
|
|
If you would like to run it in turbo mode (faster emulation, useful for testing) then run:
|
|
|
|
```shell
|
|
yacemu [PATH_TO_YOUR_ROM] turbo
|
|
```
|
|
|
|
### Todo
|
|
- [x] Graphics
|
|
- [x] Corax+ Required Instructions
|
|
- [x] Proper Flag Handling
|
|
- [x] Working Input
|
|
- [x] More Instructions
|
|
- [x] Tetris Working Running
|
|
- 1/2 Pass Quirks Test (DispQuirk is a bit touchy)
|
|
- [x] Add beeper (instead of sound, screen becomes red)
|
|
- [ ] Code cleanup
|
|
- [ ] Rest of Instructions (I believe a few are missing)
|
|
|
|
### Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|