MUSA 安装

概述

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

---

支持的硬件平台

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

设备型号

平台	型号
MTT E300	E300

操作系统

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

---

软件包下载

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

软件包

包	驱动包
musa	musa_5.3.0-M1000_arm64.deb
musa-sdk	musa-sdk_5.2.2_arm64.deb

---

卸载旧版本（可选）

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

---

安装

命令行安装

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

# musa-sdk
sudo dpkg -i musa-sdk_5.2.2_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"

方式一示例输出：

[    3.316228] MTGPU Driver Version: 2d65012-dirty release build for Desktop

方式二命令：

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

方式二示例输出：

[    3.316228] kernel: MTGPU Driver Version: 2d65012-dirty release build for Desktop

更多详情，参见 Linux Driver 文档

---

步骤 2：验证 MUSA SDK 安装

验证 MUSA Toolkit 是否安装成功：

命令：

musa_version_query

完整输出（附录）：

展开查看 musa_version_query 完整示例输出

musa_toolkits:
{
    "version":    "5.2.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260602_master",
    "commit id":    "8c44cbed02a79be2066f1f62bdca039177f71d51",
    "commit date":    "2026-06-02 16:29:39 +0800"
}
mccl:
{
    "version":    "2.4.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0_s4000",
    "git tag":    "No tag",
    "commit id":    "f80a3d0baf5f345d5a839abc320a1f037962d604",
    "commit date":    "2026-07-02 19:06:07 +0800"
}
mcc:
{
    "version":    "5.2.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "d540ad42622dd6b082003fda9b3673815be8a53c",
    "commit date":    "2026-09-20 17:58:31 +0800"
}
mtjpeg:
{
    "version":    "1.0.5",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "a9067e05bc481d7c5537fb0aacc37741debe043b",
    "commit date":    "2026-06-06 13:07:55 +0800"
}
mualg:
{
    "version":    "1.17.2",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "64ddc804d6f4392fb1527f253c1b5cb27da9a97f",
    "commit date":    "2026-06-09 10:56:22 +0800"
}
mublasLt:
{
    "version":    "1.13.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260630_release_musa_5.2.0",
    "commit id":    "05024b470c2b8965214b39f74f26c4628b2476f7",
    "commit date":    "2026-06-12 17:38:48 +0800"
}
mublas:
{
    "version":    "1.13.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "55b7d8679a6569259ad8c578106dc7334b1d44e8",
    "commit date":    "2026-08-08 15:04:51 +0800"
}
mudnn:
{
    "version":    "3.4.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "39c98c2fe14f8608c0c05aedc96a0b2fa8ed887a",
    "commit date":    "2026-09-07 13:32:23 +0800"
}
mufft:
{
    "version":    "1.12.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260430_develop",
    "commit id":    "4b628d8d0c8c2567fcf58fe3e69257a480d265b5",
    "commit date":    "2026-04-30 10:51:14 +0800"
}
mupp:
{
    "version":    "1.13.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260630_release_musa_5.2.0",
    "commit id":    "a6ec2ec756c6c056b136d3e697d1fff69c425e5b",
    "commit date":    "2026-06-12 17:23:18 +0800"
}
MUPTI:
{
    "version":    "1.3.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "5323b0b50e2cce79f3f78329a8d4f2a6e11f92bb",
    "commit date":    "2026-07-31 14:02:24 +0800"
}
murand:
{
    "version":    "1.3.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260325_develop",
    "commit id":    "fb83ce7572d6377862849d9b8a932a93684bb363",
    "commit date":    "2026-03-24 19:22:09 +0800"
}
musify:
{
    "version":    "1.3.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260612_master",
    "commit id":    "4cf23971a3d075d8c45602bbd240b02881685cf5",
    "commit date":    "2026-06-12 10:11:24 +0800"
}
musolver:
{
    "version":    "1.6.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "20260528_develop",
    "commit id":    "7841b55db3cf9e2fb2a4d2a79637de860d36b704",
    "commit date":    "2026-05-28 16:13:03 +0800"
}
musparse:
{
    "version":    "1.7.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "c8d3a3543c00ecb3677e823000df847665f65b1b",
    "commit date":    "2026-07-06 09:53:15 +0800"
}
muthrust:
{
    "version":    "1.17.2",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "b106727500b47661cf611e4a7b1a1cd8a8a5ac0d",
    "commit date":    "2026-06-30 21:27:28 +0800"
}
musa_runtime:
{
    "version":    "5.2.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "c92b4e82ce65993b9b996b20eb33b1ffd3185dbd",
    "commit date":    "2026-06-25 10:33:44 +0800"
}

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

命令：

musaInfo

示例输出：

展开查看 musaInfo 完整示例输出

compiler: mcc
--------------------------------------------------------------------------------
device#                          0
Name:                            M1000
Driver Version:                  5.3
Runtime Version:                 5.2
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:                  14.98 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:                   14.98 GB
memInfo.free:                    12.76 GB (85%)

验证 muDNN：

命令：

mudnn_version

示例输出：

mudnn:
{
    "version":    "3.4.0",
    "git branch":    "release_musa_5.2.0",
    "git tag":    "No tag",
    "commit id":    "39c98c2fe14f8608c0c05aedc96a0b2fa8ed887a",
    "commit date":    "2026-09-07 13:32:23 +0800"
}

验证 mccl：

命令：

mccl_version

示例输出：

mccl:
{
    "version":    "2.4.0",
    "build archs":    "22",
    "git branch":    "release_musa_5.2.0_s4000",
    "git tag":    "No tag",
    "commit id":    "f80a3d0baf5f345d5a839abc320a1f037962d604",
    "commit date":    "2026-07-02 19:06:07 +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