utils/tcctool/README

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  ****************************************************************************/
  11
  12 tcctool
  13 -------
  14
  15 tcctool is a utility for uploading code to Telechips TCC77x based
  16 devices in USB boot mode.
  17
  18 It has been tested on the iaudio 7 and Logik DAX DAB/MP3 Player, but
  19 should work on other devices if the appropriate magic value is
  20 identified from existing "firmware recovery" programs - see the
  21 "devices" array in tcctool.c
  22
  23 It can be used for safely testing firmware images before performing a
  24 firmware upgade.
  25
  26 A first test when using tcctool on a new device can be to upload the
  27 original firmware.  If you do this, make sure you upload the same
  28 version that is installed on your player - otherwise you may find
  29 yourself with corrupted config files and music database.
  30
  31
  32 Building for Windows
  33 --------------------
  34
  35 1) Download libusb-win32-device-bin-0.1.12.1.tar.gz from:
  36
  37 http://sourceforge.net/project/showfiles.php?group_id=78138
  38
  39 2) Extract libusb-win32-device-bin-0.1.12.1.tar.gz in the tcctool
  40 source directory.
  41
  42 3) Type "make tcctool.exe" to compile.
  43
  44 4) Copy the following four files from libusb-win32-device-bin-0.1.12.1/bin
  45 to tcctool-driver-win32/
  46
  47 libusb0.dll
  48 libusb0.sys
  49 libusb0_x64.dll
  50 libusb0_x64.sys
  51
  52 5) Create the tcctool-win32.zip file from the directory above tcctool as follows:
  53
  54 zip tcctool-win32.zip tcctool/tcctool.exe tcctool/tcctool-windows.txt tcctool/tcctool-driver/win32/*
  55
  56 6) See tcctool/tcctool-windows.txt for Windows usage instructions.