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