blob: a9eba35d21450f4cf26f05a880505167cbe6e781 [file] [log] [blame]
Dave Chapmanc6be8182008-10-04 08:46:03 +00001mkamsboot
2---------
3
Dave Chapman1c4bcfa2008-10-11 11:35:59 +00004A tool to inject a bootloader into a Sansa V2 (AMS) firmware file.
Dave Chapmanc6be8182008-10-04 08:46:03 +00005
Rafaël Carré96165ab2009-05-28 18:27:08 +00006
7Usage
8-----
9
10mkamsboot <firmware file> <boot file> <output file>
11
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
14
15<boot file> is the code you want to execute (a rockbox bootloader), previously
16 scrambled with tools/scramble utility.
17
18<output file> is the resulting firmware file which you'll have to copy on your
19 Sansa player. See "Firmware filenames".
20
21
22Supported models
23----------------
24
25Sansa Clip : firmware version starting with "01."
Rafaël Carré8b926e92010-01-13 03:05:29 +000026Sansa Clip+ : firmware version starting with "01."
Rafaël Carré96165ab2009-05-28 18:27:08 +000027Sansa Clipv2: firmware version starting with "02."
28Sansa Fuze : firmware version starting with "01."
29Sansa E200v2: firmware version starting with "03."
30Sansa C200v2: firmware version starting with "03."
31Sansa M200v4: firmware version starting with "4."
32
33
34Firmware filenames
35------------------
36
37For the firmware upgrade to happen, the firmware has to be named specially:
38
39clip v2 : m30pa.bin
40clip : m300a.bin
Rafaël Carré8b926e92010-01-13 03:05:29 +000041clip+ : clppa.bin
Rafaël Carré96165ab2009-05-28 18:27:08 +000042fuze : fuzea.bin
43e200v2 : e200pa.bin
44c200v2 : c200pa.bin
45m200v4 : m200a.bin
46
47
48Dual-Boot
49---------
50
51 The purpose of this program is to provide dual-boot between the original
52firmware and the new (rockbox) firmware.
53
54 By default the player will boot into the new firmware.
55
56 To boot into the Original Firmware, you need to press the Left key.
57 ***Note : on the c200v2 you need to press the Right key.
58
59 The player will boot into the Original Firmware as well if it is powered up by
60inserting an usb cable.
61 ***Note : on the m200v4 powering up by usb will cause booting into the new
62firmware
63
64Hacking
65-------
66
67See comments in mkamsboot.c and dualboot/dualboot.S for more information.