Author: Processware
Version: 3.0.0
Description: Flask-powered ESPConnect v1.09 with integrated ESP32 diagnostic tools

Major Update: Merged with upstream ESPConnect v1.09!

✅ Fixed flash size determination - More reliable flash operations
✅ CH340 baud auto-lower - Automatically uses 460,800 for CH340 chips
✅ Pause/Resume Serial Monitor - Freeze output temporarily
✅ More chip support - ESP32-C2, C5, C6, C61, H2, P4, P4R3
✅ Espressif documentation links - Direct links to datasheets and TRM
✅ Better USB bridge detection - Improved hardware compatibility
✅ Higher baud rates - Faster flashing options
✅ LittleFS folder navigation - Browse folders in LittleFS
✅ WebSerial_ESPTool updates - Latest flashing improvements

✅ Flask Backend - Serves ESPConnect on port 8080
✅ Diagnostic Tab - Hardware analysis with auto-flash
✅ Auto-Capture - Automatic diagnostic data collection
✅ Pre-compiled Firmware - Ready-to-flash diagnostic bins
✅ I2C Scanner - Detect and identify I2C devices
✅ REST API - Programmatic access to diagnostics

Complete rewrite with powerful diagnostic capabilities:

✅ Flask Backend - Serves ESPConnect Vue.js frontend on port 8080
✅ Diagnostic API - REST endpoints for ESP32 hardware analysis
✅ Pre-compiled Firmware - Ready-to-flash .bin files (ESP32, S2, S3, C3)
✅ I2C Scanner - Detect and identify connected I2C devices
✅ Web Integration - Beautiful diagnostic display in browser
✅ JSON Output - Structured data for easy parsing

# Install dependencies
pip install -r requirements.txt

# Run server
python app.py

# Open browser → http://localhost:8080
# Flash firmware → bin/diagnostic-esp32.bin
# View diagnostics → Serial Monitor (115200 baud)

espconnect-flask/
├── app.py                      # Flask server with diagnostic API
├── static/                     # ESPConnect Vue.js frontend (9.2 MB)
├── bin/                        # Pre-compiled diagnostic firmware (1.1 MB)
│   ├── diagnostic-esp32.bin    # ESP32 (291 KB)
│   ├── diagnostic-esp32-s2.bin # ESP32-S2 (250 KB)
│   ├── diagnostic-esp32-s3.bin # ESP32-S3 (278 KB)
│   └── diagnostic-esp32-c3.bin # ESP32-C3 (271 KB)
├── firmware/                   # Diagnostic tool source code
│   └── esp32-diagnostic-tool/
│       ├── src/main.cpp        # Complete firmware (500+ lines)
│       └── platformio.ini
├── docs/                       # Documentation
│   ├── INTEGRATION_GUIDE.md
│   └── DiagnosticTab.vue
├── Dockerfile
├── docker-compose.yml
└── DEPLOYMENT.md

• Flash ESP32 firmware via browser
• Read/write flash memory
• Partition management
• Serial monitor
• File system management
• No drivers needed

• ✅ Chip info (model, cores, frequency, MAC)
• ✅ Memory analysis (Heap, PSRAM, Flash)
• ✅ GPIO pinout with warnings
• ✅ I2C scanner with device identification
• ✅ System info (SDK, uptime)
• ✅ JSON output for web integration

• ✅ REST API for diagnostic data
• ✅ CORS support
• ✅ Health check endpoint
• ✅ I2C device database
• ✅ Docker ready

Parse serial output and extract JSON

List all stored diagnostics

Get specific diagnostic data

Upload diagnostic JSON

Delete diagnostic data

Get I2C device database

Full API docs: docs/INTEGRATION_GUIDE.md

1. Open http://localhost:8080
2. Connect → Select ESP32
3. Flash Firmware tab
4. Choose .bin file
5. Offset: 0x10000
6. Click Program

1. Serial Monitor tab
2. Baud: 115200
3. Press Reset
4. Copy JSON output

{
  "diagnostic_tool": {
    "chip": {
      "model": "ESP32",
      "cores": 2,
      "frequency_mhz": 240,
      "mac_address": "24:6F:28:XX:XX:XX"
    },
    "memory": {
      "heap": { "total_kb": 327, "free_kb": 298 },
      "flash": { "size_mb": 4, "speed_mhz": 40 }
    },
    "i2c_scan": {
      "devices": [
        { "address": "0x3c", "likely": "OLED Display (SSD1306)" },
        { "address": "0x68", "likely": "MPU6050 IMU" }
      ]
    }
  }
}

docker-compose up -d

Access at http://localhost:8080

pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:8080 wsgi:app

server {
    listen 80;
    location / {
        proxy_pass http://localhost:8080;
    }
}

Full guide: DEPLOYMENT.md

Chromium-based only:

• ✅ Chrome, Edge, Brave, Opera
• ❌ Firefox, Safari (no Web Serial API)

cd firmware/esp32-diagnostic-tool
# Edit src/main.cpp
pio run -e esp32dev
# Binary: .pio/build/esp32dev/firmware.bin

Can't connect: Use Chromium browser, check USB cable
Flash fails: Hold BOOT button, check offset is 0x10000
I2C empty: Check wiring, add 4.7kΩ pull-ups
API errors: Check Flask server logs

• docs/INTEGRATION_GUIDE.md - Web integration tutorial
• DEPLOYMENT.md - Production deployment
• firmware/esp32-diagnostic-tool/FLASH_NOW.md - Firmware guide
• bin/README.md - Pre-compiled firmware docs

• Flask backend with diagnostic API
• Pre-compiled firmware for all ESP32 variants
• I2C scanner with device identification
• Web integration components
• Docker support

• Vue.js frontend
• Web Serial API
• Flash programming

MIT License

• Author: Processware
• Original ESPConnect: thelastoutpostworkshop
• Framework: Flask + Vue.js + PlatformIO

git clone https://github.com/me-processware/ESPConnect.git
cd ESPConnect
pip install -r requirements.txt
python app.py
# Open http://localhost:8080

Built with ❤️ by Processware