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 在样本间自行外插。
• 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 行说明该车机不认这个协议（非零跑，或系统版本不同）。

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

• 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），贴日志前先核对这一行。

本次改动

docs(零跑): 三包协议清单 —— PhoneApp / SystemUpdate / CloudLeamp 的可复用通道

逆向三个零跑车机应用的进程间通道，产出 docs/零跑三包协议清单_*.md：

• PhoneApp(com.leapmotor.phone)：★来电状态广播 com.leapmotor.phonecall
  (extra MMI_PhoneSts int 0空闲/1响铃/2通话) + 详细来电 JSON car.hmi.sender.BROADCAST
  (byte[] 长度前缀+JSON) + 主动接听 com.leapmotor.ICU2MMICtrl(ICU_PhoneCtrl 1/2/3)

  • 导出 Provider com.jacp.provider.demo.programmer(通话记录)/.leader(通讯录)
  • 跳转 com.leapmotor.command.phone(必须带 type，否则对方 NPE)
    结论：电话应用不占音频焦点、无 MediaSession → 与 CarPlay 无冲突

• SystemUpdate(com.leapmotor.systemupdate)：★AIDL 宝库
  DeviceCtrlAidlService/IDeviceCtrlInterface 共 38 方法(0x15=getCarType，
  0x14=getVinInfo，0x16=getHighVoltage，0x17=getDCDCState，ECU 版本族...)；
  权限 com.leapmotor.JNIDEVICECTRL=signature → DiPlay 平台签名可调
  （交叉验证：VehicleSetting 自己也调 getVinInfo）。
  SpiStateAidlService 无权限门槛但只给 UDS 诊断/危险 shell，不用。
  SoundEffectPlayAidlService.play 是空实现，放了不响。
  可发广播：com.leapmotor.RESTORESYSTEM/SETTIME/SLEEPCTRL

• CloudLeamp(com.leapmotor.cloudleamp)：车云 MQTT(mTLS+TEE，不可复用)；
  ★VIN 配方法：读 /data/leapmotor/VinInfo（回落 /VinInfo.txt）；
  给出 car.meter.carinfo.BROADCAST 报文格式(但三包内只接收无发送，
  生产者是未解包的仪表应用 → 车辆信号仍以 CAN 总线为准)

同步在《零跑车机数据来源分析》§7 补上这几项的答案与交叉引用。