安装 NPU 驱动
完成 MUSA 安装后，安装 NPU 驱动以启用神经网络加速功能。
前提条件
- ✅ 已完成 MUSA 安装
- ✅ 系统可正常启动
- ✅ 网络连接正常
步骤 1：安装 NPU Unify 驱动
本节介绍如何安装 NPU Unify 驱动。
解压并安装
# 解压 all_deb 包
tar -xvf all_deb.tar
# 进入目录
cd all_deb
# 更新包列表
sudo apt update
# 安装所有 deb 包
sudo apt install -y ./*.deb --allow-downgrades
安装内容
下表列出 NPU 安装包含的软件包。
| 包名 | 说明 |
|---|---|
kernel-module-m1000-npu | NPU 内核驱动 |
m1000-mtnn-unify-lib | NPU 统一库 |
m1000-mtnnrt | NPU 运行时库 |
m1000-mtc-toolkit | NPU 工具包 |
步骤 2：验证安装
# 验证 NPU 驱动
sudo dpkg -s kernel-module-m1000-npu
# 验证 NPU 库
sudo dpkg -s m1000-mtnn-unify-lib
sudo dpkg -s m1000-mtnnrt
# 验证工具包
sudo dpkg -s m1000-mtc-toolkit
预期输出：
Package: kernel-module-m1000-npu
Status: install ok installed
Priority: optional
Section: base
Installed-Size: 8775
Maintainer: Soc-SW-Team
Architecture: all
Version: 1.5-r20251223061609-8cc96d8
Description: mtnn unify driver
mtnn unify driver
Package: m1000-mtnn-unify-lib
Status: install ok installed
Priority: optional
Section: base
Installed-Size: 48615
Maintainer: Soc-SW-Team
Architecture: all
Version: 1.5-r20251211101745-cca46b8
Replaces: m1000-mtnnlite-lib
Depends: kernel-module-m1000-npu (>= 1.3), libc6 (>= 2.35)
Description: mtnn unify lib
mtnn unify lib
Package: m1000-mtnnrt
Status: install ok installed
Priority: optional
Section: base
Installed-Size: 50801
Maintainer: Soc-SW-Team
Architecture: all
Version: 1.5-r20251211101900-f5a4ba5
Depends: m1000-mtnn-unify-lib (>= 1.1), libc6 (>= 2.35)
Description: mtnn runtime lib
mtnn runtime lib
Package: m1000-mtc-toolkit
Status: install ok installed
Priority: optional
Section: base
Installed-Size: 1313026
Maintainer: MT Software System Team <meta-maintainer@mthreads.com>
Architecture: arm64
Version: 1.5-r20251211102012-5aaa237ba
Description: MTC Toolkit
步骤 3：验证 ALSA 配置
# 验证音频配置
sudo dpkg -s alsa-ucm-conf
预期输出：
Package: alsa-ucm-conf
Status: install ok installed
Priority: optional
Section: base
Installed-Size: 963
Maintainer: MT Software System Team <meta-maintainer@mthreads.com>
Architecture: all
Version: 1.2.6.3-1ubuntu2-r20250717100741+45a6512
Description: ALSA Use Case Manager configuration
This package contains ALSA Use Case Manager configuration of audio
input/output names and routing for specific audio hardware. They can be
used with alsaucm tool.
Homepage: https://alsa-project.org
常见问题
Q1: aburn 无法识别设备
确保：
- 设备已进入烧录模式（S1+S3 组合键）
- USB 驱动已正确安装（设备管理器显示 "Apollo update"）
- 使用 Type-C 数据线（非仅充电线）
Q2: 烧录后无法启动
检查：
- 固件是否已签名
- 分区是否正确
- 存储介质是否损坏
Q3: DDK 驱动安装失败
排查：
- 内核头文件是否安装：
dpkg -l | grep linux-headers - 架构是否匹配：
file /lib/modules/$(uname -r)/build
Q4: MUSA 工具无法运行
解决：
# 检查环境变量
echo $PATH
echo $LD_LIBRARY_PATH
# 添加必要路径
export PATH=/usr/local/musa/bin:${PATH}
export LD_LIBRARY_PATH=/usr/local/musa/lib:/usr/lib/aarch64-linux-gnu/musa/:${LD_LIBRARY_PATH}
完成所有步骤后，你的 MTT E300 系统已完全配置：
- ✅ 定制固件和内核
- ✅ 定制根文件系统
- ✅ MUSA
GPU驱动和SDK - ✅ NPU 驱动和工具
