dcmi_get_device_component_static_version接口原型

函数原型

int dcmi_get_device_component_static_version(int card_id, int device_id, enum dcmi_component_type component_type, unsigned char *version_str, unsigned int len)

功能说明

查询静态组件版本。

参数说明

参数名称	输入/输出	类型	描述
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]。
component_type	输入	enum dcmi_component_type	固件类型 enum dcmi_component_type { DCMI_COMPONENT_TYPE_NVE, DCMI_COMPONENT_TYPE_XLOADER, DCMI_COMPONENT_TYPE_M3FW, DCMI_COMPONENT_TYPE_UEFI, DCMI_COMPONENT_TYPE_TEE, DCMI_COMPONENT_TYPE_KERNEL, DCMI_COMPONENT_TYPE_DTB, DCMI_COMPONENT_TYPE_ROOTFS, DCMI_COMPONENT_TYPE_IMU, DCMI_COMPONENT_TYPE_IMP, DCMI_COMPONENT_TYPE_AICPU, DCMI_COMPONENT_TYPE_HBOOT1_A, DCMI_COMPONENT_TYPE_HBOOT1_B, DCMI_COMPONENT_TYPE_HBOOT2, DCMI_COMPONENT_TYPE_DDR, DCMI_COMPONENT_TYPE_LP, DCMI_COMPONENT_TYPE_HSM, DCMI_COMPONENT_TYPE_SAFETY_ISLAND, DCMI_COMPONENT_TYPE_HILINK, DCMI_COMPONENT_TYPE_RAWDATA, DCMI_COMPONENT_TYPE_SYSDRV, DCMI_COMPONENT_TYPE_ADSAPP, DCMI_COMPONENT_TYPE_COMISOLATOR, DCMI_COMPONENT_TYPE_CLUSTER, DCMI_COMPONENT_TYPE_CUSTOMIZED, DCMI_COMPONENT_TYPE_SYS_BASE_CONFIG, DCMI_COMPONENT_TYPE_RECOVERY, DCMI_COMPONENT_TYPE_HILINK2, DCMI_COMPONENT_TYPE_LOGIC_BIST, DCMI_COMPONENT_TYPE_MEMORY_BIST, DCMI_COMPONENT_TYPE_ATF, DCMI_COMPONENT_TYPE_USER_BASE_CONFIG, DCMI_COMPONENT_TYPE_BOOTROM, DCMI_COMPONENT_TYPE_MAX, DCMI_UPGRADE_AND_RESET_ALL_COMPONENT = 0xFFFFFFF7, DCMI_UPGRADE_ALL_IMAGE_COMPONENT = 0xFFFFFFFD, DCMI_UPGRADE_ALL_FIRMWARE_COMPONENT = 0xFFFFFFFE, DCMI_UPGRADE_ALL_COMPONENT = 0xFFFFFFFF }; 当前仅支持： DCMI_COMPONENT_TYPE_AICPU, DCMI_COMPONENT_TYPE_HBOOT1_A, DCMI_COMPONENT_TYPE_HBOOT1_B, DCMI_COMPONENT_TYPE_HBOOT2， DCMI_COMPONENT_TYPE_HSM， DCMI_COMPONENT_TYPE_HILINK， DCMI_COMPONENT_TYPE_SYS_BASE_CONFIG， DCMI_COMPONENT_TYPE_ATF， DCMI_COMPONENT_TYPE_USER_BASE_CONFIG
version_str	输出	unsigned char *	用户申请的空间，存放返回的固件版本号。
len	输入	unsigned int	version_str的内存大小，大小不能小于64Byte。

返回值

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

异常处理

无。

约束说明

表1 部署场景
Linux物理机		Linux物理机容器
root用户	运行用户组（非root用户）	root用户
Y	N	Y

调用示例

… 
int ret = 0;
int card_id = 0;
int device_id = 0;
unsigned char version_str[64] = {0};
ret = dcmi_get_device_component_static_version(card_id, device_id, DCMI_COMPONENT_TYPE_NVE,version_str, 64);
if (ret != 0){
    //todo：记录日志
    return ret;
}
…