esp-idf/docs/en/migration-guides/tools.rst
Roland Dobai d56c578ddb tools: Rename the flash size detection kconfig option
9c46c98b4c have changed the default value
of ESPTOOLPY_FLASHSIZE_DETECT. As the side effect, existing
projects (having the option still enabled) started to discard the SHA256 digest.

Rename the ESPTOOLPY_FLASHSIZE_DETECT option so existing projects would
have the value disabled by default.

Closes https://github.com/espressif/esp-idf/issues/9148
2022-06-14 15:56:20 +02:00

43 lines
2.0 KiB
ReStructuredText

Migrate Tools to ESP-IDF 5.0
============================
IDF Monitor
-----------
IDF Monitor follows the custom console baud-rate (:ref:`CONFIG_ESP_CONSOLE_UART_BAUDRATE`) by default instead of 115200. Setting a custom baud rate is not supported from menuconfig anymore. A custom baud-rate can be specified from command line with the ``idf.py monitor -b <baud>`` command or through setting environment variables. Please note that the baud-rate argument has been renamed from ``-B`` to ``-b`` in order to be consistent with the global baud-rate ``idf.py -b <baud>``. Run ``idf.py monitor --help`` for more information.
Deprecated commands
-------------------
``idf.py`` sub-commands and ``cmake`` targets are unified to contain ``-`` instead of ``_``. The following changes have been made. Deprecated sub-commands and targets produce a warning. It is advised to migrate to the new ones.
.. list-table:: Target and sub-command deprecation
:widths: 50 50
:header-rows: 1
* - Old name
- New name
* - efuse_common_table
- efuse-common-table
* - efuse_custom_table
- efuse-custom-table
* - erase_flash
- erase-flash
* - partition_table
- partition-table
* - partition_table-flash
- partition-table-flash
* - post_debug
- post-debug
* - show_efuse_table
- show-efuse-table
* - erase_otadata
- erase-otadata
* - read_otadata
- read-otadata
Esptool
-------
The CONFIG_ESPTOOLPY_FLASHSIZE_DETECT option has been renamed to :ref:`CONFIG_ESPTOOLPY_HEADER_FLASHSIZE_UPDATE` and it is disabled by default. New and existing projects migrated to ESP-IDF v5.0 will have to set :ref:`CONFIG_ESPTOOLPY_FLASHSIZE`. If this is not possible because the flash size is not known at build time then :ref:`CONFIG_ESPTOOLPY_HEADER_FLASHSIZE_UPDATE` can be enabled but this will have the consequence of not appending a SHA256 digest after the image in order that the binary header could be updated with the flash size during flashing without invalidating the digest.