Как создать и добавить библиотеку в Ардуино

Как самому написать или редактировать библиотеку для Ардуино, а затем установить ее? Если вы ищете в Интернете ответ на этот вопрос, то вы достаточно хорошо знакомы с языком программирования Arduno и знаете, что библиотеки значительно облегчают работу с этой платой. Рассмотрим пример написания библиотеки в Arduino IDE, как установить новую библиотеку и подключить ее в скетче для выполнения различных операций.

Дополнительные материалы на эту тему:

1. Список популярных библиотек для Ардуино
2. Ошибки компиляции для плат Ардуино Уно
3. Типы данных, типы переменных в Ардуино

В Arduino IDE есть много стандартных библиотек с примерами и множество других библиотек для различных датчиков и модулей, которые можно скачать из Интернета. Для мигающего светодиода используется довольно простая программа, которая рассмотрена в Уроках по Ардуино. В этом обзоре мы создадим файлы с помощью которых можно включать и выключать светодиод заданное количество раз с помощью одной команды.

Как создать новую библиотеку в Ардуино

1. Перейдите в каталог …Documents\Arduino\libraries
2. Создайте папку с названием BlinkLed
3. Создайте текстовый документ BlinkLed.h
4. Создайте текстовый документ BlinkLed.cpp
5. Создайте текстовый документ keywords.txt

Все, что нужно для создания новой библиотеки — это текстовый редактор «Блокнот». Первое, что нужно сделать, это создать папку для библиотечных файлов Arduino IDE в директории …Documents\Arduino\libraries. Имя папки и имена создаваемых файлов, могут быть любыми, но должны быть одинаковыми у всех файлов. Для примера будем использовать имя «BlinkLed», которое характеризует назначение библиотеки.

Как редактировать библиотеку в Ардуино

Каждая библиотека для Arduino IDE должна содержать минимум два файла. Первый — это заголовочный файл (с расширением .h), который содержит описание класса и включает переменные. Второй файл исходного кода (с расширением .cpp). Файл keywords.txt является необязательным и используется при работе с утилитой Arduino IDE только для выделения цветом типов и методов новой библиотеки (оранжевый и синий цвет функций).

Создание файла с расширением .h — BlinkLed.h

Заголовочный файл BlinkLed.h содержит класс с объявлением функций, которые будут использоваться в коде (в нашем примере blink) и переменные. Запишите следующий код в файл BlinkLed.h и сохраните его в папке BlinkLed, которую ранее создали.

#include "Arduino.h"
void blink (int pin, int pause, int repeat);

Создание файла с расширением .cpp — BlinkLed.cpp

Исходный файл с расширением .cpp содержит основной код. В примере для мигания светодиодом используются три переменные, которые должны быть созданы: pin — номер порта, pause — время паузы в миллисекундах, repeat — сколько раз выполнится цикл for.

#include "Arduino.h"
#include "BlinkLed.h"

void blink (int pin, int pause, int repeat) {

   pinMode(pin, OUTPUT);

   for (int x=0; x<=repeat; x++) {
        digitalWrite(pin, HIGH);
        delay(pause);
        digitalWrite(pin, LOW);
        delay(pause); 
   }
}

Создание файла keywords.txt для библиотеки

Файл keywords.txt задает цвет синтаксиса в утилите Arduino IDE для новых команд из нашей библиотеки. Функция KEYWORD1 окрашивает слово в оранжевый цвет, например, как random или randomseed. Функция LITERAL1 окрашивает слово в синий цвет.

	BlinkLed	KEYWORD1
	blink		KEYWORD1

Как добавить библиотеку в Ардуино

Чтобы светодиод мигал определенное количество раз, необходимо использовать цикл for, в котором можно установить счетчик для повторения. Используя новую библиотеку, вместо указания номера порта в команде pinMode, создания цикла for в скетче с задержкой delay, мы просто вводим переменные, которые используются в программе. Добавив собственную библиотеку BlinkLed.h в скетч можно управлять миганием светодиода одной командой.

// добавление библиотеки в скетч
#include "BlinkLed.h"

void setup() {
  // указываем: номер пина, задержку, число повторений
  blink (13, 500, 10);
}

void loop() {
 
}

Заключение. На этом создание новой библиотеки для Arduino завершено. В папке BlinkLed можно также создать папку examples для примеров со скетчами, куда можно сохранить данную программу. Когда вы откроете утилиту Arduino IDE, то нашу новую библиотеку можно найти через панель инструментов File > Examples / BlinkLed. Теперь вы можете мигать светодиодом с помощью одной команды и создать собственную библиотеку.