Initial commit

.gitignore

@@ -0,0 +1,11 @@
+*~
+.DS_Store
+*.pyc
+*.html
+MANIFEST
+PKG-INFO
+setup.cfg
+*.egg-info/
+/build/
+/dist/
+/nsis/

AUTHORS

@@ -0,0 +1,4 @@
+Authors
+=======
+
+- Chris Wilson <[email protected]>

CHANGES

@@ -0,0 +1,11 @@
+CHANGES
+=======
+
+0.9.1 (12/11/2012)
+-----------------
+- Check in code and publish on Github
+- Change User Guide format to asciidoc/html
+
+0.9.0 (2/1/2010)
+-----------------
+- Initial release

INSTALL

@@ -0,0 +1,70 @@
+INSTALL
+=======
+
+Overview
+--------
+If you simply want to install the MSP430 BSL Utility, follow the "Install"
+instructions below.  If you want to actually build the installer from source,
+follow the "Build" instructions.
+
+Install
+-------
+Windows
+~~~~~~~
+There is a binary installer for Windows available on the Flying Camp Design
+website (http://www.flyingcampdesign.com/msp430-bsl-utility.html)
+It is the recommended way to install the MSP430 BSL Utility for Windows.
+
+Linux
+~~~~~
+Coming soon...
+
+Mac OSX
+~~~~~~~
+Coming soon...
+
+Build
+-----
+Windows Installer
+~~~~~~~~~~~~~~~~~
+The binary installer for Windows available on the Flying Camp Design website
+was built on Windows XP 32-bit following the instructions below.  Other versions
+of the requirements listed below may work, but have not been tested.
+
+.Requirements
+- Python 2.7.3 (python-2.7.3.msi)
+- distribute 0.6.32 (distribute-0.6.32.tar.gz)
+- pip 1.2.1 (installed via `easy_install pip`)
+- py2exe 0.6.9 (py2exe-0.6.9.win32-py2.7.exe)
+- pyserial 2.6 (installed via `pip install pyserial`)
+- NSIS 2.46 (http://nsis.sourceforge.net)
+- asciidoc 8.6.8 (unzipped to C:\asciidoc-8.6.8)
+
+.Add the following to the System PATH
+- C:\Python27
+- C:\Python27\Scripts
+- C:\Program Files\NSIS (so that makensis is in PATH)
+- C:\asciidoc-8.6.8 (so that asciidoc.py is in PATH)
+
+.Build the installer
+----
+make installer
+----
+
+.Build only the docs
+----
+make doc
+----
+
+.Remove generated files
+----
+make clean
+----
+
+Linux Installer
+~~~~~~~~~~~~~~~
+Coming soon...
+
+Mac OSX Installer
+~~~~~~~~~~~~~~~~~
+Coming soon...

LICENSE

@@ -0,0 +1,22 @@
+"Copyright (c) 2012 Flying Camp Design
+
+All rights reserved.
+
+Permission to use, copy, modify, and distribute this software, hardware,
+and/or documentation for any purpose, without fee, and without written
+agreement is hereby granted, provided that the above copyright notice,
+the following two paragraphs and the author appear in all copies of this
+software and documentation, and the author appear on all copies or
+derivative works of this hardware.
+
+IN NO EVENT SHALL FLYING CAMP DESIGN BE LIABLE TO ANY PARTY FOR DIRECT,
+INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF
+THE USE OF THIS SOFTWARE, HARDWARE, OR DOCUMENTATION, EVEN IF FLYING
+CAMP DESIGN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+FLYING CAMP DESIGN SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT
+NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE.  THE SOFTWARE, HARDWARE, AND/OR DOCUMENTATION
+PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND FLYING CAMP DESIGN HAS
+NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS,
+OR MODIFICATIONS."

MANIFEST.in

@@ -0,0 +1,14 @@
+include AUTHORS
+include CHANGES
+include ez_setup.py
+include INSTALL
+include LICENSE
+include make.bat
+include Makefile
+include MANIFEST.in
+include README
+include RELEASE_NOTES
+include setup.nsi
+include docs/UserGuide
+include resources/*
+include src/msp430bslu/resources/*

Makefile

@@ -0,0 +1,24 @@
+.PHONY: sdist docs clean
+
+sdist: clean
+	python setup.py sdist
+
+docs:
+	asciidoc AUTHORS
+	asciidoc CHANGES
+	asciidoc INSTALL
+	asciidoc LICENSE
+	asciidoc README
+	asciidoc RELEASE_NOTES
+	cd docs && asciidoc UserGuide
+
+clean:
+	rm -f *~
+	rm -f .DS_Store
+	rm -f *.html
+	rm -rf docs/*.html
+	rm -f MANIFEST
+	rm -rf build
+	rm -rf dist
+	rm -rf msp430bslu.egg-info
+	rm -rf nsis

README

@@ -0,0 +1,15 @@
+README
+======
+
+http://www.flyingcampdesign.com
+
+About
+-----
+The MSP430 BSL Utility is a simple GUI front end for the mspgcc python package.  
+
+Files
+-----
+- For install instructions see INSTALL
+- For license information see LICENSE
+- For changes between releases see CHANGES
+- For issues with the current release see RELEASE_NOTES

RELEASE_NOTES

@@ -0,0 +1,16 @@
+RELEASE NOTES
+=============
+
+KNOWN ISSUES
+------------
+
+- The default install of python/Tk/Tcl on OSX Snow Leopard has some bugs
+  which cause severe errors when trying to run this application.  The
+  progress bar does not update and trying to quit using cmd+q causes a
+  segfault.  Upgrading to python >= 2.6.4 and Tcl/Tk >= 8.5 fixes these
+  issues.  
+- The 'Toggle TEST on TX' option is currently disabled because it relies 
+  on serial.win32file (in bsl.py) provided by pySerial releases OLDER than 2.5.
+  pySerial releases 2.5 and later on windows no longer rely on pywin32
+  and therefore do not provide serial.win32file.  This feature will remain
+  disabled until the dependency on serial.win32file is removed from bsl.py.

docs/UserGuide

@@ -0,0 +1,4 @@
+MSP430 BSL Utility User Guide
+=============================
+
+Version 0.9.1