昇腾社区首页
中文
注册

dcmi_get_device_frequency接口原型

函数原型

int dcmi_get_device_frequency(int card_id, int device_id, enum dcmi_freq_type input_type, unsigned int *frequency)

功能说明

获取设备的频率。

参数说明

参数名称

输入/输出

类型

描述

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]。

input_type

输入

enum dcmi_freq_type

设备类型,数值和具体设备类型对应如下:

  • 1:内存
  • 2:控制CPU
  • 6:片上内存
  • 7:AI CORE当前频率
  • 9:AI CORE额定频率
  • 12 :Vector Core当前频率

当前支持1、2、7、9这几种类型。

说明:

AI CORE额定频率:表示AI CORE在TDP功耗和场景下,能够持续运行的频率。

frequency

输出

unsigned int *

频率,单位为MHz。

返回值

类型

描述

int

处理结果:

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

异常处理

无。

约束说明

表1 部署场景

Linux物理机

Linux物理机容器

root用户

运行用户组(非root用户)

root用户

Y

Y

Y

调用示例

… 
int ret = 0;
int card_id = 0;
int device_id = 0;
unsigned int frequency = 0;
ret = dcmi_get_device_frequency(card_id, device_id, DCMI_FREQ_DDR, &frequency);
…