rockbox/utils/tcctool
Dave Chapman a5e4cc9e68 Document how to use tcctool in Windows, and include the appropriate .inf file for use with the libusb-win32 device driver
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@15559 a1c6a512-1295-4272-9138-f99709370657
2007-11-10 20:26:54 +00:00
..
tcctool-driver-win32 Document how to use tcctool in Windows, and include the appropriate .inf file for use with the libusb-win32 device driver 2007-11-10 20:26:54 +00:00
Makefile Initial version of tcctool - a utility for talking to Telechips TCC77x-based devices in USB boot mode, allowing code to be uploaded to RAM and run via USB, without any danger of bricking. When your uploaded code crashes, just power-cycle the device and it is back to normal. Requires libusb. 2007-10-20 09:11:34 +00:00
README Document how to use tcctool in Windows, and include the appropriate .inf file for use with the libusb-win32 device driver 2007-11-10 20:26:54 +00:00
tcctool-windows.txt Document how to use tcctool in Windows, and include the appropriate .inf file for use with the libusb-win32 device driver 2007-11-10 20:26:54 +00:00
tcctool.c Use O_BINARY when reading the firmware file - for win32 compatibility 2007-10-31 17:52:50 +00:00

/***************************************************************************
 *             __________               __   ___.
 *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
 *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
 *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
 *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
 *                     \/            \/     \/    \/            \/
 * $Id$
 *
 ****************************************************************************/

tcctool
-------

tcctool is a utility for uploading code to Telechips TCC77x based
devices in USB boot mode.

It has been tested on the iaudio 7 and Logik DAX DAB/MP3 Player, but
should work on other devices if the appropriate magic value is
identified from existing "firmware recovery" programs - see the
"devices" array in tcctool.c

It can be used for safely testing firmware images before performing a
firmware upgade.

A first test when using tcctool on a new device can be to upload the
original firmware.  If you do this, make sure you upload the same
version that is installed on your player - otherwise you may find
yourself with corrupted config files and music database.


Building for Windows
--------------------

1) Download libusb-win32-device-bin-0.1.12.1.tar.gz from:

http://sourceforge.net/project/showfiles.php?group_id=78138

2) Extract libusb-win32-device-bin-0.1.12.1.tar.gz in the tcctool
source directory.

3) Type "make tcctool.exe" to compile.

4) Copy the following four files from libusb-win32-device-bin-0.1.12.1/bin
to tcctool-driver-win32/

libusb0.dll
libusb0.sys
libusb0_x64.dll
libusb0_x64.sys

5) Create the tcctool-win32.zip file from the directory above tcctool as follows:

zip tcctool-win32.zip tcctool/tcctool.exe tcctool/tcctool-windows.txt tcctool/tcctool-driver/win32/*

6) See tcctool/tcctool-windows.txt for Windows usage instructions.