0xFFFF(1) Open Free Fiasco Firmware Flasher, version 0.6.1

[giraffelife]

NAME
       0xFFFF - Open Free Fiasco Firmware Flasher, version 0.6.1

SYNOPSIS
       0xFFFF [options]

DESCRIPTION
       0xFFFF  is  Open  Free  Fiasco  Firmware  Flasher for Maemo devices. It
       support generating and  unpacking  FIASCO  images  on  local  computer.
       Useful  for editing Maemo firmware package for future flash. It support
       via USB flashing any  image  type  to  Maemo  device  and  also  "cold"
       flashing which means flashing dead device with erased bootloader. There
       is support for booting kernel via USB without flashing to NAND and also
       changing  configuration  of  Maemo  device  (enable/disable  R&D  mode,
       changing HW revision strings, ...).

       0xFFFF is alternative tool to proprietary Nokia flasher-3.5 and fiasco-
       gen.  0xFFFF  generate  compatible FIASCO images and also accept FIASCO
       images generated by Nokia fiasco-gen.

Operations:
       -b [cmdline]
              boot default or loaded kernel (default: no cmdline)

       -b update
              boot default or loaded kernel to Update mode

       -r     reboot device

       -l     load kernel and initfs images to RAM

       -f     flash all specified images

       -c     cold flash 2nd and secondary images

       -x [/dev/mtd]
              check for bad blocks on mtd device (default: all)

       -E file
              dump all device images to one fiasco image

       -e [dir]
              dump all device  images  (or  one  -t)  to  directory  (default:
              current)

Device configuration:
       -I     identify, show all information about device

       -D 0|1|2
              change root device: 0 - flash, 1 - mmc, 2 - usb

       -U 0|1 disable/enable USB host mode

       -R 0|1 disable/enable R&D mode

       -F flags
              change R&D flags, flags are comma separated list, can be empty

       -H rev change HW revision

       -N ver change NOLO version string

       -K ver change kernel version string

       -T ver change initfs version string

       -S ver change SW release version string

       -C ver change content eMMC version string

Input image specification:
       -M file
              specify fiasco image

       -m arg specify normal image
              arg is [[[dev:[hw:]]ver:]type:]file[%lay]
              dev is device name string (default: empty)
              hw are comma separated list of HW revisions (default: empty)
              ver is image version string (default: empty)
              type is image type (default: autodetect)
              file is image file name
              lay is layout file name (default: none)

Image filters:
       -t type
              filter images by type

       -d dev filter images by device

       -w hw  filter images by HW revision

Fiasco image:
       -u [dir]
              unpack fiasco image to directory (default: current)

       -g file[%sw]
              generate fiasco image with SW rel version (default: no version)

Other options:
       -i     identify images

       -s     simulate, do not flash or write on disk

       -n     disable hash, checksum and image type checking

       -v     be verbose and noisy

       -h     show this help message

R&D flags:
       no-omap-wd
              disable auto reboot by OMAP watchdog

       no-ext-wd
              disable auto reboot by external watchdog

       no-lifeguard-reset
              disable auto reboot by software lifeguard

       serial-console
              enable serial console

       no-usb-timeout
              disable usb timeout for flashing

       sti-console
              enable sti console

       no-charging
              disable battery charging

       force-power-key
              force omap boot reason to power key

Supported devices:
       SU-18  Nokia 770

       RX-34  Nokia N800

       RX-44  Nokia N810

       RX-48  Nokia N810 Wimax

       RX-51  Nokia N900

Supported image types:
       xloader
       2nd
       secondary
       kernel
       initfs
       rootfs
       mmc
       cmt-2nd
       cmt-algo
       cmt-mcusw

Supported connection protocols:
       Local on device
       NOLO via USB
       Cold flashing via USB

EXAMPLES
       Via USB:

       Identify device:
       $ 0xFFFF -I

       Load kernel & initfs and boot it with cmdline:
       $ 0xFFFF -m initfs:<file> -m kernel:<file> -l -b "<cmdline>"

       Flash kernel and reboot:
       $ 0xFFFF -m kernel:<file> -f -r

       Flash FIASCO image and reboot:
       $ 0xFFFF -M <file> -f -r

       Flash only kernel from FIASCO image and reboot:
       $ 0xFFFF -M <file> -t kernel -f -r

       Cold-Flash 2nd and secondary bootloaders:
       $ 0xFFFF -m 2nd:<file> -m secondary:<file> -c

       On device (need nanddump from mtd-utils):

       Dump all images to current directory:
       $ 0xFFFF -e

       Dump all images to one FIASCO file:
       $ 0xFFFF -E <file>

       FIASCO packaging:

       Show FIASCO image content:
       $ 0xFFFF -M <file> -i

       Unpack FIASCO image to current directory:
       $ 0xFFFF -M <file> -u

       Generate   new   FIASCO  image  image.fiasco  from  files  xloader.bin,
       nolo.bin, zImage, rootfs and append device&version information (xloader
       for RX-51 hw revision: 2101 and 2102, version 1.0)
       $ 0xFFFF -m RX-51:2101,2102:1.0:xloader:xloader.bin -m RX-51:2101,2102:1.0:secondary:nolo.bin -m 2.6.28:kernel:zImage -m rootfs -g image.fiasco