Проект на Arduino не работает? Порядок диагностики за 10 минут

Если проект на Arduino не работает, не ищи неисправность, выдёргивая провода наугад. Иди снаружи внутрь: сначала питание (включается ли плата?), затем загрузка (дошёл ли код до платы на самом деле?), затем подключение (общая ли GND, на нужном ли пине каждый провод?), затем ориентация и номинал деталей (не перевёрнут ли светодиод, тот ли резистор?), затем код (номера пинов и логика) и, наконец, датчик и окружение (свет, расстояние, напряжение питания). Делай по одному тесту на уровень и меняй только одну вещь за раз. В таком порядке большинство неисправностей находится за 10 минут, потому что самые частые ошибки сидят во внешних уровнях, а их проверить дешевле всего.

Здесь нет списка отдельных сообщений об ошибках — здесь метод диагностики. Сначала два правила метода, затем таблица-алгоритм, где для каждого уровня указаны признак, тест на 1 минуту и вероятная причина. Дальше — короткий тестовый скетч, который с помощью Blink и монитора порта делит схему на части, 4 проверки мультиметром (плюс альтернативы со светодиодом и монитором порта, если мультиметра нет), пошаговая диагностика неисправности в бесплатном проекте BlueGrays, таблица-шпаргалка по признакам и чек-лист диагностики из 8 пунктов для класса.

Два правила диагностики: снаружи внутрь и одна переменная за раз

Логика «снаружи внутрь» проста: внутренние уровни зависят от внешних. Если на плату не приходит питание, неважно, правильный ли код; если код так и не попал в плату, исправление проводов ничего не изменит. К тому же внешние уровни проверяются быстрее всего: взглянуть на светодиод питания — 5 секунд, прочитать сообщение о загрузке — 10, а поиск логической ошибки в коде может занять минуты. Второе правило — правило одной переменной. Если разом поменять провод, резистор и порог в коде, то даже если проект заработает, будет непонятно, что именно помогло; а если не заработает, можно добавить новую неисправность. Сделай одно изменение, проверь, запиши результат и только потом переходи к следующему.

• Опиши признак одним предложением: «Когда я закрываю LDR рукой, светодиод должен включаться, но он не включается никогда». «Не работает» — это не признак; когда ожидаемое и фактическое записаны по отдельности, нужный уровень для проверки часто становится очевиден.
• Отключай USB при сборке: если плата остаётся под питанием, пока меняются соединения, неверное касание может вызвать короткое замыкание. Внеси изменение, проверь его глазами, затем подключи снова.
• Подставь заведомо исправную деталь: заменить подозрительный светодиод, провод или датчик на точно рабочий — самый сильный тест, который можно сделать без прибора.
• Записывай: короткие заметки вроде «провод с 7 на 8 перенесён, без изменений» не дают повторять один и тот же тест, а если придётся спросить на форуме или у преподавателя, они станут готовым кратким описанием.
• Упрощай: если проект большой, убирай модули по одному. Сначала только плата, затем плата плюс выходная часть, затем входная часть. То, на какой части всё ломается, и показывает, где неисправность.

Таблица-алгоритм диагностики за 10 минут

Читай таблицу ниже сверху вниз и не переходи к следующему уровню, пока текущий тест не пройден. Каждый тест занимает около минуты, так что все шесть уровней проходятся за 6–10 минут. Для большинства тестов хватает глаз, светодиодов на плате и монитора порта Arduino IDE; мультиметр ускоряет дело, но не обязателен. В столбце «Вероятная причина» перечислены места, куда стоит смотреть в первую очередь, если тест не пройден, — примерно в порядке того, как часто они встречаются.

Уровни 1 и 2: питание и загрузка

На Arduino Uno первую подсказку по этим двум уровням дают два светодиода. Светодиод ON показывает, что на плату подано питание; если он не горит, сначала замени кабель USB, потому что некоторые кабели только заряжают и не передают данные. Если ON горит, но при подключении пропадает звук USB на компьютере или светодиод мерцает, в схеме может быть замыкание: отключи USB, проследи линии 5V и GND и поищи модуль, вставленный наоборот, или провод, перемыкающий две шины. Нагревающаяся деталь — всегда серьёзный признак; не подавай питание на плату снова, пока её не уберёшь. Если в проекте есть мотор, сервопривод или реле, USB может не дать достаточного тока; тогда признак обычно не «ничего не работает», а случайные перезагрузки или дрожание. Варианты питания от батарей и адаптера — в статье питание Arduino от батарей.

На уровне загрузки нужно ответить на один вопрос: тот ли код на плате, что виден на экране? Когда загрузка завершается, Arduino IDE сообщает об этом в области вывода внизу; если там красные строки, код до платы не дошёл и она продолжает выполнять старую программу. Это коварно: кажется, что исправление просто не помогло. Об ошибках avrdude, порта и драйвера по каждому сообщению рассказывает статья код не загружается в Arduino, а если всё застревает на компиляции, смотри ошибки компиляции. Есть и простой проверочный тест: поменяй в коде задержку со 100 на 1000 и загрузи. Если ритм светодиода не изменился, проблема на уровне загрузки. Некоторым платам ESP32 нужно удерживать кнопку BOOT во время загрузки; на Raspberry Pi Pico проверь, что в правом нижнем углу Thonny выбран интерпретатор MicroPython.

Уровень 3: подключение, GND и пины

Плата под питанием, код загружен — очередь проводов. Две самые частые ошибки — забытая общая GND и неверно понятая макетная плата. Даже если у датчика или модуля своё питание, его GND должна быть соединена с GND Arduino, иначе у сигнального напряжения нет опорной точки. На макетной плате центральная канавка разделяет две половины, а на длинных макетных платах шины питания по краям могут быть разделены посередине; подать 5V на одну половину шины и считать, что это питает деталь на другой половине, — очень частая ошибка. Лучший метод на этом уровне — сверка со схемой один к одному: пересчитай каждый провод, оба конца, и покажи пальцем его пару на схеме. Цифровой 2, перепутанный с аналоговым A2, 5V вместо VIN или провод на одну строку в стороне сразу бросятся в глаза. Если символы на схеме незнакомы, статья как читать электрическую схему проведёт через перенос схемы на макетную плату.

Уровень 4: ориентация и номинал деталей

Если подключение правильное, а деталь всё равно не отвечает, посмотри на саму деталь. Длинная ножка светодиода (анод) должна идти через резистор к пину, а короткая (катод) — к GND; перевёрнутый светодиод обычно не повреждается, он просто не светится. Чаще всего путают резисторы: у 220 Ω полосы красная-красная-коричневая, у 10 kΩ — коричневая-чёрная-оранжевая. Поставь 10 kΩ рядом со светодиодом — и он засветится так слабо, что это легко не заметить; поставь 220 Ω рядом с LDR или кнопкой — и показания потеряют смысл. Полосы можно расшифровать в утилите цветового кода резисторов, а нужный номинал для светодиода подобрать в калькуляторе резистора для светодиода. Четырёхногая тактовая кнопка, повёрнутая на 90 градусов, будет читаться как всегда нажатая или никогда не нажатая. На модулях порядок VCC, GND и сигнала зависит от производителя, поэтому читай надписи пинов на самой плате, а не на картинке из интернета. У трёхвыводных деталей вроде транзисторов и стабилизаторов напряжения порядок выводов тоже зависит от модели.

Уровень 5: код (номера пинов и логика)

Если железо в порядке, проверь, говорит ли код то же самое, что схема. Первая проверка — номера пинов: если светодиод физически на 8, а в коде digitalWrite(9, HIGH), всё выглядит идеально, и ничего не происходит. Вторая проверка — pinMode: если в setup() нет pinMode(pin, OUTPUT), digitalWrite(pin, HIGH) не делает пин выходом, а только включает встроенный подтягивающий резистор, и светодиод светится очень тускло. Помимо резистора, это самая частая причина «тусклого светодиода». Третья проверка — логика: запись if (value = 100) ничего не сравнивает, а присваивает переменной 100, и условие всегда истинно; правильная форма — ==. К этому уровню относятся и пороги с задержками: если порог не подходит к окружению, ничего не срабатывает даже при идеально рабочем датчике. В проектах с библиотеками проверь ещё, что установлена нужная библиотека; подробности — в статье установка библиотек Arduino.

Уровень 6: датчик и окружение

Последний уровень — внешние условия, которые портят результат даже при правильных схеме и коде. Значение LDR зависит от освещения в комнате; порог, который работает днём у окна, вечером под лампой может не сработать. HC-SR04 не получает эха от мягких поверхностей вроде ткани и не меряет ближе 2 см. Газовым датчикам серии MQ перед измерением нужно несколько минут на прогрев. DHT11 возвращает ошибки, если опрашивать его чаще раза в секунду. Пины ESP32 и Raspberry Pi Pico работают на 3,3 V; прямое подключение датчика с выходом 5 V может дать неверные показания и повредить пин. Длинные провода, помехи от моторов и «висящие» входы тоже заставляют значения скакать. Лучший инструмент на этом уровне — монитор порта: смотри «сырое» значение датчика и намеренно меняй условия. Если I2C-дисплей или датчик вообще не отвечает, скетч-сканер из статьи что такое I2C покажет его адрес.

Разделяй и властвуй: проверь плату через Blink, а шаги — монитором порта

Быстрее всего уровни проходятся, если разделить схему и код на части. Первая часть — сама плата: ничего не подключая, загрузи код, который мигает встроенным светодиодом L. Если L мигает, питание, загрузка и плата в порядке, и дальше проблему нужно искать за пределами платы. Вторая часть — выход: в том же коде помигай внешним светодиодом. Третья часть — вход: выведи значение датчика в монитор порта. Скетч ниже делает все три шага и на каждом выводит в монитор порта пронумерованную контрольную точку. Подключи внешний светодиод к пину 9 через резистор 220 Ω, а сигнал проверяемого аналогового датчика — к A0, и выставь в мониторе порта скорость 9600 бод.

1const int LED_PIN = 9;       // Harici LED pini / External LED pin
2const int SENSOR_PIN = A0;   // Analog sensör pini / Analog sensor pin
3
4void setup() {
5  Serial.begin(9600);                  // Seri monitör de 9600 olmalı / Serial Monitor must be 9600 too
6  pinMode(LED_BUILTIN, OUTPUT);        // Karttaki L ışığı / On-board L LED
7  pinMode(LED_PIN, OUTPUT);            // Harici LED çıkış / External LED as output
8  Serial.println("1) setup bitti");    // Kontrol noktası 1 / Checkpoint 1
9}
10
11void loop() {
12  digitalWrite(LED_BUILTIN, HIGH);     // Kart canlı mı? / Is the board alive?
13  digitalWrite(LED_PIN, HIGH);         // Harici LED açık / External LED on
14  Serial.println("2) LED acik");       // Kontrol noktası 2 / Checkpoint 2
15  delay(500);
16
17  digitalWrite(LED_BUILTIN, LOW);
18  digitalWrite(LED_PIN, LOW);          // Harici LED kapalı / External LED off
19  Serial.println("3) LED kapali");     // Kontrol noktası 3 / Checkpoint 3
20  delay(500);
21
22  int value = analogRead(SENSOR_PIN);  // 0-1023 arası okuma / Reading from 0 to 1023
23  Serial.print("4) A0 = ");
24  Serial.println(value);               // Sensör değeri / Sensor value
25}

Настоящая сила этого скетча — в контрольных точках. Используй тот же метод в своём проекте: добавь короткий Serial.println() в конец setup() и после каждого важного шага в loop(), например «кнопка нажата» или «порог пройден». Последнее сообщение, появившееся в мониторе порта, показывает, где застряла программа. Чтобы понять, почему условие никогда не срабатывает, выведи сравниваемое значение прямо перед условием; если «value < 50» никогда не выполняется, тут же станет видно, что значение никогда не опускается ниже 50. В больших проектах логика та же: временно закомментируй часть кода и проверяй куски по одному. О настройках монитора порта — скорости, конце строки и плоттере — читай в статье как пользоваться монитором порта Arduino.

4 проверки мультиметром (или светодиодом и монитором порта без него)

Мультиметр превращает диагностику из угадывания в измерение, и всего четыре измерения покрывают большинство неисправностей Arduino. Перед измерением выставь нужный режим: DC V для напряжения, прозвонку (со звуком) для проверки проводов и строк, Ω для сопротивления. Прозвонку и измерение сопротивления делай только при отключённом USB. Если мультиметра нет, способы из последнего столбца дают более грубый, но достаточный ответ на тот же вопрос. Диапазоны прибора и то, в какие гнёзда вставлять щупы, с картинками объясняет статья как пользоваться мультиметром.

Разбор примера: в проекте «Ночник на LDR» не включается светодиод

Опробуем метод на бесплатном проекте BlueGrays: Ночник на LDR. В схеме один конец LDR идёт на 5V, а другой на A0; между A0 и GND стоит резистор 10 kΩ, и вместе они образуют делитель напряжения. Светодиод подключён к пину 13 через резистор 330 Ω. Код читает A0 и, если значение ниже 50, считает, что в комнате темно, и включает светодиод. Признак: «Закрываю LDR рукой, а светодиод так и не включается». Вместо того чтобы переставлять провода наугад, пройдём уровни по порядку.

1. Питание: светодиод ON горит, ничего не греется. Идём дальше.
2. Загрузка: загрузка прошла без ошибок. Для уверенности временно замени в коде 50 на 2000 и загрузи; analogRead возвращает не больше 1023, поэтому условие всегда истинно и светодиод должен гореть постоянно.
3. Подключение и светодиод L: пин 13 подключён ещё и к встроенному светодиоду L. Если с порогом 2000 L загорается, а внешний светодиод нет, код выполняется, и проблема на пути светодиода. Идёт ли длинная ножка светодиода к 13 через 330 Ω, а короткая — к GND?
4. Ориентация и номинал деталей: светодиод не перевёрнут, но если рядом с ним стоит 10 kΩ вместо 330 Ω, он светится слишком слабо, чтобы это заметить. Различай эти два резистора по цветам.
5. Код и датчик: если с порогом 2000 внешний светодиод загорается, верни 50. Теперь, чтобы увидеть реальные значения, загрузи в ту же схему код проекта Измерение освещённости с LDR: в нём то же подключение LDR, и он каждые полсекунды выводит A0 в монитор порта.
6. Прочитай значения: допустим, без руки видно около 600, а если закрыть рукой — около 120. Значение никогда не опускается ниже 50, поэтому светодиод и не включается. Вернись к коду ночника и подними порог куда-нибудь в диапазон от 200 до 300.
7. Заметь обратное поведение: если при закрывании значение растёт, а не падает, LDR и резистор 10 kΩ поменялись местами. Если значение случайно скачет, пока рука неподвижна, провод A0 не попал в строку, где соединяются LDR и резистор.

В этом примере неисправность нашли не новые знания, а порядок: сначала мы доказали, что сам светодиод может гореть, затем посмотрели, что на самом деле читает датчик. В приложении в разделе Если не получается на вкладке Разбор кода этого проекта уже есть пять таких признаков в виде пар «признак — решение»: внешний светодиод не загорается в темноте, светодиод горит на свету и гаснет в темноте, не загорается даже под рукой, горит постоянно или мерцает, а также ошибка загрузки. Раздел проекта Если не работает даёт общий чек-лист из 10 шагов, который начинается с питания и проходит через загрузку, номера пинов, макетную плату, перемычки, GND, светодиод и резистор. Как можно заметить, этот порядок почти совпадает с уровнями из начала статьи.

Помощь в приложении: где искать, если проект не работает

• Если не работает: упорядоченный чек-лист на странице проекта, который начинается со слов «Если проект не работает, проверь шаги ниже». Он есть более чем в 170 проектах и открывается с Premium; в бесплатных проектах этот раздел тоже доступен с Premium. Если совсем непонятно, что сломалось, это то место, которое стоит пройти от начала до конца.
• Разбор кода › Если не получается: пары «признак — решение», свои для кода и схемы конкретного проекта. В бесплатных проектах открыто всем, в проектах Premium — с Premium. Если признак удаётся описать одним предложением, загляни сюда первым делом. Весь раздел описан в статье Разбор кода.
• Вернись к шагам «Собираем вместе»: в пошаговом режиме вернись к шагу 2. Собери схему и собери схему с нуля при отключённом кабеле USB; на шаге 3. Загрузи код ещё раз проверь плату и порт в меню «Инструменты» Arduino IDE. Режим запоминает, на каком шаге работа прервалась. Как он работает, рассказано в статье твой первый проект на Arduino.
• Увеличь схему подключения: разведи пальцы, чтобы увеличить Схему, и сверяй своё подключение соединение за соединением; при желании сохрани её кнопкой Сохранить в галерею и отмечай проверенные провода. Так ловится большинство неисправностей 3-го уровня.
• Задай правильный вопрос на форуме: если всё это испробовано, а проект так и не работает, создай тему в категории Вопрос в разделе Учёба › Форум. Укажи плату, полный код, соединения, ожидаемое и фактическое поведение и то, какие уровни уже проверены, и добавь чёткое фото схемы. Как это написать, рассказано в статье как задать вопрос на форуме.

Шпаргалка по признакам

Для преподавателей: чек-лист диагностики из 8 пунктов

Допустим, в классе 24 ученика, 8 групп одновременно собирают схемы, и за первые 15 минут шесть групп поднимают руки со словами «не работает». Положи чек-лист ниже на стол каждой группе и с самого начала введи правило: прежде чем поднимать руку, пройти карточку сверху вниз и записать на обороте, на каком пункте всё застряло и что было изменено. Это освобождает твоё время и формирует у учеников привычку решать проблемы; а записи диагностики — ещё и свидетельство процесса, которое можно использовать при оценивании. Об организации групп в большом классе читай в статье урок Arduino в большом классе, а об оценке процесса — в статье критерии оценивания.

1. Признак: что ожидалось и что происходит? Записать одним предложением.
2. Питание: горит ли светодиод ON? Отключить USB: какая-нибудь деталь тёплая?
3. Загрузка: завершилась ли загрузка без ошибок? Правильно ли выбраны плата и порт в меню «Инструменты»?
4. Плата: мигает ли встроенный светодиод L после загрузки Blink?
5. Подключение: увеличить схему и пересчитать каждый провод с обоих концов. Общая ли GND, на нужном ли пине и в нужной ли строке провода?
6. Деталь: идёт ли длинная ножка светодиода к пину? Совпадают ли полосы резистора с номиналом из списка деталей? Правильно ли подключены VCC и GND на модуле?
7. Код: совпадают ли номера пинов в коде со схемой? Какая контрольная точка появляется последней при выводе в монитор порта?
8. Датчик и следующий шаг: имеет ли смысл значение датчика в мониторе порта и меняется ли оно при изменении условий? Если проблема не решена, заглянуть в «Если не получается» и «Если не работает», затем позвать преподавателя. Менять по одной вещи за раз и всё записывать.

Диагностика — это навык, и с каждой неисправностью она идёт быстрее: поиск, который в первом проекте занимает 20 минут, к пятому сокращается до 3 минут, потому что уровень начинаешь угадывать уже по признаку. В следующий раз, когда проект не заработает, открой этот порядок, прежде чем выдёргивать провода, и иди сверху вниз. Небольшие проекты вроде ночника из этой статьи идеально подходят для тренировки; в приложении BlueGrays у каждого из 60 бесплатных проектов есть схема, код и раздел «Разбор кода», так что при следующей неисправности уже будет понятно, куда смотреть.