核心劫持点与 NPU 优化解构
由于通用的 Linux 内核 SDHCI 驱动（如 sdhci.c，sdhci-pci.c 等）采取了最保守的设计以谋求百余种主板控制器的兼容性，sdhci_zodiac_mmc 的作用便是将那些"慢且通用"的代码分支换成"快且专属"的高级硬件接口。
1. 劫持耗时的频率相位训练 (Hardware Tuning)
在通用 Linux SDHCI 流程中，当启动高速传输（比如读取 HS200 的 eMMC 或者 UHS-I SD 卡），系统往往需要执行一个极其烧负荷的软件循环 ------ 不停重调相频然后校验波形有没有错。
Zodiac 优化行动 ：该模块劫持了 sdhci_zodiac_platform_execute_tuning() 操作流点。抛弃通用的读写错误比较重发机制，一旦进入 Tuning，将任务触发标志发给底层后，NPU 内骨骸的 Auto Hardware Tuner (硬件自动相位分析引擎) 会即时接管。系统驱动只须轻松地轮询获取代表寻相成功的中断变量 SDHCI_CTRL_TUNED_CLK，最后凭借专有寄存器地址 TUNING_RESULT_VALUE_REG (0x88) 读取计算完的绝对相位，几乎消去了 CPU Wait I/O 排队耗时。
2. 时钟树侵入式整形 (Timing Subsystem & Clock Register Hijacking)
在进行高频模式的时分复用中，信号不能有一微秒的衰减与串扰。通用驱动最多只会发一两个命令改变总体倍频器。
Zodiac 优化行动 ：sdhci_zodiac_set_clock 劫持后：
- 利用外骨骼函数接口
hisi_subctrl_XXX去重设从L_CLK向H_CLK转变的源。 - 向四块专有寄存器位段（
0x80,0x90,0x94,0x98）强灌入一套经核心板硬件匹配校准并下发自设备树 (DTS) 的时序参数映射表 (timing_x_cfg)。 - 这些参数定义了极微观的值：例如延迟读取的时间（
clk_dly_sample与crc_st_det_dly）、推拉电平延迟等。这一操刀本质上是驱动程序变成了数字示波器的信号波形裁剪师。
3. 微秒级动态时钟防抖系统 (ICG, Internal Clock Gating)
大多系统掉盘死机都是源于切频带来的亚稳态毛刺逆传给总线系统。
为阻止此情况出现，sdhci_zodiac_icg_en 和 sdhci_zodiac_icg_dis 构成了严格的加锁系统。在改变 sdhci_zodiac_mmc 控制器时钟的任何一点，必定先执行 ICG 冻结锁定，切断 IP 单元与 NPU 通海数据互联的高速时钟，完成设频切换并在芯片级延迟 100us 稳定后，再给 ICG 单元解冻。
4. 针对 16 字节对齐总线引擎的强制拦截 (ADMA Override)
这是该代码中最不容易发现但是最关键的保命优化 之一（位于 sdhci_zodiac_set_desc_size）。
- Linux 内核由于照顾 64-bit 系统的历史包袱，通常默认 ADMA2 数据表头配置为
12字节(12 Bytes)。 - 然而，Ascend (Hisi 体系) 内存总线的 ADMA2 读取表地址抓取硬件是强硬要求按
16字节对齐 (16 Bytes)处理的。 - 驱动通过强推
host->alloc_desc_sz = 16打破了 Linux 原有结构的长度假设，从系统边界处修复了 64Bit 直接存取 eMMC 数据必将产生的页错误挂死。
5. eMMC 高速物理通道动态平衡 (Combo PHY)
当挂载的 eMMC 跑在 HS200 / HS400 等百兆赫兹边沿环境，热胀冷缩及线路漏电流都会成为拦路虎。 sdhci_phy_delay_measurement 引入了通过设备树拿到的 mmc_ddr52_tx_delay 各频率延边裕量值（Margin），配合 sdhci_combo_phy_init 重建传输通道物理层（PHY），抵消阻抗误差，动态补偿硬件信号。
结论汇总
sdhci_zodiac_mmc 绝非只是简单挂载了 eMMC 设备，而是深入了硬件底盘的极限压榨模块 。 在调试或后续拓展中，如果修改板子时钟引脚、遇上内核态读写 I/O 长时停滞不前、或者遇到了罕见的 eMMC ADMA2 溢出 Kernel Panic（内核恐慌），请首要从这个包含了 硬件排队与 Tuning 劫持特性的胶水文件查起。