diff --git a/config/config_en.json b/config/config_en.json
index 58bac158..6e3592b8 100755
--- a/config/config_en.json
+++ b/config/config_en.json
@@ -10,7 +10,7 @@
"items": [
{
"label": "Products",
- "url": "/hardware/en/",
+ "url": "/en/",
"position": "left"
},
{
diff --git a/docs/hardware/en/maixcam/assemble.md b/docs/hardware/en/maixcam/assemble.md
index fd66d797..551c12ab 100644
--- a/docs/hardware/en/maixcam/assemble.md
+++ b/docs/hardware/en/maixcam/assemble.md
@@ -2,24 +2,27 @@
title: MaixCAM Case
---
-**The screen protector and lens cover serve as protective measures during shipping. Please remove them before use.**
+## Introduction
-MaixCAM comes with a 3D-printed case that protects the hardware of the MaixCAM.
+There are a few accessories to note when you receive your device:
+* **Lens Cap**: Protects the lens during transport. Please remove it before use, otherwise, the image will appear black.
+* **Screen Protector**: To prevent scratches during transport, there is a thin plastic film on the screen. Please remove it upon arrival, as it can severely affect the viewing quality.
+* **Manual Focus Lens**: The lens supports manual focusing. Simply rotate the lens gently to adjust the focus. If the image is blurry, it may be due to incorrect focusing.
+* **Case**: A 3D-printed case that facilitates handling and installation while enhancing aesthetics.
## Disassembly
-It is strongly recommended to choose the package with a TF card. The factory default is already assembled, and you can skip this step and use it directly.
+It is strongly recommended to choose the package that includes a TF card, as it comes pre-assembled from the factory and you can skip this step and use it directly.
-The factory default is already assembled. If you need to replace the TF card or solder the pin header, you can try to disassemble it.
+The device is pre-assembled from the factory, but if you need to replace the TF card or solder pin headers, you can attempt to disassemble it.
-Here are a few points to note:
-* Make sure to power off before disassembly.
-* There is thermal grease (non-conductive) between the CPU and the case. Please be careful not to get your clothes dirty during disassembly.
-* The heat sink is also in contact with the heat sink plate through thermal grease. Please be careful not to get your clothes dirty during disassembly.
-* Be careful not to damage the camera, touch, and screen cables. Do not break the cables.
-* Pay attention to the direction of the cable, do not plug it in the wrong way.
+Here are some points to note:
+* Ensure the device is powered off before disassembling.
+* There is a thermal pad between the CPU and the case; be careful not to dislodge it during disassembly.
+* Be careful not to damage the camera, touch, and screen ribbon cables (they can easily become loose), and do not break the cables.
+* Pay attention to the orientation of the ribbon cables to avoid inserting them incorrectly.
-### Replacing the TF Card
+## Replacing the TF Card
1. **Open the Case:** Gently pry open the clasps on both sides of the device to separate the front and back covers.
diff --git a/docs/hardware/en/maixcam/os.md b/docs/hardware/en/maixcam/os.md
index 47c37bbb..10f6fe6d 100644
--- a/docs/hardware/en/maixcam/os.md
+++ b/docs/hardware/en/maixcam/os.md
@@ -1,49 +1,61 @@
---
----
title: MaixCAM System Flashing
---
## Download the System
-Find the latest system image file, such as `maixcam_os_20240401_maixpy_v4.1.0.xz`, on the [MaixPy release page](https://github.com/sipeed/MaixPy/releases).
+Find the latest system image file on the [MaixPy Release Page](https://github.com/sipeed/MaixPy/releases), such as `maixcam_os_20240401_maixpy_v4.1.0.xz`.
-Alternative address:
+Alternative download link:
* [Sourceforge](https://sourceforge.net/projects/maixpy/files/)
-## Prepare Flashing Tools
+## Prepare the Flashing Tool
Download [Etcher](https://etcher.balena.io/), install and open it.
-Windows can also use [Win32DiskImager](https://sourceforge.net/projects/win32diskimager/) or [Rufus](https://rufus.ie/).
+Windows users can also use [Win32DiskImager](https://sourceforge.net/projects/win32diskimager/) or [Rufus](https://rufus.ie/).
-## Flash TF Card
+## Flashing the TF Card
There are two ways to flash the TF card:
+* If you bought the official TF card package, it already contains a system, but the version might be outdated. It is recommended to use the USB update method so you don't have to disassemble the casing, which makes it difficult to reassemble.
+* If you are using your own card and have never flashed a system onto it before, you must first flash it using a card reader and then install the TF card by disassembling the device. After that, you can flash the image directly via USB without disassembling.
-### Flash TF Card with Card Reader
+### Method One: Flashing the TF Card Using a Card Reader
-* Directly remove the TF card, insert it into the card reader, and then insert it into the computer.
-* Open Etcher, select the image file, select the TF card, and click `Flash`.
-* Wait for the flashing to complete, eject the TF card, insert it into MaixCAM, then power on, wait for the system to start, the first boot will be slower, just wait a while.
+* Remove the TF card and insert it into a card reader, then plug it into the computer.
+* Open Etcher, select the image file, choose the TF card, and click `Flash`.
+* Wait for the flashing process to complete, eject the TF card, insert it into the MaixCAM, power it up, and wait for the system to boot. The first boot may be slow, just wait for a while.
-### Flash TF Card via USB
+### Method Two: Update the TF Card Image via USB
-* Power off MaixCAM, keep the TF card inserted.
-* Hold down the `user` button on the device without releasing it, insert the USB cable connected to the computer, and wait for the USB device to appear on the computer.
-* Open Etcher, select the image file, select the USB device, and click `Flash`.
-* Wait for the flashing to complete, then press the `reset` button or re-power on, wait for the system to start, the first boot will be slower, just wait a while.
+**Note: USB can only be used for updates, not for the first-time flashing.**
+Ensure that the system has already been flashed using a card reader and is **running properly** before using this method.
-## System Usage Precautions
+* Power off the MaixCAM, keeping the TF card inserted.
+* Hold down the `user` button, plug in the USB cable to the computer, (or plug in the USB cable first, then hold down the `user` button, press the `reset` button briefly and release it), wait for the disk drive to appear on the computer, and then release the `user` button.
+* Open `Etcher`, select the image file, choose the disk drive, and click `Flash`.
+* Wait for the flashing to complete, then press the `reset` button or power it back on, wait for the system to boot. The first boot might be slow, wait until the screen displays content (to be safe, wait about 1 minute), and do not power off during boot-up to prevent file corruption during system initialization (if this happens, reflash the image).
+
+> If you cannot enter USB upgrade mode, the system files may be corrupted, and you should reflash the TF card using a card reader.
+
+## Points to Note When Using the System
### Forced Shutdown
-It is **not recommended to press the `reset` button** during normal system use, except in the situations mentioned above. This button forces a power cut, and if your system is writing content to the TF card, it could cause system and data damage. Similarly, forcibly unplugging the power while the system is still running poses the same risk as pressing the `reset` button. Always try to **shut down the software before unplugging the power**.
+Other than the above situations where using the `reset` button, it is **not recommended to press the `reset` button** during normal use. This button forcefully cuts off power. If your system is writing content to the TF card, it could cause system and data damage.
+Similarly, forcibly unplugging the power supply while the system is still running poses the same risk. Try to **shut down the software before unplugging the power supply**.
-For normal operations, please **shut down or restart using software**. Here are the methods:
+For normal use, please **shut down or reboot via software**. Methods:
+* Method One: From the interface, select `Settings` -> `Power` to perform a software shutdown or reboot.
+* Method Two: In the terminal, use the `poweroff` or `reboot` commands to shut down or restart via software.
+* Method Three: Other software calls, such as using `Python` to invoke `import os;os.system("poweroff")` for shutdown or reboot.
-- **Method 1:** Navigate to `Settings` -> `Power` to shut down or restart through the software.
-- **Method 2:** Use the `poweroff` or `reboot` commands in the terminal for software shutdown or restart.
-- **Method 3:** Other software calls, such as using Python `import os; os.system("poweroff")` to shut down or restart.
+### Issues with File Writing and Data Loss
+The system uses a caching mechanism. When your code writes a file, it might only write to memory initially, and the system automatically writes to the disk after some time. If the power is cut during this period, the content will not be written to the disk (TF card), and the next time the system boots, the previously written content will be missing.
+Solutions:
+* Try not to directly cut off power or press the `reset` button; use the software shutdown methods mentioned above.
+* To save critical content, you can manually call an API to force the content to be written to disk. For example, in `Python`, you can use `os.sync()` to tell the system to immediately write all cached files to the disk. For other methods such as writing to a specific file, and other languages, please search for terms
diff --git a/docs/hardware/zh/maixcam/assemble.md b/docs/hardware/zh/maixcam/assemble.md
index 6d4be34e..edc3251e 100644
--- a/docs/hardware/zh/maixcam/assemble.md
+++ b/docs/hardware/zh/maixcam/assemble.md
@@ -2,9 +2,13 @@
title: MaixCAM 外壳
---
-**屏幕保护膜及镜头透明盖在运输中起保护作用,使用时撕掉、取下即可。**
+## 简介
-MaixCAM 自带了一个 3D 打印外壳,可以保护 MaixCAM 的硬件。
+拿到手有几个配件需要注意:
+* **镜头盖**: 运输过程中保护镜头,使用时请取下,不让画面会是黑的。
+* **屏幕保护膜**:为了防止运输刮花屏幕,有一个塑料薄膜,到手请直接撕掉,不然会严重影响观感。
+* **镜头手动对焦**: 镜头支持手动对焦,轻轻旋动镜头即可实现手动对焦,如果画面模糊则可能对焦不正确。
+* **外壳**:一个 3D 打印外壳,方便握持和安装,同时增加美观性。
## 拆机
@@ -15,7 +19,7 @@ MaixCAM 自带了一个 3D 打印外壳,可以保护 MaixCAM 的硬件。
这里有几点需要注意:
* 拆机前请确保已经断电。
* CPU和外壳之间有导热垫,拆机时请注意不要搞掉。
-* 注意不要破坏摄像头、触摸、屏幕的排线,不要折断排线。
+* 注意不要破坏摄像头、触摸、屏幕的排线(比较容易松动),不要折断排线。
* 注意排线的方向,不要插反。
diff --git a/docs/hardware/zh/maixcam/os.md b/docs/hardware/zh/maixcam/os.md
index 9752a2e4..5948bf19 100644
--- a/docs/hardware/zh/maixcam/os.md
+++ b/docs/hardware/zh/maixcam/os.md
@@ -20,22 +20,26 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis
## 烧录 TF 卡
有两种方式烧录 TF 卡:
+* 如果你买的官方的 TF 卡套餐,里面已经有系统了,只是版本可能比较老旧,建议使用 USB 更新系统的方法,这样就不用拆外壳了,拆外壳会比较难装。
+* 如果你使用自己的卡, 且从来没有烧录过系统,那么必须至少要先用 读卡器烧录一次,然后拆机安装 TF 卡,后面就不用拆机直接使用 USB 烧录镜像了。
-### 读卡器烧录 TF 卡
+### 方法一: 读卡器烧录 TF 卡
* 直接取出 TF 卡,插入读卡器,然后插入电脑。
* 打开 Etcher,选择镜像文件,选择 TF 卡,点击`Flash`。
* 等待烧录完成,弹出 TF 卡,插入 MaixCAM,然后上电,等待系统启动,第一次启动会慢一点,等待一会即可。
-### USB 更新 TF 卡镜像
+### 方法二: USB 更新 TF 卡镜像
**注意使用 USB 只能更新系统不能用作第一次烧录。**
请保证 TF 里面已经用 读卡器烧录过系统,并且**系统能正常运行**之后才能用这种方式。
* MaixCAM 断电,保持 TF 卡插入。
-* 按住设备的 `user` 按键不松开,插入 USB 线连接到电脑,(或者先插入 USB 线,然后按住 `usr`按键不放,再按一下`reset`按钮立即松开)等待 U 盘设备出现在电脑上。
+* 按住设备的 `user` 按键不松开,插入 USB 线连接到电脑,(或者先插入 USB 线,然后按住 `user`按键不放,再按一下`reset`按钮立即松开`reset`)等待 U 盘设备出现在电脑上,然后再松开`user`按键。
* 打开 `Etcher`,选择镜像文件,选择 U 盘设备,点击`Flash`。
-* 等待烧录完成,然后按一下 `reset` 按键或者重新上电,等待系统启动,第一次启动会慢一点,等待一会即可。
+* 等待烧录完成,然后按一下 `reset` 按键或者重新上电,等待系统启动,第一次启动会慢一点,等待一会即可(等待屏幕显示内容,保险起见等待1分钟左右),启动过程中不要断电,防止正在开机处理的文件损坏(解决方法是重新烧录镜像)
+
+> 如果发现进不了 U 盘升级模式,可能是系统文件损坏,使用读卡器烧录 TF 卡即可。
## 使用系统注意点
@@ -51,6 +55,15 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis
* 方法三:其它软件调用,比如 `Python` 调用 `import os;os.system("poweroff")` 进行关机或者重启。
+### 文件写入和内容丢失问题
+
+系统做了缓存机制,当你的代码在写入文件时,可能只是写入到了内存,过一段时间后系统自动写入到磁盘,如果在这中间断电了,那么内容就没有写入到磁盘(TF卡),下次开机就会发现之前写入的内容不存在。
+
+解决方法:
+* 尽量不直接断电或者按`reset`按键,使用上面说的软关机。
+* 保存重要的内容,可以手动调用强制写入内容到磁盘的 API,比如在 `Python` 里面可以用`os.sync()`来告诉系统把所有缓存的文件立即写入到磁盘,其它的方式比如写入指定文件,以及其它语言请自性搜索类似`Linux 刷新内容到磁盘`的关键词。
+
+
diff --git a/docs/soft/maixpy/en/README.md b/docs/soft/maixpy/en/README.md
index ef9a01ca..195fa4e3 100644
--- a/docs/soft/maixpy/en/README.md
+++ b/docs/soft/maixpy/en/README.md
@@ -1,9 +1,37 @@
---
-title: Introduction of MaixPy
+title: Introduction of MaixPy-v1
keywords: maixpy, k210, AIOT, edge computing
-desc: maixpy Introduction to MaixPy documentation
+desc: maixpy Introduction to MaixPy-v1 documentation
---
+
+
+**The Maix-I K210 series is being phased out; if you are planning to purchase a K210, please choose the MaixCAM immediately;**
+**K210 users are also encouraged to upgrade to MaixCAM**
+
+**In this document (under the path https://wiki.sipeed.com/soft/maixpy/en/), all references to MaixPy specifically refer to MaixPy-v1.**
+
+
+
+
+

@@ -26,7 +54,7 @@ desc: maixpy Introduction to MaixPy documentation
- | MaixPy official document website |
+ MaixPy-v1 official document website |
Official website: wiki.sipeed.com Chinese
@@ -38,7 +66,7 @@ desc: maixpy Introduction to MaixPy documentation
|
- | MaixPy demo repository |
+ MaixPy-v1 demo repository |
github: github/maixpy_script
Domestic:gitee/maixpy_scripts |
- | MaixPy source code |
+ MaixPy-v1 source code |
github: MaixPy |
+ href="https://github.com/sipeed/MaixPy-v1">github: MaixPy-v1
| Hardware data download |
@@ -63,7 +91,7 @@ desc: maixpy Introduction to MaixPy documentation
-## About MaixPy
+## About MaixPy-v1
[**MaixPy**](https://maixpy.sipeed.com/zh/wiki.sipeed.com/maixpy) is to port [Micropython](http://micropython.org/) to [K210](https://canaan-creative.com/product/kendryteai) (a 64-bit dual-core RISC-V CPU with hardware FPU, convolution accelerator, FFT, Sha256) is a project that supports the normal operation of the MCU and integrates hardware acceleration. `AI` machine vision and microphone array, `1TOPS` computing power core module is less than `¥50`, in order to quickly develop intelligent applications in the field of `AIOT` with extremely low cost and practical size.
diff --git a/docs/soft/maixpy/en/api_reference/Maix/kpu.md b/docs/soft/maixpy/en/api_reference/Maix/kpu.md
index 82102fda..214422fb 100644
--- a/docs/soft/maixpy/en/api_reference/Maix/kpu.md
+++ b/docs/soft/maixpy/en/api_reference/Maix/kpu.md
@@ -95,7 +95,7 @@ The `offset` and `file_path` parameters can only choose one of the two, no keywo
##### Return
-If it is loaded correctly, the return value will be returned, otherwise an error will be thrown. Please see the error message thrown. In addition, please refer to [here](https://github.com/sipeed/MaixPy-v1blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
+If it is loaded correctly, the return value will be returned, otherwise an error will be thrown. Please see the error message thrown. In addition, please refer to [here](https://github.com/sipeed/MaixPy-v1/blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
If the error code is found to be less than the value of `2000`, the firmware version is too low, and the firmware version needs to be updated
@@ -319,7 +319,7 @@ After `load`, you need to call this function to manually set the output layer sh
##### Return
-* `success`: Whether the setting is successful, if not, please pay attention to the output prompt information, refer to [error code](https://github.com/sipeed/MaixPy-v1blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
+* `success`: Whether the setting is successful, if not, please pay attention to the output prompt information, refer to [error code](https://github.com/sipeed/MaixPy-v1/blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
### memtest
diff --git a/docs/soft/maixpy/en/course/advance/compile.md b/docs/soft/maixpy/en/course/advance/compile.md
index 4405efb6..af6343cc 100644
--- a/docs/soft/maixpy/en/course/advance/compile.md
+++ b/docs/soft/maixpy/en/course/advance/compile.md
@@ -9,7 +9,7 @@ This article is an open source project development document written to help some
## Get maixpy open source project
-Please prepare the linux system environment (WSL on Windows is also possible), hook up the XXX proxy, enter `git clone https://github.com/sipeed/MaixPy` to pull the MaixPy warehouse code and submodules, and make sure to read the catalog after you get it [Build.md](https://github.com/sipeed/MaixPy-v1blob/master/build.md) document under.
+Please prepare the linux system environment (WSL on Windows is also possible), hook up the XXX proxy, enter `git clone https://github.com/sipeed/MaixPy` to pull the MaixPy warehouse code and submodules, and make sure to read the catalog after you get it [Build.md](https://github.com/sipeed/MaixPy-v1/blob/master/build.md) document under.
> Students who do not have an agent can use the github mirror station list (`https://github.com/rc1844/fastgithub`) to accelerate the pull of the maixpy repository. Please do not use gitee to pull the maixpy repository, which will drop the submodule repository.
@@ -57,7 +57,7 @@ juwan@juwan-N85-N870HL:~/Desktop/maixpy$ git submodule status
> This section assumes that you do not have any experience in building cross-compilation chains.
-First press [build.md](https://github.com/sipeed/MaixPy-v1blob/master/build.md) to perform various operations in order. If you don’t speak English, you can open a translator.
+First press [build.md](https://github.com/sipeed/MaixPy-v1/blob/master/build.md) to perform various operations in order. If you don’t speak English, you can open a translator.
The steps are as follows:
diff --git a/docs/soft/maixpy/en/firmware/compile.md b/docs/soft/maixpy/en/firmware/compile.md
index 1e83c9b2..85789017 100644
--- a/docs/soft/maixpy/en/firmware/compile.md
+++ b/docs/soft/maixpy/en/firmware/compile.md
@@ -9,7 +9,7 @@ The pre-compiled firmware may not meet specific usage scenarios. If you need to
## Native environment compilation
-For the compilation method, please refer to the compilation instructions under the source code [build.md](https://github.com/sipeed/MaixPy-v1blob/master/build.md)
+For the compilation method, please refer to the compilation instructions under the source code [build.md](https://github.com/sipeed/MaixPy-v1/blob/master/build.md)
## Use docker environment to compile
diff --git a/docs/soft/maixpy/en/get_started/get_started_boot.md b/docs/soft/maixpy/en/get_started/get_started_boot.md
index 03623790..13f8cb37 100644
--- a/docs/soft/maixpy/en/get_started/get_started_boot.md
+++ b/docs/soft/maixpy/en/get_started/get_started_boot.md
@@ -10,7 +10,7 @@ The system will create the `boot.py` file and `main.py` in the `/flash` or `/sd`
- boot.py is mainly used to configure the hardware and only needs to be configured once.
- main.py can be used for the main running program.
-The corresponding specific implementation [code here](https://github.com/sipeed/MaixPy-v1blob/972059491227ece63fbfc2cd0e78fe13ee78427d/components/micropython/port/src/maixpy_main.c#L586-L595), if you have any questions, just look at the source .
+The corresponding specific implementation [code here](https://github.com/sipeed/MaixPy-v1/blob/972059491227ece63fbfc2cd0e78fe13ee78427d/components/micropython/port/src/maixpy_main.c#L586-L595), if you have any questions, just look at the source .
note:
* The Micro SD card should be formatted as FAT (FAT32) file system
diff --git a/docs/soft/maixpy/en/maixpy_history.md b/docs/soft/maixpy/en/maixpy_history.md
index 731c617d..a68ceb76 100644
--- a/docs/soft/maixpy/en/maixpy_history.md
+++ b/docs/soft/maixpy/en/maixpy_history.md
@@ -90,3 +90,9 @@ Hardware update: Maix Amigo development board is online, with a shell added
## November 2020
Reorganize the documents, more perfect documents and communities
+
+## April 2024
+
+The brand new [MaixPy v4](https://wiki.sipeed.com/maixpy/) update no longer uses MicroPython but has switched to standard CPython3 to better match the more powerful [MaixCAM](https://wiki.sipeed.com/maixcam) hardware.
+
+To differentiate it from the MicroPython version of MaixPy, the name has been changed to MaixPy-v1, and its maintenance will be paused. Future updates will be considered if necessary. The new MaixPy v4 will adopt the name MaixPy.
diff --git a/docs/soft/maixpy/en/sidebar.yaml b/docs/soft/maixpy/en/sidebar.yaml
index 6e9bec28..62005e57 100644
--- a/docs/soft/maixpy/en/sidebar.yaml
+++ b/docs/soft/maixpy/en/sidebar.yaml
@@ -1,7 +1,7 @@
items:
-- label: What is MaixPy?
+- label: What is MaixPy-v1?
file: README.md
-- label: What can MaixPy do?
+- label: What can MaixPy-v1 do?
file: what_maix_do.md
- label: MaixPy Development History
file: maixpy_history.md
diff --git a/docs/soft/maixpy/zh/README.md b/docs/soft/maixpy/zh/README.md
index 63c7ab61..3c4b2b71 100644
--- a/docs/soft/maixpy/zh/README.md
+++ b/docs/soft/maixpy/zh/README.md
@@ -1,7 +1,7 @@
---
-title: MaixPy 文档简介
+title: MaixPy-v1 文档简介
keywords: maixpy, k210, AIOT, 边缘计算, 人工智能, 深度学习
-desc: maixpy MaixPy 文档简介
+desc: maixpy MaixPy-v1 文档简介
---
@@ -20,21 +20,20 @@ desc: maixpy MaixPy 文档简介
**Maix-I K210 系列正在被逐渐淘汰,如果你正准备购买 K210, 请立刻选择 MaixCAM;**
**也欢迎 K210 用户升级到 MaixCAM**
-
-
-
-
-
-
-
+**本文档中(https://wiki.sipeed.com/soft/maixpy/zh/ 路径下)的所有 MaixPy 均代指 MaixPy-v1**
+
+
+
+
+
@@ -49,9 +48,11 @@ desc: maixpy MaixPy 文档简介
-## 关于 MaixPy
-[**MaixPy**](https://wiki.sipeed.com/soft/maixpy/zh/index.html) 是将 [Micropython](http://micropython.org/) 移植到 [K210](https://canaan-creative.com/product/kendryteai)(一款 64 位双核带硬件 FPU、卷积加速器、FFT、Sha256 的 RISC-V CPU ) 的一个项目; [**MaixPy**](https://wiki.sipeed.com/soft/maixpy/zh/index.html) 不但支持 MCU 常规操作, 还集成了硬件加速的 `AI` 机器视觉和麦克风阵列相关的算法。相应的高达 `1TOPS` 算力核心模块却不到`¥50`, 凭借着快速开发和较低成本与其较小的体积很适合 `AIOT` 领域智能应用
+
+## 关于 MaixPy-v1
+
+[**MaixPy-v1**](https://wiki.sipeed.com/soft/maixpy/zh/index.html)(后文直接用 MaixPy 代之,注意与 MaixPy v4 区分) 是将 [Micropython](http://micropython.org/) 移植到 [K210](https://canaan-creative.com/product/kendryteai)(一款 64 位双核带硬件 FPU、卷积加速器、FFT、Sha256 的 RISC-V CPU ) 的一个项目; [**MaixPy**](https://wiki.sipeed.com/soft/maixpy/zh/index.html) 不但支持 MCU 常规操作, 还集成了硬件加速的 `AI` 机器视觉和麦克风阵列相关的算法。相应的高达 `1TOPS` 算力核心模块却不到`¥50`, 凭借着快速开发和较低成本与其较小的体积很适合 `AIOT` 领域智能应用
> MicroPython 是基于 Python3 的语法做的一款解析器,包含了 Python3 的大多数基础语法, 主要运行在性能和内存有限的嵌入式芯片上。(注意 Micropython 不包含 Python3 的所有语法)
diff --git a/docs/soft/maixpy/zh/api_reference/Maix/kpu.md b/docs/soft/maixpy/zh/api_reference/Maix/kpu.md
index 552d0bec..8179d3a9 100644
--- a/docs/soft/maixpy/zh/api_reference/Maix/kpu.md
+++ b/docs/soft/maixpy/zh/api_reference/Maix/kpu.md
@@ -95,7 +95,7 @@ KPU.load(offset, file_path)
##### 返回
-如果正确加载,会返回返回值, 否则会抛出错误, 请看抛出的错误提示, 另外错误代码参考[这里](https://github.com/sipeed/MaixPy-v1blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
+如果正确加载,会返回返回值, 否则会抛出错误, 请看抛出的错误提示, 另外错误代码参考[这里](https://github.com/sipeed/MaixPy-v1/blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
如果发现错误代码是小于 `2000` 的值, 则是固件版本太低,需要更新固件版本
@@ -321,7 +321,7 @@ success = set_outputs(kput_net, out_idx, width, height, channel)
##### 返回
-* `success`: 是否设置成功, 如果不成功,注意看输出的提示信息, 参考[错误代码](https://github.com/sipeed/MaixPy-v1blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
+* `success`: 是否设置成功, 如果不成功,注意看输出的提示信息, 参考[错误代码](https://github.com/sipeed/MaixPy-v1/blob/fa3cf2c96353fa698e9386e42be8b3c9cf495114/components/kendryte_sdk/include/sipeed_kpu.h#L6-L23)
### memtest
diff --git a/docs/soft/maixpy/zh/course/advance/compile.md b/docs/soft/maixpy/zh/course/advance/compile.md
index 3ddcee89..46a7ad22 100644
--- a/docs/soft/maixpy/zh/course/advance/compile.md
+++ b/docs/soft/maixpy/zh/course/advance/compile.md
@@ -9,7 +9,7 @@ desc: maixpy 如何编译
## 获取 maixpy 开源项目
-请准备 linux 系统环境(在 Windows 上使用 WSL 也可以),挂上 XXX 代理,输入 `git clone https://github.com/sipeed/MaixPy` 拉取 MaixPy 仓库代码和子模块,确保拿到后阅读目录下的 [build.md](https://github.com/sipeed/MaixPy-v1blob/master/build.md) 文档。
+请准备 linux 系统环境(在 Windows 上使用 WSL 也可以),挂上 XXX 代理,输入 `git clone https://github.com/sipeed/MaixPy` 拉取 MaixPy 仓库代码和子模块,确保拿到后阅读目录下的 [build.md](https://github.com/sipeed/MaixPy-v1/blob/master/build.md) 文档。
> 没有代理的同学可以用 github 镜像站列表(`https://github.com/rc1844/fastgithub`)加速拉取 maixpy 仓库,请不要用 gitee 拉取 maixpy 仓库,会掉子模块仓库的。
@@ -57,7 +57,7 @@ juwan@juwan-N85-N870HL:~/Desktop/maixpy$ git submodule status
> 这节内容假设你没有任何搭建交叉编译链的经验。
-首先按 [build.md](https://github.com/sipeed/MaixPy-v1blob/master/build.md) 顺序执行各种操作即可,如果你不会英文你可以开翻译机。
+首先按 [build.md](https://github.com/sipeed/MaixPy-v1/blob/master/build.md) 顺序执行各种操作即可,如果你不会英文你可以开翻译机。
步骤说明如下:
diff --git a/docs/soft/maixpy/zh/firmware/compile.md b/docs/soft/maixpy/zh/firmware/compile.md
index e3ebfb91..67fa5878 100644
--- a/docs/soft/maixpy/zh/firmware/compile.md
+++ b/docs/soft/maixpy/zh/firmware/compile.md
@@ -9,7 +9,7 @@ desc: maixpy 源码编译
## 本机环境编译
-编译方法请参考 源码下的编译说明 [build.md](https://github.com/sipeed/MaixPy-v1blob/master/build.md)
+编译方法请参考 源码下的编译说明 [build.md](https://github.com/sipeed/MaixPy-v1/blob/master/build.md)
在 `python project.py menuconfig` 命令部分可以 勾选 或者 去掉 功能和模块
diff --git a/docs/soft/maixpy/zh/get_started/get_started_boot.md b/docs/soft/maixpy/zh/get_started/get_started_boot.md
index 05bec680..82a47eaf 100644
--- a/docs/soft/maixpy/zh/get_started/get_started_boot.md
+++ b/docs/soft/maixpy/zh/get_started/get_started_boot.md
@@ -10,7 +10,7 @@ desc: maixpy 开机自启动脚本
- boot.py 主要用于配置硬件,只配置一次即可。
- main.py 可以用于主要的运行的程序。
-对应的具体执行的[代码在此](https://github.com/sipeed/MaixPy-v1blob/972059491227ece63fbfc2cd0e78fe13ee78427d/components/micropython/port/src/maixpy_main.c#L586-L595),有疑问就直接看源码。
+对应的具体执行的[代码在此](https://github.com/sipeed/MaixPy-v1/blob/972059491227ece63fbfc2cd0e78fe13ee78427d/components/micropython/port/src/maixpy_main.c#L586-L595),有疑问就直接看源码。
注意:
* Micro SD 卡应该被格式化为 FAT(FAT32) 文件系统
diff --git a/docs/soft/maixpy/zh/maixpy_history.md b/docs/soft/maixpy/zh/maixpy_history.md
index 7c502468..d25703c5 100644
--- a/docs/soft/maixpy/zh/maixpy_history.md
+++ b/docs/soft/maixpy/zh/maixpy_history.md
@@ -97,4 +97,13 @@ wipping 退出项目组, zepan 和 xel 专注到其它项目组
## 2022 年 6 月
-全新 [Maixhub](maix.sipeed.com) 上线,更好的体验
\ No newline at end of file
+全新 [Maixhub](maix.sipeed.com) 上线,更好的体验
+
+
+## 2024 年 4 月
+
+全新的 [MaixPy v4](https://wiki.sipeed.com/maixpy/) 更新,不再使用 MicroPython,转而使用标准 CPython3,适配性能更强大的 [MaixCAM](https://wiki.sipeed.com/maixcam) 硬件设备。
+
+为了区分 MicroPython 版本的 MaixPy, 将其名称改为 MaixPy-v1,并且暂停维护,等到未来如果有必要再考虑更新,新版的 MaixPy v4 采用 MaixPy 名称。
+
+
diff --git a/docs/soft/maixpy/zh/sidebar.json b/docs/soft/maixpy/zh/sidebar.json
index e502c6cc..7f2fbe69 100644
--- a/docs/soft/maixpy/zh/sidebar.json
+++ b/docs/soft/maixpy/zh/sidebar.json
@@ -1,11 +1,11 @@
{
"items": [
{
- "label": "MaixPy 是什么?",
+ "label": "MaixPy-v1 是什么?",
"file": "README.md"
},
{
- "label": "MaixPy 能做哪些事?",
+ "label": "MaixPy-v1 能做哪些事?",
"file": "what_maix_do.md"
},
{