idv7lol 公测
idv7lol.com 已开启公测。 最新动态 →

安装指南

分两步:先通过 MGU Store 把 idv7lol 应用装到车上,再添加主题。全程请在驻车状态下进行,并保持车辆供电稳定(发动机运转,或连接蓄电池充电器)。

开始之前

1 · 安装 MGU Store

MGU Store 由 Robert Nisipeanu 开发,负责在主机上安装应用。idv7lol 不会替你安装它:请按照它的 README 操作。它需要获取一次 root SSH 权限,可以通过 idrive7-8-ssh-root 获得。

SSH 解锁会清除主机的编码

刷写后主机将处于未编码状态:语言、菜单和设置都会重置;在重新编码之前,Store 会拒绝安装任何东西;BMW Digital Key 的配对通常也会丢失。请先备份编码,准备好重新编码的手段,并且只刷写一次。如果之后 SSH 失效,请使用该工具的 enable 或 persist 步骤,而不要再刷写一次。idv7lol 本身从不刷写或编码任何东西。

当 Store 能够打开并显示应用列表后,继续第 2 步。

2 · 将 idv7lol 添加到 Store

  1. 打开软件源

    在车上的 Store 中依次进入 Settings › Sources › Add GitHub repository。

  2. 输入仓库

    ALMSTRA/idv7lol,然后选择一个通道:

    • Branch 并填入 main:在主机上用最新代码构建应用。已在实车上测试;推荐使用。
    • Releases:来自 catalog 发行版的现成安装包。尚未在实车上试过。

    不要选择 Tags:它会跳过 v0.2.0-beta.7 这样的预发布版本,因此 idv7lol 不会出现。

  3. 安装

    列表中会出现 idv7lol。打开它并按下 Install。Store 会先安装 idv7lol 所需的组件:cluster-render 0.6.6(负责在仪表盘上绘制内容的服务),以及 Store 自己的部署工具 mgu-deploy 0.8.21,它能确保更新后运行的是新代码。然后在主机上构建 idv7lol。大约需要一分钟。

  4. 按提示重启

    如果 Store 要求重启主机,请在打开应用之前完成重启。

主机无法联网?把代码仓库复制到 U 盘,插入后在 Store 中用 Add from USB 添加。Store 会以同样的方式构建应用。

3 · 首次运行

  1. 打开应用

    在应用菜单中打开 idv7lol。它的标签页有 Themes、Data、Status、Signals、Renderer 和 About,用 Page 切换。与渲染器的连接应显示为 connected (id7)。

  2. 在仪表盘上显示

    在你按下 Show(显示),或在 Settings 中设为 Show on the cluster: On 之前,不会绘制任何内容。只有在车辆数据实时传入时,布局才会出现:启动车辆,或者打开 Demo data(演示数据)来查看。

  3. 选择主题和调色板

    使用 Theme(主题)和 Palette(调色板),或在 Settings 中选择。Start-up sweep(启动扫表)和 Clock offset from UTC(时钟与 UTC 的时差)也在设置里。

  4. 确认如何恢复

    原厂警告始终显示在主题上层。再按一次 Show:原厂仪表盘会在一秒内恢复。这样在开车之前,你就知道如何退出了。

4 · 从本站添加主题

需要应用 0.2.0 或更高版本;带动画的主题(例如 Volt Runner)需要 0.2.6 或更高版本。最多可同时安装 20 个主题。

  1. 下载主题

    在主题页面点击下载车机版,得到一个 .idv7pkg 文件。

  2. 复制到 U 盘

    在任意 FAT32 或 exFAT 格式的 U 盘上创建文件夹 idv7lol/themes/,并把文件复制进去。可以同时放多个主题。

  3. 驻车时插到车上

    打开 idv7lol 应用,插入 U 盘。几秒内,状态页会显示 Installed from USB(已从 USB 安装),或者显示某个文件被拒绝的原因。

  4. 选用

    按 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

出现问题时

Store 中没有出现 idv7lol
检查软件源:应为 ALMSTRA/idv7lol,通道选 Branch main 或 Releases,而不是 Tags。
“no catalog release and no …”(没有 catalog 发行版,也没有……)
该软件源是在 catalog 发行版出现之前以 Releases 通道添加的。让 Store 重新检查软件源,或者删除该软件源后重新添加。改用 Branch main 也可以。
“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 即可恢复原厂仪表盘。所有安装和试用都请在驻车时进行。