Методика отладки: симулятор → Serial → мультиметр

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

План стоило бы выучить раньше. Пирамида из трёх ступеней: сначала логика в симуляторе — там плата всегда под рукой, время послушно, провода не гнилые; затем Serial-точки и половинное деление кода; и только потом мультиметр на живую плату. Ступени идут в порядке роста цены: симулятор бесплатен и мгновенен, Serial-печать замедляет скетч на миллисекунды за строку, щупы требуют платы, стола и терпения. Мой ночной провал был нарушением порядка: я начал с третьей ступени, не проверив первую. Методика — единственный инструмент, который переносится с проекта на проект целиком, поэтому час на неё возвращается дольше всего.

Симулятор сайта — та же Uno с макеткой в браузере: светодиоды зажигаются, кнопки нажимаются, ползунки крутятся, Serial-монитор печатает. Ценность не в картинке, а в управляемости: время замедляется, вход держится ровно на границе порога, пограничный случай повторяется двадцать раз подряд — на живой плате такое терпение не водится. Логические промахи — не та ветка if, не тот знак сравнения, перепутанный порядок фаз — выявляются здесь за минуты, без единого провода и без риска спалить деталь. Приём для таймингов: замедлите время и посмотрите на фазы построчно — на плате вы бы фотографировали светодиод и надеялись поймать кадр. Граница «ровно на пороге» в симе держится ползунком столько, сколько нужно; на живом датчике она живёт доли секунды. В симе нельзя спалить детали, поэтому смелые гипотезы — нулевые периоды, деление на ноль, зеркальные фазы — проверяйте именно там: живая плата такие эксперименты не прощает.

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

Serial-точка — строка вида etap1 val=512, напечатанная при входе в ветку. Метод: расставить метки на каждом развороте скетча, открыть монитор порта и найти первое место, где реальность разошлась с планом. Строка не пришла — ветка мертва, ищите выше условие; строка пришла со странным значением — виноваты значения, а не поток. Тонкость, которую все замечают на второй день: печать стоит времени. На 9600 бод канал тянет примерно 960 байт в секунду — байт с битами старта и стопа занимает около миллисекунды, значит строка из двадцати символов съедает двадцать миллисекунд; на 115200 тот же текст проходит за две. Если период мигалки 300 мс, печать на каждом витке loop() заберёт заметный кусок — метки ставят на события, а не на каждый проход. Формат метки выбирайте машинно-читаемым: пары имя=значение через пробел потом распарсятся parseInt() или поиском в блокноте, а фраза «сейчас проверяю датчик» парсится только глазами.

Половинное деление — вторая половина ступени, когда меток уже не хватает. Закомментируйте половину кода — или оберните её в #if 0, потому что блочные комментарии вкладывать нельзя, — залейте, посмотрите на симптом. Пропал: виновник внутри закрытой части. Остался: смотрите в оставшейся. Три-четыре среза локализуют строку в файле на сотню строк: сто строк, пятьдесят, двадцать пять, двенадцать. Скучно до зевоты и работает даже тогда, когда кажется, что ломается всё сразу. Правило гигиены среза: закрытую половину держите одним блоком с пометкой, почему она выключена, — иначе через час вы не найдёте, что именно отключили, и включите обратно всё подряд.

Границы метода жёсткие. Печать внутри обработчика прерывания запрещена: Serial держится на прерываниях и зависает внутри ISR — рабочий приём там другой, флаг в volatile-переменной, о чём я писал в уроке про volatile и прерывания. И второй нюанс: Serial.flush() в современных ядрах не чистит приёмник, а дожидается отправки — чтобы слить вход, читайте read() в цикле. Парсинг значений и протоколы с метками разобраны глубже в уроке про отладку через Serial; здесь же я про порядок всей пирамиды.

Мультиметр входит в дело, когда логика в симе сходится, метки печатают честные значения, а схема всё равно молчит. Три измерения закрывают большинство полевых случаев. Первое — напряжение на рейках +5 В и GND под нагрузкой: просело до 4,4 В — источник не тянет, причём без нагрузки тот же блок показывал честные пять. Второе — прозвонка подозрительной дорожки: писк пропал — контакт гнилой. Третье — падение напряжения на проводе под током: доли вольта на перемычке — она и есть виновник. Куда какие щупы и что значат цифры — отдельный урок про мультиметр; здесь важен порядок, а не кнопки прибора. Мой порядок фиксированный: сначала питание на рейках — оно объясняет половину странностей сразу; затем земля от платы до макетки — вторая половина; и только потом сигнальные провода по одному. Перемычка стоит копейки, а часы на её поиски стоят дороже.

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

Дефект в скетче выше — pinMode, направленная на другой пин, — по монитору не видна: все три метки печатают уверенные строки. Противоречие собирается из пары «монитор против светодиода», и половинное деление доводит до строки setup() за три среза: закрыли ветку — симптом остался, закрыли метки — остался, остался setup() — а там уже и искать нечего. На живой плате сценарий продолжается мультиметром: если метки сходятся, а лампа молчит, щуп идёт на пин, потом на рейку. Заметьте и другую сторону: монитор остаётся честным историком — строки печатались в реальном времени, и по ним видно, когда именно лампа должна была зажечься. Цифры при этом умеют скрывать дрожь порога — кривая на плоттере показывает её честнее, об этом в уроке про Serial Plotter.