Setup

Getting Started -

Implementation

There are currently two implementations of badgeup: C# .NET (src/CSharp) and Python 2.7 (src/CPy27); both targeting a Windows environment. Other than language differences, both versions have a similar structure. The C# version uses System.IO.Ports to communicate over the emulated Serial port while the Python version uses pySerial to do it's serial work.

Setting up the CSharp development environment with VS2010

1. Get Visual Studio C# 2010 Express from here or download Microsoft's Web Platform Installer to pull it down for you.
2. Once installed grab the latest badgeup code: download here or using git bash: $ git clone git://github.com/mrdc/badgeup.git
3. Navigate to the folder where you saved the badgeup code and open src/CSharp/. Here you should see the Visual Studio solution file, badgeup.sln. Double-click and the project will load. From here you can build the project or run it in debug mode with your badge plugged in and it should upload the testing strings.

Setting up the Python 2.7 development environment with Eclipse and PyDev

1. Download and install Python 2.7.2 here
2. Download and install Eclipse Classic here
3. Once Eclipse is installed, install PyDev:
   • Go to Help > Install New Software...
   • Click "Add" next to the Work With field
   • For the Name, enter PyDev Updates
   • For the Uri, enter http://pydev.org/updates
   • You should now see several modules, select PyDev or click Select All and then click Next
   • Read the license and accept to install PyDev
   • Hit Next and then Finish. Click Yes to restart Eclipse
4. Once Eclipse reloads with PyDev installed, setup the default interpreter to point to your Python 2.7 installation
   • Go to Window > Preferences
   • Expand the PyDev node in the tree view to the left
   • Select the sub-node "Interpreter - Python"
   • Click "New" and browse the folder where you installed Python 2.7
   • Click okay
5. Now you have a working Eclipse + PyDev Development environment setup. From here grab the badgeup source using step 2 from the Visual Studio setup above. Once you have the source, in Eclipse go to File > Import and select General > Existing Projects into Workspace. Click next and navigate to src/CPy27/badgeup/. Click Finish.
6. Since the CPy27/badgeup project depends on pySerial, you'll also need to download and install pySerial. See here for more detail.

You could also optionally install Python tools for Visual Studio here