Cómo crear una biblioteca Arduino personalizada?
Necesitará una gran cantidad de trabajo antes de comenzar a comenzar con nuestro proyecto. Aunque hay una gran variedad de bibliotecas de código abierto disponibles, a veces necesitamos escribir una biblioteca personalizada para que esta guía lo ayude a escribir su primera biblioteca Arduino.
Cómo crear la biblioteca personalizada de Arduino
Las bibliotecas generalmente se escriben en lenguaje c/c ++, por lo que para escribir bibliotecas arduino necesitamos algún conocimiento sólido de funciones y clases. Las bibliotecas son un montón de .Archivos CPP combinados para ejecutar un solo hardware. Las bibliotecas hacen que la programación de Arduino sea más fácil y eficiente. No tenemos que escribir un nuevo código cada vez que usamos algún hardware. Las bibliotecas son una excelente manera de compartir códigos que ahorra mucho tiempo y costo.
Como Arduino es una plataforma de código abierto, la comunidad Arduino ha creado miles de bibliotecas. Pero aún así hay un espacio para que se escriban nuevas bibliotecas o si va a convertir un proyecto Arduino en un producto, entonces uno podría necesitar escribir una biblioteca separada para su hardware.
Antes de avanzar, tomemos una revisión rápida de la estructura básica de la Biblioteca Arduino.
Una biblioteca generalmente consiste en:
- Archivo de cabecera (.H): Esto contiene las definiciones de la biblioteca.
- Archivo fuente (.CPP): Esto contiene el código de la biblioteca.
- Archivo de palabras clave (.TXT): Este archivo explica las palabras clave utilizadas en la biblioteca.
- Archivo readMe (.TXT): Esto contiene información adicional relacionada con la Biblioteca Arduino.
- Ejemplos (INO): Ejemplos ayudan a los usuarios a operar la biblioteca.
Todos estos archivos ayudan a los usuarios a comprender y operar bibliotecas en Arduino.
El archivo de cabecera(.h) y archivo fuente(.CPP) son los dos archivos necesarios necesarios para operar una biblioteca Arduino. Todos los demás archivos son un complemento que brinda a los usuarios información necesaria como lo que está haciendo esta biblioteca o quién es el escritor de esta biblioteca.
Ahora crearemos una nueva biblioteca .H y .CPP archivo.
Paso 1: crear un código de muestra
Paso 2: Crear encabezado de biblioteca y archivo de origen
Paso 3: Agregar biblioteca personalizada en Arduino IDE
Paso 4: Llamar a la biblioteca personalizada dentro de un código Arduino
Paso 1: crear un código de muestra
i: Escriba un código simple en el editor de Arduino IDE que tomará dos números y sumará ambos números para mostrar el resultado en el monitor en serie:
int sum (int a, int b)devolver a + b;
Configuración vacía ()
De serie.comenzar (9600);
int respuesta = sum (1,2);
De serie.println (respuesta);
bucle void ()
Compilar el código anterior La siguiente salida aparecerá en la ventana de salida. La salida imprimirá la suma de dos números 1 y 2.
II: Una vez que el código se escribe en IDE, guarde su código yendo a Guardar como opción bajo el Archivo menú:
Se abrirá una nueva ventana, creará una nueva carpeta MI BIBLIOTECA y guarde el archivo Arduino dentro de esa carpeta.
Una vez que se cree la nueva carpeta de la biblioteca, verá un nuevo .ino archivo allí. Dentro de este archivo llamaremos a una biblioteca personalizada y probaremos su salida.
Paso 2: Crear encabezado de biblioteca y archivo de origen
i: Ahora cree dos archivos principales de la biblioteca que son encabezado y archivo de origen. Para hacer esta prensa "Ctrl+Shif+N" o haga clic en el icono de elipsis en el lado derecho del IDE y luego haga clic en Nueva pestaña:
II: Una nueva ventana se abrirá aquí y escribirá el nombre de los archivos que queremos crear. Tipo Mi biblioteca.CPP y Mi biblioteca.H Para crear un archivo de origen y encabezado respectivamente:
III: Después de que se creen los dos archivos nuevos, la interfaz IDE se verá así. El siguiente paso es escribir código para los archivos de origen y encabezado para que podamos llamar a nuestra propia biblioteca personalizada en el archivo de código principal.
Código para el archivo de encabezado
Primero, crearemos un archivo de encabezado para la biblioteca personalizada Arduino. Escriba el código a continuación dentro del ".H " archivo.
#ifndef my_library_h#define my_library_h
#incluir
int sum (int a, int b);
#terminara si
Esta es una sintaxis general para escribir código para la biblioteca Arduino, comenzamos con la definición del nombre del guarda de encabezado y termina con #terminara si declaración. Normalmente, mientras escribe el nombre del protector del encabezado, es mejor escribir en letras mayúsculas y agregar "_H" Al final del nombre.
Después de eso, es necesario agregar una biblioteca Arduino, ya que la biblioteca puede requerir el uso de algunas funciones de Arduino. En nuestro programa principal normalmente, se agrega de forma predeterminada, pero escribiendo una biblioteca personalizada debemos incluirla nosotros mismos. A continuación, creamos una variable "SUMA" que será llamado por nuestro archivo fuente .CPP Dentro de una función.
Código para el archivo fuente
Nuestro archivo de encabezado está listo, ahora avanzaremos hacia la creación del código fuente (.CPP archivo). Escriba el siguiente código en el archivo de origen:
#include "my_library.H "int sum (int a, int b)
devolver a + b;
Aquí en el código anterior, comenzamos llamando al archivo de encabezado usando #incluir directiva. El archivo de encabezado contiene comentarios descriptivos que incluyen archivos como (#include), algunas definiciones y clases constantes que contienen diferentes funciones y variables que llamamos en nuestra biblioteca.
Paso 3: Agregar biblioteca personalizada en Arduino IDE
Una vez que hemos creado una biblioteca Arduino, el siguiente paso es agregarla al IDE Arduino para que podamos llamarla dentro de cualquier código. Para hacer esta copia de la carpeta que contiene el encabezado de la biblioteca y el código fuente, pegue esa carpeta dentro del directorio de la biblioteca Arduino. La ruta de la carpeta del directorio Arduino se verá así: Documentos> Arduino> Bibliotecas:
Una vez que se agrega la biblioteca dentro del IDE Arduino. Podemos llamarlo dentro de cualquier código yendo a: Sketch> incluir biblioteca> my_library:
Abra un boceto Arduino en blanco e intente llamar a la biblioteca que acaba de crear el código se verá así:
Hemos creado con éxito una biblioteca para calcular la suma de dos enteros y la llamamos dentro del código Arduino.
Paso 4: Llamar a la biblioteca personalizada dentro de un código Arduino
Como nuestra biblioteca Arduino se completa ahora, escribiremos el mismo código de suma anterior llamando a nuestra biblioteca personalizada. Escriba el siguiente código en IDE:
#include "my_library.H "Configuración vacía ()
De serie.comenzar (9600);
int resultado = sum (1,2);
De serie.println (resultado);
bucle void ()
En el código anterior primero incluimos "Mi biblioteca.H " Luego, en la parte de configuración, comenzamos la comunicación en serie. Se llamará a la siguiente variable de resultado y se imprimirá la suma de dos números en el monitor en serie llamando a la función de resultado de la biblioteca .CPP archivo. Mientras llama a la biblioteca personalizada dentro del Arduino .ino Archivo Asegúrese de usar exactamente el mismo nombre de archivo que llamó el archivo de encabezado.
Después de compilar el código, el mismo resultado se imprime como nuestro código anterior. Justo aquí el código está más optimizado usando una biblioteca separada.
Cómo compartir la biblioteca personalizada de Arduino
Para compartir la biblioteca Arduino, primero abra la carpeta donde dos archivos principales con .CPP y .H el formato se guardan. La carpeta de boceto puede estar abierta yendo a: Sketch> Mostrar carpeta de boceto.
Se abrirá una nueva ventana aquí donde se pueden ver todos los archivos de la biblioteca. Para compartir bibliotecas, primero comprime estos archivos y los comparta usando un archivo zip:
Conclusión
Arduino tiene una amplia gama de bibliotecas de código abierto disponibles, pero a veces necesitamos una biblioteca personalizada para aumentar la productividad del proyecto o para optimizar el código. Este artículo cubre todos los pasos necesarios necesarios para escribir su propio código de biblioteca. Principalmente se requieren dos archivos para una biblioteca Arduino, fuente y archivos de encabezado. Ambos archivos se pueden crear siguiendo los pasos mencionados en esta guía.