Arduino работает – пока не перестает: 12 ошибок, которых не видит компилятор

Ошибка 1«Uno принимает 12 В» не означает «от Uno можно питать всё»

Миф: если 7–12 В рекомендованы для VIN или разъёма питания, то на 5V можно подключить сервопривод, реле и дисплей — стабилизатор как-нибудь разберётся.

На официальной схеме Uno R3 пятивольтовую шину от внешнего входа формирует линейный NCP1117. Перед ним в пути от barrel jack также стоит диод M7.^[2] Линейный стабилизатор не переносит лишнее напряжение в отдельную баночку на потом. Разница между входом и выходом преимущественно становится теплом.

Если именно на входе стабилизатора есть 12 В, а весь ток через него составляет 0,2 А, расчёт даёт 1,4 Вт. При 7 В и тех же 0,2 А — 0,4 Вт. Ток одинаковый, но тепловая нагрузка отличается в 3,5 раза. Это расчёт, а не прогноз температуры конкретной платы: результат зависит от меди, температуры окружающей среды, воздуха и корпуса.

NCP1117 имеет ограничение тока, компенсацию безопасной области и тепловое отключение примерно около 175 °C, однако производитель прямо требует надлежащего отвода тепла, чтобы защита не активировалась.^[3] Thermal shutdown — это аварийный ремень, а не штатный круиз-контроль.

Характерный след: от USB устройство работает, а от 12-вольтового адаптера через несколько минут начинает перезапускаться; сервопривод дёргается; дисплей гаснет на пике; в закрытом корпусе проблема приходит быстрее.

Инженерное решение: силовую нагрузку питать отдельной ветвью; для большой разницы напряжений использовать соответствующий импульсный DC-DC; считать весь ток через регулятор, а не только «ток модуля»; не подавать мощную нагрузку с GPIO. Если регулируемые 5 В заводятся непосредственно на шину 5V, это обходит часть штатной входной защиты платы и требует отдельной проверки источников и обратного питания.

Для обзора классов понижающих модулей есть отдельный материал «LM2596 против всех». Конкретный модуль всё равно требует проверки собственного регулирования, охлаждения и реальной нагрузки.

Arduino принимает 12 В. Но часть этих вольт она вынуждена буквально отапливать.

Ошибка 2Общая земля не означает одинаковый ноль в каждой точке

Миф: GND Arduino соединён с GND двигателя, значит проблема с землёй исключена.

Дорожка, макетная шина и провод имеют сопротивление и индуктивность. Когда ток меняется, между двумя точками того же «GND» возникает напряжение:

Microchip в рекомендациях AVR042 поясняет, что даже одновременное переключение целого порта AVR создаёт очень короткие импульсы в сотни миллиампер. Длинные линии питания не успевают обеспечить их; поэтому локальный развязывающий конденсатор должен стоять близко к выводам питания и замыкать малую токовую петлю.^[5] Пусковой ток двигателя или сервопривода добавляет к этой истории значительно большие и более медленные импульсы, индуктивный шум и падение на общем обратном проводе.

Характерный след: reset происходит именно во время старта двигателя; ADC скачет синхронно с движением сервопривода; I²C исчезает при переключении реле; большой конденсатор «лечит» симптом, но схема остаётся чувствительной к длине проводов.

Инженерное решение: вести силовой ток коротким и достаточно толстым путём к источнику; не пропускать возврат двигателя через тонкую макетную шину логики; соединить логическую и силовую части в определённой опорной точке; поставить 100 нФ возле каждой цифровой микросхемы и накопительную ёмкость у драйвера; для катушки обеспечить корректное подавление индуктивного выброса. «Звезда» — не магический символ, а способ не смешивать падение от больших токов с опорным напряжением логики.

Это может быть не баг библиотеки двигателя. В момент запуска изменилась сама точка, которую код считал нулём.

Ошибка 3Плата не перезагрузилась, но уже вышла из гарантированного режима

Миф: если brown-out reset не сработал, питание достаточное.

ATmega328P имеет зависимость максимальной частоты от напряжения. Datasheet задаёт линию между 10 МГц при 2,7 В и 20 МГц при 4,5 В. Для 16 МГц линейная интерполяция даёт примерно:

Это расчёт по официальной speed-grade кривой, а не отдельно гарантированная табличная точка. В то же время ArduinoCore-avr 1.8.8 задаёт для Uno рецепт extended fuse 0xFD.^[7] Младшие биты соответствуют BODLEVEL=101: минимальный, типовой и максимальный пороги 2,5; 2,7 и 2,9 В.^[4]

Следовательно, существует промежуток, в котором BOD уже не обязательно держит reset, но 16 МГц ещё не лежат в полностью гарантированной области. Это не обещание ошибки при 3,7 В. Это более точная и важная вещь: производитель уже не гарантирует штатную работу для всех экземпляров, температур и условий.

Инженерное решение: согласовать минимальное напряжение, частоту и BOD как одну систему; держать 5-вольтовую шину с достаточным запасом; для низковольтного питания снижать частоту; в собственном устройстве рассмотреть более высокий BOD, учтя его диапазон и требования к старту. Изменение fuse-битов требует ISP и внимательности: неудачный рецепт может сделать обычную загрузку недоступной.

Reset — не единственное состояние между «всё хорошо» и «питание исчезло».

Ошибка 4Выключенный модуль может питаться через провод данных

Миф: VCC отключено, значит устройство гарантированно обесточено.

Для обычных I/O ATmega328P допустимый абсолютный диапазон напряжения ограничен примерно от GND − 0,5 В до VCC + 0,5 В. Эквивалентная структура входа содержит защитные пути к шинам питания.^[4] Если целевая плата выключена, а другое активное устройство подаёт HIGH на её GPIO, ток может пойти в VCC цели. Это называется back-powering или фантомным питанием.

Тот же класс проблемы возникает в UART, SPI и I²C, если pull-up остаётся под напряжением, а один участник шины выключен. Конкретное напряжение на VCC зависит от нагрузки, защитной структуры и всей схемы, поэтому универсальные «там всегда будет 2 В» не имеют смысла.

Характерный след: выключенный модуль тускло светится; порядок включения двух плат меняет запуск; выключенное устройство нагружает линию; батарея разряжается быстрее; после полного обесточивания проблема исчезает.

Инженерное решение: перевести источник сигнала в высокоимпедансное состояние до выключения приёмника; согласовать последовательность питания; применить шинный ключ, буфер или преобразователь уровней с документированным отсечением при выключенном питании (power-off isolation / Ioff); при необходимости разрывать линию аппаратно. Последовательный резистор может ограничить паразитный ток, но не делает электрического разъединения.

О границах 3,3/5 В и о том, почему HIGH одного устройства может быть запрещённым напряжением для другого, подробнее рассказывают «Тайны логических уровней».

Провод с именем TX не перестаёт быть путём тока только потому, что мы думаем о нём как о данных.

Ошибка 5Serial Monitor может добраться до реле раньше setup()

Миф: безопасное состояние записано в первой строке setup(), поэтому до команды реле не включится.

На схеме Uno R3 сигнал DTR от USB-UART связан с RESET через конденсатор 100 нФ.^[2] Arduino отдельно документирует, что Uno и Mega без native USB автоматически перезагружаются, когда последовательный порт открывается.^[6]

Во время аппаратного reset GPIO становятся входами с высоким импедансом. Затем выполняется bootloader, и только после него управление получает скетч. Следовательно, даже самая первая строка setup() приходит после короткого, но вполне реального промежутка, когда исполнительный выход контролирует не программа, а внешняя схема.

Для active-LOW входа правильный порядок в коде убирает лишний импульс при переходе пина в OUTPUT:

constexpr uint8_t RELAY_PIN = 7;
constexpr uint8_t RELAY_OFF = HIGH;

void setup()
{
  digitalWrite(RELAY_PIN, RELAY_OFF); // сначала выходной latch
  pinMode(RELAY_PIN, OUTPUT);         // потом драйвер пина
}

Но этот порядок не закрывает reset-окно. Безопасное состояние критического механизма задают внешним pull-up/pull-down, входом enable, инвертором или силовой архитектурой, в которой floating GPIO означает OFF.

setup() не выполняется во время reset. Для критического выхода это не мелкая деталь, а граница ответственности между кодом и схемой.

Ошибка 6Два способа потерять PWM: библиотека забрала таймер или Core отключил канал

Миф: Servo генерирует импульсы только на выбранном пине и не влияет на PWM где-либо ещё.

ATmega328P имеет три аппаратных таймера. Они не знают названий библиотек — только регистры, счётчики, prescaler и выходные каналы. Servo 1.3.0 на Uno использует Timer1, переводит его в normal counting mode и задаёт prescaler 8.^[8] На Uno Timer1 одновременно обслуживает PWM D9/D10. Функция tone() использует Timer2, к которому привязаны D3/D11.^[9]

Лучшая часть этой ловушки — сервопривод может быть подключён, скажем, к D6. Timer1 всё равно используется библиотекой, а PWM исчезает на D9/D10. Конфликт произошёл не между проводами, а внутри MCU.

Второй механизм ещё менее очевиден. В AVR Core 1.8.8 и digitalWrite(), и digitalRead() вызывают turnOffPWM() для выбранного timer-backed pin.^[10]

void checkPwmPin()
{
  analogWrite(9, 128);
  int state = digitalRead(9); // на AVR Core отключит PWM именно от D9
  (void)state;
}

Это не останавливает весь Timer1, но аппаратный PWM на этом канале больше не управляет пином. Следующий analogWrite() может подключить его снова.

Инженерное решение: перед объединением библиотек вести карту таймеров; проверять исходный код именно зафиксированной версии, а не только API; не читать пин аппаратного PWM «для проверки», если модуляция должна оставаться активной; после сторонней библиотеки проверять конфигурацию общего ресурса. Основы коэффициента заполнения (duty cycle) и фильтрации PWM вынесены в отдельную статью о ШИМ (PWM).

Библиотека — это не только набор C++-функций. Иногда это новый хозяин аппаратного таймера.

Ошибка 7ADC «помнит» предыдущий канал, потому что конденсатор не успел перезарядиться

Миф: analogRead() — идеальный вольтметр с бесконечным входным сопротивлением.

Внутри ADC ATmega328P есть sample-and-hold конденсатор примерно 14 пФ. После переключения мультиплексора источник сигнала должен зарядить его до нового напряжения за ограниченное время. Datasheet рекомендует выходное сопротивление источника около 10 кОм или меньше.^[4]

В делителе важна не сумма двух резисторов, а сопротивление Тевенена, которое видит ADC. Для 10 кОм + 10 кОм это 5 кОм. Для 1 МОм + 1 МОм — уже 500 кОм. Второй вариант не только заряжает внутреннюю ёмкость значительно медленнее, но и становится чувствительнее к токам утечки и загрязнению платы.

После перехода с канала с одним напряжением на высокоомный канал с другим первый результат может содержать остаточное влияние предыдущего заряда. Это не тайная цифровая связь между A0 и A1. Это обычная аналоговая схема, которой не дали установиться.

Инженерное решение: уменьшить эквивалентное сопротивление источника; добавить у входа конденсатор, учтя его влияние на скорость сигнала; использовать буферный операционный усилитель; увеличить время выборки (acquisition time) или снизить скорость ADC; после переключения выполнить пробное преобразование только там, где этого действительно требуют импеданс и точность.

Правило «всегда читайте дважды» слишком грубое: оно тратит время, маскирует слишком большое выходное сопротивление источника и не гарантирует установления второго отсчёта. Изменение источника опорного напряжения также требует времени, а внешний AREF нельзя бездумно сочетать с внутренним источником.

Базовую логику ADC, разрядность и опорное напряжение разобраны в материале «Переводчики реальности: АЦП и ЦАП».

ADC измеряет датчик через маленький конденсатор. Если источник слабый, предыдущий канал ещё успевает сказать последнее слово.

Ошибка 8volatile сообщает компилятору об изменениях, но не запирает данные

Миф: переменную изменяет interrupt — достаточно добавить volatile.

volatile запрещает компилятору считать значение стабильным между доступами. Но ATmega328P — 8-битный процессор. Чтение 16- или 32-битной переменной требует нескольких операций, и ISR может обновить её между отдельными байтами. Основной код получит гибрид двух моментов.

AVR-LibC прямо показывает, что volatile не делает многобайтовый доступ атомарным, и предоставляет ATOMIC_BLOCK для короткой критической секции.^[11] Сам Arduino Core читает 32-битный timer0_millis с сохранением SREG и кратким отключением прерываний.^[12]

#include <util/atomic.h>

volatile uint32_t pulseCount = 0;

uint32_t readPulseCount()
{
  uint32_t snapshot;

  ATOMIC_BLOCK(ATOMIC_RESTORESTATE) {
    snapshot = pulseCount;
  }

  return snapshot;
}

ATOMIC_RESTORESTATE важен: он восстанавливает предыдущее состояние прерываний, а не безусловно включает их в конце.

Вторая ошибка — использовать ISR как второй loop(). Обычный AVR ISR выполняется с отключёнными глобальными прерываниями. В нём не следует ждать delay(), обновлять дисплей, печатать длинные сообщения или запускать медленный опрос датчика. ISR должна зафиксировать критическое состояние, увеличить счётчик или поставить флаг и завершиться.

volatile — записка для компилятора, а не навесной замок для общей переменной.

Ошибка 9На 115200 бод в Serial есть лишь несколько миллисекунд запаса

Миф: байты подождут, пока loop() закончит delay(), а потом парсер всё прочитает.

В стандартной конфигурации HardwareSerial для Uno RX- и TX-массивы имеют по 64 байта. Но кольцевой head/tail оставляет одну позицию пустой, чтобы различать «пусто» и «полно», поэтому программный RX-ring хранит 63 байта.^[13]

В формате 8N1 один байт занимает примерно 10 бит. Для пустого software buffer и непрерывного потока имеем:

Аппаратные регистры USART добавляют ещё небольшой запас, а реальный поток может иметь паузы. Однако порядок величины неизменен: двадцатимиллисекундная блокировка легко дольше всей программной очереди на 115200. Когда кольцо заполнено, новый байт не доходит до парсера, поэтому увеличение тайм-аута уже ничего не вернёт.

Serial.flush() тоже не является резинкой для RX. В современной реализации он ждёт завершения выходной передачи.^[13]

Инженерное решение: читать поток при каждой возможности; заменять длинные блокировки на конечный автомат; ограничивать длину кадра; иметь поле длины, номер последовательности и контроль целостности; отделять тайм-аут протокола от факта переполнения локальной очереди.

Высокий baud rate быстрее передаёт данные — и так же быстрее забирает время на реакцию.

Ошибка 10Четыре I²C-модуля могут добавить не только четыре адреса, но и восемь резисторов

Миф: SDA и SCL соединяются параллельно, поэтому количество готовых модулей электрически неважно.

I²C использует двунаправленные open-drain/open-collector линии. Устройства активно тянут SDA/SCL к LOW, а HIGH создаёт pull-up к положительной шине. Скорость фронта определяют сопротивление подтяжки и суммарная ёмкость; уровень HIGH определяет напряжение той шины.^[14]

Предположим, каждая из четырёх плат имеет по 4,7 кОм на SDA и SCL, и все резисторы подключены к одному напряжению:

Расчётный LOW-ток составляет примерно 2,81 мА при 3,3 В и 4,26 мА при 5 В, если пренебречь ненулевым VOL. Спецификация I²C приводит 3 мА при VOL = 0,4 В как важный Standard/Fast-mode ориентир, но точную способность стягивания надо брать из datasheet каждого участника.^[14] Меньшее сопротивление ускоряет фронт, но увеличивает LOW-ток — «больше pull-up» не всегда лучше.

Если часть готовых модулей подтягивает линии к 3,3 В, а часть к 5 В, формула 1175 Ом вообще неприменима: резисторы образуют путь между двумя шинами питания. Для 3,3-вольтовой платы без толерантности к 5 В это уже риск повреждения, а не просто странная форма фронта.

Есть и программная граница. В Wire/TWI для AVR Core буферы имеют 32 байта. Это ограничение конкретной реализации, даже если периферийный чип способен передать более длинный блок. Механизм тайм-аута также отключён, пока программа явно не вызовет setWireTimeout().^[15]

#include <Wire.h>

void setup()
{
  Wire.begin();
  Wire.setWireTimeout(25000, true); // 25 мс — пример, не универсальная константа
}

Timeout позволяет выйти из части ожиданий и, по выбранному параметру, сбросить TWI hardware. Он не убирает неправильные pull-up, шум, обратное питание или устройство, которое физически продолжает держать SDA в LOW.

Инженерное решение: определить одну контролируемую сеть pull-up; проверить, к какому напряжению подключён каждый модуль; убрать лишние резисторы; считать ёмкость и время нарастания фронта; снижать частоту при длинной шине; делить передачи по размеру буфера; иметь протокол восстановления после тайм-аута.

Основы адресации и ролей шин смотрите в отдельном материале «I²C, SPI, UART — что это такое».

Каждый новый I²C-модуль может принести собственный датчик, собственные pull-up и собственное представление о том, каким должно быть напряжение HIGH.

Ошибка 11«Неиспользуемый» D10 может отключить SPI master

Миф: если peripheral chip-select расположен на D7, пин D10 к SPI не имеет отношения.

В ATmega328P аппаратный SS — это PB2, то есть D10 на Uno. Если SPI работает как master, но SS настроен как вход и получает LOW, аппаратный бит MSTR очищается, а SPI переходит в slave mode.^[4]

SPI.begin() защищает от этого: сначала устанавливает выходной latch SS в HIGH, затем делает SS выходом и включает master.^[16] Проблема возвращается, если последующий код или сторонняя библиотека снова выполняет pinMode(10, INPUT).

#include <SPI.h>

void setup()
{
  digitalWrite(SS, HIGH); // сначала latch, без короткого LOW
  pinMode(SS, OUTPUT);
  SPI.begin();
}

Рабочий CS периферии может быть на D7, D8 или другом GPIO. D10 всё равно должен оставаться OUTPUT, если Uno является SPI master.

Для нескольких устройств нужен ещё один уровень дисциплины: отдельный CS каждому, неактивные CS в правильном состоянии и SPI.beginTransaction() с частотой, bit order и mode конкретного устройства. Библиотека, которая молча меняет SPI mode без транзакции, создаёт другой вид «мистики».

SPI может потерять звание master через пин, который в схеме якобы ни к чему не подключён.

Ошибка 12EEPROM переживает отключение питания, но отдельная запись — не обязательно

Миф: EEPROM.put() сохраняет структуру как одну неделимую операцию.

Для EEPROM ATmega328P заявлено как минимум 100 000 циклов write/erase при приведённых условиях, а объём Uno составляет 1 КБ.^[4] Это не дата гарантированной смерти ячейки, но очень полезный проектный бюджет.

EEPROM.update() действительно уменьшает износ: байт записывается только тогда, когда значение изменилось. Но EEPROM.put() просто проходит объект байт за байтом и для каждого использует update-семантику.^[17] Транзакции здесь нет.

Если питание исчезнет посреди структуры, часть полей может быть новой, часть старой, а многобайтовое поле — смешанным. Низкое напряжение во время EEPROM-операции отдельно упоминается в datasheet как условие риска повреждения данных.^[4]

Более надёжная схема: два или более слота и явное подтверждение завершения записи (commit).

1. Оставить новейший правильный слот нетронутым.
2. В слоте для новой записи сначала установить маркер INVALID.
3. Записать номер последовательности, версию формата, длину, данные (payload) и CRC.
4. Прочитать запись обратно и проверить формат и CRC.
5. Записать VALID последней операцией.
6. При старте выбрать новейший слот с правильными маркером, длиной, версией и CRC.

CRC выявляет повреждения, но не делает EEPROM атомарной. Sequence определяет новейший слот, version позволяет изменить формат, а несколько слотов дают частичный wear leveling. Для долговременного формата лучше явно сериализовать поля, а не считать raw layout C++-структуры вечным контрактом: padding и формат могут измениться.

EEPROM хранит байты без питания. Она не обещает, что ваши двадцать байтов записались одновременно.