USB 动态配置

One-KVM 可通过 USB OTG Gadget 向被控机枚举复合 USB 设备。键盘、相对/绝对鼠标、多媒体键盘、USB 麦克风、虚拟媒体（MSD）和 USB 虚拟网卡都在 设置 → 硬件 → HID 页面配置。

只有 HID 后端 为 USB OTG 时，这些 OTG 功能才会创建。切换到 CH9329、蓝牙 HID 或禁用 HID 后，MSD、UAC 麦克风和 USB 网络也会被关闭。

使用前检查

进入 设置 → 硬件 → HID：

• 将 HID 后端 设为 USB OTG；
• 确认页面能找到并显示当前 UDC；
• 根据需要选择 OTG HID 功能，并确认页面没有运行时错误。

如果设备控制器或线缆状态发生变化，可重新打开页面并保存配置，让 One-KVM 重新协调 USB Gadget。

USB 设备描述符

USB 设备描述符决定被控机看到的 USB 标识：

• 厂商 ID（VID）、产品 ID（PID）：填写十六进制值，默认 1d6b / 0104；
• 制造商、产品名称：填写设备描述字符串；
• 序列号：可留空，留空时由设备运行时生成。

保存描述符会使 USB 设备重新枚举，被控机可能短暂断开并重新识别设备。

OTG 功能

页面可分别启用：

• 标准键盘；
• 多媒体键盘（Consumer Control）；
• 键盘状态灯（Caps Lock、Num Lock、Scroll Lock），需要先启用标准键盘；
• 相对定位鼠标；
• 绝对定位鼠标；
• USB 麦克风（UAC）：固定为 48 kHz、双声道；
• 虚拟媒体（MSD）；
• USB 虚拟网卡桥接：选择 NCM、ECM 或 RNDIS / Windows 驱动，并选择要桥接的本机网络接口。

USB 虚拟网卡的桥接接口留空时由系统选择连接中的 NetworkManager 以太网接口。RNDIS 适合 Windows；Linux/macOS 通常优先使用 NCM 或 ECM。

启用 MSD 后，还需填写：

• MSD 目录：虚拟磁盘文件所在目录；
• Flash 设备名称和CD-ROM 设备名称：只能使用可打印 ASCII 字符，长度 1–28 个字符。

虚拟媒体镜像仍在控制台的 虚拟媒体 功能中创建、挂载和卸载。

OTG HID 至少要保留一个键盘、鼠标或多媒体键盘接口；HID 接口为空时保存会失败。macOS 拖拽兼容性需要同时启用相对鼠标和绝对鼠标。USB 麦克风、MSD 和 USB 网络不能单独替代 HID 接口。

操作步骤

1. 打开 设置 → 硬件 → HID。
2. 将 HID 后端设为 USB OTG，确认 UDC 可用。
3. 按需填写 VID、PID、制造商、产品名称和序列号。
4. 启用键盘、鼠标、多媒体键盘、UAC、MSD 或 USB 网络，并填写对应参数。
5. 点击 保存功能配置，等待设备重新枚举。

保存会重新枚举 USB

修改 HID 功能、设备描述符、MSD、UAC 或 USB 网络配置都可能导致被控机短暂断开并重新识别，这是 USB Gadget 重新创建的正常现象。