diff options
| author | Marti Bolivar <mbolivar@leaflabs.com> | 2012-05-16 13:22:30 -0400 |
|---|---|---|
| committer | Marti Bolivar <mbolivar@leaflabs.com> | 2012-05-16 13:23:10 -0400 |
| commit | 97312655aba4b54f594941d50fcb7c654bd7ff3c (patch) | |
| tree | 1d720ce0cf2995363a9f40725df199b3a493b20d | |
| parent | c5e6b90ba80fb02da3f4f94e85912727e6d94360 (diff) | |
| download | librambutan-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>
| -rw-r--r-- | source/unix-toolchain.rst | 10 |
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 |