aboutsummaryrefslogtreecommitdiffstats
path: root/source
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2012-05-16 13:22:30 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2012-05-16 13:23:10 -0400
commit97312655aba4b54f594941d50fcb7c654bd7ff3c (patch)
tree1d720ce0cf2995363a9f40725df199b3a493b20d /source
parentc5e6b90ba80fb02da3f4f94e85912727e6d94360 (diff)
downloadlibrambutan-97312655aba4b54f594941d50fcb7c654bd7ff3c.tar.gz
librambutan-97312655aba4b54f594941d50fcb7c654bd7ff3c.zip
unix-toolchain: Add warnings about our DFU bogosity.
The bootloader isn't up to spec, and stricter versions of dfu-util don't work with it. There are now some quirks included with dfu-util v0.6 that work around our bugs, so add warnings about the version requirements. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
Diffstat (limited to 'source')
-rw-r--r--source/unix-toolchain.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/source/unix-toolchain.rst b/source/unix-toolchain.rst
index 751ec18..f68a17e 100644
--- a/source/unix-toolchain.rst
+++ b/source/unix-toolchain.rst
@@ -77,6 +77,11 @@ connect to serial port devices.
``dfu-util`` is a tool from the `OpenMoko`_ project that we use to
upload programs to the Maple over USB.
+.. warning:: Due to firmware bugs in our :ref:`bootloader
+ <bootloader>`, you must use recent versions of ``dfu-util``, or
+ uploads will not work. ``dfu-util`` versions 0.6 and greater
+ should work.
+
.. _OpenMoko: http://openmoko.com/
``openocd`` is a `JTAG
@@ -177,6 +182,11 @@ You will need the following tools\ [#fpackman]_ to get started:
source, OpenMoko provides instructions for `building dfu-util
<http://wiki.openmoko.org/wiki/Dfu-util#Mac>`_.
+ .. warning:: Due to firmware bugs in our :ref:`bootloader
+ <bootloader>`, you must use recent versions of ``dfu-util``, or
+ uploads will not work. ``dfu-util`` versions 0.6 and greater
+ should work.
+
If you're in a hurry, you can steal a dfu-util binary from a program
called `OpenMoko Flasher
<http://www.handheld-linux.com/wiki.php?page=OpenMoko%20Flasher>`_. To