Uotan Wiki · 刷机百科 - 用户贡献 [zh-cn]

Project-Aloha

2025-06-08T07:26:06Z

Sunflower2333：依旧是更改名字

'''Project-Aloha 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。'''

Project aloha项目内仓库主要基于WOA Project的DuoWoA项目进行二次通用开发。

woa-msmnile 已经于2024/11/9更名为Project Aloha。

<u>主要仓库</u>：

* [https://github.com/project-aloha/mu_aloha_platforms mu_aloha_platforms]: 基于[https://github.com/WOA-Project/SurfaceDuoPkg SurfaceDuoPkg]二次开发的 UEFI仓库，目前支持Sm7125, Sm7325, Sm8150, Sm8550启动Windows。
* <s>[https://github.com/woa-msmnile/msmnile-drivers msmnile-Drivers]: [https://github.com/WOA-Project/SurfaceDuo-Drivers SurfaceDuo-Drivers]的Fork，主要提供了适用于Sm8150的平台通用驱动。</s>
* [DevcieCodename]: 基于SurfaceDuo-Drivers的设备特殊驱动。
* <s>[https://github.com/woa-msmnile/Kodiak-Drivers Kodiak-Drivers]: 整理来自Windows Updater的7c Gen3驱动合集，适用于Sm7325。</s>
* <s>[https://github.com/woa-msmnile/Atoll-Drivers Atoll-Drivers]: 整理来自Windows Updater的7c Gen2 驱动合集，适用于Sm7125。</s>
* [DriverName]: 存放触摸、功放等的开放源代码驱动。
* [https://github.com/Project-Aloha/project-aloha.github.io project-aloha.github.io]: Project aloha静态文档网站，托管在github page。

<u>主要条款:</u>

<u>[https://github.com/woa-msmnile/msmnilePkg/blob/main/LICENSE UEFI库条款]</u>

<u>[https://github.com/woa-msmnile/msmnile-Drivers/blob/main/LICENSE.md 驱动库条款]</u>

<u>联系我们</u>：

* QQ 群: project-aloha [https://qm.qq.com/cgi-bin/qm/qr?k=r2Gb_eHElZq0T7Rczf4rnEMsMdX6gbvF&jump_from=webapi&authKey=L4/pvGXcxQQddJpzUoa3qEh6P4n/fbF88oPKuPh4L0EFIEj5cY1k06i2w78gA5m5 问题与建议]
* 电报群: [https://t.me/woa_msmnile_issues project-aloha issues & advice]

<u>关于Gus</u>

Gustave Monce是计算机博士，是杰出的WOA开发者(WOA Project成员)，也是我们最好的老师。

8150 woa的发展离不开Gus，平台适配都是Gus做的。

需要注意的是，Gus会告诉你怎么做，但是不会帮你做。如果你遇到Gustave Monce，请尊重Gus，并且不要要求他帮你做任何非SurfaceDuo系列设备的woa适配，且不要询问任何与SDPkg无关的项目。

你可以在[https://github.com/sponsors/gus33000 这里赞助]Gus，感谢你的慷慨。

<u>关于其他同类仓库:</u>

本项目组与edk2-msm仓库, edk2-porting组织以及MU-Qcom没有任何关联。

故如果您在移植他们的过程中遇到问题，请勿打扰本项目开发者。

<u>关于sm8150 woa：</u>

ww, lemon ice, slfr以及其他贡献者是最初研究sm8150 woa的人。

ww最先基于imbushuo的pkg给f11(k20pro)移植了edk2，sflr给edk2增加了更多的设备支持，lemon ice最先在op7tp上修好了usb。

起初公开的edk2-sm8150是sflr基于f11pkg改的，后来因为pep无法工作且因sflr的patch无果而止步。

后来Gustave Monce(国外知名woa大佬) 给SurfaceDuo1移植了基于projectMU的UEFI，对8180的pep和其他驱动进行大量补丁，基于8180的acpi进行逆向修改适配，最终pep成功在8150平台跑通，给8150带来了新的曙光。

sflr之前对projectmu就比较感兴趣，出于学习的目的尝试研究SDPkg并且移植给其他设备，即后来的mu-sm8150pkg。Ice在后来不知所踪，ww参与了几个工程设备的woa适配，slfr跟着Gus学习相关知识，并且给一些设备适配DSDT表和驱动。

8150pkg并入rp

edk2msm支持8150

8150pkg被移出rp

8150pkg移入woa-msmnile

MU-Qcom出现

8150pkg在投票后改名msmnilePkg

首页

2025-06-08T07:25:02Z

Sunflower2333：

<div style="text-align: center; padding: 40px 20px;">
<div style="display: inline-block; vertical-align: middle; padding: 20px; text-align: center;">
<h1 style="display: block; font-size: 42px; font-weight: bold; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin: 0 auto;">
欢迎来到[[文件:UotanWiki.png|250px]]刷机百科
</h1>
</div>

<p style="font-size: 20px; color: #6c757d; margin-top: 30px; line-height: 1.5; text-align: center;">
我们致力于打造<br>
<span style="font-weight: bold; color: #34495e;">更适合国人使用</span>、<span style="font-weight: bold; color: #34495e;">更贴近刷机本质</span>的<br>
玩机知识共享平台<br>
<br>
<span style="font-weight: bold; color: #34495e;">UoWiki现已上线[[提问与反馈板块]]，欢迎前往！╰(*°▽°*)╯
</p>
</div>
<div style="margin: 40px 0;">
<div style="display: flex; flex-wrap: wrap; justify-content: center; gap: 30px; margin: 0 auto; max-width: 1000px; text-align: center;">

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">注册用户</div>
<div style="font-size: 24px; color: #007BFF;">{{NUMBEROFUSERS}}</div>
</div>

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">活跃用户</div>
<div style="font-size: 24px; color: #28a745;">{{NUMBEROFACTIVEUSERS}}</div>
</div>

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">条目总数</div>
<div style="font-size: 24px; color: #fd7e14;">{{NUMBEROFARTICLES}}</div>
</div>

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">总编辑数</div>
<div style="font-size: 24px; color: #6f42c1;">{{NUMBEROFEDITS}}</div>
</div>

</div>
</div>

<div style="display: flex; flex-wrap: wrap; gap: 20px; max-width: 1200px; margin: 0 auto; padding: 20px;">


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">刷机入门</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[ADB与Fastboot|ADB 与 Fastboot]]<br>
• [[解锁Bootloader|解锁 Bootloader]]<br>
• [[刷入第三方Recovery|刷入第三方 Recovery]]<br>
• [[Recovery 刷机基本操作]]<br>
• [[获取Root权限|获取 Root 权限]]<br>
• [[Miflash线刷|MiFlash 线刷]]<br>
• [[使用柚坛工具箱进行线刷]]<br>
• [[ADB SideLoad]]<br>
• [[关于USB]]<br>
• [[Fastboot Update]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">进阶内容</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[Fastboot 命令]]<br>
• [[刷入任意单独镜像]]<br>
• [[Fastbootd|用户空间Fastboot]]<br>
• [[Project Treble|Project Treble（PT）]]<br>
• [[通用系统镜像|通用系统镜像（GSI）]]<br>
• [[GKI|GKI（通用内核映像）]]<br>
• [[Dynamic System Updates|DSU（Dynamic System Updates）]]<br>
• [[Android Verified Boot|AVB（Android Verified Boot）]]<br>
• [[Super Empty|Super empty]]<br>
• [[9008深度刷机|9008 深度刷机]]<br>
• [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]<br>
• [[提取分区]]<br>
• [[格式化分区]]<br>
• [[修改分区]]<br>
• [[QCN]]<br>
• [[Magiskboot]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">玩机软件（移动端）</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[NekoSMS]]<br>
• [[Chimi]]<br>
• [[Xposed]]<br>
• [[LSPosed]]<br>

</div>
</div>
</div>

<div style="display: flex; flex-wrap: wrap; gap: 20px; max-width: 1200px; margin: 0 auto; padding: 20px;">


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">柚坛工具箱</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[UotanToolBoxNT使用合集|柚坛工具箱使用合集]]

</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">系统修改</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[ADB命令|ADB 命令]]<br>
• [[HDC命令|HDC 命令]]<br>
• [[Magisk模块|Magisk 模块]]<br>
• [[LsPosed 模块|LSPosed 模块]]<br>
• [[KSU 模块]]<br>
• [[修改方案合集]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">Windows on ARM 相关</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[Renegade project]]<br>
• [[Renegade_Project移植指南]]<br>
• [[为手机刷入Windows|为手机刷入 Windows]]<br>
• [[更新驱动程序]]<br>
• [[Project-Aloha]]
• [[重新安装Windows|重新安装 Windows]]<br>
• [[LumiaWOA_设备]]
• [[Windows RT]]
• [[OnePlus SM8150]]
• [[Xiaomi POCO X3 NFC (surya) woa]]
• [[Redmi Note 9 Pro (miatoll) woa]]
• [[Xiaomi Civi (mona) woa]]
• [[一些常见问题及其解决方案]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">高级内容</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[AOSP]]<br>
• [[Android 分区详解]]<br>
• [[SELinux]]<br>
• [[如何解包 Android ROM]]<br>
• [[如何打包 Android ROM]]<br>
• [[柚坛工具箱TXT线刷规范文档]]<br>
• [[如何从源码构建 TWRP Recovery]]<br>
• [[如何从源码构建 Android ROM]]<br>
• [[使用edl.py|使用 edl.py]]<br>
• [[高通端口合集]]<br>
• [[ARM-v8a异常等级]]<br>
• [[为手机安装Linux|为手机安装 Linux]]<br>
• [[Git使用教程]]<br>
• [[Android内核编译入门]]<br>
• [[为新设备编写Recovery device tree]]<br>
• [[为新设备编写类原生device tree]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">数据资料查询</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[SOC平台型号对照表（联发科）]]<br>
• [[SOC平台型号对照表（高通骁龙）]]<br>
• [[小米手机设备代号名称对照表]]<br>
• [[华为手机型号对照表（中国）]]<br>
• [[荣耀手机型号对照表（中国）]]<br>
• [[各 Android 手机厂商 Bootloader 解锁 / 内核开源 / 解锁后保修情况]]
• [[部分Android厂商设备原厂Rom下载渠道收录]]<br>
• [[适用于原厂Rom刷机工具、固件烧录工具下载渠道收录]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">知名类原生ROM</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[AfterLife]]<br>
• [[AlphaDroid]]<br>
• [[AOSPA]]<br>
• [[ArrowOS]]<br>
• [[crDroid]]<br>
• [[dotOS]]<br>
• [[DroidX]]<br>
• [[DerpFest]]<br>
• [[EvolutionX]]<br>
• [[exTHmUI]]<br>
• [[GrapheneOS]]<br>
• [[KaleidoscopeOS]]<br>
• [[LineageOS]]<br>
• [[Miku|Miku UI]]<br>
• [[Mokee]]<br>
• [[PixelExperience]]<br>
• [[RisingOS]]<br>
• [[YAAP]]
</div>
<div style="font-family: 'Microsoft YaHei', sans-serif; font-size: 14px; font-style: italic; color: #666; margin-top: 10px;">注：以上排序不分先后</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">知名玩机博主</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[极客湾Geekerwan]]<br>
• [[晨钟酱Official]]<br>
• [[江灵夏草]]<br>
• [[柚坛UOTAN]]
</div>
<div style="font-family: 'Microsoft YaHei', sans-serif; font-size: 14px; font-style: italic; color: #666; margin-top: 10px;">注：以上排序不分先后</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">知名玩机开发者</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[暮间雾]]<br>
• [[某贼]]<br>
• [[Amktiao]]<br>
• [[小太阳ACA]]<br>
• [[hellobbn]]
</div>
<div style="font-family: 'Microsoft YaHei', sans-serif; font-size: 14px; font-style: italic; color: #666; margin-top: 10px;">注：以上排序不分先后</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">更多词条</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[设备代号收录集合]]<br>
• [[Android 版本合集]]<br>
• [[Linux mainlining]]<br>
• [[Windows on arm|WOA (Windows on arm)]]
</div>
</div>

</div>

Woa-msmnile

2025-06-08T07:24:27Z

Sunflower2333：Sunflower2333移动页面Woa-msmnile至Project-Aloha：woa msmnile 改名

#重定向 [[Project-Aloha]]

Project-Aloha

2025-06-08T07:24:27Z

Sunflower2333：Sunflower2333移动页面Woa-msmnile至Project-Aloha：woa msmnile 改名

'''Project-Aloha 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。'''

Project aloha项目内仓库主要基于WOA Project的DuoWoA项目进行二次通用开发。

woa-msmnile 已经于2024/11/9更名为Project Aloha。

<u>主要仓库</u>：

* [https://github.com/project-aloha/mu_aloha_platforms mu_aloha_platforms]: 基于[https://github.com/WOA-Project/SurfaceDuoPkg SurfaceDuoPkg]二次开发的 UEFI仓库，目前支持Sm7125, Sm7325, Sm8150, Sm8550启动Windows。
* <s>[https://github.com/woa-msmnile/msmnile-drivers msmnile-Drivers]: [https://github.com/WOA-Project/SurfaceDuo-Drivers SurfaceDuo-Drivers]的Fork，主要提供了适用于Sm8150的平台通用驱动。</s>
* [DevcieCodename]: 基于SurfaceDuo-Drivers的设备特殊驱动。
* <s>[https://github.com/woa-msmnile/Kodiak-Drivers Kodiak-Drivers]: 整理来自Windows Updater的7c Gen3驱动合集，适用于Sm7325。</s>
* <s>[https://github.com/woa-msmnile/Atoll-Drivers Atoll-Drivers]: 整理来自Windows Updater的7c Gen2 驱动合集，适用于Sm7125。</s>
* [DriverName]: 存放触摸、功放等的开放源代码驱动。
* [https://github.com/Project-Aloha/project-aloha.github.io project-aloha.github.io]: woa-msmnile 静态文档网站，托管在github page。

<u>主要条款:</u>

<u>[https://github.com/woa-msmnile/msmnilePkg/blob/main/LICENSE UEFI库条款]</u>

<u>[https://github.com/woa-msmnile/msmnile-Drivers/blob/main/LICENSE.md 驱动库条款]</u>

<u>联系我们</u>：

* QQ 群: [https://qm.qq.com/cgi-bin/qm/qr?k=r2Gb_eHElZq0T7Rczf4rnEMsMdX6gbvF&jump_from=webapi&authKey=L4/pvGXcxQQddJpzUoa3qEh6P4n/fbF88oPKuPh4L0EFIEj5cY1k06i2w78gA5m5 woa-msmnile 问题与建议]
* 电报群: [https://t.me/woa_msmnile_issues woa-msmnile issues & advice]
* Discord: [https://discord.gg/zfh6RxYwb5 woa-msmnile uefi porting]

<u>关于Gus</u>

Gustave Monce是计算机博士，是杰出的WOA开发者(WOA Project成员)，也是我们最好的老师。

8150 woa的发展离不开Gus，平台适配都是Gus做的。

需要注意的是，Gus会告诉你怎么做，但是不会帮你做。如果你遇到Gustave Monce，请尊重Gus，并且不要要求他帮你做任何非SurfaceDuo系列设备的woa适配，且不要询问任何与SDPkg无关的项目。

你可以在[https://github.com/sponsors/gus33000 这里赞助]Gus，感谢你的慷慨。

<u>关于其他同类仓库:</u>

本项目组与edk2-msm仓库, edk2-porting组织以及MU-Qcom没有任何关联。

故如果您在移植他们的过程中遇到问题，请勿打扰本项目开发者。

<u>关于sm8150 woa：</u>

ww, lemon ice, slfr以及其他贡献者是最初研究sm8150 woa的人。

ww最先基于imbushuo的pkg给f11(k20pro)移植了edk2，sflr给edk2增加了更多的设备支持，lemon ice最先在op7tp上修好了usb。

起初公开的edk2-sm8150是sflr基于f11pkg改的，后来因为pep无法工作且因sflr的patch无果而止步。

后来Gustave Monce(国外知名woa大佬) 给SurfaceDuo1移植了基于projectMU的UEFI，对8180的pep和其他驱动进行大量补丁，基于8180的acpi进行逆向修改适配，最终pep成功在8150平台跑通，给8150带来了新的曙光。

sflr之前对projectmu就比较感兴趣，出于学习的目的尝试研究SDPkg并且移植给其他设备，即后来的mu-sm8150pkg。Ice在后来不知所踪，ww参与了几个工程设备的woa适配，slfr跟着Gus学习相关知识，并且给一些设备适配DSDT表和驱动。

8150pkg并入rp

edk2msm支持8150

8150pkg被移出rp

8150pkg移入woa-msmnile

MU-Qcom出现

8150pkg在投票后改名msmnilePkg

Project-Aloha

2025-06-08T07:21:23Z

Sunflower2333：更名为Project Aloha

'''Project-Aloha 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。'''

Project aloha项目内仓库主要基于WOA Project的DuoWoA项目进行二次通用开发。

woa-msmnile 已经于2024/11/9更名为Project Aloha。

<u>主要仓库</u>：

* [https://github.com/project-aloha/mu_aloha_platforms mu_aloha_platforms]: 基于[https://github.com/WOA-Project/SurfaceDuoPkg SurfaceDuoPkg]二次开发的 UEFI仓库，目前支持Sm7125, Sm7325, Sm8150, Sm8550启动Windows。
* <s>[https://github.com/woa-msmnile/msmnile-drivers msmnile-Drivers]: [https://github.com/WOA-Project/SurfaceDuo-Drivers SurfaceDuo-Drivers]的Fork，主要提供了适用于Sm8150的平台通用驱动。</s>
* [DevcieCodename]: 基于SurfaceDuo-Drivers的设备特殊驱动。
* <s>[https://github.com/woa-msmnile/Kodiak-Drivers Kodiak-Drivers]: 整理来自Windows Updater的7c Gen3驱动合集，适用于Sm7325。</s>
* <s>[https://github.com/woa-msmnile/Atoll-Drivers Atoll-Drivers]: 整理来自Windows Updater的7c Gen2 驱动合集，适用于Sm7125。</s>
* [DriverName]: 存放触摸、功放等的开放源代码驱动。
* [https://github.com/Project-Aloha/project-aloha.github.io project-aloha.github.io]: woa-msmnile 静态文档网站，托管在github page。

<u>主要条款:</u>

<u>[https://github.com/woa-msmnile/msmnilePkg/blob/main/LICENSE UEFI库条款]</u>

<u>[https://github.com/woa-msmnile/msmnile-Drivers/blob/main/LICENSE.md 驱动库条款]</u>

<u>联系我们</u>：

* QQ 群: [https://qm.qq.com/cgi-bin/qm/qr?k=r2Gb_eHElZq0T7Rczf4rnEMsMdX6gbvF&jump_from=webapi&authKey=L4/pvGXcxQQddJpzUoa3qEh6P4n/fbF88oPKuPh4L0EFIEj5cY1k06i2w78gA5m5 woa-msmnile 问题与建议]
* 电报群: [https://t.me/woa_msmnile_issues woa-msmnile issues & advice]
* Discord: [https://discord.gg/zfh6RxYwb5 woa-msmnile uefi porting]

<u>关于Gus</u>

Gustave Monce是计算机博士，是杰出的WOA开发者(WOA Project成员)，也是我们最好的老师。

8150 woa的发展离不开Gus，平台适配都是Gus做的。

需要注意的是，Gus会告诉你怎么做，但是不会帮你做。如果你遇到Gustave Monce，请尊重Gus，并且不要要求他帮你做任何非SurfaceDuo系列设备的woa适配，且不要询问任何与SDPkg无关的项目。

你可以在[https://github.com/sponsors/gus33000 这里赞助]Gus，感谢你的慷慨。

<u>关于其他同类仓库:</u>

本项目组与edk2-msm仓库, edk2-porting组织以及MU-Qcom没有任何关联。

故如果您在移植他们的过程中遇到问题，请勿打扰本项目开发者。

<u>关于sm8150 woa：</u>

ww, lemon ice, slfr以及其他贡献者是最初研究sm8150 woa的人。

ww最先基于imbushuo的pkg给f11(k20pro)移植了edk2，sflr给edk2增加了更多的设备支持，lemon ice最先在op7tp上修好了usb。

起初公开的edk2-sm8150是sflr基于f11pkg改的，后来因为pep无法工作且因sflr的patch无果而止步。

后来Gustave Monce(国外知名woa大佬) 给SurfaceDuo1移植了基于projectMU的UEFI，对8180的pep和其他驱动进行大量补丁，基于8180的acpi进行逆向修改适配，最终pep成功在8150平台跑通，给8150带来了新的曙光。

sflr之前对projectmu就比较感兴趣，出于学习的目的尝试研究SDPkg并且移植给其他设备，即后来的mu-sm8150pkg。Ice在后来不知所踪，ww参与了几个工程设备的woa适配，slfr跟着Gus学习相关知识，并且给一些设备适配DSDT表和驱动。

8150pkg并入rp

edk2msm支持8150

8150pkg被移出rp

8150pkg移入woa-msmnile

MU-Qcom出现

8150pkg在投票后改名msmnilePkg

高通Windows平台音频驱动适配

2024-02-18T10:46:16Z

Sunflower2333：新增ACDB配置

''<u>声明：本篇中可能存在大量错误，欢迎指正。</u>''

'''<big>前言</big>'''

在高通平台上，常见的扬声器解决方案主要有：

# WCD -- SWR --> WSA --> Speaker（例如WCD9340 + WSA8815）
# WCD -- I2S --> 3rd-party Amplifier --> Speaker（例如WCD9340 + TFA9874）

大多数OEM机器采用三方功放，部分厂商采用高通的WSA方案，高通工程机绝大部分采用WCD + WSA方案。

本文讨论方案2，也就是WCD + 三方功放方案。

'''<big>基础知识</big>'''

<u>常见英文简写/名词说明:</u>

* AP: Application Processor，应用处理器，这里指处理器
* WCD: 高通的Audio CodeC
* [[wikipedia:I²C|I2C]]: 也常写作I²C/IIC，只需要两根线就可以双向传输数据
* [[wikipedia:I²S|I2S]]: 集成电路内置音频总线，传输音频数据
* SWR: SoundWire，MIPI 2014年定义的音频接口
* SLIMBus: MIPI 2007年定义的音频接口
* DSDT: Differentiated System Description Table，ACPI表中的一个，用以描述平台的外围设备和系统硬件
* ASL: ACPI源语言
* Microsoft asl: 微软的ASL编译器
* iasl: Intel的ASL语言编译器
* AML: ACPI计算机语言，即ASL编译后产物
* dsl: iasl反编译AML之后产出的反编译源代码文件
* ACDB: Audio Calibration Database 高通平台音频配置
* amp: 下文对Amplifier即功放芯片的简称
* LA: Linux Android平台
* WP: WIndows平台

<u>硬件相关:</u>

* WCD通过SPI, SLIMBus 与AP进行通信。
* 功放芯片通常通过I2C与AP进行通信，即我们可以通过i2c传输命令配置和控制功放芯片。
* AP通过I2S向功放芯片传输音频数据。
* I2S一般连接四根线，即BCK, WCK, DATAO, DATAI。
* 在Linux内核或者安卓内核源码中可以找到平台GPIO的功能配置等信息，例如[https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/tree/drivers/pinctrl/qcom/pinctrl-sm8150.c#n1313 SM8150]。
* 高通的I2S不只一组，其命名编号通常为Primary，Secondary，Tertiary，Quaternary或其简写。
* 在Linux内核或者安卓内核中的设备树源码中可以寻找到I2C相关的属性，例如[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/oneplus/SM8150_SDX50M_Q_10.0/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi SM8150]

<u>软件相关:</u>

高通Windows平台已经提供了大部分音频相关的DSDT配置和驱动，即：

# 基础的DSDT
# 音频相关驱动以及inf中的默认配置
# 默认的ACDB

我们能够在Windows Update，或者[[WOA-Project]]的[https://github.com/WOA-Project/Qualcomm-Reference-Drivers Qualcomm-Reference-Drivers]上下载到的参考平台驱动和固件，其中对应关系：
{| class="wikitable"
|+
!移动PC平台
!移动平台
|-
|SD850
|SD845
|-
|7c Gen1/Gen2
|SD720
|-
|7c Gen3
|SD778
|-
|SD835
|SD835
|}

对于

* 如何从firmware cab中解包出ACPI表
* 如何反编译DSDT
* 如何反编译dtb
* 如何解决回编译.dsl中遇到的error
* 如何反编译AeoB
* 如何回编译AeoBSL

均不在本文探讨范围之内。

'''<u>所以，在阅读下述内容时，假设你已经拥有DSDT表和Audio相关驱动，并且说实在的，这是最常见的情况。</u>'''

'''<big>配置DSDT表</big>'''

对于使用三方功放的平台，我们需要在DSDT中定义：

* 功放设备，其中包含了功放的硬件连接的资源描述，主要为I2C和Gpio中断（如果你的驱动不处理中断，可以不定义）
* 功放设备的电源管理配置，其中包含功放的Reset脚以及电源配置（如果你的功放在dts中未定义电源，此处也不需要定义）
* I2S Gpio功能配置
* I2C Master设备定义
* I2C Master设备资源定义

下面我们以一加7T Pro为例，具体说说如何定义。

'''<u>定义功放设备:</u>'''

要在DSDT中定义我们的功放设备，首先我们需要了解其基本的连接属性，即挂在哪个i2c master下面，中断gpio是多少，reset gpio是多少，reset gpio是高电平使能还是低电平使能等等，这些通常在设备树中有所定义。

<u>''一：在设备树中寻找属性:''</u>

在安卓里面，打开<code>Device Info HW</code>软件，点击右上角<code>设置</code>，打开<code>显示i2c地址</code>和<code>使用Root</code>在首页，我们可以看到设备的音频那一栏写着诸如<code>tfa98xx (i2c 0-0034)</code>、<code>tas2557 (i2c 1-004c)</code> 、cs35l41 <code>(i2c 0-0040)</code>之类的字样，此时我们打开反编译之后的dts，搜索相关字段，例如我在一加7T Pro的dts中搜索tfaxx，可以找到相关节点：<blockquote> i2c@890000 {

......

tfa98xx_right@34 {

compatible = "nxp,tfa98xx";

reg = <0x34>;

reset-gpio = <0x38 0x25 0x00>;

status = "ok";

phandle = <0x761>;

};

tfa98xx_left@35 {

compatible = "nxp,tfa98xx";

reg = <0x35>;

reset-gpio = <0x38 0x64 0x00>;

status = "ok";

phandle = <0x762>;

};

......

};</blockquote>一加7T Pro拥有双扬声器，故此处定义了左右两个tfa98xx设备。观察上下文即可得出tfa98xx设备位于<code>i2c@890000</code>下，reset 脚分别为<code>gpio37</code>(hex: 0x25)和<code>gpio100</code> (hex: 0x64)，并且这两个slave设备在i2c上地址/ID分别为<code>0x34</code>和<code>0x35</code>。

<u>''二：使用asl创建设备:''</u>
新建文本文件cust_spkr.asl并粘贴如以下内容：<blockquote> Device (SPK1)

{

Name (_HID, "PLHD0001")

Name (_UID, 0)

Alias(\_SB.PSUB, _SUB)

Name (_DEP, Package()

{

\_SB.GIO0,

\_SB.I2CX

})

Method (_CRS, 0x0, NotSerialized)

{

Name (RBUF, ResourceTemplate()

{

I2CSerialBus(0xAA, , 400000, AddressingMode7Bit, "\\_SB.I2CX",,,,)

})

Return (RBUF)

}

}</blockquote>粘贴进去之后，我们需要修改几个地方，

# <code>Device (SPK1)</code> 中的1修改为实际数值，例如有两个amp，则第二个设备名应该为<code>SPK2</code>，以此类推。
# 将<code>Name (_HID, "PLHD0001")</code>将此处的<code>PLHD0001</code>改成你的设备的名称，例如对于一加7TPro, 此处为<code>GTFA9874</code>，请记住你定义的_HID，下文驱动中还需要用到。
# <code>Name (_UID, 0)</code> 中的0修改为实际数值，例如有两个amp，则第二个设备的_UID应该为<code>1</code>，以此类推。
# <code>\_SB.I2CX</code> 中的X修改为实际数值，例如本文中amp挂在<code>i2c@890000</code>下，通过观察[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi#L111 xxx-qupv3.dtsi源码]可知其属于qupv3_se4_i2c，故此处的<code>X</code>为 <code>5</code>（se号+1）。
# <code>I2CSerialBus(0xAA, , 400000, AddressingMode7Bit, "\\_SB.I2CX",,,,)</code> 中的<code>0xAA</code>修改为实际值，例如本文中第一个tfa98xx地址为<code>0x34</code>，则此处修改为<code>0x34</code>，<code>400000</code>为频率，通常为<code>400khz</code>或者<code>100khz，"\\_SB.I2CX"</code> 中的<code>X</code>需要修改为实际值，参考上条。

自此，我们已经在asl中完成了amp设备的定义。接下来，我们需要在DSDT.dsl中添加<code>Include("cust_spkr.asl")</code> 将我们的文件包含在DSDT.dsl中。

需要注意的是，这条Include语句必须位于 <code>Scope (\_SB){ ... }</code>内。

<u>'''定义I2C Master设备:'''</u>

上文中我们使用了<code>\_SB.I2CX</code>这个设备，但是大部分情况下这个设备都是没有被定义的，我们需要手动在dsdt中添加这个设备。

打开的DSDT.dsl，搜索<code>Device (I2C</code>，此时应当有较多和候选结果，如图：
[[文件:Search I2C Device.png|缩略图|1077x1077像素]]

此时我们将<code>Device (I2CX) {</code> 到对应的 <code>}</code> 复制并粘贴一份，依照我们的需求做相应修改:

# 修改粘贴后的文本中的<code>I2CX</code>的<code>X</code>为我们需要的se号+1。由于上文我们已经在dts中找到了i2c对应的se号，此处不在赘述。在一加7T Pro例子中，我们得到的是<code>5</code> 。注意，如果这里的<code>X</code>是两位数，你应当写作<code>ICX</code>，例如<code>IC17</code>。
# 修改<code>_UID</code>为实际值。此处与上文'''<code>X</code>'''的值保持相同，在一加7T Pro例子中，此处是<code>5</code>。
# 修改<code>Memory32Fixed</code>中的Address Base为实际值。在一加7T Pro的例子中，我们找到的<code>i2c@890000</code> 里面的<code>890000</code>即为此处的值，注意此数字为16精致数字，我们补上0x后，此处填写<code>0x890000</code>。
# 修改<code>Interrupt</code>里面的中断号。在上文中提到的[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi#L114 xxxx-quiv3.dtsi]中有此中断号的定义，需要注意的是，对于GIC_SPI，此处的值需要+32，即 <code>605 + 32= 637</code>。

<u>'''配置I2CMaster设备的硬件资源'''</u>

在DSDT.dsl中，我们再次搜索<code>\\_SB.I2C</code>，我们会找到一个类似如下结构的地方（注意，此处我将缩进和可省略代码整理了一下以便能够放在这里）：
[[文件:Sorted I2C resource.png|缩略图|1099x1099像素]]

将你的搜索结果中的这一个<code>Package{...}</code>复制并粘贴这个<code>Package{...}</code>下方，然后修改这里的一些字符串和Gpio配置为我们需要的实际值：

# 修改此处的<code>"\\_SB.I2CX"</code>为实际值，此处<code>X</code>应当与你在上方所得的<code>X</code>值保持一致。
# 修改上下两方的<code>QUP_Y、wrap_Y</code>和<code>sZ_clk</code>中的<code>Y</code>与<code>Z</code>为实际值。你仍然需要参考安卓[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi#L118 xxxx-qupv3.dts中的一个宏]来确定这里的值，例如此处的<code>GCC_QUPV3_WRAP0_S4_CLK</code>中的<code>WARP0</code>中的0即为Y的值，<code>S4</code>中的<code>4</code>为此处的<code>Z</code>。
# 修改TLMM Gpio的值为正确的值，你可以在安卓内核源码中的[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-pinctrl.dtsi#L782 xxxx-pinctrl.dtsi]和[https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/tree/drivers/pinctrl/qcom/pinctrl-sm8150.c#n1365 linux内核源码]中找到对应的gpio以及当其配置为qup时对应的func编号，在本文一加7T Pro的例子中，i2c_se4在pinctrl.dtsi中对应的gpio编号为51和52，gpio51、gpio52在内核源码中qup4功能对应的func为1。注意，PINGROUP(...)从左往右数依次为：(PIN编号，块，func1，func2，func3 ..... )。
# 此处TLMMGPIO内的Package释义如下：{PIN编号，电平，func，方向，上下拉，驱动电流强度}，具体使用参考DSDT.dsl内其他TLMMGPIO Package在DSTATE0和DSTATE3的区别即可知。

<u>'''配置Amp设备的硬件资源'''</u>

通过上述操作，我们已经成功定义了I2C从设备和I2C主设备，并且掌握了如何在Package中定义一个gpio状态。

如果我们此时进入系统并安装上I2C驱动，应当会在设备管理器中出现一个未知设备，且通过查看其详细信息可知此设备为SPK1。

假如此时使用SPBTool能够获取到Amp的回传数据，则此条目可忽略。当然，为了追求更高效率的电源管理，还是建议配置。

通常参考设备的dsdt的中PEP会保留OPMD方法，我们可以尝试在DSDT.dsl中搜索此OPMD，如果没有搜索结果，你可以新建一个文件，并且将他Include到你的DSDT中，文件内容大致如下：<blockquote>Scope(\_SB_.PEP0){

Method(OPMD){ Return(OPCC) }

Name(OPCC, Package () {

Package(){

"DEVICE",

"\\_SB.SPK1",

Package(){

"DSTATE", 0,

// Set your Reset gpio here, IC should be enabled in this DSTATE.

<nowiki> // Package(){"TLMMGPIO",Package(){123, 1, 0, 1, 0, 0}},</nowiki>

// Delay in ms if you need it, in most time not needed.

//Package() { "DELAY", Package() {2} },

}

Package(){

"DSTATE", 3,

// Set your Reset gpio here, IC should be shutdown in this DSTATE.

<nowiki> // Package(){"TLMMGPIO",Package(){123, 0, 0, 0, 0, 0}},</nowiki>

// Delay in ms if you need it, in most time not needed.

//Package() { "DELAY", Package() {2} },

}

}

}

}</blockquote>根据上文中所述的TLMMGPIO Package配置方法，并且按照你从dts中获得的Reset Gpio编号，你可以很轻松的按照这里的提示填写对应的数值。

在本文一加7T Pro的例子中，Reset Gpio编号为gpio37，我们将其TLMMGPIO的package前面的//删掉以取消注释，并将pin编号（第一个数字）改为37，由于此例中配置Reset脚为高电平时IC关闭（注意，通常情况下是Reset高电平时IC正常工作，此例是特殊），故将第二个数据改为0，在D3状态下，则将第二个数字改为1，第四个数字改为1。

'''<u>添加I2S配置</u>'''

恭喜你，已经成功完成了大部分配置了。现在我们即将完成最后一步，配置I2S所需的硬件资源。

相信根据前面的操作，你现在能过熟练使用TLMMGPIO这个Package来配置gpio状态了。

<u>''一：在设备树中寻找属性:''</u>

要配置正确的I2S，我们首先需要在源码中dts中，或者反编译后的dts中寻找到[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/1dd473abda05a72f6978c47b2a7d80828db6b426/arch/arm64/boot/dts/qcom/sm8150-oem.dtsi#L212 codec对应的节点]，此处为<code>quat</code>，故使用了<code>Quaternary</code>组的I2S，通过观察可知<code>mi2s_quat</code>在active时<code>137、138</code>均启用，但是由于缺乏原理图DATA线无法确定是使用SD0、SD1、SD2还是SD3(详见pinctrl dts里面的描述)，可以先考虑将几个gpio都写进去，日后再acdb中进行尝试。

当然如果你有原理图，直接搜索amp的名称，观察其BCK、WCK、DO、DI走线对应的gpio编号即可。

<u>''二：在DSDT中的合适位置添加资源:''</u>

在DSDT.dsl中搜索<code>\\_SB.ADSP.SLM1.ADCM.AUDD</code>，找到对应的资源配置Package。
[[文件:Search Resource of AUDD.png|缩略图|1102x1102像素]]

在此Package中寻找正确的Component ID，在本例中，<code>Quaternary</code>对应<code>Component ID</code>为<code>0xD。</code>你可以通过查阅<code>auddev_ext.inf</code>中的<code>COMPONENT_GPIOUID</code>与其对应的<code>GroupID_DeviceID</code>来确定其对应关系，具体方法在之后说到'''ACDB配置'''时会详细阐述。
[[文件:Quaternary RX I2S Component.png|缩略图|666x666像素]]
通常的对应关系为：
{| class="wikitable"
|+
!RX I2S ID
!Component ID
|-
|Quaternary
|0xD
|-
|Tertiary
|0xB
|-
|Secondary
|0x9
|-
|Primary
|0x7
|}

右侧图示为整理并添加完I2S相关的GPIO之后的Component 0xD，之前已经介绍过TLMMGPIO Package内部各个参数的含义，故不在赘述。

请'''务必'''将'''dts'''和'''源码'''中定义的'''对应的'''I2S的GPIO添加到这里，并且指定正确的Function，否则声音信号无法传输到Amp。

<big>''<u>自此，我们已经完成了对DSDT方面的修改，下面我们介绍驱动所需要的修改，以及如何书写一个驱动控制Amplifier。</u>''</big>

'''<big>配置ACDB</big>'''

WP平台的ACDB与LA平台的ACDB并不兼容，即便是同样的SOC。

旧平台的ACDB通常可以在'''QACT v7.4'''中进行编辑。

你可以在[https://developer.qualcomm.com/software/qact-platform 这里下载QACT]。
[[文件:QACT.png|缩略图|1085x1085像素]]

这是'''QACT 7.4'''正常打开时候的精神面貌，点击<code>Open ACDB From Disk</code>，再选择解压后的<code>qcacsp_xxxx.cab</code>包里面的<code>workspaceFile.qwsp</code>。如果没问题的话你会看到这个页面：
[[文件:QACT OPEN DEVICE MGR.png|缩略图|1080x1080像素]]

选择上方的Tools -> Device Designer 进入设备设计器中。

打开qcaudminiport.inf，搜索TopologySpeaker, 找到

<code>HKR,QCAUD\TopologySpeaker\Device0\,DeviceID,0x00010001,0x000000FF</code>

这里写的Device ID即为扬声器设备的Device ID，同时也就串联起了之前我们提到的<code>auddev_ext</code>里面的Device ID，一个device中包含了其使用的I2S，以及Data Line是SD0还是SD1、SD2、SD3。Device 存储在ACDB中，通过QACT的Device Designer中我们可以修改原来设备的属性或者添加删除设备。

推荐尽量不要修改qcaudminiport.inf中的Device ID，通过默认配置的方式达到我们的目的，这些DeviceID和ComponentID之类的如果一处配置出错都会导致驱动异常（表现为音量条自动调到最大，且无法控制）

<blockquote></blockquote>

文件:QACT OPEN DEVICE MGR.png

2024-02-18T10:09:32Z

Sunflower2333：

指出Device manager的位置

文件:QACT.png

2024-02-18T09:48:48Z

Sunflower2333：

高通QACT工具

文件:Quaternary RX I2S Component.png

2024-02-18T08:16:29Z

Sunflower2333：

用以第四组I2S的GPIO。

文件:Search Resource of AUDD.png

2024-02-18T08:14:45Z

Sunflower2333：

AUDD驱动的Resource，可以在里面配置电源等硬件资源。

高通Windows平台音频驱动适配

2024-02-17T18:17:01Z

Sunflower2333：添加了基础dsdt配置方法

''<u>声明：本篇中可能存在大量错误，欢迎指正。</u>''

'''<big>前言</big>'''

在高通平台上，常见的扬声器解决方案主要有：

# WCD -- SWR --> WSA --> Speaker（例如WCD9340 + WSA8815）
# WCD -- I2S --> 3rd-party Amplifier --> Speaker（例如WCD9340 + TFA9874）

大多数OEM机器采用三方功放，部分厂商采用高通的WSA方案，高通工程机绝大部分采用WCD + WSA方案。

本文讨论方案2，也就是WCD + 三方功放方案。

'''<big>基础知识</big>'''

<u>常见英文简写/名词说明:</u>

* AP: Application Processor，应用处理器，这里指处理器
* WCD: 高通的Audio CodeC
* [[wikipedia:I²C|I2C]]: 也常写作I²C/IIC，只需要两根线就可以双向传输数据
* [[wikipedia:I²S|I2S]]: 集成电路内置音频总线，传输音频数据
* SWR: SoundWire，MIPI 2014年定义的音频接口
* SLIMBus: MIPI 2007年定义的音频接口
* DSDT: Differentiated System Description Table，ACPI表中的一个，用以描述平台的外围设备和系统硬件
* ASL: ACPI源语言
* Microsoft asl: 微软的ASL编译器
* iasl: Intel的ASL语言编译器
* AML: ACPI计算机语言，即ASL编译后产物
* dsl: iasl反编译AML之后产出的反编译源代码文件
* ACDB: Audio Calibration Database 高通平台音频配置
* amp: 下文对Amplifier即功放芯片的简称

<u>硬件相关:</u>

* WCD通过SPI, SLIMBus 与AP进行通信。
* 功放芯片通常通过I2C与AP进行通信，即我们可以通过i2c传输命令配置和控制功放芯片。
* AP通过I2S向功放芯片传输音频数据。
* I2S一般连接四根线，即BCK, WCK, DATAO, DATAI。
* 在Linux内核或者安卓内核源码中可以找到平台GPIO的功能配置等信息，例如[https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/tree/drivers/pinctrl/qcom/pinctrl-sm8150.c#n1313 SM8150]。
* 高通的I2S不只一组，其命名编号通常为Primary，Secondary，Tertiary，Quaternary或其简写。
* 在Linux内核或者安卓内核中的设备树源码中可以寻找到I2C相关的属性，例如[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/oneplus/SM8150_SDX50M_Q_10.0/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi SM8150]

<u>软件相关:</u>

高通Windows平台已经提供了大部分音频相关的DSDT配置和驱动，即：

# 基础的DSDT
# 音频相关驱动以及inf中的默认配置
# 默认的ACDB

我们能够在Windows Update，或者[[WOA-Project]]的[https://github.com/WOA-Project/Qualcomm-Reference-Drivers Qualcomm-Reference-Drivers]上下载到的参考平台驱动和固件，其中对应关系：
{| class="wikitable"
|+
!移动PC平台
!移动平台
|-
|SD850
|SD845
|-
|7c Gen1/Gen2
|SD720
|-
|7c Gen3
|SD778
|-
|SD835
|SD835
|}

对于

* 如何从firmware cab中解包出ACPI表
* 如何反编译DSDT
* 如何反编译dtb
* 如何解决回编译.dsl中遇到的error
* 如何反编译AeoB
* 如何回编译AeoBSL

均不在本文探讨范围之内。

'''<u>所以，在阅读下述内容时，假设你已经拥有DSDT表和Audio相关驱动，并且说实在的，这是最常见的情况。</u>'''

'''<big>配置DSDT表</big>'''

对于使用三方功放的平台，我们需要在DSDT中定义：

* 功放设备，其中包含了功放的硬件连接的资源描述，主要为I2C和Gpio中断（如果你的驱动不处理中断，可以不定义）
* 功放设备的电源管理配置，其中包含功放的Reset脚以及电源配置（如果你的功放在dts中未定义电源，此处也不需要定义）
* I2S Gpio功能配置
* I2C Master设备定义
* I2C Master设备资源定义

下面我们以一加7T Pro为例，具体说说如何定义。

'''<u>定义功放设备:</u>'''

要在DSDT中定义我们的功放设备，首先我们需要了解其基本的连接属性，即挂在哪个i2c master下面，中断gpio是多少，reset gpio是多少，reset gpio是高电平使能还是低电平使能等等，这些通常在设备树中有所定义。

<u>''一：在设备树中寻找属性:''</u>

在安卓里面，打开<code>Device Info HW</code>软件，点击右上角<code>设置</code>，打开<code>显示i2c地址</code>和<code>使用Root</code>在首页，我们可以看到设备的音频那一栏写着诸如<code>tfa98xx (i2c 0-0034)</code>、<code>tas2557 (i2c 1-004c)</code> 、cs35l41 <code>(i2c 0-0040)</code>之类的字样，此时我们打开反编译之后的dts，搜索相关字段，例如我在一加7T Pro的dts中搜索tfaxx，可以找到相关节点：<blockquote> i2c@890000 {

......

tfa98xx_right@34 {

compatible = "nxp,tfa98xx";

reg = <0x34>;

reset-gpio = <0x38 0x25 0x00>;

status = "ok";

phandle = <0x761>;

};

tfa98xx_left@35 {

compatible = "nxp,tfa98xx";

reg = <0x35>;

reset-gpio = <0x38 0x64 0x00>;

status = "ok";

phandle = <0x762>;

};

......

};</blockquote>一加7T Pro拥有双扬声器，故此处定义了左右两个tfa98xx设备。观察上下文即可得出tfa98xx设备位于<code>i2c@890000</code>下，reset 脚分别为<code>gpio37</code>(hex: 0x25)和<code>gpio100</code> (hex: 0x64)，并且这两个slave设备在i2c上地址/ID分别为<code>0x34</code>和<code>0x35</code>。

<u>''二：使用asl创建设备:''</u>
新建文本文件cust_spkr.asl并粘贴如以下内容：<blockquote> Device (SPK1)

{

Name (_HID, "PLHD0001")

Name (_UID, 0)

Alias(\_SB.PSUB, _SUB)

Name (_DEP, Package()

{

\_SB.GIO0,

\_SB.I2CX

})

Method (_CRS, 0x0, NotSerialized)

{

Name (RBUF, ResourceTemplate()

{

I2CSerialBus(0xAA, , 400000, AddressingMode7Bit, "\\_SB.I2CX",,,,)

})

Return (RBUF)

}

}</blockquote>粘贴进去之后，我们需要修改几个地方，

# <code>Device (SPK1)</code> 中的1修改为实际数值，例如有两个amp，则第二个设备名应该为<code>SPK2</code>，以此类推。
# 将<code>Name (_HID, "PLHD0001")</code>将此处的<code>PLHD0001</code>改成你的设备的名称，例如对于一加7TPro, 此处为<code>GTFA9874</code>，请记住你定义的_HID，下文驱动中还需要用到。
# <code>Name (_UID, 0)</code> 中的0修改为实际数值，例如有两个amp，则第二个设备的_UID应该为<code>1</code>，以此类推。
# <code>\_SB.I2CX</code> 中的X修改为实际数值，例如本文中amp挂在<code>i2c@890000</code>下，通过观察[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi#L111 xxx-qupv3.dtsi源码]可知其属于qupv3_se4_i2c，故此处的<code>X</code>为 <code>5</code>（se号+1）。
# <code>I2CSerialBus(0xAA, , 400000, AddressingMode7Bit, "\\_SB.I2CX",,,,)</code> 中的<code>0xAA</code>修改为实际值，例如本文中第一个tfa98xx地址为<code>0x34</code>，则此处修改为<code>0x34</code>，<code>400000</code>为频率，通常为<code>400khz</code>或者<code>100khz，"\\_SB.I2CX"</code> 中的<code>X</code>需要修改为实际值，参考上条。

自此，我们已经在asl中完成了amp设备的定义。接下来，我们需要在DSDT.dsl中添加<code>Include("cust_spkr.asl")</code> 将我们的文件包含在DSDT.dsl中。

需要注意的是，这条Include语句必须位于 <code>Scope (\_SB){ ... }</code>内。

<u>'''定义I2C Master设备:'''</u>

上文中我们使用了<code>\_SB.I2CX</code>这个设备，但是大部分情况下这个设备都是没有被定义的，我们需要手动在dsdt中添加这个设备。

打开的DSDT.dsl，搜索<code>Device (I2C</code>，此时应当有较多和候选结果，如图：
[[文件:Search I2C Device.png|缩略图|1077x1077像素]]

此时我们将<code>Device (I2CX) {</code> 到对应的 <code>}</code> 复制并粘贴一份，依照我们的需求做相应修改:

# 修改粘贴后的文本中的<code>I2CX</code>的<code>X</code>为我们需要的se号+1。由于上文我们已经在dts中找到了i2c对应的se号，此处不在赘述。在一加7T Pro例子中，我们得到的是<code>5</code> 。注意，如果这里的<code>X</code>是两位数，你应当写作<code>ICX</code>，例如<code>IC17</code>。
# 修改<code>_UID</code>为实际值。此处与上文'''<code>X</code>'''的值保持相同，在一加7T Pro例子中，此处是<code>5</code>。
# 修改<code>Memory32Fixed</code>中的Address Base为实际值。在一加7T Pro的例子中，我们找到的<code>i2c@890000</code> 里面的<code>890000</code>即为此处的值，注意此数字为16精致数字，我们补上0x后，此处填写<code>0x890000</code>。
# 修改<code>Interrupt</code>里面的中断号。在上文中提到的[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi#L114 xxxx-quiv3.dtsi]中有此中断号的定义，需要注意的是，对于GIC_SPI，此处的值需要+32，即 <code>605 + 32= 637</code>。

<u>'''配置I2CMaster设备的硬件资源'''</u>

在DSDT.dsl中，我们再次搜索<code>\\_SB.I2C</code>，我们会找到一个类似如下结构的地方（注意，此处我将缩进和可省略代码整理了一下以便能够放在这里）：
[[文件:Sorted I2C resource.png|缩略图|1099x1099像素]]

将你的搜索结果中的这一个<code>Package{...}</code>复制并粘贴这个<code>Package{...}</code>下方，然后修改这里的一些字符串和Gpio配置为我们需要的实际值：

# 修改此处的<code>"\\_SB.I2CX"</code>为实际值，此处<code>X</code>应当与你在上方所得的<code>X</code>值保持一致。
# 修改上下两方的<code>QUP_Y、wrap_Y</code>和<code>sZ_clk</code>中的<code>Y</code>与<code>Z</code>为实际值。你仍然需要参考安卓[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-qupv3.dtsi#L118 xxxx-qupv3.dts中的一个宏]来确定这里的值，例如此处的<code>GCC_QUPV3_WRAP0_S4_CLK</code>中的<code>WARP0</code>中的0即为Y的值，<code>S4</code>中的<code>4</code>为此处的<code>Z</code>。
# 修改TLMM Gpio的值为正确的值，你可以在安卓内核源码中的[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/31bebb6ffc476f51986bd04502a76ffbd9e2fa7a/arch/arm64/boot/dts/qcom/sm8150-pinctrl.dtsi#L782 xxxx-pinctrl.dtsi]和[https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/tree/drivers/pinctrl/qcom/pinctrl-sm8150.c#n1365 linux内核源码]中找到对应的gpio以及当其配置为qup时对应的func编号，在本文一加7T Pro的例子中，i2c_se4在pinctrl.dtsi中对应的gpio编号为51和52，gpio51、gpio52在内核源码中qup4功能对应的func为1。注意，PINGROUP(...)从左往右数依次为：(PIN编号，块，func1，func2，func3 ..... )。
# 此处TLMMGPIO内的Package释义如下：{PIN编号，电平，func，方向，上下拉，驱动电流强度}，具体使用参考DSDT.dsl内其他TLMMGPIO Package在DSTATE0和DSTATE3的区别即可知。

<u>'''配置Amp设备的硬件资源'''</u>

通过上述操作，我们已经成功定义了I2C从设备和I2C主设备，并且掌握了如何在Package中定义一个gpio状态。

如果我们此时进入系统并安装上I2C驱动，应当会在设备管理器中出现一个未知设备，且通过查看其详细信息可知此设备为SPK1。

假如此时使用SPBTool能够获取到Amp的回传数据，则此条目可忽略。当然，为了追求更高效率的电源管理，还是建议配置。

通常参考设备的dsdt的中PEP会保留OPMD方法，我们可以尝试在DSDT.dsl中搜索此OPMD，如果没有搜索结果，你可以新建一个文件，并且将他Include到你的DSDT中，文件内容大致如下：<blockquote>Scope(\_SB_.PEP0){

Method(OPMD){ Return(OPCC) }

Name(OPCC, Package () {

Package(){

"DEVICE",

"\\_SB.SPK1",

Package(){

"DSTATE", 0,

// Set your Reset gpio here, IC should be enabled in this DSTATE.

<nowiki> // Package(){"TLMMGPIO",Package(){123, 1, 0, 1, 0, 0}},</nowiki>

// Delay in ms if you need it, in most time not needed.

//Package() { "DELAY", Package() {2} },

}

Package(){

"DSTATE", 3,

// Set your Reset gpio here, IC should be shutdown in this DSTATE.

<nowiki> // Package(){"TLMMGPIO",Package(){123, 0, 0, 0, 0, 0}},</nowiki>

// Delay in ms if you need it, in most time not needed.

//Package() { "DELAY", Package() {2} },

}

}

}

}</blockquote>根据上文中所述的TLMMGPIO Package配置方法，并且按照你从dts中获得的Reset Gpio编号，你可以很轻松的按照这里的提示填写对应的数值。

在本文一加7T Pro的例子中，Reset Gpio编号为gpio37，我们将其TLMMGPIO的package前面的//删掉以取消注释，并将pin编号（第一个数字）改为37，由于此例中配置Reset脚为高电平时IC关闭（注意，通常情况下是Reset高电平时IC正常工作，此例是特殊），故将第二个数据改为0，在D3状态下，则将第二个数字改为1，第四个数字改为1。

'''<u>添加I2S配置</u>'''

恭喜你，已经成功完成了大部分配置了。现在我们即将完成最后一步，配置I2S所需的硬件资源。

相信根据前面的操作，你现在能过熟练使用TLMMGPIO这个Package来配置gpio状态了。

<u>''一：在设备树中寻找属性:''</u>

要配置正确的I2S，我们首先需要在源码中dts中，或者反编译后的dts中寻找到[https://github.com/OnePlusOSS/android_kernel_oneplus_sm8150/blob/1dd473abda05a72f6978c47b2a7d80828db6b426/arch/arm64/boot/dts/qcom/sm8150-oem.dtsi#L212 codec对应的节点]，此处为quat，故使用了Quaternary组的I2S，通过观察可知mi2s_quat在active时137、138均启用，但是由于缺乏原理图无法确定使用SD0、SD1、SD2还是SD3，可以先考虑将几个gpio都写进去，日后再acdb中进行尝试。

当然如果你有原理图，直接搜索amp的名称，观察其BCK、WCK、DO、DI走线即可。

<u>''二：在DSDT中的合适位置添加资源:''</u>

在DSDT.dsl中搜索<code>\\_SB.ADSP.SLM1.ADCM.AUDD</code>，找到对应的资源配置Package，找到Quaternary对应Component ID，这通常为0xD，你可以通过查阅<code>auddev_ext.inf</code>中的<code>COMPONENT_GPIOUID</code>与其对应的<code>GroupID_DeviceID</code>来确定，具体方法在之后说到ACDB配置时会详细阐述。

未完待续.

<blockquote></blockquote>

文件:Sorted I2C resource.png

2024-02-17T16:26:03Z

Sunflower2333：

整理后的I2C Bus所需要的电源配置

文件:Search I2C Device.png

2024-02-17T14:48:01Z

Sunflower2333：

搜索I2C Bus设备

设备代号收录集合

2024-02-17T13:03:08Z

Sunflower2333：

目前设备代号收录表格
----

=== 小米/红米：（按发布时间排序） ===
{| class="wikitable"
|机型设备
|代号名称
|发布时间
|-
|红米Note13 4G NFC
|sapphiren
|2024/1/15
|-
|红米Note13 4G
|sapphire
|2024/1/15
|-
|红米13R 5G / 红米13C 5G
|air
|2023/12/8
|-
|红米K70E / POCO X6 Pro 5G
|duchamp
|2023/11/29
|-
|红米K70 Pro
|manet
|2023/11/29
|-
|红米K70
|vermeer
|2023/11/29
|-
|红米13C / POCO C65
|gale
|2023/11/10
|-
|小米14 Pro
|shennong
|2023/10/26
|-
|小米14
|houji
|2023/10/26
|-
|小米13T
|aristotle
|2023/9/26
|-
|红米Note13 Pro 4G / POCO X6
|garnet
|2023/9/21
|-
|红米Note13 5G / 13R Pro
|gold
|2023/9/21
|-
|红米Note13 Pro 5G / Pro+ 5G
|zircon
|2023/9/21
|-
|红米平板SE
|xun
|2023/8/15
|-
|小米MIX Fold 3
|babylon
|2023/8/14
|-
|红米K60 至尊版 / 小米13T Pro
|corot
|2023/8/14
|-
|小米平板6 Max
|yudi
|2023/8/14
|-
|POCO M6 Pro 4G
|emerald
|2023/8/5
|-
|红米Note12R / POCO M6 Pro 5G / 红米12 5G
|sky
|2023/6/23
|-
|红米12
|fire
|2023/6/3
|-
|红米Note12T Pro
|pearl
|2023/5/29
|-
|小米CIVI3
|yuechu
|2023/5/25
|-
|红米Note12S
|sea
|2023/4/26
|-
|小米13 Ultra
|ishtar
|2023/4/18
|-
|小米平板6 Pro
|liuqin
|2023/4/18
|-
|小米平板6
|pipa
|2023/4/18
|-
|红米Note12 Pro 4G
|sweet_k6a
|2023/4/11
|-
|红米Note12 4G NFC
|topaz
|2023/3/30
|-
|红米Note12 4G
|tapas
|2023/3/30
|-
|红米Note12 Turbo / POCO F5 5G
|marble
|2023/3/28
|-
|POCO C51 / 红米A2 / A2+
|water
|2023/3/24
|-
|红米12C / POCO C55
|earth
|2022/12/31
|-
|红米Note12 Pro 极速版 / POCO X5 Pro 5G
|redwood
|2022/12/27
|-
|红米K60E
|rembrandt
|2022/12/27
|-
|红米K60 Pro
|socrates
|2022/12/27
|-
|红米K60 / POCO F5 Pro
|mondrian
|2022/12/27
|-
|小米13 Pro
|nuwa
|2022/12/12
|-
|小米13
|fuxi
|2022/12/12
|-
|POCO X5 5G
|moonstone
|2022/11/20
|-
|红米Note12 5G / 红米Note12R Pro
|sunstone
|2022/10/27
|-
|红米Note12 Pro
|ruby
|2022/10/27
|-
|小米12T
|plato
|2022/10/4
|-
|红米平板
|yunluo
|2022/10/4
|-
|小米CIVI 2 / 小米13 Lite
|ziyi
|2022/9/27
|-
|POCO C50 / 红米A1
|ice
|2022/9/15
|-
|POCO M5S
|rosemary_p
|2022/9/5
|-
|POCO M5 / 红米11 Prime 4G
|rock
|2022/9/5
|-
|小米平板5 Pro 12.4
|dagu
|2022/8/11
|-
|红米K50 至尊版 / 小米12T Pro
|diting
|2022/8/11
|-
|小米MIX Fold 2
|zizhan
|2022/8/11
|-
|小米12S
|mayfly
|2022/7/4
|-
|小米12S Ultra
|thor
|2022/7/4
|-
|小米12S Pro
|unicorn
|2022/7/4
|-
|小米12 Pro 天玑版
|daumier
|2022/7/4
|-
|小米12 Lite
|taoyao
|2022/7/4
|-
|POCO C40
|frost
|2022/6/17
|-
|红米Note11T Pro / Pro+ / POCO X4 GT / Pro / 红米K50i / Pro
|xaga
|2022/5/24
|-
|小米CIVI 1S
|zijin
|2022/4/21
|-
|红米Note 10T
|lilac
|2022/4/14
|-
|红米10A
|dandelion
|2022/3/29
|-
|红米10C
|fog
|2022/3/17
|-
|红米K50
|rubens
|2022/3/17
|-
|红米K50 Pro
|matisse
|2022/3/17
|-
|红米K40S / POCO F4
|munch
|2022/3/17
|-
|红米Note11 Pro
|viva
|2022/3/7
|-
|红米Note11R
|lightcm
|2022/3/7
|-
|红米Note11E / POCO M4 5G / 红米10 Prime+ 5G
|light
|2022/3/7
|-
|红米K50 电竞版 / POCO F4 GT
|ingres
|2022/2/16
|-
|红米Note11 NFC
|spesn
|2022/2/7
|-
|红米Note11
|spes
|2022/2/7
|-
|红米Note11E Pro / 红米Note11 Pro 5G
|veux
|2022/1/26
|-
|红米Note 11S 5G
|opal
|2022/1/26
|-
|红米Note 11S / POCO M4 Pro 4G
|fleur
|2022/1/26
|-
|小米12 Pro
|zeus
|2021/12/28
|-
|小米12X
|psyche
|2021/12/28
|-
|小米12
|cupid
|2021/12/28
|-
|POCO M4 Pro 5G
|evergreen
|2021/11/9
|-
|红米Note11 Pro / Pro+
|pissarro
|2021/10/28
|-
|红米Note11 5G
|evergo
|2021/10/28
|-
|红米Note11 4G
|selenes
|2021/10/28
|-
|小米CIVI
|mona
|2021/9/27
|-
|小米11青春活力版
|lisa
|2021/9/15
|-
|小米11T
|agate
|2021/9/15
|-
|小米11T Pro
|vili
|2021/9/15
|-
|红米10
|selene
|2021/8/19
|-
|小米MIX4
|odin
|2021/8/10
|-
|小米平板5 Pro (WiFi)
|elish
|2021/8/10
|-
|小米平板5 Pro (5G)
|enuma
|2021/8/10
|-
|小米平板5
|nabu
|2021/8/10
|-
|红米Note 10 Pro (China) / POCO X3 GT
|chopin
|2021/5/26
|-
|红米Note 10 (China) / POCO M3 Pro / 红米Note 11 SE
|camellia
|2021/5/26
|-
|红米Note 8 (21年款)
|biloba
|2021/5/24
|-
|红米K40 游戏增强版 / POCO F3 GT
|ares
|2021/4/27
|-
|小米MIX Fold
|cetus
|2021/3/29
|-
|小米11 青春版
|renoir
|2021/3/29
|-
|小米11 Pro / Ultra
|star
|2021/3/29
|-
|小米11 Lite
|courbet
|2021/3/29
|-
|POCO X3 Pro
|vayu
|2021/3/22
|-
|小米10S
|thyme
|2021/3/10
|-
|红米Note 10 Pro
|sweet
|2021/3/4
|-
|红米Note 10 5G
|camellian
|2021/3/4
|-
|红米Note 10S
|rosemary
|2021/3/4
|-
|红米Note 10
|mojito
|2021/3/4
|-
|红米K40 Pro / Pro+ / 小米11i / 小米11X Pro
|haydn
|2021/2/25
|-
|红米K40 / POCO F3
|alioth
|2021/2/25
|-
|小米11
|venus
|2020/12/28
|-
|红米Note 9T 5G
|cannong
|2020/12/1
|-
|红米Note 9 Pro 5G / 小米10T Lite
|gauguin
|2020/11/26
|-
|红米Note 9 5G
|cannon
|2020/11/26
|-
|红米Note 9 4G / 红米9T
|lime
|2020/11/26
|-
|POCO M3
|citrus
|2020/11/24
|-
|红米K30S 至尊纪念版 / 小米10T / 10T Pro
|apollo
|2020/10/27
|-
|POCO C3
|angelicain
|2020/10/6
|-
|POCO M2
|shiva
|2020/9/8
|-
|POCO X3 NFC
|surya
|2020/9/7
|-
|红米9C NFC
|angelican
|2020/8/31
|-
|红米9 (India)
|cattail
|2020/8/27
|-
|小米10 至尊纪念版
|cas
|2020/8/11
|-
|红米K30 至尊纪念版
|cezanne
|2020/8/11
|-
|POCO M2 Pro
|gram
|2020/7/7
|-
|红米9A / 9AT
|dandelion
|2020/6/30
|-
|红米9C
|angelica
|2020/6/30
|-
|红米9
|lancelot
|2020/6/15
|-
|小米Note10 Lite
|toco
|2020/5/30
|-
|红米10X Pro
|bomb
|2020/5/26
|-
|红米10X 5G
|atom
|2020/5/26
|-
|红米K30i 5G
|picasso_48m
|2020/5/26
|-
|红米10X 4G / 红米Note 9
|merlin
|2020/4/30
|-
|小米10 青春版
|vangogh
|2020/4/27
|-
|小米10 Lite
|monet
|2020/3/27
|-
|红米K30 Pro / 变焦版 / POCO F2 Pro
|lmi
|2020/3/24
|-
|红米Note 9 Pro Max
|excalibur
|2020/3/12
|-
|红米Note 9S / Pro (India)
|curtana
|2020/3/12
|-
|红米Note9 Pro
|joyeuse
|2020/3/12
|-
|小米10 Pro
|cmi
|2020/2/13
|-
|小米10
|umi
|2020/2/13
|-
|红米8A Pro / 红米8A Dual
|olivewood
|2020/2/11
|-
|POCO X2 印度版
|phoenixin
|2020/2/4
|-
|红米K30 5G
|picasso
|2019/12/10
|-
|红米K30 4G / POCO X2
|phoenix
|2019/12/10
|-
|红米Note 8T
|willow
|2019/11/6
|-
|小米CC9 Pro / 小米Note 10
|tucana
|2019/11/6
|-
|红米Note 8 Pro 印度版
|begoniain
|2019/10/21
|-
|红米8
|olive
|2019/10/9
|-
|红米8A
|olivelite
|2019/9/25
|-
|小米9 Pro 5G
|crux
|2019/9/24
|-
|红米K20 Pro 尊享版
|raphaels
|2019/9/19
|-
|红米Note 8 Pro
|begonia
|2019/8/29
|-
|红米Note 8
|ginkgo
|2019/8/29
|-
|小米A3
|laurel
|2019/7/17
|-
|小米CC9e
|laurus
|2019/7/2
|-
|小米CC9 / 小米9 Lite
|pyxis
|2019/7/2
|-
|小米CC9 美图定制版
|vela
|2019/7/2
|-
|红米K20 / 小米9T 印度版
|davinciin
|2019/6/12
|-
|红米K20 / 小米9T
|davinci
|2019/5/28
|-
|红米K20 Pro / 小米9T Pro
|raphael
|2019/5/28
|-
|红米K20 Pro 印度版
|raphaelin
|2019/5/28
|-
|红米7A
|pine
|2019/5/22
|-
|红米Y3
|onc
|2019/4/24
|-
|红米7
|onclite
|2019/3/18
|-
|小米MIX 3 5G
|andromeda
|2019/2/24
|-
|小米9
|cepheus
|2019/2/20
|-
|小米9 SE
|grus
|2019/2/20
|-
|红米Go
|tiare
|2019/1/29
|-
|红米Note 7
|lavender
|2019/1/10
|-
|红米Note 7 Pro
|violet
|2019/1/10
|-
|小米Play
|lotus
|2018/12/24
|-
|红米Note 6 Pro
|tulip
|2018/11/22
|-
|小米MIX 3
|perseus
|2018/10/25
|-
|小米8 Lite
|platina
|2018/9/19
|-
|红米6 Pro
|sakura
|2018/9/5
|-
|POCO F1
|beryllium
|2018/8/22
|-
|小米平板4/Plus
|clover
|2018/8/14
|-
|小米A2 Lite
|daisy
|2018/7/24
|-
|小米A2
|jasmine
|2018/7/24
|-
|小米Max 3
|nitrogen
|2018/7/19
|-
|红米6A
|cactus
|2018/6/12
|-
|红米6
|cereus
|2018/6/12
|-
|小米8
|dipper
|2018/5/31
|-
|小米8 Pro 屏幕指纹版
|equuleus
|2018/5/31
|-
|小米8 SE
|sirius
|2018/5/31
|-
|小米8 透明探索版
|ursa
|2018/5/31
|-
|红米S2 / 红米Y2
|ysl
|2018/5/10
|-
|小米6X
|wayne
|2018/4/25
|-
|小米MIX 2S
|polaris
|2018/3/27
|-
|红米Note 5 / Pro
|whyred
|2018/2/14
|-
|红米5
|rosy
|2017/12/7
|-
|红米5 Plus
|vince
|2017/12/7
|-
|红米5A
|riva
|2017/10/20
|-
|小米MIX 2
|chiron
|2017/9/11
|-
|小米Note 3
|jason
|2017/9/11
|-
|小米A1
|tissot
|2017/9/5
|-
|红米Note 5A 高配版
|ugg
|2017/8/21
|-
|红米Note 5A 标准版
|ugglite
|2017/8/21
|-
|小米5X
|tiffany
|2017/7/26
|-
|小米Max 2
|oxygen
|2017/5/25
|-
|小米6
|sagit
|2017/4/19
|-
|小米平板3
|cappu
|2017/4/6
|-
|小米5C
|meri
|2017/2/28
|-
|红米4X
|santoni
|2017/2/28
|-
|红米Note 4X 高通版
|mido
|2017/1/19
|-
|红米Note 4 联发科版
|nikel
|2017/1/19
|-
|红米4 高配版
|markw
|2016/11/4
|-
|红米4 标准版
|prada
|2016/11/4
|-
|红米4A
|rolex
|2016/11/4
|-
|小米MIX
|lithium
|2016/10/25
|-
|小米Note 2
|scorpio
|2016/10/25
|-
|小米5S
|capricorn
|2016/9/27
|-
|小米5S Plus
|natrium
|2016/9/27
|-
|红米Pro
|omega
|2016/7/27
|-
|红米3S
|land
|2016/6/15
|-
|小米Max 高配版
|helium
|2016/6/1
|-
|小米Max 标准版
|hydrogen
|2016/5/10
|-
|小米4S
|aqua
|2016/2/24
|-
|小米5
|gemini
|2016/2/24
|-
|红米3 / Pro
|ido
|2016/1/10
|-
|红米Note 3 台湾特别版
|kate
|2015/11/25
|-
|红米Note 3 全网通版
|kenzo
|2015/11/25
|-
|红米Note 3 双网通版
|hennessy
|2015/11/24
|-
|小米平板2
|latte
|2015/11/24
|-
|小米4C
|libra
|2015/9/22
|-
|红米Note 2
|hermes
|2015/8/13
|-
|小米4i
|ferrari
|2015/4/23
|-
|红米2A 标准版
|lte26007
|2015/3/1
|-
|小米Note 顶配版
|leo
|2015/1/15
|-
|小米Note 双网通 / 全网通
|virgo
|2015/1/15
|-
|红米手机2 增强版
|wt86047
|2015/1/4
|-
|红米手机2
|wt88047
|2015/1/4
|-
|红米Note 4G单卡版
|dior
|2014/8/12
|-
|红米Note 4G双卡版
|gucci
|2014/8/12
|-
|小米3 / 小米4
|cancro
|2014/7/22
|-
|红米手机1S
|armani
|2014/7/16
|-
|红米手机1S 移动3G版
|HM2014011
|2014/7/16
|-
|红米手机1S 移动4G版
|HM2014501
|2014/7/16
|-
|小米平板1
|mocha
|2014/5/15
|-
|红米Note
|lcsh92
|2014/3/20
|-
|小米2A
|taurus
|2013/10/24
|-
|小米3 移动版
|pisces
|2013/9/5
|-
|红米手机
|HM2013023
|2013/7/12
|-
|小米2S
|aries
|2013/6/17
|-
|小米1S
|mione
|2012/8/23
|}

=== Nothing Phone ===
{| class="wikitable"
|+
!机型设备
!机型型号
!机型代号
!发布时间
|-
|Nothing Phone (2)
|A065/AIN065(India)
|Pong
|2023/07/12
|-
|Nothing Phone (1)
|A603
|Spacewar
|2022/7/12
|}

=== 一加 ===
{| class="wikitable"
|+
!机型设备
!机型代号
!发布时间
|-
|一加 7T Pro 5G
|hotdogg
|2019/11/05
|-
|一加 7T Pro
|hotdog
|2019/10/15
|-
|一加 7T
|hotdogb
|2019/10/15
|-
|一加 7 Pro
|guacamole
|2019/05/16
|-
|一加 7
|guacamoleb
|2019/05/16
|-
|}

Windows on arm

2024-02-17T12:49:55Z

Sunflower2333：

= 简介 =
Windows on ARM，也被称为Windows 10 on ARM，是微软公司为基于ARM架构的处理器开发的Windows 10操作系统的一个版本。该版本旨在将Windows 10引入到更多类型的设备上，特别是那些采用ARM处理器的移动设备和平板电脑。
=开源项目=

* [[WOA-Project]]

* [[Renegade project|Renegade Project]]

* [[woa-msmnile]]

* [[Mu-Qcom]]

=发展历程=
Windows on arm的前身是[[Windows RT]]，它是微软在2012年推出的一种专为ARM32平台设计的操作系统，但由于软件兼容性和性能问题，没有获得市场的认可。微软并没有放弃这一领域的探索，而是与高通展开了长期的合作。

从2016年开始，陆续推出了基于骁龙835、850、8CX等不同平台的Windows on arm设备，如Surface Pro X等。

到2020年底，微软还发布了Windows 10 21H2的测试版，首次为ARM设备加入了64位x86应用的兼容能力，这意味着Windows on arm可以运行更多的专业软件和游戏，进一步提升了用户体验。Windows on arm的发展历程，可以说是一次从失败到成功的逆袭，也是一次从尝试到创新的突破，它展示了微软对于ARM生态的坚持和信心，也为PC行业的转型和未来的发展带来了新的可能性。

Mu-Qcom

2024-02-17T12:49:41Z

Sunflower2333：创建页面，内容为“[https://github.com/Robotix22/Mu-Qcom Mu-Qcom]是基于SurfaceDuoPkg二次开发的通用库，适用于更多高通平台，其与edk2msm结构更加相似，也吸引了不少开发者参与移植。”

[https://github.com/Robotix22/Mu-Qcom Mu-Qcom]是基于SurfaceDuoPkg二次开发的通用库，适用于更多高通平台，其与edk2msm结构更加相似，也吸引了不少开发者参与移植。

WOA-Project

2024-02-17T12:45:28Z

Sunflower2333：创建页面，内容为“[https://github.com/WOA-Project/ WOA-Project]是手机运行WOA的先驱，其中LumiaWOA 和 DuoWOA 广为人知。”

[https://github.com/WOA-Project/ WOA-Project]是手机运行WOA的先驱，其中LumiaWOA 和 DuoWOA 广为人知。

Project-Aloha

2024-02-17T12:34:12Z

Sunflower2333：

'''WOA-msmnile 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。'''

WoA msmnile项目内仓库主要基于WOA Project的DuoWoA项目进行二次通用开发。

<u>主要仓库</u>：

* [https://github.com/woa-msmnile/msmnilePkg msmnilePkg]: 基于[https://github.com/WOA-Project/SurfaceDuoPkg SurfaceDuoPkg]二次开发的 UEFI仓库，目前支持Sm7125, Sm7325, Sm8150, Sm8550启动Windows。
* [https://github.com/woa-msmnile/msmnile-drivers msmnile-Drivers]: [https://github.com/WOA-Project/SurfaceDuo-Drivers SurfaceDuo-Drivers]的Fork，主要提供了适用于Sm8150的平台通用驱动。
* [DevcieCodename]: 基于SurfaceDuo-Drivers的设备特殊驱动。
* [https://github.com/woa-msmnile/Kodiak-Drivers Kodiak-Drivers]: 整理来自Windows Updater的7c Gen3驱动合集，适用于Sm7325。
* [https://github.com/woa-msmnile/Atoll-Drivers Atoll-Drivers]: 整理来自Windows Updater的7c Gen2 驱动合集，适用于Sm7125。
* [DriverName]: 存放触摸、功放等的开放源代码驱动。
* [https://github.com/woa-msmnile/woa-msmnile.github.io woa-msmnile.github.io]: woa-msmnile 静态文档网站，托管在github page。

<u>主要条款:</u>

<u>[https://github.com/woa-msmnile/msmnilePkg/blob/main/LICENSE UEFI库条款]</u>

<u>[https://github.com/woa-msmnile/msmnile-Drivers/blob/main/LICENSE.md 驱动库条款]</u>

<u>联系我们</u>：

* QQ 群: [https://qm.qq.com/cgi-bin/qm/qr?k=r2Gb_eHElZq0T7Rczf4rnEMsMdX6gbvF&jump_from=webapi&authKey=L4/pvGXcxQQddJpzUoa3qEh6P4n/fbF88oPKuPh4L0EFIEj5cY1k06i2w78gA5m5 woa-msmnile 问题与建议]
* 电报群: [https://t.me/woa_msmnile_issues woa-msmnile issues & advice]
* Discord: [https://discord.gg/zfh6RxYwb5 woa-msmnile uefi porting]

<u>关于Gus</u>

Gustave Monce是计算机博士，是杰出的WOA开发者(WOA Project成员)，也是我们最好的老师。

8150 woa的发展离不开Gus，平台适配都是Gus做的。

需要注意的是，Gus会告诉你怎么做，但是不会帮你做。如果你遇到Gustave Monce，请尊重Gus，并且不要要求他帮你做任何非SurfaceDuo系列设备的woa适配，且不要询问任何与SDPkg无关的项目。

你可以在[https://github.com/sponsors/gus33000 这里赞助]Gus，感谢你的慷慨。

<u>关于其他同类仓库:</u>

本项目组与edk2-msm仓库, edk2-porting组织以及MU-Qcom没有任何关联。

故如果您在移植他们的过程中遇到问题，请勿打扰本项目开发者。

<u>关于为何从edk2-porting独立:</u>

MU-sm8150pkg(现称msmnilePkg，以下简称8150pkg)最初由sunflower2333(以下简称sflr)在高三之余基于SurfaceDuo1Pkg做的Sm8150平台通用版本Uefi仓库，并对多款设备添加基本支持(启动完整Windows + Usb可用), 移植过程中也不乏海外友人的贡献。

edk2-porting(renegade project, 以下简称rp) 项目组fork了这个仓库，并且一直不同步上游更新, 鉴于当时rp正处于流量高点，许多人都认为此仓库才是上游仓库，这使得很多人找到sflr询问何时修复bug, 但是实际上bug在上游已经修复。由于sflr对rp项目中的8150pkg无写权限，故sflr向rp的8150pkg提交sync fork的pull request，rp开发者在一个多月后同意 pull request请求。

sflr 在这期间在rp群组中多次提醒rp的'''owner'''(sophon/strongtz/wxl/sakuramist, 以下简称wxl) 同意pull request, 均被wxl忽视, 且私信相关问题无法得到回应。为了确定wxl QQ在线且有空，sflr多次关顾其在bilibili直播，发现其与Molly等人均保持联系，且在QQ群中刻意忽视sflr的@等提醒。

不久后，sflr因言论过于讽刺而被移出群聊。

其后受到调解，且sflr忙于学业，将8150pkg从个人转移到rp组织维护，并在之后的一段时间内暂停维护。

在开学三个月后，sflr开始处理12GB设备Crash问题和其他问题。不久后，wxl在电报(以下简称tg)中联系sflr, 要求将8150pkg转回sflr个人账户下，理由如下:

# edk2-sdm845升级了，现在支持sm8150，8150pkg与edk2msm功能重合，导致产生了误导。
# wxl不喜欢mu
# sflr被移出所有rp群聊后，不处理用户问题
# wxl认为sflr只参与8150pkg开发，不参与其他rp项目
# wxl认为sflr筛选了想要问他问题的人
# wxl认为8150pkg是sflr一个人的东西，只有他一个人在参与开发

作为回应sflr给出的解释有：

# sm8150pkg是许多人一起参与开发的。
# sflr在github主页留有邮箱，且只通过b站发布个人进度，时常有国内/外友人问问题，且积极回复，对于用户完全可以发邮件或者仓库提issue。
# 8150pkg早于edk2-sdm845升级之前，新的edk2msm属于重复造轮子，且新的edk2msm使用了部分来自8150pkg的源码(sflr后来发现的，其未标注Copyright信息)，且8150pkg支持更多设备。
# sflr认为edk2-sdm845因历史遗留问题，编译过程问题一堆，仓库存储占用较大，且兼容性堪忧，目录结构不如SDPkg简洁，不应再适合添加其他平台支持。

sflr妥协，消息传入其他rp成员后引发反响，wxl做长文批ww和sflr且挂于官网，sflr和ww退出rp。不久后，在sflr考量和询问其他开发者意见之后决定开设新组织存放sm8150相关仓库，并邀请之前的开发者进入一同开发。

自此woa-msmnile与rp分道扬镳。

ww与wxl的不合，是因为ww自费购买了一些资料，并与部分rp成员分享帮助开发，wxl未经允许在discord等平台进行二次分发，wxl和ww闹翻。ww后来将其称之为“新一代网络强盗”。

<u>关于sm8150 woa：</u>

ww, lemon ice, slfr以及其他贡献者是最初研究sm8150 woa的人。

ww最先基于imbushuo的pkg给f11(k20pro)移植了edk2，sflr给edk2增加了更多的设备支持，lemon ice最先在op7tp上修好了usb。

起初公开的edk2-sm8150是sflr基于f11pkg改的，后来因为pep无法工作且因sflr的patch无果而止步。

后来Gustave Monce(国外知名woa大佬) 给SurfaceDuo1移植了基于projectMU的UEFI，对8180的pep和其他驱动进行大量补丁，基于8180的acpi进行逆向修改适配，最终pep成功在8150平台跑通，给8150带来了新的曙光。

sflr之前对projectmu就比较感兴趣，出于学习的目的尝试研究SDPkg并且移植给其他设备，即后来的mu-sm8150pkg。Ice在后来不知所踪，ww参与了几个工程设备的woa适配，slfr跟着Gus学习相关知识，并且给一些设备适配DSDT表和驱动。

8150pkg并入rp

edk2msm支持8150

8150pkg被移出rp

8150pkg移入woa-msmnile

MU-Qcom出现

8150pkg在投票后改名msmnilePkg

Project-Aloha

2024-02-17T12:32:18Z

Sunflower2333：

'''WOA-msmnile 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。'''

WoA msmnile项目内仓库主要基于WOA Project的DuoWoA项目进行二次通用开发。

<u>主要仓库</u>：

* [https://github.com/woa-msmnile/msmnilePkg msmnilePkg]: 基于[https://github.com/WOA-Project/SurfaceDuoPkg SurfaceDuoPkg]二次开发的 UEFI仓库，目前支持Sm7125, Sm7325, Sm8150, Sm8550启动Windows。
* [https://github.com/woa-msmnile/msmnile-drivers msmnile-Drivers]: [https://github.com/WOA-Project/SurfaceDuo-Drivers SurfaceDuo-Drivers]的Fork，主要提供了适用于Sm8150的平台通用驱动。
* [DevcieCodename]: 基于SurfaceDuo-Drivers的设备特殊驱动。
* [https://github.com/woa-msmnile/Kodiak-Drivers Kodiak-Drivers]: 整理来自Windows Updater的7c Gen3驱动合集，适用于Sm7325。
* [https://github.com/woa-msmnile/Atoll-Drivers Atoll-Drivers]: 整理来自Windows Updater的7c Gen2 驱动合集，适用于Sm7125。
* [DriverName]: 存放触摸、功放等的开放源代码驱动。
* [https://github.com/woa-msmnile/woa-msmnile.github.io woa-msmnile.github.io]: woa-msmnile 静态文档网站，托管在github page。

<u>主要条款:</u>

<u>[https://github.com/woa-msmnile/msmnilePkg/blob/main/LICENSE UEFI库条款]</u>

<u>[https://github.com/woa-msmnile/msmnile-Drivers/blob/main/LICENSE.md 驱动库条款]</u>

<u>联系我们</u>：

* QQ 群: [https://qm.qq.com/cgi-bin/qm/qr?k=r2Gb_eHElZq0T7Rczf4rnEMsMdX6gbvF&jump_from=webapi&authKey=L4/pvGXcxQQddJpzUoa3qEh6P4n/fbF88oPKuPh4L0EFIEj5cY1k06i2w78gA5m5 woa-msmnile 问题与建议]
* 电报群: [https://t.me/woa_msmnile_issues woa-msmnile issues & advice]
* Discord: [https://discord.gg/zfh6RxYwb5 woa-msmnile uefi porting]

<u>关于Gus</u>

Gustave Monce是计算机博士，是杰出的WOA开发者(WOA Project成员)，也是我们最好的老师。

8150 woa的发展离不开Gus，平台适配都是Gus做的。

需要注意的是，Gus会告诉你怎么做，但是不会帮你做。如果你遇到Gustave Monce，请尊重Gus，并且不要要求他帮你做任何非SurfaceDuo系列设备的woa适配，且不要询问任何与SDPkg无关的项目。

你可以在[https://github.com/sponsors/gus33000 这里赞助]Gus，感谢你的慷慨。

<u>关于其他同类仓库:</u>

本项目组与edk2-msm仓库, edk2-porting组织以及MU-Qcom没有任何关联。

故如果您在移植他们的过程中遇到问题，请勿打扰本项目开发者。

<u>关于为何从edk2-porting独立:</u>

MU-sm8150pkg(现称msmnilePkg，以下简称8150pkg)最初由sunflower2333(以下简称sflr)在高三之余基于SurfaceDuo1Pkg做的Sm8150平台通用版本Uefi仓库，并对多款设备添加基本支持(启动完整Windows + Usb可用), 移植过程中也不乏海外友人的贡献。

edk2-porting(renegade project, 以下简称rp) 项目组fork了这个仓库，并且一直不同步上游更新, 鉴于当时rp正处于流量高点，许多人都认为此仓库才是上游仓库，这使得很多人找到sflr询问何时修复bug, 但是实际上bug在上游已经修复。由于sflr对rp项目中的8150pkg无写权限，故sflr向rp的8150pkg提交sync fork的pull request，rp开发者在一个多月后同意 pull request请求。

sflr 在这期间在rp群组中多次提醒rp的'''owner'''(sophon/strongtz/wxl/sakuramist, 以下简称wxl) 同意pull request, 均被wxl忽视, 且私信相关问题无法得到回应。为了确定wxl QQ在线且有空，sflr多次关顾其在bilibili直播，发现其与Molly等人均保持联系，且在QQ群中刻意忽视sflr的@等提醒。

不久后，sflr因言论过于讽刺而被移出群聊。

其后受到调解，且sflr忙于学业，将8150pkg从个人转移到rp组织维护，并在之后的一段时间内暂停维护。

在开学三个月后，sflr开始处理12GB设备Crash问题和其他问题。不久后，wxl在电报(以下简称tg)中联系sflr, 要求将8150pkg转回sflr个人账户下，理由如下:

# edk2-sdm845升级了，现在支持sm8150，8150pkg与edk2msm功能重合，导致产生了误导。
# wxl不喜欢mu
# sflr被移出所有rp群聊后，不处理用户问题
# wxl认为sflr只参与8150pkg开发，不参与其他rp项目
# wxl认为sflr筛选了想要问他问题的人
# wxl认为8150pkg是sflr一个人的东西，只有他一个人在参与开发

作为回应sflr给出的解释有：

# sm8150pkg是许多人一起参与开发的。
# sflr在github主页留有邮箱，且只通过b站发布个人进度，时常有国内/外友人问问题，且积极回复，对于用户完全可以发邮件或者仓库提issue。
# 8150pkg早于edk2-sdm845升级之前，新的edk2msm属于重复造轮子，且新的edk2msm使用了部分来自8150pkg的源码(sflr后来发现的，其未标注Copyright信息)，且8150pkg支持更多设备。
# sflr认为edk2-sdm845因历史遗留问题，编译过程问题一堆，仓库存储占用较大，且兼容性堪忧，目录结构不如SDPkg简洁，不应再适合添加其他平台支持。

sflr妥协，消息传入其他rp成员后引发反响，wxl做长文批ww和sflr且挂于官网，sflr和ww退出rp。不久后，在sflr考量和询问其他开发者意见之后决定开设新组织存放sm8150相关仓库，并邀请之前的开发者进入一同开发。

自此woa-msmnile与rp分道扬镳。

ww与wxl的不合，是因为ww自费购买了一些资料，并与部分rp成员分享帮助开发，wxl未经允许在discord等平台进行二次分发，wxl和ww闹翻。ww后来将其称之为“新一代网络强盗”。

<u>关于sm8150 woa：</u>

ww, lemon ice, slfr以及其他贡献者是最初研究sm8150 woa的人。

ww最先基于imbushuo的pkg给f11(k20pro)移植了edk2，sflr给edk2增加了更多的设备支持，lemon ice最先在op7tp上修好了usb。

起初公开的edk2-sm8150是sflr基于f11pkg改的，后来因为pep无法工作且因sflr的patch无果而止步。

后来Gustave Monce(国外知名woa大佬) 给SurfaceDuo1移植了基于projectMU的UEFI，对8180的pep和其他驱动进行大量补丁，基于8180的acpi进行逆向修改适配，最终pep成功在8150平台跑通，给8150带来了新的曙光。

sflr之前对projectmu就比较感兴趣，出于学习的目的尝试研究SDPkg并且移植给其他设备，即后来的mu-sm8150pkg。Ice在后来不知所踪，ww参与了几个工程设备的woa适配，slfr跟着Gus学习相关知识，并且给一些设备适配DSDT表和驱动。

8150pkg并入rp

8150pkg被移出rp

8150pkg移入woa-msmnile

8150pkg在投票后改名msmnilePkg

Project-Aloha

2024-02-15T08:42:49Z

Sunflower2333：添加woa msmnile简介

'''WOA-msmnile 是由一群致力于推动WOA在搭载Sm8150及后续芯片的设备上发展的人们组建的组织。'''

WoA msmnile项目内仓库主要基于WOA Project的DuoWoA项目进行二次通用开发。

<u>主要仓库</u>：

* [https://github.com/woa-msmnile/msmnilePkg msmnilePkg]: 基于[https://github.com/WOA-Project/SurfaceDuoPkg SurfaceDuoPkg]二次开发的 UEFI仓库，目前支持Sm7125, Sm7325, Sm8150, Sm8550启动Windows。
* [https://github.com/woa-msmnile/msmnile-drivers msmnile-Drivers]: [https://github.com/WOA-Project/SurfaceDuo-Drivers SurfaceDuo-Drivers]的Fork，主要提供了适用于Sm8150的平台通用驱动。
* [DevcieCodename]: 基于SurfaceDuo-Drivers的设备特殊驱动。
* [https://github.com/woa-msmnile/Kodiak-Drivers Kodiak-Drivers]: 整理来自Windows Updater的7c Gen3驱动合集，适用于Sm7325。
* [https://github.com/woa-msmnile/Atoll-Drivers Atoll-Drivers]: 整理来自Windows Updater的7c Gen2 驱动合集，适用于Sm7125。
* [DriverName]: 存放触摸、功放等的开放源代码驱动。
* [https://github.com/woa-msmnile/woa-msmnile.github.io woa-msmnile.github.io]: woa-msmnile 静态文档网站，托管在github page。

<u>主要条款:</u>

<u>[https://github.com/woa-msmnile/msmnilePkg/blob/main/LICENSE UEFI库条款]</u>

<u>[https://github.com/woa-msmnile/msmnile-Drivers/blob/main/LICENSE.md 驱动库条款]</u>

<u>联系我们</u>：

* QQ 群: [https://qm.qq.com/cgi-bin/qm/qr?k=r2Gb_eHElZq0T7Rczf4rnEMsMdX6gbvF&jump_from=webapi&authKey=L4/pvGXcxQQddJpzUoa3qEh6P4n/fbF88oPKuPh4L0EFIEj5cY1k06i2w78gA5m5 woa-msmnile 问题与建议]
* 电报群: [https://t.me/woa_msmnile_issues woa-msmnile issues & advice]
* Discord: [https://discord.gg/zfh6RxYwb5 woa-msmnile uefi porting]

<u>关于Gus</u>

Gustave Monce是计算机博士，是杰出的WOA开发者(WOA Project成员)，也是我们最好的老师。

8150 woa的发展离不开Gus，平台适配都是Gus做的。

需要注意的是，Gus会告诉你怎么做，但是不会帮你做。如果你遇到Gustave Monce，请尊重Gus，并且不要要求他帮你做任何非SurfaceDuo系列设备的woa适配，且不要询问任何与SDPkg无关的项目。

你可以在[https://github.com/sponsors/gus33000 这里赞助]Gus，感谢你的慷慨。

<u>关于其他同类仓库:</u>

本项目组与edk2-msm仓库, edk2-porting组织以及MU-Qcom没有任何关联。

故如果您在移植他们的过程中遇到问题，请勿打扰本项目开发者。

<u>关于为何从edk2-porting独立:</u>

MU-sm8150pkg(现称msmnilePkg，以下简称8150pkg)最初由sunflower2333(以下简称sflr)在高三之余基于SurfaceDuo1Pkg做的Sm8150平台通用版本Uefi仓库，并对多款设备添加基本支持(启动完整Windows + Usb可用), 移植过程中也不乏海外友人的贡献。

edk2-porting(renegade project, 以下简称rp) 项目组fork了这个仓库，并且一直不同步上游更新, 鉴于当时rp正处于流量高点，许多人都认为此仓库才是上游仓库，这使得很多人找到sflr询问何时修复bug, 但是实际上bug在上游已经修复。由于sflr对rp项目中的8150pkg无写权限，故sflr向rp的8150pkg提交sync fork的pull request，rp开发者在一个多月后同意 pull request请求。

sflr 在这三个月期间在rp群组中多次提醒rp的'''owner'''(sophon/strongtz/wxl/sakuramist, 以下简称wxl) 同意pull request, 均被wxl忽视, 且私信相关问题无法得到回应。为了确定wxl QQ在线且有空，sflr多次关顾其在bilibili直播，发现其与Molly等人均保持联系，且在QQ群中刻意忽视sflr的@等提醒。

不久后，sflr因言论过于讽刺而被移出群聊。

其后受到调解，且sflr忙于学业，将8150pkg从个人转移到rp组织维护，并在之后的一段时间内暂停维护。

在开学三个月后，sflr开始处理12GB设备Crash问题和其他问题。不久后，wxl在电报(以下简称tg)中联系sflr, 要求将8150pkg转回sflr个人账户下，理由如下:

# edk2-sdm845升级了，现在支持sm8150，8150pkg与edk2msm功能重合，导致产生了误导。
# wxl不喜欢mu
# sflr被移出所有rp群聊后，不处理用户问题
# wxl认为sflr只参与8150pkg开发，不参与其他rp项目
# wxl认为sflr筛选了想要问他问题的人
# wxl认为8150pkg是sflr一个人的东西，只有他一个人在参与开发

作为回应sflr给出的解释有：

# sm8150pkg是许多人一起参与开发的。
# sflr在github主页留有邮箱，且只通过b站发布个人进度，时常有国内/外友人问问题，且积极回复，对于用户完全可以发邮件或者仓库提issue。
# 8150pkg早于edk2-sdm845升级之前，新的edk2msm属于重复造轮子，且新的edk2msm使用了部分来自8150pkg的源码(sflr后来发现的，其未标注Copyright信息)，且8150pkg支持更多设备。
# sflr认为edk2-sdm845因历史遗留问题，编译过程问题一堆，仓库存储占用较大，且兼容性堪忧，目录结构不如SDPkg简洁，不应再适合添加其他平台支持。

sflr妥协，消息传入其他rp成员后引发反响，wxl做长文批ww和sflr且挂于官网，sflr和ww退出rp。不久后，在sflr考量和询问其他开发者意见之后决定开设新组织存放sm8150相关仓库，并邀请之前的开发者进入一同开发。

自此woa-msmnile与rp分道扬镳。

ww与wxl的不合，是因为ww自费购买了一些资料，并与部分rp成员分享帮助开发，wxl未经允许在discord等平台进行二次分发，wxl和ww闹翻。ww后来将其称之为“新一代网络强盗”。

<u>关于sm8150 woa：</u>

ww, lemon ice, slfr以及其他贡献者是最初研究sm8150 woa的人。

ww最先基于imbushuo的pkg给f11(k20pro)移植了edk2，sflr给edk2增加了更多的设备支持，lemon ice最先在op7tp上修好了usb。

起初公开的edk2-sm8150是sflr基于f11pkg改的，后来因为pep无法工作且因sflr的patch无果而止步。

后来Gustave Monce(国外知名woa大佬) 给SurfaceDuo1移植了基于projectMU的UEFI，对8180的pep和其他驱动进行大量补丁，基于8180的acpi进行逆向修改适配，最终pep成功在8150平台跑通，给8150带来了新的曙光。

sflr之前对projectmu就比较感兴趣，出于学习的目的尝试研究SDPkg并且移植给其他设备，即后来的mu-sm8150pkg。Ice在后来不知所踪，ww参与了几个工程设备的woa适配，slfr跟着Gus学习相关知识，并且给一些设备适配DSDT表和驱动。

8150pkg并入rp

8150pkg被移出rp

8150pkg移入woa-msmnile

8150pkg在投票后改名msmnilePkg