AVR 8-bit GNU Toolchain: Release 3.4.0.663
Contents
1. AVR 8 bit GNU Toolchain Release 3 4 0 663 Alin L 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 and Standard C library AVRLibC 8 32 bit AMR Microcontrollers Release 3 4 0 663 AMEL AMEL 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 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 or Windows 7 x86 or x86 64 Fedora 13 or 12 x86 or x86 64 RedHat Enterprise Linux 4 or 5 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 as well work on the other distributions However those would be untested and unsupported AVR 8 bit GNU Toolchain is not supported on Windows 98 NT or ME Downloading and Installing The package comes in two forms As part of a standalone installer avr toolchain installer e As part of Atmel Studio 6 Installer This can be downloaded from Atmel s website at htto www2. 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 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 avr as The Assembler e avr ld The Linker e 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 avr size List section sizes and total size avr nm List symbols from object files e avr strings List printable strings from files avr strip Discard symbols avr readelf Display the contents of ELF format files avr addr2line Convert addresses to file and line 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
3. Copyright 2006 2012 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 and 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 AIMEL 9
4. in lt math h gt and a bit more Thus it is a good idea to always include the Im linker option Also there are additional libraries which allow a customization of the printf and scanf function families 4 AVR 8 bit GNU Toolchain AVR 8 bit GNU Toolchain 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 6 provides a debugger and also provides simulators for the parts that can be used for debugging as well Note that Atmel Studio 6 is currently free to the public but it is not Open Source AIMEL 5 New and Noteworthy AMEL 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 t90s2313 t90s4414 ta5272 ta6286 ttiny2313a tiny828 tiny261 tiny43u 76c711 mega l6u2 mega48 mega88p 90pwm2 megal6 megal64p megal68 megal69a megal 6hvbrevb mega324a mega325pa mega328p mega3290a mega32u6 mega644p mega6450a mega6490a mega64hve 90pwm316 mes ms mn gt En IL RL IE EEL UE ER EL amp IA amp D EEL I EL p 6 AVR 8 bit GNU t90s2323 t9
5. 0s4433 ta5505 ta6289 tiny24a tiny84 tiny26la tiny87 mega103 mega32u2 mega48a mega88pa 90pwm2b megal6a megal64pa megal68a megal69pa tmegal 6u4 mega324p mega3250 mega329 mega3290p mega406 mega644pa mega6450p mega6490a mega32hvb megal6 cl a Q QD 9 D ow pp Toolchain voup yy yy ypy yp OO D Q amp OV QD OV amp p t90s2333 t90s4434 ta5790 ttinyl3 tiny4313 tiny25 tiny46la tiny88 90usb82 tiny1634 mega48pa mega8515 90pwm3 megal61 egal65 egal68p egal6hva ega32 ega325 ega3250p ega329p ega32cl ega640 ega645p ega649a ega64a ega32hvbrevb ega32cl ooonornononoownowowvwoenowowew onvoowew oovwoeoeoweoowoeoa ow t90s2343 t90s8515 Eas 795 ttinyl3a tiny44 tiny45 tiny861 86rf401 90usb162 mega 8 mega 88 mega8hva 90pwm8 1 megal63 megal65a megal68pa megal6hva2 mega32a mega325a mega3250pa mega329pa mega32m1 mega644 mega645 mega649p mega64cl 90can64 megal6m1 voup yy yy ypy yp yoy uoy uoy uyup uyy yp ypy yyy Ar OUT AE EE CE UT CEEE OF OUT AE EF CEPE OUT OT AE OP UF CE OUT EF UT EE EE UF OUT EF tiny22 90c8534 a6285 tiny2313 tiny44a tiny85 tiny86la 43usb355 mega8u2 mega8a mega88a 90pwml 90pwml1 61 megal64a megal65pa megal69 megal6hvb mega323 mega325p mega328 mega3290 mega32u4 mega644a mega6450 mega6490 mega64m1 90pwm216 mega32m1 AVR 8 bit GNU Toolchain atmegal6u4 atmega32u4
6. ard Library for AVR 8 bit 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 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 avr 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 e GCC program components e lt install_dir gt doc e Various documentation e lt install_dir gt source e Documentation on where to find the source code for the various projects and source code patches that were used to build the tools Toolset Background AVR 8 bit GNU Toolchain is a collections of executable open source software development tools for the Atmel AVR 8 bit series of Micro Controller Units MCU 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 config
7. at90scr100 at90usb646 at90usb647 at94k m3000 atmegal28a atmega1280 atmegal281 atmegal284 atmegal284p atmegal28rfal at90can128 at 90usb1287 atmega2560 atmega2561 atxmegal6a4 atxmegal6a4u atxmegal6d4 atxmega32a4 atxmega32a4u atxmega32d4 atxmega32x1 atxmega64a3 atxmega64a3u atxmega64d3 atxmega64alu atxmega64a4u atxmega64bl atxmega64b3 atxmega64c3 atxmegal28a3 atxmegal28a3u atxmegal28b1 atxmegal28b3 atxmegal28d3 atxmegal28d4 atxmegal92a3 atxmegal92a3u atxmegal92c3 atxmega256a3 atxmega256a3b atxmega256a3bu atxmega256a3u atxmega256d3 atxmegal28al attiny4 attiny5 attiny9 attiny10 attiny20 at90s1200 attinyll attiny12 attinyl5 Component Upgrades Binutils upgraded to 2 22 from 2 20 1 GCC upgraded to 4 6 2 from 4 5 1 AVR LibC upgraded to 1 8 0 from 1 7 1 Known Issues AVR Tiny Architecture ATTiny 4 5 9 10 20 40 support has some limitations This is expected to be fixed soon Some notable known issues are e libgcc implementation has some known limitations e Standard C Math library implementation are very limited or not present e Attribute signal has some known issues Support for ATtiny1634 does not include clock_prescaler_set and wdt_enable macros Program memory beyond 128KBytes is not efficiently supported for Mega and Xmega devices Improvements PR 259 Support for Xmega RMW instructions lat las lac xch PR 232 Dwarf2 CFI Call frame information generation Issues Fixed PR 441 Undefined Reference to __ BV error when set_slee
8. atmel com Installing on Windows Atmel Studio 6 installation procedure will also install AVR Toolchain See Atmel Studio 6 release notes for more information 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 You may use Custom Installation in order to install in a specific 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 If it is installed via Atmel Studio 6 it will be upgraded through the Atmel Studio 6 upgrade See Atmel Studio 6 release notes for more details 2 AVR 8 bit GNU Toolchain AVR 8 bit GNU Toolchain If you used the standalone installer on MS Windows you might do a clean upgrade by first un installing the old version or just upgrade using the latest installer 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 Manifest 1 AVR 8 bit GNU Binutils 2 22 e Binary utilities for AVR 8 bit target including assembler linker etc 2 AVR 8 bit GNU Compiler Collection avr gcc 4 6 2 e C language and C language compiler for AVR 8 bit target 3 AVRLibC 1 8 0 e C Stand
9. p_mode is called for specific devices This is now corrected PR 424 Linker error relocation truncated to fit RLAVR_13_PCREL against symbol XXX defined in YYYY section in ZZZ o issued as wrong candidates are taken for relaxation This issue is now fixed PR 419 Segmentation fault when linker relaxation is enabled This is caused since the relocations were not read properly side effect of a change done for binutils PR Id 12161 This is now fixed PR 206 Incomplete support in power h for specific devices are corrected PR 195 The clock_prescale_set function is implemented for tiny devices PR 381 Calling _delay_ms function causes the compiler to crash after showing error for ATtiny10 This is now fixed PR 193 Support LDS STS 16 bit variants as per AVR8L specifications in assembler linker and disassembler PR 444 Support config section for ATTiny 4 5 9 10 20 40 AIMEL 7 AMEL 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
10. ured for multiple different languages front ends AIMEL 3 AMEL The GCC included in AVR 8 bit GNU Toolchain is targeted for the AVR 8 bit MCUs and is configured to compile C or C CAUTION There are caveats on using C See the avr libc FAQ 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
Download Pdf Manuals
Related Search