mspdebug fork containing various WIP patches
Go to file
Peter A. Bigot dd2c6d997c Avoid truncating breakpoint address
Use of uint16_t caused the stored breakpoint address to be wrong.  However,
breakpoints above 64 kiB don't seem to work even with this, so there may
also be a FET issue.
2012-06-13 09:43:04 +12:00
drivers Avoid truncating breakpoint address 2012-06-13 09:43:04 +12:00
formats elf32: more portable implementation. 2012-05-10 10:00:58 +12:00
simio Modernise decl styles 2011-11-16 08:42:45 +13:00
ui Fix GDB breakpoint support. 2012-04-30 08:52:12 +12:00
util fix disassembly of 20-bit calla operands 2012-06-05 12:01:53 +12:00
.gitignore Modifications to compile on Cygwin. 2010-05-13 16:45:38 +12:00
AUTHORS Add more error codes from MSP430.dll v3: 2011-08-16 10:22:37 +12:00
COPYING MSPDebug version 0.2. 2009-11-17 15:36:04 +13:00
ChangeLog Version 0.19 2012-03-03 11:56:26 +13:00
Makefile Add support for building on Cygwin. 2012-04-25 11:02:22 +12:00
README Version 0.19 2012-03-03 11:56:26 +13:00
mspdebug.man Add support for read and write watchpoints. 2012-04-25 14:10:26 +12:00
ti_3410.fw.ihex Implemented TI3410 firmware download. 2011-09-16 16:09:03 +12:00
ti_3410.fw.txt Implemented TI3410 firmware download. 2011-09-16 16:09:03 +12:00

README

MSPDebug
========

MSPDebug is a free debugger for use with MSP430 MCUs. It supports
FET430UIF, eZ430, RF2500 and Olimex MSP430-JTAG-TINY programmers, as
well as many other compatible devices. It can be used as a proxy for
gdb or as an independent debugger with support for programming,
disassembly and reverse engineering.

Features
--------

  * Userspace only: no kernel modifications required.
  * Works with RF2500, eZ430, FET430UIF (V2 and V3), Launchpad, Chronos,
    Olimex MSP430-JTAG-TINY and MSP430-JTAG-ISO programmers. Also
    supports the TI flash bootloader.
  * Can act as a GDB remote stub (replacement for msp430-gdbproxy)
    and/or a GDB client.
  * Can single-step, program, run to breakpoint and inspect memory on
    supported devices.
  * Can be used to access the FET430UIF bootloader.
  * Supports Intel HEX, ELF32, BSD symbol table, COFF, TI Text and
    SREC file formats.
  * Can disassemble code in memory, including translating addresses to
    symbols.
  * Includes reverse-engineering features such as instruction search,
    call-graph analysis and symbol table editing.
  * Simulation mode allows execution of MSP430 code without hardware.
  * Cross-platform: compiles on Linux, *BSD, OS/X and Windows.

Compiling from source
---------------------

Ensure that you have the necessary packages to compile programs that use
libusb (on Debian or Ubuntu systems, you might need to do apt-get
install libusb-dev). After that, unpack and compile the source code
with:

    tar xvfz mspdebug-version.tar.gz
    cd mspdebug-version
    make

If you don't want GNU readline support, you can invoke make with:

    make WITHOUT_READLINE=1

After compiling, install the binary and manual page by running (as
root):

    make install

Type "mspdebug --help" for usage instructions.