DiPlay 0.2.17 · PSA 车机版（beta 测试渠道）

这是 PSA 线的 beta 渠道，从 psa-beta 分支发布，包名 com.shihab.diplay.psabeta
（可与正式包 com.shihab.diplay 共存安装），发版 tag 走 v0.2.17-beta-<run>，
与正式渠道的 v0.2.12-<run> 互不可见（在线更新各自只看自己的命名空间）。
每次发版同时创建 v0.2.15-beta- / v0.2.12-beta- 别名 release，旧版本也能自动更新。
正式渠道的包请到 v0.2.12- 的 release 下载。

本版基于上游 0.2.17 合并（在 0.2.15 基础上新增：USB 充电电流选择、FPS 计数器、
麦克风 Opus 软件编码、音乐预缓冲欠载恢复、视频低延迟解码、仪表盘卡片 1% 滑块、
设置页内联搜索、BYD 氛围灯/通话弹窗/方控音量/平台21 等实验性功能）。
但有线与无线连接全部保留本线自己实车验证过的实现，未采用上游版本——
上游的连接实现在 Android 7 上有已知问题。

Android 7.1.2（API 25）/ Qualcomm msm8953 车机上的 CarPlay 接收端。
本页是当前整体状态页，每次发布前更新。

✅ 可用

连接

• 有线 CarPlay（VPN/NCM 通路）：设备发现、重枚举、配对、NCM 数据通路、MFi 认证、
  0x4300 / 0x4301、出画面（Video: first frame rendered）、音频（audioType=media）全部正常。
• 无线 CarPlay —— 三种模式都可用，按车机条件任选：
  • Wi-Fi Direct：✅ 可用。车机自建 P2P 组，iPhone 直连，不依赖车机热点。
    API 25 上信道由系统选择（见「已知限制」）。
  • 车载自建热点：✅ 可用。走车机自己的热点，需要车机 Wi-Fi 开关打开。
  • 外置 Wi-Fi / 同一局域网：✅ 可用。车机与 iPhone 连同一个网络。

功能

• 方向盘方控：
  • S01：通道 A（car.meter.music.BROADCAST 的 JSON）—— 实测正确。
  • T03：通道 B（com.leapmotor.customkey.music.pauseplay 的整数 extras）—— 可用。
• 方控音频归属：焦点与 MediaSession 已拿到，原厂播放器会让出方控。
• 媒体信息投送：曲名 / 艺术家 / 封面经 MediaSession 提供给车机仪表等读取方。
• 氛围灯 🆕：设置 →「氛围灯」。开关灯、随音乐流光（单色 / 多色）、颜色（31 色 / 专辑取色）、
  速度、灯光档位、分区。同一份 APK 自动识别车型：检测到零跑车机（/data/leapmotor/CarType）
  就走车机自己的 leapmotor.carapp.CARCANCONTROL 广播（appCAN=Atmos_ctrl，与 VehicleSetting.apk
  同协议）；其它车机（含 BYD）仍走原有的 ADB 通路，BYD 行为不受影响。
  不再以「亮度」判断是否驱动：只看开关（与「随音乐」），零跑协议本身没有亮度参数。
• 整车 CAN 信号读取 🆕：零跑车机通过 leapmotor.cantoapp.update 广播一次性回传全部车辆信号，
  本版把它接成一条总线（LeapmotorVehicleSignals，1 Hz 轮询）。只认零跑车机
  （/data/leapmotor/CarType 存在才启动轮询），不再走 ADB（零跑车机没有 adbd）。
  已知信号：档位 1010105、车速 1100409/1100412/100001、电池 SOC 1060115（回落电源 SOC 1030115）、
  SOH 1060306、电压 1060122、快/慢充 1030505/1030506、EPB 1110113。
  -1 / -1.0f 表示「本帧未上报」，绝不当作真实的 0。
• iPhone 车辆状态（电量/续航） 🆕：由上面那条总线供数，CarPlay 里 Apple 地图能看到电量、
  低电量提醒与充电状态。车机不上报剩余续航，续航按 SOC × 满电续航估算（默认 400 km，
  S01 有 380/460 两版）；能量字段只给电量比例（约 150 Wh/km），仅用于比例。
  设置 →「电量同步到 iPhone」仍可总开关。
• iPhone 航位推算（车速/档位） 🆕：车速与档位经 $PASCD 供 iAP2，进隧道无 GPS 时
  iPhone 能继续推算位置。采样率受 1 Hz 总线限制，iPhone 在样本间自行外插。
• CarPlay 来电卡片（零跑） 🆕：设置 →「CarPlay 来电显示到仪表盘」。iPhone 的来电/去电
  通过 iAP2 CallStateUpdate 取得，再以 car.hmi.sender.BROADCAST（sender = 2 字节大端长度 +
  UTF-8 JSON，{"type":"call","data":{"state":"ring|answer|end","name":"…"}}）送到零跑仪表盘。
  全程只用普通广播，不需要 ADB（零跑车机没有 adbd）；BYD 车机仍走原来的 ADB 通路，行为不变。
  方控的接听/挂断走 iAP2（与 BYD 同一套），零跑上直接可用。
  设置项在零跑上不需要 ADB 支持性探测，打开即可。
• USB 权限弹窗：MANAGE_USB + 无障碍按内容判定自动确认。
• 界面汉化、零跑档位识别、倒车暂停、iOS 27 视频车内播放（N 挡门控）。
• 在线更新（首页快捷设置下方 → 在线更新）：检查 GitHub 上的新构建 → 下载 → 安装。
• CarPlay 应用列表里那个「回到原车」的图标按钮，名称与图标都是零跑。
• 中控屏上的仪表盘地图（悬浮卡片）：窗口类型按 SDK 分支，API < 26 降级 TYPE_PHONE；
  画面取自 stream 111（仪表盘流）。
• 设置页：分类 + 侧栏 + 搜索（上游 0.2.14 结构）；本线自有的「与嘟嘟桌面共享实时界面」
  在高级组、紧跟仪表盘地图；「方控学习」在车辆组、紧跟方向盘按键；「在线更新」在首页。

⚠️ 已知限制

• Wi-Fi Direct 在 API 25 上无法指定信道：WifiP2pGroup.getFrequency() 与带 config 的
  createGroup 都是 API 29 才有的，所以信道由系统选择。升到 Android 10 以上才能手动指定。
• CI 不再跑 lint 与单元测试，只出 release 包。改运行时代码时请手动跑一次
  python D:\Launcher\kotlin_static_check.py <改动的 .kt 文件>。
• APK 必须带 arm64-v8a：为某个 native 库钉 ABI 会把整个进程变成 32 位，
  而 32 位会打挂车载热点。CI 里已加断言。
• 开无线 CarPlay 时车机自身没有网络（msm8953 单射频，不支持 STA+GO 并发）。
• 无线握手完成后会尝试把 iAP2 从蓝牙引导通道切到隧道通道；若隧道未就绪会
  wireless handoff fallback ... preserving AirPlay，AirPlay 与画面不受影响。
• 本版升级会更换发版 tag 命名空间（v0.2.15-beta- → v0.2.17-beta-）：
  CI 会同时为 v0.2.15-beta- / v0.2.12-beta- 创建别名 release，故旧 beta 包仍能自动发现本版。
• 大版本升级建议卸载后重装（残留状态可能影响首次连接）。

复测判据

方向盘方控（S01 / T03 都适用）：

1. 起会话时应看到 media keys listening on 9 car actions（通道 A 侧）
   与 car bus listening on 2 extra wheel channels（通道 B 侧）。
2. 按一次「下一首」，应出现恰好一行
   media key source=<通道> action=nextOne -> CarPlay 4 sent=true。
3. 若某台车无反应：看 media key extra-channel unmatched action=... extras=[...]
   —— 这行会把该车机真正发的 extras 全量列出来。

氛围灯（需车辆通电）：

1. 设置 →「氛围灯」→ 打开「启用」并「保存」：零跑车机应直接通过（零跑通路不做 ADB 支持性探测）；
   BYD 车机沿用原有的 ADB 只读探测。
2. 报告里应出现 DiPlay-Ambient: leapmotor probe file=true model=<n> path=/data/leapmotor/CarType
   —— 这行判定车型（file=false 即走 BYD 通路）。
3. 随后应出现 DiPlay-Ambient: leapmotor applied=<n> sw=0 auto=1 deg=<d> r=<r> g=<g> b=<b>
   （sw=0/auto=1 即自动档；随音乐时 deg/r/g/b 随频谱变化）。
4. 关掉「启用」后应出现 leapmotor restored to auto，车机回到自身自动氛围灯。

整车 CAN 信号（需车辆通电）：

1. 起会话后报告里应出现 DiPlay-Vehicle: vehicle signals listening on leapmotor.cantoapp.update
   —— 这行说明接收器注册成功（车型判定走 DiPlay-Ambient: leapmotor probe file=true）。
2. 挂挡应逐次出现 DiPlay-Vehicle: gear raw=<a> -> <b> (<R/N/D/P>)；
   挂 R 时同时 reverse: pause CarPlay sent=true，退出 R 时 reverse ended: resume CarPlay sent=true。
3. 车动起来后应出现 DiPlay-LM-Speed: first CAN speed <nn.n> km/h。
4. 若接收器注册失败会打印 vehicle signals receiver not registered: ...；完全没有任何
   vehicle signals listening 行说明该车机不认这个协议（非零跑，或系统版本不同）。

CarPlay 来电卡片（零跑，需车辆通电）：

1. 打开设置 →「CarPlay 来电显示到仪表盘」：报告里应出现
   DiPlay-Lm-Call: call output listening（DiPlay-Ambient: leapmotor probe file=true 是前提）。
2. 手机上模拟来电：应出现 DiPlay-Lm-Call: CarPlay call RINGING，仪表盘出现来电卡片。
3. 来电状态变化依次打 … CarPlay call ACTIVE / CarPlay call ended；挂断后卡片应消失。
4. 车机自身的蓝牙来电会打 DiPlay-Lm-Call: car phone state=<0|1|2>（1 振铃 2 通话中 0 空闲）。
5. ⚠️ 本机判据只验证到「广播已发出」；仪表是否真的渲染卡片属实车验证项
   （data.state 的拼写取自第三方 App 的实现，尚未上车验证）。若仪表不显示，
   联系开发者改为「通话中让位」策略。

无线连接成功时报告里应出现：

• Wi-Fi Direct：wireless hotspot backend=Wi-Fi P2P iface=p2p0 →
  wireless Bonjour services started mode=interface iface=p2p0 → AirPlay session active
• 车载热点：wireless hotspot backend=Manual hotspot → AirPlay session active
• 出画面：Video: first frame rendered
• 悬浮卡片：Centre map: card shown streamActive=true（流应为 111 / dashboard stream）

装包说明

• 包名 com.shihab.diplay.psabeta（beta 渠道），平台签名。
• 诊断报告第一行带真实版本名（DiPlay 0.2.17（NN-sha）-beta），贴日志前先核对这一行。

本次改动

零跑来电卡片：iAP2 CarPlay 通话状态经 car.hmi.sender.BROADCAST 送到零跑仪表盘

• 新增 shared/hud/LeapmotorCarPlayCallOutput.kt：CarPlay 的 iAP2 CallStateUpdate 复用
  CarPlayCallState 解析，再以 [u16 大端长度][UTF-8 JSON] 的 sender extra 发到
  car.hmi.sender.BROADCAST（{"type":"call","data":{state/name}}）。全程普通广播，
  无 ADB/反射/root（零跑车机没有 adbd）。同时监听 com.leapmotor.phonecall(MMI_PhoneSts)
  以知晓车机原生通话，避免与原生 UI 打架。
• BydNavigationOutputs 按 BydOutputSettings.leapmotorHeadUnit() 分支：start/onFrame/
  carPlayCallsChanged/carPlaySessionStarted/carPlayCall/endNow 全部按车型分派；
  carPlaySessionStarted 现在带 context。
• BydOutputSettings 新增 public leapmotorHeadUnit()，供 common 模块判车型
  （LmCarProbe 是 shared 的 internal，common 看不见 —— 跨模块可见性坑）。
• 设置：零跑上 carplay_calls 开关不再需要 ADB 探测（applyCarPlayCalls 跳过 checkAdbState）；
  两处开关 enabled 门控加 lmHeadUnit()。
• 新增单测 LeapmotorCarPlayCallOutputTest：锁定 JSON 形状/转义/UTF-8 字节长度前缀。
• 文档：零跑三包协议清单 §1.2 按第三方 App（小零助手/LauncherThree）实测重写；
  BYD独有功能_零跑适配清单 更新结论表 + §5/§6/§7/§12；RELEASE_NOTES 补来电卡片。
• 方控接挂走 iAP2（与 BYD 同一套），零跑上直接可用；原生蓝牙通话方控由车机自处理。