ARM-USB-OCD-H, ARM-USB-OCD
OLIMEX OPENOCD ARM JTAG DEBUGGERS
USER’S MANUAL
Document revision D, July 2015
All boards produced by Olimex LTD are ROHS compliant
OLIMEX© 2015
ARM-USB-OCD user's manual
DISCLAIMER
© 2015 Olimex Ltd. Olimex®, logo and combinations thereof, are registered trademarks of Olimex Ltd.
Other product names may be trademarks of others and the rights belong to their respective owners.
The information in this document is provided in connection with Olimex products. No license, express
or implied or otherwise, to any intellectual property right is granted by this document or in connection
with the sale of Olimex products.
The hardware designs of the devices, subjects of this manual, are proprietary. The design files would not be
distributed nor shared with the end customer.
The products described in this manual are intended to work with open source software.
It is possible that the pictures in this manual differ from the latest revision of the board.
The product described in this document is subject to continuous development and improvements. All
particulars of the product and its use contained in this document are given by OLIMEX in good faith.
However all warranties implied or expressed including but not limited to implied warranties of
merchantability or fitness for purpose are excluded. This document is intended only to assist the reader in the
use of the product. OLIMEX Ltd. shall not be liable for any loss 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 development, demonstration, or evaluation purposes only
and is not considered by OLIMEX to be a finished end-product fit for general consumer use. Persons
handling the product must have electronics training and observe good engineering practice standards. As
such, the goods being provided are not intended to be complete in terms of required design-, marketing-,
and/or manufacturing-related protective considerations, including product safety and environmental
measures typically found in end products that incorporate such semiconductor components or circuit boards.
Olimex currently deals with a variety of customers for products, and therefore our arrangement with the user
is not exclusive. Olimex assumes no liability for applications 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 manual
Table of Contents
DISCLAIMER............................................................................................................. 2
CHAPTER 1: OVERVIEW........................................................................................5
1. Introduction to the chapter.................................................................................5
1.1 Features.............................................................................................................. 5
1.2 Functional description and purpose of the board.......................................... 6
1.3 What is OpenOCD?...........................................................................................6
1.4 Comparison of Olimex OpenOCD debuggers................................................ 7
CHAPTER 2: DEVICE DESCRIPTION..................................................................9
2. Introduction to the chapter.................................................................................9
2.1 Status LED......................................................................................................... 9
2.2 Ports and connectors.........................................................................................9
2.2.1 USB type B connector....................................................................................................................................9
2.2.2 JTAG connector............................................................................................................................................10
2.2.3 RS232 connector...........................................................................................................................................11
2.2.4 Power out barrel jack...................................................................................................................................11
CHAPTER 3: SETTING UP ARM-USB-OCD.......................................................13
3. Introduction to the chapter...............................................................................13
3.1 Basic system setup........................................................................................... 13
3.2 Detailed hardware setup................................................................................. 13
3.2.1 Enabling SWD interface for ARM-USB-OCD.......................................................................................... 14
3.3 Detailed software setup...................................................................................14
3.3.1 Getting OpenOCD........................................................................................................................................15
3.3.2 Drivers and driver installation....................................................................................................................16
3.3.3 Driver installation in Windows................................................................................................................... 17
3.3.4 Driver installation in Linux.........................................................................................................................19
3.3.5 Driver installation in MAC OS X............................................................................................................... 19
3.3.6 How to uninstall and clean-up previously installed drivers.....................................................................20
3.4 Basic OpenOCD connection........................................................................... 21
3.4.1 Simple target connection via FTDI drivers................................................................................................21
3.4.2 Simple target connection via LibUSB drivers........................................................................................... 22
3.4.3 Simple SWD target connection with ARM-JTAG-SWD.......................................................................... 23
3.5 Advanced OpenOCD practices.......................................................................23
3.5.1 Using multiple ARM-USB-OCD interfaces................................................................................................23
3.5.2 Changing the VID and 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 Suite (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 manual
CHAPTER 5: REVISION HISTORY AND SUPPORT........................................ 31
5. Introduction to the chapter...............................................................................31
5.1 Document revision........................................................................................... 31
5.2 Useful web links and purchase codes.............................................................31
5.3 Product support............................................................................................... 33
Page 4 of 33
OLIMEX© 2015
ARM-USB-OCD user's manual
CHAPTER 1: OVERVIEW
1. Introduction 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 similar 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 applies for both debuggers, unless it is specifically stated otherwise.
1.1 Features
The debuggers have the following features:
•
Debug all ARM microcontrollers with JTAG interface supported by OpenOCD
•
Use ARM's standard 2×10 pin JTAG connector
•
Support ARM targets working in voltage 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
•
Able to power a target board via a standard DC barrel jack; cable for the external powering
included – 2.1×5.5×14mm female connectors at both ends
•
Downloadable Windows installer for full featured and open source tools as alternative to the
commercial ARM development packages: GCC C compiler, OpenOCD debugger and
Eclipse IDE.
•
Work with IAR EW for ARM via GDB server
•
Work with Rowley Crossworks IDE
•
Work with CooCox IDE
•
Supported in Windows, Linux and Mac
•
Dimensions (50×40)mm ~ (2×1.6)" + 20 cm ~ (8") JTAG cable – ribbon cable included
ARM-USB-OCD-H has these specific features over the ARM-USB-OCD:
•
High speed USB 2.0 with lower latency time, RTCK adaptive JTAG clock up to 30Mhz and
higher throughput achieve x3-x5 times faster programming speed than ARM-USB-OCD
•
Works with lower voltage targets (down to 1.65V); the ARM-USB-OCD can't debug targets
working at voltage levels lower than 2V.
ARM-USB-OCD has this specific feature over ARM-USB-OCD-H:
•
A jumper that allows you to change the voltage provided to the target. It can power 5V, 9V
or 12V targets; ARM-USB-OCD-H can provide only 5V to the target.
Page 5 of 33