Introduccin a Arduino I:

Jugando con Leds y

pulsadores
Taller 1: Introduccin a Arduino. Jugando con Leds y pulsadores

"El verdadero progreso es el que pone la

tecnologa al alcance de todos."

(Henry Ford)
 Taller 1: Introduccin a Arduino. Jugando con Leds y pulsadores

7 Anexo: Gua de lenguaje Arduino.

7.1 Funciones
Una funcin es un bloque de cdigo que tiene un nombre y un conjunto de
instrucciones que son ejecutadas cuando se llama a la funcin. Son funciones
setup() y loop() de las que ya se ha hablado. Las funciones de usuario pueden ser
escritas para realizar tareas repetitivas y para reducir el tamao de un programa.
Las funciones se declaran asociadas a un tipo de valor. Este valor ser el que
devolver la funcin, por ejemplo 'int' se utilizara cuando la funcin devuelva un
dato numrico de tipo entero. Si la funcin no devuelve ningn valor entonces se
colocara delante la palabra void, que significa funcin vaca. Despus de
declarar el tipo de dato que devuelve la funcin se debe escribir el nombre de la
funcin y entre parntesis se escribirn, si es necesario, los parmetros que se
deben pasar a la funcin para que se ejecute.

t i p o n o mb r e F u n ci n (p a r me t r o s)
{
i n str u cci o n e s;
}

La funcin siguiente devuelve un numero entero, delayVal() se utiliza para

poner un valor de retraso en un programa que lee una variable analgica de un
potencimetro conectado a una entrada de Arduino. Al principio se declara como
una variable local, v recoge el valor ledo del potencimetro que estar
comprendido entre 0 y 1023, luego se divide el valor por 4 para ajustarlo a un
margen comprendido entre 0 y 255, finalmente se devuelve el valor v y se
retornara al programa principal.

i n t del a yVal ( )
{
i n t v; / / cr ea u n a va ri a bl e te mp o r a l ' v'
v= a n a lo g Re a d( p o t ); / / l e e e l val o r del p o te n ci me t r o
v / = 4 ; / / co n vi er t e 0 - 1 0 2 3 a 0 -2 5 5
r e t u r n v; / / d e vu el ve el val or fi n al
}

7.2 {} entre llaves

Las llaves sirven para definir el principio y el final de un bloque de
instrucciones. Se utilizan para los bloques de programacin setup(), loop(), if.., etc.

t yp e f u n ci n( )
{
i n str u cci o n e s;
}
 Taller 1: Introduccin a Arduino. Jugando con Leds y pulsadores

Una llave de apertura { siempre debe ir seguida de una llave de cierre

}, si no es as el compilador dar errores. El entorno de programacin de Arduino
incluye una herramienta de gran utilidad para comprobar el total de llaves. Solo
tienes que hacer clic en el punto de insercin de una llave abierta e
inmediatamente se marca el correspondiente cierre de ese bloque (llave cerrada).

7.3 ; punto y coma

El punto y coma ; se utiliza para separar instrucciones en el lenguaje de
programacin de Arduino. Tambin se utiliza para separar elementos en una
instruccin de tipo bucle for.

i n t x = 1 3 ; / / de cl a r a l a va ri a bl e ' x' como t i p o

/ / e n t e ro d e val or 1 3

Nota: Si olvidis poner fin a una lnea con un punto y coma se producir en
un error de compilacin. El texto de error puede ser obvio, y se referir a la falta de
un punto y coma, o puede que no. Si se produce un error raro y de difcil deteccin
lo primero que debemos hacer es comprobar que los puntos y comas estn
colocados al final de las instrucciones.

7.4 /* */ bloque de comentarios

Los bloques de comentarios, o comentarios multi-linea son reas de texto
ignorados por el programa que se utilizan para las descripciones del cdigo o
comentarios que ayudan a comprender el programa. Comienzan con / * y terminan
con * / y pueden abarcar varias lneas.

/ * e st o e s u n bl oq u e de co me n t a r i o no se d e b e ol vid a r
ce r r a r lo s co me n t a r i o s e st o s d eb e n est a r e q uili br a d o s */

Debido a que los comentarios son ignorados por el compilador y no ocupan

espacio en la memoria de Arduino pueden ser utilizados con generosidad. Tambin
pueden utilizarse para "comentar" bloques de cdigo con el propsito de anotar
informaciones para depuracin y hacerlo ms comprensible para cualquiera.

Nota: Dentro de una misma lnea de un bloque de comentarios no se puede

escribir otra bloque de comentarios (usando /*..*/).

7.5 // lnea de comentarios

Una lnea de comentario empieza con / / y terminan con la siguiente lnea de
cdigo. Al igual que los comentarios de bloque, los de lnea son ignoradas por el
programa y no ocupan espacio en la memoria.

/ / Est o e s u n co me n t a ri o
 Taller 1: Introduccin a Arduino. Jugando con Leds y pulsadores

Una lnea de comentario se utiliza a menudo despus de una instruccin,

para proporcionar ms informacin acerca de lo que hace esta o para recordarla
ms adelante.

7.6 Variables
Una variable es una manera de nombrar y almacenar un valor numrico
para su uso posterior por el programa. Como su nombre indica, las variables son
nmeros que se pueden variar continuamente en contra de lo que ocurre con las
constantes cuyo valor nunca cambia. Una variable debe ser declarada y,
opcionalmente, asignarle un valor. El siguiente cdigo de ejemplo declara una
variable llamada variableEntrada y luego le asigna el valor obtenido en la entrada
analgica del PIN2:

i n t vari a bl e En tr a d a = 0 ; / / d e cl ar a u na va ri a bl e y le
/ / a sig n a el valo r 0
va r ia bl e En t r ad a = a n al og Re a d (2 ) ; / / la va ri a bl e r e co g e
/ / e l va lo r an al gi co de l PI N2

'variableEntrada' es la variable en s. La primera lnea declara que ser de

tipo entero int. La segunda lnea fija a la variable el valor correspondiente a la
entrada analgica PIN2. Esto hace que el valor de PIN2 sea accesible en otras
partes del cdigo. Una vez que una variable ha sido asignada, o re-asignada, usted
puede probar su valor para ver si cumple ciertas condiciones, o puede utilizar
directamente su valor. Como ejemplo ilustrativo veamos tres operaciones tiles con
variables: el siguiente cdigo prueba si la variable entradaVariable es inferior a
100, si es cierto se asigna el valor 100 a entradaVariable y, a continuacin,
establece un retardo (delay) utilizando como valor entradaVariable que ahora
ser como mnimo de valor 100:

i f (e n t r ad a Va ri a bl e < 1 0 0 ) / / p re g u n t a si l a vari a bl e e s
{ / / me n o r d e 1 0 0
e n t r a d a Vari a bl e = 1 00 ; / / si e s ci er t o a si g na el val or
} //100
d e l a y( e n tr a d a Va ria bl e ) ; // u sa el va lor co mo r e t a r d o

Nota: Las variables deben tomar nombres descriptivos, para hacer el cdigo
ms legible. Los nombres de variables pueden ser contactoSensor o pulsador
, para ayudar al programador y a cualquier otra persona a leer el cdigo y
entender lo que representa la variable. Nombres de variables como var o
valor, facilitan muy poco que el cdigo sea inteligible. Una variable puede ser
cualquier nombre o palabra que no sea una palabra reservada en el entorno de
Arduino.
 Taller 1: Introduccin a Arduino. Jugando con Leds y pulsadores

7.7 Declaracin de variables

Todas las variables tienen que declararse antes de que puedan ser
utilizadas. Para declarar una variable se comienza por definir su tipo como int
(entero), long (largo), float (coma flotante), etc., asignndoles siempre un nombre,
y, opcionalmente, un valor inicial. Esto solo debe hacerse una vez en un programa,
pero el valor se puede cambiar en cualquier momento usando aritmtica y
reasignaciones diversas.

El siguiente ejemplo declara la variable entradaVariable como una variable

de tipo entero int, y asignndole un valor inicial igual a cero. Esto se llama una
asignacin.

i n t en t r ad a Va ri a bl e = 0;

Una variable puede ser declarada en una serie de lugares del programa y en
funcin del lugar en donde se lleve a cabo la definicin esto determinara en que
partes del programa se podr hacer uso de ella.

7.8 utilizacin de una variable

Una variable puede ser declarada al inicio del programa antes de la parte de
configuracin setup(), a nivel local dentro de las funciones, y, a veces, dentro de un
bloque, como para los bucles del tipo if.. for.., etc. En funcin del lugar de
declaracin de la variable as se determinara el mbito de aplicacin, o la capacidad
de ciertas partes de un programa para hacer uso de ella.

Una variable global es aquella que puede ser vista y utilizada por cualquier
funcin y estamento de un programa. Esta variable se declara al comienzo del
programa, antes de setup().

Una variable local es aquella que se define dentro de una funcin o como
parte de un bucle. Solo es visible y solo puede utilizarse dentro de la funcin en la
que se declar.

Por lo tanto, es posible tener dos o ms variables del mismo nombre en

diferentes partes del mismo programa que pueden contener valores diferentes. La
garanta de que solo una funcin tiene acceso a sus variables dentro del programa
simplifica y reduce el potencial de errores de programacin.

El siguiente ejemplo muestra como declarar a unos tipos diferentes de

variables y la visibilidad de cada variable:

i n t valu e ; / / ' val u e' e s vi si bl e pa r a cua l q uie r

f u n ci n
vo i d se t u p ()
{
 Taller 1: Introduccin a Arduino. Jugando con Leds y pulsadores

/ / n o e s ne ce sa ri o co n fi g ur a r na d a e n e st e e je mp l o
}
vo i d l oo p ()
{
f o r (i n t i =0 ; i <20 ; ) / / 'i ' so lo e s vi si bl e
{ / / d e n tr o d el b u cl e f or
i ++
} / / ' f' e s vi si bl e so lo
f l o a t f ; / / de n t r o d e l o op ( )
}

7.9 Tipos de datos

7.9.1 Byte
Byte almacena un valor numrico de 8 bits sin decimales. Tienen un rango
entre 0 y 255.

b yt e u n a Va ri abl e = 1 8 0 ; / / d e cl ar a 'u na Va r i abl e ' co mo

/ / d e ti p o b y t e

7.9.2 Int
Enteros son un tipo de datos primarios que almacenan valores numricos de
16 bits sin decimales comprendidos en el rango 32,767 to -32,768.

i n t u n a Vari a bl e = 1 50 0 ; / / d e cl a r a ' u na Va r i abl e ' co mo

/ / u n a var ia bl e d e ti p o e nt e r o

Nota: Las variables de tipo entero int pueden sobrepasar su valor

mximo o mnimo como consecuencia de una operacin. Por ejemplo, si x = 32767
y una posterior declaracin agrega 1 a x, x = x + 1 entonces el valor se x pasara a
ser -32.768. (algo as como que el valor da la vuelta).

7.9.3 Long
El formato de variable numrica de tipo extendido long se refiere a
nmeros enteros (tipo 32 bits) sin decimales que se encuentran dentro del rango -
2147483648 a 2147483647.

l o n g u n a Va ri abl e = 9 0 0 00 ; / / de cl a r a 'u n a Va ri a bl e' co mo

/ / d e ti p o l on g

7.9.4 Float
El formato de dato del tipo punto flotante float se aplica a los
nmeros con decimales. Los nmeros de punto flotante tienen una mayor
resolucin que los de 32 bits con un rango comprendido 3.4028235E +38 a +38-
3.4028235E.