Back to main page

# AVR®32 AT32AP7000 Series Software Framework: the UTILS folder

Copyright © 2006-2008 Atmel Corporation

## Introduction

This directory contains files that are used by all other directories of the framework: it holds several linker script files, IAR & GCC pre-compiled libraries of some Software Framework modules, and C/C++ files with general usage defines, macros and functions.

## UTILS folder Description

This directory consists of the following contents:

### compiler.h

This file defines commonly used types and macros.

### AVR32_HEADER_FILES folder

This module gathers a set of header files for the avr32-gcc Gnu Compiler Collection (see the AVR32_Header_Files_for_AVR32-GCC.zip file) and a set of header files for the IAR IDE (see the AVR32_Header_Files_for_IAR_EWAVR32_2.21A.zip file).

For installation of these header files, see the installation page.

### DEBUG folder

This module gathers a set of useful functions to print data on the USART.

print_funcs.h is the interface of this module and print_funcs.c is its implementation.

### PREPROCESSOR folder

This module gathers a set of useful C preprocessor macros. It is composed of the files

- mrepeat.h: C preprocessor repeating set of macros,
- preprocessor.h: include of all header files of this module (so that applications only use to include this file),
- stringz.h: C preprocessor stringenizer set of macros,
- tpaste.h: C preprocessor token manipulation set of macros.

### NEWLIB_ADDONS folder

The AVR32 GNU Toolchain v2.1 has removed some newlib addons files that were present in the previous versions: exceptions, interrupts and usart support. To minimize the effect on the Software Framework and on customers, these files have been added in the Software Framework as a module named NEWLIB_ADDONS. The NEWLIB_ADDONS module is organized as follows:
- under UTILS/NEWLIB_ADDONS/ the src code,
- under UTILS/NEWLIB_ADDONS/Build the scripts to build the libraries,
- under UTILS/LIBS/NEWLIB_ADDONS/INCLUDE the nlao interface header files.
- under UTILS/LIBS/NEWLIB_ADDONS/ the archive libs for AT32AP7, AT32UCR1, AT32UCR2:

- libnewlib_addons-at32xxxx-debug archive lib generated with -O0 -g (for debug)
- libnewlib_addons-at32xxxx archive lib generated with -O0 (no optimization)
- libnewlib_addons-at32xxxx-balanced_opt archive lib generated with -O2 (medium level optimization)
- libnewlib_addons-at32xxxx-speed_opt archive lib generated with -O3 (speed optimization)
- libnewlib_addons-at32xxxx-size_opt archive lib generated with -Os (size optimization)

AVR is a registered trademark of Atmel Corporation.