From d4161cd7e907e23ebfb32f15f2cd4e0361f08349 Mon Sep 17 00:00:00 2001 From: lxowalle Date: Fri, 31 Oct 2025 11:49:52 +0800 Subject: [PATCH] * [maixcam2] optimize maixcam2_os.md --- docs/hardware/en/maixcam/maixcam2_os.md | 7 ++-- docs/hardware/zh/maixcam/maixcam2_os.md | 44 ++++++++++++------------- 2 files changed, 25 insertions(+), 26 deletions(-) diff --git a/docs/hardware/en/maixcam/maixcam2_os.md b/docs/hardware/en/maixcam/maixcam2_os.md index 83bf0553..7d5f67e5 100644 --- a/docs/hardware/en/maixcam/maixcam2_os.md +++ b/docs/hardware/en/maixcam/maixcam2_os.md @@ -87,7 +87,7 @@ If problems persist, or the system won’t boot after flashing, try `rufus` or ` * 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`. * Method 2: Power off, connect USB, power on, then within `1 second` press and hold `boot/Func`. Release after `3 seconds`. - > Don’t hold the button before power-on—this enters AXDL mode, which takes at least 5 seconds. Too slow. + > Don’t hold the button before power-on—this enters AXDL mode, which takes at least 10 seconds. Too slow. * After a few seconds, you’ll see a virtual U-disk appear. The blue LED flashes in a `off-on-on` pattern. * Click the software’s “Flash” button to begin. The blue LED flashes `0.5s on / 0.5s off`. * If Windows prompts to format the new drive—**do not format it**! Just close the window. @@ -102,13 +102,12 @@ This is similar to USB flashing but often faster (depending on TF card speed, e. ### Preparing a TF Upgrade Card * Insert the TF card into your PC using a card reader. -* Format the TF card as `exFAT` or `ext4` (not `FAT32`). -* Decompress `xxx.img.xz` to `xxx.img` and copy it to the TF card. +* Format the TF card as `exFAT` or `ext4` (not `FAT32`). Make sure to partition the TF card. +* 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. * Safely eject the card to ensure data is fully written. * Power off the MaixCAM2. * Insert the TF card and power on. * The board will auto-detect and flash the system. Blue LED flashes `0.5s on / 0.5s off`. - > If it doesn’t, check previous steps. * When complete, the LED stays solid on. Fast flashing (`0.3s on / 0.3s off`) indicates failure. Do not power off—use Method 2 (USB) to recover. If powered off and still failing, use AXDL to restore the boot partition. * Reboot to enter the new system. As before, wait for the first boot to finish before shutting down. diff --git a/docs/hardware/zh/maixcam/maixcam2_os.md b/docs/hardware/zh/maixcam/maixcam2_os.md index 26b9927a..3b3b75aa 100644 --- a/docs/hardware/zh/maixcam/maixcam2_os.md +++ b/docs/hardware/zh/maixcam/maixcam2_os.md @@ -11,10 +11,10 @@ title: MaixCAM2 系统烧录 * 缺点：只支持Windows，烧录速度慢。 * **方法二**: USB 卡烧录`.img.xz`格式的系统，包含了完整的系统，使用通用工具比如`etcher / rufus / win32diskimager / imageUSB`等即可烧录。 * 优点：烧录简单，不受烧录系统和软件限制，速度快（TF > USB2.0 > AXDL）。 - * 缺点：只有在 EMMC 内有**启动分区**时才能正常使用。如果没有启动分区或者损坏，则需要用方法一烧录一次 `*.axp` 系统才能使用方法二。 + * 缺点：只有在 EMMC 已经烧录过**启动分区**时才能正常使用。如果没有启动分区或者损坏，则需要用方法一烧录一次 `*.axp` 系统才能使用方法二。 * **方法三**: TF 卡烧录`.img.xz`格式的系统，包含了完整的系统。 * 优点：烧录简单，无需三方软件，速度快（TF > USB2.0 > AXDL）。 - * 缺点：需要一张 TF 卡；只有在 EMMC 内有**启动分区**时才能正常使用。如果没有启动分区或者损坏，则需要用方法一烧录一次 `*.axp` 系统才能使用方法三。 + * 缺点：需要一张 TF 卡；只有在 EMMC 已经烧录过**启动分区**时才能正常使用。如果没有启动分区或者损坏，则需要用方法一烧录一次 `*.axp` 系统才能使用方法三。 **推荐选择**：正常情况下出厂已经烧录过一次启动分区，所以可以直接用方法二烧录`.img`文件，遇到启动分区损坏的情况再考虑用方法一烧录。 @@ -54,10 +54,10 @@ title: MaixCAM2 系统烧录 ### 加载和烧录系统文件 -* 点击加载系统文件按纽，选择加载下载的`.axp`格式的系统。 -* 等待加载完毕后，点击开始按纽，就会开始自动检测 USB。 -* 按住`boot/Func`按纽不放，再插上 USB 到电脑， AXDL 就会自动开始下载系统，然后松开按纽等待即可。 -* 或者先插上 USB 到电脑，再按住`boot/Func`按纽不放，拨动电源开关重新上电，等 AXDL 检测到后再松开按纽。 +* 点击加载系统文件按钮，选择加载下载的`.axp`格式的系统。 +* 等待加载完毕后，点击开始按钮，就会开始自动检测 USB。 +* 按住`boot/Func`按钮不放，再插上 USB 到电脑， AXDL 就会自动开始下载系统，然后松开按钮等待即可。 +* 或者先插上 USB 到电脑，再按住`boot/Func`按钮不放，拨动电源开关重新上电，等 AXDL 检测到后再松开按钮。 * 下载过程中建议不要触碰 USB 线和板子，以免接触不良失败。 * 下载完成后会自动重启进入系统，第一次启动请至少等到启动进入主界面后才能断电，防止第一次文件初始化丢失。 @@ -82,11 +82,11 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis 大多数软件烧录时软件会自动解压`xz`为`img`文件，如果软件不支持则需要先手动解压为`img`文件。 `Etcher`会报错`Missing partition table` `not a bootable image ...`即检测不到分区表，对于`MaixCAM2`是正常现象，点击`Continue`继续即可。 * 上电进入 USB / TF 卡升级模式，两种方式： - * 方式1：USB 一端插电脑，然后另一端插上板子的`1秒内`按住`boot/Func`按纽不放，`3秒`后即可松开。 - * 方式2：先关机，USB 连接电脑和板子，打开电源开关的`1秒内`按住`boot/Func`按纽不放，`3秒`后即可松开。 - > 这里不先按住`Func`按纽再开机的原因是按住再开机会进入 AXDL 下载模式，要等待至少 5秒才能进入，太慢了。 + * 方式1：USB 一端插电脑，然后另一端插上板子的`1秒内`按住`boot/Func`按钮不放，`3秒`后即可松开。 + * 方式2：先关机，USB 连接电脑和板子，打开电源开关的`1秒内`按住`boot/Func`按钮不放，`3秒`后即可松开。 + > 这里不先按住`Func`按钮再开机的原因是按住再开机会进入 AXDL 下载模式，要等待至少 5秒才能进入，太慢了。 * 然后等待几秒，就能在下载软件选择烧录磁盘，可以看到板子虚拟的 U盘设备了。另外也可以看到蓝色 LED 按照 `灭-亮-亮` 进行双闪。 -* 点击软件的烧录(Flash)按纽，开始进行烧录（可能会需要管理员权限）。这时板子蓝色 LED开始`亮0.5s-灭0.5s`闪烁。 +* 点击软件的烧录(Flash)按钮，开始进行烧录（可能会需要管理员权限）。这时板子蓝色 LED开始`亮0.5s-灭0.5s`闪烁。 * 烧录过程或者完成后，如果电脑弹出`使用驱动器 G: 中的光盘之前需要将其格式化`这样的字符，**不要**点击格式化磁盘！不然刚烧录好的系统又被格式化了！ 关掉窗口即可。 * 等待烧录完毕，`蓝色 LED 会变成常亮`表示烧录完毕，软件可能还没完成，比如软件会读取 EMMC 内容检验是否出错（也可以跳过，不过校验是加一层保险，建议还是等待其校验完成）。 * 如果烧录软件不会自动弹出 U 盘，建议手动弹出 U盘保证数据都写入了。 @@ -99,15 +99,15 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis ### 制作 TF 升级卡 * 使用读卡器将 TF 卡插到电脑。 -* 格式化 TF 卡，可以选择 `exFAT` 或者`ext4`格式（不要选择`FAT32`）。 -* 将`xxx.img.xz`文件解压为`xxx.img`并且拷贝到 TF 卡。 -* **点击弹出 U 盘**保证数据玩全写入后再拔出读卡器，防止数据未写入完成系统文件损坏。 -* 将 MaixCAM2 断电。 -* 将 TF 卡插入 MaixCAM2，然后上电开机。 +* 格式化 TF 卡，至少创建一个主分区, 可以选择 `exFAT` 或者`ext4`格式（不要选择`FAT32`）, 一定要给TF分区。 +* 将`xxx.img.xz`文件解压为`xxx.img`并且一定拷贝到 TF 卡的第一个分区中。如果之前拷贝了其他`.img`文件, 需要删除旧的镜像文件 +* 拷贝完成后需要**点击弹出 U 盘**保证数据玩全写入后再拔出读卡器，防止数据未写入完成导致系统文件损坏。 +* 将 MaixCAM2 断电, 再将 TF 卡插入 MaixCAM2 +* MaixCAM2上电开机, 并在`1秒内`按住`boot/Func`按钮不放。 * 开机后板子会自动检查 TF 卡中的系统文件，自动进行烧录，此时蓝色 LED开始`亮0.5s-灭0.5s`闪烁。 > 如果不是这样闪烁可能前面的步骤有误。 * 烧录完成后`蓝色 LED 会变成常亮`。如果`亮0.3s-灭0.3s`快闪则表示烧录失败（一般不会出现），不要关机，直接用方法二 USB 烧录补救，如果关机了可以再试试重启会不会进入升级模式，不会的话说明启动分区受损，就需用 AXDL 烧录启动分区了。 -* 手动重启（重新上电）即可进入新系统，第一次进入系统注意至少要等到进入主界面后才能关机断电，方式初始化出错。 +* 手动重启（重新上电）即可进入新系统，第一次进入系统注意至少要等到进入主界面后才能关机断电，防止初始化出错。 ### 加载和烧录系统文件 @@ -115,11 +115,11 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis * 加载前面下载的系统，注意不要下载错了，比如`MaixCAM2`是下载的`maixcam2-2025-09-01-maixpy-v4.11.9.img.xz`。 * 烧录时软件会自动解压`xz`为`img`文件，你也可以自己先手动解压为`img`文件。 * 上电进入 USB / TF 卡升级模式，两种方式： - * 方式1：USB 一端插电脑，然后另一端插上板子的`1秒内`按住`boot/Func`按纽不放，`3秒`后即可松开。 - * 方式2：先关机，USB 连接电脑和板子，打开电源开关的`1秒内`按住`boot/Func`按纽不放，`3秒`后即可松开。 - > 这里不先按住`Func`按纽再开机的原因是按住再开机会进入 AXDL 下载模式，要等待至少 5秒才能进入，太慢了。 + * 方式1：USB 一端插电脑，然后另一端插上板子的`1秒内`按住`boot/Func`按钮不放，`3秒`后即可松开。 + * 方式2：先关机，USB 连接电脑和板子，打开电源开关的`1秒内`按住`boot/Func`按钮不放，`3秒`后即可松开。 + > 这里不先按住`Func`按钮再开机的原因是按住再开机会进入 AXDL 下载模式，要等待至少 10秒才能进入，太慢了。 * 然后等待几秒，就能在下载软件选择烧录磁盘，可以看到板子虚拟的 U盘设备了。另外也可以看到蓝色 LED 按照 `灭-亮-亮` 进行双闪。 -* 点击软件的烧录(Flash)按纽，开始进行烧录（可能会需要管理员权限）。这时板子蓝色 LED开始`亮0.5s-灭0.s`闪烁。 +* 点击软件的烧录(Flash)按钮，开始进行烧录（可能会需要管理员权限）。这时板子蓝色 LED开始`亮0.5s-灭0.s`闪烁。 * 等待烧录完毕，蓝色 LED 会变成常亮表示烧录完毕，软件可能还没完成，比如软件会读取 EMMC 内容检验是否出错，可以等待其校验完成。 * 手动重启（重新上电）即可进入新系统，第一次进入系统注意至少要等到进入主界面后才能关机断电，方式初始化出错。 @@ -129,11 +129,11 @@ Windows 也可以用 [Win32DiskImager](https://sourceforge.net/projects/win32dis ### 断电和关机 -除了上诉情况直接断电（包括拨动开关机按纽也是强制断电），平时正常使用系统时**不建议强制断电**来关机，如果你的系统正在写入内容到 TF 卡，可能会造成数据写入失败，以及系统有缓存机制，可能只是写入到内存，还没同步到磁盘。 +除了上诉情况直接断电（包括拨动开关机按钮也是强制断电），平时正常使用系统时**不建议强制断电**来关机，如果你的系统正在写入内容到 TF 卡，可能会造成数据写入失败，以及系统有缓存机制，可能只是写入到内存，还没同步到磁盘。 另外系统仍在运行，强制拔掉电源和按`reset`按钮的是同样的问题，尽量**先软件关机再拔电源**。 正常使用请**软件关机或者重启**，方法： -* 方法一： 主界面长按`Func`按纽选择关机，或者`设置`->`电源` 进行软件关机或者重启。 +* 方法一： 主界面长按`Func`按钮选择关机，或者`设置`->`电源` 进行软件关机或者重启。 * 方法二： 终端使用`poweroff` 或者`reboot`命令进行软件关机或者重启。 * 方法三：其它软件调用，比如 `Python` 调用 `import os;os.system("poweroff")` 进行关机或者重启。