核心劫持点与 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 劫持后：

1. 利用外骨骼函数接口 hisi_subctrl_XXX 去重设从 L_CLK 向 H_CLK 转变的源。
2. 向四块专有寄存器位段（0x80, 0x90, 0x94, 0x98）强灌入一套经核心板硬件匹配校准并下发自设备树 (DTS) 的时序参数映射表 (timing_x_cfg)。
3. 这些参数定义了极微观的值：例如延迟读取的时间（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 劫持特性的胶水文件查起。