DFUScript

From Openmoko

Revision as of 03:58, 13 September 2008 by Prjktdtnt (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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://projektenterprises.com/openmoko/dfuscript.sh

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

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

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://projektenterprises.com/openmoko/dfuscript.sh

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

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