UOS V2500 沐曦驱动安装手册
·
目录
概述
本手册适用于在 UOS V25 服务器操作系统 上安装和配置 沐曦 C500 AI 加速卡 驱动程序及 SDK 开发环境。
核心功能
| 模块 | 功能说明 |
|---|---|
| 驱动安装 | GPU 驱动安装、DKMS 配置、内核模块管理 |
| SDK 安装 | MACA 开发环境、编译工具链、示例代码 |
| 固件管理 | VBIOS 升级、版本校验、重启生效 |
| 电源管理 | 省电模式配置、性能模式切换 |
| 状态监控 | mx-smi 工具、温度/功耗/负载监控 |
环境准备
基础环境
| 组件 | 规格/版本 |
|---|---|
| 操作系统 | UOS V25 服务器操作系统 |
| 服务器型号 | 浪潮 AI 服务器 (NF5468m6) |
| AI 加速卡 | 沐曦 C500 |
| 驱动版本 | metax-driver-3.7.2.30-rpm-x86_64.run |
| SDK版本 | maca-sdk-3.7.2.0-rpm-x86_64.tar.xz |
驱动下载
- 官方下载中心：沐曦资源中心
- 驱动包名称：
corex-driver-linux64-4.4.0_x86_64_10.2.run、metax-driver-3.7.0.23-rpm-aarch64.run
SDK下载
- 官方下载中心：沐曦资源中心
- 驱动包名称：
maca-sdk-3.7.2.0-rpm-x86_64.tar.xz、maca-sdk-3.7.0.38-rpm-aarch64.tar.xz
驱动安装
步骤 1：赋予执行权限
# X86架构
sudo chmod +x metax-driver-3.7.2.30-rpm-x86_64.run
# aarch64架构
sudo chmod +x metax-driver-3.7.0.23-rpm-aarch64.run
步骤 2：执行安装程序
# X86架构
sudo ./metax-driver-3.7.2.30-rpm-x86_64.run -- --dkms -f
# aarch64架构
sudo ./metax-driver-3.7.0.23-rpm-aarch64.run -- --dkms -f
参数说明
| 参数 | 含义 | 推荐 | 说明 |
|---|---|---|---|
--dkms |
使用 DKMS 动态内核模块支持 | ✅ 推荐 | 内核升级后自动重编译驱动 |
-f |
强制安装（跳过部分检查） | ⚠️ 谨慎 | 仅在确认兼容时使用 |
安装过程预期输出
Loading new metax-linux/3.8.30 DKMS files...
Deprecated feature: CLEAN (/usr/src/metax-linux-3.8.30/dkms.conf)
Building for 6.6.0-25.02.2510.002.yyq.uos25.x86_64
Building initial module metax-linux/3.8.30 for 6.6.0-25.02.2510.002.yyq.uos25.x86_64
Deprecated feature: CLEAN (/var/lib/dkms/metax-linux/3.8.30/source/dkms.conf)
Module signing is disabled by policy, modules won't be signed
Running the pre_build script..... done.
Building module(s).... done.
Running the post_build script... done.
Deprecated feature: CLEAN (/var/lib/dkms/metax-linux/3.8.30/source/dkms.conf)
Installing /lib/modules/6.6.0-25.02.2510.002.yyq.uos25.x86_64/extra/metax.ko.xz
Running the post_install script:
Running depmod.... done.
Executing post-transaction command.......... done.
安装后验证
# 检查驱动模块是否加载
lsmod | grep metax
# 预期输出：metax 模块应在列表中
固件升级
⚠️ 警告：固件升级过程中断电会导致硬件损坏！请确保服务器连接 UPS 或稳定电源。
前置条件检查
| 检查项 | 要求 | 验证命令 |
|---|---|---|
| 业务状态 | 所有 GPU 业务已停止 | mx-smi 查看负载 |
| 驱动状态 | 驱动已卸载 | lsmod | grep metax 无输出 |
| 固件文件 | 已下载到本地 | ls /lib/firmware/metax/mxc500/ |
| 电源状态 | UPS 或稳定供电 | 目视检查 |
步骤 1：升级固件
# X86架构
sudo /opt/mxdriver/bin/mx-smi -u lib/firmware/metax/mxc500/mxvbios-1.33.5.0-1174-C500.bin -t 600
# aarch64架构
sudo /opt/mxdriver/bin/mx-smi -u /lib/firmware/metax/mxc500/mxvbios-1.33.4.0-1141-C500.bin -t 600
参数说明
| 参数 | 含义 | 推荐值 | 备注 |
|---|---|---|---|
-u |
指定固件文件路径 | 必填 | 绝对路径 |
-t |
超时时间（秒） | 600 | 10 分钟，大文件可适当延长 |
预期输出
mx-smi version: 2.3.1
Hint: -u only support upgrading vbios for all devices.
GPU#0 vbios-upgrade Done
Will take effect after reboot or warmreset
步骤 2：重启服务器（必须执行）
sudo reboot
⚠️ 重要：固件升级后必须重启才能使新固件完全生效。
SDK 安装
步骤 1：解压 SDK 包
# x86架构
tar -xvf maca-sdk-3.7.2.0-rpm-x86_64.tar.xz
cd maca-sdk-3.7.2.0
# aarch64架构
tar -xvf maca-sdk-3.7.0.38-rpm-aarch64.tar.xz
cd maca-sdk-3.7.0.38
步骤 2：执行安装脚本
sudo ./mxmaca-sdk-install.sh
步骤 3：验证安装
# 检查 SDK 安装目录
ls /opt/maca/
# 预期目录结构：
# /opt/maca/
# ├── bin/ # 编译工具 (hipcc, hcc 等)
# ├── lib/ # 动态库文件
# ├── lib64/ # 64 位库文件
# ├── include/ # 头文件
# ├── samples/ # 示例代码
# ├── tools/ # 工具链 (性能分析、调试等)
# ├── mxgpu_llvm/ # LLVM 编译后端
# ├── ompi/ # OpenMPI (多卡通信)
# ├── ucx/ # UCX (高性能通信)
# ├── ffmpeg/ # 视频编解码支持
# ├── static-lib/ # 静态库
# ├── wheel/ # Python wheel 包
# ├── etc/ # 配置文件
# ├── share/ # 共享资源
# ├── EULA-zh.txt # 中文许可协议
# ├── EULA-en.txt # 英文许可协议
# └── Version.txt # 版本信息
SDK 环境配置
# 添加环境变量（~/.bashrc 或 /etc/profile）
echo 'export PATH=/opt/maca/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/opt/maca/lib:/opt/maca/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc
验证SDK环境的安装
执行以下命令，检查是否正确安装MXMACA编程环境。
macainfo
如下所示，如果 macainfo 在有曦云系列GPU运行的系统中正常运行，说明MXMACA编程环境安装成功。
======================
MXC System Attributes
======================
Runtime Version: 1.0
System Timestamp Freq: 1000MHz
Signal Max Wait Time: 18446744073709551615(0xffffffffffffffff)
Machine Model: LARGE
System Endianess: LITTLE
验证与测试
开机后验证流程
# 1. 检查驱动模块加载
lsmod | grep metax
# 预期：输出 metax 模块信息
# 2. 查看 GPU 状态（基础检查）
mx-smi
# 预期：正常输出卡型号、显存、温度、负载
# 3. 查看完整版本信息
mx-smi --show-version
# 预期：显示驱动版本、固件版本、序列号等
# 4. 查看升级开关状态
mx-smi misc --show-update-toggle
# 预期：不再报版本不兼容错误
正常输出示例
mx-smi version: 2.3.1
=================== MetaX System Management Interface Log ===================
Timestamp : Tue Jun 9 14:48:40 2026
Attached GPUs : 1
+---------------------------------------------------------------------------------+
| MX-SMI 2.3.1 Kernel Mode Driver Version: 3.8.30 |
| MACA Version: 3.7.2.0 BIOS Version: 1.33.5.0 |
|------------------+-----------------+---------------------+----------------------|
| Board Name | GPU Persist-M | Bus-id | GPU-Util sGPU-M |
| Pwr:Usage/Cap | Temp Perf | Memory-Usage | GPU-State |
|==================+=================+=====================+======================|
| 0 MetaX C500 | 0 Off | 0000:86:00.0 | 0% Disabled |
| 34W / 350W | 41C P0 | 858/65536 MiB | Available |
+------------------+-----------------+---------------------+----------------------+
+---------------------------------------------------------------------------------+
| Process: |
| GPU PID Process Name GPU Memory |
| Usage(MiB) |
|=================================================================================|
| no process found |
+---------------------------------------------------------------------------------+
省电模式配置
默认行为
驱动默认启用省电模式：
- 空闲状态时 GPU 进入低功耗模式
- PCIe link speed 降低至 Gen1（2.5GT/s）
- 唤醒延迟约 100-200ms
关闭省电模式（两种方案）
方案 A：临时关闭（重启失效）
适用于临时测试或调试场景：
sudo rmmod metax
sudo modprobe metax runpm=0
| 步骤 | 命令 | 说明 |
|---|---|---|
| 1. 卸载模块 | sudo rmmod metax |
确保无业务占用 |
| 2. 重新加载 | sudo modprobe metax runpm=0 |
runpm=0 禁用运行时电源管理 |
方案 B：永久关闭（推荐生产环境）
适用于需要持续高性能的业务场景：
echo "options metax runpm=0" | sudo tee /etc/modprobe.d/metax.conf
sudo reboot
配置说明
| 配置项 | 值 | 含义 | 适用场景 |
|---|---|---|---|
runpm |
0 |
禁用运行时电源管理 | 生产环境/高性能需求 |
runpm |
1 |
启用运行时电源管理（默认） | 测试环境/节能需求 |
生效验证
cat /etc/modprobe.d/metax.conf
# 应输出：options metax runpm=0
性能基准测试
# 使用 mx-smi 监控实时状态
watch -n 1 mx-smi
# 查看 PCIe 速度
lspci -vvv -s <GPU_BDF> | grep "LnkSta:"
例如：lspci -vvv -s 86:00.0 | grep -i "lnksta"
# 预期：LnkSta: Speed 16GT/s (downgraded), Width x16
附录
常用命令速查
| 功能 | 命令 | 备注 |
|---|---|---|
| 查看 GPU 状态 | mx-smi |
基础状态 |
| 查看版本信息 | mx-smi --show-version |
驱动 + 固件版本 |
| 查看温度 | mx-smi --query-gpu=temperature.gpu |
单位°C |
| 查看显存使用 | mx-smi --query-gpu=memory.used |
单位 MB |
| 查看功耗 | mx-smi --query-gpu=power.draw |
单位 W |
| 查看 PCIe 速度 | lspci -vvv -s <GPU_BDF> |
查看 LnkSta 字段 |
| 卸载驱动 | sudo rmmod metax |
需先停止业务 |
| 加载驱动 | sudo modprobe metax |
重启后可自动加载 |
| 查看驱动日志 | dmesg | grep metax |
排查驱动问题 |
| 重启服务 | sudo systemctl restart metax-driver |
部分版本支持 |
目录结构
| 路径 | 内容 |
|---|---|
/opt/mxdriver/ |
驱动程序目录 |
/opt/mxdriver/bin/ |
管理工具（mx-smi 等） |
/lib/firmware/metax/mxc500/ |
固件文件 |
/etc/modprobe.d/metax.conf |
驱动配置文件 |
/opt/maca/ |
SDK 安装目录 |
技术支持
| 渠道 | 链接/联系方式 | 响应时间 |
|---|---|---|
| 官方文档 | 沐曦开发者中心 | 自助 |
| 驱动下载 | https://developer.metax-tech.com/softnova | 自助 |
openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构
更多推荐
4
0- 0
已为社区贡献8条内容
所有评论(0)