r1175 - trunk/src/host/devirginator

[werner at sita.openmoko.org]

Author: werner
Date: 2007-03-01 14:22:29 +0100 (Thu, 01 Mar 2007)
New Revision: 1175

Modified:
   trunk/src/host/devirginator/README
   trunk/src/host/devirginator/environment.in
   trunk/src/host/devirginator/openocd.in
Log:
environment.in: corrected file name in header
openocd.in: use new "wait_halt [<seconds>]"
README: added prerequisites and miscellaneous text



Modified: trunk/src/host/devirginator/README
===================================================================
--- trunk/src/host/devirginator/README	2007-03-01 12:58:22 UTC (rev 1174)
+++ trunk/src/host/devirginator/README	2007-03-01 13:22:29 UTC (rev 1175)
@@ -18,6 +18,36 @@
 % ./devirginate
 
 
+Prerequisites
+=============
+
+The device must be connected to:
+
+- JTAG, with an interface supported by OpenOCD (required for all stages)
+- USB, connected to the machine running "devirginate" (only required for
+  stage 2 and beyond)
+
+Furthermore, if a serial console is connected to the device, installation
+progress can be monitored.
+
+The following programs are needed:
+
+- dfu-util must be accessible from the machine running "devirginate".
+  If dfu-util is not in PATH, you can set an explicit path in "config".
+
+  To build dfu-util, do this:
+  cd $OMDIR/openmoko/trunk/src/host/dfu-util
+  ./autogen.sh
+  ./configure
+  make
+
+- OpenOCD. SVN revision 130 with libftdi 0.8 is known to work. Other
+  combinations may also work. The following patch is required:
+  SVN: developers/werner/openocd-wait-patiently.patch
+
+  For build instructions, see developers/werner/notes/openocd
+
+
 Files
 =====
 
@@ -25,10 +55,13 @@
 Scripts
 -------
 
+- crc32.pl
+  Provides the function crc32, which computes the IEEE CRC-32.
+  This script is used by other Perl scripts, with "do".
+
+- envedit.pl
 - openocdcmd.pl
 - scriptify.pl
-- crc32.pl
-- envedit.pl
 - setup.sh
 
 User configuration
@@ -65,6 +98,13 @@
   produced in stage 0. In particular, the "mtdparts" variable is
   retained from that stage.
 
+  Long lines can be split in environment.in by simply indenting the
+  continuation. Note that the newline and the indentation are replaced
+  with one space. E.g.,
+  foo=some
+    thing
+  would yield  foo=some thing
+
 - smiley.fig -> tmp/smiley.gz
   The stage 0 splash screen, a smiling face on a green background.
 

Modified: trunk/src/host/devirginator/environment.in
===================================================================
--- trunk/src/host/devirginator/environment.in	2007-03-01 12:58:22 UTC (rev 1174)
+++ trunk/src/host/devirginator/environment.in	2007-03-01 13:22:29 UTC (rev 1175)
@@ -1,5 +1,5 @@
 #
-# environment - The default environment
+# environment.in - The default environment
 #
 
 bootargs_base=

Modified: trunk/src/host/devirginator/openocd.in
===================================================================
--- trunk/src/host/devirginator/openocd.in	2007-03-01 12:58:22 UTC (rev 1174)
+++ trunk/src/host/devirginator/openocd.in	2007-03-01 13:22:29 UTC (rev 1175)
@@ -44,6 +44,6 @@
 # run
 bp 0 4 hw
 resume 0x32000000
-wait_halt
+wait_halt 300
 rbp 0
 resume