dcmi_get_device_multi_utilization_rate_period

函数原型

int dcmi_get_device_multi_utilization_rate_period (int card_id, int device_id, struct dcmi_multi_utilization_info *util_info, int period)

功能说明

获取指定时间内芯片的平均占用率。

参数说明

参数名称	输入/输出	类型	描述
card_id	输入	int	设备ID，当前实际支持的ID通过dcmi_get_card_list接口获取。
device_id	输入	int	芯片ID，通过dcmi_get_device_id_in_card接口获取。取值范围如下： NPU芯片：[0, device_id_max-1]。说明： device_id_max值为1，当device_id为0时表示NPU芯片；当device_id为1时表示MCU芯片。
util_info	输出	struct dcmi_multi_utilization_info *	返回AI Cube利用率、AI vector利用率、AI Core利用率和NPU整体利用率。 #define DCMI_UTIL_RESERVED_LEN 8 struct dcmi_multi_utilization_info { unsigned int aic_util; unsigned int aiv_util; unsigned int aicore_util; unsigned int npu_util; unsigned int reserved[DCMI_UTIL_RESERVED_LEN]; //预留参数 };
period	输入	int	指定时间，单位s，取值范围为[1, 4]。

返回值说明

类型	描述
int	处理结果：成功：返回0。失败：返回码请参见返回码。

异常处理

无。

约束说明

A300I A2 推理卡的片上内存为32G，无业务时系统占用3G。
Atlas 800T A2 训练服务器、Atlas 200T A2 Box16 异构子框的片上内存为64G，无业务时系统占用4G。
Atlas 900 A2 PoD 集群基础单元、A200I A2 Box 异构组件、Atlas 800I A2 推理服务器的片上内存为32G或64G，无业务时系统占用3G或4G。

该命令支持在物理机+特权容器场景使用。

表1 不同部署场景下的支持情况
产品形态	物理机场景（裸机）root用户	物理机场景（裸机）运行用户组（非root用户）	物理机+普通容器场景root用户	物理机+容器AVI场景root用户
Atlas 900 A2 PoD 集群基础单元	Y	Y	Y	Y
Atlas 800T A2 训练服务器	Y	Y	Y	Y
Atlas 800I A2 推理服务器	Y	Y	Y	Y
Atlas 200T A2 Box16 异构子框	Y	Y	Y	Y
A200I A2 Box 异构组件	Y	Y	Y	Y
A300I A2 推理卡	Y	Y	Y	Y
注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。

调用示例

int ret = 0;
int card_id = 0x3;
int device_id = 0;
struct dcmi_multi_utilization_info util_info = {0};
int period = 1;
ret = dcmi_get_device_multi_utilization_rate_period(card_id, device_id, &util_info, period);
if (ret != 0){
    //todo：记录日志
    return ret;
}