Hogar › Ajustes › Instalación de librerías en Arduino IDE. Escribiendo una biblioteca para Arduino

Instalación de librerías en Arduino IDE. Escribiendo una biblioteca para Arduino

La biblioteca ya contiene la mayor parte del código que no necesitará escribir, la biblioteca facilita el trabajo con un módulo específico o uno de sus tipos y solo necesita incluirlo en su boceto.

Por ejemplo, si desea mostrar texto en una pantalla LCD sin conectar una biblioteca, debe pasarle varios bytes de comandos y datos, lo que requerirá varias líneas de código y, lo más importante, debe saber el tipo de microcontrolador bajo el cual opera la pantalla LCD, el propósito de los comandos que se controlan, conocer la arquitectura de su memoria, direcciones y propósito de los registros, para lo cual necesitará buscar y releer su hoja de datos.

Mientras que al escribir código usando una biblioteca (por ejemplo LiquidCrystal_I2C.h), puede mostrar texto llamando solo a una función de la biblioteca:

Lcd.print(“mi texto”);

Puede conectar cualquier biblioteca con el siguiente comando:

"#incluir<файл.h>"

<файл.h>- esta es la misma biblioteca que estamos conectando.

También puedes ver un ejemplo de conexión de la biblioteca. en el artículo.

Antes de comenzar a utilizar los métodos y funciones de la biblioteca, debe:

descargar (descárgalo a tu computadora),
instalar (colocar en la carpeta deseada),
conectar (inserte el texto “#include<файл.h>”en el boceto).

Cada biblioteca debe contener 2 archivos con extensiones. .h Y .cpp.

El primer tipo de archivos contiene:

descripción de clase,
constantes,
variables.

El segundo tipo contiene códigos de método.

Además, es necesario comprender que los archivos .h Y .cpp Es posible que no esté en la raíz del archivo descargado. También se incluyen con los archivos principales “keywords.txt” y una carpeta con ejemplos.

¿Cómo instalar la biblioteca?

Después de haber descargado (cargado) la biblioteca a su computadora, debe instalarla. Puedes instalar la biblioteca manualmente o hacerlo usando el IDE de Arduino:

Instalación de la biblioteca usando Arduino IDE

Esto lo haremos a través del menú. Ir al menú:

Bosquejo – Conectar biblioteca – Agregar biblioteca .ZIP

En la ventana que aparece, haga clic en el icono "Esta PC" y seleccione la carpeta "Descargas". Si, al descargar un archivo ZIP del sitio, especificó la ruta para guardar el archivo, en lugar de la carpeta "Descargas", especifique la ruta al archivo.

Seleccione el archivo ZIP de la biblioteca que descargó. Es posible que el nombre del archivo no coincida con el nombre de la biblioteca. Luego haga clic en “ Abierto » ( Abierto ).

En este punto, la instalación de la biblioteca está completa, puede comenzar a conectarla al boceto.

¡Importante! Después de instalar Arduino IDE, se crea una carpeta separada en la computadora para almacenar todas las bibliotecas. Para el sistema operativo Linux, "Scetchbook", ubicado en /home/. Para el sistema operativo Windows, la carpeta "Arduino" se encuentra en /Mis documentos/.

Instalar la biblioteca manualmente

Desempaquete el archivo ZIP que descargó y coloque la carpeta (el nombre de la carpeta generalmente coincide con el nombre de la biblioteca) de este archivo en la carpeta:

esta computadora → Documentos → arduino → bibliotecas

Si el IDE de Arduino se estaba ejecutando (abierto) durante la copia, entonces debe cerrar todas las ventanas de este programa, luego iniciar (abrir) el IDE de Arduino y podrá comenzar a conectar la biblioteca al boceto.

El hecho es que el programa está en constante evolución y el número de versiones crece constantemente. Si desea instalar una nueva versión del IDE de Arduino, las bibliotecas ubicadas en la carpeta ( Esta computadora → Documentos → Arduino → bibliotecas) estará disponible tanto en la versión antigua como en la nueva (instalada) del IDE de Arduino, y en las bibliotecas ubicadas en la carpeta bibliotecas Los programas Arduino IDE de la versión anterior (que se instalaron anteriormente) solo estarán disponibles en él (hasta que los copie en la nueva).

¿Dónde puedo encontrar la biblioteca que necesito?

Para mayor comodidad, en nuestro sitio web hay una sección completa llamada -. La mayoría de las bibliotecas se pueden encontrar en Internet en el dominio público.

Además, se pueden encontrar varios kits estándar en el sitio web oficial de Arduino: arduino.cc.

¿Qué bibliotecas ya están instaladas?

Como ya comentamos, el IDE en sí ya viene con algunos archivos .

Hay dos formas de ver las bibliotecas instaladas.

Método 1

Para ver qué conjunto ya está instalado, vaya a la pestaña:

Método 2

La segunda forma es utilizar el menú "Sketch" y el submenú "Connect Library". De esta forma también podrás ver la lista de bibliotecas.

Vaya a Sketch y seleccione Incluir biblioteca:

Bosquejo → Incluir biblioteca

Posibles errores

A veces, al instalar bibliotecas o al usarlas, pueden ocurrir algunos errores. A continuación veremos los principales.

'xxxx' no nombra un tipo

El error aparece cuando la biblioteca aún no está instalada.

El error también ocurre si la carpeta o biblioteca tiene el nombre incorrecto.

Es posible que la ubicación de la carpeta esté especificada incorrectamente o que el IDE de Arduino no se haya reiniciado.

Ubicación de carpeta incorrecta

Compruebe si todas las bibliotecas están ubicadas en la dirección correcta. Proporcionamos direcciones de carpetas para diferentes sistemas operativos arriba.

Nombre de biblioteca no válido

El error aparece cuando el nombre después de la etiqueta #include no coincide con el nombre de la biblioteca.

biblioteca incompleta

Faltan todos los archivos y carpetas necesarios.

Dependencias de la biblioteca

Es necesario conectar bibliotecas dependientes adicionales sin las cuales el funcionamiento correcto es imposible.

Instalar y conectar una biblioteca a arduino es una operación bastante común, tarde o temprano cualquier desarrollador inevitablemente se encontrará con ella. Se utiliza código de complemento externo en todos los lenguajes de programación para ahorrar tiempo. Arduino no es una excepción: muchos sensores, módulos, pantallas y motores requieren esquemas de interacción bastante complejos que son difíciles de implementar en su código. Es mucho más fácil y rápido descargar la biblioteca requerida, conectarla rápidamente manualmente o usando el IDE de Arduino y luego usarla en todos sus bocetos. En este artículo encontrará breves instrucciones sobre cómo conectar y utilizar bibliotecas.

Una biblioteca en Arduino es un código de programa en archivos externos que se pueden instalar y conectar a su boceto. La biblioteca almacena varios métodos y estructuras de datos necesarios para simplificar el trabajo con sensores, indicadores, módulos y otros componentes. El uso de bibliotecas simplifica enormemente el trabajo en proyectos porque puede concentrarse en la lógica principal del programa sin perder tiempo en muchas pequeñas cosas. Hoy en día, hay una gran cantidad de bibliotecas publicadas en Internet, donde se pueden descargar fácilmente y de forma totalmente gratuita. se puede encontrar en nuestro sitio web.

Desde la perspectiva del sistema de archivos, una biblioteca es un directorio que contiene carpetas específicas. Al compilar y construir un proyecto, el IDE de Arduino incluye automáticamente en el código aquellas clases, estructuras de datos y métodos de las bibliotecas que se incluyen y utilizan en el boceto. Por lo tanto, lo único que debemos hacer es poner las instrucciones apropiadas en nuestro código, después de asegurarnos de que la biblioteca requerida esté instalada.

Cómo conocer la lista de bibliotecas conectadas al IDE de Arduino

Cada biblioteca instalada contiene uno o más ejemplos con los que trabajar. Se utilizan para mostrar las capacidades del dispositivo conectado al Arduino. Por lo tanto, la forma más rápida de obtener una lista de todas las bibliotecas Arduino instaladas es utilizar la lista de ejemplos en el IDE de Arduino. Para hacer esto, seleccione Archivo en el menú principal y luego abra el submenú Ejemplos.

Otra forma es utilizar el menú Sketch y el submenú – Incluir biblioteca. Allí también puedes ver una lista de bibliotecas:

Conectando el archivo h de encabezado con el operador #include

Para comenzar a usar la biblioteca, debe incluir el archivo de encabezado h con la directiva de inclusión al comienzo del programa. Por ejemplo, incluir la biblioteca LiquidCrystal.h se verá así: #include

Puedes ver un ejemplo completo usando la propia biblioteca.

Archivos requeridos en la biblioteca

Cada biblioteca debe contener al menos 2 archivos: un archivo de encabezado con la extensión .h y un archivo de código fuente con la extensión .cpp. El archivo de encabezado contiene la descripción de la clase, constantes y variables. El segundo archivo contiene códigos de método. Además de los dos archivos principales, puede contener un documento de texto palabras clave.txt y una carpeta de ejemplos con códigos para ejemplos de uso de la biblioteca. Los archivos h y cpp no necesariamente se encuentran en la raíz

No es posible editar archivos en el IDE de Arduino; todos los cambios se pueden realizar en cualquier editor de texto o entorno de desarrollo C++. Esto se debe a que en el IDE de Arduino no trabajamos con archivos cpp, el editor de código no está diseñado para C “puro”, solo funciona con el lenguaje Arduino.

Dónde encontrar la biblioteca requerida

La biblioteca requerida se puede descargar a través de Internet. La mayoría de las bibliotecas están disponibles en Github. Después de descargar la biblioteca, es importante agregarla a la carpeta correcta para que el compilador pueda encontrarla y cargar el boceto. La carpeta en la que se guardan todos los códigos se crea en la computadora después de instalar el IDE de Arduino. Para el sistema operativo Linux, la carpeta se llama “Scetchbook” y se encuentra en /home/; en Windows, la carpeta “Arduino” se puede encontrar en la sección “Mis documentos”.

Todas las bibliotecas que se instalan adicionalmente se encuentran en la carpeta "Bibliotecas". Para versiones anteriores de Arduino, debe crear la carpeta usted mismo, pero a partir de la versión 1.0.2, se agrega automáticamente al instalar el IDE de Arduino.

Cómo instalar la biblioteca. Instrucciones paso a paso

Una vez que la biblioteca se haya descargado en su PC, debe comenzar a instalarla. Hay dos formas de instalar la biblioteca: utilizando el IDE de Arduino y manualmente.

Conexión mediante Arduino IDE

La biblioteca se descarga como un archivo zip. Para habilitarlo usando este método, no es necesario descomprimir el archivo. Para instalarlo, debe ir al menú Sketch – Conectar biblioteca – Agregar biblioteca Zip.

Cuando se abre la ventana, debe seleccionar la carpeta "descargas" en la sección "Esta PC". Si, después de descargar la biblioteca, se guardó en otra ubicación, debe especificarla.

Luego debe seleccionar el archivo descargado y hacer clic en "abrir".

La biblioteca se instalará y podrá utilizarla. Para comenzar a utilizar el Archivo de ejemplos - ejemplos, debe reiniciar el entorno de desarrollo Arduino.

Instalar la biblioteca manualmente desde un archivo zip

Antes de comenzar la instalación, debe salir del IDE de Arduino. Es necesario descomprimir el archivo zip descargado con la biblioteca. Como resultado, obtendremos una carpeta en la que se ubicarán los archivos de la biblioteca con la extensión .cpp y .h y los directorios. La carpeta resultante deberá colocarse en las bibliotecas.

En el sistema operativo Windows, la carpeta de bibliotecas se puede encontrar en la ruta Mis documentos – Arduino – bibliotecas. En Linux, esta será la carpeta de bibliotecas con bocetos.

Al final, deberá reiniciar el IDE de Arduino; la biblioteca descargada estará disponible para su inclusión a través de Sketch - Connect Library.

Errores al conectar la biblioteca Arduino

A continuación se muestra una lista de posibles errores al instalar la biblioteca y formas de solucionarlos:

'xxxx' no nombra un tipo; aparece un error similar si la biblioteca aún no se ha instalado, la carpeta o biblioteca tiene un nombre incorrecto, la dirección de ubicación de la carpeta es incorrecta o el IDE de Arduino no se ha reiniciado.
Ubicación de carpeta incorrecta: si se muestra este error, debe verificar si la biblioteca está ubicada en una carpeta que el entorno pueda buscar.
Nombre de biblioteca no válido: el error aparece si el nombre después de #include no coincide con el nombre de la biblioteca.
Biblioteca incompleta: puede aparecer si no se han descargado todos los archivos y carpetas necesarios.
Dependencias de biblioteca: dado que este tipo de biblioteca solo funciona con dependencias adicionales, es necesario incluirlas inicialmente.

Muchos bocetos (programas) funcionan con bibliotecas. La biblioteca facilita el trabajo con un módulo específico o uno de los tipos de módulos. Por ejemplo, si desea mostrar texto en una pantalla LCD sin conectar una biblioteca, entonces necesita transferirle varios bytes de comandos y datos, lo que requerirá varias líneas de código y, lo más importante, necesita saber el tipo. del microcontrolador bajo el cual opera la pantalla LCD, el propósito de los comandos que se controlan, conocer la arquitectura de su memoria, direcciones y propósito de los registros, para lo cual necesitará buscar y releer su hoja de datos. Mientras que al escribir código usando una biblioteca (por ejemplo LiquidCrystal_I2C.h), puede mostrar texto llamando solo a una función de la biblioteca: lcd.print("my text");

Antes de comenzar a utilizar los métodos y funciones de la biblioteca, debe descargar (descárgalo a tu computadora), instalar (colocar en la carpeta deseada) y conectar (inserte el texto "#include<файл.h>" en el boceto).

Descargando la biblioteca:

Si nuestras lecciones, descripciones o ejemplos utilizan una biblioteca, proporcionamos un enlace para descargar esta biblioteca. Todas nuestras bibliotecas están en un archivo zip, pero no se apresure a obtener archivos del archivo, puede que esto no sea necesario, porque... El propio Arduino IDE puede descomprimir archivos y colocar bibliotecas en las carpetas requeridas (ver más abajo).

Si descargó el archivo de la biblioteca del sitio sin especificar la ruta para guardar el archivo, lo más probable es que el archivo descargado (cargado) se encuentre en la carpeta: Esta computadora > Descargas.

Instalación de la biblioteca:

Después de haber descargado (cargado) la biblioteca a su computadora, debe instalarla. Puedes instalar la biblioteca manualmente o hacerlo usando el IDE de Arduino:

Instalación de la biblioteca usando Arduino IDE:

Ingrese al menú: Bosquejo > Conectar biblioteca > Agregar biblioteca .ZIP... .

En la ventana que aparece, haga clic en " esta computadora " y seleccione la carpeta " Descargas " Si, al descargar un archivo ZIP del sitio, especificó la ruta para guardar el archivo, en lugar de la carpeta "Descargas", especifique la ruta al archivo.

Seleccione el archivo ZIP de la biblioteca que descargó. Es posible que el nombre del archivo no coincida con el nombre de la biblioteca. Luego haga clic en “ Abierto » ( Abierto ).

En este punto, la instalación de la biblioteca está completa, puede comenzar a conectarla al boceto.

Instalación de la biblioteca manualmente:

Descomprime lo que descargaste archivo ZIP y coloque la carpeta (el nombre de la carpeta generalmente coincide con el nombre de la biblioteca) de este archivo en la carpeta: esta computadora > Documentos > arduino > bibliotecas .

Nota: carpeta bibliotecas no sólo existe el camino indicado arriba, sino también en la carpeta del programa Arduino IDE (¿dónde está el archivo arduino? .exe). Al copiar la biblioteca a esta carpeta, también se instalará, pero no recomendamos hacerlo. El hecho es que el programa Arduino IDE está en constante evolución y el número de sus versiones crece constantemente. Si desea instalar una nueva versión del IDE de Arduino, las bibliotecas ubicadas en la carpeta Esta computadora > Documentos > Arduino > bibliotecas estarán disponibles tanto en la versión antigua como en la nueva (instalada) del IDE de Arduino, y las bibliotecas ubicadas en la carpeta de bibliotecas Los programas Arduino IDE de la versión anterior (que se instalaron anteriormente) solo estarán disponibles en él (hasta que los copie en la nueva).

Conectando la biblioteca:

Para incluir la biblioteca, es necesario escribir solo una línea al comienzo del boceto: "#include<файл.h>", Por ejemplo:

#incluir // Conexión de la biblioteca iarduino_4LED para trabajar con indicadores LED de 4 segmentos.

Algunas bibliotecas funcionan usando los métodos y funciones de otras bibliotecas, luego necesita conectar dos bibliotecas, primero conecte aquella cuyos métodos y funciones usa la segunda, por ejemplo:

#incluir // Conectando la biblioteca Wire para trabajar con el bus I2C #include // Conexión de la biblioteca LiquidCrystal_I2C para trabajar con una pantalla LCD a través del bus I2C // La biblioteca LiquidCrystal_I2C utiliza los métodos y funciones de la biblioteca Wire

Para trabajar con la mayoría de las bibliotecas, necesita crear un objeto (una instancia de la clase de biblioteca) a través del cual estarán disponibles sus funciones y métodos, por ejemplo:

LiquidCrystal_I2C lcd (0x27,20,4); // lcd es un objeto de la biblioteca LiquidCrystal_I2C // se accede a las funciones y métodos de la biblioteca a través del objeto

En lugar de lcd, puedes escribir cualquier palabra o combinación de letras y números; este es el nombre del objeto a través del cual puedes acceder a los métodos y funciones de la biblioteca. Si en lugar de lcd escribió myLCD, entonces se debe acceder a todos los métodos y funciones de la biblioteca LiquidCrystal_I2C a través del nombre del objeto que especificó, por ejemplo: myLCD.print("my text");

Ejemplos de bibliotecas:

La mayoría de las bibliotecas contienen ejemplos. Se trata de pequeños bocetos (programas) que revelan la funcionalidad de la biblioteca. La forma más cómoda de ver ejemplos es utilizando el IDE de Arduino. Seleccionar elemento del menú: Archivo > Ejemplos , se abrirá una lista con los nombres de las bibliotecas que tienen ejemplos. Pase el cursor sobre el nombre de la biblioteca y verá una lista de ejemplos contenidos en él; al hacer clic en un ejemplo, aparecerá una nueva ventana del IDE de Arduino con un boceto de ejemplo.

Una forma alternativa de ver los ejemplos es ejecutar los archivos de boceto desde la carpeta:
camino > bibliotecas > nombre de la biblioteca > ejemplos > nombre de ejemplo .

Buscar bibliotecas:

Puede buscar bibliotecas usted mismo o puede utilizar la funcionalidad del IDE de Arduino.

Seleccionar elemento del menú: Bosquejo > Conectar biblioteca > Administrar bibliotecas... .

" Administrador de biblioteca ", en el que puede encontrar la biblioteca que le interesa ingresando su nombre en la barra de búsqueda; además puede configurar los elementos "Tipo" y "Asunto".

Al hacer clic en la descripción de la biblioteca aparecerá el mensaje " Versión "y botones" Instalación " Después de hacer clic en el botón "Instalar", puede comenzar a incluir la biblioteca en el boceto "#include<файл.h>".

Una de las razones de la popularidad de Arduino es la facilidad de uso de una variedad de dispositivos periféricos (módulos): pantallas, controladores de motor, módulos de comunicación inalámbrica (Bluetooth, wi-fi, XBee o ISM), etc.

El entorno de software Arduino (IDE) incluye muchas funciones útiles que facilitan la creación de programas para nuevos proyectos. Pero, desafortunadamente, no puede tener soporte integrado para cada nuevo hardware (módulo) o componente de software que aparece.

En cambio, se proporciona soporte para "bibliotecas", que son módulos autónomos diseñados para ampliar el entorno de software, agregar funcionalidades específicas o agregar soporte de hardware.

La principal fuente de bibliotecas para Arduino son los fabricantes de hardware que las crean para brindar soporte en el IDE de Arduino.

¿Dónde puedo encontrar bibliotecas para Arduino?

Si necesita soporte Arduino para un hardware (módulo) específico, intente navegar por el sitio web del fabricante del módulo. También puedes visitar el sitio web de Arduino, que contiene muchas bibliotecas populares.

De lo contrario, intente realizar una búsqueda en Google como "biblioteca Arduino" seguida del nombre de su hardware.

Como se mencionó anteriormente, el entorno de desarrollo Arduino tiene bibliotecas preinstaladas. Para que las funciones de la biblioteca estén disponibles en nuestro programa, primero debe conectarlo. Para esto se utiliza la directiva #include.

La conexión de la biblioteca incorporada se llama desde el menú "Sketch - Conectar biblioteca - ..." luego seleccione la biblioteca requerida (en nuestro caso "Servo").

Cuando selecciona una biblioteca, el IDE de Arduino agregará automáticamente la directiva #include apropiada a su código.

#incluir // conecta la biblioteca de soporte del servodrive.

Si el IDE no tiene la biblioteca preinstalada requerida, deberá instalarla usted mismo. Hay 2 formas de hacer esto.

Primera forma: Agregar una biblioteca desde el repositorio de Arduino.

Los creadores de Arduino han publicado una base de datos de varias bibliotecas en Internet. Si te falta alguna biblioteca, puedes buscarla en el repositorio. Para hacer esto, seleccione “Sketch – Conectar biblioteca – Administrar bibliotecas” en el menú.

En esta ventana puede descargar una nueva biblioteca de Internet o actualizar una biblioteca existente.

Segunda forma: Agregar una biblioteca descargada de Internet.

Dado que casi todo es fácil y sencillo en el entorno Arduino, instalar bibliotecas adicionales tampoco es muy difícil. Como ejemplo, mostraremos la instalación de una biblioteca para trabajar con el módulo de radio del sistema de comunicación inalámbrica NRF24L01 de Nordic Semiconductor.

Las bibliotecas de Arduino para los módulos más populares están disponibles en http://arduino.cc/libraries. El software (bibliotecas) para módulos menos populares generalmente se encuentra en los sitios web de los fabricantes de estos módulos.

En el caso del módulo de radio NRF24L01, la biblioteca de soporte para este módulo en el entorno Arduino se creó a partir de la biblioteca desarrollada para microcontroladores AVR. La documentación de esta biblioteca y la biblioteca misma se puede descargar desde https://github.com/stanleyseow/arduino-nrf24l01

Una vez que haya descargado el archivo de la biblioteca arduino-nrf24l01-master.zip, deberá instalarlo en el IDE. Para hacer esto, vaya al menú “Sketch – Conectar biblioteca – Agregar biblioteca ZIP”

Luego especifique la ubicación del archivo arduino-nrf24l01-master.zip descargado y haga clic en el botón Abrir.

Después de esto, por regla general ya tenemos la biblioteca instalada. Pero, desafortunadamente, a menudo sucede que Arduino señala el error "La carpeta/archivo zip seleccionado no contiene las bibliotecas correctas".

En este caso, la biblioteca se puede instalar manualmente. Para hacer esto, debe descomprimir el archivo descargado arduino-nrf24l01-master.zip y copiar la carpeta "Mirf" a la carpeta "bibliotecas". O puede colocar la carpeta “Mirf” en C:\....\Documents\Arduino\libraries (entonces la biblioteca estará disponible en diferentes versiones de IDE).

Después de reiniciar el IDE de Arduino, podemos conectar esta biblioteca, así como usar ejemplos para el módulo de radio NRF24L01.

Cómo eliminar una biblioteca en Arduino

Si ha descubierto cómo instalar una nueva biblioteca en el IDE, no será un problema eliminarla (si es necesario).

Todo lo que tiene que hacer para eliminar la biblioteca es eliminar la carpeta de la biblioteca del directorio "bibliotecas" en el IDE o (si la biblioteca está instalada en "Documentos") de C:\....\Documentos\Arduino\ directorio de bibliotecas

Las bibliotecas Arduino son una herramienta conveniente para distribuir código. Por ejemplo, podrían ser controladores de hardware o funciones de uso frecuente.

Esta guía describe en detalle cómo instalar bibliotecas en su computadora.

Hay dos tipos principales de bibliotecas Arduino: estándar y adicionales.

Bibliotecas estándar

El IDE de Arduino tiene un conjunto de bibliotecas estándar que se utilizan con mucha frecuencia. Estas bibliotecas admiten todos los ejemplos que se incluyen en el IDE de Arduino. Las bibliotecas estándar admiten funciones para trabajar con los equipos periféricos más comunes, por ejemplo: servomotores o pantallas LCD.

Las bibliotecas estándar se instalan en la carpeta "Bibliotecas" al instalar el IDE de Arduino. Si tiene varias versiones del IDE instaladas, cada versión tendrá su propio conjunto de bibliotecas. Se recomienda encarecidamente no cambiar las bibliotecas estándar e instalar otras adicionales en la misma carpeta.

Bibliotecas adicionales

En Internet hay una gran cantidad de bibliotecas adicionales con funciones convenientes y controladores para diversos equipos periféricos. Las bibliotecas se publican principalmente en Arduino Playground, Github y Google Code. Los fabricantes de sensores, transductores, placas de circuito impreso, etc. suelen escribir bibliotecas para Arduino. Por ejemplo, Adafruit ofrece más de 100 bibliotecas que admiten todos los modelos de placas Arduino.

Instale bibliotecas adicionales en la carpeta Bibliotecas. Gracias a esto, se pueden utilizar en todas las versiones del IDE de Arduino. Después de actualizar la versión, ¡no tendrás que volver a instalarlas!

Dónde instalar bibliotecas

Es importante instalar las bibliotecas en la carpeta correcta. De lo contrario, el compilador no podrá encontrarlos cuando compile y cargue su código.

La carpeta donde se almacenan todos los bocetos de Arduino se crea automáticamente cuando instala el IDE.

En Linux, la carpeta se llama "Scetchbook" y normalmente se encuentra en /home/<username>.

En Windows y Macintosh, la carpeta se llama "Arduino" y se encuentra en la carpeta Documentos.

¡Tenga en cuenta que esto es importante! En la carpeta "Mis documentos", se crea automáticamente otra carpeta llamada "Arduino".

Las bibliotecas adicionales deben ubicarse en la carpeta "Bibliotecas", que se encuentra dentro de "Scetchbook" o "Arduino". Aquí es donde el IDE buscará bibliotecas instaladas adicionales.

Desde Arduino IDE 1.0.2 y posteriores, la carpeta "Bibliotecas" se crea automáticamente. En versiones anteriores, debe crearse antes de instalar su primera biblioteca.

Abra el menú y seleccione "Archivo->Preferencias" en el IDE de Arduino.

Encuentra la ubicación de tus bocetos. Suele ser la carpeta "Arduino" en su carpeta "Mis documentos".

Una vez que haya determinado la ruta, navegue hasta esa carpeta usando el Explorador de archivos.

Si la carpeta Bibliotecas no existe, cree una nueva carpeta.

Cambie el nombre a "Bibliotecas".

Instalación de bibliotecas en Windows

Para instalar la biblioteca en Windows, siga las instrucciones a continuación.

Cerrar IDE de Arduino

Asegúrese de que el IDE de Arduino esté cerrado, ya que las bibliotecas se escanean solo cuando el IDE está cargado. La nueva biblioteca no funcionará hasta que reinicie el IDE.

Descargue el archivo zip de Github.

Copia la carpeta descomprimida

Pégalo en tu carpeta de bibliotecas.

Dale un nombre correcto. Arduino IDE no reconoce carpetas con un guión en el nombre. Entonces tendrás que cambiar el nombre de la carpeta. Puedes utilizar debajo de los guiones.

Reinicie el IDE de Arduino y verifique si la biblioteca aparece en el elemento de menú Archivo->Ejemplos.

Para comprobarlo, descargue uno de los ejemplos.

Antes de subir el ejemplo a la pizarra, revisa el boceto.

Instalación de bibliotecas en Mac OSX

Para instalar correctamente bibliotecas adicionales en Mac OSX, siga las instrucciones a continuación

Cierre el IDE de Arduino.

Descargue el archivo con la biblioteca de Github.

Busque el archivo descargado en la carpeta de descargas de su Mac.

Descomprima y copie la biblioteca en la carpeta de bibliotecas que se creó cuando instaló el IDE de Arduino.

Dé a la biblioteca un nombre válido. Como ocurre con Windows, las carpetas con guiones no son legibles.

Reinicie el IDE de Arduino. La biblioteca debería aparecer en el menú Archivo->Ejemplos.

Descarga uno de los ejemplos.

Verifique que el boceto sea correcto antes de cargarlo en su Arduino.

Instalación de bibliotecas en Linux

Para instalar bibliotecas personalizadas en Linux, siga las instrucciones a continuación.

Nuevamente, cierre el IDE de Ardino.

Descarga el archivo con la biblioteca que necesitamos.

Guardamos el archivo en el disco duro de nuestra PC.

Busque el archivo descargado en la carpeta de descargas.

Descomprima la biblioteca y cópiela en la carpeta Sketchbook/Bibliotecas.

Dale a la carpeta el nombre correcto. ¡Sin carrera!

Reinicie el IDE de Arduino y verifique si la biblioteca aparece en la carpeta del menú Archivo->Ejemplos.

Descarguemos uno de los ejemplos.

Comprobamos si el archivo de ejemplo se compila sin errores.

Errores comunes al instalar librerías para Arduino

"xxxx" no nombra ningún tipo

Este es el error más común al trabajar con bibliotecas externas. La razón es que el compilador no puede encontrar la biblioteca. Posibles razones de este error:

La biblioteca no está instalada (consulte las instrucciones de instalación anteriores).
La ubicación de la carpeta es incorrecta.
Nombre de carpeta no válido.
Nombre de biblioteca no válido.
Olvidó reiniciar el IDE de Arduino.

A continuación se muestran soluciones a posibles problemas.

Ubicación de carpeta incorrecta

El IDE solo encuentra bibliotecas estándar y adicionales que están instaladas en la carpeta "Bibliotecas". Las bibliotecas que estén ubicadas en otras ubicaciones no se inicializarán

La carpeta de la biblioteca debe estar en la raíz de la carpeta "Bibliotecas". Si crea una subcarpeta adicional, el IDE no detectará la biblioteca.

Nota: en algunos repositorios en línea, las bibliotecas están diseñadas con un nivel adicional de anidamiento de carpetas. Comprueba este momento. Los archivos de la biblioteca deben ubicarse en la primera carpeta, sin subcarpetas adicionales.

No es una biblioteca completa

No debe cambiar el nombre de los archivos de la biblioteca utilizando letras mayúsculas, guiones, etc.

Nombre de carpeta incorrecto

El IDE no detecta carpetas con ciertos caracteres en el nombre. Desafortunadamente, el IDE no admite guiones, que se generan en los nombres de archivos en Github. Por lo tanto, después de descargar el archivo, cambie el nombre de la carpeta. El nuevo nombre no debe contener un guión. Simplemente puede reemplazar todos los caracteres ('-') con ('_').

Nombre de biblioteca no válido

El nombre que especifique en la directiva #include en su boceto debe coincidir exactamente con el nombre de la clase en la biblioteca (¡distingue entre mayúsculas y minúsculas!). Si el nombre no coincide, el IDE no incluirá las funciones, clases, etc. necesarias. En los ejemplos que vienen con las bibliotecas, los nombres son correctos. Entonces, para evitar errores accidentales, simplemente puedes copiarlos y pegarlos en tu código.

Múltiples versiones de biblioteca

Si tiene varias versiones de la biblioteca, Arduino IDE intentará cargarlas todas al mismo tiempo. Como resultado, puede producirse un error de compilación. Por lo tanto, las versiones antiguas o que no funcionan deben eliminarse o trasladarse del catálogo de la biblioteca.

Bibliotecas dependientes

Algunas bibliotecas dependen de otras bibliotecas. Por ejemplo, la mayoría de las bibliotecas de visualización gráfica de Adafruit dependen de la biblioteca Adafruit GFX. Es decir, para utilizar la primera biblioteca es necesario tener instalada la segunda.

Bibliotecas “básicas”

Algunas bibliotecas no se pueden utilizar directamente. Un buen ejemplo es la biblioteca GFX. Esta biblioteca alimenta la mayoría de las pantallas de Adafruit, pero no se puede utilizar sin una biblioteca de controladores para esa pantalla.