← Back to branch summary

~ubuntu-branches/ubuntu/utopic/binutils-arm64-cross/utopic

« back to all changes in this revision

Viewing changes to binutils-2.23.52.20130611/gas/doc/c-m32c.texi

  • Committer: Package Import Robot
  • Author(s): Matthias Klose
  • Date: 2013-06-20 17:38:09 UTC
  • Revision ID: package-import@ubuntu.com-20130620173809-app8lzgvymy5fg6c
Tags: 0.7
Build-depend on binutils-source (>= 2.23.52.20130620-1~).

Show diffs side-by-side

added added

removed removed

Lines of Context:
binutils-2.23.52.20130611/gas/doc/c-m32c.texi
 
1
@c Copyright 2005, 2008
 
2
@c Free Software Foundation, Inc.
 
3
@c This is part of the GAS manual.
 
4
@c For copying conditions, see the file as.texinfo.
 
5
@ifset GENERIC
 
6
@page
 
7
@node M32C-Dependent
 
8
@chapter M32C Dependent Features
 
9
@end ifset
 
10
@ifclear GENERIC
 
11
@node Machine Dependencies
 
12
@chapter M32C Dependent Features
 
13
@end ifclear
 
14
 
 
15
@cindex M32C support
 
16
 
 
17
@code{@value{AS}} can assemble code for several different members of
 
18
the Renesas M32C family.  Normally the default is to assemble code for
 
19
the M16C microprocessor.  The @code{-m32c} option may be used to
 
20
change the default to the M32C microprocessor.
 
21
 
 
22
@menu
 
23
* M32C-Opts::                   M32C Options
 
24
* M32C-Syntax::                 M32C Syntax
 
25
@end menu
 
26
 
 
27
@node M32C-Opts
 
28
@section M32C Options
 
29
 
 
30
@cindex options, M32C
 
31
@cindex M32C options
 
32
 
 
33
The Renesas M32C version of @code{@value{AS}} has these
 
34
machine-dependent options:
 
35
 
 
36
@table @code
 
37
@item -m32c
 
38
@cindex @samp{-m32c} option, M32C
 
39
@cindex architecture options, M32C
 
40
@cindex M32C architecture option
 
41
Assemble M32C instructions.
 
42
 
 
43
@item -m16c
 
44
@cindex @samp{-m16c} option, M16C
 
45
@cindex architecture options, M16C
 
46
@cindex M16C architecture option
 
47
Assemble M16C instructions (default).
 
48
 
 
49
@item -relax
 
50
Enable support for link-time relaxations.
 
51
 
 
52
@item -h-tick-hex
 
53
Support H'00 style hex constants in addition to 0x00 style.
 
54
 
 
55
 
 
56
@end table
 
57
 
 
58
@node M32C-Syntax
 
59
@section M32C Syntax
 
60
@menu
 
61
* M32C-Modifiers::              Symbolic Operand Modifiers
 
62
* M32C-Chars::                  Special Characters
 
63
@end menu
 
64
 
 
65
@node M32C-Modifiers
 
66
@subsection Symbolic Operand Modifiers
 
67
 
 
68
@cindex M32C modifiers
 
69
@cindex modifiers, M32C
 
70
 
 
71
The assembler supports several modifiers when using symbol addresses
 
72
in M32C instruction operands.  The general syntax is the following:
 
73
 
 
74
@smallexample
 
75
%modifier(symbol)
 
76
@end smallexample
 
77
 
 
78
@table @code
 
79
@cindex symbol modifiers
 
80
 
 
81
@item %dsp8
 
82
@itemx %dsp16
 
83
 
 
84
These modifiers override the assembler's assumptions about how big a
 
85
symbol's address is.  Normally, when it sees an operand like
 
86
@samp{sym[a0]} it assumes @samp{sym} may require the widest
 
87
displacement field (16 bits for @samp{-m16c}, 24 bits for
 
88
@samp{-m32c}).  These modifiers tell it to assume the address will fit
 
89
in an 8 or 16 bit (respectively) unsigned displacement.  Note that, of
 
90
course, if it doesn't actually fit you will get linker errors.  Example:
 
91
 
 
92
@smallexample
 
93
mov.w %dsp8(sym)[a0],r1
 
94
mov.b #0,%dsp8(sym)[a0]
 
95
@end smallexample
 
96
 
 
97
@item %hi8
 
98
 
 
99
This modifier allows you to load bits 16 through 23 of a 24 bit
 
100
address into an 8 bit register.  This is useful with, for example, the
 
101
M16C @samp{smovf} instruction, which expects a 20 bit address in
 
102
@samp{r1h} and @samp{a0}.  Example:
 
103
 
 
104
@smallexample
 
105
mov.b #%hi8(sym),r1h
 
106
mov.w #%lo16(sym),a0
 
107
smovf.b
 
108
@end smallexample
 
109
 
 
110
@item %lo16
 
111
 
 
112
Likewise, this modifier allows you to load bits 0 through 15 of a 24
 
113
bit address into a 16 bit register.
 
114
 
 
115
@item %hi16
 
116
 
 
117
This modifier allows you to load bits 16 through 31 of a 32 bit
 
118
address into a 16 bit register.  While the M32C family only has 24
 
119
bits of address space, it does support addresses in pairs of 16 bit
 
120
registers (like @samp{a1a0} for the @samp{lde} instruction).  This
 
121
modifier is for loading the upper half in such cases.  Example:
 
122
 
 
123
@smallexample
 
124
mov.w #%hi16(sym),a1
 
125
mov.w #%lo16(sym),a0
 
126
@dots{}
 
127
lde.w [a1a0],r1
 
128
@end smallexample
 
129
 
 
130
@end table
 
131
 
 
132
@node M32C-Chars
 
133
@subsection Special Characters
 
134
 
 
135
@cindex line comment character, M32C
 
136
@cindex M32C line comment character
 
137
The presence of a @samp{;} character on a line indicates the start of
 
138
a comment that extends to the end of that line.
 
139
 
 
140
If a @samp{#} appears as the first character of a line, the whole line
 
141
is treated as a comment, but in this case the line can also be a
 
142
logical line number directive (@pxref{Comments}) or a
 
143
preprocessor control command (@pxref{Preprocessing}).
 
144
 
 
145
@cindex line separator, M32C
 
146
@cindex statement separator, M32C
 
147
@cindex M32C line separator
 
148
The @samp{|} character can be used to separate statements on the same
 
149
line.