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)//判断是否文件结束