Классы и объекты в Arduino: с нуля до собственного класса
Arduino работает на C++, а Arduino Language — это вариант C++, который поддерживает объектно-ориентированное программирование ООП . На практике это значит: помимо привычных setup и loop у тебя есть очень удобный механизм — классы.
Arduino работает на C++, а Arduino Language — это вариант C++, который поддерживает объектно-ориентированное программирование (ООП). На практике это значит: помимо привычных setup() и loop() у тебя есть очень удобный механизм — классы. Класс позволяет упаковать устройство — светодиод, датчик или реле — вместе с его поведением в один «коробок», чтобы скетч не превратился в кучу глобальных переменных.
В этой статье мы разберём базу по шагам. Пример — самый простой из возможных, светодиод, — а объяснения — без лишней теории.
Что такое класс и что такое объект
В C++ класс — это кодовый шаблон для определения объектов. Простая аналогия: класс — это форма, а объект — отливка из этой формы.
Официальное руководство по созданию библиотек для Arduino формулирует ещё проще: класс — это просто коллекция функций и переменных, которые хранятся вместе в одном месте.
Посмотрим на светодиод. Вот класс:
class LED {
public:
byte pin;
void toggle(void) {
pinMode(pin, OUTPUT);
digitalWrite(pin, !digitalRead(pin));
delay(1000);
}
};
Внутри — переменная pin (к какому ножке подключён светодиод) и функция toggle() (переключить светодиод). Переменные — это свойства, функции — это действия. Больше внутри класса по сути ничего нет.
Объект — это конкретный экземпляр класса:
LED led;
Объект led — это «твой» светодиод, со своим номером ножки. Если светодиодов два, создаёшь два объекта:
LED led1;
LED led2;
Каждый объект хранит свои собственные данные: у led1 — своя ножка, у led2 — своя.
Что лежит внутри класса: переменные и функции
Переменные, которые принадлежат классу, называют member variables (переменные-члены), а функции — member functions (функции-члены, или методы).
У Adafruit есть наглядный пример: код мерцающего светодиода без блокирующих задержек — переменные ledPin, OnTime, OffTime, ledState, previousMillis — собирают в класс Flasher, а функцию loop() просто переименовывают во member function Update(). Всё то же самое, только собрано в одном месте.
Именно в этом главная польза: состояние (данные) и поведение (функции) живут вместе, и скетч перестает «рассыпаться» по глобальным переменным.
Кто может к чему прикасаться: private, public, protected
У класса три уровня доступа:
- public — члены доступны из любого места, где виден объект;
- protected — доступны классу самому и классам, которые от него наследуются;
- private — доступны только внутри того же класса.
Здесь есть важное замечание: в классе члены по умолчанию private. Если ты не указал уровень доступа, компилятор считает, что ты имел в виду private. Это главное отличие класса от struct — в struct члены по умолчанию public.
Зачем прятать данные? Это называется инкапсуляция: сделать члена private — один из способов защитить данные от внешнего вмешательства. Простой пример:
class LED {
public:
LED(int p) {
pinMode(p, OUTPUT);
pin = p;
}
void toggle(void) {
digitalWrite(pin, !digitalRead(pin));
delay(1000);
}
private:
int pin;
};
Теперь переменная pin — private, и из внешнего кода её не поменять: номер ножки передаётся через конструктор, а дальше класс сам управляет своими данными.
Конструктор: объект готовит себя сам
Конструктор — это особая функция, которая называется так же, как класс, и у неё нет типа возврата — даже void. Она вызывается автоматически при создании объекта.
В примере выше конструктор — функция LED(int p). Использование:
LED led(9);
Всё: объект led создан, конструктор выполнился, ножка 9 задана как OUTPUT и запомнена внутри класса. Писать led.pin = 9 в setup() больше не нужно — объект сам себя подготовил.
Работа конструктора — инициализировать все переменные объекта. Так работает Flasher от Adafruit: Flasher(int pin, long on, long off) принимает номер ножки и длительности включения/выключения, вызывает pinMode и обнуляет состояние.
Один класс — много объектов
На этом месте классы начинают окупаться. Возьмём пример из официальной документации Arduino: класс Morse кода, у него private-переменная _pin и public-функции begin(), dot(), dash().
#include <Morse.h>
Morse morse(13);
void setup() {
morse.begin();
}
void loop() {
morse.dot(); morse.dot(); morse.dot();
morse.dash(); morse.dash(); morse.dash();
morse.dot(); morse.dot(); morse.dot();
delay(3000);
}
Нужны два светодиода — один на 13-й ножке, другой на 12-й? Создаёшь два объекта:
Morse morse(13);
Morse morse2(12);
Вызов morse2.dot() будет мигать на 12-й ножке, потому что _pin внутри этого объекта — 12. Один и тот же код, два независимых устройства, и ни одной продублированной строки.
Класс в отдельном файле
Когда скетч растёт, класс удобнее вынести в отдельный файл. В Arduino IDE создаёшь новый таб (или жмёшь Ctrl+Shift+N), называешь файл, например, LED.h, переносишь туда определение класса, а в главном скетче просто подключаешь:
#include "LED.h"
На том же принципе работают и библиотеки Arduino: библиотеке нужны минимум два файла — заголовок (.h) с определениями, то есть списком того, что внутри, и исходник (.cpp) с реальным кодом. Твой LED-класс — в одном шаге от собственной библиотеки, которую можно показать друзьям или выложить в интернет.
Наследование: коротко
Класс может унаследовать члены другого класса. Например, класс реле RELAY, построенный поверх LED:
class RELAY : public LED {
public:
RELAY(int p) : LED(p) {
pinMode(p, OUTPUT);
pin = p;
}
void on(void) { digitalWrite(pin, HIGH); }
void off(void) { digitalWrite(pin, LOW); }
};
RELAY получает от LED всё нужное и добавляет свои методы on() и off(). В этой статье мы не погружаемся в детали — это уже тема для продвинутого уровня, — но хорошо знать, что такой механизм существует.
Важно про память: Arduino — не десктоп
У Arduino ограниченный объём RAM, и есть пара правил, которые стоит выучить сразу:
- Не используй new, delete и класс String внутри loop(). Это вызывает фрагментацию кучи: за дни и недели SRAM превращается в «швейцарский сыр» из непригодных блоков, а потом наступают внезапные сбои malloc и зависание устройства.
- Создавай объекты глобально или внутри setup(). Это статическая аллокация — она не фрагментирует память.
- Виртуальные функции стоят Flash-памяти. Таблица виртуальных функций (vtable) занимает место во Flash, так что на AVR-платах её лучше использовать с осторожностью.
Итого: объект создай один раз — и работай с ним. Создавать и удалять объекты внутри цикла — плохая привычка.
Три частых вопроса новичков
«Почему компилятор ругается, когда я пишу led.pin = 9 извне?» Потому что pin — private, и из внешнего кода к нему нет доступа. Это не баг, а инкапсуляция: класс защищён от случайного изменения «внутренностей». Правильное решение — передать номер ножки через конструктор и дальше обращаться к объекту только через его public-функции.
«В чём разница между class и struct?» Для новичка — в уровне доступа по умолчанию. В class члены по умолчанию private, в struct — public. Поэтому в class важно всегда явно писать public: перед теми членами, которые должны быть доступны снаружи, иначе всё станет закрытым.
«Когда вызывается конструктор?» Автоматически, в момент создания объекта. Ты не пишешь вызова конструктора явно — он происходит сам, как только объект рождается. Именно поэтому строка LED led(9); уже означает и создание, и подготовку объекта.
Что ты теперь умеешь
Пара фраз для самопроверки:
- Класс — это шаблон, объект — конкретное устройство.
- Переменные — свойства, функции — действия.
- private прячет «внутренности», public открывает доступ снаружи.
- Конструктор автоматически инициализирует объект при его создании.
- Один класс → много независимых объектов.
- Класс в файле .h — это задел на собственную библиотеку.
Именно так устроен код серьёзных проектов: у каждого устройства свой класс, и главный скетч остаётся читаемым, даже когда строк уже тысячи. А следующий шаг — написать свой первый класс для датчика или мотора и переписать старые скетчи через него.
Источники
- TeachMeMicro — Arduino Programming: Classes (учебник по классам в Arduino) — https://www.teachmemicro.com/arduino-programming-classes/
- Adafruit — Multi-tasking the Arduino – Part 1: A Classy Solution (класс Flasher) — https://learn.adafruit.com/multi-tasking-the-arduino-part-1/a-classy-solution
- Arduino (официальная документация) — Writing a Library for Arduino (класс Morse, .h/.cpp) — https://github.com/arduino/docs-content/blob/main/content/learn/08.contributions/03.arduino-creating-library-guide/arduino-creating-library-guide.md
- ElectricalFlux — Mastering C++ and Arduino: How to Write Object-Oriented Sketches (память, vtables) — https://electricalflux.com/mcu-general/cpp-arduino-object-oriented-sketch-tutorial
