Skip to content

Latest commit

 

History

History
executable file
·
325 lines (227 loc) · 20.5 KB

README.md

File metadata and controls

executable file
·
325 lines (227 loc) · 20.5 KB
Raw

This Repo Is Based On mu_andromeda_platforms

Thanks for Gustave's instructions!

Project Mu UEFI Implementation for Devices with Snapdragon™ inside.

For users

You can download the latest UEFI build by clicking here.

ActionStatus

What's this?

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.

Support Status

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

What can you do?

Please see https://Project-Aloha.github.io for some tutorials.

Build

Minimum System Requirements

  • 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-

Build Instructions

  • 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:
  1. 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

  1. 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.

  • You will find Build/xxxxPkg/<target-device>.img after successfully building.

Target list

Snapdragon 855/855+/860 (SM8150)

Qualcomm Technologies, Inc. Devices

Device Target name DSDT Support Contributors
Qualcomm Technologies, Inc. MTP 8150 qcom-mtp8150 ✅ NONE
Qualcomm Technologies, Inc. QRD 8150 qcom-qrd8150 ✅ sunflower2333

ASUS Devices

Device Target name DSDT Support Contributors
ASUS ROG2 asus-I001DC ✅ sunflower2333

Axon Devices

Device Target name DSDT Support Contributors
Axon Stage 5G kakao-pine ❌ AKA

BlackShark Devices

Device Target name DSDT Support Contributors
BlackShark 2 blackshark-skywalker ❌ NONE
BlackShark 2 Pro blackshark-darklighter ❌ NONE

HTC Devices

Device Target name DSDT Support Contributors
HTC 5G Hub htc-rtx ❌ NONE

LG Devices

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

Meizu Devices

Device Target name DSDT Support Contributors
Meizu 16s meizu-m971q ❌ NONE
Meizu 16T meizu-m928q ❌ NONE

Nubia Devices

Device Target name DSDT Support Contributors
Nubia Mini 5G nubia-tp1803 ✅ Alula
Nubia RedMagic 3 nubia-nx629j ❌ NONE
Nubia RedMagic 3S nubia-nx629jv1s ❌ NONE

OnePlus Devices

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

OPPO Devices

Device Target name DSDT Support Contributors
OPPO Reno 10X oppo-op46c3 ❌ NONE
OPPO Reno ACE oppo-pclm10 ✅ NONE

Realme Devices

Device Target name DSDT Support Contributors
Realme X2 Pro realme-rmx1931 ❌ NONE
Realme X3 SuperZoom realme-rmx2086 ✅ NONE

Samsung Devices

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

Smartisan Devices

Device Target name DSDT Support Contributors
Smartisan Pro 3 smartisan-aries ❌ NONE

Xiaomi Devices

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

Snapdragon 675/720G/7c/7c Gen 2 (SM6250/SM7125/SC7180)

Qualcomm Technologies, Inc. Devices

Device Target name DSDT Support Maintainers
Qualcomm Technologies, Inc. QRD 7125 qcom-qrd7125 ✅ sunflower2333

Xiaomi Devices

Device Target name DSDT Support Contributors
Xiaomi Note 10 Pro xiaomi-sweet ❌ dopaemon
Xiaomi Note 9S xiaomi-miatoll ✅ Icesito

Snapdragon 778G/7c+ Gen 3 (SM7325/SC7280)

Qualcomm Technologies, Inc. Devices

Device Target name DSDT Support Maintainers
Qualcomm Technologies, Inc. QRD 7325 qcom-qrd7325 ✅ Ayu&sunflower2333

Snapdragon 888/888+/888 4G/G3x Gen 1 (SM8350/SM8350P/SG8175P)

Qualcomm Technologies, Inc. Devices

Device Target name DSDT Support Maintainers
Qualcomm Technologies, Inc. MTP 8350 qcom-mtp8350 ✅ Ayu

Samsung Devices

Device Target name DSDT Support Contributors
Galaxy Z Fold 3 5G samsung-q2q ✅ None

ZTE Devices

Device Target name DSDT Support Contributors
ZTE A31 Pro zte-p875a02 ✅ None

Xiaomi Devices

Device Target name DSDT Support Contributors
Xiaomi K40 Pro xiaomi-haydn ❌ None
Xiaomi Mi 11 xiaomi-venus ✅ None

Snapdragon 8 Gen 1 / 8+ Gen 1 / 7+ Gen 2 (SM8450/SM8475/SM7475)

Qualcomm Technologies, Inc. Devices

Device Target name DSDT Support Maintainers
Qualcomm Technologies, Inc. HDK 8450 qcom-hdk8450 ❌ None

Xiaomi Devices

Device Target name DSDT Support Contributors
Xiaomi Pad 6 Pro xiaomi-liuqin ❌ None

Snapdragon 8 Gen 2 (SM8550)

Qualcomm Technologies, Inc. Devices

Device Target name DSDT Support Maintainers
Qualcomm Technologies, Inc. QRD 8550 qcom-qrd8550 ❌ None

AYANEO Devices

Device Target name DSDT Support Contributors
AYANEO Pocket S ayaneo-aps ❌ None

AYN Devices

Device Target name DSDT Support Contributors
AYN Odin 2 ayn-odin2 ❌ None

Nubia Devices

Device Target name DSDT Support Contributors
Nubia RedMagic 8 Pro nubia-nx729j ❌ None

Oneplus Devices

Device Target name DSDT Support Contributors
Oneplus 11 5G oneplus-salami ❌ None

Xiaomi Devices

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

Acknowledgements

License License