docs: Update CN for idf-monitor.rst

This commit is contained in:
renpeiying
2025-05-14 13:55:08 +02:00
committed by Peter Dragun
parent bb3655d6e7
commit f114a94369
2 changed files with 35 additions and 11 deletions
+24 -2
View File
@@ -61,11 +61,27 @@ IDF 监视器是一个串行终端程序,使用了 esp-idf-monitor_ 包,用
-
* - Ctrl + C
- 中断正在运行的应用程序
- 暂停 IDF 监视器并运行 GDB_ 项目调试器,从而在运行时调试应用程序。这需要启用 :ref: `CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME` 选项。
- 暂停 IDF 监视器并运行 GDB_ 项目调试器,从而在运行时调试应用程序。这需要启用 :ref:`CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME` 选项。
除了 ``Ctrl-]`` 和 ``Ctrl-T``,其他快捷键信号会通过串口发送到目标设备。
自动着色
==========
IDF 监视器会根据日志级别自动为输出内容进行着色。该功能通过避免冗余的日志格式化,减少了通过串口控制台传输的字节数,降低了日志传输的延迟,提升了性能。该功能还具有其他优势,能够为预编译库(例如 Wi-Fi)添加颜色,以及减少应用程序的二进制文件大小。
该功能默认启用。如需禁用,请使用命令行选项 ``--disable-auto-color``。
着色是基于日志级别进行的,日志级别后可选择是否显示时间戳和标签。如需在 {IDF_TARGET_NAME} 端启用着色,参见 :ref:`CONFIG_LOG_COLORS`。
有关日志的更多信息,参见 :doc:`日志记录 <../../api-reference/system/log>`。
.. note::
如果日志消息中包含换行符,自动着色可能无法正常工作。在这种情况下,IDF 监视器仅会为消息的第一行着色。
兼具 ESP-IDF 特性
=========================
@@ -349,7 +365,13 @@ GDBStub 支持在运行时进行调试。GDBStub 在目标上运行,并通过
IDF 监视器已知问题
=================================
如果在使用 IDF 监视器过程中遇到任何问题,请查看 `GitHub 仓库 <https://github.com/espressif/esp-idf-monitor/issues>`_ 以获取已知问题列表及其当前状态。如果遇到的问题没有相关记录,请创建一个新的问题报告。
目前已知的问题如下:
- 消息中包含换行符时,自动着色无法检测日志级别。在这种情况下,IDF Monitor 只会为消息的第一行着色。
为了避免这个问题,可以在 menuconfig 中启用 :ref:`CONFIG_LOG_COLORS`。注意,这可能会对二进制文件的大小和性能产生一定影响。
如果在使用 IDF 监视器过程中遇到问题,可以访问 `IDF 监视器的 GitHub 仓库 <https://github.com/espressif/esp-idf-monitor/issues>`_ 查看已知问题及其当前状态。如果遇到的问题没有相关记录,可以提交一个新的问题报告。
.. _esp-idf-monitor: https://github.com/espressif/esp-idf-monitor
.. _IDF 监视器文档: https://github.com/espressif/esp-idf-monitor/blob/v1.5.0/README.md#documentation