Funciones y librerías en Arduino

A medida que vuestros programas crecen, os habréis dado cuenta de un problema: el loop() empieza a hacerse eterno.

Tenéis cientos de líneas de código, if dentro de if, bucles for… y cuando queréis cambiar algo, tenéis que buscar entre un mar de llaves y punto y comas 😱.

Además, también os habrá pasado esto: queréis hacer parpadear un LED en tres momentos distintos del programa, y habéis tenido que copiar y pegar el mismo bloque de código tres veces.

Para solucionar esto existen las funciones. Hoy vamos a aprender a empaquetar nuestro código en bloques reutilizables.

¿Qué es una función?

En Arduino, una función es un trozo de código que hace una tarea específica, le ponemos un nombre, y podemos llamarlo desde cualquier parte del programa.

De hecho, ¡ya habéis usado funciones!

• setup() y loop() son funciones.
• digitalWrite() y delay() son funcoines.

Estas son funcinoes que alguien escribió para vosotros. Ahora vamos a aprender a escribir las nuestras.

Creando tu primera función

La estructura básica para definir una fucnión es:

tipoDevuelto nombreFuncion(parametros) {
   // El código de la receta
}

Veámoslo mejor con un ejemplo sencillo, una función simple llamada parpadearTresVeces().

void setup() {
  pinMode(13, OUTPUT);
}

void loop() {
  // En lugar de escribir todo el código aquí, solo llamamos a la función
  parpadearTresVeces(); 
  
  delay(2000); // Esperamos un poco
  
  parpadearTresVeces(); // ¡Podemos reusarla las veces que queramos!
}

// --- ZONA DE TUS FUNCIONES ---
// (Normalmente se escriben después del loop)

void parpadearTresVeces() {
  for(int i=0; i<3; i++) {
    digitalWrite(13, HIGH);
    delay(200);
    digitalWrite(13, LOW);
    delay(200);
  }
}

Funciones con parámetros

La función anterior está bien, pero es un poco rígida. Siempre parpadea 3 veces. ¿Y si quiero que parpadee 5? ¿O 10?

Podemos pasarle información a la función a través de los paréntesis. Esto se llaman Parámetros de la función.

Vamos a mejorar nuestra función:

void parpadear(int numeroVeces) {
  for(int i=0; i < numeroVeces; i++) {
    digitalWrite(13, HIGH);
    delay(200);
    digitalWrite(13, LOW);
    delay(200);
  }
}

Ahora, cuando la llamemos desde el loop, tenemos que darle el dato:

void loop() {
  parpadear(5);  // Parpadea 5 veces
  delay(1000);
  parpadear(2);  // Parpadea 2 veces
}

Las librerías: Usando el código de otros

Una librería no es más que un conjunto de funciones que podemos añadir a nuestro proyecto para no tener que reinventar la rueda.

Gente muy lista y ha dedicado su tiempo ha escribir cientos de funciones súper útiles para controlar motores, pantallas, sensores complejos o conectarse a Internet.

Además ese “alguien” ha empaquetado todas esas funciones en un archivo y lo ha compartido gratis. Eso es una Librería.

Cómo se usan

Para usar una librería, primero tenemos que avisar a nuestro programa de que la queremos incluir. Esto se hace con el comando #include.

Por ejemplo, para controlar un Servomotor (un motor que podemos mover a un ángulo exacto), usaríamos la librería Servo.h que ya viene instalada en Arduino.

#include <Servo.h> // Incluimos la "caja de herramientas" del Servo

Servo miMotor; // Creamos nuestro objeto motor

void setup() {
  miMotor.attach(9); // Le decimos que el motor está en el pin 9
}

void loop() {
  // ¡Mirad qué fácil! No tenemos que saber cómo funcionan los pulsos eléctricos.
  // Solo usamos la función "write" que viene en la librería.
  
  miMotor.write(90); // "Ponte a 90 grados"
  delay(1000);
  miMotor.write(0);  // "Ponte a 0 grados"
  delay(1000);
}

¿Dónde consigo librerías?

Arduino tiene un Gestor de Librerías integrado.

1. Vais a Sketch > Include Library > Manage Libraries...
2. Buscáis lo que necesitéis (ej: “DHT11” para temperatura, “NeoPixel” para luces de colores).
3. Le dais a Install.