Depending on the target ISA, the executable to invoke will be named motor, followed by the CPU architecture name. motorz80 (for Z80 and Game Boy), motor6809 (for Motorola 6809), motor68k (for Motorola 680x0), motor6502 (6502 and derivatives, and 65C816), motormips (for MIPS), motorschip (for CHIP-8/SCHIP) or motordcpu16 (for DCPU-16).
-a<n> Section alignment when writing binary file
-b<AS> Change the two characters used for binary constants
(default is 01)
-e(l|b) Change endianness
-f<f> Output format, one of
x - xobj (default)
b - binary file
v - verilog readmemh file
g - Amiga executable file
h - Amiga object file
-i<dir> Extra include path (can appear more than once)
-o<f> Write assembly output to <file>
-v Verbose text output
-w<d> Disable warning <d> (four digits)
-z<XX> Set the byte value (hex format) used for uninitialised
data (default is FF)
An assembler for a particular ISA may support additional options relevant for the target architecture. Please consult the CPU specific documentation for ISA specific options.
The OPT directive can be used to set options while assembling. The options that can be set are the
same as the command line options. The current set of options can be saved on an option stack using the
PUSHO directive and restored at a later point using POPO.
PUSHO
OPT w0001 ; disable warning 0001
; code
POPO
The syntax is line based. A valid line consists of an optional label, an ISA instruction or assembler instruction and an optional comment. Labels are described in the "Labels" section, assembler instructions in The macro language.
Label: INSTR ; comment
Labels and other symbols are case sensitive. Directives, register names and mnemonics are not.
Comments are ignored during assembling. They are an important part of writing code, this is especially true for assembly where comments are essential for documenting what a function does - it's not as immediately obvious as when code is written in a higher level language.
Comments usually start with a semi-colon and end at the end of the line. A comment may also begin with a whitespace character (including a line break) followed by an asterisk.
* These are comment examples
moveq #1,d0 ;load register d0 with the value 1
move.l d0,d1 *copy it to d1
- Introduction, goals and background
- Invoking the assembler and basic syntax
- Symbols and labels
- Control structures like
INCLUDE,MACROs and conditional assembling. - Expressions and how they're built
- Printing diagnostic messages, warnings and errors
- Organising code into sections. How to define data.
- The linker