Read Me

This is the source code for the cell-top Battery Monitoring Unit (BMU)
of Mike Van Emmerik and Dave Keenan ("Coulomb" and "Weber" in the Australian Electric Vehicle
Association forum). See http://http://www.aeva.asn.au/forums/forum_posts.asp?TID=980

These BMUs use Texas Instruments MSP430 microcontrollers which are 16-bit and Ultra-Low-Power.
It specifically requires a model of MSP430 that comes in a 16QFN package and has a 10-bit ADC,
at least 256 bytes of RAM and 4K of flash, e.g.
http://focus.ti.com/docs/prod/folders/print/msp430g2332.html
http://focus.ti.com/docs/prod/folders/print/msp430g2352.html
or 8K of flash
http://focus.ti.com/docs/prod/folders/print/msp430g2432.html
http://focus.ti.com/docs/prod/folders/print/msp430g2452.html

To build them you will need to install the free IAR Embedded Workbench Kickstart.
See http://focus.ti.com/docs/toolsw/folders/print/iar-kickstart.html

There are two different BMU programs (IAR projects in celltopbmu.eww), only one of which may
be loaded into the BMU at any given time. There is the software that is loaded in normal operation,
and there is the special software that is only loaded to perform testing, ID setting or calibration,
or to load a new version of the bootstrap loader.

The folders within the celltopbmu folder are:

Normal BMU software:
	monitor
		Current. Uses interrupt-driven buffered full-duplex serial comms.
	
Special BMU software:
	TestICal
		Current. Updates the bootstrap loader (BSL), allows calibration and debugging.
		Adds command interpreting to BSLwriter.

Common BMU source files:
	common
		Not a BMU program, but code that is common to more than one of the above.

Host software:
	BMUsend
		Windows software. To load new programs into the BMUs via the serial port and our
		bootstrap loader (BSL), as opposed to using the JTAG port. Requires Microsoft
		Visual Studio.
		Only one of BMUsend or sendprog is needed; they do the same job. sendprog is command line
		based; BMUsend is GUI.
	sendprog
		Linux or Windows/Cygwin software. To load new programs into the BMUs via the serial
		port and our Bootstrap loader (BSL), as opposed to using the JTAG port.
		Only one of BMUsend or sendprog is needed; they do the same job. sendprog is command line
		based; BMUsend is GUI.
Hardware:
	web
		A set of web pages describing the BMUs and printed-circuit artwork.
	PCB
		The printed-circuit-board artwork and schematics in DesignSpark format 
		and parts spreadsheet in Excel.