Библиотеки Arduino

Библиотеки — это файлы, которые предоставляют вашим скетчам дополнительную функциональность.

Библиотеки — это файлы, написанные на C или C++ (.c, .cpp), которые обеспечивают ваши скетчи дополнительной функциональностью (например, возможностью управлять светодиодной матрицей или считывать данные с энкодера и т.д.). Они были введены в Arduino 0004.

Чтобы использовать существующую библиотеку в скетче, просто перейдите в меню Sketch, выберите «Import Library» и выберите одну из доступных библиотек. Это добавит оператор #include в начало скетча для каждого заголовочного файла (.h) в папке библиотеки. Эти операторы делают публичные функции и константы, определённые в библиотеке, доступными для вашего скетча. Они также сигнализируют среде Arduino о необходимости связать код этой библиотеки с вашим скетчем при его компиляции или загрузке.

Пользовательские библиотеки начиная с версии 0017 размещаются в подкаталоге вашей стандартной папки скетчей. Например, в OSX это будет ~/Documents/Arduino/libraries/. В Windows — My Documents\Arduino\libraries. Чтобы добавить собственную библиотеку, создайте новый каталог в папке libraries с именем вашей библиотеки. Папка должна содержать файл C или C++ с вашим кодом и заголовочный файл с объявлениями функций и переменных. После этого библиотека появится в меню Sketch | Import Library в Arduino IDE.

Примечание

Для пользователей версий до 0017: библиотеки располагались в подкаталоге каталога приложения Arduino: ARDUINO/lib/targets/libraries. В версии 0017 каталог библиотек был перемещён для более удобной установки и использования.

Поскольку библиотеки загружаются на плату вместе с вашим скетчем, они увеличивают объём занимаемого пространства на ATmega8 на плате. Ознакомьтесь с FAQ для объяснения различных ограничений памяти и советов по уменьшению размера программы. Если скетч больше не нуждается в библиотеке, просто удалите её операторы #include из начала вашего кода. Это предотвратит связывание библиотеки Arduino IDE с вашим скетчем и уменьшит объём занимаемого пространства на плате Arduino.

Чтобы начать писать библиотеки, скачайте эту тестовую библиотеку. Она должна предоставить базовый шаблон для создания новой библиотеки. После внесения изменений в вашу библиотеку, для её перекомпиляции вам нужно будет удалить файл .o, сгенерированный в каталоге библиотеки.