Template:KVM-FAQ: Difference between revisions

(17 intermediate revisions by 4 users not shown)

Line 1:

'''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 [https://github.com/pikvm/pikvm?tab=GPL-3.0-1-ov-file#readme GPLv3].

<span style="color:#f012be;">Geekworm's KVM products use the open source pikvm software developed by [https://pikvm.org pikvm.org] under the GPLv3 without any modification. Geekworm will regularly donate to pikvm.org</span>

<span class="tb_red">About '''after-sales service''' of Geekworm KVM Products:</span>

The after-sales service of all products sold by Geekworm should be the responsibility of our Geekworm team (email: '''support@geekworm.com'''), please <span class="tb_red">DO NOT</span> disturb the official PiKVM support team.

* First of all, we recommend you to get more FAQ information on the official website: [https://docs.pikvm.org/faq/ official FAQ], or check the following FAQ;

* You can post a issue ticket at [https://geekworm.com/community/forum/topic/78220/pikvm-faq 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

~~<div class="toccolours mw-collapsible mw-collapsed">~~

~~<div style="font-weight:bold;line-height:1.0;">~~

~~Q: How to enable oled display on [[KVM-A4]]?~~

~~</div>~~

~~<div class="mw-collapsible-content">~~

~~A. Refer to https://geekworm.com/community/forum/topic/85024/enable-oled-on-geekworm-pikvm-a4-kit~~

~~</div>~~

Q: Why [[KVM-A3]]/[[KVM-A4]]/[[KVM-A8]] does not show the video only display No Signals?

Q: Why [[KVM-A3]]/[[KVM-A4]]/[[KVM-A8]]/[[X680]] does not show the video only display No Signals?

</div>

Line 35:

Line 39:

Q: ~~Which pins are available on the KVM-A3~~?

Q: Why OLED is not display?

</div>

A: ~~You only can use GPIO16~~, 26, ~~11, 17, 25, 9, 10 pins on~~ [[~~KVM~~-A3]]

A: Please follow the steps below to check

</~~div~~>

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/

[[File:Pi4-V3-HAT.png|800px]]

*For Raspberry Pi Zero 2 W : https://docs.pikvm.org/flashing_os/

[[File:PiKVM V2 Platform.png|800px]]

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;

[[File:OLED-IMG-4373-1.jpg|800px]]

The run the following command to check the I2C address

sudo i2cdetect -y 1

<pre>

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: -- -- -- -- -- -- -- --

</pre>

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

<pre>

pikvm-update

rw

pacman -S i2c-tools -y

</pre>

4. Then run the following command to enable OLED display:

rw

systemctl enable --now kvmd-oled

ro

~~<div class="toccolours mw-collapsible mw-collapsed">~~

'''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.

~~<div style="font-weight:bold;line-height:1~~.~~0;">~~

Q: ~~I want to control several pc power~~. ~~Is it possible with one [[KVM~~-~~A3]] and several [[X630~~-~~A5]]?~~

~~</div>~~

~~<div class="mw~~-~~collapsible~~-~~content">~~

~~A. No, one kit can only control one pc,~~ you can ~~refer to [[X680]] to control up to 4 PCs~~.

</div>

Line 53:

Line 95:

Q: How ~~to do if [[KVM-A8]] hangs up or reboot or has to be started manually~~?

Q: How can I access the device from an external network?

</div>

~~A. The [[KVM-A8]] hardware itself does not cause~~ the ~~system to reboot, and [[KVM-A8 shield is controled by raspberry pi 4;~~

A：Please refer to the official tutorial : https://docs.pikvm.org/v3/

~~'''Please ensure these keys~~:~~'''~~

~~1. The [https://pikvm.org/download/ PiKVM OS version] is correct;~~

~~2. Check & use a high-quality power supply;~~

[[File:KVM_Networking.png|800px]]

~~3. Whether the raspberry pi 4 temperature is too high;~~

~~4. Contact us via email to support@geekworm.com~~

[[File:~~Kvm-a8-cable~~.~~jpg~~]]

~~If you find that the color wiring is wrong, please contact us at support@geekworm.com~~

</div>

Line 76:

Line 107:

Q. I ~~want to control several pc power. Is it possible with one [[KVM-A8]]~~

Q: How do I emulate various USB devices on the target machine?

</div>

A: ~~No, one PiKVM~~-~~A8 can only control one pc~~. ~~Please~~ refer to ~~[[X680]] 4-port IP KVM Switch~~.

[[File:How-to-emulate-various-USB-devices-on-the-target-machine.png]]

More details, pls refer to: https://discord.com/channels/580094191938437144/896216359963332628/1021503994436276245

</div>

Line 85:

Line 118:

Q. How to login pikvm os?

Q: How to login pikvm os?

</div>

Line 115:

Line 148:

Q. How to switch root user?

Q: How to switch root user?

</div>

Line 121:

Line 154:

su root

#default password is root also

</div>

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]]?

</div>

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.

</div>

Q: Which pins are available on the [[KVM-A3]]?

</div>

A: You only can use GPIO16, 26, 11, 17, 25, 9, 10 pins on [[KVM-A3]]

</div>

Q: I want to control several pc power. Is it possible with one [[KVM-A3]] and several [[X630-A5]]?

</div>

A. No, one kit can only control one pc, you can refer to [[X680]] to control up to 4 PCs.

</div>

Q: How to enable oled display on [[KVM-A4]]?

</div>

A. Refer to https://geekworm.com/community/forum/topic/85024/enable-oled-on-geekworm-pikvm-a4-kit

</div>

Line 135:

Line 204:

Q. Does [[KVM-A8]] support passive heatsink such as (P165-A or P165-B etc) instead of fan?

Q: How to do if [[KVM-A8]] hangs up or reboot or has to be started manually?

</div>

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 [https://pikvm.org/download/ 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

[[File:Kvm-a8-cable.jpg]]

If you find that the color wiring is wrong, please contact us at support@geekworm.com

</div>

Q: I want to control several pc power. Is it possible with one [[KVM-A8]]

</div>

A: No, one PiKVM-A8 can only control one pc. Please refer to [[X680]] 4-port IP KVM Switch.

</div>

Q: Does [[KVM-A8]] support passive heatsink such as (P165-A or P165-B etc) instead of fan?

</div>

Line 154:

Line 255:

<span class="tb_red">Q: Why is the X680 not working?</span>

<span class="tb_red">Q: Why is the [[X680]] not working?</span>

</div>

Line 184:

Line 285:

Q: Why is USB mass driver not recognized on X680?

Q: Why is USB mass driver not recognized on [[X680]]?

</div>

Line 199:

Line 300:

Q: Does the ~~x680~~ support audio?

Q: Does the [[X680]] support audio?

</div>

Line 207:

Line 308:

Q: Does the X680 support PoE power? How to enable PoE Power?

Q: Does the [[X680]] support PoE power? How to enable PoE Power?

</div>

Line 216:

Line 317:

Q: Why can't I switch to another PC on X680?'

Q: Why can't I switch to another PC on [[X680]]?

</div>

Line 225:

Line 326:

Q: Why NVME SSD cannot be recognized on ~~X680？~~

Q: Why NVME SSD cannot be recognized on [[X680]]？

</div>

Line 236:

Line 337:

Q: How to boot from NVMe SSD on X680?

Q: How to boot from NVMe SSD on [[X680]]?

</div>

Line 245:

Line 346:

You can also check out the official guide of the Raspberry Pi Foundation on how to boot CM4 from NVMe devices

* https://github.com/raspberrypi/documentation/blob/develop/documentation/asciidoc/computers/raspberry-pi/boot-nvme.adoc

</div>

Q: Can PiKVM work on Raspberry Pi 5？

</div>

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.

</div>

@@ Line 1: / Line 1: @@
+'''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 [https://github.com/pikvm/pikvm?tab=GPL-3.0-1-ov-file#readme GPLv3].
+<span style="color:#f012be;">Geekworm's KVM products use the open source pikvm software developed by [https://pikvm.org pikvm.org] under the GPLv3 without any modification. Geekworm will regularly donate to pikvm.org</span>
+<span class="tb_red">About '''after-sales service''' of Geekworm KVM Products:</span>
+The after-sales service of all products sold by Geekworm should be the responsibility of our Geekworm team (email: '''support@geekworm.com'''), please <span class="tb_red">DO NOT</span> disturb the official PiKVM support team.
 * First of all, we recommend you to get more FAQ information on the official website: [https://docs.pikvm.org/faq/ official FAQ], or check the following FAQ;
 * You can post a issue ticket at [https://geekworm.com/community/forum/topic/78220/pikvm-faq 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
-<div class="toccolours mw-collapsible mw-collapsed">
-<div style="font-weight:bold;line-height:1.0;">
-Q: How to enable oled display on [[KVM-A4]]?
-</div>
-<div class="mw-collapsible-content">
-A. Refer to https://geekworm.com/community/forum/topic/85024/enable-oled-on-geekworm-pikvm-a4-kit
-</div>
-</div>
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0; ">
-Q: Why [[KVM-A3]]/[[KVM-A4]]/[[KVM-A8]] does not show the video only display No Signals?
+Q: Why [[KVM-A3]]/[[KVM-A4]]/[[KVM-A8]]/[[X680]] does not show the video only display No Signals?
 </div>
 <div class="mw-collapsible-content">
@@ Line 35: / Line 39: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Which pins are available on the KVM-A3?
+Q: Why OLED is not display?
 </div>
 <div class="mw-collapsible-content">
-A: You only can use GPIO16, 26, 11, 17, 25, 9, 10 pins on [[KVM-A3]]
+A: Please follow the steps below to check
-</div>
-</div>
+. 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/
+[[File:Pi4-V3-HAT.png|800px]]
+*For Raspberry Pi Zero 2 W : https://docs.pikvm.org/flashing_os/
+[[File:PiKVM V2 Platform.png|800px]]
+. Please check if the order of OLED screen pins is correct, please email to support@geekworm.com if it's a wrong pin order;
+[[File:OLED-IMG-4373-1.jpg|800px]]
+The run the following command to check the I2C address
+ sudo i2cdetect -y 1
+<pre>
+  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
+:                         -- -- -- -- -- -- -- --
+: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- --
+: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+: -- -- -- -- -- -- -- --
+</pre>
+c 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
+<pre>
+pikvm-update
+rw
+pacman -S i2c-tools -y
+</pre>
+. Then run the following command to enable OLED display:
+ rw
+ systemctl enable --now kvmd-oled
+ ro
-<div class="toccolours mw-collapsible mw-collapsed">
+'''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.
-<div style="font-weight:bold;line-height:1.0;">
-Q: I want to control several pc power. Is it possible with one [[KVM-A3]] and several [[X630-A5]]?
-</div>
-<div class="mw-collapsible-content">
-A. No, one kit can only control one pc, you can refer to [[X680]] to control up to 4 PCs.
 </div>
 </div>
@@ Line 53: / Line 95: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: How to do if [[KVM-A8]] hangs up or reboot or has to be started manually?
+Q: How can I access the device from an external network?
 </div>
 <div class="mw-collapsible-content">
-A. The [[KVM-A8]] hardware itself does not cause the system to reboot, and [[KVM-A8 shield is controled by raspberry pi 4;
+A：Please refer to the official tutorial : https://docs.pikvm.org/v3/
-'''Please ensure these keys:'''
-. The [https://pikvm.org/download/ PiKVM OS version] is correct;
-. Check & use a high-quality power supply;
+[[File:KVM_Networking.png|800px]]
-. Whether the raspberry pi 4 temperature is too high;
-. Contact us via email to support@geekworm.com
-[[File:Kvm-a8-cable.jpg]]
-If you find that the color wiring is wrong, please contact us at support@geekworm.com
 </div>
 </div>
@@ Line 76: / Line 107: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q. I want to control several pc power. Is it possible with one [[KVM-A8]]
+Q: How do I emulate various USB devices on the target machine?
 </div>
 <div class="mw-collapsible-content">
-A: No, one PiKVM-A8 can only control one pc. Please refer to [[X680]] 4-port IP KVM Switch.
+[[File:How-to-emulate-various-USB-devices-on-the-target-machine.png]]
+More details, pls refer to: https://discord.com/channels/580094191938437144/896216359963332628/1021503994436276245
 </div>
 </div>
@@ Line 85: / Line 118: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q. How to login pikvm os?
+Q: How to login pikvm os?
 </div>
 <div class="mw-collapsible-content">
@@ Line 115: / Line 148: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q.  How to switch root user?
+Q:  How to switch root user?
 </div>
 <div class="mw-collapsible-content">
@@ Line 121: / Line 154: @@
   su root
   #default password  is root also
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+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]]?
+</div>
+<div class="mw-collapsible-content">
+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.
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q: Which pins are available on the [[KVM-A3]]?
+</div>
+<div class="mw-collapsible-content">
+A: You only can use GPIO16, 26, 11, 17, 25, 9, 10 pins on [[KVM-A3]]
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q: I want to control several pc power. Is it possible with one [[KVM-A3]] and several [[X630-A5]]?
+</div>
+<div class="mw-collapsible-content">
+A. No, one kit can only control one pc, you can refer to [[X680]] to control up to 4 PCs.
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q: How to enable oled display on [[KVM-A4]]?
+</div>
+<div class="mw-collapsible-content">
+A. Refer to https://geekworm.com/community/forum/topic/85024/enable-oled-on-geekworm-pikvm-a4-kit
 </div>
 </div>
@@ Line 135: / Line 204: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q.  Does [[KVM-A8]] support passive heatsink such as (P165-A or P165-B etc) instead of fan?
+Q: How to do if [[KVM-A8]] hangs up or reboot or has to be started manually?
+</div>
+<div class="mw-collapsible-content">
+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:'''
+. The [https://pikvm.org/download/ PiKVM OS version] is correct;
+. Check & use a high-quality power supply;
+. Whether the raspberry pi 4 temperature is too high;
+. Contact us via email to support@geekworm.com
+[[File:Kvm-a8-cable.jpg]]
+If you find that the color wiring is wrong, please contact us at support@geekworm.com
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q: I want to control several pc power. Is it possible with one [[KVM-A8]]
+</div>
+<div class="mw-collapsible-content">
+A: No, one PiKVM-A8 can only control one pc. Please refer to [[X680]] 4-port IP KVM Switch.
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q:  Does [[KVM-A8]] support passive heatsink such as (P165-A or P165-B etc) instead of fan?
 </div>
 <div class="mw-collapsible-content">
@@ Line 154: / Line 255: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-<span class="tb_red">Q: Why is the X680 not working?</span>
+<span class="tb_red">Q: Why is the [[X680]] not working?</span>
 </div>
 <div class="mw-collapsible-content">
@@ Line 184: / Line 285: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Why is USB mass driver not recognized on X680?
+Q: Why is USB mass driver not recognized on [[X680]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 199: / Line 300: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Does the x680 support audio?
+Q: Does the [[X680]] support audio?
 </div>
 <div class="mw-collapsible-content">
@@ Line 207: / Line 308: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Does the X680 support PoE power? How to enable PoE Power?
+Q: Does the [[X680]] support PoE power? How to enable PoE Power?
 </div>
 <div class="mw-collapsible-content">
@@ Line 216: / Line 317: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Why can't I switch to another PC on X680?'
+Q: Why can't I switch to another PC on [[X680]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 225: / Line 326: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Why NVME SSD cannot be recognized on X680？
+Q: Why NVME SSD cannot be recognized on [[X680]]？
 </div>
 <div class="mw-collapsible-content">
@@ Line 236: / Line 337: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: How to boot from NVMe SSD on X680?
+Q: How to boot from NVMe SSD on [[X680]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 245: / Line 346: @@
 You can also check out the official guide of the Raspberry Pi Foundation on how to boot CM4 from NVMe devices
 * https://github.com/raspberrypi/documentation/blob/develop/documentation/asciidoc/computers/raspberry-pi/boot-nvme.adoc
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q: Can PiKVM work on Raspberry Pi 5？
+</div>
+<div class="mw-collapsible-content">
+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.
 </div>
 </div>