Changes

* A good quality 32GB Micro SD minimum 16 Gb class 10 memory cardis recommended. （In fact, you don't need Micro SD card if you use CM4 with eMMC, because you can flash the firmware into the eMMC.） '''ATX Conrol cable(Not included):''' You can make your own ATX control cable, in fact, it is a normal Ethernet cable, and the requirements must be '''568B''' line sequence [[File:RJ75-568B.png]] '''RJ45 Pinout of KVM:''' [[File:RJ45-PINOUT.png]] ==Hardware Connection & installation==Refer to: https://youtu.be/ukHCz1RsFx4 {{#ev:youtube|https://youtu.be/ukHCz1RsFx4}} X680 HDMI port display information, according to the test: [[File:HDMI-OUT-INFO-1.jpg|700px|X680 HDMI port info]]

===How to installing [http://about:blank 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. ===OS Download & Installation===1. Firstly, need prepair a micro sd card, a minimum 32/64 Gb class 10 memory card is recommended. If you use a CM4 without with eMMC, you don't need a micro sd card. 2. Download an appropriate OS image for the PiKVM, the url link is https://pikvm.org/download/ or click [https://files.pikvm.org/images/v3-hdmi-rpi4-box-latest.img.xz this one] to download it. (Please use the '''V3 Pre-Assembled''' OS image)? :We recommend that you use the ''''V3 Pre-Assembled'''' version, and this image includes OLED display configuration.:<span style="color:red;">Only compatible with PiKVM V3 platform OS, NOT support PiKVM V4 Plus & V4 Mini platform!!!</span> :[[File:Pi4-V3-HAT.png|800px|PiKVM V3 platform]] ===Flash OS image===Refer :1. You can use Raspberry Pi Imager to Flash or the following alternatives tools::* [https://etcher.balena.io/ balenaEtcher]: The application runs on Windows, MacOS, and Ubuntu operating systems.:* [https://i-win32diskimager.com/ Win32 Disk Imager]: This imaging software is designed for Windows machines.:2. Flash OS image to a microSD memory card by following [https://docs.pikvm.org/flashing_os the simple instructions] or [https://www.raspberrypi.com/documentation/computers/getting-started.html#installing-the-operating-system Official installation tutorial] :3. Refer to [[#How to flash OS onto the eMMC of CM4? (CM4 with eMMC)?]] if you use the CM4 shield with eMMC. :4. Then power the device, then open explore to login the pikvm web ui.* How to flash OS onto the eMMC of CM4? (CM4 with eMMC)?:1. Short nBOOT Pin, refer to the picture below. :[[File:X680-IMG-5615-3.jpg|500px]]

===How to flash OS onto the eMMC of CM4? (:2. Connect CM4 USB port with eMMC)?===1. Short nBOOT Pin, refer a Type-A to Type-B cable to the picture below.your computer as follow:

:[[File:X680-IMG-56155546-3.jpg|500px]]

2:3. Connect CM4 USB port Power the device via PWR DC Jack with a Type-A to Type-B cable to your computer as follow:5V Power adaper

:4. Then rerfer to [[Filehttps:X680//www.jeffgeerling.com/blog/2020/how-IMGflash-5546raspberry-3.jpg|500px]pi-os-compute-module-4-emmc-usbboot this tutorial]to flash raspberry pi OS

3:5. Power Remove the jumper of nBOOT after flashing is complete, then restart your device via PWR DC Jack with 5V Power adaper;

4. Then rerfer to [https://www.jeffgeerling'''PS：If you use CM4 with eMMC, then SD card cannot be used.com/blog/2020/how-flash-raspberry-pi-os-compute-module-4-emmc-usbboot this tutorial] to flash raspberry pi OS'''

5. Remove ===Configuring the PiKVM OS===* '''Login web UI''': Access to PiKVM Web Interface via any browser with the jumper URL '''https://pikvm/''' OR '''https://IP''' address of nBOOT after flashing your ipkvm/, the default user and password is completeadmin/admin* '''Log into PiKVM and open Terminal program'''* '''Switch to 'root' user ''':<pre>su root</pre>:then type the password, then restart your device;and the default password is 'root' also.* '''Switch OS to writable mode''':<pre>rw</pre>

* '''PS：If Enable RTC''' ('''Only for X680 V1.3''' because v1.3 use the ds1307 chip, Please skip this step if you use CM4 X680 V1.5 using the same chip pcf8563 with pikvm official product):1. Due to different RTC chips with eMMCofficial PiKVM hardware, then SD card cannot be used.you still need to '''configure RTC'''to make RTC work normally.

===OS download===Refer to https://pikvm2.org/download/Insert the '''C1220''' button battery. run the following command in web terminal window:

For Raspberry Pi 4, please use [https:3. Edit the /boot/filesconfig.pikvmtxt file, and change line <code>dtoverlay=i2c-rtc,pcf8563</code> to <code>dtoverlay=i2c-rtc,ds1307</code> (due to use the different RTC chip).org:<pre>sudo nano /imagesboot/v3-hdmi-rpi4-box-latest.img.xz PiKVM V3 platform]config.txt</pre>:Then save & '''reboot''' the device;

[[File:Pi4Test & setting RTC, write&read the time of Raspberry Pi to RTC DS1307<dd><pre>date sudo hwclock -V3w sudo hwclock -HAT.png|800px|PiKVM V3 platform]]r</pre></dd>

*'''PSEnable OLED display''':Run the following command in web terminal window to enable OLED display::<pre>systemctl enable --now kvmd-oled kvmd-oled-reboot kvmd-oled-shutdown </pre>:If you are using <code>PiKVM OS V3 Pre-Assembled</code>, the OLED configuration is already pre-installed, you can ignore this step.: Rotate the OLED display by 180 degrees (Optional):<pre>nano /usr/bin/kvmd-oled</pre>:Change the line:return {"height": 64, "rotate": '''2'''} to return {"height": 64, "rotate": '''0'''}, then save & exit

We recommend that you use the * '''Enable pikvm hdmi audio'V3 Pre-Assembled'''' version, and this image includes OLED display configuration.:Refer to [[Enable pikvm hdmi audio]]

But due to different RTC chips, you still need to configure RTC to make RTC work normally, please refer *How to boot from NVME SSD？:1.Prepare the following '''FAQ#Q: How to enable RTCWin32 Disk Imager tool'''===Computersfirst, download and install it, refer to:https://Servers Switching===Press to select PC1sourceforge.net/PC2projects/PC3win32diskimager/PC4 through buttons on front panel. the corresponding LED located on the right of the button will be on if a PC is selected. the PC1 will be automatically selected when power applied or restored.

===Hotkey swtiching===* Keyboard must be connected to USB1:2.1 port (Marked with an icon of keyboard)* Press Insert NVME SSD into the "Ctrl" twice quickly, then immediately press "1" to switch to PC1* Press the "Ctrl" twice quickly, then immediately press "2" to switch to PC2* Press the "Ctrl" twice quickly, then immediately press "3" to switch to PC3* Press the "Ctrl" twice quickly, then immediately press "4" to switch '''USB to PC4NVME ssd adapter''' or [[X876]]

:3. Connect '''USB to NVME SSD adapter''' or [[X876]] to computer through USB A cable, then a USB drive can be recognized in computer. :4. Open '''Win32 Disk Imager''' tool, then select the '''PiKVM os image file''' and '''USB drive''', then click '''Write''' button :5. Wait a few minutes for the write process to complete. :6. Insert NMVE SSD into the X680, then power on (must remove the micro sd card firstly) *'''Mass Storage Drive''':Refer to: https://docs.pikvm.org/msd/* '''Check Video Output''':<pre>ls /dev/video0</pre>: Run the above command, if you see anything such as '''/dev/video0''' other than '''file not found''', then it’s available* <span class="tb_red">'''To support max resolution 1920x1080 60Hz''' （for '''V1.5''' only)</span>:<pre>nano /boot/config.txt</pre>:Change the line7 from '''dtoverlay=tc358743''' to '''dtoverlay=tc358743,<span class="tb_red">4lane=1</span>''':Save and exit by hitting '''CTRL + X''', answering '''Y''' and hitting Enter when prompted. :'''Editing the EDID''':<pre>nano /etc/kvmd/tc358743-edid.hex</pre>:Delete existing EDID data, then copy and paste below new EDID data<dd><pre>00FFFFFFFFFFFF0052628888008888881C150103800000780AEE91A3544C99260F505400000001010101010101010101010101010101011D007251D01E206E285500C48E2100001E8C0AD08A20E02D10103E9600138E2100001E000000FC00546F73686962612D4832430A20000000FD003B3D0F2E0F1E0A202020202020014F020323454F041303021211012021A23C3D3E1F102309070766030C00300080E3007F8C8C0AD08A20E02D10103E9600C48E210000188C0AD08A20E02D10103E9600138E210000188C0AA01451F01600267C4300138E21000098000000000000000000000000000000000000000000000000000000000000000000000000000087</pre></dd>:Save and exit by hitting CTRL + X, answering Y and hitting Enter when prompted.* <span class="tb_red">'''Adding UI elements to control the KVM switch''' （for '''V1.5''' only)</span>:Edit the file: /etc/kvmd/override.yaml and include the following:<dd><pre>kvmd: gpio: scheme: button1: pin: 16 # GPIO pin number for PC1 mode: output switch: false pulse: delay: 1 max_delay: 2 button2: pin: 26 # GPIO pin number for PC2 mode: output switch: false pulse: delay: 1 max_delay: 2 button3: pin: 11 # GPIO pin number for PC3 mode: output switch: false pulse: delay: 1 max_delay: 2 button4: pin: 17 # GPIO pin number for PC4 mode: output switch: false pulse: delay: 1 max_delay: 2  view: header: title: Switches # The menu title table: # The menu items are rendered in the form of a table of text labels and controls - ["#X680 IPKVM Switch"] # Text starting with the sharp symbol will be a label - [] # creates a horizontal separator and starts a new table - ["#PC1-XXXXX:", button1] # Text label for PC1, one button with text "Click" - ["#PC2-XXXXX:", button2] # Text label for PC2, one button with text "Click" - ["#PC3-XXXXX:", button3] # Text label for PC3, one button with text "Click" - ["#PC4-XXXXX:", button4] # Text label for PC4, one button with text "Click"</pre></dd>:As follows :[[File:X680v1.5-setting2.png|800px]] :Save and exit by hitting CTRL + X, answering Y and hitting Enter when prompted. :Then restart the kvmd service with the coomand::<pre>systemctl restart kvmd</pre> * '''Disable writable mode''': <pre>ro</pre> *'''Reboot to make the changes take effect''': <pre>reboot</pre> * '''How to switch target computers/servers''':The IP KVM (X680) Switch supports direct switching through buttons on front panel and hotkey through keyboard connected to the special USB 1.1 port. it also supports remote hotkey switching between computers for easy monitoring. :'''Computers/Servers Switching'''::Press to select PC1/PC2/PC3/PC4 through buttons on front panel. the corresponding LED located on the right of the button will be on if a PC is selected. the PC1 will be automatically selected when power applied or restored. :'''Hotkey switching''':* Keyboard must be connected to USB1.1 port (Marked with an icon of keyboard):* Press the "Ctrl" twice quickly, then immediately press "1" to switch to PC1:* Press the "Ctrl" twice quickly, then immediately press "2" to switch to PC2:* Press the "Ctrl" twice quickly, then immediately press "3" to switch to PC3:* Press the "Ctrl" twice quickly, then immediately press "4" to switch to PC4 :'''Remote hotkey switching===''':* Access to PiKVM web interface and log in:* Press the "Ctrl" twice quickly, then immediately press "1" to switch to PC1:* Press the "Ctrl" twice quickly, then immediately press "2" to switch to PC2:* Press the "Ctrl" twice quickly, then immediately press "3" to switch to PC3:* Press the "Ctrl" twice quickly, then immediately press "4" to switch to PC4:* If your mouse cursor is not in the area of the PiKVM web interface, it is not functional :''' <span class="tb_red">Switching hosts in the Web UI''' (for '''V1.5''' only </span>） :To switch between hosts, enter the KVM UI and click the "Switches" menu. Click the buttons. :[[File:X680v1.5-setting3.png|800px]]

<div class="toccolours mw-collapsible mw-collapsed"><span div style="color:red;font-weight:bold;line-height:1.0;">Q: Why is the X680 not working?</spandiv><div class="mw-collapsible-content">

1. First you need to make sure your physical connection is correct, or you can email us at support@geekworm.com to confirm your physical connection;(<span styleclass="color:red;tb_red">Please make sure the CM4 is rightly and tightly connected.</span>)

'''Q<div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight: Does the x680 support audio?''' Abold;line-height: Yes1. Refer to [[Enable pikvm hdmi audio]] 0;">'''Q: Why OLED is not display?'''</div><div class="mw-collapsible-content">

2. Please check if the order of OLED screen pins is correct, please contact us email to support@geekworm.com if it's a wrong pin order;

'''<div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0;">Q: How to enable RTCDoes x680 support proarammable switch between PC?'''</div><div class="mw-collapsible-content">A: NO</div></div>

A<div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height: Firstly, insert the C1220 button battery1.0;">run Q: Does the following command:X680 support PoE power? How to enable PoE Power? rw</div> sudo nano /boot/config.txt<div class="mw-collapsible-content"> #Then change the lineA: The X680 doesn'''dtoverlay=i2c-rtct support POE,pcf8563''' but you can use something similar to '''dtoverlay=i2c-rtc,ds1307''' #Test RTC #Display the current time of the Raspberry Pi date #Write the time of Raspberry Pi to DS1307 sudo hwclock [[PD3005G-w3A]] </div> #Read the time of DS1307 sudo hwclock -r ro</div>

<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?''Q</div><div class="mw-collapsible-content">A: Does the X680 support PoE power? How You need to enable PoE Power?make sure that your target computer is not in '''sleep''', because when the computer is sleep, the USB port will stop supplying power</div></div>

<div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0;">Q: Why NVME SSD cannot be recognized？</div><div class="mw-collapsible-content">A: The X680 reserve Login the POE port, but need to use with customized POE module to support PoE powerpikvm web teminal, and then type the customized POE module still not release now. And following command: lspciThe result of the X680 does not support command should look similar to the Raspberry Pi official PoE module.Recommend to use [[PiKVM-A8]] kitfollowing, if you need PoE power. '''Q: Why can't I switch find something similar to another PC?''' A: You need to make sure that the following, your target computer NVME SSD is not in '''sleep''', because when the computer is sleep, the USB port will stop supplying powercompatible</div></div>