Release Notes - AVR32 UC3 Software Framework -------------------------------------------- Release version: 1.2.2ES Release date: 2008-12-04 AVR32-SoftwareFramework-1.2.2ES-AT32UC3A: This package supports UC3A devices revision E. AVR32-SoftwareFramework-1.2.2ES-AT32UC3B: This package supports UC3B devices revision B. All UC3A revE devices are marked "32UC3Axxxx-xES", later revisions are marked with "32UC3Axxxx-X". Revisions above E fix most of the errata of the 32UC3Axxxx-xES parts. Please refer to the device datasheets for more details on the errata. All UC3B revB devices are marked "32UC3Bxxxx-xES", later revisions are marked with "32UC3Bxxxx-X". Revisions above B fix most of the errata of the 32UC3Bxxxx-xES parts. Please refer to the device datasheets for more details on the errata. It is possible to identify the silicon revision from the top side marking of the package. If your device is marked with "32UC3Axxxx-xES", it is a revision E. If your device is marked with "32UC3Axxxx-X", you should go to www.atmel.com and download the appropriate AVR32 Software Framework. Supported tools: # AVR32 GNU Toolchain (2.1.3) with GCC version: 4.2.2-atmel.1.1.2 (mingw32 special) # AVR32Studio Version: 2.1.0 # IAR EWAVR32 v3.10A with updated header files (unzip the UTILS/AVR32_HEADER_FILES/AVR32_Header_Files.zip under /Embedded Workbench 4.0/avr32/inc/). 1 Overview ---------- The AVR�32 AT32UC3 Software Framework consists of AVR�32 UC3 microcontroller drivers, software services & libraries, and demonstration applications. Each software module is provided with full source code, example of usage, rich html documentation and ready-to-use projects for the IAR EWAVR32 and GNU GCC compilers. 2 Downloading and Installing ---------------------------- The software can be found on the AVR32 Technical Library CD, or downloaded from Atmel's website at http://www.atmel.com/products/AVR32/ under the "Tools & Software" menu. Unzip the package zip file (AVR32-SoftwareFramework-AT32UC3*-1.2.1ES-.zip) under a local folder on your PC. Open the \AT32UC3*-1.2.1ES-\AVR32_Readme.html file to browse through the documentation. 3 Contents ----------- The following tables describe the availability of framework modules per AVR32 UC3 series. |-------------------------------------| UC3A | UC3B | |APPLICATIONS-------------------------|------|------| | EVK1100-CONTROL-PANEL | x | | | EVK1101-DEMO | | x | |-------------------------------------|------|------| |-------------------------------------| UC3A | UC3B | |BOARDS-------------------------------|------|------| | EVK1100 | x | N/A | | EVK1101 | N/A | x | |-------------------------------------|------|------| |-------------------------------------| UC3A | UC3B | |DRIVERS------------------------------|------|------| | ADC | x | x | | CPU / CYCLE_COUNTER | x | x | | EBI / SDRAMC | x | N/A | | EIC | x | x | | FLASHC | x | x | | GPIO | x | x | | INTC | x | x | | MACB | x | N/A | | PDCA | x | x | | PM | x | x | | PWM | x | x | | RTC | x | x | | SPI | x | x | | SSC | x | x | | TC | x | x | | TWI | x | x | | USART | x | x | | USBB | x | x | |-------------------------------------|------|------| |-------------------------------------| UC3A | UC3B | |COMPONENTS---------------------------|------|------| | ACCELEROMETER / LIS3L06AL | | x | | DISPLAY / DIP204 | x | | | JOYSTICK | x | x | | MEMORY / DATA_FLASH | x | x | | MEMORY / SD-MMC | x | x | | MEMORY / SDRAM / MT48LC16M16A2TG7E | x | N/A | |-------------------------------------|------|------| |-------------------------------------| UC3A | UC3B | |SERVICES-----------------------------|------|------| | DSPLIB | x | x | | FAT | x | x | | FREERTOS | x | x | | LWIP | x | | | MEMORY / CTRL_ACCESS | x | x | | USB / CLASS / AUDIO | x | x | | USB / CLASS / CDC | x | x | | USB / CLASS / DFU | x | x | | USB / CLASS / HID | x | x | | USB / CLASS / MASS_STORAGE | x | x | |-------------------------------------|------|------| |-------------------------------------| UC3A | UC3B | |UTILS--------------------------------|------|------| | AVR32_HEADER_FILES | x | x | | DEBUG | x | x | | LIBS / DRIVERS | x | x | | LIBS / DSPLIB | x | x | | LINKER_SCRIPTS | x | x | | PREPROCESSOR | x | x | | STARTUP_FILES | x | x | |-------------------------------------|------|------| 4 News ------ This section describes the changes between the 1.2.1ES and the 1.2.2ES releases. 4.1 New Features * Added the NEWLIB_ADDONS module: The AVR32 GNU Toolchain v2.1 has removed some newlib addons files that were present in the previous versions: exceptions, interrupts, usart support. To minimize the effect on the SF and on customers, these files have been added in the SF as a module named NEWLIB_ADDONS. All projects in the SF have been updated to be compliant with the AVR32 GNU toolchain v2.1. 4.2 Notable Bug Fixes and Improvements * All : Updated files to support the latest GNU tool chain and Newlib addon. * COMPONENTS\DISPLAY\DIP204\EXAMPLE\dip204_example.c: fix volatile keyword on TimeOut variable. * SERVICES/USB/CLASS/DFU/EXAMPLES/ISP/: -> boot.S & boot.s82: # Updated due to header files update. * UTILS/compiler.h: Updated due to header files update. * UTILS/AVR32_HEADER_FILES/AVR32_Header_Files.zip: updated. * UTILS/LIBS/: -> Libraries rebuilt with the latest compilers. -> added for backward compatibility support of the AVR32 GNU toolchain v2.1 release. In addition to these fixes, the documentation has been improved and updated. 4.3 Known Bugs and Limitations * /SERVICES/FAT/fsaccess.c: For the 1.2.1ES Software Framework packages, the open() and fsaccess_IsDirPresent() functions have hard-coded references to the LUN_ID_AT45DBX_MEM memory (i.e. the AT45DBX Atmel DataFlash). This file is thus not usable for memories other than the AT45DBX Atmel DataFlash. * /SERVICES/FREERTOS/: IAR: DLIB functions are not compiled for multithreading. -> Standard library functions like malloc, printf, etc. using global resources should not be called from tasks. * SERVICES/FREERTOS/Demo/AVR32_UC3: the AVR32_UC3 demo doesn't work on UC3 parts with less than 64kB of RAM (because the heap is not big enough for the number of simultaneous running tasks). * SERVICES/USB/CLASS/MASS_STORAGE/EXAMPLES/MASS_STORAGE_EXAMPLE_FREERTOS/AT32UC3B0256/GCC/ crashes due to lack of heap space. * Some software modules do not provide EXAMPLE subdirectories (e.g. /DRIVERS/SPI/). * The avr32-gcc/avr32-ld linker generates warnings at link time. Check the explanation in the FAQ under /.docsrc/AVR32_Faq.html in the section titled "What is the meaning of the warning "LD `allocated section not in segment'"". * The flashc driver example (DRIVERS/FLASHC/EXAMPLE) does not work on AT32UC3A0512 and AT32UC3A1512 parts for Revision E, H and I. * The header files of the Software modules are not C++-ready. * The AVR32Studio Managed Make tutorial doesn't work if it is loaded with the USB bootloader. * The AVR32Studio tutorial is not up-to-date with the latest AVR32Studio 2.0 release. * APPLICATIONS/EVK1100-CONTROL-PANEL: the file date is not set when copying files between USB key to/from Control Panel. * DRIVERS/MACB: The MACB software driver interrupt handler is implemented to use the AVR32_INTC_INT2 interrupt level. * DRIVERS/TWI: -> The TWI software driver interrupt handler is implemented to use the AVR32_INTC_INT2 interrupt level. -> do not use the twi_probe() function. * DRIVERS/ADC: -> in the example, the ADC input clock is at 6MHz while the ADC-Characteristics (datasheet) specify a maximum Clock-Frequency of 5 Mhz. -> the ADC software driver doesn't allow the user to configure the ADC settings. * DRIVERS/RTC: the RTC software driver initializes the 32-kHz oscillator; this init has to be done, but it doesn't belong in the RTC software driver. 5 Contact Information --------------------- For support on the UC3 Software Framework please see http://support.atmel.no/. 6 Copyright (c) 2008, Atmel Corporation All rights reserved. ------------------------------------------------------------ Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The name of ATMEL may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY ATMEL ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.