2024-01-31 01:54:35 +00:00
|
|
|
# Yet Another Yet Another Chip-8 Emulator (yayacemu)
|
|
|
|
|
|
|
|
|
|
[Because one just wasn't enough](https://github.com/nickorlow/yacemu).
|
|
|
|
|
|
|
|
|
|
A Chip-8 emulator (interpreter) written in SystemVerilog with I/O simulated with C++ also depends on SDL2.
|
|
|
|
|
|
2024-01-31 01:57:54 +00:00
|
|
|
Note: Code quality is bad at the moment because I just wanted to get graphics working and didn't pay much attention to it. I will fix tomorrow.
|
|
|
|
|
|
2024-01-31 01:54:35 +00:00
|
|
|
### Building & Testing
|
|
|
|
|
|
|
|
|
|
In order to run yayacemu, you must have sdl2, verilator, 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]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Running
|
|
|
|
|
|
|
|
|
|
If you have a binary, you can run it with the following:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
yayacemu [PATH_TO_YOUR_ROM]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Todo
|
|
|
|
|
- [x] Graphics
|
|
|
|
|
- [ ] Corax+ Required Instructions
|
|
|
|
|
- [ ] Proper Flag Handling
|
|
|
|
|
- [ ] Working Input
|
|
|
|
|
- [ ] More Instructions
|
|
|
|
|
- [ ] Tetris Working Running
|
2024-01-31 01:57:54 +00:00
|
|
|
- [ ] Pass Quirks Test
|
2024-01-31 01:54:35 +00:00
|
|
|
- [ ] Add beeper (instead of sound, screen becomes red)
|
|
|
|
|
- [ ] Code cleanup
|
|
|
|
|
- [ ] All Instructions
|
|
|
|
|
|
|
|
|
|
### Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
