|
|
|
|
|
|
PiKVM is a Free and Open
Source Software that is released under the GPLv3 license. The
Operating System (OS) image provided here is solely for the purpose
of hardware testing. For commercial use, it is advised to directly
contact the developers of PiKVM.
The development of this software would not be possible without the
financial backing of the community. Contributions play a vital role
in sustaining and advancing the project. If you wish to contribute,
you can visit the PiKVM donation page at
https://pikvm.org/donate/.
Your support is greatly appreciated and will help in the continuous
development and improvement of this software.
|
|
|
|
*Compatible with PiKVM V3 platform OS version
only, not support V4 |
|
|
|
|
|
| |
| |
How to install Raspberry
Pi Imager
Raspberry Pi Imager is free to install from
the official Raspberry Pi website. It's available
for MacOS, Windows, and Ubuntu systems.
1. Visit the
Raspberry Pi download page.
2. Download the
Raspberry Pi Imager installer for your Operating
System.
3. Run the
installer and follow the prompts to complete the
setup.
Write a Raspberry Pi Imager built-in image
1. Launch
Raspberry Pi Imager.
2. Click Choose OS.
3. Select Use custom to write an
unlisted image.
4. Click Choose SD card.
5. Select from the list the SD card you want to
write to.
6. Click Write to begin the image
writing process.
When the imager is finished,
you can connect your microSD card to the Pi and boot
it up.
Raspberry Pi Imager alternatives
If for whatever reason you
don't want to or are unable to use Raspberry Pi
Imager, you can opt to use an alternative
application. Here are a couple we've relied on over
the years leading up to the new imager release.
-
balenaEtcher - The application
runs on Windows, MacOS, and Ubuntu operating
systems.
- Win32
Disk Imager - This imaging software is
designed for Windows machines.
Notes:
The X688 does not support
programming the Compute Module 4 with eMMC. Please
use usbboot to flash the IPKVM OS onto your CM4
eMMC, using a Raspberry Pi CM4 IO board or another
carrier board that supports eMMC programming.
|
|
|
| |
|
|
| |
| |
1. Access to web interface
Access to PiKVM Web Interface via any
browser with the URL
https://pikvm/ OR
https:// IP address
of your ipkvm/ .
2.
Log in to PiKVM and click Terminal
:
3. Get root access (enter the root
password: root ).
|
[kvmd-webterm@pikvm
~]$
su |
|
4. To enable write-mode
|
[kvmd-webterm@pikvm
~]$
rw |
|
5. To support max resolution 1920x1080 60Hz
and Change GPIO for CM4 activity LED
|
[root@pikvm
kvmd-webterm]#
nano /boot/config.txt |
|
Change the line7 from dtoverlay=tc358743 to
dtoverlay=tc358743,4lane=1
Change the line10 from
dtparam=act_led_gpio=13 to
dtparam=act_led_gpio=STATUS_LED_G_CLK
6. Save and exit by hitting CTRL + X, answering Y and hitting Enter when
prompted.
7. Editing the EDID
|
[root@pikvm
kvmd-webterm]#
nano /etc/kvmd/tc358743-edid.hex |
|
Delete existing EDID data, then copy and paste below
new EDID data
00FFFFFFFFFFFF005262888800888888
1C150103800000780AEE91A3544C9926
0F505400000001010101010101010101
010101010101011D007251D01E206E28
5500C48E2100001E8C0AD08A20E02D10
103E9600138E2100001E000000FC0054
6F73686962612D4832430A20000000FD
003B3D0F2E0F1E0A202020202020014F
020323454F041303021211012021A23C
3D3E1F102309070766030C00300080E3
007F8C8C0AD08A20E02D10103E9600C4
8E210000188C0AD08A20E02D10103E96
00138E210000188C0AA01451F0160026
7C4300138E2100009800000000000000
00000000000000000000000000000000
00000000000000000000000000000087 |
|
8. Save and exit by hitting CTRL + X, answering Y and hitting Enter when
prompted.
9. Configure the OLED display from 128x64
to 128x32
|
[root@pikvm
kvmd-webterm]#
nano
/usr/bin/kvmd-oled |
|
Before change
After change
10. Save and exit by hitting CTRL + X, answering Y and hitting Enter when
prompted.
11. Run the following command to
enable OLED
|
[root@pikvm
kvmd-webterm]#
systemctl enable --now kvmd-oled
kvmd-oled-reboot kvmd-oled-shutdown |
|
12. Adding UI elements to
control the KVM switch
|
[root@pikvm
kvmd-webterm]#
nano /etc/kvmd/override.yaml |
|
Edit the file: /etc/kvmd/override.yaml and include
the following.
kvmd:
gpio:
scheme:
button1:
pin: 25 # GPIO pin number for Target host1
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button2:
pin: 16 # GPIO pin number for Target host2
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button3:
pin: 11 # GPIO pin number for Target host3
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button4:
pin: 9 # GPIO pin number for Target host4
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button5:
pin: 10 # GPIO pin number for Target host5
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button6:
pin: 17 # GPIO pin number for Target host6
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button7:
pin: 26 # GPIO pin number for Target host7
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
button8:
pin: 13 # GPIO pin number for Target host8
mode: output
switch: false
pulse:
delay: 0.5
max_delay: 1
view:
header:
title: Switches # The menu title
table: # The menu items are rendered in the form of a table of text labels and controls
- ["#X688 IPKVM Switch"] # Text starting with the sharp symbol will be a label
- [] # creates a horizontal separator and starts a new table
- ["#Target host1:", button1] # Text label for Host1, one button with text "Click"
- ["#Target host2:", button2] # Text label for Host2, one button with text "Click"
- ["#Target host3:", button3] # Text label for Host3, one button with text "Click"
- ["#Target host4:", button4] # Text label for Host4, one button with text "Click"
- ["#Target host5:", button5] # Text label for Host5, one button with text "Click"
- ["#Target host6:", button6] # Text label for Host6, one button with text "Click"
- ["#Target host7:", button7] # Text label for Host7, one button with text "Click"
- ["#Target host8:", button8] # Text label for Host8, one button with text "Click"
|
|
reads like this:
13. Save and exit by hitting CTRL + X, answering Y and hitting Enter when
prompted.
14. Restart the kvmd service
|
[root@pikvm
kvmd-webterm]#
systemctl restart kvmd |
|
15. Switching between hosts in the
UI
To switch between hosts, enter the KVM UI and click
the "Switches" menu. Click the buttons.
16. To disable write mode
|
[root@pikvm
kvmd-webterm]#
ro |
|
17. Reboot the system
|
[root@pikvm
kvmd-webterm]#
reboot |
|
|
| |
|
| |
|
CSI-2 bridge
connection test |
|
|
| |
|
| |
Make sure that the ‘/dev/video0’
device is available. Use this command to check:
|
[kvmd-webterm@pikvm
~]$ ls /dev/video0 |
|
If you see anything other than ‘file not found‘,
then it’s available.
|
| |
|
|
|
|
|
|
