blob: 899529ce2f0c3e2bc9acf0408bd0c5e8125406c7 [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."
Rafaël Carréb0e3fc62010-03-16 15:24:56 +000029Sansa Fuzev2: firmware version starting with "02."
Rafaël Carré96165ab2009-05-28 18:27:08 +000030Sansa E200v2: firmware version starting with "03."
31Sansa C200v2: firmware version starting with "03."
32Sansa M200v4: firmware version starting with "4."
33
34
35Firmware filenames
36------------------
37
38For the firmware upgrade to happen, the firmware has to be named specially:
39
40clip v2 : m30pa.bin
41clip : m300a.bin
Rafaël Carré8b926e92010-01-13 03:05:29 +000042clip+ : clppa.bin
Rafaël Carré96165ab2009-05-28 18:27:08 +000043fuze : fuzea.bin
Rafaël Carréb0e3fc62010-03-16 15:24:56 +000044fuzev2 : fuzpa.bin
Rafaël Carré96165ab2009-05-28 18:27:08 +000045e200v2 : e200pa.bin
46c200v2 : c200pa.bin
47m200v4 : m200a.bin
48
49
50Dual-Boot
51---------
52
53 The purpose of this program is to provide dual-boot between the original
54firmware and the new (rockbox) firmware.
55
56 By default the player will boot into the new firmware.
57
58 To boot into the Original Firmware, you need to press the Left key.
Rafaël Carréb0e3fc62010-03-16 15:24:56 +000059 ***Note : on the Clip+ you can alternatively press the Home key.
Rafaël Carré96165ab2009-05-28 18:27:08 +000060
61 The player will boot into the Original Firmware as well if it is powered up by
62inserting an usb cable.
Rafaël Carré66f18302010-05-17 21:57:46 +000063 ***Note : on the m200v4 powering up by usb will cause booting into the new firmware.
Rafaël Carré96165ab2009-05-28 18:27:08 +000064
65Hacking
66-------
67
68See comments in mkamsboot.c and dualboot/dualboot.S for more information.