运行时事件 API 性能计数器使用汇总 - 2023.2 简体中文

AI 引擎工具和流程用户指南 (UG1076)

Document ID
UG1076
Release Date
2023-12-04
Version
2023.2 简体中文
运行时事件 API 在 AI 引擎到 PL 接口拼块和 AI 引擎到 NoC 接口拼块中使用性能计数器。在每一列接口拼块中均有 2 个性能计数器。本节列出了每个运行时事件 API 所使用的性能计数器数量。如果所使用的性能计数器总数超过接口拼块的列中可用的性能计数器数量,那么无法获取性能计数器的 API 将运行失败,并在 AI 引擎仿真器中显示以下错误消息。
[AIE WARNING]: Unable to request resources. RscType: 0
ERROR: event::start_profiling: Failed to request performance counter resources.
对于硬件仿真或硬件流程,使用的错误消息如下。
[XRT] ERROR: ERROR: event::start_profiling: Failed to request performance counter resources.: Resource temporarily unavailable
表 1. 运行时事件 API 性能计数器使用情况
运行时事件枚举 性能计数器的数量
event::io_total_stream_running_to_idle_cycles 1
event::io_stream_start_to_bytes_transferred_cycles 2
event::io_stream_start_difference_cycles 1 个用于输入端口,1 个用于输出端口
event::io_stream_running_event_count 1
注释: 总计有 4 个性能计数器可用。完成 event::stop_profiling 后会释放性能计数器。性能计数器释放后,运行时事件 API 即可获取同样的性能计数器。
注释: 如有多个计算图端口映射到同一个接口拼块,如果在这些端口上运行时事件 API,那么这些 API 将争用相同接口拼块内的性能计数器。