diff options
Diffstat (limited to 'utils/mkamsboot/README')
-rw-r--r-- | utils/mkamsboot/README | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/utils/mkamsboot/README b/utils/mkamsboot/README new file mode 100644 index 0000000000..8e3f202f38 --- /dev/null +++ b/utils/mkamsboot/README | |||
@@ -0,0 +1,67 @@ | |||
1 | mkamsboot | ||
2 | --------- | ||
3 | |||
4 | A tool to inject a bootloader into a Sansa V2 (AMS) firmware file. | ||
5 | |||
6 | |||
7 | Usage | ||
8 | ----- | ||
9 | |||
10 | mkamsboot <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 | |||
22 | Supported models | ||
23 | ---------------- | ||
24 | |||
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 ClipZip: firmware version starting with "01." | ||
29 | Sansa Fuze : firmware version starting with "01." | ||
30 | Sansa Fuzev2: firmware version starting with "02." | ||
31 | Sansa E200v2: firmware version starting with "03." | ||
32 | Sansa C200v2: firmware version starting with "03." | ||
33 | Sansa M200v4: firmware version starting with "4." | ||
34 | |||
35 | |||
36 | Firmware filenames | ||
37 | ------------------ | ||
38 | |||
39 | For the firmware upgrade to happen, the firmware has to be named specially: | ||
40 | |||
41 | clip v2 : m30pa.bin | ||
42 | clip : m300a.bin | ||
43 | clip+ : clppa.bin | ||
44 | clip zip: clpza.bin | ||
45 | fuze : fuzea.bin | ||
46 | fuzev2 : fuzpa.bin | ||
47 | e200v2 : e200pa.bin | ||
48 | c200v2 : c200pa.bin | ||
49 | m200v4 : m200a.bin | ||
50 | |||
51 | |||
52 | Dual-Boot | ||
53 | --------- | ||
54 | |||
55 | The purpose of this program is to provide dual-boot between the original | ||
56 | firmware 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. | ||
61 | ***Note : on the Clip+ you can alternatively press the Home key. | ||
62 | ***Note : on the Clip Zip you can alternatively press the Vol- key. | ||
63 | |||
64 | Hacking | ||
65 | ------- | ||
66 | |||
67 | See comments in mkamsboot.c and dualboot/dualboot.S for more information. | ||