diff options
author | Marti Bolivar <mbolivar@leaflabs.com> | 2012-09-05 14:45:57 -0400 |
---|---|---|
committer | Marti Bolivar <mbolivar@leaflabs.com> | 2012-09-05 14:45:57 -0400 |
commit | bd69f95fb19c185e0df737c74f55e34d47855a85 (patch) | |
tree | 6f622af3451872a2c34a2db5a9a2cfc7c3645d81 /source/unix-toolchain.rst | |
parent | b32b01ab466cf5f29b1fa8e3c5d530b6de34dce2 (diff) | |
download | librambutan-bd69f95fb19c185e0df737c74f55e34d47855a85.tar.gz librambutan-bd69f95fb19c185e0df737c74f55e34d47855a85.zip |
unix-toolchain: Fix up JTAG section.
Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
Diffstat (limited to 'source/unix-toolchain.rst')
-rw-r--r-- | source/unix-toolchain.rst | 20 |
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 |