edk2-sdm845/README.md

107 lines
2.5 KiB
Markdown

# EDK2 UEFI Firmware For Snapdragon 845 (sdm845)
![Github](https://img.shields.io/github/downloads/edk2-porting/edk2-sdm845/total)
![Github](https://img.shields.io/github/v/release/edk2-porting/edk2-sdm845?include_prereleases)
A broken but working EDK2 implementation for Snapdragon 845 platform.
中国人请看中文版
[Chinese version (中文版)](https://github.com/edk2-porting/edk2-sdm845/blob/master/README.zh.md)
## Resources
[Telegram group (recommended)](https://t.me/joinchat/MNjTmBqHIokjweeN0SpoyA)
[Discord group](https://discord.gg/XXBWfag)
QQ group: 697666196 (Never On-Topic)
[Windows Drivers](https://github.com/edk2-porting/WOA-Drivers)
[Useless documents](https://renegade-doc.readthedocs.io/en/latest/index.html)
## WARNING
**DO NOT EVER TRY TO PORT IT TO *SONY* DEVICES**
**YOUR UFS WILL BE WIPED CLEAN!!!**
## Supported devices
1. Xiaomi MIX 2S (polaris)
2. Xiaomi MIX 3 (perseus)
3. Xiaomi MI 8 (dipper)
4. Xiaomi PocoPhone F1 (beryllium)
5. OnePlus 6 (enchilada)
6. OnePlus 6T (fajita)
7. Nubia X (nx616j)
8. Meizu 16th (m1882)
9. BlackShark One (skr-a0)
10. LG G7 (judyln) (Will automatically restart)
11. Samsung Galaxy S9+ (star2qltechn) (May wipe your UFS)
12. Xiaomi MI 7 (dipper-old)
13. OPPO Find X (pafm00)
14. Smartisan R1 (trident)
15. Nokia9 PureView (olympic)
## Dependencies
For Ubuntu 20.04:
```bash
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
```
## Building
1.Clone this project (no need for recursive)
```bash
git clone https://github.com/edk2-porting/edk2-sdm845.git --depth=1
cd edk2-sdm845
```
2.Build this project
```bash
bash build.sh --device DEVICE
```
3.Boot the image
```bash
fastboot boot boot_DEVICE.img
```
(DEVICE is the codename of your phone.)
Additionally, you can flash the image to recovery to achieve dual-boot.
```bash
fastboot flash recovery boot_DEVICE.img
```
## Credits
@fxsheep for his original `edk2-sagit`
@strongtz for the creating and maintaining the whole Renegade Project
@BigfootACA for build script
@lemon1ice and NTAuthority for guidance and some blobs
@wetdreams and TAOCroatia for working hard on testing and debugging
@NekokeCore for fixing MemoryMap
## Porting Guide
[edk2-sdm845 Porting Guide](https://renegade-doc.readthedocs.io/en/latest/edk2/port.html).
## License
This project is released under the [WTFPL LICENSE](http://www.wtfpl.net/).