Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:guide-developer:uefi-bootable-image [2018/12/26 04:29] – [Building UEFI bootable OpenWrt image] Use merge instead of cherry-pick alive4everdocs:guide-developer:uefi-bootable-image [2021/06/28 13:50] (current) – [Status] replace git commit ID with actual link to the commit fiouz
Line 2: Line 2:
  
 ===== Introduction ===== ===== Introduction =====
-UEFI based systems are becoming more common and it's expected at some time that newer UEFI based system doesn't contain CSM to support legacy bios mode at all ((http://www.uefi.org/sites/default/files/resources/Brian_Richardson_Intel_Final.pdf)). 
  
-To accommodate this, it's necessary for OpenWrt build system to generate UEFI bootable images.+UEFI boot has been required for years now, boards that only support UEFI are common, and Intel has stated back in 2017 that "legacy" BIOS will no longer be supported after 2020.
  
-===== Status =====+https://www.anandtech.com/show/12068/intel-to-remove-bios-support-from-uefi-by-2020
  
-There are pending commits related to add UEFI bootable OpenWrt under +http://www.uefi.org/sites/default/files/resources/Brian_Richardson_Intel_Final.pdf.
-[[https://git.openwrt.org/?p=openwrt/staging/jow.git;a=summary|Jow staging repository]].+
  
-===== Building UEFI bootable OpenWrt image =====+To accommodate this, it's necessary for OpenWrt build system to generate UEFI bootable images.
  
-The commits necessary to build uefi bootable OpenWrt image are as follows.+===== Status =====
  
-<code> +As of OpenWrt ''[[commit>?p=openwrt/openwrt.git;a=commit;h=a6b7c3e672764858fd294998406ae791f5964b4a|a6b7c3e672764858fd294998406ae791f5964b4a]]'', EFI-compatible images are available on the x86-64 [[https://downloads.openwrt.org/snapshots/targets/x86/64/|snapshots]] downloads page.
-tools: add libopt host build +
-add sgdisk host build +
-Generate EFI grub images for x86 platforms +
-x86: fix bios mkimage during efi image generation +
-</code>+
  
-To build the image, checkout jow-staging repository, i.e. 
  
-<code bash> +===== Building UEFI bootable OpenWrt image =====
-$ git remote add jow-staging https://git.openwrt.org/openwrt/staging/jow.git +
-$ git fetch jow-staging +
-$ git checkout -b uefi-capable --track origin/master # so that you can rebase easily +
-$ git merge jow-staging +
-</code>+
  
-After merging the branch or checking out jow-staging repository, run ''make menuconfig''.+To build an EFI-compatible OpenWrt image:
  
-Go to **Target Images** and make sure that **Build EFI grub images** option is checked.+    * Run ''make menuconfig''. 
 + 
 +    * Go to **Target Images** and make sure that the option **Build GRUB EFI images (Linux x86 or x86_64 host only)** is checked.
  
 Select additional packages as necessary and finally save changes and exit menuconfig. Select additional packages as necessary and finally save changes and exit menuconfig.
Line 39: Line 28:
 Run ''make'' as usual to build the image. Run ''make'' as usual to build the image.
  
-The resulting image will be available as ''bin/targets/x86/64/openwrt-x86-64-uefi-gpt-ext4.img.gz'', which can be written to disk after decompression.+The resulting image(s) will be available in ''./bin/targets/x86/64/'' (depending on the image format(s) you chose), which can be written to disk after decompression. 
 + 
 +Note that these are **disk images**, not partition images, which must be written to a block device directly e.g. ''/dev/sdb''.
  
 ===== UEFI Secure Boot ===== ===== UEFI Secure Boot =====
  • Last modified: 2018/12/26 04:29
  • by alive4ever