Como crear una librería para Arduino

¿Cómo puedo crear una librería Arduino e integrarla en el IDE de Arduino? Si te estás haciendo esta pregunta, es que ya estás bastante familiarizado con el lenguaje de programación Arduno IDE y sabes que las librerías te facilitan mucho el trabajo. Aquí tienes dos ejemplos sencillos de cómo puedes escribir una nueva librería en Arduino para realizar varias operaciones y llamarlas en tu programa con tus propios comandos.

Para esta actividad necesitaremos:

  • Arduino Uno / Arduino Nano / Arduino Mega
  • LEDs y resistencias de 220 Ohm;
  • protoboard;
  • cables de conexion.

Todo lo que necesitamos es un editor de texto, el Bloc de notas. Lo primero que hay que hacer es crear una carpeta para los archivos de librería en el directorio C:\Program Files\Arduino\libraries, aquí es donde se instalan las librerías de Arduino. El nombre de la carpeta, así como los nombres de los archivos que crees, pueden ser los tuyos propios. Para el ejemplo, utilizaremos el nombre «BlinkLed», que refleja la finalidad de la librería.

Cómo construir una librería de Arduino

Arduino encender y apagar un LED
Arduino encender y apagar un LED

El Arduino IDE tiene muchas librerías estándar con ejemplos y muchas otras librerías para diversos sensores y módulos, que se pueden descargar de Internet. Nuestro objetivo es aprender a encender y apagar el LED integrado del Arduino Uno con un solo comando y un número determinado de veces. Si decidimos escribir un sketch del microcontrolador para hacer que el LED parpadee, deberíamos usar el siguiente código:

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

void loop() {
   digitalWrite(13, HIGH);
   delay(1000);
   digitalWrite(13, LOW);
   delay(1000);
}

Cómo crear una librería de Arduino IDE

La nueva librería del Arduino IDE debe contener al menos dos archivos: un archivo de cabecera (con extensión .h) y un archivo de código fuente (con extensión .cpp). El primer archivo contiene la descripción de la clase y las variables, el segundo archivo contiene el código del programa de los métodos. El fichero keywords.txt se utiliza para resaltar en color los nuevos tipos y métodos de la librería creada en el Arduino IDE.

  1. Vaya al directorio C:\Archivos de Programa\Arduino\libraries;
  2. Crear una nueva carpeta llamada BlinkLed;
  3. Crear un documento de texto BlinkLed.h;
  4. Crear un documento de texto BlinkLed.cpp;
  5. Crear un documento de texto keywords.txt.

Crear un documento de texto BlinkLed.h

El fichero de cabecera contiene la clase donde se declaran las funciones que se utilizarán en el código (blink en nuestro caso) y las variables. Guarda el siguiente código en el archivo BlinkLed.h y guarda el archivo en la carpeta C:\Program Files\Arduino\libraries\BlinkLed

#include "Arduino.h"
void blink (int pin, int pause, int repeat);

Crear un documento de texto BlinkLed.cpp

El archivo fuente contiene el código básico de la biblioteca. En el ejemplo, se utilizan tres variables en el programa, que deben especificarse en el boceto: pin – número de puerto, tiempo de pause en milisegundos, repeat – número de veces que se ejecuta el bucle for.

#include "Arduino.h"
#include "BlinkLed.h"

void blink (int pin, int pause, int repeat) {

   pinMode(pin, OUTPUT);

   for (int x=0; x<=repeat; x++) {
        digitalWrite(pin, HIGH);
        delay(pause);
        digitalWrite(pin, LOW);
        delay(pause); 
   }
}

Crear un documento de texto keywords.txt

Este archivo especifica el color de la sintaxis en el Arduino IDE. La función KEYWORD1 colorea la palabra naranja, LITERAL1 colorea la palabra azul.

	BlinkLed	KEYWORD1
	blink		KEYWORD1

Si quieres que el LED parpadee un número determinado de veces, debes utilizar un bucle for en el que puedes establecer un contador para repetir las operaciones. Usando nuestra librería, en lugar de definir el número de veces que se repite el bucle for, especificar el número de puerto Arduino para el LED y el retardo entre operaciones, simplemente ponemos variables que se usan en el programa para hacer que el LED parpadee.

Programa Arduino para nueva librería BlinkLed.h

#include "BlinkLed.h"

void setup() {
 
}

void loop() {
  blink (13, 500, 10);
}



Conclusión. Esto completa la escritura de la nueva librería para Arduino. También puede crear una carpeta de ejemplos en la carpeta BlinkLed, donde puede colocar programas de ejemplo para demostrar la librería. Al abrir el IDE de Arduino, la nueva librería de Arduino creada se puede encontrar a través de la barra de herramientas Archivo > Ejemplos / BlinkLed. Por lo tanto, podemos llamar a la función blinkLed con un solo comando.


Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *