DFUScript

From Openmoko

Jump to: navigation, search

Contents

Purpose

DFUScript was written to help users who have multiple DFU compatible devices, such as a freerunner and a bluetooth module in a laptop, flash their phones without typing the additional command line options such as the hex key device identifier. This script will use dfu-util to flash the rootfs, kernel or u-boot.

Source

Currently DFUScript is available for download at http://projects.openmoko.org/projects/dfuscript/

Configuration

DFUScript assumes that dfu-util is in /usr/bin, /usr/local/bin, or /bin. If your copy of dfu-util is not in this location just open dfuscript.sh in your favorite text editor and append :/path/to/dfu-util/folder to the end of the PATH variable.

Documentation for dfu-util is available at Dfu-util.

Usage

The DFUScript supports the following methods and is used as follows

Usage: ./dfuscript.sh deviceType alternativeType fileName

Accepted Devices:
  freerunner or fr - Neo Freerunner
  neo1973 or 1973 - FIC Neo1973

Accepted Alternatives:
  kernel - Usually a file ending in .bin
  rootfs - Usually a file ending in .jffs2
  u-boot - Usually a file ending in .bin

Reference Documentation for FreeRunner

NOTE: All following instructions assume you already have your freerunner booted in NOR, for more information about getting the freerunner ready to flash see Flashing_the_Neo_FreeRunner


WARNING: DFUScript does NOT check to see if the filenames you pass are valid, please ensure you pass a correct filename to this script or you run the risk of damaging your phone.


Flash the kernel

./dfuscript.sh fr kernel kernelName.image.bin

Flash the rootfs

./dfuscript.sh fr rootfs rootfsName.rootfs.jffs2

Flash the u-boot

./dfuscript.sh fr u-boot version_name_of-u-boot.bin
WARNING: DFUScript comes with no warranty and is used at your own risk!


Reference Documentation for Neo1973

NOTE: All following instructions assume you already have your freerunner booted in DFU mode (NAND), for more information about getting the Neo1973 ready to flash see Flashing_the_Neo_1973


WARNING: DFUScript does NOT check to see if the filenames you pass are valid, please ensure you pass a correct filename to this script or you run the risk of damaging your phone.


Flash the kernel

./dfuscript.sh 1973 kernel kernelName.image.bin

Flash the rootfs

./dfuscript.sh 1973 rootfs rootfsName.rootfs.jffs2

Flash the u-boot

WARNING: Flashing your u-boot can brick your phone, please ensure you are using the correct u-boot image. If your phone is bricked in this process a dboard is the only way to recover! This is not suggested unless you have a dboard!!


./dfuscript.sh 1973 u-boot version_name_of-u-boot.bin
WARNING: DFUScript comes with no warranty and is used at your own risk!


See Also

Personal tools