Files
esp-idf/docs/en/api-reference/system/esp_trace.rst
Erhan Kurubas c99a63fd18 refactor(examples): group trace examples under examples/system/tracing/
Move 6 trace-related examples (app_trace_basic, app_trace_to_plot,
esp_trace, gcov, sysview_tracing, sysview_tracing_heap_log) from
examples/system/ into a dedicated examples/system/tracing/
subdirectory for better organization.

Update all path references across documentation (en + zh_CN),
build-test-rules, CI configs and component READMEs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KZAGzon27T12sGbDPPbZ8G
2026-09-07 16:41:37 +08:00

71 lines
1.5 KiB
ReStructuredText

ESP Trace
=========
:link_to_translation:`zh_CN:[中文]`
Overview
--------
The ``esp_trace`` component is the entry point for ESP-IDF tracing. It provides the public tracing API, manages the active trace session, and connects the selected encoder, such as SEGGER SystemView, with the selected transport, such as apptrace.
For a conceptual overview, architecture, and usage guides, see :doc:`/api-guides/tracing/index`.
Application Examples
--------------------
- :example:`system/tracing/esp_trace_custom_library` demonstrates how to integrate an external trace library (encoder) with the ``esp_trace`` core.
API Reference
-------------
Types
^^^^^
.. doxygentypedef:: esp_trace_handle_t
.. doxygenstruct:: esp_trace_open_params_t
:members:
.. doxygenstruct:: esp_trace_config
:members:
.. doxygenenum:: esp_trace_link_types_t
Adapter Types
^^^^^^^^^^^^^
.. doxygenstruct:: esp_trace_encoder_vtable_t
:members:
.. doxygenstruct:: esp_trace_encoder
:members:
.. doxygenenum:: esp_trace_transport_cfg_key_t
.. doxygenstruct:: esp_trace_transport_vtable_t
:members:
.. doxygenstruct:: esp_trace_transport
:members:
Functions
^^^^^^^^^
.. doxygenfunction:: esp_trace_get_user_params
.. doxygenfunction:: esp_trace_get_active_handle
.. doxygenfunction:: esp_trace_write
.. doxygenfunction:: esp_trace_start
.. doxygenfunction:: esp_trace_stop
.. doxygenfunction:: esp_trace_flush
.. doxygenfunction:: esp_trace_is_host_connected
.. doxygenfunction:: esp_trace_get_link_type
.. doxygenfunction:: esp_trace_panic_handler