USBDM Coldfire V2,3,4/DSC/Kinetis Debugger and Programmer -- MC9S08JS16

Introduction

The attached files provide a port of a combined TBLCF/DSC code to a MC9S08JS16 processor. The primary motivation for this was to produce a single BDM that could be used with a range of Freescale microcontrollers. Other features have also been added. The software may also be used to provide an on-board BDM for the Axiom MCF8006Demo board. Strangely, this board has a complete DSC BDM built-in but the firmware is not present. You will need a HCS08 BDM to do this upgrade - No warranty - do this at your own risk.

---

Quick Links

• Release versions of the software for the various BDMs are available on Sourceforge.
• Various stand-alone programmers are provided to support the USBDM hardware.
• Source code is available on GitHub
• Post queries on OSBDM and TBDML Discussion Board

---

Features

This version of the code & BDM hardware provides the following features:

• A single BDM interface for programming and debugging of the following targets:
  • Coldfire V2, V3 & V4 microcontrollers
  • Kinetis ARM-Cortex microcontrollers
  • MC56F80xx Digital Signal Controllers (Limited range of devices in CW 10 & stand-alone programmer)
• No re-flashing of the BDM is required when changing between targets
• Compatible IDEs
  • Codewarrior V10.1 (Eclipse version)
    • Tested on Windows-XP-32bit, Windows-7-32bit, Windows-7-64bit
    • Tested on Ubuntu-32-bit
  • Codewarrior Legacy versions CW for Coldfire V7.1 CodeWarrior for DSC56800E v8.3 (USBDM-JMxx-CF or MC56F8006Demo board only)
    • Tested on Windows-XP-32bit, Windows-Vista-32bit
  • Initial support for CodeSourcery Lite for Coldfire
    • Tested on Windows-XP-32bit
  • Initial support for Coldfire Flasher (CFFlasher)
    • Tested on Windows-XP-32bit
• Higher USB communication speed cf. JB16 version BDMs (USB full speed cf. USB low speed)
• Vista compatible
• Linux compatible
• Initial Firmware programming may be done without a BDM using the JS16 USB bootloader ROM.
• The Firmware in the BDM may be automatically updated using an in-circuit-programming (ICP) feature.
• Hardware is physically small
• HCS12, HCS08, RS08, Coldfire V1 specific features:
• Target reset detection & control (required for HC12 processors). This allows HC12 processors to be reset into BDM mode as required for debugging.
  • A higher BDM interface speed than the existing JB16 OSBDMs. Up to 56MHz. (BDM clock 28MHz).
  • Automatic re-connection. The software has an option to continuously update the interface speed to prevent loss of communication if the target BDM interface speed changes (as may occur with clock changes on some targets).
  • Control of BDM clock selection in HC12/HCS08/Coldfire microcontrollers. Most of these targets provide an alternative BDM clock selection. This can have advantages when connecting to high speed targets as the alternative clock may operate at a lower speed.
  • Trial-and-error determination of communication speed for earlier HC12 targets.
  • User prompting for target supply cycling with BKGD low as may be needed for HCS08 targets
• Coldfire V2,3,4 specific features and limitations:
• Higher communication speed with target - The target communication speed may be selected.
• The BDM uses asychronous communication with the target i.e. the BDM signals are not synchronized with the target clock. This means that the BDM should not be used with early Coldfire targets. Check the description of the BDM interface timing in the appropriate Coldfire Processor manual to determine if this limitation applies.

Hardware Design

Please refer to the following document for hardware design details:

• USBDM Design with Serial interface - Schematics, Assembly Overlays & Bill of Materials
• USBDM Design - Schematics, Assembly Overlays & Bill of Materials

Differences to JB16 TBLCF etc

• The PCB artwork provided is for a double-sided plated-through-hole board using surface mount components. This seems a reasonable decision since the processor is only available in a SMT package in any case. It is possible to prototype the board using a non-PTH board but the required vias may present problems as they are beneath components and need to be replaced with feed through wires. 
  The above images are for a milled board that was hand assembled.
• Software drivers (tblcf.dll etc) need to be installed so that advantage can be taken of the new features.

Credits

• Some of the code is based upon the TBLCF and OSBDM-JM60 projects and I very much appreciate the effort involved in producing the original code. I hope this extension will be useful.

References

• Altium Designer (PCB Design) - http://www.altium.com/products/altium-designer/
• Axiom MC56F8006 Demo board - http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=MC56F8006DEMO
• Codesourcery - http://www.codesourcery.com/
• Coldfire Flasher - http://www.freescale.com/files/soft_dev_tools/software/programmers/CFFLASHER.zip
• Doxygen Documentation tool - http://www.stack.nl/~dimitri/doxygen/index.html
• I2C voltage level conversion - Phillips application note http://www.standardics.nxp.com/support/documents/i2c/pdf/an97055.pdf
• LIBUSB-WIN32 - http://libusb-win32.sourceforge.net/
• MAX662 Data sheet - http://www.maxim-ic.com
• OSBDM - http://forums.freescale.com/freescale/board?board.id=OSBDM08
• OSBDM hardware - http://forums.freescale.com/freescale/board/message?board.id=OSBDM08&thread.id=212
• Tasking GDI Spec - http://www.tasking.com/resources/technologies/debuggers/gdikdi.shtml
• Tcl/Tk - http://www.tcl.tk/software/tcltk/8.5.html
• TBDML - http://forums.freescale.com/freescale/board?board.id=TBDML
• TBDML hardware - http://forums.freescale.com/freescale/board/message?board.id=TBDML&thread.id=2
• USBSPYDER08 - USB mini board for Freescale's Low-End 8-bit Microcontrollers - http://www.freescale.com/
• Ultimate Packer for eXecutables (UPX) has been used to pack DLLs and EXEs - http://upx.sourceforge.net/
• WTBDMS08/12 (Witztronics) Hardware - http://www.witztronics.com/
• WxWidgets Cross Platform Library has been used for the GUI - http://www.wxwidgets.org/
• Xerces XML parser - http://xerces.apache.org/xerces-c