mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-11-27 12:03:41 +08:00
5518c738a4
ld * Makefile.am: (ALL_EMULATION_SOURCES): Add new emulations. * Makefile.in: Regenerate. * configure.tgt: Add h8300-*-linux * emulparams/h8300elf_linux.sh: Add new emulation. * emulparams/h8300helf_linux.sh: Likewise. * emulparams/h8300self_linux.sh: Likewise. * emulparams/h8300sxelf_linux.sh: Likewise. bfd * config.bfd: Add h8300-*-linux. * configure.ac: Add h8300_elf32_linux_vec. * configure: Regenerate. * elf32-h8300.c: Likewise. * targets.c(_bfd_target_vector): Likewise. gas * config/tc-h8300.c (line_separater_chars): Add a version for h8300-linux that includes a separator. (default_mach): New variable. (md_main): Use it. (md_longopts): Add '--march' option. (md_parse_option): Parse the new option. * config/tc-h8300.h (TARGET_FORMAT): Add elf32-h8300-linux. * configure.tgt: Add h8300-*-linux * doc/c-h8300.texi: Document --march.
375 lines
13 KiB
Plaintext
375 lines
13 KiB
Plaintext
@c Copyright (C) 1991-2015 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.
|