You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

139 lines
5.7 KiB
Markdown

1 year ago
# PiKVM V4 Mini & Plus
<img src="overview.jpg" width="400" />
* [PiKVM V4 Mini Datasheet PDF](v4mini_datasheet.pdf)
* [PiKVM V4 Plus Datasheet PDF](v4plus_datasheet.pdf)
10 months ago
-----
1 year ago
## Installation requirements
1 year ago
* PiKVM V4 Mini or Plus box kit.
* Any reliable HDMI cable.
1 year ago
10 months ago
-----
1 year ago
## Basic setup
1. Unpack the box and connect the PiKVM according to the below:
1 year ago
1 year ago
| Back side | Front side |
|-----------|------------|
| <img src="plus_back.jpg" width="300" /> | <img src="plus_front.jpg" width="300" /> |
1 year ago
1 year ago
* **HDMI input** (the **bottom right** on the **back** side) and **OTG** port (USB emulation) should be connected to the computer. Optionally, the **[ATX port](atx_board.md)** can be connected to control the power. There should be no USB hub between PiKVM and the computer, as some UEFI/BIOS cannot detect them at the boot stage.
1 year ago
4 weeks ago
* Connect **Ethernet** (**bottom right** on the **front** side) to the network using the cable from the kit. The kit includes two Ethernet cables of different colors: one for the network, the second for ATX. Use whichever one you like best.
1 year ago
* Use the power supply and turn on PiKVM. The Mini comes with USB-C 5V power supply, and Plus with Barrel 12V. Use the appropriate connector on the **front** side. Please note that Plus can also work from 5V, in this case, do not connect a 12V power supply and don't create a significant power load on USB (external flash sticks, cameras, and so on).
8 months ago
!!! warning
Do not block the ventilation holes on the sides of the device. This is especially important for the V4 Plus, which has an active cooling.
12 months ago
7 months ago
2. Wait until PiKVM starts and shows a greeting on the built-in display.<br>
Do not turn off the device until it's fully booted for the first time.
1 year ago
7 months ago
3. **Carefully read and follow [the "First steps" guide](first_steps.md){target=_blank}.**<br>
It describes how to find PiKVM on the network, how to log in there, change passwords, and so on.<br>
8 months ago
**Follow the steps described there and come back to this page.**
1 year ago
4. ??? note "Using Fahrenheit instead of Celsius on the OLED"
7 months ago
6 months ago
```console
[root@pikvm ~]# mkdir -p /etc/systemd/system/kvmd-oled.service.d
```
7 months ago
6 months ago
Create file `/etc/systemd/system/kvmd-oled.service.d/override.conf`:
7 months ago
6 months ago
```ini
[Service]
ExecStart=
ExecStart=/usr/bin/kvmd-oled --clear-on-exit --fahrenheit
```
7 months ago
6 months ago
Then run `systemctl restart kvmd-oled`. In some cases, if you still do not see Fahrenheit being displayed, reboot the device.
1 year ago
12 months ago
5. **Just reminding again:**
{!_passwd.md!}
1 year ago
7 months ago
6. Try to manage the computer using PiKVM with the Web Interface.<br>
8 months ago
Make sure that you get an image and both keyboard and mouse are working.
If something doesn't work, check out our [FAQ](faq.md) (it's really useful).
If nothing helped, you can get support in our [Discord chat](https://discord.gg/bpmXfz5).
1 year ago
8 months ago
7. Configure access to PiKVM from the Internet using [port forwarding](https://docs.pikvm.org/port_forwarding)
or [Tailscale VPN](https://docs.pikvm.org/tailscale), if you need it.
2 months ago
8. **If you are using PiKVM V4 Plus, check out its new exclusive feature: [HDMI Passthrough](pass.md)!**
9. Explore the features of PiKVM using the site's table of contents and have fun!
1 year ago
10 months ago
-----
1 year ago
## ATX connection
[See here](atx_board.md).
1 year ago
10 months ago
-----
12 months ago
## DIP switches
11 months ago
There is a pair of DIP switches on the V4 right side. It is not recommended to change their state while the device is turned on.
12 months ago
| Right side |
|------------|
12 months ago
| <img src="plus_right.jpg" width="450" /> |
12 months ago
* The left switch **[1]**. When pulled down (**ON** state), the advanced backpower protection is used.
12 months ago
On the default state is **OFF** (up), "diode protection" is used.
11 months ago
This is required for debugging at the request of technical support. Under normal conditions, it is not necessary to change the mode.
12 months ago
* The right switch **[2]**. When pulled down (**ON** state), the Power Delivery chip is activated on the USB OTG port.
The default state is **OFF** (up).
10 months ago
-----
10 months ago
## Wi-Fi antenna
The PiKVM V4 has a robust metal case that protects your device from physical damage and electromagnetic interference.
This also means that an external antenna must be used for Wi-Fi.
We recommend the [official Antenna Kit](https://www.raspberrypi.com/products/compute-module-4-antenna-kit)
for Raspberry Pi.
To install the antenna, fix it in the round hole in the back side of the PiKVM,
and connect the wire to the connector on the Compute Module 4,
as described in the [instructions](https://datasheets.raspberrypi.com/cm4/cm4-antenna-kit-product-brief.pdf).
Next, to activate the antenna, add line `dtparam=ant2` to the `/boot/config.txt` file on PiKVM.
10 months ago
[Follow this guide](wifi.md) to configure Wi-Fi in PiKVM OS.
10 months ago
10 months ago
-----
1 year ago
## Internal USB on V4 Plus
The V4 Plus has an internal USB port that can be used at your discretion.
It supports USB 3.0, but by default it only works with USB 2.0 devices due to energy savings.
To enable USB 3.0, it is required to flash the USB controller firmware. It's very easy:
3 months ago
1. Choose `usb3` for USB 3.0 support, or `default` for the default USB 2.0-only firmware:
7 months ago
```console
[root@pikvm ~]# flashrom-vl805 usb3
1 year ago
```
7 months ago
3 months ago
2. Perform the soft reboot:
7 months ago
```console
[root@pikvm ~]# reboot
11 months ago
```
7 months ago
3 months ago
3. After the soft reboot, perform **reboot by power** (unplug and plug again the power cable).
1 year ago
10 months ago
-----
1 year ago
## Known issues and limitations
* There may be **compatibility** issues with some motherboards (such as **HP** or **DELL**) which are the same as those that exist with PiKVM V2. Not everything is perfect, but if you have already used PiKVM V2 - our new V4 will work great and please you. If there is no image from the BIOS, you can fine-tune the HDMI settings, but it is possible that the Mass Storage devices will not be available in the BIOS.