🎹 aCYD MIDI Web Installer

Flash your ESP32 display with aCYD MIDI firmware directly from your browser

✨ No software installation required! This web-based installer uses your browser to flash firmware directly to your ESP32 device via USB.

Requirements

Browser: Chrome, Edge, or Opera (Web Serial API support required)
Connection: USB cable to connect your ESP32 board to your computer
Drivers: ESP32 USB drivers (usually auto-installed, but see ESP32 driver guide if needed)

⚠️ Important: Flashing will erase all existing data on your device. Make sure to back up any configurations if needed.

ESP32-2432S028R (CYD) - 2.8" Display

The classic "Cheap Yellow Display" - 320x240 resolution, 2.8" TFT display (~$15 from AliExpress/Amazon)

Default Build (UART2 for development with debug):

Development Build (UART2 - explicit):

Production Build (UART0 for hardware MIDI, no debug):

ESP32-4832S035C - 3.5" Capacitive Touch

Larger 480x320 display with capacitive touchscreen

Default Build (UART2 for development with debug):

Development Build (UART2 - explicit):

Production Build (UART0 for hardware MIDI, no debug):

ESP32-4832S035R - 3.5" Resistive Touch

Larger 480x320 display with resistive touchscreen

Default Build (UART2 for development with debug):

Development Build (UART2 - explicit):

Production Build (UART0 for hardware MIDI, no debug):

ESP32-4832S040R - 4.0" Resistive Touch

Large 480x320 display with resistive touchscreen

Default Build (UART2 for development with debug):

Development Build (UART2 - explicit):

Production Build (UART0 for hardware MIDI, no debug):

Elecrow ESP32 7.0" - 7.0" Capacitive Touch

Large 800x480 display with capacitive touchscreen

Default Build (UART2 for development with debug):

Development Build (UART2 - explicit):

Production Build (UART0 for hardware MIDI, no debug):

Headless Builds (No Display)

Firmware for ESP32/ESP32-S3 dongles without display - USB MIDI, BLE, and hardware MIDI support

ESP32 Headless (BLE + Hardware MIDI + ESP-NOW master):

ESP32-S3 Headless (Native USB MIDI + BLE + Hardware MIDI + ESP-NOW master):

⚠️ Troubleshooting Flash Errors

If you see "Failed to connect with the device" or "Read timeout exceeded" errors:

The CYD boards use a CH340 USB-to-serial chip which can have compatibility issues with web-based flashing. Try these solutions:

Use PlatformIO/esptool instead: The web installer may not work reliably with CH340 chips. See the Installation Guide for PlatformIO instructions.
Try a different USB cable: Use a high-quality USB cable with data lines (not charge-only).
Try a different USB port: USB 2.0 ports often work better than USB 3.0 ports.
Install CH340 drivers manually: Download from SparkFun's CH340 driver guide.
Manual boot mode (advanced): Some CYD boards may require manually entering download mode:
- Hold the BOOT button (if available)
- Press and release the RST/EN button
- Release the BOOT button
- Try flashing again immediately
Windows users: Make sure no other programs (Arduino IDE, PlatformIO, PuTTY, etc.) are using the COM port.
Linux users: Add your user to the dialout group: sudo usermod -a -G dialout $USER then log out and back in.

Recommended: For the most reliable installation, use PlatformIO as described in the main README.

✅ After Successful Installation

Wait for the installation to complete (usually 1-2 minutes)
Your device will automatically restart
Connect via Bluetooth: Look for "CYD MIDI" in your Bluetooth settings
Select "CYD MIDI" as MIDI input in your DAW or music software
Start making music! 🎵