Permalink
Browse files

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>
  • Loading branch information...
1 parent a0b3315 commit 70a209816930cb920a2071081931db37c60f5725 Marti Bolivar committed May 16, 2012
Showing with 10 additions and 0 deletions.
  1. +10 −0 source/unix-toolchain.rst
@@ -75,6 +75,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
@@ -168,6 +173,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

0 comments on commit 70a2098

Please sign in to comment.