Directives

dc

b, w, l

Defines constants, following the directive there can be a list of constants separated by commas, the size of each constant depends on the selected size. If no size is selected, the size is determined by the value of the constant. If the constant is a string, it will be stored as a sequence of bytes, if it is a number, it will be stored as a sequence of words

Example
dc.b 'Hello world!', 4, %10, $F, @8, 'a', some_label

ds

b, w, l

Defines a space in memory of N elements, the size of each element depends on the specified size, the content of the space is undefined

Example
ds.l 100

dcb

b, w, l

Defines a space in memory of N elements, the size of each element depends on the specified size, the content of the space is initialized to the second operand

Example
dcb.b 50, 1

org

Sets the current position in memory for the following instructions

Example
org $1000

equ

Defines a constant expression. The symbol cannot be redefined later.

Example
name equ 10

set

Defines an expression value that may be redefined later in the assembled order.

Example
count set count+1

end

Stops assembly and optionally selects the program entry point. Code after it is ignored.

Example
end START

reg

Names a register list for use by movem.

Example
saved reg d0-d3/a0-a2

fail

Raises an assembly error with the rest of the line as its message.

Example
fail Expected an argument

simhalt

Emits a four-byte simulator pause. Run resumes at the following instruction.

Example
simhalt

section

Selects one of sixteen independent location counters, numbered 0 through 15.

Example
section 1

offset

Enters an offset-only region at the given value. Labels receive offsets and no bytes are emitted until org.

Example
offset 0

include

Assembles another text File at this point. The path is relative to the including File, then the Project root.

Example
include 'lib/io.x68'

incbin

Copies the exact bytes of another File into memory at this point.

Example
incbin 'images/sprite.bin'

opt

Accepts an assembler option for compatibility and ignores it.

Example
opt xref

list

Accepted for compatibility and ignored.

Example
list

nolist

Accepted for compatibility and ignored.

Example
nolist

page

Accepted for compatibility and ignored.

Example
page