image urls

pull/502/head
Maxim Devaev 3 years ago
parent ff8bee53cb
commit bd6649f11b

@ -8,11 +8,11 @@ The website: [pikvm.org](https://pikvm.org). Also join to the [Discord Community
| **[>>> DIY Device Getting Started <<<](#diy-getting-started)** | **[>>> PiKVM v3 HAT Getting Started <<<](#pikvm-v3-hat-features)** |
| --------------------------------------------- | ------------------------------------------ |
| [DIY Review by **Novaspirit Tech**](https://youtu.be/plP9Y1likRg)<br>[**Hackaday**](https://hackaday.com/2020/11/24/true-networked-kvm-without-breaking-the-bank/) & [**Tom's HARDWARE**](https://www.tomshardware.com/how-to/kvm-over-ip-raspberry-pi)<br>[Our boring presentation for the DIY :)](https://youtu.be/9YhPWjWv5gw) | [PiKVM v3 Review by **Novaspirit Tech**](https://youtu.be/dTchVKxx7Fo)<br>[Another review by **Level1Techs**](https://www.youtube.com/watch?v=LwsznhIBPMc)<br>[Review by **The Geek Freaks** (DE)](https://www.youtube.com/watch?v=fnd6wojrw3c) |
| <img src="img/v2_example.jpg" alt="drawing"/> | <img src="img/v3_board.jpg" alt="drawing"/> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v2_example.jpg" alt="drawing"/> | <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v3_board.jpg" alt="drawing"/> |
| Web UI |
| ------------------------------------------ |
| <img src="img/screen1.png" alt="drawing" height=200/> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/screen1.png" alt="drawing" height=200/> |
# Features
@ -174,7 +174,7 @@ The dongle is completely supported and PiKVM works great with it. But it has som
# PiKVM v3 HAT Features
<img src="img/v3_kit.jpg" alt="drawing" height=200>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v3_kit.jpg" alt="drawing" height=200>
**[>>> PiKVM v3 HAT on Kickstarter! <<<](https://www.kickstarter.com/projects/mdevaev/pikvm-v3-hat)**
@ -218,13 +218,13 @@ Insert the flexible flat cable of the HDMI bridge into the narrow white connecto
| Opening the MIPI CSI-2 slot on the Raspberry Pi |
| ------------------------------------------------------------------------------------------------ |
| <img src="img/open-MIPI-CSI2-Slot.png" alt="detailed picture of the MIPI-CSI2 slot" width="350"> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/open-MIPI-CSI2-Slot.png" alt="detailed picture of the MIPI-CSI2 slot" width="350"> |
For the HDMI-CSI bridge it depends on the version you bought. Either pull it gently up as on the Raspberry or push it sideways. Make sure that the cable is inserted on the correct side and until it stops, and then push the black latch back. Never connect or disconnect the flat cable from a powered device. This is not Plug-and-Play, and you can damage it. Also use only the cable that was included with the device package, or make sure that the third-party cable has the correct pinout.
| HDMI-CSI-2 bridge connected to Raspberry Pi 4 |
| ------------------------------------------------------------------------------------------------------------ |
| <img src="img/rpi4-hdmi-csi-connection.png" alt="HDMI-CSI-2 bridge connected to Raspberry Pi 4" width="350"> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/rpi4-hdmi-csi-connection.png" alt="HDMI-CSI-2 bridge connected to Raspberry Pi 4" width="350"> |
</details>
@ -235,7 +235,7 @@ Connect USB dongle to exactly this port. It is bound in the software so the OS d
| Raspberry Pi 2 and 3 | Raspberry Pi 4 |
| ------------------------------------------------------------- | ------------------------------------------------------------- |
| <img src="img/v2_usbcap_rpi2.png" alt="drawing" width="200"/> | <img src="img/v2_usbcap_rpi4.png" alt="drawing" width="200"/> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v2_usbcap_rpi2.png" alt="drawing" width="200"/> | <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v2_usbcap_rpi4.png" alt="drawing" width="200"/> |
There are many revisions of the Raspberry Pi boards and you may come across one that we haven't tested. If the binding fails, the device will be available for all ports. Everything will work, but if you use a webcam and Linux mistakes it for a dongle, [write to us](https://discord.gg/bpmXfz5) and we will fix it.
</details>
@ -247,12 +247,12 @@ Here is a diagram shows that how to connect all of the pieces (click to full siz
| ATX control board | USB splitter cable (only for Raspberry Pi 4) |
| ------------------------------------------------- | ---------------------------------------------------------- |
| <img src="img/v2.png" alt="drawing" width="400"/> | <img src="img/v2_splitter.png" alt="drawing" width="400"/> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v2.png" alt="drawing" width="400"/> | <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v2_splitter.png" alt="drawing" width="400"/> |
**Raspberry Pi 4**: since one USB-C female connector is used to receive power and perform keyboard/mouse/drive emulation a special Y-cable must be made that splits the DATA and POWER lines of USB-C (see [reasons](https://github.com/pikvm/docs/issues/11)). It can be made from two suitable connecting cables, or soldered together from scratch. Be sure to check the circuit diagram below, otherwise you may damage your devices. The appropriate USB pinout(s) can easily be found on Google. Please note that if you make a Y-cable from two no-name cables, the colors of the wires may not match those shown. Use a multimeter to make sure the connections are correct.
**Raspberry Pi Zero W**: This board has two USB micro connectors: one for power supply, the second for emulating a USB OTG device. You need to prevent backpowering as in the RPi4 case. To do this, you need to cut off the red power wire in the OTG wire, or seal the +5v pin in the USB-A connector with electrical tape like this:
<img src="img/v2_tape_off.png" alt="drawing" width="300"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v2_tape_off.png" alt="drawing" width="300"/>
See video how-tos:
* [Making USB Y-splitter cable](https://www.youtube.com/watch?v=uLuBuQUF61o).
@ -266,7 +266,7 @@ See video how-tos:
| ATX control board and Arduino HID (keyboard & mouse) |
| ---------------------------------------------------- |
| <img src="img/v0.png" alt="drawing" width="400"/> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v0.png" alt="drawing" width="400"/> |
</details>

@ -81,7 +81,7 @@ Next, you need to connect Arduino pins to the female PS/2 port of your motherboa
Follow this diagram:
| Female PS/2 port (front view) | Pinout |
|-------------------------------|--------|
| <img src="/img/ps2_kbd.png" alt="drawing" width="200"/> | Arduino pin 7 <-> PS/2 CLOCK<br>Arduino pin 5 <-> PS/2 DATA<br>Arduino GND pin <-> PS/2 GND |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/ps2_kbd.png" alt="drawing" width="200"/> | Arduino pin 7 <-> PS/2 CLOCK<br>Arduino pin 5 <-> PS/2 DATA<br>Arduino GND pin <-> PS/2 GND |
**Connect VIN pin of Arduino to [any Raspberry's 5v pin](https://pinout.xyz/pinout/5v_power) for PS/2 only device. But you don't need to connect the Arduino VIN pin if you connected USB (Arduino will get power through it).**
@ -91,7 +91,7 @@ Due to an ancient buggy driver, the USB absolute mouse on Windows 98 moves only
## SPI connection to Arduino Micro
Using an SPI connection, an Arduino Micro or compatible can be flashed from the Pi and used as an HID keyboard and mouse. Unlike UART, SPI does not share pins with Bluetooth on the Raspberry Pi so the Bluetooth radio does not need to be disabled.
<img src="/img/arduino_spi_hid.png" alt="Diagram of the Arduino SPI wiring for HID keyboard and mouse." width="654"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/arduino_spi_hid.png" alt="Diagram of the Arduino SPI wiring for HID keyboard and mouse." width="654"/>
Before powering either device, double-check the connections. The following should be wired from the Pi to either the level shifter or the Arduino. While the Arduino tolerates 3.3V logic input, 5V outputs from the Arduino can damage or destroy the Raspberry Pi and must not be connected directly to 3.3V GPIO pins directly.
@ -129,7 +129,7 @@ Pictures of this setup are also available in full resolution for download to ass
| Raspberry Pi Closeup | Breadboard with Arduino |
|------------|--------|
| <img src="/img/arduino_spi_hid_rpi.jpg" alt="A closeup of the Raspberry Pi wired to the breadboard." width=300/> | <img src="/img/arduino_spi_hid_bb.jpg" alt="Arduino on a breadboard fully wired to the Pi." width=300/> |
| <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/arduino_spi_hid_rpi.jpg" alt="A closeup of the Raspberry Pi wired to the breadboard." width=300/> | <img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/arduino_spi_hid_bb.jpg" alt="Arduino on a breadboard fully wired to the Pi." width=300/> |
Programming assumes the Arduino is powered via USB, either from the connected host or the Pi itself. If the USB is not connected, 5 V may be provided by the Raspberry Pi GPIO but should be disconnected prior to connecting USB to the microcontroller's USB port. The Raspberry Pi does not have backcurrent protection, a circuit using one or more Schottky diodes can be built to OR power from multiple sources but it's easier and more cost effective to avoid conflict and voltage differences between power supplies by leaving the 5 V wire disconnected.

@ -124,7 +124,7 @@ Note: if you can't find an answer to your question here, try the [Community FAQ]
* On some motherboards, the BIOS may be displayed at a lower resolution, or with some rendering issues/glitches, specially on newer ASUS ones. Like this:
<img src="../img/bios_glitch.png" alt="ASUS BIOS glitch" width="400"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/bios_glitch.png" alt="ASUS BIOS glitch" width="400"/>
This can be solved by enabling the **Compatibility Support Module (CSM)** in your BIOS, usually under the **Boot** options.
@ -229,7 +229,7 @@ Note: if you can't find an answer to your question here, try the [Community FAQ]
* The latest versions of Chrome do not allow access to the page with a self signed certificate, so if you see the following screen when loading the PiKVM website:
<img src="../img/chrome.png" alt="Chrome Blocking" width="400"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/chrome.png" alt="Chrome Blocking" width="400"/>
* You can proceed by typing ```thisisunsafe``` and Chrome will then load the page.
</details>

@ -19,23 +19,23 @@ Decompress and flash image and follow to the [final steps](#the-final-steps). Be
3. Run Balena Etcher:
<img src="../img/balena-1.png" alt="drawing" height="300"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/balena-1.png" alt="drawing" height="300"/>
4. Press **Flash from file** and select the image:
<img src="../img/balena-2.png" alt="drawing" height="300"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/balena-2.png" alt="drawing" height="300"/>
5. Insert the memory card into the card reader. Press **Select target** and choose your memory card:
<img src="../img/balena-3.png" alt="drawing" height="300"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/balena-3.png" alt="drawing" height="300"/>
6. Press **Flash!** button.
<img src="../img/balena-4.png" alt="drawing" height="300"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/balena-4.png" alt="drawing" height="300"/>
7. Wait for the process to finish. Get yourself a coffee or do some stretching. :wink: If an error occurs during flashing, repeat the process:
<img src="../img/balena-5.png" alt="drawing" height="300"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/balena-5.png" alt="drawing" height="300"/>
**NOTE** - If Etcher does not work for you and you continue to get failed bootup's, download RaspberryPi imager and use that instead

@ -136,7 +136,7 @@ kvmd:
This will be rendered as:
<img src="../img/gpio_menu.png" alt="drawing" />
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/gpio_menu.png" alt="drawing" />
Some rules and customization options:
- Text starting with the `#` symbol will be a label.

@ -18,11 +18,11 @@ In some ways, this is the most complex part of this. The default IP address of t
If you need to change it, you will first need to connect to the switch with a Windows machine, most easily directly through an ethernet cord, with your Windows laptop (or VM) up and assigned to a fixed IP address, such as 192.168.1.5. Once you've launched the utility you will see this screen:
<img src="/img/tesmart_controller_1.png" alt="Configuration screen for TESMART Windows controller utility"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/tesmart_controller_1.png" alt="Configuration screen for TESMART Windows controller utility"/>
On this screen, ensure you are on the "General" tab. Click the radio button for "Network control". Change the IP address to the default for the switch (may already be this -- 192.168.1.10). Press the "Connect" button. Should make the status light go green, as well as the selected port. If you do not get a connection here, you cannot proceed to change the IP address. To change the IP address, change to the "Settings" tab at the top. You will then see this screen:
<img src="/img/tesmart_controller_2.png" alt="Configuration screen for TESMART Windows controller utility"/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/tesmart_controller_2.png" alt="Configuration screen for TESMART Windows controller utility"/>
On this screen, change to your desired IP address, gateway, mask, and port. Then press apply. Watch the box on the right to see if it applied OK. Press Query again to double-check. The actual IP address will not be changed until you power off/power on the switch. Make sure you have these settings correct, because if you get them wrong you would have to connect over RS232/serial and not the network.

@ -45,7 +45,7 @@ To use PiKVM v3, you will need the following things, which are NOT included in t
5. **Important!** If you are going to use GPIO pins to control a relay, KVM switch, or anything else, be sure to check the v3 shield pinout. Many ports are busy with internal functions. Before using them for your own use, you must disable them, otherwise you may damage the device.
# IO ports
<img src="../img/v3.png" alt="drawing" height=400/>
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/v3.png" alt="drawing" height=400/>
### Description
1. **USB for the power**

@ -14,7 +14,7 @@ As an alternative to the web interface, you can use VNC with various desktop cli
```
_All available keymaps are located in /usr/share/kvmd/keymaps:_
![VNC keymaps](/img/vnc-keymaps.png)
![VNC keymaps](https://raw.githubusercontent.com/pikvm/pikvm/master/img/vnc-keymaps.png)
3. _Optional:_ (This step is not nessessory if using TigerVNC) Some VNC clients (for example TightVNC) can't use user/password authentication. In this case you can enable passphrases mode in `/etc/kvmd/override.yaml`:
```yaml

@ -25,15 +25,15 @@ wifi-menu -o
```
The `-o` makes sure that the WiFi passphrase is stored encrypted. Otherwise it will be stored in cleartext in the profile file. `wifi-menu` will scan for all available WiFi networks and provide you a list:
![Wifi Menu 1](/img/wifi-1.png)
![Wifi Menu 1](https://raw.githubusercontent.com/pikvm/pikvm/master/img/wifi-1.png)
Select the WiFi you want to connect to and give the profile file a name. The default name is wlan0-wifiname:
![Wifi Menu 2](/img/wifi-2.png)
![Wifi Menu 2](https://raw.githubusercontent.com/pikvm/pikvm/master/img/wifi-2.png)
Enter the WPA-Passphrase:
![Wifi Menu 3](/img/wifi-3.png)
![Wifi Menu 3](https://raw.githubusercontent.com/pikvm/pikvm/master/img/wifi-3.png)
Afterwards `wifi-menu` will try to connect to the WiFi. If you're connected via ssh or the Web Terminal you'll loose connection to the Raspberry Pi. Most DHCP servers will give the Raspberry Pi a new (and usually different) IP address for each interface (LAN / WLAN).
@ -45,7 +45,7 @@ If you want to store the WiFi passphrase encrypted you have to generate it via `
wpa_passphrase wifiname this_is_my_great_and_secure_key_1234567890
```
![WPA passphrase generation](/img/wifi-4.png)
![WPA passphrase generation](https://raw.githubusercontent.com/pikvm/pikvm/master/img/wifi-4.png)
Copy the second hexadecimal string without *psk=*. In this example _814c45d0f88f60636532b034c463639a506670f8ba3c7965e62cdbc1989f6d66_.
Create a new file with the editor of your choice:

@ -1,7 +1,7 @@
### Some example wiring setups
# CSI (Geekworm) (Any brand will be the same)
<img src="/img/csi_wiring.jpg" alt="drawing">
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/csi_wiring.jpg" alt="drawing">
List of items: (WARNING! Links may dissappear or no longer work, this just gives you an idea)
@ -13,13 +13,13 @@ List of items: (WARNING! Links may dissappear or no longer work, this just gives
- TARGET (Anything you want to control)
# Another CSI example using the PCB splitter
<img src="/img/csi_wiring_w_pcb_splitter.jpg" alt="drawing">
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/csi_wiring_w_pcb_splitter.jpg" alt="drawing">
# USB
<img src="/img/usb_capture_wiring.jpg" alt="drawing">
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/usb_capture_wiring.jpg" alt="drawing">
# Direct connect to target
<img src="/img/direct_connect_to_target.jpg" alt="drawing">
<img src="https://raw.githubusercontent.com/pikvm/pikvm/master/img/direct_connect_to_target.jpg" alt="drawing">
Explanation of pic
- USB-C from PI to USB-A onto target which also powers the PI

@ -1,5 +1,5 @@
# XH-HK4401 4-port HDMI USB KVM Switch
![KVM](../img/xh-hk4401.jpg)
![KVM](https://raw.githubusercontent.com/pikvm/pikvm/master/img/xh-hk4401.jpg)
This KVM is sold (https://www.aliexpress.com/item/4000849336545.html) under many names, and comes in two versions.
The only way these two versions differ is that one has one of its USB ports replaced with a PS/2 port. The
@ -31,7 +31,7 @@ For this you will need:
- 1x USB Micro connector, or sacrificial micro USB cable
- Optional: USB UART adapter
![KVM](../img/xh-hk4401_circuit.jpg)
![KVM](https://raw.githubusercontent.com/pikvm/pikvm/master/img/xh-hk4401_circuit.jpg)
You can connect this either via a USB UART adapter, or directly to the Raspberry Pi: GND -> Pin 6, TX -> Pin 8, RX -> Pin 10.
On the v3 PiKVM hat you will need to disable the UART jumpers to use the on-board UART.

Loading…
Cancel
Save