Tutorial - Using the USBDM

Author: Joel - MyFreescaleWebPage http://myfreescalewebpage.free.fr Last revision of this document: 1.3 of 2013-10-13.

Table of contents
Revisions ................................................................................................................................................. 2 Introduction ............................................................................................................................................ 3 1 2 3 Download the USBDM installation files ............................................................................................ 5 Installation of the USBDM ................................................................................................................ 5 Flashing the USBDM firmware ....................................................................................................... 13 3.1 3.2 4 5 Flashing the USBDM firmware with an external tool............................................................... 13 Flashing the USBDM firmware with the internal bootloader of the HCS08JS16 microcontroller 13

Updating the USBDM firmware ...................................................................................................... 16 Programming microcontrollers ...................................................................................................... 18 5.1 5.2 Using standalone programmer ............................................................................................... 18 Using Freescale CodeWarrior ................................................................................................. 21

Conclusion............................................................................................................................................. 22 Appendix A - Uninstalling the USBDM .................................................................................................... 23

Revisions
Version 1.0 1.1 1.2 1.3 Date 2013-02-26 2013-05-08 2013-06-02 2013-10-13 Changes First release (USBDM 4.10.4) Update (USBDM 4.10.5) Update (USBDM 4.10.5b - Released due to some issues with 4.10.5) Update (USBDM 4.10.6c for CodeWarrior 10.5)

MyFreescaleWebPage

Tutorial - Using the USBDM

Introduction
The USBDM is an open source programming cable for Freescale microcontrollers. The USBDM is released by PGO, all source files, firmware, schematics are available on http://usbdm.sourceforge.net. Several hardware versions are available depending of the targets you want to program. It is possible to build your own USBDM. If you want to begin with Freescale microcontrollers, I recommend you to get this cheap but powerful USBDM cable, compatible with HCS08, HCS12 and CFV1 microcontrollers, from BlackBoxStudio seller on eBay: http://www.ebay.fr/itm/Freescale-DebuggerProgrammer-for-HCS08-HCS12-Coldfire-V1-/110958979630?.

TheUno and BigBrother evaluation boards are based on the USBDM with an additional serial port used to communicate with the target.

MyFreescaleWebPage

Tutorial - Using the USBDM

The following USBDM (found on eBay) is able to program RS08, HCS08, HCS12, CFV1, CFV2, CFV3, CFV4, Kinetis and DSC microcontrollers and is able to supply the target with 3.3 or 5V voltage.

This tutorial explains how to use the USBDM: installation, update, programming the target with standalone software and Freescale CodeWarrior.

MyFreescaleWebPage

Tutorial - Using the USBDM

1 Download the USBDM installation files

Today the he last USBDM release is V4.10.6c. V4.10. . The installation files are available on Sourceforge on the following page: http://sourceforge.net/projects/usbdm/files/Version%204.10.6/Software http://sourceforge.net/projects/usbdm/files/Version%204.10.6/Software.

Download the USBDM Installer and the right USBDM Drivers according to your computer.

2 Installation of the USBDM

Please note that it is recommend to remove your previous USBDM installation before installing the last version. See "Appendix A - Uninstalling the USBDM" for more details.

MyFreescaleWebPage

Tutorial - Using the USBDM

Execute the installer.

. A wizard is displayed. Click Next.

MyFreescaleWebPage

Tutorial - Using the USBDM

Accept the License Agreement and click Next.

It is possible to custom the installation.

MyFreescaleWebPage

Tutorial - Using the USBDM

I have only verified that the installer detected my CodeWarrior installation (Eclipse Special Edition V10.5) has shown on the following screenshot. Click Next to perform the USBDM installation.

Click Install.

MyFreescaleWebPage

Tutorial - Using the USBDM

The setup takes several minutes to complete.

The installation ends. Click Finish to close the wizard. wiz

MyFreescaleWebPage

Tutorial - Using the USBDM

It's now time to install the USBDM Drivers. Execute the right USBDM Drivers installer according to your configuration (Windows XP or not, not x86 or x64 operating system).

A wizard is displayed. Accept the License Agreement and click Install.

MyFreescaleWebPage

Tutorial - Using the USBDM

10

The wizard install the USBDM Drivers.

Window can't verify the publisher of the driver software. Validate the installation.

MyFreescaleWebPage

Tutorial - Using the USBDM

11

The installation takes only some few seconds. The wizard says that it is now possible to connect the USBDM. Click OK.

Click Finish to close the wizard.

The installation is finished. USBDM shortcuts are available in the start menu.

MyFreescaleWebPage

Tutorial - Using the USBDM

12

3 Flashing the USBDM firmware

The microcontroller of the USBDM must be programmed with the right USBDM firmware. The table below present several USBDM versions and their features. Description USBDM_JS16CWJ USBDM_SER_JS16CWJ USBDM_SWD_JS16CWJ USBDM_SWD_SER_JS16CWJ USBDM_CF_JS16CWJ USBDM_CF_SER_JS16CWJ USBDM_CF_JMxxCLD_V3 Based On HCS08JS16 HCS08JS16 HCS08JS16 HCS08JS16 HCS08JS16 HCS08JS16 HCS08JM60 Supported Devices & Features HCS08, HCS12, CFV1 HCS08, HCS12, CFV1 - Serial Port HCS08, HCS12, CFV1, Kinetis HCS08, HCS12, CFV1, Kinetis - Target Power, Serial Port CFV2, CFV3, CFV4, Kinetis, DSC HCS08, HCS12, CFV1, CFV2, CFV3, CFV4, Kinetis, DSC - Serial Port RS08, HCS08, HCS12, CFV1, CFV2, CFV3, CFV4, Kinetis, DSC - Target Power, Serial Port Firmware USBDM_JS16CWJ_V4 USBDM_SER_JS16CWJ_V4 USBDM_SWD_JS16CWJ_V4 USBDM_SWD_SER_JS16CWJ_V4 USBDM_CF_JS16CWJ_V4 USBDM_CF_SER_JS16CWJ_V4 USBDM_CF_JMxxCLD_V4

The USBDM schematics and firmware are available in the "BDM Flash Images" directory of the USBDM installation (a shortcut is available in the start menu following the installation of the USBDM). The USBDM based on the HCS08JM60 microcontroller must be flashed using an external tool (another USBDM for example). The USBDM based on the HCS08JS16 microcontroller can be flashed using the internal USB bootloader present in this device.

3.1 Flashing the USBDM firmware with an external tool

This will depend of the programmer used. You can refer to the 5 "Programming microcontrollers" if you are using another USBDM.

3.2 Flashing the USBDM firmware with the internal bootloader of the HCS08JS16 microcontroller
The internal bootloader of the HCS08JS16 microcontroller is very convenient and can be used to flash the USBDM firmware. The internal bootloader is a specific peripheral and is always available. First short the BLMS pin of the HGCS08JS16 microcontroller to the ground. As shown below, on TheUno it is done by shorting X3 with a simple jumper. Adapt this step to your own USBDM. Please note that this is not necessary if the USBDM is blank (never programmed before), because it is starting by default with the internal bootloader in this case.

MyFreescaleWebPage

Tutorial - Using the USBDM

13

Now connect the USBDM to your computer. A new peripheral called "JS16" is detected and automatically installed. Start "JS16 First Level Bootloader" utility.

MyFreescaleWebPage

Tutorial - Using the USBDM

14

Select the right firmware according to your USBDM. Description USBDM_JS16CWJ USBDM_SER_JS16CWJ USBDM_SWD_JS16CWJ USBDM_SWD_SER_JS16CWJ USBDM_CF_JS16CWJ USBDM_CF_SER_JS16CWJ Firmware USBDM_JS16CWJ_V4 USBDM_SER_JS16CWJ_V4 USBDM_SWD_JS16CWJ_V4 USBDM_SWD_SER_JS16CWJ_V4 USBDM_CF_JS16CWJ_V4 USBDM_CF_SER_JS16CWJ_V4 BDM Firmware choice HCS08/HCS12/CFV1 HCS08/HCS12/CFV1 + Serial HCS08/HCS12/CFV1/ARM-SWD HCS08/HCS12/CFV1/ARM HCS08/HCS12/CFV1/ARM-SWD HCS08/HCS12/CFV1/ARM + Serial CFVx/DSC/ARM_JTAG CFVx/DSC/ARM_JTAG + Serial

Click "Program" to flash the USBDM. Wait some few seconds. The following message is finally displayed to indicate that the USBDM has been correctly flashed.

Click "OK" and disconnect isconnect the USBDM. It is now possible to use the USBDM.

MyFreescaleWebPage

Tutorial - Using the USBDM

15

4 Updating the USBDM firmware

Connect t the USBDM to your computer and start "USBDM Firmware Updater" utility. utility

MyFreescaleWebPage

Tutorial - Using the USBDM

16

You can check "Auto select BDM firmware" to automatically chose the right USBD DM firmware. Note that the Serial Number of the USBDM M will be set to its default value in this case. irmware yourself by clicking "Load Source File" button b and browsing to Instead, you can load the right fi the USBDM firmware. It is then possible p to set the Serial Number yourself or to click c "Read from device" to reuse the existing Serial Numb ber. This is very useful if you have several USBDM M because you will be able to use them at the same tim me on your computer by giving them different Se erial Number values.

Click on "Program Flash" h" button. The following window is displayed.

MyFreescaleWebPage

Tutorial - Using the USBDM

17

Click "OK" to validate. The USBDM reboots. On my computer this is sometimes failing and the following message is displayed.

Click ck "No" to cancel the operation and try again by pressing "Program Flash" button. button The firmware of the USBDM is updated and verified.

It is now possible to use the USBDM.

5 Programming microcontrollers
5.1 Using standalone programmer
Some applications are provided by PGO to program microcontrollers with the USBDM USBDM. The following example is done using TheUno, on which the target microcontroller is a HCS08DZ60 device.

MyFreescaleWebPage

Tutorial - Using the USBDM

18

Connect the USBDM and start "HCS08 HCS08 Programmer". Programmer". The following window is displayed. The USBDM has been detected. Click "Detect" if not.

MyFreescaleWebPage

Tutorial - Using the USBDM

19

Go to the "Target" tab. Click on "Detect Chip" to check the t target microcontroller.

Choose the right microcontroller in the device selection list ("DZ-MC9S08DZ60" ("DZ MC9S08DZ60" in this example).

MyFreescaleWebPage

Tutorial - Using the USBDM

20

Click on "Load Hex Files" s" to select the application you want to program. Finally click on "Program Flash".

The device is programmed and a message is displayed to indicate that the operation completed.

Click "No" and close the HCS08 Programmer utility.

5.2 Using Freescale CodeWarrior

It is possible to use the USBDM with Freescale CodeWarrior to load and debug applications. application

MyFreescaleWebPage

Tutorial - Using the USBDM

21

Simply choose the USBDM in the connection list during the creation of the project, as shown on the following screenshot (Freescale CodeWarrior V10. V10.5).

Then, it is possible to load and debug applications application with the USBDM as done if you were using any other tool.

Conclusion
The USBDM is a powerful device. It is regularly updated to support new microcontrollers. You are now ready to build your own n USBDM and use it to load and debug application applications on many Freescale devices.

MyFreescaleWebPage

Tutorial - Using the USBDM

22

Appendix A - Uninstalling the USBDM

Uninstalling the USBDM is done very simply using the Control Panel. Select UBSDM and click "Uninstall" button.

The USBDM is uninstalled.

MyFreescaleWebPage

Tutorial - Using the USBDM

23

Finally select USBDM Drivers and click "Uninstall" button.

The USBDM Drivers are uninstalled.

MyFreescaleWebPage

Tutorial - Using the USBDM

24