USBDM  V4.10.6.170
USBDM Debugger interface for Freescale RS08,HCS08,HCS12,Coldfire and ARM-Kinetis Devices.

Introduction

USBDM is a debugger hardware interface for a range of Freescale microcontrollers. It is designed to work with Freescale's Codewarrior software under Windows and Linux. More recently basic support for Coldfire and Kinetis with the Codesourcery Tool chain or ARM Ltd GNU Tools for ARM has been added. A set of stand-alone programmers are also provided.

The attached files provide a port of a combined TBDML/OSBDM/TBLCF code to various processors. The primary motivation for doing this was to produce a single BDM that could be used with the following processors:

  • RS08
  • HCS08,
  • HC12,
  • Coldfire V1-4 microcontrollers
  • MC56F800xx Digital Signal Controllers (very limited range of devices).
  • Kinetis ARM-cortex

Other features have also been added compared to the original TBDML/OSBDM designs.

This site contains links to Version 4 of the following:

  • A set of software drivers for MS windows and Linux that work with various version of the Freescale Codewarrior IDE, including the latest Eclipse version.
  • Standard-alone programmers.
  • A description of, and design files for, several versions of suitable BDM hardware
  • The firmware required for the above BDM hardware.

Quick Links


JS16 based versions (Current designs)

The following two designs & variations use the MC9S08JS16CWJ (20 pin SOIC).
This chip is USB2 Full speed and supports initial programming over USB without needing a BDM.

Minimal design - Supports HCS12, HCS08 and Coldfire V1 Minimal design - Supports HCS12, HCS08, Coldfire V1 and Kinetis (via SWD)

  • These are two alternative designs using a MC9S08JS16CWJ (20 pin SOIC).
  • It is easier to construct than the JMxx version
  • It may be programmed over the USB connection and doesn't require a BDM for initial programming.
  • It replaces the Minimal JB16 designs and is recommended (by me) for newbies!
  • A PCB design is supplied but is should be possible to roll-your-own on a prototyping board.
  • An alternative, larger design is provided that supports Serial over USB (CDC interface) and Kinetis via SWD.

Minimal design - Supports Coldfire V2,3,4, Kinetis(via JTAG) and DSC (M56F80xx only)

  • This is a minimal design using a MC9S08JS16CWJ (20 pin SOIC).
  • It is easier to construct than the JMxx version
  • It may be programmed over the USB connection and doesn't require a BDM for initial programming.
  • It is approximately equivalent to the earlier JB16 based TBLCF design in functionality.
  • A PCB design is supplied but is should be possible to roll-your-own on a prototyping board.
  • An alternative, larger design is provided that supports Serial over USB (CDC interface).

JMxx based versions (Current designs)

The following designs use the MC9S08JM60CLD (44 pin LQFP).
This chip is USB2 Full speed and requires a HCS08 BDM for programming the device.

USBDM-CF - Supports HCS12, HCS08, RS08 & Coldfire V1, V2, V3 & V4, Kinetis(via JTAG) and MC56F80xx

  • This is a complete fully-featured design using a MC9S08JM60CLD (44 pin LQFP).
  • It has target power and various other options.
  • It REQUIRES a BDM for initial programming.
  • Later firmware updates may be done over the USB

USBDM-TWR-xxxx - Supports various Freescale Tower systems

  • This supports the OSBDM-JM60 hardware as used in various Freescale Tower systems.
  • Allows use of the stand-alone USBDM programmers with Tower boards.
  • Significant speed improvement over OSBDM with some targets.
  • Serial port support uses the standard USB CDC interface and so serial ports appear as the usual COM devices under Windows and Linux.
    This means they may be used with standard serial programs such as Hyperterminal and within a Terminal window in Codewarrior Eclipse.

MK20DX128 based versions (Current designs)

The following design use the MK20DX128 present on various Freescale FREEDOM boards (Arduino form factor).
This chip is USB2 Full speed and the chips on the Freedom boards include a pre-rogrammer bootloader (OpenSDA) that allows installation of USBDM without a programmer.

USBDM_OpenSDA - Supports various Freescale Freedom boards

  • This supports the OpenSDA hardware as used in various Freescale Freedom systems.
  • Allows use of the stand-alone USBDM programmers with FRDM boards.
  • The Freedom board may be used to Open source tool chains such as Codesourcery or ARM Ltd GNU tools.
  • The Freedom board may be used as a programmer for external devices (with the addition of a cable and header).
  • Serial port support uses the standard USB CDC interface and so serial ports appear as the usual COM devices under Windows and Linux.
    This means they may be used with standard serial programs such as Hyperterminal and within a Terminal window in Codewarrior Eclipse or Eclipse Juno (with suitable plugin).

JB16 based versions (These design are longer recommended)

These versions were mainly produced to be compatible with the previous hardware versions of TBDML or OSBDM which were based on the MC908JB16. This is a USB low speed device. The provided firmware versions allow (some) of these devices to be updated to a combined TBDML/OSBDM. It also allows these to be used with the new Eclipse-based Codewarror which does not support the original osbdm or tbdml.

There are several hardware designs supplied :

  • Complete USBDM - Supports HCS12, HCS08, RS08 & Coldfire V1
    • This is a complete fully-featured design using MC68HC908JB16DW (28 pin SOIC)
  • Minimal TBDML 20pin SOIC - Supports HCS12, HCS08, Coldfire V1
    • This is a very minimal design using MC68HC908JB16DW (28 pin SOIC)
  • Minimal TBDML 28pin SOIC - Supports HCS12, HCS08, Coldfire V1
    • This is a very minimal design using MC908JB16JDWE (20 pin SOIC)

BDM firmware versions are also supplied to support several existing hardware designs by other people:

  • WTBDM08/12
    • A commercial design available from Witztronics.
  • OSBDM
    • A previous design posted on Freescale OSBDM board
  • HCS08-OSBDM+E
    • A previous design posted on Freescale OSBDM board

Device Characteristics and links to documentation

The table below shows the support provided by each version and provides links to further information.


Description


Current Design

Device Support

Features

RS08

HCS08, HCS12, CFV1

Kinetis

CFV2, CFV3, CFV4*

DSC*

Target Power

Serial Port

USBDM_JB16

No

X

USBDM_CF_JMxxCLD

No

X

X

JTAG

X

X

X

USBDM_SER_JS16CWJ

No

X

X

USBDM_CF_SER_JS16CWJ

No

X

JTAG

X

X

USBDM_JMxxCLC

No

X

X

X

USBDM_JMxxCLD

No

X

X

X

USBDM_JS16CWJ

Yes

X

USBDM_SWD_JS16CWJ

Yes

X

SWD

USBDM_SWD_SER_JS16CWJ

Yes

X

SWD

X

X

USBDM_CF_JS16CWJ

Yes

JTAG

X

X

USBDM_CF_JMxxCLD_V3
Also supports Tower systems.

Yes

X

X

JTAG

X

X

X

X

USBDM_OpenSDA
Custom OpenSDA (FRDM-KL25Z).

Yes

SWD

X


* DSC support is very limited in Codewarrior 10 and the stand-alone programmer
* CFV2,3,4 support is limited in the stand-alone programmer

Other Links


Notes

  • Please note that these design are different from the Freescale OSBDM-JM60 design which was proceeding independently while I was doing the above designs.

Revision History

History & Issues

Credits

The bulk of the code is taken from the TBDML, OSBDM and TBLCF projects and I very much appreciate the effort involved in producing the original code. I hope this extension will be useful.

The hardware interface is based on TBDML, Freescale USBSPYDER08 and my own invention.

References

Queries

Any queries please post on the Freescale OSBDM Discussion Board.

Some Commercial versions of USBDM BDMs

I am aware of several companies producing commercial versions of USBDMs of various kinds:

The software may be used to "upgrade" the Axiom MC56F8006 Demo board to enable the on-board BDM.


License

   Portions of this software is based on TBLCF software
   Portions of this software is based on OSBDM software
   Portions of this software is based on TBDML software

   USBDM
   Copyright (C) 2007-12  Peter O'Donoghue

   Opensource BDM (OSBDM)
   Copyright (C) ?

   Turbo BDM Light (TBDML)
   Copyright (C) 2005  Daniel Malik

   Turbo BDM Light ColdFire (TBLCF)
   Copyright (C) 2005  Daniel Malik

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA