Что такое библиотека и зачем она нужна

Чтобы датчик температуры заработал, нужно знать его протокол, тайминги и регистры — или подключить библиотеку, где всё это уже написано. Библиотека — главный ускоритель в мире Arduino: чужой проверенный код, который превращает сложное железо в одну понятную команду.

Как это выглядит в коде

Библиотека подключается строчкой #include в начале скетча — а дальше вы пользуетесь её командами как родными. Вместо сотни строк работы с протоколом датчика — sensor.readTemperature(). Именно так устроены почти все проекты: немного вашей логики поверх библиотек, написанных сообществом.

Разница видна на одном примере. Вот управление сервоприводом без библиотеки — импульсы приходится формировать вручную, и код молчит о том, что вообще происходит:

// Управление сервоприводом без библиотеки: импульс нужной длины
// нужно формировать вручную, и так — каждые 20 миллисекунд.
const int SERVO_PIN = 9;

void setup() {
  pinMode(SERVO_PIN, OUTPUT);
}

void loop() {
  // 1500 микросекунд — среднее положение. Считать это в градусах
  // и следить за паузами приходится самому.
  digitalWrite(SERVO_PIN, HIGH);
  delayMicroseconds(1500);
  digitalWrite(SERVO_PIN, LOW);
  delay(20);
}

А вот то же самое с библиотекой — одна строка #include, и вместо микросекунд появляются градусы:

#include <Servo.h>  // одна строка — и появляются готовые команды

Servo myServo;

void setup() {
  myServo.attach(9);  // сервопривод подключён к выводу 9
}

void loop() {
  myServo.write(0);    // повернуть в 0 градусов
  delay(1000);
  myServo.write(90);   // в середину
  delay(1000);
  myServo.write(180);  // и до упора
  delay(1000);
}

Код стал короче втрое и, что важнее, читается вслух: «повернуть в девяносто градусов». Библиотека не добавила возможностей плате — она перевела разговор на человеческий язык.

Откуда берутся библиотеки в Trema IDE

Из каталога libraries.trema.ru — российского реестра, где собрано почти десять тысяч библиотек: датчики, экраны, моторы, связь, хранение данных. Установка — в пару кликов через менеджер библиотек, зависимости приезжают сами, а если открытому проекту чего-то не хватает, программа сама предложит доустановить.

Что даёт установленная библиотека

• Команды — функции для работы с железом, сразу с подсветкой в редакторе.
• Примеры — готовые скетчи автора библиотеки появляются в меню примеров: лучший способ понять, как ей пользоваться.
• Совместимость — хорошие библиотеки работают на разных платах; в каталоге архитектуры видны бейджами (AVR, ESP32 и т.д.).

Куда дальше

Практика — в статье «Установка из каталога»; устройство самого каталога — в «Каталог libraries.trema.ru»; а если сборка ругается на отсутствующую библиотеку — разбор в «Библиотека не найдена».

Частые вопросы

Читайте также

• Установка библиотеки из каталогаПоиск, клик, готово: путь от «нужен датчик» до работающей команды — меньше минуты.
• Каталог libraries.trema.ruПочти 10 000 библиотек с русскими описаниями, поиском по include и зеркалом в России.
• Версии библиотек: обновить или закрепитьНовая версия — не всегда благо посреди четверти: как управлять версиями осознанно.
• Зависимости: библиотеки, которым нужны библиотекиПочему «поставил одну — установились три» — это правильно, и как Trema IDE делает это сама.

• Как установить библиотеку