USB 动态配置

One-KVM 通过 USB OTG Gadget 向目标机枚举复合 USB 设备（键盘、鼠标、多媒体控制键等），并可配合 虚拟媒体（MSD） 暴露 USB 大容量存储。仅当 HID 后端 为 USB OTG 时本节配置生效；CH9329 串口 HID 或 禁用 时不适用。

配置项

在 设置 → 硬件 → HID 中，后端为 USB OTG 时可配置：

• OTG HID 功能：用开关组合要向目标机暴露的能力（保存前须至少启用 键盘、相对鼠标、绝对鼠标、多媒体键盘 中的一项；不能在未启用任一 HID 功能时仅打开 MSD）：
• 相对鼠标：传统相对位移（HID Boot Mouse）
• 绝对鼠标：绝对坐标（类似触控/数位板类用法）
• 键盘：标准 HID 键盘
• 多媒体键盘：Consumer Control（音量、播放/暂停等）
• 键盘状态灯：与键盘配合时同步 Caps/Num/Scroll 状态；启用键盘且打开此项会多占用 1 个端点

• 虚拟媒体（MSD）：向目标机提供 USB 存储；占用 2 个端点

• 最大端点数量：可选 5、6 或 无限制，用于按硬件 UDC 能力做软件侧预算；界面会显示 当前端点占用（估算值），超出所选上限时无法保存。部分低端点控制器在载入配置时可能对应更保守的默认策略。当然，实际是否可用仍取决于硬件限制，例如全志 CPU 端点数量为 5 ,晶晨 CPU 为 6。

• USB 设备描述符：厂商 ID（VID）、产品 ID（PID）、制造商、产品名称、序列号（可留空由设备侧自动生成）

操作步骤

1. 打开 设置 → 硬件 → HID
2. 将 HID 后端 设为 USB OTG
3. 按需设置 最大端点数量，并打开所需的 OTG HID 功能 与 虚拟媒体（MSD）（注意端点占用提示）
4. 如需修改枚举名称，在 USB 设备描述符 中填写 VID/PID 与字符串
5. 点击 保存 应用配置

会重新枚举 USB

修改 OTG HID 功能、MSD 开关或 USB 设备描述符都会导致 USB 设备重新连接，属于正常现象。