Tree [c6f72c] bzr/jtag /
 History



File Date Author Commit
 funclets 2009-09-25 cliechti@users.sourceforge.net <> [888126] doc updates, fix make clean (missed files)
 hardware_access 2009-09-26 cliechti@users.sourceforge.net <> [7b38e9] fix compilation with mingw (cc somehow not foun...
 msp430 2009-09-26 cliechti@users.sourceforge.net <> [7b38e9] fix compilation with mingw (cc somehow not foun...
 .bzrignore 2009-09-26 cliechti@users.sourceforge.net <> [745f32] added "make dist", update ignores
 Basic_Types.h 2003-01-10 cliechti <> [53c1df] MSP43mspgcc:
 LICENSE.txt 2005-12-30 cliechti <> [349590] update licences, ensure that the file is also c...
 MSP430mspgcc.h 2006-09-09 cliechti <> [9c846f] add public function to read address bus
 README.txt 2009-09-25 cliechti@users.sourceforge.net <> [3f9818] remove obsolete code (now handled with ctypes, ...
 makefile 2009-09-26 cliechti@users.sourceforge.net <> [745f32] added "make dist", update ignores
 windist.properties 2009-09-27 cliechti@users.sourceforge.net <> [c6f72c] add file list, used for windows installer

Read Me

Parallel Port JTAG Interface
============================

Sources for the MSP430mspgcc library, the Python extension using it
and the hardware access library HIL.

Description of the directories:

funclets
    Helper programs that are downloaded to the target.
    Require the mspgcc toolchain to compile (msp430-gcc etc.)

hardware_access
    The hardware layer is encapsulated in the HIL library.
    Sources for Linux and Win32 and tools for Win32.

msp430
    The MSP430mspgcc library communicates trough the JTAG with an
    attached MSP430 processor. It has support to read and write memory,
    erase and write Flash.


All makefiles contain targets for Win32 and Linux. If "WINDIR" is found
in the environment variables a Win32 build is assumed, linux otherwise. For
Linux, two options are supported:

- Parallel port device (ppdev). This requires a Linux 2.4 or newer kernel.
- Direct input/output (directio). This should work under any Linux kernel
  (tested under 2.2.14-5.0), but requires msp430-jtag to be run as "root".

If "DIRECTIO" is found in the environment variables, the direct I/O interface
will be used. Otherwise, ppdev is assumed.

GCC is required to compile on both platforms.


Requirements
------------
The giveio driver is required on Windows NT/2k/XP.
You must execute ``hardware_access/giveio/install_giveio.bat`` to install the
driver.


Build
-----

For the default (Linux ppdev) build::

  Type "make" in the jtag directory and hope ;-)

To build for direct I/O under Linux::

  env DIRECTIO=1 make

To build for Windows::

  env WINDIR=1 make

Then copy the resulting _parjtag (so or pyd) library in the pyjtag (separate
application) directory to be able to use pyjtag.
On Windows you'll need hardware_access/HILwin32_giveio/HIL.dll and
msp430/MSP430mspgcc.dll too.

Test, I usualy use: ``python msp430-jtag.py -f ../jtag/funclets/blinking.a43``
in the python directory for a first connection test (LEDs on P1 and P2 are
toggled).


Disclaimer
----------
As allways with open source - use at your own risk :-)
See also LICENSE.txt.


References
----------
- TI MSP430 home: http://www.ti.com/msp430

- TI application notes:
  slaa149: "Programming a Flash-Based MSP430 Using the JTAG Interface"
  docs:    http://www-s.ti.com/psheets/slaa149/slaa149.pdf
  sources: http://www-s.ti.com/psheets/slaa149/slaa149.zip


chris <cliechti@gmx.net>
http://mspgcc.sourceforge.net