0xFFFF(1) 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