mirror of
https://github.com/espressif/esp-idf.git
synced 2026-10-02 03:00:34 +03:00
docs: Update CN for idf-monitor.rst
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user