From ea781ee5f2d368d6f95f50defda758068a13fbe1 Mon Sep 17 00:00:00 2001
From: Neucrack <CZD666666@gmail.com>
Date: Sat, 30 Mar 2024 17:41:31 +0800
Subject: [PATCH] update doc

---
 .github/workflows/build_maixcam.yml |   2 +-
 README.md                           |  51 ++++----
 README_ZH.md                        | 191 +++++++++++++++++++++++++++-
 docs/pages/index/README.md          |  77 +++++++----
 4 files changed, 265 insertions(+), 56 deletions(-)

diff --git a/.github/workflows/build_maixcam.yml b/.github/workflows/build_maixcam.yml
index bf33e0f9..d3a0099c 100755
--- a/.github/workflows/build_maixcam.yml
+++ b/.github/workflows/build_maixcam.yml
@@ -67,7 +67,7 @@ jobs:
           user_email=`git log -1 --pretty=format:'%ae'`
           echo "== checkout gh-pages branch =="
           cd out
-          cp -r ../.github .
+          cp -r ../../.github .
           git init
           git config user.name ${user_name}
           git config user.email ${user_email}
diff --git a/README.md b/README.md
index 9b6442ec..ed542dcf 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@ MaixPy
 
 <div align="center">
 
-![](./docs/static/image/maixpy_banner.png)
+![](https://wiki.sipeed.com/maixpy/static/image/maixpy_banner.png)
 
 **Let's Sipeed up, Maximize AI's power!**
 
@@ -56,7 +56,8 @@ while 1:
 ```
 
 Result video:
-<video controls autoplay loop muted preload src="./docs/static/video/classifier.mp4" type="video/mp4">
+
+<video controls autoplay loop muted preload src="https://wiki.sipeed.com/maixpy/static/video/classifier.mp4" type="video/mp4">
 Classifier Result video
 </video>
 
@@ -76,7 +77,7 @@ print("received:", serial.read(timeout = 2000))
 
 And we provide new powerful hardware platform **[MaixCAM](https://wiki.sipeed.com/maixcam)**:
 
-![MaixCAM](./docs/static/image/maixcam.png)
+![MaixCAM](https://wiki.sipeed.com/maixpy/static/image/maixcam.png)
 
 | CPU | NPU | Memory |
 | --- | --- | ------- |
@@ -89,7 +90,7 @@ And we provide new powerful hardware platform **[MaixCAM](https://wiki.sipeed.co
 More detalils: [MaixCAM](https://wiki.sipeed.com/maixcam)
 
 > * Big core can choose one of RISC-V and ARM A53.
-> * **Maix-I K210** series is outdated, Not support MaixPy v4, use it please visit **[MaixPy-v1](https://github.com/sipeed/maixpy-v1)**
+> * **Maix-I K210** series is outdated, MaixPy v4 not support it, use it please visit **[MaixPy-v1](https://github.com/sipeed/maixpy-v1)**
 
 
 ## Features
@@ -104,47 +105,30 @@ Python programing, MaixVision IDE, AI vision, video streaming, voice recognize,
 MaixPy not only a Python SDK, but have a whole ecosystem, including hardware, software, tools, docs, even cloud platform etc.
 See the picture below:
 
-![](./docs/static/image/maix_ecosystem.png)
+![](https://wiki.sipeed.com/maixpy/static/image/maix_ecosystem.png)
 
 
 ## Who are using MaixPy?
 
-* **AI programmer** who want to develop your AI model to embedded devices.
+* **AI Algorithm Engineer** who want to deploy your AI model to embedded devices.
 > MaixPy provide easy-to-use API to access NPU, and docs to help you develop your AI model.
-* **STEM** teacher who want to teach AI to students.
+* **STEM** teacher who want to teach AI and embeded to students.
 > MaixPy provide easy-to-use API, PC tools, online AI train service ... Let you focus on teaching AI, not the hardware and complicated software usage.
 * **Maker** who want to make some cool projects but don't want to learn complicated hardware and software.
-> MaixPy provide Python API, so all you need is learn Python, and MaixPy's API is so easy to use, you can make your project even in a few minutes.
+> MaixPy provide Python API, so all you need is learn basic Python syntax, and MaixPy's API is so easy to use, you can make your project even in a few minutes.
 * **Engineer** who want to make some projects but want a prototype as soon as possible.
-> MaixPy is easy to build projects, and provide corresponding C++ sdk, so you can directly use MaixPy to deploy or transfer Python code to C++ in a few minutes.
+> MaixPy is easy to build projects, and provide corresponding C++ SDK, so you can directly use MaixPy to deploy or transfer Python code to C++ in a few minutes.
 * **Students** who want to learn AI, embedded development.
-> We provide many docs and tutorials to help you find learning route, and grow up step by step. From simple Python programming to `Vision`, `AI`, `Audio`, `Linux`, `RTOS` etc.
+> We provide many docs and tutorials, and lot of open source code, to help you find learning route, and grow up step by step. From simple Python programming to `Vision`, `AI`, `Audio`, `Linux`, `RTOS` etc.
 * **Enterprise** who want to develop AI vision products but have no time or engineers to develop complicated embedded system.
 > Use MaixPy even graphic programming to develop your products with no more employees and time. For example, add a AI QA system to your production line, or add a AI security monitor to your office as your demand.
 * **Contestants** who want to win the competition.
-> MaixPy integrate many functions and easy to use, fasten your work to win the competition in limited time.
-
-## Quick start
-
-Please visit [Quick Start doc](https://wiki.sipeed.com/maixpy/doc/en/index.html) to get started.
+> MaixPy integrate many functions and easy to use, fasten your work to win the competition in limited time. There are already many contestants win the competition with MaixPy.
 
-Full Documentation: [wiki.sipeed.com/maixpy/](https://wiki.sipeed.com/maixpy/)
-
-API Documentation: [wiki.sipeed.com/maixpy/api/](https://wiki.sipeed.com/maixpy/api/index.html)
-
-## What difference between MaixPy v1, MaixPy3 and MaixPy v4?
-
-* MaixPy v1 use MicroPython programming language, only support Sipeed Maix-I K210 series hardware, have limited third-party packages.
-* MaixPy3 is designed for Sipeed Maix-II-Dock v831, not a long-term support version.
-* MaixPy v4 use Python programming language, so there's much package we can use directly. MaixPy v4 support new hardware platforms of Sipeed, it's a long-term support version, the future's hardware platforms will support this version. MaixPy v4 have a MaixPy-v1 compatible API, so you can quickly migrate your MaixPy v1 project to MaixPy v4.
-
-(MaixPy v4 Will not support Maix-I K210 series, if you are using Maix-I K210 series, it's recommended to upgrade hardware platform to use this to get more features and better performance.)
 
 ## Performance comparison
 
-And why upgrade from Maix-I K210 or Maix-II v831 ?
-
-K210 and v831 are outdated, K210 have many limitations in memory, performance, NPU operators missing etc.<br>
+K210 and v831 are outdated, they have many limitations in memory, performance, NPU operators missing etc.<br>
 No matter you are using them or new comer, it's recommended to upgrade to MaixCAM and MaixPy v4.<br>
 
 Here's the comparison between them:
@@ -156,6 +140,7 @@ Here's the comparison between them:
 | NPU | 0.25Tops@INT8<br>official says 1T but... | 0.25Tops@INT8 | **1Tops@INT8** |
 | Encoder | ✖ | 1080p@30fps | **2K@30fps** |
 | Screen | 2.4" 320x240 | 1.3" 240x240 | **2.28" 552x368** / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800|
+| TouchScreen | ✖ | ✖ | **2.3" 552x368** |
 | Camera | 30W | 200W | **500W** |
 | WiFi   | 2.4G | 2.4G | **WiFi6** 2.4G/5G |
 | USB    | ✖    | **USB2.0** | **USB2.0** |
@@ -173,6 +158,14 @@ Here's the comparison between them:
 | AI detect   | YOLOv2(224x224) 15fps |  YOLOv2(224x224) 15fps |  **YOLOv5s(224x224) 100fps<br>YOLOv5s(320x256) 70fps<br>YOLOv5s(640x640) 15fps<br>YOLOv8n(640x640) 23fps**|
 | Ease of use     | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
 
+## What difference between MaixPy v1, MaixPy3 and MaixPy v4?
+
+* MaixPy v1 use MicroPython programming language, only support Sipeed Maix-I K210 series hardware, have limited third-party packages.
+* MaixPy3 is designed for Sipeed Maix-II-Dock v831, not a long-term support version.
+* MaixPy v4 use Python programming language, so there's much package we can use directly. MaixPy v4 support new hardware platforms of Sipeed, it's a long-term support version, the future's hardware platforms will support this version. MaixPy v4 have a MaixPy-v1 compatible API, so you can quickly migrate your MaixPy v1 project to MaixPy v4.
+
+(MaixPy v4 Will not support Maix-I K210 series, if you are using Maix-I K210 series, it's recommended to upgrade hardware platform to use this to get more features and better performance.)
+
 ## License
 
 All files in this repository are under the terms of the [Apache License 2.0 Sipeed Ltd.](./LICENSE) except the third-party libraries or have their own license.
diff --git a/README_ZH.md b/README_ZH.md
index 21569df0..15bc51b9 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -1,5 +1,194 @@
-MaixPy v4
+MaixPy
 ======
 
+<div align="center">
+
+![](https://wiki.sipeed.com/maixpy/static/image/maixpy_banner.png)
+
+**Let's Sipeed up, Maximize AI's power!**
+
+**MaixPy**: 快速落地 AI 视觉、听觉应用
+
+<h3>
+    <a href="https://wiki.sipeed.com/maixpy/doc/en/index.html"> 快速开始 </a> |
+    <a href="https://wiki.sipeed.com/maixpy/en/index.html"> 文档 </a> |
+    <a href="https://wiki.sipeed.com/maixpy/api/index.html"> API </a> |
+    <a href="https://wiki.sipeed.com/MaixCAM"> 硬件 </a>
+</h3>
+
+[![GitHub Repo stars](https://img.shields.io/github/stars/sipeed/MaixPy?style=social)](https://github.com/sipeed/MaixPy/stargazers)
+[![Apache 2.0](https://img.shields.io/badge/license-Apache%20v2.0-orange.svg)]("https://github.com/sipeed/MaixPy/blob/main/LICENSE.md)
+[![PyPI](https://img.shields.io/pypi/v/maixpy.svg)](https://pypi.python.org/pypi/maixpy/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/maixpy?label=pypi%20downloads)](https://pypi.org/project/maixpy/)
+![GitHub repo size](https://img.shields.io/github/repo-size/sipeed/maixpy) 
+[![Build MaixCAM](https://github.com/sipeed/MaixPy/actions/workflows/build_maixcam.yml/badge.svg)](https://github.com/sipeed/MaixPy/actions/workflows/build_maixcam.yml)
+[![Trigger wiki](https://github.com/sipeed/MaixPy/actions/workflows/trigger_wiki.yml/badge.svg)](https://github.com/sipeed/MaixPy/actions/workflows/trigger_wiki.yml)
+
 [English](./README.md) | 中文
 
+</div>
+
+
+
+> 新的 MaixPy (v4) 和新的硬件平台 MaixCAM 来了(2024.4)!<br>
+> 如果你有任何建议，请在 [MaixHub](https://maixhub.com/discussion/100073) 上告诉我们，或者 [Telegram/MaixPy](https://t.me/maixpy) 或 QQ 群: 862340358。
+>
+> 点击右上角的 **Star** 让我们知道你喜欢它，以鼓励我们开发更多功能。
+
+## 介绍
+
+使用 MaixPy 轻松创建 **AI 视觉项目**，只需 **10 行代码**:
+
+```python
+from maix import camera, display, image, nn
+
+classifier = nn.Classifier(model="/root/models/mobilenetv2.mud")
+cam = camera.Camera(classifier.input_width(), classifier.input_height(), classifier.input_format())
+dis = display.Display()
+
+while 1:
+    img = cam.read()
+    res = classifier.classify(img)
+    max_idx, max_prob = res[0]
+    msg = f"{max_prob:5.2f}: {classifier.labels[max_idx]}"
+    img.draw_text(10, 10, msg, image.COLOR_RED)
+    dis.show(img)
+```
+
+效果视频:
+
+<video controls autoplay loop muted preload src="https://wiki.sipeed.com/maixpy/static/video/classifier.mp4" type="video/mp4">
+Classifier Result video
+</video>
+
+建议的代码使用串口等 **外设**：
+
+```python
+from maix import uart
+
+ports = uart.list_ports()
+
+serial = uart.UART(ports[0], 115200)
+serial.write_str("hello world")
+print("received:", serial.read(timeout = 2000))
+```
+
+## 硬件平台 MaixCAM
+
+提供性能强劲的硬件平台 **[MaixCAM](https://wiki.sipeed.com/maixcam)**:
+
+![MaixCAM](https://wiki.sipeed.com/maixpy/static/image/maixcam.png)
+
+| CPU | NPU | Memory |
+| --- | --- | ------- |
+| - 1GHz RISC-V(Linux)/ARM A53<br>- 700MHz RISCV-V(RTOS)<br>- 25~300MHz 8051(LowPower) | 1Tops@INT8 NPU, support BF16<br>support YOLOv5 YOLOv8 etc.| 256MB DDR3 |
+
+| Connecting | Peripheral | MultiMedia | Price |
+| ----------- | ----- | --- | ---- |
+|  USB2.0/WiFi6/BLE5.4 | IIC/PWM/SPI/UART/WDT/ADC | - 4M Camera<br>- 2.3" 552x368 Touchscreen<br>- H.264/H.265/MJPEG codec | [￥169/￥249](https://wiki.sipeed.com/store) |
+
+详情看 [MaixCAM](https://wiki.sipeed.com/maixcam)
+
+> * 大核在 RISC-V and ARM A53 二选一。
+> * **Maix-I K210** 已过时，MaixPy v4 不支持它, 仍要使用请访问 **[MaixPy-v1](https://github.com/sipeed/maixpy-v1)**
+
+
+## 特点
+
+Python 编程, MaixVision IDE, AI 视觉, 视频串流, 语音识别, 外设使用 等。
+
+**细节和视频展示** 请访问官网: [wiki.sipeed.com/maixpy/](https://wiki.sipeed.com/maixpy/)
+
+
+## Maix 生态系统
+
+
+MaixPy 不仅仅是一个 Python SDK，还有一个完整的生态系统，包括硬件、软件、工具、文档、甚至云平台等。
+看下面的图片:
+
+![](https://wiki.sipeed.com/maixpy/static/image/maix_ecosystem.png)
+
+
+## 谁在用 MaixPy？
+
+* **AI 算法工程师**： 轻松将你的 AI 模型部署到嵌入式设备。
+> MaixPy 提供了易于使用的 API 来访问 NPU，以及帮助你开发 AI 模型的文档。
+
+* **STEM**：想要教学生 AI 和嵌入式开发的老师。
+> MaixPy 提供了易于使用的 API，PC 工具，在线 AI 训练服务... 让你专注于教授 AI，而不是硬件和复杂的软件使用。
+
+* **创客**: 想要制作一些酷炫的项目，但不想学习复杂的硬件和软件。
+> MaixPy 提供了 Python API，所以你需要做的就是学习基础 Python 语法，而 MaixPy 的 API 非常易于使用，你甚至可以在几分钟内完成你的项目。
+
+* **工程师**: 想要做一些项目，但希望尽快有一个原型。
+> MaixPy 易于构建项目，并提供相应的 C++ SDK，所以你可以直接使用 MaixPy 来部署或在几分钟内将 Python 代码转换为 C++。
+
+* **学生**： 想要学习 AI，嵌入式开发。
+> 我们提供了许多文档和教程，以及大量开源代码，帮助你找到学习路线，并逐步成长。从简单的 Python 编程到视觉，AI，音频，Linux，RTOS等。
+
+* **企业**: 想要开发 AI 视觉产品，但没有时间或工程师来开发复杂的嵌入式系统。
+> 使用 MaixPy 甚至图形编程来开发你的产品，不需要更多的员工和时间。例如，向你的生产线添加一个 AI QA 系统，或者根据你的需求向你的办公室添加一个 AI 安全监控器。
+
+* **竞赛者**: 想要赢得比赛的比赛人们。
+> MaixPy 集成了许多功能，易于使用，加快你作品产出速度，以在有限的时间内赢得比赛，国内常见比赛都有很多同学使用 MaixPy 赢得比赛。
+
+## 性能对比
+
+相比上两代 Maix 系列产品有限的 NPU 算子支持和内存限制，MaixCAM 在保持超高性价比的同时，性能和体验有了很大的提升，强烈建议升级到最新的 MaixCAM 以及 MaixPy v4。
+
+| 特征 | Maix-I K210 | Maix-II v831 | MaixCAM |
+| ------- | ----------- | ------------ | ------- |
+| CPU | 400MHz RISC-V x2 | 800MHz ARM7 | **1GHz RISC-V(Linux)<br>700MHz RISC-V(RTOS)<br>25~300MHz 8051(Low Power)** |
+| 内存 | 6MB SRAM | 64MB DDR2 | **256MB DDR3** |
+| NPU | 0.25Tops@INT8<br>official says 1T but... | 0.25Tops@INT8 | **1Tops@INT8** |
+| Encoder | ✖ | 1080p@30fps | **2K@30fps** |
+| 屏幕 | 2.4" 320x240 | 1.3" 240x240 | **2.28" 552x368** / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800|
+| 触摸屏 | ✖ | ✖ | **2.3" 552x368** |
+| 摄像头 | 30W | 200W | **500W** |
+| WiFi   | 2.4G | 2.4G | **WiFi6** 2.4G/5G |
+| USB    | ✖    | **USB2.0** | **USB2.0** |
+| 以太网    | ✖    | 100M(选配)   | 100M(选配) |
+| SD 卡接口 | SPI | **SDIO** | **SDIO** |
+| BLE    | ✖    | ✖      | **BLE5.4** |
+| 操作系统     | RTOS | Tina Linux | **Linux + RTOS** |
+| 编程语言 | C / C++ / MicroPython | C / C++ / **Python3** | C / **C++ / Python3** |
+| Software | MaixPy | MaixPy3 | **MaixCDK + MaixPy v4 + opencv + numpy + ...**|
+| PC 软件 | MaixPy IDE | MaixPy3 IDE | **MaixVision** Workstation |
+| 文档   | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
+| 在线 AI 训练 | ⭐️⭐️⭐️ |  ⭐️⭐️⭐️⭐️ |  🌟🌟🌟🌟🌟 |
+| 官方应用   | ⭐️⭐️   |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
+| AI 分类(224x224) | MobileNetv1 50fps<br>MobileNetv2 ✖<br>Resnet ✖ | MobileNet ✖<br>Resnet18 20fps<br>Resnet50 ✖| MobileNetv2 **130fps**<br>Resnet18 **62fps**<br>Resnet50 **28fps** |
+| AI 检测   | YOLOv2(224x224) 15fps |  YOLOv2(224x224) 15fps |  **YOLOv5s(224x224) 100fps<br>YOLOv5s(320x256) 70fps<br>YOLOv5s(640x640) 15fps<br>YOLOv8n(640x640) 23fps**|
+| 易用性     | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
+
+## What difference between MaixPy v1, MaixPy3 and MaixPy v4?
+
+* MaixPy v1 use MicroPython programming language, only support Sipeed Maix-I K210 series hardware, have limited third-party packages.
+* MaixPy3 is designed for Sipeed Maix-II-Dock v831, not a long-term support version.
+* MaixPy v4 use Python programming language, so there's much package we can use directly. MaixPy v4 support new hardware platforms of Sipeed, it's a long-term support version, the future's hardware platforms will support this version. MaixPy v4 have a MaixPy-v1 compatible API, so you can quickly migrate your MaixPy v1 project to MaixPy v4.
+
+(MaixPy v4 Will not support Maix-I K210 series, if you are using Maix-I K210 series, it's recommended to upgrade hardware platform to use this to get more features and better performance.)
+
+## MaixPy v1, MaixPy3 and MaixPy v4 有什么区别？
+
+* MaixPy v1 使用 MicroPython 编程语言，仅支持 Sipeed Maix-I K210 系列硬件，有限的第三方包。
+* MaixPy3 专为 Sipeed Maix-II-Dock v831 设计，不是长期支持版本。
+* MaixPy v4 使用 Python 编程语言，因此我们可以直接使用许多包。MaixPy v4 支持 Sipeed 的新硬件平台，这是一个长期支持版本，未来的硬件平台将支持这个版本。MaixPy v4 有一个 MaixPy-v1 兼容的 API，所以你可以快速将你的 MaixPy v1 项目迁移到 MaixPy v4。
+
+(MaixPy v4 不支持 Maix-I K210 系列，如果你正在使用 Maix-I K210 系列，建议升级硬件平台以使用此版本，以获得更多功能和更好的性能。)
+
+## 开源协议
+
+
+所有在本仓库中的文件都遵循 [Apache License 2.0 Sipeed Ltd.](https://github.com/sipeed/maixpy/blob/main/LICENSE) 协议，除了第三方库或者有自己的协议。
+
+## 社区
+
+* 项目分享: [maixhub.com/share](https://maixhub.com/share)
+* 讨论: [maixhub.com/discussion](https://maixhub.com/discussion)
+* QQ 群: 862340358
+* Telegram: [t.me/maixpy](https://t.me/maixpy)
+
+
+
+
diff --git a/docs/pages/index/README.md b/docs/pages/index/README.md
index ecd0f358..cac6b40b 100644
--- a/docs/pages/index/README.md
+++ b/docs/pages/index/README.md
@@ -129,8 +129,7 @@ li {
 
 <div class="flex justify-center" id="tags">
 
-[![GitHub Repo stars](https://img.shields.io/github/stars/sipeed/MaixPy?style=social)](https://github.com/sipeed/MaixPy/stargazers) [![Apache 2.0](https://img.shields.io/badge/license-Apache%20v2.0-orange.svg)]("https://github.com/sipeed/MaixPy/blob/main/LICENSE.md) [![PyPI](https://img.shields.io/pypi/v/maixpy.svg)](https://pypi.python.org/pypi/maixpy/) [![PyPI - Downloads](https://img.shields.io/pypi/dm/maixpy?label=pypi%20downloads)](https://pypi.org/project/maixpy/) ![GitHub repo size](https://img.shields.io/github/repo-size/sipeed/maixpy) [![Build MaixCAM](https://github.com/sipeed/MaixPy/actions/workflows/build_maixcam.yml/badge.svg)](https://github.com/sipeed/MaixPy/actions/workflows/build_maixcam.yml)
-[![Trigger wiki](https://github.com/sipeed/MaixPy/actions/workflows/trigger_wiki.yml/badge.svg)](https://github.com/sipeed/MaixPy/actions/workflows/trigger_wiki.yml)
+[![GitHub Repo stars](https://img.shields.io/github/stars/sipeed/MaixPy?style=social)](https://github.com/sipeed/MaixPy/stargazers)[![Apache 2.0](https://img.shields.io/badge/license-Apache%20v2.0-orange.svg)]("https://github.com/sipeed/MaixPy/blob/main/LICENSE.md)[![PyPI](https://img.shields.io/pypi/v/maixpy.svg)](https://pypi.python.org/pypi/maixpy/)[![PyPI - Downloads](https://img.shields.io/pypi/dm/maixpy?label=pypi%20downloads)](https://pypi.org/project/maixpy/)![GitHub repo size](https://img.shields.io/github/repo-size/sipeed/maixpy) [![Build MaixCAM](https://github.com/sipeed/MaixPy/actions/workflows/build_maixcam.yml/badge.svg)](https://github.com/sipeed/MaixPy/actions/workflows/build_maixcam.yml)[![Trigger wiki](https://github.com/sipeed/MaixPy/actions/workflows/trigger_wiki.yml/badge.svg)](https://github.com/sipeed/MaixPy/actions/workflows/trigger_wiki.yml)
 
 
 </div>
@@ -144,8 +143,8 @@ li {
 
 <div class="mt-16"></div>
 
-> MaixPy-v1 (Maix-I K210) 用户请查看 <a target="_blank" href="https://wiki.sipeed.com/soft/maixpy/zh/">MaixPy-v1 文档</a>。
-> MaixPy v4 不支持 Maix-I Maix-II 系列硬件，请更新到 [MaixCAM](https://wiki.sipeed.com/maixcam) 硬件平台。
+> MaixPy-v1 (Maix-I K210) 用户请查看 <a target="_blank" href="https://wiki.sipeed.com/soft/maixpy/zh/">MaixPy-v1 文档</a>。 MaixPy v4 不支持 Maix-I Maix-II 系列硬件，请更新到 [MaixCAM](https://wiki.sipeed.com/maixcam) 硬件平台。
+> 喜欢 MaixPy 请到 GitHub 给 [ MaixPy 源码](https://github.com/sipeed/MaixPy) 点个 Star ⭐️ 以鼓励我们开发更多功能。
 
 
 <div class="mt-6"></div>
@@ -153,7 +152,7 @@ li {
 <div id="id1" class="flex flex-row justify-start flex-wrap">
 
 <div>
-<h2>简易的 API 设计， 10 行代码搞定 AI 图像识别：</h2>
+<h2>简易的 API 设计， 10 行代码进行 AI 图像识别：</h2>
 
 ```python
 from maix import camera, display, image, nn
@@ -247,7 +246,7 @@ print("received:", dev1.readfrom(0x12, 5))
         <div class="img_video">
             <video controls autoplay loop muted preload src="/static/video/maixvision.mp4"></video>
             <p class="feature">Python + MaixVision IDE</p>
-            <p class="description">简单的API，带有硬件加速，包含许多库，如numpy，opencv，MaixVision IDE编程</p>
+            <p class="description">简单的API，带有硬件加速，包含许多库，如numpy，opencv，MaixVision IDE 编程</p>
         </div>
         <div>
         </div>
@@ -428,41 +427,69 @@ print("received:", dev1.readfrom(0x12, 5))
 
 </div>
 
-<!-- 比较 -->
+## Maix 生态
 
-<div class="flex flex-col justify-center mt-10">
+![](/static/image/maix_ecosystem.png)
+
+## 谁在用 MaixPy？
+
+* **AI 算法工程师**： 轻松将你的 AI 模型部署到嵌入式设备。
+> MaixPy 提供了易于使用的 API 来访问 NPU，以及帮助你开发 AI 模型的文档。
+
+* **STEM**：想要教学生 AI 和嵌入式开发的老师。
+> MaixPy 提供了易于使用的 API，PC 工具，在线 AI 训练服务... 让你专注于教授 AI，而不是硬件和复杂的软件使用。
+
+* **创客**: 想要制作一些酷炫的项目，但不想学习复杂的硬件和软件。
+> MaixPy 提供了 Python API，所以你需要做的就是学习基础 Python 语法，而 MaixPy 的 API 非常易于使用，你甚至可以在几分钟内完成你的项目。
+
+* **工程师**: 想要做一些项目，但希望尽快有一个原型。
+> MaixPy 易于构建项目，并提供相应的 C++ SDK，所以你可以直接使用 MaixPy 来部署或在几分钟内将 Python 代码转换为 C++。
+
+* **学生**： 想要学习 AI，嵌入式开发。
+> 我们提供了许多文档和教程，以及大量开源代码，帮助你找到学习路线，并逐步成长。从简单的 Python 编程到视觉，AI，音频，Linux，RTOS等。
+
+* **企业**: 想要开发 AI 视觉产品，但没有时间或工程师来开发复杂的嵌入式系统。
+> 使用 MaixPy 甚至图形编程来开发你的产品，不需要更多的员工和时间。例如，向你的生产线添加一个 AI QA 系统，或者根据你的需求向你的办公室添加一个 AI 安全监控器。
+
+* **竞赛者**: 想要赢得比赛的比赛人们。
+> MaixPy 集成了许多功能，易于使用，加快你作品产出速度，以在有限的时间内赢得比赛，国内常见比赛都有很多同学使用 MaixPy 赢得比赛。
 
 ## 性能对比
 
-相比上两代 Maix 系列产品，性能和体验有了很大的提升，强烈建议升级到最新的 MaixCAM 以及 MaixPy v4：
+相比上两代 Maix 系列产品有限的 NPU 算子支持和内存限制，MaixCAM 在保持超高性价比的同时，性能和体验有了很大的提升，强烈建议升级到最新的 MaixCAM 以及 MaixPy v4。
 
-| Feature | Maix-I K210 | Maix-II v831 | MaixCAM |
+| 特征 | Maix-I K210 | Maix-II v831 | MaixCAM |
 | ------- | ----------- | ------------ | ------- |
 | CPU | 400MHz RISC-V x2 | 800MHz ARM7 | **1GHz RISC-V(Linux)<br>700MHz RISC-V(RTOS)<br>25~300MHz 8051(Low Power)** |
-| Memory | 6MB SRAM | 64MB DDR2 | **256MB DDR3** |
+| 内存 | 6MB SRAM | 64MB DDR2 | **256MB DDR3** |
 | NPU | 0.25Tops@INT8<br>official says 1T but... | 0.25Tops@INT8 | **1Tops@INT8** |
 | Encoder | ✖ | 1080p@30fps | **2K@30fps** |
-| Screen | 2.4" 320x240 | 1.3" 240x240 | **2.28" 552x368** / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800|
-| Camera | 30W | 200W | **500W** |
+| 屏幕 | 2.4" 320x240 | 1.3" 240x240 | **2.28" 552x368** / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800|
+| 触摸屏 | ✖ | ✖ | **2.3" 552x368** |
+| 摄像头 | 30W | 200W | **500W** |
 | WiFi   | 2.4G | 2.4G | **WiFi6** 2.4G/5G |
 | USB    | ✖    | **USB2.0** | **USB2.0** |
-| Eth    | ✖    | 100M   | 100M |
-| SD Interface | SPI | **SDIO** | **SDIO** |
+| 以太网    | ✖    | 100M(选配)   | 100M(选配) |
+| SD 卡接口 | SPI | **SDIO** | **SDIO** |
 | BLE    | ✖    | ✖      | **BLE5.4** |
-| OS     | RTOS | Tina Linux | **Linux + RTOS** |
-| Language | C / C++ / MicroPython | C / C++ / **Python3** | C / **C++ / Python3** |
+| 操作系统     | RTOS | Tina Linux | **Linux + RTOS** |
+| 编程语言 | C / C++ / MicroPython | C / C++ / **Python3** | C / **C++ / Python3** |
 | Software | MaixPy | MaixPy3 | **MaixCDK + MaixPy v4 + opencv + numpy + ...**|
-| PC software | MaixPy IDE | MaixPy3 IDE | **MaixVision** Workstation |
-| Docs   | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
-| Online AI train | ⭐️⭐️⭐️ |  ⭐️⭐️⭐️⭐️ |  🌟🌟🌟🌟🌟 |
-| Official APPs   | ⭐️⭐️   |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
-| AI classify(224x224) | MobileNetv1 50fps<br>MobileNetv2 ✖<br>Resnet ✖ | MobileNet ✖<br>Resnet18 20fps<br>Resnet50 ✖| MobileNetv2 **130fps**<br>Resnet18 **62fps**<br>Resnet50 **28fps** |
-| AI detect   | YOLOv2(224x224) 15fps |  YOLOv2(224x224) 15fps |  **YOLOv5s(224x224) 100fps<br>YOLOv5s(320x256) 70fps<br>YOLOv5s(640x640) 15fps<br>YOLOv8n(640x640) 23fps**|
-| Ease of use     | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
+| PC 软件 | MaixPy IDE | MaixPy3 IDE | **MaixVision** Workstation |
+| 文档   | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
+| 在线 AI 训练 | ⭐️⭐️⭐️ |  ⭐️⭐️⭐️⭐️ |  🌟🌟🌟🌟🌟 |
+| 官方应用   | ⭐️⭐️   |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
+| AI 分类(224x224) | MobileNetv1 50fps<br>MobileNetv2 ✖<br>Resnet ✖ | MobileNet ✖<br>Resnet18 20fps<br>Resnet50 ✖| MobileNetv2 **130fps**<br>Resnet18 **62fps**<br>Resnet50 **28fps** |
+| AI 检测   | YOLOv2(224x224) 15fps |  YOLOv2(224x224) 15fps |  **YOLOv5s(224x224) 100fps<br>YOLOv5s(320x256) 70fps<br>YOLOv5s(640x640) 15fps<br>YOLOv8n(640x640) 23fps**|
+| 易用性     | ⭐️⭐️⭐️⭐️ |  ⭐️⭐️⭐️   |  🌟🌟🌟🌟🌟 |
 
+## MaixPy v1, MaixPy3 and MaixPy v4 有什么区别？
 
-</div>
+* MaixPy v1 使用 MicroPython 编程语言，仅支持 Sipeed Maix-I K210 系列硬件，有限的第三方包。
+* MaixPy3 专为 Sipeed Maix-II-Dock v831 设计，不是长期支持版本。
+* MaixPy v4 使用 Python 编程语言，因此我们可以直接使用许多包。MaixPy v4 支持 Sipeed 的新硬件平台，这是一个长期支持版本，未来的硬件平台将支持这个版本。MaixPy v4 有一个 MaixPy-v1 兼容的 API，所以你可以快速将你的 MaixPy v1 项目迁移到 MaixPy v4。
 
+(MaixPy v4 不支持 Maix-I K210 系列，如果你正在使用 Maix-I K210 系列，建议升级硬件平台以使用此版本，以获得更多功能和更好的性能。)
 
 ## 开源协议