Skip to content
Closed
15 changes: 15 additions & 0 deletions docs/dragon/q6a/hardware-use/hardware-info.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
2 changes: 1 addition & 1 deletion docs/e/e20c/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
84 changes: 84 additions & 0 deletions docs/orion/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,3 +49,87 @@ sudo reboot
</NewCodeBlock>

说明:禁用后将释放 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 电源管理设置:
<NewCodeBlock tip="Linux$" type="host">

```bash
# 禁用 USB 自动挂起
echo 'on' | sudo tee /sys/bus/usb/devices/*/power/control

# 禁用 USB3 链路电源管理
echo '0' | sudo tee /sys/module/usbcore/parameters/autosuspend
```

</NewCodeBlock>

#### 3. 更新系统:
<NewCodeBlock tip="Linux$" type="host">

```bash
sudo apt update
sudo apt upgrade
```

</NewCodeBlock>

#### 4. 检查内核版本:
<NewCodeBlock tip="Linux$" type="host">

```bash
uname -r
# 确保使用最新支持的内核版本
```

</NewCodeBlock>

#### 5. 添加内核启动参数(临时):
在 `/boot/extlinux/extlinux.conf` 中添加:
```
usbcore.autosuspend=-1 usb-storage.quirks=...
```

#### 6. 收集诊断信息:
<NewCodeBlock tip="Linux$" type="host">

```bash
# 检查 USB 拓扑
lsusb -t

# 监控内核日志
sudo dmesg -w

# 检查特定设备信息
sudo lsusb -v -d 04b4:00f1
```

</NewCodeBlock>

### 如果问题仍然存在:
如果以上步骤无法解决问题,这可能是一个需要进一步调查的技术问题。请提供以下信息以便技术支持:

1. 完整的 `dmesg` 日志
2. `lsusb -t` 和 `lsusb -v` 输出
3. 使用的具体镜像版本和内核版本
4. 复现问题的详细步骤
Original file line number Diff line number Diff line change
Expand Up @@ -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
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
84 changes: 84 additions & 0 deletions i18n/en/docusaurus-plugin-content-docs/current/orion/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,3 +49,87 @@ sudo reboot
</NewCodeBlock>

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:
<NewCodeBlock tip="Linux$" type="host">

```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
```

</NewCodeBlock>

#### 3. Update system:
<NewCodeBlock tip="Linux$" type="host">

```bash
sudo apt update
sudo apt upgrade
```

</NewCodeBlock>

#### 4. Check kernel version:
<NewCodeBlock tip="Linux$" type="host">

```bash
uname -r
# Ensure using the latest supported kernel version
```

</NewCodeBlock>

#### 5. Add kernel boot parameters (temporary):
Add to `/boot/extlinux/extlinux.conf`:
```
usbcore.autosuspend=-1 usb-storage.quirks=...
```

#### 6. Collect diagnostic information:
<NewCodeBlock tip="Linux$" type="host">

```bash
# Check USB topology
lsusb -t

# Monitor kernel logs
sudo dmesg -w

# Check specific device information
sudo lsusb -v -d 04b4:00f1
```

</NewCodeBlock>

### 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