跳到主要内容

openEuler/Kylin V10驱动安装与卸载

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

3.3.1. 安装前准备​

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

  1. 下载驱动安装包。
 1. 登录[后摩开发者社区](https://developer.houmoai.com/resources_v2) 。

 2. 在 **请先选择板级类别** 下拉列表中选择使用的后摩板级产品。

 3. 在版本列表中选择下载的版本号，再在 **AI模型类别筛选器** 、**平台架构筛选器** 、**操作系统筛选器** 下拉菜单中分别选择AI模型类型、平台架构和操作系统，找到资源名为**芯片驱动** 的下载资源，选中该资源左边复选框。

 4. 点击 **直接下载** 、**wget链接** 、**批量直接下载** 或 **wget批量下载** 按钮，下载驱动安装包。

  1. 检测环境依赖。

  2. 非首次安装：卸载老版本驱动。

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

    1. 安装依赖工具。
sudo dnf update -y && sudo dnf install -y \
    python3 \
    python3-libs \
    python3-devel \
    gcc \
    gcc-c++ \
    curl
 2. 安装并初始化 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
 3. 配置镜像源并安装核心依赖。
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. 安装驱动​

详细步骤如下：

警告

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

  1. 完成 安装前准备。

  2. 在驱动软件包所在路径下，运行下面指令安装驱动：

警告

 * 安装过程中，请勿对主机和设备进行复位或下电操作，否则会导致安装失败。

 * 安装过程中，禁止使用Ctrl+C中断安装进程，否则再次安装驱动时可能会失败。如果因此导致安装失败，请联系后摩智能工程师。

 * 需要使用sudo或以root用户身份安装驱动。
sudo yum install houmo-drv-<target_hw>-<release>-1.$arch.rpm
  1. （可选）如果安装过程中提示缺少内核头文件，可根据日志安装内核开发包，示例如下：
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
  1. 检测驱动是否安装成功。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