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

# 配置 udev 规则

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

## 为什么需要 udev 规则

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

## 自动设置（推荐）

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

```bash theme={null}
printf 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", 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"
    ```

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

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