Atmel UC3-L0 Xplained Installation and operating instructions

Atmel AVR32931: UC3-L0 Xplained Getting
Started Guide
Features
• Easy to reprogram with just a USB cable and a preprogrammed bootloader
• Easy to debug code with JTAG-based debugger and emulator
• Can be used with Atmel®AVR®JTAGICE mkII, Atmel AVR Dragon™, and Atmel
AVR ONE!
1 Introduction
The Atmel UC3-L0 Xplained evaluation kit is a hardware platform for evaluating the
Atmel AT32UC3L064 microcontroller.
The kit offers a range of features that enable the Atmel AVR UC3 user to get
started using UC3 peripherals right away and understand how to integrate the UC3
device in their own design. This getting started guide describes all the basic steps
needed to start using the UC3-L0 Xplained evaluation kit.
Figure 1-1. UC3-L0 Xplained evaluation kit.
32-bit Atmel
Microcontrollers
Application Note
Rev. 32162A-AVR-03/11

2 Atmel AVR32931 32162A-AVR-03/11
2 What is needed to get started?
To be able to run the preprogrammed code, the Atmel UC3-L0 Xplained evaluation kit
and a USB cable (Standard-A to Mini-B, or Mini-AB) are needed to connect the board
to a PC.
When connecting the UC3-L0 Xplained to a PC, the operating system will request a
driver file for installing the serial communication driver. This driver file is available in
the zip file associated with this document. The driver file supports both 32-bit and 64-
bit versions of the Windows® XP and Windows7 operating systems. Driver installs are
not necessary on Linux®operating systems.
To modify the example code or write new code and compile it, a toolchain for Atmel
AVR microcontrollers and an IDE are needed to edit and debug code. Atmel provides
both Atmel AVR32 Studio and the Atmel AVR32 GNU Toolchain for this purpose.
Other IDEs and toolchains are also available, such as the IAR Embedded
Workbench®.
To debug the code at runtime, a debugger, such as the Atmel AVR JTAGICE mkII or
the Atmel AVR ONE!, will also be needed. More information on these tools is
available from the Atmel website. See the reference section later in this document for
more details.
2.1 Documentation for UC3-L0 Xplained
The AVR32924: UC3-L0 Xplained Hardware User’s Guide package includes in-depth
information about the kit, such as schematics, BOM, assembly drawings, 3D plots,
and more. The package is available from the Atmel website:
www.atmel.com/xplained
2.2 Atmel AVR Software Framework
The AVR Software Framework (ASF) provides software drivers and libraries to build
applications for Atmel AVR devices. It has been designed to help develop and merge
the different components of a software design. It can easily be integrated into an
operating system (OS) or run as a standalone product.
The ASF (version 1.7.0) that integrates with AVR32 Studio can be found here:
http://atmel.com/dyn/products/tools_card.asp?tool_id=4192
However, the above framework does not include the latest examples for this kit. The
new AVR Software Framework (version 2+) should be used to get the latest software
updates. The ASF can be found here:
http://asf.atmel.no/
2.3 Integrated development environment (IDE) for Atmel AVR 32-bit microcontrollers
2.3.1 Atmel AVR32 Studio
The AVR32 Studio is a free IDE for developing applications for AVR 32-bit
microcontrollers. It offers an advanced editor as well as programming and debugging
support.

Atmel AVR32931
3
32162A-AVR-03/11
Atmel AVR32 Studio (free Atmel 32-bit IDE)
http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4116
To learn how to use this tool, take a look at the following document:
AVR32015: AVR32 Studio getting started:
http://atmel.com/dyn/resources/prod_documents/doc32086.pdf
2.3.2 IAR Embedded Workbench for Atmel AVR 32-bit devices
IAR™ Embedded Workbench is an integrated development environment with project
management tools and editor.
IAR Embedded Workbench for Atmel AVR32:
http://www.iar.com/website1/1.0.1.0/124/1/
2.4 FLIP (BatchISP)
BatchISP is a command-line tool for programming the flash and EEPROM memories
of the board controller, and is part of the FLIP installation. It can be used to
communicate with the preprogrammed bootloader on the board controller.
FLIP (FLexible In-system Programmer) for programming:
http://atmel.com/dyn/products/tools_card.asp?tool_id=3886
2.5 Toolchain
In order to build an application from the source code, a toolchain is needed, which
includes required tools such as an assembler, compiler, and linker. The code for this
kit is compatible with the Atmel AVR32 GNU and IAR AVR toolchains.
2.5.1 Atmel AVR32 GNU Toolchain
The AVR32 GNU Toolchain is a free toolchain that can be downloaded from the
Atmel website. It includes all the necessary tools, such as a C/C++ compiler, an
assembler, and a linker, for AVR application development. The toolchain is included
in the AVR32 Studio installation, but is also available as a separate installation. The
toolchain is also available for the Linux OS. For more information about the supported
distributions, please see the release notes on the Atmel website.
AVR GNU Toolchain (Free C/C++ compiler for AVR 8-bit and 32-bit MCUs)
http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4118
2.5.2 IAR AVR Toolchain
The IAR AVR Toolchain is a commercial toolchain that includes all the necessary
tools, such as a C/C++ compiler, an assembler, and a linker, for AVR application
development. A 30-day evaluation version as well as a 32k (code size limited) kick-
start version are available from the IAR website.
IAR Embedded Workbench for Atmel AVR32:
http://www.iar.com/website1/1.0.1.0/124/1/
2.6 Programmers and debuggers
Programmers and debuggers are needed when either application programming
occurs without using the bootloader or debugging support is desired. Several different
tools are available for use directly with the Xplained kit, and the most common of
these are described in the following sections.

4 Atmel AVR32931 32162A-AVR-03/11
2.6.1 Atmel AVR Dragon
The low-cost Atmel AVR Dragon debug/programming tool can be used for code
development with the UC3-L0 Xplained kit.
Atmel AVR Dragon (on-chip programming and debugging tool)
http://atmel.com/dyn/products/tools_card.asp?tool_id=3891
2.6.2 Atmel AVR JTAGICE mkII
The Atmel AVR JTAGICE mkII is a mid-range debug/programming tool that can be
used for code development with the UC3-L0 Xplained kit.
Atmel AVR JTAGICE mkII (on-chip programming and debugging tool)
http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3353
2.6.3 Atmel AVR ONE!
The high-end Atmel AVR ONE! debug/programming tool can be used for code
development with the UC3-L0 Xplained kit.
Atmel AVR ONE! (on-chip programming and debugging tool)
http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4279

Atmel AVR32931
5
32162A-AVR-03/11
3 Board overview
Figure 3-1 shows most of the available features on the UC3-L0 Xplained board. For
more detailed information on the Atmel UC3-L0 Xplained hardware, take a look at the
Atmel application note, AVR32924: UC3-L0 Xplained Hardware User’s Guide.
Figure 3-1. Overview of the UC3-L0 Xplained kit.

6 Atmel AVR32931 32162A-AVR-03/11
4 Connecting the board
Connect a USB cable (Standard-A to Mini-B, or Mini-AB) between the board and a
PC or a USB power supply to power it up. That is all that is needed. When power is
applied, the power/status LED will light up green, and the RGB LED will light up blue.
WARNING Do not power the board without having a jumper installed or an
ammeter mounted across the pins of the power measurement header
located next to the USB connector. Otherwise, the device may be
damaged by power sourcing through the I/O pins. The power
measurement header location is shown in Figure 3-1.
4.1 Connecting the Atmel AVR Dragon kit
A 10-pin header is needed to connect the AVR Dragon kit to the Atmel UC3-L0
Xplained board. Connect the cable between the JTAG connector on the AVR Dragon
kit and the JTAG connector on the UC3-L0 Xplained board. Figure 4-1 shows how the
connection should be made.
Figure 4-1. Connecting the AVR Dragon kit to the UC3-L0 Xplained board.
4.2 Connecting the Atmel AVR JTAGICE mkII
The grey connector on the AVR JTAGICE mkII probe has to be used when
connecting to the UC3-L0 Xplained board. Figure 4-2 shows how to make the
connection. The notch of the grey connector must be placed into the cutout of the
board.

Atmel AVR32931
7
32162A-AVR-03/11
Figure 4-2. Connecting the Atmel AVR JTAGICE mkII to the Atmel UC3-L0 Xplained
board.
4.3 Connecting the Atmel AVR ONE!
The AVR ONE! JTAG connector can be connected to the UC3-L0 Xplained board
with a standoff adapter, as shown in Figure 4-3.
Figure 4-3. Connecting the AVR ONE! to the UC3-L0 Xplained board.

8 Atmel AVR32931 32162A-AVR-03/11
5 Programming the kit
5.1 Programming via the bootloader
The preprogrammed bootloader on the Atmel AT32UC3L064 makes it possible to
program the device via the UART interface. Because the default board controller
firmware acts as UART-to-USB bridge, the AT32UC3L064 can be programmed from
the PC via the USB connector.
The AT32UC3L064 bootloader is started by pushing the mechanical switch (SW0)
during reset. Programming can be performed by using the BatchISP command-line
tool from the FLIP installation.
5.1.1 Prerequisites
To program the device, BatchISP is needed, and it can be found under the FLIP
installation directory. Install FLIP version 3.4.2 or later.
The UART-USB gateway in the board controller must be intact to program the new
firmware into the device using BatchISP.
5.1.2 Step-by-step guide
To program the device, follow these steps:
1. Disconnect the USB cable from the kit.
2. Press and hold the button (SW0) while re-attaching the USB cable.
3. Open the device manager and locate the COM port used by the kit:
Figure 5-1. Xplained kit COM port.
4. Run the command below with the correct COM port:
Batchisp -device AT32UC3L064
-hardware RS232
-port COM19
-baudrate 115200
–operation onfail abort
memory flash
erase f

Atmel AVR32931
9
32162A-AVR-03/11
blankcheck
loadbuffer your_firmware_file.hex
program verify
start reset 0
5. The firmware should now be running.
NOTE The bootloader can only be synchronized once after power up, which means it is
possible to connect to the target only once, using BatchISP. If everything was not
able to be done on the first try, power cycle the board and run the command again.
An example of programming the device via the bootloader can be seen in Figure 5-2.
Note that the output gives a warning about the user program and the bootloader
overlap. This happens because the bootloader resides in the start of the flash section,
which is the same area as the trampoline area in which the user code is located. As
the bootloader is protected, the bootloader will not be overwritten.
Figure 5-2. Example of programming with BatchISP.
For more information about the BatchISP command line tool, run batchisp –h from a
command line to get a list of options and parameters. Read the help file for FLIP for
more detailed information.
The bootloader supports reading and writing of the following memories:
•Flash (0x0000 - 0xFFFF, application section)
•User (0x000 - 0x1FF, user signature row)
5.2 Restoring the bootloader
When the bootloader has been erased, it can be restored by using any of the
previously mentioned programming tools.
The source for the UART bootloader is part of ASF 2.2.x and later, and can be
downloaded and programmed into the device to restore the bootloader functionality, if
the bootloader was accidently erased.
NOTE The bootloader section is protected, and can only be erased by using an external
programmer.

10 Atmel AVR32931 32162A-AVR-03/11
6 Example applications
Several examples are available in ASF that can be downloaded from the ASF section
of the Atmel website: http://asf.atmel.no. Each example has full source code with
documentation, and also ready made binaries to get started quickly. The examples
can be compiled by using either GCC or IAR compilers.
6.1 Preprogrammed firmware
The Atmel AT32UC3L064 on the Atmel UC3-L0 Xplained kit is preprogrammed with a
UART bootloader and a default example firmware.
6.1.1 Functionality of the preprogrammed firmware
The preprogrammed firmware in the AT32UC3L064 is a demonstration of the Atmel
QTouch®button and Atmel QMatrix slider. By pushing the QTouch button (QTB0),
LED1 will light up. The QTouch button will cycle through the selection of the colors
red, green, and blue for the RGB LED. When moving a finger on the QMatrix slider
(QMSlider), the intensity of the color selected by the QTouch button will change. The
RGB colors are controlled with 8-bit resolution PWM, which theoretically gives the
user the ability to mix up to 16.7 million colors.
6.1.1.1 Capacitive touch module
The preprogrammed firmware was made to demonstrate the built-in hardware
functionality of the AT32UC3L064 device. The device has a capacitive touch (CAT)
module, which can be used for both QTouch and QMatrix sensors. To demonstrate
this, the UC3-L0 Xplained board has one of each sensor; one QTouch button and one
QMatrix slider.
The design of the sensor defines if it is a QTouch or a QMatrix sensor. One of each is
included for demonstration. The QMatrix slider can also be used as four separate
QMatrix buttons.
The preprogrammed firmware uses the QTouch button to select among the three
colors of the RGB LED to control with the QMatrix slider. When touching the QTouch
button, LED1 will also light up while a touch is registered.
The QMatrix slider has an 8-bit resolution, which gives 256 different values according
to where on the slider the touch is held. This value is passed on to the PWM module,
which will set the brightness of the selected color on the RGB LED.
NOTE Register and accept the license to get access to the QTouch libraries included in the
source zip file provided with this application note.
6.1.1.2 Pulse width modulation controller
The AT32UC3L064 device has a pulse width modulation controller (PWMA), which
can output an 8-bit PWM signal on any of the I/O pins of the device. This module is
used to control the brightness of each of the colors on the kit’s RGB LED with the
value received from the QMatrix slider and the color selected by the QTouch button.
6.1.1.3 UART
The preprogrammed firmware has a UART module set up for transferring serial data
through the board controller to a PC. This can be used for sending data to the PC to
implement any communication in a custom design. This gateway is currently used to