Skip to content

woa-msmnile/msmnilePkg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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://woa-msmnile.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

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

Check our memePkg[https://github.com/woa-msmnile/memePkg] for other SoCs support!