Repository files navigation

You can download the latest UEFI build by clickinghere.

This package demonstrates an AArch64 UEFI implementation for hacked Surface Duo (1st Gen) and Surface Duo 2 devices. Currently it is able to boot Windows 10 ARM64 as well as Windows 11 ARM64. Please be aware that SM8350 devices have limited support.

Applicable to all supported targets unless noted.

• Low-speed I/O: I2C, SPI, GPIO, SPMI and Pinmux (TLMM).
• Power Management: PMIC and Resource Power Manager (RPM).
• High-speed I/O for firmware and HLOS: UFS 3.1
• Peripherals: Touchscreen (HID SPI), side-band buttons (TLMM GPIO and PMIC GPIO)
• Display FrameBuffer

Please seehttps://github.com/WOA-Project/SurfaceDuo-Guides for some tutorials.

It is not going to work on any other device even if they use the same SoC as is. You may risk breaking your other device if you even try it. It is only for Surface Duo devices, and there is no interest in adding support for other devices in this repository.

• At least 2 cores x86_64 processor running at 2Ghz or higher implementing the X86 ISA with 64 bit AMD extensions (AMD64) (Currently, building on any other ISA is not supported. In other words, do. not. build. this. on. a. phone. running. android. please.)
• SSD
• A linux environment capable of running below tool stack:
  • Bash
  • Python 3.10 or higher (python3.10, python3.10-venv, python3.10-pip)
  • mono-devel
  • git-core, git
  • build-essential
  • clangpdb (or higher), llvm, gcc-aarch64-linux-gnu
  • cargo
• Exported CLANGPDB_BIN environment variable pointing to LLVM 10 binary folder
• Exported CLANGPDB_AARCH64_PREFIX variable equalling to aarch64-linux-gnu-

• Clone this repository to a reasonable location on your disk (There is absolutely no need to initialize submodules, stuart will do it for you later on)
• Run the following commands in order, with 0 typo, and without copy pasting all of them blindly all at once:

# Build UEFIpip install --upgrade -r pip-requirements.txt./build_uefi_epsilon.sh./build_uefi_zeta.sh# Generate ELF image./build_bootshim.sh./build_boot_images.sh

• EFIDroid Project
• Andrei Warkentin and hisRaspberryPiPkg
• Sarah Purohit
• Googulator
• Ben (Bingxing) Wang
• Samuel Tulach and hisRainbow Patcher

All code is licensed under BSD 2-Clause.