Skip to content

Commit fd97a68

Browse files
committed
* [maixcam2] Add system source code link
* [maixcam2] Optimize the instructions for downloading images.
1 parent 226c63b commit fd97a68

File tree

4 files changed

+22
-19
lines changed

4 files changed

+22
-19
lines changed

docs/hardware/en/maixcam/maixcam2.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -217,6 +217,7 @@ We don’t just provide hardware — MaixCAM2 comes with a complete software eco
217217
* [MaixCAM-Pro Official Docs](https://wiki.sipeed.com/maixcam2) (this documentation)
218218
* [MaixPy Official Docs](https://wiki.sipeed.com/maixpy/) (Python SDK) ([MaixPy Source Code](https://github.com/sipeed/MaixPy))
219219
* [MaixCDK](https://github.com/sipeed/MaixCDK) (C/C++ SDK) ([MaixCDK Source Code](https://github.com/sipeed/MaixCDK))
220+
* [System Source Code](https://github.com/sipeed/maix_ax620e_sdk)
220221
* [System Flashing Guide](./maixcam2_os.md)
221222
* [Camera and Lens](./maixcam2_camera_lens.md)
222223
* [Hardware Resource Downloads](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM2)

docs/hardware/en/maixcam/maixcam2_os.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,14 @@ title: MaixCAM2 System Flashing
66

77
## Downloading the System
88

9-
At present, only images in the `.img.xz` format are provided.
9+
At present, only images in the `.img` format are provided, and may be compressed to `.img.xz` or multi-volume compression to `.img.7z.00x`.
10+
1011
[Download image (Baidu Netdisk)](https://pan.baidu.com/s/1r4ECNlaTVxhWIafNBZOztg) Extraction code: `vjex`.
1112
[Download image (MEGA)](https://mega.nz/folder/01IEDZQb#3ktByGkFMn_x6jDxMLbK4w)
1213

1314
Image file directory description:
14-
1. `boot_parts_maixcam2-xxxx-xx-xx-maixpy-x.x.x.axp`:This file is a minimal boot image. Normally, it does not need to be flashed. Only when the board cannot be flashed via TF card or USB, refer to the method described below for flashing .axp files. After flashing this file, the TF card and USB flashing functions can be restored.
15-
2. `maixcam2-xxxx-xx-xx-maixpy-x.x.x.img.7z.00x`:The image is split into multiple files using multi-volume compression. You may see files such as `maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.001` and `maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.002`. All volume files must be downloaded before extraction.
15+
1. `boot_parts_maixcam2-xxx-maixpy-xxx.axp`:This file is a minimal boot image. Normally, it does not need to be flashed. Only when the board cannot be flashed via TF card or USB, refer to the method described below for flashing .axp files. After flashing this file, the TF card and USB flashing functions can be restored.
16+
2. `maixcam2-xxx-maixpy-xxx.img.7z.00x`:The image is split into multiple files using multi-volume compression. You may see files such as `maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.001` and `maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.002`. All volume files must be downloaded before extraction.
1617
> Extraction instructions:
1718
> - `On Linux`: use `7z` to extract. Place all volume files in the same directory, then run: '`7z x maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.001`'
1819
> - `On Windows`: place all volume files in the same folder, then right-click the first file (`.7z.001` or `.7z`) and select 7-Zip -> Extract Files or Extract Here.The software will automatically merge and extract the files. Make sure all volumes are complete and correctly named.
@@ -22,10 +23,10 @@ For MaixCAM2, there are two types of systems and flashing methods:
2223
* **Method 1**: The original chip manufacturer’s flashing format (`.axp`). Requires [AXDL](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM2/Software/Tools) to flash.
2324
* Pros: Works regardless of whether the EMMC has a boot partition or system.
2425
* Cons: Only supported on Windows, flashing speed is slow.
25-
* **Method 2**: USB flashing (`.img.xz` format), which contains a complete system. You can flash it with general tools such as `etcher / rufus / win32diskimager / imageUSB`.
26+
* **Method 2**: USB flashing (`.img` format), which contains a complete system. You can flash it with general tools such as `etcher / rufus / win32diskimager / imageUSB`.
2627
* Pros: Simple, OS/software independent, faster (TF > USB2.0 > AXDL).
2728
* Cons: Only works if the EMMC already has a **boot partition**. If the boot partition is missing or corrupted, you must first flash a `*.axp` system using Method 1 before Method 2 can be used.
28-
* **Method 3**: TF card flashing (`.img.xz` format), which contains a complete system.
29+
* **Method 3**: TF card flashing (`.img` format), which contains a complete system.
2930
* Pros: Simple, OS/software independent, no extra 3rd-parth PC software needed, faster (TF > USB2.0 > AXDL).
3031
* Cons: Need a TF card. Only works if the EMMC already has a **boot partition**. If the boot partition is missing or corrupted, you must first flash a `*.axp` system using Method 1 before Method 2 can be used.
3132

@@ -92,9 +93,9 @@ If problems persist, or the system won’t boot after flashing, try `rufus` or `
9293

9394
### Load and Flash the System File
9495

95-
* Load the system image you downloaded (e.g. `maixcam2-2025-09-01-maixpy-v4.11.9.img.xz`).
96-
Most of software will automatically decompress `xz` to `img`, if not you must do it manually first.
97-
`Etcher`may occurs `Missing partition table` `not a bootable image ...` warning, it's normall for `MaixCAM2`, just click `Continue` to continue.
96+
> `Etcher`may occurs `Missing partition table` `not a bootable image ...` warning, it's normall for `MaixCAM2`, just click `Continue` to continue.
97+
98+
* Load the system image you downloaded and extract it. Make sure you’re loading the right one. It’s usually named `maixcam2-2025-09-01-maixpy-v4.11.9.img`.
9899
* Enter USB/TF upgrade mode:
99100

100101
* Method 1: Plug one end of USB into the PC, then within `1 second` of connecting to the board, press and hold `boot/Func`. Release after `3 seconds`.
@@ -116,7 +117,7 @@ This is similar to USB flashing but often faster (depending on TF card speed, e.
116117

117118
* Insert the TF card into your PC using a card reader.
118119
* Format the TF card as `exFAT` or `ext4` (not `FAT32`). Make sure to partition the TF card.
119-
* Extract the `xxx.img.xz` file to `xxx.img` and be sure to copy it to the first partition of the TF card. If other, img files were previously copied, delete the old image files.
120+
* Copy the xxx.img file to the first partition of the TF card. If you have previously copied other `.img` files, you need to delete the old image files.
120121
* Safely eject the card to ensure data is fully written.
121122
* Power off the MaixCAM2, then insert the TF card into the MaixCAM2.
122123
* Power on the MaixCAM2, and within `1 second`, press and hold the `boot/Func` button.

docs/hardware/zh/maixcam/maixcam2.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -219,6 +219,7 @@ title: MaixCAM2 -- 快速落地 AI 视觉、听觉应用
219219
* [MaixCAM2 官方文档](https://wiki.sipeed.com/maixcam2)(本文档)
220220
* [MaixPy 官方文档](https://wiki.sipeed.com/maixpy/)(Python SDK)([MaixPy 源码](https://github.com/sipeed/MaixPy)
221221
* [MaixCDK](https://github.com/sipeed/MaixCDK)(C/C++ SDK)([MaixCDK 源码](https://github.com/sipeed/MaixCDK)
222+
* [系统源码](https://github.com/sipeed/maix_ax620e_sdk)
222223
* [系统烧录](./maixcam2_os.md)
223224
* [摄像头和镜头](./maixcam2_camera_lens.md)
224225
* [硬件相关资料下载](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM2)

docs/hardware/zh/maixcam/maixcam2_os.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,14 @@ title: MaixCAM2 系统烧录
55

66
## 获取系统文件
77

8-
目前只提供了`.img.xz`格式的镜像.
8+
目前只提供了`.img`格式的镜像, 可能压缩后的后缀为`.img.xz`, 也可能分卷压缩为`.img.7z.00x`
9+
910
[下载镜像(百度网盘)](https://pan.baidu.com/s/1r4ECNlaTVxhWIafNBZOztg) 提取码:`vjex`
1011
[下载镜像(MEGA)](https://mega.nz/folder/01IEDZQb#3ktByGkFMn_x6jDxMLbK4w)
1112

1213
镜像文件目录说明:
1314
1. `boot_parts_maixcam2-xxxx-xx-xx-maixpy-x.x.x.axp`: 该文件是一个最小启动镜像, 一般不需要烧录, 只有当板子无法通过TF卡或USB烧录时, 参考下文烧录`.axp`格式的方法烧录这个文件后, 即可恢复TF卡和USB烧录的功能.
14-
2. `maixcam2-xxxx-xx-xx-maixpy-x.x.x.img.7z.00x`: 我们通过分卷压缩的方式将镜像分割成多个文件, 你可以能会看到例如`maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.001``maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.002`文件等, 需要下载所有的分卷文件后才能解压.
15+
2. `maixcam2-xxx-maixpy-xxx.img.7z.00x`: 我们通过分卷压缩的方式将镜像分割成多个文件, 你可以能会看到例如`maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.001``maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.002`文件等, 需要下载所有的分卷文件后才能解压.
1516
> 解压方法说明:
1617
> - 如果是`linux`系统, 可以使用`7z`进行解压, 将所有分卷文件放到同一个文件夹下后, 执行'`7z x maixcam2-2025-12-22-maixpy-v4.12.4.img.7z.001`'
1718
> - 如果是`windows`系统, 将所有分卷文件放在同一个文件夹,然后对第一个文件(`.7z.001`或者`.7z`)右键,选择 7-Zip -> 解压文件或提取到“指定文件夹”,软件会自动合并并解压,注意所有分卷必须完整且命名无误
@@ -21,10 +22,10 @@ title: MaixCAM2 系统烧录
2122
* **方法一**:芯片原厂烧录`.axp`格式。需要使用[AXDL](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM2/Software/Tools) 进行烧录。
2223
* 优点:无论 EMMC 内是否有启动分区和系统都能成功烧录。
2324
* 缺点:只支持Windows,烧录速度慢。
24-
* **方法二**: USB 烧录`.img.xz`格式的系统,包含了完整的系统,使用通用工具比如`etcher / rufus / win32diskimager / imageUSB`等即可烧录。
25+
* **方法二**: USB 烧录`.img`格式的系统,包含了完整的系统,使用通用工具比如`etcher / rufus / win32diskimager / imageUSB`等即可烧录。
2526
* 优点:烧录简单,不受烧录系统和软件限制,速度快(TF > USB2.0 > AXDL)。
2627
* 缺点:只有在 EMMC 已经烧录过**启动分区**时才能正常使用。如果没有启动分区或者损坏,则需要用方法一烧录一次 `*.axp` 系统才能使用方法二。
27-
* **方法三**: TF 卡烧录`.img.xz`格式的系统,包含了完整的系统。
28+
* **方法三**: TF 卡烧录`.img`格式的系统,包含了完整的系统。
2829
* 优点:烧录简单,无需三方软件,速度快(TF > USB2.0 > AXDL)。
2930
* 缺点:需要一张 TF 卡;只有在 EMMC 已经烧录过**启动分区**时才能正常使用。如果没有启动分区或者损坏,则需要用方法一烧录一次 `*.axp` 系统才能使用方法三。
3031

@@ -91,9 +92,9 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis
9192

9293
### 加载和烧录系统文件
9394

94-
* 加载前面下载的系统,注意不要下载错了,比如`MaixCAM2`是下载的`maixcam2-2025-09-01-maixpy-v4.11.9.img.xz`
95-
大多数软件烧录时软件会自动解压`xz``img`文件,如果软件不支持则需要先手动解压为`img`文件。
96-
`Etcher`会报错`Missing partition table` `not a bootable image ...`即检测不到分区表,对于`MaixCAM2`是正常现象,点击`Continue`继续即可
95+
> 下载过程如果`Etcher`会报错`Missing partition table` `not a bootable image ...`即检测不到分区表,对于`MaixCAM2`是正常现象,点击`Continue`继续即可
96+
97+
* 加载前面下载并解压后的系统,注意不要弄混了文件,比如`MaixCAM2`的镜像文件是`maixcam2-2025-09-01-maixpy-v4.11.9.img`
9798
* 上电进入 USB / TF 卡升级模式,两种方式:
9899
* 方式1:USB 一端插电脑,然后另一端插上板子的`1秒内`按住`boot/Func`按钮不放,`3秒`后即可松开。
99100
* 方式2:先关机,USB 连接电脑和板子,打开电源开关的`1秒内`按住`boot/Func`按钮不放,`3秒`后即可松开。
@@ -113,7 +114,7 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis
113114

114115
* 使用读卡器将 TF 卡插到电脑。
115116
* 格式化 TF 卡,至少创建一个主分区, 可以选择 `exFAT` 或者`ext4`格式(不要选择`FAT32`), 一定要给TF分区。
116-
*`xxx.img.xz`文件解压为`xxx.img`并且一定拷贝到 TF 卡的第一个分区中。如果之前拷贝了其他`.img`文件, 需要删除旧的镜像文件
117+
*`xxx.img`文件拷贝到 TF 卡的第一个分区中。如果之前拷贝了其他`.img`文件, 需要删除旧的镜像文件
117118
* 拷贝完成后需要**点击弹出 U 盘**保证数据玩全写入后再拔出读卡器,防止数据未写入完成导致系统文件损坏。
118119
* 将 MaixCAM2 断电, 再将 TF 卡插入 MaixCAM2
119120
* MaixCAM2上电开机, 并在`1秒内`按住`boot/Func`按钮不放。
@@ -125,8 +126,7 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis
125126

126127
### 加载和烧录系统文件
127128

128-
* 加载前面下载的系统,注意不要下载错了,比如`MaixCAM2`是下载的`maixcam2-2025-09-01-maixpy-v4.11.9.img.xz`
129-
* 烧录时软件会自动解压`xz``img`文件,你也可以自己先手动解压为`img`文件。
129+
* 加载前面下载并解压后的系统,注意不要弄混了文件,比如`MaixCAM2`的镜像文件是`maixcam2-2025-09-01-maixpy-v4.11.9.img`
130130
* 上电进入 USB / TF 卡升级模式,两种方式:
131131
* 方式1:USB 一端插电脑,然后另一端插上板子的`1秒内`按住`boot/Func`按钮不放,`3秒`后即可松开。
132132
* 方式2:先关机,USB 连接电脑和板子,打开电源开关的`1秒内`按住`boot/Func`按钮不放,`3秒`后即可松开。

0 commit comments

Comments
 (0)