as: M68HC11-Opts
1
1 9.24.1 M68HC11 and M68HC12 Options
1 ----------------------------------
1
1 The Motorola 68HC11 and 68HC12 version of 'as' have a few machine
1 dependent options.
1
1 '-m68hc11'
1 This option switches the assembler into the M68HC11 mode. In this
1 mode, the assembler only accepts 68HC11 operands and mnemonics. It
1 produces code for the 68HC11.
1
1 '-m68hc12'
1 This option switches the assembler into the M68HC12 mode. In this
1 mode, the assembler also accepts 68HC12 operands and mnemonics. It
1 produces code for the 68HC12. A few 68HC11 instructions are
1 replaced by some 68HC12 instructions as recommended by Motorola
1 specifications.
1
1 '-m68hcs12'
1 This option switches the assembler into the M68HCS12 mode. This
1 mode is similar to '-m68hc12' but specifies to assemble for the
1 68HCS12 series. The only difference is on the assembling of the
1 'movb' and 'movw' instruction when a PC-relative operand is used.
1
1 '-mm9s12x'
1 This option switches the assembler into the M9S12X mode. This mode
1 is similar to '-m68hc12' but specifies to assemble for the S12X
1 series which is a superset of the HCS12.
1
1 '-mm9s12xg'
1 This option switches the assembler into the XGATE mode for the RISC
1 co-processor featured on some S12X-family chips.
1
1 '--xgate-ramoffset'
1 This option instructs the linker to offset RAM addresses from S12X
1 address space into XGATE address space.
1
1 '-mshort'
1 This option controls the ABI and indicates to use a 16-bit integer
1 ABI. It has no effect on the assembled instructions. This is the
1 default.
1
1 '-mlong'
1 This option controls the ABI and indicates to use a 32-bit integer
1 ABI.
1
1 '-mshort-double'
1 This option controls the ABI and indicates to use a 32-bit float
1 ABI. This is the default.
1
1 '-mlong-double'
1 This option controls the ABI and indicates to use a 64-bit float
1 ABI.
1
1 '--strict-direct-mode'
1 You can use the '--strict-direct-mode' option to disable the
1 automatic translation of direct page mode addressing into extended
1 mode when the instruction does not support direct mode. For
1 example, the 'clr' instruction does not support direct page mode
1 addressing. When it is used with the direct page mode, 'as' will
1 ignore it and generate an absolute addressing. This option
1 prevents 'as' from doing this, and the wrong usage of the direct
1 page mode will raise an error.
1
1 '--short-branches'
1 The '--short-branches' option turns off the translation of relative
1 branches into absolute branches when the branch offset is out of
1 range. By default 'as' transforms the relative branch ('bsr',
1 'bgt', 'bge', 'beq', 'bne', 'ble', 'blt', 'bhi', 'bcc', 'bls',
1 'bcs', 'bmi', 'bvs', 'bvs', 'bra') into an absolute branch when the
1 offset is out of the -128 .. 127 range. In that case, the 'bsr'
1 instruction is translated into a 'jsr', the 'bra' instruction is
1 translated into a 'jmp' and the conditional branches instructions
1 are inverted and followed by a 'jmp'. This option disables these
1 translations and 'as' will generate an error if a relative branch
1 is out of range. This option does not affect the optimization
1 associated to the 'jbra', 'jbsr' and 'jbXX' pseudo opcodes.
1
1 '--force-long-branches'
1 The '--force-long-branches' option forces the translation of
1 relative branches into absolute branches. This option does not
1 affect the optimization associated to the 'jbra', 'jbsr' and 'jbXX'
1 pseudo opcodes.
1
1 '--print-insn-syntax'
1 You can use the '--print-insn-syntax' option to obtain the syntax
1 description of the instruction when an error is detected.
1
1 '--print-opcodes'
1 The '--print-opcodes' option prints the list of all the
1 instructions with their syntax. The first item of each line
1 represents the instruction name and the rest of the line indicates
1 the possible operands for that instruction. The list is printed in
1 alphabetical order. Once the list is printed 'as' exits.
1
1 '--generate-example'
1 The '--generate-example' option is similar to '--print-opcodes' but
1 it generates an example for each instruction instead.
1