3. 安装libsophon

libsophon在不同的Linux发行版上提供不同类型的安装方式。请根据您的系统选择对应的方式,不要在一台机器上混用多种安装方式。 以下描述中“0.5.1”仅为示例,视当前实际安装版本会有变化。

如果安装了V3.0.0版本及之前版本的SDK驱动,请先卸载旧的驱动:

进入SDK的安装目录,执行:
sudo ./remove_driver_pcie.sh
或者:
sudo rmmod bmsophon
sudo rm -f /lib/modules/$(uname -r)/kernel/drivers/pci/bmsophon.ko

3.1. Debian/Ubuntu系统

安装包由三个文件构成,其中“$arch”为当前机器的硬件架构,使用以下命令可以获取当前服务器的arch:

uname -m
通常x86_64机器对应的硬件架构为amd64,arm64机器对应的硬件架构为arm64:
  • sophon-driver_0.5.1_$arch.deb

  • sophon-libsophon_0.5.1_$arch.deb

  • sophon-libsophon-dev_0.5.1_$arch.deb

其中:sophon-driver包含了PCIe加速卡驱动;sophon-libsophon包含了运行时环境(库文件、工具等);sophon-libsophon-dev包含了开发环境(头文件等)。 如果只是在部署环境上安装,则不需要安装sophon-libsophon-dev。

可以通过如下步骤安装:

安装依赖库,只需要执行一次:
sudo apt install dkms libncurses5
安装libsophon:
sudo dpkg -i sophon-*.deb
在终端执行如下命令,或者登出再登入当前用户后即可使用bm-smi等命令:
source /etc/profile

安装位置为:

/opt/sophon/
├── driver-0.5.1
├── libsophon-0.5.1
│    ├── bin
│    ├── data
│    ├── include
│    └── lib
└── libsophon-current -> /opt/sophon/libsophon-0.5.1

deb包安装方式并不允许您安装同一个包的多个不同版本,但您可能用其它方式在/opt/sophon下放置了若干不同版本。 在使用deb包安装时,/opt/sophon/libsophon-current会指向最后安装的那个版本。在卸载后,它会指向余下的最新版本(如果有的话)。

在使用deb包安装时,如果出现了下面的提示信息

modprobe: FATAL: Module bmsophon is in use.

需要您手动停止正在使用驱动的程序后,手动执行下面的命令来安装新的deb包里的驱动。

sudo modprobe -r bmsophon
sudo modprobe bmsophon

卸载方式:

注意:如果安装了sophon-mw及sophon-rpc,因为它们对libsophon有依赖关系,请先卸载它们。

sudo apt remove sophon-driver sophon-libsophon
或者:
sudo dpkg -r sophon-driver
sudo dpkg -r sophon-libsophon-dev
sudo dpkg -r sophon-libsophon

如果卸载时遇到问题,可以尝试如下方法:

手工卸载驱动:
dkms status
检查输出结果,通常如下:
bmsophon, 0.5.1, 5.15.0-41-generic, x86_64: installed
记下前两个字段,套用到如下命令中:
sudo dkms remove -m bmsophon -v 0.5.1 --all
然后再次卸载驱动:
sudo apt remove sophon-driver
sudo dpkg --purge sophon-driver
彻底清除libsophon:
sudo apt purge sophon-libsophon

3.2. Centos系统, 当前版本仅支持x86_64

安装包由三个文件构成,其中“$arch”为当前机器的硬件架构,使用以下命令可以获取当前服务器的arch:

uname -m
x86_64机器对应的安装包名称为:
  • sophon-driver-0.5.1-1.$arch.rpm

  • sophon-libsophon-0.5.1-1.$arch.rpm

  • sophon-libsophon-dev-0.5.1-1.$arch.rpm

安装前需要通过后面“卸载方式”中的步骤卸载旧版本libsophon,可以通过如下步骤安装:

安装依赖库,只需要执行一次:
sudo yum install -y dkms
sudo yum install -y ncurses*
安装libsophon:
sudo  rpm -ivh sophon-driver-0.5.1-1.x86_64.rpm
sudo  rpm -ivh sophon-libsophon-0.5.1-1.x86_64.rpm
sudo  rpm -ivh --force sophon-libsophon-dev-0.5.1-1.x86_64.rpm
在终端执行如下命令,或者登出再登入当前用户后即可使用bm-smi等命令:
source /etc/profile

卸载方式:

sudo rpm -e sophon-driver-0.5.1-1.x86_64
sudo rpm -e sophon-libsophon-dev-0.5.1-1.x86_64
sudo rpm -e sophon-libsophon-0.5.1-1.x86_64

3.3. Fedora系统, 当前版本仅支持riscv架构

安装包由三个文件构成,其中“$arch”为当前机器的硬件架构,使用以下命令可以获取当前服务器的arch:

uname -m
x86_64机器对应的安装包名称为:
  • sophon-driver-0.5.1-1.$arch.rpm

  • sophon-libsophon-0.5.1-1.$arch.rpm

  • sophon-libsophon-dev-0.5.1-1.$arch.rpm

安装前需要通过后面“卸载方式”中的步骤卸载旧版本libsophon,可以通过如下步骤安装:

安装依赖库,只需要执行一次:
sudo yum install -y dkms
sudo yum install -y ncurses*
安装libsophon:
sudo  rpm -ivh sophon-driver-0.5.1-1.riscv64.rpm
sudo  rpm -ivh sophon-libsophon-0.5.1-1.riscv64.rpm
sudo  rpm -ivh --force sophon-libsophon-dev-0.5.1-1.riscv64.rpm
在终端执行如下命令,或者登出再登入当前用户后即可使用bm-smi等命令:
source /etc/profile

卸载方式:

sudo rpm -e sophon-driver-0.5.1-1.riscv64
sudo rpm -e sophon-libsophon-dev-0.5.1-1.riscv64
sudo rpm -e sophon-libsophon-0.5.1-1.riscv64

3.4. 其它Linux系统

安装包由一个文件构成,其中“$arch”为当前机器的硬件架构,使用以下命令可以获取当前服务器的arch:

uname -m
通常x86_64机器对应的硬件架构为x86_64,arm64机器对应的硬件架构为aarch64:
  • libsophon_0.5.1_$arch.tar.gz

可以通过如下步骤安装:

注意:如果有旧版本,先参考下面的卸载方式步骤卸载旧版本。

tar -xzvf libsophon_0.5.1_$arch.tar.gz
sudo cp -r libsophon_0.5.1_$arch/* /
sudo ln -s /opt/sophon/libsophon-0.5.1 /opt/sophon/libsophon-current

接下来请先按照您所使用Linux发行版的要求搭建驱动编译环境,然后做如下操作:

sudo ln -s /opt/sophon/driver-0.5.1/$bin /lib/firmware/bm1684x_firmware.bin
sudo ln -s /opt/sophon/driver-0.5.1/$bin /lib/firmware/bm1684_ddr_firmware.bin
sudo ln -s /opt/sophon/driver-0.5.1/$bin /lib/firmware/bm1684_tcm_firmware.bin
cd /opt/sophon/driver-0.5.1

此处“$bin”是bin文件全名, 对于bm1684x板卡,为a53lite_pkg.bin, 对于bm1684板卡,如bm1684_ddr.bin_v3.1.2-3dfbe057-221128和bm1684_tcm.bin_v3.1.2-3dfbe057-221128。

之后就可以编译驱动了(这里不依赖于dkms):

sudo make SOC_MODE=0 PLATFORM=asic SYNC_API_INT_MODE=1 \
          TARGET_PROJECT=sg_pcie_device FW_SIMPLE=0 \
          PCIE_MODE_ENABLE_CPU=1
sudo cp ./bmsophon.ko /lib/modules/$(uname -r)/kernel/
sudo depmod
sudo modprobe bmsophon

最后是一些配置工作:

添加库和可执行文件路径:
sudo cp /opt/sophon/libsophon-current/data/libsophon.conf /etc/ld.so.conf.d/
sudo ldconfig
sudo cp /opt/sophon/libsophon-current/data/libsophon-bin-path.sh /etc/profile.d/
在终端执行如下命令,或者登出再登入当前用户后即可使用bm-smi等命令:
source /etc/profile

添加cmake config文件:
sudo mkdir -p /usr/lib/cmake/libsophon
sudo cp /opt/sophon/libsophon-current/data/libsophon-config.cmake /usr/lib/cmake/libsophon/

卸载方式:

sudo rm -f /etc/ld.so.conf.d/libsophon.conf
sudo ldconfig
sudo rm -f /etc/profile.d/libsophon-bin-path.sh
sudo rm -rf /usr/lib/cmake/libsophon
sudo rmmod bmsophon
sudo rm -f /lib/modules/$(uname -r)/kernel/bmsophon.ko
sudo depmod
sudo rm -f /lib/firmware/bm1684x_firmware.bin
sudo rm -f /lib/firmware/bm1684_ddr_firmware.bin
sudo rm -f /lib/firmware/bm1684_tcm_firmware.bin
sudo rm -f /opt/sophon/libsophon-current
sudo rm -rf /opt/sophon/libsophon-0.5.1
sudo rm -rf /opt/sophon/driver-0.5.1