ESP32/doc/DEPLOYMENT_GUIDE.md

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:

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:

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:

chmod +x test_devices.sh
NUM_DEVICES=32 ./test_devices.sh

Quick Start

# 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.