YKR038 COURSE · MODULE 3 · LESSON 15
Read a Push Button with ESP32
Build a stable digital input circuit and detect pressed and released states.
Follow the numbered steps in order. Do not connect USB power until the wiring step tells you to. Compare every pin label before continuing.
LESSON GOAL
What you will build and learn
In this lesson, you will learn digital input and internal pull-up resistance. By the end, serial Monitor reports reliable button states.
- Recognize the purpose of each required part.
- Make the connections in a safe, repeatable order.
- Upload or run the lesson procedure and verify the expected result.
- Use observable evidence to fix common problems.
A close, labeled photograph of this exact experiment will be added here. Until then, use the written pin-by-pin connection list below.
STEP-BY-STEP GUIDE
Build the experiment
Understand the target result
Build a stable digital input circuit and detect pressed and released states. The expected result is: Serial Monitor reports reliable button states.
Prepare the board and parts
Disconnect the ESP32 from USB. Put the ESP32, breadboard, jumper wires, and the listed lesson parts in front of you. Straighten bent pins gently and never force a module into the breadboard.
Make each connection with power off
- Place the push button across the breadboard center gap.
- Connect one button side to GPIO 4.
- Connect the opposite side to GND; the sketch enables the internal pull-up resistor.
Power check: confirm that no 5V signal goes directly into an ESP32 GPIO and that 3.3V is not connected to GND.
Install any library and upload the code
No additional Arduino library is required for this starter sketch. Select your ESP32 board and serial port before clicking Upload.
const int BUTTON = 4;
void setup() { Serial.begin(115200); pinMode(BUTTON, INPUT_PULLUP); }
void loop() {
bool pressed = digitalRead(BUTTON) == LOW;
Serial.println(pressed ? "PRESSED" : "RELEASED");
delay(100);
}Power the circuit and observe
Connect USB power only after the wiring check. Open Serial Monitor at 115200 baud when the sketch prints data. Watch the circuit for at least 20 seconds and compare it with this expected behavior: Serial Monitor reports reliable button states.
Change one value and test again
Make one small change—such as a delay, threshold, brightness, or displayed message—then upload again. This confirms that you understand which part of the program controls the result.
WHY IT WORKS
The key idea
This experiment demonstrates digital input and internal pull-up resistance. The ESP32 repeatedly reads or updates the connected hardware, applies the program logic, and produces the observable result. Changing one input or one code value helps you see that relationship directly.
TROUBLESHOOTING
If the experiment does not work
Nothing powers on
Disconnect USB. Check the USB cable, 3.3V/5V selection, GND rail, and breadboard row placement.
Upload fails
Confirm the board and port. Close other serial programs, reconnect USB, and hold BOOT only if your board requires it.
Result is unstable
Shorten jumper wires, confirm a shared ground, and verify that input pins are not floating.
Lesson-specific check
With INPUT_PULLUP, pressed normally reads LOW.
VIDEO WALKTHROUGH
Hands-on lesson video reserved
The final video will show the real YKR038 parts, every wire connection, the upload process, and the expected result.