To be filled soon
## Porting Guide
-
- 1. Install Python protobuf and uefi_firmware-parser by executing `pip install --upgrade google-api-python-client uefi_firmware` in terminal
- 2. Download [extract_android_ota_payload](https://github.com/cyxx/extract_android_ota_payload/archive/master.zip) and extract the folder inside the archive anywhere
- 3. Download any OTA update for your phone
- 4. Extract payload.bin to `extract_android_ota_payload-master` folder
- 5. Open terminal in the same folder and execute `python3 extract_android_ota_payload.py payload.bin`
- 6. Execute `uefi-firmware-parser -b -e xbl.img`
- 7. Change directory to `volume-******/file-9e21fd93-9c72-4c15-8c4b-e77f1db2d792`
- 8. Execute `7z x -oextracted section0.guid`
- 9. Open UEFITool and open the file `section0` in folder `extracted`
- 10. In a file manager, open `edk2-sdm845/sdm845Pkg/Binary`, duplicate `dipper` folder and rename it to your device's codename
- 11. In UEFITool, expand `UEFI image` and the volume underneath
- 12. For each file in your device's folder replace it with UEFITool by:
- - expanding the DXE Driver in UEFITool with the same name as the file you are replacing
- - in case of file that ends with `.depex` right clicking on DXE dependency
- - in case of file that ends with `.efi` right clicking on PE32 Image
- - clicking `Extract body`
- - deleting the original file
- - saving the one you are extracting and naming it same as the deleted one
-- In case a part (ex. DXE Dependency) is missing in UEFITool, just delete that file
- 13. Open `edk2-sdm845/sdm845Pkg` in a file manager
- 14. Duplicate `dipper.dsc` and `dipper.fdf` and rename both to your device's codename
- 15. Open the `.dsc` file, replace values 1080 and 2248 with your device's display width and height and save
- 16. Open the `.fdf` file, replace every word "dipper" with your device's codename and save
- 17. Open `edk2-sdm845` and edit `build.sh` with a text editor
- 18. Locate device list at the top, add your device's codename and save
-
- You can now build as usual.
-
- Make sure to message the Discord or Telegram group in case you are stuck somewhere and if your port is successful, send `edk2-sdm845/sdm845Pkg/Binary/devicename` folder and `.dsc` and `.fdf` files.
+
+[edk2-sdm845 Porting Guide](https://renegade-doc.readthedocs.io/en/latest/edk2/port.html).
## License
\r
欢迎PR新设备的支持，以及设备树或ACPI的修复！\r
\r
-\r
-\r
-\r
## 资源\r
\r
[Telegram交流群](https://t.me/joinchat/MNjTmBqHIokjweeN0SpoyA)\r
\r
QQ交流群: 697666196\r
\r
-## 开源许可证\r
-\r
-该项目在[WTFPL LICENSE](http://www.wtfpl.net/)下发布.\r
-\r
## 警告\r
\r
**请勿尝试移植到任何索尼设备上**\r
\r
**你的UFS会被清空!!!**\r
\r
+## 已支持的设备\r
\r
-**该项目仅支持骁龙845(sdm845)平台,不支持其它任何平台如骁龙855 (sm8150)**\r
-\r
-**请不要在非骁龙845设备上编译运行，如小米MIX3 5G**\r
+1. 小米MIX2S (polaris)\r
+2. 小米MIX3 (perseus)\r
+3. 小米8 (dipper)\r
+4. 小米PocoPhone F1 (beryllium)\r
+5. 一加6 (enchilada)\r
+6. 一加6T (fajita)\r
\r
## 依赖\r
\r
-Ubuntu 18.04:\r
+Ubuntu 20.04:\r
\r
```bash\r
sudo apt update\r
sudo apt install build-essential uuid-dev iasl git nasm gcc-aarch64-linux-gnu abootimg python3-distutils python3-pil python3-git\r
```\r
-Ubuntu 20.04同上。\r
-\r
-## 已支持的设备\r
-\r
-1. 小米MIX2S (polaris)\r
-2. 小米MIX3 (perseus)\r
-3. 小米8 (dipper)\r
-4. 小米PocoPhone F1 (beryllium)\r
-5. 一加6 (enchilada)\r
-6. 一加6T (fajita)\r
\r
## 构建\r
\r
\r
## 贡献\r
\r
-特别感谢[fxsheep](https://github.com/fxsheep)\r
-\r
-感谢[Lemon1Ice](https://github.com/Lemon1Ice)提供MemoryMap\r
-\r
-感谢[5超级菜鸟5](https://github.com/sunshuyu)以及其他人提供的ACPI\r
-\r
-SimpleFbDxe驱动来自imbushuo的[Lumia950XLPkg](https://github.com/WOA-Project/Lumia950XLPkg)\r
-\r
-同样感谢[tianocore wiki](https://github.com/tianocore/tianocore.github.io/wiki/Using-EDK-II-with-Native-GCC#Install_required_software_from_apt)\r
-\r
-## 简单的移植教程\r
-\r
- 1. 在终端执行`pip install --upgrade google-api-python-client uefi_firmware`以安装Python的模块protobuf和uefi_firmware-parser\r
- 2. 下载[extract_android_ota_payload](https://github.com/cyxx/extract_android_ota_payload/archive/master.zip)并将其解压到任何位置\r
- 3. 下载设备的OTA更新包\r
- 4. 解压payload.bin到`extract_android_ota_payload-master`文件夹\r
- 5. 在相同文件夹打开终端并执行并`python3 extract_android_ota_payload.py payload.bin`\r
- 6. 执行`uefi-firmware-parser -b -e xbl.img`\r
- 7. 进入文件夹`volume-******/file-9e21fd93-9c72-4c15-8c4b-e77f1db2d792`\r
- 8. 执行`7z x -oextracted section0.guid`\r
- 9. 打开UEFITool软件并打开`extracted`文件夹中的文件`section0`\r
- 10. 进入文件夹`edk2-sdm845/sdm845Pkg/Binary`,复制文件夹`dipper`并更名为你的设备代号\r
- 11. 在UEFITool中展开`UEFI image`在volume下操作\r
- 12. 在设备文件夹中对每个文件,请通过以下方式将使用UEFITool其替换为:\r
- - 用您要替换的文件相同的名称在UEFITool中展开DXE驱动程序\r
- - 如果文件以`.depex`结尾,请右键单击DXE依赖项\r
- - 如果文件以`.efi`结尾,请右键单击PE32镜像\r
- - 点击`Extract body`\r
- - 删除原始文件\r
- - 保存要提取的内容,并将其命名为已删除的内容\r
-- 如果UEFITool中缺少一部分(例如DXE依赖关系),只需删除该文件\r
- 13. 在文件管理器打开文件夹`edk2-sdm845/sdm845Pkg`\r
- 14. 复制`dipper.dsc`和`dipper.fdf`并更名为你的设备代号(`设备代号.dsc` `设备代号.fdf`)\r
- 15. 打开`设备代号.dsc`文件,使用你的设备的实际屏幕分辨率替换1080(宽)和2248(高)\r
- 16. 打开`设备代号.fdf`文件,将所有"dipper"替换成你的设备代号并保存\r
- 17. 进入文件夹`edk2-sdm845`并使用文本编辑器编辑`build.sh`\r
- 18. 在顶部的数组中添加你的设备代号并保存\r
-\r
- 然后现在可以编译并测试使用.\r
-\r
- 如果您在某个地方遇到问题,你可以在Discord、Telegram和QQ群中发送消息询问,并发送`edk2-sdm845/sdm845Pkg/Binary/设备代号`文件夹以及.dsc和.fdf文件。若移植成功，亦可发送消息告知。\r
+待填充\r
+\r
+## 简单的适配指南\r
+\r
+[edk2-sdm845适配指南](https://renegade-doc.readthedocs.io/zh_CN/latest/edk2/port.html).\r
+\r
+## 开源许可证\r
+\r
+该项目在[WTFPL LICENSE](http://www.wtfpl.net/)下发布.\r
é¡¹ç® / edk2-sdm845.git / commitdiff