ProtoSnap Contributors Guide

This ProtoSnap Contributors/Testers Guide uses TurtleArt initially, but later Scratch & Etoys are expected. Ask questions on the unleashkids@googlegroups.com mailing list here: http://groups.google.com/group/unleashkids

These instructions have been tested on the XO-4 Touch laptop, and should run on XO-1, XO-1.5, XO-1.75 too. But Ian Daniher will investigate whether "ino" below can be made to run on OLPC Release 11.3.1 (based on Fedora 14) commonly used in Haiti.

Loosely speaking, this 5-phase install will proceed as follows:

1. install requirement
2. setup build environment
3. build it
4. upload it (to the SparkFun board)
5. install the TurtleArt plugin

Now down to business

• Install http://wiki.laptop.org/go/Release_notes/13.2.0#XO-4
• Connect your XO to Wifi Internet (using the F1 key = Neighborhood View)
• Open the Terminal Activity (Sugar's list view in the top-right)
• Install 3 packages, each of which take a couple minutes to install. Run:

 sudo yum install ino
 sudo yum install git   (type "y" when asked if importing GPG key is OK)
 sudo yum install make

• Run the following 4 commands:

 mkdir firmata
 cd firmata
 ino init
 mkdir lib

• Correct a packaging error in "ino", running these 4 commands:

 sudo mkdir /usr/share/arduino/hardware/tools
 sudo cp /etc/avrdude/avrdude.conf /usr/share/arduino/hardware/tools
 cp /usr/share/arduino/libraries/Firmata/examples/StandardFirmata/StandardFirmata.ino ./src/sketch.ino
 ino build

• Plug in a "USB-A to mini-USB" cable, connecting your XO to the ProtoSnap (Ian can provide these, or 80 cents @ monoprice.com). Then run:

 ino upload

• ProtoSnap's bright white light will turn on! Finally, run:

 git clone https://github.com/itdaniher/turtleblocks-arduino.git ~/Arduino/TurtleBlocks.activity/plugins/arduino

• Return to Sugar's Activity wheel (Home View) and launch the TurtleArt Activity. Load the sample TurtleArt project here:

 http://wiki.laptop.org/go/File:TurtleBlocks_Activity.ta

• Go hog wild in TurtleArt, thanks!! Please submit all priority bug reports to our mailing list: unleashkids@googlegroups.com (join @ http://groups.google.com/group/unleashkids)