ESP32/doc/DEPLOYMENT_GUIDE.md

67 lines
1.5 KiB
Markdown

# ESP32 Mass Deployment Scripts
Scripts for deploying, configuring, and testing multiple ESP32 devices in parallel.
## Scripts
### 1. `mass_deploy.sh` - Basic Deployment
Simple parallel flashing and configuration.
**Usage:**
```bash
chmod +x mass_deploy.sh
PASSWORD='your_wifi_password' ./mass_deploy.sh ~/Code/esp32/esp32-iperf
```
### 2. `mass_deploy_enhanced.sh` - Production Deployment (RECOMMENDED)
Enhanced version with retry logic and verification.
**Usage:**
```bash
chmod +x mass_deploy_enhanced.sh
# Basic usage
PASSWORD='your_wifi_password' ./mass_deploy_enhanced.sh ~/Code/esp32/esp32-iperf
# With custom settings
PASSWORD='mypass' \
SSID='MyNetwork' \
START_IP='192.168.1.100' \
./mass_deploy_enhanced.sh
```
**Environment Variables:**
- `PASSWORD` - WiFi password (required)
- `SSID` - WiFi SSID (default: ClubHouse2G)
- `START_IP` - Starting IP (default: 192.168.1.51)
- `MAX_RETRIES` - Retry attempts (default: 2)
- `VERIFY_PING` - Test after config (default: true)
### 3. `test_devices.sh` - Device Testing
Tests all deployed devices with iperf.
**Usage:**
```bash
chmod +x test_devices.sh
NUM_DEVICES=32 ./test_devices.sh
```
## Quick Start
```bash
# 1. Connect all ESP32 devices via USB
# 2. Deploy with one command
PASSWORD='your_wifi_pass' ./mass_deploy_enhanced.sh ~/Code/esp32/esp32-iperf
# 3. Test all devices
NUM_DEVICES=32 ./test_devices.sh
```
## Performance
**Before:** 60-90 minutes (sequential)
**After:** 15-20 minutes (parallel) ⚡
See DEPLOYMENT_GUIDE.md for full documentation.