ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

解读 ESP32 system - Application Level Tracing

2021-02-05 12:31:39  阅读:315  来源: 互联网

标签:esp apptrace Tracing ESP32 Level dest void uint32 size


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

标签:esp,apptrace,Tracing,ESP32,Level,dest,void,uint32,size
来源: https://blog.csdn.net/qq_42523725/article/details/113664155

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有