下载
中文
注册

准备环境

  • 开发应用前,需安装驱动固件及CANN软件,请参见CANN软件安装指南部署环境,部署开发环境请安装Ascend-cann-tookit,运行环境请安装Ascend-cann-tookit-nnae或Ascend-cann-tookit-nnrt。

    安装CANN软件后,使用CANN运行用户进行编译、运行时,需要以CANN运行用户登录环境,执行source ${install_path}/set_env.sh命令设置环境变量。其中${install_path}为CANN软件的安装目录,例如:/usr/local/Ascend/ascend-toolkit。

    • 部署开发环境后,才能获取调用接口所需的头文件、编译运行接口所需的库文件。

      对于昇腾设备,已安装驱动、固件场景下,该环境可直接作为运行环境,执行编译生成的应用可执行文件。

    • 部署运行环境后,才能在运行环境上执行编译生成的应用可执行文件。
    • 头文件和库文件所在路径:
      • 头文件路径:${install_path}/latest/include/acl
      • 库文件路径:${install_path}/latest/lib64
    • 本文中的操作步骤(包括模型转换、编译代码、运行应用等)需以运行用户登录开发环境运行环境后再执行,请务必获取各组件的运行用户,以便后续操作时使用。
  • (可选)通过环境变量ASCEND_CACHE_PATH、ASCEND_WORK_PATH设置AscendCL应用编译运行过程中产生的文件的落盘路径,涉及ATC模型转换、AscendCL应用编译配置、AOE模型智能调优、性能数据收集、日志采集等功能,落盘文件包括算子编译缓存文件、知识库文件、调优结果文件、性能数据文件、日志文件等。

    配置示例如下,详细配置说明请参见环境变量参考

    export ASCEND_CACHE_PATH=/repo/task001/cache
    export ASCEND_WORK_PATH=/repo/task001/172.16.1.12_01_03

通过export命令,设置环境变量只在当前终端窗口生效,且只对设置环境变量之后启动的昇腾AI应用进程生效。

若将export命令写入~/.bashrc文件,使环境变量永久生效,则环境变量对该用户下的所有昇腾AI应用进程都生效。这种方式,可能会影响其它不需要调整Device ID的应用进程,请谨慎使用。将export命令写入~/.bashrc文件的方法如下:

  1. 以安装用户在任意目录下执行vi ~/.bashrc,在该文件最后添加上述内容。
  2. 执行:wq!命令保存文件并退出。
  3. 执行source ~/.bashrc使环境变量生效。