ProtoSnap Contributors Guide

From OLPC
Revision as of 22:53, 25 July 2013 by Holt (talk | contribs) (Now down to business)
Jump to: navigation, search

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