mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-27 04:52:05 +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.
525 lines
17 KiB
Plaintext
525 lines
17 KiB
Plaintext
@c Copyright (C) 2006-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
|
|
@node AVR-Dependent
|
|
@chapter AVR Dependent Features
|
|
@end ifset
|
|
|
|
@ifclear GENERIC
|
|
@node Machine Dependencies
|
|
@chapter AVR Dependent Features
|
|
@end ifclear
|
|
|
|
@cindex AVR support
|
|
@menu
|
|
* AVR Options:: Options
|
|
* AVR Syntax:: Syntax
|
|
* AVR Opcodes:: Opcodes
|
|
* AVR Pseudo Instructions:: Pseudo Instructions
|
|
@end menu
|
|
|
|
@node AVR Options
|
|
@section Options
|
|
@cindex AVR options (none)
|
|
@cindex options for AVR (none)
|
|
|
|
@table @code
|
|
|
|
@cindex @code{-mmcu=} command-line option, AVR
|
|
@item -mmcu=@var{mcu}
|
|
Specify ATMEL AVR instruction set or MCU type.
|
|
|
|
Instruction set avr1 is for the minimal AVR core, not supported by the C
|
|
compiler, only for assembler programs (MCU types: at90s1200,
|
|
attiny11, attiny12, attiny15, attiny28).
|
|
|
|
Instruction set avr2 (default) is for the classic AVR core with up to
|
|
8K program memory space (MCU types: at90s2313, at90s2323, at90s2333, at90s2343,
|
|
attiny22, attiny26, at90s4414, at90s4433, at90s4434, at90s8515, at90c8534,
|
|
at90s8535).
|
|
|
|
Instruction set avr25 is for the classic AVR core with up to 8K program memory
|
|
space plus the MOVW instruction (MCU types: attiny13, attiny13a, attiny2313,
|
|
attiny2313a, attiny24, attiny24a, attiny4313, attiny44, attiny44a, attiny84,
|
|
attiny84a, attiny25, attiny45, attiny85, attiny261, attiny261a, attiny461,
|
|
attiny461a, attiny861, attiny861a, attiny87, attiny43u, attiny48, attiny88,
|
|
attiny828, at86rf401, ata6289, ata5272).
|
|
|
|
Instruction set avr3 is for the classic AVR core with up to 128K program
|
|
memory space (MCU types: at43usb355, at76c711).
|
|
|
|
Instruction set avr31 is for the classic AVR core with exactly 128K program
|
|
memory space (MCU types: atmega103, at43usb320).
|
|
|
|
Instruction set avr35 is for classic AVR core plus MOVW, CALL, and JMP
|
|
instructions (MCU types: attiny167, attiny1634, at90usb82, at90usb162,
|
|
atmega8u2, atmega16u2, atmega32u2, ata5505).
|
|
|
|
Instruction set avr4 is for the enhanced AVR core with up to 8K program
|
|
memory space (MCU types: atmega48, atmega48a, atmega48pa, atmega48p, atmega8,
|
|
atmega8a, atmega88, atmega88a, atmega88p, atmega88pa, atmega8515, atmega8535,
|
|
atmega8hva, at90pwm1, at90pwm2, at90pwm2b, at90pwm3, at90pwm3b, at90pwm81,
|
|
ata6285, ata6286).
|
|
|
|
Instruction set avr5 is for the enhanced AVR core with up to 128K program
|
|
memory space (MCU types: at90pwm161, atmega16, atmega16a, atmega161, atmega162,
|
|
atmega163, atmega164a, atmega164p, atmega164pa, atmega165, atmega165a,
|
|
atmega165p, atmega165pa, atmega168, atmega168a, atmega168p, atmega168pa,
|
|
atmega169, atmega169a, atmega169p, atmega169pa, atmega32, atmega323, atmega324a,
|
|
atmega324p, atmega324pa, atmega325, atmega325a, atmega32, atmega32a, atmega323,
|
|
atmega324a, atmega324p, atmega324pa, atmega325, atmega325a, atmega325p,
|
|
atmega325p, atmega325pa, atmega3250, atmega3250a, atmega3250p, atmega3250pa,
|
|
atmega328, atmega328p, atmega329, atmega329a, atmega329p, atmega329pa,
|
|
atmega3290a, atmega3290p, atmega3290pa, atmega406, atmega64, atmega64a,
|
|
atmega64rfr2, atmega644rfr2, atmega640, atmega644, atmega644a, atmega644p,
|
|
atmega644pa, atmega645, atmega645a, atmega645p, atmega6450, atmega6450a,
|
|
atmega6450p, atmega649, atmega649a, atmega649p, atmega6490, atmega6490a,
|
|
atmega6490p, atmega16hva, atmega16hva2, atmega16hvb, atmega16hvbrevb,
|
|
atmega32hvb, atmega32hvbrevb, atmega64hve, at90can32, at90can64, at90pwm161,
|
|
at90pwm216, at90pwm316, atmega32c1, atmega64c1, atmega16m1, atmega32m1,
|
|
atmega64m1, atmega16u4, atmega32u4, atmega32u6, at90usb646, at90usb647, at94k,
|
|
at90scr100, ata5790, ata5795).
|
|
|
|
Instruction set avr51 is for the enhanced AVR core with exactly 128K
|
|
program memory space (MCU types: atmega128, atmega128a, atmega1280,
|
|
atmega1281, atmega1284, atmega1284p, atmega128rfa1, atmega128rfr2,
|
|
atmega1284rfr2, at90can128, at90usb1286, at90usb1287, m3000).
|
|
|
|
Instruction set avr6 is for the enhanced AVR core with a 3-byte PC
|
|
(MCU types: atmega2560, atmega2561, atmega256rfr2, atmega2564rfr2).
|
|
|
|
Instruction set avrxmega2 is for the XMEGA AVR core with 8K to 64K
|
|
program memory space and less than 64K data space (MCU types:
|
|
atxmega16a4, atxmega16a4u, atxmega16c4, atxmega16d4, atxmega16x1,
|
|
atxmega32a4, atxmega32a4u, atxmega32c4, atxmega32d4, atxmega16e5,
|
|
atxmega8e5, atxmega32e5, atxmega32x1).
|
|
|
|
Instruction set avrxmega3 is for the XMEGA AVR core with up to 64K
|
|
of combined program memory and RAM, and with program memory
|
|
visible in the RAM address space (MCU types:
|
|
attiny212, attiny214, attiny412, attiny414, attiny416, attiny417,
|
|
attiny814, attiny816, attiny817, attiny1614, attiny1616, attiny1617,
|
|
attiny3214, attiny3216, attiny3217).
|
|
|
|
Instruction set avrxmega4 is for the XMEGA AVR core with up to 64K
|
|
program memory space and less than 64K data space (MCU types:
|
|
atxmega64a3, atxmega64a3u, atxmega64a4u, atxmega64b1, atxmega64b3,
|
|
atxmega64c3, atxmega64d3, atxmega64d4).
|
|
|
|
Instruction set avrxmega5 is for the XMEGA AVR core with up to 64K
|
|
program memory space and greater than 64K data space (MCU types:
|
|
atxmega64a1, atxmega64a1u).
|
|
|
|
Instruction set avrxmega6 is for the XMEGA AVR core with larger than
|
|
64K program memory space and less than 64K data space (MCU types:
|
|
atxmega128a3, atxmega128a3u, atxmega128c3, atxmega128d3, atxmega128d4,
|
|
atxmega192a3, atxmega192a3u, atxmega128b1, atxmega128b3, atxmega192c3,
|
|
atxmega192d3, atxmega256a3, atxmega256a3u, atxmega256a3b,
|
|
atxmega256a3bu, atxmega256c3, atxmega256d3, atxmega384c3,
|
|
atxmega256d3).
|
|
|
|
Instruction set avrxmega7 is for the XMEGA AVR core with larger than
|
|
64K program memory space and greater than 64K data space (MCU types:
|
|
atxmega128a1, atxmega128a1u, atxmega128a4u).
|
|
|
|
Instruction set avrtiny is for the ATtiny4/5/9/10/20/40
|
|
microcontrollers.
|
|
|
|
@cindex @code{-mall-opcodes} command-line option, AVR
|
|
@item -mall-opcodes
|
|
Accept all AVR opcodes, even if not supported by @code{-mmcu}.
|
|
|
|
@cindex @code{-mno-skip-bug} command-line option, AVR
|
|
@item -mno-skip-bug
|
|
This option disable warnings for skipping two-word instructions.
|
|
|
|
@cindex @code{-mno-wrap} command-line option, AVR
|
|
@item -mno-wrap
|
|
This option reject @code{rjmp/rcall} instructions with 8K wrap-around.
|
|
|
|
@cindex @code{-mrmw} command-line option, AVR
|
|
@item -mrmw
|
|
Accept Read-Modify-Write (@code{XCH,LAC,LAS,LAT}) instructions.
|
|
|
|
@cindex @code{-mlink-relax} command-line option, AVR
|
|
@item -mlink-relax
|
|
Enable support for link-time relaxation. This is now on by default
|
|
and this flag no longer has any effect.
|
|
|
|
@cindex @code{-mno-link-relax} command-line option, AVR
|
|
@item -mno-link-relax
|
|
Disable support for link-time relaxation. The assembler will resolve
|
|
relocations when it can, and may be able to better compress some debug
|
|
information.
|
|
|
|
@cindex @code{-mgcc-isr} command-line option, AVR
|
|
@item -mgcc-isr
|
|
Enable the @code{__gcc_isr} pseudo instruction.
|
|
|
|
@cindex @code{-mno-dollar-line-separator} command line option, AVR
|
|
@item -mno-dollar-line-separator
|
|
Do not treat the @code{$} character as a line separator character.
|
|
This is for languages where @code{$} is valid character inside symbol
|
|
names.
|
|
|
|
@end table
|
|
|
|
|
|
@node AVR Syntax
|
|
@section Syntax
|
|
@menu
|
|
* AVR-Chars:: Special Characters
|
|
* AVR-Regs:: Register Names
|
|
* AVR-Modifiers:: Relocatable Expression Modifiers
|
|
@end menu
|
|
|
|
@node AVR-Chars
|
|
@subsection Special Characters
|
|
|
|
@cindex line comment character, AVR
|
|
@cindex AVR line comment character
|
|
|
|
The presence of a @samp{;} anywhere on a line indicates the start of a
|
|
comment that extends to the end of that line.
|
|
|
|
If a @samp{#} appears as the first character of a line, the whole line
|
|
is treated as a comment, but in this case the line can also be a
|
|
logical line number directive (@pxref{Comments}) or a preprocessor
|
|
control command (@pxref{Preprocessing}).
|
|
|
|
@cindex line separator, AVR
|
|
@cindex statement separator, AVR
|
|
@cindex AVR line separator
|
|
|
|
The @samp{$} character can be used instead of a newline to separate
|
|
statements. Note: the @option{-mno-dollar-line-separator} option
|
|
disables this behaviour.
|
|
|
|
@node AVR-Regs
|
|
@subsection Register Names
|
|
|
|
@cindex AVR register names
|
|
@cindex register names, AVR
|
|
|
|
The AVR has 32 x 8-bit general purpose working registers @samp{r0},
|
|
@samp{r1}, ... @samp{r31}.
|
|
Six of the 32 registers can be used as three 16-bit indirect address
|
|
register pointers for Data Space addressing. One of the these address
|
|
pointers can also be used as an address pointer for look up tables in
|
|
Flash program memory. These added function registers are the 16-bit
|
|
@samp{X}, @samp{Y} and @samp{Z} - registers.
|
|
|
|
@smallexample
|
|
X = @r{r26:r27}
|
|
Y = @r{r28:r29}
|
|
Z = @r{r30:r31}
|
|
@end smallexample
|
|
|
|
@node AVR-Modifiers
|
|
@subsection Relocatable Expression Modifiers
|
|
|
|
@cindex AVR modifiers
|
|
@cindex syntax, AVR
|
|
|
|
The assembler supports several modifiers when using relocatable addresses
|
|
in AVR instruction operands. The general syntax is the following:
|
|
|
|
@smallexample
|
|
modifier(relocatable-expression)
|
|
@end smallexample
|
|
|
|
@table @code
|
|
@cindex symbol modifiers
|
|
|
|
@item lo8
|
|
|
|
This modifier allows you to use bits 0 through 7 of
|
|
an address expression as an 8 bit relocatable expression.
|
|
|
|
@item hi8
|
|
|
|
This modifier allows you to use bits 7 through 15 of an address expression
|
|
as an 8 bit relocatable expression. This is useful with, for example, the
|
|
AVR @samp{ldi} instruction and @samp{lo8} modifier.
|
|
|
|
For example
|
|
|
|
@smallexample
|
|
ldi r26, lo8(sym+10)
|
|
ldi r27, hi8(sym+10)
|
|
@end smallexample
|
|
|
|
@item hh8
|
|
|
|
This modifier allows you to use bits 16 through 23 of
|
|
an address expression as an 8 bit relocatable expression.
|
|
Also, can be useful for loading 32 bit constants.
|
|
|
|
@item hlo8
|
|
|
|
Synonym of @samp{hh8}.
|
|
|
|
@item hhi8
|
|
|
|
This modifier allows you to use bits 24 through 31 of
|
|
an expression as an 8 bit expression. This is useful with, for example, the
|
|
AVR @samp{ldi} instruction and @samp{lo8}, @samp{hi8}, @samp{hlo8},
|
|
@samp{hhi8}, modifier.
|
|
|
|
For example
|
|
|
|
@smallexample
|
|
ldi r26, lo8(285774925)
|
|
ldi r27, hi8(285774925)
|
|
ldi r28, hlo8(285774925)
|
|
ldi r29, hhi8(285774925)
|
|
; r29,r28,r27,r26 = 285774925
|
|
@end smallexample
|
|
|
|
@item pm_lo8
|
|
|
|
This modifier allows you to use bits 0 through 7 of
|
|
an address expression as an 8 bit relocatable expression.
|
|
This modifier is useful for addressing data or code from
|
|
Flash/Program memory by two-byte words. The use of @samp{pm_lo8}
|
|
is similar to @samp{lo8}.
|
|
|
|
@item pm_hi8
|
|
|
|
This modifier allows you to use bits 8 through 15 of
|
|
an address expression as an 8 bit relocatable expression.
|
|
This modifier is useful for addressing data or code from
|
|
Flash/Program memory by two-byte words.
|
|
|
|
For example, when setting the AVR @samp{Z} register with the @samp{ldi}
|
|
instruction for subsequent use by the @samp{ijmp} instruction:
|
|
|
|
@smallexample
|
|
ldi r30, pm_lo8(sym)
|
|
ldi r31, pm_hi8(sym)
|
|
ijmp
|
|
@end smallexample
|
|
|
|
@item pm_hh8
|
|
|
|
This modifier allows you to use bits 15 through 23 of
|
|
an address expression as an 8 bit relocatable expression.
|
|
This modifier is useful for addressing data or code from
|
|
Flash/Program memory by two-byte words.
|
|
|
|
@end table
|
|
|
|
@node AVR Opcodes
|
|
@section Opcodes
|
|
|
|
@cindex AVR opcode summary
|
|
@cindex opcode summary, AVR
|
|
@cindex mnemonics, AVR
|
|
@cindex instruction summary, AVR
|
|
For detailed information on the AVR machine instruction set, see
|
|
@url{www.atmel.com/products/AVR}.
|
|
|
|
@code{@value{AS}} implements all the standard AVR opcodes.
|
|
The following table summarizes the AVR opcodes, and their arguments.
|
|
|
|
@smallexample
|
|
@i{Legend:}
|
|
r @r{any register}
|
|
d @r{`ldi' register (r16-r31)}
|
|
v @r{`movw' even register (r0, r2, ..., r28, r30)}
|
|
a @r{`fmul' register (r16-r23)}
|
|
w @r{`adiw' register (r24,r26,r28,r30)}
|
|
e @r{pointer registers (X,Y,Z)}
|
|
b @r{base pointer register and displacement ([YZ]+disp)}
|
|
z @r{Z pointer register (for [e]lpm Rd,Z[+])}
|
|
M @r{immediate value from 0 to 255}
|
|
n @r{immediate value from 0 to 255 ( n = ~M ). Relocation impossible}
|
|
s @r{immediate value from 0 to 7}
|
|
P @r{Port address value from 0 to 63. (in, out)}
|
|
p @r{Port address value from 0 to 31. (cbi, sbi, sbic, sbis)}
|
|
K @r{immediate value from 0 to 63 (used in `adiw', `sbiw')}
|
|
i @r{immediate value}
|
|
l @r{signed pc relative offset from -64 to 63}
|
|
L @r{signed pc relative offset from -2048 to 2047}
|
|
h @r{absolute code address (call, jmp)}
|
|
S @r{immediate value from 0 to 7 (S = s << 4)}
|
|
? @r{use this opcode entry if no parameters, else use next opcode entry}
|
|
|
|
1001010010001000 clc
|
|
1001010011011000 clh
|
|
1001010011111000 cli
|
|
1001010010101000 cln
|
|
1001010011001000 cls
|
|
1001010011101000 clt
|
|
1001010010111000 clv
|
|
1001010010011000 clz
|
|
1001010000001000 sec
|
|
1001010001011000 seh
|
|
1001010001111000 sei
|
|
1001010000101000 sen
|
|
1001010001001000 ses
|
|
1001010001101000 set
|
|
1001010000111000 sev
|
|
1001010000011000 sez
|
|
100101001SSS1000 bclr S
|
|
100101000SSS1000 bset S
|
|
1001010100001001 icall
|
|
1001010000001001 ijmp
|
|
1001010111001000 lpm ?
|
|
1001000ddddd010+ lpm r,z
|
|
1001010111011000 elpm ?
|
|
1001000ddddd011+ elpm r,z
|
|
0000000000000000 nop
|
|
1001010100001000 ret
|
|
1001010100011000 reti
|
|
1001010110001000 sleep
|
|
1001010110011000 break
|
|
1001010110101000 wdr
|
|
1001010111101000 spm
|
|
000111rdddddrrrr adc r,r
|
|
000011rdddddrrrr add r,r
|
|
001000rdddddrrrr and r,r
|
|
000101rdddddrrrr cp r,r
|
|
000001rdddddrrrr cpc r,r
|
|
000100rdddddrrrr cpse r,r
|
|
001001rdddddrrrr eor r,r
|
|
001011rdddddrrrr mov r,r
|
|
100111rdddddrrrr mul r,r
|
|
001010rdddddrrrr or r,r
|
|
000010rdddddrrrr sbc r,r
|
|
000110rdddddrrrr sub r,r
|
|
001001rdddddrrrr clr r
|
|
000011rdddddrrrr lsl r
|
|
000111rdddddrrrr rol r
|
|
001000rdddddrrrr tst r
|
|
0111KKKKddddKKKK andi d,M
|
|
0111KKKKddddKKKK cbr d,n
|
|
1110KKKKddddKKKK ldi d,M
|
|
11101111dddd1111 ser d
|
|
0110KKKKddddKKKK ori d,M
|
|
0110KKKKddddKKKK sbr d,M
|
|
0011KKKKddddKKKK cpi d,M
|
|
0100KKKKddddKKKK sbci d,M
|
|
0101KKKKddddKKKK subi d,M
|
|
1111110rrrrr0sss sbrc r,s
|
|
1111111rrrrr0sss sbrs r,s
|
|
1111100ddddd0sss bld r,s
|
|
1111101ddddd0sss bst r,s
|
|
10110PPdddddPPPP in r,P
|
|
10111PPrrrrrPPPP out P,r
|
|
10010110KKddKKKK adiw w,K
|
|
10010111KKddKKKK sbiw w,K
|
|
10011000pppppsss cbi p,s
|
|
10011010pppppsss sbi p,s
|
|
10011001pppppsss sbic p,s
|
|
10011011pppppsss sbis p,s
|
|
111101lllllll000 brcc l
|
|
111100lllllll000 brcs l
|
|
111100lllllll001 breq l
|
|
111101lllllll100 brge l
|
|
111101lllllll101 brhc l
|
|
111100lllllll101 brhs l
|
|
111101lllllll111 brid l
|
|
111100lllllll111 brie l
|
|
111100lllllll000 brlo l
|
|
111100lllllll100 brlt l
|
|
111100lllllll010 brmi l
|
|
111101lllllll001 brne l
|
|
111101lllllll010 brpl l
|
|
111101lllllll000 brsh l
|
|
111101lllllll110 brtc l
|
|
111100lllllll110 brts l
|
|
111101lllllll011 brvc l
|
|
111100lllllll011 brvs l
|
|
111101lllllllsss brbc s,l
|
|
111100lllllllsss brbs s,l
|
|
1101LLLLLLLLLLLL rcall L
|
|
1100LLLLLLLLLLLL rjmp L
|
|
1001010hhhhh111h call h
|
|
1001010hhhhh110h jmp h
|
|
1001010rrrrr0101 asr r
|
|
1001010rrrrr0000 com r
|
|
1001010rrrrr1010 dec r
|
|
1001010rrrrr0011 inc r
|
|
1001010rrrrr0110 lsr r
|
|
1001010rrrrr0001 neg r
|
|
1001000rrrrr1111 pop r
|
|
1001001rrrrr1111 push r
|
|
1001010rrrrr0111 ror r
|
|
1001010rrrrr0010 swap r
|
|
00000001ddddrrrr movw v,v
|
|
00000010ddddrrrr muls d,d
|
|
000000110ddd0rrr mulsu a,a
|
|
000000110ddd1rrr fmul a,a
|
|
000000111ddd0rrr fmuls a,a
|
|
000000111ddd1rrr fmulsu a,a
|
|
1001001ddddd0000 sts i,r
|
|
1001000ddddd0000 lds r,i
|
|
10o0oo0dddddbooo ldd r,b
|
|
100!000dddddee-+ ld r,e
|
|
10o0oo1rrrrrbooo std b,r
|
|
100!001rrrrree-+ st e,r
|
|
1001010100011001 eicall
|
|
1001010000011001 eijmp
|
|
@end smallexample
|
|
|
|
@node AVR Pseudo Instructions
|
|
@section Pseudo Instructions
|
|
|
|
The only available pseudo-instruction @code{__gcc_isr} can be activated by
|
|
option @option{-mgcc-isr}.
|
|
|
|
@table @code
|
|
|
|
@item __gcc_isr 1
|
|
Emit code chunk to be used in avr-gcc ISR prologue.
|
|
It will expand to at most six 1-word instructions, all optional:
|
|
push of @code{tmp_reg}, push of @code{SREG},
|
|
push and clear of @code{zero_reg}, push of @var{Reg}.
|
|
|
|
@item __gcc_isr 2
|
|
Emit code chunk to be used in an avr-gcc ISR epilogue.
|
|
It will expand to at most five 1-word instructions, all optional:
|
|
pop of @var{Reg}, pop of @code{zero_reg},
|
|
pop of @code{SREG}, pop of @code{tmp_reg}.
|
|
|
|
@item __gcc_isr 0, @var{Reg}
|
|
Finish avr-gcc ISR function. Scan code since the last prologue
|
|
for usage of: @code{SREG}, @code{tmp_reg}, @code{zero_reg}.
|
|
Prologue chunk and epilogue chunks will be replaced by appropriate code
|
|
to save / restore @code{SREG}, @code{tmp_reg}, @code{zero_reg} and @var{Reg}.
|
|
|
|
@end table
|
|
|
|
Example input:
|
|
|
|
@example
|
|
__vector1:
|
|
__gcc_isr 1
|
|
lds r24, var
|
|
inc r24
|
|
sts var, r24
|
|
__gcc_isr 2
|
|
reti
|
|
__gcc_isr 0, r24
|
|
@end example
|
|
|
|
Example output:
|
|
|
|
@example
|
|
00000000 <__vector1>:
|
|
0: 8f 93 push r24
|
|
2: 8f b7 in r24, 0x3f
|
|
4: 8f 93 push r24
|
|
6: 80 91 60 00 lds r24, 0x0060 ; 0x800060 <var>
|
|
a: 83 95 inc r24
|
|
c: 80 93 60 00 sts 0x0060, r24 ; 0x800060 <var>
|
|
10: 8f 91 pop r24
|
|
12: 8f bf out 0x3f, r24
|
|
14: 8f 91 pop r24
|
|
16: 18 95 reti
|
|
@end example
|