0xFFFF

NAME

0xFFFF − Open Free Fiasco Firmware Flasher, version 0.8

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
	RM-680		Nokia N950
	RM-696		Nokia N9

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
Mk II protocol via USB
RAW disk 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