README.md

This Repo Is Based On SurfaceDuoPkg

Thanks for Gustave's instructions!

Project Mu UEFI Implementation for SM8150 Devices

Build

Quick notes for building:

• Use Ubuntu 20.04 x64 (or use docker-compose under other distros)
• Generate ACPI tables with IASL
• Follow this quick draft

1. Setup Base environment

./setup_env.sh
pip install --upgrade -r pip-requirements.txt

Alternatively, use docker-compose if you don't have Ubuntu 20.04 environment

docker-compose run mu

Then finish the following process in docker environment

2. Activate Workspace

python3 -m venv SurfaceDuo
source SurfaceDuo/bin/activate

3. Setup Mu environment

./setup_uefi.sh

4. Stamp build

python3 ./Platforms/SurfaceDuoPkg/StampBuild.py

or

./build_releaseinfo.ps1

5. Build UEFI

Usage: build_uefi.sh -d <target_device> -s <ram_size> Optional: -m -r -u -b

./build_uefi.sh -d <target-name> -s <traget-ram-size> [ -m <Model> -r <RetailModel> -u <RetailSku> -b <BoardModel> ]

Ram size should be 6, 8, or 12. You will find Build//uefi.img if it builds successfully.

Target list

Device	Target name	DSDT Support	Maintainers
ASUS ROG2	asus-I001DC	✅	Ww
LG G8	lg-alphaplus	✅	Molly Sophia
LG G8X	lg-mh2lm	✅	Molly Sophia
LG V50	lg-flashlmdd	✅	AKA
LG V50S	lg-mh2lm-5G	✅	AKA
Nubia Mini 5G	nubia-tp1803	✅	Alula
OnePlus 7 Pro	oneplus-guacamole	✅	Waseem Alkurdi
OnePlus 7T Pro	oneplus-hotdog	✅	sunflower2333
Samsung Galaxy S10	samsung-beyond1qlte	✅	Ww
Xiaomi 9	xiaomi-cepheus	❌	NONE
Xiaomi Hercules	xiaomi-hercules	✅	Ww
Xiaomi K20 Pro	xiaomi-raphael	✅	sunflower2333
Xiaomi Mix3 5G	xiaomi-andromeda	✅	sunflower2333
Xiaomi Pad 5	xiaomi-nabu	✅	Map220v
Xiaomi Poco X3 Pro	xiaomi-vayu	❌	Mcusr120

Acknowledgements

• EFIDroid Project
• Andrei Warkentin and his RaspberryPiPkg
• Sarah Purohit
• Googulator
• Ben (Bingxing) Wang
• Renegade Project

License

All code except drivers in GPLDriver directory are licensed under BSD 2-Clause. GPL Drivers are licensed under GPLv2 license.