Help

Memory Map

Main memory: 0x0 -> 0x8000
Terminal (default): 0xe000 (write), 0xe001 (read)
    

System Handlers

0x01: Write arg to console.log
0xf0: Halt the system
    

Assembler Syntax

• Comments start with ";", these lines are ignored
• Labels start with ":" and must go on their own line. They become variables equal to the value of the offset of the next instruction.
• Variable references are prefixed with "!", eg "!n" to substitute the variable "n". This includes labels, jumping to label foo is done with Imm PC !foo
• Macro invocations start with "."
  • `.defvar` defines a variable that can be referenced later
  • `.defmacro` defines a substitution macro. Instructions are separated by `/`, and tokens of the form `!0`, `!1`, ... represent the first, second, etc arguments when invoked.
    For example, a macro for loading the sum of 2 numbers to the top of the stack:

    .defmacro AddOnStack Imm A !0 / Imm B !1 / Stack A SP Push / Stack B SP Push / Stack Zero SP Add

    Which could be used:

    .AddOnStack 17 33

• All other lines must be a valid instruction of the form "Name [X] [Y] [Z]", where X, Y and Z may be numbers, register names. In a Stack instruction Z must be a Stack Op. In a Test instruction, Z must be a Test Op. See the repo for more details.

Virtual Devices

Terminal I/O

• A simple byte-stream I/O device for reading and writing text
• Writing to 0xe000 (default) will print an ascii character in the output area
• Reading from 0xe001 (default) will give the next character from the input, or 0

Monitor

Virtual pixel monitor coming soon