1. 环境配置¶

为了使用 TopsPlatform 基础平台，需要安装配置您的开发环境。

1.1. 组件列表¶

表 1.1.1 安装组件说明¶
组件名称	说明
Enflame Driver Package	内核驱动
User Mode Driver and Runtime	用户驱动和运行时
Enflame TopsCC Compiler Toolkit	编译器工具链
Developer Tools	开发者工具
Samples	代码示例

1.2. TopsPlatform 安装¶

一键安装：将在host和docker内分别安装一次

> sudo bash TopsPlatform.run -y

软件包安装选项：

> bash ./TopsPlatform_1.1.0.5-49ad8f_deb_amd64.run -h
Tops self-extracting installer
usage: ./TopsPlatform_1.1.0.5-49ad8f_deb_amd64.run [-h] [-A] ...
optional arguments:
   -h, --help                Print basic help options
   -l, --list                List install components in the archive, component-id shows in brackets
   -C, --components          Select components to install, component-id separated by comma without space
   --break-depends           Break dependencies, only install selected components
   -y, --silence             Install in silent mode, accept license, use default values
   -x, --extract-only        Extract the contents of this package, but do not install
   --python <python_path>    Specify which python environment to install with, eg. /usr/bin/python3.8 or python3.8
   --install-dir <dir>       Specify a folder to install assets, samples, or docs
   --uninstall               Uninstall this software package

options for driver:
   --driver                  Install drivers only
   --with-dkms               Install with dkms, default is no-dkms
   --no-auto-load            Do not auto load kmd driver when reboot system, default is auto load
   --mdev-host               Load kmd driver in mdev host mode
   --with-vgcu               Load kmd driver in vgcu mode
   --virt-host               Load kmd driver in sriov mode
   --vf-num N                Create N vfs, make sure you have config --virt-host to load kmd driver in sriov mode
   --no-kernel-modules       Do not build and install kernel modules. Build and install on default
   --peermem                 Install Enflame peer memory driver package
   --virt                    Install Enflame virtualization driver package

交互式安装：

> sudo bash TopsPlatform.run

卸载TopsPlatform软件：

> sudo bash TopsPlatform.run --uninstall

如果是第一次使用TopsPlatform软件，需先清理旧环境：

# Ubuntu Dist
> sudo apt remove tops-sdk topsruntime
# CentOS Dist
> sudo yum remove tops-sdk topsruntime

1.3. 加载环境¶

加载驱动¶

加载驱动可使用以下命令。

modprobe enflame

配置环境变量¶

安装包会自动配置环境变量。

export PATH=/opt/tops/bin:$PATH
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/tops/lib/

其他变量¶

TopsPlatform软件同时还提供了一些环境变量可以控制相关软件的行为。

TOPS_VISIBLE_DEVICES¶

在多GCU设备系统中，用于控制执行环境内进程可以看到的设备列表。传入设备物理ID并用逗号隔开，程序内所见的设备索引会根据传入的顺序重新排列，从而影响到topsSetDevice接口和默认设备的行为。

Note

export TOPS_VISIBLE_DEVICES=7,5,3,1

如上配置这个环境变量后，环境内启动的进程可以看到4个设备，默认设备将变为7。