Fuzev2: revert r25741 and r25746
[kugel-rb.git] / rbutil / mkamsboot / README
blobfd81297e06e8ffec67e15e4917a36f83e117fa9b
1 mkamsboot
2 ---------
4 A tool to inject a bootloader into a Sansa V2 (AMS) firmware file.
7 Usage
8 -----
10 mkamsboot <firmware file> <boot file> <output file>
12 <firmware file> is an original Sansa firmware file obtained from the Sansa
13     forums for example : http://forums.sandisk.com/sansa/?category.id=devices
15 <boot file> is the code you want to execute (a rockbox bootloader), previously
16     scrambled with tools/scramble utility.
18 <output file> is the resulting firmware file which you'll have to copy on your
19     Sansa player. See "Firmware filenames".
22 Supported models
23 ----------------
25 Sansa Clip  :   firmware version starting with "01."
26 Sansa Clip+ :   firmware version starting with "01."
27 Sansa Clipv2:   firmware version starting with "02."
28 Sansa Fuze  :   firmware version starting with "01."
29 Sansa Fuzev2:   firmware version starting with "02."
30 Sansa E200v2:   firmware version starting with "03."
31 Sansa C200v2:   firmware version starting with "03."
32 Sansa M200v4:   firmware version starting with "4."
35 Firmware filenames
36 ------------------
38 For the firmware upgrade to happen, the firmware has to be named specially:
40 clip v2 :   m30pa.bin
41 clip    :   m300a.bin
42 clip+   :   clppa.bin
43 fuze    :   fuzea.bin
44 fuzev2  :   fuzpa.bin
45 e200v2  :   e200pa.bin
46 c200v2  :   c200pa.bin
47 m200v4  :   m200a.bin
50 Dual-Boot
51 ---------
53   The purpose of this program is to provide dual-boot between the original
54 firmware and the new (rockbox) firmware.
56   By default the player will boot into the new firmware.
58   To boot into the Original Firmware, you need to press the Left key.
59   ***Note : on the c200v2 you need to press the Right key.
60   ***Note : on the Clip+ you can alternatively press the Home key.
62   The player will boot into the Original Firmware as well if it is powered up by
63 inserting an usb cable.
64   ***Note : on the m200v4 and Clip+, powering up by usb will cause booting into
65 the new firmware.
67 Hacking
68 -------
70 See comments in mkamsboot.c and dualboot/dualboot.S for more information.