Projects STRLCPY pikvm Files
🤬
2026fb1b
ROOT /
docs /
multiport.md
41 lines | UTF-8 | 4 KB

Multiport KVM over IP

There are many ways to do this, but the best and most documented one right now is to use the ezCoo KVM switch.

Also, PiKVM can be connected to a multi-port HDMI/USB switch and the switch's buttons can be connected via optocouplers to the Pi's GPIO to switch channels.

If your KVM switches channels using keyboard shortcuts, there is a chance that it will not be able to work with OTG (v2+ platform, see below), since it does not fully implement the USB stack. In this case, you will have to use an Arduino board to emulate the keyboard & mouse (PiKVM supports this configuration).

!!! warning If you choose AIMOS, be aware that it has a back powering issue that you need to use work arounds for. Limitations are are listed below. Also please be aware that Arduino's will not work with the AIMOS KVM's.

List of tested KVMs

Here the status is:

  • ✔ - Everything is working as expected. There may be some subtleties.
  • ☹ - Not everything works. Additional work is needed for some functions to work, like MSD.
  • ✘ - The keyboard or mouse does not work at all, the switch loses the image, etc.
ModelStatusNotes
ezCoo EZ-SW41HA-KVMU3L 4x1 switch ~~ezCoo SW41HA HDMI 4x1 switch~~ (legacy)Using with PiKVM - 4 Port is the ONLY supported KVM, 2 Port does not work the same and is not supported
eccoo EZ-SW41HA-KVMU3P 4x1 switchmake sure you buy the with hotkey version as that has the control port
ezcoo EZ-SW41H21-KVMU3P 8K 4x1 switchDoes NOT have a control port. MSD Works. Can be managed through key combo (ctrl+ctrl+#)
TESmart 8 PORT - HDMI KVM SWITCHUse OTG with USB 2.0 Hub only, no hotkey support. Switching available with serial or IP-to-serial interface using fixed IP (/31 peer-to-peer addressing supported). Can be managed via WebUI or CLI tool
XH-HK4401 4-port HDMI USB KVM SwitchUsing with PiKVM - USB MSD works, requires the HDMI backpower solutions found below
Ali's nonameLimitations are listed below
AIMOS 8-port HDMI USB-C KVM SwitchSimilar to Ali's noname model, available in 4/8port editions, has same HDMI bridge boot problem/solution using a Marmitek 312 UHD HDMI splitter. ONLY supports HotKey switching. Limitations are are listed below
Aten CS1758 8-port PS/2 / USB VGA KVM switchOlder Aten switches can be had for cheap and can be a viable alternative. Devices are connected via PS/2 so USB media support does not work. The setup relies on a VGA-> HDMI adapter to make the video signal work and there can be issues with unsupported VGA resolutions with some adapters. KVM hotkeys and switching all work and so does mouse and keyboard.

Limitations:

  • HDMI backpower solutions:
  • MSD workaround (will not work OOB)
    • RPi4 OTG needs to be in the KB port for mouse and KB funtionality, ZeroW is required and needs to be connected to the HUB port for HK switching and MSD functionality - ✔KNOWN WORKING
    • See here - Advanced soldering required - allows use of GPIO menu to change input
Please wait...
Page is in error, reload to recover