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 to Wifi Internet (Neighborhood View = F1 key)
• open Terminal Activity (Sugar's list view in the top-right)
• 3 packages you need, each take several min 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 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 USB-A to mini-USB cable attached to ProtoSnap (Ian can provide, or 80 cents @ monoprice.com)
• run "ino upload" then ProtoSnap's bright white light will turn on!
• run "git clone https://github.com/itdaniher/turtleblocks-arduino.git ~/Arduino/TurtleBlocks.activity/plugins/arduino"
• go wild in TurtleArt, submit bug reports to mailing list unleashkids@googlegroups.com (http://groups.google.com/group/unleashkids)
• sample TurtleArt project is here: http://wiki.laptop.org/go/File:TurtleBlocks_Activity.ta