警告

This document is not updated for ESP32H2 yet, so some of the content may not be correct.

This warning was automatically inserted due to the source file being in the add_warnings_pages list.

工具

[English]

IDF 监视器

IDF 监视器在波特率方面的改动如下:

  • 目前,IDF 监视器默认遵循自定义的控制台波特率 (CONFIG_ESP_CONSOLE_UART_BAUDRATE),而非 115200。

  • ESP-IDF v5.0 不再支持通过 menuconfig 自定义波特率。

  • 支持通过设置环境变量或在命令行中使用 idf.py monitor -b <baud> 命令自定义波特率。

  • 注意,为了与全局波特率 idf.py -b <baud> 保持一致,波特率参数已从 -B 改名为 -b。请运行 idf.py monitor --help 获取更多信息。

废弃指令

ESP-IDF v5.0 已将 idf.py 子命令和 cmake 目标名中的下划线 (_) 统一为连字符 (-)。使用废弃的子命令及目标名将会触发警告,建议使用更新后的版本。具体改动如下:

废弃子命令及目标名

废弃名

现用名

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

CONFIG_ESPTOOLPY_FLASHSIZE_DETECT 选项已重命名为 CONFIG_ESPTOOLPY_HEADER_FLASHSIZE_UPDATE,且默认禁用。迁移到 ESP-IDF v5.0 的新项目和现有项目必须设置 CONFIG_ESPTOOLPY_FLASHSIZE。若因编译时 flash 大小未知而无法设置,可启用 CONFIG_ESPTOOLPY_HEADER_FLASHSIZE_UPDATE。但需注意的是,启用该项后,为在烧录期间使用 flash 大小更新二进制头时不会导致摘要无效,映像后将不再附加 SHA256 摘要。

Windows 环境

基于 MSYS/MinGW 的 Windows 环境支持已在 ESP-IDF v4.0 中弃用,v5.0 则完全移除了该项服务。请使用 ESP-IDF 工具安装器 设置 Windows 兼容环境。目前支持 Windows 命令行、Power Shell 和基于 Eclipse IDE 的图形用户界面等选项。此外,还可以使用 支持的插件,设置基于 VSCode 的环境。