mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-21 04:42:53 +08:00
a2c5833233
The result of running etc/update-copyright.py --this-year, fixing all the files whose mode is changed by the script, plus a build with --enable-maintainer-mode --enable-cgen-maint=yes, then checking out */po/*.pot which we don't update frequently. The copy of cgen was with commit d1dd5fcc38ead reverted as that commit breaks building of bfp opcodes files.
375 lines
13 KiB
Plaintext
375 lines
13 KiB
Plaintext
@c Copyright (C) 1991-2022 Free Software Foundation, Inc.
|
|
@c This is part of the GAS manual.
|
|
@c For copying conditions, see the file as.texinfo.
|
|
@ifset GENERIC
|
|
@page
|
|
@end ifset
|
|
@node H8/300-Dependent
|
|
@chapter H8/300 Dependent Features
|
|
|
|
@cindex H8/300 support
|
|
@menu
|
|
* H8/300 Options:: Options
|
|
* H8/300 Syntax:: Syntax
|
|
* H8/300 Floating Point:: Floating Point
|
|
* H8/300 Directives:: H8/300 Machine Directives
|
|
* H8/300 Opcodes:: Opcodes
|
|
@end menu
|
|
|
|
@node H8/300 Options
|
|
@section Options
|
|
|
|
@cindex H8/300 options
|
|
@cindex options, H8/300
|
|
The Renesas H8/300 version of @code{@value{AS}} has one
|
|
machine-dependent option:
|
|
|
|
@c man begin OPTIONS
|
|
@table @gcctabopt
|
|
@item -h-tick-hex
|
|
Support H'00 style hex constants in addition to 0x00 style.
|
|
|
|
@item -mach=@var{name}
|
|
Sets the H8300 machine variant. The following machine names
|
|
are recognised:
|
|
@code{h8300h},
|
|
@code{h8300hn},
|
|
@code{h8300s},
|
|
@code{h8300sn},
|
|
@code{h8300sx} and
|
|
@code{h8300sxn}.
|
|
|
|
@end table
|
|
@c man end
|
|
|
|
@node H8/300 Syntax
|
|
@section Syntax
|
|
@menu
|
|
* H8/300-Chars:: Special Characters
|
|
* H8/300-Regs:: Register Names
|
|
* H8/300-Addressing:: Addressing Modes
|
|
@end menu
|
|
|
|
@node H8/300-Chars
|
|
@subsection Special Characters
|
|
|
|
@cindex line comment character, H8/300
|
|
@cindex H8/300 line comment character
|
|
@samp{;} is the line comment character.
|
|
|
|
@cindex line separator, H8/300
|
|
@cindex statement separator, H8/300
|
|
@cindex H8/300 line separator
|
|
@samp{$} can be used instead of a newline to separate statements.
|
|
Therefore @emph{you may not use @samp{$} in symbol names} on the H8/300.
|
|
|
|
@node H8/300-Regs
|
|
@subsection Register Names
|
|
|
|
@cindex H8/300 registers
|
|
@cindex register names, H8/300
|
|
You can use predefined symbols of the form @samp{r@var{n}h} and
|
|
@samp{r@var{n}l} to refer to the H8/300 registers as sixteen 8-bit
|
|
general-purpose registers. @var{n} is a digit from @samp{0} to
|
|
@samp{7}); for instance, both @samp{r0h} and @samp{r7l} are valid
|
|
register names.
|
|
|
|
You can also use the eight predefined symbols @samp{r@var{n}} to refer
|
|
to the H8/300 registers as 16-bit registers (you must use this form for
|
|
addressing).
|
|
|
|
On the H8/300H, you can also use the eight predefined symbols
|
|
@samp{er@var{n}} (@samp{er0} @dots{} @samp{er7}) to refer to the 32-bit
|
|
general purpose registers.
|
|
|
|
The two control registers are called @code{pc} (program counter; a
|
|
16-bit register, except on the H8/300H where it is 24 bits) and
|
|
@code{ccr} (condition code register; an 8-bit register). @code{r7} is
|
|
used as the stack pointer, and can also be called @code{sp}.
|
|
|
|
@node H8/300-Addressing
|
|
@subsection Addressing Modes
|
|
|
|
@cindex addressing modes, H8/300
|
|
@cindex H8/300 addressing modes
|
|
@value{AS} understands the following addressing modes for the H8/300:
|
|
@table @code
|
|
@item r@var{n}
|
|
Register direct
|
|
|
|
@item @@r@var{n}
|
|
Register indirect
|
|
|
|
@need 1200
|
|
@item @@(@var{d}, r@var{n})
|
|
@itemx @@(@var{d}:16, r@var{n})
|
|
@itemx @@(@var{d}:24, r@var{n})
|
|
Register indirect: 16-bit or 24-bit displacement @var{d} from register
|
|
@var{n}. (24-bit displacements are only meaningful on the H8/300H.)
|
|
|
|
@item @@r@var{n}+
|
|
Register indirect with post-increment
|
|
|
|
@item @@-r@var{n}
|
|
Register indirect with pre-decrement
|
|
|
|
@item @code{@@}@var{aa}
|
|
@itemx @code{@@}@var{aa}:8
|
|
@itemx @code{@@}@var{aa}:16
|
|
@itemx @code{@@}@var{aa}:24
|
|
Absolute address @code{aa}. (The address size @samp{:24} only makes
|
|
sense on the H8/300H.)
|
|
|
|
@item #@var{xx}
|
|
@itemx #@var{xx}:8
|
|
@itemx #@var{xx}:16
|
|
@itemx #@var{xx}:32
|
|
Immediate data @var{xx}. You may specify the @samp{:8}, @samp{:16}, or
|
|
@samp{:32} for clarity, if you wish; but @code{@value{AS}} neither
|
|
requires this nor uses it---the data size required is taken from
|
|
context.
|
|
|
|
@item @code{@@}@code{@@}@var{aa}
|
|
@itemx @code{@@}@code{@@}@var{aa}:8
|
|
Memory indirect. You may specify the @samp{:8} for clarity, if you
|
|
wish; but @code{@value{AS}} neither requires this nor uses it.
|
|
@end table
|
|
|
|
@node H8/300 Floating Point
|
|
@section Floating Point
|
|
|
|
@cindex floating point, H8/300 (@sc{ieee})
|
|
@cindex H8/300 floating point (@sc{ieee})
|
|
The H8/300 family has no hardware floating point, but the @code{.float}
|
|
directive generates @sc{ieee} floating-point numbers for compatibility
|
|
with other development tools.
|
|
|
|
@page
|
|
@node H8/300 Directives
|
|
@section H8/300 Machine Directives
|
|
|
|
@cindex H8/300 machine directives (none)
|
|
@cindex machine directives, H8/300 (none)
|
|
@cindex @code{word} directive, H8/300
|
|
@cindex @code{int} directive, H8/300
|
|
@code{@value{AS}} has the following machine-dependent directives for
|
|
the H8/300:
|
|
|
|
@table @code
|
|
@cindex H8/300H, assembling for
|
|
@item .h8300h
|
|
Recognize and emit additional instructions for the H8/300H variant, and
|
|
also make @code{.int} emit 32-bit numbers rather than the usual (16-bit)
|
|
for the H8/300 family.
|
|
|
|
@item .h8300s
|
|
Recognize and emit additional instructions for the H8S variant, and
|
|
also make @code{.int} emit 32-bit numbers rather than the usual (16-bit)
|
|
for the H8/300 family.
|
|
|
|
@item .h8300hn
|
|
Recognize and emit additional instructions for the H8/300H variant in
|
|
normal mode, and also make @code{.int} emit 32-bit numbers rather than
|
|
the usual (16-bit) for the H8/300 family.
|
|
|
|
@item .h8300sn
|
|
Recognize and emit additional instructions for the H8S variant in
|
|
normal mode, and also make @code{.int} emit 32-bit numbers rather than
|
|
the usual (16-bit) for the H8/300 family.
|
|
@end table
|
|
|
|
On the H8/300 family (including the H8/300H) @samp{.word} directives
|
|
generate 16-bit numbers.
|
|
|
|
@node H8/300 Opcodes
|
|
@section Opcodes
|
|
|
|
@cindex H8/300 opcode summary
|
|
@cindex opcode summary, H8/300
|
|
@cindex mnemonics, H8/300
|
|
@cindex instruction summary, H8/300
|
|
For detailed information on the H8/300 machine instruction set, see
|
|
@cite{H8/300 Series Programming Manual}. For information specific to
|
|
the H8/300H, see @cite{H8/300H Series Programming Manual} (Renesas).
|
|
|
|
@code{@value{AS}} implements all the standard H8/300 opcodes. No additional
|
|
pseudo-instructions are needed on this family.
|
|
|
|
@ifset SMALL
|
|
@c this table, due to the multi-col faking and hardcoded order, looks silly
|
|
@c except in smallbook. See comments below "@set SMALL" near top of this file.
|
|
|
|
The following table summarizes the H8/300 opcodes, and their arguments.
|
|
Entries marked @samp{*} are opcodes used only on the H8/300H.
|
|
|
|
@smallexample
|
|
@c Using @group seems to use the normal baselineskip, not the smallexample
|
|
@c baselineskip; looks approx doublespaced.
|
|
@i{Legend:}
|
|
Rs @r{source register}
|
|
Rd @r{destination register}
|
|
abs @r{absolute address}
|
|
imm @r{immediate data}
|
|
disp:N @r{N-bit displacement from a register}
|
|
pcrel:N @r{N-bit displacement relative to program counter}
|
|
|
|
add.b #imm,rd * andc #imm,ccr
|
|
add.b rs,rd band #imm,rd
|
|
add.w rs,rd band #imm,@@rd
|
|
* add.w #imm,rd band #imm,@@abs:8
|
|
* add.l rs,rd bra pcrel:8
|
|
* add.l #imm,rd * bra pcrel:16
|
|
adds #imm,rd bt pcrel:8
|
|
addx #imm,rd * bt pcrel:16
|
|
addx rs,rd brn pcrel:8
|
|
and.b #imm,rd * brn pcrel:16
|
|
and.b rs,rd bf pcrel:8
|
|
* and.w rs,rd * bf pcrel:16
|
|
* and.w #imm,rd bhi pcrel:8
|
|
* and.l #imm,rd * bhi pcrel:16
|
|
* and.l rs,rd bls pcrel:8
|
|
@page
|
|
* bls pcrel:16 bld #imm,rd
|
|
bcc pcrel:8 bld #imm,@@rd
|
|
* bcc pcrel:16 bld #imm,@@abs:8
|
|
bhs pcrel:8 bnot #imm,rd
|
|
* bhs pcrel:16 bnot #imm,@@rd
|
|
bcs pcrel:8 bnot #imm,@@abs:8
|
|
* bcs pcrel:16 bnot rs,rd
|
|
blo pcrel:8 bnot rs,@@rd
|
|
* blo pcrel:16 bnot rs,@@abs:8
|
|
bne pcrel:8 bor #imm,rd
|
|
* bne pcrel:16 bor #imm,@@rd
|
|
beq pcrel:8 bor #imm,@@abs:8
|
|
* beq pcrel:16 bset #imm,rd
|
|
bvc pcrel:8 bset #imm,@@rd
|
|
* bvc pcrel:16 bset #imm,@@abs:8
|
|
bvs pcrel:8 bset rs,rd
|
|
* bvs pcrel:16 bset rs,@@rd
|
|
bpl pcrel:8 bset rs,@@abs:8
|
|
* bpl pcrel:16 bsr pcrel:8
|
|
bmi pcrel:8 bsr pcrel:16
|
|
* bmi pcrel:16 bst #imm,rd
|
|
bge pcrel:8 bst #imm,@@rd
|
|
* bge pcrel:16 bst #imm,@@abs:8
|
|
blt pcrel:8 btst #imm,rd
|
|
* blt pcrel:16 btst #imm,@@rd
|
|
bgt pcrel:8 btst #imm,@@abs:8
|
|
* bgt pcrel:16 btst rs,rd
|
|
ble pcrel:8 btst rs,@@rd
|
|
* ble pcrel:16 btst rs,@@abs:8
|
|
bclr #imm,rd bxor #imm,rd
|
|
bclr #imm,@@rd bxor #imm,@@rd
|
|
bclr #imm,@@abs:8 bxor #imm,@@abs:8
|
|
bclr rs,rd cmp.b #imm,rd
|
|
bclr rs,@@rd cmp.b rs,rd
|
|
bclr rs,@@abs:8 cmp.w rs,rd
|
|
biand #imm,rd cmp.w rs,rd
|
|
biand #imm,@@rd * cmp.w #imm,rd
|
|
biand #imm,@@abs:8 * cmp.l #imm,rd
|
|
bild #imm,rd * cmp.l rs,rd
|
|
bild #imm,@@rd daa rs
|
|
bild #imm,@@abs:8 das rs
|
|
bior #imm,rd dec.b rs
|
|
bior #imm,@@rd * dec.w #imm,rd
|
|
bior #imm,@@abs:8 * dec.l #imm,rd
|
|
bist #imm,rd divxu.b rs,rd
|
|
bist #imm,@@rd * divxu.w rs,rd
|
|
bist #imm,@@abs:8 * divxs.b rs,rd
|
|
bixor #imm,rd * divxs.w rs,rd
|
|
bixor #imm,@@rd eepmov
|
|
bixor #imm,@@abs:8 * eepmovw
|
|
@page
|
|
* exts.w rd mov.w rs,@@abs:16
|
|
* exts.l rd * mov.l #imm,rd
|
|
* extu.w rd * mov.l rs,rd
|
|
* extu.l rd * mov.l @@rs,rd
|
|
inc rs * mov.l @@(disp:16,rs),rd
|
|
* inc.w #imm,rd * mov.l @@(disp:24,rs),rd
|
|
* inc.l #imm,rd * mov.l @@rs+,rd
|
|
jmp @@rs * mov.l @@abs:16,rd
|
|
jmp abs * mov.l @@abs:24,rd
|
|
jmp @@@@abs:8 * mov.l rs,@@rd
|
|
jsr @@rs * mov.l rs,@@(disp:16,rd)
|
|
jsr abs * mov.l rs,@@(disp:24,rd)
|
|
jsr @@@@abs:8 * mov.l rs,@@-rd
|
|
ldc #imm,ccr * mov.l rs,@@abs:16
|
|
ldc rs,ccr * mov.l rs,@@abs:24
|
|
* ldc @@abs:16,ccr movfpe @@abs:16,rd
|
|
* ldc @@abs:24,ccr movtpe rs,@@abs:16
|
|
* ldc @@(disp:16,rs),ccr mulxu.b rs,rd
|
|
* ldc @@(disp:24,rs),ccr * mulxu.w rs,rd
|
|
* ldc @@rs+,ccr * mulxs.b rs,rd
|
|
* ldc @@rs,ccr * mulxs.w rs,rd
|
|
* mov.b @@(disp:24,rs),rd neg.b rs
|
|
* mov.b rs,@@(disp:24,rd) * neg.w rs
|
|
mov.b @@abs:16,rd * neg.l rs
|
|
mov.b rs,rd nop
|
|
mov.b @@abs:8,rd not.b rs
|
|
mov.b rs,@@abs:8 * not.w rs
|
|
mov.b rs,rd * not.l rs
|
|
mov.b #imm,rd or.b #imm,rd
|
|
mov.b @@rs,rd or.b rs,rd
|
|
mov.b @@(disp:16,rs),rd * or.w #imm,rd
|
|
mov.b @@rs+,rd * or.w rs,rd
|
|
mov.b @@abs:8,rd * or.l #imm,rd
|
|
mov.b rs,@@rd * or.l rs,rd
|
|
mov.b rs,@@(disp:16,rd) orc #imm,ccr
|
|
mov.b rs,@@-rd pop.w rs
|
|
mov.b rs,@@abs:8 * pop.l rs
|
|
mov.w rs,@@rd push.w rs
|
|
* mov.w @@(disp:24,rs),rd * push.l rs
|
|
* mov.w rs,@@(disp:24,rd) rotl.b rs
|
|
* mov.w @@abs:24,rd * rotl.w rs
|
|
* mov.w rs,@@abs:24 * rotl.l rs
|
|
mov.w rs,rd rotr.b rs
|
|
mov.w #imm,rd * rotr.w rs
|
|
mov.w @@rs,rd * rotr.l rs
|
|
mov.w @@(disp:16,rs),rd rotxl.b rs
|
|
mov.w @@rs+,rd * rotxl.w rs
|
|
mov.w @@abs:16,rd * rotxl.l rs
|
|
mov.w rs,@@(disp:16,rd) rotxr.b rs
|
|
mov.w rs,@@-rd * rotxr.w rs
|
|
@page
|
|
* rotxr.l rs * stc ccr,@@(disp:24,rd)
|
|
bpt * stc ccr,@@-rd
|
|
rte * stc ccr,@@abs:16
|
|
rts * stc ccr,@@abs:24
|
|
shal.b rs sub.b rs,rd
|
|
* shal.w rs sub.w rs,rd
|
|
* shal.l rs * sub.w #imm,rd
|
|
shar.b rs * sub.l rs,rd
|
|
* shar.w rs * sub.l #imm,rd
|
|
* shar.l rs subs #imm,rd
|
|
shll.b rs subx #imm,rd
|
|
* shll.w rs subx rs,rd
|
|
* shll.l rs * trapa #imm
|
|
shlr.b rs xor #imm,rd
|
|
* shlr.w rs xor rs,rd
|
|
* shlr.l rs * xor.w #imm,rd
|
|
sleep * xor.w rs,rd
|
|
stc ccr,rd * xor.l #imm,rd
|
|
* stc ccr,@@rs * xor.l rs,rd
|
|
* stc ccr,@@(disp:16,rd) xorc #imm,ccr
|
|
@end smallexample
|
|
@end ifset
|
|
|
|
@cindex size suffixes, H8/300
|
|
@cindex H8/300 size suffixes
|
|
Four H8/300 instructions (@code{add}, @code{cmp}, @code{mov},
|
|
@code{sub}) are defined with variants using the suffixes @samp{.b},
|
|
@samp{.w}, and @samp{.l} to specify the size of a memory operand.
|
|
@code{@value{AS}} supports these suffixes, but does not require them;
|
|
since one of the operands is always a register, @code{@value{AS}} can
|
|
deduce the correct size.
|
|
|
|
For example, since @code{r0} refers to a 16-bit register,
|
|
@example
|
|
mov r0,@@foo
|
|
@exdent is equivalent to
|
|
mov.w r0,@@foo
|
|
@end example
|
|
|
|
If you use the size suffixes, @code{@value{AS}} issues a warning when
|
|
the suffix and the register size do not match.
|