Классы и объекты в 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, и есть пара правил, которые стоит выучить сразу:

  1. Не используй new, delete и класс String внутри loop(). Это вызывает фрагментацию кучи: за дни и недели SRAM превращается в «швейцарский сыр» из непригодных блоков, а потом наступают внезапные сбои malloc и зависание устройства.
  2. Создавай объекты глобально или внутри setup(). Это статическая аллокация — она не фрагментирует память.
  3. Виртуальные функции стоят Flash-памяти. Таблица виртуальных функций (vtable) занимает место во Flash, так что на AVR-платах её лучше использовать с осторожностью.

Итого: объект создай один раз — и работай с ним. Создавать и удалять объекты внутри цикла — плохая привычка.

Три частых вопроса новичков

«Почему компилятор ругается, когда я пишу led.pin = 9 извне?» Потому что pin — private, и из внешнего кода к нему нет доступа. Это не баг, а инкапсуляция: класс защищён от случайного изменения «внутренностей». Правильное решение — передать номер ножки через конструктор и дальше обращаться к объекту только через его public-функции.

«В чём разница между class и struct?» Для новичка — в уровне доступа по умолчанию. В class члены по умолчанию private, в struct — public. Поэтому в class важно всегда явно писать public: перед теми членами, которые должны быть доступны снаружи, иначе всё станет закрытым.

«Когда вызывается конструктор?» Автоматически, в момент создания объекта. Ты не пишешь вызова конструктора явно — он происходит сам, как только объект рождается. Именно поэтому строка LED led(9); уже означает и создание, и подготовку объекта.

Что ты теперь умеешь

Пара фраз для самопроверки:

  • Класс — это шаблон, объект — конкретное устройство.
  • Переменные — свойства, функции — действия.
  • private прячет «внутренности», public открывает доступ снаружи.
  • Конструктор автоматически инициализирует объект при его создании.
  • Один класс → много независимых объектов.
  • Класс в файле .h — это задел на собственную библиотеку.

Именно так устроен код серьёзных проектов: у каждого устройства свой класс, и главный скетч остаётся читаемым, даже когда строк уже тысячи. А следующий шаг — написать свой первый класс для датчика или мотора и переписать старые скетчи через него.

Источники

  1. TeachMeMicro — Arduino Programming: Classes (учебник по классам в Arduino) — https://www.teachmemicro.com/arduino-programming-classes/
  2. Adafruit — Multi-tasking the Arduino – Part 1: A Classy Solution (класс Flasher) — https://learn.adafruit.com/multi-tasking-the-arduino-part-1/a-classy-solution
  3. 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
  4. ElectricalFlux — Mastering C++ and Arduino: How to Write Object-Oriented Sketches (память, vtables) — https://electricalflux.com/mcu-general/cpp-arduino-object-oriented-sketch-tutorial

Leave a Reply

Your email address will not be published. Required fields are marked *