Instructions for real hardware

[loadnothing.git] / README.md

diff --git a/README.md b/README.md
index 424a0cba72072870488f4ccaab112d77558059f8..7e920529f249200e7661815665f4b289dc856878 100644 (file)
--- 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!".