Getting Started

gregsaul edited this page Nov 17, 2014 · 6 revisions

Step 1 – Assemble

View the assembly instructions here

Once you have assembled and checked that the X,Y & Z axes of your piccolo are sliding smoothly, plug it in by USB or with a 5V power supply.

Step 2 – Program

1) Arduino + Processing
For this you will need the latest version of Arduino. If you need to or would like to make changes to Controllo you will also need Processing.

arduino.cc/en/Main/Software (please download version 1.0.5)
processing.org/download (windows/linux users please download the 32bit versions)

2) Libraries
Before you can run the Piccolo code, you will need the piccolo library for Arduino.

PiccoloLib library for Arduino > PiccoloLib_current
github.com/DiatomStudio/Piccolo/tree/master/PiccoloLib

Have a look at PiccoloLib/examples. Upload ‘USBTether’ to Piccolo to use it with Controllo. Have a look at the ‘Simple’ example for a basic overview of how the library works.

To work with the Controllo code, you will also need a couple of libraries for Processing

Control p5 for Processing >
www.sojamo.de/libraries/controlP5/download/controlP5-2.0.4.zip
Geoometrive for Processing > www.ricardmarxer.com/geomerative/geomerative.zip

3) Controllo

Controllo is a Processing sketch that provides a simple control interface for Piccolo over serial.

You can download the compiled versions here >
Mac/Windows/Linux – Controllo_current.zip

Controllo source > Controllo src

You can now send several generative examples straight from Controllo. You can also open your own SVG to send.

SVG requirements:

  • The SVG must be 300px wide and high.
  • All paths must be expanded (ie: no compound paths)

Step 3 – Test

If Step 2 has been performed and the USBTether Arduino sketch has been uploaded. You will be able to test that your Piccolo is functioning correctly and moving smoothly by holding the “test” button for 2 seconds. This will cause Piccolo to draw a spiral that extends over the entire draw space.