Update year range in copyright notice of all files.
[deliverable/binutils-gdb.git] / gas / doc / c-avr.texi
index 14f89796e3adea51371111d50f86bc19d74f82ef..f829e7968565139cb2f06365f7b1f21d6d872f2d 100644 (file)
@@ -1,5 +1,4 @@
-@c Copyright 2006, 2007, 2008, 2009, 2011
-@c Free Software Foundation, Inc.
+@c Copyright (C) 2006-2017 Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
 
@@ -46,7 +45,7 @@ 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,
-at86rf401, ata6289).
+attiny828, at86rf401, ata6289, ata5272).
 
 Instruction set avr3 is for the classic AVR core with up to 128K program
 memory space (MCU types: at43usb355, at76c711).
@@ -55,35 +54,75 @@ 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, at90usb82, at90usb162, atmega8u2,
-atmega16u2, atmega32u2).
+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, atmega48p, atmega8, atmega88,
-atmega88a, atmega88p, atmega88pa, atmega8515, atmega8535, atmega8hva, at90pwm1,
-at90pwm2, at90pwm2b, at90pwm3, at90pwm3b, at90pwm81).
+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: atmega16, atmega16a, atmega161, atmega162, atmega163,
-atmega164a, atmega164p, atmega165, atmega165a, atmega165p, atmega168,
-atmega168a, atmega168p, atmega169, atmega169a, atmega169p, atmega169pa,
-atmega32, atmega323, atmega324a, atmega324p, atmega325, atmega325a, atmega325p,
-atmega3250, atmega3250a, atmega3250p, atmega328, atmega328p, atmega329,
-atmega329a, atmega329p, atmega329pa, atmega3290, atmega3290a, atmega3290p,
-atmega406, atmega64, atmega640, atmega644, atmega644a, atmega644p, atmega644pa,
-atmega645, atmega645a, atmega645p, atmega6450, atmega6450a, atmega6450p,
-atmega649, atmega649a, atmega649p, atmega6490, atmega6490a, atmega6490p,
-atmega16hva, atmega16hva2, atmega16hvb, atmega32hvb, atmega64hve, at90can32,
-at90can64, at90pwm216, at90pwm316, atmega32c1, atmega64c1, atmega16m1, 
-atmega32m1, atmega64m1, atmega16u4, atmega32u4, atmega32u6, at90usb646,
-at90usb647, at94k, at90scr100).
-
-Instruction set avr51 is for the enhanced AVR core with exactly 128K program
-memory space (MCU types: atmega128, atmega1280, atmega1281, atmega1284p,
-atmega128rfa1, at90can128, at90usb1286, at90usb1287, m3000).
-
-Instruction set avr6 is for the enhanced AVR core with a 3-byte PC (MCU types:
-atmega2560, atmega2561).
+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 8K to 64K
+program memory space and greater than 64K data space (MCU types:
+none).
+
+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
@@ -97,6 +136,21 @@ This option disable warnings for skipping two-word instructions.
 @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.
+
 @end table
 
 
@@ -270,37 +324,37 @@ The following table summarizes the AVR opcodes, and their arguments.
    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  
+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 
+1001010000001001   ijmp
 1001010111001000   lpm     ?
 1001000ddddd010+   lpm     r,z
 1001010111011000   elpm    ?
 1001000ddddd011+   elpm    r,z
-0000000000000000   nop  
-1001010100001000   ret  
-1001010100011000   reti 
+0000000000000000   nop
+1001010100001000   ret
+1001010100011000   reti
 1001010110001000   sleep
 1001010110011000   break
-1001010110101000   wdr  
-1001010111101000   spm  
+1001010110101000   wdr
+1001010111101000   spm
 000111rdddddrrrr   adc     r,r
 000011rdddddrrrr   add     r,r
 001000rdddddrrrr   and     r,r
@@ -384,6 +438,6 @@ The following table summarizes the AVR opcodes, and their arguments.
 100!000dddddee-+   ld      r,e
 10o0oo1rrrrrbooo   std     b,r
 100!001rrrrree-+   st      e,r
-1001010100011001   eicall  
-1001010000011001   eijmp   
+1001010100011001   eicall
+1001010000011001   eijmp
 @end smallexample
This page took 0.035044 seconds and 4 git commands to generate.