ES-3초급
ESP32와 버튼으로 LED 켜고 끄기 (Toggle)
버튼을 누를 때마다 LED 상태가 바뀌어요. 켜져 있으면 꺼지고, 꺼져 있으면 켜져요. 고전적인 토글 패턴이에요. 디바운싱으로 푸시 버튼의 기계적 노이즈를 걸러서 한 번 누르면 한 번만 바뀌게 해요.
4.6(39)
59 완료
버튼을 한 번 누르면 LED가 켜지고, 다시 누르면 꺼져요. 집에 있는 전등 스위치와 같아요. ESP32는 버튼이 눌리는 바로 그 순간을 잡아내고 버튼 안의 미세한 떨림은 무시해서, 한 번 누를 때 한 번만 바뀌어요. 거의 모든 기기에 있는 켜기/끄기 버튼의 원리를 여기서 배워요.
동영상
회로도

소스 코드
C++ (Arduino IDE)
1// ─────────────────────────────────────────
2// BlueGrays · bluegrays.com
3// ESP32 LED Control with Pushbutton (Toggle)
4// ─────────────────────────────────────────
5// Each press of the button toggles the LED: on becomes off, off becomes
6// on. A 50 ms debounce makes sure one press gives exactly one toggle.
7//
8// Pins:
9// GPIO 5 -> Red LED (with a 220 ohm resistor)
10// GPIO 4 -> Button (other leg to GND)
11
12const int LED_PIN = 5; // LED output
13const int BUTTON_PIN = 4; // Button input
14
15bool ledState = false; // Is the LED on now
16bool lastButton = HIGH; // Previous button reading
17bool stableButton = HIGH; // Stable (debounced) button state
18unsigned long lastChange = 0; // Last time the reading changed (ms)
19const unsigned long DEBOUNCE = 50; // Debounce time (ms)
20
21void setup() {
22 pinMode(LED_PIN, OUTPUT);
23 pinMode(BUTTON_PIN, INPUT_PULLUP); // Reads HIGH when not pressed
24}
25
26void loop() {
27 bool buttonState = digitalRead(BUTTON_PIN);
28
29 // Restart the timer whenever the reading changes
30 if (buttonState != lastButton) lastChange = millis();
31
32 // A reading that stays the same for DEBOUNCE ms counts as stable. The LED toggles once, only when
33 // the stable state turns LOW (a new press).
34 if (millis() - lastChange > DEBOUNCE && buttonState != stableButton) {
35 stableButton = buttonState;
36 if (stableButton == LOW) {
37 ledState = !ledState;
38 digitalWrite(LED_PIN, ledState);
39 }
40 }
41 lastButton = buttonState;
42}
43FAQ
디바운싱 시간은 얼마나 길어야 해요?
대부분의 버튼은 20–50 ms면 충분해요. 너무 짧으면 채터링이 여전히 감지되고, 너무 길면 빠르게 연달아 누른 입력을 놓쳐요.
토글하려면 어떤 상태를 잡아야 해요?
버튼이 "눌리는" 순간만 잡으세요(INPUT_PULLUP을 쓴다면 HIGH에서 LOW로 바뀌는 순간). 버튼을 누르고 있는 동안 LED가 계속 토글되지 않도록 이전 버튼 상태를 변수에 저장해 두세요.
디바운싱에 `delay()`를 써도 돼요?
간단한 프로젝트에서는 괜찮지만, delay()는 현재 loop() 실행을 멈춰서 같은 흐름의 다른 작업을 늦춰요. ESP32의 다른 태스크는 계속 돌 수 있어요. millis() 기반 타이밍을 쓰면 loop() 안의 작업을 블로킹 없이 처리할 수 있어요.
전원을 껐다 켜도 LED가 마지막 상태를 기억할 수 있어요?
네, ESP32에서는 Preferences 라이브러리로 상태를 비휘발성 메모리에 쓰고 시작할 때 읽어 올 수 있어요. 그러면 전원이 나갔다 들어와도 LED가 마지막 상태로 시작해요.

