CHIP8Assembler

Very simple Assembler for the CHIP-8 Fantasy Console

Using CHIP8Assembler:

After compile, simply run it with the source file as its first argument. You can also specifiy an output file as the second argument. If you don't, it'll default to "cart.c8"

Quick Reference:

SYSC NNN : Syscall (0x0NNN).

CLEAR: Clears the Screen (0x00E0).

RETN: Return from sub-routine (0x00EE).

JUMP NNN : Jump to address NNN (0x1NNN)

CALL NNN : Call subroutine NNN (0x2NNN)

JNEM X NN: Skip if VX Not Equal Immediate NN (0x3XNN)

JEQM X NN: Skip if VX Equal Immediate NN (0x4XNN)

JEQU X Y : Skip if VX Equal VY (0x5XY0)

SETM X NN: Set VX to Immediate NN (0x6XNN)

ADDM X NN: Add Immediate NN to VX (0x7XNN)

RGOP X Y : Register Operations (See further down for more info, 0x8XYK)

JNEQ X Y : Skip if VX not equal VY (0x9XY0)

SETI NNN : Set I to Immediate NNN (0xANNN)

JMPV NNN : Jump to Address Immediate NNN + V0 (0xBNNN)

RAND X NN: Set VX to a Random Number & NN (0xCXNN)

DRAW X Y N: Draws a Sprite at Position (VX,VY) with the Height of N (0xDXYN)

KEYD X : Skips if the Key Stored in VX is Not Pressed (0xEX9E)

KEYU X : Skips if the Key Stored in VX is Pressed (0xEXA1)

DGET X : Sets VX to the Delay Timer (0xFX07)

KGET X : Blocks Until a Key Press, Set VX to that Key Press (0xFX0A)

DSET X : Sets the Delay Timer to VX (0xFX15)

ASET X : Sets the Sound Timer to VX (0xFX18)

ADDI X : Adds VX to I (0xFX1E)

FONT X : Sets I to the Address of Hex Character Font Data Stored in VX (0xFX29)

SBCD X : Stores the Binary-Coded Decimal Representation of VX Starting at I (0xFX33)

DUMP X : Stores V0-VX in Memory Starting at I (0xFX55)

LOAD X : Loads X Bytes of Data from Memory Starting at I, Storing in V0-VX (0xFX65)

Comments can be made by starting a line with a #

Numbers can be represented using Binary, Octal, Decimal and Hexadecimal by starting the number with 0b, 0o, 0d, 0x respectively. By default numbers will be interpreted as decimal.

Labels can be created by starting a line with the $ character. You can access them with $LABEL_NAME. You can add an offset to the label with $LABEL_NAME/offset.

Register Operations:

The RGOP Instruction takes 3 arguments. X, Y and K.

X and Y represent two register, K represents an operation. RGOP will execute operation K on VX and VY and store the result on VX.

While K is a number, this assembler also gives a few keywords that represent said numbers to make using RGOP easier:

ASSIGN: Sets VX to VY

BWOR: Sets VX to VX | VY (Bitwise OR)

BAND: Sets VX to VX & VY (Bitwise AND)

BXOR: Sets VX to VX ^ VY (Bitwise XOR)

ADD: Sets VX to VX + VY

SUB: Sets VX to VX - VY

LSHIFT: Sets VX to VX>>1

NEGATE: Sets VX to VY-VX

RSHIFT: Sets VX to VX<<1

Todo:

Error Checking

Comments

Labels

Probably more stuff