Domov › Nastavení › Instalace knihoven v Arduino IDE. Psaní knihovny pro Arduino

Instalace knihoven v Arduino IDE. Psaní knihovny pro Arduino

Knihovna již obsahuje většinu kódu, který nebudete muset psát, knihovna usnadňuje práci s konkrétním modulem nebo jedním z jejich typů a stačí jej zahrnout do náčrtu.

Chcete-li například zobrazit text na LCD displeji bez připojení knihovny, musíte mu předat několik bajtů příkazů a dat, což zabere několik řádků kódu, a co je nejdůležitější, musíte znát typ mikrokontrolér, pod kterým LCD displej pracuje, účel příkazů, které ovládá, znát architekturu jeho paměti, adresy a účel registrů, pro které si budete muset najít a znovu přečíst jeho datasheet.

Zatímco při psaní kódu pomocí knihovny (například LiquidCrystal_I2C.h), můžete zobrazit text voláním pouze jedné funkce knihovny:

Lcd.print(“můj text”);

Libovolnou knihovnu můžete připojit pomocí následujícího příkazu:

"#zahrnout<файл.h>"

<файл.h>– toto je právě ta knihovna, kterou propojujeme.

Můžete se také podívat na příklad připojení knihovny v článku.

Než začnete používat metody a funkce knihovny, musíte:

stáhnout (stáhněte si do počítače),
instalovat (umístěte do požadované složky),
připojit (vložte text „#zahrnout<файл.h>“ do náčrtu).

Každá knihovna musí obsahovat 2 soubory s příponami .h A .cpp.

První typ souborů obsahuje:

popis třídy,
konstanty,
proměnné.

Druhý typ obsahuje kódy metod.

Kromě toho musíte těmto souborům porozumět .h A .cpp nemusí být v kořenovém adresáři staženého archivu. Součástí hlavních souborů je také „keywords.txt“ a složka s příklady.

Jak nainstalovat knihovnu?

Po stažení (nahrání) knihovny do počítače je třeba ji nainstalovat. Knihovnu můžete nainstalovat ručně nebo to udělat pomocí Arduino IDE:

Instalace knihovny pomocí Arduino IDE

Uděláme to přes menu. Přejděte do nabídky:

Skica – Připojit knihovnu – Přidat knihovnu .ZIP

V okně, které se zobrazí, klikněte na ikonu „Tento počítač“ a vyberte složku „Stahování“. Pokud jste při stahování archivu ZIP z webu zadali cestu k uložení souboru, pak místo složky „Stahování“ zadejte cestu k souboru.

Vyberte soubor ZIP knihovny, který jste stáhli. Název souboru se nemusí shodovat s názvem knihovny. Poté klikněte na „ OTEVŘENO » ( OTEVŘENO ).

V tuto chvíli je instalace knihovny dokončena, můžete ji začít připojovat ke skice.

Důležité! Po instalaci Arduino IDE se v počítači vytvoří samostatná složka pro uložení všech knihoven. Pro OS Linux "Scetchbook", umístěný v /home/. V případě OS Windows se složka "Arduino" nachází v /My Documents/.

Ruční instalace knihovny

Rozbalte stažený ZIP archiv a umístěte složku (název složky obvykle odpovídá názvu knihovny) z tohoto archivu do složky:

Tento počítač → Dokumenty → Arduino → knihovny

Pokud při kopírování běželo (otevřelo) Arduino IDE, tak je potřeba zavřít všechna okna tohoto programu, následně spustit (otevřít) Arduino IDE a můžete začít připojovat knihovnu ke skice.

Faktem je, že program se neustále vyvíjí a počet jeho verzí neustále roste. Pokud chcete nainstalovat novou verzi Arduino IDE, knihovny umístěné ve složce ( Tento počítač → Dokumenty → Arduino → knihovny) bude k dispozici ve staré i nové (nainstalované) verzi Arduino IDE a v knihovnách umístěných ve složce knihovny Programy Arduino IDE staré verze (které byly nainstalovány dříve) budou k dispozici pouze v něm (dokud je nezkopírujete do nové).

Kde najdu knihovnu, kterou potřebuji?

Pro pohodlí je na našem webu celá sekce s názvem -. Většinu knihoven lze nalézt na internetu ve veřejné doméně.

Řadu standardních sad lze také nalézt na oficiálních stránkách Arduina: arduino.cc.

Jaké knihovny jsou již nainstalovány?

Jak jsme již diskutovali - samotné IDE již obsahuje některé .

Existují dva způsoby, jak zobrazit nainstalované knihovny.

Metoda 1

Chcete-li zjistit, která sada je již nainstalována, přejděte na kartu:

Metoda 2

Druhým způsobem je použití nabídky „Sketch“ a podnabídky „Connect Library“. Tímto způsobem můžete také zobrazit seznam knihoven.

Přejděte na Sketch a vyberte Zahrnout knihovnu:

Skica → Zahrnout knihovnu

Možné chyby

Někdy se při instalaci knihoven nebo při jejich používání mohou objevit nějaké chyby. Níže se podíváme na ty hlavní.

„xxxx“ nepojmenovává typ

Chyba se objeví, když knihovna ještě není nainstalována.

K chybě také dochází, pokud má složka nebo knihovna nesprávný název.

Umístění složky může být nesprávně specifikováno nebo Arduino IDE nemuselo být restartováno!

Nesprávné umístění složky

Zkontrolujte, zda jsou všechny knihovny umístěny na správné adrese. Výše jsme poskytli adresy složek pro různé operační systémy.

Neplatný název knihovny

Chyba se objeví, když název za tagem #include neodpovídá názvu knihovny.

Neúplná knihovna

Chybí všechny potřebné soubory a složky.

Závislosti knihovny

Je nutné připojit další závislé knihovny, bez kterých není správný/správný provoz nemožný.

Instalace a připojení knihovny k arduinu je poměrně běžná operace, dříve nebo později se s tím nevyhnutelně setká každý vývojář. Pro úsporu času se používá externí zásuvný kód ve všech programovacích jazycích. Arduino není výjimkou: mnoho senzorů, modulů, obrazovek a motorů vyžaduje poměrně složitá schémata interakce, která je obtížné implementovat do vašeho kódu. Je mnohem jednodušší a rychlejší stáhnout si požadovanou knihovnu, rychle ji připojit ručně nebo pomocí Arduino IDE a poté ji použít ve všech svých skicách. V tomto článku najdete krátké pokyny k připojení a používání knihoven.

Knihovna v Arduinu je programový kód v externích souborech, které lze nainstalovat a připojit k vaší skice. Knihovna uchovává různé metody a datové struktury, které jsou potřebné pro zjednodušení práce se senzory, indikátory, moduly a dalšími komponentami. Používání knihoven výrazně zjednodušuje práci na projektech, protože se můžete soustředit na hlavní logiku programu, aniž byste ztráceli čas spoustou maličkostí. Dnes je na internetu vyvěšeno obrovské množství knihoven, odkud je lze snadno stáhnout, a to zcela zdarma. naleznete na našich webových stránkách.

Z pohledu systému souborů je knihovna adresář obsahující specifické složky. Při kompilaci a sestavování projektu Arduino IDE automaticky zahrne do kódu ty třídy, datové struktury a metody z knihoven, které jsou zahrnuty a použity ve skice. Jediné, co tedy musíme udělat, je vložit příslušné instrukce do našeho kódu poté, co se ujistíme, že je nainstalována požadovaná knihovna.

Jak zjistit seznam knihoven připojených k Arduino IDE

Každá nainstalovaná knihovna obsahuje jeden nebo více příkladů pro práci. Používají se k zobrazení možností zařízení připojeného k Arduinu. Proto nejrychlejším způsobem, jak získat seznam všech nainstalovaných Arduino knihoven, je použít seznam příkladů v Arduino IDE. Chcete-li to provést, vyberte v hlavní nabídce Soubor a poté otevřete podnabídku Příklady.

Dalším způsobem je použití nabídky Skica a podnabídky – Zahrnout knihovnu. Zde můžete také vidět seznam knihoven:

Propojení hlavičkového h souboru s operátorem #include

Chcete-li začít používat knihovnu, musíte na začátek programu zahrnout hlavičkový soubor h s direktivou include. Například zahrnutí knihovny LiquidCrystal.h bude vypadat takto: #include

Můžete vidět kompletní příklad pomocí samotné knihovny.

Požadované soubory v knihovně

Každá knihovna musí obsahovat alespoň 2 soubory – hlavičkový soubor s příponou .h a soubor zdrojového kódu s příponou .cpp. Hlavičkový soubor obsahuje popis třídy, konstanty a proměnné. Druhý soubor obsahuje kódy metod. Kromě dvou hlavních souborů může obsahovat textový dokument keywords.txt a složku příkladů s kódy pro příklady použití knihovny. Soubory ha cpp nemusí být nutně umístěny v kořenovém adresáři

Editace souborů není možná v Arduino IDE, všechny změny lze provést v libovolném textovém editoru nebo vývojovém prostředí C++. Je to dáno tím, že v Arduino IDE nepracujeme se soubory cpp, editor kódu není určen pro „čisté“ C, funguje pouze s jazykem Arduino.

Kde najít požadovanou knihovnu

Požadovanou knihovnu lze stáhnout přes internet. Většina knihoven je k dispozici na Github. Po stažení knihovny je důležité ji přidat do správné složky, aby ji překladač našel a načetl skicu. Složka, ve které jsou uloženy všechny kódy, se vytvoří v počítači po instalaci Arduino IDE. Pro operační systém Linux se složka nazývá „Scetchbook“ a nachází se v /home/ ve Windows, složku „Arduino“ najdete v sekci „My Documents“.

Všechny knihovny, které se instalují dodatečně, jsou umístěny ve složce „Libraries“. U dřívějších verzí Arduina si musíte složku vytvořit sami, ale od verze 1.0.2 se přidává automaticky při instalaci Arduino IDE.

Jak nainstalovat knihovnu. Pokyny krok za krokem

Jakmile je knihovna stažena do počítače, musíte ji začít instalovat. Knihovnu lze nainstalovat dvěma způsoby – pomocí Arduino IDE a ručně.

Připojení pomocí Arduino IDE

Knihovna se stahuje jako zip archiv. Chcete-li jej povolit pomocí této metody, není nutné archiv rozbalovat. Pro její instalaci je potřeba přejít do nabídky Sketch – Connect library – Add.Zip library.

Když se okno otevře, musíte vybrat složku „stahování“ v části „Tento počítač“. Pokud byla knihovna po stažení uložena na jiné místo, musíte ji určit.

Poté musíte vybrat stažený soubor a kliknout na „otevřít“.

Knihovna se nainstaluje a můžete ji používat. Abyste mohli začít používat příklady Soubor - příklady, musíte restartovat vývojové prostředí Arduino.

Ruční instalace knihovny ze souboru zip

Před zahájením instalace musíte ukončit Arduino IDE. Stažený zip soubor s knihovnou je třeba rozbalit. Ve výsledku získáme složku, ve které budou umístěny soubory knihovny s příponou .cpp a .h a adresáře. Výslednou složku bude nutné umístit do knihoven.

V OS Windows lze složku libraries nalézt pod cestou My Documents – Arduino – libraries. V Linuxu to bude složka knihoven se skicami.

Na konci je potřeba restartovat Arduino IDE, stažená knihovna bude k dispozici pro zařazení přes Sketch - Connect Library.

Chyby při připojování knihovny Arduino

Níže je uveden seznam možných chyb při instalaci knihovny a způsoby, jak se s nimi vypořádat:

„xxxx“ nepojmenuje typ – podobná chyba se objeví, pokud knihovna ještě nebyla nainstalována, složka nebo knihovna je pojmenována nesprávně, adresa umístění složky je nesprávná nebo Arduino IDE nebylo restartováno.
Nesprávné umístění složky – Pokud se zobrazí tato chyba, musíte zkontrolovat, zda se knihovna nachází ve složce, kterou lze prohledávat prostředím.
Neplatný název knihovny – chyba se objeví, pokud název za #include neodpovídá názvu knihovny.
Neúplná knihovna – může se objevit, pokud nebyly staženy všechny potřebné soubory a složky.
Závislosti knihoven – protože tento typ knihoven funguje pouze s dalšími, musíte je zpočátku zahrnout.

Mnoho skic (programů) pracuje s knihovnami. Knihovna usnadňuje práci s konkrétním modulem nebo jedním z typů modulů. Pokud chcete například zobrazit text na LCD displeji bez připojení knihovny, musíte do něj přenést několik bajtů příkazů a dat, což zabere několik řádků kódu, a co je nejdůležitější, musíte znát typ mikrokontroléru, pod kterým LCD displej pracuje, účel příkazů, které ovládá, znát architekturu jeho paměti, adresy a účel registrů, pro které budete muset najít a znovu přečíst jeho datasheet. Zatímco při psaní kódu pomocí knihovny (například LiquidCrystal_I2C.h), můžete zobrazit text voláním pouze jedné funkce knihovny: lcd.print("můj text");

Než začnete používat metody a funkce knihovny, musíte stáhnout (stáhněte si do počítače), instalovat (umístěte do požadované složky) a připojit (vložte text „#include<файл.h>“ do náčrtu).

Stahování knihovny:

Pokud je v našich lekcích, popisech nebo příkladech použita knihovna, poskytujeme odkaz ke stažení této knihovny. Všechny naše knihovny jsou v archivu zip, ale se získáváním souborů z archivu nespěchejte, nemusí to být nutné, protože... Samotné Arduino IDE umí rozbalit archivy a umístit knihovny do požadovaných složek (viz níže).

Pokud jste stáhli archiv knihovny z webu, aniž byste zadali cestu k uložení souboru, pak se stažený (nahraný) soubor s největší pravděpodobností nachází ve složce: Tento počítač > Stažené soubory.

Instalace knihovny:

Po stažení (nahrání) knihovny do počítače je třeba ji nainstalovat. Knihovnu můžete nainstalovat ručně nebo to udělat pomocí Arduino IDE:

Instalace knihovny pomocí Arduino IDE:

Vstupte do nabídky: Skica > Připojte knihovnu > Přidat knihovnu ZIP... .

V zobrazeném okně klikněte na „ Tento počítač "a vyberte složku" Stahování " Pokud jste při stahování archivu ZIP z webu zadali cestu k uložení souboru, pak místo složky „Stahování“ zadejte cestu k souboru.

Vyberte soubor ZIP knihovny, který jste stáhli. Název souboru se nemusí shodovat s názvem knihovny. Poté klikněte na „ OTEVŘENO » ( OTEVŘENO ).

V tuto chvíli je instalace knihovny dokončena, můžete ji začít připojovat ke skice.

Ruční instalace knihovny:

Rozbalte, co jste stáhli ZIP archiv a umístěte složku (název složky obvykle odpovídá názvu knihovny) z tohoto archivu do složky: Tento počítač > Dokumenty > Arduino > knihovny .

Poznámka: složka knihovny existuje nejen výše uvedená cesta, ale také ve složce programu Arduino IDE (kde je soubor arduino .exe). Zkopírováním knihovny do této složky se také nainstaluje, ale nedoporučujeme to dělat. Faktem je, že program Arduino IDE se neustále vyvíjí a počet jeho verzí neustále roste. Pokud chcete nainstalovat novou verzi Arduino IDE, pak knihovny umístěné ve složce Tento počítač > Dokumenty > Arduino > knihovny budou dostupné ve staré i nové (nainstalované) verzi Arduino IDE a v knihovnách umístěných ve složce knihovny Programy Arduino IDE staré verze (které byly nainstalovány dříve) budou k dispozici pouze v něm (dokud je nezkopírujete do nové).

Připojení knihovny:

Chcete-li zahrnout knihovnu, musíte na začátek náčrtu napsat pouze jeden řádek: „#include<файл.h>“, Například:

#zahrnout // Připojení knihovny iarduino_4LED pro práci se 4 segmentovými LED indikátory.

Některé knihovny pracují pomocí metod a funkcí jiných knihoven, pak je potřeba propojit dvě knihovny, nejprve propojit tu, jejíž metody a funkce používá druhá, například:

#zahrnout // Připojení knihovny Wire pro práci se sběrnicí I2C #include // Připojení knihovny LiquidCrystal_I2C pro práci s LCD displejem přes sběrnici I2C // Knihovna LiquidCrystal_I2C využívá metody a funkce knihovny Wire

Chcete-li pracovat s většinou knihoven, musíte vytvořit objekt (instanci třídy knihovny), jehož prostřednictvím budou dostupné jejich funkce a metody, například:

LiquidCrystal_I2C lcd(0x27,20,4); // lcd je objekt knihovny LiquidCrystal_I2C // funkce a metody knihovny jsou přístupné přes objekt

Místo lcd můžete napsat libovolné slovo nebo kombinaci písmen a číslic. Toto je název objektu, jehož prostřednictvím můžete přistupovat k metodám a funkcím knihovny. Pokud jste místo lcd napsali myLCD, pak všechny metody a funkce knihovny LiquidCrystal_I2C musí být přístupné přes vámi zadaný název objektu, například: myLCD.print("můj text");

Příklady z knihoven:

Většina knihoven obsahuje příklady. Jedná se o malé skici (programy), které odhalují funkčnost knihovny. Nejpohodlnějším způsobem zobrazení příkladů je použití Arduino IDE. Vyberte položku nabídky: Soubor > Příklady otevře se seznam s názvy knihoven, které mají příklady. Najeďte myší na název knihovny a uvidíte seznam příkladů v něm obsažených, kliknutím na příklad se zobrazí nové okno Arduino IDE s ukázkovým náčrtem.

Alternativním způsobem zobrazení příkladů je spuštění souborů skici ze složky:
cesta > knihovny > název knihovny > příklady > příklad názvu .

Hledat knihovny:

Můžete vyhledávat knihovny sami, nebo můžete využít funkcionalitu Arduino IDE.

Vyberte položku nabídky: Skica > Připojte knihovnu > Spravovat knihovny... .

" Správce knihovny ", ve kterém najdete knihovnu, o kterou máte zájem, zadáním jejího názvu do vyhledávacího řádku, můžete dodatečně nastavit položky "Typ" a "Předmět".

Kliknutím na popis knihovny se zobrazí „ Verze "a tlačítka" Instalace " Po kliknutí na tlačítko „Instalovat“ můžete začít zahrnovat knihovnu do náčrtu „#include<файл.h>".

Jedním z důvodů popularity Arduina je snadné použití různých periferních zařízení (modulů): displeje, ovladače motorů, bezdrátové komunikační moduly (Bluetooth, wi-fi, XBee nebo ISM) atd.

Arduino Software Environment (IDE) obsahuje mnoho užitečných funkcí, které usnadňují vytváření programů pro nové projekty. Bohužel však nemůže mít vestavěnou podporu pro každý nový hardware (modul) nebo softwarový komponent, který se objeví.

Místo toho je poskytována podpora pro „knihovny“, což jsou samostatné moduly určené k rozšíření softwarového prostředí, přidání specifických funkcí nebo přidání hardwarové podpory.

Hlavním zdrojem knihoven pro Arduino jsou výrobci hardwaru, kteří je vytvářejí, aby poskytovali podporu v Arduino IDE.

Kde najdu knihovny pro Arduino?

Pokud potřebujete podporu Arduina pro konkrétní hardware (modul), zkuste procházet web výrobce modulu. Můžete také navštívit webovou stránku Arduino, která obsahuje mnoho oblíbených knihoven.

V opačném případě zkuste vyhledat Google, například „Knihovna Arduino“, za kterým následuje název vašeho hardwaru.

Jak již bylo zmíněno výše, vývojové prostředí Arduino má předinstalované knihovny. Aby byly funkce knihovny dostupné v našem programu, musíte jej nejprve připojit. K tomu slouží direktiva #include.

Připojení vestavěné knihovny se vyvolá z nabídky „Sketch - Connect library - …“ a poté vyberte požadovanou knihovnu (v našem případě „Servo“).

Když vyberete knihovnu, Arduino IDE automaticky přidá příslušnou direktivu #include do vašeho kódu.

#zahrnout // připojení knihovny podpory servopohonu.

Pokud IDE nemá požadovanou předinstalovanou knihovnu, musíte si ji nainstalovat sami. Existují 2 způsoby, jak to udělat.

První způsob: Přidání knihovny z úložiště Arduino.

Tvůrci Arduina umístili na internet databázi různých knihoven. Pokud vám nějaká knihovna chybí, můžete ji vyhledat v úložišti. Chcete-li to provést, vyberte z nabídky „Sketch – Connect Library – Manage Libraries“.

V tomto okně si můžete stáhnout novou knihovnu z internetu nebo aktualizovat existující knihovnu.

Druhý způsob: Přidání knihovny stažené z internetu.

Vzhledem k tomu, že v prostředí Arduina je téměř vše snadné a jednoduché, instalace dalších knihoven také není příliš obtížná. Jako příklad si ukážeme instalaci knihovny pro práci s rádiovým modulem bezdrátového komunikačního systému NRF24L01 od Nordic Semiconductor.

Knihovny Arduino pro nejoblíbenější moduly jsou k dispozici na http://arduino.cc/libraries. Software (knihovny) pro méně oblíbené moduly se obvykle nachází na stránkách výrobců těchto modulů.

V případě rádiového modulu NRF24L01 byla podpůrná knihovna pro tento modul v prostředí Arduino vytvořena na základě knihovny vyvinuté pro mikrokontroléry AVR. Dokumentaci pro tuto knihovnu a samotnou knihovnu lze stáhnout z https://github.com/stanleyseow/arduino-nrf24l01

Poté, co si stáhnete archiv knihovny arduino-nrf24l01-master.zip, musíte jej nainstalovat do IDE. Chcete-li to provést, přejděte do nabídky „Sketch – Connect library – Add ZIP library“

Poté zadejte umístění staženého souboru arduino-nrf24l01-master.zip a klikněte na tlačítko Otevřít.

Poté máme zpravidla knihovnu nainstalovanou. Ale bohužel se často stává, že Arduino signalizuje chybu „Vybraná složka/soubor zip neobsahuje správné knihovny“

V tomto případě lze knihovnu nainstalovat ručně. Chcete-li to provést, musíte rozbalit stažený soubor arduino-nrf24l01-master.zip a zkopírovat složku „Mirf“ do složky „libraries“. Nebo můžete umístit složku “Mirf” do C:\....\Documents\Arduino\libraries (pak bude knihovna dostupná z různých verzí IDE).

Po restartu Arduino IDE můžeme tuto knihovnu připojit, stejně jako použít příklady pro rádiový modul NRF24L01

Jak odstranit knihovnu v Arduinu

Pokud jste přišli na to, jak nainstalovat novou knihovnu do IDE, pak pro vás nebude problém ji (v případě potřeby) odebrat.

Vše, co musíte udělat pro odstranění knihovny, je odstranit složku knihovny z adresáře "libraries" v IDE nebo (pokud je knihovna nainstalována v "Documents") z C:\....\Documents\Arduino\ adresář knihoven

Knihovny Arduino jsou pohodlným nástrojem pro distribuci kódu. Mohou to být například ovladače hardwaru nebo často používané funkce.

Tato příručka podrobně popisuje, jak nainstalovat knihovny do počítače.

Existují dva hlavní typy knihoven Arduino: standardní a doplňkové.

Standardní knihovny

Arduino IDE má sadu standardních knihoven, které se používají velmi často. Tyto knihovny podporují všechny příklady, které jsou součástí Arduino IDE. Standardní knihovny podporují funkce pro práci s nejběžnějším periferním zařízením, například: servomotory nebo LCD obrazovky.

Standardní knihovny se instalují do složky „Libraries“ při instalaci Arduino IDE. Pokud máte nainstalovaných více verzí IDE, každá verze bude mít vlastní sadu knihoven. Důrazně se doporučuje neměnit standardní knihovny a instalovat další do stejné složky.

Další knihovny

Na internetu je k dispozici velké množství doplňkových knihoven s pohodlnou funkčností a ovladačů pro různá periferní zařízení. Knihovny jsou umístěny hlavně na Arduino Playground, Github a Google Code. Výrobci senzorů, převodníků, desek plošných spojů atd. často píší knihovny pro Arduino. Například Adafruit nabízí více než 100 knihoven, které podporují všechny modely desek Arduino.

Nainstalujte další knihovny do složky Knihovny. Díky tomu je lze použít ve všech verzích Arduino IDE. Po aktualizaci verze je nebudete muset znovu instalovat!

Kam instalovat knihovny

Je důležité nainstalovat knihovny do správné složky. V opačném případě je kompilátor nebude schopen najít při kompilaci a načítání kódu.

Složka, kde jsou uloženy všechny náčrty Arduina, se vytvoří automaticky při instalaci IDE.

V Linuxu se složka nazývá "Scetchbook" a je obvykle umístěna v /home/<username>

V systémech Windows a Macintosh se složka nazývá „Arduino“ a nachází se ve složce Dokumenty.

Upozorňujeme, že je to důležité! Ve složce „My Documents“ se automaticky vytvoří další složka s názvem „Arduino“!

Další knihovny by měly být umístěny ve složce "Libraries", která se nachází uvnitř "Scetchbook" nebo "Arduino". Zde bude IDE hledat dodatečně nainstalované knihovny.

Od Arduino IDE 1.0.2 a novějších se složka "Libraries" vytváří automaticky. V dřívějších verzích musí být vytvořena před instalací vaší první knihovny.

Otevřete nabídku a vyberte "Soubor->Předvolby" v Arduino IDE.

Najděte umístění svých náčrtů. Obvykle se jedná o složku „Arduino“ ve složce „Moje dokumenty“.

Jakmile určíte cestu, přejděte do této složky pomocí Průzkumníka souborů.

Pokud složka Knihovny neexistuje, vytvořte novou složku.

Přejmenujte jej na „Knihovny“.

Instalace knihoven na Windows

Chcete-li nainstalovat knihovnu v systému Windows, postupujte podle pokynů níže.

Zavřete Arduino IDE

Ujistěte se, že je Arduino IDE zavřené, protože knihovny jsou skenovány pouze při načtení IDE. Nová knihovna nebude fungovat, dokud nerestartujete IDE.

Stáhněte si soubor Zip z Github.

Zkopírujte rozbalenou složku

Vložte jej do složky knihoven.

Dejte jí správné jméno. Arduino IDE nerozpozná složky s pomlčkou v názvu. Budete tedy muset složku přejmenovat. Můžete použít pod čárky.

Restartujte Arduino IDE a zkontrolujte, zda se knihovna objeví v položce nabídky Soubor->Příklady.

Pro kontrolu si stáhněte jeden z příkladů.

Před nahráním příkladu na tabuli zkontrolujte náčrt.

Instalace knihoven na Mac OSX

Chcete-li správně nainstalovat další knihovny na Mac OSX, postupujte podle pokynů níže

Zavřete Arduino IDE.

Stáhněte si archiv knihovny z Github.

Najděte stažený archiv ve složce stažených souborů na svém Macu.

Rozbalte a zkopírujte knihovnu do složky libraries, která byla vytvořena při instalaci Arduino IDE.

Zadejte knihovně platný název. Stejně jako v případě Windows nejsou složky s pomlčkami čitelné.

Restartujte Arduino IDE. Knihovna by se měla objevit v nabídce Soubor->Příklady.

Stáhněte si jeden z příkladů.

Před nahráním do Arduina zkontrolujte, zda je náčrt správný.

Instalace knihoven na Linuxu

Chcete-li nainstalovat vlastní knihovny v systému Linux, postupujte podle pokynů níže.

Znovu zavřete Ardino IDE.

Stáhněte si archiv s knihovnou, kterou potřebujeme.

Archiv uložíme na pevný disk našeho PC.

Najděte stažený archiv ve složce stažených souborů.

Rozbalte knihovnu a zkopírujte ji do složky Sketchbook/Libraries.

Dejte složce správný název. Žádná pomlčka!

Restartujte Arduino IDE a zkontrolujte, zda se knihovna objeví ve složce nabídky Soubor->Příklady.

Pojďme si stáhnout jeden z příkladů.

Zkontrolujeme, zda se vzorový soubor zkompiluje bez chyb.

Časté chyby při instalaci knihoven pro Arduino

"xxxx" nepojmenuje typ

Toto je nejčastější chyba při práci s externími knihovnami. Důvodem je, že kompilátor nemůže najít knihovnu. Možné důvody této chyby:

Knihovna není nainstalována (viz pokyny k instalaci výše).
Umístění složky je nesprávné.
Neplatný název složky.
Neplatný název knihovny.
Zapomněli jste restartovat Arduino IDE.

Níže jsou uvedena řešení možných problémů

Nesprávné umístění složky

IDE najde pouze standardní knihovny a další, které jsou nainstalovány ve složce "Libraries". Knihovny, které jsou umístěny v jiných umístěních, nebudou inicializovány

Složka knihovny by měla být v kořenovém adresáři složky "Knihovny". Pokud vytvoříte další podsložku, IDE knihovnu nezjistí.

Poznámka: v některých online úložištích jsou knihovny uspořádány s další úrovní vnoření složek. Zkontrolujte tento okamžik. Soubory knihovny musí být umístěny v první složce bez dalších podsložek.

Ne úplná knihovna

Soubory v knihovně byste neměli přejmenovávat velkými písmeny, pomlčkami atd.

Nesprávný název složky

IDE nerozpozná složky s určitými znaky v názvu. Bohužel IDE nepodporuje pomlčky, které se generují v názvech souborů na Githubu. Po stažení archivu tedy složku přejmenujte. Nový název nesmí obsahovat pomlčku. Všechny znaky ('-') můžete jednoduše nahradit ('_').

Neplatný název knihovny

Název, který zadáte v direktivě #include ve vaší skice, se musí přesně shodovat s názvem třídy v knihovně (rozlišují se malá a velká písmena!). Pokud se název neshoduje, IDE nebude obsahovat potřebné funkce, třídy atd. V příkladech dodaných s knihovnami jsou názvy správné. Abyste se vyhnuli náhodným chybám, můžete je jednoduše zkopírovat a vložit do kódu.

Více verzí knihovny

Pokud máte více verzí knihovny, Arduino IDE se je pokusí načíst všechny najednou. V důsledku toho může dojít k chybě kompilace. Takže staré nebo nefunkční verze musí být odstraněny nebo přesunuty z katalogu knihovny.

Závislé knihovny

Některé knihovny jsou závislé na jiných knihovnách. Například většina knihoven grafického zobrazení Adafruit závisí na knihovně Adafruit GFX. To znamená, že pro použití první knihovny musíte mít nainstalovanou druhou.

„Základní“ knihovny

Některé knihovny nelze použít přímo. Dobrým příkladem je knihovna GFX. Tato knihovna pohání většinu displejů od Adafruit, ale nelze ji použít bez knihovny ovladačů pro tento displej.