1. Introduction
The Geekworm KVM-A8 PCIe Version kit enables users to implement a KVM (Keyboard, Video, Mouse) over IP project utilizing a Raspberry Pi 4 Model B. This system allows for remote control of a computer via a web browser, providing comprehensive management capabilities. This manual provides detailed instructions for assembly, setup, operation, and maintenance of the KVM-A8 kit. Please note that this kit is unassembled and intended for professional users.
2. Product Overview
2.1. What's in the Box
The KVM-A8 kit includes the following components:
- 1 x X630-A8 Expansion Board
- 1 x X630 CSI-2 Module
- Other Accessories (including cables, screws, and spacers)

Note: The Raspberry Pi 4, SD card, and power adapter are not included and must be purchased separately.

2.2. Key Features
- Remote power control: Turn on, turn off, or restart your computer remotely.
- UEFI/BIOS configuration: Access and configure your computer's UEFI/BIOS settings.
- OS reinstallation: Reinstall operating systems using virtual CD-ROM or Flash Drive.
- Remote input: Utilize a remote keyboard and mouse.
- Web browser interface: Simulate keyboard, mouse, and monitor functions accessible via a web browser.
2.3. Compatibility
The Geekworm KVM-A8 PCIe Version is compatible exclusively with the Raspberry Pi 4 Model B (8GB/4GB/2GB/1GB versions). It does NOT support Raspberry Pi 3 or Raspberry Pi 5.
3. Setup Instructions
3.1. Hardware Assembly
Follow these steps to assemble the KVM-A8 kit with your Raspberry Pi 4:
- Secure the X630-A8 Expansion Board: Fix the X630-A8 board using the provided M2.5x5mm screws and M2.5x20mm F/F spacers.
- Install Heatsinks (Optional): Apply the three aluminum heatsinks to the correct chips on your Raspberry Pi 4. This step is optional if you already have proper heatsinks.
- Connect FFC Cable to Raspberry Pi 4: Insert the FFC cable (5cm length) into the Raspberry Pi 4 camera port, ensuring the correct direction.
- Assemble X630-A8 on Raspberry Pi 4: Carefully assemble the X630-A8 onto the Raspberry Pi 4, passing the FFC cable through the X630-A8.
- Connect X630 HDMI to CSI-2 Module: Insert the FFC cable tightly into the X630 module.
- Mount X630 Module: Place the X630 module onto the three on-board nut standoffs of the X630-A8 and secure it with M2.5x5mm screws.
- Install I2S Audio Cable (Optional): Insert the 10-pin I2S audio cable into both the X630 and X630-A8 with the correct direction. This is optional if audio functionality is not required.
- Insert CR1220 Coin Battery (Optional): Place a CR1220 coin battery into the designated socket on the X630-A8 for Real-Time Clock (RTC) functionality. The battery is not included.
- Attach OLED Display (Optional): Plug the 0.96" OLED display into the OLED port of the X630-A8 and fix it with two KM2x2x6mm screws.
- Attach PCIe Bracket: Fix the standard height PCIe bracket to the X630-A8-CAB adapter using M3x6 screws.
- Connect FFC Cables to X630-A8-CAB: Plug the FFC cables into the X630-A8-CAB adapter, ensuring correct wiring direction.



3.2. Wiring and Connections
Proper wiring is crucial for the KVM-A8 to function correctly. Refer to the diagram below for detailed connections:
- ATX Control Cable: Connect the provided ATX control cable from the X630-A8 to your computer's motherboard system panel header. Pay attention to polarity.
- USB-A to USB-C OTG Cable: Connect the USB-C end to the OTG port on the KVM-A8 and the USB-A end to a USB-A port on your computer for keyboard and mouse emulation.
- HDMI Cable: Connect an HDMI cable from the HDMI IN port on the KVM-A8 to the HDMI output of your computer.
- Ethernet Cable: Connect an Ethernet cable to the Raspberry Pi 4's Ethernet port for network access.

3.3. Powering the KVM-A8
The KVM-A8 can be powered via two methods:
- PoE Power: Recommended method, requires an 802.3af-compliant PoE switch.
- USB-C Power: If PoE is not available, power the unit via the USB-C port of the X630-A8. Power input: 5.1Vdc +/-5%, ≥3A. A Geekworm Type-C 5V 4A power adapter is recommended.
Important: Do NOT power via the Raspberry Pi 4's USB-C port, as it is occupied as a USB OTG port for KVM functionality.

4. Operating Instructions
4.1. Initial Setup and Remote Access
After completing the hardware assembly and connections, the PiKVM software needs to be configured. The KVM-A8 operates on the PiKVM V3 Platform.
- Software Configuration: Refer to the Geekworm Wiki for detailed software configuration guides and FAQs. Search for "KVM-A8" on the Wiki for specific instructions.
- Accessing the Web Interface: Once the Raspberry Pi 4 is powered and connected to the network, you can access the KVM over IP interface via a web browser on another computer. The IP address will be displayed on the optional OLED screen or can be found through network scanning tools.
- Login: Use the default credentials (usually admin/admin) to log into the PiKVM web interface.
4.2. Remote Control Functions
Through the PiKVM web interface, you can perform the following remote operations:
- Power Management: Remotely turn on, turn off, or restart your computer using the ATX control features.
- BIOS/UEFI Access: Enter and configure your computer's BIOS or UEFI settings during startup.
- Virtual Media: Mount ISO images or USB drives as virtual media to reinstall operating systems or perform diagnostics.
- Keyboard and Mouse Emulation: Control the remote computer using your local keyboard and mouse, which are emulated through the KVM-A8.
4.3. Installation Guide Video
For a visual walkthrough of the installation process and initial operation, please refer to the official Geekworm installation guide video below:
5. Maintenance
To ensure optimal performance and longevity of your Geekworm KVM-A8 kit, consider the following maintenance practices:
- Keep Clean: Regularly clean the components to prevent dust buildup, especially around the cooling fan.
- Check Connections: Periodically inspect all cable connections to ensure they are secure and free from damage.
- Software Updates: Keep the PiKVM software updated to the latest version to benefit from new features, bug fixes, and security enhancements. Refer to the Geekworm Wiki for update procedures.
6. Troubleshooting
If you encounter issues with your KVM-A8 kit, consult the Geekworm Wiki for comprehensive troubleshooting guides and FAQs. Common issues and their potential solutions include:
- No Video Signal: Verify HDMI cable connections, ensure the Raspberry Pi 4 is powered, and check PiKVM software settings.
- Network Connectivity Issues: Confirm Ethernet cable connection, check network settings on the Raspberry Pi 4, and ensure the correct IP address is being used.
- Keyboard/Mouse Not Responding: Ensure the USB OTG cable is correctly connected to both the KVM-A8 and the computer, and check PiKVM settings for HID emulation.
- Power Control Malfunction: Double-check the ATX control cable connections to the motherboard and the KVM-A8, ensuring correct polarity.
7. Specifications
| Feature | Specification |
|---|---|
| Brand | Geekworm |
| Series | KVM-A8 |
| Item Model Number | TB-2022-63 |
| Operating System | PiKVM V3 Platform |
| Item Weight | 2.19 ounces |
| Product Dimensions | 4.72 x 3.54 x 0.79 inches |
| Connectivity Technology | Ethernet |
| Included Components | 1 x X630-A8 Expansion Board, 1 x X630 CSI-2 Module, 1x Other Accessories |
8. Support
For further assistance, detailed documentation, and community support, please visit the official Geekworm resources:
- Geekworm Wiki: Comprehensive hardware installation and software configuration guides.
- Geekworm Amazon Store: For product information and purchases.





