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

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

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

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

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

Table of contents

Other Atmel Microcontroller manuals

Atmel

Atmel ATmega168PB Xplained Mini User manual

Atmel

Atmel AT90USB162 User manual

Atmel

Atmel AT91 Series User manual

Atmel

Atmel AVR1925 XMEGA-C3 Xplained User manual

Atmel

Atmel AT43DK380 User manual

Atmel

Atmel ATtiny26 User manual

Atmel

Atmel ATtiny104 Xplained Nano User manual

Atmel

Atmel AVR ATtiny22 Instruction Manual

Atmel

Atmel ATSAMB11 BluSDK SMART User manual

Atmel

Atmel AT91 Series User manual

Atmel

Atmel AVR042 Installation and operating instructions

Atmel

Atmel AT89C52 User manual

Atmel

Atmel AVR365 User manual

Atmel

Atmel AVR461 User manual

Atmel

Atmel AT91FR40162S User manual

Atmel

Atmel AT90S1200 User manual

Atmel

Atmel ATtiny13A User manual

Atmel

Atmel AVR4901 Installation and operating instructions

Atmel

Atmel AVR AT90CAN32 User manual

Atmel

Atmel AT88CK101BK8 Installation manual

Atmel

Atmel AVR1909 Installation manual

Atmel

Atmel SAM4N Xplained Pro User manual

Atmel

Atmel SAM4SD32B Instruction Manual

Atmel

Atmel ARIS+ AT88SC-ADK2 User manual

Popular Microcontroller manuals by other brands

AMS

AMS AS7261 Demo Kit user guide

Novatek

Novatek NT6861 manual

Espressif Systems

Espressif Systems ESP8266 SDK AT Instruction Set

Nuvoton

Nuvoton ISD61S00 ChipCorder Design guide

STMicrolectronics

STMicrolectronics ST7 Assembler Linker user manual

Texas Instruments

Texas Instruments Chipcon CC2420DK user manual

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM user guide

NEC

NEC 78GK0S/K 1+ Series Application note

Mikroe

Mikroe SEMITECH N-PLC Click Application note

Intel

Intel Agilex user guide

Cypress

Cypress CY4607 HX2VL quick start guide

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE manual

Texas Instruments

Texas Instruments TMS320F2837 D Series Workshop Guide and Lab Manual

CYPRES

CYPRES CY14NVSRAMKIT-001 user guide

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM user guide

Espressif Systems

Espressif Systems ESP8266EX Programming guide

Abov

Abov AC33M8128L user manual

Laird

Laird BL654PA user guide