--- /dev/null
+config BR2_TARGET_GRUB2
+ bool "grub2"
+ depends on BR2_i386 || BR2_x86_64
+ help
+ GNU GRUB is a Multiboot boot loader. It was derived from
+ GRUB, the GRand Unified Bootloader, which was originally
+ designed and implemented by Erich Stefan Boleyn. GRUB 2 has
+ replaced what was formerly known as GRUB (i.e. version
+ 0.9x), which has, in turn, become GRUB Legacy.
+
+ Amongst others, GRUB2 offers EFI support, which GRUB Legacy
+ doesn't provide.
+
+ Notes on using Grub2 for BIOS-based platforms
+ =============================================
+
+ 1. Create a disk image
+ dd if=/dev/zero of=disk.img bs=1M count=32
+ 2. Partition it (either legacy or GPT style partitions work)
+ cfdisk disk.img
+ - Create one partition, type Linux, for the root
+ filesystem. The only constraint is to make sure there
+ is enough free space *before* the first partition to
+ store Grub2. Leaving 1 MB of free space is safe.
+ 3. Setup loop device and loop partitions
+ sudo losetup -f disk.img
+ sudo partx -a /dev/loop0
+ 4. Prepare the root partition
+ sudo mkfs.ext3 -L root /dev/loop0p1
+ sudo mount /dev/loop0p1 /mnt
+ sudo tar -C /mnt -xf output/images/rootfs.tar
+ sudo umount /mnt
+ 5. Install Grub2
+ sudo ./output/host/usr/sbin/grub-bios-setup \
+ -b ./output/host/usr/lib/grub/i386-pc/boot.img \
+ -c ./output/images/grub.img -d . /dev/loop0
+ 6. Cleanup loop device
+ sudo partx -d /dev/loop0
+ sudo losetup -d /dev/loop0
+ 7. Your disk.img is ready!
+
+ Using genimage
+ --------------
+
+ If you use genimage to generate your complete image,
+ installing Grub can be tricky. Here is how to achieve Grub's
+ installation with genimage:
+
+ partition boot {
+ in-partition-table = "no"
+ image = "path_to_boot.img"
+ offset = 0
+ size = 512
+ }
+ partition grub {
+ in-partition-table = "no"
+ image = "path_to_grub.img"
+ offset = 512
+ }
+
+ The result is not byte to byte identical to what
+ grub-bios-setup does but it works anyway.
+
+ To test your BIOS image in Qemu
+ -------------------------------
+
+ qemu-system-{i386,x86-64} -hda disk.img
+
+ Notes on using Grub2 for EFI-based platforms
+ ============================================
+
+ 1. Create a disk image
+ dd if=/dev/zero of=disk.img bs=1M count=32
+ 2. Partition it with GPT partitions
+ cgdisk disk.img
+ - Create a first partition, type EF00, for the
+ bootloader and kernel image
+ - Create a second partition, type 8300, for the root
+ filesystem.
+ 3. Setup loop device and loop partitions
+ sudo losetup -f disk.img
+ sudo partx -a /dev/loop0
+ 4. Prepare the boot partition
+ sudo mkfs.vfat -n boot /dev/loop0p1
+ sudo mount /dev/loop0p1 /mnt
+ sudo cp -a output/images/efi-part/* /mnt/
+ sudo cp output/images/bzImage /mnt/
+ sudo umount /mnt
+ 5. Prepare the root partition
+ sudo mkfs.ext3 -L root /dev/loop0p2
+ sudo mount /dev/loop0p2 /mnt
+ sudo tar -C /mnt -xf output/images/rootfs.tar
+ sudo umount /mnt
+ 6 Cleanup loop device
+ sudo partx -d /dev/loop0
+ sudo losetup -d /dev/loop0
+ 7. Your disk.img is ready!
+
+ To test your EFI image in Qemu
+ ------------------------------
+
+ 1. Download the EFI BIOS for Qemu
+ Version IA32 or X64 depending on the chosen Grub2
+ platform (i386-efi vs. x86-64-efi)
+ http://sourceforge.net/projects/edk2/files/OVMF/
+ 2. Extract, and rename OVMF.fd to bios.bin and
+ CirrusLogic5446.rom to vgabios-cirrus.bin.
+ 3. qemu-system-{i386,x86-64} -L ovmf-dir/ -hda disk.img
+ 4. Make sure to pass pci=nocrs to the kernel command line,
+ to workaround a bug in the EFI BIOS regarding the
+ EFI framebuffer.
+
+ http://www.gnu.org/software/grub/
+
+if BR2_TARGET_GRUB2
+
+choice
+ prompt "Platform"
+
+config BR2_TARGET_GRUB2_I386_PC
+ bool "i386-pc"
+ help
+ Select this option if the platform you're targetting is a
+ x86 or x86-64 legacy BIOS based platform.
+
+config BR2_TARGET_GRUB2_I386_EFI
+ bool "i386-efi"
+ help
+ Select this option if the platform you're targetting has a
+ 32 bits EFI BIOS. Note that some x86-64 platforms use a 32
+ bits EFI BIOS, and this option should be used in this case.
+
+config BR2_TARGET_GRUB2_X86_64_EFI
+ bool "x86-64-efi"
+ depends on BR2_ARCH_IS_64
+ help
+ Select this option if the platform you're targetting has a
+ 64 bits EFI BIOS.
+
+endchoice
+
+if BR2_TARGET_GRUB2_I386_PC
+
+config BR2_TARGET_GRUB2_BOOT_PARTITION
+ string "boot partition"
+ default "hd0,msdos1"
+ help
+ Specify the partition where the /boot/grub/grub.cfg file is
+ located. Use 'hd0,msdos1' for the first partition of the
+ first disk if using a legacy partition table, or 'hd0,gpt1'
+ if using GPT partition table.
+
+endif # BR2_TARGET_GRUB2_I386_PC
+
+config BR2_TARGET_GRUB2_BUILTIN_MODULES
+ string "builtin modules"
+ default "boot linux ext2 fat part_msdos part_gpt normal biosdisk" if BR2_TARGET_GRUB2_I386_PC
+ default "boot linux ext2 fat part_msdos part_gpt normal efi_gop" \
+ if BR2_TARGET_GRUB2_I386_EFI || BR2_TARGET_GRUB2_X86_64_EFI
+
+config BR2_TARGET_GRUB2_BUILTIN_CONFIG
+ string "builtin config"
+ help
+ Path to a Grub 2 configuration file that will be embedded
+ into the Grub image itself. This allows to set the root
+ device and other configuration parameters, but however menu
+ entries cannot be described in this embedded configuration.
+
+endif # BR2_TARGET_GRUB2