README.md

EDK2 UEFI Firmware For Snapdragon 835 (msm8998)

• A broken but working EDK2 implementation for Snapdragon 835 platform.

• 中国人请看中文版 Chinese version (中文版)

Warning

• Starting with build 25188 ARMv8.1 Atomics are now required. Build 25169 to 25183 will BSOD on boot (KMODE_EXCEPTION_NOT_HANDLED).

• Builds 25163 and earlier will successfully boot.

• DO NOT EVER TRY TO PORT IT TO SONY, SAMSUNG DEVICES

• YOUR UFS WILL BE WIPED CLEAN!!!

Supported devices

Device	Target name	ACPI Support
OnePlus 5	cheeseburger	✅
OnePlus 5T	dumpling	✅
LG V30	joan	✅
Xiaomi Mi6	sagit	✅
Xiaomi Mi Mix 2	chiron	✅
Essential Phone PH-1	mata	✅
HTC U11+	htc_ocmdtwl	❌

Supported devices

Windows Status Matrix

Resources

Telegram group (recommended)

Discord group

Project website

Dependencies

Compiling has been tested on Debian 11 (bullseye) and on Ubuntu 20.04 LTS.

For Ubuntu 20.04:

sudo apt update
sudo apt upgrade
sudo apt install build-essential uuid-dev iasl git nasm gcc-aarch64-linux-gnu abootimg python3-distutils python3-pil python3-git gettext

Building

1.Clone this project

git clone https://github.com/edk2-porting/edk2-msm8998.git
cd edk2-msm8998

2.Build this project

bash build.sh --device DEVICE

3.Boot the image

fastboot boot boot_DEVICE.img

(DEVICE is the codename of your phone.)

Acknowledgements

• Gustave Monce and his SurfaceDuoPkg and Lumia950XLPkg
• WOA-Project
• EFIDroid
• Ben (Bingxing) Wang
• Lumia950XLPkg
• BigfootACA and his SimpleInit and LinuxSimpleMassStorage
• fxsheep and his original edk2-sagit
• All the developers and members of Renegade Project for offering efforts, equipments, valuable documents and more