Computing">
Capitulo 3 Lenguaje de Programacion para Arduino: 3.1 Introducción
Capitulo 3 Lenguaje de Programacion para Arduino: 3.1 Introducción
Capitulo 3 Lenguaje de Programacion para Arduino: 3.1 Introducción
3.1 Introducción
El lenguaje de programación de Arduino está basado en C++ y aunque la
referencia para el lenguaje de programación de Arduino lo describiremos mas
adelante, también es posible usar comandos estándar de C++ en la programación
de Arduino.
3.2. Estructura
La estructura básica del lenguaje de programación de Arduino es bastante
simple y se compone de al menos dos partes. Estas dos partes necesarias, o
funciones, encierran bloques que contienen declaraciones, estamentos o
instrucciones.
void setup()
{
estamentos;
}
void loop()
{
estamentos;
}
1
En donde setup() es la parte encargada de recoger la configuración y loop() es la
que contienen el programa que se ejecutará cíclicamente (de ahí el termino loop
–bucle-).
Ambas funciones son necesarias para que el programa trabaje.
Setup()
La función setup() se invoca una sola vez cuando el programa empieza. Se
utiliza para inicializar los modos de trabajo de los pins, o el puerto serie. Debe
ser incluido en un programa aunque no haya declaración que ejecutar.
void setup()
{
pinMode(pin, OUTPUT); // configura el 'pin' como salida
}
Loop()
Después de llamar a setup(), la función loop() hace precisamente lo que sugiere
su nombre, se ejecuta de forma cíclica, lo que posibilita que el programa este
respondiendo continuamente ante los eventos que se produzcan en la tarjeta
void loop()
{
digitalWrite(pin, HIGH); // pone en uno (on, 5v) el ´pin´
delay(1000); // espera un segundo (1000 ms)
digitalWrite(pin, LOW); // pone en cero (off, 0v.) el ´pin´
delay(1000);
}
2
Funciones
Una función es un bloque de código que tiene un nombre y un conjunto de
estamentos que son ejecutados cuando se llama a la función. 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 tamaño de un programa.
Las funciones se declaran asociadas a un tipo de valor “type”. Este valor será el
que devolverá la función, por ejemplo 'int' se utilizará cuando la función
devuelva un dato numérico de tipo entero. Si la función no devuelve ningún
valor entonces se colocará delante la palabra “void”, que significa “función
vacía”. Después de declarar el tipo de dato que devuelve la función se debe
escribir el nombre de la función y entre paréntesis se escribirán, si es necesario,
los parámetros que se deben pasar a la función para que se ejecute.
type nombreFunción(parámetros)
{
estamentos;
}
int delayVal()
{
int v; // crea una variable temporal 'v'
v= analogRead(pot); // lee el valor del potenciómetro
v /= 4; // convierte 0-1023 a 0-255
return v; // devuelve el valor final
}
Entre llaves {}
Las llaves sirven para definir el principio y el final de un bloque de
instrucciones. Se utilizan para los bloques de programación setup(), loop(), if..,
etc.
3
type funcion()
{
estamentos;
}
Una llave de apertura “{“ siempre debe ir seguida de una llave de cierre “}”, si
no es así el programa dará errores. El entorno de programación de Arduino
incluye una herramienta de gran utilidad para comprobar el total de llaves. Sólo
tienes que hacer click en el punto de inserción de una llave abierta e
inmediatamente se marca el correspondiente cierre de ese bloque (llave cerrada).
Punto y Coma
El punto y coma “;” se utiliza para separar instrucciones en el lenguaje de
programación de Arduino. También se utiliza para separar elementos en una
instrucción de tipo “bucle for”.
Nota: Olvidarse de poner fin a una línea con un punto y coma se traducirá en un
error de compilación. El texto de error puede ser obvio, y se referirá a la falta de
una coma, o puede que no. Si se produce un error raro y de difícil detección lo
primero que debemos hacer es comprobar que los puntos y comas están
colocados al final de las instrucciones.
Bloque de Comentarios
Los bloques de comentarios, o multi-línea de comentarios, son áreas de texto
ignorados por el programa que se utilizan para las descripciones del código o
comentarios que ayudan a comprender el programa. Comienzan con / * y
terminan con * / y pueden abarcar varias líneas.
4
también pueden utilizarse para "comentar" bloques de código con el propósito
de anotar informaciones para depuración.
Línea de comentarios
Una línea de comentario empieza con / / y terminan con la siguiente línea de
código. Al igual que los comentarios de bloque, los de línea son ignoradas por el
programa y no ocupan espacio en la memoria.
// esto es un comentario
3.3 Variables
Una variable es una manera de nombrar y almacenar un valor numérico para su
uso posterior por el programa. Como su nombre indica, las variables son
números 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 código de ejemplo declara una
variable llamada variableEntrada y luego le asigna el valor obtenido en la
entrada analógica del PIN2:
Una vez que una variable ha sido asignada, o re-asignada, usted puede probar
su valor para ver si cumple ciertas condiciones (instrucciones if..), o puede
utilizar directamente su valor. Como ejemplo ilustrativo veamos tres
operaciones útiles con variables: el siguiente código prueba si la variable
“entradaVariable” es inferior a 100, si es cierto se asigna el valor 100 a
5
“entradaVariable” y, a continuación, establece un retardo (delay) utilizando
como valor “entradaVariable” que ahora será como mínimo de valor 100:
Nota: Las variables deben tomar nombres descriptivos, para hacer el código más
legible. Nombres de variables pueden ser “contactoSensor” o “pulsador”, para
ayudar al programador y a cualquier otra persona a leer el código y entender lo
que representa la variable. Nombres de variables como “var” o “valor”, facilitan
muy poco que el código sea inteligible. Una variable puede ser cualquier nombre
o palabra que no sea una palabra reservada en el entorno de Arduino.
Declaración 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, asignándoles siempre un nombre, y,
opcionalmente, un valor inicial. Esto sólo debe hacerse una vez en un programa,
pero el valor se puede cambiar en cualquier momento usando aritmética y
reasignaciones diversas.
int entradaVariable = 0;
Una variable puede ser declarada en una serie de lugares del programa y en
función del lugar en donde se lleve a cabo la definición esto determinará en que
partes del programa se podrá hacer uso de ella.
6
declaración de la variable así se determinara el ámbito de aplicación, 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
función 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 función o como parte
de un bucle. Sólo es visible y sólo puede utilizarse dentro de la función en la que
se declaró.
Por lo tanto, es posible tener dos o más variables del mismo nombre en
diferentes partes del mismo programa que pueden contener valores diferentes.
La garantía de que sólo una función tiene acceso a sus variables dentro del
programa simplifica y reduce el potencial de errores de programación.
7
3.4 Tipos de datos
Byte
Byte almacena un valor numérico de 8 bits sin decimales. Tienen un rango entre
0 y 255
Int
Enteros son un tipo de datos primarios que almacenan valores numéricos de 16
bits sin decimales comprendidos en el rango 32,767 to -32,768.
Nota: Las variables de tipo entero “int” pueden sobrepasar su valor máximo o
mínimo como consecuencia de una operación. Por ejemplo, si x = 32767 y una
posterior declaración agrega 1 a x, x = x + 1 entonces el valor se x pasará a ser -
32.768. (algo así como que el valor da la vuelta)
Long
El formato de variable numérica de tipo extendido “long” se refiere a números
enteros (tipo 32 bits) sin decimales que se encuentran dentro del rango -
2147483648 a 2147483647.
Float
El formato de dato del tipo “punto flotante” “float” se aplica a los números con
decimales. Los números de punto flotante tienen una mayor resolución que los
de 32 bits con un rango comprendido 3.4028235E +38 a +38-3.4028235E.
8
Arrays
Un array es un conjunto de valores a los que se accede con un número índice.
Cualquier valor puede ser recogido haciendo uso del nombre de la matriz y el
número del índice. El primer valor de la matriz es el que está indicado con el
índice 0, es decir el primer valor del conjunto es el de la posición 0. Un array
tiene que ser declarado y opcionalmente asignados valores a cada posición antes
de ser utilizado.
Del mismo modo es posible declarar una matriz indicando el tipo de datos y el
tamaño y posteriormente, asignar valores a una posición especifica:
Las matrices se utilizan a menudo para estamentos de tipo bucle, en los que la
variable de incremento del contador del bucle se utiliza como índice o puntero
del array. El siguiente ejemplo usa una matriz para el parpadeo de un LED.
9
for(int i=0; i<8; i++) // crea un bucle tipo for utilizando la variable i de 0
a7
{
analogWrite(ledPin, parpadeo[i]); // escribe en la salida PIN 10 el valor al
que apunta i dentro del array parpadeo[]
delay(200); // espera 200ms
}
}
3.5 Aritmética
Los operadores aritméticos que se incluyen en el entorno de programación son
suma, resta, multiplicación y división. Estos devuelven la suma, diferencia,
producto, o cociente (respectivamente) de dos operandos.
y = y + 3;
x = x - 7;
i = j * 6;
r = r / 5;
Si los operandos son de diferentes tipos, para el cálculo se utilizará el tipo más
grande de los operandos en juego. Por ejemplo, si uno de los números
(operandos) es del tipo float y otra de tipo integer, para el cálculo se utilizará el
método de float es decir el método de coma flotante.
Elija el tamaño de las variables de tal manera que sea lo suficientemente grande
como para que los resultados sean lo precisos que usted desea. Para las
operaciones que requieran decimales utilice variables tipo float, pero sea
consciente de que las operaciones con este tipo de variables son más lentas a la
hora de realizarse el computo..
10
Nota: Utilice el operador (int) myFloat para convertir un tipo de variable a otro
sobre la marcha. Por ejemplo, i = (int) 3,6 establecerá i igual a 3.
Asignaciones compuestas
Las asignaciones compuestas combinan una operación aritmética con una
variable asignada. Estas son comúnmente utilizadas en los bucles tal como se
describe más adelante. Estas asignaciones compuestas pueden ser:
Nota: Por ejemplo, x * = 3 hace que x se convierta en el triple del antiguo valor x
y por lo tanto x es reasignada al nuevo valor .
Operadores de comparación
Las comparaciones de una variable o constante con otra se utilizan con
frecuencia en las estructuras condicionales del tipo if.. para testear si una
condición es verdadera. En los ejemplos que siguen en las próximas páginas se
verá su utilización práctica usando los siguientes tipo de condicionales:
x == y // x es igual a y
x != y // x no es igual a y
x < y // x es menor que y
x > y // x es mayor que y
x <= y // x es menor o igual que y
x >= y // x es mayor o igual que y
asignaciones compuestas
Operadores lógicos
Los operadores lógicos son usualmente una forma de comparar dos expresiones
y devolver un VERDADERO o FALSO dependiendo del operador. Existen tres
operadores lógicos, AND (&&), OR (||) y NOT (!), que a menudo se utilizan en
estamentos de tipo if..:
Logical AND:
if (x > 0 && x < 5) // cierto sólo si las dos expresiones son ciertas
11
Logical OR:
if (x > 0 || y > 0) // cierto si una cualquiera de las expresiones
es cierta
Logical NOT:
if (!x > 0) // cierto solo si la expresión es falsa
3.6 Constantes
El lenguaje de programación de Arduino tiene unos valores predeterminados,
que son llamados constantes. Se utilizan para hacer los programas más fáciles de
leer. Las constantes se clasifican en grupos.
Cierto/falso (true/false)
Estas son constantes booleanas que definen los niveles HIGH (alto) y LOW (bajo)
cuando estos se refieren al estado de las salidas digitales. FALSE se asocia con 0
(cero), mientras que TRUE se asocia con 1, pero TRUE también puede ser
cualquier otra cosa excepto cero. Por lo tanto, en sentido booleano, -1, 2 y -200
son todos también se define como TRUE, (esto es importante tenerlo en cuanta).
if (b == TRUE);
{
ejecutar las instrucciones;
}
High/Low
Estas constantes definen los niveles de salida altos o bajos y se utilizan para la
lectura o la escritura digital para las patillas. ALTO se define como en la lógica
de nivel 1, ON, ó 5 voltios, mientras que BAJO es lógica nivel 0, OFF, o 0 voltios.
Input/Output
Estas constantes son utilizadas para definir, al comienzo del programa, el modo
de funcionamiento de los pines mediante la instrucción pinMode de tal manera
que el pin puede ser una entrada INPUT o una salida OUTPUT.
12
3.7 Control de flujo
If (si)
if es un estamento que se utiliza para probar si una determinada condición se ha
alcanzado, como por ejemplo averiguar si un valor analógico está por encima de
un cierto número, y ejecutar una serie de declaraciones (operaciones) que se
escriben dentro de llaves, si es verdad. Si es falso (la condición no se cumple) el
programa salta y no ejecuta las operaciones que están dentro de las llaves, El
formato para if es el siguiente:
if (unaVariable ?? valor)
{
ejecutaInstrucciones;
}
En el ejemplo anterior se compara una variable con un valor, el cual puede ser
una variable o constante. Si la comparación, o la condición entre paréntesis se
cumple (es cierta), las declaraciones dentro de los corchetes se ejecutan. Si no es
así, el programa salta sobre ellas y sigue.
Nota: Tenga en cuenta el uso especial del símbolo '=', poner dentro de if (x = 10),
podría parecer que es valido pero sin embargo no lo es ya que esa expresión
asigna el valor 10 a la variable x, por eso dentro de la estructura if se utilizaría
X==10 que en este caso lo que hace el programa es comprobar si el valor de x es
10.. Ambas cosas son distintas por lo tanto dentro de las estructuras if, cuando se
pregunte por un valor se debe poner el signo doble de igual “==”
13
Else puede ir precedido de otra condición de manera que se pueden establecer
varias estructuras condicionales de tipo unas dentro de las otras (anidamiento)
de forma que sean mutuamente excluyentes pudiéndose ejecutar a la vez. Es
incluso posible tener un número ilimitado de estos condicionales. Recuerde sin
embargo qué sólo un conjunto de declaraciones se llevará a cabo dependiendo
de la condición probada:
For
La declaración for se usa para repetir un bloque de sentencias encerradas entre
llaves un número determinado de veces. Cada vez que se ejecutan las
instrucciones del bucle se vuelve a testear la condición. La declaración for tiene
tres partes separadas por (;) vemos el ejemplo de su sintaxis:
14
Si la condición sigue cumpliéndose, las instrucciones del bucle se vuelven a
ejecutar. Cuando la condición no se cumple, el bucle termina.
for (int i=0; i<20; i++) // declara i, prueba que es menor que
20, incrementa i en 1
{
digitalWrite(13, HIGH); // envía un 1 al pin 13
delay(250); // espera ¼ seg.
digitalWrite(13, LOW); // envía un 0 al pin 13
delay(250); // espera ¼ de seg.
}
Nota: El bucle en el lenguaje C es mucho más flexible que otros bucles
encontrados en algunos otros lenguajes de programación, incluyendo BASIC.
Cualquiera de los tres elementos de cabecera puede omitirse, aunque el punto y
coma es obligatorio. También las declaraciones de inicialización, condición y
expresión puede ser cualquier estamento válido en lenguaje C sin relación con
las variables declaradas. Estos tipos de estados son raros pero permiten disponer
soluciones a algunos problemas de programación raras.
While
Un bucle del tipo while es un bucle de ejecución continua mientras se cumpla la
expresión colocada entre paréntesis en la cabecera del bucle. La variable de
prueba tendrá que cambiar para salir del bucle. La situación podrá cambiar a
expensas de una expresión dentro el código del bucle o también por el cambio de
un valor en una entrada de un sensor
15
{
instrucciones; // ejecuta las instrucciones entre llaves
unaVariable++; // incrementa la variable en 1
}
Do… while
El bucle do while funciona de la misma manera que el bucle while, con la
salvedad de que la condición se prueba al final del bucle, por lo que el bucle
siempre se ejecutará al menos una vez.
do
{
Instrucciones;
} while (unaVariable ?? valor);
El siguiente ejemplo asigna el valor leído leeSensor() a la variable 'x', espera 50
milisegundos, y luego continua mientras que el valor de la 'x' sea inferior a 100:
do
{
x = leeSensor();
delay(50);
} while (x < 100);
PinMode(pin, mode)
Esta instrucción es utilizada en la parte de configuración setup () y sirve para
configurar el modo de trabajo de un PIN pudiendo ser INPUT (entrada) u
OUTPUT (salida).
Los terminales de Arduino, por defecto, están configurados como entradas, por
lo tanto no es necesario definirlos en el caso de que vayan a trabajar como
entradas. Los pines configurados como entrada quedan, bajo el punto de vista
eléctrico, como entradas en estado de alta impedancia.
Estos pines tienen a nivel interno una resistencia de 20 KΩ a las que se puede
acceder mediante software. Estas resistencias se accede de la siguiente manera:
16
pinMode(pin, INPUT); // configura el ‘pin’ como entrada
digitalWrite(pin, HIGH); // activa las resistencias internas
Los pins configurado como OUTPUT (salida) se dice que están en un estado de
baja impedancia estado y pueden proporcionar 40 mA (miliamperios) de
corriente a otros dispositivos y circuitos. Esta corriente es suficiente para
alimentar un diodo LED (no olvidando poner una resistencia en serie), pero no
es lo suficiente grande como para alimentar cargas de mayor consumo como
relés, solenoides, o motores.
DigitalRead(pin)
Lee el valor de un pin (definido como digital) dando un resultado HIGH (alto) o
LOW (bajo). El pin se puede especificar ya sea como una variable o una
constante (0-13).
DigitalWrite(pin, value)
Envía al ´pin´ definido previamente como OUTPUT el valor HIGH o LOW
(poniendo en 1 o 0 la salida). El pin se puede especificar ya sea como una
variable o como una constante (0-13).
17
{
pinMode(led, OUTPUT); // configura el led (pin13) como salida
pinMode(boton, INPUT); // configura botón (pin7) como entrada
}
void loop()
{
valor = digitalRead(boton); //lee el estado de la entrada
botón
digitalWrite(led, valor); // envía a la salida ´led´el
valor leído
}
AnalogRead(pin)
Lee el valor de un determinado pin definido como entrada analógica con una
resolución de 10 bits. Esta instrucción sólo funciona en los pines (0-5). El rango
de valor que podemos leer oscila de 0 a 1023.
Nota: Los pins analógicos (0-5) a diferencia de los pines digitales, no necesitan
ser declarados como INPUT u OUPUT ya que son siempre INPUT´s.
AnalogWrite(pin, value)
Esta instrucción sirve para escribir un pseudo-valor analógico utilizando el
procedimiento de modulación por ancho de pulso (PWM) a uno de los pin´s de
Arduino marcados como “pin PWM”. El más reciente Arduino, que implementa
el chip ATmega168, permite habilitar como salidas analógicas tipo PWM los
pines 3, 5, 6, 9, 10 y 11. Los modelos de Arduino más antiguos que implementan
el chip ATmega8, solo tiene habilitadas para esta función los pines 9, 10 y 11. El
valor que se puede enviar a estos pines de salida analógica puede darse en forma
de variable o constante, pero siempre con un margen de 0-255.
18
valores de entre 0 y 255, el pin saca tensiones entre 0 y 5 voltios - el valor HIGH
de salida equivale a 5v (5 voltios). Teniendo en cuenta el concepto de señal PWM
, por ejemplo, un valor de 64 equivaldrá a mantener 0 voltios de tres cuartas
partes del tiempo y 5 voltios a una cuarta parte del tiempo; un valor de 128
equivaldrá a mantener la salida en 0 la mitad del tiempo y 5 voltios la otra mitad
del tiempo, y un valor de 192 equivaldrá a mantener en la salida 0 voltios una
cuarta parte del tiempo y de 5 voltios de tres cuartas partes del tiempo restante.
3.10 Tiempo
Delay(ms)
Detiene la ejecución del programa la cantidad de tiempo en ms que se indica en
la propia instrucción. De tal manera que 1000 equivale a 1seg.
19
Millis()
Devuelve el número de milisegundos transcurrido desde el inicio del programa
en Arduino hasta el momento actual. Normalmente será un valor grande
(dependiendo del tiempo que esté en marcha la aplicación después de cargada o
después de la última vez que se pulsó el botón “reset” de la tarjeta)..
3.11 Matematicas
Min(x, y)
Calcula el mínimo de dos números para cualquier tipo de datos devolviendo el
número más pequeño.
Si 'valor' es menor que 100 valor recogerá su propio valor si ´valor´ es mayor que
100 valor pasara a valer 100.
Max(x, y)
Calcula el máximo de dos números para cualquier tipo de datos devolviendo el
número mayor de los dos.
3.12 Aleatorio
RandomSeed(seed)
Establece un valor, o semilla, como punto de partida para la función random().
20
dentro de la función random, lo que permite generar números aleatorios "al
azar". Hay una variedad de semillas, o funciones, que pueden ser utilizados en
esta función, incluido millis () o incluso analogRead () que permite leer ruido
eléctrico a través de un pin analógico.
Random(max)-Random(min, max)
La función random devuelve un número aleatorio entero de un intervalo de
valores especificado entre los valores min y max.
El siguiente ejemplo genera un valor aleatorio entre 0-255 y lo envía a una salida
analógica PWM :
3.13 Serie
Serial.begin(rate)
Abre el puerto serie y fija la velocidad en baudios para la transmisión de datos
en serie. El valor típico de velocidad para comunicarse con el ordenador es 9600,
aunque otras velocidades pueden ser soportadas.
void setup()
{
21
Serial.begin(9600); // abre el Puerto serie
} // configurando la velocidad en 9600 bps
Nota: Cuando se utiliza la comunicación serie los pins digital 0 (RX) y 1 (TX) no
puede utilizarse al mismo tiempo.
Serial.println(data)
Imprime los datos en el puerto serie, seguido por un retorno de carro automático
y salto de línea. Este comando toma la misma forma que Serial.print (), pero es
más fácil para la lectura de los datos en el Monitor Serie del software.
El siguiente ejemplo toma de una lectura analógica pin0 y envía estos datos al
ordenador cada 1 segundo.
void setup()
{
Serial.begin(9600); // configura el puerto serie a 9600bps
}
void loop()
{
Serial.println(analogRead(0)); // envía valor analógico
delay(1000); // espera 1 segundo
}
22