# 工具

[English]

## ESP-IDF 监视器

ESP-IDF 监视器在波特率方面的改动如下：

- 目前，ESP-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 工具安装器（ESP-IDF v6.0 已弃用）设置 Windows 兼容环境。目前支持 Windows 命令行、Power Shell 和基于 Eclipse IDE 的图形用户界面等选项。此外，还可以使用 支持的插件，设置基于 VSCode 的环境。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。