From 97312655aba4b54f594941d50fcb7c654bd7ff3c Mon Sep 17 00:00:00 2001 From: Marti Bolivar 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 --- 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 + `, 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 `_. + .. warning:: Due to firmware bugs in our :ref:`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 `_. To -- cgit v1.2.3