头文件和库文件说明【免费下载链接】docs该仓库用于维护cann公共文档项目地址: https://gitcode.com/cann/docsCANN应用开发场景涉及Runtime、图引擎Graph Engine简称GE和DVPPDigital Vision Pre-Processing等组件提供的接口。各组件提供的接口及其详细说明请参见各组件的API参考。本节仅介绍接口分类以及调用接口时依赖的头文件和库文件。接口分类接口名以acl作为前缀命名风格为acl接口类别缩写*其中*通常表示操作动词和对象均采用首字母大写。下文为了描述方便将本文中的接口统称为acl接口。在acl接口中参数顺序通常遵循输入参数在前、输出参数在后的原则。且需注意不要因为某些参数是新增的就将其随意添加到接口的末尾相反应将新的仅作为输入的参数放在输出参数之前。对于同时作为输入和输出的参数情况会相对复杂可能还需考虑与其他接口的一致性需灵活处理。表 1接口类别列表接口名前缀描述组件acl系统配置类接口Runtimeaclrt运行时管理类的接口Runtimeaclop单算子模型执行类的接口Runtimeaclblasblas类接口Graph Engineaclmdl模型推理类的接口Graph Engineacldvpp或aclvdec或aclvenc媒体数据处理的接口其中媒体数据处理V2版本下的接口命名例外这一类接口命名以“hi_mpi”开头。DVPPDigital Vision Pre-ProcessingaclprofProfiling配置类接口Runtimeacltdt数据传输接口Runtimeaclfv特征向量检索接口Feature Vector由于软硬件差异各产品型号支持的接口类别不同具体以各接口说明为准。调用接口依赖的头文件和库文件说明安装固件、驱动及CANN软件包后编译、运行应用程序时才能引用到acl接口的头文件、库文件。acl接口的头文件在“${INSTALL_DIR}/include/”目录下库文件在“${INSTALL_DIR}/lib64/”目录下。${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例安装后文件默认存储路径为/usr/local/Ascend/cann。您需要根据实际使用的acl接口来include依赖的文件各头文件的用途如下表所示。须知编译acl接口程序时请按照include的头文件依赖对应的库文件如果引用多余的库文件例如libascendcl.a可能导致版本功能异常或后续版本升级时存在兼容性问题。表 2Runtime头文件和库文件列表定义接口的头文件用途对应的库文件acl/acl_rt.h用于定义初始化/去初始化、Device管理、Context管理、Stream管理、同步等待、内存管理等接口。libacl_rt.so说明为了兼容旧版本旧版本中支持使用libascendcl.so但后续版本这种方式会废弃建议使用libacl_rt.so防止后续版本出现兼容性问题。acl/acl_dump.h用于定义模型和算子Dump接口。libascend_dump.soacl/acl_prof.h用于定义Profiling数据采集接口。libmsprofiler.so说明为了兼容旧版本旧版本中支持使用libascendcl.so但后续版本这种方式会废弃建议使用libmsprofiler.so防止后续版本出现兼容性问题。acl/acl_tdt.h用于定义Tensor数据传输接口。libacl_tdt_channel.soacl/acl_tdt_queue.h用于定义共享队列管理、共享Buffer管理接口。libacl_tdt_queue.soacl/acl_rt_api.h用于定义C扩展接口提供函数重载和模板封装仅适用于C 程序。依赖acl_rt.h。libacl_rt.so表 3Graph Engine组件头文件和库文件列表定义接口的头文件用途对应的库文件acl/acl_mdl.h用于定义模型管理接口。libacl_mdl.so说明为了兼容旧版本旧版本中支持使用libascendcl.so但后续版本这种方式会废弃建议使用libacl_mdl.so防止后续版本出现兼容性问题。acl/acl_op.hacl/acl_op_compiler.h用于定义单算子调用接口仅包含单算模型执行接口。libacl_op_executor.solibacl_op_compiler.so说明为了兼容旧版本旧版本中支持使用libascendcl.so但后续版本这种方式会废弃建议使用libacl_op_executor.so和libacl_op_compiler.so防止后续版本出现兼容性问题。acl/ops/acl_cblas.h用于定义CBLAS接口。libacl_cblas.so表 4DVPP组件头文件和库文件列表分类定义接口的头文件用途对应的库文件媒体数据处理算子acldvppop目录下acldvpp_base.hacldvpp_op_api.h用于定义DVPP媒体数据处理类算子的功能接口。libacl_dvpp_op.so媒体数据处理算子aclnn目录下acl_meta.haclnn_base.h调用算子接口时依赖的公共Meta接口如创建aclTensor、aclScalar、aclIntArray等。libnnopbase.so媒体数据处理V2acl/dvpp/hi_dvpp.h用于定义媒体数据处理V2版本中的DVPP接口。libacl_dvpp_mpi.so媒体数据处理V2acl/media目录下hi_mpi_vi.hhi_common_vi.hhi_common_dis.hhi_common_gdc.hhi_media_common.hhi_media_type.hhi_mpi_sys.h用于定义VIVideo Input视频数据获取功能的接口。libacl_vi_mpi.solibacl_dvpp_mpi.so媒体数据处理V2acl/media目录下hi_mpi_isp.hhi_common_isp.hhi_common_3a.hhi_mpi_ae.hhi_common_ae.hhi_mpi_awb.hhi_common_awb.hhi_common_sns.hhi_media_common.hhi_media_type.hhi_mpi_sys.h用于定义ISPImage Signal Processing系统控制功能的接口。libacl_isp_ae_mpi.solibacl_isp_awb_mpi.solibacl_isp_mpi.solibacl_dvpp_mpi.so媒体数据处理V2acl/media目录下hi_mpi_vpss.hhi_media_common.hhi_media_type.hhi_mpi_sys.h用于定义VPSSVideo Process Sub-System图像处理功能的接口。libacl_vpss_mpi.solibacl_dvpp_mpi.so媒体数据处理V2acl/media/hi_mipi_rx.h用于定义MIPI Rx ioctl命令字。-媒体数据处理V2acl/media目录下hi_mpi_audio.hhi_common_aio.h用于定义音频输入、音频输出功能的接口。libacl_audio_mpi.so媒体数据处理V2acl/media/hi_acodec.h用于定义音量调整的命令字。-媒体数据处理V2acl/media目录下hi_common_vo.hhi_mpi_vo.h用于定义视频输出接口。libacl_vo_mpi.so媒体数据处理V2acl/media/hi_mpi_hdmi.h用于定义对接外设的HDMI接口。libacl_hdmi_mpi.so媒体数据处理V2acl/media/hi_mpi_tde.h用于定义TDE图形绘制接口。libacl_tde_mpi.so媒体数据处理V2acl/media/hifb.h用于定义叠加图形层管理接口。-媒体数据处理V1acl/ops/acl_dvpp.h用于定义媒体数据处理V1版本的接口。libacl_dvpp.so表 5特征向量检索头文件和库文件定义接口的头文件用途对应的库文件acl/ops/acl_fv.h用于定义特征向量检索的接口。libacl_retr.so【免费下载链接】docs该仓库用于维护cann公共文档项目地址: https://gitcode.com/cann/docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考