下载
中文
注册

dcmi_get_device_health接口原型

函数原型

int dcmi_get_device_health(int card_id, int device_id, unsigned int *health)

功能说明

查询芯片的总体健康状态。

参数说明

参数名称

输入/输出

类型

描述

card_id

输入

int

指定NPU管理单元的ID,当前实际支持的ID通过dcmi_get_card_list接口获取。

device_id

输入

int

指定设备编号,通过dcmi_get_device_id_in_card接口获取。取值范围如下:

NPU芯片:[0, device_id_max-1]。

health

输出

unsigned int *

设备总体健康状态,只代表本部件,不包括与本部件存在逻辑关系的其它部件,内容定义为:

  • 0:正常
  • 1:一般告警
  • 2:重要告警
  • 3:紧急告警
  • 0xFFFFFFFF:该设备不存在

返回值

类型

描述

int

处理结果:

  • 成功:返回0。
  • 失败:返回码请参见返回码

异常处理

无。

约束说明

如果有多个告警,以最严重的告警作为设备的健康状态。
表1 部署场景

Linux物理机

Linux物理机容器

root用户

运行用户组(非root用户)

root用户

Y

Y

Y

调用示例

… 
int ret = 0;
int card_id = 0;
int device_id = 0;
unsigned int health = 0;
ret = dcmi_get_device_health(card_id, device_id, &health);
…