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: