mspdebug fork containing various WIP patches
Go to file
Daniel Beer 4f6a845fb4 Fix operation size error in instruction decoding. 2019-03-28 14:26:28 +13:00
drivers Don't issue mass erase if BSL password is specified. 2019-03-12 12:16:35 +13:00
formats elf32: fix size in call to memset. 2014-02-09 20:32:47 +13:00
simio simio: fix uninitialized memory use in IO reads. 2018-11-28 08:44:49 +13:00
transport Improve compiling experience on MinGW platform (use pkg-config, *nix rm). 2018-11-18 14:49:08 -05:00
ui Don't issue mass erase if BSL password is specified. 2019-03-12 12:16:35 +13:00
util Fix operation size error in instruction decoding. 2019-03-28 14:26:28 +13:00
.gitignore Modifications to compile on Cygwin. 2010-05-13 16:45:38 +12:00
AUTHORS Add Jan Willeke to AUTHORS file. 2015-02-04 12:48:55 +13:00
BSDmakefile Add BSDmakefile, a wrapper to call gmake on some BSDs. 2013-07-19 11:38:21 +12:00
COPYING MSPDebug version 0.2. 2009-11-17 15:36:04 +13:00
ChangeLog Version 0.25. 2017-07-24 18:58:05 +12:00
EmbeddedMode.txt Add power sample output. 2012-10-24 09:37:46 +13:00
Makefile Improve compiling experience on MinGW platform (use pkg-config, *nix rm). 2018-11-18 14:49:08 -05:00
README add note to install libreadline-dev 2016-12-27 20:14:08 +00:00
chipinfo.db Update chipinfo.db with slac460y 2018-05-18 07:16:02 +09:00
mspdebug.man Implement --bsl-entry-password option. 2019-03-08 08:46:16 +13: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,
    GoodFET, 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

On Debian Ubuntu systems sudo apt-get install libreadline-dev may be 
required. 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.