manual-arduino2
manual-arduino2
ARDUINO
La “inteligencia de Arduino” se expresa mediante su lenguaje de programación
Revisado y adaptado:
Sergio Treviño Gonzalvo
DATOS DEL DOCUMENTO ORIGINAL
Published:
First Edition August 2007
http://creativecommons.org/licenses/by-nc-/
Creative Commons
171 Second Street, Suite 300
San Francisco, California, 94105, USA
ÍNDICE DE CONTENIDOS pestañas librerias
Introducción
control de flujo
el hardware de la placa arduino
if
alimentación
if… else
entradas y salidas
for
comunicaciones
switch/case
programación
while
el entorno de desarrollo para arduino
do… while
estructura break
estructura
continue
setup()
return
loop()
funciones E/S digitales
pinMode(pin, mode)
{} uso de llaves
digitalRead(pin)
; punto y coma
digitalWrite(pin, value)
/*… */ bloque de comentarios
E/S analógicas
// linea de comentario
analogRead(pin)
variables analogWrite(pin, value)
variables
E/S avanzadas
declaración de variables
tone
variable scope
noTone
tipos de datos pulseIn
booleanos
tiempo
char
delay(ms)
byte
delayMicroseconds
int
millis
unsigned int
micros
long
matemáticas
unsigned long min(x, y)
float max(x, y)
double abs
arrays map
string pow
aritmética sq
aritmética
sqrt
composición de asignaciones
sin
operadores de comparación
cos
operadores lógicos
tan
constantes
constantes
cierto/falso
alto/bajo
entrada/salida
aleatorio
randomSeed(seed)
random(min, max)
puerto serie
Serial.begin(rate)
Serial.end
Serial.println(data)
Serial.print(data, data type)
Serial.available
Serial.read
Serial.flush
Serial.write
FORMAS DE CONEXIONADO DE
ENTRADAS Y SALIDAS
salida digital
entrada digital
salida de alto consumo (corriente)
salida analógica (pwm)
potenciómetro de entrada
Resistencia variable de entrada
Salida a servo
INTRODUCCIÓN
Alimentación
Las placas pueden ser alimentadas por medio de la conexión USB o con una fuente
de alimentación externa de entre 6 a 20 V, aunque el rango recomendado es de 7 a
12 V.
Las fuentes de alimentación externas (no-USB) pueden ser tanto un transformador
como una batería. El transformador se puede conectar usando un conector macho
de 2.1 mm con centro positivo en el conector hembra de la placa. Los cables de la
batería pueden conectarse a los pines Gnd y Vin en los conectores de alimentación
(POWER)
Entradas y Salidas
Cada uno de los 14 pines digitales (de 0 a 13) pueden utilizarse como entradas o
como salidas usando las funciones pinMode(), digitalWrite() y digitalRead(). Las E/S
operan a 5 V. Cada pin puede proporcionar o recibir una intensidad máxima de 40
mA.
Los pines 3, 5, 6, 9, 10, y 11 proporcionan una salida PWM (modulación por anchura
de pulsos) de 8 bits de resolución (valores de 0 a 255) mediante la función
analogWrite().
El pin digital 13 lleva conectado un LED integrado en la propia placa. Se encenderá
cuando dicho pin se configura como salida y adopte un valor HIGH.; con valor LOW
se apaga.
La placa tiene 6 entradas analógicas, y cada una de ellas proporciona una resolución
de 10 bits (1024 valores).
Comunicaciones
La placa Arduino proporciona comunicación vía serie a través de los pines digitales
0 (RX) y 1 (TX). Un chip integrado en la placa canaliza esta comunicación serie a
través del puerto USB. El software de Arduino incluye un monitor de puerto serie
que permite enviar y recibir información textual hacia y desde la placa Arduino. Los
leds RX y TX de la placa parpadearán cuando se detecte comunicación transmitida a
través de la conexión USB.
SERGIO TREVIÑO 5 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
Programación
SERGIO TREVIÑO 6 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
Editar
• Deshacer
Deshacer: permite volver atrás si se ha modificado algo.
• Rehacer
Rehacer una acción.
• Cortar
Corta y almacena el texto seleccionado en el portapapeles para pegarlo en
otro lugar.
• Copiar
Copia y almacena el texto seleccionado en el portapapeles para pegarlo en
otro lugar.
• Pegar
Pega el texto que se encuentra en el portapapeles en el lugar seleccionado.
• Seleccionar todo
Selecciona todo el código.
• Buscar…
Busca una palabra en el código.
Herramientas
• Formato automático
Da formato al código proporcionando estética: por ejemplo realiza
tabulaciones entre la apertura y cierre de llaves, y las sentencias que tengan
que ser tabuladas lo serán.
• Monitor Serial
Abre el monitor serie donse se visualizan los datos del puerto serie o se
envían datos al mismo. Para enviar datos a la placa, teclee el texto y pulse
el botón "send" o enter. Seleccione la velocidad (baud rate) en el menú
desplegable que coincida con el configurado en Serial.begin dentro de su
"sketch".
• Tarjeta
Selecciona la placa que estás usando (Arduino Uno o Arduino Duemilanove w/
ATmega328).
• Puerto Serial
Este menú contiene todos los dispositivos serie (reales o virtuales) de su
equipo. Se refrescará automáticamente cada vez que abra el menú
Herramientas. Antes de subir nuestro sketch a la placa hay que seleccionar
el elemento de este menú que representa a nuestra placa Arduino
(normalmente COM3 o COM4).
SERGIO TREVIÑO 7 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
ESTRUCTURA
estructura de un programa.
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
}
SERGIO TREVIÑO 8 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
loop()
funciones
SERGIO TREVIÑO 9 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
{} entre llaves
; punto y coma
SERGIO TREVIÑO 10 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
// línea de comentarios
VARIABLES
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:
int variableEntrada = 0; // declara una variable y le asigna el
valor 0
variableEntrada = analogRead(2); // la variable recoge el valor
analógico del PIN2
variableEntrada es la variable en sí. La primera línea declara que será de tipo
entero int. La segunda línea fija a la variable el valor correspondiente a la entrada
analógica PIN2. Esto hace que el valor de PIN2 sea accesible en otras partes del
código.
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 entradaVariable y, a continuación, establece un
retardo (delay) utilizando como valor entradaVariable que ahora será como mínimo
de valor 100:
if (entradaVariable < 100) // pregunta si la variable es
menor de 100
{
entradaVariable = 100; // si es cierto asigna el valor 100 a
esta
};
delay(entradaVariable); // usa el valor como retardo
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.
SERGIO TREVIÑO 11 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
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.
El siguiente ejemplo declara la variable entradaVariable como una variable de tipo
entero int, y asignándole un valor inicial igual a cero. Esto se llama una asignación.
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.
Una variable puede ser declarada al inicio del programa antes de la parte de
configuración 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 función del lugar de
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.
El siguiente ejemplo muestra cómo declarar a unos tipos diferentes de variables y
la visibilidad de cada variable:
int value; // 'value' es visible para cualquier
función
void setup()
{
// no es necesario configurar
}
void loop()
{
for (int i=0; i<20;) // 'i' solo es visible
{ // dentro del bucle for
i++;
}
float f; // 'f' es visible solo
} // dentro del bucle
SERGIO TREVIÑO 12 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
TIPOS DE DATOS
booleanos
Un booleano sólo puede tomar dos valores, Verdadero o Falso. Cada booleano ocupa
un único byte en la memoria.
int LEDpin = 5; // LED en el pin 5
int switchPin = 13; // pulsador en el pin 13, su otra
patilla conectada en GND
boolean running = false; // crea la variable booleana running y
le asigna el valor Falso.
void setup()
{
pinMode(LEDpin, OUTPUT);
pinMode(switchPin, INPUT);
digitalWrite(switchPin, HIGH); // conecta la resistencia pull-up
interna
del pin 13
}
void loop()
{
if (digitalRead(switchPin) == LOW)
{ // si el pulsador es accionado la pull-
up mantiene el pin en estado HIGH
delay(100); // retardo para impedir un rebote en
el pulsador
running = !running; // invierte el valor de la variable
running
digitalWrite(LEDpin, running); // enciende el LED
}
}
Char
SERGIO TREVIÑO 13 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
byte
Byte almacena un valor numérico de 8 bits sin decimales. Tienen un rango entre 0 y
255
byte unaVariable = 180; // declara 'unaVariable' como tipo
byte
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.
int unaVariable = 1500; // declara 'unaVariable' como una
variablede tipo entero
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)
unsigned int
Los enteros sin firma (unsigned int) son los mismos enteros de modo que almacenan
un valor de dos bytes. En lugar de almacenar números negativos, sólo almacenan
valores positivos, generando un rango útil desde 0 a 65,535 (2^16 - 1).
La diferencia entre los enteros sin firma y los enteros (firmados), reside en que el
bit más alto, a veces referenciado como el bit "firmado", es interpretado. En el tipo
de dato int de Arduino (que es firmado), si el bit más alto es "1", el número es
interpretado como un número negtivo, y los otros 15 bits son interpretados con
complemento a 2.
unsigned int ledPin = 13;
unsigned int var = val;
var - el nombre de tu variable unsigned int
val - el valor que asignas a a esa variable
Cuando las variables sobrepasan su capacidad máxima dan la vuelta a su mínima
capacidad. Ten en cuenta que esto sucede en ambas direcciones.
unsigned int x
x = 0;
x = x - 1; // x ahora contiene 65535 - da la
vuelta en dirección negativa.
x = x + 1; // x ahora contiene 0 - da la vuelta.
long
SERGIO TREVIÑO 14 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
unsigned long
Las variable long sin firmar (unsigned long) son variables extendidas para almacenar
números, y almacenar 32 bits (4 bytes). Por el contrario que las variables long
estándar, las unsigned long no almacenan números negativos, haciendo que su
rango sea de 0 a 4,294,967,295 (2^32 - 1).
unsigned long tiempo;
void setup()
{
Serial.begin(9600);
}
void loop()
{
Serial.print("Tiempo: ");
tiempo = millis();
Serial.println(tiempo); //imprime el tiempo desde el inicio
del programa
delay(1000); // espera un segundo para no enviar
cantidad de masivas de datos
}
unsigned long var = val;
var - el nombre de tu variable long
val - el valor que asignas a tu variable long
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.
float unaVariable = 3.14; // declara 'unaVariable'
como tipo flotante
Nota: Los números de punto flotante no son exactos, y pueden producir resultados
extraños en las comparaciones. Los cálculos matemáticos de punto flotante son
también mucho más lentos que los del tipo de números enteros, por lo que debe
evitarse su uso si es posible.
double
SERGIO TREVIÑO 15 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
arrays
SERGIO TREVIÑO 16 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
string
Los strings se representan como arrays de caracteres (tipo char) que terminan con
el caracter NULL.
Todas las siguientes son declaraciones válidas de strings.
char Str1[15];
char Str2[8] = {'a', 'r', 'd', 'u', 'i', 'n', 'o'};
char Str3[8] = {'a', 'r', 'd', 'u', 'i', 'n', 'o', '\0'};
char Str4[ ] = "arduino";
char Str5[8] = "arduino";
char Str6[15] = "arduino";
Declaración de strings:
Declarar un array de caracteres sin incializarlo como en Str1
Declarar un array de caracteres (con un carácter extra) y el compilador añadirá el
carácter NULL requerido,como en STR2
Explicitar el caracter NULL, Str3
Inicializar con un string constante entre comillas dobles; el compilador medirá el
tamaño del array para ajustar el string constante y caracter NULL para finalizar,
Str4
Inicializar el array con un tamaño explícito y un string constante, Str5
Inicializar el array, dejando un espacio extra para un string más largo, Str6
Terminación NULL
Generalmente, los strings se finalizan con un carácter NULL (código ASCII 0). Esto
permite a funciones (como Serial.print()) establecer dónde está el final del string. De
otra forma, seguiría leyendo los siguientes bytes de la memoria que no forman
parte del string.
Esto significa que tu string necesita tener espacio para un carácter más del texto
que quieres que contenga. Esto es por lo que Str2 y Str5 necesitan 8 caracteres,
incluso aunque "arduino" tenga sólo 7 - la última posición es automáticamente
completada con un caracter NULL. Str4 será automáticamente dimensionada a 8
caracteres, uno para el NULL extra.
En Str3, hemos incluido nosotros mismos el caracter NULL (escrito como '\0').
Ten en cuenta que es posible tener un string sin un carácter NULL al final (p.e. si tú
has especificado la longitud de Str2 como 7 en lugar de 8). Esto romperá la mayoría
de funciones que usen strings, por lo que no deberías hacerlo intencionadamente.
Por lo tanto, si detectas algún comportamiento extraño (operando con los
caracteres, no con el string), este podría se el problema.
Comillas simples o dobles
Los string siempre se definen entre comillas dobles ("Abc") y los caracteres siempre
se definen dentro de comillas
simples ('A').
SERGIO TREVIÑO 17 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 18 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
ARITMÉTICA
aritmética
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:
x++ // incremento de x en 1 y devuelve
el valor antiguo de x
++x // incremento de x en 1 y devuelve
el nuevo valor de x
x– – // decremento de x en 1 y devuelve
el valor antiguo de x
– –x // decremento de x en 1 y devuelve
el nuevo valor de x
x += y // igual que x = x + y, o incrementa
x en +y
x -= y // igual que x = x - y, o
decrementar x en -y
x *= y // igual que x = x * y, o
multiplicar x por y
x /= y // igual que x = x / y, o dividir
x por y
SERGIO TREVIÑO 19 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
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
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
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
CONSTANTES
constantes
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 todos se
definen como TRUE. ( esto es importante tenerlo en cuenta)
if (b == TRUE);
{
ejecutar las instrucciones;
}
SERGIO TREVIÑO 20 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
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.
digitalWrite(13, HIGH); // activa la salida 13 con un nivel
alto (5v.)
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.
pinMode(13, OUTPUT); // designamos que el PIN 13 es una
salida
PESTAÑAS LIBRERIAS
Con objeto de ordenar nuestro código podemos crear nuevas pestañas que deben
ser llamadas desde la pestaña principal para poder hacer uso del código allí alojado.
#include “pestaña” //incluye la pestaña “pestaña”
Nota: include debe utilizarse antes de setup. Include se utiliza para incluir librerías.
#include <LiquidCrystal.h> //incluye la librería
liquidCrystal.h
CONTROL DE FLUJO
if (si)
SERGIO TREVIÑO 21 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
if… else viene a ser un estructura que se ejecuta en respuesta a la idea “si esto no
se cumple haz esto otro”. Por ejemplo, si se desea probar una entrada digital, y
hacer una cosa si la entrada fue alto o hacer otra cosa si la entrada es baja, usted
escribiría que de esta manera:
if (inputPin == HIGH) // si el valor de la entrada inputPin
es alto
{
instruccionesA; //ejecuta si se cumple la condición
}
else
{
instruccionesB; //ejecuta si no se cumple la
condición
};
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:
if (inputPin < 500)
{
instruccionesA; // ejecuta las operaciones A
}
else if (inputPin >= 1000)
{
instruccionesB; // ejecuta las operacione B
}
else
{
instruccionesC; // ejecuta las operaciones C
};
Nota: Un estamento de tipo if prueba simplemente si la condición dentro del
paréntesis es verdadera o falsa. Esta declaración puede ser cualquier declaración
válida. En el anterior ejemplo, si cambiamos y ponemos (inputPin == HIGH). En este
caso, el estamento if sólo chequearía si la entrada especificado esta en nivel alto
(HIGH), o +5v.
SERGIO TREVIÑO 22 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
for
switch / case
Como las sentencias if, switch...case controla el flujo de programas permitiendo a
los programadores especificar diferentes códigos que deberían ser ejecutados en
función de varias condiciones. En particular, una sentencia switch compara el valor
de una variable con el valor especificado en las sentencias case. Cuando se
encuentra una sentencia case cuyo valor coincide con dicha variable, el código de
esa sentencia se ejecuta.
La palabra clave break sale de la sentencia switch, y es usada típicamente al final
de cada case. Si una sentencia break, la sentencia switch continuaría ejecutando las
siguientes expresiones ("falling-through") hasta encontrar un break, o hasta llegar al
final de la sentencia switch.
SERGIO TREVIÑO 23 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
switch (var)
{
case 1: //hacer algo cuando sea igual a 1
break;
case 2: //hacer algo cuando sea igual a 2
break;
default: // si nada coincide, ejecuta el
"default"
// el "default" es opcional
}
switch (var)
{
case etiqueta: // sentencias
break;
case etiqueta: // sentencias
break;
default: // sentencias
}
while
SERGIO TREVIÑO 24 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
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);
break
break es usado para salir de los bucles do, for, o while, pasando por alto la
condición normal del bucle. Es usado también para salir de una estructura de control
switch.
for (x = 0; x < 255; x ++)
{
digitalWrite(PWMpin, x);
sens = analogRead(sensorPin);
if (sens > threshold)
{
x = 0;
break; // sale del bucle for.
}
delay(50);
}
SERGIO TREVIÑO 25 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
Continue
Return
SERGIO TREVIÑO 26 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
La palabra clave return es útil para depurar una sección de código sin tener que
comentar una gran cantidad de líneasde código posiblemente incorrecto.
void loop()
{ // código magnífico a comprobar aquí
return; // el resto del programa del que se
desconfía que nunca será ejecutado
por estar detrás de return
}
E/S DIGITALES
pinMode(pin,mode)
SERGIO TREVIÑO 27 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
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).
valor = digitalRead(Pin); // hace que 'valor sea igual al
estado leído en ´Pin´
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).
digitalWrite(pin, HIGH) ; // deposita en el 'pin' un valor HIGH
(alto o 1)
El siguiente ejemplo lee el estado de un pulsador conectado a una entrada digital y
lo escribe en el ´pin´de salida LED:
int led = 13; // asigna a LED el valor 13
int boton = 7; // asigna a botón el valor 7
int valor = 0; // define el valor y le asigna el
valor 0
void setup()
{
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
}
SERGIO TREVIÑO 28 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
E/S ANALÓGICAS
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.
valor = analogRead(pin); // asigna a valor lo que lee en la
entrada ´pin'
Nota: Los pines 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)
SERGIO TREVIÑO 29 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 30 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
E/S AVANZADAS
tone
Genera una onda cuadrada de la frecuencia especificada (y un 50% de ciclo de
trabajo, como una salida pwm analogWrite127) en un pin. La duración puede ser
especificada, en caso contrario la onda continua hasta que haya una llamada a
noTone. El pin puede conectarse a un zumbador piezoeléctrico u otro altavoz que
haga sonar los tonos.
Sólo puede generarse un tono cada vez. Si un tono está sonando en un pin
diferente, la llamada a tone no tendrá efecto. Si el tono está sonando en el mismo
pin, la llamada establecerá la nueva frecuencia.
El uso de la función tone interferirá con la salida PWM en los ins 3 y 11 (en otras
placas distintas de la Mega).
Nota: si quieres hacer sonar diferentes tonos en múltiples pins necesitas llamar a
noTone en un pin antes de llamar a tone en el siguiente pin.
tone(pin, frecuencia)
tone(pin, frecuencia, duracion)
pin: el pin en el que generar el tono.
frecuencia: la frecuencia del tono en hercios.
duración: la duración del tono en milisegundos (opcional)
Nota: las frecuencias audibles por el oído humano van de los 20Hz a los 20KHz por
lo que el parámetro "frecuencia" debería estar comprendido entre estos dos
valores.
SERGIO TREVIÑO 31 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
noTone
pulseIn
Lee un pulso (ya sea HIGH —alto— o LOW —bajo—) en un pin. Por ejemplo, si value
es HIGH, pulseIn espera a que el pin sea HIGH, empieza a cronometrar, espera a que
el pin sea LOW y entonces detiene la medida de tiempo.
Devuelve la anchura del pulso en microsegundos. Interrumpe la medida y devuelve
0 si el pulso no ha comenzado en un tiempo especificado.
La medida del tiempo en esta función ha sido determinada de forma empírica y está
sujeta a errores en pulsos largos.
Funciona correctamente en pulsos con una anchura de 10 microsegundos a tres
minutos.
pulseIn(pin, value)
pulseIn(pin, value, timeout)
pin: el número del pin en el que se realiza la medida del pulso. (int)
value: tipo de pulso. Puede ser HIGH o LOW. (int)
timeout (opcional): el tiempo en microsegundos máximo a esperar antes de que se
inicie el pulso. (unsigned long)
Devuelve el ancho del pulso (en microsegundos) ó 0 si el pulso no ha empezado
antes del timeout (unsigned long)
int pin = 7;
unsigned long duracion;
void setup()
{
pinMode(pin, INPUT);
}
void loop()
{
duracion = pulseIn(pin, HIGH);
}
SERGIO TREVIÑO 32 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
TIEMPO
delay()
delayMicroseconds()
millis()
Micros()
Devuelve el número de microsegundos 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).
valor = micros(); // valor recoge el número de
microsegundos
Nota: Este número se desbordará (si no se resetea de nuevo a cero), después de
aproximadamente 7 horas.
SERGIO TREVIÑO 33 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
MATEMÁTICAS
min()
max()
abs(x)
Calcula el valor absoluto de un número.
x: El numero cuyo valor absoluto deseamos calcular
Devuelve
x: si x is mayor o igual que 0.
-x: si x es menor que 0.
Precaución
Debido a la forma en la que se ha implementado la función abs(), evite usar otras
funciones como parámetro debido aque puede ocasionar que se devuelva un
resultado incorrecto.
abs(a++); // evite esto - produce errores en el
resultado
a++; // hazlo de esta manera -
abs(a); // mantenga cualquier otra operación
fuera de la función
constrain(x, a, b)
Restringe un número a un rango definido.
x: el número a restringir, cualquier tipo de datos.
a: El número menor del rango, cualquier tipo de datos.
b: El número mayor del rango, cualquier tipo de datos.
Devuelve
x: si x está entre a y b
a: si x es menor que a
b: si x es mayor que b
sensVal = constrain(sensVal, 10, 150); // limita el valor del sensor entre 10
y 150
SERGIO TREVIÑO 34 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
pow(base, exponente)
Calcula el valor de un número elevado a otro número. Pow() puede ser usado para
elevar un número a una fracción.
Esta función es útil para generar datos exponenciales o curvas.
base: base que queremos elevar (float) (Coma flotante)
exponente: la potencia a la que se quiere elevar la base (float) (Coma flotante)
Devuelve
El resultado de la exponenciación (double)(Doble).
SERGIO TREVIÑO 35 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
sq(x)
sqrt(x)
Trigonometría
sin(rad)
cos(rad)
tan(rad)
SERGIO TREVIÑO 36 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
ALEATORIO
randomSeed(seed)
random(max)
random(min,max)
SERGIO TREVIÑO 37 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
PUERTO SERIE
Serial.begin(rate)
Serial.end
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.
Serial.println(analogValue); // envía el valor 'analogValue' al
puerto
Nota: Para obtener más información sobre las distintas posibilidades de Serial.println
() y Serial.print () puede consultarse el sitio web de Arduino.
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
}
Serial.println(data)
SERGIO TREVIÑO 39 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
Serial.print(b, BIN)
Vuelca o envía el valor de b como un número binario en caracteres ASCII.
Equivaldría a printBinary();
int b = 79;
Serial.print(b, BIN); // prints the string "1001111".
Serial.print(b, BYTE)
Vuelca o envía el valor de b como un byte.
Equivaldría a printByte();
int b = 79;
Serial.print(b, BYTE); // Devuelve el caracter "O", el cual
representa el caracter ASCII del
valor 79. (Ver tabla ASCII ).
Serial.print(str)
Vuelca o envía la cadena de caracteres como una cadena ASCII.
Equivaldría a printString().
Serial.print("Hello World!"); // vuelca "Hello World!".
Serial.avaible()
int Serial.available()
Obtiene un número entero con el número de bytes (caracteres) disponibles para
leer o capturar desde el puerto serie.
Equivaldría a la función SerialAvailable().
Devuelve Un entero con el número de bytes disponibles para leer desde el buffer
serie, o 0 si no hay ninguno. Si hay algún dato disponible, SerialAvailable() será
mayor que 0.
El buffer serie puede almacenar como máximo 64 bytes.
int incomingByte = 0; // almacena el dato serie
void setup()
{
Serial.begin(9600); // abre el puerto serie, y le asigna la
velocidad de 9600 bps
}
void loop()
{
if (Serial.available() > 0) // envía datos sólo si los recibe:
{
incomingByte = Serial.read(); // lee el byte de entrada:
Serial.print("I received: "); //lo vuelca a pantalla
Serial.println(incomingByte, DEC);
}
}
SERGIO TREVIÑO 40 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
Serial.read()
int Serial.read()
Lee o captura un byte (un carácter) desde el puerto serie.
Equivaldría a la función SerialRead().
Devuelve : El siguiente byte (carácter) desde el puerto serie, o -1 si no hay ninguno.
int incomingByte = 0; // almacenar el dato serie
void setup()
{
Serial.begin(9600); // abre el puerto serie, y le asigna la
velocidad de 9600 bps
}
void loop()
{
if (Serial.available() > 0) // envía datos sólo si los recibe:
{
incomingByte = Serial.read(); // lee el byte de entrada:
Serial.print("I received: "); //lo vuelca a pantalla
Serial.println(incomingByte, DEC);
}
}
Para strings Serial.readString()
Serial.flush
Vacía el búfer de entrada de datos en serie. Es decir, cualquier llamada a
Serial.read () o Serial.available () devolverásólo los datos recibidos después la
llamada más reciente a Serial.flush ().
Serial.flush()
Serial.write()
Escribe datos binarios en el puerto serie, estos datos se envían como un byte o una
serie de bytes; para enviar los caracteres que representan los dígitos de un
número usar función print () en su lugar.
Envía un solo valor si queremos texto hay que ponerlo entre comillas.
Serial.write(val)
Serial.write(str)
Serial.write(buf, len)
SERGIO TREVIÑO 41 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 42 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
ENTRADA DIGITAL
Ésta es la forma más sencilla de entrada con sólo dos posibles estados: encendido o
apagado. En este ejemplo se lee un simple switch o pulsador conectado a PIN13.
Cuando el interruptor está cerrado el pin de entrada se lee ALTO y encenderá un
LED colocado en el PIN2.
int ledPin = 2; // pin 13 asignado para el LED de
salida
int inPin = 13; // pin 2 asignado para el pulsador
void setup() // Configura entradas y salidas
{
pinMode(ledPin, OUTPUT); // declara LED como salida
pinMode(inPin, INPUT); // declara pulsador como entrada
}
void loop()
{
if (digitalRead(inPin) == HIGH) // testea si la entrada esta activa
HIGH
{
digitalWrite(ledPin, HIGH); // enciende el LED
delay(1000); // espera 1 segundo
digitalWrite(ledPin, LOW); // apaga el LED
}
}
SERGIO TREVIÑO 43 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 44 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 45 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 46 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 47 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
+5v
Los servos de los juguetes tienen un tipo de motor que se puede mover en un arco
de 180 º y contienen la electrónica necesaria para ello. Todo lo que se necesita es
un pulso enviado cada 20ms. Este ejemplo utiliza la función servoPulse para mover
el servo de 10º a 170 º.
int servoPin = 2; // servo conectado al pin digital 2
int myAngle; // ángulo del servo de 0-180
int pulseWidth; // anchura del pulso para la función
servoPulse
void setup()
{
pinMode(servoPin, OUTPUT); // configura pin 2 como salida
}
void servoPulse(int servoPin, int myAngle)
{
pulseWidth = (myAngle * 10) + 600; // determina retardo
digitalWrite(servoPin, HIGH); // activa el servo
delayMicroseconds(pulseWidth); // pausa
digitalWrite(servoPin, LOW); // desactiva el servo
delay(20); // retardo de refresco
}
SERGIO TREVIÑO 48 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
void loop()
{
for (myAngle=10; myAngle<=170; myAngle++) // el servo inicia su
recorrido en 10º y gira hasta 170º
{
servoPulse(servoPin, myAngle);
}
for (myAngle=170; myAngle>=10; myAngle--) // el servo vuelve
desde 170º hasta 10º
{
servoPulse(servoPin, myAngle);
}
}
SERGIO TREVIÑO 49 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
VARIABLES DE DESIGNACION DE
CONSTANTES
PUERTOS Y CONSTANTES
HIGH DDRB
LOW PINB
INPUT PORTB
OUTPUT PB0
SERIAL PB1
DISPLAY PB2
PI PB3
HALF_PI PB4
TWO_PI PB5
LSBFIRST PB6
MSBFIRST PB7
CHANGE DDRC
FALLING PINC
RISING PORTC
false PC0
true PC1
null PC2
private
protected
public
return
short
signed
static
switch
throw
try
unsigned
void
SERGIO TREVIÑO 50 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
OTRAS null
abs ()
acos PI
+= return
+ >>
[] ;
asin Serial
= Setup
atan sin
atan2 sq
& sqrt
| -=
boolean switch
byte tan
case this
ceil true
char TWO_PI
char void
class while
, Serial
// begin
?: read
constrain print
cos write
{} println
-- available
default digitalWrite
delay digitalRead
loop pinMode
max analogRead
millis analogWrite
min attachInterrupts
- detachInterrupts
% PC3
/* PC4
* PC5
new PC6
SERGIO TREVIÑO 51 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
PC7
DDRD
PIND
PORTD
PD0
PD1
PD2
PD3
PD4
PD5
PD6
PD7
SERGIO TREVIÑO 52 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 53 de 54
ARDUINO: MANUAL DE PROGRAMACIÓN
SERGIO TREVIÑO 54 de 54