Bom dia pessoal, 

Ja acompanhei inúmeros tópicos aqui no Lab, referentes à problemas de instalação de Bibliotecas na IDE do Arduino. 

Por isso resolvi criar esse Tutorial - Arduino - Instalando Bibliotecas ( guia de instalação) . 

Vou esclarecer primeiramente algumas informações básicas sobre o Projeto Arduino. Um dos motivos do grande sucesso mundial do Arduino é a facilidade de programação do microcontrolador do fabricante Atmel.

Em termos de hardware foram desenvolvidos vários tipos de Arduino, cada um com uma utilidade específica e com muitos recursos variados. 

A plataforma de desenvolvimento da programação do Arduino se chama IDE ( Integrated Development Environment ou Ambiente de Desenvolvimento Integrado) . Essa plataforma desenvolvida com a linguagem Java, foi criada para facilitar a vida do programador. Nela você tem o editor de programa, o acesso às Bibliotecas, o compilador (que converte o seu programa em linguagem de máquina) e o programa que grava essa linguagem de máquina no seu Micro-controlador. A IDE tem sido sempre atualizada e  assim mais recursos e facilidades são adicionados. 

Para fazer o download da IDE do Arduino, acesse esse link ( só baixar e executar o arquivo) : 

https://www.arduino.cc/en/Main/Software

Recomendo que sempre use a IDE mais recente. É claro, às vezes algumas Bibliotecas não são atualizadas e não funcionam para uma IDE mais nova. Nesse caso, a solução é usar uma IDE mais a antiga, ou uma outra Biblioteca que permita uma programação similar ao que deseja. 

Mas o que são Bibliotecas ?

Bibliotecas são coleções de códigos desenvolvidas com o objetivo de permitir o uso de algum hardware específico, como sensores, displays, módulos, etc. Por exemplo, ao escolher uma biblioteca relacionada com um sensor de temperatura, toda a codificação necessária para usá-lo já estará pronta nessa biblioteca. Assim a sua programação ficará reduzida e simplificada. Esse conceito de programação se chama Orientação à objetos. 

https://pt.wikipedia.org/wiki/Orienta%C3%A7%C3%A3o_a_objetos

Existem centenas de Bibliotecas na Internet para download. Nem sempre elas estão atualizadas para serem compatíveis com as IDEs mais recentes. Por isso o grupo do Arduino, resolveu implementar um jeito organizado de criar, atualizar e instalar bibliotecas na IDE. Nas versões mais recentes, o processo ficou automatizado, evitando erros nas instalações. Existe um processo manual de instalação de bibliotecas, mas para os menos experientes, recomendo sempre o processo automatizado, pois é muito simples. 

https://www.arduino.cc/en/Guide/Libraries

Essa é uma lista oficial de algumas Bibliotecas disponíveis no site Arduino . Mas existem muitas outras mais !

Veja que a maioria delas são dedicadas para o uso de Hardware, mas já existem algumas para o uso de software também. 

https://www.arduino.cc/en/Reference/Libraries

Agora que já tem a IDE instalada no seu PC  e  já configurou-a para uso com o seu Arduino, podemos seguir o procedimento de instalação de Bibliotecas. Se a versão da IDE é 1.6.2 ou maior, faça isso :

- clique em Sketch, Incluir Biblioteca  e depois Gerenciar Bibliotecas

A IDE do Arduino irá abrir uma janela do Gerenciador de Biblioteca . Aparecerá uma lista de Bibliotecas já instaladas ou prontas para serem instaladas. Você pode pesquisar alguma Biblioteca digitando o nome da mesma no campo Refine sua busca. Para instalar uma Biblioteca nova , clique em More Info...após aparecer o  ícone de Instalar , clique nele. Se clicar mais uma vez em More Info..., a IDE vai direcionar você para o site do GitHub dessa Biblioteca, onde poderá encontrar mais detalhes como fontes de códigos e exemplos. Toda Biblioteca já instalada, aparecerá Installed. 

Para visualizar a versão da Biblioteca selecionada, clique em Selecionar Versão, após More Info...

Algumas Bibliotecas não tem essa opção. 

Observação importante : Para instalar qualquer biblioteca, seu PC precisará estar conectado na Internet, e o tempo de download poderá variar dependendo da velocidade da sua conexão. Após instalar as bibliotecas desejadas, feche a janela do Gerenciador de Biblioteca. Para usar exemplos da Biblioteca , clique em Arquivos, Exemplos e escolha a biblioteca.

Ao instalar a IDE , algumas Bibliotecas já estarão instaladas também. No caso do Windows, esse é o diretório onde essas bibliotecas  são instaladas:

 C:\Program Files (x86)\Arduino\libraries

Obs: Bibliotecas adicionais estarão em outro diretório (exemplo Windows 10) :

 C:\Users\jgust\OneDrive\Documentos\Arduino\libraries

Qualquer um pode desenvolver uma Biblioteca, mas o site Arduino recomenda procedimentos regulamentados para essa criação, com o objetivo de organização e padronização. 

Esse tutorial ensina como desenvolver uma Biblioteca :

https://www.arduino.cc/en/Hacking/LibraryTutorial

Esse é o guia de estilo para o desenvolvimento de uma Biblioteca:

https://www.arduino.cc/en/Reference/APIStyleGuide

Nos próximos tópicos, veja outros métodos de instalação de Bibliotecas !

Bons trabalhos !

Exibições: 20065

Comentar

Você precisa ser um membro de Laboratorio de Garagem (arduino, eletrônica, robotica, hacking) para adicionar comentários!

Entrar em Laboratorio de Garagem (arduino, eletrônica, robotica, hacking)

Comentário de guilherme lourenço soares martin em 21 dezembro 2016 às 21:21

jose Boa noite e qual a diferença entre as libs que ficam na pasta C:\Program Files\Arduino\libraries\
para a pasta do sketchbook?

Comentário de José Gustavo Abreu Murta em 10 julho 2016 às 14:00

Dicas para resolver problemas com as Bibliotecas Arduino :

Pode ser que por algum motivo, tenha um problema com a Biblioteca instalada. 

Um problema frequente é a incompatibilidade de versões. Por exemplo, sua biblioteca é antiga e se estiver usando uma IDE nova, pode ser que alguns comandos não funcionem.  Nesse caso pode tentar usar uma IDE mais antiga, ou então pode procurar uma outra Biblioteca similar, mas que seja compatível com a sua IDE. 

Mas o problema mais frequente que percebo aqui no Lab de Garagem é a falta da biblioteca ou a instalação incorreta da mesma . 

Toda biblioteca tem que ter os aquivos com as extensões .H (header) , .CPP ( programa em C) e a pasta com exemplos

Para analisar as mensagens de erro na IDE, veja na janela inferior , os textos na cor laranja. Você pode colar e copiar as mensagens, se precisar de ajuda (Copie todas as mensagens). 

Nesse caso podem aparecer as seguintes mensagens :

error: 'XXXXX' was not declared in this scope

error XXXXX.h: No such file or directory

Nesse caso, reinstale a biblioteca e provavelmente o erro será corrigido. (siga os procedimentos desse tutorial) . 

Se a biblioteca esta corrompida, apague o diretório da mesma e reinstale-a novamente. 

Lembre-se que para as Bibliotecas poderem ser usadas, tem que dar um reboot na IDE !

Para conferir o diretório onde suas Bibliotecas são adicionadas, clique em Arquivos e Preferências :

Veja em Local do Sketchbook :

Comentário de José Gustavo Abreu Murta em 10 julho 2016 às 13:21

Instalação de Bibliotecas Arduino  zipadas:

Muitas vezes quando vamos usar um dispositivo ou módulo para Arduino, é necessário a instalação de um Biblioteca com os programas dedicados para o mesmo. 

A grande parte das Bibliotecas são disponibilizadas pelo fabricante ou desenvolvedor de um dispositivo para Arduino. Atualmente, estão usando o site GitHub para arquivar essas bibliotecas. 

A grande vantagem do GitHub é a padronização e a facilidade de acesso aos arquivos, aos fontes e aos exemplos. E tudo documentado. 

https://github.com/

Vou exemplificar a instalação de um biblioteca acessando o GitHub.  Por exemplo , se você deseja montar esse sensor DHT de temperatura e umidade, seguindo o tutorial da Adafruit, vai achar uma nova biblioteca para o mesmo. 

https://learn.adafruit.com/dht

Podem existir outras bibliotecas para esse mesmo tipo de sensor.

Mas esse é o  link da biblioteca Adafruit para o sensor DHT  :

https://github.com/adafruit/DHT-sensor-library

Para fazer o download de todos aquivos da Biblioteca, clique no campo Clone or Download

Baixe o arquivado zipado no seu computador - Download ZIP. 

Não precisa descompactar os arquivados zipados ! A própria IDE do Arduino já faz isso para a gente.

Abra a IDE do Arduino. Clique em Sketch, Incluir Biblioteca e depois Adicionar biblioteca.ZIP.

Quando aparecer a janela para selecionar o arquivo zipado, escolha a pasta onde fez o download e clique no arquivo da biblioteca. Assim que o arquivo zipado for instalado, feche e abra novamente a IDE do Arduino. 

Só assim , a biblioteca e os exemplos poderão ser acessados.  Para certificar que a Biblioteca foi instalada corretamente, clique em Sketch, Incluir Biblioteca e veja que agora aparece a opção na lista de Bibliotecas :

DHT sensor Library !

Comentário de José Gustavo Abreu Murta em 9 julho 2016 às 19:43

Esse é o meu objetivo, Moisés. 

Obrigado pelo elogio. Aguarde mais procedimentos.

Comentário de Moisés Guimarães Coelho Filho em 9 julho 2016 às 12:50

Muito esclarecedor seu tutorial pois trata do assunto de uma maneira objetiva e simples.

Moisés

Comentário de José Gustavo Abreu Murta em 8 julho 2016 às 21:32

Muito obrigado Marcelo pelo elogio. 

Sugiro que inclua nos links de tutoriais. 

Vou acrescentar tópicos com outras alternativas de instalação de bibliotecas; 

Abraços. 

Gustavo 

Comentário de Marcelo Rodrigues em 8 julho 2016 às 16:55

Gustavo,

Muito boa essa iniciativa. Realmente é uma dúvida recorrente.

Obrigado!

© 2024   Criado por Marcelo Rodrigues.   Ativado por

Badges  |  Relatar um incidente  |  Termos de serviço