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>-1.$arch.rpm
```
（可选）如果安装过程中提示缺少内核头文件，可根据日志安装内核开发包，示例如下：
```
sudo dnf install kernel-devel-6.6.0-72.0.0.76.oe2403sp1.x86_64
```
然后重新执行驱动安装：
```
sudo yum install houmo-drv-<target_hw>-<release>-1.$arch.rpm
```

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

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

hm_smi -a

返回信息示例如下：

--------------------------------------------------------------------------------
  sdk build infos
--------------------------------------------------------------------------------
  Build_Time     : 2026-07-15 09:54:29
  HMSW_Version   : V1.4.0
  HM_SMI_Version : V1.0.0
--------------------------------------------------------------------------------
  Wed Jul 15 13:58:28 CST 2026
--------------------------------------------------------------------------------
  device0 detail infos
--------------------------------------------------------------------------------
  Driver_Version        : V1.4.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        : 1300.0 Mhz
    Lock_Ipu_Pll_Rate   : 1300.0 Mhz
    IPU_Load            : 0.0 %
  Firmware_Version      : V1.4.0
  IPU_Infos             :
    Core_Num            : 2
    Core_Freq           : 1300.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
  DDR_Memory_Infos      :
    DDR_Memory_Free     : 12160.0MB
    DDR_Memory_Total    : 12160.0MB
  Temperature           :
    DDR0                : 25.9 C
    DDR2                : 26.6 C
    DDR4                : 23.6 C
    DDR5                : 24.8 C
    Core0               : 27.2 C
    Core1               : 26.0 C
  Board_Power           : 5.26 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