La Malinette is an open source project by Reso-nance Numérique Programming Interactivity Kit

Transcription

1 La Malinette is an open source project by Reso-nance Numérique Programming Interactivity Kit

2

3 La Malinette is a pedagogical tool under free license to discover and learn to build interactive systems. Inside, there are a software and electronic devices, an Arduino board and a set of sensors and actuators. This project is developped by the Reso-nance numérique collective since It is used in education (schools, colleges, faculties), and also as a tool to make artistic pieces. The learning way is experimental, transdisciplinary and fun. Sommaire Installation Software interface Getting started with Pure Data Sensors Actuators Electronic Board and wires Projet #1 : Graphite control! Projet #2 : Stroboscope!

4 Installation Install the Pure Data Extended software Download and uncompress the Malinette folder Install the Arduino software Plug the Arduino board, then open the Arduino software. Select Leonardo board from Tools > Boards and the Serial Port. Open the StandardFirmata example from Files > Examples > Firmata, and upload it into the board. Open the MALINETTE-en.pd file for the english version. structure Folders organisation Folders and files Description abstractions all objects (in, numbers, audio, video, out, ) data media files used in the examples docs some documentations, all objects, examples examples patchs lib some externals objects other others programs, utilities and scripts projects store your projects licence.txt GNU/GPL3 license readme.txt useful informations MALINETTE-fr.pd french version MALINETTE-en.pd launch the Malinette! * TCL Optional A TCL plugin, based on Kiosk, is inside the./other/tcplugins folder of the Malinette. It allows you to show all objects with a right clic and some little visuals effects. To install it, go on Edit > Preferences menu from Pd-extended, add (New) the path to the folder./other/tclplugins and restart Pure Data.

5 Interface? HELP Two windows are opened : the menu and the NEW project. Don t close MALINETTE-en.pd.? HELP Getting started with Pure Data and the Malinette PATCHS EXAMPLES PROJECTS PATCHS Patchs is the name for Pure Data files. Here are the examples files to see and copy. Save (Edit > Save as) and find your patchs in the projects folder. OBJECTS IN NUMBERS AUDIO VIDEO OUT AUDIO VU GAIN 1 VOL pd record RECORD CHOOSE FILE ARDUINO CHECK DEVICES MAIN CPU:5% VIDEO WIDTH 320 HEIGHT 240 PRESETS OPTIONS AUDIO VIDEO xp 3 PORT TEST:13 OBJECTS Objects are organized by family. Look at their descriptions in./docs/overview.html AUDIO Check this box to switch on and off the sound. Control le master level with the slider. All [audio-out] objects are routed through this master. VIDEO Check this box to show or hide the video window, handled here by GEM a graphical library for Pure Data. The presets change the size of the window and with the options you can go further. RECORD Choose a file, select which media to record (audio and/or vidéo) and check this box. ARDUINO The board is recognized automatically. If not, you have to clic on «CHECK DEVICES» which display of the serial ports availables into the Pure Data console. Write the right port avec check the box. Test it with the «TEST:13» button to blink the LED of the Arduino board.

6 Pure Data Pure Data is graphical programming language for multimedia projects. We create a programm by connecting boxes together, it is called a patch. The Malinette software is a collection of patch that s why it is useful to understand the basics of Pure Data. There are two modes in Pure Data. The edition mode and the action mode. You can switch between them with the Edit > mode menu or with this short key : Ctrl + e (Cmd + e sur Mac) EDITION MODE to create object, connect, move, etc. Create object Select Duplicate Connect Disconnect ACTION MODE to trigger events, change numbers, draw, etc. Trigger Change Graphical objects Write symbols Draw a number inside a array

7 Help All objects have their helps : Right clic > Help on objects. Elements delay 0 symbol object du texte... message number symbol comment Inputs/Outputs Objects have inputs on the top and outputs on the bottom. We connect them by clicking, drag & drop to the input of the next object. input > output > delay < cold input Arguments The arguments are used on some objects to initialize them. Look at the Help (Right clic > Help). f ade 2000 un argument sel plusieurs arguments Messages The messages are used to control more parameters. r 1, g 0.3, b 0.2, a Somes commands into a message shape (look at help). Here, we change all colors : red (r), green (g), blue (b) and alpha (a). video input video-colors r g b a video output a $1 $1 is often used id Pure Data. It is updated by the number above, in the number box. Here, we change the transparency (alpha) of an image or video.

8 Sensors Potentiometer rotation sensor 0/10kΩ +5V ANALOG IN GND 10kΩ Photoresistor luminosity sensor +5V ANALOG IN GND Resistive foam pression sensor 10kΩ +5V ANALOG IN GND Piezoelectric vibration sensor 1MΩ ANALOG IN GND Infrared distance sensor +5V ANALOG IN GND

9 Actuators 220Ω L.E.D light DIGITAL-OUT Digital or ~ (PWM) GND Plug a battery on the terminal strip. Motor DC (direct current) rotation movement Ω Use these digital outputs : M1 : 4 (direction - digital) et 5 (speed- PWM) M2 : 7 (direction - digital) et 6 (speed- PWM) Servomotor angular movement GND DIGITAL-OUT +5V ~ (Servo) light, motor, etc. Relay 5V-220V control 220V with 5V 0 1 There are two positions on the terminal strip. GND DIGITAL-OUT +5V Digital Buzzer sound GND DIGITAL-OUT Digital or ~ (PWM / Servo)

10 Electronic Board Arduino RoMeo [Leonardo type] RoMeo V2.0[R3] DIGITAL 4 OFF POWER ANALOG IN 5 ON OFF ON USB servomotors supply digital inputs/outputs (including PWM) motors 1 and 2 outputs supply for the board and motors analog inputs buttons More informations on the board :

11 Connections Wires Breadboard 3 crocodile clamps Points of the columns (B) are connected Points of the rows (A) are connected A and B are not connected The columns are not connected together, rows either. 1 A B C D E F G H I J 9 jumpers 5 10 B 15 2 connectors A 30 A B C D E F G H I J

12 Projet #1 GRAPHITE CONTROL! This example use the graphite material of a stencil lik e a controller. More the stencil is far from the electrode connected to the paper, more the resistance is big. With this patch, we can control the pitch of a synthetic sound and the movement of a servomotor. 1 A B C D E F G H I J A B C D E F G H I J

13 PATCH Check the analog input 0 (checked by default) to get the voltage value of the circuit (between 0 and 1) Simple mathematics to convert the value between 40 and 80 (MIDI notes) Musical scales conversion Check the output 9 and Servo box on the arduino-out object and connect all like this : none digital pwm servo rst arduino-analog-in rst vu map notescale V major Root note audio-out VOL M F V vu L..R P 0 C synth ~ / I_I G1 G2 O 5V GND Output 9 Entrée 0 The graphite is a conductor The length of the graphite between the stencil and the clamp change the resistance of the circuit.

14 Projet #2 STROBOSCOPE! Here, we build a stroboscope light, where the speed change by a sequencer in the Malinette. We use a relay to switch on and off the light. 1 A B C D E 5 F G H I J A B C D E F G H I J NEUTRAL PHASE 230V Plug (we don t use the ground)

15 PATCH seq-taptempo ms 120 We use the seq-taptempo object to change the speed This toggle object converts bang in 0 and none digital pwm servo rst Check the 13 digital output of the arduino-out object to control the 13 output. The digital mode has two states : 0 and 1 to switch off (0V) and on (5V). Output 13 5V GND Please be careful! A 230V circuit is dangerous! Use a halogen light which support those king of electric triggers. Don t use Neon light.

16 GNU / FDL 1.3 GNU / GPL 3