From: HimbeerserverDE <himbeerserverde@gmail.com>
Date: Fri, 16 Sep 2022 19:57:16 +0000 (+0200)
Subject: Instructions for real hardware
X-Git-Url: https://git.lizzy.rs/?a=commitdiff_plain;h=21e8daa329623fa0ba81637be95de97c3aa9ff9b;p=loadnothing.git

Instructions for real hardware
---

diff --git a/README.md b/README.md
index 424a0cb..7e92052 100644
--- a/README.md
+++ b/README.md
@@ -25,3 +25,17 @@ Simply type `make` to build and run the project.
 QEMU may require a VNC viewer.
 
 If it's working you should see "Hello Stage2!" on the screen.
+
+# Real Hardware
+It is possible to test this project on real hardware.
+The only supported platform at the moment is x86. UEFI is not supported
+and UEFI support is unlikely to be added in the future. If you use UEFI
+make sure to enable CSM / Legacy Boot in your UEFI settings. If you don't have CSM you can still use a virtual machine as explained above.
+
+You can use `dd` to write the `nothing.img` file to a block device
+of your choice (but only if you've built it). It is exactly 32 MiB in size.
+
+**This will overwrite the partition table so be careful not to write
+to the wrong device.**
+
+You can then boot from the device. It should once again print "Hello Stage2!".