AVR 8-bit GNU Toolchain: Release 3.4.3.1072
Contents
1. AVR 8 bit GNU Toolchain Release 3 4 3 1072 Atmel 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 8 32 bits Atmel e A assembler linker and binutils GCC and Binutils and Standard C Microcontrollers About this release This is an update release that fixes some defects and upgrades GCC and binutils to Release higher versions 3 4 3 1 072 Atmel Atmel Installation Instructions System Requirements AVR 8 bit GNU Toolchain is supported under the following configurations 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 vvith less resources but may run satisfactorily depending on the number and size of the projects and the user s patience Softvvare 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 Fedora 13 or 12 x86 or x86 64 RedHat Enterprise Linux 4 5 6 Ubuntu Linux 10 04 or 8 04 x86 or x86 64 or SUSE Linux 11 2 or 11 1 x86 or x86 64 AVR 8 bit GNU Toolchain may very well work on other distributions However those would be untested and unsupported Downloading and Installing The package comes in two forms e As a standalone self extracting installer e2. Fix EVSYS QDIRM and EVSYS PRESCFILT issue for xmega E devices e PR 410 Add missing ADC CURRLIMIT definition for few xmega devices e PR 413 Add missing TWI peripheral definitions for ATMega16U4 e PR 425 Add missing definitions for xmega E5 devices e PR 465 Add missing register definitions for xmega 32E5 e PR 470 Remove TIMCTRL register from xmega 128A1U and E5 devices e PR 482 Add CRC module definitions for xmega D4 devices 8 AVR 8 bit GNU Toolchain AVR 8 bit GNU Toolchain e PR 494 Fix SMBUS parameter definitions for xmega E5 devices e PR 512 Add missing PCINTO 7 definitions for xmega 128 256 RFR2 Atmel 9 Atmel 10 AVR 8 bit GNU Toolchain AVR 8 bit GNU Toolchain Contact Information For support on AVR 8 bit GNU Toolchain please contact avr atmel com Users of AVR 8 bit GNU Toolchain are also welcome to discuss on the AVRFreaks website forum for AVR Software Tools Disclaimer and Credits AVR 8 bit GNU Toolchain is distributed free of charge for the purpose of developing applications for Atmel AVR processors Use for other purposes are not permitted see the software license agreement for details AVR 8 bit GNU Toolchain comes without any warranty Copyright 2013 Atmel Corporation All rights reserved ATMEL logo and combinations thereof Everywhere You Are AVR AVR32 and others are the registered trademarks or trademarks of Atmel Corporation or its subsidiaries Windows Internet Explorer an
3. Also there are additional libraries which allow a customization of the printf and scanf function families avr libc also contains the most 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 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 distribute atmel no tools opensource Atmel AVR GNU Toolchain 3 4 3 Please refer to the README for the instructions on how to use the supplied script to build the toolchain Atmel 5 Atmel New and Noteworthy This chapter lists new and noteworthy items for the AVR 8 bit GNU Toolchain release AVR 8 bit GNU Toolchain Supported Devices AVR 8 bit GNU Toolchain supports the following devices Note Devices which are newly supported in this release are marked with Toolchain avr2 at90s2313 at90s2323 at 9082333 at90s2343 attiny22 attiny26 at90s4414 at 9084433 at90s4434 at90s8515 at 90c8534 at90s8535 avr25 ata5272 ata6616c attiny13 attiny13a attiny2313 attiny2313a attiny24 attiny24a atti
4. atmega645a atmega645p atmega6450 atmega6450a atmega6450p atmega649 atmega649a atmega649p atmega6490 atmegal6 hva atmegal6hva2 atmega32hvb atmega6490a atmega6490p atmega64c1 atmega64m1l atmega64hve atmega64hve2 atmega64rfr2 atmega644rfr2 atmega32hvbrevb at 90can32 at 90can64 at90pwml161 at 90pwm216 at 90pwm316 at90scr100 at90usb646 at90usb647 at94k m3000 avr51 atmegal28 atmegal28a atmega1280 atmegal281 atmegal284 atmegal284p atmegal28rfal atmegal28rfr2 atmegal284rfr2 at90can128 at90usb1286 at90usb1287 avr6 atmega2560 atmega2561 atmega256rfr2 atmega2564rfr2 avr ata5831 avrxmega2 atxmega8e5 atxmegal6a4 atxmegal6adu atxmegal6c4 atxmegal6d4 atxmegal6e5 atxmegal6x1 atxmega32a4 atxmega32a4u atxmega32c3 atxmega32c4 atxmega32d3 atxmega32d4 atxmega32e5 avrxmega4 atxmega64a3 atxmega64a3u atxmega64a4u atxmega64b1 atxmega64b3 atxmega64c3 atxmega64d3 atxmega64d4 avrxmega5 atxmega64al atxmega64alu avrxmega6 atxmegal28a3 atxmegal28a3u atxmegal28bl atxmegal28b3 atxmegal28c3 atxmegal28d3 atxmegal28d4 atxmegal 92a3 atxmegal92a3u atxmegal92c3 atxmegal92d3 atxmega256a3 atxmega256a3b atxmega256a3bu atxmega256a3u atxmega256c3 atxmega256d3 atxmega384c3 atxmega384d3 avrxmega7 atxmegal28al atxmegal28alu atxmegal28a4u avrtiny attiny4 attiny5 attiny9 attiny10 attiny20 attiny40 Atmel 7 Atmel avr1 at90s1200 attiny11 attinyl2 attinyl5 attiny28 Known Issues e Support for AVR Tiny architecture ATTiny 4 5 9 10 20 40 has known limitat
5. d Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and or other countries Linux is the registered trademark of Linus Torvalds in the United States and other countries Built on Eclipse is a trademark of Eclipse Foundation Inc Sun and Java are registered trademarks of Sun Microsystems Inc in the United States and other countries Mozilla and Firefox are registered trademarks of the Mozilla Foundation Fedora is a trademark of Red Hat Inc SUSE is a trademark of Novell Inc Other terms and product names may be the trademarks of others Atmel 11
6. ibc 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 cciplus 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 operators expression syntax is derived from the common assemble
7. ions e libgcc implementation has some known limitations e Standard C Math library implementation are very limited or not present e 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 e 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 html AVR 20Named 20Address 20Spaces Updates and Issues Fixed avr gcc e Updated to gcc 4 8 1 e Configured with with avrlibc yes e Set default DWARF version to 2 e Backported bug fixes e Backported testsuite fixes for AVR target e FIX Emit error for negative values in alignment specifiers avr binutils e Updated to binutils 2 23 2 e PR 618 Place trampolines before progmem section in all linker scripts avr libc e PR 683 Fix data load issue for xmega devices in PF functions e PR 684 Swap order of SPH SPL write for XMEGA in startup code e Bug fixes submitted to mailing list are integrated e Backported avr libc trunk bugfixes Headers e PR 187 Add ADC_CH_GAIN_DIV2_gc for most XMEGA D3 D4 devices e PR 340 Remove USARTF1 from xmega 256a3b and 256a3bu e PR 374 Update power macro definitions for xmega 64 128 192 256 D3 devices e PR 382 Fix PCMSK issue for ATtiny1634 e PR 400
8. log enter the name and path to the toolchain executable For example if its AVR8 select the path till avr gcc exe and click OK Oo OO If you want support for other architecture language please remember to repeat the exercise by choosing the correct Toolchain within the Package configuration tab Now you are done with configuring a toolchain for use from within Atmel Studio To configure a project to use this toolchain do the following 1 Open the project in Atmel Studio 6 0 or later 2 Right click the project go to Properties gt Advanced tab 3 Select the toolchain you configured in the previous step Now build the project and the toolchain should be picked from the configured location Installing on Linux On Linux AVR 8 bit 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 where you want the toolchain to run from Upgrading from previous versions Upgrading is not supported with the installer But you are allowed to have any number of versions of the toolchain in your machine If it is installed via Atmel Studio it can be upgraded through the extension manager in Atmel Studio See Atmel Studio release notes for more information On Linux if you have it unpacked to a local folder you just delete the old folder and unpack the latest version in a new folder Layout Listed below are some directories you might want to know abou
9. ny4313 attiny44 attiny44a attiny441 attiny84 attiny84a attiny25 attiny45 attiny85 attiny261 attiny26la attiny461 attiny46la attiny861 attiny86la attiny43u attiny87 attiny48 attiny88 attiny828 attiny841 at86rf4a01 avr3 at43usb355 at76c711 avr31 atmegal03 at43usb320 avr35 ata5505 ata6617c ata664251 at90usb82 at90usb162 atmega8u2 atmegal6u2 atmega32u2 attiny167 attiny1634 avr4 ata6285 ata6286 ata6289 ata6612c atmega8 atmega8a atmega48 atmega48a atmega48p atmega48pa atmega88 atmega88a atmega8 8p atmega88pa atmega8515 atmega8535 atmega8hva at90pwml at 90pwm2 at 90pwm2b at 90pwm3 at 90pwm3b at90pwm81 avr5 6 AVR 8 bit GNU AVR 8 bit GNU Toolchain ata5790 ata5790n ata5795 ata6613c ata6614q atmegal6 atmegal6a atmegal61 atmegal62 atmegal63 atmegal64a atmegal64p atmegal64pa atmegal65 atmegal65a atmegal65p atmegal65pa atmegal68 atmegal68a atmegal68p atmegal68pa atmegal69 atmegal69a atmegal69p atmegal69pa atmegal6 hvb atmegal hvbrevb atmegal mi atmegal6u4 atmega32a atmega32 atmega323 atmega324a atmega324p atmega324pa atmega325 atmega325a atmega325p atmega325pa atmega3250 atmega3250a atmega3250p atmega3250pa atmega328 atmega328p atmega329 atmega329a atmega329p atmega329pa atmega3290 atmega3290a atmega3290p atmega3290pa atmega32cl atmega32m1 atmega32u4 atmega32u6 atmega406 atmega64 atmega64a atmega640 atmega644 atmega644a atmega644p atmega644pa atmega645
10. r 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 Id The Linker avr ar Create modify and extract from archives libraries avr ranlib Generate index to archive library contents avr objcopy Copy and translate object files avr objdump Display information from object files including disassembly e avr size List section sizes and total size avr nm List symbols from object files 4 AVR 8 bit GNU Toolchain AVR 8 bit GNU Toolchain e avr strings List printable strings from files e avr strip Discard symbols e avr readelf Display the contents of ELF format files e avr addr2line Convert addresses to file and line e avr c 4filt Filter to demangle encoded C symbols 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 MCUs 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 Thus it is a good idea to always include the Im linker option
11. t lt install_dir gt The directory where you installed AVR 8 bit GNU Toolchain e lt install_dir gt bin e The AVR software development programs This directory should be in your PATH environment variable This includes e GNU Binutils e GCC e lt install_dir gt avr lib e avr libc libraries startup files linker scripts and stuff e lt install_dir gt avr include e ayvr libc header files for AVR 8 bit e lt install_dir gt avr include avr e 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 e GCC libraries other libraries headers and stuff e lt install_dir gt libexec Atmel 3 Atmel e GCC program components e lt install_dir gt doc e Various documentation 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 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 CAUTION There are caveats on using C See the avr l
12. xe e As Atmel Studio Toolchain Extension It may be downloaded from Atmel s website at http www atmel com or from the Atmel Studio Extension Gallery http gallery atmel com Installing on Windows In order to install using standalone installer the AVR Toolchain installer can be downloaded from Atmel website After downloading the installer double click the executable file to install It will ask for a location to install and when entered it will extract the toolchain binaries into the corresponding location This will not add the toolchain path to the system environment variable PATH The user has to do it manually Any number of installations is possible on a single machine To uninstall please remove the directory from the file system In order to install as extension please refer to Atmel Studio documentation Configuring the toolchain in Atmel Studio If you plan to use the standalone installer outside Atmel Studio you can skip this section To configure a standalone toolchain installation to be used inside Atmel Studio environment do the following 1 Install the toolchain using the standalone self extracting installer 2 From Atmel Studio 6 0 or later go to Tools menu gt Options 2 AVR 8 bit GNU Toolchain AVR 8 bit GNU Toolchain From the dialog select Toolchain s Package Configuration From the right pane select nature of the toolchain e x AVR8 for C ARM for C etc Click Add Flavour From the dia
Download Pdf Manuals
Related Search