#hrt_ucp_monitor 工具介绍

hrt_ucp_monitor 是一个监控硬件 IP 占用率的工具，支持的 IP 包括BPU，DSP，GDC，STITCH，PYM，ISP，Codec（VPU 和 JPU）。 在提交任务时，UCP可以指定任务部署的后端（Backend)，这些后端与本文档中的硬件IP相对应。

#参数描述

参数	类型	说明
-b, --batch	null	指定以非交互的批处理模式运行, 默认为交互模式。
-d, --delay	int	指定占用率更新间隔，单位毫秒，默认为 1000 毫秒，有效范围为[100, 10000]。
-f, --freq	int	指定采样频率，默认为每秒采样 1000 次，仅对 BPU 和 DSP 有效，有效范围为[10, 1000]。
-n, --number	int	指定占用率的刷新次数，有效范围为[1, INT32_MAX]。
-t, --time	int	指定工具运行时间，单位秒，有效范围为[1, INT32_MAX]。
-e, --enable	string	指定需要监控的 IP，有效值为bpu, dsp, gdc, stitch, pym, isp, jpu, vpu，不区分大小写，多个参数通过分号隔开。

#使用说明

运行 hrt_ucp_monitor -h 或 hrt_ucp_monitor --help 获取工具的使用详情如下所示：

在 hrt_ucp_monitor 的运行过程中，您可以按键盘的Q或执行CTRL+C提前退出。

#默认参数

#概述

运行hrt_ucp_monitor时，如果不指定参数，则使用默认参数运行。默认开启所有硬件IP监控，以交互模式运行， BPU 和 DSP 每秒采样 500 次，硬件 IP 占用率每 1000ms 刷新一次。

#示例

#batch

#概述

批处理模式下，不支持接收用户的按键操作，hrt_ucp_monitor 每次刷新数据都将换行重新输出，适用于将数据重定向到文件。

#示例 1：在终端输出结果

#示例 2：重定向输出到文件

#delay

#概述

指定硬件 IP 占用率的刷新时间，单位毫秒，当前支持的设置范围为[100, 10000]。如果设置的时间不在有效范围内，将设置失败，并打印错误提示信息。

#示例

刷新时间设置为 3 秒，表示每 3 秒刷新一次占用率数据。

#freq

#概述

仅适用于 BPU 和 DSP，用于控制硬件 IP 状态采样频率。当前支持的范围是[10,1000]，即最少每秒采样 10 次，最多每秒采样 1000 次。 由于占用率的统计方式不同，其他硬件 IP，比如 GDC，STITCH 不需要设置采样频率，当设置刷新时间时，会获取指定周期内的占用率数据。

#示例

设置 BPU 和 DSP 的 Busy 状态的采样周期为每秒采样 100 次。

#number

#概述

用于指定硬件 IP 占用率最大刷新次数，当刷新次数到达最大刷新次数后，hrt_ucp_monitor 工具会自动退出，同时您可以按 CTRL+C 提前退出。

#示例

#time

#概述

用于指定工具运行时间，单位秒，在 hrt_ucp_monitor 中会根据刷新时间计算最大刷新次数，当刷新次数到达最大刷新次数后，hrt_ucp_monitor 会自动退出， 与 number 参数一样，您也可以按 CTRL+C 提前退出。time 和 number 参数不支持同时设置，如果同时设置，将提示错误信息。

#示例

工具默认刷新时间为 1s，设置运行 10s 后退出。

#enable

#概述

您可以设置需要开启的硬件 IP，这样可以只监控关心的数据，降低工具的 CPU 占用率。

#示例

工具将只输出 BPU 的占用率数据。

#verbose

#概述

用于显示 hrt_ucp_monitor 运行过程中更详细的日志信息，比如工具使用的参数。

#示例