aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2012-09-05 14:45:57 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2012-09-05 14:45:57 -0400
commitbd69f95fb19c185e0df737c74f55e34d47855a85 (patch)
tree6f622af3451872a2c34a2db5a9a2cfc7c3645d81
parentb32b01ab466cf5f29b1fa8e3c5d530b6de34dce2 (diff)
downloadlibrambutan-bd69f95fb19c185e0df737c74f55e34d47855a85.tar.gz
librambutan-bd69f95fb19c185e0df737c74f55e34d47855a85.zip
unix-toolchain: Fix up JTAG section.
Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
-rw-r--r--source/unix-toolchain.rst20
1 files changed, 13 insertions, 7 deletions
diff --git a/source/unix-toolchain.rst b/source/unix-toolchain.rst
index ffa6020..769b8ec 100644
--- a/source/unix-toolchain.rst
+++ b/source/unix-toolchain.rst
@@ -336,15 +336,21 @@ notifications about bleeding-edge development.
Advanced users will wish to use a JTAG (or SWD) dongle for uploading
and debugging their programs. A big advantage to this approach is that
-it lets you use `GDB
-<http://www.gnu.org/software/gdb/documentation/>`_ to single-step
-through your code, inspect variables, etc.
+it lets you use `GDB <http://www.gnu.org/software/gdb/>`_ to
+single-step through your code, inspect variables, etc.
You can build your projects for JTAG or SWD upload with the ``jtag``
-Makefile target. Instead of compiling with ``make``, compile with
-``make jtag``. Then use your method of choice to upload the resulting
-program, which will be in ``build/$BOARD.elf`` in the libmaple
-directory.
+Makefile target. That is, instead of compiling with ``make``, compile
+with ::
+
+ # (This is equivalent to $ MEMORY_TARGET=jtag make)
+ $ make jtag
+
+Then use your favorite JTAG/SWD dongle and driver software to upload
+the resulting program. An `ELF
+<http://en.wikipedia.org/wiki/Executable_and_Linkable_Format>`_
+suitable for upload is in :file:`build/$BOARD.elf`; the raw binary you
+can copy directly to address 0x0 is :file:`build/$BOARD.bin`.
.. warning:: Uploading code built with the ``jtag`` target will
overwrite the :ref:`bootloader <bootloader>`. This is a good thing