SecureVault Firmware Installer

GPIO Configuration

Configure hardware pin mappings for custom boards, or use the default EdgeHax S3-PRO mapping.

EdgeHax S3-PRO Default Pinout

No extra steps needed. Flash the firmware using the Connect Device button above and the default EdgeHax S3-PRO pin mapping will be used automatically.

TFT_CS4

TFT_RST5

TFT_DC7

TFT_MOSI15

TFT_CLK16

TFT_MISO39

TOUCH_CS14

T_DO41

RTC_SDA1

RTC_SCL2

LADDER_PIN6

TOUCH_PIN40

BUZZER_PIN38

SD_CS10

SD_MOSI11

SD_SCK12

SD_MISO13

I2S_MCLK9

I2S_SDIN38

I2S_LRCLK21

I2S_BCLK42

Only change pins that differ from the defaults. Unchanged pins will use the EdgeHax S3-PRO mapping automatically.

⚙ Display (ILI9341 TFT)

TFT_CS default: 4

TFT_RST default: 5

TFT_DC default: 7

TFT_MOSI default: 15

TFT_CLK default: 16

TFT_MISO default: 39

☝ Touch (XPT2046)

TOUCH_CS default: 14

T_DO default: 41

🔌 I2C Bus

RTC_SDA default: 1

RTC_SCL default: 2

RTC_I2C_ADDR default: 0x68 (104)

MPU_ADDR default: 0x69 (105)

EEPROM_I2C_ADDR default: 0x57 (87)

INA219_I2C_ADDR default: 0x40 (64)

🎧 Input / Output

LADDER_PIN default: 6

TOUCH_PIN default: 40

BUZZER_PIN default: 38

💾 SD Card

SD_CS default: 10

SD_MOSI default: 11

SD_SCK default: 12

SD_MISO default: 13

🎵 I2S Audio

I2S_MCLK default: 9

I2S_SDIN default: 38

I2S_LRCLK default: 21

I2S_BCLK default: 42

GPIO Config Generated Successfully

Download gpio_cfg.bin

Flash the GPIO config to your device:

esptool.py --chip esp32s3 --port /dev/ttyACM0 write_flash 0x410000 gpio_cfg.bin

Note: This flashes only the GPIO configuration, not the firmware. Flash the firmware separately using the Connect Device button above. The GPIO config will take effect after the next reboot.

View raw hex dump

Supported Hardware

Board:

EdgeHax ESP32-S3 S3-PRO (N16R8)

Chip Family:

ESP32-S3 Dual-Core • 16MB Flash • 8MB PSRAM

Display:

ILI9341 320x240 TFT + XPT2046 Touch

Installation Steps

Connect the device using a USB data cable (not a charging cable).
Open Chrome, Edge, Brave, or Opera.
Click the Connect Device button above.
Select the ESP32 serial port from the browser prompt.
Allow firmware installation to proceed.
Wait for flashing to complete (~30 seconds).
The device will reboot automatically.
Default PIN is 1234 — change it in Settings.

6-Layer Security

Layer 1: ECDH P-256 key exchange
Layer 2: HKDF-SHA256 session key derivation
Layer 3: AES-256-GCM per-message encryption
Layer 4: Sequential nonces (replay protection)
Layer 5: Method tunneling (obfuscated envelopes)
Layer 6: Traffic padding + chaff (pattern hiding)

Browser Compatibility

Google Chrome (recommended)
Microsoft Edge
Brave Browser
Opera Browser
Web Serial API support required

Firefox and Safari do not support Web Serial API yet.

Important Notes

Use a USB data cable (charging cables won't work).
Close PlatformIO Serial Monitor or Arduino IDE before flashing.
Disconnect other serial tools (PuTTY, minicom, etc.).
Do not unplug during flashing.
Use direct USB ports (avoid USB hubs if possible).
If the button doesn't appear, check browser Web Serial support.

Troubleshooting

Try a different USB cable (many cables are power-only).
Install CP210x or CH340 USB-serial drivers on your OS.
Refresh the browser page and reconnect.
Hold BOOT button while connecting to enter bootloader mode.
Verify manifest.json loads correctly in the browser.
Verify BIN file paths in manifest.json are accessible.
Check that your board is ESP32-S3 (not ESP32 or ESP32-C3).

After Flashing

Default unlock PIN is 1234.
Change it immediately in Settings → Change PIN.
BLE HID typing works out of the box — pair from your phone.
AP Mode: tap mode badge → AP MODE for WiFi management.
Dashboard: tap mode badge → DASHBOARD for Electron app.