Переключатель на кнопке: toggle и счётчик нажатий

Ночник у прикроватной тумбочки я собрал за десять минут и ещё неделю не мог понять, почему он работает через раз. Нажимаешь — включился. Нажимаешь второй — снова включился, хотя должен погаснуть. Третий — погас. Схема была образцовая: INPUT_PULLUP, кнопка между пином 2 и GND, светодиод на 13-м — по всем канонам. Логика «нажал — переключил» была написана без ошибок, но реакция висела на уровне «кнопка нажата», а не на моменте нажатия: за один клик код успевал инвертировать свет шесть-семь раз, и то, куда свет приходил в итоге, зависело от того, где именно затихал дребезг. Снаружи это выглядело как случайность, на деле — чётная серия инверсий, аккуратно возвращающая всё на место.

В этом уроке соберём переключатель по-нормальному: переменная ledState хранит текущее состояние света, инверсия происходит по фронту нажатия — один раз на клик, а счётчик нажатий в Serial подтвердит, что фильтр дребезга не дырявый. Разберём, почему в toggle антидребезг — не украшение, а обязательное условие, чем плоха пауза через delay(), и как замерить короткое и длинное нажатие — идея, которая превращает одну кнопку в интерфейс с двумя командами. Кстати, сам термин toggle пришёл из английского: тумблер после каждого щелчка остаётся в новом положении — в противоположность звонковой кнопке, возвращающейся сама.

digitalRead() возвращает уровень: пока палец на кнопке — LOW, отпустили — HIGH. Задержали кнопку на секунду — условие «кнопка нажата» истинно весь этот период, сотни кругов loop(). Если в каждом таком круге инвертировать состояние света, он переключится столько раз, сколько оборотов успеет сделать loop() за удержание. Даже простейший «инвертор» без фильтра наматывает несколько инверсий только за дребезг, не говоря об удержании. Формально скетч «работает»: инверсия есть, свет переключается. Ломается он на подсчёте — сколько именно раз он переключился, никто не контролировал.

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

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

Хранителем состояния служит переменная ledState: она помнит, горит свет или нет, между кликами. Сам пин ничего не помнит — digitalRead() отвечает только за кнопку, а светодиоду мы каждый раз говорим, что ему делать. Логика toggle выглядит так: поймали фронт нажатия — если ledState был true, делаем false; был false — делаем true; после этого digitalWrite(13, ledState) выставляет светодиоду новое состояние. Внутри инверсии я сознательно пишу развилку if/else, а не сокращённое отрицание: на старте полезно видеть обе ветки глазами. Переменную объявляю над setup(), глобально: она обязана переживать каждый круг loop() — локальная умирала бы вместе с проходом, и свет сбрасывался бы каждый раз.

В примере ниже антидребезг сделан по-грубому, паузой delay(300), — чтобы показать рабочий минимум и его границы. Пока пауза длиннее суммарного дребезга и времени удержания, переключатель ведёт себя прилично: один клик — одно переключение. Проблемы вылезают на границах: удержание дольше 300 мс даёт второе переключение (свет мигает, пока держишь), а любая параллельная задача в loop() замирает на время паузы. Для прикидки: круг loop() в простом скетче занимает микросекунды, значит за паузу 300 мс плата пропускает десятки тысяч шансов проверить кнопку — не страшно для одного выключателя, фатально для мигалки в том же корпусе.

Счётчик нажатий здесь — не баловство, а измерительный прибор. Если печатать номер клика и итоговое состояние света в Serial, поведение toggle становится читаемым: клик пятый — свет включился, клик шестой — выключился. Как только числа в Serial перестают совпадать с вашими щелчками — фильтр дырявый, и вы увидите это раньше, чем заметите на светодиоде. Мой формат строки — номер клика, стрелка и итог: «Клик 6 -> свет ВЫКЛ». Одна строка на событие — и отладка превращается в чтение дневника.

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

Лечение — тот же неблокирующий каркас из прошлого урока: lastButtonState, lastDebounceTime, интервал 20–50 мс, реакция только на фронт HIGH→LOW. Счётчик нажатий остаётся тестером: в правильно собранном toggle число кликов в Serial всегда равно числу ваших щелчков, а нажатий ровно столько же, сколько отпусканий. Любое расхождение — сигнал, что интервал не подходит конкретной кнопке, и это первый параметр, который я кручу. Правило простое: одно нажатие — один клик в Serial, одно отпускание на каждое нажатие, одно переключение света на каждый клик. Три числа должны сходиться, как в бухгалтерии.

Следующая ступень — короткое и длинное нажатие. Идея простая: в момент фронта нажатия запомнить millis(), в момент отпускания посчитать разницу. Держали меньше 400 мс — обычный клик, переключаем свет; больше 800 мс — «долгое» нажатие, другая команда: мигнуть дважды или перевести ночник в ночной режим. В смартфонах и машинах так устроены почти все кнопки с двойной функцией. Оговорка: не добавляйте длинное нажатие, пока не добились идеального одиночного срабатывания — сначала чистый фронт, потом усложнения, иначе будете отлаживать две проблемы одновременно. Пороги держите в const: правка одной константы — и вся чувствительность кнопки перенастроена.

Теперь у вас есть полный набор для любой кнопки: чистый фронт, неблокирующий антидребезг и переменная состояния — из этого конструктора собираются выключатели, меню и переключатели режимов любого масштаба. Дальше по курсу свет перестанет быть бинарным: в следующем уроке мы возьмём analogWrite() и ШИМ, чтобы менять яркость светодиода плавно — от тусклого ночника до полной мощности одной строкой кода. Пощёлкайте выключателем в симуляторе и посчитайте суммарное время горения из эксперимента выше — эта копилка пригодится в проектах с ночным режимом. И проверьте себя вслух: скажите, на каком условии висит ваша реакция — на уровне или на фронте. Если ответили мгновенно, урок удался.