# ESP32-C3-with-micro-servo

> Control servo via WiFi with a captive portal. Uses GPIO 4.

- Author: Vesp
- Platform: ESP32
- Board: ESP32C3 Dev Module (`esp32:esp32:esp32c3`)
- SDK version: 3.3.6
- Tags: #esp32, #captive-portal, #example, #servo
- Created: 2026-11-14
- Updated: 2026-11-15
- Favorites: 0, forks: 0
- Forked from: [Mikrobot.pl/esp-32-with-micro-servo-example](https://flashesp.com/explore/km4MK7p7fT3w4GMZnl8Y5.md)
- Project page (view, flash from the browser, fork): https://flashesp.com/explore/D4goACcEA5kGQumCYHdhy
- Download all sources (zip): https://flashesp.com/api/public-projects/D4goACcEA5kGQumCYHdhy/download-sources/

## Source files

- [libraries_lock.json (89 B)](https://flashesp.com/explore/D4goACcEA5kGQumCYHdhy/files/sUkFSMXfLfWcTq4O2WA4M.md)
- [main.ino (6.9 KB)](https://flashesp.com/explore/D4goACcEA5kGQumCYHdhy/files/Y0X3VdvFNEt6KYyJBoWmX.md)
- readme.md (3.3 KB)

## README

# ESP32 Servo Captive Portal
### Control an MG90S servo (left / right) via WiFi with a captive portal

This project turns an **ESP32-C3 Board** into a small WiFi-controlled servo module.
When powered, the ESP32 creates an **open WiFi Access Point** and a **captive portal**.
As soon as a device connects to the AP, a control page appears that lets you move the
servo **Left**, **Right**, back to **Center**, or set a **precise angle** with a slider.

---

## ⭐ Features

- **Open WiFi Access Point** (no password)
  - SSID: `ESP32-Servo`
- **Captive portal**
  - Any URL request (e.g. `google.com`) is redirected to the servo control page
  - Works with Android / iOS / Windows / Linux
- **Web-based servo control**
  - Left / Center / Right buttons (15° step per press, adjustable)
  - Slider for a precise 0–180° angle
  - Live angle display
- No external network or internet required

---

## 📦 Hardware requirements

- **ESP32-C3** 
- **MG90S servo** (or any standard 180° hobby servo)

### Wiring

The MG90S has 3 wires:

| Servo wire       | Connect to               |
|------------------|---------------------------|
| Orange/Yellow (signal) | ESP32 GPIO 4 (default, see `SERVO_PIN`) |
| Red (VCC)        | ESP32 **5V** pin (or external 5–6V supply) |
| Brown/Black (GND)| ESP32 **GND** (must share ground with the ESP32 even if using an external supply) |

> A single MG90S can usually be powered directly from the ESP32's 5V pin over USB.
> If the servo jitters, resets the board, or misbehaves under load, power it from a
> separate 5–6V supply and make sure its ground is still connected to the ESP32's GND.

---

## 🛠️ Software requirements

1. **Arduino IDE** with ESP32 board support installed
   (Boards Manager → search "esp32" → install by Espressif Systems)
2. **ESP32Servo** library
   Arduino IDE → Tools → Manage Libraries → search "ESP32Servo" (by Kevin Harrington / madhephaestus) → Install

---

## 🚀 Usage

1. Open `esp32_servo_control.ino` in the Arduino IDE.
2. If your servo signal wire is on a different pin, change:
   ```cpp
   #define SERVO_PIN 4
   ```
3. Select your ESP32 board and COM port, then upload the sketch.
4. Open the Serial Monitor (115200 baud) to confirm:
   ```
   AP started. SSID: ESP32-Servo
   AP IP address: 192.168.4.1
   ```
5. On your phone or laptop, connect to the WiFi network **`ESP32-Servo`** (no password).
6. A control page should open automatically (captive portal). If it doesn't, open a
   browser and go to `http://192.168.4.1`.
7. Use the **Left** / **Center** / **Right** buttons or the slider to move the servo.

---

## ⚙️ Configuration options

All adjustable at the top of the `.ino` file:

```cpp
#define SERVO_PIN 4         // GPIO connected to the servo signal wire
#define SERVO_MIN_US 500    // Pulse width for 0° — tune if the servo doesn't reach full range
#define SERVO_MAX_US 2400   // Pulse width for 180°
#define ANGLE_STEP 15       // Degrees moved per Left/Right button press
```

---

## 🔧 Troubleshooting

- **Servo doesn't move / twitches constantly**: check wiring, especially a shared GND
  between the ESP32 and the servo's power source.
- **Servo resets the ESP32 when moving**: the servo is drawing more current than the
  onboard 5V regulator can supply — use an external 5–6V power source for the servo.
- **Captive portal doesn't pop up automatically**: connect manually by browsing to
  `http://192.168.4.1`.
