安装指南
分两步:先通过 MGU Store 把 idv7lol 应用装到车上,再添加主题。全程请在驻车状态下进行,并保持车辆供电稳定(发动机运转,或连接蓄电池充电器)。
开始之前
- 一辆配备 iDrive 7(MGU 主机)和数字仪表盘的 BMW。已有许多用户试用过。
- 主机编码的备份,以及重新编码的手段(BimmerCode、E-Sys 或维修店)。原因见第 1 步。
- 让主机联网以使用 Store(mgu-uplink:手机热点或调制解调器),或者一个 U 盘。
1 · 安装 MGU Store
MGU Store 由 Robert Nisipeanu 开发,负责在主机上安装应用。idv7lol 不会替你安装它:请按照它的 README 操作。它需要获取一次 root SSH 权限,可以通过 idrive7-8-ssh-root 获得。
刷写后主机将处于未编码状态:语言、菜单和设置都会重置;在重新编码之前,Store 会拒绝安装任何东西;BMW Digital Key 的配对通常也会丢失。请先备份编码,准备好重新编码的手段,并且只刷写一次。如果之后 SSH 失效,请使用该工具的 enable 或 persist 步骤,而不要再刷写一次。idv7lol 本身从不刷写或编码任何东西。
当 Store 能够打开并显示应用列表后,继续第 2 步。
2 · 将 idv7lol 添加到 Store
打开软件源
在车上的 Store 中依次进入 Settings › Sources › Add GitHub repository。
输入仓库
ALMSTRA/idv7lol,然后选择一个通道:- Branch 并填入
main:在主机上用最新代码构建应用。已在实车上测试;推荐使用。 - Releases:来自
catalog发行版的现成安装包。尚未在实车上试过。
不要选择 Tags:它会跳过
v0.2.0-beta.7这样的预发布版本,因此 idv7lol 不会出现。- Branch 并填入
安装
列表中会出现 idv7lol。打开它并按下 Install。Store 会先安装 idv7lol 所需的组件:cluster-render 0.6.6(负责在仪表盘上绘制内容的服务),以及 Store 自己的部署工具 mgu-deploy 0.8.21,它能确保更新后运行的是新代码。然后在主机上构建 idv7lol。大约需要一分钟。
按提示重启
如果 Store 要求重启主机,请在打开应用之前完成重启。
主机无法联网?把代码仓库复制到 U 盘,插入后在 Store 中用 Add from USB 添加。Store 会以同样的方式构建应用。
3 · 首次运行
打开应用
在应用菜单中打开 idv7lol。它的标签页有 Themes、Data、Status、Signals、Renderer 和 About,用 Page 切换。与渲染器的连接应显示为 connected (id7)。
在仪表盘上显示
在你按下 Show(显示),或在 Settings 中设为 Show on the cluster: On 之前,不会绘制任何内容。只有在车辆数据实时传入时,布局才会出现:启动车辆,或者打开 Demo data(演示数据)来查看。
选择主题和调色板
使用 Theme(主题)和 Palette(调色板),或在 Settings 中选择。Start-up sweep(启动扫表)和 Clock offset from UTC(时钟与 UTC 的时差)也在设置里。
确认如何恢复
原厂警告始终显示在主题上层。再按一次 Show:原厂仪表盘会在一秒内恢复。这样在开车之前,你就知道如何退出了。
4 · 从本站添加主题
需要应用 0.2.0 或更高版本;带动画的主题(例如 Volt Runner)需要 0.2.6 或更高版本。最多可同时安装 20 个主题。
下载主题
在主题页面点击下载车机版,得到一个
.idv7pkg文件。复制到 U 盘
在任意 FAT32 或 exFAT 格式的 U 盘上创建文件夹
idv7lol/themes/,并把文件复制进去。可以同时放多个主题。驻车时插到车上
打开 idv7lol 应用,插入 U 盘。几秒内,状态页会显示 Installed from USB(已从 USB 安装),或者显示某个文件被拒绝的原因。
选用
按 Theme,直到新主题出现。安装本身绝不会改变仪表盘。
移除主题:在该主题显示时,选择 Settings › Theme from USB on show › Remove it from the car(设置 › 正在显示的 USB 主题 › 从车上移除)。也要把它从 U 盘中删除,否则下次插入 U 盘时它会再次被安装。
读取 U 盘的功能尚未在实车上得到确认。即将开放试用:如果你的主机通过 MGU Store 联网,应用将在中控屏上显示这份主题目录并直接安装其中的主题,无需 U 盘,仅限驻车时。
5 · 更新
车机应用有新版本时,Store 会提供 idv7lol 的更新;请在 Store 中 idv7lol 的页面上安装。如果更新后应用的表现仍像旧版本,请更新 Store 的工具并重启主机。
6 · 卸载 idv7lol
- 想立即恢复原厂仪表盘:按 Show,或在 Settings 中设为 Show on the cluster: Off。
- 卸载:MGU Store › Installed › idv7lol › Remove。是否卸载 cluster-render 可自行决定;其他应用可能也在使用它。
- Store 还可以回滚它安装过的内容。如果主机运行异常,Store 的文档说明了如何通过 SSH 移除全部内容。
出现问题时
- Store 中没有出现 idv7lol
- 检查软件源:应为
ALMSTRA/idv7lol,通道选 Branchmain或 Releases,而不是 Tags。 - “no catalog release and no …”(没有 catalog 发行版,也没有……)
- 该软件源是在
catalog发行版出现之前以 Releases 通道添加的。让 Store 重新检查软件源,或者删除该软件源后重新添加。改用 Branchmain也可以。 - “coding is missing: it holds default values”(缺少编码:仍为默认值)
- 主机没有编码,几乎都是 SSH 刷写造成的。请重新编码(BimmerCode、E-Sys 或维修店)后重试。
- 已安装,但应用菜单中没有图标
- 更新 Store 的工具,然后重新安装 idv7lol。
- 应用显示“not connected”(未连接)
- cluster-render 未安装或未运行。请从 Store 安装它(软件源
robertnisipeanu/idrive-apps),版本 0.6.6 或更高。 - “Waiting for live car data”(正在等待实时车辆数据)
- 发动机熄火且车辆休眠时,不会有数据传入。启动车辆,或打开 Demo data 来检查布局。
- 仪表盘上出现黑色方块
- 请把应用更新到 0.2.4 或更高版本,然后重启主机:按住音量旋钮约 30 秒。从 0.2.4 起,布局会在车辆自带的底部信息条上方结束;以前布局盖住这条信息条时,部分仪表盘(包括 M 车型)会留下黑色方块,直到重启。
没有找到你的问题?附上图片或视频报告给我们。更多情况见故障排除指南,全部细节见代码仓库中的安装指南(英文)。
安全
idv7lol 是实验性项目,并非 BMW 出品。原厂警告始终显示在主题上层,再按一次 Show 即可恢复原厂仪表盘。所有安装和试用都请在驻车时进行。