From 97312655aba4b54f594941d50fcb7c654bd7ff3c Mon Sep 17 00:00:00 2001
From: Marti Bolivar <mbolivar@leaflabs.com>
Date: Wed, 16 May 2012 13:22:30 -0400
Subject: 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>
---
 source/unix-toolchain.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

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
-- 
cgit v1.2.3