SOLA Toolkit 安装指南

概述

SOLA Toolkit是墨芯软件开发工具包（以下简称 SOLA），它提供了C++高级编程语言的接口，便于用户开发部署在墨芯硬件上的应用程序。还提供了一系列工具，方便用户进行开发和调试。

系统要求

要在您的系统上使用SOLA Toolkit，您需要安装以下内容：

• 带有 GCC 编译器和工具链的支持版本的 Linux

• SOLA兼容设备（墨芯加速卡）

• SOLA

安装前的准备工作

在安装SOLA之前，需要执行一些操作：

• 验证系统是否具有SOLA兼容设备

• 验证系统是否运行支持的Linux版本

• 验证系统是否已安装 GCC

• 检查IOMMU配置参数，将其设置为disabled

验证系统是否具有SOLA兼容设备

要确定有多少个SOLA兼容设备，请在命令行中键入以下内容：

lspci | grep "1f36:7030"
51:00.0 Processing accelerators: Device 1f36:7030
52:00.0 Processing accelerators: Device 1f36:7030
53:00.0 Processing accelerators: Device 1f36:7030


lspci | grep 1f36  | wc -l
3

验证系统是否运行支持的Linux版本

SOLA仅支持某些特定的Linux发行版。这些在SOLA工具包发行说明中列出。

要确定您运行的是哪个发行版和版本号，请在命令行中键入以下内容：

uname -m && cat /etc/*release

您应该看到类似于以下内容的输出：

x86_64
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=20.04

验证系统是否已安装 GCC

SOLA的安装需要GCC编译器（GCC版本 >= 6.3）。通常，它会随Linux安装的一部分而安装，大多数情况下，与支持的Linux版本一起安装的GCC版本将正常工作。

要验证系统上安装的GCC版本，请在命令行中键入以下内容：

gcc --version

如果显示错误消息，则需要从Linux发行版安装开发工具，或者从Web获取GCC及其相应的工具链版本。

驱动安装方式

已发布的驱动安装包有 2 种，推荐使用 Runfile 的方式进行安装驱动。

• Runfile 安装包

• Deb 安装包

Runfile 安装包

https://moffett-oss-bucket01.oss-cn-shenzhen.aliyuncs.com/sola-toolkits/MOFFETT-Linux-x86_64-v3.4.0.run

Deb 安装包

通过 Runfile 安装

概述

Runfile 是一种扩展名为 .run 的独立安装程序，它提供基于命令行界面安装SOLA工具包。

安装步骤

1. 获取 runfile 安装程序

2. 运行安装程序

sudo sh MOFFETT-<system>-<arch>-<version>.run

例如：

sudo sh MOFFETT-Linux-x86_64-v3.4.0.run

1. 验证安装

验证安装

安装完成后，会自动创建SOLA工具包的软连接，默认安装在 /usr/local/sola 下。

有五个工具被安装到了 /usr/bin 下：

• mx-smi

• mx-qual

• mx-mft

• mx-daemon

• sola-uninstall

通过执行 mx-smi 可以查看系统中的SOLA设备信息。

其他工具的使用方法请参考其它工具的使用手册。

卸载

执行 sola-uninstall 即可完成卸载。

通过 Deb 安装

概述

Debian软件包是一种扩展名为 .deb 的安装程序，用于在Debian及其衍生发行版（例如Ubuntu）上安装软件的二进制软件包格式。

安装步骤

1. 获取 deb 安装程序

2. 运行安装程序

sudo dpkg -i MOFFETT-<system>-<arch>-<version>.deb

例如：

sudo dpkg -i MOFFETT-Linux-x86_64-v3.4.0.deb

1. 验证安装

验证安装

dpkg -l | grep moffett-sola-sdk

# 查看系统中的墨芯加速卡
mx-smi

卸载

sudo dpkg -r moffett-sola-sdk