1@c Copyright (C) 1991, 1992, 1993, 1994, 1995, 2003 Free Software Foundation, Inc. 2@c This is part of the GAS manual. 3@c For copying conditions, see the file as.texinfo. 4@ifset GENERIC 5@page 6@end ifset 7@node H8/300-Dependent 8@chapter H8/300 Dependent Features 9 10@cindex H8/300 support 11@menu 12* H8/300 Options:: Options 13* H8/300 Syntax:: Syntax 14* H8/300 Floating Point:: Floating Point 15* H8/300 Directives:: H8/300 Machine Directives 16* H8/300 Opcodes:: Opcodes 17@end menu 18 19@node H8/300 Options 20@section Options 21 22@cindex H8/300 options (none) 23@cindex options, H8/300 (none) 24@code{@value{AS}} has no additional command-line options for the 25Renesas (formerly Hitachi) H8/300 family. 26 27@node H8/300 Syntax 28@section Syntax 29@menu 30* H8/300-Chars:: Special Characters 31* H8/300-Regs:: Register Names 32* H8/300-Addressing:: Addressing Modes 33@end menu 34 35@node H8/300-Chars 36@subsection Special Characters 37 38@cindex line comment character, H8/300 39@cindex H8/300 line comment character 40@samp{;} is the line comment character. 41 42@cindex line separator, H8/300 43@cindex statement separator, H8/300 44@cindex H8/300 line separator 45@samp{$} can be used instead of a newline to separate statements. 46Therefore @emph{you may not use @samp{$} in symbol names} on the H8/300. 47 48@node H8/300-Regs 49@subsection Register Names 50 51@cindex H8/300 registers 52@cindex register names, H8/300 53You can use predefined symbols of the form @samp{r@var{n}h} and 54@samp{r@var{n}l} to refer to the H8/300 registers as sixteen 8-bit 55general-purpose registers. @var{n} is a digit from @samp{0} to 56@samp{7}); for instance, both @samp{r0h} and @samp{r7l} are valid 57register names. 58 59You can also use the eight predefined symbols @samp{r@var{n}} to refer 60to the H8/300 registers as 16-bit registers (you must use this form for 61addressing). 62 63On the H8/300H, you can also use the eight predefined symbols 64@samp{er@var{n}} (@samp{er0} @dots{} @samp{er7}) to refer to the 32-bit 65general purpose registers. 66 67The two control registers are called @code{pc} (program counter; a 6816-bit register, except on the H8/300H where it is 24 bits) and 69@code{ccr} (condition code register; an 8-bit register). @code{r7} is 70used as the stack pointer, and can also be called @code{sp}. 71 72@node H8/300-Addressing 73@subsection Addressing Modes 74 75@cindex addressing modes, H8/300 76@cindex H8/300 addressing modes 77@value{AS} understands the following addressing modes for the H8/300: 78@table @code 79@item r@var{n} 80Register direct 81 82@item @@r@var{n} 83Register indirect 84 85@need 1200 86@item @@(@var{d}, r@var{n}) 87@itemx @@(@var{d}:16, r@var{n}) 88@itemx @@(@var{d}:24, r@var{n}) 89Register indirect: 16-bit or 24-bit displacement @var{d} from register 90@var{n}. (24-bit displacements are only meaningful on the H8/300H.) 91 92@item @@r@var{n}+ 93Register indirect with post-increment 94 95@item @@-r@var{n} 96Register indirect with pre-decrement 97 98@item @code{@@}@var{aa} 99@itemx @code{@@}@var{aa}:8 100@itemx @code{@@}@var{aa}:16 101@itemx @code{@@}@var{aa}:24 102Absolute address @code{aa}. (The address size @samp{:24} only makes 103sense on the H8/300H.) 104 105@item #@var{xx} 106@itemx #@var{xx}:8 107@itemx #@var{xx}:16 108@itemx #@var{xx}:32 109Immediate data @var{xx}. You may specify the @samp{:8}, @samp{:16}, or 110@samp{:32} for clarity, if you wish; but @code{@value{AS}} neither 111requires this nor uses it---the data size required is taken from 112context. 113 114@item @code{@@}@code{@@}@var{aa} 115@itemx @code{@@}@code{@@}@var{aa}:8 116Memory indirect. You may specify the @samp{:8} for clarity, if you 117wish; but @code{@value{AS}} neither requires this nor uses it. 118@end table 119 120@node H8/300 Floating Point 121@section Floating Point 122 123@cindex floating point, H8/300 (@sc{ieee}) 124@cindex H8/300 floating point (@sc{ieee}) 125The H8/300 family has no hardware floating point, but the @code{.float} 126directive generates @sc{ieee} floating-point numbers for compatibility 127with other development tools. 128 129@page 130@node H8/300 Directives 131@section H8/300 Machine Directives 132 133@cindex H8/300 machine directives (none) 134@cindex machine directives, H8/300 (none) 135@cindex @code{word} directive, H8/300 136@cindex @code{int} directive, H8/300 137@code{@value{AS}} has the following machine-dependent directives for 138the H8/300: 139 140@table @code 141@cindex H8/300H, assembling for 142@item .h8300h 143Recognize and emit additional instructions for the H8/300H variant, and 144also make @code{.int} emit 32-bit numbers rather than the usual (16-bit) 145for the H8/300 family. 146 147@item .h8300s 148Recognize and emit additional instructions for the H8S variant, and 149also make @code{.int} emit 32-bit numbers rather than the usual (16-bit) 150for the H8/300 family. 151 152@item .h8300hn 153Recognize and emit additional instructions for the H8/300H variant in 154normal mode, and also make @code{.int} emit 32-bit numbers rather than 155the usual (16-bit) for the H8/300 family. 156 157@item .h8300sn 158Recognize and emit additional instructions for the H8S variant in 159normal mode, and also make @code{.int} emit 32-bit numbers rather than 160the usual (16-bit) for the H8/300 family. 161@end table 162 163On the H8/300 family (including the H8/300H) @samp{.word} directives 164generate 16-bit numbers. 165 166@node H8/300 Opcodes 167@section Opcodes 168 169@cindex H8/300 opcode summary 170@cindex opcode summary, H8/300 171@cindex mnemonics, H8/300 172@cindex instruction summary, H8/300 173For detailed information on the H8/300 machine instruction set, see 174@cite{H8/300 Series Programming Manual}. For information specific to 175the H8/300H, see @cite{H8/300H Series Programming Manual} (Renesas). 176 177@code{@value{AS}} implements all the standard H8/300 opcodes. No additional 178pseudo-instructions are needed on this family. 179 180@ifset SMALL 181@c this table, due to the multi-col faking and hardcoded order, looks silly 182@c except in smallbook. See comments below "@set SMALL" near top of this file. 183 184The following table summarizes the H8/300 opcodes, and their arguments. 185Entries marked @samp{*} are opcodes used only on the H8/300H. 186 187@smallexample 188@c Using @group seems to use the normal baselineskip, not the smallexample 189@c baselineskip; looks approx doublespaced. 190 @i{Legend:} 191 Rs @r{source register} 192 Rd @r{destination register} 193 abs @r{absolute address} 194 imm @r{immediate data} 195 disp:N @r{N-bit displacement from a register} 196 pcrel:N @r{N-bit displacement relative to program counter} 197 198 add.b #imm,rd * andc #imm,ccr 199 add.b rs,rd band #imm,rd 200 add.w rs,rd band #imm,@@rd 201* add.w #imm,rd band #imm,@@abs:8 202* add.l rs,rd bra pcrel:8 203* add.l #imm,rd * bra pcrel:16 204 adds #imm,rd bt pcrel:8 205 addx #imm,rd * bt pcrel:16 206 addx rs,rd brn pcrel:8 207 and.b #imm,rd * brn pcrel:16 208 and.b rs,rd bf pcrel:8 209* and.w rs,rd * bf pcrel:16 210* and.w #imm,rd bhi pcrel:8 211* and.l #imm,rd * bhi pcrel:16 212* and.l rs,rd bls pcrel:8 213@page 214* bls pcrel:16 bld #imm,rd 215 bcc pcrel:8 bld #imm,@@rd 216* bcc pcrel:16 bld #imm,@@abs:8 217 bhs pcrel:8 bnot #imm,rd 218* bhs pcrel:16 bnot #imm,@@rd 219 bcs pcrel:8 bnot #imm,@@abs:8 220* bcs pcrel:16 bnot rs,rd 221 blo pcrel:8 bnot rs,@@rd 222* blo pcrel:16 bnot rs,@@abs:8 223 bne pcrel:8 bor #imm,rd 224* bne pcrel:16 bor #imm,@@rd 225 beq pcrel:8 bor #imm,@@abs:8 226* beq pcrel:16 bset #imm,rd 227 bvc pcrel:8 bset #imm,@@rd 228* bvc pcrel:16 bset #imm,@@abs:8 229 bvs pcrel:8 bset rs,rd 230* bvs pcrel:16 bset rs,@@rd 231 bpl pcrel:8 bset rs,@@abs:8 232* bpl pcrel:16 bsr pcrel:8 233 bmi pcrel:8 bsr pcrel:16 234* bmi pcrel:16 bst #imm,rd 235 bge pcrel:8 bst #imm,@@rd 236* bge pcrel:16 bst #imm,@@abs:8 237 blt pcrel:8 btst #imm,rd 238* blt pcrel:16 btst #imm,@@rd 239 bgt pcrel:8 btst #imm,@@abs:8 240* bgt pcrel:16 btst rs,rd 241 ble pcrel:8 btst rs,@@rd 242* ble pcrel:16 btst rs,@@abs:8 243 bclr #imm,rd bxor #imm,rd 244 bclr #imm,@@rd bxor #imm,@@rd 245 bclr #imm,@@abs:8 bxor #imm,@@abs:8 246 bclr rs,rd cmp.b #imm,rd 247 bclr rs,@@rd cmp.b rs,rd 248 bclr rs,@@abs:8 cmp.w rs,rd 249 biand #imm,rd cmp.w rs,rd 250 biand #imm,@@rd * cmp.w #imm,rd 251 biand #imm,@@abs:8 * cmp.l #imm,rd 252 bild #imm,rd * cmp.l rs,rd 253 bild #imm,@@rd daa rs 254 bild #imm,@@abs:8 das rs 255 bior #imm,rd dec.b rs 256 bior #imm,@@rd * dec.w #imm,rd 257 bior #imm,@@abs:8 * dec.l #imm,rd 258 bist #imm,rd divxu.b rs,rd 259 bist #imm,@@rd * divxu.w rs,rd 260 bist #imm,@@abs:8 * divxs.b rs,rd 261 bixor #imm,rd * divxs.w rs,rd 262 bixor #imm,@@rd eepmov 263 bixor #imm,@@abs:8 * eepmovw 264@page 265* exts.w rd mov.w rs,@@abs:16 266* exts.l rd * mov.l #imm,rd 267* extu.w rd * mov.l rs,rd 268* extu.l rd * mov.l @@rs,rd 269 inc rs * mov.l @@(disp:16,rs),rd 270* inc.w #imm,rd * mov.l @@(disp:24,rs),rd 271* inc.l #imm,rd * mov.l @@rs+,rd 272 jmp @@rs * mov.l @@abs:16,rd 273 jmp abs * mov.l @@abs:24,rd 274 jmp @@@@abs:8 * mov.l rs,@@rd 275 jsr @@rs * mov.l rs,@@(disp:16,rd) 276 jsr abs * mov.l rs,@@(disp:24,rd) 277 jsr @@@@abs:8 * mov.l rs,@@-rd 278 ldc #imm,ccr * mov.l rs,@@abs:16 279 ldc rs,ccr * mov.l rs,@@abs:24 280* ldc @@abs:16,ccr movfpe @@abs:16,rd 281* ldc @@abs:24,ccr movtpe rs,@@abs:16 282* ldc @@(disp:16,rs),ccr mulxu.b rs,rd 283* ldc @@(disp:24,rs),ccr * mulxu.w rs,rd 284* ldc @@rs+,ccr * mulxs.b rs,rd 285* ldc @@rs,ccr * mulxs.w rs,rd 286* mov.b @@(disp:24,rs),rd neg.b rs 287* mov.b rs,@@(disp:24,rd) * neg.w rs 288 mov.b @@abs:16,rd * neg.l rs 289 mov.b rs,rd nop 290 mov.b @@abs:8,rd not.b rs 291 mov.b rs,@@abs:8 * not.w rs 292 mov.b rs,rd * not.l rs 293 mov.b #imm,rd or.b #imm,rd 294 mov.b @@rs,rd or.b rs,rd 295 mov.b @@(disp:16,rs),rd * or.w #imm,rd 296 mov.b @@rs+,rd * or.w rs,rd 297 mov.b @@abs:8,rd * or.l #imm,rd 298 mov.b rs,@@rd * or.l rs,rd 299 mov.b rs,@@(disp:16,rd) orc #imm,ccr 300 mov.b rs,@@-rd pop.w rs 301 mov.b rs,@@abs:8 * pop.l rs 302 mov.w rs,@@rd push.w rs 303* mov.w @@(disp:24,rs),rd * push.l rs 304* mov.w rs,@@(disp:24,rd) rotl.b rs 305* mov.w @@abs:24,rd * rotl.w rs 306* mov.w rs,@@abs:24 * rotl.l rs 307 mov.w rs,rd rotr.b rs 308 mov.w #imm,rd * rotr.w rs 309 mov.w @@rs,rd * rotr.l rs 310 mov.w @@(disp:16,rs),rd rotxl.b rs 311 mov.w @@rs+,rd * rotxl.w rs 312 mov.w @@abs:16,rd * rotxl.l rs 313 mov.w rs,@@(disp:16,rd) rotxr.b rs 314 mov.w rs,@@-rd * rotxr.w rs 315@page 316* rotxr.l rs * stc ccr,@@(disp:24,rd) 317 bpt * stc ccr,@@-rd 318 rte * stc ccr,@@abs:16 319 rts * stc ccr,@@abs:24 320 shal.b rs sub.b rs,rd 321* shal.w rs sub.w rs,rd 322* shal.l rs * sub.w #imm,rd 323 shar.b rs * sub.l rs,rd 324* shar.w rs * sub.l #imm,rd 325* shar.l rs subs #imm,rd 326 shll.b rs subx #imm,rd 327* shll.w rs subx rs,rd 328* shll.l rs * trapa #imm 329 shlr.b rs xor #imm,rd 330* shlr.w rs xor rs,rd 331* shlr.l rs * xor.w #imm,rd 332 sleep * xor.w rs,rd 333 stc ccr,rd * xor.l #imm,rd 334* stc ccr,@@rs * xor.l rs,rd 335* stc ccr,@@(disp:16,rd) xorc #imm,ccr 336@end smallexample 337@end ifset 338 339@cindex size suffixes, H8/300 340@cindex H8/300 size suffixes 341Four H8/300 instructions (@code{add}, @code{cmp}, @code{mov}, 342@code{sub}) are defined with variants using the suffixes @samp{.b}, 343@samp{.w}, and @samp{.l} to specify the size of a memory operand. 344@code{@value{AS}} supports these suffixes, but does not require them; 345since one of the operands is always a register, @code{@value{AS}} can 346deduce the correct size. 347 348For example, since @code{r0} refers to a 16-bit register, 349@example 350mov r0,@@foo 351@exdent is equivalent to 352mov.w r0,@@foo 353@end example 354 355If you use the size suffixes, @code{@value{AS}} issues a warning when 356the suffix and the register size do not match. 357