DCMI_MAIN_CMD_VDEV_MNG

函数原型

int dcmi_set_device_info(int card_id, int device_id, enum dcmi_main_cmd main_cmd, unsigned int sub_cmd, const void *buf, unsigned int buf_size)

功能说明

配置SRIOV功能开关。

参数说明

参数名	输入/输出	类型	描述
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芯片。
main_cmd	输入	enum dcmi_main_cmd	DCMI_MAIN_CMD_VDEV_MNG
sub_cmd	输入	unsigned int	typedef enum { DCMI_VMNG_SUB_CMD_GET_VDEV_RESOURCE, //获取单个虚拟设备的资源信息 DCMI_VMNG_SUB_CMD_GET_TOTAL_RESOURCE, //获取指定SoC设备的总资源信息，用于在创建新虚拟设备时参考使用 DCMI_VMNG_SUB_CMD_GET_FREE_RESOURCE, //获取指定SoC设备的未使用资源信息，用于在创建新虚拟设备时参考使用 DCMI_VMNG_SUB_CMD_SET_SRIOV_SWITCH, //设置SRIOV功能的开关 DCMI_VMNG_SUB_CMD_MAX, //枚举值上限标记 }DCMI_VDEV_MNG_SUB_CMD; 仅支持DCMI_VMNG_SUB_CMD_SET_SRIOV_SWITCH命令。
buf	输入	const void *	详见本节约束说明。
buf_size	输入	unsigned int	buf数组的长度。

表1 sub_cmd对应的buf格式
sub_cmd	buf对应的数据类型	size	参数说明
DCMI_VMNG_SUB_CMD_SET_SRIOV_SWITCH	unsigned int	长度为：sizeof(unsigned int)	0：关闭SRIOV功能 1：开启SRIOV功能

返回值说明

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

异常处理

无

约束说明

关闭SRIOV功能前需要销毁所有的昇腾虚拟化实例（AVI）。
使能SRIOV时，请停掉该场景下的所有业务。

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

调用示例

    …
    int ret;
    int card_id = 0;
    int device_id = 0;
    DCMI_MAIN_CMD main_cmd = DCMI_MAIN_CMD_VDEV_MNG;
    unsigned int sub_cmd = DCMI_VMNG_SUB_CMD_SET_SRIOV_SWITCH;
    unsigned int sriov_switch = 1;
    unsigned int size = sizeof(unsigned int);

    ret = dcmi_set_device_info(card_id, device_id, main_cmd, sub_cmd, (void *)&sriov_switch , size);
    if (ret) {
        // todo
    }
    // todo
    …

父主题： dcmi_set_device_info