常见问题（FAQ）
环境与设备检查
如何查看内存 / 显存占用？
建议优先使用 free -g 查看系统统一内存占用：
free -g
也可以使用 musaInfo 查看 MUSA 设备侧信息：
musaInfo
M1000 采用 SoC 统一内存形态，free 展示的是系统统一内存视角，musaInfo 或 mthreads-smi 展示的是 MUSA 设备侧视角。排查模型加载和推理峰值时，建议分别记录模型启动前、模型加载后和请求执行期间的内存变化。
CreatePlatform failed!
执行 MUSA 相关命令时报 CreatePlatform failed! 时，按以下顺序检查：
- 使用 root 或 sudo 权限确认
musaInfo是否正常：
sudo musaInfo
- 将当前用户加入
render和video用户组：
sudo usermod -aG render,video $USER
-
重新登录或重启设备后再次验证。
-
如果仍然报错，设备可能需要连接显示器并进入桌面环境。
找不到 musaInfo
先补充 MUSA 的可执行文件和库路径：
export PATH=/usr/local/musa/bin:${PATH}
export LD_LIBRARY_PATH=/usr/local/musa/lib:${LD_LIBRARY_PATH}
如果补充路径后仍然找不到 musaInfo，通常说明 musa-sdk 没有正确安装。可以先清理旧目录：
sudo rm -rf /usr/local/musa*
然后按照“环境准备与部署”章节重新安装 musa-sdk。
MUSA 初始化失败
常见报错包括：
RuntimeError: MUSA error: initialization error
RuntimeError: MUSA driver initialization failed, you might not have a Mthreads GPU
处理方式：
- 确认当前用户已加入
render和video用户组：
sudo usermod -aG render,video $USER
-
重新登录或重启设备。
-
如果设备带桌面环境，连接显示器并解锁桌面；在安全策略允许时，可以在系统设置中开启自动登录。
