diff --git a/docs/dragon/q6a/hardware-use/hardware-info.md b/docs/dragon/q6a/hardware-use/hardware-info.md index e389fcc26..499cbfad4 100644 --- a/docs/dragon/q6a/hardware-use/hardware-info.md +++ b/docs/dragon/q6a/hardware-use/hardware-info.md @@ -27,3 +27,18 @@ sidebar_position: 1 | 19 | 2x USB 2.0 Type-A 接口 | 20 | EDL 按键 | 21 | 耳机插孔 | | 22 | 标准 HDMI | 23 | eMMC & UFS 模块二合一接口 | 24 | RTC 电池接口 | | 25 | 2x MIPI CSI(2 通道) | | | | | + +## M.2 M Key 插槽安装说明 + +Dragon Q6A 的 M.2 M Key 插槽支持 **M.2 2230** 尺寸的 NVMe SSD。 + +### 安装步骤: +1. 将 M.2 2230 NVMe SSD 以约 30° 角度插入 M.2 插槽 +2. 轻轻按下 SSD 使其与插槽接触良好 +3. 使用 **M2×3.5mm** 螺丝将 SSD 固定到主板上 + +### 注意事项: +- 确保使用正确的螺丝尺寸(M2×3.5mm) +- 不要过度拧紧螺丝,以免损坏 SSD 或主板 +- Dragon Q6A 仅支持 **M.2 2230** 尺寸,不支持更长的 2242、2260 或 2280 尺寸 +- 该插槽仅支持 NVMe 协议 SSD,不支持 SATA 协议 M.2 SSD diff --git a/docs/e/e20c/download.md b/docs/e/e20c/download.md index 24f17863e..797abd360 100644 --- a/docs/e/e20c/download.md +++ b/docs/e/e20c/download.md @@ -10,7 +10,7 @@ import Images from "./\_image.mdx" iStoreOS: -[istoreos-22.03.6-2024062810-e20c-squashfs.img.gz](https://dl.radxa.com/rock2/images/istoreos/istoreos-22.03.6-2024062810-e20c-squashfs.img.gz) +[istoreos-22.03.6-2024062810-e20c-squashfs.img.gz](https://site.istoreos.com/firmware/download?devicename=e20c) Radxa OS: diff --git a/docs/orion/faq.md b/docs/orion/faq.md index 133ba81b8..8d963edb2 100644 --- a/docs/orion/faq.md +++ b/docs/orion/faq.md @@ -49,3 +49,87 @@ sudo reboot 说明:禁用后将释放 NPU 预留内存,如需恢复,删除 blacklist 配置并重启即可。 + +## 2.USB3 批量传输期间设备断开/重新枚举问题 + +在使用 Cypress FX3 等 USB3 设备进行高吞吐量批量传输时,可能会遇到设备断开并重新枚举的问题,导致 `LIBUSB_ERROR_NO_DEVICE` 错误。 + +### 常见症状: +- 设备在批量传输开始后约 1 秒断开连接 +- 内核日志显示:`usb 6-1: USB disconnect, device number 3` 后立即出现 `usb 6-1: new SuperSpeed USB device number 4 using xhci-hcd` +- 程序报告 `LIBUSB_ERROR_NO_DEVICE` 错误 + +### 可能原因: +1. **电源稳定性**:USB3 设备在高速传输时可能超过端口电流限制 +2. **USB3 链路电源管理**:U1/U2 状态切换可能导致不稳定 +3. **xHCI 驱动/固件问题**:某些内核版本可能存在兼容性问题 + +### 建议的排查步骤: + +#### 1. 检查电源供应: +- 使用高质量的外接电源(5V/4A 或更高) +- 对于高功耗设备,考虑使用带外接电源的 USB3 集线器 +- 确保 USB 线缆符合规范且质量良好 + +#### 2. 调整 USB 电源管理设置: + + +```bash +# 禁用 USB 自动挂起 +echo 'on' | sudo tee /sys/bus/usb/devices/*/power/control + +# 禁用 USB3 链路电源管理 +echo '0' | sudo tee /sys/module/usbcore/parameters/autosuspend +``` + + + +#### 3. 更新系统: + + +```bash +sudo apt update +sudo apt upgrade +``` + + + +#### 4. 检查内核版本: + + +```bash +uname -r +# 确保使用最新支持的内核版本 +``` + + + +#### 5. 添加内核启动参数(临时): +在 `/boot/extlinux/extlinux.conf` 中添加: +``` +usbcore.autosuspend=-1 usb-storage.quirks=... +``` + +#### 6. 收集诊断信息: + + +```bash +# 检查 USB 拓扑 +lsusb -t + +# 监控内核日志 +sudo dmesg -w + +# 检查特定设备信息 +sudo lsusb -v -d 04b4:00f1 +``` + + + +### 如果问题仍然存在: +如果以上步骤无法解决问题,这可能是一个需要进一步调查的技术问题。请提供以下信息以便技术支持: + +1. 完整的 `dmesg` 日志 +2. `lsusb -t` 和 `lsusb -v` 输出 +3. 使用的具体镜像版本和内核版本 +4. 复现问题的详细步骤 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware-info.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware-info.md index 932daad00..ddc83f21b 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware-info.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware-info.md @@ -27,3 +27,18 @@ sidebar_position: 1 | 19 | 2x USB 2.0 Type-A ports | 20 | EDL button | 21 | Headphone jack | | 22 | Standard HDMI | 23 | eMMC & UFS module connector | 24 | RTC battery connector | | 25 | 2x MIPI CSI (2 Lane) | | | | | + +## M.2 M Key Slot Installation Guide + +The M.2 M Key slot on Dragon Q6A supports **M.2 2230** sized NVMe SSDs. + +### Installation Steps: +1. Insert the M.2 2230 NVMe SSD into the M.2 slot at approximately 30° angle +2. Gently press down the SSD to ensure good contact with the slot +3. Secure the SSD to the board using an **M2×3.5mm** screw + +### Notes: +- Ensure you use the correct screw size (M2×3.5mm) +- Do not overtighten the screw to avoid damaging the SSD or motherboard +- Dragon Q6A only supports **M.2 2230** size, longer sizes like 2242, 2260, or 2280 are not supported +- This slot only supports NVMe protocol SSDs, SATA protocol M.2 SSDs are not supported diff --git a/i18n/en/docusaurus-plugin-content-docs/current/e/e20c/download.md b/i18n/en/docusaurus-plugin-content-docs/current/e/e20c/download.md index a5b8a9e37..51cf8c3d3 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/e/e20c/download.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/e/e20c/download.md @@ -10,7 +10,7 @@ import Images from "./\_image.mdx" iStoreOS: -[istoreos-22.03.6-2024062810-e20c-squashfs.img.gz](https://dl.radxa.com/rock2/images/istoreos/istoreos-22.03.6-2024062810-e20c-squashfs.img.gz) +[istoreos-22.03.6-2024062810-e20c-squashfs.img.gz](https://site.istoreos.com/firmware/download?devicename=e20c) Radxa OS: diff --git a/i18n/en/docusaurus-plugin-content-docs/current/orion/faq.md b/i18n/en/docusaurus-plugin-content-docs/current/orion/faq.md index 54c64815a..4106f56a7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/orion/faq.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/orion/faq.md @@ -49,3 +49,87 @@ sudo reboot Note: Disabling will free the memory reserved for NPU. To restore, delete the blacklist configuration and reboot. + +## 2.USB3 bulk transfer device disconnect/re-enumeration issue + +When performing high-throughput bulk transfers with USB3 devices like Cypress FX3, you may encounter device disconnection and re-enumeration, resulting in `LIBUSB_ERROR_NO_DEVICE` errors. + +### Common symptoms: +- Device disconnects approximately 1 second after bulk transfer starts +- Kernel logs show: `usb 6-1: USB disconnect, device number 3` immediately followed by `usb 6-1: new SuperSpeed USB device number 4 using xhci-hcd` +- Program reports `LIBUSB_ERROR_NO_DEVICE` error + +### Possible causes: +1. **Power stability**: USB3 devices may exceed port current limits during high-speed transfers +2. **USB3 link power management**: U1/U2 state transitions may cause instability +3. **xHCI driver/firmware issues**: Certain kernel versions may have compatibility problems + +### Recommended troubleshooting steps: + +#### 1. Check power supply: +- Use a high-quality external power supply (5V/4A or higher) +- For high-power devices, consider using a powered USB3 hub +- Ensure USB cables are specification-compliant and of good quality + +#### 2. Adjust USB power management settings: + + +```bash +# Disable USB autosuspend +echo 'on' | sudo tee /sys/bus/usb/devices/*/power/control + +# Disable USB3 link power management +echo '0' | sudo tee /sys/module/usbcore/parameters/autosuspend +``` + + + +#### 3. Update system: + + +```bash +sudo apt update +sudo apt upgrade +``` + + + +#### 4. Check kernel version: + + +```bash +uname -r +# Ensure using the latest supported kernel version +``` + + + +#### 5. Add kernel boot parameters (temporary): +Add to `/boot/extlinux/extlinux.conf`: +``` +usbcore.autosuspend=-1 usb-storage.quirks=... +``` + +#### 6. Collect diagnostic information: + + +```bash +# Check USB topology +lsusb -t + +# Monitor kernel logs +sudo dmesg -w + +# Check specific device information +sudo lsusb -v -d 04b4:00f1 +``` + + + +### If the issue persists: +If the above steps don't resolve the issue, this may be a technical problem requiring further investigation. Please provide the following information for technical support: + +1. Complete `dmesg` logs +2. `lsusb -t` and `lsusb -v` outputs +3. Specific image version and kernel version used +4. Detailed steps to reproduce the issue