A factory menu application for the Heltec WiFi LoRa 32 V3 that allows switching between multiple applications stored in different flash partitions.

• Board: Heltec WiFi LoRa 32 V3
• MCU: ESP32-S3FN8 (8MB Flash)
• Display: 0.96" OLED (128x64 SSD1306)
• Radio: LoRa SX1262
• Features: WiFi, Bluetooth, Battery Management

This project implements a multi-partition boot system that allows you to store multiple independent applications on the ESP32 and switch between them using a menu interface. The factory partition contains the menu system, which always remains accessible.

• PRG Button Navigation: Single-click to navigate through applications
• Double-Click Loading: Double-click to boot into selected application with confirmation
• Return to Factory: Hold PRG button during boot to return to factory menu
• OLED Display: Visual menu with battery voltage display
• Partition Validation: Checks partition integrity before switching
• Error Handling: Visual feedback for errors and invalid partitions
• Serial Debug: Comprehensive logging for troubleshooting

• Single Click PRG Button: Navigate through available applications (or cancel confirmation)
• Double Click PRG Button: Show confirmation popup, then load selected application
• Hold PRG During Boot: Return to factory menu from any loaded application

Important: Once you load an application, it becomes the boot partition. To return to factory menu, you have these options:

Option 1: Use esptool (Most Reliable)

# Set factory as boot partition via USB
esptool.py --chip esp32s3 --port /dev/cu.usbserial-XXXX write_flash 0xe000 ~/.platformio/packages/framework-arduinoespressif32/tools/partitions/boot_app0.bin

Or use the provided script:

./reset_to_factory.sh /dev/cu.usbserial-XXXX

Option 2: Modify Application Binaries

Add factory return code to your applications:

1. Copy include/FactoryReturn.h to your app
2. Add one line to the start of your setup():

#include "FactoryReturn.h"

void setup() {
  checkFactoryReturn();  // Add this as the FIRST line
  
  // ... rest of your setup
}

Then rebuild and re-upload your application binaries. Now you can hold PRG during boot to return to factory.

Why This is Necessary:

The ESP32 can only boot ONE partition at a time. When you load Meshtastic or LoRABLE, that app becomes the boot partition and runs on every reset. The factory menu doesn't run again unless you change the boot partition back (via esptool) or the loaded app checks for a return request (which requires modifying the app).

See RETURN_TO_FACTORY.md for detailed instructions.

• PlatformIO
• USB connection to Heltec LoRa 32 V3

pio run

./upload_all.sh /dev/cu.usbserial-XXXX path/to/Meshtastic.bin path/to/LoRABLE.bin

This will:

1. Build the factory menu
2. Upload bootloader and partition table
3. Upload all three applications to their respective partitions

# 1. Upload factory menu
pio run --target upload

# 2. Upload Meshtastic binary
esptool.py --chip esp32s3 --port /dev/cu.usbserial-XXXX --baud 921600 write_flash 0x210000 Meshtastic.bin

# 3. Upload LoRABLE binary
esptool.py --chip esp32s3 --port /dev/cu.usbserial-XXXX --baud 921600 write_flash 0x410000 LoRABLE.bin

macOS:

ls /dev/cu.*

Look for /dev/cu.usbserial-XXXX or /dev/cu.SLAB_USBtoUART

Linux:

ls /dev/ttyUSB*

Windows: Check Device Manager for COM ports (e.g., COM3)

Espeon/
├── src/
│   └── main.cpp           # Factory menu application
├── include/
├── lib/
├── partitions.csv         # Partition table definition
├── platformio.ini         # PlatformIO configuration
├── upload_all.sh          # Upload script for all partitions
└── README.md

To add a new application partition:

1. Update partitions.csv: Add a new partition entry
2. Update main.cpp: Add the partition to the appPartitions[] array
3. Adjust offsets: Ensure partition offsets don't overlap
4. Build and upload: Upload the new binary to the correct offset

Example partition entry:

myapp, app, ota_3, 0x610000, 0x200000,

• Heltec ESP32 LoRa V3 Library

• PRG Button: GPIO 0 (with internal pullup)
• Debounce Delay: 50ms
• Double-Click Window: 300ms
• Long Press Threshold: 2000ms (reserved for future use)

Connect at 115200 baud to see debug output:

pio device monitor

The serial output shows:

• Current running partition
• Available partitions with addresses
• Button events (clicks, partition loading)
• Error messages

• Verify the binary was uploaded to the correct address
• Check that the partition label matches the name in partitions.csv

• The uploaded binary may be corrupted
• Try re-uploading the application binary

• Ensure GPIO 0 is not being used by other hardware
• Check serial output for button press detection

• Verify the Heltec library is properly installed
• Check that heltec_setup() is called in setup()

MIT License

Built for the Heltec WiFi LoRa 32 V3 using:

• ESP32 Arduino Framework
• Heltec ESP32 LoRa V3 Library by @ropg