解读 ESP32 system - Application Level Tracing

原文地址

概述

是esp32提供的一种调试方案，通过JTAG接口可以在程序执行时以很小的开销在主机和esp32中间传输数据，可以用于收集数据。
实例参考:
特定应用程序的跟踪
记录日志到主机
基于 SEGGER SystemView 的系统行为分析

API介绍

头文件

app_trace/include/esp_app_trace.h

函数原型

/*
初始化 应用追踪模块
返回值：成功初始化返回ESP_OK 其他情况见esp_err_t 的定义
*/

esp_err_t esp_apptrace_init(void);

/*
在数据传输前应该先调用这个函数来设置数据的buf和buf的大小
/*
void esp_apptrace_down_buffer_config(uint8_t *buf, uint32_t size)

/*
为跟踪的数据分配缓冲区，当缓冲区的数据可以发送时，
就调用esp_apptrace_buffer_put函数
返回值：不成功时返回NULL 
参数：
dest：指明发送信息的硬件接口
size：跟踪数据缓冲区的大小
tmo：操作时间限制(us)，如果想不限时应该用 ESP_APPTRACE_TMO_INFINITE
*/
uint8_t *esp_apptrace_buffer_get(esp_apptrace_dest_t dest, uint32_t size, uint32_t tmo)

/*
当缓冲区的数据可以被发送时调用此函数，这个函数与esp_apptrace_buffer_get
对应。
返回ESP_OK表示成功
参数：
dest：发送数据的硬件接口 应该和esp_apptrace_buffer_get的dest一致
ptr:跟踪缓冲区指针，应该和esp_apptrace_buffer_get的返回值一致
tmo：时间限制 (us)
*/
esp_err_t esp_apptrace_buffer_put(esp_apptrace_dest_t dest, uint8_t *ptr, uint32_t tmo)

//向跟踪缓冲区写入数据
esp_err_t esp_apptrace_write(esp_apptrace_dest_t dest, const void *data, uint32_t size, uint32_t tmo)

//这两个是实现printf的底层函数 用户可以用这两个函数
//实现类似printf的格式化输出
int esp_apptrace_vprintf_to(esp_apptrace_dest_t dest, uint32_t tmo, const char *fmt, va_list ap)
int esp_apptrace_vprintf(const char *fmt, va_list ap)

//刷新缓冲区
esp_err_t esp_apptrace_flush(esp_apptrace_dest_t dest, uint32_t tmo)
esp_err_t esp_apptrace_flush_nolock(esp_apptrace_dest_t dest, uint32_t min_sz, uint32_t tmo)

//从跟踪数据缓冲区中读取数据
esp_err_t esp_apptrace_read(esp_apptrace_dest_t dest, void *data, uint32_t *size, uint32_t tmo)


//检查缓冲区是否有未处理的数据
uint8_t *esp_apptrace_down_buffer_get(esp_apptrace_dest_t dest, uint32_t *size, uint32_t tmo)
//表示缓冲区数据被处理，这两个函数是相对的
esp_err_t esp_apptrace_down_buffer_put(esp_apptrace_dest_tdest, uint8_t *ptr, uint32_t tmo)


//判断主机是否连接
bool esp_apptrace_host_is_connected(esp_apptrace_dest_t dest)

//类似文件操作
void *esp_apptrace_fopen(esp_apptrace_dest_t dest, const char *path, const char *mode)
void *esp_apptrace_fopen(esp_apptrace_dest_t dest, const char *path, const char *mode)
size_t esp_apptrace_fwrite(esp_apptrace_dest_t dest, const void *ptr, size_t size, size_t nmemb, void *stream)
size_t esp_apptrace_fread(esp_apptrace_dest_t dest, void *ptr, size_t size, size_t nmemb, void *stream)
int esp_apptrace_fseek(esp_apptrace_dest_t dest, void *stream, long offset, int whence)
int esp_apptrace_ftell(esp_apptrace_dest_t dest, void *stream)
int esp_apptrace_fstop(esp_apptrace_dest_t dest)//判断是否文件结束