From c876d3bbefe0dc00c27ca0c12d29da5874946962 Mon Sep 17 00:00:00 2001 From: Dominik Riebeling Date: Wed, 15 Dec 2021 21:04:28 +0100 Subject: rbutil: Merge rbutil with utils folder. rbutil uses several components from the utils folder, and can be considered part of utils too. Having it in a separate folder is an arbitrary split that doesn't help anymore these days, so merge them. This also allows other utils to easily use libtools.make without the need to navigate to a different folder. Change-Id: I3fc2f4de19e3e776553efb5dea5f779dfec0dc21 --- utils/mkamsboot/README | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 utils/mkamsboot/README (limited to 'utils/mkamsboot/README') 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 @@ +mkamsboot +--------- + +A tool to inject a bootloader into a Sansa V2 (AMS) firmware file. + + +Usage +----- + +mkamsboot + + is an original Sansa firmware file obtained from the Sansa + forums for example : http://forums.sandisk.com/sansa/?category.id=devices + + is the code you want to execute (a rockbox bootloader), previously + scrambled with tools/scramble utility. + + is the resulting firmware file which you'll have to copy on your + Sansa player. See "Firmware filenames". + + +Supported models +---------------- + +Sansa Clip : firmware version starting with "01." +Sansa Clip+ : firmware version starting with "01." +Sansa Clipv2: firmware version starting with "02." +Sansa ClipZip: firmware version starting with "01." +Sansa Fuze : firmware version starting with "01." +Sansa Fuzev2: firmware version starting with "02." +Sansa E200v2: firmware version starting with "03." +Sansa C200v2: firmware version starting with "03." +Sansa M200v4: firmware version starting with "4." + + +Firmware filenames +------------------ + +For the firmware upgrade to happen, the firmware has to be named specially: + +clip v2 : m30pa.bin +clip : m300a.bin +clip+ : clppa.bin +clip zip: clpza.bin +fuze : fuzea.bin +fuzev2 : fuzpa.bin +e200v2 : e200pa.bin +c200v2 : c200pa.bin +m200v4 : m200a.bin + + +Dual-Boot +--------- + + The purpose of this program is to provide dual-boot between the original +firmware and the new (rockbox) firmware. + + By default the player will boot into the new firmware. + + To boot into the Original Firmware, you need to press the Left key. + ***Note : on the Clip+ you can alternatively press the Home key. + ***Note : on the Clip Zip you can alternatively press the Vol- key. + +Hacking +------- + +See comments in mkamsboot.c and dualboot/dualboot.S for more information. -- cgit v1.2.3