jack/chromebox_10th_audio_driver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(kaisa): ProAudio 主路线、WirePlumber default-profile 与一键脚本

Browse Source 
- 新增 OPERATION_PipeWire_Kaisa_ProAudio / UCM_HiFi，核心问题复盘与恢复 Ubuntu 重测手顺；HDMI 旧文改为 stub。
- 脚本：apply / verify-pro-audio、strip default-profile、reapply-session、remove deb 与 UCM overlay、verify-audio-environment。
- systemd-user：kaisa-pro-audio-reapply.service 示例。
- README、docs 索引、REPO_INDEX、REPRO deb 存档说明；deb 标为未来计划；reference/ucm2 与采集脚本小改。
- debian 与 _bmad-output 规划文件随本次工作区一并更新。

Made-with: Cursor
This commit is contained in:
jack
2026-04-08 11:07:13 +08:00
parent 5c7d0aa360
commit 17f0a4521f
29 changed files with 1505 additions and 427 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
_bmad-output/planning-artifacts/epics.md
View File

@@ -90,7 +90,7 @@ workflowType: epics
- **Given** 仓库根已克隆
- **When** 打开 `docs/INDEX.md`
- **Then** 存在指向 `OPERATION_PipeWire_Kaisa_HDMI.md` 与 `REPRO_Kaisa_Deb_ProAudio_Manual.md` 的条目
- **Then** 存在指向 `OPERATION_PipeWire_Kaisa_ProAudio.md`、`OPERATION_PipeWire_Kaisa_UCM_HiFi.md` 与 `REPRO_Kaisa_Deb_ProAudio_Manual.md` 的条目
### Story 1.2：（已收敛）路线图
@@ -125,7 +125,7 @@ workflowType: epics
### Story 3.1：OPERATION 覆盖 pro-audio / EBUSY / IEC958 / 全自动
作为一名 **Kaisa 用户**，
我希望 **OPERATION_PipeWire_Kaisa_HDMI.md** 说明 **pro-audio**、**`speaker-test -D pulse`**、**IEC958',N** 与 **§4.3 安装器**，
我希望 **OPERATION_PipeWire_Kaisa_ProAudio.md** 说明 **pro-audio**、**`speaker-test -D pulse`**、**IEC958',N** 与 **§4.3 安装器**，
以便 **排障不靠口口相传**（**FR5**）。
**验收标准：**

19
_bmad-output/planning-artifacts/prd.md
View File

@@ -4,7 +4,8 @@ stepsCompleted:
inputDocuments:
- README.md
- docs/INDEX.md
- docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md
- docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md
- docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md
- docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md
workflowType: prd
brownfield_synthesis: true
@@ -18,7 +19,7 @@ last_edited: '2026-04-06'
**日期：** 2026-04-06
**状态：** 基线重建；已按 **`prd-validation-report.md`** 做 [EP] 修订（P2/P4）
**2026-04 文档收敛**：仓库已删除 ChromiumOS 长文、路线图、WORK_PROGRESS 等；**事实与验收**以 **README.md**、**OPERATION_PipeWire_Kaisa_HDMI.md**、**REPRO_Kaisa_Deb_ProAudio_Manual.md** 为准。下文仍出现旧路径处视为历史表述。
**2026-04 文档收敛**：仓库已删除 ChromiumOS 长文、路线图、WORK_PROGRESS 等；**事实与验收**以 **README.md**、**OPERATION_PipeWire_Kaisa_ProAudio.md**、**OPERATION_PipeWire_Kaisa_UCM_HiFi.md**、**REPRO_Kaisa_Deb_ProAudio_Manual.md** 为准。旧名 **OPERATION_PipeWire_Kaisa_HDMI.md** 仅为重定向 stub。
---
@@ -63,7 +64,7 @@ last_edited: '2026-04-06'
| 角色 | 目标 | 主要触点 |
|------|------|----------|
| **维护者 / Jack** | 可选内核对照、脚本 | `chromiumos_kernel/`、`scripts/`（HWE 源码树本机自行 `apt source`） |
| **另一台 Kaisa 用户** | 在 Ubuntu + PipeWire 上让 HDMI 有声 | `OPERATION_PipeWire_Kaisa_HDMI.md`、`50-kaisa-sof-rt5682-hdmi.conf`、deb 内工具 |
| **另一台 Kaisa 用户** | 在 Ubuntu + PipeWire 上让 HDMI 有声 | `OPERATION_PipeWire_Kaisa_ProAudio.md`、`50-kaisa-sof-rt5682-hdmi.conf`、deb 内工具 |
| **上游读者** | IPC/内核对照 | 本地两棵内核树 + 可选 `reference/chromeos-ubuntu-sound-diffs/`（本机 diff 输出） |
---
@@ -88,8 +89,8 @@ last_edited: '2026-04-06'
| ID | 能力 | 验收要点 |
|----|------|----------|
| **FR1** | **文档索引** | 人读 **INDEX.md** 可到达 **OPERATION**、**REPRO**。 |
| **FR2** | **Linux HDMI 技术路线** | **OPERATION_PipeWire_Kaisa_HDMI.md** 覆盖 pro-audio / UCM / deb；**REPRO** 为验收手顺。 |
| **FR5** | **桌面 HDMI 操作说明** | **OPERATION_PipeWire_Kaisa_HDMI.md** 覆盖 **pro-audio**、**plughw EBUSY**、**IEC958 §4.2**、**§4.3 登录自动 restore**。 |
| **FR2** | **Linux HDMI 技术路线** | **ProAudio / UCM 文档** 覆盖 pro-audio、UCM、deb；**REPRO** 为验收手顺。 |
| **FR5** | **桌面 HDMI 操作说明** | **ProAudio 文档** 覆盖 **pro-audio**、**plughw EBUSY**、**IEC958 §4.2**、**§4.3 登录自动 restore**。 |
| **FR6** | **登录自动修复（Kaisa）** | **OPERATION §4.3**：**user systemd** 示例 + 手顺；**deb ≥0.3.0** 不随包提供可执行工具。 |
| **FR7** | **WirePlumber 片段示例** | **`50-kaisa-sof-rt5682-hdmi.conf`** 可复制到 **`~/.config/wireplumber/...`**。 |
| **FR8** | **对照与导出** | **ChromeOS ↔ Ubuntu**：本机两树 **`diff`**；可选输出至 **`reference/chromeos-ubuntu-sound-diffs/`**（见该目录 README）。 |
@@ -103,9 +104,10 @@ last_edited: '2026-04-06'
```bash
test -f docs/INDEX.md
test -f docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md
test -f docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md
test -f docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md
test -f docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md
grep -q 'OPERATION_PipeWire_Kaisa_HDMI' docs/INDEX.md
grep -q 'OPERATION_PipeWire_Kaisa_ProAudio' docs/INDEX.md
```
---
@@ -144,7 +146,8 @@ grep -q 'OPERATION_PipeWire_Kaisa_HDMI' docs/INDEX.md
## 10. 参考（仓库内）
- [docs/INDEX.md](../../docs/INDEX.md)
- [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md)
- [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)
- [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md)
- [docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md](../../docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md)
- [README.md](../../README.md)