Att bli bekväm med programvara Arduino, med hjälp av inbyggda funktioner, kan du utöka funktionerna i din Arduino med hjälp av ytterligare bibliotek.
Ett bibliotek är en uppsättning kod som gör det enklare att ansluta en sensor, skärm, skärm och så vidare. Till exempel inbyggt bibliotek Flytande kristall gör det lättare att interagera med. Du kan hitta hundratals olika på Internet ytterligare bibliotek. För att kunna använda dessa bibliotek måste du först installera dem.
Vi använder Bibliotekschef
För att installera ett nytt bibliotek i Arduino IDE , du kan använda Bibliotekschef, som dök upp i .
Från Skiss-menyn, välj Inkludera bibliotek → Hantera bibliotek...
Efter detta öppnas bibliotekshanteraren och du kommer att se en lista över bibliotek som redan är installerade eller redo att installeras. Redan installerade bibliotek är markerade som INSTALLERAD.
I det här exemplet kommer vi att installera biblioteket Encoder. Hitta den i listan och välj den version du vill installera. Vissa bibliotek har bara en version tillgänglig för dig, så oroa dig inte om du inte ser en valmeny för biblioteksversion.
Efter detta kommer en indikator för installationsprocessen att visas och, efter avslutad, status för biblioteket Encoder kommer att ändras till INSTALLERAD. Nu kommer detta bibliotek att bli tillgängligt för att lägga till i våra program med hjälp av menyn Skiss → Inkludera bibliotek.
Importera ett bibliotek som en fil .blixtlås
Bibliotek kan ofta hittas förpackade i blixtlås-arkivmapp. Namnet på den här mappen är namnet på biblioteket. Det kommer definitivt att finnas en fil i mappen .cpp och rubrik .h fil. Du kan också ofta hitta filen nyckelord.txt, en mapp med kod för exempel på användning av detta bibliotek och andra filer som krävs för detta bibliotek.
Efter att ha laddat ner biblioteket i formuläret blixtlås-arkivera det behövs inte packa upp. För att installera det zippade biblioteket, använd menyn Skiss → Inkludera bibliotek → Lägg till .ZIP-bibliotek.
Efter detta måste du ange sökvägen till blixtlås- biblioteksfil. Detta blixtlås-filen kommer att packas upp och placeras i en mapp bibliotek till katalogen med skisser Arduino.
Det bör noteras att efter installationen blir biblioteket tillgängligt via menyn Skiss → Inkludera bibliotek, men för att exempelfilerna i detta bibliotek ska bli tillgängliga med hjälp av menyn Arkiv → Samples måste du starta om Arduino IDE.
Manuell biblioteksinstallation
För manuell installation bibliotek, först och främst måste du stänga programmet Arduino IDE. Extrahera sedan den nedladdade zip-filen. Vi vill till exempel installera ett hypotetiskt bibliotek Robotosha Arduino. Packar upp filen RobotoshaArduino.zip, vi måste hämta mappen Robotosha Arduino med filer som RobotoshaArduino.cpp Och RobotoshaArduino.h inuti. Om vi efter uppackning tar emot filer utan en mapp måste vi skapa en mapp manuellt Robotosha Arduino, placera de resulterande biblioteksfilerna inuti.
Efter detta måste du flytta den här mappen till mappen bibliotek, vars placering beror på typen av operativ system.
För Windows är standard:
Mina dokument\Arduino\bibliotek
För användare Mac OS X:
~/Dokument/Arduino/bibliotek
I Linux detta blir en mapp bibliotek med dina skisser.
Det är mycket viktigt att biblioteksfiler .cpp Och .h fanns i en separat mapp (som i exemplet Robotosha Arduino). Om du placerar filerna .cpp Och .h bara i en mapp bibliotek, då fungerar inte biblioteket.
Efter omstart Arduino IDE det tillagda biblioteket blir tillgängligt för att ansluta det till dina program via menyn Skiss → Inkludera bibliotek.
Hur betygsätter du denna publikation?
Många skisser (program) fungerar med bibliotek. Biblioteket gör det lättare att arbeta med en specifik modul eller en av modulerna. Till exempel om du vill mata ut text till LCD skärm utan att ansluta biblioteket måste du överföra flera byte med kommandon och data till det, vilket kommer att ta flera rader kod, och viktigast av allt, du behöver veta vilken typ av mikrokontroller under vilken LCD-skärmen fungerar, syftet med kommandon som den styrs av, känner till arkitekturen för dess minne, adresser och syften med register, för vilka du måste hitta och läsa dess datablad igen. När du skriver kod med hjälp av ett bibliotek (till exempel LiquidCrystal_I2C.h), kan du visa text genom att bara anropa en biblioteksfunktion: lcd.print("min text");
Innan du börjar använda bibliotekets metoder och funktioner måste du ladda ner (ladda ner till din dator), Installera (lägg i önskad mapp) och att plugga (infoga texten "#inkludera<файл.h>" i skissen).
Ladda ner biblioteket:
Om ett bibliotek används i våra lektioner, beskrivningar eller exempel tillhandahåller vi en länk för att ladda ner detta bibliotek. Alla våra bibliotek finns i ett zip-arkiv, men skynda dig inte att hämta filer från arkivet, detta kanske inte är nödvändigt, eftersom... Arduino IDE kan själv packa upp arkiv och placera bibliotek i nödvändiga mappar(se vidare).
Om du laddade ner biblioteksarkivet från webbplatsen utan att ange sökvägen för att spara filen, så finns den nedladdade (uppladdade) filen troligen i mappen: Den här datorn > Nedladdningar.
Biblioteksinstallation:
När du har laddat ner (laddat upp) biblioteket till din dator måste du installera det. Du kan installera biblioteket manuellt eller göra det med Arduino IDE:
Installera biblioteket med Arduino IDE:
Gå in i menyn: Skiss > Anslut biblioteket > Lägg till .ZIP-bibliotek... .
I fönstret som visas klickar du på " Den här datorn " och välj mappen " Nedladdningar " Om vid nedladdning ZIP-arkiv och från webbplatsen angav du sökvägen för att spara filen, och ange sedan sökvägen till filen istället för mappen "Nedladdningar".
Välj Zip fil biblioteket du laddade ner. Filnamnet kanske inte matchar biblioteksnamnet. Klicka sedan på " Öppen » ( Öppen ).
Vid denna tidpunkt är installationen av biblioteket klar, du kan börja ansluta det till skissen.
Installera biblioteket manuellt:
Packa upp det du laddade ner ZIP-arkiv och placera mappen (mappnamnet är vanligtvis detsamma som biblioteksnamnet) från av detta arkiv till mapp: Den här datorn > Dokumentation > Arduino > bibliotek .
Om Arduino IDE kördes (öppen) under kopieringen, måste du stänga alla fönster i det här programmet, sedan starta (öppna) Arduino IDE och du kan börja ansluta biblioteket till skissen.
Obs: mapp bibliotek det finns inte bara vägen som anges ovan, utan också i Arduino IDE-programmappen (var är arduino-filen .exe). Genom att kopiera biblioteket till den här mappen kommer det också att installeras, men vi rekommenderar inte att du gör detta. Faktum är att Arduino IDE-programmet ständigt utvecklas och antalet versioner växer hela tiden. Om du vill installera ny version Arduino IDE, då kommer biblioteken som finns i mappen Den här datorn > Dokument > Arduino > bibliotek att vara tillgängliga i både den gamla och nya (installerade) versionen av Arduino IDE, och biblioteken som finns i mappen bibliotek Arduino IDE-program gammal version(som installerades tidigare) kommer endast att vara tillgänglig i den (tills du kopierar dem till den nya).
Ansluta biblioteket:
För att inkludera biblioteket behöver du bara skriva en rad i början av skissen: "#inkludera<файл.h>", Till exempel:
#omfatta
Vissa bibliotek arbetar med metoderna och funktionerna i andra bibliotek, sedan måste du koppla ihop två bibliotek, först koppla ihop det vars metoder och funktioner det andra använder, till exempel:
#omfatta
För att arbeta med de flesta bibliotek måste du skapa ett objekt (en instans av biblioteksklassen) genom vilket deras funktioner och metoder kommer att vara tillgängliga, till exempel:
LiquidCrystal_I2C lcd(0x27,20,4); // lcd är ett objekt i LiquidCrystal_I2C-biblioteket // bibliotekets funktioner och metoder nås via objektet
Istället för lcd kan du skriva vilket ord eller kombination av bokstäver och siffror som helst. Detta är namnet på objektet genom vilket du kan komma åt metoderna och funktionerna i biblioteket. Om du istället för lcd skrev myLCD, måste alla metoder och funktioner i LiquidCrystal_I2C-biblioteket nås via det objektnamn du angav, till exempel: myLCD.print("min text");
Exempel från bibliotek:
De flesta bibliotek innehåller exempel. Det är små skisser (program) som avslöjar bibliotekets funktionalitet. Mest bekväm väg titta på exempel med hjälp av Arduino verktyg ID. Välj menyalternativ: Fil > Exempel , öppnas en lista med namnen på bibliotek som har exempel. Håll muspekaren över bibliotekets namn och du kommer att se en lista med exempel som finns i den, klicka på ett exempel kommer att leda till att ett nytt Arduino IDE-fönster med en exempelskiss visas.
Alternativt sätt att visa exempel är att köra skissfiler från mappen:
väg
> bibliotek
> bibliotekets namn
> exempel
> exempelnamn
.
Sök efter bibliotek:
Du kan söka efter bibliotek själv, eller så kan du använda funktionerna i Arduino IDE.
Välj menyalternativ: Skiss > Anslut biblioteket > Hantera bibliotek... .
" Bibliotekschef ", där du kan hitta biblioteket du är intresserad av genom att ange dess namn i sökfältet; du kan dessutom ställa in objekten "Typ" och "Ämne".
Om du klickar på biblioteksbeskrivningen visas " Version "och knappar" Installation " Efter att ha klickat på "Installera"-knappen kan du börja inkludera biblioteket i skissen "#inkludera<файл.h>".
Bibliotek för Arduino är bekvämt verktyg att distribuera koden. Dessa kan till exempel vara hårdvarudrivrutiner eller ofta använda funktioner.
Den här guiden beskriver i detalj hur du installerar bibliotek på din dator.
Det finns två huvudtyper av Arduino-bibliotek: standard och extra.
Standardbibliotek
Arduino IDE har en uppsättning standardbibliotek som används väldigt ofta. Dessa bibliotek stöder alla exempel som ingår i Arduino IDE. Standardbibliotek stödjer funktioner för att arbeta med den vanligaste kringutrustningen, till exempel: servomotorer eller LCD-skärmar.
Standardbibliotek installeras i mappen "Bibliotek" när installera Arduino ID. Om du har flera versioner av IDE installerad kommer varje version att ha sin egen uppsättning bibliotek. Det rekommenderas starkt att inte ändra standardbibliotek och installera ytterligare sådana i samma mapp.
Ytterligare bibliotek
Internet innehåller ett stort antal ytterligare bibliotek med bekväm funktionalitet och drivrutiner för olika kringutrustning. Biblioteken läggs huvudsakligen ut på Arduino Playground, Github och Google Code. Skrivandet av bibliotek för Arduino görs ofta av tillverkare av sensorer, givare, tryckta kretskort och så vidare. Till exempel erbjuder Adafruit mer än 100 bibliotek som stöder alla modeller av Arduino-brädor.
Installera ytterligare bibliotek i mappen Bibliotek. Tack vare detta kan de användas i alla versioner av Arduino IDE. Efter att ha uppdaterat versionen behöver du inte installera om dem!
Var man installerar bibliotek
Det är viktigt att installera biblioteken i rätt mapp. Annars kommer kompilatorn inte att kunna hitta dem när du kompilerar och laddar din kod.
Mappen där allt finns lagrat Arduino skisser, skapas automatiskt när du installerar IDE.
På Linux-mapp kallas "Scetchbook" och finns vanligtvis i /home/<username>
På Windows och Macintosh heter mappen "Arduino" och finns i mappen Dokument.
Observera att detta är viktigt! I mappen "Mina dokument" skapas en annan mapp som heter "Arduino" automatiskt!
Ytterligare bibliotek bör finnas i mappen "Libraries", som finns i "Scetchbook" eller "Arduino". Det är här IDE kommer att leta efter ytterligare installerade bibliotek.
Från Arduino IDE 1.0.2 och senare skapas mappen "Libraries" automatiskt. På tidigare versioner måste det skapas innan du installerar ditt första bibliotek.
Öppna menyn och välj "Arkiv->Inställningar" i Arduino IDE.
>Hitta platsen för dina skisser. Detta är vanligtvis "Arduino"-mappen i din "Mina dokument"-mapp.
När du har bestämt sökvägen, navigera till den mappen med File Explorer.
Om mappen Bibliotek inte finns skapar du en ny mapp.
Byt namn på det till "Bibliotek".
Installera bibliotek på Windows
För att installera biblioteket på Windows, följ instruktionerna nedan.
Stäng Arduino IDE
Se till att Arduino IDE är stängd, eftersom bibliotek endast skannas när IDE är laddad. Nytt bibliotek kommer inte att fungera förrän du startar om IDE.
Ladda ner zip-filen från Github.
Kopiera den uppackade mappen
Klistra in den i din biblioteksmapp.
Ge henne ett korrekt namn. Arduino IDE känner inte igen mappar med ett streck i namnet. Så du måste byta namn på mappen. Du kan använda under streck.
Starta om Arduino IDE och kontrollera om biblioteket visas i menyalternativet Arkiv->Exempel.
För att kontrollera, ladda ner ett av exemplen.
Innan du laddar upp exemplet till tavlan, kontrollera skissen.
Installera bibliotek på Mac OSX
För korrekt installation ytterligare bibliotek på Mac OSX, följ instruktionerna nedan
Stäng Arduino IDE.
Ladda ner arkivet med biblioteket från Github.
Hitta det nedladdade arkivet i nedladdningsmappen på din Mac.
Packa upp och kopiera biblioteket till biblioteksmappen som skapades när du installerade Arduino IDE.
Ge biblioteket ett giltigt namn. Som är fallet med Windows är mappar med bindestreck inte läsbara.
Starta om Arduino IDE. Biblioteket bör visas i Arkiv->Exempel-menyn.
Ladda ner ett av exemplen.
Kontrollera att skissen är korrekt innan du laddar upp den till din Arduino.
Installera bibliotek på Linux
För att installera anpassade bibliotek på Linux, följ instruktionerna nedan.
Återigen, stäng Ardino IDE.
Ladda ner arkivet med det bibliotek vi behöver.
Vi sparar arkivet till HDD vår PC.
Hitta det nedladdade arkivet i nedladdningsmappen.
Packa upp biblioteket och kopiera det till mappen Sketchbook/Libraries.
Ge mappen rätt namn. Inget streck!
Starta om Arduino IDE och kontrollera om biblioteket visas i menymappen Arkiv->Exempel.
Låt oss ladda ner ett av exemplen.
Vi kontrollerar om exempelfilen kompileras utan fel.
Vanliga misstag vid installation av bibliotek för Arduino
"xxxx" gör det inte namn en typ
Detta är det vanligaste misstaget när man arbetar med externa bibliotek. Anledningen är att kompilatorn inte kan hitta biblioteket. Möjliga skäl detta fel inträffar:
- Biblioteket är inte installerat (se installationsinstruktioner ovan).
- Mappplatsen är felaktig.
- Fel namn mappar.
- Ogiltigt biblioteksnamn.
- Du glömde att starta om Arduino IDE.
Nedan finns lösningar på möjliga problem
Felaktig mappplats
IDE hittar bara standardbibliotek och ytterligare sådana som är installerade i mappen "Libraries". Bibliotek som finns på andra platser kommer inte att initieras
Biblioteksmappen ska finnas i roten av mappen "Libraries". Om du skapar en ytterligare undermapp kommer IDE inte att upptäcka biblioteket.
Obs: i vissa onlineförråd publiceras bibliotek med ytterligare nivå mappkapsling. Kontrollera detta ögonblick. Biblioteksfilerna måste finnas i den första mappen, utan ytterligare undermappar.
Inte ett komplett bibliotek
Du bör inte byta namn på filer i biblioteket med stora bokstäver, streck osv.
Felaktigt mappnamn
IDE:n upptäcker inte mappar med vissa tecken i namnet. Tyvärr stöder IDE inte bindestreck, som genereras i filnamn på Github. Därför, efter att ha laddat ner arkivet, byt namn på mappen. Det nya namnet får inte innehålla ett bindestreck. Du kan helt enkelt byta ut alla tecken ('-') med ('_').
Ogiltigt biblioteksnamn
Namnet du anger i #include-direktivet i din skiss måste exakt matcha namnet på klassen i biblioteket (skiftlägeskänsligt!). Om namnet inte matchar kommer IDE inte att ansluta nödvändiga funktioner, klasser osv. I exemplen som följer med biblioteken är namnen korrekta. Så för att undvika oavsiktliga fel kan du helt enkelt kopiera och klistra in dem i din kod.
Flera biblioteksversioner
Om du har flera versioner av biblioteket kommer Arduino IDE att försöka ladda alla samtidigt. Som ett resultat kan ett kompileringsfel uppstå. Så gamla eller icke-fungerande versioner måste tas bort eller flyttas från bibliotekskatalogen.
Beroende bibliotek
Vissa bibliotek är beroende av andra bibliotek. Till exempel är de flesta Adafruit Graphic Display Libraries beroende av Adafruit GFX Library. Det vill säga, för att använda det första biblioteket måste du ha det andra installerat.
"Grundläggande" bibliotek
Vissa bibliotek kan inte användas direkt. Bra exempel, GFX bibliotek. Detta bibliotek driver de flesta skärmar från Adafruit, men kan inte användas utan ett drivrutinsbibliotek för den skärmen.
Glömde stänga Arduino IDE
Glöm inte att IDE letar efter bibliotek när den laddas. Innan du använder det nyinstallerade biblioteket måste Arduino IDE startas om.
Lämna dina kommentarer, frågor och dela personlig erfarenhet Nedan. Nya idéer och projekt föds ofta i diskussioner!
Biblioteket innehåller redan det mesta av koden som du inte behöver skriva, biblioteket gör det lättare att arbeta med en specifik modul eller en av deras typer och du behöver bara inkludera den i din skiss.
Till exempel, om du vill visa text på en LCD-skärm utan att ansluta ett bibliotek, måste du skicka det flera byte med kommandon och data, vilket kommer att ta flera rader kod, och viktigast av allt måste du veta vilken typ av mikrokontroller under vilken LCD-skärmen fungerar, syftet med kommandona den styrs, känner till arkitekturen för dess minne, adresser och syftet med register, för vilka du måste hitta och läsa dess datablad igen.
När du skriver kod med hjälp av ett bibliotek (till exempel LiquidCrystal_I2C.h), kan du visa text genom att bara anropa en biblioteksfunktion:
Lcd.print(“min text”);
Du kan ansluta vilket bibliotek som helst med följande kommando:
"#omfatta<файл.h>"<файл.h>– Det här är själva biblioteket som vi kopplar samman.
Du kan också se ett exempel på anslutning av biblioteket
Innan du börjar använda metoderna och funktionerna i biblioteket måste du:
- ladda ner (ladda ner till din dator),
- Installera (lägg i önskad mapp),
- att plugga (infoga texten "#inkludera<файл.h>” in i skissen).
Varje bibliotek måste innehålla 2 filer med tillägg .h Och .cpp.
Den första typen av filer innehåller:
- klassbeskrivning,
- konstanter,
- variabler.
Den andra typen innehåller metodkoder.
Dessutom måste du förstå dessa filer .h Och .cpp kanske inte finns i roten av det nedladdade arkivet. I huvudfilerna ingår också "keywords.txt" och en mapp med exempel.
Hur installerar man biblioteket?
När du har laddat ner (laddat upp) biblioteket till din dator måste du installera det. Du kan installera biblioteket manuellt eller göra det med Arduino IDE:
Installera biblioteket med Arduino IDE
Vi kommer att göra detta via menyn. Gå till menyn:
Skiss - Anslut biblioteket – Lägg till .ZIP-bibliotek
I fönstret som visas klickar du på ikonen "Den här datorn" och väljer mappen "Nedladdningar". Om du, när du laddade ner ett ZIP-arkiv från webbplatsen, angav sökvägen för att spara filen, ange istället för mappen "Nedladdningar" sökvägen till filen.
Välj bibliotekets ZIP-fil du laddade ner. Filnamnet kanske inte matchar biblioteksnamnet. Klicka sedan på " Öppen » ( Öppen ).
Vid denna tidpunkt är installationen av biblioteket klar, du kan börja ansluta det till skissen.
Viktig! Efter installation av Arduino IDE på datorn skapas den separat mapp att lagra alla bibliotek. För Linux OS "Scetchbook", som finns i /home/. För Windows OS finns mappen "Arduino" i /Mina dokument/.
Installera biblioteket manuellt
Packa upp ZIP-arkivet du laddade ner och placera mappen (mappnamnet matchar vanligtvis namnet på biblioteket) från detta arkiv i mappen:
Den här datorn → Dokumentation → Arduino → bibliotek
Om Arduino IDE kördes (öppen) under kopieringen, måste du stänga alla fönster i det här programmet, sedan starta (öppna) Arduino IDE och du kan börja ansluta biblioteket till skissen.
Faktum är att programmet ständigt utvecklas och antalet versioner växer hela tiden. Om du vill installera en ny version av Arduino IDE, finns biblioteken i mappen ( Den här datorn → Dokument → Arduino → bibliotek) kommer att finnas tillgängliga i både den gamla och nya (installerade) versionen av Arduino IDE, och biblioteken som finns i mappen bibliotek Arduino IDE-program av den gamla versionen (som installerades tidigare) kommer bara att vara tillgängliga i den (tills du kopierar dem till den nya).
Var kan jag hitta det bibliotek jag behöver?
För enkelhetens skull finns det ett helt avsnitt på vår webbplats som heter -. De flesta bibliotek kan hittas på Internet i allmänhetens egendom.
Också ett nummer standarduppsättningar kan hittas på den officiella Arduino-webbplatsen: arduino.cc.
Vilka bibliotek är redan installerade?
Som vi redan diskuterat - IDE själv kommer redan med några.
Det finns två sätt att visa installerade bibliotek.
Metod 1
För att se vilken uppsättning som redan är installerad, gå till fliken:
Metod 2
Det andra sättet är att använda "Sketch"-menyn och "Connect Library" undermenyn. På så sätt kan du också se listan över bibliotek.
Gå till Sketch och välj Inkludera bibliotek:
Skiss → Inkludera bibliotek
Möjliga misstag
Ibland, när du installerar bibliotek eller när du använder dem, kan vissa fel uppstå. Nedan kommer vi att titta på de viktigaste.
"xxxx" namnger inte en typ
Felet visas när biblioteket inte är installerat ännu.
Felet uppstår även om mappen eller biblioteket har fel namn.
Mappplatsens adress kan vara felaktig eller så kanske Arduino IDE inte har startats om!
Felaktig mappplats
Kontrollera om alla bibliotek är inne till rätt adress. Vi angav mappadresser för olika operativsystem ovan.
Ogiltigt biblioteksnamn
Felet visas när namnet efter #include-taggen inte matchar biblioteksnamnet.
Ofullständigt bibliotek
Alla nödvändiga filer och mappar saknas.
Biblioteksberoenden
Det är nödvändigt att ansluta ytterligare beroende bibliotek utan vilka korrekt/korrekt drift är omöjlig.
Att installera och ansluta ett bibliotek till arduino är en ganska vanlig operation förr eller senare kommer alla utvecklare oundvikligen att stöta på det. Extern plug-in-kod på alla programmeringsspråk används för att spara tid. Arduino är inget undantag: många sensorer, moduler, skärmar och motorer kräver ganska mycket komplexa kretsar interaktioner som är svåra att implementera i din kod. Det är mycket enklare och snabbare att ladda ner det nödvändiga biblioteket, snabbt ansluta det manuellt eller använda Arduino IDE och sedan använda det i alla dina skisser. I den här artikeln hittar du korta instruktioner om att ansluta och använda bibliotek.
Biblioteket i Arduino är programkod i externa filer, som kan installeras och kopplas till din skiss. Bibliotekets butiker olika metoder och datastrukturer som behövs för att förenkla arbetet med sensorer, indikatorer, moduler och andra komponenter. Att använda bibliotek förenklar arbetet med projekt avsevärt eftersom du kan fokusera på programmets huvudlogik utan att slösa tid på en massa småsaker. Idag läggs ett stort antal bibliotek ut på Internet, där de enkelt kan laddas ner och helt gratis. finns på vår hemsida.
Ur synvinkel filsystem Ett bibliotek är en katalog som innehåller specifika mappar. Under sammanställning och montering Arduino-projekt IDE inkluderar automatiskt i din kod de klasser, datastrukturer och metoder från bibliotek som ingår och används i skissen. Det enda vi behöver göra är alltså att lägga in lämpliga instruktioner i vår kod, efter att ha säkerställt det erforderligt bibliotek installerat.
Hur man tar reda på listan över anslutna bibliotek till Arduino IDE
Varje installerat bibliotek innehåller ett eller flera exempel att arbeta med. De används för att visa funktionerna hos enheten som är ansluten till Arduino. Därför mest på ett snabbt sätt få en lista över alla installerade bibliotek Arduino - använd listan med exempel i Arduino IDE. För att göra detta, välj Arkiv från huvudmenyn och öppna sedan undermenyn Exempel.
Ett annat sätt är att använda Sketch-menyn och undermenyn – Inkludera bibliotek. Där kan du också se en lista över bibliotek:
Ansluter header h-filen med #include-operatorn
För att börja använda biblioteket måste du inkludera h-huvudfilen i början av programmet omfatta direktiv. Till exempel kommer LiquidCrystal.h-biblioteket att se ut så här: #include
Du kan se fullständigt exempel använder själva biblioteket.
Nödvändiga filer i biblioteket
Varje bibliotek måste innehålla minst 2 filer - en rubrikfil med filändelsen .h och en fil med källkod med tillägget .cpp. Rubrikfilen innehåller klassbeskrivningen, konstanter och variabler. Den andra filen innehåller metodkoder. Förutom de två huvudfilerna kan den innehålla textdokument keywords.txt och exempelmappen med koder för exempel på användning av biblioteket. h- och cpp-filerna finns inte nödvändigtvis i roten
Det går inte att redigera filer i Arduino IDE. Alla ändringar kan göras i vilken som helst textredigerare, eller utvecklingsmiljön C++. Detta beror på det faktum att vi i Arduino IDE inte arbetar med cpp-filer, kodredigeraren är inte designad för "ren" C, den fungerar bara med Arduino-språket.
Var du hittar det nödvändiga biblioteket
Det nödvändiga biblioteket kan laddas ner via Internet. De flesta bibliotek är tillgängliga på Github. Efter att ha laddat ner biblioteket är det viktigt att lägga till det i rätt mapp så att kompilatorn kan hitta det och ladda skissen. Mappen där alla koder sparas skapas på datorn efter installation av Arduino IDE. För operationssalen Linux-system mappen heter "Scetchbook" och finns i /home/, på Windows-mappen"Arduino" finns i avsnittet "Mina dokument".
Alla bibliotek som installeras extra finns i mappen "Bibliotek". För tidigare versioner Du måste skapa Arduino-mappen själv, men från och med version 1.0.2 läggs den till automatiskt när du installerar Arduino IDE.
Hur man installerar biblioteket. Steg-för-steg-instruktion
När biblioteket har laddats ner till din PC måste du börja installera det. Det finns två sätt att installera biblioteket - med Arduino IDE och manuellt.
Anslutning med Arduino IDE
Biblioteket laddas ner som ett zip-arkiv. För att aktivera det med den här metoden behöver arkivet inte packas upp. För att installera det måste du gå till Sketch-menyn – Anslut bibliotek – Add.Zip-bibliotek.
När fönstret öppnas måste du välja mappen "nedladdningar" i avsnittet "Den här datorn". Om det, efter att du laddat ner biblioteket, sparades på en annan plats, måste du ange det.
Sedan måste du välja den nedladdade filen och klicka på "öppna".
Biblioteket kommer att installeras och du kan använda det. För att börja använda exempelfilen - exempel måste du starta om Arduinos utvecklingsmiljö.
Installera biblioteket manuellt från en zip-fil
Innan du startar installationen måste du avsluta Arduino IDE. Den nedladdade zip-filen med biblioteket måste packas upp. Som ett resultat kommer vi att få en mapp där biblioteksfiler med tilläggen .cpp och .h och kataloger kommer att finnas. Den resulterande mappen måste placeras i bibliotek.
I Windows OS finns biblioteksmappen under rubriken Mina dokument – Arduino – bibliotek. På Linux kommer detta att vara biblioteksmappen med skisser.
I slutet måste du starta om Arduino IDE, det nedladdade biblioteket kommer att vara tillgängligt för inkludering via Sketch - Connect Library.
Fel vid anslutning av Arduino-biblioteket
Nedan finns en lista möjliga fel när du installerar bibliotek och sätt att hantera dem:
- "xxxx" namnger inte en typ - liknande fel visas om biblioteket ännu inte har installerats, mappen eller biblioteket har ett felaktigt namn, mappplatsen är felaktig eller Arduino IDE inte har startats om.
- Felaktig mappplats - Om det här felet visas måste du kontrollera om biblioteket finns i en mapp som kan sökas i av miljön.
- Ogiltigt biblioteksnamn – felet visas om namnet efter #include inte stämmer överens med biblioteksnamnet.
- Ofullständigt bibliotek – kan visas om inte alla har laddats ner nödvändiga filer och mappar.
- Biblioteksberoenden - eftersom den här typen av bibliotek bara fungerar med ytterligare sådana måste du initialt inkludera dem.
