rbutil/mkamsboot/README

   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.