Estándar bibliotecas arduino se almacenan en la carpeta:
Se instalan bibliotecas adicionales en la carpeta:
"C:\Usuarios\*Nombre de usuario*\Documentos\Arduino\bibliotecas"
En su caso, estas rutas pueden ser diferentes debido a una letra base diferente. disco duro y otro nombre de usuario. Si tiene instalado un sistema operativo de 32 bits, la carpeta "Archivos de programa (x86)" se llamará "Archivos de programa".
Instalación de bibliotecas Arduino
Instalar bibliotecas en el IDE de Arduino es muy fácil. Hay dos formas de hacer esto. A través de la interfaz del programa o copiando la biblioteca descargada a la carpeta “bibliotecas”. Echemos un vistazo más de cerca a ambas opciones:
Instalación de bibliotecas a través de Arduino IDE
La primera opción es instalar las bibliotecas de Arduino desde el repositorio oficial. Para hacer esto, necesita ejecutar el IDE de Arduino, en menú superior seleccione "Sketch -> Conectar biblioteca -> Administrar bibliotecas".
Después de esto, se abrirá una ventana con una lista de bibliotecas disponibles. Para encontrar la biblioteca que necesita, puede utilizar la búsqueda o seleccionar la sección requerida. Para instalar una biblioteca, debe seleccionarla de la lista haciendo clic en el nombre y hacer clic en el botón "Instalar" que aparece.
La segunda opción es instalar la biblioteca desde la carpeta .zip descargada. A través de la interfaz Arduino IDE, esto se puede hacer con sólo un par de clics. En el menú superior del programa, seleccione "Sketch -> Conectar biblioteca -> Agregar biblioteca ZIP". Se abrirá una ventana gestor de archivos, donde debe seleccionar una carpeta o un archivo .zip con su biblioteca.
Otra forma de instalar bibliotecas Arduino
Simplemente puedes mover las carpetas de la biblioteca a lo largo de la ruta:
"C:\Archivos de programa (x86)\Arduino\bibliotecas\"
Conectando la biblioteca Arduino
No basta con instalar la biblioteca. Para usarlo, debes conectarlo al boceto. Es muy fácil de hacer. Puedes escribir manualmente una línea similar al comienzo del boceto.
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, 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("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 archivo ZIP y desde el sitio, especificó la ruta para guardar el archivo, luego, en lugar de la carpeta "Descargas", indique la ruta al archivo.
Seleccionar archivo ZIP biblioteca que descargaste. 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 .
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.
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 quieres instalar nueva versión Arduino IDE, luego 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) de Arduino IDE, y las bibliotecas ubicadas en la carpeta de bibliotecas. Programas IDE de Arduino versión antigua(que se instaló anteriormente) estarán disponibles solo en él (hasta que los copie en el nuevo).
Conectando la biblioteca:
Para incluir la biblioteca, es necesario escribir solo una línea al comienzo del boceto: "#include<файл.h>", Por ejemplo:
#incluir
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
Para trabajar con la mayoría de las bibliotecas, necesita crear un objeto (una instancia de la clase de la 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. Mayoría manera conveniente viendo ejemplos usando 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.
Manera alternativa ver ejemplos es ejecutar 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 vez que te sientas cómodo con software Arduino y lo dominarás a la perfección características estándar, probablemente querrás ampliar las capacidades de tu Arduino con bibliotecas adicionales.
¿Qué es una biblioteca?
Una biblioteca es un conjunto de funciones diseñadas para facilitar el trabajo con varios sensores, pantallas LCD, módulos, etc. Por ejemplo, la biblioteca LiquidCrystal incorporada le permite interactuar fácilmente con pantallas LCD de caracteres. Hay cientos de bibliotecas adicionales que se pueden descargar en línea. Las bibliotecas estándar de Arduino y algunas de las bibliotecas adicionales más utilizadas se enumeran en la ayuda. Pero antes de poder utilizar bibliotecas adicionales, primero debe instalarlas.
Cómo instalar la biblioteca
La mayoría de las veces, las bibliotecas se presentan en forma de archivo ZIP o simplemente de carpeta. El nombre de esta carpeta es el nombre de la biblioteca. Dentro de la carpeta habrá un archivo con la extensión .cpp, archivo con extensión .h, y también archivo de texto palabras clave.txt, carpeta con ejemplos ejemplos y otros archivos requeridos por la biblioteca.
Instalación automática
A partir de la versión 1.0.5, puede instalar bibliotecas de terceros directamente en el entorno de desarrollo.
No descomprima el archivo descargado con la biblioteca; déjelo como está.
En el entorno de desarrollo Arduino, seleccione el menú Bosquejo > Importar biblioteca. En la parte superior de la lista desplegable, seleccione Agregar biblioteca(Agregar biblioteca).
Aparecerá un cuadro de diálogo solicitándole que seleccione la biblioteca que desea agregar. Navegue hasta el archivo zip descargado y ábralo.
Abre el menú nuevamente Bosquejo > Importar biblioteca. Debería ver la nueva biblioteca en la parte inferior de la lista desplegable. Ahora la biblioteca se puede utilizar en programas.
El archivo zip ya estará descomprimido en el directorio. bibliotecas dentro de tu carpeta de trabajo Arduino.
Nota: después de completar estos pasos, la biblioteca se puede utilizar completamente en sus programas, pero aparecerán ejemplos de la biblioteca instalada en el menú. Archivo > Ejemplos solo después de reiniciar el entorno Arduino.
instalación manual
Antes de instalar la biblioteca, cierre el entorno de desarrollo Arduino.
Luego extraiga el archivo ZIP que contiene la biblioteca. Digamos que instala la biblioteca "ArduinoParty": descomprima el archivo ArduinoParty.zip. Debería haber una carpeta en él. ArduinoFiesta con archivos ArduinoParty.cpp Y ArduinoParty.h. (Si los archivos con la extensión .cpp Y .h no están en una carpeta, necesitas crear una. En este caso, necesita crear una carpeta llamada ArduinoFiesta y transfiera todos los archivos del archivo ZIP a él, por ejemplo: ArduinoParty.cpp Y ArduinoParty.h).
Arrastra una carpeta ArduinoFiesta al directorio de bibliotecas de Arduino. En Windows será aproximadamente aquí: "Mis Documentos\Arduino\bibliotecas", para usuarios de Mac está aquí: "Documentos/Arduino/bibliotecas", y en sistemas Linux el directorio " bibliotecas" estará dentro de la carpeta de trabajo con bocetos.
Después de moverse, el directorio de su biblioteca debería verse así (en Windows):
Mis Documentos\Arduino\libraries\ArduinoParty\ArduinoParty.cpp Mis Documentos\Arduino\libraries\ArduinoParty\ArduinoParty.h Mis Documentos\Arduino\libraries\ArduinoParty\examples ....
o así (en Mac):
Documentos/Arduino/libraries/ArduinoParty/ArduinoParty.cpp Documentos/Arduino/libraries/ArduinoParty/ArduinoParty.h Documentos/Arduino/libraries/ArduinoParty/examples...
y de manera similar en Linux.
además de archivos .cpp Y .h Es posible que también haya otros archivos aquí; solo asegúrese de que estén todos aquí ahora.
(Si los archivos .cpp Y .h ubicada en la raíz de la carpeta "bibliotecas" o anidada dentro de otra carpeta, la biblioteca descargada no funcionará. Por ejemplo:
Documentos\Arduino\libraries\ArduinoParty.cpp y Documentos\Arduino\libraries\ArduinoParty\ArduinoParty\ArduinoParty.cpp
No es un ejemplo funcional.)
Reinicie el entorno Arduino. Asegúrese de que la nueva biblioteca aparezca en el menú. Bosquejo->Importar biblioteca.
¡Eso es todo! ¡Has instalado la biblioteca!
Esta guía está publicada bajo una licencia Creative Commons Attribution-ShareAlike 3.0. Los ejemplos de código que se encuentran en esta guía son contenido gratuito.
Las bibliotecas Arduino son la forma más conveniente de separar códigos como controladores de dispositivos o códigos de uso común. funciones útiles. Este tutorial le mostrará cómo instalar bibliotecas Arduino para Windows, Mac OSX y Linux, y también cubrirá problemas comunes con las bibliotecas Arduino. El artículo será útil para los principiantes; sin embargo, los usuarios ávidos de Arduino pueden aprender algo nuevo. Hay dos tipos de bibliotecas: bibliotecas estándar y de usuario.
Bibliotecas estándar Arduino El IDE de Arduino viene con un conjunto de bibliotecas estándar de funciones básicas útiles. Estas bibliotecas admiten todos los ejemplos incluidos en el IDE. Funcional bibliotecas estándar Incluye funciones de tipos básicos de comunicación y soporta los dispositivos más comunes como servomotores y pantallas LCD de caracteres. Las bibliotecas estándar se encuentran en el directorio Bibliotecas (en la carpeta Arduino IDE). Si tienes IDE instalado diferentes versiones, entonces cada uno de ellos utilizará sus propias bibliotecas.
Bibliotecas de usuario hoy hay gran número bibliotecas para una mayor funcionalidad y para varios dispositivos. Estas bibliotecas y controladores suelen estar disponibles en Arduino Playground, Github y Google Code. Es recomendable instalar estas bibliotecas en la carpeta Bibliotecas, que debe crearse en carpeta compartida con tus bocetos. Entonces todas las versiones del IDE podrán utilizar estas bibliotecas. En Windows y Mac OS, la carpeta con bocetos suele llamarse Arduino y se encuentra en la carpeta Documentos. Para Linux, la carpeta se llama Sketchbook y está ubicada en /home/(nombre de usuario).
Las versiones IDE 1.0.2 crean la carpeta Bibliotecas automáticamente; las versiones más recientes no pueden hacer esto, por lo que este procedimiento debe realizarse manualmente. Para comenzar, abra Archivo-Preferencias.
Encuentra la ubicación del Sketchbook.
crear allí nueva carpeta y asígnele el nombre Bibliotecas.
Instalación de bibliotecas Arduino para Windows Primero, cierre el IDE de Arduino, ya que este entorno solo busca bibliotecas cuando se inicia. Descargue la biblioteca que necesita en un archivo zip, por ejemplo, desde Github.
Abra el archivo zip y descomprima la biblioteca en la carpeta Bibliotecas.
Dale a la biblioteca un nombre normal. Por ejemplo, el IDE no aceptará una biblioteca con guiones en el nombre.
Inicie el IDE y vaya a Archivo-Ejemplos. Habrá ejemplos que utilizan las capacidades de la nueva biblioteca.
Abra el ejemplo y compílelo para asegurarse de que todo funcione correctamente.
Instalación de bibliotecas Arduino para Mac OSX
Cierre el IDE de Arduino. Descargue el archivo zip del repositorio.
Busque la biblioteca descargada en la carpeta Descargas. OSX abrirá automáticamente el archivo zip en la ubicación indicada.
Mueva la biblioteca a la carpeta Bibliotecas.
Instalación de bibliotecas Arduino para Linux Cierre el IDE de Arduino. Descargue el archivo zip del repositorio.
Guarde el archivo zip en una ubicación que le resulte cómoda.
Abra el archivo y extraiga el contenido en la carpeta Sketchbook/Bibliotecas.
Si es necesario, asigne a la biblioteca un nombre claro sin guiones ni otros caracteres innecesarios. Reinicie el IDE y abra uno de los ejemplos.
Su compilación sin errores supondrá que la biblioteca esté instalada correctamente.
Problemas comunes con las bibliotecas de Arduino
"xxxx" no nombra ningún tipo- Esto es lo más error común, y se debe a que el compilador no puede encontrar la biblioteca. Esto podría deberse a los siguientes motivos: biblioteca no instalada, ubicación de carpeta incorrecta, nombre de carpeta incorrecto, nombre de biblioteca incorrecto, dependencias de biblioteca, IDE de Arduino no reiniciado.
Ubicación de carpeta incorrecta- El IDE solo busca bibliotecas en la carpeta de bibliotecas estándar y en la carpeta de bibliotecas del usuario. Las bibliotecas ubicadas en otras ubicaciones simplemente no se pueden buscar. Además, una biblioteca no se puede organizar como un subdirectorio dentro de otro directorio.
Nombre de carpeta incorrecto- Como se indicó anteriormente, el IDE no entenderá nombres que contengan el carácter '-'. Generalmente se reemplaza por '_'.
Nombre de biblioteca no válido- El nombre que viene después de #include en su programa debe coincidir completamente con el nombre de la biblioteca.
biblioteca incompleta- Otro motivo por el que una biblioteca puede no funcionar es que no se haya descargado por completo del repositorio. Debe descargar todos los archivos y carpetas ofrecidos.
Varias versiones- Si tiene varias versiones de la biblioteca, el IDE intentará cargarlas todas. Esto provocará errores de compilación. No basta simplemente con cambiar el nombre de las bibliotecas; las innecesarias deben eliminarse fuera de la carpeta Bibliotecas.
Dependencias de la biblioteca- Algunas bibliotecas dependen de otras bibliotecas, por lo que debe asegurarse de que se estén ejecutando todas las bibliotecas necesarias.
Y no lo olvides ¡Reinicie el IDE de Arduino!
Arduino y componentes de radio disponibles a bajo costo en
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 en la pantalla 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.
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 el IDE de Arduino en la computadora, se crea carpeta separada para almacenar todas las bibliotecas. Para el sistema operativo Linux, "Scetchbook", ubicado en /home/. Para sistema operativo carpeta de ventanas"Arduino", ubicado 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 a 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.
tambien un numero conjuntos estándar se puede encontrar 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. Direcciones de carpetas para diferentes sistemas operativos citamos anteriormente.
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
todos faltan archivos necesarios y carpetas.
Dependencias de la biblioteca
Es necesario conectar bibliotecas dependientes adicionales sin las cuales el funcionamiento correcto es imposible.