Archives/pikvm
2
0
Fork 0
mirror of https://github.com/pikvm/pikvm synced 2024-11-10 13:10:37 +00:00
Code Issues Projects Releases Wiki Activity
d9e8a8bcef
pikvm/docs/flashing_os.md
Maxim Devaev 7a7ca7429c update
2023-10-18 22:58:23 +03:00

4.1 KiB
Raw Blame History

Flashing PiKVM OS image

!!! warning "Micro-SD Card Requirements" Minimum 16 Gb, Class 10 recommended

Download the image

Download the appropriate SD card image. Select it based on the board, platform, and the video capture device you are using.

!!! abstract "Official PiKVM Devices"

These images are not suitable for DIY and are intended only for our branded devices.

* **PiKVM V4**
    * [PiKVM V4 Mini](https://files.pikvm.org/images/v4mini-hdmi-rpi4-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v4mini-hdmi-rpi4-latest.img.xz.sha1)
    * [PiKVM V4 Plus](https://files.pikvm.org/images/v4plus-hdmi-rpi4-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v4plus-hdmi-rpi4-latest.img.xz.sha1)

* **PiKVM V3**
    * [PiKVM V3 HAT BOX Image, OLED/FAN preactivated](https://files.pikvm.org/images/v3-hdmi-rpi4-box-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v3-hdmi-rpi4-box-latest.img.xz.sha1)
    * [PiKVM V3 HAT DIY Assembly](https://files.pikvm.org/images/v3-hdmi-rpi4-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v3-hdmi-rpi4-latest.img.xz.sha1)</sub>

!!! abstract "DIY PiKVM V2 Platform"

* **Raspberry Pi 4**
    * [For HDMI-CSI bridge](https://files.pikvm.org/images/v2-hdmi-rpi4-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v2-hdmi-rpi4-latest.img.xz.sha1)</sub>
    * [For HDMI-USB dongle](https://files.pikvm.org/images/v2-hdmiusb-rpi4-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v2-hdmiusb-rpi4-latest.img.xz.sha1)</sub>

* **Raspberry Pi Zero 2 W**
    * [For HDMI-CSI bridge](https://files.pikvm.org/images/v2-hdmi-zero2w-latest.img.xz)
        <sub>- [*sha1*](https://files.pikvm.org/images/v2-hdmi-zero2w-latest.img.xz.sha1)</sub>

* **Raspberry Pi Zero W (obsolete)**
    * Support has been discontinued due to reaching the End-of-Life of the base board.<br>
        Please join [Discord](https://discord.gg/bpmXfz5) and ask about this in #unofficial_ports channel if you still want to use it.

!!! abstract "Any other platforms" You will need to build the image manually. But don't worry, it's very simple.

Flashing the image

!!! tip After inserting the memory card into your computer, ignore request to format. This is not nessessary.

Using Linux CLI

Decompress (if nessessary) and flash the image. Be careful when choosing the device path, it may be different on your machine:

[user@localhost]$ xz --decompress v2-hdmi-rpi4-latest.img.xz
[user@localhost]$ sudo dd if=v2-hdmi-rpi4-latest.img of=/dev/mmcblkX

You can also use dd_rescue or ddrescue.

Using RPi Imager (Linux, MacOS and Windows)

  1. Download and install the latest version of RPi Imager.

  2. Run RPi Imager:

  3. Press CHOOSE OS and select Use custom image at bottom of the list:

  4. After clicking on this item, select the image file (*.img or *.img.xz), then click CHOOSE STORAGE:

    !!! warning Check the advanced settings (CTRL+SHIFT+X), make sure they are blank or the flash will fail.

  5. Insert the memory card into the card reader. Choose the card reader from this list. Be careful and choose the right device:

  6. After choosing the memory card, press the WRITE button. Confirm the operation when you are asked about it:

  7. Wait for the process to finish. Get yourself a coffee or do some stretching :) The process may hang at 99% for a long time, this is okay, just wait for it to complete.

  8. Remove the memory card after successful completion. If an error occurs during flashing or booting PiKVM, repeat the process. If the error persists, use a different card.