AVR32 UC3 Software Framework User Manual
Contents
1. Web Site http www atmel com 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 ATMEL S TERMS AND CONDI TIONS OF SALE LOCATED ON ATMEL S WEB SITE 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 INCIDEN TAL DAMAGES INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF 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 product descriptions 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 s products are not intended authorized or warranted for2. 78 FAX 852 2722 1369 Japan Atmel Japan K K 9F Tonetsu Shinkawa Bldg 1 24 8 Shinkawa Chuo ku Tokyo 104 0033 Japan TEL 81 3 3523 3551 Atmel Operations Memory Atmel Corporate 2325 Orchard Parkway San Jose CA 95131 TEL 1 408 436 4270 FAX 1 408 436 4314 Microcontrollers Atmel Corporate 2325 Orchard Parkway San Jose CA 95131 TEL 1 408 436 4270 FAX 1 408 436 4314 Atmel Nantes La Chantrerie BP 70602 44306 Nantes Cedex 3 France TEL 33 2 40 18 18 18 FAX 33 2 40 18 19 60 ASIC ASSP Smart Cards Atmel Rousset Zone Industrielle 13106 Rousset Cedex France TEL 33 4 42 53 60 00 FAX 33 4 42 53 60 01 Atmel Colorado Springs 1150 East Cheyenne Min Blvd Colorado Springs CO 80906 TEL 1 719 576 3300 RF Automotive Atmel Heilbronn Theresienstrasse 2 Postfach 3535 74025 Heilbronn Germany TEL 49 71 31 67 0 FAX 49 71 31 67 2340 Atmel Colorado Springs 1150 East Cheyenne Min Blvd Colorado Springs CO 80906 TEL 1 719 576 3300 FAX 1 719 540 1759 Biometrics Imaging Hi Rel MPU High Speed Converters RF Data com Atmel Grenoble Avenue de Rochepleine BP 123 38521 Saint Egreve Cedex France TEL 33 4 76 58 30 00 FAX 33 4 76 58 34 80 FAX 81 3 3523 7581 FAX 1 719 540 1759 Atmel Smart Card ICs Scottish Enterprise Technology Park Maxwell Building East Kilbride G75 OQR Scotland TEL 44 1355 803 000 FAX 44 1355 242 743 e mail literature atmel com
3. AVR32 UC3 Software Framework User Manual AMEL T AMEL 1 1 1 2 Features Introduction Section 1 AVR32 UC3 Software Framework W Drivers for each AVR 32 UC3 peripheral E Software libraries optimized for AVR32 B Hardware components drivers B Demo applications that use all libraries B RTOS ready source code B Complete software framework in C code E Full projects compatible with GNU GCC and IAR Embedded Workbench B High level user documentation including examples getting started and tutorials B Designed to run on AVR32 UC3 evaluation kits and easily portable to any other hardware platform B Designed to help develop software applications for AVR32 UC3 microcontroller This document describes the software framework developed for the Atmel AVR32 UC3 microcontrollers This framework provides software drivers and libraries to build any application for AVR32 UC3 devices This framework has been carefully developed to help develop and glue together the dif ferent components of a software design It also has been designed to be easily integrable into an operating system OS as well as to operate in a stand alone way AVR32 UC3 Software Framework User Manual 7732A AVR32 05 07 AVR32 UC3 Software Framework 1 3 Framework Description The framework is divided into several modules Each module is provided with full source code example of usage rich HTML documentation and ready to use project for the
4. IAR EWAVR32 and the GNU GCC compilers Figure 1 Block Diagram Overview UC3 COMPONENTS Software Framework BOARDS DRIVERS AT32UC3 Target Board 1 3 1 1 3 2 1 3 3 1 3 4 1 3 5 1 2 UC3 Drivers directory DRIVERS Software Services directory SERVICES Hardware Components directory COMPONENTS C C Utilities directory UTILS Demo Applications directory APPLICATIONS 7732A AVR32 05 07 This directory contains software drivers such as ADC GPIO or Timer peripherals Each driver is composed of a driver c and driver h file that provides low level functions to access the peripheral This directory provides application oriented piece of software such as a USB mass stor age class a FAT file system and an optimized DSP library This directory provides software drivers to access hardware components such as exter nal memory e g Atmel Dataflash or SDRAM or LCD This directory provides several linker script files and C C files with general usage defines macros and functions This directory provides application examples that are based on services components and drivers modules AIMEL AVR32 UC3 Software Framework User Manual AVR32 UC3 Software Framework 1 4 Framework Usage 1 4 1 Installation Download the AT32UC3X SoftwareFramework x y z zip Extract it to a local directory Open AVR32_Readme html file in the root directory The framework contai
5. TIONS MYAPPLICATION directory Note The DRIVERS USART EXAMPLE is also a simple ready to use project that you can start from Rename the gpio example c file to myapplication c file Implement the application as defined in step1 Modify the GCC or IAR project to match this new application Note You will find one or several of examples in each module 1 DRIVERS PM EXAMPLE 1 and DRIVERS PM EXAMPLE2 2 IDRIVERS USART USART EXAMPLE and DRIVERS USART MODEM EXAMPLE 3 DRIVERS GPIO EXAMPLE Note The COMPONENTS MEMORY DATA FLASH ATA5DBX EXAMPLE directory con tains an example of this application All IAR projects are compatible with the latest available version of IAR Embedded Work bench for AVR32 All GNU GCC projects are provided with stand alone makefile The projects are designed to run on AVR32 UC3 evaluation kits All the projects contain board definition files to ease portability to any other hardware platform that use a AVR32 UC3 microcontroller AVR32 UC3 Software Framework User Manual AIMEL 1 5 7732A AVR32 05 07 AIMEL EE O Atmel Headquarters Corporate Headquarters 2325 Orchard Parkway San Jose CA 95131 TEL 1 408 441 0311 FAX 1 408 487 2600 Europe Atmel SarL Route des Arsenaux 41 Casa Postale 80 CH 1705 Fribourg Switzerland TEL 41 26 426 5555 FAX 41 26 426 5500 Asia Atmel Asia Ltd Room 1219 Chinachem Golden Plaza 77 Mody Road Tsimhatsui East Kowloon Hong Kong TEL 852 2721 97
6. gram config nk make configuration file included by the Makefile file contains the list of source files and compilation link options gdb cmdfile txt configuration file for the avr32 gdb program Usage avr32 qdb x gdb_cmdfile txt or ddd debugger avr32 gdb command gdb_cmdfile txt l IAR this directory holds IAR specific files adc_example ewd IAR EWAYR32 debug configuration file adc example ewp IAR EVAVR32 project file adc example eww IAR EWAVR3Z workspace file DOC this directory holds all automatically generated documentation htnul lt adc jpg a image that will be integrated in the automatically generated documentation l adc_example c the implementation of the example documentation h the entry point source of doxygen documentation doxyfile doxygen the doxygen configuration file readme html the entry point of all automatically generated documentation 5 directories 50 files 1 4 3 Building an Application with the Framework Step1 Defining the application Let s take an example to build an application the Atmel AT45DB dataflash is a memory that is present on EVK1100 evaluation kit It is connected to the SPI interface of the AVR32 UC3A microcontroller We want to access this memory and perform a basic san ity check Step2 Identifying the bl
7. ns rich html documentation for all directories and files Navigate through the documentation Check the installation section first Note There is a uc3softwareframework releasenote txt file in the root directory This file con tains all information regarding the revision management of the software framework 1 4 2 Directory Below is an example on what the complete AVR32 UC3 software framework folder Architecture should look like after a successful and complete installation Figure 2 AVR32 UC3 Software Framework Architecture Ei YOUR LOCAL FOLDER El AT32UC3X Y Z O doesrc E C _AVA32STUDIO_WORKSPACE E APPLICATIONS t BOARDS t COMPONENTS DRIVERS E SERVICES amp UTILS Here is the content of the ADC driver directory to introduce the typical organization of a software driver AVR32 UC3 Software Framework User Manual AIMEL 1 3 7732A AVR32 05 07 AVR32 UC3 Software Framework Figure 3 Module File Architecture ADC the name of the controller is usually used as the directory name adc c the implementation of the software driver API adc h the software driver API EXAMPLE the EXAMPLE directory holds one example of usage of this software driver API AT32UC3 this directory holds all AT32UC3 family build files GCC this directory contains gcc specific files Makefile gcc make makefile uc3a0512 adc_example elf target downloadable elf file Use avr3Zpro
8. ocks AT45DB We are going to use the AT45DB driver it is a hardware component it will be under the COMPONENTS directory It is a memory component it will be stored under the COMPONENTS MEMORY directory It is a dataflash memory type It will be located under the COMPONENTS MEMORY DATA FLASH directory It is an AT45DBX type of dataflash The driver will be located under the COMPONENTS MEMORY DATA FLASH AT45DBX directory Power manager to start the external oscillator clock It is a AVR32 UC3 peripheral The power manager driver is located under the DRIVERS PM directory e RS232 the USART will be used as an output for the memory test It is located under the DRIVERS USART directory GPIO we will need to configure the UCS IO to be used by the peripherals It is located under the DRIVERS GPIO directory Debug we will need format printing functions to print messages to the RS232 The debug module is located under the UTILS DEBUG directory The application itself will be located under the APPLICATIONS MYAPPLICATION 1 4 AIMEL AVR32 UC3 Software Framework User Manual 7732A AV R32 05 07 Step3 Building the project 1 5 Tools 1 5 0 1 IAR 1 5 0 2 GNU GCC and AVR32Studio 1 5 0 3 Evaluation Kit AVR32 UC3 Software Framework We need to create a new project for this application In order not to start from scratch we are going to reuse a simple project Copy the DRIVERS GPIO EXAMPLE content to the APPLICA
9. use as components in applications intended to support or sustain life 2007 Atmel Corporation All rights reserved Atmel logo and combinations thereof DataFlash and others are registered trademarks or trademarks of Atmel Corporation or its subsidiaries Other terms and product names may be trademarks of others 7732A AVR32 05 07 xM
Download Pdf Manuals
Related Search