Merge pull request #4279 from bleaaach/docusaurus-version

Add content related to flashing errors and issues during system flash…

Author: nfs0619

sites/en/docs/Edge/NVIDIA_Jetson/FAQs/USB_Timeout_during_Flashing.md

@@ -1,42 +1,197 @@
 ---
-description: List the possible causes of timeout issues during the Jetson flashing process.
-title: Timeout Issue during Flash Jetpack
+description: Common Jetson flashing errors and how to troubleshoot them.
+title: Common Flashing Errors and How to Fix Them
 keywords:
   - reComputer
+  - Jetson
+  - flashing
+  - USB
+  - NFS
 image: https://files.seeedstudio.com/wiki/wiki-platform/S-tempor.png
 slug: /usb_timeout_during_flash
 last_update:
-  date: 1/22/2025
-  author: Youjiang
+  date: 3/18/2026
+  author: Lorraine
 createdAt: '2025-01-22'
-updatedAt: '2026-03-03'
+updatedAt: '2026-03-18'
 url: https://wiki.seeedstudio.com/usb_timeout_during_flash/
 ---
 
+This page summarizes several common Jetson flashing failures, especially errors related to USB reconnection, NFS mount, host environment issues, missing flashing tools, and first boot OEM setup.
+
+## Before You Start
+
+Before troubleshooting a specific error, confirm the following:
+
+1. Use a dedicated physical Ubuntu host whenever possible. Avoid virtual machines, Docker containers, and WSL for flashing.
+2. Use a short, good-quality USB cable that supports stable data transfer.
+3. Connect the cable directly to the host PC. Avoid USB hubs.
+4. Put the Jetson into recovery mode again and reconnect power if needed.
+5. Make sure the host OS matches the JetPack version:
+   - JetPack 5.x: Ubuntu 18.04 or 20.04 is recommended.
+   - JetPack 6.x: Ubuntu 20.04 or 22.04 is recommended.
+
+## Error: USB Timeout During Flashing
+
 <div align="center">
   <img width ="800" src="https://files.seeedstudio.com/wiki/reComputer-Jetson/FAQ/timeout_issue.png"/>
 </div>
 
-There are several reasons that may cause a timeout issue during the process of flashing the Jetson device via the command line:
+Typical symptoms include messages such as:
+
+```text
+ERROR: might be timeout in usb write
+```
+
+or the device disconnecting during the flashing process.
+
+### Why this happens
+
+During flashing, the Jetson may reboot and re-enumerate over USB. On a physical Ubuntu host, this is usually reconnected automatically. In a VM or WSL environment, you often need to reattach the device manually, and this can cause timeout failures.
+
+### What to check
+
+1. Confirm whether the host is a physical Ubuntu PC, a VM, or WSL.
+2. If you are using a VM, manually reconnect the Jetson USB device after it reboots during flashing.
+3. If you are using WSL, re-attach the device after reconnect. For setup details, refer to [Flash JetPack with WSL2](/ai_robotics_flash_jetpack_with_wsl2/).
+4. Confirm the DC power adapter can provide sufficient power for the Jetson device.
+5. Switch to another high-quality USB Type-C cable. The cable should support at least USB 2.0 data communication and should ideally be shorter than 1.5 meters.
+6. Try another USB-A port on the host.
+7. Avoid using USB hubs, as they may reduce connection stability during flashing.
+8. Confirm that you selected the correct flashing package for the target Jetson product and JetPack version.
+9. Re-enter recovery mode and reconnect power before trying again.
+10. After checking the items above, restart the flashing script and try again.
+
+### Recommendation
+
+We strongly recommend using a dedicated physical Ubuntu host for flashing.
+
+## Error: NFS Mount Failure During Flashing
+
+<div align="center">
+  <img width ="800" src="https://files.seeedstudio.com/wiki/reComputer-Jetson/FAQ/nfs_error.png"/>
+</div>
+
+Typical logs may include:
+
+```text
+Formatting APP partition /dev/nvme0n1p1 ...
+tar --checkpoint-action="ttyout=Hit %s checkpoint #%u%*\r" -x -I 'zstd -T0' -pf /mnt/external/system.img --warning=no-timestamp --numeric-owner --xattrs --xattrs-include=* -C /tmp/ci-EUsLOiqBxk
+Flash failure
+Either the device cannot mount the NFS server on the host or a flash command has failed.
+Check your network setting (VPN, firewall,...) to make sure the device can mount NFS server.
+```
+
+Reference:
+[Flash fails Orin AGX at 99% - NVIDIA Developer Forums](https://forums.developer.nvidia.com/t/either-the-device-cannot-mount-the-nfs-server-on-the-host-or-a-flash-command-has-failed-while-using-sdk-manager/312719/3)
+
+### Why this happens
+
+When using initrd flash, Jetson mounts an NFS share exported by the host PC through the USB0 network interface. If the host NFS service is unavailable, blocked by firewall rules, or the host environment is unstable, the flash can fail near the end.
+
+### Checklist
+
+1. Make sure the NFS server is running on the Ubuntu host:
+
+```bash
+systemctl status nfs-kernel-server
+```
+
+2. Disable the Ubuntu firewall temporarily and test again:
+
+```bash
+sudo ufw status
+sudo ufw disable
+```
+
+3. Avoid VM, Docker, and WSL environments.
+4. Format the NVMe SSD to `ext4` before use.
+5. Install the required dependencies on the host:
+
+```bash
+sudo apt install qemu-user-static sshpass abootimg nfs-kernel-server libxml2-utils binutils -y
+```
+
+6. Check that the host PC has enough free disk space. NFS mount failures can also happen when host storage is insufficient.
+7. If the issue persists, test with a validated SSD model. Seeed SSD reference:
+[NVMe M.2 2280 SSD 256GB](https://www.seeedstudio.com/NVMe-M-2-2280-SSD-256GB-p-5333.html)
+
+## Error: `The connected jetson device is not ready for flash: Stat for blob_boot0.imgimg failed`
+
+The key line is:
+
+```text
+Stat for blob_boot0.imgimg failed Error: Return value 19
+```
+
+### Why this happens
+
+In practice, this usually means the host environment used to generate the boot blob is not compatible with the flashing toolchain. We have seen this on Ubuntu 24.04 hosts.
+
+### Recommended fix
+
+Use Ubuntu 20.04 or Ubuntu 22.04 as the flashing host instead of Ubuntu 24.04.
+
+## Error: `could not find tegrarcm_v2`
+
+<div align="center">
+  <img width ="800" src="https://files.seeedstudio.com/wiki/reComputer-Jetson/FAQ/tegrarcm_v2_failed.jpg"/>
+</div>
+
+Typical log:
+
+```text
+Error: could not find tegrarcm_v2
+```
+
+### Why this happens
+
+The flashing package and MFI flashing tool are intended for an x86 host. This error often appears when users try to flash from another Jetson device or another unsupported host architecture.
+
+### Recommended fix
+
+Use an x86 Ubuntu host PC for flashing.
+
+## Error: Stuck At OEM Configuration After First Boot
+
+<div align="center">
+  <img width ="800" src="https://files.seeedstudio.com/wiki/reComputer-Jetson/FAQ/oem_failed.png"/>
+</div>
+
+Typical message:
+
+```text
+(1 of 2) A start job is running for End-user configuration after initial OEM installation (Debconf UI)
+```
+
+### Why this happens
+
+This usually means the OEM setup service is waiting for user interaction, but no usable display path is available. This commonly happens when the HDMI display was not connected at the first boot and was attached later.
+
+### What to do
+
+1. Power off the Jetson.
+2. Disconnect unnecessary peripherals.
+3. Keep only the HDMI monitor and power connected.
+4. Reboot the device.
+5. If needed, reboot a few more times.
 
-1. **Abnormalities with the Ubuntu host PC used for flashing:** A typical example is flashing through an Ubuntu virtual machine. Due to USB stability issues in virtual machines, timeouts are often encountered.
-2. **Insufficient power supply from the DC power adapter:** The power output needs to meet the requirements of the Jetson device. You can check this parameter on the product details page of Seeed Bazaar.
-3. **Quality issues with the Type-C cable:** Although flashing can be done via USB 2.0, the quality of the cable affects the stability of the process. Based on practical experience, two key points for the cable are: (a) it should at least support USB 2.0 communication, and (b) the cable length should be shorter than 1.5m.
-4. **Avoid using USB hubs:** Some USB hubs may affect the stability of data transmission during the flashing process.
-5. **Incorrect flashing package selection:** Please verify that the correct flashing package is selected and restart the flashing script.
+## Additional Notes
 
-Please check the issues mentioned above and try restarting the flashing script.
+- If the device reboots during flashing, this can be expected. The important part is whether the host re-detects and reconnects the Jetson correctly.
+- If you are flashing to NVMe, confirm the target drive is healthy and already formatted properly.
+- If you use SDK Manager, also review the terminal details for the exact failing component.
 
 ## Tech Support & Product Discussion
 
 Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.
 
 <div class="button_tech_support_container">
-<a href="https://forum.seeedstudio.com/" class="button_forum"></a> 
+<a href="https://forum.seeedstudio.com/" class="button_forum"></a>
 <a href="https://www.seeedstudio.com/contacts" class="button_email"></a>
 </div>
 
 <div class="button_tech_support_container">
-<a href="https://discord.gg/eWkprNDMU7" class="button_discord"></a> 
+<a href="https://discord.gg/eWkprNDMU7" class="button_discord"></a>
 <a href="https://github.com/Seeed-Studio/wiki-documents/discussions/69" class="button_discussion"></a>
 </div>

sites/en/docs/Edge/NVIDIA_Jetson/FAQs/jetson_FAQ.md

@@ -34,7 +34,7 @@ For details, please click [here](/Use_IMX477_Camera_with_A603_Jetson_Carrier_Boa
 
 For details, please click [here](/get_the_system_log_of_recomputer_j30_and_j40)
 
-#### Q6: Timeout issue during flash Jetpack.
+#### Q6: Common flashing errors during Jetson flashing.
 
 For details, please click [here](/usb_timeout_during_flash)