Chapter 2. API Reference
• dest: Indicates HW interface to use.
• ptr: Address to store read data.
• size: Size of an item.
• nmemb: Number of items to read.
• stream: File handle returned by esp_apptrace_fopen.
int esp_apptrace_fseek(esp_apptrace_dest_t dest, void *stream, long offset, int whence)
Set position indicator in file on host. This function has the same semantic as ‘fseek’except for the first
argument.
Return Zero on success, otherwise non-zero. See fseek for details.
Parameters
• dest: Indicates HW interface to use.
• stream: File handle returned by esp_apptrace_fopen.
• offset: Offset. See fseek for details.
• whence: Position in file. See fseek for details.
int esp_apptrace_ftell(esp_apptrace_dest_t dest, void *stream)
Get current position indicator for file on host. This function has the same semantic as ‘ftell’except for the
first argument.
Return Current position in file. See ftell for details.
Parameters
• dest: Indicates HW interface to use.
• stream: File handle returned by esp_apptrace_fopen.
int esp_apptrace_fstop(esp_apptrace_dest_t dest)
Indicates to the host that all file operations are completed. This function should be called after all file operations
are finished and indicate to the host that it can perform cleanup operations (close open files etc.).
Return ESP_OK on success, otherwise see esp_err_t
Parameters
• dest: Indicates HW interface to use.
void esp_gcov_dump(void)
Triggers gcov info dump. This function waits for the host to connect to target before dumping data.
Enumerations
enum esp_apptrace_dest_t
Application trace data destinations bits.
Values:
ESP_APPTRACE_DEST_JTAG = 1
JTAG destination.
ESP_APPTRACE_DEST_TRAX = ESP_APPTRACE_DEST_JTAG
xxx_TRAX name is obsolete, use more common xxx_JTAG
ESP_APPTRACE_DEST_UART0
UART0 destination.
ESP_APPTRACE_DEST_MAX = ESP_APPTRACE_DEST_UART0
ESP_APPTRACE_DEST_NUM
Header File
• components/app_trace/include/esp_sysview_trace.h
Functions
static esp_err_t esp_sysview_flush(uint32_t tmo)
Flushes remaining data in SystemView trace buffer to host.
Espressif Systems 793
Submit Document Feedback
Release v4.4