blob: 8e3f202f38e029aff35f950334e5edc2a12f3262 [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."
Rafaël Carrée4614c42011-12-20 18:48:20 +000028Sansa ClipZip: firmware version starting with "01."
Rafaël Carré96165ab2009-05-28 18:27:08 +000029Sansa Fuze : firmware version starting with "01."
Rafaël Carréb0e3fc62010-03-16 15:24:56 +000030Sansa Fuzev2: firmware version starting with "02."
Rafaël Carré96165ab2009-05-28 18:27:08 +000031Sansa E200v2: firmware version starting with "03."
32Sansa C200v2: firmware version starting with "03."
33Sansa M200v4: firmware version starting with "4."
34
35
36Firmware filenames
37------------------
38
39For the firmware upgrade to happen, the firmware has to be named specially:
40
41clip v2 : m30pa.bin
42clip : m300a.bin
Rafaël Carré8b926e92010-01-13 03:05:29 +000043clip+ : clppa.bin
Rafaël Carrée4614c42011-12-20 18:48:20 +000044clip zip: clpza.bin
Rafaël Carré96165ab2009-05-28 18:27:08 +000045fuze : fuzea.bin
Rafaël Carréb0e3fc62010-03-16 15:24:56 +000046fuzev2 : fuzpa.bin
Rafaël Carré96165ab2009-05-28 18:27:08 +000047e200v2 : e200pa.bin
48c200v2 : c200pa.bin
49m200v4 : m200a.bin
50
51
52Dual-Boot
53---------
54
55 The purpose of this program is to provide dual-boot between the original
56firmware and the new (rockbox) firmware.
57
58 By default the player will boot into the new firmware.
59
60 To boot into the Original Firmware, you need to press the Left key.
Rafaël Carréb0e3fc62010-03-16 15:24:56 +000061 ***Note : on the Clip+ you can alternatively press the Home key.
Rafaël Carrée4614c42011-12-20 18:48:20 +000062 ***Note : on the Clip Zip you can alternatively press the Vol- key.
Rafaël Carré96165ab2009-05-28 18:27:08 +000063
64Hacking
65-------
66
67See comments in mkamsboot.c and dualboot/dualboot.S for more information.