Serial-over-USB

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. Update your PiKVM:

    Updating PiKVM OS

    To update, run following commands under the root user:

    [root@pikvm ~]# pikvm-update
    

    If you encounter an error like:

    [root@pikvm ~]# pikvm-update
    bash: pikvm-update: command not found
    

    It's most likely you have an old OS release. You can update the OS as follows:

    [root@pikvm ~]# rw
    [root@pikvm ~]# pacman -Syy
    [root@pikvm ~]# pacman -S pikvm-os-updater
    [root@pikvm ~]# pikvm-update
    

    Next time you will be able to use the usual method with pikvm-update.

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

    otg:
        devices:
            serial:
                enabled: true
    
  3. Run the following command:

    [root@pikvm ~]# echo ttyGS0 >> /etc/securetty
    
  4. Run these comands:

    [root@pikvm ~]# systemctl enable kvmd-otg-getty@ttyGS0.service
    [root@pikvm ~]# 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.