From 75a4e343772693691c0b0d895da869f9be06e7d4 Mon Sep 17 00:00:00 2001
From: Tang Zaozao <tangzz@radxa.com>
Date: Fri, 7 Aug 2026 11:09:54 +0800
Subject: [PATCH] docs(airbox-q900): add QDL GitHub download link and Ubuntu
 udev rules for EDL verification

---
 docs/fogwise/airbox-q900/download.md          |  3 +-
 .../install-system/onboard-ufs.md             | 33 ++++++++++++++++++-
 .../current/fogwise/airbox-q900/download.md   |  3 +-
 .../install-system/onboard-ufs.md             | 33 ++++++++++++++++++-
 4 files changed, 68 insertions(+), 4 deletions(-)

diff --git a/docs/fogwise/airbox-q900/download.md b/docs/fogwise/airbox-q900/download.md
index 6457b5fd1..6b8ca69eb 100644
--- a/docs/fogwise/airbox-q900/download.md
+++ b/docs/fogwise/airbox-q900/download.md
@@ -24,7 +24,8 @@ sidebar_position: 150
 
 ## 软件工具
 
-- [QDL 工具](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader)
+- [QDL 工具（Qualcomm Software Center）](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader)
+- [QDL 工具（Qualcomm GitHub 仓库）](https://github.com/linux-msm/qdl)
 
 Qualcomm Device Loader (QDL) 是 Qualcomm 提供的用于刷写 Qualcomm 芯片的工具。
 
diff --git a/docs/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md b/docs/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md
index 896594bd3..402519a16 100644
--- a/docs/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md
+++ b/docs/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md
@@ -62,7 +62,38 @@ Fogwise® AIRbox Q900 板载 128GB UFS。
 
 <TabItem value="Ubuntu">
 
-使用 `lsusb` 命令查看设备是否进入 QDL 模式。
+1. 创建 udev 规则文件
+
+使用以下命令创建 udev 规则文件。
+
+<NewCodeBlock tip="Ubuntu$" type="host">
+
+```bash
+sudo nano /etc/udev/rules.d/51-qcom-usb.rules
+```
+
+</NewCodeBlock>
+
+2. 添加以下内容
+
+```text
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"
+```
+
+3. 保存文件后，重新加载 udev 规则并触发设备检测
+
+<NewCodeBlock tip="Ubuntu$" type="host">
+
+```bash
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+```
+
+</NewCodeBlock>
+
+4. 重新插拔 USB 数据线，使规则生效
+
+5. 使用 `lsusb` 命令查看设备是否进入 QDL 模式
 
 <NewCodeBlock tip="Ubuntu$" type="host">
 
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/download.md b/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/download.md
index cbacc09da..232208b14 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/download.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/download.md
@@ -12,7 +12,8 @@ sidebar_position: 150
 
 ## Software Tools
 
-- [QDL Tool](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader)
+- [QDL Tool (Qualcomm Software Center)](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader)
+- [QDL Tool (Qualcomm GitHub Repository)](https://github.com/linux-msm/qdl)
 
 Qualcomm Device Loader (QDL) is a tool provided by Qualcomm for flashing Qualcomm chips.
 
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md b/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md
index 6ee9048ee..a57ae78d2 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/fogwise/airbox-q900/getting-started/install-system/onboard-ufs.md
@@ -63,7 +63,38 @@ After successfully installing the driver, try unplugging and replugging the USB
 
 <TabItem value="Ubuntu">
 
-Use the `lsusb` command to check if the device has entered QDL mode.
+1. Create a udev rules file
+
+Use the following command to create a udev rules file.
+
+<NewCodeBlock tip="Ubuntu$" type="host">
+
+```bash
+sudo nano /etc/udev/rules.d/51-qcom-usb.rules
+```
+
+</NewCodeBlock>
+
+2. Add the following content
+
+```text
+SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"
+```
+
+3. After saving the file, reload the udev rules and trigger device detection
+
+<NewCodeBlock tip="Ubuntu$" type="host">
+
+```bash
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+```
+
+</NewCodeBlock>
+
+4. Replug the USB cable to apply the rules
+
+5. Use the `lsusb` command to check if the device has entered QDL mode
 
 <NewCodeBlock tip="Ubuntu$" type="host">