42330A-MCU-07/2014
USER GUIDE
Atmel-ICE
The Atmel-ICE Debugger
Atmel-ICE is a powerful development tool for debugging and programming
ARM
®
Cortex
®
-M based Atmel
®
SAM and Atmel AVR
®
microcontrollers with On-
Chip Debug capability.
It supports:
Programming and on-chip debugging of all Atmel AVR 32-bit
microcontrollers on both JTAG and aWire interfaces
Programming and on-chip debugging of all Atmel AVR XMEGA
®
family
devices on both JTAG and PDI 2-wire interfaces
Programming (JTAG and SPI) and debugging of all Atmel AVR 8-bit
microcontrollers with OCD support on either JTAG or debugWIRE interfaces
Programming and debugging of all Atmel SAM ARM Cortex-M based
microcontrollers on both SWD and JTAG interfaces
Programming (TPI) of all Atmel tinyAVR
®
8-bit microcontrollers with support
for this interface
Consult the supported devices list in the Atmel Studio User Guide for a full list of
devices and interfaces supported by this firmware release.
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
2
Table of Contents
The Atmel-ICE Debugger
.............................................................
1
1.
Introduction
..............................................................................
4
1.1.
Introduction to the Atmel-ICE
...................................................
4
1.2.
Atmel-ICE Features
...............................................................
4
1.3.
System Requirements
............................................................
4
2.
Getting Started with the Atmel-ICE
.........................................
6
2.1.
Full Kit Contents
...................................................................
6
2.2.
Basic Kit Contents
.................................................................
6
2.3.
PCBA Kit Contents
................................................................
7
2.4.
Spare Parts Kits
....................................................................
7
2.5.
Kit Overview
.........................................................................
8
2.6.
Assembling the Atmel-ICE
......................................................
8
2.7.
Opening the Atmel-ICE
.........................................................
10
2.8.
Powering the Atmel-ICE
........................................................
12
2.9.
Connecting to the Host Computer
...........................................
12
2.10.
USB Driver Installation
.........................................................
12
2.10.1.
Windows
................................................................
12
3.
Connecting the Atmel-ICE
....................................................
13
3.1.
Overview: Connecting to AVR and SAM Target Devices
..............
13
3.2.
Connecting to a JTAG Target
.................................................
13
3.3.
Connecting to an aWire Target
...............................................
14
3.4.
Connecting to a PDI Target
...................................................
15
3.5.
Connecting to a debugWIRE Target
........................................
15
3.6.
Connecting to a SPI Target
...................................................
16
3.7.
Connecting to a TPI Target
....................................................
17
3.8.
Connecting to a SWD Target
.................................................
17
4.
On-Chip Debugging
..............................................................
19
4.1.
Introduction to On-Chip Debugging (OCD)
................................
19
4.2.
Physical Interfaces
...............................................................
19
4.2.1.
JTAG
.....................................................................
19
4.2.2.
aWire
....................................................................
21
4.2.3.
PDI Physical
...........................................................
22
4.2.4.
debugWIRE
............................................................
22
4.2.5.
SPI
.......................................................................
22
4.2.6.
TPI
.......................................................................
23
4.2.7.
SWD
.....................................................................
23
4.3.
Atmel OCD Implementations
..................................................
23
4.3.1.
Atmel AVR UC3 OCD (JTAG and aWire)
......................
23
4.3.2.
Atmel AVR XMEGA OCD (JTAG and PDI Physical)
........
24
4.3.3.
Atmel megaAVR OCD (JTAG)
....................................
24
4.3.4.
Atmel megaAVR / tinyAVR OCD (debugWIRE)
..............
24
4.3.5.
ARM Coresight Components
.....................................
24
5.
Hardware Description
............................................................
25
5.1.
LEDs
.................................................................................
25
5.2.
Rear Panel
.........................................................................
25
5.3.
Bottom Panel
......................................................................
25
5.4.
Architecture Description
........................................................
26
5.4.1.
Atmel-ICE Mainboard
...............................................
26
5.4.2.
Atmel-ICE Target Connectors
.....................................
27
5.4.3.
Atmel-ICE target Connectors Part Numbers
..................
27
6.
Software Integration
..............................................................
28
6.1.
Atmel Studio
.......................................................................
28
6.1.1.
Software Integration in Atmel Studio
............................
28
6.1.2.
Programming Options
...............................................
28
6.1.3.
Debug Options
........................................................
28
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
3
7.
Command Line Utility
............................................................
30
8.
Advanced Debugging Techniques
........................................
31
8.1.
Atmel AVR UC3 Targets
.......................................................
31
8.1.1.
EVTI / EVTO Usage
.................................................
31
8.2.
debugWIRE Targets
.............................................................
31
8.2.1.
Software Breakpoints
...............................................
31
9.
Special Considerations
.........................................................
32
9.1.
Atmel AVR XMEGA OCD
......................................................
32
9.2.
Atmel megaAVR OCD and debugWIRE OCD
............................
32
9.2.1.
Atmel megaAVR OCD (JTAG)
....................................
33
9.2.2.
debugWIRE OCD
....................................................
34
9.3.
Atmel AVR UC3 OCD
...........................................................
35
9.4.
SAM / Coresight OCD
..........................................................
35
10. Firmware Upgrade
................................................................
37
11. Release History and Known issues
......................................
38
11.1.
What's New
........................................................................
38
11.2.
Firmware Release History
.....................................................
38
11.2.1.
Atmel Studio 6.2
.....................................................
38
11.2.2.
Atmel Studio 6.2 (beta)2
...........................................
38
11.3.
Known Issues Concerning the Atmel-ICE
.................................
38
11.3.1.
Atmel AVR XMEGA OCD Specific Issues
.....................
38
11.3.2.
Atmel megaAVR OCD and Atmel tinyAVR OCD
Specific Issues
........................................................
38
11.4.
Device Support
...................................................................
38
12. Product Compliance
..............................................................
39
12.1.
RoHS and WEEE
................................................................
39
12.2.
CE and FCC
......................................................................
39
13. Document Revisions
.............................................................
40
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
4
1.
Introduction
1.1
Introduction to the Atmel-ICE
Atmel-ICE is a powerful development tool for debugging and programming ARM Cortex-M based Atmel SAM
and Atmel AVR microcontrollers with On-Chip Debug capability.
It supports:
Programming and on-chip debugging of all Atmel AVR UC3 microcontrollers on both JTAG and aWire
interfaces
Programming and on-chip debugging of all AVR XMEGA family devices on both JTAG and PDI 2-wire
interfaces
Programming (JTAG and SPI) and debugging of all AVR 8-bit microcontrollers with OCD support on both
JTAG or debugWIRE interfaces
Programming and debugging of all Atmel SAM ARM Cortex-M based microcontrollers on both SWD and
JTAG interfaces
Programming (TPI) of all Atmel tinyAVR 8-bit microcontrollers with support for this interface
1.2
Atmel-ICE Features
Fully compatible with Atmel Studio
Supports programming and debugging of all Atmel AVR UC3 32-bit microcontrollers
Supports programming and debugging of all 8-bit AVR XMEGA devices
Supports programming and debugging of all 8-bit Atmel megaAVR
®
and tinyAVR devices with OCD
Supports programming and debugging of all SAM ARM Cortex-M based microcontrollers
Target operating voltage range of 1.62V to 5.5V
Draws less than 3mA from target VTref when using debugWIRE interface and less than 1mA for all other
interfaces
Supports JTAG clock frequencies from 32kHz to 7.5MHz
Supports PDI clock frequencies from 32kHz to 7.5MHz
Supports debugWIRE baud rates from 4kbit/s to 0.5Mbit/s
Supports aWire baud rates from 7.5kbit/s to 7Mbit/s
Supports SPI clock frequencies from 8kHz to 5MHz
Supports SWD clock frequencies from 32kHz to 2MHz
USB 2.0 high-speed host interface
ITM serial trace capture at up to 3MB/s
Supports 10-pin 50-mil JTAG connector with both AVR and Cortex pinouts. The standard probe cable
supports AVR 6-pin ISP/PDI/TPI 100-mil headers as well as 10-pin 50-mil. An adapter is available to
support 6-pin 50-mil, 10-pin 100-mil and 20-pin 100-mil headers. Several kit options are available with
different cabling and adapters.
1.3
System Requirements
The Atmel-ICE unit requires that a front-end debugging environment Atmel Studio version 6.2 or later is
installed on your computer.
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
5
The Atmel-ICE should be connected to the host computer using the USB cable provided, or a certified USB-
micro cable.
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
6
2.
Getting Started with the Atmel-ICE
2.1
Full Kit Contents
The Atmel-ICE full kit contains these items:
Atmel-ICE unit
USB cable (1.8m, high-speed, micro-B)
Adapter board containing 50-mil AVR, 100-mil AVR/SAM and 100-mil 20-pin SAM adapters
IDC flat cable with 10-pin 50-mil connector and 6-pin 100-mil connector
50-mil 10-pin mini squid cable with 10 x 100-mil sockets
Figure 2-1. Atmel-ICE Full Kit Contents
2.2
Basic Kit Contents
The Atmel-ICE basic kit contains these items:
Atmel-ICE unit
USB cable (1.8m, high-speed, micro-B)
IDC flat cable with 10-pin 50-mil connector and 6-pin 100-mil connector
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
7
Figure 2-2. Atmel-ICE Basic Kit Contents
2.3
PCBA Kit Contents
The Atmel-ICE PCBA kit contains these items:
Atmel-ICE unit without plastic encaptulation
Figure 2-3. Atmel-ICE PCBA Kit Contents
2.4
Spare Parts Kits
The following spare parts kits are available:
Adapter kit
Cable kit
Atmel-ICE [USER GUIDE]
42330A-MCU-07/2014
8
Figure 2-4. Atmel-ICE Adapter Kit Contents
Figure 2-5. Atmel-ICE Cable Kit Contents
2.5
Kit Overview
The Atmel-ICE kit options are shown diagrammatically here:
Figure 2-6. Atmel-ICE Kit Overview
PCBA
PCBA kit
basic kit
adapter kit
full kit
SAM
AVR
cable kit
2.6
Assembling the Atmel-ICE
The Atmel-ICE unit is shipped with no cables attached. Two cable options are provided in the full kit:
50-mil 10-pin IDC flat cable with 6-pin ISP and 10-pin connectors