Open On-Chip Debugger - OpenOCD

Open On-Chip Debugger support on OS X

Home > Robert_Rau.html
Links >Links.html


Visit my other pages:

Electronic Design ToolsElectronics.html
Rocketry ApplicationsRocketry.html
Green LivingEco.html

If you have any comments or know of links I should add, please feel free to email me.

Developing Mac ApplicationsDesktopProgLinks.html
Lego StuffLego.html

OpenOCD is a software project started by Dominic Rath several years ago. It is now a open source project and the source can be downloaded from here. It now connects to several target machines through many debug/programming interfaces. A list of supported targets can be found in chapter 6 of the documentation. Below are programming/debugging interfaces that mention OS X compatibility. Instructions here (I prefer the homebrew process, see below):

Don’t use a pre-compiled binary, or you will get an old versions of OpenOCD. Open OCD is updated frequently.

To install, first make sure you have the folder /usr/local. If not, create it with sudo mkdir /usr/local. Then:

sudo chown -R $(whoami) /usr/local/*

brew install --HEAD openocd

For some JTAG interfaces (like CMSIS DAP) you will also need to install the HDI API:

brew install hidapi

If you are new to building your own tools, you might want to look at my Command Line Tips page.

Bus Pirate

The Bus Pirate is accessed from a command line in a OS X terminal. When powered up all I/O lines are high impedance. From there, a bus mode can be selected to use the Bus Pirate with a specific protocol. Bus modes : 1-Wire, UART, I2C, SPI, raw 2-wire, raw 3-wire, HD44780 LCDs, MIDI, PC keyboard, DIO, JTAG.

Bus Pirate can be purchased in the USA from:

Tutorial for use on OSX:

Bus Pirate firmware information:

Other Tutorial sites for OpenOCD on OS X

NoICE Debugger:

AVR on Egnite’s AVR based Internet Radio:

Blog for the STM32 ARM using OpenOCD on OS X:

Summary of OpenOCD on OS X 10.5:

YAGARTO ARM Tool chain using Eclipse and OpenOCD:

Several articles about using the Freescale Freedom board with Eclipse & OpenOCD on non-Windows machines :

USB to Chip Adapters compatible with OpenOCD

All FTDI Based Adapters

Many evaluation boards use a FTDI chip for USB to JTAG communications. FTDI makes two kinds of drivers, the VCP version for serial port emulation, and the D2XX version which are more general and designed for dynamic libraries. To use the JTAG features you need the D2XX version. There are compatibility issues between the two, see the FTDI read me here.

Download the D2XX version:

Embedded Programming on the Mac >MacEmbeddedLinks.html


Three-in-one USB JTAG debugger - offers JTAG + RS232 (full modem signals supported) port + power supply all in one compact device.


ARM GCC + gdb + OpenOCD tool chain build (without MacPorts)

Build a Texas Instruments Stellaris tool chain on OS X without using macports. Macintosh OS X.

USB-AtmelPrg: Wolfgang's Universal Interface Cable

USB-AtmelPrg is a USB-based universal interface providing all features needed when designing with programmable devices like AVR 8-bit RISCs via SPI, XILINX CPLDs and 32-bit ARMs via JTAG port.

Bus Blaster

Bus Blaster v2 is an experimental, high-speed JTAG debugger from Dangerous Prototypes.


Turtelizer is an JTAG debugger from Ethernut. Its connector uses the AVR 10 pin pinout.

Turtelizer, OPENOCD, and the Ethernut 3:


JTAG and serial port to work under Mac OS X using an Olimex ARM-USB-OCD.


Atmel based target adapter.


Bus Blaster v2 is an experimental, high-speed JTAG debugger from Dangerous Prototypes.

Flyswatter & Flyswatter2

Flyswatter support ARM and the Flyswatter2 supports ARM and MIPS.


NXP offers the LPC-Link2 board. Only $25.00. This can be programmed with several different firmware options, including three different JATAG/SWD options. The ARM Limited CMSIS DAP SWD programmer firmware has no use restrictions allowing it to be used for commercial use. See:

The utility to program the LPC-Link2 is LPCScrypt, the CMSIS DAP image is build in.

Particle Debugger

Adafruit has this programmer board with connectors for power and a UART too. Only $20.00. See:

To use OpenOCD as a stand-alone device programmer

I struggled with trying to program a NXP MKL27Z256VFM4 MCU. The MKL27 is a one wait state FLASH with fast multiply CORTEX M0+ MCU. This is when I learned you want a fresh build of OpenOCD from source. The 10.0 release was missing the ability to turn off the watchdog reset for the MKL... family, so programming would start and then get reset. I wrote a OpenOCD cfg file with all the interface, transport, and device information is a single cfg file. I also choose to make it the default cfg file by naming it openocd.cfg in the current directory. I choose to use a CMSIS DAP compatible programmer (The NXP LPC-Link2) which can many any ARM devices.

You can download my cfg file openocd.cfg.