Hvordan lage et tilpasset Arduino -bibliotek?

Å bygge prosjekter med Arduino krever ekstern maskinvare å integrere, og det meste av maskinvaren vi bruker med Arduino har biblioteker med seg som hjelper til med å kontrollere disse modulene uten å skrive en ny kode for dem. Se for deg å skrive en kode for å kontrollere en flytende krystall LCD -skjerm eller flytte en servomotor.

Det vil trenge en omfattende mengde arbeid før vi begynner å begynne med prosjektet vårt. Selv om det er et stort utvalg av open source-biblioteker tilgjengelig, må vi noen ganger skrive et tilpasset bibliotek, slik at denne guiden vil hjelpe deg med å skrive ditt aller første Arduino-bibliotek.

Hvordan lage Arduino Custom Library

Biblioteker er vanligvis skrevet på C/C ++ språk, så å skrive Arduino -biblioteker vi trenger litt god kunnskap om funksjoner og klasser. Biblioteker er en haug med .CPP -filer kombinert for å kjøre en enkelt maskinvare. Biblioteker gjør Arduino -programmering enklere og effektiv. Vi trenger ikke å skrive en ny kode hver gang vi bruker litt maskinvare. Biblioteker er en flott måte å dele koder som sparer mye tid og kostnader.

Siden Arduino er en åpen kildekode-plattform, har Arduino-samfunnet laget tusenvis av biblioteker. Men fortsatt er det et rom for nye bibliotek.

Før vi går videre, la oss ta en rask gjennomgang av den grunnleggende strukturen i Arduino -biblioteket.

Et bibliotek består vanligvis av:

• Overskriftsfil (.h): Dette inneholder bibliotekets definisjoner.
• Kildefil (.CPP): Dette inneholder bibliotekets kode.
• Nøkkelordfil (.tekst): Denne filen forklarer nøkkelord som brukes på biblioteket.
• Readme -fil (.tekst): Dette inneholder ekstra informasjon relatert til Arduino -biblioteket.
• Eksempler (INO): Eksempler hjelper brukere til å betjene biblioteket.

Alle disse filene hjelper brukere til å forstå og betjene biblioteker i Arduino.

De overskriftsfil (.h) og kildefil(.CPP) er de to nødvendige filene som trengs for å betjene et Arduino -bibliotek. Alle andre filer er et tillegg som gir brukerne noe nødvendig informasjon som hva dette biblioteket gjør eller hvem som er forfatteren av dette biblioteket.

Nå lager vi et nytt bibliotek .h og .CPP fil.

Trinn 1: Opprett en prøvekode

Trinn 2: Opprett bibliotekoverskrift og kildefil

Trinn 3: Legge til tilpasset bibliotek i Arduino IDE

Trinn 4: Ringer tilpasset bibliotek inne i en Arduino -kode

Trinn 1: Opprett en prøvekode

Jeg: Skriv en enkel kode i Arduino IDE -redaktøren som tar to tall og sum begge tall for å vise resultatet på seriemonitoren:

int sum (int a, int b)

returner A + B;

ugyldig oppsett ()

Serie.Begynn (9600);
int svar = sum (1,2);
Serie.println (svar);

void loop ()

Sett sammen koden ovenfor følgende utdata vises i utgangsvinduet. Utgangen vil skrive ut summen av to tall 1 og 2.

ii: Når koden er skrevet i IDE, lagre koden din ved å gå til Lagre som alternativ under Fil Meny:

Et nytt vindu åpnes, oppretter en ny mappe My_library og lagre Arduino -filen i mappen.

Når den nye bibliotekmappen er opprettet, vil du se en ny .ino fil der. Inne i denne filen vil vi ringe et tilpasset bibliotek og teste utdataene.

Trinn 2: Opprett bibliotekoverskrift og kildefil

Jeg: Lag nå to hovedfiler på biblioteket som er overskrifts- og kildefil. Å gjøre denne pressen “Ctrl+shif+n” eller klikk på ellipsisikonet på høyre side av IDE og klikk deretter Ny fane:

ii: Et nytt vindu åpnes her og skriver navnet på filer vi vil opprette. Type My_library.CPP og My_library.h For å opprette henholdsvis kilde- og overskriftsfil:

iii: Etter at de to nye filene blir opprettet, vil IDE -grensesnittet se slik ut. Neste trinn er å skrive kode for kilde- og toppfiler, slik at vi kan ringe vårt eget tilpassede bibliotek i hovedkodefilen.

Kode for overskriftsfil

Først oppretter vi en overskriftsfil for Arduino Custom Library. Skriv inn kode nedenfor inne i “.h ” fil.

#ifndef my_library_h
#Define my_library_h
#inkludere
int sum (int a, int b);
#slutt om

Dette er en generell syntaks for å skrive kode for Arduino -biblioteket vi starter med å definere headervakts navn og slutter med #slutt om uttalelse. Normalt, mens du skriver navnet på headervakten, er det bedre å skrive i store bokstaver og legge til “_H” På slutten av navnet.

Etter det er det nødvendig å legge til et Arduino -bibliotek da biblioteket kan kreve bruk av noen Arduino -funksjoner. I vårt hovedprogram normalt legges det til som standard, men å skrive et tilpasset bibliotek må vi inkludere det selv. Deretter opprettet vi en variabel "SUM" som vil bli kalt av kildefilen vår .CPP inne i en funksjon.

Kode for kildefil

Vår overskriftsfil er klar nå vil vi gå mot å lage kildekode (.CPP fil). Skriv nedenfor koden i kildefil:

#include "my_library.h "
int sum (int a, int b)

returner A + B;

Her i koden ovenfor startet vi med å ringe overskriftsfilen ved hjelp av #inkludere direktiv. Headerfil inneholder beskrivende kommentarer inkluderer filer som (#include), noen konstante definisjoner og klasser som inneholder forskjellige funksjoner og variabler som vi kaller i biblioteket vårt.

Trinn 3: Legge til tilpasset bibliotek i Arduino IDE

Når vi har opprettet et Arduino -bibliotek, er neste trinn å legge det til Arduino IDE, slik at vi kan ringe det inne i hvilken som helst kode. For å gjøre dette kopier mappen som inneholder bibliotekoverskriften og kildekoden, lim inn mappen i Arduino Library Directory. Arduino Directory Folder Path vil se slik ut: Dokumenter> Arduino> Biblioteker:

Når biblioteket er lagt til i Arduino IDE. Vi kan kalle det inne i hvilken som helst kode ved å gå til: Skisse> Inkluder bibliotek> my_library:

Åpne en tom Arduino -skisse og prøv å ringe biblioteket du nettopp opprettet koden vil se slik ut:

Vi har opprettet et bibliotek for å beregne summen av to heltall og kalt det inne i Arduino -koden.

Trinn 4: Ringer tilpasset bibliotek inne i en Arduino -kode

Ettersom Arduino -biblioteket vårt er fullført nå, vil vi skrive det samme ovenfor sumkoden ved å ringe vårt tilpassede bibliotek inn i det. Skriv inn følgende kode i IDE:

#include "my_library.h "
ugyldig oppsett ()

Serie.Begynn (9600);
int resultat = sum (1,2);
Serie.println (resultat);

void loop ()

I ovennevnte kode først inkluderte vi “My_library.h ” Så i oppsettdelen begynte vi seriell kommunikasjon. Neste resultatvariabel vil bli kalt, og summen av to tall vil bli skrevet ut på seriemonitoren ved å kalle resultatfunksjonen fra biblioteket .CPP fil. Mens du ringer til det tilpassede biblioteket inne i Arduino .ino Filen sørg for å bruke nøyaktig samme filnavn som du kalte overskriftsfilen.

Etter å ha samlet koden, skrives det samme resultatet som vår forrige kode. Bare her er koden mer optimalisert ved hjelp av et eget bibliotek.

Hvordan dele Arduino Custom Library

For å dele Arduino -biblioteket åpner først mappen der to hovedfiler med .CPP og .h Formatet lagres. Skissemappe kan være åpen ved å gå til: Skisse> Vis skisse mappe.

Et nytt vindu åpnes her der alle filene på biblioteket kan sees. For å dele biblioteker komprimerer først disse filene og deler dem ved hjelp av en zip -fil:

Konklusjon

Arduino har et bredt spekter av open source-biblioteker tilgjengelig, men noen ganger trenger vi et tilpasset bibliotek for å øke prosjektproduktiviteten vår eller for å optimalisere koden. Denne artikkelen dekker alle nødvendige trinn som er nødvendige for å skrive din egen bibliotekskode. Hovedsakelig er det nødvendig med to filer for et Arduino -bibliotek, kilde- og overskriftsfiler. Begge disse filene kan opprettes etter trinnene som er nevnt i denne guiden.