Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
6a1a183b
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
6a1a183b
编写于
7月 27, 2023
作者:
葛
葛亚芳
提交者:
Gitee
7月 27, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update MindSpore Native API
Signed-off-by:
N
葛亚芳
<
geyafang@huawei.com
>
上级
3d737f16
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
91 addition
and
1 deletion
+91
-1
zh-cn/application-dev/reference/native-apis/_mind_spore.md
zh-cn/application-dev/reference/native-apis/_mind_spore.md
+88
-1
zh-cn/application-dev/reference/native-apis/context_8h.md
zh-cn/application-dev/reference/native-apis/context_8h.md
+2
-0
zh-cn/application-dev/reference/native-apis/tensor_8h.md
zh-cn/application-dev/reference/native-apis/tensor_8h.md
+1
-0
未找到文件。
zh-cn/application-dev/reference/native-apis/_mind_spore.md
浏览文件 @
6a1a183b
...
...
@@ -109,6 +109,7 @@
|
[
OH_AI_DeviceInfoSetFrequency
](
#oh_ai_deviceinfosetfrequency
)
(
[OH_AI_DeviceInfoHandle](#oh_ai_deviceinfohandle
)
device_info, int frequency) | 设置NPU的频率,仅NPU设备可用。 |
|
[
OH_AI_DeviceInfoGetFrequency
](
#oh_ai_deviceinfogetfrequency
)
(
const
[
OH_AI_DeviceInfoHandle
]
(#oh_ai_deviceinfohandle) device_info) | 获取NPU的频率类型,仅NPU设备可用。 |
|
[
OH_AI_GetAllNNRTDeviceDescs
](
#oh_ai_getallnnrtdevicedescs
)
(
size_t
\*
num) | 获取系统中所有NNRT硬件设备的描述信息。 |
|
[
OH_AI_GetElementOfNNRTDeviceDescs
](
#oh_ai_getelementofnnrtdevicedescs
)
(
NNRTDeviceDesc
\*
descs, size_t index) | 获取NNRT设备描述信息数组中的元素指针。 |
|
[
OH_AI_DestroyAllNNRTDeviceDescs
](
#oh_ai_destroyallnnrtdevicedescs
)
(
[NNRTDeviceDesc](#nnrtdevicedesc
)
\*\*
desc) | 销毁从
[
OH_AI_GetAllNNRTDeviceDescs
](
#oh_ai_getallnnrtdevicedescs
)
获取的NNRT描写信息实例数组。 |
|
[
OH_AI_GetDeviceIdFromNNRTDeviceDesc
](
#oh_ai_getdeviceidfromnnrtdevicedesc
)
(
const
[
NNRTDeviceDesc
]
(#nnrtdevicedesc)
\*
desc) | 从特定的NNRT设备描述信息实例获取NNRT设备ID。注意,此ID只对NNRT有效。 |
|
[
OH_AI_GetNameFromNNRTDeviceDesc
](
#oh_ai_getnamefromnnrtdevicedesc
)
(
const
[
NNRTDeviceDesc
]
(#nnrtdevicedesc)
\*
desc) | 从特定的NNRT设备描述信息实例获取NNRT设备名称。 |
...
...
@@ -131,6 +132,7 @@
|
[
OH_AI_ModelGetOutputs
](
#oh_ai_modelgetoutputs
)
(
const
[
OH_AI_ModelHandle
]
(#oh_ai_modelhandle) model) | 获取模型的输出张量数组结构体。 |
|
[
OH_AI_ModelGetInputByTensorName
](
#oh_ai_modelgetinputbytensorname
)
(
const
[
OH_AI_ModelHandle
]
(#oh_ai_modelhandle) model, const char
\*
tensor_name) | 通过张量名获取模型的输入张量。 |
|
[
OH_AI_ModelGetOutputByTensorName
](
#oh_ai_modelgetoutputbytensorname
)
(
const
[
OH_AI_ModelHandle
]
(#oh_ai_modelhandle) model, const char
\*
tensor_name) | 通过张量名获取模型的输出张量。 |
|
[
OH_AI_DeviceInfoAddExtension
](
#oh_ai_deviceinfoaddextension
)
(
[OH_AI_DeviceInfoHandle](#oh_ai_deviceinfohandle
)
device_info, const char
\*
name, const char
\*
value, size_t value_size) | 向设备信息中添加键/值对形式的扩展配置。只对NNRT设备信息有效。 |
|
[
OH_AI_TensorCreate
](
#oh_ai_tensorcreate
)
(
const
char
\*
name,
[
OH_AI_DataType
](
#oh_ai_datatype
)
type, const int64_t
\*
shape, size_t shape_num, const void
\*
data, size_t data_len) | 创建一个张量对象。 |
|
[
OH_AI_TensorDestroy
](
#oh_ai_tensordestroy
)
(
[OH_AI_TensorHandle](#oh_ai_tensorhandle
)
\*
tensor) | 释放张量对象。 |
|
[
OH_AI_TensorClone
](
#oh_ai_tensorclone
)
(
[OH_AI_TensorHandle](#oh_ai_tensorhandle
)
tensor) | 深拷贝一个张量。 |
...
...
@@ -147,7 +149,7 @@
|
[
OH_AI_TensorGetMutableData
](
#oh_ai_tensorgetmutabledata
)
(
const
[
OH_AI_TensorHandle
]
(#oh_ai_tensorhandle) tensor) | 获取可变的张量数据指针。如果数据为空则会开辟内存。 |
|
[
OH_AI_TensorGetElementNum
](
#oh_ai_tensorgetelementnum
)
(
const
[
OH_AI_TensorHandle
]
(#oh_ai_tensorhandle) tensor) | 获取张量元素数量。 |
|
[
OH_AI_TensorGetDataSize
](
#oh_ai_tensorgetdatasize
)
(
const
[
OH_AI_TensorHandle
]
(#oh_ai_tensorhandle) tensor) | 获取张量中的数据的字节数大小。 |
|
[
OH_AI_TensorSetUserData
](
#oh_ai_tensorsetuserdata
)
(
[OH_AI_TensorHandle](#oh_ai_tensorhandle
)
tensor, void
\*
data, size_t data_size) | 设置张量为用户自行管理的数据。此接口常用于复用用户数据作为模型输入,可减少一次数据拷贝。 |
## 宏定义说明
...
...
@@ -1951,3 +1953,88 @@ OH_AI_API void OH_AI_TensorSetShape (OH_AI_TensorHandle tensor, const int64_t *
| tensor | 张量对象句柄。 |
| shape | 形状数组。 |
| shape_num | 张量形状数组长度。 |
### OH_AI_TensorSetUserData()
```
OH_AI_API OH_AI_Status OH_AI_TensorSetUserData (OH_AI_TensorHandle tensor, void * data, size_t data_size )
```
**描述:**
设置张量为用户自行管理的数据。
此接口常用于复用用户数据作为模型输入,可减少一次数据拷贝。
注意:此数据对于张量来说是外部数据,张量销毁时不会主动释放,由调用者负责释放。另外,在此张量使用过程中,调用者须确保此数据有效。
**参数:**
| 名称 | 描述 |
| -------- | -------- |
| tensor | 张量对象句柄。 |
| data | 用户数据首地址。 |
| data_size | 用户数据长度。 |
**返回:**
执行状态码。若成功返回OH_AI_STATUS_SUCCESS,否则返回具体错误码。
**起始版本:**
10
### OH_AI_DeviceInfoAddExtension()
```
OH_AI_API OH_AI_Status OH_AI_DeviceInfoAddExtension (OH_AI_DeviceInfoHandle device_info, const char * name, const char * value, size_t value_size )
```
**描述:**
向设备信息中添加键/值对形式的扩展配置。只对NNRT设备信息有效。 注意:当前仅支持{"CachePath": "YourCachePath"},{"CacheVersion": "YouCacheVersion"}, {"QuantParam": "YourQuantConfig"} 三种键值对配置,用户根据使用情况替换具体的值。
**参数:**
| 名称 | 描述 |
| -------- | -------- |
| device_info | 指向设备信息实例的
[
OH_AI_DeviceInfoHandle
](
#oh_ai_deviceinfohandle
)
。 |
| name | 单个扩展项的键,格式为C字符串。 |
| value | 单个扩展项的值内容首地址。 |
| value_size | 单个扩展项的值内容长度。 |
**返回:**
**OH_AI_Status**
执行状态码,若成功返回OH_AI_STATUS_SUCCESS,失败则返回具体错误码。
**起始版本:**
10
### OH_AI_GetElementOfNNRTDeviceDescs()
```
OH_AI_API NNRTDeviceDesc* OH_AI_GetElementOfNNRTDeviceDescs (NNRTDeviceDesc * descs, size_t index )
```
**描述:**
获取NNRT设备描述信息数组中的元素指针。
**参数:**
| 名称 | 描述 |
| -------- | -------- |
| descs | NNRT设备描述信息数组。 |
| index | 数组元素索引。 |
**返回:**
NNRT设备描述信息类型指针。
**起始版本:**
10
zh-cn/application-dev/reference/native-apis/context_8h.md
浏览文件 @
6a1a183b
...
...
@@ -52,6 +52,7 @@
|
[
OH_AI_DeviceInfoSetFrequency
](
_mind_spore.md#oh_ai_deviceinfosetfrequency
)
(
[OH_AI_DeviceInfoHandle](_mind_spore.md#oh_ai_deviceinfohandle
)
device_info, int frequency) | 设置NPU的频率,仅NPU设备可用。 |
|
[
OH_AI_DeviceInfoGetFrequency
](
_mind_spore.md#oh_ai_deviceinfogetfrequency
)
(
const
[
OH_AI_DeviceInfoHandle
]
(_mind_spore.md#oh_ai_deviceinfohandle) device_info) | 获取NPU的频率类型,仅NPU设备可用。 |
|
[
OH_AI_GetAllNNRTDeviceDescs
](
_mind_spore.md#oh_ai_getallnnrtdevicedescs
)
(
size_t
\*
num) | 获取系统中所有NNRT硬件设备的描述信息。 |
|
[
OH_AI_GetElementOfNNRTDeviceDescs
](
_mind_spore.md#oh_ai_getelementofnnrtdevicedescs
)
(
NNRTDeviceDesc
\*
descs, size_t index) | 获取NNRT设备描述信息数组中的元素指针。 |
|
[
OH_AI_DestroyAllNNRTDeviceDescs
](
_mind_spore.md#oh_ai_destroyallnnrtdevicedescs
)
(
[NNRTDeviceDesc](_mind_spore.md#nnrtdevicedesc
)
\*\*
desc) | 销毁从
[
OH_AI_GetAllNNRTDeviceDescs
](
_mind_spore.md#oh_ai_getallnnrtdevicedescs
)
获取的NNRT描写信息实例数组。 |
|
[
OH_AI_GetDeviceIdFromNNRTDeviceDesc
](
_mind_spore.md#oh_ai_getdeviceidfromnnrtdevicedesc
)
(
const
[
NNRTDeviceDesc
]
(_mind_spore.md#nnrtdevicedesc)
\*
desc) | 从特定的NNRT设备描述信息实例获取NNRT设备ID。注意,此ID只对NNRT有效。 |
|
[
OH_AI_GetNameFromNNRTDeviceDesc
](
_mind_spore.md#oh_ai_getnamefromnnrtdevicedesc
)
(
const
[
NNRTDeviceDesc
]
(_mind_spore.md#nnrtdevicedesc)
\*
desc) | 从特定的NNRT设备描述信息实例获取NNRT设备名称。 |
...
...
@@ -64,3 +65,4 @@
|
[
OH_AI_DeviceInfoGetPerformanceMode
](
_mind_spore.md#oh_ai_deviceinfogetperformancemode
)
(
const
[
OH_AI_DeviceInfoHandle
]
(_mind_spore.md#oh_ai_deviceinfohandle) device_info) | 获取NNRT性能模式,仅NNRT设备可用。 |
|
[
OH_AI_DeviceInfoSetPriority
](
_mind_spore.md#oh_ai_deviceinfosetpriority
)
(
[OH_AI_DeviceInfoHandle](_mind_spore.md#oh_ai_deviceinfohandle
)
device_info,
[
OH_AI_Priority
](
_mind_spore.md#oh_ai_priority
)
priority) | 设置NNRT任务优先级,仅NNRT设备可用。 |
|
[
OH_AI_DeviceInfoGetPriority
](
_mind_spore.md#oh_ai_deviceinfogetpriority
)
(
const
[
OH_AI_DeviceInfoHandle
]
(_mind_spore.md#oh_ai_deviceinfohandle) device_info) | 获取NNRT任务优先级,仅NNRT设备可用。 |
|
[
OH_AI_DeviceInfoAddExtension
](
_mind_spore.md#oh_ai_deviceinfoaddextension
)
(
[OH_AI_DeviceInfoHandle](_mind_spore.md#oh_ai_deviceinfohandle
)
device_info, const char
\*
name, const char
\*
value, size_t value_size) | 向设备信息中添加键/值对形式的扩展配置。只对NNRT设备信息有效。 |
zh-cn/application-dev/reference/native-apis/tensor_8h.md
浏览文件 @
6a1a183b
...
...
@@ -44,3 +44,4 @@
|
[
OH_AI_TensorGetMutableData
](
_mind_spore.md#oh_ai_tensorgetmutabledata
)
(
const
OH_AI_TensorHandle tensor) | 获取可变的张量数据指针。如果数据为空则会开辟内存。 |
|
[
OH_AI_TensorGetElementNum
](
_mind_spore.md#oh_ai_tensorgetelementnum
)
(
const
OH_AI_TensorHandle tensor) | 获取张量元素数量。 |
|
[
OH_AI_TensorGetDataSize
](
_mind_spore.md#oh_ai_tensorgetdatasize
)
(
const
OH_AI_TensorHandle tensor) | 获取张量中的数据的字节数大小。 |
|
[
OH_AI_TensorSetUserData
](
_mind_spore.md#oh_ai_tensorsetuserdata
)
(
[OH_AI_TensorHandle](_mind_spore.md#oh_ai_tensorhandle
)
tensor, void
\*
data, size_t data_size) | 设置张量为用户自行管理的数据。此接口常用于复用用户数据作为模型输入,可减少一次数据拷贝。 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录