From 0130cd22db997f43c57b74a93b7e510c0f657f58 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 27 Jun 2026 05:23:39 +0000
Subject: [PATCH] docs: add generic USB passthrough section after Coral step

Covers passing any USB device to a VM by vendor/device ID or by port,
via both web UI and CLI, with notes on plug-in requirements and config management.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/README.md b/README.md
index 2e12327..7d15fb8 100644
--- a/README.md
+++ b/README.md
@@ -2250,6 +2250,59 @@ Click **Add**.
 
 ---
 
+### Passing other USB devices to VMs
+
+Any USB device plugged into the R730xd can be passed through to a VM using
+the same method. Two ways to do it:
+
+**Method A — By Vendor/Device ID (recommended)**
+
+Ties the passthrough to the specific device model, not the physical port.
+The device appears in the VM regardless of which USB port it's plugged into.
+
+1. Find the device's IDs on the Proxmox host:
+   ```bash
+   lsusb
+   # Example output:
+   # Bus 001 Device 003: ID 0781:5583 SanDisk Corp. Ultra Fit
+   #                        ^^^^ ^^^^
+   #                        VID  PID
+   ```
+2. In the VM's **Hardware** tab → **Add** → **USB Device**
+3. Select **Use USB Vendor/Device ID**, enter the Vendor ID and Device ID
+4. Click **Add**
+
+**Method B — By USB port (use when you have multiple identical devices)**
+
+Ties the passthrough to a specific physical port on the server.
+
+1. In the VM's **Hardware** tab → **Add** → **USB Device**
+2. Select **Use USB Port**
+3. Pick the port from the dropdown (e.g. `USB Port 2`)
+4. Click **Add** — the device plugged into that port is always passed through
+
+**Via CLI instead of the web UI:**
+
+```bash
+# By vendor/device ID:
+qm set <vmid> -usb0 host=<vendorid>:<deviceid>
+# Example:
+qm set 101 -usb0 host=0781:5583
+
+# By port:
+qm set <vmid> -usb0 host=2-1   # bus-port notation from lsusb -t
+```
+
+**Notes:**
+- The device must be physically plugged in before starting the VM, or it
+  won't appear (same rule as the Coral)
+- Each USB slot in the VM config is `usb0`, `usb1`, `usb2` etc. — increment
+  for each additional device
+- To see what's currently passed through: `grep usb /etc/pve/qemu-server/<vmid>.conf`
+- To remove a device: `qm set <vmid> -delete usb0`
+
+---
+
 ### Step 11.6 — Add raw data drives to VM 100 via CLI
 
 The web UI does not support raw block device passthrough cleanly — use the