Skip to content

Dynamic USB Configuration

One-KVM uses USB OTG Gadget to emulate keyboard, mouse, and virtual media. This requires the HID backend to be USB OTG; the CH9329 backend does not support this. Switching HID profiles and MSD can help when the target machine does not support composite USB devices.

Configuration

  • OTG HID profiles:
  • Full (keyboard + relative mouse + absolute mouse + consumer + MSD)
  • Full (no MSD)
  • Legacy: keyboard only
  • Legacy: relative mouse only
  • Custom
  • Custom HID functions: keyboard / relative mouse / absolute mouse / consumer
  • MSD (virtual media): can be toggled in Custom profile
  • USB descriptor: VID/PID, manufacturer, product, serial number

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

Steps

  1. Open Settings -> Hardware -> HID
  2. Set HID backend to USB OTG
  3. Choose a profile or custom functions (at least one function must be enabled)
  4. Update the USB descriptor fields if needed
  5. Click Save to apply

USB Re-enumeration

Changing HID profiles or the USB descriptor will reconnect the USB device. This is expected.