尧图网站建设 
ESP-IDF 系统行为分析SEGGER SystemView 追踪sysview完整实战指南【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf本文基于 ESP-IDF 官方文档 docs/en/api-guides/tracing/sysview.rst并结合仓库内 esp_trace 架构文档、apptrace 传输文档、OpenOCD 追踪命令说明以及sysview_tracing示例工程与事件映射文件为开发者提供从启用配置、命令操作到多核数据可视化的完整实战指南。SEGGER SystemView 是一款实时记录与可视化工具用于分析嵌入式应用在运行时的行为任务调度、ISR、系统事件等。在 ESP-IDF 的 esp_trace 模型中SystemView 被实现为一个编码器encoder它把 FreeRTOS 与应用事件格式化为 SystemView 协议再由传输层transport通常为 apptrace over JTAG或用于实时查看的 UART将数据送到主机。读完本文你将掌握在 ESP-IDF 工程中启用 SystemView、通过 OpenOCD 命令采集单核/多核追踪数据并在主机端完成可视化的完整技术方案。一、SystemView 在 esp_trace 模型中的角色ESP-IDF 的追踪系统以esp_trace组件为核心它拥有公开的追踪 API、管理活动追踪会话并负责把追踪编码器与追踪传输连接起来。SystemView、Gcov 以及 apptrace 传输都插接在这一模型之上且该模型是可扩展的——新增追踪格式或传输无需修改 ESP-IDF 本身详见 架构文档。从 tracing/index.rst 的选择路径表格可以看出不同目标对应不同模块目标对应文档/模块分析 FreeRTOS 任务/ISR 行为SEGGER SystemView发送/接收任意应用数据、向主机记录日志Application Level Tracing 传输收集源码覆盖率Gcov自动追踪每个函数的进出Function tracing集成第三方追踪记录器Custom trace library传输层的选择是独立的apptrace over JTAG吞吐最高且支持主机端主动控制启动、停止、转储最适合 SystemView 与按需 Gcov 转储apptrace over UART使用空闲 UART 替代调试探针吞吐低于 JTAG适合 SystemView 实时查看部分芯片还支持USB Serial JTAG传输数据流经其串口 CDC 接口而非 JTAG 接口。SystemView 的官方工具见 SEGGER 官网本文聚焦其在 ESP-IDF 中的接入方式。二、启用 SystemViewSystemView 支持由托管组件espressif/esp_sysview提供。只有当以下两个条件都满足后menuconfig 中的 SystemView 菜单才会出现1. 在idf_component.yml中添加组件依赖工程根目录的idf_component.yml中写入dependencies: espressif/esp_sysview: ^1参考 sysview_tracing 示例的 idf_component.yml该示例同时声明了idf: version: 6.0的 IDF 版本要求。2. 在 menuconfig 中选择外部库进入Component configESP Trace ConfigurationTrace library选择External library from component registry。完成上述两步后即可在Component configSEGGER SystemView Configuration中进行配置时间戳源通过CONFIG_ESP_TRACE_TIMESTAMP_SOURCE选择如 ESP Timer事件采集开关通过CONFIG_SEGGER_SYSVIEW_EVT_XXX系列选项逐个启用或禁用各类 SystemView 事件任务创建/切换、ISR 进出、Timer 进出等UART 目标下的 CPU 选择当使用 UART 作为传输目的地时选择追踪 PRO 还是 APP CPU。以 sysview_tracing 示例的 sdkconfig.defaults 为参照一份典型的启用配置如下CONFIG_FREERTOS_HZ1000 CONFIG_ESP_TRACE_ENABLEy CONFIG_ESP_TRACE_LIB_EXTERNALy CONFIG_ESP_TRACE_TS_SOURCE_ESP_TIMERy CONFIG_SEGGER_SYSVIEW_EVT_OVERFLOW_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_ISR_ENTER_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_ISR_EXIT_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_ISR_TO_SCHED_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_START_EXEC_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_STOP_EXEC_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_START_READY_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_STOP_READY_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_CREATE_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_TERMINATE_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_IDLE_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TIMER_ENTER_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TIMER_EXIT_ENABLEy说明完整的、最新的配置选项清单与主机端设置以组件 READMEesp_sysview为准。三、通过 UART 进行实时追踪若希望通过 UART 接口实时查看追踪数据需按以下顺序配置在Component configESP Trace ConfigurationApplication Level Tracing中将**目的地destination**选择为 UART。此时还需要配置端口号、波特率、TX/RX 引脚号及附加 UART 参数。根据 transports.rstUART 的 RX/TX 环形缓冲区大小由CONFIG_APPTRACE_UART_TX_BUFF_SIZE控制取决于经 UART 传输的数据量单条消息最大长度由CONFIG_APPTRACE_UART_TX_MSG_SIZE控制在Component configESP Trace ConfigurationSEGGER SystemView中选择要追踪的 CPUPro 或 App。由于 UART 吞吐低于 JTAG实时追踪时建议选择不被打断的专用 UART避免与控制台占用冲突并合理设置环形缓冲区大小以减少丢包。四、OpenOCD SystemView 追踪命令通过 JTAG 追踪时数据由专用的 OpenOCD 命令采集。OpenOCD/JTAG 的环境搭建适配器接线、OpenOCD 启动、telnet 连接等参见 JTAG Debugging。命令总览esp sysview [start options] | [stop] | [status]子命令作用start启动追踪持续流式传输stop停止追踪status查询追踪状态start 命令语法start outfile1 [outfile2] [poll_period [trace_size [stop_tmo]]]参数含义与默认值outfile1PRO CPU 数据的保存文件路径格式为file://path/to/fileoutfile2APP CPU 数据的保存文件路径格式为file://path/to/filepoll_period可用追踪数据的轮询周期ms。大于 0 时命令以非阻塞模式运行。默认 1 mstrace_size采集的数据最大字节数达到后自动停止追踪。默认 -1禁用该停止触发器stop_tmo空闲超时秒。指定时间内无数据则停止追踪。默认 -1禁用该停止触发器重要提示若poll_period为 0在追踪停止之前 OpenOCD telnet 命令行将不可用。此时必须手动停止复位开发板或在 OpenOCD 窗口不是 telnet 会话所在窗口按 CtrlC。另一种做法是设置trace_size等待数据采集到该大小后自动停止。使用示例以下命令以非阻塞模式采集双核追踪数据分别保存到两个文件esp sysview start file://pro-cpu.SVDat file://app-cpu.SVDat要停止该过程在 OpenOCD telnet 提示符下输入esp sysview stop也可选择在 OpenOCD 窗口按 CtrlC。从 transports.rst 中 apptrace 命令的配套用法可知其通用参数语义与esp sysview一致esp apptrace start file://trace.log 1 2048 5 0 0表示非阻塞采集 2048 字节、空闲超时 5 秒。若看到 Data timeout! 提示通常意味着目标产生的数据不足以在超时前清空缓冲可增大超时值或使用esp_apptrace_flush()按间隔主动刷新数据。五、多核追踪esp sysview_mcore命令对于 SystemView 3.60 及更高版本支持多核追踪请使用esp sysview_mcore命令。它与esp sysview完全一致但输出使用 SEGGER SystemView 官方多核格式——所有核的追踪数据保存在同一个文件中可直接在 SystemView v3.60 及以上版本中打开。使用示例esp sysview_mcore start file://heap_log_mcore.SVDatesp sysview_mcore接受与esp sysview相同的参数详细语法与选项参照上文。在 sysview_tracing 示例的 gdbinit 中可以看到自动化实践通过 GDB 脚本连接目标、复位、在app_main打断点并在断点处执行mon esp sysview_mcore start file:///tmp/sysview_example.svdat自动开始追踪程序运行结束后执行mon esp sysview_mcore stop停止。多核格式单文件同时容纳单核与双核目标且要求 SystemView v3.60。六、数据可视化采集到追踪数据后需要专门的工具进行可视化以分析程序行为。多核追踪的可视化要求SystemViewv3.60 及以上使用esp sysview_mcore命令生成单个多核格式文件直接加载即可进行多核可视化SystemViewv3.60 之前不支持多核追踪。对支持双核的芯片通过 JTAG 双核模式追踪时会生成两个独立文件PRO CPU 一个、APP CPU 一个需分别加载到两个 SystemView 实例中。UART 方式则在 menuconfig 中选择外部库后通过Component configSEGGER SystemView Configuration指定要追踪的 CPUPro 或 App。对于旧版 SystemView分别分析每个核的数据较为不便可改用 Eclipse 插件Impulse它能加载多个追踪文件在单一视图中查看双核事件且相比 SystemView 免费版没有 1,000,000 事件的限制。ESP-IDF 专属事件映射文件ESP-IDF 使用自己的一套 SystemView FreeRTOS 事件 ID 映射因此需要将原文件$SYSVIEW_INSTALL_DIR/Description/SYSVIEW_FreeRTOS.txt替换为 ESP-IDF 提供的$IDF_PATH/tools/esp_app_trace/SYSVIEW_FreeRTOS.txt仓库内路径为tools/esp_app_trace/SYSVIEW_FreeRTOS.txt。同时配置 SystemView serializer 时也应使用该 ESP-IDF 专属文件的内容。该映射文件为 FreeRTOS 的每个系统调用分配了事件 ID 与参数解码模板例如128 vTaskAllocateMPURegions xTask%t pxRegions%u 33 vTaskDelete xTaskToDelete%t 34 vTaskDelay xTicksToDelay%u 53 xQueueGenericSend xQueue%I pvItemToQueue%p xTicksToWait%u xCopyPosition%u 512 esp_sysview_heap_trace_alloc addr%p size%u callers%x 513 esp_sysview_heap_trace_free addr%p callers%x注意最后两行ID 512/513是 ESP-IDF 为堆分配追踪heap tracing扩展的自定义事件由 sysview_tracing_heap_log 示例 使用可与 SystemView 事件一并展示堆内存的分配/释放调用栈。使用 Impulse 配置双核追踪安装 Impulse 并确认其能分别在独立标签页加载各核的追踪文件后可通过以下步骤添加 Multi Adapter Port把两个文件加载到同一视图打开Signal Ports视图WindowsShow ViewOther在 Impulse 文件夹下找到Signal Ports并双击打开在Signal Ports视图中右键Ports选择AddNew Multi Adapter Port在打开的对话框中点击Add选择New Pipe/File在对话框中选择SystemView Serializer作为 Serializer并设置 PRO CPU 追踪文件路径点击OK对 APP CPU 追踪文件重复步骤 3-4双击创建的端口打开该端口的视图点击Start/Stop Streaming按钮加载数据使用Zoom Out、Zoom In、Zoom Fit按钮查看数据测量光标等其他功能请参考 Impulse 官方文档。排错提示若可视化出现问题无数据显示或缩放行为异常可尝试删除当前信号层级signal hierarchy然后双击所需文件或端口Eclipse 会提示创建新的信号层级。七、应用示例从源码看 SystemView 用户事件扩展文档提供了两个可直接运行的示例examples/system/tracing/sysview_tracing演示使用 SEGGER SystemView 追踪 FreeRTOS 任务与系统事件examples/system/tracing/sysview_tracing_heap_log演示堆分配追踪与 SystemView 事件并行展示。以sysview_tracing为例见 main/sysview_tracing.c该示例模拟了一个典型问题场景定时器 ISR 每次触发向任务发送事件任务处理事件后等待下一个由于事件没有确认机制当 ISR 触发频率高于任务处理速度时部分事件会丢失示例运行输出中任务依次收到 1、2、5、8、10丢失了中间事件。SystemView 正是用来定位这类系统级互动问题的工具。示例还展示了扩展 SystemView 的两种方式方式一使用内置用户事件 API——通过SEGGER_SYSVIEW_OnUserStart/SEGGER_SYSVIEW_OnUserStop标记用户事件开始/结束。这种方式无需额外编码但只能携带事件 ID无法附带其他数据#define SYSVIEW_EXAMPLE_SEND_EVENT_START() SEGGER_SYSVIEW_OnUserStart(SYSVIEW_EXAMPLE_SEND_EVENT_ID) #define SYSVIEW_EXAMPLE_SEND_EVENT_END(_val_) SEGGER_SYSVIEW_OnUserStop(SYSVIEW_EXAMPLE_SEND_EVENT_ID)方式二自定义 SystemView 消息——注册用户模块SEGGER_SYSVIEW_MODULE定义自己的事件集合每个事件可携带任意数量参数。示例在CONFIG_USE_CUSTOM_EVENT_ID开启时定义s_example_sysview_module模块名为MExample SystemView User Module含 4 个事件并通过SEGGER_SYSVIEW_PREPARE_PACKETSEGGER_SYSVIEW_EncodeU32SEGGER_SYSVIEW_SendPacket构造并发送自定义事件包。由于当前 OpenOCD 不支持向目标请求模块信息示例在收到主机 START 命令后SEGGER_SYSVIEW_Started()才调用SEGGER_SYSVIEW_RegisterModule注册模块。要自定义事件在 Events 视图中以可读名称显示需在SYSVIEW_FreeRTOS.txt中定义解析模板。示例同样展示了 esp_trace 用户参数回调的用法当启用 apptrace 传输时实现esp_trace_get_user_params()返回编码器为sysview、传输为apptrace的打开参数UART 模式下可覆盖默认配置把 TX/RX 引脚指到控制台引脚U0TXD_GPIO_NUM/U0RXD_GPIO_NUM。八、小结SEGGER SystemView 为 ESP-IDF 开发者提供了一条从现象到根因的系统级分析路径通过托管组件espressif/esp_sysview一键接入借助esp sysview/esp sysview_mcore两条 OpenOCD 命令分别完成单核/多核数据采集最终在 SystemView 3.60或 Impulse 插件中完成可视化。结合 ESP-IDF 专属的SYSVIEW_FreeRTOS.txt事件映射与示例工程中的自定义事件扩展手法开发者既能分析 FreeRTOS 调度与 ISR 行为也能将应用自有的关键事件如堆分配、任务通知纳入同一时间线从而精准定位时序相关的疑难问题。更底层的传输机制post-mortem/streaming 两种模式、16 KB 分块暴露、UART 参数等可进一步查阅 Application Level Tracing 传输文档 与 esp_trace 追踪总览。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESP-IDF 系统行为分析：SEGGER SystemView 追踪（sysview）完整实战指南
ESP-IDF 系统行为分析SEGGER SystemView 追踪sysview完整实战指南【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf本文基于 ESP-IDF 官方文档 docs/en/api-guides/tracing/sysview.rst并结合仓库内 esp_trace 架构文档、apptrace 传输文档、OpenOCD 追踪命令说明以及sysview_tracing示例工程与事件映射文件为开发者提供从启用配置、命令操作到多核数据可视化的完整实战指南。SEGGER SystemView 是一款实时记录与可视化工具用于分析嵌入式应用在运行时的行为任务调度、ISR、系统事件等。在 ESP-IDF 的 esp_trace 模型中SystemView 被实现为一个编码器encoder它把 FreeRTOS 与应用事件格式化为 SystemView 协议再由传输层transport通常为 apptrace over JTAG或用于实时查看的 UART将数据送到主机。读完本文你将掌握在 ESP-IDF 工程中启用 SystemView、通过 OpenOCD 命令采集单核/多核追踪数据并在主机端完成可视化的完整技术方案。一、SystemView 在 esp_trace 模型中的角色ESP-IDF 的追踪系统以esp_trace组件为核心它拥有公开的追踪 API、管理活动追踪会话并负责把追踪编码器与追踪传输连接起来。SystemView、Gcov 以及 apptrace 传输都插接在这一模型之上且该模型是可扩展的——新增追踪格式或传输无需修改 ESP-IDF 本身详见 架构文档。从 tracing/index.rst 的选择路径表格可以看出不同目标对应不同模块目标对应文档/模块分析 FreeRTOS 任务/ISR 行为SEGGER SystemView发送/接收任意应用数据、向主机记录日志Application Level Tracing 传输收集源码覆盖率Gcov自动追踪每个函数的进出Function tracing集成第三方追踪记录器Custom trace library传输层的选择是独立的apptrace over JTAG吞吐最高且支持主机端主动控制启动、停止、转储最适合 SystemView 与按需 Gcov 转储apptrace over UART使用空闲 UART 替代调试探针吞吐低于 JTAG适合 SystemView 实时查看部分芯片还支持USB Serial JTAG传输数据流经其串口 CDC 接口而非 JTAG 接口。SystemView 的官方工具见 SEGGER 官网本文聚焦其在 ESP-IDF 中的接入方式。二、启用 SystemViewSystemView 支持由托管组件espressif/esp_sysview提供。只有当以下两个条件都满足后menuconfig 中的 SystemView 菜单才会出现1. 在idf_component.yml中添加组件依赖工程根目录的idf_component.yml中写入dependencies: espressif/esp_sysview: ^1参考 sysview_tracing 示例的 idf_component.yml该示例同时声明了idf: version: 6.0的 IDF 版本要求。2. 在 menuconfig 中选择外部库进入Component configESP Trace ConfigurationTrace library选择External library from component registry。完成上述两步后即可在Component configSEGGER SystemView Configuration中进行配置时间戳源通过CONFIG_ESP_TRACE_TIMESTAMP_SOURCE选择如 ESP Timer事件采集开关通过CONFIG_SEGGER_SYSVIEW_EVT_XXX系列选项逐个启用或禁用各类 SystemView 事件任务创建/切换、ISR 进出、Timer 进出等UART 目标下的 CPU 选择当使用 UART 作为传输目的地时选择追踪 PRO 还是 APP CPU。以 sysview_tracing 示例的 sdkconfig.defaults 为参照一份典型的启用配置如下CONFIG_FREERTOS_HZ1000 CONFIG_ESP_TRACE_ENABLEy CONFIG_ESP_TRACE_LIB_EXTERNALy CONFIG_ESP_TRACE_TS_SOURCE_ESP_TIMERy CONFIG_SEGGER_SYSVIEW_EVT_OVERFLOW_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_ISR_ENTER_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_ISR_EXIT_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_ISR_TO_SCHED_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_START_EXEC_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_STOP_EXEC_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_START_READY_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_STOP_READY_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_CREATE_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TASK_TERMINATE_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_IDLE_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TIMER_ENTER_ENABLEy CONFIG_SEGGER_SYSVIEW_EVT_TIMER_EXIT_ENABLEy说明完整的、最新的配置选项清单与主机端设置以组件 READMEesp_sysview为准。三、通过 UART 进行实时追踪若希望通过 UART 接口实时查看追踪数据需按以下顺序配置在Component configESP Trace ConfigurationApplication Level Tracing中将**目的地destination**选择为 UART。此时还需要配置端口号、波特率、TX/RX 引脚号及附加 UART 参数。根据 transports.rstUART 的 RX/TX 环形缓冲区大小由CONFIG_APPTRACE_UART_TX_BUFF_SIZE控制取决于经 UART 传输的数据量单条消息最大长度由CONFIG_APPTRACE_UART_TX_MSG_SIZE控制在Component configESP Trace ConfigurationSEGGER SystemView中选择要追踪的 CPUPro 或 App。由于 UART 吞吐低于 JTAG实时追踪时建议选择不被打断的专用 UART避免与控制台占用冲突并合理设置环形缓冲区大小以减少丢包。四、OpenOCD SystemView 追踪命令通过 JTAG 追踪时数据由专用的 OpenOCD 命令采集。OpenOCD/JTAG 的环境搭建适配器接线、OpenOCD 启动、telnet 连接等参见 JTAG Debugging。命令总览esp sysview [start options] | [stop] | [status]子命令作用start启动追踪持续流式传输stop停止追踪status查询追踪状态start 命令语法start outfile1 [outfile2] [poll_period [trace_size [stop_tmo]]]参数含义与默认值outfile1PRO CPU 数据的保存文件路径格式为file://path/to/fileoutfile2APP CPU 数据的保存文件路径格式为file://path/to/filepoll_period可用追踪数据的轮询周期ms。大于 0 时命令以非阻塞模式运行。默认 1 mstrace_size采集的数据最大字节数达到后自动停止追踪。默认 -1禁用该停止触发器stop_tmo空闲超时秒。指定时间内无数据则停止追踪。默认 -1禁用该停止触发器重要提示若poll_period为 0在追踪停止之前 OpenOCD telnet 命令行将不可用。此时必须手动停止复位开发板或在 OpenOCD 窗口不是 telnet 会话所在窗口按 CtrlC。另一种做法是设置trace_size等待数据采集到该大小后自动停止。使用示例以下命令以非阻塞模式采集双核追踪数据分别保存到两个文件esp sysview start file://pro-cpu.SVDat file://app-cpu.SVDat要停止该过程在 OpenOCD telnet 提示符下输入esp sysview stop也可选择在 OpenOCD 窗口按 CtrlC。从 transports.rst 中 apptrace 命令的配套用法可知其通用参数语义与esp sysview一致esp apptrace start file://trace.log 1 2048 5 0 0表示非阻塞采集 2048 字节、空闲超时 5 秒。若看到 Data timeout! 提示通常意味着目标产生的数据不足以在超时前清空缓冲可增大超时值或使用esp_apptrace_flush()按间隔主动刷新数据。五、多核追踪esp sysview_mcore命令对于 SystemView 3.60 及更高版本支持多核追踪请使用esp sysview_mcore命令。它与esp sysview完全一致但输出使用 SEGGER SystemView 官方多核格式——所有核的追踪数据保存在同一个文件中可直接在 SystemView v3.60 及以上版本中打开。使用示例esp sysview_mcore start file://heap_log_mcore.SVDatesp sysview_mcore接受与esp sysview相同的参数详细语法与选项参照上文。在 sysview_tracing 示例的 gdbinit 中可以看到自动化实践通过 GDB 脚本连接目标、复位、在app_main打断点并在断点处执行mon esp sysview_mcore start file:///tmp/sysview_example.svdat自动开始追踪程序运行结束后执行mon esp sysview_mcore stop停止。多核格式单文件同时容纳单核与双核目标且要求 SystemView v3.60。六、数据可视化采集到追踪数据后需要专门的工具进行可视化以分析程序行为。多核追踪的可视化要求SystemViewv3.60 及以上使用esp sysview_mcore命令生成单个多核格式文件直接加载即可进行多核可视化SystemViewv3.60 之前不支持多核追踪。对支持双核的芯片通过 JTAG 双核模式追踪时会生成两个独立文件PRO CPU 一个、APP CPU 一个需分别加载到两个 SystemView 实例中。UART 方式则在 menuconfig 中选择外部库后通过Component configSEGGER SystemView Configuration指定要追踪的 CPUPro 或 App。对于旧版 SystemView分别分析每个核的数据较为不便可改用 Eclipse 插件Impulse它能加载多个追踪文件在单一视图中查看双核事件且相比 SystemView 免费版没有 1,000,000 事件的限制。ESP-IDF 专属事件映射文件ESP-IDF 使用自己的一套 SystemView FreeRTOS 事件 ID 映射因此需要将原文件$SYSVIEW_INSTALL_DIR/Description/SYSVIEW_FreeRTOS.txt替换为 ESP-IDF 提供的$IDF_PATH/tools/esp_app_trace/SYSVIEW_FreeRTOS.txt仓库内路径为tools/esp_app_trace/SYSVIEW_FreeRTOS.txt。同时配置 SystemView serializer 时也应使用该 ESP-IDF 专属文件的内容。该映射文件为 FreeRTOS 的每个系统调用分配了事件 ID 与参数解码模板例如128 vTaskAllocateMPURegions xTask%t pxRegions%u 33 vTaskDelete xTaskToDelete%t 34 vTaskDelay xTicksToDelay%u 53 xQueueGenericSend xQueue%I pvItemToQueue%p xTicksToWait%u xCopyPosition%u 512 esp_sysview_heap_trace_alloc addr%p size%u callers%x 513 esp_sysview_heap_trace_free addr%p callers%x注意最后两行ID 512/513是 ESP-IDF 为堆分配追踪heap tracing扩展的自定义事件由 sysview_tracing_heap_log 示例 使用可与 SystemView 事件一并展示堆内存的分配/释放调用栈。使用 Impulse 配置双核追踪安装 Impulse 并确认其能分别在独立标签页加载各核的追踪文件后可通过以下步骤添加 Multi Adapter Port把两个文件加载到同一视图打开Signal Ports视图WindowsShow ViewOther在 Impulse 文件夹下找到Signal Ports并双击打开在Signal Ports视图中右键Ports选择AddNew Multi Adapter Port在打开的对话框中点击Add选择New Pipe/File在对话框中选择SystemView Serializer作为 Serializer并设置 PRO CPU 追踪文件路径点击OK对 APP CPU 追踪文件重复步骤 3-4双击创建的端口打开该端口的视图点击Start/Stop Streaming按钮加载数据使用Zoom Out、Zoom In、Zoom Fit按钮查看数据测量光标等其他功能请参考 Impulse 官方文档。排错提示若可视化出现问题无数据显示或缩放行为异常可尝试删除当前信号层级signal hierarchy然后双击所需文件或端口Eclipse 会提示创建新的信号层级。七、应用示例从源码看 SystemView 用户事件扩展文档提供了两个可直接运行的示例examples/system/tracing/sysview_tracing演示使用 SEGGER SystemView 追踪 FreeRTOS 任务与系统事件examples/system/tracing/sysview_tracing_heap_log演示堆分配追踪与 SystemView 事件并行展示。以sysview_tracing为例见 main/sysview_tracing.c该示例模拟了一个典型问题场景定时器 ISR 每次触发向任务发送事件任务处理事件后等待下一个由于事件没有确认机制当 ISR 触发频率高于任务处理速度时部分事件会丢失示例运行输出中任务依次收到 1、2、5、8、10丢失了中间事件。SystemView 正是用来定位这类系统级互动问题的工具。示例还展示了扩展 SystemView 的两种方式方式一使用内置用户事件 API——通过SEGGER_SYSVIEW_OnUserStart/SEGGER_SYSVIEW_OnUserStop标记用户事件开始/结束。这种方式无需额外编码但只能携带事件 ID无法附带其他数据#define SYSVIEW_EXAMPLE_SEND_EVENT_START() SEGGER_SYSVIEW_OnUserStart(SYSVIEW_EXAMPLE_SEND_EVENT_ID) #define SYSVIEW_EXAMPLE_SEND_EVENT_END(_val_) SEGGER_SYSVIEW_OnUserStop(SYSVIEW_EXAMPLE_SEND_EVENT_ID)方式二自定义 SystemView 消息——注册用户模块SEGGER_SYSVIEW_MODULE定义自己的事件集合每个事件可携带任意数量参数。示例在CONFIG_USE_CUSTOM_EVENT_ID开启时定义s_example_sysview_module模块名为MExample SystemView User Module含 4 个事件并通过SEGGER_SYSVIEW_PREPARE_PACKETSEGGER_SYSVIEW_EncodeU32SEGGER_SYSVIEW_SendPacket构造并发送自定义事件包。由于当前 OpenOCD 不支持向目标请求模块信息示例在收到主机 START 命令后SEGGER_SYSVIEW_Started()才调用SEGGER_SYSVIEW_RegisterModule注册模块。要自定义事件在 Events 视图中以可读名称显示需在SYSVIEW_FreeRTOS.txt中定义解析模板。示例同样展示了 esp_trace 用户参数回调的用法当启用 apptrace 传输时实现esp_trace_get_user_params()返回编码器为sysview、传输为apptrace的打开参数UART 模式下可覆盖默认配置把 TX/RX 引脚指到控制台引脚U0TXD_GPIO_NUM/U0RXD_GPIO_NUM。八、小结SEGGER SystemView 为 ESP-IDF 开发者提供了一条从现象到根因的系统级分析路径通过托管组件espressif/esp_sysview一键接入借助esp sysview/esp sysview_mcore两条 OpenOCD 命令分别完成单核/多核数据采集最终在 SystemView 3.60或 Impulse 插件中完成可视化。结合 ESP-IDF 专属的SYSVIEW_FreeRTOS.txt事件映射与示例工程中的自定义事件扩展手法开发者既能分析 FreeRTOS 调度与 ISR 行为也能将应用自有的关键事件如堆分配、任务通知纳入同一时间线从而精准定位时序相关的疑难问题。更底层的传输机制post-mortem/streaming 两种模式、16 KB 分块暴露、UART 参数等可进一步查阅 Application Level Tracing 传输文档 与 esp_trace 追踪总览。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考