跳转至

USB 动态配置

One-KVM 通过 USB OTG Gadget 模拟键盘、鼠标与虚拟媒体。需要 HID 后端为 USB OTG,CH9329 后端不支持此配置。通过切换 HID 组合和 MSD 开关,可用于被控机不支持复合 USB 设备的情况。

配置项

  • OTG HID 组合
  • 完整(键盘 + 相对鼠标 + 绝对鼠标 + 多媒体 + 虚拟媒体)
  • 完整(不含虚拟媒体)
  • 兼容:仅键盘
  • 兼容:仅相对鼠标
  • 自定义
  • 自定义 HID 功能:键盘 / 相对鼠标 / 绝对鼠标 / 多媒体
  • 虚拟媒体(MSD):可在自定义模式中单独开关
  • USB 设备描述符:VID/PID、制造商、产品名、序列号

usb_dynamic-2026-01-28-00-14-21 usb_dynamic-2026-01-28-00-14-39

操作步骤

  1. 打开 设置 → 硬件 → HID
  2. 将 HID 后端设置为 USB OTG
  3. 选择 HID 组合或自定义功能(至少启用一个)
  4. 如需修改设备标识,在“USB 设备描述符”中设置 VID/PID 等
  5. 点击 保存 应用配置

会重新枚举 USB

修改 HID 组合或描述符会导致 USB 设备重新连接,属于正常现象。