⚡ ESP32 GPIO Not Working - Complete Fix Guide

• 📌 Input-Only Pins – GPIO 34, 35, 36, 39 are input-only (cannot be used as outputs)
• 📌 Strapping Pins – GPIO 0, 2, 5, 12, 15 affect boot behavior
• 📌 Pin Already in Use – Some pins are used by internal functions (flash, PSRAM, etc.)
• 📌 Incorrect Pin Mode – Using INPUT mode when you need OUTPUT
• 📌 Floating Pin – No pull-up/pull-down resistor on input pins
• 📌 Voltage Level Issues – ESP32 is 3.3V, not 5V tolerant on most pins

❌ WRONG - Using input-only pin as output:

pinMode(34, OUTPUT);  // GPIO 34 is INPUT ONLY!
digitalWrite(34, HIGH);  // This will NOT work

✅ CORRECT - Use proper output pins:

pinMode(4, OUTPUT);   // GPIO 4 is safe for output
digitalWrite(4, HIGH);  // This works!

🔧 Test with this simple sketch:

void setup() {
    Serial.begin(115200);
    pinMode(4, OUTPUT);
}

void loop() {
    digitalWrite(4, HIGH);
    Serial.println("Pin 4 HIGH");
    delay(1000);
    digitalWrite(4, LOW);
    Serial.println("Pin 4 LOW");
    delay(1000);
}

These pins affect how your ESP32 boots. Avoid using them or ensure proper pull-up/down resistors:

Floating input pins cause random readings. Use internal or external resistors:

Using internal pull-up (software):

pinMode(4, INPUT_PULLUP);  // Enable internal pull-up

Using internal pull-down (ESP32 only):

pinMode(4, INPUT_PULLDOWN);  // Enable internal pull-down

External resistor (more reliable for critical applications):

// Add 10kΩ resistor between GPIO and 3.3V for pull-up
// Add 10kΩ resistor between GPIO and GND for pull-down

Use a level shifter for 5V devices:

// Connect 5V sensor through level shifter:
// 5V Sensor Output → Level Shifter (5V side)
// Level Shifter (3.3V side) → ESP32 GPIO

For analog inputs, use a voltage divider:

// Convert 5V to 3.3V:
// Use 2.2kΩ and 3.3kΩ resistors
// Max voltage: 5V * (3.3 / (2.2 + 3.3)) = 3.0V

Disconnect everything and test with just an LED:

// LED connected between GPIO 4 and GND (with 220Ω resistor)
void setup() {
    pinMode(4, OUTPUT);
}

void loop() {
    digitalWrite(4, HIGH);
    delay(500);
    digitalWrite(4, LOW);
    delay(500);
}

If the LED blinks, your ESP32 is working! Then add components one by one.

• Use GPIO 4, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33 for reliable operation
• Avoid GPIO 0, 2, 5, 12, 15 unless you understand boot implications
• Remember: GPIO 34-39 are input only – never use them as outputs!
• Add pull-up/pull-down resistors to all input pins
• Use level shifters for 5V sensors
• Test each pin with a simple blink sketch before connecting components

• ESP32 ADC Inaccurate Reading
• ESP32 Low Memory Crash
• ESP32 Not Detected via USB

OceanRemote generates code with:

• ✓ Pre-configured GPIO pins
• ✓ Relay and sensor support
• ✓ WiFi and cloud connection
• ✓ No coding required