public_git
/
pikvm
mirror of https://github.com/pikvm/pikvm.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

dvd support

This commit is contained in:
Maxim Devaev 2025-01-24 04:49:15 +02:00
parent 310af47588
commit 001dedd711
2 changed files with 26 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@ -1,7 +1,7 @@
# Open and inexpensive DIY IP-KVM based on Raspberry Pi
[![Discord](https://img.shields.io/discord/580094191938437144?logo=discord)](https://discord.gg/bpmXfz5) [![Reddit](https://img.shields.io/badge/reddit-join-orange?logo=reddit)](https://www.reddit.com/r/pikvm)
A very simple and fully functional Raspberry Pi-based KVM (Keyboard-Video-Mouse) over IP that you can make with your own hands. This device helps to manage servers or workstations remotely, regardless of the health of the operating system or whether one is installed. You can fix any problem, configure the BIOS, and even reinstall the OS using the virtual CD-ROM or Flash Drive.
A very simple and fully functional Raspberry Pi-based KVM (Keyboard-Video-Mouse) over IP that you can make with your own hands. This device helps to manage servers or workstations remotely, regardless of the health of the operating system or whether one is installed. You can fix any problem, configure the BIOS, and even reinstall the OS using the virtual CD/DVD or Flash Drive.
The website: [pikvm.org](https://pikvm.org). Also check out [the documentation](https://docs.pikvm.org) and join to the [Discord Community Chat](https://discord.gg/bpmXfz5) for news, questions and support!
@ -15,7 +15,7 @@ The website: [pikvm.org](https://pikvm.org). Also check out [the documentation](
* *Raspberry Pi 5 is not supported right now. It doesn't have GPU video encoders, therefore, there is no point in using it for PiKVM, it will not give any performance boost for this case. The Pi 5 is a great device, just not suitable for PiKVM.*
* **FullHD video** using advanced **HDMI-to-CSI bridge** or **USB dongle**;
* Extra low **video latency** with **MJPEG** or **H.264** via direct HTTP or WebRTC streaming (for CSI bridge);
* Bootable **Virtual CD-ROM** and **Flash Drive**, ability to store images on **NFS**;
* Bootable **Virtual CD/DVD** and **Flash Drive**, ability to store images on **NFS**;
* USB **Keyboard** and **mouse** (with leds and the wheel), Bluetooth HID, Mouse jiggler, full support of PS/2;
* **Control the server power** using ATX functions;
* Access via **Web UI** or **VNC**;
@ -108,7 +108,7 @@ All of them uses our common open source software stack.
| <div align="center">⭐ ⭐ ⭐ **PERIPHERY** ⭐ ⭐ ⭐</div> | **V4 Plus** | **V4 Mini** | | **V3** | | **DIY V2** | **DIY V1** |
||
| USB keyboard/mouse emulation | ✅ | ✅ | | ✅ | | ✅ | ✅ |
| Virtual **Flash Drive** / **CD-ROM** emulation | ✅ | ✅ | | ✅ | | ✅ | ❌ |
| Virtual **Flash Drive** / **CD/DVD** emulation | ✅ | ✅ | | ✅ | | ✅ | ❌ |
| Ability to simulate **"eject/insert"** for USB | ✅ | ✅ | | ✅ | | ❌ | ❌ |
| **Onboard ATX controller** for power management of the host | ✅ | ✅ | | ✅ | | DIY | DIY |
| **Built-in OLED** with IP and other info | ✅ | ✅ | | ✅ | | ❌ | ❌ |
@ -159,7 +159,7 @@ All of them uses our common open source software stack.
* **Keyboard and mouse**
Mouse usage works directly in the browser. The keyboard emulator supports displaying the state of the keyboard LEDs.
* **Mass Storage Drive**
On the Raspberry Pi 4 and Zero2W, PiKVM can emulate a virtual CD-ROM or Flash Drive. A live image can be uploaded to boot the attached server.
On the Raspberry Pi 4 and Zero2W, PiKVM can emulate a virtual CD/DVD or Flash Drive. A live image can be uploaded to boot the attached server.
* **ATX power management**
With a very simple circuit that can be assembled on a breadboard, the power button of the attached server can be controlled using the ATX button headers on the motherboard.
* **Security**
@ -213,7 +213,7 @@ So, again, in short:
* [Here are the instructions and a complete list of components](https://docs.pikvm.org/v2).
* Requires Raspberry Pi 4 or Zero 2 W.
* Supports H.264 (for recommended CSI capture).
* Supports CD-ROM and Flash Drive (mass storage) emulation.
* Supports CD/DVD and Flash Drive (mass storage) emulation.
* It is recommended as a simpler and more feature-rich way compared to V1.
* **DIY PiKVM V1:**
@ -222,7 +222,7 @@ So, again, in short:
* Requires Raspberry Pi Pico for the keyboard/mouse emulation.
* Requires extra wiring and little bit more parts.
* Supports H.264 (for recommended CSI capture).
* Doesn't support CD-ROM and Flash Drive (mass storage) emulation.
* Doesn't support CD/DVD and Flash Drive (mass storage) emulation.
-----

34
docs/msd.md
View File

@ -1,12 +1,18 @@
# Mass Storage Drive
This powerful feature that is available on all PiKVM V2+ devices.
It allows PiKVM to emulate a virtual CD-ROM or Flash Drive for the target host
It allows PiKVM to emulate a virtual CD/DVD or Flash Drive for the target host
which will be available even in BIOS/UEFI when you need live disk to revive the OS
or even reinstall it.
!!! warning "Legacy note"
This document is relevant for `KVMD >= 3.249`. If you are using an older version, please update the PiKVM OS.
!!! warning
This document is relevant for `KVMD >= 4.49`.
**Also since this version, PiKVM supports DVD emulation!**
If you are using an older version, please update the PiKVM OS:
{!_update_os.md!}
| Take a look at the `Drive` menu in the Web UI |
|-----------------------------------------------|
@ -28,14 +34,7 @@ The following actions are available here:
The rest of the time, power off is safe because the PiKVM filesystem
will be in read-only mode.
!!! info "The max CD-ROM image size is 2.2 GB"
This is a [Linux kernel limitation](https://github.com/pikvm/pikvm/issues/322) on PiKVM,
which currently cannot emulate a DVD drive.
To use a larger boot image, please use a Flash Drive emulation.
If this is not possible (the image does not support Flash, for example, for Windows),
you can try [this recipe](#making-windows-boot-flash-image).
!!! info "Changing the media type between CD-ROM and Flash is possible only when the device is reconnected"
!!! info "Changing the media type between CD/DVD and Flash is possible only when the device is reconnected"
On PiKVM V3 and V4, this can be done using the `System -> Connect main USB` switch in the Web UI.
In this case, the **media type is determined at the time of connecting the image, and not by clicking on the switch**.
@ -221,7 +220,7 @@ To refresh the list of available isos on the share it is currently necessary to
3. Perform `reboot` to apply all changes.
-----
### 'exfat' Filesystem warning
### exFAT filesystem warning
Using the existing USB ports you can reduce writes to the internal SSD card by storing
images on a USB thumb drive. This is mounted as would NFS or Samba, above. As recent
@ -239,6 +238,7 @@ exfat filesystem is:
This says to mount it automatically, do not fail if it's missing, mount it read/write by
default, and allow all users and groups access to it.
-----
## Multiple drives
@ -281,7 +281,7 @@ So, to add a second virtual drive, follow this:
enabled: true # Set it to true to enable
count: 1 # +1 drive, default value
default: # Default configuration for the all extra drives
cdrom: false # Default value (false for the generic flash drive)
cdrom: false # Default value (false for the generic flash drive, true for CD/DVD)
rw: false # Read-only by default
```
@ -322,7 +322,11 @@ The full list of options can be found by running `kvmd-otgmsd --help`.
```
!!! note
Index `0` represents the main drive that is controlled via the Web UI and API.
* Index `0` represents the main drive that is controlled via the Web UI and API.
* If `--set-cdrom=1`, the drive will work as CD-ROM for small images, and as DVD-ROM for big.
Please note that CD/DVD can't be writable (you should use `--set-rw=0` in this case).
4. On this step, you will be able to access the flash drive from the target host
and format the it in the usual way.
@ -332,7 +336,7 @@ The full list of options can be found by running `kvmd-otgmsd --help`.
```console
[root@pikvm ~]# kvmd-otgmsd -i 1
Image file: /root/flash.img
CD-ROM flag: no
CD/DVD flag: no
RW flag: yes
```