Skip to content

Commit

Permalink
Add files via upload
Browse files Browse the repository at this point in the history
  • Loading branch information
dev-otl authored Oct 10, 2024
1 parent 6d660c3 commit ae5b686
Show file tree
Hide file tree
Showing 3 changed files with 1,090 additions and 0 deletions.
54 changes: 54 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,56 @@
# otlchip8x
Cross platform chip8 emulator/interpreter

## Install
Look at the releases or download source codes from here:

For windows x64:

1) Extract zip file in a folder or download .exe file, download SDL.dll from their SDL website
2) drag and drop a chip8 rom
3) Change created config file as needed

For linux:

1) Extract source code (main.cpp main.h in a folder)
2) Libraries needed to compile:
```
sudo apt-get install libsdl2-dev g++
```
3) Compile:
```
g++ -o otlchip8x main.cpp `sdl2-config --cflags --libs`
```
4) Provide rom as argument to otlchip8x or drag and drop if feature available
```
./otlchip8x "<your_rom_file_(name|path)>"
```
5) Change configuration file as needed

## Roms:

Huge collection of roms hosted by [Kripod](https://github.com/kripod/chip8-roms)

Some tests by [Timendus](https://github.com/Timendus/chip8-test-suite)
## Keymap
QWERTY(or same key position as QWERTY) => Hex Value recognized by Chip8
```
1 2 3 4 => 1 2 3 C
Q W E R => 4 5 6 D
A S D F => 7 8 9 E
Z X C V => A 0 B F
```
```
ESC key : quit
Backspace : reset/refresh/reload, any change in configuration will be loaded.
```
## Configuration
```
ENABLE_DELAY : enable or disable emulation speed(cpu frequency) limit
FREQUENCY_CPU : cpu frequency limit to use if delay enabled
SCALE_FACTOR : length of a square pixel on the window. 64x32 pixels displayed on window.
FRAME_RATE : Display update rate. Frames per seconds
CHIP_MODE : 1)COSMACVIP, 2)CHIP48, 4)SUPERCHIP, only some difference inplemented :: Flag register update, Index register update, etc
```
## Tips
1) Space Invaders : change CHIPMODE to 2 or 4 in configuration file.
Loading

0 comments on commit ae5b686

Please sign in to comment.