PDF de programación - Arduino Programming Notebook

Arduino

Programming

Notebook




Escrito y compilado por Brian W. Evans

Traducido al español por JarBot.
































Arduino Programming Notebook
Written and compiled by Brian W. Evans
Traducido al español por JarBot (Noviembre 2009).


Publicado:
Primera Edición Agosto 2007
Segunda Edición Septiembre 2008






Prólogo

Este documento sirve como un fácil y conveniente compañero, para
el principiante que quiere aprender a utilizar y programar el
microcontrolador Arduino. Su objetivo es ser una referencia
secundaria para ser utilizada junto con otros sitios web, libros,
talleres, o clases. Para hacerlo simple, ciertas exclusiones han dado
lugar a un ligero énfasis utilizando el microcontrolador para los
propósitos independiente y, por ejemplo, deja fuera las matrices más
complejas o las formas avanzadas de comunicación en serie. A partir
de la estructura básica de Arduino derivado programación en
lenguaje C, esta referencia sirve para describir los elementos más
comunes e ilustrar su uso con ejemplos y fragmentos de código.. Por
encima de todo, este documento no sería posible sin la gran
comunidad de políticas y de masas de corte de material original que
se encuentra en el Arduino
página web, y un foro en http://www.arduino.cc.
































ESTRUCTURA

structure
setup()
loop()
functions
{} curly braces
; semicolon
/*… */ block comments
// line comments


VARIABLES

variables
variable declaration
variable scope


TIPOS DE DATOS

byte
int
long
float
arrays


ARITMETICA

arithmetic
compound assignments
comparison operators
logical operators


CONSTANTES

constants
true/false
high/low
input/output



if
if… else
for
while
do… while


CONTROL DE FLUJO

ENTRADA/SALIDA DIGITAL

pinMode(pin, mode)
digitalRead(pin)
digitalWrite(pin, value)




ENTRADA/ SALIDA ANALOGICA

analogRead(pin)
analogWrite(pin, value)



TIEMPO

delay(ms)
millis()



min(x, y)
max(x, y)



MATEMATICAS

ALEATORIO

randomSeed(seed)
random(min, max)



SERIAL

Serial.begin(rate)
Serial.println(data)



APENDICE

digital output
digital input
high current output
pwm output
potentiometer input
variable resistor input
servo output

Estructura
La estructura básica del lenguaje de programación de Arduino es bastante simple
y corre en al menos dos partes. Estas dos piezas necesarias, o las funciones, los
bloques para adjuntar las declaraciones.


void setup ()
{
declaraciones;
}

void loop ()
{
declaraciones;
}


En void setup () es la preparación, void loop () es la ejecución. Ambas funciones
son necesarias para el programa de trabajo.
La función de configuración deben seguir la declaración de las variables al
principio del programa. Es la primera función para ejecutar en el programa, se
ejecuta sólo una vez, y se utiliza para establecer pinMode o inicializar la
comunicación serial.
La función de bucle sigue a continuación e incluye el código que se ejecutará de
forma continua - lectura insumos, provocando salidas, etc Esta función es el
núcleo de todos los programas de Arduino.


setup ()
El comando void setup () es llamado una vez al iniciar el programa. Se utiliza
para inicializar los modos de PIN, o empezar de serie. Debe incluirse en un
programa, incluso si no hay declaraciones a correr.


void setup ()
{
pinMode( pin, OUTPUT); // establece el 'pin' como salida
}





loop ()
Después de llamar a void setup() la función void loop () hace precisamente lo que
sugiere su nombre, ejecuta los bucles de forma consecutiva, permitiendo que el
programa responda a los cambios, y el control de la placa Arduino.


void loop ()
{
digitalWrite (pin, HIGH); // se vuelve 'pin' on

delay (1000); // pausa por un segundo
digitalWrite (pin, LOW); // se vuelve 'pin' off

delay (1000); // hace una pausa por un segundo
}



funciones
Una función es un bloque de código que tiene un nombre y un bloque de
instrucciones que se ejecutan cuando se llama a la función. La configuración de
las funciones void setup () y void loop () ya se han discutido y otras funciones
incorporadas se discutirá más adelante.
Las funciones habituales pueden ser escritas para realizar tareas repetitivas y
reducir el desorden en un programa. Las funciones son declaradas primero el tipo
de variable de la función. Este es el tipo de valor a de ser devuelto por la función
como "int" para una función de tipo entero. Si no hay ningún valor se va a devolver
el tipo de función sería nula. Después de tipo, declarar el nombre dado a la función
y entre paréntesis los parámetros que se pasan a la función.


type functionName (parámetros)
{
declaraciones;
}


El siguiente tipo int delayVal function () se utiliza para fijar un valor de retraso en
un programa de lectura del valor de un potenciómetro. En primer lugar, declara
una variable local v, v Establece el valor del potenciómetro que le da un número
entre 0-1023, entonces ese valor se divide por 4 para un valor final entre 0-255, y
finalmente regresa de nuevo a que el valor del programa principal .


int delayVal ()
{
int v; // v Crear variable temporal
v = analogRead (pot); // leer el valor del potenciómetro
v /= 4; // convierte 0-1023 a 0-255
return v; // valor de retorno final
}


{} Llaves
Llaves definen el comienzo y el final de los bloques de función y bloques de
sentencias, como el void loop () y {} para las declaraciones.


type function ()
{
declaraciones;
}


Una llave de apertura (siempre debe ser seguido por una llave de cierre). Esto se
refiere a menudo como las llaves de ser equilibrado. Llaves no balanceado puede
conducir a menudo crípticos, los errores del compilador impenetrable, que a veces
puede ser difícil de rastrear en un programa de gran tamaño.
El medio ambiente Arduino incluye una práctica función para comprobar el saldo
de llaves. Sólo tiene que seleccionar un par, o incluso, haga clic en el punto de
inserción inmediatamente después de un par, y su compañero lógica será
resaltada.

; Punto y coma
Un punto y coma se utiliza para poner fin a una declaración y los distintos
elementos del programa. Un punto y coma se utiliza también para los distintos
elementos en un bucle for.


int x = 13 ; // declara la variable 'x' como el entero 13


Nota: El olvido de poner fin a una línea en un punto y coma dará lugar a un error
del compilador. El texto de error puede ser obvia, y se refieren a un punto y coma
que falta, o puede que no. Si un error del compilador impenetrable o
aparentemente lógicos surge, una de las primeras cosas que hay que comprobar
es un punto y coma que falta, cerca de la línea donde el compilador se quejó.


/ *... * / Comentarios en bloque
Los comentarios de bloque son de varios comentarios en línea, son áreas de
texto ignorados por el programa y se utilizan para las descripciones de texto
grandes de código o comentarios que ayuden a entender otras partes del
programa. Ellos empiezan con / * y terminan con * /, y puede abarcar varias líneas.

/ * Este es un bloque cerrado comentario no olvide el comentario de cierre -
que tienen que ser equilibradas!
* /

Dado que los comentarios son ignorados por el programa y no tienen espacio en
la memoria que se debe utilizar con generosidad y también se puede utilizar para
"comentar" bloques de código para propósitos de depuración.
Nota: Si bien es posible incluir comentarios en línea único dentro de un bloque de
comentario, adjuntando un comentario segundo bloque no está permitido.



// Comentarios en línea
Comentarios de una sola línea en empezar con // y terminar con la siguiente línea
de código. Como comentarios en bloque, son ignorados por el programa y no
tienen espacio en la memoria.
// Esto es un comentario de una sola línea

Comentarios de línea individual se utilizan a menudo después de una declaración
válida para proporcionar más información acerca de lo que lleva a cabo la
declaración o para proporcionar un recordatorio en el futuro.


variables
Una variable es una manera de nombrar y guardar un valor para su uso posterior
por el programa. Como su nombre lo indica, las variables son valores que puede
ser cambiado continuamente frente a las constantes cuyo valor no cambia nunca.
Una variable debe ser declarado y, opcionalmente, el valor asignado a la
necesidad de ser almacenado. El siguiente código declara una variable llamada
inputVariable y luego le asigna el valor obtenido en la clavija de entrada analógica
2:


int inputVariable = 0; // declara una variable y
// Asigna el valor 0
inputVariable = analogRead (2); // conjunto de variables y el valor de
// Pin analógico 2


'InputVariable' es la variable. La primera línea declara que contenga un int,
abreviatura de número entero. La segunda línea establece la variable con el valor
en la terminal analógico 2. Esto hace que el valor de los pines 2 accesibles en
otras partes del código.
Una vez que una variable se le ha asignado, o re-asignado, usted puede probar su
valor a ver si cumple con ciertas condiciones, o usted puede utilizar su valor
directamente. Como ejemplo para ilustrar tres operaciones útiles con las variables,
el siguiente código comprueba si el inputVariable es inferior a 100, si es cierto que

asigna el valor 100 a inputVariable y, a continuación establece un retraso sobre la