This Repo Is Based On mu_andromeda_platforms
Thanks for Gustave's instructions!
Project Mu UEFI Implementation for Devices with Snapdragon™ inside.
You can download the latest UEFI build by clicking here.
This package demonstrates an AArch64 UEFI implementation for hacked devices with qcom silicons. Currently it is able to boot Windows 10 ARM64 as well as Windows 11 ARM64. Please be aware that devices with no dsdt support 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: side-band buttons (TLMM GPIO and PMIC GPIO), USB
- Display FrameBuffer
Please see https://Project-Aloha.github.io for some tutorials.
- 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, ggc-aarch64-linux-gnu
- 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:
- Setup Base environment
./build_setup.sh
pip install --upgrade -r pip-requirements.txt
Alternatively, use docker if you don't have Ubuntu 22.04 environment
sudo docker build -t mu:v1 .
sudo docker run -v $(pwd):/build/ -it mu:v1
Then finish the following process in docker environment
- Build UEFI & Generate Android Boot Image
Usage: build_uefi.py -d <target-device> -s <secureboot status> -t <build type>
-
Exmaple with secure boot off and release build:
./build_uefi.py -d <target-name>
-
Exmaple with secure boot on:
./build_uefi.py -d <target-name> -s 1
-
Exmaple with secure boot off and DEBUG build:
./build_uefi.py -d <target-name> -t DEBUG
-
Tips:
- use
-p all
to build devices in all platforms. - use
-d all -p <target-platform>
to build all devices in same platform.
- use
-
You will find Build/xxxxPkg/<target-device>.img after successfully building.
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Qualcomm Technologies, Inc. MTP 8150 | qcom-mtp8150 | ✅ | NONE |
Qualcomm Technologies, Inc. QRD 8150 | qcom-qrd8150 | ✅ | sunflower2333 |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
ASUS ROG2 | asus-I001DC | ✅ | sunflower2333 |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Axon Stage 5G | kakao-pine | ❌ | AKA |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
BlackShark 2 | blackshark-skywalker | ❌ | NONE |
BlackShark 2 Pro | blackshark-darklighter | ❌ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
HTC 5G Hub | htc-rtx | ❌ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
LG G8 | lg-alphaplus | ✅ | sunflower2333 |
LG G8S | lg-betalm | ✅ | J0SH1X |
LG G8X | lg-mh2lm | ✅ | Molly Sophia |
LG V50 | lg-flashlmdd | ✅ | AKA |
LG V50S | lg-mh2lm5g | ✅ | AKA |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Meizu 16s | meizu-m971q | ❌ | NONE |
Meizu 16T | meizu-m928q | ❌ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Nubia Mini 5G | nubia-tp1803 | ✅ | Alula |
Nubia RedMagic 3 | nubia-nx629j | ❌ | NONE |
Nubia RedMagic 3S | nubia-nx629jv1s | ❌ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
OnePlus 7 | oneplus-guacamoleb | ✅ | NONE |
OnePlus 7 Pro | oneplus-guacamole | ✅ | Waseem Alkurdi |
OnePlus 7T | oneplus-hotdogb | ✅ | UNKNOWN |
OnePlus 7T Pro | oneplus-hotdog | ✅ | Morc |
OnePlus 7T Pro 5G | oneplus-hotdogg | ✅ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
OPPO Reno 10X | oppo-op46c3 | ❌ | NONE |
OPPO Reno ACE | oppo-pclm10 | ✅ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Realme X2 Pro | realme-rmx1931 | ❌ | NONE |
Realme X3 SuperZoom | realme-rmx2086 | ✅ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Samsung Galaxy Fold | samsung-winner | ✅ | Ost268 |
Samsung Galaxy S10 | samsung-beyond1qlte | ✅ | Ww |
Samsung Galaxy Tab S6 | samsung-gts6l | ✅ | NONE |
Samsung Galaxy Tab S6 WIFI | samsung-gts6lwifi | ✅ | qaz6750 |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Smartisan Pro 3 | smartisan-aries | ❌ | NONE |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Xiaomi 9 | xiaomi-cepheus | ✅ | qaz6750 |
Xiaomi Hercules | xiaomi-hercules | ✅ | Ww |
Xiaomi K20 Pro | xiaomi-raphael | ✅ | Degdag&sunflower2333 |
Xiaomi Mix Alpha u2 | xiaomi-avenger | ❌ | NONE |
Xiaomi Mix3 5G | xiaomi-andromeda | ✅ | NONE |
Xiaomi Pad 5 | xiaomi-nabu | ✅ | Map220v |
Xiaomi Poco X3 Pro | xiaomi-vayu | ✅ | Degdag |
Device | Target name | DSDT Support | Maintainers |
---|---|---|---|
Qualcomm Technologies, Inc. QRD 7125 | qcom-qrd7125 | ✅ | sunflower2333 |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Xiaomi Note 10 Pro | xiaomi-sweet | ❌ | dopaemon |
Xiaomi Note 9S | xiaomi-miatoll | ✅ | Icesito |
Device | Target name | DSDT Support | Maintainers |
---|---|---|---|
Qualcomm Technologies, Inc. QRD 7325 | qcom-qrd7325 | ✅ | Ayu&sunflower2333 |
Device | Target name | DSDT Support | Maintainers |
---|---|---|---|
Qualcomm Technologies, Inc. MTP 8350 | qcom-mtp8350 | ✅ | Ayu |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Galaxy Z Fold 3 5G | samsung-q2q | ✅ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
ZTE A31 Pro | zte-p875a02 | ✅ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Xiaomi K40 Pro | xiaomi-haydn | ❌ | None |
Xiaomi Mi 11 | xiaomi-venus | ✅ | None |
Device | Target name | DSDT Support | Maintainers |
---|---|---|---|
Qualcomm Technologies, Inc. HDK 8450 | qcom-hdk8450 | ❌ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Xiaomi Pad 6 Pro | xiaomi-liuqin | ❌ | None |
Device | Target name | DSDT Support | Maintainers |
---|---|---|---|
Qualcomm Technologies, Inc. QRD 8550 | qcom-qrd8550 | ❌ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
AYANEO Pocket S | ayaneo-aps | ❌ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
AYN Odin 2 | ayn-odin2 | ❌ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Nubia RedMagic 8 Pro | nubia-nx729j | ❌ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Oneplus 11 5G | oneplus-salami | ❌ | None |
Device | Target name | DSDT Support | Contributors |
---|---|---|---|
Xiaomi 13 | xiaomi-fuxi | ❌ | None |
Xiaomi 13 Pro | xiaomi-nuwa | ❌ | None |
Xiaomi Pad6 S Pro | xiaomi-sheng | ❌ | None |
Xiaomi K60 Pro | xiaomi-socrates | ❌ | None |
- Gustave Monce and his mu_andromeda_platforms
- EFIDroid Project
- Andrei Warkentin and his RaspberryPiPkg
- Sarah Purohit
- Googulator
- Ben (Bingxing) Wang
- Samuel Tulach and his Rainbow Patcher
- BigfootACA and his SimpleInit
- Uotan
- Developers in Renegade Project
- Lemon ICE