3.3. openEuler/Kylin V10驱动安装与卸载

本章节介绍openEuler / Kylin V10操作系统下驱动的安装、卸载及安装后验证流程。

3.3.1. 安装前准备

驱动升级前需要完成下面操作：

下载驱动安装包。
1. 登录后摩开发者社区。
2. 在 请先选择板级类别 下拉列表中选择使用的后摩板级产品。
3. 在版本列表中选择下载的版本号，再在 AI模型类别筛选器 、平台架构筛选器 、操作系统筛选器 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为芯片驱动的下载资源，选中该资源左边复选框。
4. 点击 直接下载、wget链接、批量直接下载 或 wget批量下载 按钮，下载驱动安装包。
检测环境依赖。
卸载老版本驱动。

使用系统主机，需要确保以下依赖已安装：

安装依赖工具。

sudo dnf update -y && sudo dnf install -y \
    python3 \
    python3-libs \
    python3-devel \
    gcc \
    gcc-c++ \
    curl

安装并初始化 pip。

curl -sSL https://bootstrap.pypa.io/get-pip.py -o /tmp/get-pip.py \
&& python3 /tmp/get-pip.py -i https://pypi.tuna.tsinghua.edu.cn/simple \
&& rm /tmp/get-pip.py

配置镜像源并安装核心依赖。

sudo pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple \
    && sudo pip3 install \
        "setuptools>=45.0" \
        "cython>=0.29.0" \
        pyyaml \
        pyserial \
    && sudo pip3 install --no-cache-dir PySide6

3.3.2. 安装驱动

详细步骤如下：

警告

安装驱动前，请确保主机网络连接正常，否则可能导致依赖项下载失败。

完成安装前准备。
在驱动软件包所在路径下，运行下面指令安装驱动：
警告
- 安装过程中，请勿对主机和设备进行复位或下电操作，否则会导致安装失败。
- 安装过程中，禁止使用Ctrl+C中断安装进程，否则再次安装驱动时可能会失败。如果因此导致安装失败，请联系后摩智能工程师。
- 需要使用sudo或以root用户身份安装驱动。
```
sudo yum install houmo-drv-<target_hw>-<release>.${distro}.rpm
```
（可选）如果安装过程中提示缺少内核头文件，可根据日志安装内核开发包，示例如下：
```
sudo dnf install kernel-devel-6.6.0-72.0.0.76.oe2403sp1.x86_64
```
然后重新执行驱动安装：
```
sudo yum install houmo-drv-<target_hw>-<release>.${distro}.rpm
```

检测驱动是否安装成功。SMI工具随驱动一同安装。

在任意路径下，执行下面SMI工具命令查看驱动是否安装成功：

hm_smi -a

返回信息示例如下：

--------------------------------------------------------------------------------
  sdk build infos
--------------------------------------------------------------------------------
  Build_Time     : 2026-05-07 18:52:31
  HMSW_Version   : V1.3.0
  HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
  Sat May 09 15:37:48 CST 2026
--------------------------------------------------------------------------------
  device0 detail infos
--------------------------------------------------------------------------------
  Driver_Version         : V1.3.0
  Vendor                 : Houmo
  BDF                    : 0000:01:00.0
  Dev                    : 0
  Cur_BandWidth          : 8.0 GT/s x 4lane
  Power_Management       :
    DVFS_Mode            : performance
    Cur_Ipu_Freq         : 1400.0 Mhz
    Lock_Ipu_Max_Clock   : 1400.0 Mhz
    Lock_Ipu_Min_Clock   : 700.0 Mhz
    IPU_Load             : 0.0 %
  IPU_Infos              :
    Core_Num             : 2
    Core_Freq            : 1400.0 Mhz
    Voltage              : 750.0 mV
    Core0_Util           : 0.0 %
    Core1_Util           : 0.0 %
    Average_Util         : 0.0 %
  Group_Id               : 0
  Chip_Id                : 0
  SN                     : 0102020100002025003800000059
  PN                     : 100C2010
  Model                  : LQ50-12GB
  Firmware_Version       : V1.3.0
  DDR_Memory_Infos       :
    DDR_Memory_Free      : 12160.0MB
    DDR_Memory_Total     : 12160.0MB
  Temperature            :
    DDR0                 : 19.7 C
    DDR2                 : 20.9 C
    DDR4                 : 17.4 C
    DDR5                 : 18.9 C
    Core0                : 21.2 C
    Core1                : 20.0 C
  Board_Power            : 5.33 W
--------------------------------------------------------------------------------

如果未返回后摩设备信息，则需重启后摩设备，再次使用该命令查看设备状态。

3.3.3. 卸载驱动

执行下面指令在主机端卸载驱动：

注意

卸载驱动过程中，禁止使用Ctrl+C中断卸载进程，否则再次卸载驱动时可能会失败。如果因此导致卸载失败，请联系后摩智能工程师。
需要使用sudo或以root用户身份卸载驱动。

yum list installed | grep houmo-drv-xh2
sudo yum remove houmo-drv-xh2***
sudo rmmod xh2a_drv