SCASM

Introduction

SCASM is an assembler for the DCPU-16 architecture used in the game 0x10c. See the game's official website for details on the instruction set. This assembler is different and powerful because the code you write is actually Ruby, meaning you can use all the capabilities of a high-level programming language to help generate the final machine code.

Installation

gem install scasm

Example

foo = A
bar = B
offset = 42
add [foo, offset], bar

See the examples directory for more sample code.

Syntax

SCASM input is Ruby code, but you won't need a deep understanding of Ruby to get started. Simple statements like add A, 1 work just like you expect. This section will cover the SCASM-specific syntax.

Registers

Ruby variables named A, B, C, X, Y, Z, I, and J are provided to refer to the processor registers.

Memory

Memory references are of the form [register, offset]. Either register or offset can be omitted.

Examples:

• [A]
• [0x100]
• [A, 2]

Literals

Literal values are just given as integers. Example: 42 or 0x200.

Miscellaneous

These values have the same meaning as in the spec:

• pop
• peek
• push
• sp
• pc
• o

Contributing

Fork the project on GitHub and send me a pull request.