Como crear una libreria en arduino

Como crear una libreria en arduino

Tutorial de la biblioteca avanzada de arduino

Ya verás, ¡esto puede ser mucho más sencillo de lo que pensabas! De forma muy sencilla, una librería Arduino es un montón de archivos Cpp que tienes que organizar de una forma determinada. Luego la importas, la usas y ya está.
Para ello, busca dónde se encuentra tu sketch de Arduino. Normalmente está dentro de la carpeta «Mis Documentos/Arduino», a no ser que hayas cambiado la ubicación por defecto. También puedes encontrar dónde está tu archivo de sketch actual directamente desde el IDE de Arduino: haz clic en «Sketch» > «Show Sketch Folder».
Para el nombre de la guarda de cabecera, normalmente es una buena práctica usar el nombre de tu archivo en mayúsculas y añadir «_H». Por ejemplo, si tienes un archivo temperature_sensor.h, puedes usar «TEMPERATURE_SENSOR_H».
Ve de nuevo a tu carpeta de Arduino («Mis Documentos/Arduino» o similar), y busca una carpeta llamada libraries/. Si no la encuentras, tendrás que crearla. La ruta de esta carpeta será «Mis Documentos/Arduino/bibliotecas».
En tu código principal .ino (ahora, en tu carpeta del sketch, sólo tienes tu archivo .ino de nuevo), cambia esta línea #include «my_library.h» por esto: #include <mi_biblioteca.h>. Cuando incluya un archivo de cabecera ubicado en el directorio de su proyecto, utilice «». Si el archivo de cabecera está instalado globalmente, o en este caso, desde la carpeta de bibliotecas de Arduino, utilice <>.

Biblioteca arduino.h

En el artículo anterior, escribí un sketch de Arduino para interconectar el módulo de pantalla LCD 5110 con Arduino, pero aún no es una biblioteca de Arduino que pueda ser distribuida y compartida con otros. En este artículo, voy a explicar cómo crear una biblioteca Arduino en 6 sencillos pasos.
Un sketch de Arduino es un programa que a menudo consiste en unas pocas funciones definidas por el usuario junto con dos funciones especiales que son partes fundamentales de cada sketch de Arduino: setup() y loop(). La función setup() se llama una vez cuando se inicia el sketch, se utiliza para inicializar el estado del programa. La función loop() es donde la lógica principal del programa y el flujo que utiliza todas las funciones.
Una librería Arduino adopta un enfoque de programación orientado a objetos utilizando clases C++ para separar las funciones reutilizables de su programa de aplicación, proporciona un conjunto de APIs (o interfaces) para que los programadores puedan utilizar la librería sin conocer la implementación detallada de la misma.
El paso 1 de la creación de una biblioteca Arduino es crear un directorio con el nombre de la funcionalidad de la biblioteca dentro del directorio Libraries de su directorio Arduino Sketchbook. Dado que nuestra biblioteca está relacionada con el LCD 5110, nombraremos nuestra biblioteca como LCD5110.

Cómo editar la biblioteca de arduino

Ya verás, ¡esto puede ser mucho más sencillo de lo que pensabas! En pocas palabras, una biblioteca de Arduino es un montón de archivos Cpp que tienes que organizar de una manera determinada. Luego la importas, la usas y ya está.
Para ello, busca dónde se encuentra tu sketch de Arduino. Normalmente está dentro de la carpeta «Mis Documentos/Arduino», a no ser que hayas cambiado la ubicación por defecto. También puedes encontrar dónde está tu archivo de sketch actual directamente desde el IDE de Arduino: haz clic en «Sketch» > «Show Sketch Folder».
Para el nombre de la guarda de cabecera, normalmente es una buena práctica usar el nombre de tu archivo en mayúsculas y añadir «_H». Por ejemplo, si tienes un archivo temperature_sensor.h, puedes usar «TEMPERATURE_SENSOR_H».
Ve de nuevo a tu carpeta de Arduino («Mis Documentos/Arduino» o similar), y busca una carpeta llamada libraries/. Si no la encuentras, tendrás que crearla. La ruta de esta carpeta será «Mis Documentos/Arduino/bibliotecas».
En tu código principal .ino (ahora, en tu carpeta del sketch, sólo tienes tu archivo .ino de nuevo), cambia esta línea #include «my_library.h» por esto: #include <mi_biblioteca.h>. Cuando incluya un archivo de cabecera ubicado en el directorio de su proyecto, utilice «». Si el archivo de cabecera está instalado globalmente, o en este caso, desde la carpeta de bibliotecas de Arduino, utilice <>.

Cómo ver el código de la biblioteca de arduino

La Guía de Estilo de la API de Arduino es un gran punto de partida para que los usuarios se sientan cómodos con su biblioteca, así como con la biblioteca XYZ. Me gusta mucho. Asegúrate de ser lo más amable posible con el usuario con tu biblioteca.
Si el usuario no tiene ninguna otra documentación debería ser capaz de utilizar casi todas las características de un dispositivo pasando por todos los ejemplos. Una biblioteca debería tener un ejemplo de la mayoría, si no de todos, los métodos de la clase.
Tenga en cuenta que la complejidad de los ejemplos debería avanzar. Todo el mundo necesitará las lecturas básicas. Menos gente necesitará los ejemplos AdvancedI2C o TwoSensors. Si tienes múltiples tipos de interfaz para tu biblioteca (digamos I2C y Serial) considera añadir subcarpetas con ejemplos que demuestren los diferentes métodos de la biblioteca usando las diferentes interfaces.
La biblioteca debe tener una función begin() que devuelva true si el dispositivo respondió como esperábamos, e inicialice cualquier configuración al caso de uso más predeterminado/90% que el usuario pueda querer. Minimizar la cantidad de configuración que se hace en el Ejemplo 1.

Usamos cookies para asegurar que le damos la mejor experiencia en nuestra web. Si continúa usando este sitio, asumiremos que está de acuerdo con ello. Nuestros socios (incluye a Google) podrán compartir, almacenar y gestionar sus datos para ofrecerle anuncios personalizados    Más información
Privacidad