MUSA 安装

概述

本指南涵盖 Linux Driver 和 MUSA SDK 在 MTT E300 的完整安装流程。

---

支持的硬件平台

本节列出 MUSA 安装支持的硬件平台。

设备型号

平台	型号
MTT E300	E300

操作系统

包管理	操作系统	版本
deb	Ubuntu	22.04
deb	AIOS	1.4.0

---

软件包下载

具体软件包下载信息如下所示：

软件包

包	驱动包
musa	musa_5.1.1-M1000_arm64.deb
musa-sdk	musa-sdk_5.1.1-M1000_arm64.deb

---

卸载旧版本（可选）

sudo dpkg -P musa musa-sdk
sudo rm -rf /usr/local/musa

---

安装

命令行安装

# musa
sudo dpkg -i musa_5.1.1-M1000_arm64.deb

# musa-sdk
sudo dpkg -i musa-sdk_5.1.1-M1000_arm64.deb

# 添加用户组
sudo usermod -aG render ${USER}
sudo usermod -aG video ${USER}

# 当前 shell 添加 MUSA envs（临时生效）
export PATH=/usr/local/musa/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/musa/lib:$LD_LIBRARY_PATH

# 永久生效（写入 ~/.bashrc）
echo 'export PATH=/usr/local/musa/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/musa/lib:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

安装后，重启操作系统使驱动加载：

sudo reboot

---

验证安装

步骤 1：验证 Linux Driver 安装

查看驱动模块是否加载：

命令：

lsmod | grep mtgpu

示例输出：

mtgpu                4579328  59
mt_ion                 49152  1 mtgpu
mdev                   24576  1 mtgpu
drm_display_helper    180224  2 mtgpu,mtdisp
drm_kms_helper        217088  5 mtgpu,drm_display_helper,mtdisp
drm                   643072  33 mtgpu,i2c_hid,drm_kms_helper,drm_display_helper,mtdisp

查看 Linux Driver 版本信息：

方式一命令：

dmesg | grep "Driver Version"

方式一示例输出：

[    5.321818] MTGPU Driver Version: fff6a5a-dirty release build for Desktop

方式二命令：

sudo cat /var/log/dmesg | grep "Driver Version"

方式二示例输出：

[    5.321818] kernel: MTGPU Driver Version: fff6a5a-dirty release build for Desktop

更多详情，参见 Linux Driver 文档

---

步骤 2：验证 MUSA SDK 安装

验证 MUSA Toolkit 是否安装成功：

命令：

musa_version_query

完整输出（附录）：

展开查看 musa_version_query 完整示例输出

musa_toolkits:
{
        "version":      "5.1.0",
        "git branch":   "HEAD",
        "git tag":      "AIMODULE_1.4.1",
        "commit id":    "e1481406739bd545c45c4b852450a81ac5feee6c",
        "commit date":  "2026-03-06 20:38:51 +0800"
}
CUB:
{
        "version":      "1.17.2",
        "git branch":   "HEAD",
        "git tag":      "No tag",
        "commit id":    "2aa7e2b6a2e82ca339ca132d345377d6faef6024",
        "commit date":  "2026-04-22 21:48:03 +0800"
}
mccl:
{
        "version":      "2.1.3",
        "build archs":  "22",
        "git branch":   "develop_qy2",
        "git tag":      "No tag",
        "commit id":    "f13ff3006e6f7fa7e70064fc989364661b3ad9d2",
        "commit date":  "2026-04-15 10:49:18 +0800"
}
mcc:
{
        "version":      "3.1.0",
        "git branch":   "release_M1000_1.3.0",
        "git tag":      "No tag",
        "commit id":    "d09fc6f38f4fb9dfa6d5ec58c730ec41e825bbc1",
        "commit date":  "2025-11-27 16:58:58 +0800"
}
mtjpeg:
{
        "version":      "1.0.5",
        "git branch":   "release_musa_5.1.0",
        "git tag":      "No tag",
        "commit id":    "070f3ff97088cfdef12da04b09af22bfc862874c",
        "commit date":  "2026-03-23 13:40:41 +0800"
}
mublasLt:
{
        "version":      "1.12.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "b99c7919a587a92ec1f24b75a633d18da754377b",
        "commit date":  "2026-04-07 14:08:36 +0800"
}
mublas:
{
        "version":      "1.12.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "4bced69bfb393863c43c23e9d21fbce6e2ff9ffd",
        "commit date":  "2026-04-23 19:16:27 +0800"
}
mudnn:
{
        "version":      "3.3.0",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "bd105d42d4413d10f51cf91785cf4e06acee30ac",
        "commit date":  "2026-04-26 17:03:03 +0800"
}
mufft:
{
        "version":      "1.12.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "0a2e9ac103e2d54c384947561076c682c6811c1e",
        "commit date":  "2026-03-11 19:24:16 +0800"
}
muPP:
{
        "version":      "1.13.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "0a8b4f2b1c8f9928130fa882a97705be2fc693e2",
        "commit date":  "2026-03-12 14:48:07 +0800"
}
MUPTI:
{
        "version":      "1.2.0",
        "git branch":   "HEAD",
        "git tag":      "AIMODULE_1.4.1",
        "commit id":    "453615f9e030b4c0bd101ce44d60346a1ffee11b",
        "commit date":  "2026-04-28 12:40:08 +0800"
}
murand:
{
        "version":      "1.3.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "525224ed521b4cb0af25ada59b84583241e57761",
        "commit date":  "2026-03-27 19:58:21 +0800"
}
musify:
{
        "version":      "1.2.0",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "a5f79eb9e507dd7bfa1b5bd8b6b833f671c6b8c1",
        "commit date":  "2026-04-08 14:58:40 +0800"
}
musolver:
{
        "version":      "1.6.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "f6062eb2da90ad3b5091a91d3348423649275d12",
        "commit date":  "2026-04-25 19:06:04 +0800"
}
musparse:
{
        "version":      "1.7.0",
        "build archs":  "22",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "3b5df2ca75c504c98821bc2cd71a9160ddf4eb55",
        "commit date":  "2026-04-27 17:08:43 +0800"
}
Thrust:
{
        "version":      "1.17.2",
        "git branch":   "HEAD",
        "git tag":      "AIMODULE_1.4.0",
        "commit id":    "bffd03bde9af75266cc1a51d46cde48f4bcd9280",
        "commit date":  "2026-04-22 21:51:23 +0800"
}
musa_runtime:
{
        "version":      "5.1.0",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "3b6956c97bc055afffd676cb4c30c33347de9a9b",
        "commit date":  "2026-04-24 15:53:42 +0800"
}

验证 MUSA Toolkit 能否正常调用（以下为 64G 设备示例输出）：

命令：

musaInfo

示例输出：

展开查看 musaInfo 完整示例输出

compiler: mcc
--------------------------------------------------------------------------------
device#                          0
Name:                            M1000
Driver Version:                  5.1
Runtime Version:                 5.1
compute capability:              2.2
pciBusID:                        0x0
pciDeviceID:                     0x0
pciDomainID:                     0x0
multiProcessorCount:             8
maxThreadsPerMultiProcessor:     6144
isMultiGpuBoard:                 1
clockRate:                       0 Mhz
memoryClockRate:                 0 Mhz
memoryBusWidth:                  384
totalGlobalMem:                  62.02 GB
sharedMemPerMultiprocessor:      72.00 KB
totalConstMem:                   8192
sharedMemPerBlock:               72.00 KB
canMapHostMemory:                1
regsPerBlock:                    131072
warpSize:                        128
l2CacheSize:                     0
computeMode:                     0
maxThreadsPerBlock:              1024
maxThreadsDim.x:                 1024
maxThreadsDim.y:                 1024
maxThreadsDim.z:                 1024
maxGridSize.x:                   2147483647
maxGridSize.y:                   2147483647
maxGridSize.z:                   2147483647
concurrentKernels:               1
cooperativeLaunch:               1
cooperativeMultiDeviceLaunch:    0
isIntegrated:                    1
maxTexture1D:                    32768
maxTexture2D.width:              32768
maxTexture2D.height:             32768
maxTexture3D.width:              16384
maxTexture3D.height:             16384
maxTexture3D.depth:              2048
peers:
non-peers:                       device#0
memInfo.total:                   62.02 GB
memInfo.free:                    53.40 GB (86%)

验证 muDNN：

命令：

mudnn_version

示例输出：

mudnn:
{
        "version":      "3.3.0",
        "git branch":   "HEAD",
        "git tag":      "20260430_release_musa_5.1.0",
        "commit id":    "bd105d42d4413d10f51cf91785cf4e06acee30ac",
        "commit date":  "2026-04-26 17:03:03 +0800"
}

验证 mccl：

命令：

mccl_version

示例输出：

mccl:
{
        "version":      "2.1.3",
        "build archs":  "22",
        "git branch":   "develop_qy2",
        "git tag":      "No tag",
        "commit id":    "f13ff3006e6f7fa7e70064fc989364661b3ad9d2",
        "commit date":  "2026-04-15 10:49:18 +0800"
}

更多详情，参见 MUSA SDK 文档。

---

开启compute_only，关闭桌面（提高推理性能可选）

当设备用于推理任务时，可开启 compute_only 并关闭桌面服务，以减少图形显示相关资源占用。

操作步骤

1. 新建脚本 enable_compute_only.sh：

#!/usr/bin/env bash
set -euo pipefail

usage() {
  cat <<'EOF'
用法:
  sudo ./enable_compute_only.sh enable
  sudo ./enable_compute_only.sh disable
EOF
  exit 1
}

if [[ "${EUID}" -ne 0 ]]; then
  echo "请使用 sudo 运行该脚本"
  exit 1
fi

ACTION="${1:-}"
if [[ -z "${ACTION}" ]]; then
  usage
fi

case "${ACTION}" in
  enable)
    echo "[1/7] 写入 /etc/modprobe.d/mtgpu.conf"
    echo "options mtgpu mtgpu_drm_major=2 compute_only=1" > /etc/modprobe.d/mtgpu.conf

    echo "[2/7] 更新 initramfs"
    update-initramfs -u

    echo "[3/7] 禁用 gdm3"
    systemctl disable gdm3

    echo "[4/7] 停止 gdm3"
    systemctl stop gdm3

    echo "[5/7] 检查 xorg 进程"
    if pgrep -fa xorg >/dev/null; then
      echo "检测到 xorg 进程仍在运行，请先确认并停止后再重试："
      pgrep -fa xorg || true
      exit 1
    fi

    echo "xorg 进程检查通过（无 xorg 进程）"

    echo "[6/7] 重启设备前提示"
    echo "reboot 完成后，请执行以下命令检查："
    echo "  cat /sys/module/mtgpu/parameters/compute_only"
    echo "期望结果："
    echo "  - /sys/module/mtgpu/parameters/compute_only 输出为: 1"

    echo "[7/7] 重启设备"
    reboot
    ;;

  disable)
    echo "[1/5] 写入 /etc/modprobe.d/mtgpu.conf"
    echo "options mtgpu mtgpu_drm_major=2" > /etc/modprobe.d/mtgpu.conf

    echo "[2/5] 更新 initramfs"
    update-initramfs -u

    echo "[3/5] 配置 display-manager.service 指向 gdm.service"
    ln -sfn /lib/systemd/system/gdm.service /etc/systemd/system/display-manager.service

    echo "[4/5] 重载 systemd 并启动 display-manager.service"
    systemctl daemon-reload
    systemctl start display-manager.service

    echo "[5/5] 重启设备前提示"
    echo "reboot 完成后，请执行以下命令检查："
    echo "  cat /sys/module/mtgpu/parameters/compute_only"
    echo "期望结果："
    echo "  - /sys/module/mtgpu/parameters/compute_only 输出为: 0"

    echo "现在重启设备"
    reboot
    ;;

  *)
    usage
    ;;
esac

2. 添加执行权限：

chmod +x enable_compute_only.sh

3. 开启 compute_only（关闭桌面）：

sudo ./enable_compute_only.sh enable

4. 恢复桌面并关闭 compute_only：

sudo ./enable_compute_only.sh disable