DFUScript

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Reference Documentation for FreeRunner)
(Source)
 
(2 intermediate revisions by one user not shown)
Line 5: Line 5:
 
== Source ==
 
== Source ==
  
Currently DFUScript is available for download at http://projektenterprises.com/openmoko/dfuscript.sh
+
Currently DFUScript is available for download at http://projects.openmoko.org/projects/dfuscript/
  
 
== Configuration ==
 
== Configuration ==
Line 55: Line 55:
 
== Reference Documentation for Neo1973 ==
 
== 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]]}}
+
{{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.}}
 
{{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.}}
  

Latest revision as of 04:30, 13 September 2008

Contents

[edit] 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.

[edit] Source

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

[edit] 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.

[edit] 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

[edit] 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!


[edit] 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!


[edit] 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

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