GNU Toolchain for Atmel AVR8 Embedded processors 3.5.0.1636
Contents
1. attiny9 attiny10 attiny12 attiny15 atmega128rfal atmega128rfr2 atmega1284rfr2 atmega256rfr2 atxmega16a4u atxmega16c4 atxmega32a4u atxmega32c4 atxmega64b1 atxmega64b3 atxmega192d3 atxmega256a3 atxmega256a3b atxmega256a3bu atxmega256a3u atxmega128a4u attiny20 attiny40 attiny28 at90can128 at90usb1286 at90usb1287 atmega2564rfr2 atxmega32e5 atxmega64c3 atxmega64d4 atxmega256c3 atxmega256d3 atxmega384c3 atxmega384d3 GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 42372A MCU 06 2015 10 5 Contact Information and Disclaimer For support on Atmel AVR 8 bit GNU Toolchain please visit design su pport Users of AVR 8 bit GNU Toolchain are also welcome to discuss on the AVRFreaks website forum for AVR Software Tools 5 1 Disclaimer AVR 8 bit GNU Toolchain is distributed free of charge for the purpose of developing applications for Atmel AVR processors AVR 8 bit GNU Toolchain comes without any warranty A http www atmel com design support Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 11 42372A MCU 06 2015 Atmel Enabling Unlimited Possibilities Atmel Corporation 1600 Technology Drive San Jose CA 95110 USA T 1 408 441 0311 F 1 408 436 4200 www atmel com 2015 Atmel Corporation Rev 42372A MCU 06 2015 Atmel Atmel logo and combinations thereof Enabling Unlimited Possibilities AVR tinyAV2. Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 3 42372A MCU 06 2015 e GCC e GDB e lt install_dir gt avr lib avr libc libraries startup files linker scripts and stuff e lt install_dir gt avr include avr libc header files for AVR 8 bit e lt install_dir gt avr include avr header files specific to the AVR 8 bit MCU This is where for example include lt avr io h gt comes from e lt install_dir gt lib GCC libraries other libraries headers and stuff e lt install_dir gt libexec GCC program components e lt install_dir gt doc Various documentation Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 4 42372A MCU 06 2015 2 1 2 2 2 3 Toolset Background AVR 8 bit GNU Toolchain is a collection of executable open source software development tools for the Atmel AVR 8 bit series of microcontrollers It includes the GNU GCC compiler for C and C Component Versions GCC 4 9 2 binutils 2 25 avr libc 1 8 0svn gdb 7 8 7 8 Compiler The compiler is the GNU Compiler Collection or GCC This compiler is incredibly flexible and can be hosted on many platforms it can target many different processors operating systems back ends and can be configured for multiple different languages front ends The GCC included in AVR 8 bit GNU Toolchain is targeted for the AVR 8 bit microcontroller and is configured to compile C or C
3. CAUTION There are caveats on using C See the avr libc FAQ C language is not fully supported and has some limitations libstdc is unsupported Because this GCC is targeted for the AVR 8 bit MCUs the main executable that is created is prefixed with the target name avr gcc with exe extension on MS Windows It is also referred to as AVR GCC avr gcc is just a driver program only The compiler itself is called cc1 exe for C or cc1plus exe for C Also the preprocessor cpp exe will usually automatically be prepended with the target name avr cpp The actual set of component programs called is usually derived from the suffix of each source code file being processed GCC compiles a high level computer language into assembly and that is all It cannot work alone GCC is coupled with another project GNU Binutils which provides the assembler linker librarian and more Since gcc is just a driver program it can automatically call the assembler and linker directly to build the final program Assembler Linker Librarian and More GNU Binutils is a collection of binary utilities This also includes the assembler as Sometimes you will see it referenced as GNU as or gas Binutils includes the linker Id the librarian or archiver ar There are many other programs included that provide various functionality Note that while the assembler uses the same mnemonics as proposed by Atmel the glue pseudo ops operat
4. for download and install in one of the following ways Downloading Installing on Windows e Ifyou want to try the Atmel AVR8 GNU toolchain alone you can download it from here e If you want to try the Atmel AVR8 GNU Toolchain along with Atmel studio you can download and install Atmel studio 6 0 or newer which will also install the Atmel AVR8 GNU toolchain See Atmel studio release notes for more details Downloading Installing on Linux For Linux the Atmel AVR8 GNU Toolchain is available as a tar gz archive which can be extracted using the tar utility In order to install simply extract to the location from where you want to run it from Linux builds are available from here Upgrading from previous versions If the Atmel AVR8 GNU Toolchain is installed by Atmel studio installation it can be upgraded from Atmel Gallery If the toolchain is installed separately upgrading is not supported You can install the new package side by side to the old package and use it Layout Listed below are some directories you might want to know about lt install_dir gt The directory where you installed AVR 8 bit GNU Toolchain e lt install_dir gt bin The AVR software development programs This directory should be in your PATH environment variable This includes e GNU Binutils http www atmel com tools atmelavrtoolchainforwindows aspx 2 http www atmel com tools ATMELAVRTOOLCHAINFORLINUX aspx http gallery atmel com
5. E NOTES 8 42372A MCU 06 2015 4 Supported Devices avr2 at9052313 at9052323 at90s2333 avr25 ata5272 ata6616c attiny13 attiny13a attiny2313 attiny2313a attiny24 attiny24a avr3 at43usb355 avr31 atmegal03 avr35 ata5505 ata6617c ata664251 avr4 ata6285 ata6286 ata6289 ata6612c atmega8 atmega8a atmega48 avr5 ata5702m322 ata5782 ata5790 ata5790n ata5791 ata5795 ata5831 ata6613c ata6614q ata8210 ata8510 atmega16 atmegal6a atmega161 atmega162 atmega163 atmegal 4a atmegal64p atmegal64pa atmegal65 atmegal65a atmega165p atmega165pa atmega168 atmega168a atmega168p Atmel at90s2343 attiny22 attiny26 attiny4313 attiny44 attiny44a attiny441 attiny84 attiny84a attiny25 attiny45 at76c711 at43usb320 at90usb82 at9O0usb162 atmega8u2 atmega48a atmega48p atmega48pa atmega48pb atmega88 atmega88a atmega88p atmegal68pa atmegal68pb atmega169 atmegal69a atmega169p atmega169pa atmega16hvb atmega16hvbrevb atmega16m1 atmega16u4 atmega32a atmega32 atmega323 atmega324a atmega324p atmega324pa atmega325 atmega325a atmega325p atmega325pa atmega3250 atmega3250a atmega3250p atmega3250pa atmega328 atmega328p at90s4414 at90s4433 at90s4434 attiny85 attiny261 attiny261a attiny461 attiny461a attiny861 attiny861a attiny43u atmega16u2 atmega32u2 attiny167 atmega88pa atmega88pb atmega8515 atmega8535 atmega8hva at90pwm1 at90pwm2 atmega329 atme
6. E sesa n E A E E E EAEE 3 Bugs and New Features 3 1 IN W TCATUIGS fice cscdtiasentdyge2nteis ioei aaa n aaea E A E ORREN 3 2 Notable bugs fixed SS KNOWNISSUCS serron ei A E E E E 4 Supported Devices asic cctceniass cccotortcavattecsssctasetdevacenedeanndenoncee 5 Contact Information and Disclaimer 5 1 DISCIAING mrii bsezzez seasek n rksi GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 42372A MCU 06 2015 2 1 1 1 1 1 1 1 2 1 2 1 2 1 1 2 2 1 2 3 1 3 Installation Instructions System requirements Hardware requirements e Minimum processor Pentium 4 1GHz e Minimum 512 MB RAM e Minimum 500 MB free disk space AVR 8 bit GNU Toolchain has not been tested on computers with less resources but may run satisfactorily depending on the number and size of the projects and the user s patience Software Requirements e Windows 2000 Windows XP Windows Vista Windows 7 x86 or x86 64 or Windows 8 x86 or x86 64 e AVR 8 bit GNU Toolchain is not supported on Windows 98 NT or ME e The toolchain should work on the Linux distributions Fedora RedHat Enterprise Arch Linux and Ubuntu for both 32 bits and 64 bits architecture AVR 8 bit GNU Toolchain may very well work on other distributions However those are untested and unsupported Downloading Installing and Upgrading The AVR8 GNU toolchain provided by Atmel is available
7. R XMEGA megaAVR and others are registered trademarks or trademarks of Atmel Corporation in U S and other countries Windows and others are registered trademarks of Microsoft Corporation in U S and or other countries ARM6 is a registered trademark of ARM Ltd Other terms and product names may be trademarks of others DISCLAIMER The information in this document is provided in connection with Atmel products No license express or implied by estoppel or otherwise to any intellectual property right is granted by this document or in connection with the sale of Atmel products EXCEPT AS SET FORTH IN THE ATMEL TERMS AND CONDITIONS OF SALES LOCATED ON THE ATMEL WEBSITE ATMEL ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT INDIRECT CONSEQUENTIAL PUNITIVE SPECIAL OR INCIDENTAL DAMAGES INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS AND PROFITS BUSINESS INTERRUPTION OR LOSS OF INFORMATION ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT EVEN IF ATMEL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Atmel makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and products descript
8. Us In addition to avr libc libraries Host IO library libhostio a is integrated to this toolchain This Host IO library allows allows the target to use the host s file system and console I O to perform various avr I O operations NOTE The actual library is currently split into two main parts libc a and libm a where the latter contains mathematical functions everything mentioned in lt math h gt and a bit more Also there are additional libraries which allow a customization of the printf and scanf function families avr libc contains documentation on how to use and build the entire toolset including code examples The avr libc user manual also contains the FAQ on using the toolset Debugging Atmel Studio provides a debugger and also provides simulators for the parts that can be used for debugging as well Note that Atmel Studio is currently free to the public but it is not Open Source The GNU debugger is now shipped along with the toolchain Source Code Atmel AVR 8 bit GNU Toolchain uses modified source code from GCC Binutils and AVR LibC The source code and the build scripts used for building the packaged binaries are available at http distripute atmel no tools opensource Atmel AVR GNU Toolchain 3 5 0 Please refer to the README for the instructions on how to use the supplied script to build the toolchain Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 6 42372A MCU 06 2015 Bu
9. a A t Mm e L Berens eee GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 AVR8 GNU Toolchain The AVR 8 bit GNU Toolchain supports all AVR 8 bit devices The AVR 8 bit Toolchain is based on the free and open source GCC compiler The toolchain includes compiler assembler linker and binutils GCC and Binutils Standard C library AVR libc and GNU Debugger GDB 42372A MCU 06 2015 Atmel Table of Contents AVR8 GNU Toolchain e cc eeeeceeeeceeececeeeeeceseceeeeeeeeueeeeeeeeeeneeenens 1 Installation Instructions ccicien iececiccstcides vnccercdecceree sdeecenteatsedietees 1 1 System HEQUINEMENTS sosoran ai EEE EEE 1 1 1 Hardware requirements cceeeeeeeeeeeeee seen eeenee 1 1 2 Software Requirement cccceeeeeeeeeeeeeeeeeeeeeee 1 2 Downloading Installing and Upgrading 1 2 1 Downloading Installing on Windows 1 2 2 Downloading Installing on Linux 1 2 3 Upgrading from previous versions 0 0ceeeeeeeeeeees L3 LAYOUE is sz eszes tesben onecidteaosoeivaeouces 2 Toolset Background 2 1 Component Versions 225 COMPIE cesa S E A E a 2 3 Assembler Linker Librarian and More 24 C LDAN senene saz aaa EI E E E ENE inbeaeandSeenan ats 25 Deb ggihg e diets sansa sien ieeennsitionesBaalcaindaatac A a a E Ea 26 SOUNCE COd
10. c lt 5 1 0 Issue AVRTCDEV 861 Let linker remove all debug sections for a function if that function is garbage collected Issue AVRTCDEV 866 Device library lib lt device gt a and startup object files crt lt device gt o are installed in multilib location Issue AVRTC 714 Optimize wdt_enable expression by avoiding un necessary loads Issue AVRTC 726 The compiler no more supports individual devices like ATmega8 Specifying say mmcu atmega8 triggers the usage of the device specific spec file specs atmega8 which is part of the installation and describes options Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 7 42372A MCU 06 2015 3 2 3 3 for the sub processes like compiler proper assembler and linker You can add support for a new device mmcu mydevice as follows In an empty directory someplace create a new directory device specs Copy a device spec file from the installed device specs folder follow the comments in that file and then save it as someplace device specs specs mydevice Add B someplace mmcu mydevice to the compiler s command line options Notice that someplace must specify an absolute path and that mydevice must not start with avr Provided you have a device specific library libmydevice a available you can put it at someplace dito for a device specific startup file crtmydevice o The contents of the device spec files depend on the compiler
11. ga329a atmega329p atmega329pa atmega3290 atmega3290a atmega3290p atmega3290pa atmega32c1 atmega32m1 atmega32u4 atmega32u6 atmega406 atmega64 atmega64a atmega640 atmega644 atmega644a atmega644p atmega644pa atmega645 atmega645a atmega645p atmega6450 atmega6450a atmega6450p at90s8515 at90c8534 at90s8535 attiny87 attiny48 attiny88 attiny828 attiny841 at86rf401 attiny1634 at90pwm2b at90pwm3 at90pwm3b at90pwm81 atmega649 atmega649a atmega649p atmega6490 atmega16hva atmegal6hva2 atmega32hvb atmega6490a atmega6490p atmega64c1 atmega64m1 atmega64hve atmega64hve2 atmega64rfr2 atmega644rfr2 atmega32hvbrevb at90can32 at90can64 at90pwm161 at90pwm216 at90pwm316 at90scr100 at90usb646 at90usb647 at94k m3000 GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 9 42372A MCU 06 2015 Atmel avr51 atmega128 atmega128a atmega1280 avr6 atmega2560 avrxmega2 atxmega8e5 atxmegal6a4 atxmegal6d4 atxmegai6e5 avrxmega4 atxmega64a3 atxmega64d3 avrxmega5S atxmega64a1 avrxmega6 atxmega128a3 atxmega128a3u atxmega128b1 atxmega128b3 atxmega128c3 avrxmega7 atxmega128a1 avrtiny attiny4 attiny5 avr1 at90s1200 attiny11 atmega1281 atmega1284 atmega1284p atmega2561 atxmega32a4 atxmega32c3 atxmega32d3 atxmega32d4 atxmega64a3u atxmega64a4u atxmega64alu atxmega128d3 atxmega128d4 atxmega192a3 atxmega192a3u atxmega192c3 atxmega128a1u
12. gs and New Features New features Issue HAVRTCDEV 704 Move device specific functions from standard library to new device library Issue AVRTCDEV 719 Upgrade gcc to version 4 9 2 Issue AVRTCDEV 741 Allow symbols in MEMORY region specification of Linker script Issue AVRTCDEV 743 Add device memory details in a note section of device startup file Issue AVRTCDEV 744 Rewritten wdt_enable disable macros so that it doesn t require device name macro Issue AVRTCDEV 745 Remove device specific macro in sleep h Instead use sleep mode conditions from device header file Issue AVRTCDEV 747 Remove device specific macro in power h Instead use power reduction conditions from device header file Issue AVRTCDEV 748 Let io h identify the device header file without needing to hard code the device name macro Issue AVRTCDEV 796 Remove device specific macro definition in power h Instead use power reduction conditions that will be available from device header files Issue AVRTCDEV 825 Implemented fopen and fclose functions using avr libc call backs to FILE IO Issue AVRTCDEV 826 Implemented a serial protocol using which the IO operations information are sent via UART Issue AVRTCDEV 827 Host IO Server application to handle the serial data sent by device for IO operations Issue AVRTCDEV 828 Remove device specific information from standard library and headers Issue AVRTCDEV 850 Make avr libc backward compatible with gc
13. ions at any time without notice Atmel does not make any commitment to update the information contained herein Unless specifically provided otherwise Atmel products are not suitable for and shall not be used in automotive applications Atmel products are not intended authorized or warranted for use as components in applications intended to support or sustain life SAFETY CRITICAL MILITARY AND AUTOMOTIVE APPLICATIONS DISCLAIMER Atmel products are not designed for and will not be used in connection with any applications where the failure of such products would reasonably be expected to result in significant personal injury or death Safety Critical Applications without an Atmel officer s specific written consent Safety Critical Applications include without limitation life support devices and systems equipment or systems for the operation of nuclear facilities and weapons systems Atmel products are not designed nor intended for use in military or aerospace applications or environments unless specifically designated by Atmel as military grade Atmel products are not designed nor intended for use in automotive applications unless specifically designated by Atmel as automotive grade
14. ors expression syntax is derived from the common assembler syntax used in Unix assemblers so it is not directly compatible to Atmel assembler source files Binutils is configured for the AVR target and each of the programs is prefixed with the target name So you have programs such as e avr as The Assembler e avr ld The Linker e avr ar Create modify and extract from archives libraries e avr ranlib Generate index to archive library contents e avr objcopy Copy and translate object files e avr objdump Display information from object files including disassembly e avr size List section sizes and total size e avr nm List symbols from object files e avr strings List printable strings from files e avr strip Discard symbols Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEASE NOTES 5 42372A MCU 06 2015 2 4 2 5 2 6 e avr readelf Display the contents of ELF format files e avr addr2line Convert addresses to file and line e avr c filt Filter to demangle encoded C symbols e avr gdb GDB the GNU debugger allows you to see what is going on inside another program targeted to AVR while it executes See the binutils user manual for more information on what each program can do C Library avr libc is the Standard C Library for AVR 8 bit GCC It contains many of the standard C routines and many non standard routines that are specific and useful for the AVR 8 bit MC
15. s configuration in particular on with avrlipc no and whether or not it is configured for RTEMS Notable bugs fixed Issue AVRTC 708 Incorrect values for label diff expression in assembly code Assembler now emits a DIFF reloc which subsequently gets resolved to the correct value at link time Issue AVRTC 735 Incorrect constraint in wdt_enable disable macros corrected Issue AVRTC 738 Avoid unintended reset when using wdt_disable Issue AVRTC 741 Backport Device specs changes in gcc 5 1 Issue AVRTC 742 Update library build option mtiny stack to msp8 Issue AVRTC 743 Update Documentation for memory sections that require __attribute___ used Issue AVRTC 747 Backport Alias entry to sqrt function Known issues Issue AVRTC 731 libgcc implementation has some known limitations Standard C Math library implementation is very limited or not present Issue AVRTC 732 Program memory images beyond 128KBytes are supported by the toolchain subject to the limitations mentioned in 3 17 4 1 EIND and Devices with more than 128 Ki Bytes of Flash at http gcc gnu org onlinedocs gcc AVR Options html Issue AVRTC 733 Named address spaces are supported by the toolchain subject to the limitations mentioned in 6 16 1 AVR Named Address Spaces at http gcc gnu org onlinedocs gcc Named Address Spaces htmlHAVR 20Named 20Address 20Spaces Atmel GNU Toolchain for Atmel AVR8 Embedded processors 3 5 0 1636 RELEAS
Download Pdf Manuals
Related Search