Rename to project aloha.

Project-Aloha · Nov 10, 2024 · 6c61478 · 6c61478
1 parent 32a2c2d
commit 6c61478
Show file tree

Hide file tree

Showing 27 changed files with 115 additions and 48 deletions.
diff --git a/.vitepress/config.ts b/.vitepress/config.ts
@@ -6,7 +6,7 @@ import { zh } from './zh'
 // https://vitepress.dev/reference/site-config
 export default withMermaid(
   defineConfig({
-    title: "woa-msmnile",
+    title: "Project Aloha",
     lastUpdated: true,
     head: [
       ['link', { rel: 'icon', type: 'image/svg+xml', href: 'images/Logov2.2.svg' }],
@@ -46,7 +46,7 @@ export default withMermaid(
         }
       },
       socialLinks: [
-        { icon: 'github', link: 'https://github.com/woa-msmnile' },
+        { icon: 'github', link: 'https://github.com/Project-Aloha' },
       ],
     },
   })

diff --git a/.vitepress/en.ts b/.vitepress/en.ts
@@ -6,7 +6,7 @@ export const en = defineConfig({
   themeConfig: {
     nav: [
       { text: 'Home', link: '/'},
-      { text: 'Documents', link: '/Introduction/msmnilePkg' },
+      { text: 'Documents', link: '/Introduction/mu_aloha_platforms' },
       { text: 'Videos', link: '/Videos/Introduction/Introduction' },
     ],
     sidebar: {
@@ -15,10 +15,10 @@ export const en = defineConfig({
     },
     editLink: {
       text: 'Edit this page on Github',
-      pattern: 'https://github.com/woa-msmnile/woa-msmnile.github.io/edit/main/:path'
+      pattern: 'https://github.com/Project-Aloha/project-aloha.github.io/edit/main/:path'
     },
     footer: {
-      copyright: `Site CC BY-NC-SA 4.0 | CopyRight © 2022-${new Date().getFullYear()} woa-msmnile`
+      copyright: `Site CC BY-NC-SA 4.0 | CopyRight © 2022-${new Date().getFullYear()} Project-Aloha`
     },
   }
 })
@@ -28,8 +28,8 @@ function sidebarDocs(): DefaultTheme.SidebarItem[] {
     {
       text: 'Introduction',
       items: [
-        { text: 'woa-msmnile', link: '/Introduction/organization'},
-        { text: 'msmnilePkg', link: '/Introduction/msmnilePkg'},
+        { text: 'Project-Aloha', link: '/Introduction/organization'},
+        { text: 'mu_aloha_platforms', link: '/Introduction/mu_aloha_platforms'},
         { text: 'UEFI Porting Status', link: '/PortingStatus/PortingStatus'}
       ]
     },
@@ -46,6 +46,7 @@ function sidebarDocs(): DefaultTheme.SidebarItem[] {
       text: 'Dual Boot',
       items: [
         { text: 'Introduction', link: '/DualBoot/Introduction'},
+        { text: 'Apply DualBoot', link:'/DualBoot/PatchKernel.md'},
         { text: 'Config', link: '/DualBoot/Config'},
         { text: 'Shell Code', link: '/DualBoot/ShellCode'},
       ]

diff --git a/.vitepress/zh.ts b/.vitepress/zh.ts
@@ -31,10 +31,10 @@ export const zh = defineConfig({
     },
     editLink: {
       text: '在 Github 上编辑此页',
-      pattern: 'https://github.com/woa-msmnile/woa-msmnile.github.io/edit/main/:path'
+      pattern: 'https://github.com/Project-Aloha/project-aloha.github.io/edit/main/:path'
     },
     footer: {
-      copyright: `网站 CC BY-NC-SA 4.0 | 版权所有 © 2022-${new Date().getFullYear()} woa-msmnile`
+      copyright: `网站 CC BY-NC-SA 4.0 | 版权所有 © 2022-${new Date().getFullYear()} Project-Aloha`
     },
   }
 })
@@ -44,8 +44,8 @@ function sidebarDocs(): DefaultTheme.SidebarItem[] {
     {
       text: '简介',
       items: [
-        { text: 'woa-msmnile', link: '/Introduction/organization'},
-        { text: 'msmnilePkg', link: '/Introduction/msmnilePkg'},
+        { text: 'Project-Aloha', link: '/Introduction/organization'},
+        { text: 'mu_aloha_platforms', link: '/Introduction/mu_aloha_platforms'},
         { text: '移植状态', link: '/PortingStatus/PortingStatus'}
       ]
     },

diff --git a/DualBoot/PatchKernel.md b/DualBoot/PatchKernel.md
@@ -0,0 +1,66 @@
+# Apply DualBoot with DualBoot Kernel Patcher
+> This guide will help you build a boot image with uefi/android dualboot feature.
+
+## Prepare
+- An android device.
+- Download `UEFI FD` file from [Github Action](https://github.com/Project-Aloha/mu_aloha_platforms/actions)(You may need to login to download artifacts) or [Release Page](https://github.com/Project-Aloha/mu_aloha_platforms/releases) of uefi repository.
+- `Magiskboot` for your environment, there are prebuilt binaries on github.
+- DualBoot kernel patcher binary and shellcode binaries for your devices from [release page](https://github.com/Project-Aloha/DualBootKernelPatcher/releases) or [action page](https://github.com/Project-Aloha/DualBootKernelPatcher/actions).
+
+:::Notice
+  All these steps can be done on your android device.
+:::
+
+## Steps
+> Assume you have done the following steps on your android device.
+>  1. Root your device with magisk.
+>  2. Downloaded and installed termux.
+>  3. Installed root-repo and tsu in termux with apt.
+
+- Get Android Boot Image.
+  + The boot image usually can be found at `/dev/block/by-name/boot` or `/dev/block/by-name/boot_a` (or _b).
+  + Open your termux, and copy the boot image out for future use.
+  ```bash
+  tsu                             # get root shell
+  mkdir /sdcard/dualboot/         # create a folder to put files.
+  cp /dev/block/by-name/boot /sdcard/dualboot/boot.img  # copy to our folder and rename to boot.img. If your device has ab slot, please add _a or _b suffix.
+  ```
+
+- Unpack it with magiskboot.
+  + If your device was rooted by magisk, there should be an magiskboot binary at `/data/adb/magisk/magiskboot`
+  + By the way you can press the `tab` button in termux to automatically fill path, instead of typing the characters one by one.
+  + Do Unpack
+  ```bash
+  cd /sdcard/dualboot/            # change working directory to our folder.
+  /data/adb/magisk/magiskboot unpack boot.img # unpack
+  ```
+  + You will get something like this:
+  ```bash
+  /sdcard/dualboot# magiskboot unpack boot.img
+  Parsing boot image: [boot.img]
+  HEADER_VER      [1]
+  KERNEL_SZ       [41576325]
+  RAMDISK_SZ      [927736]
+  SECOND_SZ       [0]
+  RECOV_DTBO_SZ   [0]
+  OS_VERSION      [9.0.0]
+  OS_PATCH_LEVEL  [2021-05]
+  PAGESIZE        [4096]
+  NAME            []
+  CMDLINE         [console=ttyMSM0,115200n8 earlycon=msm_geni_serial,0xa90000 androidboot.hardware=qcom androidboot.console=ttyMSM0 androidboot.memcg=1 lpm_levels.sleep_disabled=1 video=vfb:640x400,bpp=32,memsize=3072000 msm_rtb.filter=0x237 service_locator.enable=1 swiotlb=2048 firmware_class.path=/vendor/firmware_mnt/image loop.max_part=7 androidboot.usbcontroller=a600000.dwc3 buildvariant=user]
+  CHECKSUM        [e73518a6e1edf3062d9cebd3203a51069ef2f424000000000000000000000000]
+  KERNEL_DTB_SZ   [3972965]
+  KERNEL_FMT      [raw]
+  RAMDISK_FMT     [raw]
+  /sdcard/dualboot# ls
+  boot  kernel  kernel_dtb  ramdisk.cpio
+  ```
+
+- Apply patch with dualboot kernel patcher.
+  + Assume the patcher and shellcodes and config you downloaded above was saved at `/sdcard/Download/`
+  + Unpack these zips:
+  ```
+  unzip /sdcard/Download/
+  ```
+
+- 
diff --git a/DualBoot/ShellCode.md b/DualBoot/ShellCode.md
@@ -6,15 +6,15 @@ Shell Code is the key place why we patch kernel or what do we patch kernel for.
 
 ## DualBoot ShellCodes
 - For DualBoot feature, here provided several sources:
-  + [DummyHead.S](https://github.com/woa-msmnile/DualBootKernelPatcher/blob/main/ShellCode/DummyHead.S)
+  + [DummyHead.S](https://github.com/Project-Aloha/DualBootKernelPatcher/blob/main/ShellCode/DummyHead.S)
     - PlaceHolders of Linux Kernel hdr.(refer `kernel64_hdr` struct in [Qualcomm ABL](https://git.codelinaro.org/clo/la/abl/tianocore/edk2/-/blob/KERNEL.PLATFORM.2.1.r1-04700-kernel.0/QcomModulePkg/Include/Library/BootImage.h?ref_type=tags#L477-489))
     - This part will not be injected into Linux kernel.
 
   + `ShellCode.xxx.S`
     - Read flags in memory or do other check.
     - Once the conditions are met, will jump to `_UEFI`, otherwise continue next instruction.
 
-  + [CommonTail.S](https://github.com/woa-msmnile/DualBootKernelPatcher/blob/main/ShellCode/CommonTail.S)
+  + [CommonTail.S](https://github.com/Project-Aloha/DualBootKernelPatcher/blob/main/ShellCode/CommonTail.S)
     - First instruction is jumping to linux, that happen when condition in `ShellCode.xxx.S` not meet.
     - Provide `_UEFI`label, `ShellCode.xxx.S` will jump here after conditions.
     - Handles unexceptional behavior in the end.

diff --git a/InstallationGuides/InstallDrivers.md b/InstallationGuides/InstallDrivers.md
@@ -14,16 +14,16 @@
 - Download Driver Pack
   > Just click the Download Button in the page.
   <img src="/InstallationGuides/Resources/InstallDrivers/HowToDownload1.png" width=40%/>
-  - For Sm8150 Devices, the repo is [msmnile-Drivers](https://github.com/woa-msmnile/msmnile-Drivers)
-  - For Sm7125 Devices, the repo is [Atoll-Drivers](https://github.com/woa-msmnile/Atoll-Drivers)
+  - For Sm8150 Devices, the repo is [msmnile-Drivers](https://github.com/Project-Aloha/msmnile-Drivers)
+  - For Sm7125 Devices, the repo is [Atoll-Drivers](https://github.com/Project-Aloha/Atoll-Drivers)
   - For others, please refer to [QC Silicons' Codename Reference Table](../ReferenceTables/QCSiliconCodenameReferenceTable.md)  
     and download the one named xxx-Drivers.
 
 - Download Device Specific Driver Pack
   > Just click the Download Zip Button to Download.
   <img src="/InstallationGuides/Resources/InstallDrivers/HowToDownload2.png" width=40%/>
-  - For Xiaomi Pad 5, the repo is [Nabu](https://github.com/woa-msmnile/Nabu)
-  - For Oneplus 7TP/7T, the repo is [Hotdog](https://github.com/woa-msmnile/Hotdog)
+  - For Xiaomi Pad 5, the repo is [Nabu](https://github.com/Project-Aloha/Nabu)
+  - For Oneplus 7TP/7T, the repo is [Hotdog](https://github.com/Project-Aloha/Hotdog)
   - For others, please refer to [Devices' Codename Reference Table](../ReferenceTables/DeviceCodenameReferenceTable.md)  
     and download the one named xxx.
 

diff --git a/Introduction/msmnilePkg.md b/Introduction/msmnilePkg.md
diff --git a/Introduction/mu_aloha_platforms.md b/Introduction/mu_aloha_platforms.md
@@ -0,0 +1,2 @@
+# mu_aloha_platforms
+> [mu_aloha_platforms](https://github.com/Project-Aloha/mu_aloha_platforms) is a UEFI repo based on [SurfaceDuoPkg](https://github.com/WOA-Project/mu_andromeda_platforms)
diff --git a/Introduction/organization.md b/Introduction/organization.md
@@ -1,2 +1,2 @@
-# WOA-msmnile
-> WOA-msmnile is a organization gathered people who are porting woa to SM8150 and other newer silicons.
+# Project-Aloha
+> Project-Aloha is a organization gathered people who are porting woa to SM8150 and other newer silicons.
diff --git a/PortingGuides/SimpleGuide.md b/PortingGuides/SimpleGuide.md
@@ -1,4 +1,4 @@
-# msmnilePkg Porting Guide. 
+# mu_aloha_platforms Porting Guide. 
 :::danger
  **⚠ Do not try it on Google devices, Sony devices or Samsung devices.**
 :::
@@ -225,5 +225,5 @@ ___
     * If you can boot windows, turn it to `FALSE` and have a try.
     * Set MLVM to `TRUE` will occupy about 300MB Ram.
 ___
-***Don't forget to add your device and maintainer into [README](https://github.com/woa-msmnile/msmnilePkg).***  
+***Don't forget to add your device and maintainer into [README](https://github.com/Project-Aloha/mu_aloha_platforms).***  
 ***Thanks for your hard works.***
diff --git a/PortingStatus/PortingStatus.md b/PortingStatus/PortingStatus.md
@@ -1,3 +1,3 @@
 # Device porting status 
-  - msmnilePkg [README](https://github.com/woa-msmnile/msmnilePkg#target-list)
+  - mu_aloha_platforms [README](https://github.com/Project-Aloha/mu_aloha_platforms#target-list)
   - XiaoMi9 [Device status](https://github.com/qaz6750/XiaoMi9-Drivers/blob/main/Status.md) 
diff --git a/README.md b/README.md
@@ -1,5 +1,5 @@
-# WOA-msmnile Website
-> Knowledge record for woa-msmnile developing.
+# Project Aloha Website
+> Knowledge record for project aloha uefi and drivers developing.
 
 ## How to write and add guide here?
 ### Repo Introduce 

diff --git a/ReferenceTables/DeviceCodenameReferenceTable.md b/ReferenceTables/DeviceCodenameReferenceTable.md
@@ -1,2 +1,2 @@
 # Devices' Codename Table
-### Check README.md in our [BinariesBackup](https://github.com/woa-msmnile/BinariesBackup/#list) repo.
+### Check README.md in our [BinariesBackup](https://github.com/Project-Aloha/BinariesBackup/#list) repo.
diff --git a/Videos/Guide/TroubleShoot/example.md b/Videos/Guide/TroubleShoot/example.md
@@ -1,8 +1,8 @@
 # Fix bug on Device
-  [Link](/Introduction/msmnilePkg.md)
+  [Link](/Introduction/mu_aloha_platforms.md)
 
 ## Description
   This video can help you fix something on `Device`.
 
 ### Text Version
-  [Link](/Introduction/msmnilePkg.md)
+  [Link](/Introduction/mu_aloha_platforms.md)
diff --git a/Videos/Guide/WindowsInstallation/example.md b/Videos/Guide/WindowsInstallation/example.md
@@ -1,5 +1,5 @@
 # Install Guide For `Device`
-  [Link](/Introduction/msmnilePkg.md)
+  [Link](/Introduction/mu_aloha_platforms.md)
 
 ## Description
   This video can help you with windows installation on `Device`.
diff --git a/WindowsDebug/SetupKDCOM.md b/WindowsDebug/SetupKDCOM.md
diff --git a/WindowsDebug/SetupKDNET.md b/WindowsDebug/SetupKDNET.md
diff --git a/index.md b/index.md
@@ -3,9 +3,9 @@
 layout: home
 
 hero:
-  name: "WOA-msmnile"
+  name: "Project Aloha"
   text: "Bring a New Life to Your Phone."
-  tagline: Based On SurfaceDuoPkg
+  tagline: Based on DuoWoA Project.
   actions:
     - theme: brand
       text: Documents

diff --git a/zh/InstallationGuides/InstallDrivers.md b/zh/InstallationGuides/InstallDrivers.md
@@ -12,15 +12,15 @@
 - 下载平台通用驱动包
   > 点击页面上的`Download`按钮下载即可.
   <img src="/InstallationGuides/Resources/InstallDrivers/HowToDownload1.png" width=40%/>
-  - 对于搭载SD855的设备, 驱动库位于 [msmnile-Drivers](https://github.com/woa-msmnile/msmnile-Drivers)
-  - 对于搭载SD720的设备, 驱动库位于 [Atoll-Drivers](https://github.com/woa-msmnile/Atoll-Drivers)
+  - 对于搭载SD855的设备, 驱动库位于 [msmnile-Drivers](https://github.com/Project-Aloha/msmnile-Drivers)
+  - 对于搭载SD720的设备, 驱动库位于 [Atoll-Drivers](https://github.com/Project-Aloha/Atoll-Drivers)
   - 其他平台以此类推.
 
 - 下载适用于单独设备的驱动包
   > 点击`Download`按钮下载即可.
   <img src="/InstallationGuides/Resources/InstallDrivers/HowToDownload2.png" width=40%/>
-  - 对于小米平板五, 仓库在 [Nabu](https://github.com/woa-msmnile/Raphael).
-  - 对于一加7T Pro, 仓库在 [Hotdog](https://github.com/woa-msmnile/Hotdog).
+  - 对于小米平板五, 仓库在 [Nabu](https://github.com/Project-Aloha/Raphael).
+  - 对于一加7T Pro, 仓库在 [Hotdog](https://github.com/Project-Aloha/Hotdog).
   - 对于其他设备, 可以参考[设备代号参考表](/ReferenceTables/DeviceCodenameReferenceTable.md)类推.
 
 - 手机进入大容量模式 [大容量模式](EnterUMS.md).

diff --git a/zh/Introduction/msmnilePkg.md b/zh/Introduction/msmnilePkg.md
diff --git a/zh/Introduction/mu_aloha_platforms.md b/zh/Introduction/mu_aloha_platforms.md
@@ -0,0 +1,2 @@
+# mu_aloha_platforms
+> [mu_aloha_platforms](https://github.com/Project-Aloha/mu_aloha_platforms) 是基于 [SurfaceDuoPkg](https://github.com/WOA-Project/SurfaceDuoPkg) 扩展的 UEFI 仓库.
diff --git a/zh/Introduction/organization.md b/zh/Introduction/organization.md
@@ -1,2 +1,2 @@
-# WOA-msmnile
-> WOA-msmnile 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。
+# Project-Aloha
+> Project-Aloha 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。
diff --git a/zh/PortingGuides/SimpleGuide.md b/zh/PortingGuides/SimpleGuide.md
@@ -1,4 +1,4 @@
-# msmnilePkg 移植向导. 
+# mu_aloha_platforms 移植向导. 
 :::danger
   **⚠ 建议不要在谷歌、索尼和三星设备上尝试。**
 :::
@@ -105,7 +105,7 @@ ___
     8. Patch你的设备的dxe并放置在`PatchedBinaries/`文件夹下.
     9. 用`android-m928q.dtb`替换`android-guacamole.dtb`(你可以在`/sys/firmware/fdt`找到dtb, 或参照[补充说明](#补充说明))
     10. 用 `linux-m928q.dtb`替换`linux-guacamole.dtb`.(如果没有，可以通过`touch linux-m928q.dtb`创建一个假的)
-    11. 编译（编译方法参见[README.md](https://github.com/woa-msmnile/msmnilePkg/tree/main#build-instructions)）.
+    11. 编译（编译方法参见[README.md](https://github.com/Project-Aloha/mu_aloha_platforms/tree/main#build-instructions)）.
     12. 测试.
         + *建议使用fastboot boot命令热启动UEFI进行测试*
   - 如果移植成功，设备将进入UEFI Shell.
@@ -177,7 +177,7 @@ ___
     * 如果你可以启动Windows, 请尝试将其恢复`FALSE`.
     * 将MLVM设为`TRUE`会占用大约300MB运行内存.
 ___
-***不要忘记将你的设备和你的名字添加到[README](https://github.com/woa-msmnile/msmnilePkg/tree/main#target-list)中.***  
+***不要忘记将你的设备和你的名字添加到[README](https://github.com/Project-Aloha/mu_aloha_platforms/tree/main#target-list)中.***  
 ***感谢你的付出.***
 
 
diff --git a/zh/PortingStatus/PortingStatus.md b/zh/PortingStatus/PortingStatus.md
@@ -1,5 +1,5 @@
 # 设备移植状态
-  - msmnilePkg [自述文件](https://github.com/woa-msmnile/msmnilePkg#target-list)
+  - mu_aloha_platforms [自述文件](https://github.com/Project-Aloha/mu_aloha_platforms#target-list)
   - XiaoMi9 [详细设备状态](https://github.com/qaz6750/XiaoMi9-Drivers/blob/main/Status.md)
 ## Windows 各设备支持状态
 > [!TIP]

diff --git a/zh/Videos/Guide/TroubleShoot/example.md b/zh/Videos/Guide/TroubleShoot/example.md
@@ -1,8 +1,8 @@
 # 修复设备上的问题
-  > [链接](/Introduction/msmnilePkg.md)
+  > [链接](/Introduction/mu_aloha_platforms.md)
 
 ## 简介
   这个视频会演示如何修复`此设备`上的问题.
 
 ## 文字版本
-  > [链接](/Introduction/msmnilePkg.md)
+  > [链接](/Introduction/mu_aloha_platforms.md)
diff --git a/zh/Videos/Guide/WindowsInstallation/example.md b/zh/Videos/Guide/WindowsInstallation/example.md
@@ -1,5 +1,5 @@
 # 在设备上安装Windows
-  > [链接](/Introduction/msmnilePkg.md)
+  > [链接](/Introduction/mu_aloha_platforms.md)
   
 ## 简介
   这个视频会演示如何在`此设备`上安装Windows.
diff --git a/zh/index.md b/zh/index.md
@@ -3,7 +3,7 @@
 layout: home
 
 hero:
-  name: "WOA-msmnile"
+  name: "Project-Aloha"
   text: "你的手机，焕发新生"
   tagline: 基于 SurfaceDuoPkg
   actions:
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# mu_aloha_platforms
		> [mu_aloha_platforms](https://github.com/Project-Aloha/mu_aloha_platforms) is a UEFI repo based on [SurfaceDuoPkg](https://github.com/WOA-Project/mu_andromeda_platforms)