通过DEB包安装KAE

DEB软件包包括hisi_hpre，hisi_sec2，hisi_rde，hisi_zip、libkaezip、libkae、uacce和libwd，其中uacce和libwd是必选安装项，其他软件包需要根据实际使用的模块和算法不同选择性安装，也可全部安装。当前只有KAE1.0支持DEB包方式安装，KAE2.0不支持此安装方式。

前提条件

安装步骤

hisi_zip驱动软件包依赖于uacce软件包，libkaezip引擎软件包依赖libwd软件包。

如果仅加速zlib库的压缩算法建议只需要安装uacce、hisi_zip、libwd、libkaezip软件包。

各软件包提供算法功能请参见安装简介。

  1. 使用SSH远程登录工具，以root账号进入Linux操作系统命令行界面。
  2. 将KAE DEB软件包拷贝到自定义路径下。
  3. 安装加速驱动软件包。

    • 方式一：通过dpkg -i *.deb安装所有KAE DEB软件包。
      1
      dpkg -i *.deb
    • 方式二：如果需要单独安装软件包，请参考以下安装uacce-1.3.1软件包示例进行安装。
      1
2
      dpkg -i uacce-1.3.1-1.ubuntu18.04.arm64.deb
uacce modules installed

      依次安装hisi_zip驱动软件包和libwd，libkaezip引擎软件包。安装libkaezip引擎软件包时需要先安装libwd软件包。

  4. 查看DEB软件是否已正常安装到系统内。

    1. 查看uacce是否已安装。
      1
      dpkg -L uacce

      回显结果如下。

      1
2
3
4
5
6
7
      /.
/lib
/lib/modules
/lib/modules/4.15.0-70-generic
/lib/modules/4.15.0-70-generic/extra
/lib/modules/4.15.0-70-generic/extra/uacce.ko
/lib/modules/4.15.0-70-generic/extra/hisi_qm.ko
    2. 查看hisi-zip是否已安装。
      1
      dpkg -L hisi-zip

      回显结果如下。

      1
2
3
4
5
6
7
8
9
      /. 
/lib 
/lib/modules 
/lib/modules/4.15.0-70-generic 
/lib/modules/4.15.0-70-generic/extra 
/lib/modules/4.15.0-70-generic/extra/hisi_zip.ko 
/etc 
/etc/modprobe.d 
/etc/modprobe.d/hisi_zip.conf
    3. 查看安装目录下是否生成对应模块。
      1
      ls -al /lib/modules/`uname -r`/extra

      回显结果如下。

      1
2
3
4
5
      total 348 
drwxr-xr-x 2 root root  4096 Apr 15 17:12 . 
drwxr-xr-x 6 root root  4096 Apr 15 17:12 .. 
-rw-r--r-- 1 root root 42600 Apr 15 09:15 hisi_zip.ko 
-rw-r--r-- 1 root root 40408 Apr 15 09:15 uacce.ko
    4. 在“/etc/modprobe.d/”目录下查看是否生成对应的配置文件。
      1
      ls -al /etc/modprobe.d/

      回显结果如下。

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
      total 52
drwxr-xr-x  2 root root 4096 Apr 15 17:12 .
drwxr-xr-x 94 root root 4096 Apr 15 09:15 ..
-rw-r--r--  1 root root  325 Jan 28  2018 blacklist-ath_pci.conf
-rw-r--r--  1 root root 1667 Nov 13  2018 blacklist.conf
-rw-r--r--  1 root root  210 Jan 28  2018 blacklist-firewire.conf
-rw-r--r--  1 root root  697 Jan 28  2018 blacklist-framebuffer.conf
-rw-r--r--  1 root root  583 Jan 28  2018 blacklist-rare-network.conf
-rw-r--r--  1 root root   44 Apr 15 09:15 hisi_zip.conf
-rw-r--r--  1 root root  347 Jan 28  2018 iwlwifi.conf
-rw-r--r--  1 root root  379 Jul  2  2018 mdadm.conf

  5. 加载加速器驱动到内核。

    • 方式一：重启系统加载。
    • 方式二：通过命令行手动依次加载，并查看是否加载成功。
      1. 查询已载入内核的驱动模块。
        1
        lsmod | grep uacce

        若没有任何回显内容则执行5.b~5.c将相应的模块加载到内核。

      2. 加载uacce驱动。
        1
        modprobe uacce
      3. 加载hisi_zip驱动，将根据“/etc/modprobe.d/hisi_zip.conf”下的配置文件加载到内核。
        1
        modprobe hisi_zip
      4. 再次查询已载入内核的驱动模块。
        1
2
        lsmod | grep uacce
lsmod | grep hisi_qm
        两次查询分别显示如下信息则表示加载成功。
        1
        uacce                  28672  1 hisi_qm

        1
2
        hisi_qm               65536  4 hisi_zip
uacce                  28672  1 hisi_qm

安装后检查

  1. 查看KAE DEB软件包。

    1
    dpkg -s uacce  hisi-zip
    查询结果如下显示。
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
    Package: uacce
Status: install ok installed
Priority: optional
Section: utils
Installed-Size: 512
Maintainer: HiSilicon Tech. Co., Ltd.
Architecture: arm64
Version: 1.3.1
Description: This package contains the Unified/User-space-access-intended Accelerator Framework.
URL: https://support.huawei.com 
 
Package: hisi-zip
Status: install ok installed
Priority: optional
Section: utils
Installed-Size: 512
Maintainer: HiSilicon Tech. Co., Ltd.
Architecture: arm64
Version: 1.3.1
Description: This package contains the Huawei Hisilicon ZIP Accelerator Driver.
URL: https://support.huawei.com

  2. 查看“/sys/”目录下对应的加速器设备。

    1
    ls -al /sys/class/uacce/
    查询结果如下显示。
    1
2
3
4
5
    total 0
drwxr-xr-x  2 root root 0 Apr    15 17:42 .
drwxr-xr-x 65 root root 0 Apr    15 16:49 ..
lrwxrwxrwx  1 root root 0 Apr    15 17:42 hisi_zip-6 -> ../../devices/pci0000:74/0000:74:00.0/0000:75:00.0/uacce/hisi_zip-6
lrwxrwxrwx  1 root root 0 Apr  15 17:42 hisi_zip-7 -> ../../devices/pci0000:b4/0000:b4:00.0/0000:b5:00.0/uacce/hisi_zip-7

  3. 查看zlib库加速引擎是否生效。

    通过ldd命令查看zlib加速库是否链接到libwd和libkaezip。
    1
    ldd /usr/local/kaezip/lib/libz.so.1.2.11
    如果显示如下返回信息，说明zlib加速库安装成功。同样的，用户目标进程也可以通过ldd命令查看是否使用libwd和libkaezip。
    1
2
3
4
5
            linux-vdso.so.1 =>  (0x0000ffff80280000)
        libc.so.6 => /lib64/libc.so.6 (0x0000ffff80080000)
        libwd.so.1 => /lib64/libwd.so.1 (0x0000ffff80040000)
        /lib/ld-linux-aarch64.so.1 (0x0000ffff80290000)
        libkaezip.so => /usr/local/kaezip/lib/libkaezip.so (0x0000ffff80830000)

父主题： 安装KAE