FlexConnect：MS12 输出声道与喇叭声道匹配原理

这篇写什么？

做 FlexConnect Soundbar 时，有一个比「Dolby 怎么渲染」更落地的问题：

MS12 吐出来的 8 声道，怎么和 Soundbar + 无线音箱 + 低音炮的物理 I2S 槽对得上？

文中「卫星」就是 无线音箱（高度声道）。
这篇用流程图讲清原理：谁负责分内容、谁负责对物理接线、为什么要 bypass TVSDX。

建议阅读顺序：图 1 总览 → 图 4 初始化 → 图 2 播放调用 → 图 3 remap → 图 5 bypass → 图 6 设备角色。

0. 一句话结论

MS12 FLAP 按「逻辑设备序」输出最终喇叭声道；
HAL 用 ALSA_Speaker_layout 做 CTA remap 成物理 I2S 槽；
flap_mode=1 时 bypass TVSDX，避免 TpFL / TpFR 被折进 LFE。

排查「高度声道没了」「低音炮和无线音箱串了」时，先核对这三句。

1. 总体数据流

核心分工： MS12 负责「内容已经分到各喇叭角色」；HAL 只负责「物理接线顺序对齐」，不再做高度声道二次混音（前提是 flap_mode=1）。

2. 播放路径：在干什么？

MS12 通过 FLAP 输出回调进入 HAL；Soundbar 路由里做 remap，再写 ALSA。

调用链：

MS12 FLAP 输出
  → dap_pcm_output（DAP / FLAP 出口）
  → Soundbar / SEI 喇叭路由
  → 多声道处理 + CTA remap（8ch）
  → （可选）TVSDX bypass
  → 写 ALSA → I2S

8ch FlexConnect 时，关键是：逻辑序和物理槽不一致时，用 remap 表逐样本搬家。
2ch DSP 配置会走另一条简化路径；典型 FlexConnect 8ch 项目走「全通路 + remap」。

触发 remap 的条件示意：

if (flexconnect_tvsdx_bypass && nchannels == 8 && alsa_ch == 8) {
    // 按 remap_table 把逻辑声道搬到物理 ALSA 槽
    channel_remap_process(...);
}

3. 开机时一次建好 remap

FlexConnect 参数与 remap 表在 首次打开 HAL 时就绪；之后播放只走上面的热路径。

初始化要做的事：

1. 装入 / 解析 flexconnect JSON（通道数、物理 layout、Real_Speaker）
2. 解析 device_role_map（Controller / Sub / 无线音箱占哪些槽）
3. 建默认 remap，再按 JSON sink 布局覆盖
4. 若 flexr 配置齐全且 Config W 生效 → FLAP 模式，并打开 -flap_mode 1

JSON 里大致会看到：

"ALSA_Speaker_Channels": 8,
"ALSA_Speaker_layout": "spk_ch_0=CTA_LFE1 ... spk_ch_7=CTA_TpFR",
"Real_Speaker_Layout": "510"

FLAP 打开的条件：

flexr stream + device 配置都在 + MS12 Config W
  → dap_init_mode = FLAP
  → MS12 按 FlexConnect 拓扑输出多声道

4. 声道 remap：逻辑序 → 物理 ALSA 槽

这是整篇的「心脏」。MS12 输出的 8 声道顺序和 PCB 上 I2S 槽顺序 往往不一致，靠 remap_table 对齐。

4.1 两套布局

典型逻辑序里 TpFR 在 TpFL 前面；物理槽 6/7 又常常是 TpFL / TpFR——这正是 remap 要解决的「序不对」。

4.2 典型 FlexConnect 5.1.2 映射

channel_remap_process() 按表把源声道样本写到目标槽；表错一张就会「喇叭对调」。

5. flap_mode 与 TVSDX bypass

传统 Soundbar 没有独立高度无线音箱时，HAL 里的 TVSDX 会把高度信息虚拟化或折进 LFE。
FlexConnect 下 MS12 已经输出独立的 TpFL / TpFR，若再走 TVSDX，高度声道会被错误处理。

设计意图很直接：

MS12 flexible renderer 已经输出最终喇叭声道；
TVSDX 不能再处理一遍，否则 TpFL/TpFR 会被折进 LFE。

因此：flap_mode == 1 → 置 flexconnect_tvsdx_bypass → 跳过 TVSDX，直接走向物理输出（以及后续的本机延迟补偿，见 Speaker Sync / 20ms 补偿篇）。

无线高度「没声」或「进低音炮了」时：先查 flap_mode 是否为 1、bypass 是否打开，再查 remap 表。

6. device_role_map 与物理喇叭

JSON 把 FlexConnect 设备角色（Controller / Sub / 无线音箱）绑定到 ALSA 槽，供 remap、校准 App 和 dump 共用。

device_role_map 描述「哪个角色占哪些槽」；ALSA_Speaker_layout 描述「每个槽的 CTA 标签」。两者一起决定 remap，并与 MS12 FLAP 逻辑序对齐。

7. 怎么核对实现

1. 按图 1 → 图 4 → 图 2 → 图 3 → 图 5 → 图 6 对照真机行为

2. dump：

   dumpsys media.audio_flinger --hal | grep -A20 FlexConnect
   

3. 日志关键字：

   set_speakers_each_channel_layout
   remap config changed
   FlexConnect: flap_mode
   dap_init_mode = 3
   flexr stream config path
   

8. 和系列其它文章的关系

校准层解决「音箱在哪」；本篇解决「PCM 写到哪一路 I2S」。

9. 常见问题速查

基于 Amlogic Soundbar HAL + Dolby MS12 FlexConnect 实践整理。