From 7b5263af899719fdca5de303fb6ff46e3bbc552e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9C=B1=E5=BB=BA?= Date: Wed, 23 Sep 2026 07:29:26 +0000 Subject: [PATCH] update user_manuals/UM_Setup_MUSA_Cross_Compile_Environment.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 朱建 --- ...UM_Setup_MUSA_Cross_Compile_Environment.md | 25 ++++++++++--------- 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/user_manuals/UM_Setup_MUSA_Cross_Compile_Environment.md b/user_manuals/UM_Setup_MUSA_Cross_Compile_Environment.md index e922bb3..fa5ad94 100644 --- a/user_manuals/UM_Setup_MUSA_Cross_Compile_Environment.md +++ b/user_manuals/UM_Setup_MUSA_Cross_Compile_Environment.md @@ -6,13 +6,14 @@ | :--- | :--- | | **ID** | `UM_Setup_MUSA_Cross_Compile_Environment` | | **语言** | `中文 (zh-CN)` | -| **版本** | 1.0.0 | +| **版本** | 1.0.1 | ## 更新日志 | 版本 | 日期 | 变更描述 | | :--- | :--- | :--- | | 1.0.0 | 2025-10-16 | 初始版本，包含MUSA交叉编译环境部署指南。 | +| 1.0.1 | 2026-09-23 | 更新版本，适配AIOS 1.5.0 | --- @@ -21,16 +22,16 @@ 本教程旨在指导开发者在x86 Ubuntu 22.04宿主机上搭建基于MUSA SDK的ARM64交叉编译环境，实现为ARM64平台编译MUSA加速程序。 - **主要目标:** - - 成功部署MUSA交叉编译环境（基于MUSA SDK 4.1.2）。 + - 成功部署MUSA交叉编译环境（基于MUSA SDK 5.1.2）。 - 掌握环境的挂载、进入、退出及卸载方法。 - 学会使用交叉编译环境编译简单的MUSA程序并验证运行效果。 - 了解环境的版本兼容性及常见问题处理方法。 - **适用范围:** - 使用x86 Ubuntu 22.04作为宿主机的开发者。 - E300平台 编译MUSA应用程序的场景。 - - 依赖MUSA SDK 4.1.2进行开发的项目。 + - 依赖MUSA SDK 5.1.2进行开发的项目。 -> **注意**：本环境基于MUSA SDK 4.1.2，不兼容MUSA SDK 3.1.2，编译的程序在MUSA SDK 3.1.2环境中可能无法运行。 +> **注意**：本环境基于MUSA SDK 5.1.2，不兼容MUSA SDK 3.1.2，编译的程序在MUSA SDK 3.1.2环境中可能无法运行。 --- @@ -48,13 +49,13 @@ - [x] 宿主机操作系统为Ubuntu 22.04 x86_64。 - [x] 已配置管理员权限（可使用`sudo`命令）。 - [x] 网络环境通畅，可访问互联网。 - - [x] 目标ARM64开发板已安装MUSA驱动及SDK 4.1.2（版本信息见下文）。 + - [x] 目标ARM64开发板已安装MUSA驱动及SDK 5.1.2（版本信息见下文）。 > **目标平台MUSA环境要求:** > ```bash -> $ dpkg -l |grep musa -> ii musa 3.1.0-AB100 arm64 Moore Threads MUSA driver -> ii musa-sdk 4.1.2 arm64 Moore Threads MTGPU Software Development Kit +> # dpkg -l |grep musa +> ii musa 5.2.1-M1000 arm64 Moore Threads MUSA driver [34b7fa81e] +> ii musa-sdk 5.1.2 arm64 Moore Threads MTGPU Software Development Kit > ``` --- @@ -74,10 +75,10 @@ 2. 下载环境包并解压： ```bash # 下载环境包 - wget https://apollo-appstore-pre.tos-cn-beijing.volces.com/appstore/release/tools/musa-crosscompile-env-v1.0.1.tar.gz + wget https://apollo-appstore-pre.tos-cn-beijing.volces.com/appstore/release/tools/musa-crosscompile-env-v1.0.2.tar.gz # 解压到当前目录 - tar xzf musa-crosscompile-env-v1.0.1.tar.gz + tar xzf musa-crosscompile-env-v1.0.2.tar.gz # 进入环境目录 cd musa-crosscompile-env @@ -197,7 +198,7 @@ arch | 问题描述 | 可能原因 | 解决方案 | | :--- | :--- | :--- | -| **运行程序时提示“libmusart.so.4: cannot open shared object file”** | 目标平台MUSA SDK版本不匹配（如使用3.1.2） | 升级目标平台MUSA SDK至4.1.2版本。 | +| **运行程序时提示“libmusart.so.4: cannot open shared object file”** | 目标平台MUSA SDK版本不匹配（如使用3.1.2） | 升级目标平台MUSA SDK至5.1.2版本。 | | **挂载环境时提示“permission denied”** | 缺少root权限或脚本执行权限 | 1. 确保使用sudo权限；2. 赋予脚本权限：`chmod +x mount.sh`。 | | **chroot环境中无法联网** | 网络配置未继承宿主机 | 1. 重新执行`cp -av /usr/bin/qemu-aarch64-static ./rootfs/usr/bin/`；2. 检查宿主机网络是否正常。 | | **编译时提示“mcc: command not found”** | 环境未正确挂载或MUSA SDK未安装 | 1. 重新挂载环境；2. 检查`/usr/local/musa`目录是否存在。 | @@ -205,7 +206,7 @@ arch ### 5.2 相关资源 -- **[MUSA SDK 4.1.2文档](https://docs.mthreads.com/musa-sdk/4.1.2/)**: 了解MUSA编译器及API使用方法。 +- **[MUSA SDK文档](https://docs.mthreads.com/musa-sdk/version-5.1.0/introduction)**: 了解MUSA编译器及API使用方法。 - **[QEMU用户模式文档](https://www.qemu.org/docs/master/user/main.html)**: 学习qemu模拟ARM64环境的更多配置。 - **[MooreThreads开发者社区](https://developer.mthreads.com/)**: 获取MUSA相关技术支持及资源。 - **[Ubuntu交叉编译指南](https://wiki.ubuntu.com/CrossCompiling)**: 了解Ubuntu平台交叉编译的通用方法。 \ No newline at end of file -- Gitee