INSYNE Engineering

esptool

Se lee en 2 min

esptool

Utilidad oficial de Espressif para comunicarse con dispositivos ESP8266 y ESP32 a través del puerto serie.

Capacidades

  • Instalar firmware
  • Crear backups completos
  • Borrar completamente la memoria flash
  • Obtener información del chip
  • Leer la dirección MAC
  • Combinar archivos binarios

Referencia Rápida

TareaComando
Borrar flasherase-flash
Instalar firmwarewrite-flash
Crear backupread-flash
Leer MACread-mac
Información de la flashflash-id
Combinar archivos binariosmerge-bin

Instalación

Crear un entorno virtual de Python:

python -m venv esptool-env

Activar el entorno virtual:

Linux

source esptool-env/bin/activate

Windows (CMD)

esptool-env\Scripts\activate.bat

Windows (PowerShell)

esptool-env\Scripts\Activate.ps1

Instalar esptool:

pip install esptool

Verificar la instalación:

esptool version

Activar el entorno virtual

Antes de utilizar esptool se debe activar el entorno virtual:

source esptool-env/bin/activate

Borrar completamente la memoria flash

esptool -p /dev/ttyUSBx erase-flash

Ejemplos rápidos

esptool -p /dev/ttyUSB0 erase-flash

Instalar firmware

esptool -p /dev/ttyUSBx -b 115200 write-flash -fm dout <offset1> filename1.bin <offset2> filename2.bin <offset3> filename3.bin

Ejemplos rápidos

esptool -p /dev/ttyUSB0 -b 115200 write-flash -fm dout 0x00000 firmware.bin
esptool -p /dev/ttyUSB0 -b 115200 write-flash -fm dout 0x1000 bootloader.bin 0x8000 partition-table.bin 0x10000 app.bin

Nota El modo dout es requerido por numerosos dispositivos ESP8266 compatibles con Tasmota.

Crear un backup completo

esptool -p /dev/ttyUSBx -b 115200 read-flash 0x00000 ALL filename.bin

Ejemplos rápidos

esptool -p /dev/ttyUSB0 -b 115200 read-flash 0x00000 ALL backup.bin

Obtener información de la memoria Flash

esptool -p /dev/ttyUSBx flash-id

Ejemplos rápidos

esptool -p /dev/ttyUSB0 flash-id

Leer la dirección MAC

esptool -p /dev/ttyUSBx read-mac

Ejemplos rápidos

esptool -p /dev/ttyUSB0 read-mac

Combinar varios archivos binarios en un único archivo

esptool -c <chip_type> merge-bin -o output_filename.bin -fm dio -ff keep -fs keep <offset1> filename1.bin <offset2> filename2.bin <offset3> filename3.bin

Ejemplos rápidos

esptool -c esp32 merge-bin -o firmware.bin -fm dio -ff keep -fs keep 0x1000 bootloader.bin 0x8000 partition-table.bin 0x10000 app.bin
esptool -c esp32s2 merge-bin -o firmware.bin -fm dio -ff keep -fs keep 0x1000 bootloader.bin 0x8000 partition-table.bin 0x10000 app.bin

Notas

  • Cerrar cualquier monitor serie antes de utilizar esptool.
  • Utilizar un cable USB de buena calidad.
  • Algunos dispositivos requieren mantener GPIO0 conectado a GND durante el reinicio para ingresar en modo de programación.
  • Reemplazar /dev/ttyUSBx por el puerto serie correspondiente (/dev/ttyUSB1, /dev/ttyACM0, COM3, etc.).

Referencias relacionadas

Vista Gráfica

Retroenlaces