OLIMEX ARM-USB-OCD-H Manual de usuario
ARM-USB-OCD-H, ARM-USB-OCD
OLIMEX OPENOCD ARM JTAG DEBUGGERS
USER’S MANUAL
Document revision D, Ju y 2015
A boards produced by O imex LTD are ROHS comp iant
OLIMEX© 2015 ARM-USB-OCD user's manua
DISCLAIMER
© 2015 O imex Ltd. O imex®, ogo and combinations thereof, are registered trademarks of O imex Ltd.
Other product names may be trademarks of others and the rights be ong to their respective owners.
The information in this doc ment is provided in connection with Olimex prod cts. No license, express
or implied or otherwise, to any intellect al property right is granted by this doc ment or in connection
with the sale of Olimex prod cts.
The hardware designs of the devices, subjects of this manua , are proprietary. The design fi es wou d not be
distributed nor shared with the end customer.
The products described in this manua are intended to work with open source software.
It is possib e that the pictures in this manua differ from the atest revision of the board.
The product described in this document is subject to continuous deve opment and improvements. A
particu ars of the product and its use contained in this document are given by OLIMEX in good faith.
However a warranties imp ied or expressed inc uding but not imited to imp ied warranties of
merchantabi ity or fitness for purpose are exc uded. This document is intended on y to assist the reader in the
use of the product. OLIMEX Ltd. sha not be iab e for any oss or damage arising from the use of any
information in this document or any error or omission in such information or any incorrect use of the
product.
This product is intended for use for engineering deve opment, demonstration, or eva uation purposes on y
and is not considered by OLIMEX to be a finished end-product fit for genera consumer use. Persons
hand ing the product must have e ectronics training and observe good engineering practice standards. As
such, the goods being provided are not intended to be comp ete in terms of required design-, marketing-,
and/or manufacturing-re ated protective considerations, inc uding product safety and environmenta
measures typica y found in end products that incorporate such semiconductor components or circuit boards.
O imex current y dea s with a variety of customers for products, and therefore our arrangement with the user
is not exc usive. O imex assumes no iabi ity for app ications assistance, customer product design, software
performance, or infringement of patents or services described herein.
THERE IS NO WARRANTY FOR THE DESIGN MATERIALS AND THE
COMPONENTS USED TO CREATE ARM-USB-OCD-H OR ARM-USB-OCD. THEY
ARE CONSIDERED SUITABLE ONLY FOR THE RESPECTIVE PRODUCTS.
Page 2 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
Table of Contents
DISCLAIMER ............................................................................................................. 2
CHAPTER 1: OVERVIEW ........................................................................................ 5
1. Introd ction to the chapter ................................................................................. 5
1.1 Feat res .............................................................................................................. 5
1.2 F nctional description and p rpose of the board .......................................... 6
1.3 What is OpenOCD? ........................................................................................... 6
1.4 Comparison of Olimex OpenOCD deb ggers ................................................ 7
CHAPTER 2: DEVICE DESCRIPTION .................................................................. 9
2. Introd ction to the chapter ................................................................................. 9
2.1 Stat s LED ......................................................................................................... 9
2.2 Ports and connectors ......................................................................................... 9
2.2.1 USB type B co ector .................................................................................................................................... 9
2.2.2 JTAG co ector ............................................................................................................................................ 10
2.2.3 RS232 co ector ........................................................................................................................................... 11
2.2.4 Power out barrel jack ................................................................................................................................... 11
CHAPTER 3: SETTING UP ARM-USB-OCD ....................................................... 13
3. Introd ction to the chapter ............................................................................... 13
3.1 Basic system set p ........................................................................................... 13
3.2 Detailed hardware set p ................................................................................. 13
3.2.1 E abli g SWD i terface for ARM-USB-OCD .......................................................................................... 14
3.3 Detailed software set p ................................................................................... 14
3.3.1 Getti g Ope OCD ........................................................................................................................................ 15
3.3.2 Drivers a d driver i stallatio .................................................................................................................... 16
3.3.3 Driver i stallatio i Wi dows ................................................................................................................... 17
3.3.4 Driver i stallatio i Li ux ......................................................................................................................... 19
3.3.5 Driver i stallatio i MAC OS X ............................................................................................................... 19
3.3.6 How to u i stall a d clea -up previously i stalled drivers ..................................................................... 20
3.4 Basic OpenOCD connection ........................................................................... 21
3.4.1 Simple target co ectio via FTDI drivers ................................................................................................ 21
3.4.2 Simple target co ectio via LibUSB drivers ........................................................................................... 22
3.4.3 Simple SWD target co ectio with ARM-JTAG-SWD .......................................................................... 23
3.5 Advanced OpenOCD practices ....................................................................... 23
3.5.1 Usi g multiple ARM-USB-OCD i terfaces ................................................................................................ 23
3.5.2 Cha gi g the VID a d PID of the debugger .............................................................................................. 25
3.6 IAR Embedded Workbench for ARM ........................................................... 25
3.7 Rowley Crossworks for ARM ......................................................................... 26
3.8 CooCox IDE ..................................................................................................... 28
3.9 Olimex Open Development S ite (ODS) package ........................................ 28
3.10 Other software tools ...................................................................................... 29
CHAPTER 4: FREQUENTLY ASKED QUESTIONS .......................................... 30
Page 3 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
CHAPTER 5: REVISION HISTORY AND SUPPORT ........................................ 31
5. Introd ction to the chapter ............................................................................... 31
5.1 Doc ment revision ........................................................................................... 31
5.2 Usef l web links and p rchase codes ............................................................. 31
5.3 Prod ct s pport ............................................................................................... 33
Page 4 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
CHAPTER 1: OVERVIEW
1. I troductio to the chapter
Thank you for choosing an OpenOCD debugger manufactured by OLIMEX LTD. This document
provides information about two of the ARM debuggers manufactured by OLIMEX LTD – ARM-
USB-OCD and ARM-USB-OCD-H.
ARM-USB-OCD and ARM-USB-OCD-H are very simi ar in features and hardware design.
Because of that when one of them is mentioned in this document it is safe to assume that the
information app ies for both debuggers, un ess it is specifica y stated otherwise.
1.1 Features
The debuggers have the fo owing features:
•Debug a ARM microcontro ers with JTAG interface supported by OpenOCD
•Use ARM's standard 2×10 pin JTAG connector
•Support ARM targets working in vo tage range 2.00V – 5.00V (1.65V – 5.00V for ARM-
USB-OCD-H)
•Supported by the open-source community and OpenOCD debugger software
•Automatic powering via the JTAG to your target board with up to 200mA at 5V
•Ab e to power a target board via a standard DC barre jack; cab e for the externa powering
inc uded – 2.1×5.5×14mm fema e connectors at both ends
•Down oadab e Windows insta er for fu featured and open source too s as a ternative to the
commercia ARM deve opment packages: GCC C compi er, OpenOCD debugger and
Ec ipse IDE.
•Work with IAR EW for ARM via GDB server
•Work with Row ey Crossworks IDE
•Work with CooCox IDE
•Supported in Windows, Linux and Mac
•Dimensions (50×40)mm ~ (2×1.6)" + 20 cm ~ (8") JTAG cab e – ribbon cab e inc uded
ARM-USB-OCD-H has these specific features over the ARM-USB-OCD:
•High speed USB 2.0 with ower atency time, RTCK adaptive JTAG c ock up to 30Mhz and
higher throughput achieve x3-x5 times faster programming speed than ARM-USB-OCD
•Works with ower vo tage targets (down to 1.65V); the ARM-USB-OCD can't debug targets
working at vo tage eve s ower than 2V.
ARM-USB-OCD has this specific feature over ARM-USB-OCD-H:
•A jumper that a ows you to change the vo tage provided to the target. It can power 5V, 9V
or 12V targets; ARM-USB-OCD-H can provide on y 5V to the target.
Page 5 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
1.2 Fu ctio al descriptio a d purpose of the board
A programmer/debugger is an inseparab e part of an active deve opment process that invo ves ARM
microcontro ers. ARM-USB-OCD is a USB FT2232-based ARM JTAG programmer/debugger that
is contro ed by a PC via OpenOCD under Windows, Linux or MAC OS. The ARM-USB-OCD
programmer/debugger is used for hardware and software deve opment on ARM microcontro ers
(MCUs) which via JTAG interface.
Both debuggers are ab e to power your target board via the JTAG.
Both debuggers can power the target board via a DC power p ug. The ARM-USB-OCD-H a ways
provides up to 5V of vo tage to the target via the p ug, whi e the ARM-USB-OCD can be
configured to provide 9V or 12V.
The O imex OpenOCD debuggers can a so be used for other app ications (except ARM
microcontro er debugging) as ong as the software a ows it. We have seen O imex OpenOCD
debuggers used for f ash memory programming (“f ashrom” uti ity software) and Atme AVR
debugging (“AVReAL” and “AVRdude” software too s). Yet, whi e these app ications of ARM-
USB-OCD are possib e, we do not provide any support regarding such use.
P ease note that O imex OpenOCD debuggers have NO hardware support for “Seria Wire Debug”
interface. An adapter extending the SWD functiona ity is so d separate y. The adapter is ca ed
ARM-JTAG-SWD.
1.3 What is Ope OCD?
OpenOCD was created by Dominic Rath as part of a 2005 dip oma thesis written at the University
of App ied Sciences Augsburg (http://www.hs-augsburg.de). Since that time, the project has grown
into an active open-source project, supported by a diverse community of software and hardware
deve opers from around the wor d.
The Open On-Chip Debugger (OpenOCD) aims to provide debugging, in-system programming and
boundary-scan testing for embedded target devices.
It does so with the assistance of a debug adapter, which in our case is the ARM-USB-OCD
debugger which he ps provide the right kind of e ectrica signa ing to the target being debugged.
These are required since the debug host (on which OpenOCD runs) won’t usua y have native
support for such signa ing, or the connector needed to hook up to the target.
Page 6 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
1.4 Compariso of Olimex Ope OCD debuggers
The main difference between ARM-USB-OCD and ARM-USB-OCD-H is the revision of the FTDI
chip inside – it is a most a ways recommended to get the -H version since it it much faster (the same
app ies for ARM-USB-TINY and ARM-USB-TINY-H).
TINY and OCD debuggers are comparab e in speed but the OCD design works with ower-vo tage
targets, can provide power to the target via a barre jack and has a virtua seria port inc uded –
suitab e for persona computers that ack a native COM port.
Table 1. Olimex OpenOCD debuggers, comparison of features
ARM-USB-TINY ARM-USB-TINY-H ARM-USB-OCD ARM-USB-OCD-H
FTDI chip FT2232C FT2232H FT2232C FT2232H
Relative debu in
speed SLOWER FASTER SLOWER FASTER
Additional power
option(*) NO NO YES, 5V-9V-12V YES, 5V
Additional VCP(**) NO NO YES YES
Tar et volta e
ran e 2.00V – 5.00V 2.00V – 5.00V 2.00V – 5.00V 1.65V – 5.0V
(*)The OCD debuggers have a DC barrel jack suitable for powering the target autonomously from the TAG
connector. An extension cable that fits the barrel jack is included in the package. The ARM-USB-OCD can
provide 5V or 9V or 12V (controlled via jumper), while ARM-USB-OCD-H can only provide 5V. This feature
is useful when you want to power the target board without establishing the TAG connection.
(**) Additional virtual COM port – the debugger might be used as convertor of a serial communication to
USB one. A good addition for newer computer systems that lack built-in COM port.
In case you are sti wondering which one you shou d get: ARM-USB-TINY-H is perfect y fine for
home use, research and deve opment. ARM-USB-OCD-H is the better choice for professiona use
and for chain programming of target devices.
Another difference between the devices is the product identification number which is different for
each different set of debuggers. A four types of OpenOCD debuggers have the same vendor ID.
However, each of the debugger series isted above has own product ID. These IDs might be seen in
the tab e be ow:
Table 2. Olimex OpenOCD debuggers, FTDI vendor and product IDs
ARM-USB-TINY ARM-USB-TINY-H ARM-USB-OCD ARM-USB-OCD-H
VID (VENDOR ID) 0×15BA 0×15BA 0×15BA 0×15BA
PID (PRODUCT ID) 0×0004 0×002a 0×0003 0×002b
You might need the IDs in severa cases but main y when you want to wipe the drivers with a third
party program.
Page 7 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
1.5 Orga izatio
Each section in this document covers a separate topic, organized as fo ow:
–Chapter 1 is an overview of the board usage and features
–Chapter 2 provides information about the connectors and the status LEDs
–Chapter 3 provides a guide for quick y setting up the board and the needed software
–Chapter 4 is a frequent y asked questions section
–Chapter 5 features a set of usefu inks, warranty info and purchase ocations
Page 8 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
CHAPTER 2: DEVICE DESCRIPTION
2. I troductio to the chapter
This chapter features exp anation of the interfaces visib e to the user. Most of the time those wou d
be the on y parts of the debugger that the user wou d manipu ate or make contact with.
There is on y one major difference in the appearance of ARM-USB-OCD and ARM-USB-OCD-H –
the first has two jumpers near the JTAG connector. These jumpers are responsib e for the se ection
of the vo tage output avai ab e at the barre jack – either 5V(by defau t), 9V or 12V. ARM-USB-
OCD-H acks such jumpers since it can provide on y 5V to the target.
2.1 Status LED
The debugger has one doub e co or (red/green) LED on the top. Upon USB connection the LED
might power up. However, it is main y meant to indicate programming/debugging in progress. The
red LED shou d b ink when you have an on-going operation (read, write).
2.2 Ports a d co ectors
The user can free y access the USB and the JTAG connector avai ab e. The pinouts and the usage of
those are discussed be ow.
2.2.1 USB type B co ector
The USB type B connector fo ows the USB 2.0 specification. The connector itse f ooks ike this:
You wou d most ike y need a suitab e cab e to connect the debugger to your persona computer.
The cab e shou d be USB A-B type. You might find a cab e ike that in the O imex web-shop or any
e ectronics store nearby.
The USB communication is hand ed by an FTDI chip inside the box. The drivers required are FTDI
ones with modified VID and PID numbers to fit the O imex own VID and PID.
Page 9 of 33
OLIMEX© 2015 ARM-USB-OCD user's manua
2.2.2 JTAG co ector
The JTAG connector is a 20-pin ma e one. It has the standard ARM JTAG 20 at 2.54mm (0.1'')
pitch, specified by IEEE 1149.1. There is a fema e-fema e ribbon cab e inc uded in the box of
ARM-USB-OCDfor easier connection to the target board.
There is a sma mark over the connector that indicates where the first pin is ocated. It might be
difficu t to spot it at first g ance (because of the casing) so p ease a so consider that the cab e that
comes with the debugger has the first wire co ored in red.
The pinout of the JTAG connector is shown in the next tab e (#3):
Table 3. TAG connector pinout
PIN # Si nal name PIN # Si nal name
1 VREF 2 VREF
3 TTRST_N 4 GND
5 TTDI 6 GND
7 TTMS 8 GND
9 TTCK 10 GND
11 TRTCK 12 GND
13 TTDO 14 GND
15 TSRST_N 16 GND
17 NOT CONNECTED 18 GND
19 TARGET SUPPLY 20 GND
Pins 1 and 2 of the JTAG connector are vo tage reference that probes if the target is a ready
powered by another source. If it is not, the ARM-USB-OCD wou d attempt to power it by 5V at pin
19 of the connector. P ease note that the USB standard a ows imited amount of power. Powering
the board from the debugger is not a ways re iab e (especia y if the target board has a ot of power-
hungry periphera s). It is recommended to use externa power supp y for bigger target boards.
If instead of the standard 20-pin 2.54mm (0.1'') JTAG connector your board has the mini version –
the 10-pin 1.27mm (0.05'') – then you might use the ARM-JTAG-20-10 adapter which is so d
separate y. This adapter does not provide SWD capabi ities ( ook for ARM-JTAG-SWD for such an
expansion). The ARM-JTAG-20-10 adapter can be used with debuggers manufactured by other
companies as ong as they fo ow the standard 20-pin JTAG ayout suggested by ARM Ho dings.
Page 10 of 33
Este manual sirve para los siguientes modelos
1
Tabla de contenidos
