rbutil/e200rpatcher/README

   1 INTRODUCTION
   2
   3 e200rpatcher is a tool for uploading and executing an application to
   4 an E200R in manufacturing mode.  It is intended to be used to upload
   5 the patching application to allow Rockbox installs.
   6
   7 e200rpatcher requires libusb (v0.1.2 has been tested successfully) for
   8 cross-platform USB access.  No-one has yet successfully installed
   9 e200rpatcher on Windows, but it works on Linux and Mac OS X (and
  10 should be fine on other Unix-like systems that libusb supports).
  11
  12 GENERAL BUILD INSTRUCTIONS
  13
  14 A pre-requisite for compiling e200rpatcher is a file called
  15 "bootloader.bin" - this is the output of running an "I" (installer)
  16 build for the E200R target.
  17
  18 In the Rockbox source directory, do:
  19
  20 mkdir build-e200rbootbin
  21 cd build-e200rbootbin
  22 ../tools/configure
  23 [Select E200R, then I for installer]
  24 make
  25
  26 This should give you a bootloader/bootloader/bin file which you should
  27 copy to the e200rpatcher source directory.
  28
  29 BUILDING ON LINUX
  30
  31 The Makefile expects libusb (and the headers) to be installed on your
  32 system and will link dynamically.  Just type "make".
  33
  34 BUILDING ON A MAC
  35
  36 To build the mac version (target e200rpatcher-mac in the Makefile)
  37 requires three files from libusb to be copied to the current
  38 directory:
  39
  40 usb.h (copied from your libusb build directory)
  41 libusb-i386.a (copied and renamed from .libs/libusb.a in an i386 build)
  42 libusb-ppc.a (copied and renamed from .libs/libusb.a in a PPC build)
  43
  44 To build the required libusb.a files, just run ./configure && make for
  45 libusb.  If anyone knows how to cross-compile a static libusb.a please
  46 make the information known - this is currently done by compiling
  47 natively on the appropriate hardware.
  48