Come creare una libreria Arduino personalizzata?

Costruire progetti con Arduino richiede che hardware esterno per integrare e la maggior parte dell'hardware che utilizziamo con Arduino hanno librerie con loro che aiutano a controllare questi moduli senza scrivere un nuovo codice per loro. Immagina di scrivere un codice per il controllo di un display LCD in cristallo liquido o spostare un servo motore.

Avrà bisogno di un ampio lavoro prima di iniziare con il nostro progetto. Sebbene sia disponibile una vasta gamma di librerie open source, a volte dobbiamo scrivere una biblioteca personalizzata in modo che questa guida ti aiuterà a scrivere la tua prima libreria Arduino.

Come creare la libreria personalizzata Arduino

Le biblioteche sono generalmente scritte in lingua c/c ++ in modo che per scrivere le biblioteche Arduino abbiamo bisogno di una solida conoscenza delle funzioni e delle classi. Le biblioteche sono un mucchio di .File CPP combinati per eseguire un singolo hardware. Le biblioteche rendono la programmazione Arduino più semplice ed efficiente. Non dobbiamo scrivere un nuovo codice ogni volta che utilizziamo un po 'di hardware. Le biblioteche sono un ottimo modo per condividere codici che risparmiano molto tempo e costo.

Dato che Arduino è una piattaforma open source, la comunità Arduino ha creato migliaia di biblioteche. Ma c'è ancora una stanza per scrivere nuove librerie o se hai intenzione di trasformare un progetto Arduino in un prodotto, potrebbe essere necessario scrivere una libreria separata per il suo hardware.

Prima di andare avanti, prendiamo una rapida revisione della struttura di base della Biblioteca Arduino.

Una biblioteca in genere è composta da:

• File di intestazione (.H): Questo contiene le definizioni della libreria.
• File sorgente (.CPP): Questo contiene il codice della libreria.
• File di parole chiave (.TXT): Questo file spiega le parole chiave utilizzate nella libreria.
• File README (.TXT): Questo contiene informazioni extra relative alla libreria Arduino.
• Esempi (ino): Esempi aiutano gli utenti a gestire la libreria.

Tutti questi file aiutano gli utenti a comprendere e gestire librerie in Arduino.

IL File di intestazione (.H) E file sorgente(.CPP) sono i due file necessari per gestire una libreria Arduino. Tutti gli altri file sono un componente aggiuntivo che forniscono agli utenti alcune informazioni necessarie come quello che sta facendo questa libreria o chi è lo scrittore di questa libreria.

Ora creeremo una nuova libreria .H E .CPP file.

Passaggio 1: creare un codice di esempio

Passaggio 2: creare intestazione della libreria e file di origine

Passaggio 3: aggiunta della libreria personalizzata in Arduino IDE

Passaggio 4: Chiamare la libreria personalizzata all'interno di un codice Arduino

Passaggio 1: creare un codice di esempio

io: Scrivi un semplice codice nell'editor IDE Arduino che richiederà due numeri e sommerrà entrambi i numeri per mostrare il risultato sul monitor seriale:

int Sum (int a, int b)

restituire a + b;

void setup ()

Seriale.Inizia (9600);
int risposta = somma (1,2);
Seriale.println (risposta);

void loop ()

Compilare il codice sopra seguente verrà visualizzato l'output nella finestra di output. L'output stamperà la somma di due numeri 1 e 2.

ii: Una volta che il codice è stato scritto in IDE salva il tuo codice andando a Salva come opzione sotto il File menù:

Si aprirà una nuova finestra, creerà una nuova cartella LA MIA BIBLIOTECA e salva il file Arduino all'interno di quella cartella.

Una volta creata la nuova cartella della libreria, vedrai un nuovo .io no file lì. All'interno di questo file chiameremo una libreria personalizzata e testeremo il suo output.

Passaggio 2: creare intestazione della libreria e file di origine

io: Ora crea due file principali della libreria che sono file di intestazione e sorgente. Per fare questa stampa "Ctrl+Shif+N" Oppure fai clic sull'icona Ellipsis sul lato destro dell'IDE, quindi fai clic su Nuova scheda:

ii: Una nuova finestra si aprirà qui e scriverà il nome dei file che vogliamo creare. Tipo La mia biblioteca.CPP E La mia biblioteca.H Per creare rispettivamente file di origine e di intestazione:

III: Dopo che i due nuovi file verranno creati, l'interfaccia IDE sembrerà così. Il prossimo passo è scrivere il codice per i file di origine e di intestazione in modo da poter chiamare la nostra libreria personalizzata nel file del codice principale.

Codice per file di intestazione

Innanzitutto, creeremo un file di intestazione per la libreria personalizzata Arduino. Digitare il codice sotto all'interno del file ".H" file.

#ifndef my_library_h
#define my_library_h
#includere
int Sum (int a, int b);
#finisci se

Questa è una sintassi generale per la scrittura di codice per la libreria Arduino, iniziamo con la definizione del nome della guardia dell'intestazione e termina con #finisci se dichiarazione. Normalmente, mentre scrivi il nome della guardia dell'intestazione, è meglio scrivere nelle lettere maiuscole e aggiungere "_H" Alla fine del nome.

Dopodiché è necessario aggiungere una libreria Arduino poiché la libreria potrebbe richiedere l'uso di alcune funzioni di Arduino. Nel nostro programma principale normalmente, viene aggiunto per impostazione predefinita, ma scrivendo una biblioteca personalizzata dobbiamo includerla noi stessi. Successivamente, abbiamo creato una variabile "SOMMA" che sarà chiamato dal nostro file di origine .CPP all'interno di una funzione.

Codice per il file di origine

Il nostro file di intestazione è pronto ora ci sposteremo verso la creazione di codice sorgente (.CPP file). Digitare il codice sotto nel file di origine:

#include "my_library.H"
int Sum (int a, int b)

restituire a + b;

Qui nel codice sopra, abbiamo iniziato chiamando il file di intestazione utilizzando #includere direttiva. Il file di intestazione contiene commenti descrittivi includono file come (#include), alcune definizioni e classi costanti che contengono funzioni e variabili diverse che chiamiamo nella nostra libreria.

Passaggio 3: aggiunta della libreria personalizzata in Arduino IDE

Una volta che abbiamo creato una libreria Arduino, il prossimo passo è aggiungerla all'IDE Arduino in modo da poterlo chiamare all'interno di qualsiasi codice. Per fare questo copia la cartella che contiene l'intestazione della libreria e il codice sorgente, incolla quella cartella all'interno della directory della libreria Arduino. Il percorso della cartella della directory Arduino sarà simile a questo: Documenti> Arduino> Biblioteche:

Una volta aggiunta la libreria all'interno dell'IDE Arduino. Possiamo chiamarlo all'interno di qualsiasi codice andando a: Sketch> Includi libreria> my_library:

Apri uno schizzo Arduino vuoto e prova a chiamare la libreria che hai appena creato il codice sarà così:

Abbiamo creato con successo una libreria per calcolare la somma di due numeri interi e averla chiamata all'interno del codice Arduino.

Passaggio 4: Chiamare la libreria personalizzata all'interno di un codice Arduino

Poiché la nostra libreria Arduino è completata ora, scriveremo lo stesso codice di somma sopra chiamando la nostra libreria personalizzata. Digita il seguente codice in IDE:

#include "my_library.H"
void setup ()

Seriale.Inizia (9600);
int risultato = somma (1,2);
Seriale.println (risultato);

void loop ()

Nel codice sopra prima che abbiamo incluso "La mia biblioteca.H" Quindi nella parte di configurazione abbiamo iniziato la comunicazione seriale. Verrà chiamata la variabile del risultato successivo e la somma di due numeri verrà stampata sul monitor seriale chiamando la funzione di risultato dalla libreria .CPP file. Mentre chiama la libreria personalizzata all'interno dell'Arduino .io no File Assicurati di utilizzare lo stesso nome del file che hai chiamato il file di intestazione.

Dopo aver compilato il codice, lo stesso risultato viene stampato come il nostro codice precedente. Proprio qui il codice è più ottimizzato utilizzando una libreria separata.

Come condividere la biblioteca personalizzata Arduino

Per condividere la libreria Arduino prima aprire la cartella in cui due file principali .CPP E .H Il formato viene salvato. La cartella di schizzo può essere aperta andando a: Schizzo> Mostra la cartella Sketch.

Una nuova finestra si aprirà qui dove si possono vedere tutti i file della libreria. Per condividere le librerie prima comprimere questi file e condividerli utilizzando un file zip:

Conclusione

Arduino ha una vasta gamma di librerie open source disponibili, ma a volte abbiamo bisogno di una libreria personalizzata per aumentare la produttività del nostro progetto o per ottimizzare il codice. Questo articolo copre tutti i passaggi necessari per scrivere il tuo codice di libreria. Principalmente sono necessari due file per una libreria Arduino, sorgente e file di intestazione. Entrambi questi file possono essere creati seguendo i passaggi menzionati in questa guida.