gas/doc/c-sh.texi

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