From 35b55ed2130551c6ba7a5e164be92e8de8101b64 Mon Sep 17 00:00:00 2001 From: Stephane Carrez Date: Wed, 9 Apr 2003 21:48:39 +0000 Subject: [PATCH] * doc/c-m68hc11.texi (M68HC11-Opts): Document -m68hcs12, -mshort, -mlong, -mshort-double and -mlong-double options; use table @code. (M68HC11-Syntax): Update to document 68HC12 operands. (M68HC11-Modifiers): New section for operand modifiers. (M68HC11-Directives): New section for specific assembler directives. (M68HC11-Branch): Fix Overfull hbox error. --- gas/ChangeLog | 9 ++ gas/doc/c-m68hc11.texi | 242 ++++++++++++++++++++++++++++++++++++++--- 2 files changed, 233 insertions(+), 18 deletions(-) diff --git a/gas/ChangeLog b/gas/ChangeLog index 9c32d9dc65..fff94ad473 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,12 @@ +2003-04-09 Stephane Carrez + + * doc/c-m68hc11.texi (M68HC11-Opts): Document -m68hcs12, -mshort, + -mlong, -mshort-double and -mlong-double options; use table @code. + (M68HC11-Syntax): Update to document 68HC12 operands. + (M68HC11-Modifiers): New section for operand modifiers. + (M68HC11-Directives): New section for specific assembler directives. + (M68HC11-Branch): Fix Overfull hbox error. + 2003-04-09 Alexandre Oliva * config/tc-mips.c (macro): Add comments explaining the rationale diff --git a/gas/doc/c-m68hc11.texi b/gas/doc/c-m68hc11.texi index 84fdd557fd..8e2ba0004b 100644 --- a/gas/doc/c-m68hc11.texi +++ b/gas/doc/c-m68hc11.texi @@ -16,6 +16,8 @@ @menu * M68HC11-Opts:: M68HC11 and M68HC12 Options * M68HC11-Syntax:: Syntax +* M68HC11-Modifiers:: Symbolic Operand Modifiers +* M68HC11-Directives:: Assembler Directives * M68HC11-Float:: Floating Point * M68HC11-opcodes:: Opcodes @end menu @@ -25,21 +27,52 @@ @cindex options, M68HC11 @cindex M68HC11 options -The Motorola 68HC11 and 68HC12 version of @code{@value{AS}} has a few machine +The Motorola 68HC11 and 68HC12 version of @code{@value{AS}} have a few machine dependent options. +@table @code + @cindex @samp{-m68hc11} +@item -m68hc11 This option switches the assembler in the M68HC11 mode. In this mode, the assembler only accepts 68HC11 operands and mnemonics. It produces code for the 68HC11. @cindex @samp{-m68hc12} +@item -m68hc12 This option switches the assembler in the M68HC12 mode. In this mode, the assembler also accepts 68HC12 operands and mnemonics. It produces -code for the 68HC12. A fiew 68HC11 instructions are replaced by +code for the 68HC12. A few 68HC11 instructions are replaced by some 68HC12 instructions as recommended by Motorola specifications. +@cindex @samp{-m68hcs12} +@item -m68hcs12 +This option switches the assembler in the M68HCS12 mode. This mode is +similar to @samp{-m68hc12} but specifies to assemble for the 68HCS12 +series. The only difference is on the assembling of the @samp{movb} +and @samp{movw} instruction when a PC-relative operand is used. + +@cindex @samp{-mshort} +@item -mshort +This option controls the ABI and indicates to use a 16-bit integer ABI. +It has no effect on the assembled instructions. +This is the default. + +@cindex @samp{-mlong} +@item -mlong +This option controls the ABI and indicates to use a 32-bit integer ABI. + +@cindex @samp{-mshort-double} +@item -mshort-double +This option controls the ABI and indicates to use a 32-bit float ABI. +This is the default. + +@cindex @samp{-mlong-double} +@item -mlong-double +This option controls the ABI and indicates to use a 64-bit float ABI. + @cindex @samp{--strict-direct-mode} +@item --strict-direct-mode You can use the @samp{--strict-direct-mode} option to disable the automatic translation of direct page mode addressing into extended mode when the instruction does not support direct mode. @@ -50,6 +83,7 @@ This option prevents @code{@value{AS}} from doing this, and the wrong usage of the direct page mode will raise an error. @cindex @samp{--short-branchs} +@item --short-branchs The @samp{--short-branchs} option turns off the translation of relative branches into absolute branches when the branch offset is out of range. By default @code{@value{AS}} transforms the relative @@ -66,16 +100,19 @@ is out of range. This option does not affect the optimization associated to the @samp{jbra}, @samp{jbsr} and @samp{jbXX} pseudo opcodes. @cindex @samp{--force-long-branchs} +@item --force-long-branchs The @samp{--force-long-branchs} option forces the translation of relative branches into absolute branches. This option does not affect the optimization associated to the @samp{jbra}, @samp{jbsr} and @samp{jbXX} pseudo opcodes. @cindex @samp{--print-insn-syntax} +@item --print-insn-syntax You can use the @samp{--print-insn-syntax} option to obtain the syntax description of the instruction when an error is detected. @cindex @samp{--print-opcodes} +@item --print-opcodes The @samp{--print-opcodes} option prints the list of all the instructions with their syntax. The first item of each line represents the instruction name and the rest of the line indicates @@ -84,8 +121,10 @@ in alphabetical order. Once the list is printed @code{@value{AS}} exits. @cindex @samp{--generate-example} +@item --generate-example The @samp{--generate-example} option is similar to @samp{--print-opcodes} but it generates an example for each instruction instead. +@end table @node M68HC11-Syntax @section Syntax @@ -109,7 +148,7 @@ brclr *bot #8 foo @cindex M68HC11 addressing modes @cindex addressing modes, M68HC11 -The following addressing modes are understood: +The following addressing modes are understood for 68HC11 and 68HC12: @table @dfn @item Immediate @samp{#@var{number}} @@ -126,6 +165,173 @@ The @var{number} may be omitted in which case 0 is assumed. @samp{@var{symbol}}, or @samp{@var{digits}} @end table +The M68HC12 has other more complex addressing modes. All of them +are supported and they are represented below: + +@table @dfn +@item Constant Offset Indexed Addressing Mode +@samp{@var{number},@var{reg}} + +The @var{number} may be omitted in which case 0 is assumed. +The register can be either @samp{X}, @samp{Y}, @samp{SP} or +@samp{PC}. The assembler will use the smaller post-byte definition +according to the constant value (5-bit constant offset, 9-bit constant +offset or 16-bit constant offset). If the constant is not known by +the assembler it will use the 16-bit constant offset post-byte and the value +will be resolved at link time. + +@item Offset Indexed Indirect +@samp{[@var{number},@var{reg}]} + +The register can be either @samp{X}, @samp{Y}, @samp{SP} or @samp{PC}. + +@item Auto Pre-Increment/Pre-Decrement/Post-Increment/Post-Decrement +@samp{@var{number},-@var{reg}} +@samp{@var{number},+@var{reg}} +@samp{@var{number},@var{reg}-} +@samp{@var{number},@var{reg}+} + +The number must be in the range @samp{-8}..@samp{+8} and must not be 0. +The register can be either @samp{X}, @samp{Y}, @samp{SP} or @samp{PC}. + +@item Accumulator Offset +@samp{@var{acc},@var{reg}} + +The accumulator register can be either @samp{A}, @samp{B} or @samp{D}. +The register can be either @samp{X}, @samp{Y}, @samp{SP} or @samp{PC}. + +@item Accumulator D offset indexed-indirect +@samp{[D,@var{reg}]} + +The register can be either @samp{X}, @samp{Y}, @samp{SP} or @samp{PC}. + +@end table + +For example: + +@smallexample +ldab 1024,sp +ldd [10,x] +orab 3,+x +stab -2,y- +ldx a,pc +sty [d,sp] +@end smallexample + + +@node M68HC11-Modifiers +@section Symbolic Operand Modifiers + +@cindex M68HC11 modifiers +@cindex syntax, M68HC11 + +The assembler supports several modifiers when using symbol addresses +in 68HC11 and 68HC12 instruction operands. The general syntax is +the following: + +@smallexample +%modifier(symbol) +@end smallexample + +@table @code +@cindex symbol modifiers +@item %addr +This modifier indicates to the assembler and linker to use +the 16-bit physical address corresponding to the symbol. This is intended +to be used on memory window systems to map a symbol in the memory bank window. +If the symbol is in a memory expansion part, the physical address +corresponds to the symbol address within the memory bank window. +If the symbol is not in a memory expansion part, this is the symbol address +(using or not using the %addr modifier has no effect in that case). + +@item %page +This modifier indicates to use the memory page number corresponding +to the symbol. If the symbol is in a memory expansion part, its page +number is computed by the linker as a number used to map the page containing +the symbol in the memory bank window. If the symbol is not in a memory +expansion part, the page number is 0. + +@item %hi +This modifier indicates to use the 8-bit high part of the physical +address of the symbol. + +@item %lo +This modifier indicates to use the 8-bit low part of the physical +address of the symbol. + +@end table + +For example a 68HC12 call to a function @samp{foo_example} stored in memory +expansion part could be written as follows: + +@smallexample +call %addr(foo_example),%page(foo_example) +@end smallexample + +and this is equivalent to + +@smallexample +call foo_example +@end smallexample + +And for 68HC11 it could be written as follows: + +@smallexample +ldab #%page(foo_example) +stab _page_switch +jsr %addr(foo_example) +@end smallexample + +@node M68HC11-Directives +@section Assembler Directives + +@cindex assembler directives, M68HC11 +@cindex assembler directives, M68HC12 +@cindex M68HC11 assembler directives +@cindex M68HC12 assembler directives + +The 68HC11 and 68HC12 version of @code{@value{AS}} have the following +specific assembler directives: + +@table @code +@item .relax +@cindex assembler directive .relax, M68HC11 +@cindex M68HC11 assembler directive .relax +The relax directive is used by the @samp{GNU Compiler} to emit a specific +relocation to mark a group of instructions for linker relaxation. +The sequence of instructions within the group must be known to the linker +so that relaxation can be performed. + +@item .mode [mshort|mlong|mshort-double|mlong-double] +@cindex assembler directive .mode, M68HC11 +@cindex M68HC11 assembler directive .mode +This directive specifies the ABI. It overrides the @samp{-mshort}, +@samp{-mlong}, @samp{-mshort-double} and @samp{-mlong-double} options. + +@item .far @var{symbol} +@cindex assembler directive .far, M68HC11 +@cindex M68HC11 assembler directive .far +This directive marks the symbol as a @samp{far} symbol meaning that it +uses a @samp{call/rtc} calling convention as opposed to @samp{jsr/rts}. +During a final link, the linker will identify references to the @samp{far} +symbol and will verify the proper calling convention. + +@item .interrupt @var{symbol} +@cindex assembler directive .interrupt, M68HC11 +@cindex M68HC11 assembler directive .interrupt +This directive marks the symbol as an interrupt entry point. +This information is then used by the debugger to correctly unwind the +frame across interrupts. + +@item .xrefb @var{symbol} +@cindex assembler directive .xrefb, M68HC11 +@cindex M68HC11 assembler directive .xrefb +This directive is defined for compatibility with the +@samp{Specification for Motorola 8 and 16-Bit Assembly Language Input +Standard} and is ignored. + +@end table + @node M68HC11-Float @section Floating Point @@ -181,21 +387,21 @@ by the @samp{--short-branchs} or @samp{--force-long-branchs} options. The following table summarizes the pseudo-operations. @smallexample - Displacement Width - +-------------------------------------------------------------+ - | Options | - | --short-branchs --force-long-branchs | - +--------------------------+----------------------------------+ -Pseudo-Op |BYTE WORD | BYTE WORD | - +--------------------------+----------------------------------+ - bsr | bsr | jsr | - bra | bra | jmp | - jbsr | bsr jsr | bsr jsr | - jbra | bra jmp | bra jmp | - bXX | bXX | bNX +3; jmp | - jbXX | bXX bNX +3; | bXX bNX +3; jmp | - | jmp | | - +--------------------------+----------------------------------+ + Displacement Width + +-------------------------------------------------------------+ + | Options | + | --short-branchs --force-long-branchs | + +--------------------------+----------------------------------+ + Op |BYTE WORD | BYTE WORD | + +--------------------------+----------------------------------+ + bsr | bsr | jsr | + bra | bra | jmp | +jbsr | bsr jsr | bsr jsr | +jbra | bra jmp | bra jmp | + bXX | bXX | bNX +3; jmp | +jbXX | bXX bNX +3; | bXX bNX +3; jmp | + | jmp | | + +--------------------------+----------------------------------+ XX: condition NX: negative of condition XX