https://github.com/stovent/risp8

Experimental Chip8 interpreter, cached interpreter and Just-In-Time compiler written in Rust.
https://github.com/stovent/risp8

cached cached-interpreter chip8 emulator interpreter jit jit-compiler rust

Last synced: about 2 months ago
JSON representation

Experimental Chip8 interpreter, cached interpreter and Just-In-Time compiler written in Rust.

• Host: GitHub
• URL: https://github.com/stovent/risp8
• Owner: Stovent
• License: mit
• Created: 2020-10-12T20:43:28.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-03-22T05:10:11.000Z (10 months ago)
• Last Synced: 2024-03-22T06:23:25.569Z (10 months ago)
• Topics: cached, cached-interpreter, chip8, emulator, interpreter, jit, jit-compiler, rust
• Language: Rust
• Homepage: https://github.com/Stovent/risp8
• Size: 232 KB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# risp8

Experimental Chip8 interpreter, cached interpreter and JIT compiler written in Rust.

There is a GUI frontend and a TUI frontend.

The JIT is only available on x86_64.

## Controls

The Chip8 controls are mapped on the keyboard and on the numpad.

TUI only has the keyboard mapping.

For each table below, the key in each layout square is the corresponding Chip8 key.

### Keyboard mapping

Keyboard key:

| | | | |

|---|---|---|---|

| 3 | 4 | 5 | 6 |

| E | R | T | Y |

| D | F | G | H |

| C | V | B | N |

Chip8 key:

| | | | |

|---|---|---|---|

| 1 | 2 | 3 | C |

| 4 | 5 | 6 | D |

| 7 | 8 | 9 | E |

| A | 0 | B | F |

### Numpad mapping

Numpad key:

| | | | |

|---|---|---|---|

|   | / | * | - |

| 7 | 8 | 9 | + |

| 4 | 5 | 6 | + |

| 1 | 2 | 3 | enter |

| 0 | 0 | . | enter |

Chip8 key:

| | | | |

|---|---|---|---|

|   | A | B | C |

| 1 | 2 | 3 | D |

| 4 | 5 | 6 | D |

| 7 | 8 | 9 | E |

| 0 | 0 | F | E |

## GUI Control hotkeys

| key | action |

|:---:| --- |

|  P  | Play/Pause toggle |

|  S  | Single Step |

|  I  | Interpreter |

|  K  | Cached interpreter |

|  L  | Cached interpreter 2 |

|  M  | Cached interpreter 3 |

|  J  | JIT |

## TUI Control hotkeys

| key | action |

|:---:| --- |

|  Q  | Close the emulator |

|  P  | Play/Pause toggle |

|  S  | Single Step |

|  I  | Interpreter |

|  K  | Cached interpreter |

|  L  | Cached interpreter 2 |

|  M  | Cached interpreter 3 |

|  J  | JIT |

|  A  | Change the display charactere |

## License

risp8 is distributed under the terms of the MIT license. Refer to the LICENSE file for more information.