Skip to content

Commit 97587cd

Browse files
authored
Merge pull request #889 from nascs/fix_dragon_q6a
Fix dragon q6a
2 parents 2bae674 + 5c370e5 commit 97587cd

10 files changed

Lines changed: 40 additions & 220 deletions

File tree

docs/dragon/q6a/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Dragon Q6A 搭载高通 QCS6490 SoC,采用 “1+3+4” 三丛集设计(1× K
3333
| USB | USB 3.1:1× Type-A HOST / OTG<br/> USB 2.0:3× Type-A HOST |
3434
| 拓展 | 40 Pin GPIO 排针:支持 UART、SPI、I2C 等<br/> 风扇接口:1× 2-pin 1.25mm <br/> 按键:Power 按键、EDL 按键 |
3535
| 供电方式 | 支持 USB Type-C 12V 供电 <br/> 支持外部 12V 引脚供电 <br/> 支持 PoE 供电(需外接 PoE HAT) |
36-
| 支持系统 | Ubuntu Linux <br/> Qualcomm Linux(基于 Yocto 开发) <br/> Android™ 13 系统 |
36+
| 支持系统 | Ubuntu Linux <br/> Qualcomm Linux(基于 Yocto 开发) <br/> Android 15 (CS) 或 Android 16 (ES) 系统 |
3737

3838
## 接口说明
3939

@@ -76,4 +76,4 @@ Dragon Q6A 搭载高通 QCS6490 SoC,采用 “1+3+4” 三丛集设计(1× K
7676

7777
- Ubuntu Linux
7878
- Qualcomm Linux(基于 Yocto 开发)
79-
- Android 13
79+
- Android 15 (CS) 或 Android 16 (ES) 系统

docs/dragon/q6a/download.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,6 @@ Dragon Q6A 出厂默认烧录 SPI 启动固件,正常情况下无需烧录启
1818

1919
- [EDL-NG](https://dl.radxa.com/q6a/images/edl-ng-dist.zip)
2020

21-
- [SPI Flash Tool](https://dl.radxa.com/q6a/images/spinor_flash_tool.zip)
22-
2321
- [SPI 启动固件](https://dl.radxa.com/q6a/images/flat_build_250801.zip)
2422

2523
## 硬件设计

docs/dragon/q6a/hardware-use/edl.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,19 @@ sidebar_position: 16
44

55
# EDL 按键
66

7-
瑞莎 Dragon Q6A 板载 EDL 按键,用于进入 QDL 模式,QDL 模式是高通处理器设备中的一种紧急下载模式,主要用于紧急修复、刷写固件或解锁设备。
7+
瑞莎 Dragon Q6A 板载 EDL 按键,用于进入 EDL 模式,EDL 模式是高通处理器设备中的一种紧急下载模式,主要用于紧急修复、刷写固件或解锁设备。
88

99
## 使用指南
1010

11-
主板上电的过程中检测到 EDL 按键被按下,主板将进入 QDL 模式。
11+
主板上电的过程中检测到 EDL 按键被按下,主板将进入 EDL 模式。
1212

1313
详细步骤:
1414

1515
1. 按住 EDL 按键
1616
2. 连接 12V Type-C 电源适配器(兼容 PD 协议)
1717
3. 松开 EDL 按键
1818

19-
正常情况下,主板会进入 QDL 模式。
19+
正常情况下,主板会进入 EDL 模式。
2020

2121
## 接口引脚定义
2222

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
sidebar_position: 1
33
---
44

5-
# 进入 QDL 模式
5+
# 进入 EDL 模式
66

7-
高通 QDL(Qualcomm Download Mode)模式是高通处理器设备中的一种紧急下载模式,主要用于紧急修复、刷写固件或解锁设备。
7+
高通 EDL(Qualcomm Download Mode)模式是高通处理器设备中的一种紧急下载模式,主要用于紧急修复、刷写固件或解锁设备。
88

9-
## 进入 QDL 模式
9+
## 进入 EDL 模式
1010

11-
主板上电前,按住 EDL 按键;主板上电后,松开 EDL 按键,进入 QDL 模式。
11+
主板上电前,按住 EDL 按键;主板上电后,松开 EDL 按键,进入 EDL 模式。
1212

1313
具体操作步骤:
1414

@@ -20,9 +20,9 @@ sidebar_position: 1
2020

2121
④ : 使用双头 USB Type-A 数据线连接 Dragon Q6A 的 USB 3.1 Type-A 接口和电脑的 USB Type-A 接口
2222

23-
## 验证 QDL 模式
23+
## 验证 EDL 模式
2424

25-
<Tabs queryString = "qdlplatform">
25+
<Tabs queryString = "EDLplatform">
2626
<TabItem value="Windows" label="Windows" default>
2727
- 下载 EDL 工具
2828

@@ -50,7 +50,7 @@ sidebar_position: 1
5050

5151
</TabItem>
5252
<TabItem value="Linux" label="Linux">
53-
在 Linux 系统中,可以使用 `lsusb` 命令查看设备是否进入 QDL 模式。
53+
在 Linux 系统中,可以使用 `lsusb` 命令查看设备是否进入 EDL 模式。
5454

5555
<NewCodeBlock tip="Linux$" type="host">
5656

@@ -60,10 +60,10 @@ lsusb
6060

6161
</NewCodeBlock>
6262

63-
设备进入 QDL 模式后,会显示类似下面的信息:
63+
设备进入 EDL 模式后,会显示类似下面的信息:
6464

6565
```
66-
Bus 001 Device 008: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
66+
Bus 001 Device 008: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (EDL mode)
6767
```
6868

6969
</TabItem>

docs/dragon/q6a/low-dev/spi_fw.md

Lines changed: 6 additions & 94 deletions
Original file line numberDiff line numberDiff line change
@@ -10,85 +10,29 @@ sidebar_position: 6
1010
SPI启动固件(BootROM + 引导程序)的核心任务是分阶段初始化硬件(CPU → 内存 → 存储),最终通过存储设备加载操作系统内核。
1111
:::
1212

13-
当设备无法正常启动时,我们可以让设备进入 [QDL 模式](./qdl_mode),然后通过 EDL 工具烧录 SPI 启动固件。
13+
当设备无法正常启动时,我们可以让设备进入 [EDL 模式](./edl_mode),然后通过 EDL 工具烧录 SPI 启动固件。
1414

1515
进入 [资源汇总下载](../../download) 页面,下载 `edl-ng` 压缩包并解压,然后根据自己的系统平台选择对应的版本进行 SPI 固件的下载。
1616

17-
<Tabs queryString = "qdlplatform">
17+
<Tabs queryString = "EDLplatform">
1818
<TabItem value="Windows" label="Windows" default>
1919

20-
## 安装 edl-ng
21-
22-
- 确认当前 edl-ng 的位置
23-
24-
<img src="/img/dragon/q6a/spi_by_win_1.webp" style={{width: '80%', maxWidth: '1200px'}} />
25-
26-
如,当前位置为 **C:\Users\radxa\Desktop\edl-ng\windows-x64**
27-
28-
- 打开 **此电脑**,选择**属性**
29-
30-
<img src="/img/dragon/q6a/spi_by_win_2.webp" style={{width: '80%', maxWidth: '1200px'}} />
31-
32-
- 点击**高级系统设置**
33-
34-
<img src="/img/dragon/q6a/spi_by_win_3.webp" style={{width: '80%', maxWidth: '1200px'}} />
35-
36-
- 点击**环境变量**
37-
38-
<img src="/img/dragon/q6a/spi_by_win_4.webp" style={{width: '80%', maxWidth: '1200px'}} />
39-
40-
- 在**系统变量**中双击**Path**
41-
42-
<img src="/img/dragon/q6a/spi_by_win_5.webp" style={{width: '80%', maxWidth: '1200px'}} />
43-
44-
- 新建一个环境变量,变量名为 edl-ng 所在位置
45-
46-
<img src="/img/dragon/q6a/spi_by_win_6.webp" style={{width: '80%', maxWidth: '1200px'}} />
47-
48-
- 打开 **powershell**, 以管理员身份运行,输入 "edl-ng.exe --version", 看是否成功输出版本号
49-
50-
<img src="/img/dragon/q6a/spi_by_win_7.webp" style={{width: '80%', maxWidth: '1200px'}} />
51-
5220
## 烧录 Firmware
5321

54-
- [进入 QDL mode](qdl_mode)
55-
56-
- 打开**powershell**
57-
58-
<img src="/img/dragon/q6a/spi_by_win_8.webp" style={{width: '80%', maxWidth: '1200px'}} />
59-
60-
- 进入固件所在位置
61-
62-
<img src="/img/dragon/q6a/spi_by_win_9.webp" style={{width: '80%', maxWidth: '1200px'}} />
22+
- [进入 EDL mode](edl_mode)
6323

6424
- 输入以下命令进行烧录
6525

6626
<NewCodeBlock tip="Windows$" type="host">
6727

6828
```bash
6929

70-
edl-ng.exe rawprogram .\rawprogram0.xml -l .\prog_firehose_ddr.elf --memory=spinor write-part XBL_CONFIG xbl_config.elf
30+
.\edl-ng.exe --memory=spinor --loader C:\path\to\prog_firehose_ddr.elf rawprogram C:\path\to\rawprogram0.xml C:\path\to\patch0.xml
7131

7232
```
7333

7434
</NewCodeBlock>
7535

76-
<img src="/img/dragon/q6a/spi_by_win_10.webp" style={{width: '80%', maxWidth: '1200px'}} />
77-
78-
- 使用以下命令擦除
79-
80-
<NewCodeBlock tip="Windows$" type="host">
81-
82-
```bash
83-
84-
edl-ng.exe -l .\prog_firehose_ddr.elf --memory=spinor erase-part xbl
85-
86-
```
87-
88-
</NewCodeBlock>
89-
90-
<img src="/img/dragon/q6a/spi_by_win_11.webp" style={{width: '80%', maxWidth: '1200px'}} />
91-
9236
## FAQ
9337

9438
- 若提示 Unable to loda DLL 'libusb-1.0'
@@ -148,46 +92,14 @@ edl-ng --version
14892

14993
终端若是打印出版本信息,说明 `edl-ng` 工具设置软链接成功。
15094

151-
- 擦除 SPI 启动固件
95+
- 烧录 SPI 启动固件
15296

15397
进入 [资源汇总下载](../../download) 页面,下载 `spi firmware` 文件,然后解压进入到 `prog_firehose_ddr.elf` 文件所在目录并打开终端,使用 `edl-ng` 命令擦除 SPI 启动固件。
15498

15599
<NewCodeBlock tip="Linux$" type="host">
156100

157101
```
158-
sudo edl-ng --memory spinor erase-part xbl -l prog_firehose_ddr.elf
159-
```
160-
161-
</NewCodeBlock>
162-
163-
擦除成功后,终端会输出类似下面的信息:
164-
165-
```
166-
11:55:49.251 [INFO] Found device using LibUsbDotNet on Linux / MacOS.
167-
11:55:49.253 [INFO] Kernel driver is active on interface 0, attempting manual detach...
168-
11:55:49.253 [INFO] Manual detach successful.
169-
11:55:49.253 [INFO] Detected device mode: Sahara
170-
11:55:49.253 [INFO] Device is in Sahara mode. Uploading loader...
171-
11:55:49.254 [INFO] Serial Number: ACAB22CD
172-
11:55:49.254 [INFO] Product ID: 408 (QCS_KODIAK)
173-
11:55:49.355 [INFO] Uploading loader: ~/prog_firehose_ddr.elf
174-
11:55:49.556 [INFO] Loader uploaded and started successfully via Sahara.
175-
11:55:50.056 [INFO] Found device using LibUsbDotNet on Linux / MacOS.
176-
11:55:51.122 [INFO] Sending Firehose configure command...
177-
11:55:51.140 [INFO] Firehose configured for Memory: SPINOR, MaxPayload: 1048576
178-
179-
11:55:51.288 [INFO] Found partition 'xbl' on LUN 0 with sector size 4096.
180-
11:55:51.288 [INFO] Attempting to erase partition 'xbl' (LUN 0, LBA 52, 256 sectors)...
181-
11:55:58.699 [INFO] Successfully erased partition 'xbl' in 7.41s.
182-
183-
```
184-
185-
- 烧录 SPI 启动固件
186-
187-
<NewCodeBlock tip="Linux$" type="host">
188-
189-
```
190-
sudo edl-ng rawprogram rawprogram0.xml --loader=prog_firehose_ddr.elf --memory=spinor write-part XBL_CONFIG xbl_config.elf
102+
sudo edl-ng rawprogram rawprogram0.xml patch0.xml --loader=prog_firehose_ddr.elf --memory=spinor
191103
```
192104

193105
</NewCodeBlock>

i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ The Dragon Q6A is equipped with the Qualcomm QCS6490 SoC, featuring a “1+3+4
3333
| USB | USB 3.1:1× Type-A HOST / OTG<br/> USB 2.0:3× Type-A HOST |
3434
| Expansion | 40-Pin GPIO Header: Supports UART, SPI, I2C, etc. <br/> Fan Connector: 1× 2-pin 1.25mm <br/> Buttons: Power button, EDL button |
3535
| Power Supply | Supports USB Type-C 12V power input <br/> Supports external 12V pin power input <br/> Supports PoE power supply (requires an external PoE HAT) |
36-
| Supported OS | Ubuntu Linux <br/> Qualcomm Linux(Based on Yocto Development) <br/> Android™ 13 |
36+
| Supported OS | Ubuntu Linux <br/> Qualcomm Linux(Based on Yocto Development) <br/> Android 15 (CS) or Android 16 (ES) System |
3737

3838
## Interface Description
3939

@@ -76,4 +76,4 @@ Based on Qualcomm QCS6490 SoC, supports multiple operating systems:
7676

7777
- Ubuntu Linux
7878
- Qualcomm Linux (Based on Yocto development)
79-
- Android 13
79+
- Android 15 (CS) or Android 16 (ES) System

i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/download.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,6 @@ For detailed steps on flashing the SPI boot firmware, please refer to the [Flash
1818

1919
- [EDL-NG](https://dl.radxa.com/q6a/images/edl-ng-dist.zip)
2020

21-
- [SPI Flash Tool](https://dl.radxa.com/q6a/images/spinor_flash_tool.zip)
22-
2321
- [SPI Boot Firmware](https://dl.radxa.com/q6a/images/flat_build_250801.zip)
2422

2523
## Hardware Design

i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/edl.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,19 @@ sidebar_position: 16
44

55
# EDL Button
66

7-
The Radxa Dragon Q6A motherboard features an onboard EDL button, which is used to enter QDL mode. QDL mode is an emergency download mode in Qualcomm processor devices, primarily used for emergency repairs, firmware flashing, or device unlocking.
7+
The Radxa Dragon Q6A motherboard features an onboard EDL button, which is used to enter EDL mode. EDL mode is an emergency download mode in Qualcomm processor devices, primarily used for emergency repairs, firmware flashing, or device unlocking.
88

99
## Usage Guide
1010

11-
During the power-on process of the motherboard, if the EDL button is detected as being pressed, the motherboard will enter QDL mode.
11+
During the power-on process of the motherboard, if the EDL button is detected as being pressed, the motherboard will enter EDL mode.
1212

1313
Detailed steps:
1414

1515
1. Hold down the EDL button
1616
2. Connect a 12V Type-C power adapter (compatible with PD protocol)
1717
3. Release the EDL button
1818

19-
Under normal circumstances, the motherboard will enter QDL mode.
19+
Under normal circumstances, the motherboard will enter EDL mode.
2020

2121
## Interface Pin Definition
2222

i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/low-dev/qdl_mode.md renamed to i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/low-dev/edl_mode.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
sidebar_position: 1
33
---
44

5-
# Entering QDL Mode
5+
# Entering EDL Mode
66

7-
Qualcomm Download Mode (QDL) is an emergency download mode for Qualcomm processor devices, primarily used for emergency repairs, firmware flashing, or device unlocking.
7+
Qualcomm Download Mode (EDL) is an emergency download mode for Qualcomm processor devices, primarily used for emergency repairs, firmware flashing, or device unlocking.
88

9-
## Entering QDL Mode
9+
## Entering EDL Mode
1010

11-
Before powering on the motherboard, hold down the EDL button; after powering on the motherboard, release the EDL button to enter QDL mode.
11+
Before powering on the motherboard, hold down the EDL button; after powering on the motherboard, release the EDL button to enter EDL mode.
1212

1313
Specific steps:
1414

@@ -20,9 +20,9 @@ Specific steps:
2020

2121
④: Use a dual-headed USB Type-A data cable to connect the Dragon Q6A's USB 3.1 Type-A port to the computer's USB Type-A port
2222

23-
## Verify QDL Mode
23+
## Verify EDL Mode
2424

25-
<Tabs queryString = "qdlplatform">
25+
<Tabs queryString = "EDLplatform">
2626
<TabItem value="Windows" label="Windows" default>
2727
- Download the EDL tool
2828

@@ -50,7 +50,7 @@ Specific steps:
5050

5151
</TabItem>
5252
<TabItem value="Linux" label="Linux">
53-
In Linux systems, you can use the `lsusb` command to check whether the device has entered QDL mode.
53+
In Linux systems, you can use the `lsusb` command to check whether the device has entered EDL mode.
5454

5555
<NewCodeBlock tip="Linux$" type="host">
5656

@@ -60,10 +60,10 @@ lsusb
6060

6161
</NewCodeBlock>
6262

63-
After the device enters QDL mode, it will display information similar to the following:
63+
After the device enters EDL mode, it will display information similar to the following:
6464

6565
```
66-
Bus 001 Device 008: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
66+
Bus 001 Device 008: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (EDL mode)
6767
```
6868

6969
</TabItem>

0 commit comments

Comments
 (0)