New Features

• ESP32-C2: Added flash encryption support
• elf2image: Added argument to disable appending SHA256 digests

Bug Fixes

• espsecure.py: Fixed Secure Boot V1 key generation
• espefuse.py: Corrected eFuse tables

Bug Fixes

• Patched the wrapper scripts to not import themselves to allow running esptool, espefuse, and espsecure in different environments and importing these directly in other Python scripts.

Starting from v4.0.0, esptool adopts the semantic versioning specification, please read the related "Versions" esptool documentation page when deciding which version to use.

Breaking changes

• Public API has been defined by limiting access to internals that have been refactored into multiple source files. Changing or refactoring these limited internals won't be considered a breaking change in future releases. Migration is easy and self-explanatory (you will get an import error if something has moved) and is required only in projects that import esptool directly.
• If active security features are detected, the default behavior changes to prevent unintentional bricking (https://github.com/espressif/esptool/issues/699):
  • If flash encryption is enabled, erase_flash and erase_region cannot be executed.
  • If secure boot is enabled, erase_flash, erase_region and write_flash operations cannot be performed (write_flash is just restricted to protect the bootloader region 0x0000->0x8000).
  • An override flag --force lets the users execute these operations anyways.
• Flash parameters in an image header can now be changed only when no SHA256 digest is appended (https://github.com/espressif/esp-idf/issues/8798).
• Python versions 2.7, 3.4, 3.5, and 3.6 have been deprecated, the code is now Python 3-only compatible. Releases v4 and later can't be installed from PyPI on these deprecated Python versions.
• The ESP8684 alias has been removed, ESP32-C2 has to be used.
• Megabit flash sizes have been deprecated, use megabyte units from now on.

New Features

• Added stub flasher support for ESP32-C2 ECO1, deprecated ECO0 stub (can still be used with ROM).

espefuse.py

• Added a new package - ESP32-D0WDR2-V3

Bug Fixes

• Fixed ESP32-S3 USB-OTG compressed flashing
• Fixed division by zero error when reading flash (https://github.com/espressif/esptool/issues/729)

Miscellaneous Changes

• Black code formatting has been adopted in the esptool project. Contributions will be automatically formatted in a compatible way when following the contributions guide.

Thanks to everyone who contributed to this release.

This bugfix release of an older esptool.py version is intended only for purposes when v3.3 needs to be used. The latest v4 release is recommended and under active development.

New Features

• Added a new option --pad-to-size <size>.
• Added support for major and minor chip revisions.

Bug Fixes

• espefuse: Fixed compatibility with Bitstring>=4 (https://github.com/espressif/esptool/issues/797)

Thanks to everyone who contributed to this release!

This bugfix release of an older esptool.py version is intended only for purposes when v3.3 needs to be used. The latest v4 release is recommended and under active development.

New Features

• write_flash: Added the ability to recover from serial errors when flashing, effectively making data transfers more robust (https://github.com/espressif/esptool/issues/182)
• Added more memory density definitions to cover known flash chips (https://github.com/espressif/esptool/pull/769)
• Added parsing of stub flasher error definitions in esptool messages

espefuse.py

• Added XTS_AES_256 key_purpose on ESP32-S3-beta2
• burn_efuse: Improved error messages when a new data value is incorrect (https://github.com/espressif/esptool/issues/760)

Bug Fixes

• load_extended_header: Load the minimum chip revision min_rev field
• Fixed faulty hard_reset() with RTS pin for ESP32-S2/S3 in slower environments
• get_default_connected_device: Fixed closing unused ports

espefuse.py

• Corrected eFuse tables
• Removed XTS_AES_256 key purposes on ESP32-C3
• Fixed location of FAIL_BIT and NUM_BITS on ESP32-C3
• Added a warning to specify the --port/-p argument if connection fails (https://github.com/espressif/esptool/issues/744)

espsecure.py

• _microecc_format: Pad zeroes to curve length
• Fixed argparse Secure Boot key generation command to work with both V1 and V2

Thanks to @johnboiles, @hathach, and others for contributing to this release!

Full Changelog: https://github.com/espressif/esptool/compare/v3.3.1...v3.3.2

New Features

• Added stub flasher support for ESP32-C2 ECO1, deprecated ECO0 stub (can still be used with ROM)

espefuse.py

• Added a new package - ESP32-D0WDR2-V3

Bug Fixes

• Fixed ESP32-S3 USB-OTG compressed flashing

New Features

• Added flash size options up to 128MB. (https://github.com/espressif/esptool/pull/680)
• Added stub flasher support for ESP32-C2.
• Added --flash-mmu-page-size option to change flash MMU page size on ESP32-C2.
• Added address and dummy cycles configuration to SPI flash commands, allowed reading flash SFDP registers.
• Added target-specific flash frequency options.

espsecure.py

• Added support for ECDSA P192 and P256 signatures in Secure Boot V2.
• Refined Secure Boot V2 ECC support.
• Added support for XTS_AES_128 using 128 bit key FE scheme.

espefuse.py

• Added execute_scripts nesting support, a script can now be called from another script.
• Added ESP32-C2 espefuse.py support.
• Fixed power-out time for VDDQ settings for ESP32-S3.
• Removed dysfunctional JTAG_SEL_ENABLE on ESP32-C3.
• Removed unused eFuse fields on ESP32-C3 and ESP32-H2.
• Added execute_scripts error handling in script files. (https://github.com/espressif/esp-idf/issues/8420)
• Added support for running multiple commands at once.
• Added checks for secure download mode.
• Added a recovery option to fix eFuse blocks after encoding errors.

Internal features

These features are intended for use inside Espressif:

• Preview support for ESP32-H2-beta2 has been added. This SoC is not generally available, so it is unsupported in this release. Official support will be added in a later esptool.py release.

Bug Fixes

• Fixed autodetection on ESP32-S2 in USB-OTG mode. (https://github.com/espressif/esptool/issues/685)
• Fixed flash.rodata not being recognized as part of IRAM in the ELF parser.
• Fixed wrong UART_RXFIFO_CNT_M mask values in the stub flasher.
• Added overerase detection and a fix sequence for certain XMC flash chips.
• Allowed USB PID detection for USB-JTAG-Serial mode on lowercase port names.
• Fixed chip autodetection to work in secure download mode.
• Fixed wrong firmware image being returned for beta chips.
• Fixed a wrong bootloader flashing offset on ESP32-S3. (https://github.com/espressif/esptool/pull/728)

Miscellaneous Changes

• Launched a new self-hosted esptool.py documentation and heavily updated its contents.
• Renamed the ESP8684 target to ESP32-C2 (added alias for compatibility).
• Added a warning for flash sizes that are not supported by the stub flasher.

Thanks to @ESP32DE, @lucasrangit, @Jason2866, and others for contributing to this release.

New Features

• Support for ESP32-S3 SoC has been added (removed ESP32-S3-beta3).
• Added USB-JTAG-Serial and USB-CDC support for ESP32-S3.
• Added a check to disable stub when connecting to an unsupported chip.
• Added boot log detection and context of failures logging.
• Improved error messages to cover more cases and provide more information.
• Added get_security_info command stub support.
• Augmented chip autodetection to work even in secure download mode. (ESP32-C3 and later only)
• Added flash chip connection verification check.
• Added ESP8266 version 3 image format support.

espsecure.py

• Added option for 512bit keys for encrypt_flash_data.

espefuse.py

• Added a new command which can execute custom python scripts to burn efuses all at once.
• Added ESP32-S2 flash_ver, psram_ver, and pkg_ver efuses.
• Corrected lenght of soft_dis_jtag efuse.
• Added custom_mac eFuse field for ESP32-C3/-S2/-S3/-H2.
• Added a check for read_protect_efuse. (https://github.com/espressif/esptool/issues/640)
• Added support for 512bit XTS_AES flash encryption key.
• Added a step to close the serial port after espefuse operations. (https://github.com/espressif/esptool/issues/671)
• Added a security confirmation flag to espefuse tests. (https://github.com/espressif/esptool/issues/677)

Internal features

These features are intended for use inside Espressif:

• Preview support for ESP32-H2 and ESP8684 has been added. These SoCs are not generally available, so they are unsupported in this release. Official support will be added in a later esptool release.
• Added automatic delay for boot time after ESP32 reset in FPGA.

Bug Fixes

• Fixed build from sources (require wheel only when installing from pip). (https://github.com/espressif/esptool/pull/632)
• Fixed failing flashing process on some supported chips. (https://github.com/espressif/esptool/issues/635)
• Fixed ESP32-C3 package detection. (https://github.com/espressif/esptool/issues/638, https://github.com/espressif/esptool/issues/639)
• Fixed test child processes being blocked waiting for the OS pipe buffer to accept more data. (https://github.com/espressif/esptool/pull/637)
• Fixed MacOS USB PID detection on tty and cu ports.
• Fixed erroneous comparison when handling deflated data. (https://github.com/espressif/esptool/pull/650)

Miscellaneous Changes

• Changed unnecessarily alarming error to a warning. (https://github.com/espressif/esptool/issues/631)
• Removed ESP32 rev0 connection workaround.
• Added a readable error and a use example to merge_bin.

Thanks to @bbilas, @xingrz, @loader-bsd, @alvarolb, and others for contributing to this release.

New Features

• Support for ESP32-C3 SoC has been added
• Added --encrypt-files option to specify which files need encryption before flashing.
• Added --use_segments option for elf2image to use segments instead of sections to generate the image. (https://github.com/espressif/esptool/pull/546)
• Improved the write_flash timeout calculation and status message.
• Support for detecting ESP8285 versions -N08, -N16, -H08, and -H16 has been added.
• Added support for all write_reg command forms (including delay and mask parameters) to flasher stub.
• Added merge_bin command to combine binary files on host (https://github.com/espressif/esptool/issues/254, https://github.com/espressif/esptool/pull/568)
• Extended the --min-rev argument of elf2image to work on all chips apart from ESP8266.
• Added diagnostic warnings about the memory regions needing to be erased during a flash write (https://github.com/espressif/esptool/issues/306)
• Added --after no_reset_stub option to keep the flasher stub running and allow its repeated usage.
• Added support for the USB-JTAG-Serial peripheral of ESP32-C3.

espsecure.py

• Added custom command-line argument to allow calling from other Python scripts.
• Added --aes-xts option to encrypt/decrypt flash data files with AES-XTS algorithm on the S2 and C3.
• Fixed handling of files to forbid empty output and re-writing input.

espefuse.py

• Added custom command-line argument to allow calling from other Python scripts.
• Added security measures to prevent burning custom multicast MAC address. (https://github.com/espressif/esptool/issues/472)
• Fixed errors when burning and read-protecting an efuse at the same time (https://github.com/espressif/esptool/issues/584)
• Fixed burning of SPI pins configuration efuses (https://github.com/espressif/esptool/issues/216)

Internal features

These features are intended for use inside Espressif:

• Support for ESP32-S3-beta3 & ESP32-C6-beta have been added. These SoCs are not generally available, so they are unsupported in this release. Official support will be added in a later esptool release.
• Support for 32-bit addressing to enable 32/64MB flash memory chips on the S3.

Bug Fixes

• Fixed error outputs when installing from pip.
• Increased the timeout for writing to flash to improve stability (https://github.com/espressif/esptool/issues/577, https://github.com/espressif/esptool/issues/533)
• Fixed failing dump_mem overall bytes read message.
• Allowed the write_mem mask argument to be optional to match with its usage example on Wiki.
• Ensured expand_file_arguments gets called when using custom command-line arguments. (https://github.com/espressif/esptool/pull/400/)
• Fixed SecureBoot v2 public key extraction (https://github.com/espressif/esptool/pull/623)

Miscellaneous Changes

• Decomposed port detection logic.
• Added flushing after each command before waiting for a reply.
• Made it easier to use esptool.py as a component by permitting passing an already formed esp object to main() (https://github.com/espressif/esptool/pull/402)
• Added function to merge adjacent sections in elf2image for the use case of linker scripts that have a large number of sections.
• Decoupled esptool reset logic for easier monkey-patching (https://github.com/espressif/esptool/pull/508)

Thanks to @Skallwar, @eykamp, @gnought, @middelink and others for contributing to this release.

Breaking changes

• The default esptool.py write_flash --flash_size argument has changed from detect to keep. This means that if no --flash_size argument is passed when flashing a bootloader, the value in the bootloader .bin file header is kept instead of detecting the actual flash size and updating the header. To keep the old behaviour, add the argument esptool.py [...] write_flash [...] -fs detect
• espefuse.py command line arguments for ESP32 have changed:
  • BLK1, BLK2, BLK3 is now BLOCK1, BLOCK2, BLOCK3`
  • The key usage secure_boot has been replaced with secure_boot_v1, secure_boot_v2. Secure Boot V2 is the new RSA-based Secure Boot mechanism supported on ESP32 V3.

New Features

• Support for ESP32-S2 SoC has been added
• Support for detecting ESP32-PICO-V3-02 and ESP32-U4WDH have been added
• New --connect-attempts argument (https://github.com/espressif/esptool/pull/464)
• Fixed scrolling problems when output is redirected (for example in Arduino IDE, see discussion at https://github.com/espressif/esptool/pull/482)
• Produce a meaningful error if the SoC we connect to doesn't match the --chip argument
• Support different capitalization and spelling for --chip argument (ie -c ESP32, -c esp32-s2, etc.
• Added dedicated program esp_rfc_2217_server.py for flashing via RFC2217 (i.e. flashing over the network, https://github.com/espressif/esptool/issues/383)

espsecure.py

• Added support for Secure Boot V2 (ESP32 V3, ESP32-S2)
• Secure Boot V1: PKCS8 formatted ECDSA keys are now supported via ecdsa library (not including password protected keys)

espefuse.py

• Added ESP32 ECO3 efuse UART_DOWNLOAD_DIS
• Added new batch burn mode, support burning more than one eFuse on a single command line
• espefuse.py internals have been refactored to support multiple chips, produce more information about which eFuses are being written to which values.
• "Virtual" mode added for host-based testing, allows updating eFuse values on a "virtual" chip inside the host.

Internal features

These features are intended for use inside Espressif:

• Support for ESP32-S3beta2 & ESP32-C3 have been added. These SoCs are not currently available outside Espressif, so these SoCs are unsupported in this release. Official support will be added in a later esptool release.
• esptool.py --no-stub read_flash is now supported on ESP32 and later. This option is slower than using the default stub option to read flash, so it's generally not useful for production SoCs.

Bug Fixes

• Added temporary workaround for a pyserial failure on macOS Big Sur Preview (https://github.com/espressif/esptool/issues/540)
• Fixed gcc9 warning in the stub (https://github.com/espressif/esptool/pull/501)
• Fixed some memory types printed in the memory map output
• Fixed the check for zero bytes before applying an ELF SHA-256 with elf2image --elf-sha256-offset option (https://github.com/espressif/esptool/issues/560)
• Fixed displaying some single core ESP32 features incorrectly, i.e. ESP32-S0WD
• Fixed exception on Python 3 if the same flash address was repeated twice (https://github.com/espressif/esptool/pull/558)

Miscellanous Changes

• Updated miniz to v2.1.0 (https://github.com/espressif/esptool/pull/500)
• Moved ESP32 stub loader location to facilitate loading large applications direct to IRAM
• Vendored modules ecdsa, pyaes and optional pycrypto have been removed. Pyaes has been replaced with the pyca-cryptography library

Thanks to @jkoelker, @earlephilhower, @paravoid, @niziak, and others for contributing to this release.

Features

• esptool.py image_info now prints a summary of segment memory types (IRAM, DRAM, etc) based on the address range.
• esptool.py write_flash will warn if it looks like a bootloader binary is built for ESP32-S2 or another newer chip (support for flashing ESP32-S2 will be added in a future version.)

Bug Fixes

• Removed ESP8266 SDK & ESP-IDF dependencies when building the flasher stub binaries. Previously the SDKs were used to include some register address macros, only. This removes any uncertainty about whether the flasher stub binary is a derived work of either SDK. The flasher stub binary itself is the same as the binary in v2.7.
• Fixed minor issues running esptool automated tests on macOS.
• Minor flake8 fixes including compatibility with newer flake8 versions.

ESP32 Only

Features

• Support detection of new ESP32 silicon revisions
• New esptool.py elf2image --min-rev X option allows creating a .bin file which only supports a minimum ESP32 silicon revision.

Bugfixes

• Fix burning custom MAC with espefuse.py when 3/4 Coding Scheme is set (#447)

Features

• New option write_flash --flash-size keep will keep whatever flash size is set in the bootloader header, matching the behaviour of --flash-mode keep and --flash-speed keep. The default is still --flash-size detect but may be changed to keep in a future major update, to be consistent with the other two options.
• write_flash no longer updates the flash header if the file being written to the bootloader offset isn't a valid image file for the chip. This is useful for flashing pre-encrypted data to ESP32s, where the image file contains ciphertext.
• esptool now always prints the detected crystal frequency (26MHz or 40MHz) as part of general chip information, and will warn if the detected frequency deviates by an unexpected amount.
• Passing arguments to main() from Python is now documented in the README (#408)

Bug Fixes/Changes

• elf2image --sha256-offset will now only write the ELF SHA-256 to this offset if the existing data is all zeroes. Otherwise a warning is printed.
• Improved the error message if esptool searches all serial ports and finds nothing. (#401)

ESP32 Only

Features

• New write_flash --encrypt option that works with the new Development Mode flash encryption that will be the default flash encryption development workflow in ESP-IDF V4.0.
• espefuse.py summary --format json will print a JSON dictionary of efuse summary data (#436)
• espefuse.py burn commands now set the efuse timing before burning, in line with recent ESP32 TRM update.
• espsecure.py key operations now support --keylen argument, allowing 192-bit keys for ESP32s with 3/4 Coding Scheme set.
• espsecure.py encryption and decryption speed substantially improved. (#416)

Bug Fixes/Changes

• FLASH_CRYPT_CNT efuse is now defined as 7 bits wide, as eight bit is not used by flash encryption hardware.

ESP8266 Only

Bug Fixes/Changes

• Flasher stub is now built with gcc 5.2.0 toolchain.

Thanks to @grandcat, @darkfader, @tim-nordell-nimbelink, @sbertrand-witekio, @marcelstoer, @eykamp, @cclauss for contributing to this release.

Features

• New write_flash --erase-all ... option to erase all flash before writing (single command). (#344)
• Support patching the SHA256 digest of the ELF file into the binary (available in ESP-IDF via app description APIs)
• Make calling esptool module functions and esptool.main() more Python-friendly (all functions clean up open files correctly, main(...) can take an optional argument with a command line formatted as a list.) (#341)

Bug Fixes/Changes

• Fix crash due to unimplemented write timeout on RFC2217 ports
• elf2image no longer adds empty ELF sections (zero length) to the .bin file
• elf2image fails with a proper error if an ELF file contains more than 16 loadable sections
• Improve error message if list_ports is missing from pyserial (#350)
• Fix some write_flash timeouts writing large but highly compressible payloads

ESP8266 Only

• Fix bug where flashing with stub would fail if ESP8266 was in deep sleep immediately beforehand. (#351)

ESP32 Only

Features

• Support for reading/writing efuses when 3/4 Coding Scheme is set details.
• espefuse.py supports displaying and setting a custom MAC address in BLK3 of efuse
• espsecure.py can now verify signatures with raw binary key file as well as PEM formatted key file (#357)

Bug Fixes/Changes

• Workaround a mapping bug in the ESP-IDF bootloader (if IROM/DROM segment ended less than 0x20 bytes after a page boundary, older ESP-IDF bootloaders would not map the final page correctly).
• Reformat espefuse.py summary output (includes: read-only efuses now display value ? not 0, byte order of keys shown for BLK1,BLK2 are now shown in software order not the reversed byte order used by hardware cryptographical modules.)
• espsecure.py: Fix Python 3 compatibility issues (includes #369 #382)

Special thanks to @Callahan93 and @borro0 for contributing to this release.

Bug fixes:

• Errors during chip detection are now formatted correctly.
• OSError is handled correctly while scanning for a port (#322)
• Update link to flashrom repo for SPI flash chip IDs (#338)
• read_flash command: Error out immediately if an invalid length packet is received (common symptom of bad serial link) (#342)

ESP32 Only:

• espefuse.py: Disable burning key efuses when 3/4 Coding Scheme is set (support for burning keys with 3/4 Coding Scheme will be added in a future update).

Thanks to @orangecms for contributing to this release.

New features:

• Set a write timeout in pyserial (prevents hanging in sync process if port is unavailable).
• (ESP32) New option elf2image --secure-pad to pad the output binary so once signed it will align to an flash cache page boundary (64KB). Prevents unsigned data from being mapped into the instruction space via the flash cache.

Bug fixes:

• Fix exception if no --port is specified but no serial ports are found in the system.
• (ESP32) espsecure: Fix bug where digest_secure_bootloader could produce an incorrect digest.

Thanks to @heyinling & @ekiro for contributing to this release.

Bug fixes:

• --port argument was not correctly handled in v2.4.0
• Corrected pyserial dependency to require pyserial v3.0 or newer

Thanks to @nopdotcom and @ildar for contributing to this release.

Version 2.4.0:

ESP8266 & ESP32 changes

• If no serial port is specified, try all serial ports until an Espressif device responds.
• Print device MAC on every command, after connecting.
• New option --before no_reset_no_sync for use when immediately reusing the serial port with an already-running loader.
• Fix spurious load_ram error when executed code immediately resets the UART baud rate..
• Produce an error if load_ram is going to clobber bootloader stub memory (can use --no-stub to work around this).
• Display a helpful error if the incompatible 'serial' module was installed instead of 'pyserial'.
• Explicitly close the serial port at end of main() function (allows calling esptool.main() from another Python program for basic scripting.)
• Workaround Windows usbser.sys (USB CDC-ACM device) driver bug setting DTR & RTS
• Flasher stub build updates to work with recent ESP-IDF & ESP8266 SDK headers
• Flasher stub now sends correct length field in protocol responses (esptool.py was ignoring this field, but some other tools were not).

ESP8266 changes

• Move the loader stub to the very end of IRAM (useful when using load_ram command).
• elf2image --version=2 is now compatible with recent ESP8266 SDK bootloader and produces the same binary output as ESP8266 SDK gen_app.py.
• Remove unsupported flash size 4MB-c2

ESP32 changes

• Print chip frequency rating values in Features list, for chips where these are set.
• Working load_ram command.
• espefuse.py: Support setting the baud rate.
• New --override-vddsdio option allows setting the VDDSDIO regulator to 1.8V, 1.9V or "OFF" when connecting (to override the default value read from efuse). To avoid hardware damage, forcing VDDSDIO to 3.3V is not supported.

Thanks to @devanlai, @andrewwakeling, @Callahan93, @tim-nordell-nimbelink, @cefn and @nkolban for contributing to this release.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.3.1

New since v2.3

• Fixes a bug where Features line was mis-formatted for ESP8266 and triggered an exception on ESP8285.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.3

New since v2.2.1

• 'Hard resetting' status message now mentions the RTS pin
• README additions
• Fix regression if esptool is used as a module and ESPLoader() is passed a Python 2 unicode string.

ESP32 only

• When connecting, esptool now prints a summary of chip features based on efuse contents.
• espefuse.py support for displaying ADC calibration data via VRef stored in efuse and BLK3_PART_RESERVE if set.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.2.1

New since v2.2

• Fix an issue seen on macOS with high baud rates (>230400). pyserial was sending configuration to the serial port (no settings were actually changing) while a response may have been coming from the device, and this caused read data to be lost at or below the OS layer.
• Fix use of esptool with remote network serial ports (see here in README).
• write_flash now warns instead of crashing if a file is empty (zero length).

Thanks to @me21 & @igrr for contributing to this release.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.2

New since v2.1

• New esptool.py --trace option provides dump of all serial traffic for easier low-level debugging
• Timeouts refactored for better consistency, fix some timeouts flashing large binaries (particularly when flashing with a high effective compression ratio)
• PEP8 style cleanup, removal of deprecated language features (thanks @Cabalist!)
• Skew between device USB/serial reference clock timing and ESP crystal is now accounted for when switching baud rate. This may help achieve higher baudrates on some development boards.

ESP8266-Specific Changes

• Full support & identification of ESP8285
• Support for stub loader when using crystals other than 26MHz (tested with 40MHz)

ESP32-Specific Changes

• Support for ESP32-PICO-D4 System In Package
• espefuse.py now verifies the factory MAC address CRC is valid
• Flasher stub build now supports compiling against ESP-IDF v2.1 codebase (and will support v3.0)
• Fix error message if --spi-connection arguments were mis-typed (thanks @Cabalist!)
• Correct espsecure.py usage message (thanks @milan-kupcevic!)

Documentation Changes

• Structure cleanup, notes about power issues, new links to the wiki

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.1

New since v2.0.1

ESP32-Specific Changes

• elf2image: Pad flash-resident sections to 64KB alignment by using parts of RAM-resident sections, rather than zeroes. This reduces the size of a final IDF binary by almost 128KB in some cases.
• elf2image: Append a SHA-256 hash of the binary image to the .bin file by default. This will be checked by the software bootloader in the IDF V3.0 release. Provides a much stronger consistency check than the previous 8-bit checksum. The image_info command will print & verify this hash if it is present.
• espefuse.py: timeout now calculated in seconds not number of retries.

Documentation Changes

• Fix typo in the README

Thanks to @daniel-leonard-robinson for contributing to this release.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.0.1

esptool.py version 2.0.1 is a minor bugfix release from v2.0.

New since v2.0:

• (ESP32) Generating bootloader images for ESP32D2WD, or any ESP32 where the SPI pins are remapped via efuse, no longer accidentally enables GPIO0 as an output.
• (ESP32) espsecure.py & espefuse.py: Dispay --help argument if run without command line arguments.
• Update README now stable release supports ESP32.

Thanks to @hroncok & @marcelstoer for contributing to this release.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/2.0

esptool.py version 2.0 is a major release compared to v1.x. Most command line options are backwards compatible, but some default settings have changed.

New Features

• Support added for ESP32 microcontrollers.
• Compressed upload support (enabled by default) to reduce overhead of the serial connection.
• Data written to flash is automatically read back and verified after writing.
• New boot mode selection options --before and --after, to override the way esptool.py enters and exits bootloader mode, respectively. Details here.
• New --flash_mode keep and --flash_freq keep default options mean that write_flash no longer modifies these settings in the image header by default.

ESP32-Only Features

• --spi-connection argument allows overriding SPI flash pin configuration. Details here.
• New espefuse.py program for working with efuses.
• New espsecure.py program for working with chip security features.
• esptool.py prints the ESP32 detailed chip model and silicon revision as part of console output.

Thanks to everyone who contributed to this release, and submitted bug reports during the long beta period!

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/1.3

New since v1.2.1:

• Python 2/3 support, esptool.py now works with Python 2.7+ or Python 3.4+
• esptool.py is now officially supported by Espressif Systems (software licensing & approach to development have not changed.)
• verify_flash command now accepts optional --flash_mode and --flash_speed arguments, allowing verification of a ROM bootable image at offset 0.
• Backport functional tests (test_esptool.py) from esptool v2.0

Thanks to @thespooler, @jeremyherbert, @jrobeson for contributing to this release.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/1.2.1

New since v1.2:

• No source code changes.
• Fix packaging bug #140 with wheel originally uploaded to pypi.
• Update README with note about closing other serial terminal programs.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/1.2

New since v1.1:

• New --flash_size default "detect" to interpret flash size from ID
• Warn when data is larger than flash.
• Support RFC2217 TCP serial ports (using pyserial serial_from_url)
• Use flasher stub for erase_flash (detects when erase is complete)
• pyserial v1.2 or newer is now required.
• README updates, minor bugfixes.

Thanks to @pfalcon, @jimparis, @jms19 for contributing to this release.

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/1.1

• Flasher stub for must faster flashing (thanks to Cesanta & @rojer for this)
• Minor bugfixes

Latest stable release available from PyPi: https://pypi.python.org/pypi/esptool/

This release: https://pypi.python.org/pypi/esptool/1.0.1