diff options
author | Dominik Riebeling <Dominik.Riebeling@gmail.com> | 2021-12-15 21:04:28 +0100 |
---|---|---|
committer | Dominik Riebeling <Dominik.Riebeling@gmail.com> | 2021-12-24 18:05:53 +0100 |
commit | c876d3bbefe0dc00c27ca0c12d29da5874946962 (patch) | |
tree | 69f468a185a369b01998314bc3ecc19b70f4fcaa /utils/e200rpatcher/README | |
parent | 6c6f0757d7a902feb293be165d1490c42bc8e7ad (diff) | |
download | rockbox-c876d3bbefe0dc00c27ca0c12d29da5874946962.tar.gz rockbox-c876d3bbefe0dc00c27ca0c12d29da5874946962.zip |
rbutil: Merge rbutil with utils folder.
rbutil uses several components from the utils folder, and can be
considered part of utils too. Having it in a separate folder is an
arbitrary split that doesn't help anymore these days, so merge them.
This also allows other utils to easily use libtools.make without the
need to navigate to a different folder.
Change-Id: I3fc2f4de19e3e776553efb5dea5f779dfec0dc21
Diffstat (limited to 'utils/e200rpatcher/README')
-rw-r--r-- | utils/e200rpatcher/README | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/utils/e200rpatcher/README b/utils/e200rpatcher/README new file mode 100644 index 0000000000..1942b3aa7a --- /dev/null +++ b/utils/e200rpatcher/README | |||
@@ -0,0 +1,48 @@ | |||
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 | |||