Skip to content

Latest commit

 

History

History
47 lines (34 loc) · 1.33 KB

README.md

File metadata and controls

47 lines (34 loc) · 1.33 KB

Chip8Emu

An emulator for the classic virtual architechture

Usage

chip8 <ROM> [-s/--speed SPEED] [-d/--debug]

Keyboard

(Chip8 key is listed, QWERTY key is in parentheses)

| 1 (1) | 2 (2) | 3 (3) | C (4) |

| 4 (Q) | 5 (W) | 6 (E) | D (R) |

| 7 (A) | 8 (S) | 9 (D) | E (F) |

| A (Z) | 0 (X) | B (C) | F (V) |

To better visualize the keyboard, imagine a phone keyboard starting at 1, with A and B next to 0, and then the last four digits down the side.

Other keys:

  • Press [spacebar] or p to pause/unpause
  • Press . to toggle debug mode
  • Press [enter] to step through the program

Debug mode:

Debug mode splits the screen into 4:

  • Chip8 display in top left
  • Assembly instructions in bottom left
  • Memory contents in top right
  • register contents in bottom right

While in debug mode, you can scroll through the program instructions, and click to the left of any instruction to set a breakpoint, represented by a red circle. Clicking a second time will remove the breakpoint. The program will automatically pause when it hits a breakpoint.

Resources