readme.md

Markdown · 66 lines

# ESP32 SH1106 OLED Text Portal  
### Wireless text sender with captive portal on ESP32 Dev Board

This project turns an **ESP32 Dev Board** plus a **128×64 SH1106 I2C OLED display** into a small wireless text terminal.

After power-up, the ESP32:

- creates an **open WiFi Access Point**,
- runs a **captive portal** (browser login page),
- shows a web form where you can enter any text,
- displays that text on the SH1106 OLED.

Default text on boot: **`mikrobot.pl`**

---

## ⭐ Features

- **Open WiFi Access Point** (no password)
  - SSID: `ESP32-OLED`
  - IP address: `192.168.4.1`
- **Captive portal**
  - Any domain (e.g. `google.com`) is redirected to the ESP32
  - Common OS captive checks handled:
    - Android `/generate_204`
    - iOS/macOS `/hotspot-detect.html`
    - Windows `/ncsi.txt`
- **Web interface**
  - Shows current text on the display
  - Simple form to send new text to the OLED
- **OLED rendering**
  - Automatic word-wrap
  - Clear 128×64 monochrome display

---

## 📦 Hardware requirements

- **ESP32 Dev Board** (e.g. ESP32-DevKitC)
- **128×64 SH1106 I2C OLED display module**

### 🔌 SH1106 → ESP32 wiring

On your SH1106 I2C module the clock pin is labeled **SCK** instead of **SCL**.  
That is normal – it is still the I²C clock line.

Typical pins on the SH1106 module:

- `VCC`
- `GND`
- `SCK`  (I²C clock, sometimes labeled SCL or CLK)
- `SDA`  (I²C data)

Connect them to the ESP32 as follows:

| SH1106 Pin | ESP32 Pin | Description                    |
|-----------:|-----------|--------------------------------|
| VCC        | 3V3       | 3.3 V Power                    |
| GND        | GND       | Ground                         |
| SCK        | GPIO22    | I²C Clock (SCK on your module) |
| SDA        | GPIO21    | I²C Data (SDA)                 |

In the code, I²C is initialized as:

```cpp
Wire.begin(21, 22); // SDA, SCK (clock)