-
KVM-A3: Difference between revisions
| Line 50: | Line 50: | ||
*'''1 x X630-A5 V1.0 Adapter Board''' | *'''1 x X630-A5 V1.0 Adapter Board''' | ||
** 1 x M3.5x6mm Screw | ** 1 x M3.5x6mm Screw | ||
** 1 x ATX Control Cable (Cable Length: | ** 1 x ATX Control Cable (Cable Length: 52cm / 20.47 inch) | ||
'''ATX Conrol cable:''' | '''ATX Conrol cable:''' | ||
Revision as of 17:28, 17 March 2026
Update History
X630-A3 (The core expansion shield of this kit) was updated from V1.2 to V1.6 in October 2023.
- Support WatchDog
- RTC function can be used directly, no need to configure.
- I2S audio cable added.
Overview
PiKVM-A3 is a member of the PiKVM[1] family, which supports Raspberry Pi 4 with a matching metal case.
Geekworm KVM family products:
| Model | Compatible With | Form Factor | Max Input Resolution | ATX Control | RTC Chipset | OLED display | PoE | RS232 Console | Ethernet | M.2 NVMe Socket | Control of PCs | USB HUB | I2S audio |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| KVM-A3 V1.6 | Raspberry Pi 4 | HAT | 1920x1080 @50Hz | Yes | DS1307 | 0.96" | No | No | 1GbE | No | 1 | No | Yes In-phase I2S wire |
| KVM-A8 V1.8 | Raspberry Pi 4 | PCI | 1920x1080 @50Hz | Yes | PCF8563 | 0.96" (Equipped with a 2P wire to connect the OLED) |
802.3af | No | 1GbE | No | 1 | No | Yes Inverted-phase I2S wire |
| KVM-A4 V2.0 | Raspberry Pi 2W | HAT | 1920x1080 @50Hz | Yes | DS1307 | 0.96" | No | No | No | No | 1 | No | No |
| X680 V1.5 | Raspberry Pi CM4 | Box | 1920x1080 @60Hz | Yes | PCF8563 | 0.96" | No | No | 1GbE | 2280 | 4 | Yes | HDMI audio supported |
Updated to V1.5 now |
Raspberry Pi CM4 | Box | 1920x1080 @50Hz | Yes | DS1307 | 0.96" | No | No | 1GbE | 2280 | 4 | Yes | HDMI audio supported |
| X651 V1.0 | Raspberry Pi CM4 | PCI | 1920x1080 @60Hz | Yes | DS1307 | 0.96" | 802.3af | No | 1GbE | No | 1 | No | HDMI audio supported |
| Raspberry Pi CM4 | PCI | 1920x1080 @50Hz | Yes | DS1307 | No | No | No | 1GbE | No | 1 | No | HDMI audio supported | |
| Raspberry Pi CM4 | PCI | 1920x1080 @60Hz | Yes | DS1307 | No | No | No | 1GbE | No | 1 | No | HDMI audio supported | |
| Raspberry Pi CM4 | PCI | 1920x1080 @60Hz | Yes | DS1307 | No | 802.3af (POE injector is required due to compatibility issues) |
No | 1GbE | 2280 | 1 | No | No |
Features
- Designed especially for PiKVM ( Raspberry Pi based KVM over IP)
- For use with Raspberry Pi 4 Model B 1GB/2GB/4GB/8GB
- Fully compatible with PiKVM OS (refer to user manual)
- Only compatible with PiKVM V3 OS, NOT support V4
- Control a server and computer using a web browser
- HDMI Full HD capture based on the TC358743 chip
- OTG Keyboard & mouse; Mass Storage Drive emulation
- Hardware Real Time Clock (RTC) with CR1220 coin battery socket
- Equipped with solidstate relays to protect RPi GPIO pins from computer and ESD spikes
- ATX control via RJ45 connector Switch the machine on or off, reset it, and monitor the status of HDD LED & power LED remotely
- Reserves the 10pin SH1.0 connector on X630-A3 for future I2S HDMI audio support
- Reserves the 4pin header & spacers for I2C OLED display
- Supports installation of passive heatsink P165-A/P165-B (Refer to KVM-A3#comment-4519)
- The cooling fan used in the X630-A3 is a 3007(30mm x 30mm x 7mm) model with a PH2.0 connector.
Packing List
- 1 x 0.96 inch OLED: Resolution: 128×64 pixel, with 2 piece of M2*6 screws
- 1 x ATX Conrol Ethernet Cable (Cable length: 100cm)
- 1 x X630 HDMI to CSI-2 Module
- 1 x FFC Cable(5cm length)
- 1 x X630-A3 Expansion Board(V1.2/V1.3/V1.6)
- 1 x USB-A to USB-C OTG Cable (Cable Length: 100cm / 39.37 inch)
- 4 x M2.5x20mm F/F Spacers
- 7 x M2.5x5mm Screws
- 1 x M2.5x10mm Screws
- 1 x X630-A5 V1.0 Adapter Board
- 1 x M3.5x6mm Screw
- 1 x ATX Control Cable (Cable Length: 52cm / 20.47 inch)
ATX Conrol cable:
You can make your own ATX control cable, in fact, it is a normal Ethernet cable, and the requirements must be 568B line sequence
RJ45 Pinout of KVM:
How to Power
- Power Input: 5.1Vdc +/-5% , ≥3A (Power Via USB Type-C port of X630-A3)
- DON'T power via raspberry pi's TYPE-C port, because it is occupied as USB OTG.
How to Cool
- For use with raspberry pi 4, X630-A3 (PiKVM-A3) equipped with a active cooling fan that cool your raspberry pi; Supports installation of passive heatsink P165-A/P165-B (Refer to KVM-A3#comment-4519)
- For use with raspberry pi 4, X630-A8 (PiKVM-A8 PCIe version) equipped with a active cooling fan that cool your raspberry pi; Supports installation of passive heatsink (Refer to KVM-A3#FAQ)
- For use with raspberry pi zero 2 w, X630-A4 (PiKVM-A4) allows to use C296 aluminum heatsink with your raspberry pi zero 2 w, but user need to prepare 4pcs M2.5*7mm screws yourself.
Hardware Parameters
User Manual
First you need to make sure your hardware connections are correct, please refer to the video and diagram below
Installation Video
KVM-A3 Kit: https://youtu.be/WPGH-rrt10E (Note: the X630-A3 V1.2 has been updated to X630-V1.3/V1.6 and remove one on-board spacer to simplify the installation.)
Connection Diagram
1. The PiKVM-A3 is composed of follow parts:
- X630 HDMI to CSI-2 Board (for video capture)
- X630-A3 HAT Board (for ethernet, cooling, RTC, ATX Control power in etc)
- X630-A5 Adapter Board (it is installed inside the PC case, and it connect the computer motherboard and IO panel cabe of PC case))
- 0.96 inch OLED (for display, Resolution: 128×64 pixel)
- Ethernet Cable (TIA/EIA-568.B connection, and it's ATX control signal cable)
Note:
- Please use the supplied USB Type-C to USB 2.0 A-Male Cable only. USB-C to USB-A cable only with DATA lines(for keyboard and mouse emulation) and no power supply, Using other cable might cause instability or damage to either the host PC or the Pi.
- We need to ensure you isolate the 5v connection between the Raspberry Pi and host PC to prevent backpower issues that can cause instability or damage to either the host PC or the Pi.
- Some PC case may not have HDMI port, you need to use VGA/DVI to HDMI adapter to transfer HDMI port, but VGA to HDMI adapter may not be compatible with PiKVM-A3
2. Connection Diagram
Click it to zoom in
Note:
- The X630-A5 adapter board will be install into the PC Case.
- The wire group ① connect to X630-A5 comes from the PANEL of PC Case.
- The black and red wires(wire group ②) come from X630-A5 accessories.
OS Download & Installation
1. Firstly, need prepair a micro sd card, a minimum 16 Gb class 10 memory card is recommended.
2. Download an appropriate OS image for the PiKVM, the url link is: https://pikvm.org/download/
- We recommend that you use the 'V3 Pre-Assembled' version, and this image includes OLED display configuration.
- For Raspberry Pi 4, please use PiKVM V3 platform. Only compatible with PiKVM V3 Platform OS, NOT support V4
3. Flash it to a microSD memory card by following the simple instructions or Official installation tutorial
4. Power the device, then open explore to login the pikvm web ui.
5. Blog sharing for reference: https://www.andysblog.de/kvm-over-ip-pikvm-als-bausatz
Enable RTC
Only need to configure the RTC function for the X630-A3 V1.5/V1.3/V1.2 version, X630-A3 V1.6 don't need.
Due to different RTC chips with official PiKVM hardware, you still need to configure RTC to make RTC work normally.
Firstly, insert the CR1220 button battery. run the following command in web terminal window:
1. switch to 'root' user
su root
then type the password, and the default password is 'root' also.
2. Switch OS to writable mode
rw
3. Edit the /boot/config.txt file, and change line dtoverlay=i2c-rtc,pcf8563 to dtoverlay=i2c-rtc,ds1307 (due to use the different RTC chip).
sudo nano /boot/config.txt
Then save & reboot the device;
4.Test & setting RTC, write&read the time of Raspberry Pi to RTC DS1307
date sudo hwclock -w sudo hwclock -r
5. Swith OS to readonly mode
ro
Enable OLED display
Run the following command in web terminal window to enable OLED display:
rw systemctl enable --now kvmd-oled ro
If you are using PiKVM OS V3 Pre-Assembled, the OLED configuration is already pre-installed, you can ignore this step.
Enable hdmi audio
Refer to Enable pikvm hdmi audio
References
- ↑ PiKVM © belongs to https://pikvm.org
FAQ
PiKVM is first and foremost a trademark, which is controlled by https://pikvm.org, and it does not belong to Geekworm.
PiKVM is Free and Open Source Software released under the GPLv3.
Geekworm's KVM products use the open source pikvm software developed by pikvm.org under the GPLv3 without any modification. Geekworm will regularly donate to pikvm.org
About after-sales service of Geekworm KVM Products:
The after-sales service of all products sold by Geekworm should be the responsibility of our Geekworm team (email: support@geekworm.com), please DO NOT disturb the official PiKVM support team.
- First of all, we recommend you to get more FAQ information on the official website: official FAQ, or check the following FAQ;
- You can post a issue ticket at Geekworm forum or email to us (support@geekworm.com) and attached your installation pictures or videos to get some help.
- Blog sharing for reference: https://www.andysblog.de/kvm-over-ip-pikvm-als-bausatz
A:
- First refer to the Video problems to troubleshoot
- Please check the hardware connection. Double-check that the video capture device is connected correctly and tightly.
- Make sure you use the original HDMI port. If your desktop only has a VGA display port, there may be no video signal when you use VGA to HDMI adapter, and there is no way to solve this; However, you can try to lower the resolution and restart the PC to test, but the probability of success is very low.
- Change the HDMI cable to test.
- Test the X630 separately to check if there is HDMI output.(run the
ls /dev/video0command, if you see anything such as /dev/video0 other than file not found, then it’s available ) - Some laptops do not output any signal until you switch the output (usually via the FN + and an F5 key on the keyboard).
- Your computer maybe enter sleep mode, please exit sleep mode.
- Feedback from users: If you're using something like NGINX Proxy Manager, you must have Websockets Support enabled for it to work correctly – screenshots below:
- Feedback from users: Multiple Network IPs. if you'll have similar thing in the future: janus is using stun servers for determining public ip address, if the network has several public IP addresses and route traffic through multiple of those, janus via stun will detect the change of the network and restart the stream each time
- Solution: either lock traffic from pikvm through one gateway (one public IP address) or configure some sort of session persistence (sticky connection)
- Run the command
systemctl status kvmd-tc358743to check whether the video service is working properly.
Q: Why OLED is not display?
A: Please follow the steps below to check
1. Please confirm that the OS is correct according to your Raspberry Pi version:
Due to downloading the wrong firmware, the OLED cannot be displayed. We ALSO made such mistakes during testing
- For Raspberry Pi 4 : https://pikvm.org/download/
- For Raspberry Pi Zero 2 W : https://docs.pikvm.org/flashing_os/
2. Please check if the order of OLED screen pins is correct, please email to support@geekworm.com if it's a wrong pin order;
The run the following command to check the I2C address
sudo i2cdetect -y 1
0 1 2 3 4 5 6 7 8 9 a b c d e f 00: -- -- -- -- -- -- -- -- 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 30: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- -- 40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 70: -- -- -- -- -- -- -- --
3c is a hexadecimal number, it is the I2C address of OLED, if you can’t find this value, please shut down and reconnect shield and OLED, then run this command again, If you still can't find the OLED's I2C address, the OLED screen may be damaged.
PS: Since the i2cdetect tool is not installed by default in pikvm os, you need to install it first. You can install it through the following command
pikvm-update rw pacman -S i2c-tools -y
4. Then run the following command to enable OLED display:
rw systemctl enable --now kvmd-oled ro
5. Please refer to https://geekworm.com/community/forum/topic/200314/kvm-a3-096-oled-display-is-dead if you can't solve the question.
Q: How can I access the device from an external network?
A：Please refer to the official tutorial : https://docs.pikvm.org/v3/
Q: How do I emulate various USB devices on the target machine?
More details, pls refer to: https://discord.com/channels/580094191938437144/896216359963332628/1021503994436276245
Q: How to login pikvm os?
A: Input the XX.XX.XX.XX ip address on the explorer, then input user: admin, the default password is 'admin' also.
Or refer to GETTING TO KNOW THE INTERFACE
Q: How to connect to wifi?
A: Refer to | Optional setting up Wi-Fi
If you want to connect KVM to a Wi-Fi network, you need to tell the device ESSID and password before first boot. To do this, mount the first partition of the memory card (FAT32) and edit or make the pikvm.txt file there. Do not remove line FIRSTBOOT=1 or FIRST_BOOT-1 for first time booting, just add your wifi settings like this:
FIRSTBOOT=1 WIFI_ESSID='mynet' WIFI_PASSWD='your password'
There is a possibility that, in countries that support CH13, the device will not connect. You will need to configure your router to disable channels 12-14 or disable Auto scan mode so it will connect.
Save, unmount and follow the next step.
Q: How to switch root user?
A:
su root #default password is root also
Q: Why does my PC stay in a continuous boot loop or act as if the power button is "always pressed" when using KVM-A3?
A: This issue is typically caused by an incomplete cable connection, specifically the absence of the USB-OTG cable. Please ensure that all required cables are fully seated and connected before powering on your device.
Q: Which pins are available on the KVM-A3?
A: You only can use GPIO16, 26, 11, 17, 25, 9, 10 pins on KVM-A3
A. No, one kit can only control one pc, you can refer to X680 to control up to 4 PCs.
Q: How to enable oled display on KVM-A4?
Q: Will there will be a case for KVM-A4?
Q: How to do if KVM-A8 hangs up or reboot or has to be started manually?
A. The KVM-A8 hardware itself does not cause the system to reboot, and [[KVM-A8 shield is controled by raspberry pi 4;
Please ensure these keys:
1. The PiKVM OS version is correct;
2. Check & use a high-quality power supply;
3. Whether the raspberry pi 4 temperature is too high;
4. Contact us via email to support@geekworm.com
If you find that the color wiring is wrong, please contact us at support@geekworm.com
Q: I want to control several pc power. Is it possible with one KVM-A8
A: No, one PiKVM-A8 can only control one pc. Please refer to X680 4-port IP KVM Switch.
Q: Does KVM-A8 support passive heatsink such as (P165-A or P165-B etc) instead of fan?
A: You can use the P165 aluminium heatsink or the H402 pure copper heatsink, but must remove the X630-A8 fan and fan connector.
①If use P165-A(thickness 7mm), you can use M2.5*5mm spacer instead of M2.5*12mm spacer to fix it;
②if use P165-B(thickness 11mm), you can directly use M2.5*6mm screws to fix it;
③if use H402(thickness 4mm), you can use M2.5*8mm spacer instead of M2.5*12mm spacer.
You can also use other suitable spacers + screws to fix the heatsink.
Q: Why is the X680 not working?
A:
1. Firstly, must make sure the hardware expecially CM4 is connected correctly and securely.
- Check if the X680's onboard SYS-PWR, CM-PWR, CM-ACT LEDs are lit.
- If SYS-PWR LED is not lit, that means no power to X680; If the CM-PWR and CM-ACT LEDs are not lit, that means that the CM4 is not installed properly. Please recheck the CM4 installation, or check if the CM4 / X680 installation slot is damaged.(This is important! Many problems are caused by poor contact of CM4)
- If the X680's SYS-PWR, CM-PWR, CM-ACT LEDs are lit, then check the wiring connection.
Please refer to the following picture for the wiring connection and LED description.
2. Make sure to use the right pikvm OS. Only PiKVM V3 is supported.
V3 Pre-Assembled version already includes OLED display configuration, while V3 HAT Kit version need to configuring OLED yourself.
3. Important: Remove the USB cable after programming is complete.
4. Please email us at support@geekworm.com if you have further questions.
Q: Why is USB mass driver not recognized on X680?
A: Please refer to the description in the red rectangle in the picture below;
The USB mass is not recognized in PIKVM OS, you can understand USB mass as a local USB HUB in PIKVM OS.
These 3 USB ports are used for local switching between target PC1-PC4, e.g. a USB disk with the OS image can be used to install the os in PC1, if switching to PC2, then the os can be installed in PC2, and so on.
Q: Does the X680 support audio?
Q: Does the X680 support PoE power? How to enable PoE Power?
A: The X680 doesn't support POE, but you can use something similar to the PD3005G-3A
Q: Why can't I switch to another PC on X680?
A: You need to make sure that your target computer is not in sleep, because when the computer is sleep, the USB port will stop supplying power
Q: Why NVME SSD cannot be recognized on X680？
A: Login the pikvm web teminal, then type the following command:
lspci
The result of the command should look similar to the following, if you can't find something similar to the following, your NVME SSD is not compatible
Q: How to boot from NVMe SSD on X680?
A: Refer to the following third-party tutorials:
- https://www.jeffgeerling.com/blog/2021/raspberry-pi-can-boot-nvme-ssds-now
- https://hagensieker.com/2022/04/17/booting- a-raspberry-pi-cm4-from-an-nvme/
- https://dphacks.com/2021/11/21/how-to-boot-a-pi-cm4-from-nvme-ssd/
You can also check out the official guide of the Raspberry Pi Foundation on how to boot CM4 from NVMe devices
Q: Can PiKVM work on Raspberry Pi 5？
A: Not yet, but it will in the future. The Raspberry Pi 5 does not support hardware video encoding, it's not recommended for PiKVM right now.
<comments />
<comments />