Atmel JTAGICE3 User guide
Introduction
Programmers and Debuggers
JTAGICE3
USER GUIDE
The Atmel JTAGICE3 is a powerful development tool for debugging and
programming ARM® Cortex®-M based Atmel® SAM and Atmel AVR
microcrontrollers with On-Chip Debug capability.
• 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® 8-bit
Microcontroller Family devices on both JTAG and PDI 2-wire
interfaces
• Programming (JTAG, SPI, and UPDI) and debugging of all Atmel AVR
8-bit Microcontrollers with OCD support on JTAG, debugWIRE, or
UPDI interfaces
• Programming and debugging of all Atmel SAM ARM Cortex-M based
microcontrollers on both SWD and JTAG interfaces (firmware version
3.0 and later)
®
Atmel-42634B-JTAGICE3_User Guide-10/2016
Table of Contents
Introduction......................................................................................................................1
1. Features.....................................................................................................................4
1.1. Atmel JTAGICE3 Features...........................................................................................................4
1.2. System Requirements.................................................................................................................. 4
2. Getting Started with the Atmel JTAGICE3................................................................. 5
2.1. Kit Contents..................................................................................................................................5
2.2. Assembling the Atmel JTAGICE3.................................................................................................5
2.3. Opening the Atmel JTAGICE3......................................................................................................7
2.4. Powering the Atmel JTAGICE3.................................................................................................... 8
2.5. Connecting to the Host Computer................................................................................................ 8
2.6. USB Driver Installation................................................................................................................. 9
2.6.1. Windows........................................................................................................................ 9
3. Connecting the Atmel JTAGICE3.............................................................................11
3.1. Connecting to a JTAG Target......................................................................................................11
3.1.1. Using the JTAG 10-pin Connector............................................................................... 11
3.2. Connecting to an aWire Target................................................................................................... 11
3.3. Connecting to a PDI Target........................................................................................................ 12
3.4. Connecting to a debugWIRE Target...........................................................................................13
3.5. Connecting to an SPI Target...................................................................................................... 14
3.6. Connecting to an SWD Target....................................................................................................15
3.7. Connecting to a UPDI Target......................................................................................................15
3.8. Using the Atmel JTAGICE3 with Atmel STK500.........................................................................16
3.9. Using the Atmel JTAGICE3 with Atmel STK600.........................................................................17
4. On-chip Debugging..................................................................................................18
4.1. Introduction to On-chip Debugging (OCD)................................................................................. 18
4.2. Physical Interfaces..................................................................................................................... 18
4.2.1. JTAG............................................................................................................................18
4.2.2. aWire........................................................................................................................... 20
4.2.3. PDI...............................................................................................................................21
4.2.4. UPDI Physical Interface...............................................................................................21
4.2.5. debugWIRE................................................................................................................. 23
4.2.6. SPI............................................................................................................................... 23
4.2.7. SWD............................................................................................................................ 23
4.3. Atmel OCD Implementations......................................................................................................24
4.3.1. Atmel AVR UC3 OCD (JTAG and aWire).....................................................................24
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).............................................................25
4.3.5. Atmel tinyX-OCD (UPDI)............................................................................................. 25
4.3.6. ARM Coresight Components....................................................................................... 26
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
2
5. Hardware Description.............................................................................................. 27
5.1. LEDs...........................................................................................................................................27
5.2. Rear Panel..................................................................................................................................27
5.3. Bottom Panel..............................................................................................................................27
5.4. Architecture Description............................................................................................................. 28
5.4.1. Atmel JTAGICE3 Main Board...................................................................................... 28
5.4.2. Atmel JTAGICE3 Target Connectors........................................................................... 28
5.4.3. Atmel JTAGICE3 Target Connectors Part Numbers....................................................29
6. Software Integration.................................................................................................30
6.1. Atmel Studio............................................................................................................................... 30
6.1.1. Software Integration in Atmel Studio........................................................................... 30
6.1.2. Programming Options..................................................................................................30
6.1.3. Debug Options.............................................................................................................30
7. Command Line Utility...............................................................................................32
8. Advanced Debugging Techniques........................................................................... 33
8.1. Atmel AVR UC3 Targets.............................................................................................................33
8.1.1. EVTI/EVTO Usage.......................................................................................................33
8.2. debugWIRE Targets................................................................................................................... 33
8.2.1. Software Breakpoints...................................................................................................33
9. Firmware Upgrade...................................................................................................35
10. Release History and Known Issues.........................................................................36
10.1. What's New in Major Version 3...................................................................................................36
10.2. Firmware Release History.......................................................................................................... 36
10.3. Known Issues Concerning the Atmel JTAGICE3........................................................................37
10.3.1. Atmel AVR XMEGA OCD Specific Issues....................................................................37
10.3.2. Atmel megaAVR OCD and Atmel tinyAVR OCD Specific Issues.................................37
11. Product Compliance................................................................................................ 38
11.1. RoHS and WEEE....................................................................................................................... 38
11.2. CE and FCC...............................................................................................................................38
12. Revision History.......................................................................................................39
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
3
1. Features
1.1. Atmel JTAGICE3 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.65V to 5.5V
• Draws less than 3mA from target VTref during operation
• Supports JTAG clock frequencies from 32kHz to 15MHz
• Supports PDI clock frequencies from 32kHz to 10MHz
• Supports debugWIRE baud rates from 4kbit/s to 0.5Mbit/s
• Supports aWire baud rates from 7.5kbit/s to 7.5Mbit/s
• Supports SPI clock frequencies from 8kHz to 1.875MHz
• Supports UPDI baud rates from up to 750kbit/s
• Supports SWD clock frequencies from 32kHz to 2MHz
• USB 2.0 high-speed host interface
• ITM serial trace capture at up to 1MB/s
• Supports 10-pin 50-mil JTAG connector, as well as 10-pin 100mil JTAG, 6-pin 50-mil SPI, and 6-pin
100-mil SPI interfaces using adapters
1.2. System Requirements
The Atmel JTAGICE3 unit requires that a front-end debugging environment as Atmel Studio or AVR
Studio® 5.0 or later is installed on your computer.
The JTAGICE3 should be connected to the host computer using the USB cable provided.
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
4
2. Getting Started with the Atmel JTAGICE3
2.1. Kit Contents
The Atmel JTAGICE3 kit contains these items:
• JTAGICE3 unit
• USB cable (1.8m, high-speed, Mini-B)
• Adapter board containing 50-mil SPI, 100-mil SPI, and 100-mil JTAG adapters
• 50-mil JTAG cable
• 50-mil 10-pin mini squid cable
• AVR Technical Library DVD
Figure 2-1. JTAGICE3 Kit Contents
2.2. Assembling the Atmel JTAGICE3
The Atmel JTAGICE3 unit is shipped with no cables attached. Two cable options are provided in the
accessory kit:
• 50-mil 10-pin IDC flat cable
• 50-mil 10-pin mini-squid cable with 10 x 100-mil sockets
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
5
Figure 2-2. JTAGICE3 Cables
For most purposes, the 50-mil 10-pin IDC flat cable can be used along with one of the adapters provided
in the accessory kit. Three adapters are provided in one small PCB panel section. To separate the
adapters, simply break off each one by gently bending the panel backwards and forwards. Take care to
avoid any sharp edges, which may result from the separation process. The following adapters are
included:
• A09-0955 - A 100-mil 10-pin JTAG adapter
• A09-0955 - B 100-mil 6-pin SPI/debugWIRE/PDI/aWire adapter
• A09-0955 - C 50-mil 6-pin SPI/debugWIRE/PDI/aWire adapter
Figure 2-3. JTAGICE3 Adapters
Note that a 50-mil JTAG adapter has not been provided - this is because the 50-mil 10-pin IDC cable can
be used to connect directly to a 50-mil JTAG header. For the part number of the component used for the
50-mil 10-pin connector, see target connectors part numbers.
To assemble your JTAGICE3 into its 'default' configuration, connect the 10-pin 50-mil IDC cable to the
unit as shown below. Be sure to orient the cable so that the red wire (pin 1) on the cable aligns with the
triangular indicator on the blue belt of the enclosure. The cable should connect upwards from the unit.
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
6
Figure 2-4. Atmel JTAGICE3 Cable Connection
Next, snap off the 100-mil 10-pin JTAG adapter from the adapter panel, and connect it to the other side of
the IDC cable. Your Atmel JTAGICE3 is now ready to use in its basic JTAG configuration.
Figure 2-5. JTAGICE3 Probe Adapter Connection
2.3. Opening the Atmel JTAGICE3
Note: For normal operation, the Atmel JTAGICE3 unit must not be opened. Opening the unit is done at
your own risk. Anti-static precautions should be taken.
The JTAGICE3 enclosure consists of three separate plastic components - top cover, bottom cover, and
blue belt - which are snapped together during assembly. To open the unit, simply insert a large flat
screwdriver into the openings in the blue belt, apply some inward pressure, and twist gently. Repeat the
process on the other snapper holes, and the top cover will pop off.
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
7
Figure 2-6. Opening the JTAGICE3 (1)
Figure 2-7. Opening the JTAGICE3 (2)
Figure 2-8. Opening the JTAGICE3 (3)
To close the unit again, simply align the top and bottom covers correctly, and press together firmly.
2.4. Powering the Atmel JTAGICE3
The Atmel JTAGICE3 is powered by the USB bus voltage. It requires less than 100mA to operate, and
can therefore be powered through a USB hub. The power LED will illuminate when the unit is plugged in.
When not connected in an active programming or debugging session, the unit will enter low-power
consumption mode to preserve your computer's battery. The JTAGICE3 cannot be powered down - it
should be unplugged when not in use.
2.5. Connecting to the Host Computer
Before plugging in the Atmel JTAGICE3 for the first time, be sure to install the USB driver on the host
computer. This is done automatically when installing the front-end software provided free by Atmel. See
www.atmel.com for further information or to download the latest front-end software.
The JTAGICE3 must be connected to an available USB port on the host computer using the USB cable
provided. The JTAGICE3 contains a USB 2.0 compliant controller, and can operate in both full-speed and
high-speed modes. For best results, connect the JTAGICE3 directly to a USB 2.0 compliant high-speed
hub on the host computer using the cable provided.
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
8
2.6. USB Driver Installation
2.6.1. Windows
When installing the Atmel JTAGICE3 on a computer running Microsoft® Windows®, the USB driver is
loaded when the JTAGICE3 is first plugged in.
Note: Be sure to install the front-end software packages before plugging the unit in for the first time!
Proceed with the default ("recommended") options through the New Hardware Wizard.
Figure 2-9. Installing the JTAGICE3 USB Driver
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
9
Figure 2-10. Installing the JTAGICE3 USB Driver
If it is not detected automatically, point the wizard to the device driver (provided by Jungo) called
jtagice3.inf which is stored in the <windows_root>\inf folder.
Once successfully installed, the JTAGICE3 will appear in the device manager as a "Jungo" device.
Your JTAGICE3 is now ready to use.
Note: Firmware version 3 and later uses a HID interface for communication. The USB driver provided by
the operating system is loaded automatically in this case.
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
10
3. Connecting the Atmel JTAGICE3
3.1. Connecting to a JTAG Target
The Atmel JTAGICE3 probe has a 50-mil 10-pin JTAG connector accessible on the front of the tool's
enclosure. The kit includes a 50-mil 10-pin cable, which can be used to connect directly to a 50-mil JTAG
header on your target board. Should your target board be fitted with a 100-mil JTAG header (e.g.: Atmel
STK®600), the 100-mil adapter provided (A08-0735-A) in the kit can be used. If your target board does
not have a compliant 10-pin JTAG header in 50- or 100-mil, you can map to a custom pinout using the 10pin "mini-squid" cable provided, which gives access to 10 individual 100-mil sockets.
3.1.1. Using the JTAG 10-pin Connector
The pinout for the 10-pin JTAG connector is shown in Figure 4-2.
Be sure to use the correct orientation of the 10-pin header when connecting the JTAGICE3 to the target
application PCB. The red wire on the probe cable indicates PIN1, as does the 'dot' on the 100-mil
adapter.
3.2. Connecting to an aWire Target
The aWire interface requires only one data line in addition to VCC and GND. The 10-pin mini-squid cable
should be used to connect between the Atmel JTAGICE3 target connector and the target board. Three
connections are required, as described in the table below.
Table 3-1. Connecting to aWire using the Mini-squid Cable
JTAGICE3 pins Target pins Mini-squid pin aWire pinout
Pin 1 (TCK) 1
Pin 2 (GND) GND 2 6
Pin 3 (TDO) DATA 3 1
Pin 4 (VTG) VTG 4 2
Pin 5 (TMS) 5
Pin 6 (nSRST) 6
Pin 7 (Not connected) 7
Pin 8 (nTRST) 8
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
11
JTAGICE3 pins Target pins Mini-squid pin aWire pinout
Pin 9 (TDI) 9
Pin 10 (GND) 0
3.3. Connecting to a PDI Target
The pinout for the 6-pin PDI connector is shown in Figure 4-5.
The adapters provided in the kit (A08-0735-B and A08-0735-C) can be used to connect to this pinout in
either 50-mil or 100-mil options.
Be sure to use the correct orientation of the 6-pin header when connecting the Atmel JTAGICE3 to the
target application PCB. A 'dot' on the adapter board indicates pin 1.
When connecting to a target that does not have the standard 6-pin header, you can use the 10-pin minisquid cable between the JTAGICE3 target connector and the target board. Four connections are required,
and the table below describes where to connect them.
Note: There is a difference from the JTAGICE mkII JTAG probe, where PDI_DATA is connected to pin 9.
The JTAGICE3 is compatible with the pinout used by the Atmel AVR ONE! and Atmel AVR Dragon
™
products.
Table 3-2. Connecting to PDI using the Mini-squid Cable
JTAGICE3 pin Target pins Mini-squid pin Atmel STK600 PDI pinout
Pin 1 (TCK) 1
Pin 2 (GND) GND 2 6
Pin 3 (TDO) PDI_DATA 3 1
Pin 4 (VTG) VTG 4 2
Pin 5 (TMS) 5
Pin 6 (nSRST) PDI_CLK 6 5
Pin 7 (Not connected) 7
Pin 8 (nTRST) 8
Pin 9 (TDI) 9
Pin 10 (GND) 0
Atmel JTAGICE3 [USER GUIDE]
Atmel-42634B-JTAGICE3_User Guide-10/2016
12
Loading...