Mark as not for python 2.7.
Summary of upstream release notes, less bugfixes:
* Version 4.1
ESP32-C2: Added flash encryption support
elf2image: Added argument to disable appending SHA256 digests
* Version 4.0
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 (#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 (espressif/esp-idf#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
Version 3.3
New Features
Added flash size options up to 128MB.
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.
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.
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.
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.
Version 3.2
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.
Added support for 512bit XTS_AES flash encryption key.
Added a step to close the serial port after espefuse operations.
Added a security confirmation flag to espefuse tests.
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).
Fixed failing flashing process on some supported chips.
Fixed ESP32-C3 package detection.
Fixed test child processes being blocked waiting for the OS pipe buffer to accept more data.
Fixed MacOS USB PID detection on tty and cu ports.
Fixed erroneous comparison when handling deflated data.
Miscellaneous Changes
Changed unnecessarily alarming error to a warning.
Removed ESP32 rev0 connection workaround.
Added a readable error and a use example to merge_bin.
Version 3.1
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.
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
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
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.
Fixed errors when burning and read-protecting an efuse at the same time
Fixed burning of SPI pins configuration efuses
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
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.
Fixed SecureBoot v2 public key extraction
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()
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
Version 2.8
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
