Added README file with compilation instructions.

This commit is contained in:
Daniel Beer 2011-06-14 12:52:59 +12:00
parent de037d8ffd
commit 6de45248f8
1 changed files with 49 additions and 0 deletions

49
README Normal file
View File

@ -0,0 +1,49 @@
MSPDebug
========
MSPDebug is a free debugger for use with MSP430 MCUs. It supports
FET430UIF, eZ430, RF2500 and Olimex MSP-JTAG-TINY programmers. 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, Launchpad and Olimex MSP-JTAG-TINY
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.
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.