0xFFFF - Man Page

Open Free Fiasco Firmware Flasher, version 0.10

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
1st
cert-sw
ape-algo

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

Info

Jul 17 2024 0xFFFF 0.10