1@c Copyright (C) 1991-2016 Free Software Foundation, Inc.
2@c This is part of the GAS manual.
3@c For copying conditions, see the file as.texinfo.
4@page
5@node SH-Dependent
6@chapter Renesas / SuperH SH Dependent Features
7
8@cindex SH support
9@menu
10* SH Options::              Options
11* SH Syntax::               Syntax
12* SH Floating Point::       Floating Point
13* SH Directives::           SH Machine Directives
14* SH Opcodes::              Opcodes
15@end menu
16
17@node SH Options
18@section Options
19
20@cindex SH options
21@cindex options, SH
22@code{@value{AS}} has following command-line options for the Renesas
23(formerly Hitachi) / SuperH SH family.
24
25@table @code
26@kindex --little
27@kindex --big
28@kindex --relax
29@kindex --small
30@kindex --dsp
31@kindex --renesas
32@kindex --allow-reg-prefix
33
34@item --little
35Generate little endian code.
36
37@item --big
38Generate big endian code.
39
40@item --relax
41Alter jump instructions for long displacements.
42
43@item --small
44Align sections to 4 byte boundaries, not 16.
45
46@item --dsp
47Enable sh-dsp insns, and disable sh3e / sh4 insns.
48
49@item --renesas
50Disable optimization with section symbol for compatibility with
51Renesas assembler.
52
53@item --allow-reg-prefix
54Allow '$' as a register name prefix.
55
56@kindex --fdpic
57@item --fdpic
58Generate an FDPIC object file.
59
60@item --isa=sh4 | sh4a
61Specify the sh4 or sh4a instruction set.
62@item --isa=dsp
63Enable sh-dsp insns, and disable sh3e / sh4 insns.
64@item --isa=fp
65Enable sh2e, sh3e, sh4, and sh4a insn sets.
66@item --isa=all
67Enable sh1, sh2, sh2e, sh3, sh3e, sh4, sh4a, and sh-dsp insn sets.
68
69@item -h-tick-hex
70Support H'00 style hex constants in addition to 0x00 style.
71
72@end table
73
74@node SH Syntax
75@section Syntax
76
77@menu
78* SH-Chars::                Special Characters
79* SH-Regs::                 Register Names
80* SH-Addressing::           Addressing Modes
81@end menu
82
83@node SH-Chars
84@subsection Special Characters
85
86@cindex line comment character, SH
87@cindex SH line comment character
88@samp{!} is the line comment character.
89
90@cindex line separator, SH
91@cindex statement separator, SH
92@cindex SH line separator
93You can use @samp{;} instead of a newline to separate statements.
94
95If a @samp{#} appears as the first character of a line then the whole
96line is treated as a comment, but in this case the line could also be
97a logical line number directive (@pxref{Comments}) or a preprocessor
98control command (@pxref{Preprocessing}).
99
100@cindex symbol names, @samp{$} in
101@cindex @code{$} in symbol names
102Since @samp{$} has no special meaning, you may use it in symbol names.
103
104@node SH-Regs
105@subsection Register Names
106
107@cindex SH registers
108@cindex registers, SH
109You can use the predefined symbols @samp{r0}, @samp{r1}, @samp{r2},
110@samp{r3}, @samp{r4}, @samp{r5}, @samp{r6}, @samp{r7}, @samp{r8},
111@samp{r9}, @samp{r10}, @samp{r11}, @samp{r12}, @samp{r13}, @samp{r14},
112and @samp{r15} to refer to the SH registers.
113
114The SH also has these control registers:
115
116@table @code
117@item pr
118procedure register (holds return address)
119
120@item pc
121program counter
122
123@item mach
124@itemx macl
125high and low multiply accumulator registers
126
127@item sr
128status register
129
130@item gbr
131global base register
132
133@item vbr
134vector base register (for interrupt vectors)
135@end table
136
137@node SH-Addressing
138@subsection Addressing Modes
139
140@cindex addressing modes, SH
141@cindex SH addressing modes
142@code{@value{AS}} understands the following addressing modes for the SH.
143@code{R@var{n}} in the following refers to any of the numbered
144registers, but @emph{not} the control registers.
145
146@table @code
147@item R@var{n}
148Register direct
149
150@item @@R@var{n}
151Register indirect
152
153@item @@-R@var{n}
154Register indirect with pre-decrement
155
156@item @@R@var{n}+
157Register indirect with post-increment
158
159@item @@(@var{disp}, R@var{n})
160Register indirect with displacement
161
162@item @@(R0, R@var{n})
163Register indexed
164
165@item @@(@var{disp}, GBR)
166@code{GBR} offset
167
168@item @@(R0, GBR)
169GBR indexed
170
171@item @var{addr}
172@itemx @@(@var{disp}, PC)
173PC relative address (for branch or for addressing memory).  The
174@code{@value{AS}} implementation allows you to use the simpler form
175@var{addr} anywhere a PC relative address is called for; the alternate
176form is supported for compatibility with other assemblers.
177
178@item #@var{imm}
179Immediate data
180@end table
181
182@node SH Floating Point
183@section Floating Point
184
185@cindex floating point, SH (@sc{ieee})
186@cindex SH floating point (@sc{ieee})
187SH2E, SH3E and SH4 groups have on-chip floating-point unit (FPU). Other
188SH groups can use @code{.float} directive to generate @sc{ieee}
189floating-point numbers.
190
191SH2E and SH3E support single-precision floating point calculations as
192well as entirely PCAPI compatible emulation of double-precision
193floating point calculations. SH2E and SH3E instructions are a subset of
194the floating point calculations conforming to the IEEE754 standard.
195
196In addition to single-precision and double-precision floating-point
197operation capability, the on-chip FPU of SH4 has a 128-bit graphic
198engine that enables 32-bit floating-point data to be processed 128
199bits at a time. It also supports 4 * 4 array operations and inner
200product operations. Also, a superscalar architecture is employed that
201enables simultaneous execution of two instructions (including FPU
202instructions), providing performance of up to twice that of
203conventional architectures at the same frequency.
204
205@node SH Directives
206@section SH Machine Directives
207
208@cindex SH machine directives
209@cindex machine directives, SH
210@cindex @code{uaword} directive, SH
211@cindex @code{ualong} directive, SH
212@cindex @code{uaquad} directive, SH
213
214@table @code
215@item uaword
216@itemx ualong
217@itemx uaquad
218@code{@value{AS}} will issue a warning when a misaligned @code{.word},
219@code{.long}, or @code{.quad} directive is used.  You may use
220@code{.uaword}, @code{.ualong}, or @code{.uaquad} to indicate that the
221value is intentionally misaligned.
222@end table
223
224@node SH Opcodes
225@section Opcodes
226
227@cindex SH opcode summary
228@cindex opcode summary, SH
229@cindex mnemonics, SH
230@cindex instruction summary, SH
231For detailed information on the SH machine instruction set, see
232@cite{SH-Microcomputer User's Manual} (Renesas) or
233@cite{SH-4 32-bit CPU Core Architecture} (SuperH) and
234@cite{SuperH (SH) 64-Bit RISC Series} (SuperH).
235
236@code{@value{AS}} implements all the standard SH opcodes.  No additional
237pseudo-instructions are needed on this family.  Note, however, that
238because @code{@value{AS}} supports a simpler form of PC-relative
239addressing, you may simply write (for example)
240
241@example
242mov.l  bar,r0
243@end example
244
245@noindent
246where other assemblers might require an explicit displacement to
247@code{bar} from the program counter:
248
249@example
250mov.l  @@(@var{disp}, PC)
251@end example
252
253@ifset SMALL
254@c this table, due to the multi-col faking and hardcoded order, looks silly
255@c except in smallbook.  See comments below "@set SMALL" near top of this file.
256
257Here is a summary of SH opcodes:
258
259@page
260@smallexample
261@i{Legend:}
262Rn        @r{a numbered register}
263Rm        @r{another numbered register}
264#imm      @r{immediate data}
265disp      @r{displacement}
266disp8     @r{8-bit displacement}
267disp12    @r{12-bit displacement}
268
269add #imm,Rn                    lds.l @@Rn+,PR
270add Rm,Rn                      mac.w @@Rm+,@@Rn+
271addc Rm,Rn                     mov #imm,Rn
272addv Rm,Rn                     mov Rm,Rn
273and #imm,R0                    mov.b Rm,@@(R0,Rn)
274and Rm,Rn                      mov.b Rm,@@-Rn
275and.b #imm,@@(R0,GBR)           mov.b Rm,@@Rn
276bf disp8                       mov.b @@(disp,Rm),R0
277bra disp12                     mov.b @@(disp,GBR),R0
278bsr disp12                     mov.b @@(R0,Rm),Rn
279bt disp8                       mov.b @@Rm+,Rn
280clrmac                         mov.b @@Rm,Rn
281clrt                           mov.b R0,@@(disp,Rm)
282cmp/eq #imm,R0                 mov.b R0,@@(disp,GBR)
283cmp/eq Rm,Rn                   mov.l Rm,@@(disp,Rn)
284cmp/ge Rm,Rn                   mov.l Rm,@@(R0,Rn)
285cmp/gt Rm,Rn                   mov.l Rm,@@-Rn
286cmp/hi Rm,Rn                   mov.l Rm,@@Rn
287cmp/hs Rm,Rn                   mov.l @@(disp,Rn),Rm
288cmp/pl Rn                      mov.l @@(disp,GBR),R0
289cmp/pz Rn                      mov.l @@(disp,PC),Rn
290cmp/str Rm,Rn                  mov.l @@(R0,Rm),Rn
291div0s Rm,Rn                    mov.l @@Rm+,Rn
292div0u                          mov.l @@Rm,Rn
293div1 Rm,Rn                     mov.l R0,@@(disp,GBR)
294exts.b Rm,Rn                   mov.w Rm,@@(R0,Rn)
295exts.w Rm,Rn                   mov.w Rm,@@-Rn
296extu.b Rm,Rn                   mov.w Rm,@@Rn
297extu.w Rm,Rn                   mov.w @@(disp,Rm),R0
298jmp @@Rn                        mov.w @@(disp,GBR),R0
299jsr @@Rn                        mov.w @@(disp,PC),Rn
300ldc Rn,GBR                     mov.w @@(R0,Rm),Rn
301ldc Rn,SR                      mov.w @@Rm+,Rn
302ldc Rn,VBR                     mov.w @@Rm,Rn
303ldc.l @@Rn+,GBR                 mov.w R0,@@(disp,Rm)
304ldc.l @@Rn+,SR                  mov.w R0,@@(disp,GBR)
305ldc.l @@Rn+,VBR                 mova @@(disp,PC),R0
306lds Rn,MACH                    movt Rn
307lds Rn,MACL                    muls Rm,Rn
308lds Rn,PR                      mulu Rm,Rn
309lds.l @@Rn+,MACH                neg Rm,Rn
310lds.l @@Rn+,MACL                negc Rm,Rn
311@page
312nop                            stc VBR,Rn
313not Rm,Rn                      stc.l GBR,@@-Rn
314or #imm,R0                     stc.l SR,@@-Rn
315or Rm,Rn                       stc.l VBR,@@-Rn
316or.b #imm,@@(R0,GBR)            sts MACH,Rn
317rotcl Rn                       sts MACL,Rn
318rotcr Rn                       sts PR,Rn
319rotl Rn                        sts.l MACH,@@-Rn
320rotr Rn                        sts.l MACL,@@-Rn
321rte                            sts.l PR,@@-Rn
322rts                            sub Rm,Rn
323sett                           subc Rm,Rn
324shal Rn                        subv Rm,Rn
325shar Rn                        swap.b Rm,Rn
326shll Rn                        swap.w Rm,Rn
327shll16 Rn                      tas.b @@Rn
328shll2 Rn                       trapa #imm
329shll8 Rn                       tst #imm,R0
330shlr Rn                        tst Rm,Rn
331shlr16 Rn                      tst.b #imm,@@(R0,GBR)
332shlr2 Rn                       xor #imm,R0
333shlr8 Rn                       xor Rm,Rn
334sleep                          xor.b #imm,@@(R0,GBR)
335stc GBR,Rn                     xtrct Rm,Rn
336stc SR,Rn
337@end smallexample
338@end ifset
339
340@ifset Renesas-all
341@ifclear GENERIC
342@raisesections
343@end ifclear
344@end ifset
345
346