pikvm/pages/v3.md

PiKVM v3 Tech info

Description

The PiKVM v3 HAT Board is designed to work with the Raspberry Pi 4 and provides the following features:

• HDMI capture device with max resolution 1080p 50Hz and audio support
• Keyboard & mouse emulation
• Mass storage emulation (i.e., virtual flash drive or CD drive provided by image file saved on PiKVM)
• Ability to simulate "removal and insertion" for USB for above mentioned devices
• ATX controller (allowing to switch power even if target device is off or operating system hangs)
• Onboard real-time clock
• 5v PWM fan controller
• USB & RJ-45 serial console

Requirements

To use PiKVM v3, you will need the following things, which are NOT included in the base kit:

• Raspberry Pi 4 (a model with any amount of memory is suitable)
• 5.1v 3A official Raspberry power supply with USB-C
• A regular HDMI cable
• USB-C to USB-A cable with DATA lines (for keyboard and mouse emulation)
• Straight Ethernet cable (NOT crossover, to connect the HAT board and ATX board)
• Micro-SD card at least 16 Gb class 10 is strongly recommended

Known issues & limitations

• The actual frame rate of the image received via HDMI will depend on the network bandwidth, resolution and the load on the Raspberry Pi. This is usually ~20-24 FPS for 1080p over LAN.
• AIMOS KVM switch not trully compatible with v3.2, but works great with v3.3 (Kickstarter edition)
• There may be compatibility issues with some motherboards (such as HP or DELL) which are the same as those that exist with PiKVM v2. Not everything is perfect, but if you have already used PiKVM v2 - our new v3 will work perfectly and please you. If there is no image from the BIOS, you can fine-tune the HDMI settings, but it is possible that the Mass Storage devices will not be available in the BIOS.

Installation

0. Print a plastic case if you want it (v3.3 for the Kickstarter model, v3.2 for the pre-release).

1. Build the device:

   • Device with or without the 3D-printed case
   • With the metal case (+ AUM option)

2. Install the operating system (choose the v3 image).

3. Power it up

4. If your kit includes the display and/or the fan, you'll need to turn them on after installation:

   su - # The default password is "root"
   rw
   systemctl enable --now kvmd-oled # For the display
   systemctl enable --now kvmd-fan  # For the fan
   ro
   logout
   

5. Important! If you are going to use GPIO pins to control a relay, KVM switch, or anything else, be sure to check the v3 shield pinout. Many ports are busy with internal functions. Before using them for your own use, you must disable them, otherwise you may damage the device.

IO ports

Description

1. USB for the power
   5.1v 3A is strongly recommended. The official Raspberry Pi 4 power supply is perfect for this.
2. Power (green) and activity (red) LEDs
   Show the device status. The red LED lights up when there is disk activity.
3. USB serial console
   Hardware serial console to login and configure the Raspberry Pi via a terminal emulator. It operates at a speed of 115200 baud. Just plug in the USB and you will see a USB-TTL device on your host.
4. USB serial console status LED
   The console has independent power from the USB connected host, so you can reboot the Pi and not lose the connection to the console. The LED indicates the presence of power via USB.
5. COM serial console
   For connection, the so-called CISCO-style serial cable is used (on the one hand, RJ45, on the other, COM port). You can buy any suitable cable or make your own. If you do not need console access to the PiKVM, this port can be used to access the server.
6. PoE pins
   PiKVM is compatible with PoE hats. These pins are used for power supply.
7. UART jumpers
   The two jumpers installed here provide communication between the console ports (3, 5) and the UART of Raspberry. By removing them, you will get access to the UART.
8. Audio capture jumpers
   The PiKVM can capture audio. Although this is not yet implemented in the software, the hardware capability is already present and you can use the arecord command to record audio. These pins are used for this purpose. If you need additional GPIO pins, you can remove these jumpers, comment line dtoverlay=tc358743-audio in /boot/config.txt, and use the GPIO 19, 20 and 21 as you see fit.
9. HDMI reset jumper
   Currently unused. In the future, it will be used for hardware resetting of the video capture chip. If you remove it, you will be able to use the GPIO 17
10. GPIO pins
    With the exception of the used pins, the rest are at your service.
11. ATX controller interface
    Use the ethernet straight cable to connect the ATX adapter (included). Connect the wires of the power button, reset button, and the power and HDD LEDs inside your server enclosure to the adapter.
12. 1-Wire & Neo-pixel interface
    Unused right now. For neopixel used GPIO 13 (same as for the red status LED).
13. OTG USB
    The port to connect to the server. Here, the keyboard, mouse, disk, and so on are emulated.
14. OTG USB AUX
    For fans of soldering. You can use these pins to connect OTG if you have installed PiKVM inside the server case.
15. HDMI input
    From 640x480 to 1920x1080 50Hz (max).
16. Service USB
    Use the dual USB-C bridge (included) to connect the Rspberry and v3 shield with this port.
17. HDMI 5v LED
18. HDMI 3.3v LED
19. AUM socket
    To connect an Advanced USB Module that provides an alternative way to emulate the keyboard and mouse and mass storage.
20. CSI socket
    Use a wide flat cable to connect to the Raspberry Pi.
21. 5v fan connector
    Connector for controlling a 5v fan with PWM support.
22. 5v power pins
    To receive or alternatively supply power to the PiKVM.
23. Top secret
    Currently unused.
24. I2C for the display