Skip to content

flashing.md

Latest commit

 

History

History
127 lines (88 loc) · 4.07 KB

flashing.md

File metadata and controls

127 lines (88 loc) · 4.07 KB
Raw

Flashing the Evil Crow RF V2 / Flasheo del Evil Crow RF V2

Prerequisites / Requisitos

  • Ubuntu/Debian Linux (other distros should work with minor adjustments)
  • USB cable to the Evilcrow's USB-A port
  • Real esptool v4.7+ via pipx (the Ubuntu apt package esptool 4.7.0+dfsg is broken — strips stub flasher blobs):
sudo apt install -y pipx
pipx install esptool
pipx ensurepath
# Open a new terminal so PATH is refreshed / Abre nueva terminal
esptool version  # Should report v4.7+ or v5.x
  • Your user needs access to /dev/ttyUSB0. Either run with sudo, or add yourself to the dialout group:
sudo usermod -aG dialout $USER
# Then logout/login

Identifying the chip / Identificar el chip

sudo esptool -p /dev/ttyUSB0 chip-id

Expected for Evil Crow RF V2 / Esperado:

Chip is ESP32-PICO-D4 (revision v1.1)

If different, this guide may not apply directly / Si es distinto, esta guía puede no aplicar directamente.

Required binaries / Binarios necesarios

Clone both repos:

cd ~
git clone https://github.com/joelsernamoreno/EvilCrowRF-V2.git
git clone https://github.com/DMFSouza/EvilCrowRF_HUN73R.0047.git

You need:

  • Bootloader: EvilCrowRF-V2/compiled/firmware.ino.bootloader.bin
  • Partition table: EvilCrowRF-V2/compiled/firmware.ino.partitions.bin
  • App (choose one):
    • HUN73R (mobile UI, recommended): EvilCrowRF_HUN73R.0047/Firmware/BETA_v2.5_EvilCrow-RFv2.ino.esp32.bin
    • v1.3.2 (desktop UI, fallback): EvilCrowRF-V2/old-firmware/v1.3.2/EvilCrow-RFv2/EvilCrow-RFv2.ino.esp32.bin

Do NOT use EvilCrowRF-V2/compiled/firmware.ino.bin — it silently hangs on PICO-D4.

NO uses EvilCrowRF-V2/compiled/firmware.ino.bin — se cuelga silenciosamente en PICO-D4.

Full flash (recommended) / Flasheo completo (recomendado)

This wipes the flash and writes everything fresh / Esto borra el flash y escribe todo limpio:

APP=~/EvilCrowRF_HUN73R.0047/Firmware/BETA_v2.5_EvilCrow-RFv2.ino.esp32.bin

sudo esptool -p /dev/ttyUSB0 -b 460800 erase-flash

sudo esptool -p /dev/ttyUSB0 -b 460800 write-flash \
    0x1000  ~/EvilCrowRF-V2/compiled/firmware.ino.bootloader.bin \
    0x8000  ~/EvilCrowRF-V2/compiled/firmware.ino.partitions.bin \
    0x10000 "$APP"

Expected output ends with Hash of data verified. for each file, then Hard resetting via RTS pin....

Output esperado termina con Hash of data verified. por cada archivo, luego Hard resetting via RTS pin....

Verification / Verificación

  1. Open serial monitor / Abre monitor serie:

    sudo picocom -b 115200 /dev/ttyUSB0

  2. Press RESET on the board / Pulsa RESET en la placa.

  3. You should see the boot banner. With HUN73R app, output may use a different baud after the boot banner — that's expected, ignore garbage characters.

  4. Within ~5 seconds, the WiFi network Evil Crow RF v2 should appear on a phone. Password: 123456789.

  5. Open http://192.168.4.1 in a mobile browser. The web panel should load.

Common mistakes / Errores comunes

❌ DON'T do this / NO hagas esto

# WRONG: erases bootloader, writes only app — bricks the device
esptool.py erase_flash
esptool.py write_flash 0x10000 some_app.bin
# WRONG: writes app to wrong offset
esptool.py write_flash 0x0 some_app.bin
# WRONG: uses Ubuntu apt esptool which is broken in 24.04 noble
sudo apt install esptool  # Has missing stub flasher blobs (4.7.0+dfsg-0.1)

✅ DO this / SÍ hacer

  • Always flash bootloader + partitions + app together as shown above.
  • Use pipx install esptool (proper PyPI version), not Ubuntu's apt install esptool.
  • For recovery from unknown state: erase-flash first, then write-flash all three files.

Restoring from a flash dump / Restaurar desde un dump

If you have a previously-made read-flash dump of a working device, you can restore it as a single image at 0x0:

Si tienes un dump previo de un dispositivo funcional:

sudo esptool -p /dev/ttyUSB0 -b 460800 write-flash 0x0 dump.bin

The dump must be exactly the flash size (0x400000 = 4 MB for PICO-D4).