DFUScript
From Openmoko
(DFUScript - Assist with flashing using dfu-util) |
(→Source) |
||
(3 intermediate revisions by one user not shown) | |||
Line 5: | Line 5: | ||
== Source == | == Source == | ||
− | Currently DFUScript is available for download at http:// | + | Currently DFUScript is available for download at http://projects.openmoko.org/projects/dfuscript/ |
== Configuration == | == Configuration == | ||
Line 47: | Line 47: | ||
Flash the u-boot | Flash the u-boot | ||
− | |||
<pre> | <pre> | ||
./dfuscript.sh fr u-boot version_name_of-u-boot.bin | ./dfuscript.sh fr u-boot version_name_of-u-boot.bin | ||
Line 56: | Line 55: | ||
== Reference Documentation for Neo1973 == | == Reference Documentation for Neo1973 == | ||
− | {{note|All following instructions assume you already have your freerunner booted in | + | {{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 05: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! |