radxa-docs · Milir-Radxa · Jun 22, 2026
@@ -0,0 +1,7 @@
+---
+sidebar_position: 3
+---
+
+# 硬件使用
+
+<DocCardList />
@@ -0,0 +1,20 @@
+---
+sidebar_position: 16
+---
+
+# EDL 按键
+
+瑞莎 Dragon Q8B 板载 EDL 按键，用于进入 EDL 模式，EDL 模式是高通处理器设备中的一种紧急下载模式，主要用于紧急修复、刷写固件或解锁设备。
+
+## 使用指南
+
+主板上电的过程中检测到 EDL 按键被按下，主板将进入 EDL 模式。
+
+详细步骤：
+
+1. 按住 EDL 按键
+2. 连接 20V Type-C 电源适配器（兼容 PD 协议）
+3. 松开 EDL 按键
+
+正常情况下，主板会进入 EDL 模式。
+
@@ -0,0 +1,28 @@
+---
+sidebar_position: 1
+---
+
+# 硬件信息
+
+## 系统框图
+
+<div style={{textAlign: 'center'}}>
+   <img src="/img/dragon/q8b/q8b_block_diagram.webp" style={{width: '100%', maxWidth: '1200px'}} />
+</div>
+
+## 接口说明
+
+<div style={{textAlign: 'center'}}>
+   <img src="/img/dragon/q8b/q8b_interface.webp" style={{width: '100%', maxWidth: '1200px'}} />
+</div>
+
+| 序号 | 说明                                   | 序号 | 说明                              | 序号 | 说明                         |
+| :--: | :------------------------------------- | :--: | :-------------------------------- | :--: | :--------------------------- |
+|  1   | 40-Pin GPIO 排针                       |  2   | LPDDR4X 内存                      |  3   | FPC 接口                     |
+|  4   | 高通骁龙 8cx Gen 3 (高通 SC8280XP)   |  5   | 麦克风接口                        |  6   | 电源排针                     |
+|  7   | 3.5 mm 耳机插孔                        |  8   | USB Type-C 供电接口（20V）        |  9   | HDMI 2.1 接口                |
+|  10  | USB 2.0 Type-A 接口                    |  11  | UFS 模块接口                      |  12  | 2x USB-C（支持 DP Alt 模式） |
+|  13  | EDL 按键                               |  14  | 风扇接口                          |  15  | M.2 E Key 插槽               |
+|  16  | RTC 电池接口                           |  17  | 2.5GbE 以太网接口                 |  18  | 2x USB 3.2 Gen2 Type-A 接口  |
+|  19  | M.2 M Key 2280 插槽 <br/>- PCIe 3.0 x2 |  20  | M.2 M Key 插槽 <br/>- PCIe 3.0 x4 |  21  | microSD 卡槽                 |
+
@@ -0,0 +1,17 @@
+---
+sidebar_position: 8
+---
+
+# HDMI 输出
+
+瑞莎 Dragon Q8B 板载 HDMI 输出接口，可以连接显示器、电视等设备输出画面。
+
+## 硬件连接
+
+将 HDMI 数据线连接到 Dragon Q8B 的 HDMI 接口，另一端连接到显示器、电视等设备的 HDMI 接口。
+
+:::tip
+部分显示器可能存在不兼容情况，可以尝试更换其他显示器测试。
+
+可以参考 [硬件信息](./hardware-info) 教程找到对应硬件接口位置。
+:::
@@ -0,0 +1,28 @@
+---
+sidebar_position: 3
+---
+
+# microSD 卡槽
+
+瑞莎 Dragon Q8B 板载 microSD 卡槽，兼容 microSD / microSDHC / microSDXC 卡，可用作系统启动盘或扩展存储空间。
+
+## 硬件连接
+
+将 microSD 卡安装到瑞莎 Dragon Q8B 的 microSD 卡槽上。
+
+:::tip 接口位置
+可以参考 [硬件信息](./hardware-info) 教程找到对应硬件接口位置
+:::
+
+## 使用指南
+
+microSD 卡可以作为系统启动介质，也可以作为扩展存储空间。
+
+### 系统启动介质
+
+microSD 卡存在正常启动的系统时，瑞莎 Dragon Q8B 会默认从 microSD 卡启动系统。
+
+### 拓展存储空间
+
+microSD 卡不存在系统或者通过其他系统启动介质启动系统，microSD 卡将作为拓展存储空间。
+
@@ -0,0 +1,33 @@
+---
+sidebar_position: 13
+---
+
+# 电源按键 / 引脚
+
+瑞莎 Dragon Q8B 板载电源按键（PER_BTN）和引出电源（PWR）引脚，用于控制主板电源的开关。
+
+① : 电源按键
+
+② : PWR 引脚
+
+<div style={{textAlign: 'center'}}>
+   <img src="/img/dragon/q8b/q8b_power_header.webp" style={{width: '80%', maxWidth: '1200px'}} />
+</div>
+
+## 使用指南
+
+### 电源按键
+
+主板在关机状态，按下电源按键，主板启动。
+
+主板在开机状态，按下电源按键，系统默认进入睡眠模式。
+
+说明：按下电源按键触发的状态可以在系统设置中修改：`Power` -> `Power Button Behavior`，可选择的状态有：`Suspend`、`Power off`、`Nothing`。
+
+### PWR 引脚
+
+主板在关机状态，PWR 引脚和 GND 引脚短接一下，主板启动。
+
+主板在开机状态，PWR 引脚和 GND 引脚短接一下，系统默认进入睡眠模式。
+
+说明：短接电源引脚触发的状态可以在系统设置中修改：`Power` -> `Power Button Behavior`，可选择的状态有：`Suspend`、`Power off`、`Nothing`。
@@ -0,0 +1,165 @@
+---
+sidebar_position: 7
+---
+
+# USB-A / C 接口
+
+瑞莎 Dragon Q8B 板载 3 个 USB-C、2 个 USB 2.0 Type-A 和 2 个 USB 3.2 Gen2 Type-A 接口。
+
+<div style={{textAlign: 'center'}}>
+   <img src="/img/dragon/q8b/q8b_usb.webp" style={{width: '80%', maxWidth: '1200px'}} />
+</div>
+
+1. USB-C 接口
+
+仅支持 20 V 给主板供电，兼容 PD 协议。
+
+2. 2x USB-C 接口
+
+支持刷机和 DP Alt 模式。
+
+3. USB 2.0 Type-A 接口
+
+理论上最大传输速率为 480Mbps，接口内部颜色为黑色。
+
+4. USB 3.2 Gen2 Type-A 接口
+
+理论上最大传输速率为 10Gbps，接口内部颜色为蓝色。
+
+## 硬件连接
+
+测试 USB 接口的 HOST 模式功能，我们可以测试 USB 接口连接的设备基础功能和 U 盘读写速度。
+
+### 基础功能
+
+我们可以给 USB 接口连接读卡器、鼠标、键盘等设备，通过插拔测试设备是否正常识别和使用。
+
+#### 未接外设
+
+使用 `lsusb` 命令查看当前系统识别的设备。
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```bash
+lsusb
+```
+
+</NewCodeBlock>
+
+终端输出示例：
+
+```text
+Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+Bus 001 Device 003: ID 1a86:8091 QinHeng Electronics USB HUB
+Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+Bus 005 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+Bus 006 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+```
+
+#### 已接外设
+
+连接读卡器、鼠标、键盘等设备到 USB 接口，使用 `lsusb` 命令查看是否新增设备。
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```bash
+lsusb
+```
+
+</NewCodeBlock>
+
+终端输出示例：我在 USB 接口连接了一个读卡器
+
+```text
+Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+Bus 001 Device 003: ID 1a86:8091 QinHeng Electronics USB HUB
+Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+Bus 002 Device 002: ID 3535:6300 aigo     U330    
+Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+Bus 005 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+Bus 006 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+```
+
+通过两者的输出信息对比，可以确定新增的 USB 设备被正常识别，新增的设备 ID 为 `3535:6300`。
+
+正常识别 USB 设备后，您就可以使用设备验证功能是否正常。
+
+### 读写测试
+
+使用 U 盘连接到 USB 接口，使用 `dd` 命令测试 U 盘读写速度。
+
+#### 确认存储设备
+
+使用 `lsblk` 命令确认 U 盘的设备名称。
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```bash
+lsblk
+```
+
+</NewCodeBlock>
+
+终端输出示例：其中 `sda` 为 我当前 U 盘设备名称，请根据实际情况替换。
+
+```text
+NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
+sda           8:0    1  29.3G  0 disk
+├─sda1        8:1    1    16M  0 part
+└─sda2        8:2    1  29.3G  0 part
+```
+
+#### 测试写入性能
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```bash
+sudo dd if=/dev/zero of=/dev/sda bs=1M count=100
+```
+
+</NewCodeBlock>
+
+- `dd` : Linux 系统中的一个命令行工具，用于复制和转换文件。
+- `if=/dev/zero` : 指定输入文件为 `/dev/zero`，这是一个特殊的文件，会提供无限的零字节数据。
+- `of=/dev/sda` : 指定输出文件为 `/dev/sda`，即 U 盘设备。
+- `bs=1M` : 指定块大小为 1MB。
+- `count=100` : 指定复制 100 个块。
+
+这个命令会将 100MB 的零字节数据写入 U 盘，显示写入速度。
+
+终端输出示例：
+
+```text
+100+0 records in
+100+0 records out
+104857600 bytes (105 MB, 100 MiB) copied, 0.0680485 s, 1.5 GB/s
+```
+
+#### 测试读取性能
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```bash
+sudo dd if=/dev/sda of=/dev/null bs=1M count=100
+```
+
+</NewCodeBlock>
+
+- `dd` : Linux 系统中的一个命令行工具，用于复制和转换文件。
+- `if=/dev/sda` : 指定输入文件为 `/dev/sda`，即 U 盘设备。
+- `of=/dev/null` : 指定输出文件为 `/dev/null`，这是一个特殊的文件，会丢弃所有写入的数据。
+- `bs=1M` : 指定块大小为 1MB。
+- `count=100` : 指定复制 100 个块。
+
+这个命令会将 U 盘的 100MB 数据读取到 `/dev/null`，并显示读取速度。
+
+终端输出示例：
+
+```text
+100+0 records in
+100+0 records out
+104857600 bytes (105 MB, 100 MiB) copied, 0.016431 s, 6.6 GB/s
+```
@@ -0,0 +1,7 @@
+---
+sidebar_position: 3
+---
+
+# Hardware Use
+
+<DocCardList />
@@ -0,0 +1,19 @@
+---
+sidebar_position: 16
+---
+
+# EDL Button
+
+The Radxa Dragon Q8B has an onboard EDL button for entering EDL mode. EDL mode is an emergency download mode for Qualcomm processor devices, mainly used for emergency recovery, firmware flashing, or device unlocking.
+
+## User Guide
+
+If the EDL button is detected as pressed while the motherboard is powering on, the motherboard will enter EDL mode.
+
+Detailed steps:
+
+1. Press and hold the EDL button
+2. Connect a 20V Type-C power adapter compatible with the PD protocol
+3. Release the EDL button
+
+Normally, the motherboard will enter EDL mode.
@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+---
+
+# Hardware Information
+
+## System Block Diagram
+
+<div style={{textAlign: 'center'}}>
+   <img src="/en/img/dragon/q8b/q8b_block_diagram.webp" style={{width: '100%', maxWidth: '1200px'}} />
+</div>
+
+## Interface Description
+
+<div style={{textAlign: 'center'}}>
+   <img src="/en/img/dragon/q8b/q8b_interface.webp" style={{width: '100%', maxWidth: '1200px'}} />
+</div>
+
+| No. | Description                            | No. | Description                       | No. | Description                      |
+| :-: | :------------------------------------- | :-: | :-------------------------------- | :-: | :------------------------------- |
+|  1  | 40-pin GPIO header                     |  2  | LPDDR4X memory                    |  3  | FPC connector                    |
+|  4  | Qualcomm Snapdragon 8cx Gen 3 (Qualcomm SC8280XP) |  5  | Microphone connector              |  6  | Power header                     |
+|  7  | 3.5 mm headphone jack                  |  8  | USB Type-C power port (20V)       |  9  | HDMI 2.1 port                    |
+| 10  | USB 2.0 Type-A port                    | 11  | UFS module connector              | 12  | 2x USB-C (DP Alt Mode supported) |
+| 13  | EDL button                             | 14  | Fan connector                     | 15  | M.2 E Key slot                   |
+| 16  | RTC battery connector                  | 17  | 2.5GbE Ethernet port              | 18  | 2x USB 3.2 Gen2 Type-A ports     |
+| 19  | M.2 M Key 2280 slot <br/>- PCIe 3.0 x2 | 20  | M.2 M Key slot <br/>- PCIe 3.0 x4 | 21  | microSD card slot                |
@@ -0,0 +1,17 @@
+---
+sidebar_position: 8
+---
+
+# HDMI Output
+
+The Radxa Dragon Q8B has an onboard HDMI output port, which can connect to monitors, TVs, and other devices for video output.
+
+## Hardware Connection
+
+Connect an HDMI cable to the HDMI port on the Dragon Q8B, and connect the other end to the HDMI port of a monitor, TV, or other display device.
+
+:::tip
+Some monitors may have compatibility issues. Try using another monitor for testing.
+
+You can refer to the [Hardware Information](./hardware-info) guide to locate the corresponding hardware interface.
+:::