readme.md

Markdown · 59 lines

# ESP8266 OLED Text Portal  
### Wireless text sender for SSD1306 OLED with Captive Portal

This project turns an **ESP8266 ESP-12F** module with a **128×64 SSD1306 OLED display** into a small wireless text terminal.  
After powering the device, it creates a **WiFi Access Point** and opens a **captive portal** allowing users to enter any text that will then be displayed on the OLED screen.

Perfect for:
- message boards  
- IoT badges  
- simple wireless displays  
- interactive installations  

---

## ⭐ Features

- **Open WiFi Access Point** (no password required)  
  Network name: `ESP-OLED`
- **Captive portal**
  - Any website request redirects to the configuration page  
  - Works on Android, iOS, Windows, Linux
- **Web interface with live text preview**
- **OLED text rendering**
  - Automatic line wrapping  
  - Clean, readable layout  
- **Default text after boot:** `mikrobot.pl`
- Fully self-contained — **no internet connection required**

---

## 📦 Hardware requirements

- **ESP8266 ESP-12F** module (or similar board)  
- **SSD1306 128x64 OLED I2C** display  
- Correct wiring:  
  - `SDA → GPIO14`  
  - `SCL → GPIO12`  
- USB-to-serial adapter for flashing (CH340 recommended)

---

## 🔧 Software requirements

Install the following libraries via Arduino Library Manager:

- `Adafruit SSD1306`
- `Adafruit GFX`
- `ESP8266WiFi`
- `ESP8266WebServer`
- `DNSServer` (comes with ESP8266 core)

Ensure you have the **ESP8266 core** installed in Arduino IDE.

---

## 🚀 How it works

1. The ESP8266 boots and initializes the SSD1306 display.
2. It starts a WiFi Access Point: