安装 AltScreen

开始之前

• 车机为 MHI2Q，固件版本为 AUG22，可以在车机信息页查看。安装时会自动核验，不符合会拒绝安装。
• 一张可以正常读写的 FAT32 SD 卡。
• 车辆停稳，车机供电稳定。
• 一台能解压 ZIP 并运行 sha256sum 的电脑，Windows 可以使用 Git Bash。

第 1 步

准备上游 MIB2 Toolbox

AltScreen 是覆盖包，需要车机上已经装好 jilleb/mib2-toolbox，不能通过红色菜单单独安装。

如果下面这项能正常执行，说明上游 Toolbox 没有问题，可以直接跳到 第 2 步：

TESTMODE›Green Developer Menu›MQBCoding›Update Toolbox

如果还没有安装上游 Toolbox，或者执行时提示 Script not found，先按以下步骤安装或修复：

1. 下载上游 MIB2 Toolbox 的最新完整版本并解压，把包内的文件和目录复制到 SD 卡根目录，不要多套一层文件夹。
2. 车机只插这一张 SD 卡，进入红色菜单：

   Software updates/versions›Update›SD 卡›MQB Coding MIB2 Toolbox

3. 等待软件更新和自动重启全部完成，期间不要拔卡或断电。
4. 重启后进入绿色菜单，确认 Update Toolbox 可以正常执行。

第 2 步

合并覆盖包到 SD 卡

1. 下载最新安装包并解压。下载 V3.7Fix6
2. SD 卡上的上游 Toolbox 内容全部保留，包括 metainfo2.txt、Toolbox/final/ 等文件。
3. 把安装包里的 Toolbox/ 目录合并到 SD 卡根目录已有的 Toolbox/：同名文件覆盖，其他文件保留。不要清空后再复制。
4. 把安装包根目录的 SHA256SUMS-SD.txt 也复制到 SD 卡根目录。

合并后的目录结构应类似：

SD 卡根目录/
├─ metainfo2.txt                    上游 Toolbox
├─ SHA256SUMS-SD.txt                本项目
└─ Toolbox/
   ├─ final/                        上游 Toolbox
   ├─ GEM/
   │  ├─ mqb-main.esd               上游 Toolbox
   │  └─ mqb-carplayAltScreen.esd   本项目
   ├─ scripts/                      两者合并
   └─ carplay_alt_screen/           本项目

不要出现 SD卡/Toolbox/、MHI2Q-CarPlay-AltScreen/Toolbox/ 这样的多余层级。

最后在 SD 卡根目录运行校验，确认所有文件都显示 OK：

sha256sum -c SHA256SUMS-SD.txt

第 3 步

用绿色菜单更新 Toolbox

1. 把 SD 卡插回车机，执行：

   TESTMODE›Green Developer Menu›MQBCoding›Update Toolbox

2. 完成后退出并重新打开绿色菜单，进入：

   Customization›MMI-Cockpit-Carplay

3. 确认菜单顶部的版本号与下载的安装包一致，并且菜单中只有 INSTALL NO RGI、INSTALL WITH RGI、RESTORE ORIGINAL 三项。

第 4 步

安装

先断开 iPhone，然后在 MMI-Cockpit-Carplay 菜单中选择一种安装模式：

安装程序会依次执行 5 步并实时显示进度，期间不要拔卡、断电或重启：

[1/5] Checking package and firmware...          检查安装包和固件
[2/5] Checking for a previous installation...   检测旧版本，有则自动卸载
[3/5] Installing AltScreen + RGI...             安装，出错自动回滚
[4/5] Enabling autostart...                     写入开机自启
[5/5] Verifying installation...                 最终校验

• RESULT: SUCCESS完整重启车机一次，安装完成。
• RESULT: FAILED屏幕会写明失败的步骤、车机当前状态和下一步操作，按提示处理即可。完整记录保存在 SD 卡日志中。

想切换安装模式，直接用另一种模式重新执行 INSTALL，安装程序会先自动卸载当前版本。

第 5 步

开始使用

重启完成后连接 iPhone，进入 CarPlay 并开始导航，仪表上就会出现第二屏画面。

• 冷启动时，第二屏会等原车仪表地图加载完成后再出现，并先播放约 5 秒开屏视频，这是正常现象。
• 推荐使用 iOS 26。低于 iOS 18 时，百度地图可能不显示，高德地图比例可能异常。
• 拨动方向盘左侧滚轮，可以缩放仪表上的地图。

升级到新版本

升级不需要先手动恢复原车：

1. 断开 iPhone，使用当初安装时的那张 SD 卡，卡上的 MMI-Cockpit-Carplay 目录必须完整保留。
2. 按 第 2 步 合并新版覆盖包，并删除 Toolbox/carplay_alt_screen/mirror_display/release/ 中旧版遗留的 logo.rgba 和 watermark.rgba。
3. 按 第 3 步 执行 Update Toolbox，再按 第 4 步 安装。安装程序检测到旧版本后，会先自动卸载并校验，再安装新版。
4. 看到 RESULT: SUCCESS 后完整重启车机一次。

如果卡上没有原车备份（比如换了 SD 卡），安装程序会在第 2 步停止并提示，不会改动车机。

恢复原车

1. 插入保留了 MMI-Cockpit-Carplay 原车备份目录的 SD 卡，在菜单中选择 RESTORE ORIGINAL。
2. 看到 RESULT: SUCCESS 后完整重启车机。

• RESULT: FAILED按屏幕提示操作。如果提示回滚不完整，不要重启，再执行一次 RESTORE ORIGINAL。
• NOTHING TO RESTORE车机本来就是原车状态，不需要恢复。

问题排查

绿色菜单里找不到 MMI-Cockpit-Carplay

确认上游绿色菜单正常、SD 卡目录层级正确，并且 Update Toolbox 已经执行成功。

冷启动后仪表一直没有第二屏

先确认原车导航地图能在仪表上正常显示。第二屏要等原车仪表地图初始化完成后才会出现。

百度地图不显示，或高德地图比例异常

把 iPhone 升级到 iOS 18 或更高版本，推荐 iOS 26。

车机读不到 SD 卡

检查 SD 卡是否为 FAT32、根目录文件是否齐全、卡是否处于可读写状态。

仪表第二屏没有画面

确认 CarPlay 已连接并且正在导航。仍然没有画面，请保存日志后反馈，不要反复重新安装。