寒武纪MLU SDK 之CNToolkit介绍和使用说明

简要概述

CNToolkit 是寒武纪Neuware SDK 中的主要组件，为用户提供基于BANG架构的编译、调试、分析、运行的工具集。

有关MLU系列产品介绍详细信息请查阅大大通博文《寒武纪产品简介》。

 

安装环境要求

       CNToolkit当前版本只支持Linux平台。安装前，需确认安装环境的一些信息。

1. 查看linux的发行版信息，可以使用cat /etc/os-release或lsb_release -a查看

       

      2. 查看主机架构类型
       

      3.检查Driver是否已经成功安装
       

       4.检查主机上安装的gcc

       由于CNToolkit中的编译工具链只负责编译*.mlu文件描述的Device端程序源码，用户Host端的C和C++源码仍然需要Host端环境中的GCC来编译，需要确认GCC已经安装成功。
       

       5.选择合适的安装方式

       目前针对X86_64和AArch64平台的Linux发行版的CNToolkit均有rpm、deb两种发布包，如下图所示
        

       『寒武纪Edge平台的OS是裁剪定制化的Linux系统，简称为Edge-OS，Edge硬件平台的CPU是AArch64架构，由于Edge-OS是面向边缘侧的，所以不具备在此OS上编译开发的能力，因此CNToolkit不提供运行在Edge平台上的CNCC、CNAS、Cambricon CNRTC、LLVM-MM等组件。CNGDB 组件通过在 Edge-OS 上运行 cngdbserver ，在 Host-OS 上运行 cngdb 的方式支持远程调试。』

安装使用

用户获取到的CNToolkit的rpm或deb是一个由多个组件组成的本地源，安装CNToolkit后并没有将全部组件安装到用户系统，而是将一个包含了全部组件的本地源安装至 /var/cntoolkit-X.Y.Z 目录并在源列表中使能了本地源。这里使用包管理器介绍下安装过程。

♦For Ubuntu

♦使用Deb包安装本地源：

sudo dpkg -i cntoolkit_1.7.3-1.ubuntu16.04_amd64.deb

♦更新本地源缓存：

sudo apt update

♦安装CNToolkit中全部组件：

cd /var/cntoolkit-1.7.3

sudo dpkg -i *.deb

♦For Centos

♦安装第三方EPEL源，方便后续解决包的依赖安装问题：

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

sudo yum update

♦使用RPM包安装本地源：

sudo rpm --install cntoolkit-1.7.3-1.el7.x86_64.rpm

♦清理本地源缓存：

sudo yum clean expire-cache

♦安装CNToolkit中全部组件：

cd /var/cntoolkit-1.7.3

sudo yum install -y *.rpm

♦For Edge-OS

♦按照Ubuntu / CentOS系统安装流程安装开发环境。(安装包分别对应7.3-1.ubuntu16.04_arm64.deb / cntoolkit-1.7.3-1.el7.aarch64.rpm)

♦将Edge部署时所需要的目录/usr/local/neuware/edge/通过网络或移动存储介质拷贝至Edge-OS对应的目录

scp -r /usr/local/neuware/edge username@xxx.xxx.xxx.xxx:/usr/local/neuware/

rsync -avL /usr/local/neuware/edge username@xxx.xxx.xxx.xxx:/usr/local/neuware/edge/

♦查看安装后的CNToolkit版本号和动态库目录：

      cat /usr/local/neuware/version.txt
      

参考资料:

https://www.cambricon.com/docs/sdk_1.7.0/cntoolkit_3.0.2/cntoolkit_install_3.0.2/index.html