Что такое библиотеки для ардуино
Что такое библиотеки для ардуино
Как только вы освоитесь с программным обеспечением Ардуино и в совершенстве овладеете стандартными функциями, вам наверняка захочется расширить возможности вашего Ардуино с помощью дополнительных библиотек.
Что такое библиотека?
Как установить библиотеку
Чаще всего библиотеки выкладываются в виде ZIP-архива или просто папки. Название этой папки является названием библиотеки. Внутри папки будет файл с расширением .cpp, файл с расширением .h, а также текстовый файл keywords.txt, папка с примерами examples и другие файлы, требуемые библиотекой.
Автоматическая установка
Начиная с версии 1.0.5, устанавливать сторонние библиотеки можно прямо в среде разработки.
В среде разработки Ардуино выберите меню Sketch > Import Library. В самом верху выпадающего списка выберите пункт Add Library (Добавить библиотеку).
Появится диалоговое окно, предлагающее вам выбрать библиотеку, которую вы хотели бы добавить. Перейдите к скачанному zip-файлу и откройте его.
Снова откройте меню Sketch > Import Library. Вы должны увидеть новую библиотеку в самом низу выпадающего списка. Теперь библиотеку можно использовать в программах.
zip-файл будет уже распакован в директории libraries внутри вашей рабочей папки Ардуино.
Примечание: после выполнения указанных действий библиотеку можно будет полноценно использовать в своих программах, однако примеры из установленной библиотеки появятся в меню File > Examples только после перезапуска среды Ардуино.
Установка вручную
Перед установкой библиотеки закройте среду разработки Ардуино.
После перемещения ваша директория с библиотеками должна выглядеть примерно так (под Windows):
и аналогично на Linux.
(Если файлы .cpp и .h расположены в корне папки «libraries» или вложены внутрь еще одной папки, то скачанная библиотека работать не будет. Например:
Перезапустите среду Ардуино. Убедитесь, что новая библиотека появилась в меню Sketch->Import Library.
Вот и все! Вы установили библиотеку!
В основе этого урока лежит текст автора Limor Fried.
Текст данного руководства опубликован под лицензией Creative Commons Attribution-ShareAlike 3.0. Примеры кода, встречающиеся в руководстве, являются свободным контентом.
Библиотеки
Очень часто одни и те же части кода кочуют из программы в программу. Например, код для работы с датчиком. Чтобы не писать этот код каждый раз заново, его выносят в отдельные файлы — библиотеки. Огромное количество готового кода уже написано другими людьми, и с помощью библиотек его можно легко использовать в своих программах.
Подключение библиотек
Библиотеки в составе Arduino IDE
Очень много библиотек идет в составе Arduino IDE. Добавить библиотеку в свой код можно из меню Эскиз Импорт библиотек… Название библиотеки :
После выбора пункта «Servo» Arduino IDE сама вставит в код нужные строчки:
Конечно, если вы знаете название нужной библиотеки, можно просто написать в самом верху скетча #include — результат будет тем же самым.
Чтобы посмотреть пример работы с библиотекой, идущей в составе Arduino IDE необходимо выбрать в меню Файл Образцы Название библиотеки Название примера
Сторонние библиотеки
Библиотек для Arduino действительно очень много. И только незначительная часть из них входит в состав Arduino IDE. Многие библиотеки можно найти на сайте GitHub.
В Arduino 1.6.7 и выше: Файл Примеры Название библиотеки Название примера
Создание библиотеки
Обычно, при создании библиотеки создаются два файла: заголовочный файл и файл с кодом библиотеки. Давайте попробуем написать библиотеку, которая бы позволяла нам посчитать площадь круга. Создадим в директории %Sketchbook%\Arduino\libraries папку с названием нашей библиотеки (название может состоять только из латинских букв и цифр, при этом не может начинаться с цифры). Давайте назовём нашу библиотеку circleArea. Перейдём в созданную нами папку %Sketchbook%\Arduino\libraries\circleArea и создим там два файла:
Код circleArea.h будет таким:
Код circleArea.cpp будет таким:
Использование библиотеки в скетче будет таким:
Arduino — библиотеки. Установка, подключение, удаление
Одной из причин популярности Arduino является простота использования разнообразных периферийных устройств (модулей): дисплеев, драйверов двигателей, модулей беспроводной связи (Bluetooth, wi-fi, XBee или ISM) и т. д.
Программная среда Arduino (IDE) включает в себя множество полезных функций, облегчающих создание программ для новых проектов. Но, к сожалению, она не может иметь встроенную поддержку для каждого вновь появившегося нового оборудования (модуля) или компонента программного обеспечения.
Вместо этого осуществляется поддержка «библиотек», которые являются автономными модулями, предназначенными для расширения программной среды, добавления определенных функций или аппаратной поддержки.
Основным источником библиотек для Arduino являются производители аппаратного обеспечения, создающие их для обеспечения поддержки в IDE Arduino.
Где можно найти библиотеки к Ардуино
Если вам нужна поддержка Arduino для определенного оборудования (модуля), попробуйте просмотреть сайт производителя модуля. Вы также можете посетить сайт Arduino, в котором собрано множество популярных библиотек.
В противном случае попробуйте выполнить поиск в Google, например, наберите «Arduino library» и название вашего оборудования.
Как подключить библиотеку в Ардуино
Как было уже сказано выше, в среде разработки Arduino есть предустановленные библиотеки. Чтобы функции библиотеки были доступны в нашей программе сначала необходимо ее подключить. Для этого используется директива #include.
Подключение встроенной библиотеки вызывается из меню «Скетч — Подключить библиотеку — …» далее выбираем необходимую библиотеку (в нашем случае «Servo»).
При выборе библиотеки, Arduino IDE автоматически добавит в ваш код соответствующую директиву #include.
Как добавить библиотеку в Ардуино
Если в IDE нет необходимой предустановленной библиотеки, то ее необходимо установить самостоятельно. Для этого есть 2 способа.
Первый способ: Добавление библиотеки из репозитория Ардуино.
Создатели Arduino разместили в интернете базу различных библиотек. Если вам не хватает какой-то библиотеки, то вы можете поискать ее в репозитории. Для этого выберите в меню «Скетч – Подключить библиотеку – Управлять библиотеками».
В этом окне вы можете скачать из интернета новую или обновить уже существующую библиотеку.
Второй способ: Добавление библиотеки, скаченной из интернета.
Поскольку в среде Arduino почти все легко и просто, установка дополнительных библиотек тоже не вызывает больших сложностей. В качестве примера мы покажем установку библиотеки для работы с радиомодулем системы беспроводной связи NRF24L01 от компании Nordic Semiconductor.
Библиотеки для Arduino, предназначенные для самых популярных модулей доступны на странице http://arduino.cc/libraries. Программное обеспечение (библиотеки) для менее популярных модулей, как правило, находятся на сайтах производителей этих модулей.
После того как вы скачали архив библиотеки arduino-nrf24l01-master.zip, необходимо ее установить в IDE. Для этого перейдите в меню «Скетч – Подключить библиотеку – Добавить ZIP библиотеку»
Затем укажите местоположение скаченного файла arduino-nrf24l01-master.zip и нажмите кнопку Open.
После этого, как правило, мы имеем установленную библиотеку. Но, к сожалению, часто бывает так, что Arduino сигнализирует ошибку «Выбранная папка/zip файл не содержит корректных библиотек»
В таком случае библиотеку можно установить вручную. Для этого необходимо распаковать скачанный файл arduino-nrf24l01-master.zip и папку «Mirf» скопировать в папку «libraries». Либо можно поместить папку «Mirf» в C:\….\Documents\Arduino\libraries (тогда библиотека будет доступна из IDE разных версий).
После перезагрузки IDE Arduino мы можем подключить данную библиотеку, а также воспользоваться примерами для радиомодуля NRF24L01
Как удалить библиотеку в Aрдуино
Если вы разобрались, как можно установить новую библиотеку в IDE, то для вас не будет проблемой и с ее удаление (в случае необходимости).
Все, что требуется от вас для удаления библиотеки, это удалить папку библиотеки из каталога «libraries» в IDE или (если библиотека установлена в «Документы») из каталога C:\….\Documents\Arduino\libraries
Установка и подключение библиотек Arduino
Стандартные библиотеки Arduino хранятся в папке:
«C:\Program Files (x86)\Arduino\libraries\»
Дополнительные библиотеки устанавливаются в папку:
В вашем случае эти пути могут быть другими из-за другой буквы основного жесткого диска и другого имени пользователя. Если у вас установлена 32х битная операционная система то папка «Program Files (x86)» будет называться «Program Files».
Установка библиотек Arduino
Установить библиотеки в Arduino IDE очень просто. Можно сделать это двумя способами. Через интерфейс программы или копированием скачанной библиотеки в папку «libraries». Рассмотрим подробнее оба варианта:
Установка библиотек через Arduino IDE
Установка библиотек ардуино
После этого откроется окно со списком доступных библиотек. Для того что бы найти нужную библиотеку можно воспользоваться поиском или выбрать необходимый раздел. Для установки библиотеки необходимо выбрать ее из списка, нажав на название, и кликнуть по появившейся кнопке «Установить».
Установить библиотеки Arduino
Еще один способ установки библиотек Ардуино
Вы можете просто перенести папки библиотек по пути:
«C:\Program Files (x86)\Arduino\libraries\»
После того как вы добавили свои библиотеки необходимо перезапустить Arduino IDE. Теперь вы можете использовать сторонние библиотеки в своих проектах.
Подключение библиотеки Arduino
Мало установить библиотеку. Для использования ее необходимо подключить в скетч. Сделать это очень просто. Можно в начале скетча вручную написать подобную строчку:
1 комментарий
Ваш сайт в стандартном браузере майнкрософт едж отображается не корректно!
Добавить комментарий Отменить ответ
Для отправки комментария вам необходимо авторизоваться.
Библиотеки Arduino: подключение, установка, импорт.
Что такое библиотеки?
Плата Ардуино, подключение библиотек.
Вопрос «как подключить библиотеку в Ардуино IDE» беспокоит многих начинающих пользователей плат Arduino. Процесс подключения незамысловатый, и выполняется буквально в пару кликов. Рассмотрим на примере подключение библиотеки Arduino для серво машин.
Если у вас возникают проблемы с навигацией по IDE, или ваш IDE не русифицирован, рекомендую ознакомиться с описанием Arduino IDE.
Ардуино установка библиотек
Вот и все, в окне редактора кода мы видим необходимую нам библиотеку и можем продолжить писать код.
Подключение библиотеки Ардуино
Как добавить библиотеку в Ардуино IDE?
Часто возникают случаи когда мы не находим в списке предустановленных библиотек необходимую нам библиотеку. Возникает задача, как установить библиотеку Ардуино. Для решения этой задачи существую три метода:
Установка библиотеки из менеджера библиотек в IDE.
Поздравляю, библиотека установлена. Переходим в меню Скетч\Подключить библиотеку, в выпадающем списке видим нашу установленную библиотеку.
Импорт библиотеки из zip-файла.
Часто возникает необходимость установить библиотеку, отсутствующую в списке менеджера библиотек, как же тогда загрузить библиотеку в ардуино IDE. Да очень просто. С помощью поисковиков, таких как Яндекс или Google находим в интернете нужную нам библиотеку и скачиваем на ПК в zip-файле. Не забудьте, куда скачали файл. Далее:
Теперь вы можете найти эту библиотеку в опции «Включить библиотеку» и использовать по назначению.
Добавления файла библиотеки вручную.
Ручная загрузка библиотеки в ардуино IDE подразумевает сохранение папки с файлами библиотеки в папку Ардуино IDE «libraries». Таких папок две. Первая находится по адресу:
Вторая папка там, где вы указали в настройках Ардуино IDE. Если вы не указывали, куда сохранять библиотеки, то по умолчанию эта папка находится по адресу Документы/Arduino.