diff options
Diffstat (limited to 'source/unix-toolchain.rst')
| -rw-r--r-- | source/unix-toolchain.rst | 16 |
1 files changed, 14 insertions, 2 deletions
diff --git a/source/unix-toolchain.rst b/source/unix-toolchain.rst index a397cc1..4fc21ea 100644 --- a/source/unix-toolchain.rst +++ b/source/unix-toolchain.rst @@ -67,14 +67,21 @@ The following are **mandatory**: the `OpenMoko`_ project. It is used 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/ + * `make <http://www.gnu.org/software/make/>`_ is used to direct compilation. * `Python <http://python.org>`_ is a programming language. Our reset script, which sends control signals to the board which cause it to to reset and enter the :ref:`bootloader <bootloader>`, is written in - Python. (Most Linux distributions these days include Python by - default). + Python (and works with Python 2 or 3). Most Linux distributions + these days include Python by default. * `PySerial`_ is a Python library for interacting with serial port devices. It's needed by our reset script. PySerial can also be @@ -176,6 +183,11 @@ You will need the following tools\ [#fpackman]_ to get started: * `dfu-util <http://wiki.openmoko.org/wiki/Dfu-util>`_: A tool from `OpenMoko`_ 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. + If you prefer to compile from source, OpenMoko provides instructions for `building dfu-util on OS X <http://wiki.openmoko.org/wiki/Dfu-util#Mac>`_. |