Mostra la font per a Instal·lació de Scratch for Arduino en LliureX

{{Nota|NOTA: El següent manual pot servir per a instal·lar la IDE Arduino i S4A en ordinadors amb Ubuntu 12.04 i versions de LliureX anteriors a la 14.06. Si utilitzes LliureX 14.06 és millor que seguisques el manual "Instal·lació de Scratch for Arduino en LliureX 14.06" disponible en un enllaç al final del manual}} 

== Introducció  ==

'''Scratch for Arduino''' ('''S4A''') ha estat creat per ''Marina Conde, Víctor Casado, Joan Güell, José García i Jordi Delgado'' amb l'ajuda del ''Grup de Programació Smalltalk del Citilab'', un centre dedicat a la investigació, formació i promoció de la tecnologia digital.<br> 

<br> 

[[Image:Scratcharduino00.jpg]]<br> 

"Arduino Uno 3" per datunie disponible en http://www.flickr.com/photos/datunie/8290929509/in/photostream sota llicència CC BY-SA 2.0<br> 

<br> 

== Programari necessari  ==

Per poder utilitzar '''S4A''' és necessari tenir instal·lat prèviament el programari d''''Arduino''' i actualitzar el microprogramari (en anglès ''firmware'') de la placa. Són dos actes que ens permeten equipar al nostre ordinador amb un entorn molt intuïtiu i senzill. 

<br> 

== Programari per Arduino  ==

1. Descarrega i descomprimix l'[http://arduino.cc/en/Main/Software última versió d'Arduino] (En el moment d'actualitzar aquest manual, '''arduino-1.0.6-linux32.tgz''').

<br> [[Image:Scratcharduino01.png]] 

Contingut de l'arxiu '''arduino-1.0.6-linux32.tgz''' descomprimit en la carpeta '''arduino-1.0.6''' amb el programari '''arduino''' preparat per a executar.<br> 

Són importants el fitxer '''arduino''' que ens permet programar i accedir a la placa, i la carpeta de '''''hardware'''''. Ho utilitzarem en el següent apartat per a pujar el Firmware a la targeta Arduino.

<br> 2. Activa els repositoris d'Ubuntu 12.04 LTS per a instal·lar dos paquets que no estan inclosos en LliureX.

Ves a Aplicacions > Administració de LliureX > Centre de control de LliureX

<br> [[Image:Scratcharduino22.png]]

<br> Selecciona "Fonts de programari"

<br> [[Image:Scratcharduino23.png]] <br>

<br> Fes clic en el botó "Avançat"

<br> [[Image:Scratcharduino24.png]] <br>

<br> Selecciona les 4 primeres caselles

<br> [[Image:Scratcharduino25.png]] <br>

<br> Fes clic en el botó "Tanca"

<br> [[Image:Scratcharduino26.png]] <br>

<br> En el següent quadre fer clic en "Actualitza"

<br> [[Image:Scratcharduino27.png]] <br>

<br> 3. Instal·la els paquets del compilador (gcc-avr) i les biblioteques (avr-libc): 

Obri un Terminal

Ves a Aplicacions > Accessoris > Terminal

<br> [[Image:Scratcharduino28.png]] <br>

<br> Copia la següent ordre en el terminal (Pots copiar el text i pegar-ho en el Terminal utilitzant la combinació de tecles Ctrl+SHIFT+V)

<pre> sudo apt-get install gcc-avr avr-libc</pre> 

<br> Introdueix la contrasenya i polsa ENTER.

<br> [[Image:Scratcharduino29.png]] <br>

<br> 4. Desactiva els repositoris d'Ubuntu 12.04 LTS. Així evitem problemes amb futures actualitzacions del sistema operatiu.

<br> Has de seguir els passos de l'apartat 2 i desactivar les 4 caselles del següent quadre.

<br> [[Image:Scratcharduino25.png]] <br>

<br> 5. Per a utilitzar el port USB per al diàleg s'ha d'afegir l'usuari del sistema al grup 'dialout' amb la finalitat de tenir permisos d'escriptura en aquest port: 

Obri un terminal i executa:

<pre> sudo usermod -aG dialout &lt;usuari&gt;</pre>

6. Finalitza la sessió i tornar a iniciar-la per a que s'apliquen aquests permisos.

== ''Firmware'' de S4A  ==

Cal canviar el microprogramari que té la placa '''Arduino''' perquè '''S4A''' puga comunicar-se i així treballar. 

Aquest programari està disponible a la pàgina web de '''S4A''' a la zona de [http://s4a.cat/index_ca.html descàrregues] (En el moment d'actualitzar aquest manual, '''S4AFirmware16.ino''').<br> 

Creem una carpeta anomenada '''S4AFirmware16''' en /arduino-1.0.6/hardware/arduino/firmwares/ i hi copiem el fitxer descarregat.<br> 

<br> 

[[Image:Scratcharduino02.png]] 

<br> 

Seguidament hem de pujar aquest microprogramari a la placa. Per això ens valdrem del programari d''''Arduino'''. 

Anem a la carpeta '''arduino-1.0.6''' i executem el programa '''arduino'''.<br> 

Apareix la finestra principal del programa, similar a la mostrada a continuació: 

<br> 

[[Image:Scratcharduino03.png]] 

<br> 

Per obrir el microprogramari ens anem a l'opció del menú '''Fitxer''' i seleccionem '''Obrir...'''<br> 

<br> 

En el quadre de cerca que sorgirà, ens desplaçarem fins al lloc on tenim guardat el ''firmware''.<br> 

<br> 

[[Image:Scratcharduino05.png]] 

<br> 

Apareix en una nova finestra el contingut del microprogramari que passarem a la placa. 

<br> 

[[Image:Scratcharduino06.png]] 

<br> 

Comprovem que tenim la placa correctament seleccionada: Eines &gt; Placa. En el nostre cas és '''Arduino Uno'''.<br> 

<br> 

[[Image:Scratcharduino07.png]] 

<br> 

Comprovem que tenim el port correctament seleccionat: Eines &gt; Port sèrie. En el nostre cas és'''/dev/ttyACM0'''<br> 

<br> 

[[Image:Scratcharduino08.png]] 

<br> 

{{Nota|NOTA: Has de tenir la placa connectada a l'ordinador mitjançant la connexió USB. Si l'opció Port sèrie no està activa, hauràs de reiniciar l'ordinador.}} 

<br> 

Seleccionem l'icona '''Puja''' de la barra d'eines. 

<br> 

[[Image:Scratcharduino09.png]] 

<br> 

A la part inferior apareix l'estat del procés i després d'un moment, si no hi ha problemes, ens indicarà que s'ha realitzat: Pujada enllestida. 

<br>[[Image:Scratcharduino10.png]] 

<br>

== Scratch for Arduino (S4A)  ==

Ja estem en disposició d'instal·lar S4A i per a això caldrà tornar a visitar la secció de [http://s4a.cat/index_ca.html descàrregues] de la pàgina web del projecte. En l'apartat instal·lació descarreguem el paquet .deb per a Linux (Debian) (En el moment d'actualitzar aquest manual, S4A16.deb). 

Copia la següent ordre en el terminal (Pots copiar el text i pegar-ho en el Terminal utilitzant la combinació de tecles Ctrl+SHIFT+V)

<pre> sudo dpkg -i /home/lliurex/S4A16.deb </pre>

Tingues en compte que has d'indicar la ruta correcta del teu fitxer on posa "/home/lliurex/S4A16.deb".

Una vegada finalitzat el procés d'instal·lació, podem iniciar S4A: Aplicacions &gt; Educació &gt; Scratch per a Arduino. Pot aparéixer en l'apartat programació. També és possible que tingues que finalitzar la sessió i tornar a iniciar-la per a que t'aparega S4A en el menú.  També pots iniciar S4A llançant directament l'ordre S4A en el Terminal.

<br> 

[[Image:Scratcharduino12.png]] 

<br>

Important: Si en l'equip només instal·les S4A perquè la targeta Arduino ja té carregat el Firmware corresponent i S4A no se connecta amb eixa placa és possible que tingues que afegir el teu usuari al grup dialout.

Comprova que el teu usuari pertany al grup dialout: Obri un terminal i executa l'ordre groups. Si el grup dialout no apareix, hauràs d'afegir-te amb la següent ordre.

<pre> sudo usermod -aG dialout "nomusuari" </pre>

On "nomusuari" és el teu nom d'usuari. No poses les cometes.

Després reinicia la sessió.

== Instal·lació de S4A en Ubuntu/Debian/LliureX 64 bits ==

Per fer funcionar S4A en una versió de 64 bits de Ubuntu/Debian/LliureX, és necessari seguir els següents passos (en un terminal, com root):

Per permetre instal·lar paquets i386

<pre> dpkg --add-arquitectura i386 </pre>
<pre> apt-get update </pre>
<pre> apt-get install ia32-libs </pre>

Després instal·la S4A:
<pre> dpkg -i --force-arquitectura S4A16.deb </pre>

Font: [http://s4a.cat/index.html "I can't install it on 64-bit Ubuntu/Debian" en pàgina oficial de S4A]

Si no te funciona puedes probar esto: [http://blog.elcacharreo.com/2014/07/10/usar-s4a-scratch-for-arduino-en-ubuntu-linux-de-64-bits/ Usar S4A (scratch for arduino) en ubuntu (linux) de 64 bits]

== Provant S4A  ==

Abans d'executar el programa és convenient tenir connectada a l'ordinador la placa Arduino, ja que la seva recerca serà una de les primeres coses que farà. Quan l'haja trobat, en el quadre resum de valors d'entrada les quantitats mostrades aniran variant molt ràpidament. 

<br> 

[[Image:Scratcharduino14.png]] 

<br> 

Estem preparats per provar el programa i el millor serà utilitzar els exemples que ja té creats l'equip del projecte i que estan a disposició de tots/es. Anem a la secció de [http://s4a.cat/index_ca.html Docs] del projecte. Dins d'ella hi ha un apartat dedicat a '''Exemples Bàsics''' que conté l'exemple de muntatge '''Polsador i LED''' i el codi corresponent.

[[Image:Scratcharduino15.png]]

== Afegir llançador Arduino al Menú Principal  ==

Si volem tenir el programari Arduino al menú principal de LliureX, llancem Paràmetres del Sistema... &gt; Menú Principal. Seleccionem el menú Educació i fem clic al botó &lt;&lt;Element Nou&gt;&gt;.<br> 

<br>

[[Image:Scratcharduino16.png]]<br> 

<br>

[[Image:Scratcharduino17.png]]<br> 

<br>

Els paràmetres que hem d'incloure són:<br> 

Tipus: '''Aplicació'''<br> 

Nom: '''Arduino'''<br> 

Orde: Hem de navegar fins a la carpeta on està l'aplicació. A l'exemple, la carpeta arduino-1.0.6 es troba en el directori /home/tecnologia, així que l'ordre per a llançar arduino seria: '''/home/tecnologia/arduino-1.0.6/arduino'''<br> 

Comentari: '''Programari Arduino'''<br> 

I així quedaria Arduino en el menú principal.<br> 

<br>

[[Image:Scratcharduino18.png]]<br> 


<br>

== Crèdits  ==

Adaptació a LliureX 12.06 Nemo del manual "[http://recursostic.educacion.es/observatorio/web/es/software/software-educativo/1018-monograficodesarrollos-de-scratch-para-robotica-enchanting-y-s4a?start=3 Scratch for Arduino (S4A)]" en "MONOGRÁFICO: Desarrollos de Scratch para robótica, Enchanting y S4A" escrit per Sergio González Moreau.<br>

Obra de Daniel Turienzo Nieto disponible sota llicència de cultura lliure [http://creativecommons.org/licenses/by-sa/4.0/deed.ca Creative Commons Reconeixement-CompartirIgual 4.0 Internacional]. 

Actualitzacions del manual d'instal·lació:

Manual actualitzat el 7 de gener de 2014 per a adaptar-lo a LliureX 13.06 Pandora

Manual actualitzat el 22 de setembre de 2014 per a adaptar-lo a LliureX 14.06 Platinum

Manual actualitzat el 5 de febrer de 2015 per a incloure l'enllaç a la versió 1.6 de S4A i la modificació per a projectes de tecnologia corresponent

NOTA DE ERRORES:

- Des de la creació d'aquest manual, el 20 de desembre de 2012, han aparegut noves versions dels programes Arduino i S4A, pel que alguna imatge pot pertanyer a una versió antiga. Es recomanable fer cas del text.

== Modificació de la versió 1.5 de S4A per a control de projectes de tecnologia (Obsolet) ==

Després de contactar amb Victor Casado, els creadors de S4A han creat un pedaç que habilita un total de sis entrades digitals (pins 2, 3, 4, 5, 6 i 7) i quatre eixides digitals (pins 10, 11, 12 i 13). En principi, es podrà programar també 1 eixida analògica (pin digital 9) i 1 eixida especial per a connectar servomotors de rotació contínua Parallax (pin digital 8). 

Aquest pedaç està basat en la versió 1.5 de S4A, disponible ací: [https://www.dropbox.com/s/ggnybgpqeoltwva/S4A15.deb?dl=0 S4A15.deb].

T'has de descarregar el fitxer comprimit [https://www.dropbox.com/s/fn2s4kwgsz6yphz/S4ADT.zip?dl=0 S4ADT.zip] que inclou el fitxer d'imatge i firmware.

<br> [[Image:Scratcharduino19.png]]<br> 

<br> El fitxer a dintre de la carpeta S4AFirmwareDT és l'sketch modificat, que s'ha de carregar a la placa Arduino (veure [http://wikimanuals.edutictac.es/index.php?title=Instal%C2%B7laci%C3%B3_de_Scratch_for_Arduino_en_LliureX#Firmware_de_S4A Firmware de S4A])

La imatge modificada (S4A.image) s'ha de copiar al directori on està instal·lat l'S4A (sobreescrivint la ja existent) juntament amb la carpeta '''locale''', la qual porta els fitxers de traducció a català i castellà actualitzats. En LliureX, l'S4A es troba a /usr/lib/s4a.

<br> [[Image:Scratcharduino20.png]]

== Modificació de la versió 1.6 de S4A per a control de projectes de tecnologia  ==

<br>

Per a disposar de sis entrades digitals (pins 2, 3, 4, 5, 6 i 7) i quatre eixides digitals (pins 10, 11, 12 i 13) en la versió 1.6 de S4A disposem d'un fitxer modificat S4A16DT.deb i del corresponent firmware S4AFirmwareDT.ino. Aquesta modificació ha sigut realitzada per Joaquín López, membre d'Edutictac, i està disponible en un fitxer comprimit que podeu descarregar ací: [https://www.dropbox.com/s/eysbbe6a6b1be7z/S4A16DT.zip?dl=0 S4A16DT.zip].

<br>

[[Image:Scratcharduino21.png]]<br>

<br>

Només cal descomprimir els fitxers, executar S4A16DT.deb i carregar el firmware S4AFirmwareDT.ino a la placa Arduino (veure [http://wikimanuals.edutictac.es/index.php?title=Instal%C2%B7laci%C3%B3_de_Scratch_for_Arduino_en_LliureX#Firmware_de_S4A Firmware de S4A])

Per a executar S4A16DT.deb hem de fer servir la següent ordre:

<pre>sudo dpkg -i /home/lliurex/S4A16DT.deb</pre> 

<br>

== Fòrum de dubtes ==

- [http://edutictac.es/moodle/mod/forum/view.php?f=172 Fòrum d'Scratch, S4A i Arduino en Edutictac]<br>

- [https://groups.google.com/forum/#!forum/s4a-community Llista de correu oficial de S4A]

== Recursos  ==

- [http://apliense.xtec.cat/arc/node/29197 Sistema domòtic per habitatges amb Scratch for Arduino]<br>

- [[Projectes amb Scratch i Arduino per a tecnologia. Aplicacions educatives]] <br>

- [https://tecnopujol.wordpress.com/s4a/ Guía de trabajo para S4A: Scratch for Arduino] <br>

<br>

== Enllaços  ==

- [http://s4a.cat/index_ca.html Scratch for Arduino en Citilab]<br> 

- [http://playground.arduino.cc//Linux/Ubuntu Instal·lar Arduino en Ubuntu Linux] (en anglés) - Apartat: '''Ubuntu (without 'arduino' package)'''<br>

- [[Instal·lació de Scratch for Arduino en LliureX 14.06|Instal·lació d'Scratch for Arduino en LliureX 14.06]]

== [[Projectes amb Scratch i Arduino per a tecnologia. Aplicacions educatives]]  ==

{{Languages|Instal·lació de Scratch for Arduino en LliureX}}

[[Category:S4A]] [[Category:LliureX]] [[Category:Arduino]]