.TH 0xFFFF 1 "Jan  5 2021" "0xFFFF 0.9"

.SH NAME
0xFFFF \- Open Free Fiasco Firmware Flasher, version 0.9

.SH SYNOPSIS
.B 0xFFFF
.I [options]

.SH 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.

.SH Operations:

.TP
.B -b [cmdline]
boot default or loaded kernel (default: no cmdline)
.TP
.B -b update
boot default or loaded kernel to Update mode
.TP
.B -r
reboot device
.TP
.B -l
load kernel and initfs images to RAM
.TP
.B -f
flash all specified images
.TP
.B -c
cold flash 2nd and secondary images
.TP
.B -x [/dev/mtd]
check for bad blocks on mtd device (default: all)
.TP
.B -E file
dump all device images to one fiasco image
.TP
.B -e [dir]
dump all device images (or one -t) to directory (default: current)

.SH Device configuration:

.TP
.B -I
identify, show all information about device
.TP
.B -D 0|1|2
change root device: 0 - flash, 1 - mmc, 2 - usb
.TP
.B -U 0|1
disable/enable USB host mode
.TP
.B -R 0|1
disable/enable R&D mode
.TP
.B -F flags
change R&D flags, flags are comma separated list, can be empty
.TP
.B -H rev
change HW revision
.TP
.B -N ver
change NOLO version string
.TP
.B -K ver
change kernel version string
.TP
.B -T ver
change initfs version string
.TP
.B -S ver
change SW release version string
.TP
.B -C ver
change content eMMC version string

.SH Input image specification:

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

.SH Image filters:

.TP
.B -t type
filter images by type
.TP
.B -d dev
filter images by device
.TP
.B -w hw
filter images by HW revision

.SH Fiasco image:

.TP
.B -u [dir]
unpack fiasco image to directory (default: current)
.TP
.B -g file[%sw]
generate fiasco image with SW rel version (default: no version)

.SH Other options:

.TP
.B -i
identify images
.TP
.B -s
simulate, do not flash or write on disk
.TP
.B -n
disable hash, checksum and image type checking
.TP
.B -v
be verbose and noisy
.TP
.B -h
show this help message

.SH R&D flags:

.TP
.B no-omap-wd
disable auto reboot by OMAP watchdog
.TP
.B no-ext-wd
disable auto reboot by external watchdog
.TP
.B no-lifeguard-reset
disable auto reboot by software lifeguard
.TP
.B serial-console
enable serial console
.TP
.B no-usb-timeout
disable usb timeout for flashing
.TP
.B sti-console
enable sti console
.TP
.B no-charging
disable battery charging
.TP
.B force-power-key
force omap boot reason to power key

.SH Supported devices:

.TP
.B SU-18
Nokia 770
.TP
.B RX-34
Nokia N800
.TP
.B RX-44
Nokia N810
.TP
.B RX-48
Nokia N810 Wimax
.TP
.B RX-51
Nokia N900
.TP
.B RM-680
Nokia N950
.TP
.B RM-696
Nokia N9

.SH Supported image types:

.br
xloader
.br
2nd
.br
secondary
.br
kernel
.br
initfs
.br
rootfs
.br
mmc
.br
cmt-2nd
.br
cmt-algo
.br
cmt-mcusw

.SH Supported connection protocols:

.br
Local on device
.br
NOLO via USB
.br
Cold flashing via USB
.br
Mk II protocol via USB
.br
RAW disk via USB
.SH EXAMPLES
.
.PP
.B Via USB:
.
.
.PP
.B Identify device:
.nf
$ 0xFFFF -I
.fi
.
.PP
.B Load kernel & initfs and boot it with cmdline:
.nf
$ 0xFFFF -m initfs:<file> -m kernel:<file> -l -b "<cmdline>"
.fi
.
.PP
.B Flash kernel and reboot:
.nf
$ 0xFFFF -m kernel:<file> -f -r
.fi
.
.PP
.B Flash FIASCO image and reboot:
.nf
$ 0xFFFF -M <file> -f -r
.fi
.
.PP
.B Flash only kernel from FIASCO image and reboot:
.nf
$ 0xFFFF -M <file> -t kernel -f -r
.fi
.
.PP
.B Cold-Flash 2nd and secondary bootloaders:
.nf
$ 0xFFFF -m 2nd:<file> -m secondary:<file> -c
.fi
.
.
.PP
.B On device (need nanddump from mtd-utils):
.
.
.PP
.B Dump all images to current directory:
.nf
$ 0xFFFF -e
.fi
.
.PP
.B Dump all images to one FIASCO file:
.nf
$ 0xFFFF -E <file>
.fi
.
.
.PP
.B FIASCO packaging:
.
.
.PP
.B Show FIASCO image content:
.nf
$ 0xFFFF -M <file> -i
.fi
.
.PP
.B Unpack FIASCO image to current directory:
.nf
$ 0xFFFF -M <file> -u
.fi
.
.PP
.B 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)
.nf
$ 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