昇腾社区首页
中文
注册

dcmi_get_device_errorcode接口原型

函数原型

int dcmi_get_device_errorcode(int card_id, int device_id, int *error_count, unsigned int *error_code, int *error_width)

功能说明

查询设备故障码。

参数说明

参数名称

输入/输出

类型

描述

card_id

输入

int

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

device_id

输入

int

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

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

error_count

输出

int *

错误码数量,取值范围:0~128。

error_code

输出

unsigned int *

错误码。数组长度至少为128。

若打印信息中提示有错误码,请参考对应产品的《黑匣子错误码信息列表》进行查看。

error_width

输出

int *

每个错误码占用的字节空间。

返回值

类型

描述

int

处理结果:

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

异常处理

无。

约束说明

该接口在后续版本将会删除,推荐使用dcmi_get_device_errorcode_v2接口原型
表1 部署场景

Linux物理机

Linux物理机容器

root用户

运行用户组(非root用户)

root用户

Y

Y

Y

调用示例

… 
#define ERROR_CODE_MAX_NUM              (128)
… 
int ret = 0;
int card_id = 0;
int device_id = 0;
int errorcount = 0;
unsigned int errorcode[ERROR_CODE_MAX_NUM] = {0};
int error_code_width = 0;
ret = dcmi_get_device_errorcode(card_id, device_id, &errorcount, errorcode, &error_code_width);
if (ret != 0){
    //todo:记录日志
    return ret;
} 
…