rockbox

History

Dominik Riebeling 1af18d52af Support building beastpatcher with MinGW. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20960 a1c6a512-1295-4272-9138-f99709370657		2009-05-16 10:51:20 +00:00
..
beastpatcher.c	Initial (untested) attempt at a Windows version. The MTP_DLL.dll library needs expanding to offer the same API as mtp_libmtp.c, but this needs someone with access to a MS compiler. Ideally we should also stop using a separate DLL and compile a single standalone beastpatcher.exe.	2009-02-22 23:35:29 +00:00
Makefile	Support building beastpatcher with MinGW.	2009-05-16 10:51:20 +00:00
mtp_common.h	Initial (untested) attempt at a Windows version. The MTP_DLL.dll library needs expanding to offer the same API as mtp_libmtp.c, but this needs someone with access to a MS compiler. Ideally we should also stop using a separate DLL and compile a single standalone beastpatcher.exe.	2009-02-22 23:35:29 +00:00
mtp_libmtp.c	Initial (untested) attempt at a Windows version. The MTP_DLL.dll library needs expanding to offer the same API as mtp_libmtp.c, but this needs someone with access to a MS compiler. Ideally we should also stop using a separate DLL and compile a single standalone beastpatcher.exe.	2009-02-22 23:35:29 +00:00
mtp_win32.c	Initial (untested) attempt at a Windows version. The MTP_DLL.dll library needs expanding to offer the same API as mtp_libmtp.c, but this needs someone with access to a MS compiler. Ideally we should also stop using a separate DLL and compile a single standalone beastpatcher.exe.	2009-02-22 23:35:29 +00:00
README	Initial (untested) attempt at a Windows version. The MTP_DLL.dll library needs expanding to offer the same API as mtp_libmtp.c, but this needs someone with access to a MS compiler. Ideally we should also stop using a separate DLL and compile a single standalone beastpatcher.exe.	2009-02-22 23:35:29 +00:00
TODO	Initial version of a BSD-licensed beastpatcher utility for Gigabeat S installation. Currently only compiles on Linux, but Windows and OS X support are planned.	2009-02-22 13:54:46 +00:00

README

beastpatcher - a tool for installing the Rockbox bootloader on the Gigabeat S

Unlike most other parts of the Rockbox project, this tool is
distributed under the BSD license.  This is due to the fact that the
Windows version links with the Microsoft MTP library.



Building instructions - All OSes
--------------------------------

For all versions, you need to copy a "bootloader.bin" file (containing
the Rockbox bootloader) into this directory.

This can be built from the Rockbox source by selecting "41" and then
"B" when running tools/configure.

You need the Rockbox toolchain to build any Rockbox target binaries -
this can be downloaded and built with the tools/rockboxdev.sh script.

The latest officially released bootloader can always be downloaded from:

http://download.rockbox.org/bootloader/gigabeat-s/



Linux
-----

The Unix versions requires libmtp, which in turn requires libusb.

beastpatcher is built to statically link to these libraries and
expects them to exist as /usr/lib/libmtp.a and /usr/lib/libusb.a
respectively.  Change the definition of LIBS in the Makefile if this
is not the case for your system.

After this, just type "make" to get a 



OS X
----

[Not yet implemented]

The OS X build is a universal binary statically linked with libusb and libmtp.



Windows
-------

The MTP_DLL.dll requires VC2005 to compile - see instructions in
MTP_DLL/README

To compile beastpatcher itself, you can either cross-compile from
Linux using the mingw32 package, or compile in Cygwin.  Just type
"make beastpatcher.exe" (in Linux) or "make" (in Cygwin).

To run beastpatcher.exe, you need MTP_DLL.dll in the same directory
(or the Windows DLL path).