Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/hardware_support/hardware_info_cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
| AI 加速芯片 | | 壁仞 | BR100、BR104 | | [源码编译](https://github.com/PaddlePaddle/PaddleCustomDevice/blob/develop/backends/biren_gpu/README_cn.md) |[代码仓库](https://github.com/PaddlePaddle/PaddleCustomDevice) |
| AI 加速芯片 | | 燧原 | 云燧 T20 、i20、S60 | | [源码编译](https://github.com/PaddlePaddle/PaddleCustomDevice/blob/develop/backends/gcu/README_cn.md) |[代码仓库](https://github.com/PaddlePaddle/PaddleCustomDevice) |
| AI 加速芯片 | | 太初 | 元碁系列 | [安装](./sdaa/install_cn.html#wheel) | [源码编译](https://github.com/PaddlePaddle/PaddleCustomDevice/blob/develop/backends/sdaa/README_cn.md) |[代码仓库](https://github.com/PaddlePaddle/PaddleCustomDevice) |

| AI 加速芯片 | | 沐曦 | 曦云 C 系列 | [安装](./metax/install_cn.md#wheel) | [源码编译](https://github.com/PaddlePaddle/PaddleCustomDevice/blob/develop/backends/metax_gpu/README_cn.md) |[代码仓库](https://github.com/PaddlePaddle/PaddleCustomDevice) |

## FastDeploy

Expand Down Expand Up @@ -81,7 +81,7 @@
| AI 加速芯片 | 海飞科 | Compass C10 | ✔️ | [模型库](https://github.com/hexaflakeai/model_zoo) |
| AI 加速芯片 | 清微智能 | TX5368 | ✔️ | [模型库](https://github.com/tsingmicro-toolchain/ts.knight-modelzoo) |
| AI 加速芯片 | 爱芯元智 | AX620A | ✔️ | [模型库](https://github.com/AXERA-TECH/ax-samples/tree/main) |
| AI 加速芯片 | 沐曦 | N100 | ✔️ | [模型库](https://github.com/denglin-github/DLPaddleModelZoo) |
| AI 加速芯片 | 沐曦 | N100 | ✔️ | [模型库](https://gitee.com/metax-maca/modelzoo/tree/master/paddlepaddle) |
| AI 加速芯片 | 希姆计算 | STCP920 | ✔️ | [模型库](https://github.com/Stream-Computing/STCPaddleModelZoo) |

## TVM
Expand Down
18 changes: 18 additions & 0 deletions docs/hardware_support/metax/index_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
.. _cn_metax_information:

####################
METAX GPGPU 芯片
####################

沐曦曦云 C 系列芯片是沐曦推出的一款高性能通用人工智能计算芯片,曦云 C 系列通用 GPU(GPGPU)芯片是针对智算及通用计算的完美解决方案,沐曦自主知识产权架构提供强大高精度及多精度混合算力,可广泛应用于智算以及通用计算、教育和科研等场景。`点击这里 <https://www.metax-tech.com/>`_ 。

飞桨框架支持基于沐曦曦云芯片的训练和推理,请参考以下内容快速体验:

- `沐曦 曦云 C 系列 安装说明 <./install_cn.html>`_ : 沐曦 曦云 C 系列 安装说明
- `沐曦 曦云 C 系列 基于框架的使用指南 <./paddle_tutorial_cn.html>`_ : 沐曦 曦云 C 系列 基于框架的使用指南

.. toctree::
:hidden:

install_cn.md
paddle_tutorial_cn.md
60 changes: 60 additions & 0 deletions docs/hardware_support/metax/install_cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@

# 沐曦 曦云 C 系列 安装说明

飞桨框架 MACA 版支持基于沐曦 MACA 软件栈 的训练和推理,提供两种安装方式:

1. 通过飞桨官网发布的 wheel 包安装
2. 通过源代码编译安装得到 wheel 包

## 沐曦 曦云 C 系列 系统要求

| 要求类型 | 要求内容 |
| --------- | -------- |
| 芯片型号 | 沐曦曦云 C 系列芯片,包括 C500 |
| 操作系统 | Linux 操作系统,包括 CentOS、Ubuntu、KylinV10 等 |


## 安装飞桨框架
### 安装方式一:wheel 包安装
沐曦曦云 C500 支持插件式安装,需先安装飞桨 CPU 安装包,再安装飞桨 沐曦 插件包:
```bash
# 先安装飞桨 CPU 安装包
python -m pip install paddlepaddle==3.1.0a0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/
# 再安装飞桨 曦云 C500 插件包
python -m pip install paddle-metax-gpu==3.1.0 -i https://www.paddlepaddle.org.cn/packages/stable/maca/
```

### 安装方式二:源代码编译安装
在启动的 docker 容器中,先安装飞桨 CPU 安装包,再下载 PaddleCustomDevice 源码编译得到飞桨 C500 插件包。

```bash
# 下载 PaddleCustomDevice 源码
git clone https://github.com/PaddlePaddle/PaddleCustomDevice -b release/3.1

# 在 PaddleCUstomDevice 根目录下执行以下指令更新子模块代码
git submodule sync
git submodule update --init --recursive

# 进入硬件后端(沐曦 曦云 C500)目录
cd backends/metax_gpu

# 先安装飞桨 CPU 安装包
python -m pip install paddlepaddle==3.1.0a0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

# 编译安装
bash build_in_metax.sh
# 或者
bash change_patch.sh #只执行一次
bash compile.sh # 可执行多次

# 编译产出在 build/dist 路径下,使用 pip 安装
pip install build/dist/*.whl --force-reinstall

```
## 如何卸载

请使用以下命令卸载 Paddle:

```bash
pip uninstall paddlepaddle paddle-metax-gpu
```
34 changes: 34 additions & 0 deletions docs/hardware_support/metax/paddle_tutorial_cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@


# 沐曦 曦云 C500 基于 PaddlePaddle 框架的使用指南

## 一、环境准备

### 环境说明

* 本教程介绍如何基于沐曦 曦云 C500 进行安装使用

* 考虑到环境差异性,我们推荐使用教程提供的标准镜像完成环境准备:

* x86_64 镜像链接:您可以联系 MetaX 或访问 https://sw-download.metax-tech.com 获取对应的镜像文件。

* 镜像中已经默认安装了沐曦 MACA 软件栈


### 环境安装

1. 安装 PaddlePaddle

*该命令会自动安装飞桨主框架自动构建的 release-3.1-build 版本*

```shell
python -m pip install paddlepaddle==3.1.0a0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/
```

2. 安装 CustomDevice

*该命令会自动安装飞桨 Custom Device 自动构建的 release-3.1-build 版本*

```shell
python -m pip install paddle-metax-gpu==3.1.0 -i https://www.paddlepaddle.org.cn/packages/stable/maca/
```