Serial-over-USB connection

Specifically to V2+. This can be used for terminal access from the target host to the PiKVM, or for any other purpose that requires a serial connection. In the last case, you only need to perform step 1 and reboot.

USB limitations

Each emulated USB device consumes a limited hardware resource called endpoints.

Short info: by default, you can add only one additional USB device.

To get more information about the endpoints, add more devices, and flexibly manage the configuration on the fly, see here.

1. Edit /etc/kvmd/override.yaml and add these lines:

   otg:
       devices:
           serial:
               enabled: true
   

2. Run the following command:

   # echo ttyGS0 >> /etc/securetty
   

3. Create the directory /etc/systemd/system/getty@ttyGS0.service.d and add a file file named override.conf into it. Afterwards edit the file and copy this into it:

   [Service]
   TTYReset=no
   TTYVHangup=no
   TTYVTDisallocate=no
   

4. Run these comands:

   # systemctl enable getty@ttyGS0.service
   # reboot
   

5. Once PiKVM is rebooted you will have access to a virtual serial port on the server that the USB is connected to. Use mingetty, screen, putty, or something like this to access the kvm from the server. The port is called /dev/ttyAMA0.