mirror of
https://github.com/darlinghq/darling-gdb.git
synced 2024-11-30 23:40:24 +00:00
149 lines
3.9 KiB
Plaintext
149 lines
3.9 KiB
Plaintext
@c Copyright (C) 2005-2014 Free Software Foundation, Inc.
|
|
@c This is part of the GAS manual.
|
|
@c For copying conditions, see the file as.texinfo.
|
|
@ifset GENERIC
|
|
@page
|
|
@node M32C-Dependent
|
|
@chapter M32C Dependent Features
|
|
@end ifset
|
|
@ifclear GENERIC
|
|
@node Machine Dependencies
|
|
@chapter M32C Dependent Features
|
|
@end ifclear
|
|
|
|
@cindex M32C support
|
|
|
|
@code{@value{AS}} can assemble code for several different members of
|
|
the Renesas M32C family. Normally the default is to assemble code for
|
|
the M16C microprocessor. The @code{-m32c} option may be used to
|
|
change the default to the M32C microprocessor.
|
|
|
|
@menu
|
|
* M32C-Opts:: M32C Options
|
|
* M32C-Syntax:: M32C Syntax
|
|
@end menu
|
|
|
|
@node M32C-Opts
|
|
@section M32C Options
|
|
|
|
@cindex options, M32C
|
|
@cindex M32C options
|
|
|
|
The Renesas M32C version of @code{@value{AS}} has these
|
|
machine-dependent options:
|
|
|
|
@table @code
|
|
@item -m32c
|
|
@cindex @samp{-m32c} option, M32C
|
|
@cindex architecture options, M32C
|
|
@cindex M32C architecture option
|
|
Assemble M32C instructions.
|
|
|
|
@item -m16c
|
|
@cindex @samp{-m16c} option, M16C
|
|
@cindex architecture options, M16C
|
|
@cindex M16C architecture option
|
|
Assemble M16C instructions (default).
|
|
|
|
@item -relax
|
|
Enable support for link-time relaxations.
|
|
|
|
@item -h-tick-hex
|
|
Support H'00 style hex constants in addition to 0x00 style.
|
|
|
|
|
|
@end table
|
|
|
|
@node M32C-Syntax
|
|
@section M32C Syntax
|
|
@menu
|
|
* M32C-Modifiers:: Symbolic Operand Modifiers
|
|
* M32C-Chars:: Special Characters
|
|
@end menu
|
|
|
|
@node M32C-Modifiers
|
|
@subsection Symbolic Operand Modifiers
|
|
|
|
@cindex M32C modifiers
|
|
@cindex modifiers, M32C
|
|
|
|
The assembler supports several modifiers when using symbol addresses
|
|
in M32C instruction operands. The general syntax is the following:
|
|
|
|
@smallexample
|
|
%modifier(symbol)
|
|
@end smallexample
|
|
|
|
@table @code
|
|
@cindex symbol modifiers
|
|
|
|
@item %dsp8
|
|
@itemx %dsp16
|
|
|
|
These modifiers override the assembler's assumptions about how big a
|
|
symbol's address is. Normally, when it sees an operand like
|
|
@samp{sym[a0]} it assumes @samp{sym} may require the widest
|
|
displacement field (16 bits for @samp{-m16c}, 24 bits for
|
|
@samp{-m32c}). These modifiers tell it to assume the address will fit
|
|
in an 8 or 16 bit (respectively) unsigned displacement. Note that, of
|
|
course, if it doesn't actually fit you will get linker errors. Example:
|
|
|
|
@smallexample
|
|
mov.w %dsp8(sym)[a0],r1
|
|
mov.b #0,%dsp8(sym)[a0]
|
|
@end smallexample
|
|
|
|
@item %hi8
|
|
|
|
This modifier allows you to load bits 16 through 23 of a 24 bit
|
|
address into an 8 bit register. This is useful with, for example, the
|
|
M16C @samp{smovf} instruction, which expects a 20 bit address in
|
|
@samp{r1h} and @samp{a0}. Example:
|
|
|
|
@smallexample
|
|
mov.b #%hi8(sym),r1h
|
|
mov.w #%lo16(sym),a0
|
|
smovf.b
|
|
@end smallexample
|
|
|
|
@item %lo16
|
|
|
|
Likewise, this modifier allows you to load bits 0 through 15 of a 24
|
|
bit address into a 16 bit register.
|
|
|
|
@item %hi16
|
|
|
|
This modifier allows you to load bits 16 through 31 of a 32 bit
|
|
address into a 16 bit register. While the M32C family only has 24
|
|
bits of address space, it does support addresses in pairs of 16 bit
|
|
registers (like @samp{a1a0} for the @samp{lde} instruction). This
|
|
modifier is for loading the upper half in such cases. Example:
|
|
|
|
@smallexample
|
|
mov.w #%hi16(sym),a1
|
|
mov.w #%lo16(sym),a0
|
|
@dots{}
|
|
lde.w [a1a0],r1
|
|
@end smallexample
|
|
|
|
@end table
|
|
|
|
@node M32C-Chars
|
|
@subsection Special Characters
|
|
|
|
@cindex line comment character, M32C
|
|
@cindex M32C line comment character
|
|
The presence of a @samp{;} character on a line indicates the start of
|
|
a comment that extends to the end of that line.
|
|
|
|
If a @samp{#} appears as the first character of a line, the whole line
|
|
is treated as a comment, but in this case the line can also be a
|
|
logical line number directive (@pxref{Comments}) or a
|
|
preprocessor control command (@pxref{Preprocessing}).
|
|
|
|
@cindex line separator, M32C
|
|
@cindex statement separator, M32C
|
|
@cindex M32C line separator
|
|
The @samp{|} character can be used to separate statements on the same
|
|
line.
|