mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
Merge branch 'docs/update_cn_for_protocols_jtag-debugging_api-guides' into 'master'
docs: Update CN for esp_https_server.rst and tips-and-quirks.rst Closes DOC-7543 See merge request espressif/esp-idf!30096
This commit is contained in:
commit
288f76960e
@ -49,11 +49,11 @@ The initial session setup can take about two seconds, or more with slower clock
|
||||
Event Handling
|
||||
--------------
|
||||
|
||||
ESP HTTPS Server has various events for which a handler can be triggered by :doc:`the Event Loop library <../system/esp_event>` when the particular event occurs. The handler has to be registered using :cpp:func:`esp_event_handler_register`. This helps in event handling for ESP HTTPS Server.
|
||||
ESP HTTPS Server has various events for which a handler can be triggered by the :doc:`../system/esp_event` when the particular event occurs. The handler has to be registered using :cpp:func:`esp_event_handler_register`. This helps in event handling for ESP HTTPS Server.
|
||||
|
||||
:cpp:enum:`esp_https_server_event_id_t` has all the events which can happen for ESP HTTPS server.
|
||||
|
||||
Expected data type for different ESP HTTP server events in event loop:
|
||||
Expected data type for different ESP HTTPS server events in event loop:
|
||||
|
||||
- HTTPS_SERVER_EVENT_ERROR : ``esp_https_server_last_error_t``
|
||||
- HTTPS_SERVER_EVENT_START : ``NULL``
|
||||
|
@ -10,7 +10,7 @@
|
||||
可用的断点和观察点
|
||||
^^^^^^^^^^^^^^^^^^
|
||||
|
||||
{IDF_TARGET_NAME} 调试器支持 {IDF_TARGET_SOC_CPU_BREAKPOINTS_NUM} 个硬件断点和 64 个软件断点。硬件断点是由 {IDF_TARGET_NAME} 芯片内部的逻辑电路实现的,能够设置在代码的任何位置:flash 或者 IRAM 的代码区域。除此以外,OpenOCD 实现了两种软件断点:flash 断点(最多 32 个)和 IRAM 断点(最多 32 个)。目前 GDB 无法在 flash 中设置软件断点,因此除非解决此限制,否则这些断点只能由 OpenOCD 模拟为硬件断点(详细信息可以参阅 :ref:`下面 <jtag-debugging-tip-where-breakpoints>`)。{IDF_TARGET_NAME} 还支持 {IDF_TARGET_SOC_CPU_WATCHPOINTS_NUM} 个观察点,所以可以观察 {IDF_TARGET_SOC_CPU_WATCHPOINTS_NUM} 个变量的变化或者通过 GDB 命令 ``watch myVariable`` 来读取变量的值。请注意 menuconfig 中的 :ref:`CONFIG_FREERTOS_WATCHPOINT_END_OF_STACK` 选项会使用最后一个观察点,如果你想在 OpenOCD 或者 GDB 中再次尝试使用这个观察点,可能不会得到预期的结果。详情请查看 menuconfig 中的帮助文档。
|
||||
{IDF_TARGET_NAME} 调试器支持 {IDF_TARGET_SOC_CPU_BREAKPOINTS_NUM} 个硬件断点和 64 个软件断点。硬件断点是由 {IDF_TARGET_NAME} 芯片内部的逻辑电路实现的,能够设置在代码的任何位置:flash 或者 IRAM 的代码区域。除此以外,OpenOCD 实现了两种软件断点:flash 断点(最多 32 个)和 IRAM 断点(最多 32 个)。目前 GDB 无法在 flash 中设置软件断点,因此除非解决此限制,否则这些断点只能由 OpenOCD 模拟为硬件断点(详细信息可以参阅 :ref:`下文 <jtag-debugging-tip-where-breakpoints>`)。{IDF_TARGET_NAME} 还支持 {IDF_TARGET_SOC_CPU_WATCHPOINTS_NUM} 个观察点,所以可以观察 {IDF_TARGET_SOC_CPU_WATCHPOINTS_NUM} 个变量的变化或者通过 GDB 命令 ``watch myVariable`` 来读取变量的值。请注意 menuconfig 中的 :ref:`CONFIG_FREERTOS_WATCHPOINT_END_OF_STACK` 选项会使用最后一个观察点,如果你想在 OpenOCD 或者 GDB 中再次尝试使用这个观察点,可能不会得到预期的结果。详情请查看 menuconfig 中的帮助文档。
|
||||
|
||||
|
||||
.. _jtag-debugging-tip-where-breakpoints:
|
||||
|
@ -46,6 +46,23 @@ API 说明
|
||||
|
||||
建立起始会话大约需要两秒,在时钟速度较慢或日志记录冗余信息较多的情况下,可能需要花费更多时间。后续通过已打开的安全套接字建立请求的速度会更快,最快只需不到 100 ms。
|
||||
|
||||
事件处理
|
||||
--------------
|
||||
|
||||
ESP HTTPS 服务器在特定事件发生时,可以通过 :doc:`../system/esp_event` 触发事件处理程序。处理程序必须使用 :cpp:func:`esp_event_handler_register` 进行注册,以帮助 ESP HTTPS 服务器处理事件。
|
||||
|
||||
:cpp:enum:`esp_https_server_event_id_t` 包含了 ESP HTTPS 服务器可能发生的所有事件。
|
||||
|
||||
事件循环中不同 ESP HTTPS 服务器事件的预期数据类型如下所示:
|
||||
|
||||
- HTTPS_SERVER_EVENT_ERROR : ``esp_https_server_last_error_t``
|
||||
- HTTPS_SERVER_EVENT_START : ``NULL``
|
||||
- HTTPS_SERVER_EVENT_ON_CONNECTED : ``NULL``
|
||||
- HTTPS_SERVER_EVENT_ON_DATA : ``int``
|
||||
- HTTPS_SERVER_EVENT_SENT_DATA : ``NULL``
|
||||
- HTTPS_SERVER_EVENT_DISCONNECTED : ``NULL``
|
||||
- HTTPS_SERVER_EVENT_STOP : ``NULL``
|
||||
|
||||
API 参考
|
||||
---------
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user