deepeshx9/lenovo-yoga-slim7x-audio-linux

# Lenovo Yoga Slim 7x 的音频 DSP 硬件支持 (Linux) ## 概述 本项目为 Linux 上的 Lenovo Yoga Slim 7x (Snapdragon X Elite / 14Q88X) 提供缺失的 DSP (数字信号处理) 和硬件安全层。 目前，上游 Linux 发行版默认使用“仅限低音扬声器且安全”的音频配置文件，以避免硬件损坏。本项目旨在将专有的 Windows 声学调优和热安全算法移植到开源 Linux 栈中，从而解锁完整的 4 扬声器旗舰音频体验。 ## 架构 本项目采用严格的关注点分离，将物理硬件保护与声学用户空间调优分离开来： * **Level 0:** 内核驱动补丁 (`wsa884x.c` / `x1e80100.c`)，实现了 Q16.16 定点 VISENSE 遥测拦截和 SoftClip 限制。这可以防止音圈熔化。 * **Level 1:** 用户空间 PipeWire/WirePlumber 配置文件 (`DSP/10-crossover.conf`) 和 ALSA UCM 配置 (`alsa-ucm2-conf/`)，复现了专有的 Dolby Atmos 双二阶 EQ 和分频频率。 ## 当前状态 * **ALSA UCM 路由:** 已实现 (来自上游 alsa-ucm-conf 项目) * **PipeWire DSP 分频:** 已实现但未测试 * **Kernel VISENSE/SoftClip 数学计算:** 进行中 (目前不作任何保证) * **Speakersafetyd 移植:** 进行中 (目前仅克隆了仓库) ## 安装与测试 *注意：您必须明确将 `snd-soc-x1e80100.i_accept_the_danger=1` 传递给内核参数，这些配置才能完全生效。* 我们在 `/deployers` 目录中提供了自动化部署脚本： 1. **仅限用户空间 (`framework-configuration.sh`)：** 安全地安装 ALSA UCM 和 PipeWire 拓扑结构。 2. **裸机部署器 (`kernel_compile-deploy.sh`)：** 一个交互式脚本，用于下载、打补丁、编译并安装包含我们自定义驱动算法的候选发布 (RC) 内核。 ## 贡献 我们正在积极寻求关于 DSP 逆向工程、ALSA UCM 验证和内核定点数学方面的帮助。在提交 PR 或 Issue 之前，请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。

标签：ALSA, Audio DSP, Dolby Atmos, Lenovo Yoga Slim 7X, Linux 音频, PipeWire, Snapdragon X Elite, SoftClip, VISENSE, WirePlumber, 内核参数, 内核驱动, 双二阶滤波器, 双四分频, 固定点数学, 声学配置, 安全渗透, 开源硬件, 扬声器保护, 数字信号处理, 硬件驱动, 网络协议, 设备兼容性, 音频调音, 音频路由, 驱动移植, 高通骁龙