インストール方法
作業は2段階です。まずMGU Storeでidv7lolアプリを車に入れ、次にテーマを追加します。すべて駐車中に、電源が安定した状態(エンジンをかけるか、充電器をつなぐ)で行ってください。
始める前に
- iDrive 7(MGUヘッドユニット)とデジタルメーターを搭載したBMW。すでに多くのユーザーが試しています。
- ヘッドユニットのコーディングのバックアップと、再コーディングの手段(BimmerCode、E-Sys、または整備工場)。理由は手順1で説明します。
- Store用のヘッドユニットのインターネット接続(mgu-uplink:スマートフォンのテザリングまたはモデム)、またはUSBメモリ。
1 · MGU Storeをインストール
Robert NisipeanuによるMGU Storeは、ヘッドユニットにアプリをインストールするためのツールです。idv7lolが代わりにStoreをインストールすることはないので、StoreのREADMEに従ってください。Storeには一度だけrootでのSSHアクセスが必要で、idrive7-8-ssh-rootで取得できます。
フラッシュすると、ユニットはコーディングされていない状態になります。言語、メニュー、設定が初期化され、再コーディングするまでStoreは何もインストールせず、BMW Digital Keyのペアリングもたいてい失われます。先にコーディングをバックアップし、再コーディングの手段を用意したうえで、フラッシュは一度だけにしてください。後でSSHが使えなくなった場合は、再度フラッシュせず、そのツールのenableまたはpersistの手順を使ってください。idv7lol自体が何かをフラッシュしたりコーディングしたりすることはありません。
Storeが開いてアプリの一覧が表示されたら、手順2に進みます。
2 · Storeにidv7lolを追加
ソースを開く
車の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をビルドします。1分ほどかかります。
求められたら再起動
Storeからヘッドユニットの再起動を求められたら、アプリを開く前に再起動してください。
ヘッドユニットがインターネットにつながらない場合は、リポジトリをUSBメモリにコピーして挿し、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をもう一度押すと、1秒以内に純正メーターに戻ります。これで、走り出す前に元に戻す方法がわかりました。
4 · このサイトからテーマを追加
アプリ0.2.0以降が必要です(Volt Runnerのようなアニメーション付きのテーマは0.2.6以降)。テーマは同時に20個までインストールできます。
テーマをダウンロード
テーマのページで車両用にダウンロードを押します。
.idv7pkgファイルです。USBメモリにコピー
FAT32またはexFATのUSBメモリに
idv7lol/themes/フォルダーを作り、そこにファイルをコピーします。複数のテーマを並べて置けます。駐車中に車に挿す
idv7lolアプリを開いてから、USBメモリを挿します。数秒でステータスページにInstalled from USB(USBからインストール済み)と表示されます。ファイルが拒否された場合は、その理由が表示されます。
選ぶ
新しいテーマが表示されるまでThemeを押します。インストールしただけでメーターが変わることはありません。
テーマの削除:そのテーマを表示した状態でSettings › Theme from USB on show › Remove it from the car(設定 › 表示中のUSBテーマ › 車から削除)を選びます。USBメモリからも削除してください。削除しないと、次にUSBメモリを挿したときに再びインストールされます。
USBメモリの読み込みは、まだ実車で確認できていません。まもなくお試しいただけます:ヘッドユニットがMGU Store経由でオンラインなら、アプリがこのカタログをセンターディスプレイに表示し、USBメモリなしでテーマをインストールできるようになります(駐車中のみ)。
5 · アップデート
車両アプリが更新されると、Storeでidv7lolのアップデートが提示されます。Storeのidv7lolのページからインストールしてください。その後もアプリが古いバージョンのように動作する場合は、Storeのツールを更新して、ヘッドユニットを再起動してください。
6 · idv7lolの削除
- すぐに純正メーターに戻すには:Showを押すか、SettingsでShow on the cluster: Offにします。
- アンインストールするには:MGU Store › Installed › idv7lol › Remove。cluster-renderの削除は任意です。ほかのアプリが使っている場合があります。
- Storeは、インストールしたものを元に戻すこともできます。ヘッドユニットの動作がおかしくなった場合は、SSHですべてを削除する方法がStoreのドキュメントで説明されています。
うまくいかないとき
- 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をもう一度押すと純正メーターに戻ります。インストールや試用は、すべて駐車中に行ってください。