| 1 | @c Copyright (C) 2002-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 SH64-Dependent |
| 6 | @chapter SuperH SH64 Dependent Features |
| 7 | |
| 8 | @cindex SH64 support |
| 9 | @menu |
| 10 | * SH64 Options:: Options |
| 11 | * SH64 Syntax:: Syntax |
| 12 | * SH64 Directives:: SH64 Machine Directives |
| 13 | * SH64 Opcodes:: Opcodes |
| 14 | @end menu |
| 15 | |
| 16 | @node SH64 Options |
| 17 | @section Options |
| 18 | |
| 19 | @cindex SH64 options |
| 20 | @cindex options, SH64 |
| 21 | @table @code |
| 22 | |
| 23 | @cindex SH64 ISA options |
| 24 | @cindex ISA options, SH64 |
| 25 | @item -isa=sh4 | sh4a |
| 26 | Specify the sh4 or sh4a instruction set. |
| 27 | @item -isa=dsp |
| 28 | Enable sh-dsp insns, and disable sh3e / sh4 insns. |
| 29 | @item -isa=fp |
| 30 | Enable sh2e, sh3e, sh4, and sh4a insn sets. |
| 31 | @item -isa=all |
| 32 | Enable sh1, sh2, sh2e, sh3, sh3e, sh4, sh4a, and sh-dsp insn sets. |
| 33 | @item -isa=shmedia | -isa=shcompact |
| 34 | Specify the default instruction set. @code{SHmedia} specifies the |
| 35 | 32-bit opcodes, and @code{SHcompact} specifies the 16-bit opcodes |
| 36 | compatible with previous SH families. The default depends on the ABI |
| 37 | selected; the default for the 64-bit ABI is SHmedia, and the default for |
| 38 | the 32-bit ABI is SHcompact. If neither the ABI nor the ISA is |
| 39 | specified, the default is 32-bit SHcompact. |
| 40 | |
| 41 | Note that the @code{.mode} pseudo-op is not permitted if the ISA is not |
| 42 | specified on the command line. |
| 43 | |
| 44 | @cindex SH64 ABI options |
| 45 | @cindex ABI options, SH64 |
| 46 | @item -abi=32 | -abi=64 |
| 47 | Specify the default ABI. If the ISA is specified and the ABI is not, |
| 48 | the default ABI depends on the ISA, with SHmedia defaulting to 64-bit |
| 49 | and SHcompact defaulting to 32-bit. |
| 50 | |
| 51 | Note that the @code{.abi} pseudo-op is not permitted if the ABI is not |
| 52 | specified on the command line. When the ABI is specified on the command |
| 53 | line, any @code{.abi} pseudo-ops in the source must match it. |
| 54 | |
| 55 | @item -shcompact-const-crange |
| 56 | Emit code-range descriptors for constants in SHcompact code sections. |
| 57 | |
| 58 | @item -no-mix |
| 59 | Disallow SHmedia code in the same section as constants and SHcompact |
| 60 | code. |
| 61 | |
| 62 | @item -no-expand |
| 63 | Do not expand MOVI, PT, PTA or PTB instructions. |
| 64 | |
| 65 | @item -expand-pt32 |
| 66 | With -abi=64, expand PT, PTA and PTB instructions to 32 bits only. |
| 67 | |
| 68 | @item -h-tick-hex |
| 69 | Support H'00 style hex constants in addition to 0x00 style. |
| 70 | |
| 71 | @end table |
| 72 | |
| 73 | @node SH64 Syntax |
| 74 | @section Syntax |
| 75 | |
| 76 | @menu |
| 77 | * SH64-Chars:: Special Characters |
| 78 | * SH64-Regs:: Register Names |
| 79 | * SH64-Addressing:: Addressing Modes |
| 80 | @end menu |
| 81 | |
| 82 | @node SH64-Chars |
| 83 | @subsection Special Characters |
| 84 | |
| 85 | @cindex line comment character, SH64 |
| 86 | @cindex SH64 line comment character |
| 87 | @samp{!} is the line comment character. |
| 88 | |
| 89 | If a @samp{#} appears as the first character of a line then the whole |
| 90 | line is treated as a comment, but in this case the line could also be |
| 91 | a logical line number directive (@pxref{Comments}) or a preprocessor |
| 92 | control command (@pxref{Preprocessing}). |
| 93 | |
| 94 | @cindex line separator, SH64 |
| 95 | @cindex statement separator, SH64 |
| 96 | @cindex SH64 line separator |
| 97 | You can use @samp{;} instead of a newline to separate statements. |
| 98 | |
| 99 | @cindex symbol names, @samp{$} in |
| 100 | @cindex @code{$} in symbol names |
| 101 | Since @samp{$} has no special meaning, you may use it in symbol names. |
| 102 | |
| 103 | @node SH64-Regs |
| 104 | @subsection Register Names |
| 105 | |
| 106 | @cindex SH64 registers |
| 107 | @cindex registers, SH64 |
| 108 | You can use the predefined symbols @samp{r0} through @samp{r63} to refer |
| 109 | to the SH64 general registers, @samp{cr0} through @code{cr63} for |
| 110 | control registers, @samp{tr0} through @samp{tr7} for target address |
| 111 | registers, @samp{fr0} through @samp{fr63} for single-precision floating |
| 112 | point registers, @samp{dr0} through @samp{dr62} (even numbered registers |
| 113 | only) for double-precision floating point registers, @samp{fv0} through |
| 114 | @samp{fv60} (multiples of four only) for single-precision floating point |
| 115 | vectors, @samp{fp0} through @samp{fp62} (even numbered registers only) |
| 116 | for single-precision floating point pairs, @samp{mtrx0} through |
| 117 | @samp{mtrx48} (multiples of 16 only) for 4x4 matrices of |
| 118 | single-precision floating point registers, @samp{pc} for the program |
| 119 | counter, and @samp{fpscr} for the floating point status and control |
| 120 | register. |
| 121 | |
| 122 | You can also refer to the control registers by the mnemonics @samp{sr}, |
| 123 | @samp{ssr}, @samp{pssr}, @samp{intevt}, @samp{expevt}, @samp{pexpevt}, |
| 124 | @samp{tra}, @samp{spc}, @samp{pspc}, @samp{resvec}, @samp{vbr}, |
| 125 | @samp{tea}, @samp{dcr}, @samp{kcr0}, @samp{kcr1}, @samp{ctc}, and |
| 126 | @samp{usr}. |
| 127 | |
| 128 | @node SH64-Addressing |
| 129 | @subsection Addressing Modes |
| 130 | |
| 131 | @cindex addressing modes, SH64 |
| 132 | @cindex SH64 addressing modes |
| 133 | |
| 134 | SH64 operands consist of either a register or immediate value. The |
| 135 | immediate value can be a constant or label reference (or portion of a |
| 136 | label reference), as in this example: |
| 137 | |
| 138 | @example |
| 139 | movi 4,r2 |
| 140 | pt function, tr4 |
| 141 | movi (function >> 16) & 65535,r0 |
| 142 | shori function & 65535, r0 |
| 143 | ld.l r0,4,r0 |
| 144 | @end example |
| 145 | |
| 146 | @cindex datalabel, SH64 |
| 147 | Instruction label references can reference labels in either SHmedia or |
| 148 | SHcompact. To differentiate between the two, labels in SHmedia sections |
| 149 | will always have the least significant bit set (i.e. they will be odd), |
| 150 | which SHcompact labels will have the least significant bit reset |
| 151 | (i.e. they will be even). If you need to reference the actual address |
| 152 | of a label, you can use the @code{datalabel} modifier, as in this |
| 153 | example: |
| 154 | |
| 155 | @example |
| 156 | .long function |
| 157 | .long datalabel function |
| 158 | @end example |
| 159 | |
| 160 | In that example, the first longword may or may not have the least |
| 161 | significant bit set depending on whether the label is an SHmedia label |
| 162 | or an SHcompact label. The second longword will be the actual address |
| 163 | of the label, regardless of what type of label it is. |
| 164 | |
| 165 | @node SH64 Directives |
| 166 | @section SH64 Machine Directives |
| 167 | |
| 168 | In addition to the SH directives, the SH64 provides the following |
| 169 | directives: |
| 170 | |
| 171 | @cindex SH64 machine directives |
| 172 | @cindex machine directives, SH64 |
| 173 | |
| 174 | @table @code |
| 175 | |
| 176 | @item .mode [shmedia|shcompact] |
| 177 | @itemx .isa [shmedia|shcompact] |
| 178 | Specify the ISA for the following instructions (the two directives are |
| 179 | equivalent). Note that programs such as @code{objdump} rely on symbolic |
| 180 | labels to determine when such mode switches occur (by checking the least |
| 181 | significant bit of the label's address), so such mode/isa changes should |
| 182 | always be followed by a label (in practice, this is true anyway). Note |
| 183 | that you cannot use these directives if you didn't specify an ISA on the |
| 184 | command line. |
| 185 | |
| 186 | @item .abi [32|64] |
| 187 | Specify the ABI for the following instructions. Note that you cannot use |
| 188 | this directive unless you specified an ABI on the command line, and the |
| 189 | ABIs specified must match. |
| 190 | |
| 191 | @end table |
| 192 | |
| 193 | @node SH64 Opcodes |
| 194 | @section Opcodes |
| 195 | |
| 196 | @cindex SH64 opcode summary |
| 197 | @cindex opcode summary, SH64 |
| 198 | @cindex mnemonics, SH64 |
| 199 | @cindex instruction summary, SH64 |
| 200 | For detailed information on the SH64 machine instruction set, see |
| 201 | @cite{SuperH 64 bit RISC Series Architecture Manual} (SuperH, Inc.). |
| 202 | |
| 203 | @code{@value{AS}} implements all the standard SH64 opcodes. In |
| 204 | addition, the following pseudo-opcodes may be expanded into one or more |
| 205 | alternate opcodes: |
| 206 | |
| 207 | @table @code |
| 208 | |
| 209 | @item movi |
| 210 | If the value doesn't fit into a standard @code{movi} opcode, |
| 211 | @code{@value{AS}} will replace the @code{movi} with a sequence of |
| 212 | @code{movi} and @code{shori} opcodes. |
| 213 | |
| 214 | @item pt |
| 215 | This expands to a sequence of @code{movi} and @code{shori} opcode, |
| 216 | followed by a @code{ptrel} opcode, or to a @code{pta} or @code{ptb} |
| 217 | opcode, depending on the label referenced. |
| 218 | |
| 219 | @end table |