Command Line Functions

[V]Chip8 <file> -q -s100 -c5 -b12 -u -d -kxnnnn

Command Line Options

-q	Quiet mode - the sound is turned off
-s100	Speed adjustment factor - slows down the processor for games that don't use the delay timer to control speed. This overrides the speed automatically calibrated when the program is run.
-c5	Set the display colour
-b12	Sets the border colour of the display (Text Mode Version only)
-u	Stops the interpreter updating the screen after every sprite write. If its too slow (on an XT ?) turn this off.
-d	Enter the debugger instead of running the program.
-kxnnn	Map key with keycode nnnn onto Chip-8 Key x. For extended codes,nnn is the keycode + 128. For example -kC32 maps the space bar (ASCII 32) onto the C key.

The original Chip-8 used 16 keys as follows :-

1	2	3	C
4	5	6	D
7	8	9	E
A	0	B	F

On this implementation the keys are mapped as follows :-

1	2	3	4
Q	W	E	R
A	S	D	F
Z	X	C	V

The Escape key is used to interrupt execution of a program.

Debugger functions

q	Return to MS-DOS
s	Single step an instruction
+	Advance two memory locations
-	Back two memory locations
x	Execute program normally
r	Dump Chip-8 Registers
v	View game screen
Page Up	Back 128 bytes
Page Down	Forward 128 bytes
d	Dump 16 bytes memory
c	Step through subroutines
Home	Set PC = 200H & Clear Screen

Index