> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置 udev 规则

> 在您的 Linux 或 WSL 主机上允许 Qualcomm USB 厂商 ID — 这是 ADB 和 EDL 通信所必需的。

## 为什么需要 udev 规则

Linux 默认限制原始 USB 访问。如果没有正确的 `udev` 规则，您的用户账户在不使用 `sudo` 的情况下无法通过 ADB 与设备通信或将其置于 EDL 模式。

## 自动设置（推荐）

运行下面这条命令。它会一次性写入 EDL 模式和 ADB 模式的规则：

```bash theme={null}
printf 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"\nSUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9135", MODE="0666", GROUP="plugdev"\n' \
  | sudo tee /etc/udev/rules.d/51-qcom-usb.rules
```

然后重启 `udev`：

```bash theme={null}
sudo systemctl restart udev
```

如果您的设备已经连接，请**拔下并重新插入** USB 线缆。

## 手动设置

<AccordionGroup>
  <Accordion title="分步操作 — 手动创建规则文件">
    1. 进入 udev 规则目录：

    ```bash theme={null}
    cd /etc/udev/rules.d/
    ```

    2. 检查文件是否已存在：

    ```bash theme={null}
    ls -l 51-qcom-usb.rules
    ```

    3. 创建或打开该文件：

    ```bash theme={null}
    sudo vi 51-qcom-usb.rules
    ```

    4. 添加（或验证）以下内容：

    ```bash theme={null}
    # Qualcomm EDL mode
    SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"

    # Qualcomm ADB mode
    SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9135", MODE="0666", GROUP="plugdev"
    ```

    5. 重启 `udev`：

    ```bash theme={null}
    sudo systemctl restart udev
    ```
  </Accordion>
</AccordionGroup>

## 确认 plugdev 组成员资格

<Warning>
  如果您的用户账户不在 `plugdev` 组中，即使 udev 规则正确，设备访问也会失败。
</Warning>

检查您的组：

```bash theme={null}
groups $USER
```

如果缺少 `plugdev`，请将自己添加进去：

```bash theme={null}
sudo usermod -aG plugdev $USER
```

注销并重新登录（或重启）以使更改生效。

参考：[Android 开发者指南 — 硬件设置](https://developer.android.com/studio/run/device)。
