Стандартні бібліотеки Arduinoзберігаються в папці:

Додаткові бібліотеки встановлюються в папку:

"C:\Users\*Ім'я Користувача*\Documents\Arduino\libraries"

У вашому випадку ці шляхи можуть бути іншими через іншу літеру основного жорсткого диската іншого імені користувача. Якщо у вас встановлена ​​32-бітна операційна система то папка «Program Files (x86)» буде називатися «Program Files».

Встановлення бібліотек Arduino

Встановити бібліотеки в Arduino IDE дуже просто. Можна зробити це двома способами. Через інтерфейс програми або копіювання завантаженої бібліотеки в папку «libraries». Розглянемо докладніше обидва варіанти:

Встановлення бібліотек через Arduino IDE

Перший варіант — установка бібліотек Ардуїно з офіційного репозиторію. Для цього необхідно запустити Arduino IDE, верхньому менювибрати "Скетч -> Підключити бібліотеку -> Управляти бібліотеками".

Після цього з'явиться вікно зі списком доступних бібліотек. Для того щоб знайти потрібну бібліотеку можна скористатися пошуком або вибрати необхідний розділ. Для встановлення бібліотеки необхідно вибрати її зі списку, натиснувши на назву, і клікнути по кнопці «Встановити».

Другий варіант - це установка бібліотеки зі скачаної.zip папки. Через інтерфейс Arduino IDE це можна зробити лише за кілька кліків. У верхньому меню програм вибираємо "Скетч -> Підключити бібліотеку -> Додати.ZIP бібліотеку". Відкриється вікно файлового менеджера, де необхідно вибрати папку або .zip архів з бібліотекою.

Ще один спосіб встановлення бібліотек Ардуїно

Ви можете просто перенести папки бібліотек по дорозі:

"C:\Program Files (x86)\Arduino\libraries\"

Підключення бібліотеки Arduino

Мало встановити бібліотеку. Для використання її необхідно підключити до скетчу. Зробити це дуже просто. Можна на початку скетчу вручну написати подібну сходинку.

Багато скетчі (програми) працюють із бібліотеками. Бібліотека полегшує роботу з певним модулем або одним із типів модулів. Наприклад, якщо Ви хочете вивести текст на LCD дисплей без підключення бібліотеки, то Вам потрібно передати йому кілька байт команд та даних, що займе кілька рядків коду, а головне, що Вам потрібно знати тип мікроконтролера під керуванням якого працює LCD дисплей, призначення команд якими Він управляється, знає архітектуру його пам'яті, адреси і призначення регістрів, для чого потрібно знайти і перечитати його дані. У той час як при написанні коду з використанням бібліотеки (наприклад LiquidCrystal_I2C.h) Ви зможете вивести текст на дисплей, викликавши лише одну функцію бібліотеки: lcd.print("my text");

Перед тим як почати користуватися методами та функціями бібліотеки, її потрібно скачати (завантажити на Ваш комп'ютер), встановити (розмістити в потрібній папці) та підключити (Вставити текст "#include<файл.h>"У скетч).

Завантаження бібліотеки:

Якщо у наших уроках, описах чи прикладах використовується бібліотека, ми вказуємо посилання на завантаження цієї бібліотеки. Всі наші бібліотеки знаходяться в zip архіві, але не поспішайте діставати файли з архіву, це може не знадобитися, тому що це не так. Arduino IDE може розпаковувати архіви і розміщувати бібліотеки в потрібних папках (див. далі).

Якщо Ви завантажили архів бібліотеки з сайту не вказуючи шлях для збереження файлу, то завантажений Вами файл швидше за все знаходиться в папці: Цей комп'ютер > Завантаження.

Встановлення бібліотеки:

Після того як Ви завантажили бібліотеку на свій комп'ютер, її потрібно встановити. Встановити бібліотеку можна вручну або зробити це засобами Arduino IDE:

Установка бібліотеки засобами Arduino IDE:

Увійдіть до меню: Скетч > Підключити бібліотеку > Додати.ZIP бібліотеку... .

У вікні, натисніть на іконку « Цей комп'ютер » та виберіть папку « Завантаження ». Якщо при скачуванні ZIP архіва з сайту Ви вказували шлях для збереження файлу, то замість папки «Завантаження» вкажіть шлях до файлу.

Виберіть ZIP файлбібліотеки, яку Ви завантажили. Назва файлу може не відповідати назві бібліотеки. Після чого натисніть кнопку « Відкрити » ( Open ).

На цьому установка бібліотеки завершена, можна приступити до її підключення до скетчу.

Встановлення бібліотеки вручну:

Розпакуйте завантажений Вами ZIP архів і помістіть папку (ім'я папки зазвичай збігається з назвою бібліотеки) з даного архіву до папки: Цей комп'ютер > Документи > Arduino > libraries .

Якщо під час копіювання Arduino IDE було запущено (відкрито), потрібно закрити всі вікна цієї програми, після чого запустити (відкрити) Arduino IDE і можна приступати до підключення бібліотеки в скетч.

Примітка: папка libraries є не тільки по зазначеному вище шляху, а й у папці програми Arduino IDE (де знаходиться файл arduino .exe). Скопіювавши бібліотеку в цю папку, вона також установиться, але ми не рекомендуємо це робити. Справа в тому, що програма Arduino IDE постійно розвивається і кількість її версій невпинно зростає. Якщо Ви захочете встановити нову версію Arduino IDE, бібліотеки, що знаходяться в папці Цей комп'ютер > Документи > Arduino > libraries, будуть доступні і в старій, і в новій (встановленій) версії Arduino IDE, а бібліотеки, що знаходяться в папці libraries програми Arduino IDE старої версії(яка була встановлена ​​раніше) будуть доступні тільки в ній (поки Ви їх не скопіюєте у нову).

Підключення бібліотеки:

Для того щоб підключити бібліотеку, потрібно написати лише один рядок на початку скетчу: "#include<файл.h>", наприклад:

#include // Підключення бібліотеки iarduino_4LED для роботи з 4 сегментними індикаторами.

Деякі бібліотеки працюють використовуючи методи та функції інших бібліотек, тоді потрібно підключати дві бібліотеки, спочатку підключається та, методи та функції якої використовує друга, наприклад:

#include // Підключення бібліотеки Wire для роботи з шиною I2C #include // Підключення бібліотеки LiquidCrystal_I2C для роботи з LCD дисплеєм по шині I2C // Бібліотека LiquidCrystal_I2C використовує методи та функції бібліотеки Wire

Для роботи з більшістю бібліотек потрібно створити об'єкт (примірник класу бібліотеки), через який будуть доступні їх функції та методи, наприклад:

LiquidCrystal_I2C lcd(0x27,20,4); // lcd це об'єкт бібліотеки LiquidCrystal_I2C // через об'єкт звертаються до функцій та методів бібліотеки

Замість lcd можна написати будь-яке слово або поєднання букв і цифр, це назва об'єкта через який можна звертатися до методів та функцій бібліотеки. Якщо Замість lcd Ви написали myLCD, то і до всіх методів та функцій бібліотеки LiquidCrystal_I2C, потрібно звертатися через вказане Вами ім'я об'єкта, наприклад: myLCD.print("my text");

Приклади з бібліотек:

Більшість бібліотек містять приклади. Це невеликі скетчі (програми), які розкривають функціонал бібліотеки. Найбільш зручний спосібперегляду прикладів за допомогою засобів Arduino IDE. Виберіть пункт меню: Файл > Приклади , відкриється список із назвами бібліотек, у яких є приклади. Наведіть курсор на назву бібліотеки і Ви побачите список прикладів, що містяться в ній, клік на прикладі призведе до появи нового вікна Arduino IDE зі скетчем прикладу.

Альтернативний спосібперегляду прикладів полягає у запуску файлів скетчів з папки:
шлях > libraries > назва бібліотеки > examples > назва прикладу .

Пошук бібліотек:

Бібліотеку можна шукати самостійно, а можна скористатися функціоналом Arduino IDE.

Виберіть пункт меню: Скетч > Підключити бібліотеку > Керувати бібліотеками... .

Відкриється « Менеджер бібліотек », в якому можна знайти цікаву для Вас бібліотеку ввівши її назву в рядок пошуку, додатково можна встановити пункти «Тип» та «Тема».

Натискання на опис бібліотеки призведе до появи вкладки « Версія » та кнопки « Встановлення ». Після натискання на кнопку «Установка» можна приступати до підключення бібліотеки до скетчу "#include<файл.h>".

Як тільки ви освоїтеся з програмним забезпеченнямАрдуїно і досконало оволодієте стандартними функціями, вам, напевно, захочеться розширити можливості вашого Ардуїно за допомогою додаткових бібліотек.

Що таке бібліотека?

Бібліотека - це набір функцій, призначених для того, щоб максимально спростити роботу з різними датчиками, РК-екрани, модулі та ін. Наприклад, вбудована бібліотека LiquidCrystal дозволяє легко взаємодіяти з символьними LCD-екранами. Існують сотні додаткових бібліотек, які можна завантажити в Інтернеті. Стандартні бібліотеки Ардуїно та ряд додаткових бібліотек , що найчастіше використовуються , перераховані в довідці . Але перед тим, як використовувати додаткові бібліотеки, необхідно встановити їх спочатку.

Як встановити бібліотеку

Найчастіше бібліотеки викладаються у вигляді ZIP-архіву або просто папки. Назва цієї папки є назвою бібліотеки. Усередині папки буде файл із розширенням .cpp, файл із розширенням .h, а також текстовий файл keywords.txt, папка з прикладами examplesта інші файли, необхідні бібліотекою.

Автоматична установка

Починаючи з версії 1.0.5, встановлювати сторонні бібліотеки можна у середовищі розробки.

Не розпаковуйте архів з бібліотекою - залиште його, як є.

У середовищі розробки Ардуїно виберіть меню Sketch > Import Library. У самому верху списку виберіть пункт Add Library(Додати бібліотеку).

З'явиться діалогове вікно, яке пропонує вам вибрати бібліотеку, яку ви хотіли б додати. Перейдіть до завантаженого zip-файлу та відкрийте його.

Знову відкрийте меню Sketch > Import Library. Ви повинні побачити нову бібліотеку в самому низу списку. Тепер бібліотеку можна використовувати у програмах.

zip-файл буде вже розпакований у директорії librariesвсередині вашої робочої папкиАрдуїно.

Примітка: після виконання вказаних дій бібліотеку можна буде повноцінно використовувати у своїх програмах, проте приклади зі встановленої бібліотеки з'являться в меню File > Examplesтільки після перезапуску середовища Ардуїно.

Встановлення вручну

Перед встановленням бібліотеки закрийте середовище розробки Ардуїно.

Потім розпакуйте ZIP-архів із бібліотекою. Допустимо, ви встановлюєте бібліотеку "ArduinoParty" - розпакуйте файл ArduinoParty.zip. У ньому має бути папка ArduinoPartyз файлами ArduinoParty.cppі ArduinoParty.h. (Якщо файли з розширенням .cppі .hлежать не в папці, необхідно її створити. У цьому випадку вам потрібно створити папку з ім'ям ArduinoPartyі перенести до неї всі файли із ZIP-архіву, наприклад - ArduinoParty.cppі ArduinoParty.h).

Перетягніть папку ArduinoPartyдо директорії з бібліотеками Ардуїно. У Windows вона лежатиме приблизно тут: "My Documents\Arduino\libraries", у користувачів Mac - тут: "Documents/Arduino/libraries", а в Linux-системах директорія " librariesбуде всередині робочої папки зі скетчами.

Після переміщення ваша директорія з бібліотеками має виглядати приблизно так (під Windows):

My Documents\Arduino\libraries\ArduinoParty\ArduinoParty.cpp My Documents\Arduino\libraries\ArduinoParty\ArduinoParty.h My Documents\Arduino\libraries\ArduinoParty\examples ....

або так (на Mac):

Documents/Arduino/libraries/ArduinoParty/ArduinoParty.cpp Documents/Arduino/libraries/ArduinoParty/ArduinoParty.h Documents/Arduino/libraries/ArduinoParty/examples ...

та аналогічно на Linux.

Крім файлів .cppі .hтут можуть бути інші файли - просто переконайтеся, що всі вони тепер лежать тут.

(Якщо файли .cppі .hрозташовані в корені папки "libraries" або вкладені всередину ще однієї папки, то завантажена бібліотека не працюватиме. Наприклад:

Documents\Arduino\libraries\ArduinoParty.cpp and Documents\Arduino\libraries\ArduinoParty\ArduinoParty\ArduinoParty.cpp

Чи не робочий приклад.)

Перезапустіть середу Ардуїно. Переконайтеся, що нова бібліотека з'явиться у меню Sketch->Import Library.

Ось і все! Ви встановили бібліотеку!

Текст цього посібника опубліковано під ліцензією Creative Commons Attribution-ShareAlike 3.0 . Приклади коду, що зустрічаються у посібнику, є вільним контентом.

Бібліотеки Arduino являють собою найбільш зручний спосіб поділу коду на кшталт коду драйверів пристроїв або часто використовуваних корисних функцій. У цьому матеріалі буде показано, як встановити бібліотеки Arduino для Windows, Mac OSX та Linux, а також будуть розглянуті загальні проблеми, пов'язані з бібліотеками Arduino. Стаття буде корисна новачкам, втім, і затяті користувачі Arduino можуть дізнатися про щось нове. Існує два типи бібліотек: стандартні та користувацькі бібліотеки.

Стандартні бібліотеки ArduinoСередовище розробки Arduino IDE постачається разом із набором стандартних бібліотек основних корисних функцій. Ці бібліотеки підтримують усі приклади, включені до IDE. Функціонал стандартних бібліотеквключає функції базових видів комунікації і підтримує найбільш поширені пристрої на кшталт сервомоторів і символьних LCD-дисплеїв. Стандартні бібліотеки розташовуються в каталозі Libraries (у папці Arduino IDE). Якщо у вас встановлені IDE різних версій, то кожна з них використовуватиме свої бібліотеки.

Користувальницькі бібліотекиСьогодні існує велика кількістьбібліотек для більшої функціональності та для різних пристроїв. Такі бібліотеки та драйвери найчастіше доступні на Arduino Playground, Github та Google Code. Ці бібліотеки бажано встановлювати в папку Libraries, яку потрібно створити в спільної папкиіз вашими скетчами. Тоді всі версії IDE можуть використовувати ці бібліотеки. У Windows та Mac OS зазвичай папка зі скетчами називається Arduino і розташовується в папці Документи або Documents. Для Linux папка називається Sketchbook, і вона розташована в /home/(username).

Версії IDE 1.0.2 створюють папку Libraries автоматично, молодші версії цього робити не вміють, тому цю процедуру потрібно виконати вручну. Для початку відкрийте File-Preferences (Файл-Параметри).

Знайдіть розташування папки зі скетчами (Sketchbook location).

Створіть там нову папкута назвіть її Libraries.

Встановлюємо бібліотеки Arduino під WindowsДля початку закрийте Arduino IDE, оскільки це середовище сканує наявність бібліотек лише під час запуску. Скачайте необхідну вам бібліотеку у zip-архіві, наприклад, з Github.

Відкрийте zip-файл та розархівуйте бібліотеку в папку Libraries.

Дайте бібліотеці нормальне ім'я. Наприклад, IDE не сприйме бібліотеку з дефісами у назві.

Запустіть IDE та зайдіть у File-Examples (Файл-Приклади). Там розташовуватимуться приклади, що використовують можливості нової бібліотеки.

Відкрийте приклад і скомпілюйте його, щоб переконатися, що все працює правильно.

Встановлюємо бібліотеки Arduino для Mac OSX

Закрийте IDE Arduino. Завантажте zip-файл із репозиторію.

Знайдіть завантажену бібліотеку в папці Downloads. OSX автоматично відкриє zip-файл у дане місце розташування.

Перемістіть бібліотеку до папки Libraries.

Встановлюємо бібліотеки Arduino для LinuxЗакрийте IDE Arduino. Завантажте zip-файл із репозиторію.

Збережіть zip-файл у зручному для вас місці.

Відкрийте файл і розпакуйте вміст у папку Sketchbook/Libraries.

За потреби дайте бібліотеці зрозуміле ім'я без дефісів та інших зайвих символів. Перезапустіть IDE та відкрийте один з прикладів.

Його компіляція без помилок означатиме правильність встановлення бібліотеки.

Поширені проблеми, пов'язані з бібліотеками Arduino

"xxxx" does not name a type- Це найбільш часта помилкаі пов'язана вона з тим, що компілятор не може знайти бібліотеку. Це може бути з таких причин: бібліотека не встановлена, неправильне розташування папки, неправильне найменування папки, неправильне найменування бібліотеки, залежність бібліотеки, не перезапущено середовище Arduino IDE.

Неправильне розташування папки- IDE шукає бібліотеки тільки в папці стандартних бібліотек та папці бібліотек користувача. Бібліотеки, які знаходяться в інших місцях, просто недоступні для пошуку. Також бібліотеку не можна організовувати як підкаталог усередині іншого каталогу.

Неправильне найменування папки- Як раніше було зазначено, IDE не зрозуміє назви, що містять символ '-'. Зазвичай його замінюють на _.

Неправильне найменування бібліотеки- Назва, що йде після #include у вашій програмі, має повністю відповідати імені бібліотеки.

Неповна бібліотека- Ще однією причиною, через яку бібліотека може не заробити, є неповне її скачування з репозиторію. Потрібно завантажувати всі пропоновані файли та папки.

Декілька версій- Якщо у вас є кілька версій бібліотеки, то IDE спробує завантажити їх усі. Це спричинить помилки при компіляції. Недостатньо просто перейменувати бібліотеки, зайві потрібно забрати за межі папки Libraries.

Залежність бібліотеки- Деякі бібліотеки залежать від інших бібліотек, тому потрібно стежити, щоб усі необхідні бібліотеки були запущені.

І не забудьте перезапустити Arduino IDE!

Arduino та радіодеталі недорого в наявності на

У бібліотеці вже є велика частина коду, який вам не потрібно буде писати, бібліотека полегшує роботу з певним модулем або одним з їх типів і її лише необхідно підключити у вашому скетчі.

Наприклад, якщо ви хочете вивести текст на LCD дисплей без підключення бібліотеки, то Вам потрібно передати йому кілька байт команд і даних, що займе кілька рядків коду, а головне, що Вам потрібно знати тип мікроконтролера під керуванням якого працює LCD дисплей, призначення команд якими Він управляється, знає архітектуру його пам'яті, адреси і призначення регістрів, для чого потрібно знайти і перечитати його дані.

У той час як при написанні коду з використанням бібліотеки (наприклад LiquidCrystal_I2C.h) Ви зможете вивести текст на дисплей, викликавши лише одну функцію бібліотеки:

lcd.print(“my text”);

Підключити будь-яку бібліотеку можна такою командою:

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

<файл.h>– це і є та сама бібліотека, яку ми підключаємо.

Також ви можете подивитися приклад підключення бібліотеки у статті.

Перед тим як почати користуватися методами та функціями бібліотеки, її потрібно:

• скачати (завантажити на Ваш комп'ютер),
• встановити (Розмістити в потрібній папці),
• підключити (Вставити текст “#include<файл.h>” у скетч).

Кожна бібліотека повинна містити два файли з розширеннями .hі .cpp.

Файли першого типу містять:

• опис класу,
• константи,
• змінні.

Другий тип містить коди методів.

Додатково потрібно розуміти, що файли .hі .cppможуть не лежати в корені завантаженого архіву. Також можуть з основними файлами йти "keywords.txt" та папка з прикладами (examples).

Як установити бібліотеку?

Після того як Ви завантажили бібліотеку на свій комп'ютер, її потрібно встановити. Встановити бібліотеку можна вручну або зробити це засобами Arduino IDE:

Установка бібліотеки за допомогою Arduino IDE

Це ми зробимо через меню. Зайдіть у меню:

Скетч - Підключити бібліотеку – Додати.ZIP бібліотеку

У вікні, натисніть на іконку «Цей комп'ютер» і виберіть папку «Завантаження». Якщо при завантаженні ZIP архіву з сайту Ви вказували шлях для збереження файлу, то замість папки «Завантаження» вкажіть шлях до файлу.

Виберіть ZIP файл бібліотеки, який Ви завантажили. Назва файлу може не відповідати назві бібліотеки. Після чого натисніть кнопку « Відкрити » ( Open ).

На цьому установка бібліотеки завершена, можна приступити до її підключення до скетчу.

Важливо! Після інсталяції Arduino IDE на комп'ютері створюється окрема папказберігання всіх бібліотек. Для ОС Linux "Scetchbook", знаходиться в /home/. Для ОС Windows папка"Arduino", знаходиться в /Мої документи/.

Встановлення бібліотеки вручну

Розпакуйте завантажений Вами ZIP архів і помістіть папку (ім'я папки зазвичай збігається з назвою бібліотеки) з даного архіву до папки:

Цей комп'ютер → Документи → Arduino → libraries

Якщо під час копіювання Arduino IDE було запущено (відкрито), потрібно закрити всі вікна цієї програми, після чого запустити (відкрити) Arduino IDE і можна приступати до підключення бібліотеки в скетч.

Справа в тому, що програма постійно розвивається і кількість її версій невпинно зростає. Якщо Ви захочете встановити нову версію Arduino IDE, бібліотеки знаходяться в папці ( Цей комп'ютер → Документи → Arduino → libraries)будуть доступні і в старій, і в новій (встановленій) версії Arduino IDE, а бібліотеки в папці librariesпрограми Arduino IDE старої версії (яку було встановлено раніше) будуть доступні лише у ній (поки Ви їх скопіюєте в нову).

Де знайти потрібну бібліотеку?

Для зручності на нашому сайті є цілий розділ, який так і називається. Більшість бібліотек можна знайти в Інтернеті у відкритому доступі.

Також ряд стандартних наборівможна знайти на офіційному сайті Ардуїно: arduino.cc.

Які бібліотеки вже встановлені?

Як ми вже обговорювали - саме інтегроване середовище розробки вже йде з деяким.

Є два способи переглянути встановлені бібліотеки.

Спосіб 1

Щоб переглянути який набір вже встановлено, потрібно перейти у вкладку:

Спосіб 2

Другий спосіб - скористатися меню "Скетч" та підменю "Підключити бібліотеку". У такий спосіб можна також побачити список бібліотек.

Заходимо до Скетчу та вибираємо Підключити бібліотеку:

Скетч → Підключити бібліотеку

Можливі помилки

Іноді під час встановлення бібліотек або в процесі їх використання можуть виникати деякі помилки. Нижче розберемо основні.

'xxxx' does not name a type

Помилка з'являється, коли бібліотека ще не встановлена.

Також помилка виникає, якщо папка або бібліотека має неправильну назву.

Може бути вказана неправильна адреса розташування папки або не перезапущено середовище розробки Arduino IDE!

Неправильне розташування папки

Перевірте, чи всі бібліотеки знаходяться на потрібній адресі. Адреси папок для різних операційних системми наводили вище.

Неправильне найменування бібліотеки

Помилка з'являється тоді, коли ім'я #include не відповідає назві бібліотеки.

Неповна бібліотека

Не вистачає всіх потрібних файлівта папок.

Залежність бібліотеки

Необхідно підключити додаткові залежні бібліотеки, без яких правильна/коректна робота неможлива.