Merge branch 'dev' of shmalebx9/lbwww into master

site/docs/hardware/index.md

@@ -85,6 +85,11 @@ Libera IRC, who ported these boards to Libreboot. Extensive work was
 performed, to make u-boot work correctly. **TODO: installation instructions
 must be added to documentation!**
 
+### Emulation
+
+-   [Qemu x86](../misc/emulation.md)
+
+
 TODO: More hardware is supported. See `resources/coreboot/` in lbmk. Update
 the above list!
 

site/docs/misc/emulation.md

@@ -0,0 +1,38 @@
+---
+title: Building Libreboot for Emulation
+x-toc-enable: true
+...
+
+Introduction
+============
+
+Libreboot supports building for qemu as a target board.
+The resulting rom can then be tested using qemu.
+
+The qemu board is mostly intended to speed up development by removing the need to flash to bare metal during initial tests.
+Qemu may also be useful for end users who intend to make changes to their libreboot rom without having to flash and reboot their machine.
+
+Building and Testing
+====================
+
+Libreboot can be built for qemu just like any other board.
+
+`./build boot roms qemu_x86_12mb`
+
+In order to test the resulting roms, you must have qemu installed on the host machine.
+Test the roms by pointing qemu to the rom in bios mode.
+For example:
+
+`qemu-system-x86_64 -bios bin/qemu_x86_12mb/grub_qemu_x86_12mb_libgfxinit_corebootfb_usqwerty.rom`
+
+Use Cases
+=========
+
+While development is the primary motivation for qemu support, the board makes it easy to test minor changes to release roms.
+For example one can use *cbfstool* from coreboot to edit the background image in a libreboot rom as follows:
+
+```cbfstool /path/to/rom remove -n background.png
+cbfstool /path/to/rom add -f mynewbackground.png -n background.png -t raw
+```
+
+Using qemu allows the user to verify that the background image renders properly before performing the same operation on their release rom.