Como criar uma biblioteca Arduino personalizada?
Ele precisará de uma extensa quantidade de trabalho antes de começarmos a começar com nosso projeto. Embora exista uma grande variedade de bibliotecas de código aberto disponíveis, às vezes precisamos escrever uma biblioteca personalizada para que este guia o ajude a escrever sua primeira biblioteca Arduino.
Como criar Biblioteca Custom Arduino
As bibliotecas geralmente são escritas na linguagem C/C ++, para escrever bibliotecas Arduino, precisamos de um bom conhecimento de funções e classes. Bibliotecas são um monte de .Arquivos CPP combinados para executar um único hardware. Bibliotecas tornam a programação do Arduino mais fácil e eficiente. Não precisamos escrever um novo código toda vez que usamos algum hardware. As bibliotecas são uma ótima maneira de compartilhar códigos que economizam muito tempo e custo.
Como o Arduino é uma plataforma de código aberto, a comunidade Arduino criou milhares de bibliotecas. Mas ainda há um espaço para novas bibliotecas a serem escritas ou se você for transformar um projeto Arduino em um produto, é necessário escrever uma biblioteca separada para seu hardware.
Antes de avançarmos, vamos fazer uma revisão rápida da estrutura básica da Biblioteca Arduino.
Uma biblioteca normalmente consiste em:
- Arquivo de cabeçalho (.h): Isso contém as definições da biblioteca.
- Arquivo fonte (.cpp): Isso contém o código da biblioteca.
- Arquivo de palavra -chave (.TXT): Este arquivo explica palavras -chave usadas na biblioteca.
- Arquivo ReadMe (.TXT): Isso contém informações extras relacionadas à biblioteca Arduino.
- Exemplos (Ino): Exemplos ajudam os usuários a operar a biblioteca.
Todos esses arquivos ajudam os usuários a entender e operar bibliotecas em Arduino.
O arquivo de cabeçalho(.h) e arquivo fonte(.cpp) são os dois arquivos necessários para operar uma biblioteca Arduino. Todos os outros arquivos são um complemento que oferece aos usuários algumas informações necessárias, como o que esta biblioteca está fazendo ou quem é o escritor desta biblioteca.
Agora vamos criar uma nova biblioteca .h e .cpp arquivo.
Etapa 1: Crie um código de amostra
Etapa 2: Crie cabeçalho da biblioteca e arquivo de origem
Etapa 3: Adicionando biblioteca personalizada no Arduino IDE
Etapa 4: Chamando a biblioteca personalizada dentro de um código Arduino
Etapa 1: Crie um código de amostra
eu: Escreva um código simples no editor do Arduino IDE que levará dois números e soma ambos os números para mostrar o resultado no monitor serial:
int sum (int a, int b)retornar a + b;
configuração void ()
Serial.começar (9600);
int resposta = soma (1,2);
Serial.println (resposta);
void loop ()
Compilar o código acima seguinte a saída aparecerá na janela de saída. A saída imprimirá a soma de dois números 1 e 2.
ii: Depois que o código for escrito no IDE salve seu código, indo para Salvar como opção em Arquivo cardápio:
Uma nova janela abrirá, crie uma nova pasta MINHA BIBLIOTECA e salve o arquivo Arduino dentro dessa pasta.
Depois que a nova pasta da biblioteca for criada, você verá um novo .eu não arquivo lá. Dentro deste arquivo, chamaremos uma biblioteca personalizada e testaremos sua saída.
Etapa 2: Crie cabeçalho da biblioteca e arquivo de origem
eu: Agora crie dois arquivos principais da biblioteca que são cabeçalho e arquivo de origem. Para fazer isso “Ctrl+shif+n” ou clique no ícone Ellipsis no lado direito do IDE e clique Nova aba:
ii: Uma nova janela abrirá aqui e escreverá o nome dos arquivos que queremos criar. Tipo Minha biblioteca.cpp e Minha biblioteca.h Para criar o arquivo de origem e cabeçalho, respectivamente:
iii: Depois que os dois novos arquivos serão criados, a interface IDE ficará assim. O próximo passo é escrever código para arquivos de origem e cabeçalho para que possamos chamar nossa própria biblioteca personalizada no arquivo de código principal.
Código para arquivo de cabeçalho
Primeiro, criaremos um arquivo de cabeçalho para a Biblioteca Custom Arduino. Digite o código abaixo dentro do ““.h " arquivo.
#ifndef my_library_h#Define my_library_h
#incluir
int sum (int a, int b);
#fim se
Esta é uma sintaxe geral para escrever código para a biblioteca Arduino, começamos com a definição do nome do guarda de cabeçalho e termina com #fim se declaração. Normalmente, ao escrever o nome do guarda do cabeçalho, é melhor escrever em letras maiúsculas e adicionar "_H" No final do nome.
Depois disso, é necessário adicionar uma biblioteca Arduino, pois a biblioteca pode exigir o uso de algumas funções do Arduino. Em nosso programa principal normalmente, é adicionado por padrão, mas escrevendo uma biblioteca personalizada, devemos incluí -lo. Em seguida, criamos uma variável "SOMA" Isso será chamado pelo nosso arquivo de origem .cpp dentro de uma função.
Código para arquivo de origem
Nosso arquivo de cabeçalho está pronto agora, passaremos para criar o código -fonte (.cpp arquivo). Digite o código abaixo no arquivo de origem:
#include "my_library.h "int sum (int a, int b)
retornar a + b;
Aqui no código acima, começamos chamando o arquivo de cabeçalho usando #incluir diretivo. O arquivo de cabeçalho contém comentários descritivos incluem arquivos como (#include), algumas definições e classes constantes que contêm diferentes funções e variáveis que chamamos em nossa biblioteca.
Etapa 3: Adicionando biblioteca personalizada no Arduino IDE
Depois de criarmos uma biblioteca Arduino, a próxima etapa é adicioná -la ao Arduino IDE para que possamos chamá -lo dentro de qualquer código. Para fazer isso, copie a pasta que contém o cabeçalho da biblioteca e o código -fonte, cole essa pasta dentro do diretório da biblioteca Arduino. O caminho da pasta do diretório Arduino ficará assim: Documentos> Arduino> Bibliotecas:
Uma vez que a biblioteca é adicionada dentro do Arduino IDE. Podemos chamá -lo dentro de qualquer código indo para: Sketch> Incluir Biblioteca> My_library:
Abra um esboço em branco Arduino e tente ligar para a biblioteca que você acabou de criar o código será assim:
Criamos com sucesso uma biblioteca para calcular a soma de dois números inteiros e a chamamos dentro do Código Arduino.
Etapa 4: Chamando a biblioteca personalizada dentro de um código Arduino
Como nossa biblioteca Arduino está concluída agora, escreveremos o mesmo código da soma acima chamando nossa biblioteca personalizada para ela. Digite o seguinte código no IDE:
#include "my_library.h "configuração void ()
Serial.começar (9600);
int resultado = soma (1,2);
Serial.println (resultado);
void loop ()
No código acima primeiro nós incluímos "Minha biblioteca.h " Então, na parte de configuração, começamos a comunicação em série. Próxima variável de resultado será chamada e a soma de dois números será impressa no monitor serial chamando a função de resultado da biblioteca .cpp arquivo. Ao ligar para a biblioteca personalizada dentro do Arduino .eu não Arquivo Certifique -se de usar exatamente o mesmo nome de arquivo que você nomeou o arquivo de cabeçalho.
Depois de compilar o código, o mesmo resultado é impresso como o nosso código anterior. Apenas aqui o código é mais otimizado usando uma biblioteca separada.
Como compartilhar a Arduino Custom Library
Para compartilhar a biblioteca Arduino, abra a pasta pela primeira vez, onde dois arquivos principais com .cpp e .h formato são salvos. A pasta de esboço pode ser aberta indo para: Esboço> Mostrar pasta de esboço.
Uma nova janela será aberta aqui onde todos os arquivos da biblioteca podem ser vistos. Para compartilhar as bibliotecas primeiro compactar esses arquivos e compartilhá -los usando um arquivo zip:
Conclusão
O Arduino tem uma ampla gama de bibliotecas de código aberto disponíveis, mas às vezes precisamos de uma biblioteca personalizada para aumentar nossa produtividade do projeto ou otimizar o código. Este artigo abrange todas as etapas necessárias para escrever seu próprio código de biblioteca. Principalmente dois arquivos são necessários para uma biblioteca Arduino, arquivos de origem e cabeçalho. Ambos os arquivos podem ser criados seguindo as etapas mencionadas neste guia.